Console Guide
Token Pool
On the Dashboard, the Instance Tokens label indicates the number of Tokens assigned to the Instance and their relative states:
- Available for a device to migrate.
- Reserved assigned to a device in transit.
- Consumed by a device succesfully migrated.
Exports
On the Dashboard, the Exports button allow you to generate and download the following reports:
- Migrations Report: list the ongoing Migrations, with their details and the devices count for each statuses.
- Devices Report: list all the devices with their details and timestamped statuses.
Creating a new Migration
You can create a new Migration from the Dashboard:
- Click on the blue "New Migration" button, located on the top right corner.
-
Migration Name: give your Migration a name and a quick description, then click on "Next".
-
Source: provide the following details about your Source Tenant:
- The UEM server type.
- A list of specific fields which depends on the UEM server type chosen above.
- If you have any iOS devices registered in Apple's Automated Device Enrollment (or ADE), you must choose whether you want to initiate a Full Device Wipe on those devices (Apple's Official migration method) or not (Exodus's Standard migration method).
- If you wish to migrate your compatible Android devices (i.e. Android 6+) toward Google's Android Enterprise as Fully Managed by triggering a Full Device Wipe or not.
- Click on "Next"
Hint
For further information about the required Source Tenant's fields, please read Required environment’s information.
For further information about the ADE related options, please read the Apple's ADE Migration Methods section.
For further information about the Android Enterprise options, please read the Google's Android Enterprise Migration Methods section.
- Target: provide the following details about your Target Tenant:
- The UEM server type.
- A list of specific fields which depends on the UEM server type chosen above.
- Click on "Next"
Hint
For further information about the required Target Tenant's fields, please read Required environment’s information.
- Summary: you can see the name of the Migration, the date it was created, information about the host source and information about the host target, as well as the provided description.
Caution
Please pay attention to those details and make sure they are correct.
- Click Save. Exodus will then:
- Look up for the list of users and devices in the Source Tenant.
- Look up for the users in the Target Tenant.
- Create the Device List.
Note
It may take a bit of time, depending on the number of devices you’re about to migrate.
If your Migration includes any ADE devices, you'll need to do some additional steps before you can start the migration of those devices. See the Apple's ADE Migration Methods section for more details.
- Your migration is now ready to begin and you have the option to either:
- Click on the "Start all ready devices" button to start the migration of all your devices in a Ready state at once.
- Click on the
⋮
Group Device Action button to trigger an action on the filtered devices. - Click on the
⋮
Device Action button to trigger an action on the related device.
Hint
For more details on the various device actions you can trigger please read the Device List & Actions below.
Required environment's information
These instructions depend on the type of UEM you're using. Please choose the appropriate one in the list below:
- Workspace ONE Guide
- Microsoft Intune Guide
- MobileIron Cloud Guide
- MobileIron Core Guide
- Jamf Pro Guide
- SOTI MobiControl Guide
Credentials error
If the credentials of the UEM administrator happen to become invalid, Exodus will no longer be able to execute the required commands on the UEM server, thus preventing devices from updating their status and progressing through the migration. When Exodus detects that UEM credentials have become invalid, the faulty Migration is highlighted in red in the Dashboard. In the Migration details, you can renew the credentials by clicking on the red "Credentials" button below the UEM icon.
All the Instance Administrators will be notified by email.
Hint
If you use credentials with a set expiration date, do not hesitate to renew these pre-emptively to avoid any service interruption.
Hint
Beware that a credential error may be triggered for a variety of reasons, such as insufficient permissions to perform a specific command or the UEM server's authentication service being temporarily unavailable. Therefore a Migration marked as having invalid credentials may still be able to proceed normally. Exodus tries to avoid reporting false negatives by ignoring errors that occur for less than 30 seconds.
Device Statuses
The device migration statuses are shown in the Status column of the Device List.
In order to keep the interface as clear as possible, some statuses are grouped and further details are only visible as tooltips (by moving your mouse cursor over the statuses).
Note
The statuses order follows the migration process. Which means the more you go down the list, the more you'll see devices getting closer to being fully migrated.
Here is the list of all the statuses with their tooltips.
Column | Tooltip | Description |
---|---|---|
Failed | {Error description} | The tooltip describes the failure reason. See Failed sub-statuses below. |
Getting ready | Looking for User on Target Tenant | The device was found on the Source Tenant. Exodus is now searching for an associated user on the Target Tenant. |
Ready | – | The device is ready to start its migration: it has a valid user on the Target Tenant. |
Started | User notified | The user has been notified by email to install and open the Companion App. |
Companion App installed | The installation of the Companion App has been detected on the device (iOS only). | |
Companion App launched | The user has opened the Companion App at least once but has not initiated their device migration yet. | |
Unenrolling | – | The device is being unenrolled from the Source Tenant. |
Unenrolled | – | The device has been unenrolled from the Source Tenant. |
Re-enrolling | – | The device is re-enrolling on the Target Tenant. |
Re-enrolled | – | Congratulations! The device is re-enrolled on the Target Tenant. |
Failed sub-statuses
- Duplicate device: The device has already been listed in an existing Migration. As Exodus does not support duplicate devices, you must delete that device record using the Device Action and let the device migrate via the previously created Migration.
- Missing user email: The device does not have an associated user email address. Exodus can not match the user value on both Tenants and therefore does not allow the device migration.
- Target user not found: The listed user in the Source Tenant can not be found in the Target Tenant. Exodus authorise a device migration only if the user is available on both the Source Tenant and Target Tenant.
- Unsupported device: The device is not supported by Exodus. See Support Matrix for compatibilities.
Device List & Actions
An "Export" button will generate and let you download a .csv
file of the Device List. The export follow the filters parameters.
There are some actions you can perform on a device using the ⋮
button available at the end of the device's row.
Note
Some of those actions can be performed on multiple devices at a time, using the same ⋮
button available in the header of the Devices List. Those actions are performed on the eligible filtered devices.
Start migration
This action starts the migration process of a device. It is only available on devices with Ready status. After performing this action, the status changes to Started.
Resend email
This action resends the migration notification email to the user associated to the device. It is only available if the user has already received the original email and has not pushed the Start Migration button on the Companion App yet (status Started).
Send notification
This action sends a notification to the device. It is only available during an ongoing migration, the Companion App must have been installed and started at least once on the device. Depending on the migration state of the device, the content of the notification can change.
Note
On iOS, the user must allow the Companion App to display notifications.
Note
This feature is not available for the macOS platform.
Notification content
Status | Notification title | Notification content |
---|---|---|
Started | Start your migration | Launch the Exodus Companion app to start migrating your device to your new UEM. |
Unenrolling | Continue your migration | Launch the Exodus Companion app to continue migrating your device to your new UEM. |
Unenrolled | Finish your migration | Launch the Exodus Companion app to finish migrating your device to your new UEM. |
Re-enrolling |
Automatic notification
Independently from any admin triggered notifications, the Companion App has a built-in timer which initiate these same notifications automatically on both Android and iOS.
Automatic notifications schedule is as follows:
- Notification 1: t0 + 6 hours
- Notification 2: t0 + 18 hours
- Notification 3: t0 + 42 hours
- Notification 4: t0 + 90 hours
Timer will reset for each status change or at the last triggered notification from the Console Send Notification Device Action.
Remove device
This action delete the device record from the Migration. This action does not trigger the device unenrollment, it is used to remove portential duplicate devices or help the Administrators trim the Device List.