Cómo actualizar de forma segura SuiteCRM 8.3.0 a la última versión

Hola a todos,

Actualmente estoy ejecutando SuiteCRM 8.3.0 en un entorno local con PHP 8.2.30 y quiero actualizar a la versión más reciente (8.9.x) sin perder datos ni romper nada.

He seguido la guía oficial de actualización para versiones 8.2.x+:
Guía de actualización SuiteCRM 8.x

Esto es lo que intenté:

  1. Descargar el paquete instalable de la versión objetivo (SuiteCRM-8.9.2.zip).

  2. Crear la carpeta tmp/package/upgrade dentro de mi instalación de SuiteCRM y colocar el zip allí.

  3. Ejecutar el comando de actualización desde la CLI de Windows:

& "C:\xampp8\php\php.exe" bin\console suitecrm:app:upgrade -t SuiteCRM-8.9.2
  1. Ejecutar el comando de finalización:
& "C:\xampp8\php\php.exe" bin\console suitecrm:app:upgrade-finalize -t SuiteCRM-8.9.2

Sin embargo, obtengo el siguiente error:

Bad data passed in; Return to Home

He limpiado las carpetas de cache y temporales, verificado que el zip no esté corrupto y que la estructura sea correcta, pero sigue sin funcionar.

Por lo que he investigado, parece que la actualización automática desde CLI en Windows tiene problemas conocidos, y la alternativa más segura es hacer un upgrade manual, copiando los archivos nuevos sobre la instalación existente y preservando config/ y custom/.

Mis dudas:

  • ¿Alguien ha realizado con éxito la actualización de 8.3.0 a 8.9.x en Windows?

  • ¿Existe una forma confiable de usar el comando suitecrm:app:upgrade en Windows sin que aparezca “Bad data passed in”?

  • En caso de hacer el upgrade manual, ¿hay algún detalle crítico que deba tener en cuenta para no perder datos o romper la instalación?

Cualquier orientación o recomendación sería de gran ayuda.

¡Gracias de antemano!


Si quieres, puedo hacer también una versión más corta y directa, ideal para foro, que resuma todo sin tanto detalle técnico pero manteniendo la claridad.

¿Quieres que haga esa versión?