You can configure your new vRealize Orchestrator deployment to run in high availability by deploying three nodes and connecting them as a cluster.

A vRealize Orchestrator cluster consists of three vRealize Orchestrator instances that share a common PostgreSQL database. The database of the configured vRealize Orchestrator cluster can only run in asynchronous mode.

To create a vRealize Orchestrator cluster, you must select one vRealize Orchestrator instance to be the primary node of the cluster. After configuring the primary node, you join the secondary nodes to it.

The created vRealize Orchestrator cluster is pre-configured with automatic failover.

Note: Failure of the automatic failover can lead to loss of database data.



  1. Configure the primary node.
    1. Log in to the vRealize Orchestrator Appliance of the primary node over SSH as root.
    2. To configure the cluster load balancer server, run the vracli load-balancer set load_balancer_FQDN command.
    3. Log in to the Control Center of the primary node and select Host Settings.
    4. Click Change and set the host address of the connected load balancer server.
    5. Configure the authentication provider. See Configuring a Standalone vRealize Orchestrator Server.
  2. Join secondary nodes to primary node.
    1. Log in to the vRealize Orchestrator Appliance of the secondary node over SSH as root.
    2. To join the secondary node to the primary node, run the vracli cluster join primary_node_hostname_or_IP command.
    3. Enter the root password of the primary node.
    4. Repeat the procedure for other secondary node.
  3. (Optional) If your primary node uses a custom certificate, you must either set the certificate in the appliance or generate a new certificate. See Generate a Custom TLS Certificate for vRealize Orchestrator.
    Note: The file containing the certificate chain must be PEM-encoded.
  4. Finish the cluster deployment.
    1. Log in to the vRealize Orchestrator Appliance of the primary node over SSH as root.
    2. To confirm that all nodes are in a ready state, run the kubectl -n prelude get nodes command.
    3. Run the /opt/scripts/ script and wait for the deployment to finish.


You have created a vRealize Orchestrator cluster. After creating the cluster, you can access your vRealize Orchestrator environment only from the FQDN address of your load balancer server.

Note: Because you can only access the Control Center of the cluster with the root password of the load balancer, you cannot edit the configuration of a cluster node if it has a different root password. To edit the configuration of this node, remove it from the load balancer, edit the configuration in the Control Center, and add the node back to the load balancer.

What to do next

To monitor the state of the vRealize Orchestrator cluster, log in to the Control Center and select the Orchestrator Cluster Management page. See Monitoring an vRealize Orchestrator Cluster.