若要從Plesk for Linux、cPanel、Confixx或Pro Control Panel 遷移到 Plesk for Linux 伺服器，請如下操作：

  1. 通過 SSH 登入到目的 Plesk 伺服器。

  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 位址，以及原始伺服器 root 使用者的 SSH 密碼（遷移必需的最少量資訊）。您還可以指定其它的設定 - 請參閱 編輯 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 for Windows 或 Helm 3 遷移到 Plesk for Windows 伺服器：

  1. 通過 RDP 登入到目的 Plesk 伺服器並打開命令提示：

  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. The plesk-windows.simple.ini 樣本是基礎檔只包含遷移必需的最少量資訊。

    2. The plesk-windows.ini 樣本是全面且注釋好的設定檔，能夠配置不同的遷移選項。

    為了您的方便，可 在此 找到設定檔樣本的內容。複製該檔後，將其重命名為 config.ini 。

  4. 編輯 config.ini 檔指定源和目的伺服器的 IP 位址，以及原始伺服器管理員使用者的密碼（遷移必需的最少量資訊）。您還可以指定其它的設定 - 請參閱 編輯 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).