Administrators can follow the status of a migration project easily. Depending on the project progress, they can take actions to drive the migration forward.
09.1. EBF Onboarder dashboard
The dashboard of the EBF Onboarder gives you an overview about the progress of all migration projects. You access the dashboard, once you login to the EBF Onboarder platform.
In the header, the number of all active migration projects of your tenant and the number of licenses still available is summarized. The boxes below, summarize the status of each migration project – with the number of devices included and the percentage of devices which are already migrated:
09.2. Migration project dashboard
For each migration project, you can get further details about the migration progress through a migration project dashboard:
Go to the EBF Onboarder dashboard and click on ‘Migration Details’:
General information about the status of your migration can be found in the header:
- The number of devices migrated compared to the total number of devices of the migration project
- The project progress in percent
- The total number of devices included in the migration project
Detailed information about each device are shown in a list. You can see the associated user’s email address, the device name and serial number for each device. And there is a colored icon in the right column which illustrates the migration status. Read more about that in chapter 09.2.1.
09.2.1. Graphic and mouse-over information
There is a colored icon in the right column which illustrates the migration status. When you hover your mouse over the icon, you will see more information for the corresponding device.
ATTENTION for Microsoft Intune as a target system: Please read the separate document to learn more about this. You can find it here.
Color | Status | Invitation sent | Invitation received | Retiring Succeeded | App Store Redirection Succeeded | Pop-up |
Light Grey | User Not Informed: This device was not selected for receiving an invitation. | x | x | x | x | The pop-up confirms that no invitation was sent yet.![]() |
Dark Grey | Mail Queued: The invitation is pending to be sent. This can take up to 15 minutes. | . | x | x | x | The pop-up provides the timestamp of the sending date of the last invitation sent.![]() |
Yellow | Pending, User Informed: The device should have received the invitation by email or notification and the user can start the migration at any time from the device. | . | . | x | x | The pop-up provides the timestamp of the sending date of the last invitation sent.![]() |
Red | Failed: The user started the migration, but the migration failed. For example, it lost power during the retiring process or was not able to retire from the source MDM. The issue must be fixed and the migration must be restarted with the EBF Onboarder, so that the user can continue the migration. | . | . | x | x | The pop-up provides the timestamp of the sending date of the last invitation sent. |
Red/Green | Interrupted: The user has started the migration, but the device migration was interrupted after retiring the device. The user was not sent to the App Store. The issue (e.g. loss of network, loss of access to the browser, migration start from a laptop) must be fixed and the migration must be restarted with the EBF Onboarder, so that the user can continue the migration. | . | . | . | x | The pop-up provides the timestamp of the sending date of the last invitation sent and the retiring date. When automatic reminders are set, this device will receive a reminder with the status ‘partially complete’ (see chapter 05.2.2) which is targeting this situation. |
Green | Success: The user went through the migration process and the device was redirected to the App Store to install or open the registration App of its UEM target system. | . | . | . | . | The pop-up provides the timestamp of the sending date of the last invitation sent, the date of the redirection to the App Store and the retiring date.![]() |
NOTE: The number which appears in the middle of the circle of the status icon explains how often a device received an invitation or reminder. For example, a yellow circle with a ‘2’ means that the device was notified twice and did not start the migration yet. A green circle with a ‘2’ means that the device received the invitation twice before the migration was started and successfully completed.
09.2.2. Check mark information
There are two types of check marks which indicate the status of the device on the source or target system:
- There are check marks which refer to the status of the device detected on the source system (before the migration has started, presented with faded colors):
- There are check marks which refer to the status of the device detected on the target system (when the migration has started or when the device was detected on the target system for registration, presented with bright colors):
NOTE: Only the blue check mark (Registered (Status Cached)) will be shown automatically in the list. If you want to get an information about the other statuses, you need to click on ‘Fetch Status’ on top of the list.
ATTENTION for Microsoft Intune as a target system: Please read the separate document in addition to this one to learn more about this. You can find it here.
Check Mark | Description | Migration started |
![]() | The device is not detected on the source system anymore, has received 5 messages (invitation and reminder messages) and has not been detected on the source system since days. | x |
![]() | The device has received 5 messages (invitation and reminder messages) and is still registered on the source system. It has never started the migration. | x |
![]() | The device was confirmed as registered at 17:26 and the welcome message was sent by the EBF Onboarder to the user’s email address at 18:36. The blue check mark confirms that the device has been registered on the target system and the pop-up provides a timestamp for this (cached). | . |
![]() | The device was confirmed as registered (the last SyncDateTime is the date of the registration). But the welcome message was not sent to the device yet as the so-called Check Worker only checks once per hour whether a device is already detected on the target system. As soon as the Check Worker checks the presence and finds the device, the welcome message will be sent and the status will change to blue. The last notification received was an invitation/reminder message. | . |
09.3. CSV report
The EBF Onboarder provides two types of CSV reports which provide an overview about the migration progress and which can be analyzed with other tools.
09.3.1. Active migrations
You can download a CSV file with details for all active migration projects.
To do that, go to the EBF Onboarder dashboard, click on ‘Download CSV’ and save the file on your computer:
This file will display each active migration of your dashboard in one row and provide information such as:
- The type, host and group/label of the source system (sourceType, sourceHost, sourceSelection)
- The type and host of the target system (targetType, targetHost)
- The total number of devices (userCount)
- The total number of devices which have started to migrate (startedCount)
- The total number of successfully migrated devices (doneCount)
09.3.2. Single migration project
You can download a CSV file with further details for a single migration project.
To do that, go to the migration project dashboard, click on ‘Download’, select ‘Full Export as CSV file’ and save the file on your computer:
This file will for each device provide information such as:
- The email address (email)
- The device ID of the source system (deviceId)
- The device ID of the target system (targetDeviceId)
- The number for the position of the device in the project (selIndex)
- An information if the device was notified (notified)
- An information if a device was migrated successfully (done)
- An information if the device was sent to the App Store for getting its registration App for the new UEM target (notifiedApps)
- The time of the checkin at the target system (checkin)
- The start migration link (link)
- A counter for devices that are present in the migration project (one for each device) to display used/free licenses (cnt)
- The steps of the migration process such as ‘REGISTER’ or ‘RETIRE’ (action) and its success (result)
NOTE:
- There will be several rows for one device – one for each step of the migration progress.
- Instead of an email address there may be a serial number or IMEI in the list. This allows a more precise filtering which is especially useful if a user has several devices.