Una migración de Moodle mal ejecutada se detecta semanas después, cuando un estudiante reclama una nota que desapareció. Esta guía describe el procedimiento que aplicamos y los puntos donde se pierde información.
Los tres componentes que deben viajar juntos
Una instancia de Moodle no es solo una base de datos. Son tres componentes que deben migrarse de forma consistente y en el mismo punto temporal: la base de datos (usuarios, cursos, calificaciones, registros de actividad), el directorio de datos o moodledata (archivos subidos, respaldos, caché) y el código fuente con sus plugins y tema.
El error más frecuente es migrar la base de datos un día y los archivos al siguiente. Toda la actividad ocurrida entre ambos momentos queda inconsistente: hay registros en la base que apuntan a archivos que no existen en el destino. Por eso la migración se hace con la plataforma en mantenimiento, no en caliente.
Inventario previo, antes de tocar nada
Antes de mover un solo archivo conviene documentar la versión exacta de Moodle, la versión de PHP y de la base de datos, la lista completa de plugins con su versión, el tamaño de moodledata y el número de usuarios y cursos activos.
Ese inventario cumple dos funciones: permite reproducir el entorno en el destino y sirve como línea base para validar la migración. Sin él, la verificación posterior se convierte en una impresión subjetiva de que «parece que funciona».
El procedimiento
Validación: qué comparar exactamente
La validación no es entrar y ver que carga la portada. Compare contra el inventario previo el número total de usuarios, el número de cursos visibles, una muestra de calificaciones de al menos tres cursos distintos, el acceso a archivos subidos en fechas diversas y el funcionamiento del envío de correo.
Especial atención a los registros de finalización de curso: es el dato que con más frecuencia se corrompe en migraciones y el que tiene consecuencias académicas directas cuando se pierde.
El error de posicionamiento que casi nadie contempla
Si el dominio cambia, y no solo el servidor, hay una consecuencia adicional: los enlaces indexados apuntan a la dirección antigua. Sin redirecciones permanentes desde las URL anteriores hacia las nuevas, se pierde el posicionamiento acumulado y los enlaces guardados por los usuarios dejan de funcionar.
La regla es simple: una redirección 301 por cada URL relevante, mantenida durante al menos un año.