Converting a stand-alone server to high availability

You can convert an HCL Launch server into the first node of a high-availability cluster.

Before you begin

  • Each server in the cluster must run the same version of HCL Launch.

About this task

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.


After you configure the server and the load balancer, you can add nodes to the cluster.

What to do next