How to Install CouchBase Server

Automated Install

1.       Build image from base kickstart profile

2.       Login to server as root

3.       Make sure 2^nd disks are configured for stage and production. (Perform in WebUI)

a.       Configure data path to /opt/couchbase/var/lib/couchbase/data

b.      Configure Index Path to /opt/couchbase/var/lib/couchbase/index

                                                              i.      Mount 2^nd disk lvm to this path

c.       *** Note: See below in Manual Install to configure 2^nd Disk

4.       Get the basic install script from using wget.

a.       wget –P /root/ http://myDomain.com/sw/couchbase-install

5.       Run the script as root

a.       ~/.couchbase-install

6.       Set Path for Couchbase user

a.       # su – couchbase

b.      vi ~/.bash_profile

c.       PATH=$PATH:$HOME/bin:/opt/couchbase/bin

7.       Verfiy the install and change Administrator password to ‘myPassword’

8.       Continue on to Configure Couchbase Cluster

Manual Install

1.       Build image from base kickstart profile.

2.       Add 2^nd Hard Disk, thin provisioned, 50gb and power on vm.

a.       Run fdisk /dev/sdb to create new partition

                                                              i.      N = new, p = primary, 1 = part #, default, t = type, 8e =lvm, w = write

                                                            ii.      Partprobe

3.       Create Physical Volume, Vol Group, and Logical Volume

a.       # pvcreate /dev/sdb1

b.      # vgcreate rhelvg2 /dev/sdb1

c.       # lvcreate -L 10G rhelvg2 -n indexLV  (resize as needed)

d.      # mkfs /dev/mapper/rhelvg2-indexLV

4.       Add to /etc/fstab

a.       /dev/mapper/rhelvg2-indexLV /opt/couchbase/var/lib/couchbase/index ext4    defaults        1 2

5.       Add user couchbase uid/gid 1000

6.       Add devadm group GID 1501

a.       groupadd -g 1000 devadm

7.       Add couchbase user to devadm group

a.       # usermod -G 1000 couchbase

8.       Add dev users for Developers (others?)

a.       Consider sudo for dev user?

9.       Install openssl098e

a.       # yum install openssl098e.x86_64

10.   Download Couchbase and install

a.       wget http://packages.couchbase.com/releases/2.0.0/couchbase-server-enterprise_x86_64_2.0.0.rpm

b.      rpm --install  couchbase-server-enterprise_x86_64_2.0.0.rpm

c.       Starting couchbase-server[  OK  ]
You have successfully installed Couchbase Server.
Please browse to http://dsa520:8091/ to configure your server.
Please refer to http://couchbase.com for additional resources.
Please note that you have to update your firewall configuration to
allow connections to the following ports: 11211, 11210, 11209, 4369,
8091 and from 21100 to 21299.
By using this software you agree to the End User License Agreement.
See /opt/couchbase/LICENSE.txt.

11.   Create Mount point for index in /opt/couchbase/var/lib/couchbase/index and run mount command

a.       cd /opt/couchbase/var/lib/couchbase

b.      mkdir index

c.       Mount –a

d.      chown -R couchbase.couchbase index/

12.   Continue on to Configure Couchbase Cluster

Configure CouchBase Cluster

1.       Configure Couchbase as a Cluster

a.       Reference http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-getting-started-setup.html

2.       Login to http://localhost:8091/ and click on Setup

3.       On Configure Server page, Leave Default Database Path as

a.       /opt/couchbase/var/lib/couchbase/data

4.       Change Indices Path to your index path

a.       /opt/couchbase/var/lib/couchbase/index

5.       For first Node, choose ‘Start a New Cluster; and leave the default RAM Quota

6.       Click Next to continue and on the Sample Buckets page, click Next

7.       On Create Default Bucket, set the default bucket size to 100mb (default bucket should never be used for storing live application data)

a.       Keep type as Couchbase

b.      Set Memory Size to 100MB

c.       Keep ‘Enable’ check for Replicas

d.      Click Next to continue

8.       On Notifications enter your email, then check the “I agree” box. Click Next to continue

9.       On Configure Server page, set username to Admin and password to ‘myPassword’ and click next  to complete.

a.       These values can be changed later.

13.   Go to 2^nd node in cluster via browser.

a.       Click Setup to begin

10.   On Configure Server page, Leave Default Database Path as

a.       /opt/couchbase/var/lib/couchbase/data

11.   Change Indices Path to your index path

b.      /opt/couchbase/var/lib/couchbase/index

14.   Choose Join a cluster now and enter the following information and then click Next

a.       IP Address:  ip of node 1 of cluster

b.      Username = Admin

c.       Password = myPassword

15.   The server is now part of the cluster.

16.   Optional - go to server Nodes > Pending Rebalance > Rebalance Now to start rebalance immediately.