Skip Navigation

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.
Check the software version
To migrate data to 
BlackBerry UEM
:
  • The 
    BlackBerry UEM
     instance you are migrating data from must be version 12.8 or later.
  • The 
    Good Control
     (standalone) instance that you are migrating data from must be at version 5.0 or later.
BlackBerry UEM
 synchronization
Good Control
 source server must NOT be integrated with 
BlackBerry UEM
 in any way before beginning migration.
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 (
BES10
 and 
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.”
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. 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 
    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 
    Good Control
     server.
  • The authentication delegate is the same on the source 
    Good Control
     server and the destination 
    BlackBerry UEM
    . You can change the authentication delegate after migration.
Missing entitlements will result in 
BlackBerry Dynamics
 apps being disabled after migration.
Review the 
Good Control
 organization IDs
Custom apps migrate only if the source and destination servers are the same 
Good Control
 organization ID. It is possible to merge two organizations. For more information, visit support.blackberry.com/kb/ to read article KB47626.