主機描述檔驗證

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

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
已知局限性

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

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

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.