Diferencia entre revisiones de «SIU-Guarani/Version3.20.0/errores comunes»

De SIU
Saltar a: navegación, buscar
(→‎Algunos errores comunes en Jasper)
 
(No se muestran 20 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
−
== Configuración recomendada para poder visualizar los errores ==
+
== [[#configuracion_visualizar_errores |Configuración recomendada para poder visualizar los errores]] ==
  
−
=== Configurar PHP para que notifique los errores ===
+
=== [[#configurar_php_notifique_errores |Configurar PHP para que notifique los errores]] ===
 
* Ubicar el archivo de configuración de PHP, por lo general se encuentra en
 
* Ubicar el archivo de configuración de PHP, por lo general se encuentra en
 
*: <source lang="php" enclose="div">
 
*: <source lang="php" enclose="div">
−
/etc/php5/apache2/php.ini
+
/etc/phpX/apache2/php.ini
 
</source>
 
</source>
 
* 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)
 
* 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)
Línea 14: Línea 14:
 
* Guardar los cambios del archivo y reiniciar el servicio de apache.
 
* Guardar los cambios del archivo y reiniciar el servicio de apache.
  
−
=== Permisos para los archivos de log de la aplicación ===
+
=== [[#permisos_archivos_log_aplicacion |Permisos para los archivos de log de la aplicación]] ===
 
* En '''Gestión''':
 
* En '''Gestión''':
 
** El usuario con el cual se ejecuta apache debe tener permiso de escritura en:
 
** El usuario con el cual se ejecuta apache debe tener permiso de escritura en:
Línea 36: Línea 36:
 
         array(
 
         array(
 
               'activo' => true,
 
               'activo' => true,
−
               'nivel' => 'debug',
+
               'nivel' => log::NIVEL_DEBUG,
−
.....
+
 
 +
</source>
 +
 
 +
* En '''Preinscripción''':
 +
** El usuario con el cual se ejecuta apache debe tener permiso de escritura en:
 +
**:<source lang="php" enclose="div">
 +
<path de la aplicación>/instalacion/logs/<punto de acceso>/
 +
</source>
 +
** Además, se debe tener activado el log, en el archivo config.php
 +
**:<source lang="php" enclose="div">
 +
'log' =>
 +
        array(
 +
              'activo' => true,
 +
              'nivel' => log::NIVEL_DEBUG,
 +
              'barra_dev' => true, //Colocar en false cuando se pasa a producción
 
</source>
 
</source>
  
Línea 49: Línea 63:
 
=== Chequear los logs de la aplicación ===
 
=== Chequear los logs de la aplicación ===
 
* Para '''Gestión''', los archivos de logs se encuentran en:
 
* Para '''Gestión''', los archivos de logs se encuentran en:
−
*: <source lang="php" enclose="div">
+
[[#carpeta_logs |Carpeta logs]]
 +
<source lang="php" enclose="div">
 
<path proyecto Guaraní>/instalacion/<instancia>/<proyecto>/logs/
 
<path proyecto Guaraní>/instalacion/<instancia>/<proyecto>/logs/
 +
</source>
 +
 +
[[#logs_comandos |Carpeta de logs comandos]]
 +
<source lang="php" enclose="div">
 
<path proyecto Guaraní>/instalacion/logs_comandos/
 
<path proyecto Guaraní>/instalacion/logs_comandos/
 
</source>
 
</source>
 +
'''Los logs de sistema''' se guardan en la siguiente ubicación '''[[SIU-Guarani/Version3.20.0/errores_comunes#carpeta_logs|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 '''[[SIU-Guarani/Version3.20.0/errores_comunes#carpeta_logs|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 '''[[SIU-Guarani/Version3.20.0/errores_comunes#logs_comandos| 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:
 
* Para '''Autogestión''' están en:
 
*: <source lang="php" enclose="div">
 
*: <source lang="php" enclose="div">
 
<path de la aplicación>/instalacion/logs/<punto de acceso>/
 
<path de la aplicación>/instalacion/logs/<punto de acceso>/
 +
</source>
 +
 +
=== [[#jasper_logs|Para ver los logs en Jasper]] ===
 +
* en '''Gestión'''
 +
*: <source lang="php" enclose="div">
 +
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
 +
</source>
 +
* en '''Autogestión'''
 +
*: <source lang="php" enclose="div">
 +
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
 +
</source>
 +
 +
<span id="jasper_error"></span>
 +
=== [[#jasper|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
 +
*: <source lang="php" enclose="div">
 +
chmod 777 -R /dev/shm
 
</source>
 
</source>
  

Revisión actual del 09:29 4 jul 2022

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>/

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

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 777 -R /dev/shm

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)
Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.20.0/errores_comunes&oldid=82272»