Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry UEM 12.19
  3. UEM Configuration Guide
  4. Migrating users, devices, groups, and other data from a source server
  5. Prerequisites: Migrating users, devices, groups, and other data from a source BlackBerry server

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

Item
Prerequisites
Security Administrator permissions
Complete the instructions in this section as a Security Administrator.
Supported versions of the source server
For
UEM
 on-premises, you can migrate from the following source servers:
  • UEM
     on-premises 12.17 or later
  • Good Control
     (standalone) 5.0 or later
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
 (
UEM Cloud
 only)
To support all migration features, you must activate at least one
BlackBerry Connectivity Node
 version 2.13 or later.
UEM
 company directory connection
Configure the destination
UEM
 company directory connection in the same way that it is configured in the source server. Migration does not work if the company directory connection does not match.
Defragment the databases (
UEM
 on-premises only)
Defragment the source and destination
UEM
 databases before you begin migration. If you are migrating a large number of users or devices, you should defragment the destination
UEM
 database after you migrate each set of users or devices.
BlackBerry UEM Client
  • UEM
     on-premises: If you plan to migrate the
    BlackBerry Dynamics
    -enrolled
    UEM Client
     and
    BlackBerry Dynamics
     apps, the latest
    UEM Client
     must be installed on devices.
  • UEM Cloud
    : The
    UEM Client
     must be version 12.x or later.
BlackBerry Dynamics
 apps
  • UEM
     on-premises: All
    BlackBerry Dynamics
     apps that you plan to migrate must use
    BlackBerry Dynamics
     SDK version 7.1 or later. For migrations from
    Good Control
    , apps must use SDK version 4.0.0 or later.
  • UEM Cloud
    : All
    BlackBerry Dynamics
     apps that you plan to migrate must use
    BlackBerry Dynamics
     SDK version 8.0 or later.
  • BlackBerry Dynamics
     apps that are not supported for migration are removed from the device during the migration process.
BlackBerry Dynamics
 app entitlements
  • The destination
    UEM
     server must have the same list of
    BlackBerry Dynamics
     app entitlements as the source server.
  • Migrated user accounts must be assigned the same list of
    BlackBerry Dynamics
     app entitlements on the destination
    UEM
     as they have on the source server.
  • The authentication delegate must be the same on the source server and the destination server. You can change the authentication delegate after migration.
  • If the
    BlackBerry Dynamics
     profile on the source server allows the
    UEM Client
     to be activated by
    BlackBerry Dynamics
    , configure the same on the destination server.
  • The authentication delegate must be the same on the source server and the destination
    UEM
     server. You can change the authentication delegate after migration.
  • For migrations from a
    Good Control
     instance, devices with a device authentication delegate of
    Good for Enterprise
     are not migrated. After removing
    Good for Enterprise
     as the authentication delegate, refresh the cache before continuing with the migration.
If entitlements do not match between the source and destination server,
BlackBerry Dynamics
 apps are disabled after migration.
Custom
BlackBerry Dynamics
 apps
Custom apps migrate only if the source and destination servers have the same organization ID. For more information about merging organizations, see KB 47626.
Ports
  • UEM
     on-premises: Verify that Port 1433 (TCP) and port 1434 (UDP) are unblocked on the
    Microsoft SQL Server
    .
  • UEM Cloud
    : Port 8887 (TCP) must be open between the on-premises
    UEM
     server and the
    BlackBerry Connectivity Node
    . Verify that the port used by the
    Microsoft SQL Server
     that hosts the on-premises
    UEM
     database is open and can be accessed by the
    BlackBerry Connectivity Node
     (for example, port 1433).