Configuring a cluster

1 minute readScalability

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.


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.

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,

  1. Sign in as the user that runs the CloudBees CD/RO server or as a user with administrative privileges.

  2. On each CloudBees CD/RO server node, issue the following command:

    ecconfigure --serverName <load_balancer_FQDN> \ --serverZooKeeperConnection <ZooKeeper_servers> \


    • <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.

      Example for a three-ZooKeeper cluster:

      ecconfigure --serverName \ --serverZooKeeperConnection,,
  3. 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: