主機描述檔驗證

在從帶有自訂主機的伺服器上遷移之前,會驗證主機描述檔查找錯誤。驗證一完成,就會顯示報告,裡面會列舉所有檢測到的錯誤。以下便是驗證工具輸出資訊的示例:

Hosting description file 'hosting-description.json' validation failed:
- Customer 'Alex Smith': Required element 'login' is not specified
- Subscription 'alex.tld', mailbox 'a@john.tld': mailbox does not have valid domain name. Mailbox should be located under one of these domain names: 'alex.tld'
- Subscription 'jsmith.tld': source document root '/var/www/vhosts/jjsmith.tld' specified in hosting description file does not exist on the source server 'myserver' (10.52.46.227)

出現錯誤會導致遷移中斷,更正了主機描述檔後才能繼續進行。

檢測的項

如果以下項都是真的則會成功完成檔驗證:

  • 主機描述檔存在且可讀。
  • 主機描述檔是有效的 YAML 或 JSON 檔。
  • 主機描述檔的結構是有效的(例如,每位元客戶帳戶都有對應的 “登入名” 和 “密碼” 欄位)。
  • 符合要遷移的物件的某些條件(例如,要遷移的每個郵箱屬於一個域名)。
  • 所有要遷移的檔和目錄都出現在檔案系統上。
主機描述檔手動驗證

若要驗證主機描述檔而不啟動遷移,請運行以下命令:

  • 在 Linux 上:
/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator validate
  • 在 Windows 上:
"%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat" validate
禁用主機描述檔驗證

在某些環境下,驗證工具可能會在主機描述檔中標記有效的項為錯誤。如果您確信主機描述檔中的某些資料是正確的,請跳過驗證。跳過驗證的方式是如下編輯設定檔:

  • 若要驗證工具檢查錯誤,但顯示錯誤為警告資訊(遇到警告不會中斷遷移),請添加以下行到 [GLOBAL] 部分:
validation-mode: warn
  • 若要完全禁用驗證工具,請添加以下行到 [GLOBAL] 部分:
validation-mode: skip
已知局限性

驗證工具不會檢查以下項:

  • 域名的正確性。
  • 客戶、系統使用者、資料庫使用者等的登入名格式。
  • 聯繫姓名的長度。
  • 域名、客戶登入名、系統使用者登入名等的唯一性。