主机描述文件验证

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

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.