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.exe <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:

plesk bin 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

--list-subscriptions or -ls

 

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):

plesk bin migrate.exe --list-subscriptions -host 192.168.1.100 -password mypassword

or

plesk bin 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 -login option is used by default, so the option is skipped.

--list-customers or -lc

 

Displays the list of customers available for transfer (or migration).

To display a list of all customers on the source server:

plesk migrate.exe --list-customers -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -lc -host 192.168.1.100 -password mypassword

--list-resellers or -lr

 

Displays the list of resellers available for transfer (or migration).

To display a list of all resellers on the source server:

plesk bin migrate.exe --list-resellers -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -lr -host 192.168.1.100 -password mypassword

--check-subscription or -cs

<name1 [,name2,name3, ...]>

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:

plesk bin migrate.exe --check-subscription example1.com,example2.com -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -cs example1.com,example2.com -host 192.168.1.100 -password mypassword

--check-customer or -cc

<login1 [,login2,login3, ...]>

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:

plesk bin migrate.exe --check-customer customer1,customer2 -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -cc customer1,customer2 -host 192.168.1.100 -password mypassword

--check-reseller or -cr

<login1 [,login2,login3, ...]>

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:

plesk bin migrate.exe --check-reseller reseller1,reseller2 -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -cr reseller1,reseller2 -host 192.168.1.100 -password mypassword

--migrate-subscription or -ms

<name1 [,name2,name3, ...]>

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:

plesk bin migrate.exe --migrate-subscription example1.com,example2.com -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -ms example1.com,example2.com -host 192.168.1.100 -password mypassword

--migrate-customer or -mc

<login1 [,login2,login3, ...]>

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:

plesk bin migrate.exe --migrate-customer customer1,customer2 -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -mc customer1,customer2 -host 192.168.1.100 -password mypassword

--migrate-reseller or -mr

<login1 [,login2,login3, ...]>

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:

plesk bin migrate.exe --migrate-reseller reseller1,reseller2 -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -mr reseller1,reseller2 -host 192.168.1.100 -password mypassword

--migrate-server or -m

 

Migrates (or transfers) data of the entire server.

To transfer the data of an entire Plesk server:

plesk bin migrate.exe --migrate-server -host 192.168.1.100 -password mypassword

or

plesk bin migrate.exe -m -host 192.168.1.100 -password mypassword

--retry-from-cache or -r

 

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:

plesk bin migrate.exe --retry-from-cache

or

plesk bin migrate.exe -r

--help or -h

 

Displays help on the usage of the utility.

To view help on the use of the migrate utility:

plesk bin migrate.exe --help

or

plesk bin migrate.exe -h

Options
Option Parameter Description Example

-host or -h

<source host>

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:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword

 

-login or -l

<administrator's login>

The username used to access the source server. By default, Administrator is used, so the option can be skipped.

-password or -p

<administrator's password>

The password of the source server's administrator.

-mail-only

 

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:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword -mail-only

-web-only

 

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:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword -web-only

-local-cache-path

<path>

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:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword -local-cache-path "C:\temp\"

-replace-existing-objects

true|false

Replaces (overwrites) existing objects with identical names. Is true by default.

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:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword -replace-existing-objects false

-ip-mapping

<path to file>

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 C:\migration\mapping.txt when transferring the subscription example1.com from the server with IP address 192.168.1.100 and the administrator's password mypassword:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword -ip-mapping "C:\migration\mapping.txt"

-owner

<login>

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:

plesk bin migrate.exe --migrate-subscription example1.com -host 192.168.1.100 -password mypassword -owner user1

-accounts-only

 

Do not migrate server settings, migrate only business objects.

Used only with the --migrate-server command.

To skip global server settings and system services' configuration when transferring the data of an entire Plesk server:

plesk bin migrate.exe --migrate-server -host 192.168.1.100 -password mypassword -accounts-only

-skip-license

 

Do not migrate the license key.

Used only with the --migrate-server command.

In order not to replace installed license key when transferring the data of an entire Plesk server:

plesk bin migrate.exe --migrate-server -host 192.168.1.100 -password mypassword -skip-license

  

 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.