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.
Antes de empezar
Sección titulada «Antes de empezar»- 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.
Documentos
Sección titulada «Documentos»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.
Varios tenants
Sección titulada «Varios tenants»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.
Licencia
Sección titulada «Licencia»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.
Informes, sellos y LDAP
Sección titulada «Informes, sellos y LDAP»- 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.ldapy las clavesldap.*) pasa al nuevoopenkm.propertiesjunto 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):
$ 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. Escribaypara 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.
Índice de búsqueda
Sección titulada «Í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.
Después de la migración: limpieza
Sección titulada «Después de la migración: limpieza»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 (
openkmen Linux,OpenKMen Windows) y ahora arranca OpenKM 8.2; la herramienta sustituyó el de la 8.1. Con--no-serviceno 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 symlinktomcatapunta 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.homeorepository.*.homeenopenkm.properties): OpenKM 8.2 las usa tal cual. No las borre.
El resumen de la consola y
OKMMigrator.logindican cuántos ficheros se enlazaron con hardlinks y cuántos se copiaron. Para comprobarlo en Linux,ls -lmuestra un número de enlaces de 2 o más en un fichero con hardlink. -
Restos: se pueden borrar
OKMMigrator.jar,OKMMigrator.log,OKMInstaller.jaryOKMInstaller.logdel directorio base, yopenkm.properties.8.1.24(una copia de la configuración antigua) de la carpeta del Tomcat 10. ConserveOKMUpdater.jarpara futuras actualizaciones.
Parámetros de línea de comandos
Sección titulada «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.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 algo sale mal
Sección titulada «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.