在从带有自定义主机的服务器上迁移之前，会验证主机描述文件查找错误。验证一完成，就会显示报告，里面会列举所有检测到的错误。以下便是验证工具输出信息的示例：

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

已知局限性

验证工具不会检查以下项：

• 域名的正确性。
• 客户、系统用户、数据库用户等的登录名格式。
• 联系姓名的长度。
• 域名、客户登录名、系统用户登录名等的唯一性。