You can upgrade your vRealize Orchestrator 8.x or later 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

  • Verify that your vRealize Orchestrator upgrade path is supported. See the VMware Product Interoperability Matrix.
  • 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.
  • Before upgrading vRealize Orchestrator deployments authenticated with vRealize Automation, verify that the vRealize Automation product version matches the version of vRealize Orchestrator you are upgrading to. For example, if you are upgrading to vRealize Orchestrator 8.9, you must verify you are using vRealize Automation 8.9 as a authentication provider.
  • If you are upgrading vRealize Orchestrator from a version older than 8.8, you might have to activate basic authentication. For more information, go to Activate Basic Authentication.

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. Back up your vRealize Orchestrator deployment by taking a virtual machine (VM) snapshot. See Take a Snapshot of a Virtual Machine.
    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.
  5. To finish the upgrade, run the vracli upgrade exec -y --profile lcm --repo cdrom:// command on one of the nodes in your deployment.
    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.

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 running the vracli version command in the command line of the appliance. By running this command, you can validate the product version and build number of the vRealize Orchestrator Appliance.