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.