Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry UEM 12.12
  3. Installation and Configuration
  4. 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
:
  • The 
    BlackBerry UEM
     instance you are migrating data from must be version 12.10 or later.
    To migrate 
    BlackBerry Dynamics
    -activated users from  
    BlackBerry UEM
    , both the source and destination servers must be 
    BlackBerry UEM
     version 12.12.1 or later.
  • The 
    Good Control
     (standalone) instance that you are migrating data from must be at version 5.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.  
Defragment the databases (
BlackBerry UEM
)
Defragment the source databases and the destination 
BlackBerry UEM
 database (if one exists) before you begin migration. If you are migrating a large number of users, you should defragment the destination 
BlackBerry UEM
 database after you migrate each set of users. For more information about defragmenting a 
Microsoft SQL Server
 database, visit www.technet.microsoft.com to read the article “Reorganize and Rebuild Indexes.”
BlackBerry UEM Client
For migrations of 
BlackBerry Dynamics
-enrolled 
BlackBerry UEM Client
s and 
BlackBerry Dynamics
 apps from an on-premises 
BlackBerry UEM
 source database, the latest 
BlackBerry UEM Client
 must be installed on the device.
Check the status of 
BlackBerry Dynamics
 apps
Check the 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 7.1 or later.
For migrations from a 
Good Control
 (standalone) instance, all apps must be at 
BlackBerry Dynamics
 SDK version 4.0.0 or later. To determine the version of SDK used for the apps to be migrated, run the container activity report on 
Good Control
. 
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 
    BlackBerry UEM
     or 
    Good Control
     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 
    BlackBerry UEM
     or 
    Good Control
     server.
  • The authentication delegate is the same on the source 
    BlackBerry UEM
     or 
    Good Control
     server and the destination 
    BlackBerry UEM
    . 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 instance 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 are 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 1433 (TCP) and port 1434 (UDP) are unblocked on the 
Microsoft SQL Server
.