Buenas prácticas al reportar incidencias

Para ayudarnos a identificar y resolver errores rápidamente, intente seguir estas pautas:

• 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 ha seguido. La idea es poder reproducir el error o, al menos, entender mejor el contexto en el que ocurrió.
• Los vídeos también son bienvenidos.
• Comparta la traza (stack trace) del fichero openkm.log.

Nota

Como el sitio de soporte tiene restricciones de tamaño de documento, compártanos un enlace de descarga usando herramientas de intercambio de ficheros online como:

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

Obtener la traza (stack trace)

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:

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

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

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.

Nota

Tiene una copia de la herramienta mtail en c:\tomcat-9.0.76\extras\.

Ejemplo de captura de una traza (stack trace)

Precaución

Al capturar la traza, es buena práctica incluir algunas líneas extra antes y después del 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 ***