Configuración de la caché

OpenKM utiliza varias cachés para mejorar el rendimiento. Algunas de estas cachés las utiliza directamente 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 esos valores por defecto no siempre son adecuados para todas las instalaciones. El motor de caché utilizado es el popular EHCache, muy extendido y muy configurable. Puede ver los valores por defecto en $TOMCAT_HOME/webapps/OpenKM/WEB-INF/classes/ehcache.xml.

Precaución

No modifique este archivo, 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 archivo de configuración proporcionado en $TOMCAT_HOME/ehcache.xml y realizar los cambios adecuados según sus requisitos. 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 caduca al alcanzar este límite y deja de devolverse 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 deja de devolverse 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, porque establece si los elementos son eternos. En caso de ser true, los tiempos de espera 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 utilizan 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 en 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.