Проверка файла описания хостинга

Перед началом миграции с сервера с персональным хостингом файл описания хостинга проверяется на наличие ошибок. По завершении проверки выводится отчет со списком найденных проблем. Вывод результата проверки может выглядеть так:

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
Известные ограничения

Инструмент проверки не анализирует следующее:

  • Правильность доменных имен.
  • Формат имен пользователя для клиентов, системных пользователей, пользователей баз данных и так далее.
  • Длину контактного имени.
  • Уникальность доменных имен, имен пользователей клиентов и системных пользователей и так далее.