Cómo forzar la generación de backups en WHM por SSH

cPanel incluye un script oficial para ejecutar manualmente los backups configurados en WHM. Es útil antes de un cambio importante o cuando necesitás una ejecución adicional sin esperar al horario programado. El comando no crea una política nueva: utiliza la configuración existente en el servidor.

Este procedimiento requiere acceso SSH como root. Si sólo administrás una cuenta cPanel, utilizá las herramientas de backup disponibles en el panel o solicitá la tarea al responsable del servidor.

Antes de forzar el backup

Revisá en WHM → Backup → Backup Configuration que el sistema esté habilitado y que sean correctos:

  • el tipo de respaldo y la frecuencia;
  • las cuentas incluidas o excluidas;
  • el destino local o remoto;
  • la retención de copias;
  • el espacio disponible;
  • la validación del destino remoto, si corresponde.

Una ejecución forzada con una configuración incorrecta producirá un backup incorrecto. También puede consumir mucho disco, CPU e I/O, por lo que conviene realizarla en un horario de menor carga.

Comando para ejecutar el sistema de backup

Ingresá por SSH como root y ejecutá:

/usr/local/cpanel/bin/backup

El script lee la configuración de WHM y determina las tareas necesarias. De forma predeterminada, cPanel inicia el proceso en segundo plano. Cerrar la sesión SSH no debería detener esa ejecución.

Cómo forzar una copia adicional

Si el sistema ya contiene backups actualizados para el período y necesitás una ejecución adicional, usá:

/usr/local/cpanel/bin/backup --force

La opción --force obliga a realizar el proceso aunque existan archivos de respaldo al día. No modifica la frecuencia, la retención ni las cuentas seleccionadas.

Antes de utilizarla, comprobá que no haya otro backup activo. Ejecutar varios procesos simultáneos puede degradar el servicio y provocar falta de espacio.

Ejecutar en primer plano con información de depuración

Para ver el progreso directamente en la terminal, cPanel documenta la opción:

/usr/local/cpanel/bin/backup --debug

En este modo el proceso se ejecuta en primer plano y la sesión debe permanecer abierta. Es útil para diagnosticar, pero genera bastante salida. Guardá esa información si necesitás analizar un error y evitá publicarla sin revisar, ya que puede contener nombres de cuentas, rutas o destinos.

Cómo comprobar si ya existe un backup activo

Podés revisar los procesos relacionados mediante:

ps aux | grep '[b]ackup'

No mates procesos sólo por su nombre. Confirmá el PID, la hora de inicio, el usuario y el comando completo. Un backup grande puede permanecer activo durante horas aunque parezca avanzar lentamente, especialmente si comprime muchos archivos o transfiere datos a un destino remoto.

Dónde revisar los registros

La documentación de cPanel indica que los logs del sistema se almacenan en:

/usr/local/cpanel/logs/cpbackup/

Listá los archivos disponibles con:

ls -lah /usr/local/cpanel/logs/cpbackup/

Luego abrí el registro correspondiente a la ejecución. Buscá el resumen final, las cuentas omitidas, errores de empaquetado, falta de espacio y fallas de transporte. Que el comando haya terminado no significa que todas las cuentas y transferencias hayan sido exitosas.

Comprobaciones después de ejecutar el backup

  1. Confirmá que existe una copia reciente para las cuentas esperadas.
  2. Revisá tamaño, fecha y destino.
  3. Verificá que las transferencias remotas hayan finalizado.
  4. Leé el log hasta el resumen final y no sólo las primeras líneas.
  5. Comprobá que la retención no haya eliminado una copia que necesitabas conservar.

La única prueba concluyente de un backup es una restauración controlada. Planificá verificaciones periódicas en un entorno seguro, especialmente para cuentas críticas.

Diferencia entre backup del servidor y cpmove de una cuenta

/usr/local/cpanel/bin/backup ejecuta el sistema general configurado en WHM. Si necesitás crear un archivo transportable de una cuenta concreta, cPanel dispone de pkgacct, pero es otro procedimiento y requiere revisar espacio, rutas y opciones.

Para una copia iniciada por el propio usuario desde cPanel, consultá cómo generar un backup del sitio desde cPanel. Para recuperar información, revisá también cómo restaurar backups de una cuenta cPanel.

Errores frecuentes y qué revisar

  • Sin espacio: verificá el sistema de archivos local y las cuotas del destino.
  • Cuenta omitida: revisá selección, estado y configuración específica de esa cuenta.
  • Transferencia fallida: validá credenciales, red, ruta y capacidad del destino remoto.
  • Proceso muy lento: observá carga, I/O, cantidad de archivos y compresión.
  • Backup incompleto: consultá el log para identificar el componente o la cuenta que falló.

Planificar una ejecución manual sin afectar a los usuarios

Antes de iniciar una copia extraordinaria, estimá el tamaño de las cuentas y la capacidad disponible en el disco temporal. La compresión de muchos archivos pequeños, buzones grandes o bases de datos activas puede elevar la carga aunque el archivo final no parezca enorme.

Si el servidor aloja tiendas o aplicaciones con mucha actividad, elegí una ventana de menor uso y evitá coincidir con actualizaciones, análisis antivirus u otros trabajos intensivos. Monitoreá carga, espacio e I/O durante la ejecución. Si el destino es remoto, considerá también el tiempo de transferencia y el ancho de banda.

Documentá el motivo del backup manual, la hora de inicio, el comando y el resultado. Esa información evita que otro administrador lance una segunda copia y facilita relacionar cualquier aumento de carga con la tarea realizada.

No borres backups antiguos para liberar espacio hasta confirmar que existe al menos una copia válida en otra ubicación. Si administrás un servidor cPanel de Atlántica Digital y la ejecución falla, enviá a soporte la fecha, el comando utilizado y el fragmento relevante del log, ocultando credenciales.

Documentación de referencia