Ir al contenido

Buenas prácticas para reportar incidencias

Para ayudarle a identificar y resolver errores rápidamente, intente seguir las siguientes directrices:

  • Proporcione una descripción detallada de la incidencia; esto nos ayudará a entender su problema.
  • Cuando sea posible, haga capturas de pantalla de todos los pasos que siguió. La idea es poder reproducir el error o al menos entender mejor el contexto en el que se produjo.
  • Los vídeos también son bienvenidos.
  • Comparta la traza de la pila (stack trace) del fichero openkm.log.

Obtener la traza de la pila

Sección titulada «Obtener la traza de la pila»

Linux

Sección titulada «Linux»

El fichero openkm.log está en la carpeta $TOMCAT/logs. Por ejemplo, en Linux, una ubicación habitual podría ser “/home/openkm/tomcat-9.0.76/logs”.

Para ver cómo cambia openkm.log en tiempo real, puede usar la línea de comandos:

Ventana de terminal
/home/openkm/tomcat-9.0.76/logs:$ tail -f openkm.log

Para mostrar las últimas 500 líneas del fichero openkm.log, puede usar la línea de comandos:

Ventana de terminal
/home/openkm/tomcat-9.0.76/logs:$ tail -n 500 openkm.log

Windows

Sección titulada «Windows»

El fichero openkm.log está en la carpeta $TOMCAT/logs. Por ejemplo, en Windows, una ubicación habitual podría ser “c:\tomcat-9.0.76\logs”.

Para ver cómo cambia openkm.log en tiempo real, puede usar una herramienta de Windows como mtail.

Ejemplo de captura de traza de la pila

Sección titulada «Ejemplo de captura de traza de la pila»
2019-08-04 12:05:00,020 [Task Scheduler 18] [] INFO  c.openkm.plugin.cron.BaseCronPlugin - *** Process Pending Task task end ***
2019-08-04 12:05:00,032 [Task Scheduler 19] [] INFO  c.openkm.plugin.cron.BaseCronPlugin - *** Text Extractor Worker task end ***
2019-08-04 12:09:36,471 [http-nio-0.0.0.0-8080-exec-6] [okmAdmin] INFO  com.openkm.util.LocalEntityResolver - resolveEntity(publicId=-//OpenKM//DTD Property Groups 2.8//EN, systemId=http://www.openkm.com/dtd/property-groups-2.8.dtd) => NULL
2019-08-04 12:09:36,603 [http-nio-0.0.0.0-8080-exec-6] [okmAdmin] ERROR com.openkm.util.FormUtils - Element type "hpanel" must be declared.
2019-08-04 12:09:36,612 [http-nio-0.0.0.0-8080-exec-6] [okmAdmin] ERROR c.o.s.admin.PropertyGroupsServlet - Element type "hpanel" must be declared.
com.openkm.core.ParseException: Element type "hpanel" must be declared.
  at com.openkm.util.FormUtils.parsePropertyGroupsDefinition(FormUtils.java:308)
  at com.openkm.module.db.DbRepositoryModule.registerPropertyGroups(DbRepositoryModule.java:855)
  at com.openkm.module.db.DbRepositoryModule.registerPropertyGroups(DbRepositoryModule.java:844)
  at com.openkm.servlet.admin.PropertyGroupsServlet.doPost(PropertyGroupsServlet.java:220)
  at javax.servlet.http.HttpServlet.service(HttpServlet.java:661)
  at javax.servlet.http.HttpServlet.service(HttpServlet.java:742)
  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)
  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
  at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)
  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
  at com.openkm.servlet.UserLoggingFilter.doFilter(UserLoggingFilter.java:33)
  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
  at org.springframework.boot.web.filter.ApplicationContextHeaderFilter.doFilterInternal(ApplicationContextHeaderFilter.java:55)
  at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
  at org.springframework.boot.actuate.trace.WebRequestTraceFilter.doFilterInternal(WebRequestTraceFilter.java:110)
  at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
  at java.lang.Thread.run(Thread.java:748)
2019-08-04 12:10:00,000 [Task Scheduler 18] [] INFO  c.openkm.plugin.cron.BaseCronPlugin - *** Process Pending Task task begin ***
2019-08-04 12:10:00,000 [Task Scheduler 6] [] INFO  c.openkm.plugin.cron.BaseCronPlugin - *** Antivirus Checker Worker task begin ***
2019-08-04 12:10:00,000 [Task Scheduler 25] [] INFO  c.openkm.plugin.cron.BaseCronPlugin - *** Text Extractor Worker task begin ***
2019-08-04 12:10:00,014 [Task Scheduler 6] [] INFO  c.openkm.plugin.cron.BaseCronPlugin - *** Antivirus Checker Worker task end ***