SIU-Guarani/Version3.20.0/errores comunes

Configuración recomendada para poder visualizar los errores

Configurar PHP para que notifique los errores

• Ubicar el archivo de configuración de PHP, por lo general se encuentra en

  /etc/phpX/apache2/php.ini

• Encontrar en este archivo, las líneas que contienen las sentencias error_reporting y display_errors, y verificar que quede de la siguiente manera: (asegurarse de que no estén comentadas ni redefinidas más abajo en el mismo archivo)

  error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
  display_errors = On

  (display_errors = On, no está recomendado en ambientes de producción)

• Guardar los cambios del archivo y reiniciar el servicio de apache.

Permisos para los archivos de log de la aplicación

• En Gestión:
  • El usuario con el cual se ejecuta apache debe tener permiso de escritura en:

    <path proyecto Guaraní>/instalacion/

  • Además, se debe tener activado el log, en el archivo <path proyecto Guaraní>/www/aplicacion.php

    #Cambia el nivel del logger a modo 'info'. Para modo debug pasar a '7'
    define("apex_pa_log_archivo_nivel", 7);

• En Autogestión:
  • El usuario con el cual se ejecuta apache debe tener permiso de escritura en:

    <path de la aplicación>/instalacion/logs/<punto de acceso>/

  • Además, se debe tener activado el log, en el archivo config.php

    'log' =>
             array(
                  'activo' => true,
                  'nivel' => log::NIVEL_DEBUG,

• En Preinscripción:
  • El usuario con el cual se ejecuta apache debe tener permiso de escritura en:

    <path de la aplicación>/instalacion/logs/<punto de acceso>/

  • Además, se debe tener activado el log, en el archivo config.php

    'log' =>
             array(
                  'activo' => true,
                  'nivel' => log::NIVEL_DEBUG,
                  'barra_dev' => true, //Colocar en false cuando se pasa a producción

Errores más comunes al instalar la aplicación

Chequear el log de Apache

Generalmente el log de apache se ubica en:

/var/log/apache2/error.log

Chequear los logs de la aplicación

• Para Gestión, los archivos de logs se encuentran en:

Carpeta logs

<path proyecto Guaraní>/instalacion/<instancia>/<proyecto>/logs/

Carpeta de logs comandos

<path proyecto Guaraní>/instalacion/logs_comandos/

Los logs de sistema se guardan en la siguiente ubicación logs/sistema.log es útil para tener en detalle la pila de operaciones ejecutadas en un momento determinado.

Los log de procesos se guardan en la siguiente carpeta de logs/procesos_bk/ dentro del directorio con nombre '<nombre del proceso background>__<fecha y hora de ejecución>'.

Los logs de comandos se guardan en logs_comandos/comandos.log y son útiles cuando hay un error en la ejecución de un comando, como puede ser ./guarani regenerar o alguna operación de tipo proceso.

• Para Autogestión están en:

  <path de la aplicación>/instalacion/logs/<punto de acceso>/

Algunos errores comunes en Autogestión que hacen que presente una página en blanco

• Tener la Aplicación en producción (produccion = true en config.php) y no están compilados los recursos (Ver Instructivo de puesta en producción de Autogestión)
• Tener la Aplicación configurada para iniciar con un archivo de debug (ini_debug = true en config.php) y no tener un archivo debug.php en la carpeta [path_aplicacion]/src/siu (en general poner ini_debug = false)
• No tener los permisos, para que el usuario con el cual se ejecuta apache, pueda escribir en las carpetas correspondientes.
• Tener mal configurado el archivo instalacion/alias.conf (Ver Archivos de configuración Autogestión)
• Tener mal configurado el parámetro client_locale en el archivo instalacion/config.conf (Ver Archivos de configuración Autogestión)

Algunos errores comunes en Jasper

• En Debian la solución a la salida en blanco de un reporte se da por la falta de permisos en la siguiente ubicación /dev/shm

  chmod 755 -R /dev/shm

Para ver los logs en Jasper

• en Gestión

  java -Duser.language=es -Duser.country=AR -Djava.awt.headless=true -jar /path/to/gestion/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081 5

• en Autogestión

  java -Duser.language=es -Duser.country=AR -Djava.awt.headless=true -jar /path/to/autogestion/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8082 5