Actualización de Mautic 4

Este artículo va dedicado a aquellos administradores web entre cuyas labores se encuentre el mantenimiento de una instalación Mautic. Por eso no voy a explicar qué es Mautic: si no lo conoces, este artículo carece de interés.

Vamos a partir de la base que el usuario UNIX, propietario de la instalación, es mautic y que la instalación se encuentra desplegada en /home/mautic/public_html/acmecrm/

Mautic 4.x puede actualizarse de dos maneras.

Comando Mautic ( php bin/console mautic:)

Estos son los pasos a seguir:

1. Copias de seguridad de la base de datos y archivos:
   • cp -rap /home/mautic/public_html/acmecrm /home/mautic/public_html/acmecrm-bk
2. Navegación al directorio raíz de Mautic y limpieza de caché.
   • cd /home/mautic/public_html/acmecrm
   • php bin/console cache:clear
3. Eliminación total del caché (por si acaso).
   • rm -rf /home/mautic/public_html/acmecrm/var/cache/prod/*
4. Actualización a la nueva versión que detectamos primero y aplicamos después:
   • php bin/console mautic:update:find
   • php bin/console mautic:update:apply
5. Finalización de la actualización de la base de datos:
   • php bin/console mautic:update:apply --finish
6. Restauración del fichero local.php y .htaccess desde el backup.
   • cp /home/mautic/acmecrm-bk/app/config/local.php /home/mautic/public_html/acmecrm/app/config/
   • cp /home/mautic/acmecrm-bk/.htaccess /home/mautic/public_html/acmecrm/

Usando composer

En caso de que Mautic esté configurado para ser actualizado con composer, estos son los pasos a seguir

1. Copia de seguridad
2. Navegación al directorio raíz de Mautic
   • cd /home/mautic/public_html/acmecrm/docroot
3. Ejecución de una actualización de Composer de prueba (que no efectúa cambios) a fin de verificar que no habría errores.
   • composer update mautic/core-lib --with-all-dependencies --dry-run
4. Actualización de la librería principal de de Mautic.
   • composer update mautic/core-lib --with-all-dependencies
5. Modificación del archivo composer.json para cambiar la versión de mautic/core-lib y resto de ocurrencias de mautic/* a la última versión (a fecha de este artículo la «4.4.12»).
6. Actualización de todas las dependencias de Mautic.
   • composer update
7. Actualización de la base de datos.
   • php bin/console doctrine:migration:migrate
8. Restauración del fichero local.php y .htaccess desde el backup.
   • cp /home/mautic/acmecrm-bak/docroot/app/config/local.php /home/mautic/public_html/acmecrm/docroot/app/config/
   • cp /home/mautic-bak/acmecrm/docroot/.htaccess /home/mautic/public_html/acmecrm/docroot/
9. Limpieza de la caché de Mautic.
   • php bin/console cache:clear