Install the databases

Next, install the MySQL and CouchDB databases. You can install the databases manually or using the command-line interface.

The databases serve different purposes and both are required when you set up Google Workspace 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. 
  • Keep your Windows servers updated, but we recommend turning off automatic updates during a migration so the process isn't interrupted. 
  • Ensure the data directory disks have sufficient space. For details, see System requirements
  • MySQL needs a dedicated server or VM instance to run. Multiple databases cannot be run from the same server.

Install MySQL database

Option 1: Install MySQL manually

On the Windows server:

  1. Run GoogleWorkspaceMigrate_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.

Option 2: Install MySQL using the command-line interface

On the Windows server:

  1. Run PowerShell as administrator.
  2. Run the MySQL installer using the parameters from the tables below.

    Note: The installer automatically chooses the preselected setup options (below).

Preselected setup options

When running on the command line, the installer automatically chooses these setup options:

  • MySQL install location (C:\MySQL)
  • MySQL data directory (C:\MySQL_data)

Command-line parameters

Parameter Description
/RootPassword Sets the root password for MySQL
/AdminPassword Sets the password for the migrate user

To use the installer noninteractively, use the following command-line parameters:

Parameter Description
/SP- Turns off prompts at the beginning of a setup
/VERYSILENT Turns off the setup wizard and windows during the installation process
/SUPPRESSMSGBOXES Suppresses all message boxes
/NORESTART Prevents a system restart during installation

Note: For more details on the command-line parameters available, consult the documentation for Inno Setup.

Example

GoogleWorkspaceMigrate_MySQL_Installer.exe /SP- /SILENT /SUPPRESSMSGBOXES /NORESTART /RootPassword=MyRootPassword /AdminPassword=MigrateUserPassword

Install CouchDB

Option 1: Install CouchDB manually

On the Windows server:

  1. Run GoogleWorkspaceMigrate_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.

Option 2: Install CouchDB using the command-line interface

On the Windows server:

  1. Run PowerShell as administrator.
  2. Run the CouchDB installer using the parameters from the tables below.

    Note: The installer automatically chooses the preselected setup options (below).

Preselected setup options

When running on the command line, the installer automatically chooses these setup options:

  • CouchDB install location (C:\CouchDB)
  • CouchDB data directory (C:\CouchDB_data)

Command-line parameters

Parameter Description
/AdminPassword Sets the password for the migrate user

To use the installer noninteractively, use the following command-line parameters:

Parameter Description
/SP- Turns off prompts at the beginning of a setup.
/VERYSILENT Turns off the setup wizard and windows during the installation process.
/SUPPRESSMSGBOXES Suppresses all message boxes.
/NORESTART Prevents a system restart during installation.

Note: For more details on the command-line parameters available, consult the documentation for Inno Setup.

Example

GoogleWorkspaceMigrate_CouchDB_Installer.exe /SP- /SILENT /SUPPRESSMSGBOXES /NORESTART /AdminPassword=MigrateUserPassword

Next step

Install & 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.

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
false