Install the databases

Next, install the MySQL and CouchDB databases. 

The databases serve different purposes and both are required when you set up G Suite Migrate. The CouchDB database stores the detailed logging for each transaction. The MySQL database stores all the links between objects, for both configuration and logging purposes. It also stores the mappings between migrated objects in the source and target environments. 

Before you begin

  • Copy the database installers that you downloaded in the previous step, to the Microsoft Windows servers where you plan to install each database. 
  • Disable Windows automatic updates on the servers. 
  • Ensure the data directory disks have sufficient space. For details, see System requirements

Install MySQL and CouchDB databases

Step 1: Install MySQL

MySQL needs a dedicated server or VM instance to run. Multiple databases cannot be run from the same server. 

On the Windows server:

  1. Run GSuiteMigrate_MySQL_Installer as an administrator.
  2. Accept the license agreement and click Next.
  3. Choose a location for the MySQL installation and click Next.
  4. Choose a location for the MySQL data directory and click Next.

    MySQL stores all database information in the data directory.

  5. (Optional) Specify a PFX file to configure TLS and click Next.

    This step is not required. You can just click Next

  6. Take note of the database credentials.

    Important: Make sure you store the credentials securely. You'll need them when you set up the platform. They might also be required for debugging purposes.

  7. Click Nextand thenInstall.
  8. When the installation is complete, click Finish.

Note: Record the host name or internal IP address of this Windows server. You’ll need it in a later step.

Step 2: Install CouchDB

Note: G Suite Migrate supports CouchDB configured with HTTPS but does not support digest authentication.

On the Windows server:

  1. Run GSuiteMigrate_CouchDB_Installer as an administrator.
  2. Accept the license agreement and click Next.
  3. Choose a location for the CouchDB installation and click Next.
  4. Choose a location for the CouchDB data directory and click Next.

    CouchDB stores all database information in the data directory.

  5. (Optional) Specify a PFX file to configure TLS and click Next.

    This step is not required. You can just click Next

  6. Take note of the database credentials.

    Important: Make sure you store the credentials securely. You'll need them when you set up the platform. They might also be required for debugging purposes.

  7. Click Nextand thenInstall.
  8. When the installation is complete, click Finish.

Note: Record the host name or internal IP address of this Windows server. You’ll need it in a later step.

Next step

Install and set up the platform


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.