migrate.exe: Mass Migration and Transfer
The migrate utility is used to automatically transfer or migrate a large number of Plesk accounts (subscriptions). This utility offers the functionality of Migration and Transfer Manager via the command-line interface. When you need to migrate or transfer over fifty accounts or subscriptions, doing that using the Plesk UI might be impossible. Using the migrate utility helps to perform such operations.
With this utility you can do the following:
- Check for problems that might occur after transfer (or migration).
- Create lists of Plesk objects to transfer (or migrate).
- Choose type of data to transfer (or migrate).
- Choose whether to replace existing objects.
- Transfer (or migrate) the specified Plesk objects.
- Restore the data of previous migrations (transfers) from temporary files on the destination server.
Usage
migrate <command> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]
Example
The following command transfers the mail-related data of subscriptions example1.com and example2.com from a server with IP address 192.168.1.100 and the administrator's credentials Administrator and mypassword:
migrate.exe --migrate_subscription example1.com,example2.com -host 192.168.1.100 -login Administrator -password mypassword -mail-only Note: Before starting migration or transfer, check for potential problems by using the commands --check-subscription, --check-customer, or --check-reseller.
Commands
| Command | Parameter | Description | Example |
|---|---|---|---|
|
|
|
Displays the list of subscriptions available for transfer (or migration). |
To display a list of all subscriptions on the source server (the user "root" credentials are used to access the source server): migrate.exe -- or migrate.exe -ls -host 192.168.1.100 -login root -password mypassword
Note: In this and the following examples, the user Administrator credentials are used to access the source server. The value Administrator for the |
|
|
|
Displays the list of customers available for transfer (or migration). |
To display a list of all customers on the source server: migrate.exe -- or migrate.exe -lc -host 192.168.1.100 -password mypassword |
|
|
|
Displays the list of resellers available for transfer (or migration). |
To display a list of all resellers on the source server: migrate.exe -- or migrate.exe -lr -host 192.168.1.100 -password mypassword |
|
|
|
Checks the specified subscriptions for potential problems that might occur after transfer (or migration). |
To find out about problems that might occur after transferring the subscriptions example1.com and example2.com: migrate.exe -- or migrate.exe -cs example1.com,example2.com -host 192.168.1.100 -password mypassword |
|
|
|
Checks the specified customers for potential problems that might occur after transfer (or migration). |
To find out about problems that might occur after transferring the customers with usernames customer1 and customer2: migrate.exe -- or migrate.exe -cc customer1,customer2 -host 192.168.1.100 -password mypassword |
|
|
|
Checks the specified resellers for potential problems that might occur after transfer (or migration). |
To find out about problems that might occur after transferring the resellers with usernames reseller1 and reseller2: migrate.exe -- or migrate.exe -cr |
|
|
|
Migrates or transfers the specified subscriptions. |
To transfer the subscriptions example1.com and example2.com from the server with IP address 192.168.1.100 and the administrator's credentials root and mypassword: migrate.exe -- or migrate.exe -ms example1.com,example2.com -host 192.168.1.100 -password mypassword |
|
|
|
Migrates or transfers the specified customers. |
To transfer the customers customer1 and customer2 from the server with IP address 192.168.1.100 and the administrator's credentials root and mypassword: migrate.exe -- or migrate.exe -mc customer1,customer2 -host 192.168.1.100 -password mypassword |
|
|
|
Migrates or transfers the specified resellers. |
To transfer the resellers reseller1 and reseller2 from the server with IP address 192.168.1.100 and the administrator's credentials root and mypassword: migrate.exe -- or migrate.exe -mr |
|
|
|
Migrates (or transfers) data of the entire server. |
To transfer the data of an entire Plesk server: migrate.exe -- or migrate.exe -m -host 192.168.1.100 -password mypassword |
|
|
|
Repeats data restoration from the locally stored files created during the last transfer (or migration). |
To restore data from the local files created during a previous transfer or migration operation: migrate.exe -- or migrate.exe -r |
|
|
|
Displays help on the usage of the utility. |
To view help on the use of the migrate.exe --help or migrate.exe -h |
Options
| Option | Parameter | Description | Example |
|---|---|---|---|
|
|
|
Host name or IP address of the source server. |
To migrate the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword: migrate.exe --
|
|
|
|
The username used to access the source server. By default, Administrator is used, so the option can be skipped. |
|
|
|
|
The password of the source server's administrator. |
|
|
|
|
Migrates only mail configuration and content. |
To migrate mail configuration and content of the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword: migrate.exe -- |
|
|
|
Migrates configuration and content except mail. |
To migrate content and configuration settings (except mail) of the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword: migrate.exe -- |
|
|
|
Path to the temporary location of all downloads on the destination server. |
In order to use the directory C:\temp\ for temporary files when transferring the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword: migrate.exe -- |
|
|
|
Replaces (overwrites) existing objects with identical names. Is |
In order not to replace existing objects when transferring the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword: migrate.exe -- |
|
|
|
Path to the file with IP address mapping. Records in the file must be in the following format: <source IP address> at least one space <destination IP address>. Each record must be placed on a separate line.
If not specified, Plesk generates the mapping automatically. |
To use IP address mapping stored in the file migrate.exe -- |
|
|
|
Specifies a new owner for migrated Plesk objects. If not specified, then all objects on the destination will be owned by the Plesk administrator. |
To transfer the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword and make the user user1 the owner of this subscription: migrate.exe -- |
|
|
|
Do not migrate server settings, migrate only business objects. Used only with the |
To skip global server settings and system services' configuration when transferring the data of an entire Plesk server: migrate.exe -- |
|
|
|
Do not migrate the license key. Used only with the |
In order not to replace installed license key when transferring the data of an entire Plesk server: migrate.exe -- |