CROSS TENANT LAPTOP MIGRATION GUIDE
1.Cross Tenant Laptop Migration : Introduction
Laptop migration is a new feature introduced by Cloudiway. The goal of this migration task is to migrate Azure AD Joined devices and Azure AD registered devices between 2 Microsoft 365 tenants.
This initial version is covering exclusively Azure AD registered devices. Azure AD Joined devices migration will be available around December 15, 2023.
What does the Azure AD registered device migration do?
It breaks the AD registered device settings: The computers are registered to the source device. This jointure needs to be broken in order to allow registration to the new target tenant.
It breaks the Office licenses (Wold, Excell Powerpoint): Licenses are checked against the source tenant. After migration, these licenses need to be broken in order to be able to installed the licenses of the target tenant
It stops the synchronization of the OneDrive Sync Agent with the source. After migration of the user, the OneDrive Sync agent must not synchronize anymore with the source, in order to be able to setup a synchronization with the target.
2.How does it work?
A local agent needs to be installed on every laptop.
Once installed, the migration can be centrally managed from the Cloudiway console. The administror will trigger or schedule the migration.
The agent will periodically connect to the Cloudiway platform and determine if it’s time to migrate. If so, the migration of the laptop will take place.
3. Cross Tenant Laptop Migration Setup
You need :
- To configure the Cloudiway platform
- To configure the credentials
- To configure the global settings
- To configure the user list
- To deploy the agent
3.1 Credential APIS
The first thing to configure is the credentials that will be used by the local agents to connect to the Cloudiway platform.
For this, login to your primary account and enter your Cloudiway project that will hold your configuration.
Then, in the upper right, click on your Account Name, then Apis.
- Give it a name (for example Intune Migration)
- Select your project
- Give it an expiration date
- Enable Agent Tenant Migration
Click on Create and store the personal access token value for later use.
3.2 Global Settings
3.2 Global Settings
Navigate to Cross Tenant Migration / Local Agent.
Click on Global Settings.
Company Key: is automatically generated by the platform. It is your unique indentifier that deployed agents will use to lookup their configuration.
Agent Version: Enable or disable Automatic Upgrade.
Global Settings: Enable or disable the tasks that you want to be performed on the local computers.
3.3 User List
Navigate to Cross Tenant Migration / Laptop Migration / User List
From the Menu, click on Migration /Get List.
This will discover your list of users and populate the migration list.
3.4 Agent Deployment
You have 2 choices for deploying the local agent.
- You can deploy it using your internal software deployment solution, for instance deployment through Intune or Active Directory GPO.
- You can use the Cloudiway Platform to deploy the agent.
- Send an installation link to your users.
- The users will receive an installation link by mail and they will install themself the agent.
- The agent will enter in automatic execution (Shortcut in startup program)
When the user clicks on the link, he is redirected to the following page:
Installation is done through click Once. The link received by the user forces the execution through Microsoft Edge because not all browsers support Click Once by default and Microsoft Edge does.
Once the installation is complete, it runs automatically in the background and it is accessible in the systray of the computer.
3.5 Migration
Once your userlist is populated and your agents are deployed, you can trigger the migration of the laptop.
From the userlist, select your users and click On Migration / Start
Schedule the migration at the time of your choice or trigger it immediately.
3.6 Monitoring
You can monitor your migration progress from the Agent Device List.
From here you can get the status of migration of each computer, restart or stop them.
If you click on a Computer, you’ll get access to the migration logs.
You can get access to the same information from the User List.
If you click on the number of computers, it opens the list of computers for the selected users, and from here you can start/stop the migration of a computer and access the migration logs.
4. Azure AD Registered Devices migration: What is done exactly?
Azure AD Registered :
It deletes the registry keys that are storing the information about AD registrations
Office licenses:
The agent implements the following steps to reinitialize the Office licenses.
OneDrive Synchronization Agent:
The agent implements the following steps: Reset the OneDrive Sync Client
Outlook Profile
The outlook profile is deleted. After migration, end users can create a new outlook profile. It is very straightforwared and requires only 3 steps documented here:
https://support.microsoft.com/en-us/office/create-an-outlook-profile-f544c1ba-3352-4b3b-be0b-8d42a540459d
5. Troubleshooting
Cloudiway provides an extensive knowledge base with many resources, including common error messages, video guides, and downloads.
Please visit the knowledgebase here: 
Cloudiway Help Center – Cloud Migration & Coexistence
9.1 Support
Support tickets are opened through the platform.
Once logged in, go to your project and select Help, then Support. The chatbot will ask you a couple of questions and then open a support ticket. You will receive an email response to your ticket, and you can continue the support by email.
More information regarding our support program is available here: 
Free Technical Support During Cloud Migration | Cloudiway
6. FAQ
Which licenses doI need?
You need a global Cross-Tenant migration license. It is a yearly subscription plus one.
Please contact sales to get a complete quote.
