Use the upgrade shell script to upgrade the IaaS Components after you update each VMware vRealize ™ Automation appliance.

Before you begin

  • Verify the successful update of all vRealize Automation appliances.

  • If you reboot an IaaS server after you update all the vRealize Automation appliances but before you upgrade the IaaS components , stop all of the IaaS windows services, except for the Management Agent service, on the server.

  • Before you run the upgrade shell script on the primary or master vRealize Automation appliance node, verify that the status of each service, except for iaas-service, on the Services tab in the vRealize Automation appliance management console is listed as REGISTERED.

  • On each IaaS node, manually install the IaaS Management Agent shipped as separate package on the vRealize Automation 7.2 download page. For information, see Knowledge Base Article 2147926.

    Do not attempt to use the Management Agent installer that is included in the vRealize Automation virtual appliance.

    Log in to each vRealize Automation IaaS machine and upgrade the Management Agent with the downloaded package. Then restart the Management Agent Windows service.

  • Verify that your primary IaaS Website and Model Manager node has JAVA SE Runtime Environment 8, 64bits, update 91 or later installed. After you install Java, you must set the environment variable, JAVA_HOME , to the new version on each server node.

  • Log in to each IaaS Website node and verify that the creation date is earlier than the modified date in the web.config file. If the creation date for the web.config file is the same as or later than the modified date, perform the procedure in Upgrade Fails for IaaS Website Component.

  • Perform these steps on each IaaS node to verify that each IaaS node has an upgraded IaaS Management Agent:

    1. Log in to the vRealize Automation appliance management console.

    2. Select vRA Settings > Cluster.

    3. Expand the list of all installed components on each IaaS node, and locate the IaaS Management Agent.

    4. Verify that the Management Agent version is current.

  • Verify that the IaaS Microsoft SQL Server database backup is accessible in case you need to roll back.

  • Delete all orphaned IaaS nodes. See Delete Orphaned Nodes on vRealize Automation.

  • Verify that snapshots of the IaaS servers in your deployment are available.

    If the upgrade is unsuccessful, return to the snapshot and database backup and attempt another upgrade.

About this task

The updated primary or master vRealize Automation appliance contains a shell script that you use to upgrade each IaaS node and component.

You can run the upgrade script by using the vSphere console for the virtual machine or by using an SSH console session. If you use the vSphere console, you avoid intermittent network connectivity issues that can break the execution of the script.

If you stop the script while it is upgrading a component, the script stops when it completes upgrading the component. If other components on the node still need to be upgraded, you must run the script again.

When the upgrade finishes, you can review the upgrade result by opening the upgrade log file at /usr/lib/vcac/tools/upgrade/upgrade.log.

Procedure

  1. Open a new console session on the primary or master vRealize Automation appliance node and log in with the root account.

    If you plan to run the upgrade script by means of SSH, open an SSH console session.

  2. Change directories to /usr/lib/vcac/tools/upgrade/.
  3. Run this command at the command prompt to create the upgrade.properties file.

    ./generate_properties

  4. Open the upgrade.properties file and enter all the required values.

    This table shows the required values, which vary depending on the environment. For example, on a node that contains a DEM worker or orchestrator, DEM credentials are required.

    Required Value

    Description

    Credential Format

    web_username

    User name for the primary Web node. Required only once.

    Domain\User

    web_password

    Password for the primary Web node. Required only once.

    Password

    dem_username

    User name for the DEM worker or DEM orchestrator. Required for each node where a DEM component is installed.

    Domain\User

    dem_password

    Password for the DEM worker or DEM orchestrator. Required for each node where a DEM component is installed.

    Password

    agent_username

    User name for an agent such as a vSphere agent. Required for each node where an agent component is installed.

    Domain\User

    agent_password

    Password for an agent such as a vSphere agent. Required for each node where an agent component is installed.

    Password

    vidm_admin_password

    The VIDM administrator password. Required only when you upgrade from vRealize Automation 6.2.4 or 6.2.5.

    vIDM_password

    For security reasons, the upgrade.properties file is removed when you run the upgrade shell script. The properties in the file are defined using the information for each IaaS component that comes through the IaaS Management Agents. It is important that all IaaS Management Agents are upgraded and healthy prior to running the ./generate_properies or ./upgrade shell scripts. If any IaaS Management Agent has a problem when you run the upgrade shell script, see Upgrade Fails to Upgrade the Management Agent or Certificate Not Installed on a IaaS Node. To recreate the upgrade.properties file, repeat steps 2 and 3.

  5. Run the upgrade script.
    1. At the command prompt, enter ./upgrade.
    2. Press Enter.

    The script displays each IaaS node and all the components installed on it. The script validates each component before installing the upgrade. If there are incorrect values in the upgrade.properties file, the script fails.

    If the Upgrade Shell Script is unsuccessful, review the upgrade.log file.

    You can run the upgrade script again after you fix a problem. Before you run the upgrade script again, recreate the upgrade.properties file, open it, and enter all the required values.

What to do next

Add Users or Groups to an Active Directory Connection