You install the update on the vRealize Automation 7.1 or 7.2 virtual appliance and IaaS Components.

About this task

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

If you encounter any problems during the upgrade process, see Troubleshooting the vRealize Automation Upgrade from 7.1 or 7.2 to 7.3.

Note:

While upgrading the Management Agent on the IaaS virtual machines, a VMware public certificate is temporarily installed in your Trusted Publishers certificate store. The Management Agent upgrade process uses a PowerShell script that is signed with this certificate. When the upgrade is finished, this certificate is removed from your certificate store.

Prerequisites

  • Verify that you selected a download method and downloaded the update. See Downloading vRealize Automation Appliance Updates.

  • For all high-availability environments, see Back Up Your Existing vRealize Automation 7.1 or 7.2 Environment.

  • For environments with load balancers, verify that you disabled all the redundant nodes and removed the health monitors. For information, see your load balancer documentation.

    • vRealize Automation appliance

    • IaaS Website

    • IaaS Manager Service

  • For environments with load balancers, verify that the traffic is directed only to the primary node.

  • Verify that the IaaS service hosted in Microsoft Internet Information Services (IIS) is running by performing the following steps:

    1. Enter the URL https://webhostname/Repository/Data/MetaModel.svc to verify that the Web Repository is running. If successful, no errors are returned and you see a list of models in XML format.

    2. Log in to the IaaS Website and check that the status recorded in the Repository.log file reports OK. The file is located in the VCAC home folder at /Server/Model Manager Web/Logs/Repository.log.

      Note:

      For a distributed IaaS Website, log in to the secondary website, without MMD, and stop Microsoft IIS temporarily. To ensure that the load balancer traffic is only going through the primary Web node, check the MetaModel.svc connectivity, and restart the Microsoft IIS.

  • Verify that all IaaS nodes are in a healthy state by performing the following steps:

    1. Go to the management console for your primary virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.

    2. Log in with the user name root and the password you entered when the appliance was deployed.

    3. Select vRA settings > Cluster.

    4. Under Last Connected, verify the following.

      • The IaaS nodes in the table have a last connected time of less than 30 seconds.

      • The virtual appliance nodes have a last connected time of less than 10 minutes.

      If all the IaaS nodes are not in communication with the vRealize Automation appliance, the upgrade fails.

      To diagnose connectivity problems between the Management Agent and virtual appliance, perform these steps.

      1. Log in to each IaaS node that is not listed or has a Last Connected time greater than 30 seconds.

      2. Check the Management Agent logs to see if any errors are recorded.

      3. If the Management Agent is not running, restart the agent in the Services console.

    5. Note any orphaned nodes listed in the table. An orphaned node is a duplicate node that is reported on the host but does not exist on the host. You must delete all orphaned nodes. For more information, see Delete Orphaned Nodes on vRealize Automation .

  • If you have a replica virtual appliance that is no longer part of the cluster, you must delete it from the cluster table. If you do not delete this appliance, the upgrade process displays a warning message that the replica update is unsuccessful.

  • Verify that all saved and in-progress requests have finished successfully before you upgrade.

  • If you upgrade the IaaS components manually after you update the vRealize Automation 7.1 or 7.2 appliance, see Exclude Management Agents from Upgrade. If you plan to upgrade IaaS manually, you must also stop all IaaS services, except Management Agent, on each IaaS node.

Procedure

  1. Open the vRealize Automation appliance management console.

    For a distributed environment, open the management console on the master appliance.

    1. Go to the management console for your virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.
    2. Log in with the user name root and the password you entered when you deployed the appliance.
  2. Click Services and verify that all services are registered.
  3. Select vRA Settings > Database and verify that this appliance is the master vRealize Automation appliance.

    You install the update only on the master vRealize Automation appliance. Each replica vRealize Automation appliance is updated with the master appliance.

  4. Select Update > Status.
  5. Click Check Updates to verify that an update is accessible.
  6. (Optional) : For instances of vRealize Automation appliance, click Details in the Appliance Version area to see information about the location of release notes.
  7. Click Install Updates.
  8. Click OK.

    A message stating that the update is in progress appears. The system shows changes made during an upgrade on the Update Summary page. The time required for the update to finish varies according to your environment and network.

  9. (Optional) To monitor the update in greater detail, use a terminal emulator to log in to the primary appliance. View the updatecli.log file at /opt/vmware/var/log/vami/updatecli.log.

    Additional upgrade progress information can also be seen in these files.

    • /opt/vmware/var/log/vami/vami.log

    • /var/log/vmware/horizon/horizon.log

    • /var/log/bootstrap/*.log

    If you log out during the upgrade process, you can continue to follow the update progress in the log file. The updatecli.log file might display information about the version of vRealize Automation that you are upgrading from. This displayed version changes to the proper version later in the upgrade process.

  10. When the vRealize Automation appliance update finishes, click System > Reboot in the management console.

    In a distributed environment, all successfully upgraded replica appliance nodes reboot when you reboot the master appliance.

    The IaaS update starts when the system is initialized and all services are up and running. Click Update > Status to observe the IaaS upgrade progress.

  11. When the IaaS update finishes, click Cluster in the appliance management console and verify that the version number is 7.3 for all IaaS nodes and components.
  12. Click the Telemetry in the appliance management console. Read the note about participation in the Customer Experience Improvement Program (CEIP) and select to join or not join the program.

    Details regarding the data collected through CEIP and the purposes for which it is used by VMware are set forth at the Trust & Assurance Center at http://www.vmware.com/trustvmware/ceip.html.

    For more information about the Customer Experience Improvement Program, see Join or Leave the Customer Experience Improvement Program for vRealize Automation.

What to do next

If your deployment uses a load balancer, perform these steps.

  1. Upgrade each load balancer node to use vRealize Automation health checks.

  2. Re-enable load balancer traffic for any unconnected nodes.

If the IaaS components fail to upgrade, see Upgrading the IaaS Server Components Separately If the Update Process Fails.