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.15 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 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 7.1 or later. You can find the SDK version in the release notes for the app. 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 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 1433 (TCP) and port 1434 (UDP) are unblocked on the Microsoft SQL Server .

Section:

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