Ir al contenido
Otras versiones

Cargando…

Migración de 8.1 a 8.2

La herramienta de migración de OpenKM actualiza directamente una instancia OpenKM 8.1.24 a 8.2.10, sin pasar por las versiones intermedias. Instala Tomcat 10 y OpenKM 8.2.10 sobre la misma base de datos que usa la instancia 8.1.24, actualiza el esquema de la base de datos y traslada sus documentos y 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.

  • La instancia debe estar exactamente en la versión 8.1.24. 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.24.
  • 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.10.
  • 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.

Si los documentos están dentro de la carpeta del Tomcat 9 (<tomcat>/repository, lo habitual), la herramienta los enlaza con hardlinks en el Tomcat 10 nuevo: no ocupan más espacio en disco y los originales no se modifican. Si el Tomcat nuevo está en otro sistema de ficheros, se copian. Esto incluye el contenido de los documentos, el texto extraído, la caché de previsualizaciones y las plantillas OCR de cada tenant. El índice de búsqueda no se traslada (vea Índice de búsqueda).

Las carpetas que openkm.properties sitúa fuera de Tomcat (repository.home, repository.datastore.home, repository.extraction.home, repository.cache.home o repository.ocr.template.home) no se mueven: OpenKM 8.2 las sigue usando.

Se migran todos los tenants: la base de datos se actualiza entera y las carpetas de cada tenant (tenant_1, tenant_2…) se trasladan como se explica en Documentos.

Su licencia debe cubrir todos sus tenants. Si admite menos tenants de los que tiene la instancia, la licencia no es válida.

La migración actualiza la misma base de datos, así que la licencia también se migra: OpenKM 8.2 conserva el Installation ID de OpenKM 8.1 (y su licencia offline, si la tiene). No hace falta registrar una licencia nueva.

  • Los sellos se conservan tal cual.
  • Los informes se conservan, pero ninguno funciona en OpenKM 8.2 hasta convertirlo: OpenKM 8.2 usa JasperReports 7, que solo lee su propio formato JRXML, no el de JasperReports 6 de OpenKM 8.1. Hasta entonces, al ejecutar un informe da el error «Unable to load report». Abra cada informe en Jaspersoft Studio 7, guárdelo en el formato nuevo y vuelva a subirlo en Administration > Reports. Los informes que usan clases de OpenKM también pueden necesitar cambios.
  • La autenticación con LDAP o Active Directory se conserva: su configuración (okm.authentication.ldap y las claves ldap.*) pasa al nuevo openkm.properties junto con el resto de sus ajustes propios. Compruebe que los usuarios de LDAP pueden entrar.
  • Descargue la herramienta en el directorio base de su instalación (la carpeta donde está el symlink tomcat):
Ventana de terminal
$ cd /opt/openkm
$ wget https://download.openkm.com/okm/OKMMigrator.jar
  • Ejecútela desde ahí mismo:
Ventana de terminal
$ 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.10 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.

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.

Cuando haya comprobado durante unos días que OpenKM 8.2 funciona bien (los documentos se abren, las búsquedas funcionan tras reconstruir el índice, los usuarios entran con normalidad), puede eliminar lo que queda de OpenKM 8.1. Hasta entonces, consérvelo todo: es la única vuelta atrás.

  • Servicio: no hay que hacer nada. El servicio mantiene su nombre (openkm en Linux, OpenKM en Windows) y ahora arranca OpenKM 8.2; la herramienta sustituyó el de la 8.1. Con --no-service no se registró ningún servicio.

  • Base de datos: no hay nada que borrar. OpenKM 8.2 usa la misma base de datos, actualizada. Conserve el backup que hizo antes de la migración el tiempo que exija su política de copias: es la única copia de la base de datos de la 8.1.

  • Carpeta del Tomcat 9 antiguo (por ejemplo, /opt/openkm/tomcat-9.0.x; el symlink tomcat apunta ya a la del Tomcat 10): se puede borrar, pero antes compruebe dónde guarda OpenKM 8.2 los documentos (vea Documentos):

    • Con hardlinks (mismo disco, lo habitual): borrar la carpeta antigua solo quita los nombres de los ficheros de la 8.1. OpenKM 8.2 conserva los suyos, así que no se pierde nada, pero tampoco se libera espacio de los documentos: nunca estuvieron duplicados.
    • Copiados (Tomcat 10 en otro disco): los ficheros de la 8.1 son un duplicado. Borrar la carpeta antigua libera ese espacio.
    • Symlink (una carpeta del repositorio de la 8.1 era un enlace simbólico, por ejemplo a otro disco): el Tomcat nuevo tiene un enlace al mismo sitio. Borrar la carpeta del Tomcat antiguo solo quita el enlace antiguo, pero no borre la carpeta a la que apunta: la usa OpenKM 8.2.
    • Carpetas fuera de Tomcat (repository.home o repository.*.home en openkm.properties): OpenKM 8.2 las usa tal cual. No las borre.

    El resumen de la consola y OKMMigrator.log indican cuántos ficheros se enlazaron con hardlinks y cuántos se copiaron. Para comprobarlo en Linux, ls -l muestra un número de enlaces de 2 o más en un fichero con hardlink.

  • Restos: se pueden borrar OKMMigrator.jar, OKMMigrator.log, OKMInstaller.jar y OKMInstaller.log del directorio base, y openkm.properties.8.1.24 (una copia de la configuración antigua) de la carpeta del Tomcat 10. Conserve OKMUpdater.jar para futuras actualizaciones.

Parámetro Descripción
-p, –old-properties Ruta al fichero openkm.properties de la instalación 8.1.24. 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.24.
-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.24. Para otra disposición de carpetas, use -p y -d.

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.