Cambiar la ubicación del repositorio

De forma predeterminada, el repositorio se encuentra en “$TOMCAT_HOME/repository”, pero puede cambiarlo a otra ubicación.

Precaución

Esta acción debe realizarse con la aplicación detenida.

Comprender el contenido de las carpetas del repositorio

En “$TOMCAT_HOME/repository” se encuentran las carpetas tmp, index, cache y datastore.

Carpeta	Copia de seguridad	Descripción
tmp	No	Esta carpeta contiene algunos ficheros temporales que se comparten entre varias instancias de OpenKM en clúster.
index	No	La carpeta que contiene los índices del motor de búsqueda Lucene. El contenido de esta carpeta se puede reconstruir. Aunque no es obligatorio hacer una copia de seguridad de esta carpeta, le recomendamos hacerla.
cache	No	La carpeta que contiene los ficheros en caché de la aplicación. Por ejemplo, para previsualizar documentos, a veces es necesario transformar el documento original a otro formato. La conversión consume muchos recursos de hardware; por este motivo, la aplicación almacena estos ficheros convertidos para reutilizarlos más adelante. El contenido de esta carpeta se puede limpiar sin mayores problemas. Aunque no es obligatorio hacer una copia de seguridad de esta carpeta, le recomendamos hacerla.
datastore	Sí	La carpeta que contiene todos los datos binarios de los documentos. Es obligatorio hacer una copia de seguridad de esta carpeta; de lo contrario, los datos binarios de los documentos podrían perderse a causa de un fallo de hardware del servidor.
extraction	Sí	Esta carpeta contiene el texto extraído de los documentos almacenados en OpenKM. Una copia de seguridad no es realmente necesaria, pero puede ahorrar tiempo.
ocr_templates	Sí	Esta carpeta contiene los datos binarios de las plantillas de OCR.

Mover toda la ubicación del repositorio

• Detenga la aplicación.
• Mueva “$TOMCAT_HOME/repository” a otra ubicación.
• Edite el fichero “$TOMCAT_HOME/openkm.properties” y añada la propiedad “repository.home”.
• Inicie la aplicación.

Ejemplo 1

Precaución

A partir de la versión 7.1.x de OpenKM, cuando se establece el parámetro “repository.home”, la ubicación en el sistema de ficheros del índice de Lucene no se ve afectada. Debe utilizar el parámetro específico “spring.jpa.properties.hibernate.search.default.indexBase” para mover el índice de Lucene a una nueva ubicación.

Windows

repository.home=C:/okmrepo

Linux

repository.home=/mnt/okmrepo

Mover las carpetas del repositorio individualmente

Tabla de propiedades:

Carpeta	Propiedad	Valor por defecto
index	spring.jpa.properties.hibernate.search.default.indexBase	${catalina.home}/repository/index
tmp	repository.temp.home	${repository.home}/tmp
cache	repository.cache.home	${repository.home}/${tenant.id}/cache
datastore	repository.datastore.home	${repository.home}/${tenant.id}/datastore
extraction	repository.extraction.home	${repository.home}/${tenant.id}/extraction
ocr template	repository.ocr.template.home	${repository.home}/${tenant.id}/ocr_template

Precaución

Estos parámetros se pueden utilizar en combinación con los parámetros “repository.home” y “tenant.id”.

• Detenga la aplicación.
• Mueva “$TOMCAT_HOME/repository/{carpeta}” a otra ubicación.
• Edite el fichero “$TOMCAT_HOME/openkm.properties” y añada la propiedad correspondiente.
• Inicie la aplicación.

Ejemplo

Windows

spring.jpa.properties.hibernate.search.default.indexBase=C:/lucene/index
repository.datastore.home=D:/okm/${repository.home}/datastore
repository.cache.home=D:/okm/${repository.home}/cacherepository.temp.home=D:/okm/${repository.home}/tmp
repository.ocr.template.home=D:/okm/${repository.home}/cacherepository.temp.home=D:/okm/${repository.home}/ocr_template

Linux

spring.jpa.properties.hibernate.search.default.indexBase=/mnt/lucene/index
repository.datastore.home=/mnt/okm/${repository.home}/datastore
repository.cache.home=/mnt/okm/${repository.home}/cacherepository.temp.home=/mnt/okm/${repository.home}/tmp
repository.ocr.template.home=/mnt/okm/${repository.home}/cacherepository.temp.home=/mnt/okm/${repository.home}/ocr_template

Resolución de problemas

La unidad de red asignada de Windows no funciona

Precaución

Le aconsejamos que no utilice la red (NAS o Samba) para almacenar el repositorio, porque los problemas de red afectarán al repositorio; consideramos que es una configuración peligrosa.

Parece que existen restricciones al utilizar una unidad de red (asignada con el comando “net use”) y la aplicación ejecutándose como servicio. Para solucionarlo, es necesario crear un enlace entre la ruta UNC y el sistema de ficheros.

MKLINK /D C:\okm-repository \\192.168.1.36\eDocuments\okm-repository

Nota

En la mayoría de los casos será necesario utilizar un usuario estándar para ejecutar el servicio de OpenKM en lugar de la cuenta predeterminada. Consulte la configuración del servicio de Windows de OpenKM para cambiar el “Usuario del sistema local” predeterminado por el suyo propio.