Migrating via the Command Line
To migrate from Plesk for Linux, cPanel, Confixx, or Pro Control Panel to a Plesk for Linux server:
-
Log in to the destination Plesk server via SSH.
-
Make sure that Plesk Migrator is installed. If it is not, install it following the instructions here.
-
Copy a sample configuration file from the
/usr/local/psa/admin/plib/modules/panel-migrator/backend/conf/samples/
directory to the/usr/local/psa/var/modules/panel-migrator/conf/
directory. Choose one of the following sample files:- The
plesk-unix.simple.ini
,cpanel.simple.ini
,confixx.simple.ini
, andppcpl.simple.ini
samples are basic and contain only the bare minimum of information necessary for the migration. - The
plesk-unix.ini, cpanel.ini
,confixx.ini
, andppcpl.ini
are comprehensive and well-commented configuration files enabling you to configure a wide range of migration options.
For your convenience, the contents of the configuration file samples can be found here. After copying the file, rename it to
config.ini
. - The
-
Edit the
config.ini
file to specify the IP addresses of the source and destination servers, and also the source server’s root user SSH password (the bare minimum necessary for migration). You can also specify additional settings - see the Editing the Plesk Migrator Configuration File topic for more information. -
Generate the migration list by running the following command:
/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list
The resulting file will be named
migration-list
and will be placed in the/usr/local/psa/var/modules/panel-migrator/sessions/migration-session/
directory. The migration list is a list of objects (customer and reseller accounts, service plans, domains, and so on) to be migrated. -
Edit the migration list. You can remove the domains you do not want to migrate, assign domains you want to migrate to service plans, or re-assign them between customer accounts.
-
Specify the new IP addresses that should be used by websites, if you want to assign the addresses manually. By default, IP mapping is carried out automatically. You can read about IP mapping in more detail here.
-
Perform the pre-migration check by running the following command:
/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator check
Running the command will produce a list of potential issues you may encounter during the migration (if any). The “check” command must be performed each time when the migration list was changed.
-
Run the following command to begin the migration:
/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts
-
(Recommended) After the migration is finished, run the following command to check the operability of the migrated objects on the destination server:
/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator test-all
To migrate from Plesk for Windows or Helm 3 to a Plesk for Windows server:
-
Log in to the destination Plesk server via RDP and open the command prompt.
-
Make sure that Plesk Migrator is installed. If it is not, install it following the instructions here.
-
Copy a sample configuration file from the
%plesk_dir%admin\plib\modules\panel-migrator\backend\conf\samples\
directory to the<PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\conf\
directory. To find the location of<PLESK_DATA_DIRECTORY>
on your server, run the following command:reg query "HKLM\SOFTWARE\Plesk\PSA Config\Config" /v PRODUCT_DATA_D /reg:32
Choose one of the following sample files:
- The
plesk-windows.simple.ini
sample is basic and contains only the bare minimum of information necessary for the migration. - The
plesk-windows.ini
sample is a comprehensive and well-commented configuration file enabling you to configure various migration options.
For your convenience, the contents of the configuration file samples can be found here. After copying the file, rename it to
config.ini
. - The
-
Edit the
config.ini
file to specify the IP addresses of the source and destination servers, and also the source server’s administrator user password (the bare minimum necessary for migration). You can also specify additional settings - see the Editing the Plesk Migrator Configuration File topic for more information. -
Generate the migration list by running the following command:
%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat generate-migration-list
The resulting file will be named
migration-list
and placed in the<PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\sessions\migration-session\
directory. The migration list contains the list of objects (customer and reseller accounts, service plans, domains, and so on) to be migrated. -
Edit the migration list. You can remove the domains you do not want to migrate, assign domains you want to migrate to service plans, or re-assign them between customer accounts.
-
Specify the new IP addresses that should be used by websites, if you want to assign the addresses manually. By default, IP mapping is carried out automatically. You can read about IP mapping in more detail here.
-
(Recommended) Perform the pre-migration check by running the following command:
%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat check
Running the command will produce a list of potential issues you may encounter during the migration (if any).
-
Run the following command to begin the migration:
%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat transfer-accounts
-
(Recommended) After the migration is finished, run the following command to check the operability of the migrated objects on the destination server:
%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat test-all