10.1. Removing a device from a migration project
For different reasons, a device might have been included in a migration project and notified several times, before you found the reason why this device didn’t start the migration (e.g. because it is unable to connect to the network anymore or was replaced by a new one and does not need to be migrated etc.).
For example, the device with the following status was notified several times, but does not seem to be ‘connected’ to the source system anymore.
In this case, you can manually remove the device from the migration project by marking it as ‘done’. The status will then change from yellow to green.
In this way, you get a better overview of the migration status, as the device is no longer considered as non-migrated and does not unnecessarily increase the number of devices still to be migrated. And you stop the EBF Onboarder from sending further reminders to a device which should not/cannot be migrated.
NOTE:
- As it already received an invitation, a license will be counted for it.
- You cannot remove a device from the migration project which has already started the migration and retired from the source system. The EBF Onboarder will expect the device to restart the migration later until the migration is finished.
Follow these steps to mark a device as ‘done’:
- Roll your mouse over the user’s email address, make a right click and click on ‘Mark as done’:
- Confirm that you want to mark the device as done. You will see a confirmation of the process in a green box on the right side of the dashboard. The status of the device will change to green and the pop-up will provide the information that the device was ‘manually set done by <name of the admin>’, so that you know which admin took the decision:
10.2. Cleaning-up or deleting a migration project
To have a good overview of different migration projects, it can be useful to clean-up or delete a migration project. Both actions will completely stop the migration project.
ATTENTION: The devices of the project won’t be able to use the migration links which they have already received anymore and the EBF Onboarder will stop to send any further reminders. Please carefully read the following chapters before you clean-up or delete a migration project to fully understand the consequences of it.
- Cleaning-up a migration project means to deactivate the project – without completely deleting it.
- After cleaning-up the project, all information related to the project (e.g. information about the devices and about their status) will still be stored in an archive which can be accessed by you.
- This might make sense if a project is almost completed and there are only a few devices left which obviously will not migrate. EBF Onboarder will stop sending them unnecessary reminders. But if you need to investigate the project, you are still able to retrieve necessary information in the logs.
- Deleting a migration project means that the project is completely deleted.
- After deleting the project, the information related to the project (e.g. service account, hostnames, devices, actions of device migration) can’t be accessed anymore. The project will be removed from the dashboard and there is no way to restore a migration project which was deleted in this way.
- This might make sense if the migration project was for example only a test project.
NOTE: Licenses for devices which have not been notified yet will be credited to the total amount of you tenant’s licenses.
10.2.1. Cleaning up a migration project
Cleaning-up a migration project means to deactivate the project – without completely deleting it.
ATTENTION: Please carefully read chapter 10.2 before you clean-up a migration project to fully understand the consequences of it.
NOTE:
- If there are still a lot of devices in the project which need to migrate, we recommend that you set up a reminder (see chapter 05.2) to encourage the users to migrate their devices instead of cleaning-up the project. Otherwise you will lose the licenses that were reserved and consumed for them already.
- If you decided to clean-up a project, please take a screenshot of the number of pending devices and the number of total devices in the project before you do that. This is helpful in case you need to discuss about the number of licenses with you EBF contact.
Follow these steps to clean-up a migration project:
- Before you start to clean-up a project, you can take a look at the summary on the EBF Onboarder dashboard. It includes the number of active migration projects and used and total licenses (‘Available Devices’):
If you take a look at the Migration Project dashboard, you will see a list of all devices – including devices with the status ‘Not Notified’ and ‘Pending’ (see chapter 09.2.1). Devices with the status ‘Not Notified’ and ‘Pending’ will be removed from the project once you clean it up. - Click on ‘Delete Migration’ for the migration project you want to clean-up:
- Click on ‘Clean-up’ – don’t click on ‘Delete’:
- Devices with the status ‘Not Notified’ and ‘Pending’ have now been removed from the project. The number of devices with the status ‘Not Notified’ has been credited to the total amount of you tenant’s licenses. The migration project is still available on the dashboard, but it is an archive.
10.2.2. Deleting a migration project
Deleting a migration project means that the project is completely deleted and that all information related to the project can’t be accessed anymore.
ATTENTION: Please carefully read chapter 10.2 before you delete a migration project to fully understand the consequences of it.
Follow these steps to delete a migration project:
- Before you delete a project, you can take a look at the summary on the EBF Onboarder dashboard. It includes the number of active migration projects and used and total licenses (‘Available Devices’):
If you take a look at the Migration Project dashboard, you will see a list of all devices – including devices with the status ‘Not Notified’ (see chapter 09.2.1). Devices with the status ‘Not Notified’ will be removed from the project once you clean it up. - Click on ‘Delete Migration’ for the migration project you want to delete:
- Click on ‘Delete’ if you are sure that you don’t need this migration project anymore:
ATTENTION: Deleting a project is irreversible.
- The migration project is now totally removed from the tenant and not shown on the dashboard anymore. Devices with the status ‘Not Notified’ have been removed from the project and the number of devices with the status ‘Not Notified’ has been credited to the total amount of you tenant’s licenses.