A multi-server installation includes a primary server hosting primary and secondary services, along with Redis and PostgreSQL. Additional secondary servers are added to host only the secondary service, allowing for scalable migrations. By default, each secondary service can process 20 concurrent users, so a setup with three servers can handle up to 60 users simultaneously.
Running the secondary service on the primary server is optional. For high-volume migrations, disabling it on the primary server can reduce resource usage and help prevent UI performance issues.
This guide outlines the installation steps for the primary and secondary servers.
Installing the primary server
-
Download the latest installer from the Migrate Release Notes page.
-
Launch the installer on the target server.
-
Agree to the terms and conditions, then click Next.
-
Configure the installation:
-
Select Advanced as the installation type.
- Ensure Install Primary Service and Web Application is checked.
- If you would like to run the secondary service on the primary server too, check Install Secondary Migration Service.
-
Ensure Install PostgreSQL is checked.
-
Enter an email address and password (these will be your login credentials for the web interface).
-
Leave other settings as default.
-
-
Click Install to begin the installation.
Make sure to make note of the database details as they will be required for installing CloudM Migrate on the secondary servers.
Adding Secondary servers
To add a secondary server to Migrate, follow the steps below.
-
Download the latest installer from the Migrate Release Notes page.
-
Launch the installer on the target server.
-
Agree to the terms and conditions, then click Next.
-
Configure the installation:
- Ensure Install Primary Service and Web Application is un-checked.
- Ensure the Install Secondary Migration Service is checked.
-
Ensure Use Existing PostgreSQL is checked.
- Enter the hostname or IP address of the primary server as the Postgre Host.
- Enter 5432 as the Postgre Port.
- Ensure the primary server is accessible on this port from the secondary server.
- Enter the database details (Database, User Name and Password) saved during the primary server installation.
-
Enter an email address and password (these will be your login credentials for the web interface).
-
Set the Set the Maximum Users Per Secondary Service to the number of users you would like to run concurrently on the secondary server.
- By default, this is set to 20 based on the secondary server meeting the system requirements detailed here: CloudM Migrate System Requirements
- Leave the Installation Path as default.
-
Click Install to begin the installation.
The secondary server will now be installed and connected to your primary server.
To install additional secondary servers, repeat the above process on the designated servers.