Actualización de Tomcat

Precaución

El procedimiento de actualización descrito a continuación es válido para las versiones de Tomcat:

• 9.0.76 y posteriores

Por defecto, OpenKM se instala con una versión específica de Tomcat. Sin embargo, cada pocas semanas se publica una nueva versión, y es posible que desee mantener su instalación actualizada. En este caso, debe abrir un ticket en el sitio web de soporte de OpenKM para asegurarse de que esta nueva versión ha sido empaquetada por el equipo de OpenKM. Una vez haya verificado que la nueva versión está disponible y la haya descargado, debe seguir los pasos descritos en esta sección de la documentación.

Precaución

Antes de actualizar Tomcat, recomendamos actualizar a la última versión de OpenKM y asegurarse de tener una copia de seguridad reciente y funcional.

Nota

Aunque puede usar un Tomcat original (pristine), siempre recomendamos usar los proporcionados por el equipo de OpenKM porque tienen ficheros adicionales y configuraciones por defecto que funcionan mejor con OpenKM.

Método rápido

El método más sencillo para actualizar su instancia de Tomcat es seguir estos pasos:

• Detenga el proceso actual de Tomcat / OpenKM.
• Descargue la última versión de Tomcat proporcionada por el equipo de soporte.
• Elimine el contenido de la carpeta TOMCAT_HOME/lib y reemplácelo con el descargado.
• Inicie Tomcat / OpenKM de nuevo.

Una vez finalizado el proceso, puede verificar la nueva versión:

$ cd TOMCAT_HOME
$ ./bin/catalina.sh version

Si tiene alguna duda o pregunta, abra un ticket de soporte.

Linux

Preliminares

• Compruebe en el fichero openkm.properties si tiene una ubicación de ruta de repositorio especial (más información en Cambiar la ubicación del repositorio).

Sustitución de Tomcat

• Detenga el Tomcat actual
• Descomprima el nuevo Tomcat
• Copie estos ficheros y carpetas del Tomcat antiguo al nuevo:

Precaución

Recuerde que, al copiar y mover datos, debe comprobar la seguridad aplicada en el destino. A veces, al mover datos, la seguridad aplicada puede cambiar y causar problemas en el proceso de inicio de OpenKM.

Puede establecerla de forma recursiva:

$ sudo chown openkm:openkm tomcat-9.0.76 -R

Name	Type	Comments
tomcat-XXX/bin/setenv.sh	File	Opcional. Solo es necesario si ha modificado este fichero.
tomcat-XXX/openkm.properties	File	Fichero de configuración de OpenKM. Si se produce un error al copiar este fichero, podría dañar el repositorio. Compruebe que el fichero se ha copiado correctamente al destino.
tomcat-XXX/openkm.xml	File	Fichero de configuración de seguridad de OpenKM. Puede que este fichero no exista. Solo puede encontrarlo en algunas instalaciones especiales.
tomcat-XXX/logback.xml	File	Fichero de configuración de log de OpenKM. Puede que no exista.
tomcat-XXX/repository	Folder	La carpeta donde se almacenan los documentos. Si se produce un error al copiar esta carpeta, podría dañar el repositorio. Compruebe que la carpeta se ha copiado correctamente al destino.
tomcat-XXX/plugins	Folder	Directorio con los plugins de OpenKM. Puede estar vacío. Solo contiene ficheros si la instancia de OpenKM tiene personalizaciones.
tomcat-XXX/webapps	Folder	Aplicación de OpenKM desplegada.
tomcat-XXX/jbpm-console.properties	File	Fichero de configuración del motor jBPM. Puede que este fichero no exista. Solo existe si el motor jBPM ha sido instalado.

• Actualice la configuración del servicio de Tomcat:
  • Cambie la ruta de Tomcat en /etc/init.d/openkm
• Inicie OpenKM
• Vaya a Administration > Parámetros de configuración
• Filtre en la esquina superior derecha por la palabra “tomcat”
• Reemplace la ruta antigua de Tomcat usada en los parámetros de configuración por la nueva ruta.
• Reinicie el servicio de OpenKM.
• Haga una prueba rápida.

Nota

Prueba rápida sugerida:

• Navegue por el repositorio.
• Descargue un fichero existente.
• Suba un fichero nuevo e intente descargarlo.

Peligro

Recuerde actualizar el script de copia de seguridad porque la ubicación del directorio de Tomcat puede cambiar. En Linux puede comprobarlo ejecutando (como root):

$ crontab -l

De esta forma, puede ver la ubicación del script de copia de seguridad.

Conservar el Tomcat antiguo es una buena idea, pero tenga en cuenta que el script de copia de seguridad normalmente respalda todo el directorio /home/openkm, así que muévalo a otro lugar.

Si desea una rama más reciente puede probar Tomcat 9.0, pero tenga en cuenta que esta nueva rama no ha sido probada completamente y no está soportada por el equipo de OpenKM.

Windows

Preliminares

• Desde Services, compruebe el usuario que ejecuta OpenKM. Normalmente, el usuario debería ser “Local Services”, pero a veces se usa un usuario estándar. Recuerde, al registrar de nuevo el servicio de OpenKM, elegir el usuario correcto.
• Compruebe en el fichero openkm.properties si tiene una ubicación de ruta de repositorio especial (más información en Cambiar la ubicación del repositorio).

Sustitución de Tomcat

• Detenga OpenKM desde Services.
• Elimine OpenKM de Services.

Nota

Dos opciones para eliminar OpenKM de Services:

Primera opción:

• Abra un terminal como usuario Administrador.
• Vaya a la carpeta tomcat-XXX/bin.
• Ejecute el siguiente comando:

$:> service.bat remove

Segunda opción:

• Abra un terminal como usuario Administrador.
• Ejecute el siguiente comando:

$:> sc delete OpenKM

• Descomprima el nuevo Tomcat.
• Copie estos ficheros y carpetas del Tomcat antiguo al nuevo:

Precaución

Recuerde que, al copiar y mover datos, debe comprobar la seguridad aplicada en el destino. A veces, al mover datos, la seguridad aplicada puede cambiar y causar problemas en el proceso de inicio de OpenKM.

Name	Type	Comments
tomcat-XXX\bin\setenv.bat	File	Opcional. Solo es necesario si ha modificado este fichero.
tomcat-XXX\openkm.properties	File	Fichero de configuración de OpenKM. Si se produce un error al copiar este fichero, podría dañar el repositorio. Compruebe que el fichero se ha copiado correctamente al destino.
tomcat-XXX\openkm.xml	File	Fichero de configuración de seguridad de OpenKM. Puede que este fichero no exista. Solo puede encontrarlo en algunas instalaciones especiales.
tomcat-XXX\logback.xml	File	Fichero de configuración de log de OpenKM. Puede que no exista.
tomcat-XXX\repository	Folder	La carpeta donde se almacenan los documentos. Si se produce un error al copiar esta carpeta, podría dañar el repositorio. Compruebe que la carpeta se ha copiado correctamente al destino.
tomcat-XXX\plugins	Folder	Directorio con los plugins de OpenKM. Puede estar vacío. Solo contiene ficheros si la instancia de OpenKM tiene personalizaciones.
tomcat-XXX\extras	Folder	Aplicaciones de terceros usadas por OpenKM
tomcat-XXX\webapps	Folder	Aplicación de OpenKM desplegada.
tomcat-XXX\jbpm-console.properties	File	Fichero de configuración del motor jBPM. Puede que este fichero no exista. Solo existe si el motor jBPM ha sido instalado.

• Configure OpenKM como servicio

Nota

• Abra un terminal como usuario Administrador.
• Vaya a la carpeta tomcat-XXX/bin.
• Ejecute el siguiente comando:

$:> service.bat install

• Ejecute el siguiente comando:

$:> openkm //US//OpenKM ++JvmOptions="-XX:+UseG1GC"
$:> openkm //US//OpenKM ++JvmOptions="-XX:+UseStringDeduplication"
$:> openkm //US//OpenKM ++JvmOptions="-XX:+HeapDumpOnOutOfMemoryError"
$:> openkm //US//OpenKM ++JvmOptions="-XX:HeapDumpPath=$CATALINA_HOME"
$:> openkm //US//OpenKM ++JvmOptions="-Djava.net.preferIPv4Stack=true"
$:> openkm //US//OpenKM ++JvmOptions="-Dmail.mime.ignoreunknownencoding=true"
$:> openkm //US//OpenKM ++JvmOptions="-Dfile.encoding=utf-8"
$:> openkm //US//OpenKM ++JvmOptions="-Dsun.jnu.encoding=UTF-8"
$:> openkm //US//OpenKM ++JvmOptions="-Djava.awt.headless=true"
$:> openkm //US//OpenKM ++JvmOptions="-Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider"

• Inicie el servicio de OpenKM
• Vaya a Administration > Parámetros de configuración
• Filtre en la esquina superior derecha por la palabra “tomcat”.
• Reemplace la ruta antigua de Tomcat usada en los parámetros de configuración por la nueva ruta.
• Reinicie el servicio de OpenKM.
• Haga una prueba rápida.

Nota

Prueba rápida sugerida:

• Navegue por el repositorio.
• Descargue un fichero existente.
• Suba un fichero nuevo e intente descargarlo.