Hosting Description File Validation

Before a migration from a server with custom hosting is initiated, the hosting description file is validated for errors. Once the validation is completed, a report is displayed listing all detected issues. Here is what the validation tool output may look like:

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)

If there are errors, the migration is aborted so that the hosting description file can be corrected before proceeding.

What is checked

The file is validated successfully if all of the below are true:

Manual hosting description file validation

To validate your hosting description file without initiating a migration, run the following commands:

/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator validate
"%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat" validate
Disabling hosting description file validation

Under specific circumstances, the validation tool may flag valid entries in the hosting description file as errors. If you believe that the data specified in the hosting description file is correct, you can skip the validation. To do so, edit the configuration file as follows:

validation-mode: warn
validation-mode: skip
Known limitations

The validator tool does not check the following: