Configuración de caché

OpenKM usa varias cachés para mejorar el rendimiento. Algunas de estas cachés las usa OpenKM directamente y otras indirectamente, por ejemplo las que usa Hibernate. Todas estas cachés tienen valores por defecto que las hacen útiles, pero estos valores por defecto no siempre son adecuados para cada instalación. El motor de caché usado es el muy popular EHCache, ampliamente usado 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 porque todos los cambios se perderán cuando OpenKM se reinicie o se actualice.

Si quiere ajustar esta configuración por defecto, debe duplicar el fichero de configuración proporcionado en $TOMCAT_HOME/ehcache.xml y hacer los cambios oportunos según sus necesidades. 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 expira al llegar a este límite y ya no se devolverá desde la caché. El valor por defecto es 0, lo que significa que no se aplica desalojo 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 expira al llegar a este límite y ya no se devolverá desde la caché. El valor por defecto es 0, lo que significa que no se aplica desalojo por TTI (vida infinita).

Precaución

Tenga cuidado con eternal, ya que establece si los elementos son eternos. Si es true, se ignoran los tiempos de espera 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 usan durante 5 minutos. En caso contrario, permanecerán para siempre. Si quiere forzar un refresco, debe cambiar timeToLiveSeconds a 3600 y se refrescará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 en concreto. Más información en Cache stats.