Perform an Online Upgrade to Workspace ONE Access 21.08

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

Prerequisites

• The prerequisites listed in Prerequisites for a Workspace ONE Access Online Upgrade are verified.
• Verify that the virtual appliance is powered on and functioning.

Procedure

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. If you are updating multiple virtual appliances in a cluster, you must reindex the Elasticsearch indices on the first node upgraded. If this is the first node that you are updating when you see the warning message to run /usr/local/horizon/update/reindexingIndices.hzn script, enter y.
   When you upgrade other nodes in the cluster, when you see the message, enter n.

   If you are upgrading a single virtual appliance, you do not see this message. The reindexing script runs as part of the upgrade process.

7. Run the updatemgr.hzn check command again to verify that a newer update does not exist.

   /usr/local/horizon/update/updatemgr.hzn check

8. Restart the virtual appliance.
   reboot
9. Check the version of the upgraded appliance.

   vamicli version --appliance

   The new version is displayed.
10. After you upgrade all the nodes in your Workspace ONE Access deployment, use the diagnostics dashboard to monitor system information health.
    1. Log in to the Workspace ONE Access console.
    2. Select Dashboard > System 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 Elasticsearch service, review the Integrated Components section and confirm that the values for the Elasticsearch items are as expected. Therefore, the value for Elasticsearch - Health is Green, the information about the cluster nodes is accurate, and so on.

Results

The upgrade is complete.

See Post-Upgrade Configuration of Workspace ONE Access.