For a high availability environment, the master virtual appliance is the node that runs embedded PostgreSQL in the Master mode. The other nodes in the environment run the embedded PostgreSQL database in Replica mode. During upgrade, the replica virtual appliance does not require database changes.

About this task

Do not close the management console while you install the update.


  • Verify that you have downloaded the virtual appliance updates. See Downloading vRealize Automation Appliance Updates.

  • Verify that the jdbc:postgresql database connection points to the external IP address of the master PostgreSQL node.

    1. On the vRealize Automation appliance, open a new command prompt.

    2. Navigate to /etc/vcac/server.xml, and back up server.xml.

    3. Open server.xml.

    4. If necessary, edit the server.xml file entry jdbc:posgresql that points to the Postgres database and point it to the external IP address of the master PostgreSQL node for external PostgreSQL or master virtual appliance for embedded PostgreSQL.

      For example, jdbc:postgresql://

  • If you are upgrading a distributed environment configured with an embedded PostgreSQL database, examine the files in the pgdata directory on the master host before you upgrade the replica hosts. Navigate to the PostgreSQL data folder on the master host at /var/vmware/vpostgres/current/pgdata/. Close any opened files in the pgdata directory and remove any files with a .swp suffix.


  1. Open the vRealize Automation appliance management console for the upgrade.
    1. Go to the management console for your virtual appliance by using its fully qualified domain name,
    2. Log in with the user name root and the password you specified when the appliance was deployed.
    3. Click the Update tab.
  2. Click Settings.
  3. Select to download the updates from a VMware repository or CDROM in the Update Repository section.
  4. Click Status.
  5. Click Check Updates to verify that an update is accessible.
  6. Click Install Updates.
  7. Click OK.

    A message stating that the update is in progress appears.

  8. (Optional) If you have not resized Disk 1 to 50 GB manually, perform the following steps.
    1. When the system prompts you to reboot the virtual appliance, click the System tab and click Reboot.

      During the reboot, the system adjusts the space required for the update.

    2. After the system reboots, log in again to the vRealize Automation appliance management console and select Update > Status.
    3. Click Check Updates and Install Updates.
  9. Open the log files to verify that upgrade is progressing successfully.

    /opt/vmware/var/log/vami/vami.log and /var/log/vmware/horizon/horizon.log

    If you log out during the upgrade process and log in, you can continue to follow the progress of the update in the log file /opt/vmware/var/log/vami/updatecli.log.

    The time it takes for the update to finish depends on your site environment.

  10. When the update is finished, log out of the vRealize Automation appliance, clear the cache of your Web browser, and log in to the vRealize Automation appliance management console.
  11. Reboot the virtual appliance.
    1. Click System.
    2. Click Reboot and confirm your selection.
  12. Log in to the vRealize Automation appliance management console.
  13. Select vRA Settings > Cluster.
  14. Specify the master virtual appliance and click Join Cluster.
  15. Click Services and verify that all of the services are present.
  16. Perform the following steps for each tenant directory you create during migration.

    You must complete these steps prior to enabling your virtual appliances in your load balancer.

    1. Log in to the vRealize Automation console as tenant administrator.
    2. Select Administration > Directories Management > DIrectories.
    3. Select your directory name and select Settings.
    4. For Identity Providers, click the name of your identity provider from the available choices, for example WorkspaceIPD_1.
    5. In the Connector(s) drop-down menu, add your additional appliance and enter your BIND DN password.
    6. In the IdP Hostname text box, change the existing value to your virtual appliance load balancer host name, for example
    7. Click Save.

What to do next

Download the IaaS Installer