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.
The file is validated successfully if all of the below are true:
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
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:
[GLOBAL]
section:validation-mode: warn
[GLOBAL]
section:validation-mode: skip
The validator tool does not check the following: