Actualización de Tomcat

Precaución

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

• 9.0.115 y posteriores

Por defecto, OpenKM se instala con una versión concreta de Tomcat. Pero cada pocas semanas se publica una versión nueva y es posible que desee mantener su instalación actualizada. En ese caso, debe abrir un ticket en el sitio web de soporte de OpenKM para asegurarse de que el equipo de OpenKM ha empaquetado esta nueva versión. Una vez que haya comprobado que la nueva versión está disponible y la haya descargado, debe seguir los pasos que se describen 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 disponer de una copia de seguridad reciente que funcione.

Nota

Aunque puede utilizar un Tomcat limpio, siempre recomendamos utilizar los que proporciona el equipo de OpenKM, porque incluyen archivos 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 el último Tomcat proporcionado por el equipo de soporte.
• Elimine el contenido de la carpeta TOMCAT_HOME/lib y sustitúyalo por el contenido descargado.
• Vuelva a iniciar Tomcat / OpenKM.

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

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

Linux

Preliminares

• Revise el archivo openkm.properties para ver si tiene una ubicación especial de la ruta del repositorio (más información en Cambiar el directorio home del repositorio).

Sustitución de Tomcat

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

Precaución

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

Puede establecerlos de forma recursiva:

$ sudo chown openkm:openkm tomcat-9.0.115 -R

Nombre	Tipo	Comentarios
tomcat-XXX/bin/setenv.sh	File	Opcional. Solo es necesario si ha modificado este archivo.
tomcat-XXX/openkm.properties	File	Archivo de configuración de OpenKM. Si se comete un error al copiar este archivo, podría dañarse el repositorio. Compruebe que el archivo se ha copiado correctamente al destino.
tomcat-XXX/openkm.xml	File	Archivo de configuración de seguridad de OpenKM. This file might not exist. You can find this file only in a special installation.
tomcat-XXX/logback.xml	File	Archivo de configuración de registro de OpenKM. Puede no existir.
tomcat-XXX/repository	Folder	La carpeta donde se almacenan los documentos. Si se comete un error al copiar esta carpeta, podría dañarse 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 archivos si la instancia de OpenKM tiene personalizaciones.
tomcat-XXX/webapps	Folder	Aplicación de OpenKM desplegada.
tomcat-XXX/jbpm-console.properties	File	Archivo de configuración del motor jBPM. This file might not exist. This file exists only if the jBPM engine has been installed.

• Actualice la configuración del servicio de Tomcat:
  • Cambie la ruta de Tomcat en /etc/init.d/openkm
• Inicie OpenKM
• Vaya a Administration > Configuration parameters
• Filtre en la esquina superior derecha por la palabra “tomcat”
• Sustituya la ruta antigua de Tomcat utilizada 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:

• Explore el repositorio.
• Descargue un archivo existente.
• Suba un archivo nuevo e intente descargarlo.

Peligro

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

$ crontab -l

De este modo, podrá 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 suele copiar todo el directorio /home/openkm, así que muévalo a otro lugar.

Windows

Preliminares

• En Servicios, compruebe el usuario que ejecuta OpenKM. Normalmente el usuario debería ser “Servicio local”, pero a veces se utiliza un usuario estándar. Recuerde elegir el usuario correcto al volver a registrar el servicio de OpenKM.
• Revise el archivo openkm.properties para ver si tiene una ubicación especial de la ruta del repositorio (más información en Cambiar el directorio home del repositorio).

Sustitución de Tomcat

• Inicie OpenKM desde los servicios.
• Elimine OpenKM de los servicios.

Nota

Dos opciones para eliminar OpenKM de los servicios:

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 archivos y carpetas del Tomcat antiguo al nuevo:

Precaución

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

Nombre	Tipo	Comentarios
tomcat-XXX\bin\setenv.bat	File	Opcional. Solo es necesario si ha modificado este archivo.
tomcat-XXX\openkm.properties	File	Archivo de configuración de OpenKM. Si se comete un error al copiar este archivo, podría dañarse el repositorio. Compruebe que el archivo se ha copiado correctamente al destino.
tomcat-XXX\openkm.xml	File	Archivo de configuración de seguridad de OpenKM. Este archivo puede no existir. Solo se encuentra en instalaciones especiales.
tomcat-XXX\logback.xml	File	Archivo de configuración de registro de OpenKM. Puede no existir.
tomcat-XXX\repository	Folder	La carpeta donde se almacenan los documentos. Si se comete un error al copiar esta carpeta, podría dañarse 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 archivos si la instancia de OpenKM tiene personalizaciones.
tomcat-XXX\extras	Folder	Aplicaciones de terceros utilizadas por OpenKM
tomcat-XXX\webapps	Folder	Aplicación de OpenKM desplegada.
tomcat-XXX\jbpm-console.properties	File	Archivo de configuración del motor jBPM. Este archivo puede no existir. Solo existe si se ha instalado el motor jBPM.

• 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 > Configuration parameters
• Filtre en la esquina superior derecha por la palabra “tomcat”.
• Sustituya la ruta antigua de Tomcat utilizada 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:

• Explore el repositorio.
• Descargue un archivo existente.
• Suba un archivo nuevo e intente descargarlo.