Appendix C - Installation of Couchbase

This appendix describes how to install Couchbase, which you may use as storage for Aggregation, Distributed Storage, and PCC. 

In order for to communicate with the Couchbase database, the couchbase.mzp package must be included in your installation.

When the couchbase.mzp package is installed in, the Couchbase database can be installed by following these steps:

1. Open a web browser and go to http://www.couchbase.com.
   
   
2. Click Downloads. 
   
   
3. Select the Enterprise edition for  your operating system.
    

4. Click on Install Instructions to view information on how to install Couchbase. 

   Note!

   It is important that you perform the steps that are specific to your operating system. For instance, when you install Couchbase on an operating system that is based on Red Hat Enterprise Linux, Transparent Huge Pages (THP) should be disabled on all server nodes.  

    

   Note!

   Couchbase services required by  are:

   • Data
   • Index
   • Query

   These links may refer to another version of Couchbase than the one you install. If you install a different version, refer to docs.couchbase.com for the corresponding documentation version. 

5. In the Couchbase documentation, review the subtopics under Deployment Considerations in Administration.

   Note!

    For the optimal Couchbase Server operations, you must set swappiness to 0 (zero) as described in the topic about swap space.

6. Start a web browser and go to http://localhost:8091/.
   
   The Couchbase Web Administration interface opens.
   
    
   The Coucbhase Web Administration interface
   
7. Click the Setup New Cluster button and follow the instructions https://developer.couchbase.com/documentation/server/5.1/install/init-setup.html. The Couchbase Web Console opens displaying the Dashboard.
   
   
   The Couchbase Dashboard
   
   
8. In the Dashboard, select Settings and click on the Auto-Compaction tab. Select the checkbox Compact Buckets and View indexes in parallel. When you have a large number of documents in the database, creating iterators may sometimes fail. Enabling this setting may help to mitigate this problem.
   
   
9. Repeat the installation on all the Couchbase nodes in the cluster, and ensure that you select the option Join Existing Cluster during the installation of the remaining nodes.
   
   
10. In the Dashboard on any of the nodes, select Servers and click the Rebalance button to distribute the data between the nodes evenly.
    
    Couchbase Dashboard showing the Rebalance button
    
    
11. These links may refer to another version of Couchbase than the one you install Couchbase profile will be generated and visible in the Couchbase Web Console, as soon as the data buckets are called.

You can now proceed with either creating data buckets in the Couchbase cluster by using the Couchbase profile in either in combination with Distributed Storage, or with PCC. Couchbase data buckets can be created either directly in the Couchbase Web Console, or by using Couchbase profiles, in. See the Desktop User's Guide for further information about how to create buckets with Couchbase profiles.