Installing on RHEL

Installing on RHEL

Install Couchbase Server on RHEL using the rpm command-line tool with the downloaded RPM package.

Important: RHEL6 and other newer Linux distributions, running both on physical hardware and on virtual machines, are known to have transparent huge pages feature enabled. It is strongly recommended to disable the transparent huge pages feature when installing Couchbase Server.

Disable Transparent Huge Pages (THP)

To permanently disable both THP and THP defrag, the preferred method is to add the following to /etc/rc.local :
 for i in /sys/kernel/mm/*transparent_hugepage/enabled; do
 echo never > $i; 
 done 
 
 for i in /sys/kernel/mm/*transparent_hugepage/defrag; do
 echo never > $i; 
 done  

Alternatively, you can append the statement transparent_hugepage=never to the kernel boot line in /etc/grub.conf , which will disable THP but not THP defrag. This method can be used when it is not desirable to maintain a file /etc/rc.local .

Either method requires a restart of the operating system.

Complete the installation

Log in as root (superuser) to complete the installation:


root-> rpm --install couchbase-server-version.rpm 
     

where version is the version number of the downloaded package.

After the rpm command completes, the Couchbase Server starts automatically. It is configured to automatically start during boot under the 2, 3, 4, and 5 runlevels. Refer to the Red Hat RPM documentation for more information about installing packages using RPM.

After installation is completed, the installation process displays a message similar to the following:


Minimum RAM required : 4 GB 
System RAM configured : 8174464 kilobytes
    Minimum number of processors required :  4 cores 
    Number of processors on the system : 4 cores
    
    
Starting couchbase-server[ OK ]

You have successfully installed Couchbase Server. 
    Browse to http://host_name:8091/ to configure your server. 
   Refer to http://couchbase.com for additional resources.

   Update your firewall configuration 
    to allow connections to the following ports: 
   
    11211, 11210, 11209, 4369, 8091, 8092 and from 21100 to 21299.


By using this software you agree to the End User License Agreement. 
See /opt/couchbase/LICENSE.txt.
     

After the installation is completed, use the Red Hat chkconfig command to manage the Couchbase Server service, including checking the current status and creating the links to turn on and off the automatic start-up.

To perform the initial Couchbase Server setup, open a web browser and access the Couchbase Web Console.

Installing cbq

CentOS and other Red Hat distributions include a monitoring tool called cbq , which is installed in the directory /sbin .

Be aware that the Couchbase client prompt cbq , which is installed in /opt/couchbase/bin and used for N1QL, won't work by default unless you specifically invoke it with its full path, /opt/couchbase/bin/ . The other way to invoke the Couchbase client prompt cbq for N1QL is to alter your PATH variable so that it will first search for /opt/couchbase/bin.