You can upgrade your vRealize Orchestrator 8.0 deployment to the latest product version by using a mounted ISO image. Upgrading vRealize Orchestrator 7.x or earlier to vRealize Orchestrator 8.x is not supported.

Prerequisites

  • Perform the required pre-upgrade validation steps. See Pre-upgrade validation steps.
  • Download and mount the ISO image:
    1. Download the ISO image from the official VMware download site.
    2. Connect the CD-ROM drive of the vRealize Orchestrator Appliance virtual machine in vSphere. See the vSphere Virtual Machine Administration documentation.
      Note: After connecting the CD-ROM drive, navigate to your vRealize Orchestrator Appliance VM settings page and verify that Connect At Power On is enabled.
    3. Mount the ISO image to the CD-ROM drive of the vRealize Orchestrator Appliance virtual machine in vSphere. See the vSphere Virtual Machine Administration documentation.
  • vRealize Orchestrator containers must be up and running.

Procedure

  1. Log in to the vRealize Orchestrator Appliance command line as root.
  2. Run the blkid command, and note the device name for the vRealize Orchestrator Appliance CD-ROM drive.
  3. Mount the CD-ROM drive.
    mount /dev/xxx /mnt/cdrom
    Important: For clustered vRealize Orchestrator deployments, you must perform steps 2 and 3 on all nodes in the cluster.
  4. Run the vracli upgrade exec -y --prepare --profile lcm --repo cdrom:// command.
    Note: For vRealize Orchestrator deployments authenticated with vSphere, enter the credentials of the user who registered your deployment with the vCenter Single Sign-On (SSO) service. Alternatively you can also, export the your password as a environmental variable. This can be useful for scenarios where you are using an automated script to upgrade multiple vRealize Orchestrator deployments. To export the SSO password, run the export VRO_SSO_PASSWORD= your_sso_password command.
  5. Power off your vRealize Orchestrator nodes.
  6. Back up your vRealize Orchestrator deployment by taking a virtual machine (VM) snapshot. See Taking a Snapshot.
    Caution: vRealize Orchestrator 8.x does not currently support memory snapshots. Before taking the snapshot of your vRealize Orchestrator deployment, verify that the Snapshot the virtual machine’s memory option is deactivated.
  7. Power on your vRealize Orchestrator deployment.
  8. To finish the upgrade, run the vracli upgrade exec command on one of the nodes in your deployment.

Results

You have upgraded your vRealize Orchestrator deployment. To troubleshoot possible problems with the upgrade, see Troubleshooting vRealize Orchestrator Upgrades.

What to do next

Validate that the vRealize Orchestrator Appliance upgrade was successful by navigating to https:// your_vro_FQDN/vco/api/about. The page should display information about the current vRealize Orchestrator Appliance build, product version, and API version, such as the following:
<ns2:build-number>15962410</ns2:build-number>
<ns2:build-date>2020-04-02T23:00:11Z</ns2:build-date>
<ns2:version>8.1.0.15962410</ns2:version>
<ns2:api-version>5.5.2</ns2:api-version>