Migración de 8.1 a 8.2

La herramienta de migración de OpenKM actualiza directamente una instancia OpenKM 8.1.23 a 8.2.9, sin pasar por las versiones intermedias. Instala Tomcat 10 y OpenKM 8.2.9 sobre la misma base de datos que usa la instancia 8.1.23, actualiza el esquema de la base de datos y traslada la configuración de su openkm.properties. Tarda entre 10 y 20 minutos, según el tamaño de la base de datos. Puede descargarla desde https://download.openkm.com/okm/OKMMigrator.jar.

Precaución

La herramienta de migración requiere Java 17 o 21, las mismas versiones de Java que requiere OpenKM 8.2. El comando java del PATH debe ser una de estas versiones, porque también se usa para ejecutar el instalador.

Antes de empezar

• La instancia debe estar exactamente en la versión 8.1.23. Si está en una versión anterior de la serie 8.1, actualícela primero con la utilidad Updater. La herramienta comprueba la versión y se detiene sin cambiar nada si no es la 8.1.23.
• Haga un backup completo de la base de datos y del repositorio (documentos) antes de continuar. La herramienta no crea ningún backup por su cuenta, y el cambio de esquema no tiene marcha atrás.
• Tenga a mano el usuario y la contraseña del portal de descargas de OpenKM, los mismos que usa con el instalador. Son necesarios para descargar Tomcat 10 y OpenKM 8.2.9.
• El servidor necesita acceso a https://download.openkm.com. La herramienta descarga de ahí OKMInstaller.jar y OKMUpdater.jar si no están ya en la carpeta de la instalación.

Nota

Si el Tomcat 9 actual está arrancado, la herramienta lo detiene antes de empezar la migración.

Pasos

• Descargue la herramienta en el directorio base de su instalación (la carpeta donde está el symlink tomcat):

$ cd /opt/openkm
$ wget https://download.openkm.com/okm/OKMMigrator.jar

• Ejecútela desde ahí mismo:

$ java -jar OKMMigrator.jar

• Le pedirá el usuario y la contraseña del portal de descargas, y luego una confirmación ([y/N]) recordando lo del backup. Escriba y para continuar.
• A partir de ahí es automático. Verá el progreso en pantalla (instalación de Tomcat 10, actualización del esquema, activación de Flyway). Es normal que tarde varios minutos y que reinicie Tomcat unas cuantas veces.
• Al terminar verá:

### MIGRATION: DONE - now running OpenKM 8.2.9 at http://localhost:8080 ###
Migration completed successfully.

• Verifique que puede entrar con normalidad y que sus documentos siguen ahí.
• Reconstruya el índice de búsqueda desde Administration > Utilities > Rebuild indexes. Ver Índice de búsqueda.

Índice de búsqueda

OpenKM 8.1 (Lucene 8) y OpenKM 8.2 (Lucene 9) usan formatos de índice de búsqueda incompatibles, así que la instancia migrada arranca con el índice de búsqueda vacío. Los documentos, las carpetas y sus metadatos no se ven afectados y se pueden navegar con normalidad, pero no aparecerán en los resultados de búsqueda hasta que se reconstruya el índice desde Administration > Utilities > Rebuild indexes.

Precaución

No copie la carpeta repository/index antigua al nuevo Tomcat: OpenKM 8.2 no puede leerla y falla con Could not load codec 'Lucene87' la primera vez que escribe en el índice.

Parámetros de línea de comandos

Parámetro	Descripción
-p, –old-properties	Ruta al fichero openkm.properties de la instalación 8.1.23. Por defecto, ./tomcat/openkm.properties.
-d, –parent-dir	Carpeta en la que se instala el nuevo Tomcat 10. Por defecto, el directorio base de la instalación 8.1.23.
-f, –force	Omite la confirmación (para uso no interactivo o desde scripts).
--no-service	Tomcat no está configurado como servicio.
-h, –help	Muestra información de ayuda.

Los valores por defecto cubren el caso habitual: ejecutar la herramienta desde el directorio base de la instalación, donde el symlink tomcat que crea el instalador apunta a la instalación 8.1.23. Para otra disposición de carpetas, use -p y -d.

Si algo sale mal

Si la herramienta se detiene con un error, no continúa. Guarde la salida completa de la consola y el fichero OKMMigrator.log (se queda en la carpeta desde la que la ejecutó) y contacte con el soporte de OpenKM.