El archivo de descripción de hosting puede escribirse en formato YAML o JSON e incluye la lista de clientes, suscripciones, dominios complementarios, buzones y otros a transferir desde el servidor de origen. Si desea examinar archivos de descripción de hosting de muestra, haga clic aquí.Aquí se describe cómo configurar varios parámetros usados con frecuencia que permiten garantizar que la migración se efectúa correctamente.

Especificación de la ruta a los datos de contenido web

Para especificar la ruta a los datos de contenido web, tanto en el servidor de origen como en el servidor de destino, use los siguientes parámetros en la sección de suscripciones:

• source_webspace_root - La ruta absoluta al directorio que contiene todos los archivos a disposición del cliente en el servidor de origen. Puede especificarse únicamente a nivel de la suscripción, como por ejemplo /home/vhosts/example.com.
• source_document_root - La ruta absoluta al directorio que contiene únicamente los archivos entregados mediante HTTP. Puede especificarse únicamente a nivel de la suscripción, del dominio complementario o del subdominio, como por ejemplo /home/vhosts/example.com/httpdocs.
• target_document_root - El directorio que incluirá los archivos entregados mediante HTTP en el servidor de destino. La ruta es relativa al directorio raíz de la suscripción en el servidor de destino. Puede especificarse a nivel de la suscripción, del dominio complementario o del subdominio, como por ejemplo data/www. Si el nombre de dominio es example.com y el directorio de hosts virtuales en Plesk es /var/www/vhosts, la ruta absoluta al directorio de la raíz de documentos en el servidor de destino será /var/www/vhosts/example.com/data/www. De no especificarse, se usará el valor predeterminado de Plesk.

Si desea impedir la migración de determinados directorios o archivos, use la directiva exclude con los parámetros source_webspace_root y source_document_root. Por ejemplo:

subscriptions:
  - name: example.com
    source_webspace_root:
      path: /home/vhosts/example.com
      exclude:
        - /bin
        - /logs

La sintaxis para la escritura de reglas de exclusión es idéntica a la usada por la herramienta rsync. Si desea más información al respecto, consulte la sección Include/Exclude Pattern Rules de la documentación de rsync.

Si desea especificar de forma exacta en qué directorio del servidor de destino se guardará el contenido web de un determinado directorio, use la asignación de archivos web. Por ejemplo:

subscriptions:
  - name: example.com
    target_document_root: data/www
    web_files:
      - source: /home/vhosts/example.com
        target: "{webspace_root}"
      - source: /home/vhosts/example.com/httpdocs
        target: "{document_root}"

La directiva «target» se usa para indicar una ruta absoluta en el servidor de destino o bien un cadena de formato que incluya una o más variables de plantilla de una de las tablas detalladas a continuación.

Las variables de plantilla y su significado para la suscripción, es decir, cuando el nodo web_files se encuentra directamente debajo del nodo de una suscripción:

Las variables de plantilla y su significado para los dominios complementarios y subdominios, es decir, cuando el nodo web_files se encuentra debajo del nodo de un dominio o subdominio complementario:

Especificación de la ruta a los datos de contenido de correo

El mecanismo de transferencia del contenido de correo del servidor de origen al servidor de destino funciona distinto en Linux que en Windows.

En el caso de Linux deberá especificar la información sobre los buzones a migrar en la sección mail_users:

mail_users:
- name: johndoe
  password: 123qwe
  directory: /var/qmail/mailnames/johndoe

Aquí, «directory» especifica la ruta absoluta al sitio donde se guarda el contenido del buzón en el servidor de origen o bien donde se guardaba una vez transferido manualmente al servidor de destino.

En el caso de Windows no es necesario especificar nada en el archivo de descripción de hosting. Todo el contenido de correo se migrará usando los mecanismos de backup y restauración de Plesk.

Especificación de la ruta a las bases de datos

Plesk Migrator puede copiar bases de datos MySQL/MariaDB y Microsoft SQL Server cuando se migren otros paneles. Existen dos formas de copiar contenido de bases de datos:

• Copiar el contenido directamente si se proporciona acceso al servidor de bases de datos.
• Restaurar el contenido mediante un archivo de volcado de datos de una base de datos.

Para copiar el contenido directamente desde un servidor de bases de datos, este debe aparecer en el archivo de configuración de Plesk Migrator. Asimismo, debe proporcionarse la información necesaria para acceder al servidor. Use el parámetro server en la sección databases:

databases:
  - server: mysql-db
    name: wordpress_9
    users:
    - login: exdbuser1
      password: 123qwe
  - server: mssql-db
    name: drupal_2
    users:
    - login: exdbuser2
      password: 123qwe

O bien:

- name: wordpress_9
  dump: wordpress_9.sql
  users:
    - login: exdbuser1

Para restaurar el contenido del archivo de volcado de una base de datos, dicho volcado debe crearse en un formato específico:

• En el caso de MySQL, el volcado puede crearse, por ejemplo, mediante la utilidad mysqldump.
• En el caso de Microsoft SQL Server, use el T-SQL construct «BACKUP».

Para restaurar un volcado, especifique la opción dump como en el siguiente ejemplo:

- name: wordpress_9
  dump: wordpress_9.sql
  user:
    login: exdbuser1