Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry UEM 12.13
  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
To migrate data to 
BlackBerry UEM
 Cloud, the on-premises 
BlackBerry UEM
 instance you are migrating data from must be at 
BlackBerry UEM
 version 12.13 or later.
BlackBerry Connectivity Node
To use all of the migration features, activate at least one 
BlackBerry Connectivity Node
 instance running version 2.8.0 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).