When maintaining an environment or network, you might need to assign a different host name to an existing replica vRealize Automation appliance.

About this task

In a high availability cluster of vRealize Automation appliances, follow these steps to change the host name of a replica vRealize Automation appliance node.

Important:

Enter all host names as FQDNs.

Prerequisites

If the master node host name needs to change, complete that entire procedure first. See Change the Master vRealize Automation Appliance Host Name.

Procedure

  1. In DNS, create an additional record with the new replica host name.

    Do not remove the existing DNS record with the old host name yet.

  2. Wait for DNS replication and zone distribution to occur.
  3. Log in as root on the replica vRealize Automation appliance management interface.

    https://vrealize-automation-appliance-FQDN:5480

  4. Click Network > Address.
  5. In the Hostname text box, enter the new replica host name, and click Save Settings.
  6. From a console session as root on the replica vRealize Automation appliance, run the following script.

    /usr/lib/vcac/tools/change-hostname/change-hostname_replica.sh new-replica-hostname old-replica-hostname

  7. From a console session as root on the master vRealize Automation appliance, run the following script.

    /usr/lib/vcac/tools/change-hostname/change-hostname_master.sh new-replica-hostname old-replica-hostname

    Run the script one time for each directory in the current environment. There might be multiple directories per tenant.

    For example, if you have two directories, run the script twice, one after the other.

  8. From a console session as root on the master vRealize Automation appliance, run the following commands.

    sed -i "s/old-replica-hostname/new-replica-hostname/g" "/etc/haproxy/conf.d/10-psql.cfg" "/etc/haproxy/conf.d/20-vcac.cfg"

    echo master-hostname > /usr/local/horizon/conf/flags/sysconfig.hostname

  9. From a console session as root on each replica vRealize Automation appliance, run the following commands.

    sed -i "s/old-replica-hostname/new-replica-hostname/g" "/etc/haproxy/conf.d/10-psql.cfg" "/etc/haproxy/conf.d/20-vcac.cfg" "/usr/local/horizon/conf/flags/sysconfig.hostname"

    echo new-replica-hostname > /usr/local/horizon/conf/flags/sysconfig.hostname

  10. Log in as root on the replica vRealize Automation appliance management interface.

    https://vrealize-automation-appliance-FQDN:5480

  11. Click vRA Settings > Cluster.
  12. Use Join Cluster to re-join the replica node to the cluster.
  13. Verify that all authentication connectors are working correctly.
  14. In DNS, remove the existing DNS record with the old replica host name.