Configuración de la caché

OpenKM usa varias cachés para mejorar el rendimiento. Algunas de estas cachés las usa directamente OpenKM y otras indirectamente, por ejemplo las usadas por Hibernate. Todas estas cachés tienen valores por defecto que las hacen útiles, pero estos valores por defecto no siempre son adecuados para todas las instalaciones. El motor de caché usado es el muy popular EHCache, ampliamente utilizado y muy configurable. Puede ver los valores por defecto en $TOMCAT_HOME/webapps/openkm/WEB-INF/classes/ehcache.xml.

Precaución

No modifique este fichero, ya que todos los cambios se perderán cuando OpenKM se reinicie o se actualice.

Si desea ajustar esta configuración por defecto, debe duplicar el fichero de configuración proporcionado en $TOMCAT_HOME/ehcache.xml y realizar los cambios necesarios según sus requisitos. Este es un ejemplo de definición:

<cache name="com.openkm.cache.ldapPrincipalAdapter.general"
       maxElementsInMemory="1000"
       timeToIdleSeconds="300"
       timeToLiveSeconds="0"
       overflowToDisk="true"
       eternal="false" />

Los valores más importantes son:

• timeToLive: el número máximo de segundos que un elemento puede existir en la caché, independientemente de su uso. El elemento caduca al alcanzar este límite y ya no se devolverá desde la caché. El valor por defecto es 0, lo que significa que no se produce expulsión por TTL (vida infinita).
• timeToIdle: el número máximo de segundos que un elemento puede existir en la caché sin ser accedido. El elemento caduca al alcanzar este límite y ya no se devolverá desde la caché. El valor por defecto es 0, lo que significa que no se produce expulsión por TTI (vida infinita).

Precaución

Tenga cuidado con eternal, ya que establece si los elementos son eternos. Si es true, los tiempos de expiración se ignoran y el elemento nunca caduca.

Así, en este caso, la caché llamada “com.openkm.cache.ldapPrincipalAdapter.general” tendrá un máximo de 1000 elementos en memoria y, en caso de desbordamiento, se escribirán en disco. Estos elementos se eliminarán de esta caché si no se usan durante 5 minutos. En caso contrario, permanecerán para siempre. Si desea forzar una actualización, debe cambiar timeToLiveSeconds a 3600 y se actualizarán cada hora.

Puede comprobar el estado de estas cachés yendo a Administration > Utilities > Cache stats. En esta sección puede activar y ver las estadísticas de uso de la caché, e incluso reiniciar una en concreto. Más información en Cache stats.