Here’s how to troubleshoot problems you might encounter while setting up or installing the Google Workspace Migrate platform.
Error signing in | Platform configuration | Replace platform
Error when signing in
You might get the following error when signing in to the platform:
You have created a new client application that uses libraries for user authentication or authorization that will soon be deprecated. New clients must use the new libraries instead; existing clients must also migrate before these libraries are deprecated
Upgrade to Google Workspace Migrate version 2.3.4.0 or later and try again. For details, go to Upgrade the software.
Troubleshoot platform configuration
If you get a Platform is not configured correctly message when you sign in to Google Workspace Migrate:
- Open the service host logs. Follow the steps at Check the service host logs.
- Scroll to the end of the log and search for potential issues.
- Follow the troubleshooting steps for common issues below.
| Messages | Troubleshooting steps |
| Client is unauthorized to retrieve access tokens using this method, or client not authorized for any of the scopes requested. | If you manually set up a service account, check that you have completed the domain wide delegation steps and authorized the scopes in Manually create a service account. |
|
Check that you have used the correct OAuth client ID in Install the platform manually.
You enter the OAuth Client ID in step 8 of that task. |
| Platform is not configured correctly. | Check the platform server to see whether you installed an agent for a cloud access security broker (CASB) provider.
If so, remove the agent so that traffic can flow correctly. For details, go to Guidelines for setting up a third-party CASB with Google Workspace. |
Replace your platform
If you need to replace your platform instance (for example, due to a hardware failure), you need the encryption key and password used when you set up Google Workspace Migrate. The encryption key is required to access the databases. The platform cannot recover your migration data without it.
If you don’t have the key, re-establish your Google Workspace Migrate setup.
Expand section | Collapse all & go to top
Option 1: I have the encryption keyTo set up a new platform:
- Download and install the platform.
For details, go to Install & set up the platform.
- Open Chrome browser and using the http(s)://localhost:<port> format, enter the URL of the Google Workspace Migrate platform.
- Using the same administrator account that you used to authorize your service account’s client ID, sign in to the platform.
- Click Get started.
- Click I want to recover previous migration data.
- For Password, enter your encryption key password.
- Click Upload CSV file to upload the encryption key or drag the file to the box.
- Click Recover key.
- Using the database settings that you used when you first set up Google Workspace Migrate, complete the steps in Configure database settings.
- Using the callback addresses and nodes that you used when you first set up Google Workspace Migrate, continue through the setup process.
After you complete the recovery process, your new platform can access your migration data.
If you don’t have the key, re-establish your Google Workspace Migrate setup:
- Delete all your VMs for the databases and platform.
- Create VMs and reinstall the software for the databases and platform.
For details, go to Install the databases and Install & set up the platform.
- Reassociate your existing nodes with the new platform.
For details, go to Add the node servers.