Validación del archivo de descripción de hosting

Antes de iniciar la migración de un servidor con hosting personalizado, se procede con la validación del archivo de descripción de hosting para comprobar la existencia de errores. Una vez completada esta validación, se obtiene un informe que detalla todas las incidencias detectadas. Un ejemplo de la salida de la herramienta de validación podría ser el siguiente:

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)

De existir errores, la migración se aborta para que así pueda corregirse el archivo de descripción de hosting antes de continuar.

¿Qué se comprueba?

El archivo se valida correctamente si se cumple todo lo siguiente:

  • El archivo de descripción de hosting existe y puede leerse.
  • El archivo de descripción de hosting es un archivo YAML o JSON válido.
  • La estructura del archivo de descripción de hosting es válida. Por ejemplo, si se rellenan los campos 'login' y 'password' para cada una de las cuentas de cliente.
  • Se cumplen ciertas condiciones para los objetos a migrar. Por ejemplo, cada buzón a migrar pertenece a un dominio.
  • Todos los archivos y directorios a migrar están presentes en el sistema de archivos.
Validación manual del archivo de descripción de hosting

Para validar su archivo de descripción de hosting sin iniciar ninguna migración, ejecute los siguientes comandos:

  • En Linux:
/usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator validate
  • En Windows:
"%plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat" validate
Desactivación de la validación del archivo de descripción de hosting

Bajo algunas circunstancias, la herramienta de validación puede marcar entradas válidas en el archivo de descripción de hosting como errores. Si cree que los datos indicados en el archivo de descripción de hosting son correctos, puede omitir la validación. Para ello, edite el archivo de configuración de la siguiente forma:

  • Si desea que la herramienta de validación compruebe la existencia de errores pero los muestre como advertencias (la detección de advertencias no aborta la migración), añada la siguiente línea a la sección [GLOBAL]:
validation-mode: warn
  • Si desea desactivar la herramienta de validación de forma completa, añada la siguiente línea a la sección [GLOBAL]:
validation-mode: skip
Limitaciones conocidas

La herramienta de validación no comprueba lo siguiente:

  • La corrección de los nombres de dominio.
  • El formato de los nombres de usuario de los clientes, usuarios del sistema, usuarios de bases de datos, etc.
  • Longitud del nombre de contacto.
  • La unicidad de los nombres de dominio, nombres de usuario de cliente y de usuario del sistema.