Google regularly updates the Google Workspace Migrate platform and node software and occasionally updates the database software. You should use the latest version of the software to ensure that you have the most recent Google Workspace Migrate features and fixes.
Check the release notes for information on the latest software release.
How to upgrade the software
If you're upgrading the databases, nodes, and platform, start with the databases, then the nodes, before you update the platform. For details, follow the instructions below.
Upgrade the databases
If you need to update the databases, we let you know in the release notes. You can confirm the version of the databases you're running by going to the CouchDB or MySQL installation folder and checking the details in the Releases file.
To upgrade:
- Back up your database.
- Sign in to the Google Workspace Migrate platform and make sure no bridges or scans are running.
- In the task bar, right-click
and select Stop Google Workspace Migrate service.
- Sign into MySQL and Apache CouchDB and stop the services.
- Go to Download the installers and download the CouchDB and MySQL installers.
- Run the installers as an administrator.
- When the installation completes, restart the MySQL and CouchDB services.
Upgrade the platform & nodes
Expand section | Collapse all & go to top
Option 1: Upgrade manually- Sign in to the Google Workspace Migrate platform and make sure no bridges or scans are running.
- In the task bar, right-click
- Go to Download the installers and download the Google Workspace Migrate installers.
- Run the installers on the platform and on each node.
You can upgrade from any version of Google Workspace Migrate. You don't have to install the next sequential version.
- Verify the upgrade was successful by confirming that the platform version number matches the node version. To see the 2 versions:
- Platform version—In the top-right corner of the Google Workspace Migrate platform, the platform version is next to Help
.
- Node version—In the top-right corner of the Google Workspace Migrate platform, click Servers. The node version is listed under Version.
- Platform version—In the top-right corner of the Google Workspace Migrate platform, the platform version is next to Help
- To restart any bridges that you stopped in step 1, run a delta bridge. For details, see Get ready to go live.
When you upgrade Google Workspace Migrate using the command-line interface, the installation parameters are populated with values from your existing installation. You don’t need to include these parameters unless you want to change them.
For detailed steps on using the installers from the command-line interface, see: