Devices

If there are any changes such as new devices or labels being added in Core, then go to the Sync Jobs page and click the Sync Now button to sync device information from Core to Migration Portal.

Each entry in the Devices page represents an active mobile device that has been registered with a Core instance as paginated lists. Use the drop-down box to switch between Core instances. This switch to a different Core instance reflects on other pages of the Migration Portal as well.

The Migration Portal credentials are same as the Cloud tenant credentials for which the migration feature has been enabled.


The Devices page lists important information about the devices, such as:

  • User Name
  • Email (Optional)
  • UUID
  • UPN (Optional)
  • Phone
  • Model
  • Registration Type
  • Platform
  • Client Version (Optional)
  • Core Status (Optional)
  • Migration State (Optional)
  • Migration Status - Not Started, In Progress, Migrated, Failed, Halted
  • Labels
  • Last Check In (to Core)
  • Actions

By default, the optional fields (columns) are hidden on this page. Click the gear icon to select (or deselect) any of the fields to be displayed (or hidden) on this page.

You can sort the list of devices by any of the preceding column headers. Click the Refresh icon to refresh the Devices page. The Labels column displays the count of labels associated with the respective device. Click the count to display the list of labels.

In the Actions column, click the eye icon against a device to view all the migration steps with the status of each step in a pop-up window. Click the refresh icon to display the latest status. This page displays the following information:

  • Transitioned State - For example: MI_CLIENT_STARTED

  • Description - For example: Client Check-In Pending
  • Transitioned At - Displays the time-stamp of the corresponding activity

Settings in Cloud

This section describes migration-related notes and additional information in Cloud.

  • The Admin > MDM Certificate page displays multiple MDM certificates (if available) in Cloud and an additional MDM certificate for each migrating Core instance. Each certificate has the Generate CSR and Renew options.
  • The migrated device information is displayed in the device details page in the Device Source field, which represents the Core server from where the device is migrated.
  • In the Devices page, use the Device Source filter to list devices based on their origins. This filter is displayed only if there are more than one cluster identifier values.
  • You can create device groups based on the Device Source field. Based on the requirements, you can configure policies for this device group separately.
  • If a device has device custom attributes associated with it on Core, then the pre-requisites for migration to pass are:
    • The device custom attributes should be created in Cloud (via ETL) before triggering migration for that device.
    • The Cloud API user added should have device management role associated with that user on Cloud.

For more information, see the Cloud product documentation.

Finding and filtering devices

If there are many devices, it can be helpful to use any combination of searches or filters to quickly locate a device entry. You can also skip ahead to display a page of devices or search for a device.

Finding a device

Procedure 

  1. Go to Devices.
  2. In the top left corner, type a search string in the Find Devices field. The matching devices will be displayed on the page.

Filtering devices

Procedure 

  1. Go to Devices.
  2. Click the filter icon to toggle the filter pane.
  3. Select one or more of the following filters (left pane) to narrow the device entries displayed:
    • Core Status - Active. This filter is selected by default.
    • Platform - Android, iOS
    • Migration Status - Not-Started, In-Progress, Migrated, Failed
    • Migration State
    • Labels
    • Migrations
    • Notifications

For example:

  • To display the devices of the iPhone model, enter iPhone in the 'Find Devices' search box.
  • To display the migrated Android devices, select Android from the Platform section and select Migrated from the Migration Status section.
  • To display the devices for which the Migration Status is In-Progress, select In-Progress from the Migration Status section.

Migrating a device to Cloud

Remember:

  • Migration is supported for Android and iOS devices. It is disabled for retired and inactive devices.
  • Migration of devices to Cloud cannot be undone.
  • You can select only one device at a time for migration.

Perform the following steps to migrate a device to Cloud:

  1. Go to Devices.
  2. (Optional) Search or filter to find the device.
  3. Select the device.
  4. Click Migrate.
  5. Click OK to initiate the migration.
  6. Click OK on the confirmation dialog box.

After the device is migrated along with the user, the Migration Status changes to Migrated in the Migration Portal. The status changes to Migrated after a background process involving many steps is completed. You can click the Refresh icon on the page to display the latest status.

In the Actions column of the Devices page, you can perform any of the following actions depending on the device migration status:

  • For a device whose migration has been triggered and failed, click the Retry Failed Migration option.
  • For a device that is stuck during migration (for example, a device that is not in the network, a device that is not checking in), click the eye icon to display a pop-up window. In this window, click the Force Retry Migration option. Use the Force Retry Migration option only if you are sure that the device is still active, but the migration has not been successful. In addition, two immediate Force Retry Migration actions are not allowed.

In Core, the device status is marked as Retired.

In Migration Portal, the device is listed as a new device on the Devices page. The Migration State column represents the stage of the migration process.