El error "Service Unavailable" es uno de los problemas más comunes en servidores de hosting compartido que utilizan CloudLinux con CageFS y mod_lsapi. Este error indica que el servidor no pudo procesar la solicitud del visitante, generalmente porque el backend de PHP (lsphp) no logró conectarse.
En este artículo aprenderás a identificar la causa raíz del problema y aplicar la solución correcta según el escenario.
Causas comunes
- CageFS desactualizado o corrupto: Después de un reinicio del servidor, una restauración de cuenta o una actualización de CloudLinux, el entorno virtual de CageFS puede quedar en un estado inconsistente.
- Límites LVE alcanzados: CloudLinux asigna límites de CPU, memoria, procesos (EP) y conexiones a cada cuenta. Si una cuenta alcanza alguno de estos límites, el servidor rechaza las solicitudes con "Service Unavailable".
- mod_lsapi no puede conectar con lsphp: El módulo de Apache que conecta con el backend de PHP falla al establecer la comunicación, generando el error
connect to lsphp failed: 110. - Procesos lsphp huérfanos: Procesos de PHP que quedaron colgados y están consumiendo los slots disponibles del usuario.
Diagnóstico
Revisar el error log de Apache
El primer paso es identificar el error exacto en el log de Apache. Busca entradas recientes del usuario afectado:
grep -i usuario_cpanel /usr/local/apache/logs/error_log | tail -20
El error típico relacionado con mod_lsapi y CageFS se ve así:
[lsapi:error] [pid 23113:tid 47912125892352] [client 187.188.127.42:46658] mod_lsapi: [host ejemplo.com] [req GET / HTTP/1.1] Connect to backend failed: connect to lsphp failed: 110
Verificar límites LVE
Consulta si el usuario ha alcanzado algún límite de recursos recientemente:
lveinfo --user usuario_cpanel --period=1h
Si ves valores de faults (fEP, fNPROC, fPMEM, fVMEM) distintos de cero, la cuenta está alcanzando sus límites.
Verificar estado de CageFS
Comprueba si CageFS está activo y funcionando correctamente para el usuario:
cagefsctl --check-cagefs
Buscar procesos lsphp huérfanos
Verifica si existen procesos de PHP colgados para el usuario:
ps aux | grep lsphp | grep usuario_cpanel
Solución 1: Remontar CageFS para un usuario
Si el error afecta a un solo sitio o cuenta, remonta el entorno virtual de CageFS para ese usuario específico:
cagefsctl -m usuario_cpanel
Verifica que el sitio cargue correctamente después de ejecutar el comando.
Solución 2: Reparar CageFS para todo el servidor
Si múltiples sitios presentan el error simultáneamente (por ejemplo, después de un reinicio o una actualización), actualiza y remonta CageFS para todos los usuarios:
cagefsctl --force-update
cagefsctl -M
Nota: El comando cagefsctl -M (mayúscula) remonta CageFS para todos los usuarios del servidor. En servidores con muchas cuentas, este proceso puede tomar varios minutos.
Solución 3: Eliminar procesos lsphp huérfanos
Si identificaste procesos de PHP colgados, elimínalos para liberar los slots del usuario:
killall -u usuario_cpanel lsphp
Si deseas eliminar los procesos de lsphp de todos los usuarios (usar con precaución):
killall lsphp
Solución 4: Ajustar límites LVE
Si el diagnóstico reveló que la cuenta está alcanzando sus límites de recursos, puedes ajustarlos temporalmente desde la línea de comandos o de forma permanente desde WHM.
Ajuste por línea de comandos
Para aumentar el límite de Entry Processes (EP) a 30 para un usuario:
lvectl set usuario_cpanel --ep=30
Para aumentar el límite de NPROC (número máximo de procesos) a 50:
lvectl set usuario_cpanel --nproc=50
Aplica los cambios sin reiniciar:
lvectl apply all
Ajuste desde WHM
- Inicia sesión en WHM.
- Navega a CloudLinux LVE Manager.
- Busca el usuario afectado en la pestaña Current Usage.
- Haz clic en el ícono de editar y ajusta los valores de EP, NPROC, PMEM o CPU según sea necesario.
Solución 5: Reiniciar mod_lsapi
Si el problema persiste después de las soluciones anteriores, reinicia el servicio de mod_lsapi y Apache:
/usr/local/cpanel/bin/apache_conf_distiller --update
/scripts/restartsrv_httpd
Si utilizas LiteSpeed en lugar de Apache:
/scripts/restartsrv_litespeed
Verificación post-solución
Después de aplicar cualquiera de las soluciones anteriores, verifica que el problema se haya resuelto:
- Abre el sitio web afectado en el navegador y confirma que carga correctamente.
- Revisa que no aparezcan nuevos errores de lsapi en el log:
tail -f /usr/local/apache/logs/error_log | grep -i lsapi
- Monitorea los límites LVE del usuario durante las siguientes horas:
lveinfo --user usuario_cpanel --period=1h
Referencia rápida de comandos
cagefsctl -m usuario — Remontar CageFS para un usuario.cagefsctl --force-update — Forzar actualización de CageFS.cagefsctl -M — Remontar CageFS para todos los usuarios.cagefsctl --check-cagefs — Verificar estado de CageFS.lveinfo --user usuario --period=1h — Consultar faults de LVE.lvectl set usuario --ep=30 — Ajustar límite de Entry Processes.lvectl apply all — Aplicar cambios de LVE.killall -u usuario lsphp — Matar procesos lsphp de un usuario./scripts/restartsrv_httpd — Reiniciar Apache.
Recomendaciones
- Siempre diagnostica primero antes de aplicar soluciones. Revisa el error_log y los límites LVE para identificar la causa raíz.
- Si el error aparece recurrentemente para un mismo usuario, es probable que la cuenta necesite un plan de hosting con más recursos o una optimización de su aplicación (caché, plugins, consultas a base de datos).
- Después de actualizaciones de CloudLinux o del kernel, ejecuta
cagefsctl --force-update seguido de cagefsctl -M como medida preventiva. - Configura alertas en CloudLinux LVE Manager para recibir notificaciones cuando un usuario alcance sus límites de recursos frecuentemente.
- Considera implementar LVE Warden (disponible en CloudLinux 8+) para automatizar la gestión de límites basándose en patrones de uso.