Prepare for Your Upgrade

Before you begin your Workspace ONE UEM upgrade, make sure you meet all software and hardware requirements, and that all prerequisites have been completed. Learn more about software and hardware requirements, and how to best prepare your environment for the Workspace ONE UEM upgrade.

The first step of the upgrade process is to take note of your existing Workspace ONE UEM console configurations to ensure that everything is set up and functioning properly before the upgrade procedure. This also includes verifying that you meet the minimum hardware requirements and have the appropriate SQL permissions.

Meet the Hardware and Software Requirements

Meet the requirements needed for a Workspace ONE UEM installation. You can find the hardware, software, and network requirements in the Workspace ONE UEM Recommended Architecture Guide. If your device count has changed since the initial install, reference this documentation to ensure that your application and database servers still meet the minimum requirements.

Important: Do not uninstall previous versions of Workspace ONE UEM software, including Identity Manager and the UEM console. The upgrade process automatically overwrites the relevant files. Uninstalling existing versions deletes previous configurations from your deployment.

Verify Workspace ONE UEM Configurations

Part of preparing your environment for upgrade includes verifying all Workspace ONE UEM configurations have been set according to your specific environment. Learn more about how to verify your Workspace ONE UEM configurations.

1. Log in to the Workspace ONE UEM console and navigate to Groups & Settings > All Settings > System > Advanced > Site URLs. Verify the following Site URLs are correct:

   1. The Console URL should be "https://{CONSOLE_URL}/AirWatch, where {CONSOLE_URL} is the URL of your UEM console Server.

   2. The Device Services URL should be "https://{AW_DS_URL}/DeviceServices, where {AW_DS_URL} is the URL of your Device Services server.

   3. The REST API should be "https://{AW_API_URL}/API, where {AW_API_URL} is the URL of your API server.

   4. For a typical configuration, nothing should appear as "localhost" except for the Google Play Service URL.

2. Navigate to Groups & Settings > All Settings > System > Enterprise Integration > Directory Services.

3. Select the Test Connection button to verify connectivity.

4. Navigate to Groups & Settings > All Settings > Devices & Users > Apple > APNs for MDM. Double-check the expiration date of your APNs certificate and ensure it does not expire before the upgrade procedure completes.

5. Navigate to Hub > Reports & Analytics > Reports > List View and try running a report (for example, Admin User Roles) to ensure reports are working correctly.

Perform SQL Preparations

Before beginning the Workspace ONE UEM upgrade procedures, verify that your SQL database is configured correctly. Learn how to ensure your SQL User has the database db_owner role selected.

1. Open SQL Server Management Studio.

2. Log in to the DB server containing the Workspace ONE UEM database.

3. Locate your DB user in the Object Explorer by navigating to Security > Logins > [Your DB User], right-click, and select Properties.

4. Navigate to the Server Roles tab. Set the server role as Public.

5. Select User Mapping.. Select the Workspace ONE UEM Database. Then, select the db_owner role. For a successful installation, you must ensure that the SQL User you are planning to run the Workspace ONE UEM Database Script with has the database db_owner role selected.

6. Select the msdb database. Then, select the SQLAgentUserRole and db_datareader roles.

   In the event that higher permissions were used for the installation of Workspace ONE or selected during an upgrade please ensure those permissions are carried forward for future upgrades.

7. Stage all the Upgrade files on the Application Servers.