Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry UEM 12.18
  3. Installation and configuration
  4. Cloud Configuration
  5. Migrating users, devices, groups, and other data from a source server
  6. Prerequisites: Migrating users, devices, groups, and other data from a source server

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

Complete the following prerequisites before you begin a migration.
Prerequisite
Details
Log in
Log in to
BlackBerry UEM
 as a Security Administrator. Only one administrator should perform migration activities at any one time.
Check the software version
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
To use all of the migration features, activate at least one
BlackBerry Connectivity Node
 instance running version 2.13 or later.
Configure the
BlackBerry UEM
 company directory connection
Configure the destination
BlackBerry UEM
 company directory connection in the same way that it is configured in the source. For example, if the source is configured for
Active Directory
 integration and it is connected to the example.com domain, configure the destination
BlackBerry UEM
 for
Active Directory
 integration and connect it to the example.com domain.
Migration does not work if the company directory on the destination server does not match the company directory on the source server. 
BlackBerry UEM Client
The
BlackBerry UEM Client
 must be at
BlackBerry Dynamics
 SDK version 8.0 or higher. You can find the SDK version in the release notes for the app.
Check the status of
BlackBerry Dynamics
 apps
Check the
BlackBerry Dynamics
 SDK version of all
BlackBerry Dynamics
 apps you want to migrate. This includes first-party apps,
BlackBerry Dynamics
 apps, third-party ISV apps, and internal custom apps.
For migrations from an on-premises
BlackBerry UEM
 source database, all
BlackBerry Dynamics
 apps must be at
BlackBerry Dynamics
 SDK version 8.0 or later. You can find the SDK version in the release notes for the app.
BlackBerry Dynamics
 apps that are not supported for migration are wiped from the device when the administrator starts the migration.
Check the status of
BlackBerry Dynamics
 app entitlements
Make sure that:
  • The destination
    BlackBerry UEM
     has the same list of
    BlackBerry Dynamics
     app entitlements as the source server.
  • All migrated user accounts are assigned the same list of
    BlackBerry Dynamics
     app entitlements on the destination
    BlackBerry UEM
     as they have on the source server.
  • The authentication delegate is the same on the source server and the destination server. You can change the authentication delegate after migration.
  • The user's
    BlackBerry Dynamics
     profile allows the
    BlackBerry UEM Client
     to be activated by
    BlackBerry Dynamics
    , if the user's
    BlackBerry UEM Client
     on the source server is also activated by
    BlackBerry Dynamics
    .
Missing entitlements will result in
BlackBerry Dynamics
 apps being disabled after migration.
Review organization IDs
Custom apps migrate only if the source and destination servers have the same organization ID. It is possible to merge two organizations. For more information, visit support.blackberry.com/community to read article 47626.
Check that the required ports are not blocked by a firewall or in use by other software
Ensure that port 8887 (TCP) is open between the on-premises
BlackBerry UEM
 server and the
BlackBerry Connectivity Node
. The on-premises server listens on port 8887 for connections from the
BlackBerry Connectivity Node
.
Ensure that the port used by the
Microsoft SQL Server
 that hosts the on-premises
BlackBerry UEM
 database is open and can be accessed by the
BlackBerry Connectivity Node
 (for example, port 1433).