Migración de 6.3.13 a 7.0

Visión general

Esta guía describe el proceso de migración de OpenKM CE 6.3 a OpenKM CE 7.0. Es una migración mayor —no una actualización directa— debido a los profundos cambios estructurales en el esquema de la base de datos subyacente.

Por qué es una migración mayor

OpenKM 7.0 introduce cambios arquitectónicos significativos en la forma de almacenar y versionar los datos:

• El versionado de nodos ahora registra los cambios a nivel de metadatos, no solo a nivel del contenido del documento. Cualquier modificación de los metadatos de un nodo genera una nueva entrada de versión.
• Cada grupo de metadatos está ahora respaldado por dos tablas relacionadas (en lugar de una), lo que cambia de forma fundamental la estructura de la base de datos respecto a la versión 6.3.
• Como consecuencia de estos cambios de esquema, no existe una vía de actualización directa de 6.3 a 7.0. Los datos deben exportarse del sistema de origen e importarse en el sistema de destino.

Precaución

Importante: antes de iniciar la migración, asegúrese de disponer de una copia de seguridad completa tanto de los datos del repositorio como de la base de datos de 6.3. El proceso de exportación/importación no es destructivo para el sistema de origen, pero no es posible deshacerlo en el sistema de destino una vez importados los datos.

Requisitos previos

• Una instancia de OpenKM 6.3 CE en funcionamiento con acceso administrativo.
• Una instancia de OpenKM 7.0 CE en funcionamiento, recién instalada y configurada.
• Espacio en disco suficiente en el destino de la exportación: toda la estructura de carpetas, los documentos, los metadatos y el historial de versiones se escribirán en disco.
• Acceso de red o de sistema de archivos para transferir los datos exportados del servidor 6.3 al servidor 7.0.
• Conocimiento de los grupos de metadatos personalizados definidos en 6.3, ya que deben volver a registrarse manualmente en 7.0 antes de importar.

Pasos de la migración

Paso 1 — Exportar el repositorio de OpenKM 6.3

Inicie sesión en el panel de administración de OpenKM 6.3 y vaya a Repository Export. Repita el procedimiento de exportación para cada uno de los nodos del repositorio que se indican a continuación:

Nodo del repositorio	Descripción
okm:root	Repositorio principal de documentos: todas las carpetas y documentos.
okm:categories	Taxonomía de categorías aplicada a los documentos.
okm:templates	Plantillas de documentos.
okm:personal	Espacios de trabajo personales de cada usuario.
okm:mail	Archivo de correo.
okm:trash	Elementos eliminados (inclúyalo si necesita recuperarlos).

Para cada nodo, siga estos pasos en la interfaz de Repository Export:

1. Source path: introduzca la ruta del nodo del repositorio que se va a exportar (por ejemplo, okm:root).
2. Destination folder: seleccione una ruta del sistema de archivos del servidor 6.3 con espacio libre suficiente para todo el contenido exportado.
3. Marque la casilla Metadata.
4. Marque la casilla History.
5. Haga clic en el botón Export y espere a que finalice el proceso.

Nota

Nota: asegúrese de utilizar una carpeta de destino distinta para cada nodo. Mezclar nodos en la misma carpeta provocará errores de importación.

Paso 2 — Transferir los datos exportados al servidor 7.0

Una vez completadas todas las exportaciones, copie las carpetas exportadas al servidor de OpenKM 7.0. Utilice cualquier método de transferencia seguro adecuado para su infraestructura (por ejemplo, SCP, SFTP, un recurso de red compartido o una unidad portátil). La estructura de carpetas debe conservarse exactamente tal como se exportó.
Anote las rutas absolutas del sistema de archivos donde se colocan las carpetas exportadas en el servidor 7.0, ya que las necesitará en el paso 4.

Paso 3 — Registrar los grupos de metadatos en OpenKM 7.0

Si su instalación 6.3 utilizaba grupos de metadatos personalizados, deben recrearse manualmente en 7.0 antes de importar ningún dato. Importar documentos que hacen referencia a grupos de metadatos que todavía no existen en 7.0 puede provocar pérdida de datos o errores de importación.

1. Inicie sesión en el panel de administración de OpenKM 7.0.
2. Recree cada grupo de metadatos que existiera en 6.3, con los mismos nombres de campo, tipos y estructura.
3. Active cada grupo en el perfil correspondiente para que esté disponible en el sistema.

Paso 4 — Importar el repositorio en OpenKM 7.0

En el panel de administración de OpenKM 7.0, vaya a Administration > Tools > Repository Import. Repita el procedimiento de importación para cada nodo exportado:

1. Source folder: seleccione la carpeta del sistema de archivos que contiene los datos exportados de este nodo.
2. Repository path: introduzca la ruta de destino en el repositorio 7.0 donde se deben importar los datos (por ejemplo, /okm:root).
3. Type: seleccione Full en el desplegable Type.
4. Haga clic en el botón Import y espere a que finalice el proceso antes de importar el siguiente nodo.

Precaución

Importante: importe los nodos de uno en uno. No inicie una nueva importación hasta que la anterior haya terminado por completo. Las importaciones simultáneas pueden provocar incoherencias en el repositorio.

Verificación posterior a la migración

Una vez importados todos los nodos, verifique lo siguiente:

• La estructura de carpetas y documentos de 7.0 coincide con la del repositorio 6.3 de origen.
• Los metadatos de los documentos están correctamente rellenados en una muestra representativa de documentos.
• El historial de versiones de los documentos está presente cuando corresponde.
• Las categorías y los grupos de metadatos están correctamente asociados a los documentos.
• Los permisos de usuario y los derechos de acceso están correctamente asignados (nota: puede ser necesario recrear o sincronizar por separado las cuentas de usuario).