Configuring a cluster

This section provides details about configuring CloudBees CD/RO servers to operate in a clustered mode. After you install CloudBees CD/RO on servers participating in the cluster, you must configure them to operate in a clustered mode.

Prerequisites:

Configure cluster servers

Follow the steps in this section to configure all the CloudBees CD/RO servers and web servers participating in the cluster. You need the following information:

The load balancer IP addresses or FQDNs.
The list of ZooKeeper server IP addresses or FQDNs.
If using Exhibitor, IP addresses or FQDNs for the Exhibitor servers.

In addition, locate the ecconfigure tool:

Linux: /opt/cloudbees/sda/bin/ecconfigure
Windows: C:\Program Files\CloudBees\Software Delivery Automation\bin\ecconfigure.exe

On each CloudBees CD/RO server and web server node,

Sign in as the user that runs the CloudBees CD/RO server or as a user with administrative privileges.
On each CloudBees CD/RO server node, issue the following command:
```
ecconfigure --serverName <load_balancer_FQDN> \
             --serverZooKeeperConnection <ZooKeeper_servers> \
            [--serverExhibitorConnection <Exhibitor_servers>]▼
```
Where:
- <load_balancer_FQDN> is the fully-qualified domain name of your load balancer machine.
- <ZooKeeper_servers> is a comma-separated (no spaces) list of the IP_address:port_number or FQDN:port_number for each of your three or five ZooKeeper servers. The port number for ZooKeeper is normally 2181.
- If you are using Exhibitor, <Exhibitor_servers> is a comma-separated (no spaces) list of the IP addresses or FQDNs of your three or five Exhibitor servers. The default port number that CloudBees CD/RO uses to connect to Exhibitor is port 80. For example, 10.0.2.1,10.0.2.2,10.0.2.3 for a three-ZooKeeper/Exhibitor cluster.
  
  Example for a three-ZooKeeper cluster:
  ecconfigure --serverName machine.example.com \ --serverZooKeeperConnection 10.0.2.1:2181,10.0.2.2:2181,10.0.2.3:2181
  ▼
  Example for a three-ZooKeeper cluster with Exhibitor, connecting to Exhibitor port 8080:
  ecconfigure --serverName machine.company.com \ --serverZooKeeperConnection 10.0.2.1:2181,10.0.2.2:2181,10.0.2.3:2181 \ --serverExhibitorConnection 10.0.2.1:8080,10.0.2.2,10.0.2.3
  ▼
  For serverExhibitorConnection, the port is specified only on the first Exhibitor host in the list. The same port number is used for all Exhibitor hosts.
Upload configuration files to ZooKeeper

Share the plugins directory

Share the plugins directory across the CloudBees CD/RO servers and web servers if you have not done so already. For more information, see: