iDempiere Version Upgrade (Playbook)

Objetivo

Hacer upgrades repetibles y con riesgo controlado:

• minor updates (parches/bugs),
• major upgrades (cambios potencialmente breaking),
• migraciones desde ADempiere/Compiere cuando aplique.

Inputs a pedir

• Version actual y version destino (y si es minor vs major).
• Lista de plugins (publicos/privados) + como se instalan (p2/feature, dropins, manual).
• Si existe source code del core y de customizaciones.
• Tamaño de DB (dump) y ventana de mantenimiento.
• Si el DB es administrado por un DBA (sin acceso directo).
• Si se limpio el changelog en el pasado (impacta verificadores post-migracion).

Workflow recomendado (alto nivel)

1. Clasificar la migracion
   • Minor: update + validar + pasar a prod.
   • Major: assessment + plan + restore point + migraciones iterativas + verificacion + tuning.
2. Assessment del estado actual
   • Inventariar: custom source code, cambios DB, plugins, y baseline (si existe).
   • Si no hay sources: decidir si se reconstruye (decompile) o si conviene re-implantar y migrar datos.
3. Plan de migracion
   • Leer migration notes (breaking) + changelog de releases + commits relevantes.
   • Identificar customizaciones obsoletas (features ya existen en core) y planificar su remocion.
4. Restore point y ejecucion
   • Backups (DB + carpeta de servidor) y rollback claro.
   • Aplicar scripts de migracion y resolver errores de forma iterativa.
5. Verificacion post-migracion
   • Ejecutar helpers de verificacion (si aplica) para detectar customizaciones sobre-escritas.
   • Revisar plugins/EntityType/colisiones.
6. Performance tuning
   • Medir transacciones lentas y ajustar indices/planes, incluyendo impactos por upgrade de PostgreSQL.

Referencia

Para checklist detallado y casos frecuentes, ver references/migration-playbook.md.