Migration from v1.7 to v1.8

Resumen

La versión 1.8 sustituye la gestión automática del esquema de Hibernate (ddl-auto=update) por Flyway como único mecanismo para los cambios de esquema de base de datos. A partir de esta versión, todos los cambios DDL quedan versionados, registrados y son repetibles en cualquiera de los motores de base de datos soportados (MariaDB, MySQL, PostgreSQL, Oracle, SQL Server).

Pasos de migración para instalaciones v1.7 existentes

1. Descargue OKMFlow 1.8 desde https://download.openkm.com/pro/tools.

2. Detenga Tomcat y sustituya el archivo okmflow.war.

3. Edite $TOMCAT_HOME/okmflow.properties y aplique los siguientes cambios:

   • Establezca spring.jpa.hibernate.ddl-auto a validate. Hibernate solo verificará el esquema frente a las entidades; Flyway pasa a ser responsable de todos los cambios DDL:

     spring.jpa.hibernate.ddl-auto=validate

   • Añada las dos propiedades de línea base de Flyway. Indican a Flyway que el esquema existente ya corresponde a la línea base de v1.7 y que solo debe aplicar las migraciones posteriores a esa versión:

     spring.flyway.baseline-on-migrate=true
     spring.flyway.baseline-version=1.7.0.0

     Estas líneas se eliminan automáticamente por la aplicación en el primer arranque correcto. No es necesaria ninguna limpieza manual.

4. Inicie Tomcat. En el primer arranque, Flyway:

   • Creará la tabla de seguimiento WF_SCHEMA_HISTORY.
   • Registrará la línea base de v1.7 como ya aplicada.
   • Aplicará todas las migraciones pendientes posteriores a v1.7.

5. Verifique que la aplicación se inició correctamente. Las propiedades de línea base añadidas en el paso 3 se habrán eliminado automáticamente de okmflow.properties.

Instalaciones nuevas

Las instalaciones nuevas no requieren las propiedades de línea base. Flyway detecta una base de datos vacía y aplica todas las migraciones en orden.

Migraciones a v1.9

Vea Migration from v1.8 to v1.9 para conocer los pasos necesarios para actualizar una instalación v1.8 existente a v1.9.