This section provides details about configuring CloudBees CD servers to operate in a clustered mode. After you install CloudBees CD 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 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/electriccloud/electriccommander/bin/ecconfigure
-
Windows:
C:\Program Files\Electric Cloud\ElectricCommander\bin\ecconfigure.exe
On each CloudBees CD server and web server node,
-
Sign in as the user that runs the CloudBees CD server or as a user with administrative privileges.
-
On each CloudBees CD 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 theIP_address:port_number
orFQDN: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 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 toExhibitor
port8080
: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.
-