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:
The hosting description file can be provided in YAML or JSON format. To specify the file format, use the following option:
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.
[lunuxserver] hosting-description: /root/source.yaml os: unix ip: 192.168.1.17 ssh-username: root ssh-password: setup
[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-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.