Upgrading to a new version of Workspace ONE Assist is simple. Install a new version of Workspace ONE Assist on top of an existing, older version by taking the following steps.


Read through this entire topic BEFORE you begin the installation process.


  1. To ensure that you do not run the old installer file in error, replace the previous version of the installer with the new version in the same folder. All certificates and the install.config file remain the same.
  2. Right-click the installer file and select Run as administrator. The installer prompts you to remove the currently installed components, excluding the database.
  3. Select OK and allow the installer to remove the installed components.
    The AirWatch Remote Management Uninstall Components screen appears.
  4. Select Next and proceed with the uninstall process.
    The Uninstall Components dialog box displays, listing each component it finds of the old version. Each of these components is selected with a green check mark. Notice that the Database or DB does not appear on this screen. This absence is because the old database is used during the upgrade process, which means everything on the database is kept intact in the new version of Workspace ONE Assist.
  5. Select Uninstall and commence uninstalling the old components.
    The uninstallation begins in earnest, displaying each component as it is removed.
  6. Once all the old components are uninstalled, the AirWatch Remote Management Setup prompts you to install new versions of the same components. Select Next to begin.
  7. The Choose Install Location prompt appears. The default installation location appears prepopulated in the text box, which it got from the install.config file. Proceed by selecting Install.
  8. The Get Started with AirWatch screen displays, prompting you to select between Standard Installation (Basic) and Advanced Installation (Custom).
    For details about each installation method, including all steps, screens, text boxes, and options, see Standard (Basic) Installation of Workspace ONE Assist or Advanced (Custom) Installation of Workspace ONE Assist.
  9. The installer reads from the install.config file, applying all the original configurations it finds to the options screens, including SQL server details, user names, Tenant FQDN, certificates, database configurations, and many other configurations. You might not need to modify any of the settings it pulls from this install.config file with the possible exceptions below.
    • Check Database Accounts - Depending upon your configuration and the existing permissions in your environment, the install.config settings might not be populated correctly. For this reason, review the database accounts to ensure that they are correct. Do this review at the first screen, Installer - Basic - Database (Step 1 / 2) by clicking the ...More button which displays the Database Advanced Settings dialog box. Review the apadminuser and apdbuser accounts and respective passwords for accuracy and select Save. Ensuring these accounts are correct now saves you trouble later.
    • SSL Certificate - If you installed a new SSL certificate before running this upgrade, ensure that you integrate it with the upgrade. Review the certificate at the second screen, Installer - Basic - Application (Step 2 / 2) by selecting the SSL Certificate drop-down menu and reviewing the name of the new SSL Certificate. If you have not installed a new SSL certificate before running this upgrade, then just ensure that the existing SSL cert is selected.
    • T10 Certificate - When upgrading from an older version of ARM to a newer version, review the T10 certificate to make sure it is the correct one. If you are in doubt about this certificate's validity, on the Installer - Basic - Application (Step 2 / 2) screen, deselect the check box Apply Default Settings, select the folder button that corresponds to the T10 Certificate, and select the correct certificate file in P7B format.
    • Check the Ports - At the Installer - Basic - Application (Step 2 / 2) screen, select the ...More button which displays the Portal Advanced Settings screen.
      • Ensure all the ports it pulls from install.config are correct for your environment. You should know whether your environment is using port 8443, which is the default connection proctor port for Workspace ONE Assist.
      • If 8443 is not used by your environment, then ensure the CP Port text box is 8443.
      • If 8443 is being used by your environment, then you must select another CP Port in order for Workspace ONE Assist to function. Consider using port 8446 in such a case.
      • Select Save if you have made changes.
  10. After you have reviewed all the settings above and made all applicable adjustments, proceed with the remainder of the installation by selecting the Next button.
    The Installer - Selected Components screen displays.
  11. The Installer - Selected Components page confirms all the installer settings it plans to use for the upgrade. If you want to make changes, you can use the < Prev button to revisit config pages. Otherwise, select Install to begin the upgrade. The installer prompts you again for the installation location. Select Install.
    The database account is validated against the apdbuser and apadminuser accounts. During the upgrade, the Installing Database process displays "Error Message: DBAlreadyExists". This simply means it found the existing database and it has begun to upgrade it.
  12. When the installation finishes, select Next.
  13. The last step is to run the resource pack which consists of configuration files for hundreds of different devices. Ensure the Execute Resource pack check box is selected and click Finish.


The Workspace ONE Assist server has been upgraded.