Quick Start
The whole distribution group migration, from sign-up to Cutover, on one page.
This page covers the whole process in order. Each step links to a page with the details.
1. Sign up and choose a plan
Create an account at manage.primeralabs.tech. You can create a workspace and discover groups without a plan, but you need one to migrate.
To buy a plan, open the license card on the Dashboard and click View Plans. See Billing and Licenses.
2. Create a workspace
Go to Workspaces → New Workspace and follow Guided Setup. You'll create an app registration in each tenant, add the API permissions, grant admin consent, create a client secret and assign a directory role.
Then open the workspace for editing and click Test Connection for both tenants.
See Workspace Setup.
3. Discover your groups
Go to Distribution Groups and click Discover Groups. Choose the source domains whose groups you want, then click Discover Groups again.
Owners and Exchange settings are read in the background after discovery. Discovering groups uses licenses, so read Migration Planning first if you have more groups than your plan covers.
4. Map your users
Discovery adds every group member and owner to User Mapping. Each one needs a target user. Use Dynamic Mapping to match people by display name or email, import a CSV for the rest, and check that the unmapped count is zero.
See User Mapping.
5. Run the Pre-Stage migration
Back on Distribution Groups:
- Select the groups and click Continue to Configure.
- Choose a Target Domain the target tenant already owns.
- Set Migration Type to Pre-Stage Migration.
- Click Save Configuration, then Start Migration.
The job runs in the background. You can follow it on the page or under Migration Jobs.
See Running a Migration.
6. Move your email domain
Move your email domain from the source tenant to the target tenant, and verify it in the target tenant. You do this in Microsoft 365, not in Primera Labs.
You can rerun Pre-Stage as often as you like before this. Each run adds new members and reapplies owners and settings, and doesn't use extra licenses.
7. Run the Cutover migration
Select the same groups, set Target Domain to the same domain you used for Pre-Stage, set Migration Type to Cutover Migration, and start the job.
Each group's primary address changes back to its original address. The Pre-Stage address and the source group's other email addresses are kept as aliases.
8. Check the results
Go to Migration Jobs and click Details on the finished job. Groups are listed under Migrated, Completed with notes or Failed. Notes tell you about anything skipped, such as unmapped members.
See Troubleshooting for common failures.
Was this page helpful?
Something wrong or out of date?