主机描述文件验证

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

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

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

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