Migrating Domain And User Accounts

Operator: <migration>

XML Schema: migration_input.xsd, migration_output.xsd, plesk_migration.xsd

Plesk version: Plesk 8.0 for Unix and later | Plesk 8.3 for Windows and later

API RPC version: 1.4.0.0 and higher

Plesk user: Plesk Administrator

Description

Parallels Plesk Panel provides Plesk Migration Manager tool capable of transferring domain, client, and - starting from API RPC v.1.6.0.2 - reseller accounts from one Plesk server (source server) to another (destination server). Migration is a process of such data transfer.

Migrations are always processed by destination Plesk servers, namely, by Plesk servers to which the data is transferred. Therefore, all the migration request packets are sent to the destination Plesk server.

Important: It is important for performing any operation with the migration operator that Plesk Migration Manager is installed on the destination Plesk server.

The following 3 levels of migration are supported by Plesk API RPC: domain migration, client migration, and reseller migration. In case of client and reseller migrations, it is possible to migrate a mere user account, as well as a user account with any amount of his child objects (domains for a client, domains and clients for a reseller).

In case of domain and client migrations, a new owner should be specified, which can be Plesk admin or a reseller (for both domains and clients), or a client (for domains only).

When transferring a domain account within migration of any type, the domain data to be migrated can be restricted to either only mail settings and content, or only Web-site-specific data. If applying such restrictions, the following data is migrated (for each domain):

Supported operations:

• START starts migration of particular client or domain accounts from specified source Plesk server to specified target Plesk server.
• FINISH stops the migration defined by ID.
• GET_FS retrieves information on file system on the specified host (may be important for defining source and destination host directories in request packet starting migration).
• GET_STATUS retrieves the current status of the migration defined by ID.
• CHECK checks whether Plesk Migration Manager is installed on Plesk server.