Чтобы мигрировать с Plesk для Linux, cPanel, Confixx или Pro Control Panel на сервер Plesk для Linux:

  1. Войдите на целевой сервер Plesk по SSH.

  2. Удостоверьтесь в том, что расширение Plesk Migrator установлено. Если нет, установите его, следуя инструкциям, приведенным здесь.

  3. Скопируйте шаблон конфигурационного файла из папки /usr/local/psa/admin/plib/modules/panel-migrator/backend/conf/samples/ в папку /usr/local/psa/var/modules/panel-migrator/conf/. Выберите один из файлов-шаблонов:

    1. Файлы plesk-unix.simple.ini, cpanel.simple.ini, confixx.simple.ini и ppcpl.simple.ini являются базовыми и содержат только самый минимум информации, необходимой для миграции.

    2. Файлы plesk-unix.ini, cpanel.ini, confixx.ini и ppcpl.ini являются полными конфигурационными файлами, снабженными подробными комментариями; они позволяют задать широкое множество настроек миграции.

    Для вашего удобства содержимое конфигурационных файлов-шаблонов приводится здесь. После копирования файла переименуйте его в config.ini.

  4. Редактируйте файл config.ini, чтобы указать IP-адреса исходного и целевого серверов, а также пароль SSH пользователя root на исходном сервере (это минимум, необходимый для миграции). Вы можете также задать дополнительные настройки — более подробную информацию смотрите в разделе Редактирование конфигурационного файла Plesk Migrator.

  5. Создайте список миграции, запустив следующую команду:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list

    Полученный файл будет называться migration-list и будет расположен в папке /usr/local/psa/var/modules/panel-migrator/sessions/migration-session/. Список миграции — это список объектов (учетных записей клиентов и реселлеров, тарифных планов, доменов и так далее), которые будут перенесены.

  6. Отредактируйте список миграции. Вы можете удалить домены, которые не хотите переносить, а также привязать домены, которые собираетесь перенести, к тарифным планам или переназначить их другим учетным записям клиентов.

  7. Укажите новые IP-адреса, которые будут использоваться сайтами, если хотите присвоить их вручную. По умолчанию сопоставление IP-адресов выполняется автоматически. Подробнее о сопоставлении IP-адресов читайте здесь.

  8. Выполните предварительную проверку, запустив следующую команду:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator check

    В результате запуска этой команды будет создан список потенциальных проблем, с которыми вы можете столкнуться во время миграции (если таковые есть). Команду «check» необходимо выполнять каждый раз при изменении списка миграции.

  9. Запустите следующую команду, чтобы начать миграцию:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts

  10. (Рекомендуется) После завершения миграции запустите следующую команду, чтобы проверить работоспособность перенесенных объектов на целевом сервере:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator test-all

Чтобы мигрировать с сервера Plesk для Windows или Helm 3 на сервер Plesk для Windows:

  1. Войдите на сервер через RDP и запустите командную строку.

  2. Удостоверьтесь в том, что расширение Plesk Migrator установлено. Если нет, установите его, следуя инструкциям, приведенным здесь.

  3. Скопируйте шаблон конфигурационного файла из папки %plesk_dir%admin\plib\modules\panel-migrator\backend\conf\samples\ в папку <PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\conf\. Чтобы узнать расположение папки <PLESK_DATA_DIRECTORY> на вашем сервере, запустите следующую команду:

    reg query "HKLM\SOFTWARE\Plesk\PSA Config\Config" /v PRODUCT_DATA_D /reg:32

    Выберите один из файлов-шаблонов:

    1. Файл-шаблон plesk-windows.simple.ini является базовым и содержит только самый минимум информации, необходимой для миграции.

    2. Файл-шаблон plesk-windows.ini является полным конфигурационным файлом, снабженным подробными комментариями, и позволяет задать широкое множество настроек миграции.

    Для вашего удобства содержимое конфигурационных файлов-шаблонов приводится здесь. После копирования файла переименуйте его в config.ini.

  4. Редактируйте файл config.ini, чтобы указать IP-адреса исходного и целевого серверов, а также пароль пользователя administrator на исходном сервере (это минимум, необходимый для миграции). Вы можете также задать дополнительные настройки — более подробную информацию смотрите в разделе Редактирование конфигурационного файла Plesk Migrator.

  5. Создайте список миграции, запустив следующую команду:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat generate-migration-list

    Полученный файл будет называться migration-list и будет расположен в папке <PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\sessions\migration-session\. Список миграции содержит список объектов (учетных записей клиентов и реселлеров, тарифных планов, доменов и так далее), которые будут перенесены.

  6. Отредактируйте список миграции. Вы можете удалить домены, которые не хотите переносить, а также привязать домены, которые собираетесь перенести, к тарифным планам или переназначить их другим учетным записям клиентов.

  7. Укажите новые IP-адреса, которые будут использоваться сайтами, если хотите присвоить их вручную. По умолчанию сопоставление IP-адресов выполняется автоматически. Подробнее о сопоставлении IP-адресов читайте здесь.

  8. (Рекомендуется) Выполните предварительную проверку, запустив следующую команду:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat check

    В результате запуска этой команды будет создан список потенциальных проблем, с которыми вы можете столкнуться во время миграции (если таковые есть).

  9. Запустите следующую команду, чтобы начать миграцию:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat transfer-accounts

  10. (Рекомендуется) После завершения миграции запустите следующую команду, чтобы проверить работоспособность перенесенных объектов на целевом сервере:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat test-all

Using command‑line options with Plesk Migrator

When migrating via the command line, you can pass additional options to the plesk-migrator executable. These options allow you to control logging, profiling, data fetching, content transfer, licensing checks, and more.

To view all available options at any time, run:

plesk-migrator check --help

Common options:

Option

Description

-h, --help

Show help and exit.

--async

Run the command asynchronously.

--quiet

Hide log entries in console output.

--debug

Increase debug level.

--disable-profiling / --enable-profiling

Disable or enable writing the profiling report.

--stop-mark-file <file>

Path to a file whose creation triggers a safe shutdown.

--progress-task-id <id>

Use a specific progress task ID.

Migration behavior options:

Option

Description

--ignore-pre-migration-errors

Continue migration even if pre-migration errors occur (intended for Plesk Support only).

--allocate-only-required-resourcesc

Create new webspaces using only the resources required by the corresponding subscriptions.

--reload-source-data

Fetch data again from the source instead of using cached data.

--skip-services-checks

Do not check the source or target services for potential issues.

--skip-license-checks

Skip license validation on the target server.

Migration list options:

Option

Description

--migration-list-file <file>

Specify the migration list file (default: $session_dir/migration-list).

--migration-list-format <text|json>

Migration list format (text by default).

--ignore-migration-list-errors

Continue the migration even if the migration list contains errors.

IP mapping:

Option

Description

--ip-mapping-file <file>

Provide a file that maps source IPs to target IPs.

Content transfer options:

Option

Description

--skip-copy-web-content

Do not transfer web files.

--skip-copy-mail-content

Do not transfer email messages.

--skip-copy-db-content

Do not transfer database content.

Additional cCopy options:

Option

Description

--copy-mail-settings

Copy server-wide mail settings (supported on Plesk 12.0 and later).

--copy-admin-profile

Copy admin profiles (supported on Plesk 12.0 and later).

--install-extensions

Install missing extensions (supported on Plesk 17.0 and later).

--copy-extensions-settings

Copy server-wide extension settings (supported on Plesk 17.0 and later).