Ir al contenido
Otras versiones

Cargando…

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.

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, okmAdmin incluido, 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.
  • 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=db en su OpenKM.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 datasource jdbc/OpenKMDS de conf/server.xml (o conf/context.xml), donde lo configura el instalador, y el resto de OpenKM.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í:
Ventana de terminal
$ 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 como okmAdmin con su contraseña nueva, reparta las demás y borre el fichero. Para que cada usuario cambie la suya en su primer acceso, configure user.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.

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.

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).