Prerequisites: Migrating users, devices, groups, and other data from a source BlackBerry server

Item

Prerequisites

Security Administrator permissions

Complete the instructions in this section as a Security Administrator.

Supported versions of the source server

You can migrate from a source UEM on-premises version 12.21 or later.

For UEM Cloud, you can migrate data from UEM on-premises only. The source UEM on-premises instance must be one of the three most recent major version releases. Older versions are not supported for migration.

BlackBerry Connectivity Node (UEM Cloud only)

To support all migration features, you must activate at least one BlackBerry Connectivity Node version 2.13 or later.

UEM company directory connection

Configure the destination UEM company directory connection in the same way that it is configured in the source server. Migration does not work if the company directory connection does not match.

Defragment the databases (UEM on-premises only)

Defragment the source and destination UEM databases before you begin migration. If you are migrating a large number of users or devices, you should defragment the destination UEM database after you migrate each set of users or devices.

BlackBerry UEM Client
  • UEM on-premises: If you plan to migrate the BlackBerry Dynamics-enrolled UEM Client and BlackBerry Dynamics apps, the latest UEM Client must be installed on devices.
  • UEM Cloud: The UEM Client must be version 12.x or later.

BlackBerry Dynamics apps
  • UEM on-premises: All BlackBerry Dynamics apps that you plan to migrate must use BlackBerry Dynamics SDK version 7.1 or later.
  • UEM Cloud: All BlackBerry Dynamics apps that you plan to migrate must use BlackBerry Dynamics SDK version 8.0 or later.
  • BlackBerry Dynamics apps that are not supported for migration are removed from the device during the migration process.

BlackBerry Dynamics app entitlements
  • The destination UEM server must have the same list of BlackBerry Dynamics app entitlements as the source server.
  • Migrated user accounts must be assigned the same list of BlackBerry Dynamics app entitlements on the destination UEM as they have on the source server.
  • The authentication delegate must be the same on the source server and the destination server. You can change the authentication delegate after migration.
  • If the BlackBerry Dynamics profile on the source server allows the UEM Client to be activated by BlackBerry Dynamics, configure the same on the destination server.
  • The authentication delegate must be the same on the source server and the destination UEM server. You can change the authentication delegate after migration.

If entitlements do not match between the source and destination server, BlackBerry Dynamics apps are disabled after migration.

Custom BlackBerry Dynamics apps

Custom apps migrate only if the source and destination servers have the same organization ID. For more information about merging organizations, see KB 47626.

Ports
  • UEM on-premises: Verify that Port 1433 (TCP) and port 1434 (UDP) are unblocked on the Microsoft SQL Server.
  • UEM Cloud: Port 8887 (TCP) must be open between the on-premises UEM server and the BlackBerry Connectivity Node. Verify that the port used by the Microsoft SQL Server that hosts the on-premises UEM database is open and can be accessed by the BlackBerry Connectivity Node (for example, port 1433).