cPanel utiliza Phusion Passenger para ejecutar las aplicaciones de Node.js, Python, etc. Cuando ocurre un error en la ejecución, es posible que al acceder vía web veas una página de error genérica como la siguiente:
Por defecto esta página no brinda mucha información, por lo que aquí te sugerimos algunos tips para poder revisar la causa de la falla de tu app.
Sugerencias para identificar el error
Aquí hemos recopilado las acciones más relevantes para encontrar un error en tu App de Node.js o Python cuando están siendo ejecutadas vía Phusion Passenger.
Verifica la configuración de tu App
Verifica que los parámetros de configuración son correctos, que el script de inicio existe y que el modo de ejecución y variables de entorno estén correctamente seteadas.
Si tu app estaba iniciada y funcionando correctamente, es posible que esta no sea la causa del error.
Verifica que tu cuenta tenga recursos para ejecutar tu App
Los servicios de hosting suelen tener una cierta cantidad de recursos, verifica el consumo de recursos, que tengas espacio en disco disponible, procesos en ejecución, etc.
Si tienes procesos trabados, puedes matar todos los procesos de tu cuenta con el Monitor de Consumos.
Asegúrate que tu App tenga las dependencias instaladas
Si estás ejecutando Node debes asegurarte luego de instalar tu App de ejecutar el botón "Run NPM Install" o si estás ejecutando Python, ejecutar "pip install -r requirements.txt" (en ambas guías se explica esto paso a paso).
Si no tienes las dependencias instaladas correctamente es posible que veas esta página de error al intentar acceder vía web.
Verifica los registros de tu App
Por lo general las aplicaciones tienen un log, debug log o error_log para registrar cualquier error que les ocurra. Eso dependerá de tu propia app.
Algunas apps sólo generan logs cuando son ejecutadas en modo "dev".
Verifica los registros de error de Passenger
Dentro de la configuración de tu App, hay un campo "Passenger log file" destinado al archivo que guardará los registros log de la ejecución de tu App dentro de Passenger.
Este registro no siempre suele estar definido en la configuración o el archivo especificado que no exista, ya que sólo lo creará en caso que la ejecución de tu app se pueda concretar y se pueda obtener y registrar el output del error.
Verifica el registro de error de cPanel
Ingresa a cPanel > Métricas > Errores, donde podrás ver errores relacionados con el servicio web o incluso propios de Passenger.
Intenta reiniciar tu App
Desde la herramienta de configuración de tu App instalada, intenta detener y volver a iniciar tu app.
Si no puedes detenerla, puedes matar todos los procesos de tu cuenta desde el monitor de consumos.
Intenta ejecutar tu App desde su terminal de entorno virtual
Si tu app no puede iniciar desde la herramienta de configuración del panel de control, accede a la consola de su entorno virtual (puedes obtener el comando para ingresar dentro de la herramienta de configuración de tu app) e intenta ejecutarla desde allí para ver el output de su ejecución.
Si tu app consume muchos recursos o satura tu hosting, es probable que no puedas ejecutarla de esta manera.
Cambia la página de error de Passenger a "modo development"
La página de error de passenger es genérica y no brinda mucha información acerca del error. Sin embargo, puedes activar el "modo development" para que brinde más detalles (sólo te recomendamos hacer esto como último recurso ya que expondrá información de tu app al público).
Para ello, identifica el archivo ".htaccess" de tu directorio web, identifica el código correspondiente a tu app de Passenger (todo lo que está entre los comentarios de "BEGIN" y "END") y al final agrega las siguientes lineas:
PassengerFriendlyErrorPages on
PassengerAppEnv development
Ejemplo de como quedaría modificado:
Guarda el archivo y refresca la página de error en tu navegador. Verás una página de error con más detalles acerca del error ocurrido:
Una vez que termines de hacer tu revisión, recuerda desactivar el "modo development", eliminando las lineas que agregaste a tu archivo ".htacess".
Recuerda que WNPower sólo brinda soporte técnico de la plataforma y no de tu propio contenido o lo que ejecutes en ella, ya sea para consultas o asistencia de programación o que no puedas solucionar tu error, te sugerimos que recurras a la comunidad de usuarios.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.