You can perform an online upgrade of the Workspace ONE Access service to a specific version instead of the latest available version, if required.

Note: To upgrade to the latest available version, see Perform an Online Upgrade to Workspace ONE Access 20.01.0.0.

Prerequisites

Procedure

  1. Log in to the VMware Identity Manager virtual appliance as the root user.
  2. Run the following updatemgr.hzn command.
    /usr/local/horizon/update/updatemgr.hzn updateinstaller
  3. Run the following command to update the appliance to a specific version.
    /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/newVersion
    where newVersion is the version to which you want to upgrade.
    • To upgrade to version 2.9.2.1, use:
       /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/2.9.2.1
    • To upgrade to version 3.1, use:
      /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/3.1.0.0
    • To upgrade to version 3.2, use:
      /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/3.2.0.0
    • To upgrade to version 3.2.0.1, use:
      /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/3.2.0.1
    • To upgrade to version 3.3, use:
      /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/3.3.0.0
    • To upgrade to version 19.03, use:
      /usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-updates.vmware.com/vai-catalog/valm/vmw/5C08B358-F782-11E1-8F08-78776188709B/19.03.0.0

    Messages that occur during the upgrade are saved to the update.log file at /opt/vmware/var/log/update.log.

  4. Check the version of the upgraded appliance.
    vamicli version --appliance
    The new version is displayed.
  5. Restart the virtual appliance.
    reboot

Results

The upgrade is complete.