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

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

已知局限性

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

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