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 description 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]
...