Installing the Migration Tool

The migration tool supports both Unix and Windows platforms, but installation steps are slightly different.

Installation on Unix

To install the the migration tool on a Linux server, log in to the server as root, download and run the installation script from http://autoinstall.plesk.com/panel-migrator/installer.sh:

# wget http://autoinstall.plesk.com/panel-migrator/installer.sh

# chmod +x installer.sh

# ./installer.sh

The installation script will configure a package repository and install the migration tool software packages with its dependencies. The migration tool packages have the panel-migrator prefix.

The tool is installed into the directory /opt/panel-migrator/. In addition, to simplify the use of the tool, the following items are created:

/usr/local/panel-migrator - a symbolic link to /opt/panel-migrator/bin/panel-migrator.

/etc/bash_completion.d/panel-migrator.sh - this provides bash completion for the panel-migrator command line script.

Installation on Windows

To install the migration tool on a Windows server, log in to the server as Administrator, download the ZIP archive from http://autoinstall.plesk.com/panel-migrator/windows/panel-migrator.zip and extract the contents to any directory on the server.

Directory structure

Both Unix and Windows versions of the migration tool share a very similar directory structure:

/opt/panel-migrator/

+-- agents

¦   L-- panel-migrator-agent-12.0.msi 

+-- bin

¦   +-- hosting-checks-generate-xml

¦   +-- hosting-checks-test-xml

¦   +-- panel-migrator				

¦   L-- ppa-move-subscriptions

+-- conf

¦   +-- panel-migrator.yaml

¦   L-- samples

¦       +-- plesk-to-plesk.ini

¦       +-- helm-3-to-plesk.ini

¦       +-- confixx-to-plesk.ini

¦       L-- [...]

+-- lib

¦   L-- python2.7

¦       L-- site-packages

¦           L-- parallels

+-- logs

¦   +-- panel-migrator.debug.log

¦   L-- panel-migrator.log

+-- scripts

¦   L-- panel-migrator-completion.sh

+-- sessions

¦   L-- migration-session

+-- thirdparties

L-- version

The following files and directories are required for the operation of the migration tool:

• bin/panel-migrator - the main command-line script, allows to operate the migration tool and execute all available commands. It is required to perform a migration. On Windows, bin/panel-migrator.bat should be used instead.
• lib - Python modules required by the migration tool.
• conf/samples/ - examples of configuration files for migration from different sources.
• logs/ - log files of the migration tool.
• sessions/ - the directory for keeping temporary files that are created during migration sessions, described further in this guide.
• agents/ - the directory containing backup agents - applications that will be deployed on the source server to collect information about migrated domains.
• thirdparties/ — third-party applications required by the migration tool.
• version - the version of the migration tool is indicated in this file.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.