Couchbase Server Manual 2.1.0 Couchbase Server Manual 2.1.0 Abstract This manual documents the Couchbase Server 2.1.0 series, including installation, monitoring, and administration interface and associ- ated tools. For the corresponding Moxi product, please use the Moxi 1.8 series. See Moxi 1.8 Manual. External Community Resources. Download Couchbase Server 2.1 Couchbase Developer Guide 2.1 Client Libraries Couchbase Server Forum Last document update: 05 Sep 2013 23:46; Document built: 05 Sep 2013 23:46. Documentation Availability and Formats. This documentation is available online: HTML Online . For other documentation from Couchbase, see Couchbase Documentation Library Contact: [email protected] or couchbase.com Copyright © 2010-2013 Couchbase, Inc. Contact [email protected]. For documentation license information, see Section F.1, “Documentation License”. For all license information, see Appendix F, Licenses. Table of Contents Preface ................................................................................................................................................... xiii 1. Best Practice Guides ..................................................................................................................... xiii 1. Introduction to Couchbase Server .............................................................................................................. 1 1.1. Couchbase Server and NoSQL ........................................................................................................ 1 1.2. Architecture and Concepts ............................................................................................................. 2 1.2.1. Nodes and Clusters ............................................................................................................ 2 1.2.2. Cluster Manager ................................................................................................................ 2 1.2.3. Data Storage ..................................................................................................................... 3 1.2.4. RAM Quotas ..................................................................................................................... 5 1.2.5. vBuckets .......................................................................................................................... 6 1.2.6. Caching Layer ................................................................................................................... 7 1.2.7. Disk Storage ..................................................................................................................... 8 1.2.8. Ejection, Eviction and Working Set Management ..................................................................... 9 1.2.9. Expiration ....................................................................................................................... 11 1.2.10. Server Warmup .............................................................................................................. 11 1.2.11. Rebalancing ................................................................................................................... 11 1.2.12. Replicas and Replication .................................................................................................. 11 1.2.13. Failover ........................................................................................................................ 12 1.2.14. TAP ............................................................................................................................. 12 1.2.15. Client Interface .............................................................................................................. 12 1.2.16. Administration Tools ....................................................................................................... 13 1.2.17. Statistics and Monitoring ................................................................................................. 14 1.3. Migration to Couchbase ............................................................................................................... 14 1.3.1. Migrating for Membase Users ............................................................................................ 15 1.3.2. Migrating for CouchDB Users ............................................................................................ 16 2. Installing and Upgrading ........................................................................................................................ 18 2.1. Preparation ................................................................................................................................ 18 2.1.1. Supported Platforms ......................................................................................................... 18 2.1.2. Resource Requirements ..................................................................................................... 19 2.1.3. Supported Web Browsers .................................................................................................. 19 2.1.4. Network Ports ................................................................................................................. 20 2.2. Installing Couchbase Server .......................................................................................................... 21 2.2.1. Red Hat Linux Installation ................................................................................................. 21 2.2.2. Ubuntu Linux Installation .................................................................................................. 22 2.2.3. Microsoft Windows Installation .......................................................................................... 22 2.2.4. Mac OS X Installation ...................................................................................................... 24 2.3. Initial Server Setup ..................................................................................................................... 25 2.4. Using Hostnames with Couchbase Server ........................................................................................ 29 2.4.1. Hostnames for Couchbase Server 2.0.1 and Earlier ................................................................. 31 2.5. Upgrading to Couchbase Server 2.1 ............................................................................................... 33 2.5.1. Online Upgrade with Swap Rebalance ................................................................................. 34 2.5.2. Standard Online Upgrades ................................................................................................. 36 2.5.3. Offline Upgrade Process .................................................................................................... 38 2.6. Upgrading Individual Nodes ......................................................................................................... 39 2.7. Upgrades Notes 1.8.1 to 2.1 ......................................................................................................... 40 2.7.1. Upgrade Notes 1.8 and Earlier to 2.1+ ................................................................................. 41 2.7.2. Upgrading from Community Edition to Enterprise Edition ....................................................... 41 2.8. Testing Couchbase Server ............................................................................................................ 42 2.8.1. Testing Couchbase Server using cbworkloadgen ................................................................... 42 2.8.2. Testing Couchbase Server using Telnet ................................................................................ 42 2.9. Next Steps ................................................................................................................................. 43 iii Couchbase Server Manual 2.1.0 3. Administration Basics ............................................................................................................................ 44 3.1. Couchbase Data Files .................................................................................................................. 44 3.2. Server Startup and Shutdown ........................................................................................................ 45 3.2.1. Startup and Shutdown on Linux .......................................................................................... 45 3.2.2. Startup and Shutdown on Windows ..................................................................................... 45 3.2.3. Startup and Shutdown on Mac OS X ................................................................................... 46 4. Best Practices ....................................................................................................................................... 49 4.1. Cluster Design Considerations ...................................................................................................... 49 4.2. Sizing Guidelines ........................................................................................................................ 49 4.2.1. RAM Sizing .................................................................................................................... 50 4.2.2. Disk Throughput and Sizing ............................................................................................... 52 4.2.3. Network Bandwidth .........................................................................................................