If your existing 21.08.X virtual appliance has Internet connectivity, you can upgrade the appliance online.


Note: When you run the 22.09 upgrade script, XPath set is empty messages display in the script. These messages can be ignored.


  1. Log in to the existing Workspace ONE Access 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 check that an online upgrade exists.
    /usr/local/horizon/update/updatemgr.hzn check
  4. Run the following command to update the appliance
    /usr/local/horizon/update/updatemgr.hzn update
  5. Enter y to proceed with the upgrade of the Workspace ONE Access service or enter n to exit the upgrade.
  6. Run the updatemgr.hzn check command again to verify that a newer update does not exist.
    /usr/local/horizon/update/updatemgr.hzn check
  7. Restart the virtual appliance.
  8. Check the version of the upgraded appliance.
    vamicli version --appliance
    The new version is displayed.
  9. After you upgrade all the nodes in your Workspace ONE Access deployment, use the diagnostics dashboard to monitor system information health.
    Note: After upgrading to 22.09, a redesigned Workspace ONE Access console is displayed. The Monitor > Resiliency tab replaces the Dashboard > System Diagnostics Dashboard tab. For details about the Workspace ONE Access console redesign, see Workspace ONE Access Console Features and Settings in the administration guide.
    1. Log in to the Workspace ONE Access console.
    2. Select Monitor > Resiliency to open the diagnostics dashboard.
    3. If your deployment consists of more than one Workspace ONE Access appliance, select the appliance you want to monitor.
    4. Check the status of the various services.
      For example, to check the health of the OpenSearch service, review the Integrated Components section and confirm that the values for the OpenSearch items are as expected. Therefore, the value for OpenSearch - Health is Green, the information about the cluster nodes is accurate, and so on.


The upgrade is complete.

For tasks that might need to be performed after the upgrade to 22.09, see Post-upgrade Configuration of Workspace ONE Access.