Search for:

Available article translations:

[How to] How to migrate Plesk data manually with Plesk Migration Manager?

  • Parallels Plesk for Linux/Unix


How to migrate Parallels Plesk Panel (Plesk) data manually with Plesk Migration Manager.


Note: For Confixx users, this article has been superseded by How to migrate Confixx to Plesk 10.4.

To migrate Plesk data manually using Plesk Migration Manager, follow the steps below:

  1. Upload the migration agent and modules to the source server. For example, for Plesk, there are two folders: /usr/local/psa/PMM/agents/shared and /usr/local/psa/PMM/agents/PleskX.

    NOTE: Use another agent directory for migration from a hosting platform different from Plesk. For example, to migrate from cPanel, copy the directories /usr/local/psa/PMM/agents/cPanel9 and /usr/local/psa/PMM/agents/shared.

    Use the command below to copy the Migration Manager:

    destination ~# scp -r /usr/local/psa/PMM/agents/shared/* /usr/local/psa/PMM/agents/PleskX/* root@source:/temporary_migration_directory/ 
  2. Login to the source server and change to directory /temporary_migration_directory. Run Migration Agent ( with the parameter --help to get all available options of the migration agent. Start dumping with the options you need. For example:

    source ~# cd /temporary_migration_directory
     temporary_migration_directory ~# chmod 755
     temporary_migration_directory ~# ./ --dump-all {or --dump-resellers=<list>, --dump-clients=<list>, --dump-domains=<list>}
  3. This will create a dump configuration file, dump.xml, and content dump archives in current directory, /temporary_migration_directory.

  4. On the destination server, create a directory /work_dir and copy the file dump.xml from the /temporary_migration_directory to the directory:

    source ~# scp /temporary_migration_directory/dump.xml root@destination:/work_dir/
  5. On the destination of Parallels Plesk Panel 8, create a sub-directory /work_dir/archives and copy the other content dump files to this directory:

    source ~# scp -r /temporary_migration_directory/* root@destinationPPP8:/work_dir/archives/

    On the destination of Parallels Plesk Panel 9, dump.xml and all other content files should be located in the same directory. So copy all other files into /work_dir/:

    source ~# scp -r /temporary_migration_directory/* root@destinationPPP9:/work_dir/
  6. Deploy the data through the Parallels Plesk Panel GUI.

    Login to Plesk as an administrator and navigate to the Migration Manager page. The page is Server > Migration Manager in Plesk version 8.x, Home > Migration Manager in Plesk version 9.x and Tools & Settings > Migration Manager in Plesk 10.x, 11.x.

    Click the "Start a new migration" button and choose "Data import" in Plesk version 8.x, "Transfer data already processed by the migration agent and located on the local host." in Plesk version 9.x or "Transfer data already processed by the Migration & Transfer Agent and located on the local host" in Plesk 10.x, 11.x.

    In version 8.x, pay attention to the selection of a correct Working directory for data importing. It should be the directory where you put the data to be restored (/work_dir).

    In version 9.x, put the location of the dump.xml file in the "Migration data file location" field. It should be /work_dir/dump.xml.

    In Plesk version 9, restoration logs of manual migration are located on the page Backup Manager at Home > Backup Manager. It is normal to see the Home page after specifying the "Migration data file location." Just click Next.

    If you see an error like the one below, try to change the restoration logs to the '&lt;'symbol to '<' in the dump.xml file.

    Entity: line 1: parser error : Start tag expected, '&lt;'

c81e59b61af9dca603ba03b14aabe968 9f8baf78266b4e54525d1c6bf06305a5 56797cefb1efc9130f7c48a7d1db0f0c

Was this article helpful?
Tell us how we may improve it.
Yes No
Desktop Virtualization
- Parallels Desktop 9 for Mac
- Parallels Transporter
- Parallels Desktop Switch to Mac Edition
- Parallels Desktop for Mac Enterprise Edition
- Parallels Management-Mac for Microsoft SCCM
Server Virtualization
- Parallels Cloud Server
- Parallels Containers for Windows 6.0 Beta
- Parallels Virtuozzo Containers
- Parallels Automation
- Parallels Automation for Cloud Infrastructure
- Parallels Business Automation Standard
- Parallels Virtual Automation
- Parallels Plesk Panel Suite
- Web Presence Builder
- Parallels Plesk Automation
- Parallels Small Business Panel
- Value-added Services for Hosters
- Parallels Partner Storefront
Services & Resources
- Cloud Acceleration Services
- Professional Services
- Support Services
- Training & Certification