Configure the Workspace ONE Access appliance to point to the local Web server to perform an offline upgrade. Then upgrade the appliance.

Prerequisites

Prepare a Local Web Server for Offline Upgrade.

Procedure

  1. Log in to the Workspace ONE Access appliance as the root user.
  2. Run the following command to configure an upgrade repository that uses a local Web server. 
    /usr/local/horizon/update/updatelocal.hzn seturl http://YourWebServer/VM/
    Note: To undo the configuration and restore the ability to perform an online upgrade, you can run the following command. 
    /usr/local/horizon/update/updatelocal.hzn setdefault
  3. Perform the upgrade.
    1. Run the following updatemgr.hzn command. 
      /usr/local/horizon/update/updatemgr.hzn updateinstaller
    2. Run the following command. 
      /usr/local/horizon/update/updatemgr.hzn update

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

    3. Enter y to proceed with the upgrade of the Workspace ONE Access service or enter n to exit the upgrade.
      The prompt gives you the opportunity to consider the following information about virtual apps.
      Important: Citrix, Horizon Connection Server, and ThinApp integrations are not available with the Workspace ONE Access 20.01 connector.
      • To use ThinApp packaged applications, use the VMware Identity Manager connector (Linux) version 2018.8.1.0.
      • To use other Virtual Apps, such Horizon desktops and applications or Citrix published resources, use the VMware Identity Manager connector (Windows) version 19.03.

      You can proceed with the upgrade if you plan to use virtual apps or not. However, the Workspace ONE Access service 20.01 supports virtual apps while the Workspace ONE Access connector 20.01 does not. Therefore, if you plan to use virtual apps with the Workspace ONE Access service 20.01, you cannot upgrade to the Workspace ONE Access connector 20.01.

    4. Run the updatemgr.hzn check command again to verify that a newer update does not exist. 
      /usr/local/horizon/update/updatemgr.hzn check
    5. Check the version of the upgraded appliance. 
      vamicli version --appliance
      The command should display the new version.
    6. Restart the virtual appliance.
      For example, from the command line run the following command.
      reboot

Results

The upgrade is complete.

See Post-Upgrade Configuration.