Cómo migrar Moodle de hosting y dominio

Dificultad Alta

¿Estás considerando migrar tu plataforma Moodle a un nuevo hosting y dominio? La migración de Moodle puede parecer una tarea desafiante, pero con nuestra guía puedes realizar el proceso sin problemas y garantizar que tu aula virtual siga funcionando sin interrupciones. En este artículo, te brindaremos una guía completa paso a paso sobre cómo migrar Moodle de un hosting antiguo a uno nuevo. Descubre los aspectos clave que debes tener en cuenta durante todo el proceso y asegúrate de una transición exitosa hacia un nuevo servidor.

La migración de Moodle es un proceso crucial para asegurarte de que tu plataforma de aprendizaje en línea esté disponible y funcionando correctamente en tu nuevo entorno. Asegúrate de seguir los pasos y las mejores prácticas que te presentaremos a continuación para garantizar una migración exitosa. Nosotros en particular lo empleamos para la creación de un aula virtual, la cual desarrollamos en un servidor temporal hasta tener el ok del cliente.

Antes de iniciar la migración de Moodle, es importante realizar algunas tareas de preparación en el hosting antiguo. Estos son los pasos que debes seguir:

Paso 1: Realiza una copia de seguridad completa de los ficheros

Antes de realizar cualquier cambio, asegúrate de realizar una copia de seguridad completa de todos los archivos de tu instalación de Moodle en el hosting antiguo. Esto te permitirá restaurar fácilmente tu plataforma en caso de cualquier problema durante la migración. Puedes bajarte los ficheros utilizando programas como Filezilla, aunque te recomiendo el siguiente proceso:

Busca el «administrador de archivos» dentro de tu panel de control de hosting. En la siguiente imagen nos encontramos en un cPanel aunque si trabajas con PLESK, también tendrás la misma opción y las mismas características que vienen a continuación:

Una vez dentro del gestor de ficheros, localiza la carpeta donde tengas los ficheros de tu Moodle y pulsa botón derecho para elegir la opción «Comprimir» en formato «ZIP».

Cuando se haya creado el fichero .zip con todos los ficheros y el proceso haya finalizado, descarga el fichero y guárdalo en tu ordenador.

 

Este proceso te ayudará a ganar velocidad a la hora de descargar los ficheros del servidor antiguo y subirlos al nuevo.

Atención: estás trabajando con Moodle, eso quiere decir que existen 2 carpetas que tienes que migrar: la carpeta donde está la instalación y la carpeta «moodledata» que se denomina por defecto aunque puedes ponerle otro nombre. La carpeta de «moodledata» se encuentra en un nivel anterior a la instalación de Moodle generalmente. Es decir, «moodledata» no está dentro del mismo directorio donde se encuentra la instalación. Esto es importante ya que en el caso de no migrar ambas carpetas, tu migración es más que probable que falle.

Paso 2: Exporta la base de datos

Accede al panel de control de tu hosting antiguo y utiliza la herramienta phpMyAdmin u otra herramienta de gestión de bases de datos para exportar la base de datos de Moodle en formato SQL. Guarda el archivo exportado en tu computadora para utilizarlo más adelante mediante la herramienta «Exportar» que encontrarás en las opciones superiores cuando pinchas en el nombre de la base de datos. Si pinchas en una tabla y le das a «Exportar» solo te exportará la tabla en la que te encuentres:

Amplía más información sobre cómo exportar una base de datos desde phpMyAdmin.

Paso 3: Configuración PHP del nuevo servidor

Una vez que hayas completado los pasos de la copia de seguridad del antiguo servidor, es hora de trabajar en el servidor final. Revisa la configuración PHP del servidor temporal.

Moodle es realmente exigente con la configuración del servidor. Necesita tener cubiertos una serie de parámetros a nivel configuración para funcionar. Cada versión es diferente en cuanto a lo que necesita para poder ser instalado. En primer lugar, revisa qué versión de PHP está utilizando tu servidor temporal y asegúrate de que el servidor final corre en la misma versión. 

Deberás asegurarte de que todo lo relacionado con la configuración de PHP esté correcta y sea lo más similar entre el server de pruebas (o antiguo) y el servidor final. Es posible que tengas que revisar las extensiones de PHP que estén activas. A mí personalmente me pasó que en el nuevo sitio no estaba activa la extensión: «intl» y «opcache». Accedí a las versiones de PHP y en las extensiones las activé:

Paso 4: Vuelca el contenido en el nuevo servidor y la base de datos

Importar ficheros

Llegados a este punto, con el servidor final ya configurado y la copia de seguridad lista, deberemos volcar la información. Al igual que hemos descargado el fichero .zip comprimiendo la carpeta, te recomiendo que hagas lo mismo en el nuevo servidor. Dirígete al gestor de archivos y sube los ficheros que has descargado de tu anterior servidor a sus sitios correspondientes.

Una vez subidos en este gestor, pincha botón derecho sobre ellos y descomprímelos de forma que los ficheros se queden emplazados en sus carpetas correspondientes. CUIDADO con que al descomprimir no se cree una nueva carpeta dentro de la carpeta donde se están descomprimiendo. Deberás tener 2 carpetas: la de la instalación de Moodle y la de «moodledata» en un escalón superior.

Importar la base de datos

En el mismo panel, crea una nueva base de datos con formato UTF8MB4 para que se puedan emplear los emojis y demás caracteres especiales. Crea un usuario y un password con todos los privilegios para acceder a esta base de datos. Guarda los datos de conexión de base de datos: nombre de base de datos, usuario y password, pues los necesitarás a continuación.

Con estos datos guardados, abre la copia de tu base de datos en un editor de texto tipo «Sublime Text» o «Notepad ++». En esencia, en cualquier programa que pueda leer código fuente de manera rápida y amigable. Con el fichero abierto, pulsa «control+H» para reemplazar un texto. En este caso, deberás reemplazar tu antiguo dominio por el nuevo si lo vas a cambiar. De esa manera, todas las rutas y URLs que hayan en la base de datos con el antiguo dominio cambiarán. Guarda el fichero.

Una vez creada la base de datos y modificada la copia del anterior servidor, impórtala mediante la herramienta de importación que existe en phpMyAdmin. Si tienes problemas a la hora de trabajar con tu base de datos porque es muy grande, visita nuestro artículo: Cómo trabajar con bases de datos SQL Grandes.

Paso 5: Actualización de datos de los ficheros de Moodle

1. Actualiza la configuración del archivo config.php: Accede a la carpeta raíz de tu instalación de Moodle en el nuevo servidor y encuentra el archivo config.php. Edítalo y actualiza los detalles de conexión de la base de datos con los nuevos valores correspondientes al nuevo servidor.
2. Verifica la configuración de rutas: Comprueba las rutas de los archivos y las carpetas en la configuración de Moodle para asegurarte de que estén apuntando correctamente a las ubicaciones en el nuevo servidor. Si es necesario, realiza ajustes en las rutas para reflejar la estructura de carpetas del nuevo entorno.
3. Actualiza las URL: En la configuración de Moodle, actualiza las URL del sitio para que reflejen el nuevo dominio y la estructura de enlaces en el nuevo servidor. Esto garantizará que los enlaces internos y externos funcionen correctamente en tu plataforma.

Ejemplo de fichero config.php y los campos que deberás modificar:

<?php  // Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype    = 'mariadb';
$CFG->dblibrary = 'native';
$CFG->dbhost    = 'localhost';
$CFG->dbname    = 'NOMBRE_BASE_DATOS'; //este campo deberás modificarlo
$CFG->dbuser    = 'USUARIO_BASE_DATOS'; //este campo deberás modificarlo
$CFG->dbpass    = 'PASS_BASE_DATOS'; //este campo deberás modificarlo
$CFG->prefix    = 'mdl_'; //este campo NO deberías tener que modificarlo
$CFG->dboptions = array (
  'dbpersist' => 0,
  'dbport' => '',
  'dbsocket' => '',
  'dbcollation' => 'utf8mb4_general_ci',
);

$CFG->wwwroot   = 'https://NUEVO_DOMINIO_FINAL.com';
$CFG->dataroot  = '/home/ruta/public_html/moodledata100'; // especificar donde está la carpeta moodledata con ruta absoluta del servidor
$CFG->admin     = 'admin';

$CFG->directorypermissions = 0777;

require_once(__DIR__ . '/lib/setup.php');
?>

Paso 6: Pruebas y verificación

Una vez que hayas realizado todas las configuraciones necesarias ya deberías poder acceder a tu Moodle en el nuevo dominio. ¡Enhorabuena!

Es importante realizar pruebas exhaustivas para asegurarte de que la migración de Moodle se haya realizado correctamente. Aquí hay algunas actividades clave que debes realizar:

1. Verifica el inicio de sesión: Intenta iniciar sesión en tu plataforma de Moodle utilizando las credenciales de usuario existentes. Asegúrate de que el inicio de sesión sea exitoso y que todos los usuarios puedan acceder a sus cuentas sin problemas.
2. Explora los cursos y contenidos: Navega por los cursos y los contenidos en tu plataforma de Moodle para asegurarte de que todo se haya migrado correctamente. Verifica que los cursos, las lecciones, los recursos y las actividades estén disponibles y funcionando correctamente.
3. Realiza pruebas de funcionalidad: Prueba diferentes funciones de Moodle, como la creación de nuevos cursos, la inscripción de usuarios y el envío de tareas. Asegúrate de que todas las funciones principales estén operativas y que no haya errores o problemas inesperados.
4. Verifica los enlaces y las referencias: Comprueba que todos los enlaces internos y externos en tus cursos y recursos estén funcionando correctamente. Asegúrate de que no haya enlaces rotos y que todas las referencias estén actualizadas para reflejar el nuevo dominio y las rutas en el nuevo servidor.

¿Qué más necesito saber sobre la migración de Moodle de servidor y dominio?

Migrar Moodle de un hosting y dominio a otro puede parecer un proceso complejo, pero siguiendo los pasos adecuados y teniendo en cuenta los aspectos clave, puedes realizar la migración de manera exitosa. Recuerda realizar copias de seguridad regulares durante todo el proceso y planificar adecuadamente para evitar interrupciones en el acceso a tu plataforma de aprendizaje en línea.

Si sigues esta guía completa paso a paso, podrás migrar Moodle sin problemas y garantizar que tu aula virtual siga funcionando sin interrupciones en el nuevo servidor. Recuerda que el proceso de migración puede variar dependiendo de tu configuración de hosting y dominio específica. Si tienes dudas o encuentras dificultades, es recomendable consultar con un experto en desarrollo web o buscar asistencia adicional en los foros de soporte de Moodle para obtener una guía más personalizada.