Configuración de la caché

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

Precaución

No modifique este fichero, porque 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 oportunos para adaptarlo a sus necesidades. Esta es una definición de ejemplo:

<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 expira 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 aplica ninguna expulsión por TTL (vida útil infinita).
• timeToIdle: el número máximo de segundos que un elemento puede existir en la caché sin ser accedido. El elemento expira 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 aplica ninguna expulsión por TTI (vida útil infinita).

Precaución

Tenga cuidado con eternal, porque establece si los elementos son eternos. Si vale true, los tiempos de espera se ignoran y el elemento nunca expira.

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 utilizan durante 5 minutos. De lo 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 habilitar y ver las estadísticas de uso de la caché e incluso reiniciar una determinada. Más información en Cache stats.