Actualización de Tomcat

Precaución

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

• 10.1.52 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 quiera mantener su instalación actualizada. En ese caso, debe abrir un ticket en el sitio de soporte de OpenKM para asegurarse de que esta nueva versión ha sido empaquetada por el equipo de OpenKM. Una vez que 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 disponer de una copia de seguridad reciente que funcione.

Nota

Aunque puede usar un Tomcat sin modificar, siempre recomendamos usar los proporcionados por el equipo de OpenKM porque incluyen 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 sustitúyalo por el descargado.
• Inicie de nuevo Tomcat / OpenKM.

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 especial de la ruta del repositorio (más información en Change repository home).

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, al copiar y mover datos, comprobar la seguridad aplicada en el destino. A veces, al mover datos, la seguridad aplicada puede cambiar y causar problemas en el proceso de arranque de OpenKM.

Puede establecerlos de forma recursiva:

$ sudo chown openkm:openkm tomcat-10.1.52 -R

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

• Actualice la configuración de su servicio 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 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 backup, ya que la ubicación del directorio de Tomcat puede cambiar. En Linux, puede comprobarlo ejecutando (como root):

$ crontab -l

De este modo, puede ver la ubicación del script de backup.

Conservar el Tomcat antiguo es una buena idea, pero tenga en cuenta que el script de backup normalmente hace copia de seguridad de 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 rama no se ha probado completamente y no está soportada por el equipo de OpenKM.

Windows

Preliminares

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

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 administrador.
• Vaya a la carpeta tomcat-XXX/bin.
• Ejecute el siguiente comando:

$:> service.bat remove

Segunda opción:

• Abra un terminal como 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, al copiar y mover datos, comprobar la seguridad aplicada en el destino. A veces, al mover datos, la seguridad aplicada puede cambiar y causar problemas en el proceso de arranque de OpenKM.

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

• Configure OpenKM como servicio

Nota

• Abra un terminal como 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 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.