Saltar al contenido principal

Transferencia de usuarios entre FASTPANEL

Introducción​

Este artículo describe el proceso de transferencia de cuentas de usuario y sus datos asociados (sitios web, bases de datos, correo electrónico, etc.) de un servidor FASTPANEL a otro utilizando la utilidad de migración integrada.

Términos clave​

  • Servidor de origen - El servidor desde el que se transfieren los datos.
  • Servidor de destino - El servidor al que se transfieren los datos.

Notas importantes​

  • De forma predeterminada, la migración funciona correctamente solo para sitios con una configuración estándar de FASTPANEL.

  • Los sitios con cambios de configuración manual solo se pueden transferir si se utiliza el indicador -m para la asignación de direcciones IP.

  • Si no hay disponible una contraseña cifrada para un propietario de base de datos, la base de datos no se transferirá.

  • Si un sitio web no se transfiere, sus bases de datos asociadas tampoco se transferirán.

  • Solo se pueden transferir bases de datos locales.

Proceso de migración​

Conexión​

El servidor de destino se conecta al servidor de origen mediante SSH. Durante la primera conexión, el servidor de destino instala una clave SSH en el servidor de origen (ya sea proporcionada previamente o generada a partir de una contraseña).

Pasos de la migración​

  • Instalación de módulos
  • Recopilación de información sobre objetos transferibles
  • Creación de usuarios
  • Transferencia de certificados SSL
  • Creación de sitios web, cuentas FTP, dominios de correo electrónico y cuentas de correo electrónico
  • Creación de bases de datos y usuarios de bases de datos
  • Transferencia de archivos de sitios web y buzones de correo electrónico
  • Transferencia de tareas cron

La transferencia de archivos se ejecuta mediante rsync. Las bases de datos se transfieren creando un volcado a través de un túnel SSH.

Comando para iniciar la migración​

El comando se ejecuta en el servidor de destino como un usuario con privilegios de root:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Indicadores de línea de comandos​

Conexión SSH​

  • --remote_host="SOURCE_IP" - Dirección IP del servidor de origen.
  • --remote_port="SSH_PORT" - Puerto SSH.
  • --remote_username="SSH_USER" - Usuario (debe ser root).
  • --remote_password="USER_PASSWORD" - Contraseña para el usuario SSH especificado.
  • --ssh_key_path="PATH_TO_KEY" - Ruta a la clave SSH privada en el servidor de destino para conectarse al servidor de origen. Si se utiliza una clave, la contraseña (--remote_password) no es necesaria.

Direcciones IP​

Debe utilizar solo uno de los siguientes indicadores para gestionar las direcciones IP de los sitios durante la transferencia. El indicador -m tiene prioridad.

  • -i "IP_ADDRESS_ON_DESTINATION" - Asigna la dirección IP especificada a todos los sitios transferidos en el servidor de destino. Para especificar varias IP (p. ej., si había varias en el origen), repita el indicador para cada IP de origen que deba transferirse.

  • -m "SOURCE_IP,DESTINATION_IP" - Método recomendado. Establece una asignación directa: todos los sitios que usan SOURCE_IP en el servidor de origen usarán DESTINATION_IP en el servidor de destino. Este indicador se puede especificar varias veces para diferentes pares de IP. Obligatorio para transferir sitios con ediciones manuales de configuración, ya que permite sustituir correctamente las direcciones IP en las directivas listen.

Configuración adicional​

  • --users="USER_LIST" - Transfiere solo los usuarios especificados (separados por comas). Si no se especifica, se transfieren todos los usuarios.
  • --disable_disk_quota - Desactiva la transferencia de cuotas de disco de usuario.
  • --with_user_data - Incluye la copia de todo el contenido de los directorios home de los usuarios (excepto el subdirectorio logs/). Úselo con precaución, ya que esto puede aumentar significativamente el tiempo de transferencia y la cantidad de datos transferidos.
  • --only_data - Transfiere solo datos (archivos de sitios web, archivos de correo, volcados de bases de datos). Útil si la migración inicial de la estructura (usuarios, sitios, BD, etc.) fue correcta, pero se produjeron errores durante la etapa de copia de archivos o volcados. Permite volver a ejecutar solo la parte de copia de datos.
  • --transfer_timeout - Establece el tiempo de espera de la operación (el valor predeterminado es 60 minutos).

Comando de ejemplo​

Transfiera todos los usuarios del servidor 11.22.33.44 al servidor actual. En el servidor antiguo, los sitios usaban las IP 11.22.33.44 y 11.22.33.55; en el servidor nuevo, deben usar 99.88.77.66 y 99.88.77.67 respectivamente. Conexión mediante SSH con contraseña.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Posibles problemas y tipos de errores​

Un error en el registro de migración no siempre indica un problema crítico, pero puede señalar la razón por la que un objeto específico no fue transferido.

  • Conflictos: Ocurren cuando es imposible transferir un objeto debido a la configuración actual del servidor de destino (por ejemplo, ya existe un usuario o sitio con el mismo nombre) o si la configuración del sitio en el servidor de origen es desconocida para el panel (por ejemplo, debido a amplias ediciones manuales).

  • Contraseña guardada faltante: Como se mencionó anteriormente, los usuarios de bases de datos MySQL sin una contraseña guardada en FASTPANEL en el servidor de origen no se pueden transferir.

  • Configuración manual y direcciones IP: Si un sitio en el servidor de origen tiene ediciones manuales en la configuración del servidor web y no se utiliza el indicador -m durante la migración para asignar su dirección IP, dicho sitio no se transferirá porque el panel no sabe qué IP especificar en la configuración del servidor de destino.