Couchbase Server 3.0 | Contents | 2 Contents Introduction............................................................................................................... 8 Enterprise edition features....................................................................................................................................9 What's new in 3.0................................................................................................... 10 Installation and upgrade........................................................................................12 Couchbase setup overview................................................................................................................................. 12 Pre-installation.....................................................................................................................................................12 Resource requirements............................................................................................................................12 Supported platforms................................................................................................................................13 Network ports..........................................................................................................................................14 Using user-defined ports.........................................................................................................................16 Supported web browsers.........................................................................................................................17 Red Hat/CentOS installation.............................................................................................................................. 17 Prerequisites............................................................................................................................................ 18 Installing on RHEL.................................................................................................................................18 Installing as non-root, non-sudo.............................................................................................................20 Installing multiple instances................................................................................................................... 20 Uninstalling on RHEL............................................................................................................................22 Upgrading on RHEL...............................................................................................................................22 Ubuntu/Debian installation................................................................................................................................. 22 Installing as non-root, non-sudo.............................................................................................................24 Uninstalling on Ubuntu Linux................................................................................................................24 Upgrading on Ubuntu Linux.................................................................................................................. 24 Microsoft Windows installation......................................................................................................................... 25 Installing on Windows with the wizard................................................................................................. 25 Unattended Windows installation...........................................................................................................26 Uninstalling on Windows....................................................................................................................... 27 Upgrading on Windows..........................................................................................................................27 Mac OS X installation........................................................................................................................................27 Installing on Mac OSX...........................................................................................................................28 Installing as non-root, non-sudo.............................................................................................................28 Uninstalling on Mac OS X.....................................................................................................................29 Upgrading on Mac OS X....................................................................................................................... 29 Post-installation...................................................................................................................................................29 Initial server setup.................................................................................................................................. 29 Using hostnames..................................................................................................................................... 32 Start-up and shutdown on Linux............................................................................................................33 Start-up and shutdown on Windows...................................................................................................... 34 Start-up and shutdown on Mac OS X....................................................................................................34 Testing Couchbase Server...................................................................................................................... 35 Upgrading............................................................................................................................................................37 Supported upgrade paths........................................................................................................................ 38 Online upgrade with swap rebalance..................................................................................................... 39 Offline upgrade....................................................................................................................................... 40 Upgrading one node............................................................................................................................... 41 Migrating.............................................................................................................................................................41 | Contents | 3 Migrating from CouchDB...................................................................................................................... 42 Migrating from Membase.......................................................................................................................43 Administration.........................................................................................................45 Administration basics..........................................................................................................................................45 Common administration tasks................................................................................................................ 45 Starting and stopping Couchbase Server................................................................................................46 Data file location.................................................................................................................................... 47 Installation location.................................................................................................................................48 Limits.......................................................................................................................................................48 Cluster-wide diagnostics.........................................................................................................................48 Architecture and concepts.................................................................................................................................. 49 Cluster Manager......................................................................................................................................49 Data storage............................................................................................................................................ 53 RAM quotas............................................................................................................................................55 vBuckets.................................................................................................................................................. 56 Caching layer.......................................................................................................................................... 57 Disk storage............................................................................................................................................ 58 Shared thread pool..................................................................................................................................59 Disk I/O priority..................................................................................................................................... 61 Tunable memory....................................................................................................................................