Upgrade the software

Google regularly updates the Google Workspace Migrate platform and node software. We recommend that you use the latest version of the software to ensure that you have the most recent Google Workspace Migrate features and fixes. You can upgrade the software manually or using the command-line interface.

Important: Google does not recommend upgrading your databases after the initial installation.

Upgrade the platform & node servers

  1. Sign in to the Google Workspace Migrate platform and make sure no bridges or scans are running.
  2. In the task bar, right-click "" and select Stop Google Workspace Migrate service
  3. Go to Download the installers and 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.

  4. Verify the upgrade was successful by confirming the platform version number matches the node version. To see:
    • 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.
  5. To restart any bridges that you stopped in step 1, run a delta bridge. For details, see Get ready to go live.

Upgrade using the command-line interface (Optional)

Alternatively, you can run an upgrade using the command-line interface. When you upgrade Google Workspace Migrate, the installation parameters are automatically populated with values from your existing installation. You don’t need to include these parameters unless you want to change them.

For details on using the installers on the command-line interface, see:

Related topics

Clear search
Close search
Google apps
Main menu
Search Help Center