Edición del archivo de descripción de hosting

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.

Nota: si el archivo de configuración no incluye la información de acceso para el servidor de origen, las rutas source_webspace_root y source_document_root se tratarán como locales en el servidor de destino.

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:

Variable de plantilla Detalles Aplicable a

{anon_ftp_incoming}

Ruta al directorio disponible para cargas por parte de FTP anónimo

Sólo Linux

{anon_ftp_pub}

Ruta al directorio disponible para la lectura por parte de FTP anónimo

Sólo Linux

{cgi_bin}

Ruta al directorio cgi-bin de la suscripción

Sólo Unix

{document_root}

Ruta a la raíz de documentos de la suscripción - directorio disponible mediante HTTP

Linux y Windows

{logs}

Ruta al directorio con registros (Registros de error y acceso de Apache, etc.)

Linux y Windows

{main_domain_private}

Directorio privado del dominio principal

Sólo Windows

{main_domain_statistics}

Directorio de estadísticas del dominio principal (AWStats/Webalizer/etc)

Sólo Windows

{protected_dirs}

Ruta al directorio con la configuración de los directorios protegidos

Sólo Linux

{ssl_document_root}

Ruta a la raíz de documentos segura de la suscripción - directorio disponible mediante HTTPS

Sólo Windows

{statistics}

Ruta al directorio con los archivos estadísticos (AWStats/Webalizer/etc)

Sólo Linux

{webspace_idn}

Nombre de la suscripción cifrada en punycode

Linux y Windows

{webspace_root}

Ruta a la raíz de la suscripción

Linux y Windows

{webspace}

Nombre de la suscripción

Linux y Windows

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:

Variable de plantilla Detalles Aplicable a

{cgi_bin}

Ruta al directorio cgi-bin de un dominio/subdominio complementario

Sólo Linux

{document_root}

Ruta a la raíz de documentos de un dominio/subdominio complementario

Linux y Windows

{logs}

Ruta al directorio con registros (Registros de error y acceso de Apache, etc.) de un dominio/subdominio complementario

Sólo Linux

{protected_dirs}

Ruta al directorio con la configuración de los directorios protegidos de un dominio/subdominio complementario

Sólo Linux

{site_idn}

Nombre del dominio/subdominio complementario cifrado en punycode

Linux y Windows

{site}

Nombre del dominio/subdominio complementario

Linux y Windows

{statistics}

Ruta al directorio con los archivos estadísticos (AWStats/Webalizer/etc) de un dominio/subdominio complementario

Linux y Windows

{webspace_anon_ftp_incoming}

Ruta al directorio disponible para cargas por parte de FTP anónimo de una suscripción principal

Sólo Linux

{webspace_anon_ftp_pub}

Ruta al directorio disponible para lecturas por parte de FTP anónimo de una suscripción principal

Sólo Linux

{webspace_cgi_bin}

Ruta al directorio cgi-bin una suscripción principal

Sólo Linux

{webspace_document_root}

Ruta a la raíz de documentos de una suscripción principal

Linux y Windows

{webspace_idn}

Nombre de la suscripción principal cifrada en punycode

Linux y Windows

{webspace_logs}

Ruta al directorio con registros (Registros de error y acceso de Apache, etc.) de una suscripción principal

Linux y Windows

{webspace_protected_dirs}

Ruta al directorio con la configuración de los directorios protegidos de una suscripción principal

Sólo Linux

{webspace_root}

Ruta a la raíz de la suscripción

Linux y Windows

{webspace_ssl_document_root}

Ruta a la raíz de documentos segura de la suscripción principal - directorio disponible mediante HTTPS

Sólo Windows

{webspace_statistics}

Ruta al directorio con los archivos estadísticos (AWStats/Webalizer/etc) de la suscripción principal

Sólo Linux

{webspace}

Nombre de la suscripción principal

Linux y Windows

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.

Nota: en el caso de Windows, Plesk Migrator no puede importar el contenido de correo que se haya transferido manualmente al servidor de destino. En el caso del contenido de correo a migrar, es necesario acceder al servidor de origen.

Especificación de la ruta a las bases de datos

Plesk Migrator puede copiar bases de datos MySQL 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

Nota: la migración de bases de datos Microsoft SQL Server sólo es posible si el nombre de host de la instancia de Microsoft SQL Server en el servidor de origen puede resolverse desde el servidor de destino.