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. Considerations: Migrating devices from a source server

Considerations: Migrating devices from a source server

Keep the following things in mind when migrating devices to a destination 
BlackBerry UEM
:
Item
Considerations
Maximum number to migrate
You can migrate a maximum of 2000 devices at a time from a source server. 
Destination 
BlackBerry UEM
Before you migrate devices verify that 
BlackBerry UEM
 supports the device type and OS.
Users
  • The users must exist in the destination 
    BlackBerry UEM
     domain.
  • You must migrate all of a user's devices at the same time.
Managed iOS devices 
  • iOS
     devices must have the latest version of the 
    BlackBerry UEM Client
     installed.
  • iOS
     devices that are assigned an App lock profile can't be migrated because the 
    BlackBerry UEM Client
     can't be opened for the migration
Managed Android devices 
  • Android Enterprise
     devices must have the latest version of the 
    BlackBerry UEM Client
     installed.
  • You can't migrate 
    Android
     devices that have a work profile using a 
    Google
     account or 
    Google
     domain.
Windows
 devices
You can't migrate 
Windows
 devices.
macOS
 devices
You can't migrate 
macOS
 devices.
MDM controls
Devices activated with "
MDM controls
" temporarily lose access to email when the migration begins. Email services are restored when the migration is complete.
Groups
You can't migrate a device that belongs to a shared device group. These devices do not appear in the migration list.
BlackBerry Dynamics
-enabled devices
BlackBerry Dynamics
 apps
  • All 
    BlackBerry Dynamics
     apps compatible with migration are migrated. 
    BlackBerry Dynamics
     apps that are incompatible with migration are wiped when the administrator triggers the migration.
     These apps must be reactivated on the destination 
    BlackBerry UEM
    .
  • 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. 
  • In the Migrate devices screen, the Incompatible containers column displays the number of 
    BlackBerry Dynamics
     apps for each device that can't be migrated and the total number of 
    BlackBerry Dynamics
     apps for each device. Click on the number to see the 
    BlackBerry Dynamics
     apps that are incompatible with migration.
  • Make sure that the user has entitlements for the app on the destination 
    BlackBerry UEM
    . If the app doesn't have the entitlement, after migration, the user will receive a message that the app is blocked.
  • BlackBerry Dynamics
     apps are not migrated if the destination 
    BlackBerry UEM
     already has apps registered for that user.
  • BlackBerry Access for Windows
    , 
    BlackBerry Access for macOS
    , and 
    BlackBerry Enterprise BRIDGE
     are not supported for migration. After the migration is complete, users must re-enroll these apps in 
    UEM
    .
  • 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.
  • Devices with 
    BlackBerry Dynamics
     apps activated by multiple users should not be migrated. 
  • BlackBerry Dynamics
     apps that are locked due to compliance or remotely by the administrator before the migration process may no longer function after migration and may need to be reactivated. If the 
    BlackBerry UEM Client
     is locked, the user may not be migrated.
  • The migration process does not track or guarantee migration of the 
    BlackBerry UEM Client
     and apps activated on a device after that device's data is cached. Administrators should refresh the user cache before each migration. 
Device authentication
  • The authentication delegate must be the same on the source server and the destination 
    BlackBerry UEM
    . You can change the authentication delegate after migration.
Device management
  • BlackBerry Dynamics
    -only devices (no BlackBerry UEM Client) are visible in the source database until all apps are migrated.
Operating system
  • Devices with an unknown operating system are not migrated.
Chat sessions
  • The source 
    BEMS
     server may keep stale 
    Connect
     chat sessions open for up to 24 hours so the user may temporarily appear to be logged into chat from two devices.
  • Unread 
    Connect
     chat messages are deleted during migration. Users should log out of 
    Connect
     before migration.
Users
  • If a user has more than one device with 
    BlackBerry Dynamics
     apps, all the devices are automatically selected for migration.
Unlock keys
  • If a user forgets the password for a 
    BlackBerry Dynamics
     app after migration has been initiated, but before the container has completed migration, the unlock access key must be obtained from the  
    BlackBerry UEM
     source. After the migration is complete the key must be obtained from the destination 
    BlackBerry UEM
    .
After the migration is started
  • iOS
     device users must swipe up to close apps. 
  • To trigger the migration on the device, it is a best practice to first open the app that is configured as the authentication delegate on the device.
  • Not all apps will appear on the launcher until the migration is complete.
  • After migration, app icon arrangements in the launcher are reset to the default.
  • Devices upload the VIP rules, bookmarks, and user certificates to the new server.