Migración de 6.4 a 8.2
La herramienta de migración de OpenKM instala OpenKM 8.2 junto a una instalación OpenKM 6.4, en una base de datos nueva, y le copia el repositorio de la 6.4, igual que desde la 7.1. Copia los datos directamente entre las dos bases de datos, así que tarda segundos o minutos en vez de las horas que necesitaría la Importación de base de datos. OpenKM 6.4 solo se lee: su base de datos y sus documentos no cambian, y conserva su servicio hasta que la migración termina bien. Puede descargarla desde https://download.openkm.com/okm/OKMMigrator.jar.
Es la misma herramienta que la de la migración de 7.1 a 8.2, y casi todo lo que explica esa página vale también aquí: esta recoge lo que cambia con la 6.4.
Qué se migra
Sección titulada «Qué se migra»Lo mismo que desde la 7.1: carpetas, documentos con todas sus versiones, records y correos, con sus metadatos, notas, keywords, categorías, permisos, suscripciones, bloqueos, relaciones, tareas, bookmarks, usuarios y roles, y los sellos. Con estas diferencias:
- Contraseñas: OpenKM 6.4 las guarda de una forma que OpenKM 8.2 no puede comprobar, así que cada usuario,
okmAdminincluido, recibe una contraseña nueva (vea Pasos). - Metadatos: OpenKM 6.4 no guarda su histórico. OpenKM 8.2 tiene sus valores actuales, y cada grupo de metadatos aparece como una versión más del nodo. La herramienta arranca OpenKM 8.2 una segunda vez para registrar los grupos de metadatos de la 6.4, de modo que es la propia 8.2 la que crea sus tablas.
- Tareas: en OpenKM 8.2 una tarea tiene un solo usuario asignado. Si una tarea de la 6.4 tenía varios, o roles, el primer usuario queda asignado, y el resto y los usuarios de esos roles pasan a recibir avisos.
- Además, no se migran el foro, la wiki, las grapas, los contactos, OMR, los tipos CMIS, las conexiones con Dropbox, Google Drive y Zoho, ni las consultas y suscripciones compartidas. Si hay datos de eso, la herramienta avisa.
Antes de empezar
Sección titulada «Antes de empezar»- OpenKM 6.4 debe estar sobre MySQL, MariaDB o PostgreSQL, con los documentos en disco. Si los guarda en la base de datos (
repository.datastore.backend=dben suOpenKM.cfg), la herramienta se detiene sin hacer nada. - OpenKM 6.4 no tiene
openkm.properties: la herramienta lee la conexión a su base de datos del datasourcejdbc/OpenKMDSdeconf/server.xml(oconf/context.xml), donde lo configura el instalador, y el resto deOpenKM.cfg. - Cree la base de datos vacía de la 8.2, haga un backup y tenga a mano el usuario y la contraseña del portal de descargas, igual que desde la 7.1.
- Valores de metadatos largos: OpenKM 8.2 guarda cada propiedad en una columna de 128 caracteres (textos y desplegables) o de 256 (áreas de texto), salvo que el grupo indique otro tamaño, y en OpenKM 6.4 caben 512. Si algún valor no cabe, la herramienta se detiene e indica qué propiedades son.
- Descargue la herramienta en el directorio base de la instalación 6.4 (la carpeta donde está el enlace simbólico
tomcat) y ejecútela desde ahí:
$ cd /opt/openkm$ wget https://download.openkm.com/okm/OKMMigrator.jar$ java -jar OKMMigrator.jar- Reconoce OpenKM 6.4 por su
tomcat/OpenKM.cfg. Si el Tomcat está en otra carpeta, indíquelo con-p <carpeta del Tomcat>/OpenKM.cfg. - Sus preguntas, comprobaciones y confirmación son las mismas que desde la 7.1, y el resto también, salvo que arranca OpenKM 8.2 dos veces: una para que cree el esquema de su base de datos y otra para registrar los grupos de metadatos de la 6.4.
- Al terminar verá
### MIGRATION 6.4 -> 8.2: DONE ###seguido de los pasos que quedan, los mismos que desde la 7.1 salvo el primero:- Contraseñas nuevas. Están en
<carpeta de la 8.2>/migrated-users-passwords.csv(por ejemplo,/opt/openkm-8.2/migrated-users-passwords.csv), que solo puede leer su propietario. Arranque OpenKM 8.2 con su servicio, entre comookmAdmincon su contraseña nueva, reparta las demás y borre el fichero. Para que cada usuario cambie la suya en su primer acceso, configureuser.password.expiration(días) en Administración > Configuración (vea Parámetros de configuración). - Después, ejecute MailPreviewFromRaw, reactive la tarea Mail Extractor Worker, reconstruya el índice de búsqueda y registre la licencia, igual que desde la 7.1.
- Contraseñas nuevas. Están en
Si OpenKM 6.4 solo guardó las cabeceras de un correo y no el mensaje completo, la herramienta reconstruye un mensaje con ellas y el texto del correo, y sus adjuntos se migran como documentos, porque no se pueden volver a extraer.
Documentos, limpieza y si algo falla
Sección titulada «Documentos, limpieza y si algo falla»Igual que desde la 7.1, con la base de datos y las carpetas de la 6.4. Sin multitenant.mode=on, OpenKM 6.4 guarda los documentos en <repository.home>/datastore y el texto extraído en <repository.home>/extraction, sin carpeta de tenant; OpenKM 8.2 los guarda en tenant_1.
Los parámetros de la línea de comandos son los mismos que desde la 7.1, salvo que -p es la ruta al OpenKM.cfg de la 6.4 (por defecto, ./tomcat/OpenKM.cfg).