ホスティング記述ファイルの検証
カスタムホスティングを行うサーバから移行を開始する前に、ホスティング記述ファイルにエラーがないか検証が行われます。検証が完了すると、検出された問題をすべて列挙したレポートが表示されます。検証ツールの出力例を以下に示します。
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 ファイルである。
- ホスティング記述ファイルの構造が有効である(たとえば、宣言されたすべての顧客アカウントに対して 'login' フィールドと 'password' フィールドの値が提供されている)。
- 移行対象のオブジェクトについて、特定の条件が満たされている(たとえば、移行対象の各メールボックスがドメインに属している)。
- 移行対象のすべてのファイルとディレクトリがファイルシステムに存在する。
ホスティング記述ファイルを手動で検証する
移行を開始せずにホスティング記述ファイルを検証するには、以下のコマンドを実行します。
- 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
既知の制約事項
検証ツールは以下の項目をチェックしません。
- ドメイン名が正しいか
- 顧客、システムユーザ、データベースユーザなどのログイン名のフォーマット
- 担当者名の長さ
- ドメイン名、顧客ログイン名、システムユーザのログイン名などが重複していないか