Skip Navigation

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
  • In the app settings for all applicable apps, clear the
    Remove the app from the device when the device is removed from BlackBerry UEM
    check box.
    If you attempt to migrate without performing this step, the app is removed and the device may be unenrolled from
    BlackBerry UEM
    . However, even if you clear this check box, the app may still be removed during migration if the setting has not been delivered to the device. For more information on tracking commands being delivered to a device, visit support.blackberry.com/community to read article 102688.
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.
  • BlackBerry Dynamics-enabled devices are always enrolled for BlackBerry Dynamics on the destination server.
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.