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

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

    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

## Известные ограничения

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

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