Resumen
Para actualizar una instancia de Moodle a la versión 5.x no basta con subir versión de Moodle. El salto desde Moodle 4.5 a Moodle 5 exige MySQL 8.4 en el servidor y, en muchos casos, una versión del theme compatible con Moodle 5. Si no se cumplen estos dos requisitos, la actualización se queda bloqueada o el sitio queda inaccesible.
Pasos típicos de actualización
Subir Moodle a la versión 4.5 como paso intermedio (Moodle no soporta saltos directos entre versiones muy distantes).
Actualizar MySQL del servidor a 8.4. Es una tarea de servidor, la realiza el equipo de TropicalServer.
Subir Moodle a la versión 5.x.
Restituir o reinstalar el theme con una versión compatible con Moodle 5.
Por qué hay que actualizar MySQL antes
Moodle 5 incorpora consultas y tipos de datos que no son compatibles con versiones de MySQL anteriores a 8.4. Si se intenta actualizar el código de Moodle sin actualizar el motor de base de datos, la instalación falla durante el upgrade y el sitio puede dejar de cargar.
Avisos importantes antes de actualizar MySQL
La actualización del servicio de MySQL es a nivel de servidor entero, no de una sola cuenta. Por tanto afecta a todas las instancias de Moodle y a cualquier otra aplicación que conviva en ese mismo servidor (otros CMS, aplicaciones a medida, scripts propios, etc.).
Antes de iniciar el cambio el cliente debe confirmar por escrito que:
Todas sus instancias de Moodle son compatibles con MySQL 8.4 (las versiones actuales de Moodle 4.x y 5.x lo son).
No hay otra aplicación a medida o de terceros en el servidor que requiera una versión más antigua de MySQL.
El equipo de TropicalServer puede facilitar la lista de aplicaciones detectadas en el servidor para que el cliente verifique este punto.
El tema (theme) puede no migrar
Muchos themes de pago no publican versión compatible con Moodle 5 al mismo tiempo que Moodle libera la versión nueva. Si el theme instalado no es compatible:
La actualización se realiza temporalmente con el theme "boost" de Moodle (incluido por defecto) para no bloquear el paso de versión.
Una vez completada la actualización, el cliente debe facilitar el ZIP del theme en una versión compatible con Moodle 5.
Si el theme es de pago, normalmente se descarga desde la zona del cliente del proveedor del theme, donde suelen estar disponibles versiones para distintas releases de Moodle.
Servicio de actualizaciones por instancia
Importante: el servicio de actualizaciones de Moodle se contrata por instancia, no por servidor. Si en un mismo servidor hay varios Moodle instalados y se quiere mantener todos actualizados por TropicalServer, debe contratarse el servicio una vez por cada instancia.
Tiempos y planificación
Una actualización completa Moodle 4 → 5 suele requerir varias ventanas de mantenimiento porque encadena tres operaciones (Moodle 4.5, MySQL 8.4, Moodle 5.x) y la reinstalación del theme. Conviene planificarla fuera de horario de clases para minimizar el impacto sobre los usuarios.
Si tu Moodle es crítico
Antes de iniciar la actualización es recomendable:
Verificar que existe copia reciente en JetBackup (se hacen automáticamente cada 2 horas).
Comunicar a profesores y alumnos la ventana de mantenimiento prevista.
Tener identificado el theme y versión actual y la URL del proveedor del theme por si hay que descargar una versión nueva.