Buenas prácticas para informar de incidencias

Para ayudarle rápidamente a identificar y resolver errores, intente seguir la siguiente guía:

• Proporcione una descripción detallada de la incidencia; eso nos ayudará a comprender el problema que tiene.
• Cuando sea posible, haga capturas de pantalla de todos los pasos que ha seguido. La idea es poder reproducir el error o, al menos, comprender mejor el contexto en el que se produjo.
• También se agradecen los vídeos.
• Comparta la traza de pila (stack trace) del fichero openkm.log

Nota

Como el sitio web de soporte tiene restricciones en el tamaño de los documentos, comparta con nosotros un enlace de descarga mediante herramientas en línea para compartir ficheros, como:

• https://transfer.sh/
• https://filepush.co/
• https://filetransfer.io/
• https://justbeamit.com/

Obtener la traza de pila

Linux

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

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

/home/openkm/tomcat-8.5.69/logs:$ tail -f openkm.log

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

/home/openkm/tomcat-8.5.69/logs:$ tail -n 500 openkm.log

Windows

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

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

Nota

Dispone de una copia de la herramienta mtail en c:\tomcat-8.5.69\extras\

Ejemplo de captura de una traza de pila

Precaución

Al capturar la traza de pila, es una buena práctica incluir algunas líneas adicionales antes y después de que se produzca el error.

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