Migrating from Android (Legacy) Using Migration Tool

The Workspace ONE UEM console provides a migration tool that allows you to complete all prerequisites, select smart groups, configure a custom message for your users, and a dashboard to view a summary page of the migrated devices including eligilibity status and reason for failure or success.

Be sure to have completed the prerequisites to avoid failed migration or users not being able to access all apps they need.

  1. Navigate to Devices > Lifeycle > Legacy Android Migration and select New Migration.

  2. Select desired mode from the Select Migration Type window.

  3. Complete the prerequisites and select Next to move to the Details tab.

    Details The details tab allows you to select the Smart Groups you want to migrate
    Name Enter a friendly name for the migration group.
    Description Enter detailed description of the migration group.
    Smart Groups Specify which smart groups to receive the migration. Smart Groups must include Android (Legacy) deployments. You will receive an error message if a Smart Group is not eligible to be included in the migration.
    Message After users have chosen to upgrade to Android Enterprise, this message will inform them about the migration and prompt them to take action to proceed.
  4. Select Validate. Selecting validate retrieves the number of devices eligible for migration.

  5. Select Continue once all devices are validated for migration. You cannot continue until a valid Smart Group is selected.

    A Summary page displays showing details such as list of devices, migration eligibility, and reason the device is not eligible, when applied

  6. Select Create to create the migration.

    A notification is sent to eligible devices in the selected Smart Groups informing users about migration and prompting them to perform necessary actions to proceed. You can monitor progress on the Legacy Android Migration page. From this page you can select migrations from the list view to display the Migration Details page.

    Note: During Android (Legacy) migration to Android Enterprise, based on the setting in the Scheduler the migration command is automatically sent for the first batch size (300) of devices instantly. After the first 300 devices, the remaining devices will receive the command at the determined intervals. You can view the settings in the UEM console under Admin > Scheduler.

See the Migration Details Page for more information

Migration Details Page

The Migration Details pages allow you to track the migration by migration group, details, status, and list view of devices included in migration.

Legacy Android Migration List View

The Legacy Android Migration List View automatically displays after you create a new migration page. The list view helps you to view all the real-time updates of your end user devices that you are migrating with the Workspace ONE UEM console. The list view allows you to:

  • Edit specific migrations by selecting the radio button on the desired migration friendly name. You can update the migration for new devices added to the Smart Group by selecting Edit.
  • Delete migration groups which prevents devices in queue from migrating from Legacy Android by withdrawing the persistent notification. Android Work Profile is not removed from devices that have already migrated.
  • Search and narrow down a device using the Search option.

Legacy Android Migration Details Page

The Migration Details page is accessed by selecting a migration Friendly Name from the Legacy Android Migration List View with the Workspace ONE UEM console to review the status of the migration. You can view a graphical overview, status, and reason for the migration failing or succeeding.

Use the Migration Details page to push the migration command to the device with the Retry button if the migration fails.

Customize a message to the devices in the migration batch with the Notify button. Configure the field as followed:

  • Message Type: Select the message type (email, SMS, or push) that Workspace ONE UEM uses for this template.
  • Subject: Enter the message subject.
  • Message Body: Enter the message Workspace ONE UEM displays on the end-user devices for each message type.
check-circle-line exclamation-circle-line close-line
Scroll to top icon