Converting a stand-alone server to high availability

You can convert an IBM® UrbanCode® Deploy server into the first node of a high-availability cluster.

  • Each server in the cluster must run the same version of IBM UrbanCode Deploy.

To convert a stand-alone server to the first node in a clustered configuration, you first move CodeStation to shared network storage, and then modify the server settings for multi-server operation.

  1. Move CodeStation to a shared storage location with a fast network connection.
    Because each cluster server must access the same configuration files, each server must have access to this network storage. See Relocating CodeStation.
  2. Install a load balancer to send requests to the servers.
    The load balancer must be able to forward requests to the HTTP and HTTPS ports for the servers. For more information, see the documentation for your load balancer.
    Important: You must configure the load balancer for session persistence, also known as session affinity.
  3. Stop of the server.
  4. Add the following line of code to the install_folder/conf/server/ file:
  5. Start the server.
  6. On the new cluster server, click Settings > System Settings, and set the External Agent URL and the External User URL to the URL for the load balancer.
  7. Optional: Configure the license server for high availability.
    For information, see the Rational® Common Licensing documentation: For high availability options for the license server, see
After you configure the server and the load balancer, you can add nodes to the cluster.