Troubleshooting

What common errors in the Primera Labs management site mean and how to fix them.

This page lists the errors you're most likely to see, grouped by where they appear. The quoted text is what the management site shows.

Test Connection errors

"You provided the secret ID instead of the secret VALUE"

You pasted the client secret's Secret ID. Create a new client secret in the app registration and copy its Value, which is only shown once.

"Invalid Client ID"

The Application (client) ID doesn't exist in this tenant. Check that you copied it from the app registration in the right tenant.

"Invalid Tenant ID"

The Directory (tenant) ID is wrong. Copy it again from the app registration's Overview page.

"Expired Client Secret"

Create a new client secret in the app registration. Then edit the workspace and enter the new value.

"Invalid Client Credentials"

The client ID and secret don't match. Check both, and make sure you used the secret Value.

"Cannot read groups", "Cannot read users" or "Missing required scopes"

A Microsoft Graph permission is missing or hasn't been consented to. Add the permissions listed in Workspace Setup, then click Grant admin consent.

"Cannot access organization information"

The app signed in but couldn't read the tenant's organization details. Check that admin consent was granted for all permissions.

"Cannot read tenant subscriptions"

Target tenant only. Primera Labs couldn't check for an Exchange Online subscription. Assign the Exchange Administrator role to the target app. You need this role for migrations anyway. Role assignments can take up to an hour to take effect.

"No active Exchange Online subscription found in the target tenant"

Distribution groups can only be created in a tenant that has Exchange Online. Add a subscription that includes Exchange Online to the target tenant.

Warning: "Exchange.ManageAsApp permission not found"

Target tenant only. Add Exchange.ManageAsApp from Office 365 Exchange Online (under APIs my organization uses), grant admin consent, and assign the Exchange Administrator role. Distribution group migrations fail without it.

Workspace errors

"Starter plan is limited to 1 workspace" or "Free accounts are limited to 1 workspace"

Professional and Elite plans allow any number of workspaces. See Billing and Licenses.

Discovery

No groups are found

  • Check that you ticked the right domains under Select Domains to Discover. Only groups with an email address on a ticked domain are found.
  • Without a plan, discovery stops at 50 groups per workspace.

"License required to read Exchange settings"

The group didn't get a license, so its owners and Exchange settings weren't read. This happens when your plan's licenses are all in use, or when you don't have a plan. Settings are read at migration time instead, if a license is free by then. See Migration Planning.

Owners or settings show as missing, or "UnAuthorized"

The source app can't read Exchange. Add Exchange.ManageAsApp to it and assign it the Global Reader or Exchange Recipient Administrator role. Wait for the role to take effect, then discover again.

Starting a migration

"Active subscription required"

The workspace owner doesn't have an active plan. This also happens if a payment was refunded or disputed. The plan that counts is the workspace owner's, not yours.

"License limit would be exceeded"

The groups you selected that don't have a license yet would take the owner over their limit. Select fewer new groups, or upgrade. Groups that already have a license can be migrated again at no extra cost.

"Insufficient permissions to execute migrations"

Your role is Reporter. Ask an Owner or Admin to make you an Operator. See Team and Roles.

"Failed to save configuration"

Only Owners and Admins can save the Configure tab. Ask one of them to save the configuration, or to change your role.

During a migration

"Waiting for the migration service to start"

Each job starts its own migration service, which can take a few minutes. The job continues on its own, and you can leave the page.

"The migration service did not become ready within 60 minutes"

The groups that were left failed. Start the migration again for those groups. If it keeps happening, email support@primeralabs.tech.

"The migration container hit an error - retrying"

Primera Labs retries a group up to three times when this happens. No action is needed unless the group ends up failing.

Failed groups

Error with "REQUIRED CONFIGURATION" or "TROUBLESHOOTING"

Exchange Online refused the target app. Follow the steps in the message:

  1. Add Exchange.ManageAsApp to the target app registration and grant admin consent.
  2. Assign the Exchange Administrator role to the app.
  3. Wait at least 5 to 10 minutes, then run the migration again.

"Failed to update primary SMTP for cutover"

The Cutover couldn't change the group's address. Usually this means the original domain isn't verified in the target tenant yet. Finish moving the domain, then run Cutover again.

Completed with notes

These groups migrated, but something was left out. Common notes:

  • "N unmapped" or "N owner(s) unmapped": those people have no target user in User Mapping. Map them, then rerun Pre-Stage to add them.
  • "person(s) in owner/sender/moderation settings not mapped": someone named in a setting couldn't be matched to a target user, so they were left out of that setting.
  • "skipped …": Exchange rejected one setting. The other settings were applied.
  • "Group already exists": the group was found in the target, so Primera Labs added missing members and applied settings instead of creating it.

Team invitations

  • "Invitation has expired": invitations last 7 days. Ask for a new one.
  • "Invitation is for a different email address": sign in with the email address the invitation was sent to.
  • "Already a member of this workspace": you already have access. Pick the workspace in the header.

Deleting data

  • "Cancel or wait for running jobs before deleting directory data": wait for the workspace's jobs to finish, or cancel them, and try again.
  • "Transfer or delete the workspaces you own before deleting your account": see Your Data and Retention.

Unexpected errors

If you see "Something went wrong" with a reference code, email support@primeralabs.tech and include the reference. It lets us find the exact error.