Para efectuar una migración de Plesk para Linux, cPanel, Confixx o Pro Control Panel a un servidor Plesk para Linux:

  1. Acceda al servidor Plesk de destino mediante SSH.

  2. Compruebe que se ha instalado Plesk Migrator. De no ser así, instálelo tal y como se describe aquí.

  3. Copie un archivo de configuración de muestra del directorio /usr/local/psa/admin/plib/modules/panel-migrator/backend/conf/samples/ al directorio /usr/local/psa/var/modules/panel-migrator/conf/. Escoja uno de los siguientes archivos de muestra:

    1. Las muestras plesk-unix.simple.ini, cpanel.simple.ini, confixx.simple.ini y ppcpl.simple.ini son básicas y únicamente incluyen la información mínima necesaria para la migración.

    2. plesk-unix.ini, cpanel.ini, confixx.ini y ppcpl.ini son archivos de configuración bien comentados y exhaustivos que le permiten configurar una amplia variedad de opciones de migración.

    Para su comodidad, aquí encontrará el contenido de las muestras de archivos de configuración. Una vez copiado el archivo, cámbiele el nombre a config.ini.

  4. Edite el archivo config.ini para especificar las direcciones IP del servidor de origen y de destino, así como la contraseña SSH del usuario root del servidor de origen - el mínimo necesario para la migración. También puede especificar otros parámetros. Para más información al respecto, consulte Edición del archivo de configuración de Plesk Migrator.

  5. Genere la lista de migración ejecutando el siguiente comando:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list

    El archivo resultante se denominará migration-list y se almacenará en el directorio /usr/local/psa/var/modules/panel-migrator/sessions/migration-session/. La lista de migración es una lista de los objetos a migrar - cuentas de revendedor y de cliente, planes de servicio, dominios, etc.

  6. Edite la lista de migración. Puede eliminar aquellos dominios que ya no tenga previsto migrar, asignar dominios que desee migrar a planes de servicio o volverlos a asignar entre cuentas de cliente.

  7. Especifique las direcciones IP nuevas que deberían ser usadas por los sitios web, si desea asignar las direcciones de forma manual. Por omisión, la asignación de las direcciones IP se lleva a cabo de forma automática. Si desea más información sobre la asignación de IPs, haga clic aquí.

  8. Efectúe las comprobaciones previas a la migración ejecutando el siguiente comando:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator check

    Al ejecutar este comando, obtendrá una lista de las incidencias potenciales que puede experimentar durante la migración, de existir.Ejecute el comando «check» cada vez que se modifique la lista de migración.

  9. Ejecute el siguiente comando para iniciar la migración:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts

  10. (Recomendado) Una vez completada la migración, ejecute el siguiente comando para verificar la operatividad de los objetos migrados en el servidor de destino:

    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator test-all

Para migrar desde Plesk para Windows o Helm 3 a un servidor Plesk para Windows:

  1. Acceda al servidor Plesk de destino mediante RDP y abra el símbolo del sistema.

  2. Compruebe que se ha instalado Plesk Migrator. De no ser así, instálelo tal y como se describe aquí.

  3. Copie un archivo de configuración de muestra del directorio %plesk_dir%admin\plib\modules\panel-migrator\backend\conf\samples\ al directorio <PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\conf\. Para localizar la ubicación de <PLESK_DATA_DIRECTORY> en su servidor, ejecute el siguiente comando:

    reg query "HKLM\SOFTWARE\Plesk\PSA Config\Config" /v PRODUCT_DATA_D /reg:32

    Escoja uno de los siguientes archivos de muestra:

    1. La muestra plesk-windows.simple.ini es básica y únicamente incluye el mínimo de información necesaria para la migración.

    2. La muestra plesk-windows.ini es un archivo de configuración bien comentado y exhaustivo que le permite configurar varias opciones de migración.

    Para su comodidad, aquí encontrará el contenido de las muestras de archivos de configuración. Una vez copiado el archivo, cámbiele el nombre a config.ini.

  4. Edite el archivo config.ini para especificar las direcciones IP del servidor de origen y de destino, así como la contraseña del usuario administrador del servidor de origen - el mínimo necesario para la migración. También puede especificar otros parámetros. Para más información al respecto, consulte Edición del archivo de configuración de Plesk Migrator.

  5. Genere la lista de migración ejecutando el siguiente comando:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat generate-migration-list

    El archivo resultante se denominará migration-list y se almacenará en el directorio <PLESK_DATA_DIRECTORY>\var\modules\panel-migrator\sessions\migration-session\. La lista de migración es una lista de los objetos a migrar - cuentas de revendedor y de cliente, planes de servicio, dominios, etc.

  6. Edite la lista de migración. Puede eliminar aquellos dominios que ya no tenga previsto migrar, asignar dominios que desee migrar a planes de servicio o volverlos a asignar entre cuentas de cliente.

  7. Especifique las direcciones IP nuevas que deberían ser usadas por los sitios web, si desea asignar las direcciones de forma manual. Por omisión, la asignación de las direcciones IP se lleva a cabo de forma automática. Si desea más información sobre la asignación de IPs, haga clic aquí.

  8. (Recomendado) Efectúe las comprobaciones previas a la migración ejecutando el siguiente comando:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat check

    Al ejecutar este comando, obtendrá una lista de las incidencias potenciales que puede experimentar durante la migración, de existir.

  9. Ejecute el siguiente comando para iniciar la migración:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat transfer-accounts

  10. (Recomendado) Una vez completada la migración, ejecute el siguiente comando para verificar la operatividad de los objetos migrados en el servidor de destino:

    %plesk_dir%admin/plib/modules/panel-migrator/backend/plesk-migrator.bat test-all

Using command‑line options with Plesk Migrator

When migrating via the command line, you can pass additional options to the plesk-migrator executable. These options allow you to control logging, profiling, data fetching, content transfer, licensing checks, and more.

To view all available options at any time, run:

plesk-migrator check --help

Common options:

Option

Description

-h, --help

Show help and exit.

--async

Run the command asynchronously.

--quiet

Hide log entries in console output.

--debug

Increase debug level.

--disable-profiling / --enable-profiling

Disable or enable writing the profiling report.

--stop-mark-file <file>

Path to a file whose creation triggers a safe shutdown.

--progress-task-id <id>

Use a specific progress task ID.

Migration behavior options:

Option

Description

--ignore-pre-migration-errors

Continue migration even if pre-migration errors occur (intended for Plesk Support only).

--allocate-only-required-resourcesc

Create new webspaces using only the resources required by the corresponding subscriptions.

--reload-source-data

Fetch data again from the source instead of using cached data.

--skip-services-checks

Do not check the source or target services for potential issues.

--skip-license-checks

Skip license validation on the target server.

Migration list options:

Option

Description

--migration-list-file <file>

Specify the migration list file (default: $session_dir/migration-list).

--migration-list-format <text|json>

Migration list format (text by default).

--ignore-migration-list-errors

Continue the migration even if the migration list contains errors.

IP mapping:

Option

Description

--ip-mapping-file <file>

Provide a file that maps source IPs to target IPs.

Content transfer options:

Option

Description

--skip-copy-web-content

Do not transfer web files.

--skip-copy-mail-content

Do not transfer email messages.

--skip-copy-db-content

Do not transfer database content.

Additional cCopy options:

Option

Description

--copy-mail-settings

Copy server-wide mail settings (supported on Plesk 12.0 and later).

--copy-admin-profile

Copy admin profiles (supported on Plesk 12.0 and later).

--install-extensions

Install missing extensions (supported on Plesk 17.0 and later).

--copy-extensions-settings

Copy server-wide extension settings (supported on Plesk 17.0 and later).