Editing the Plesk Migrator Configuration File

The Plesk Migrator configuration file contains information about the source and the destination servers, such as the OS type (Linux or Windows), the type of control panel installed on the server, access information, and more. A sample configuration file can be found here. This topic describes how to configure a number of commonly used parameters to ensure that the migration is successful.

Specifying the hosting description file name and format

The information about the hosting description file must be placed in the [GLOBAL] section of the configuration file. To specify the name of the file (if the file is not in the current working directory, specify an absolute path), use the following option:

hosting-description: source.yaml

The hosting description file can be provided in YAML or JSON format. To specify the file format, use the following option:

description-format: yaml
Specifying the access information for source and destination servers

To import web and mail content data to the destination server, you need to either specify the administrative user credentials for both the source and the destination servers, or to move the content to the destination server manually and provide the path to the data in the hosting configuration file. In the latter case, only access information for the destination server is required.

Linux server
[lunuxserver]
hosting-description: /root/source.yaml
os: unix
ip: 192.168.1.17
ssh-username: root
ssh-password: setup
Windows server
[windowsserver]
hosting-description: C:\source.yaml
os: windows
ip: 192.168.1.18
windows-username: Administrator
windows-password: setup
Specifying the access information for database servers

To import database content data to the destination server, you need to either specify the access credentials for the database server or servers, or move database dumps to the destination server manually and provide the path to them in the hosting configuration file. If you choose the former option, specify the access information for every database server you need to migrate databases from, as follows:

MySQL server
[mysql-db]
type: mysql
host: localhost
port: 3306
login: admin
password: 123qwe
Microsoft SQL Server
[mssql-db]
type: mssql
host: 192.168.1.17\MSSQLSERVER2008
port: 1443
login: sa
password: 123qwe

Note: If the hostname of the server on which the Microsoft SQL Server databases are stored does not resolve on the destination server, database migration will fail. Make sure that the hostname can be resolved correctly, or add a corresponding entry to the hosts file on the destination server.

Include all database servers you listed in the [GLOBAL] section of the configuration file, like this:

[GLOBAL]
db-servers: mysql-db, mssql-db
Specifying more than a single source for migration

Plesk Migrator can migrate content from multiple sources in one sitting. To specify more than one source, use the sources parameter in the [GLOBAL] section of the configuration file, like this:

[GLOBAL]
source-type: custom
target-type: plesk
sources: source1, source2, source3
[source1]
...
[source2]
...
 

Leave your comments on this page

Leave your feedback or question on this documentation topic below. For technical assistance, contact your hosting service provider or submit a request to Plesk support. Suggest new features for Plesk here. Discuss general questions on the Plesk forum. All offtopic comments will be removed.