Cómo instalar Moodle en CentOS 8

En esta entrada vamos a ver cómo instalar Moodle en CentOS 8 / CentOS Stream 8 paso a paso, de modo que puedas montar una de las plataformas de eLearning más aclamadas en tu servidor o VPS CentOS.

Antes de instalar Moodle en CentOS 8

Si quieres seguir esta guía de instalación de Moodle en CentOS 8 debes partir necesariamente de los siguientes requisitos básicos:

En caso de que aún no dispongas del entorno necesario, podría interesarte consulta nuestra guía de instalación de la pila LAMP en CentOS 8. Tienes distintas posibilidades para integrar Moodle en el servicio web de CentOS 8, tanto como el sitio por defecto como un servidor virtual independiente, aunque en este tutorial integraremos la aplicación como parte del sitio por defecto. Es muy importante trabajar con HTTPS, aunque para facilitar el tutorial trabajamos excepcionalmente con HTTP.

También necesitaremos algunas utilidades que podemos obtener desde los repositorios de CentOS 8, por lo que actualizamos las listas de paquetes:

~$ sudo yum update

E instalamos dichas herramientas:

~$ sudo yum install -y policycoreutils-python-utils tar wget

Cómo descargar Moodle para CentOS 8

Puesto que no hay paquetes en los repositorios de la distribución, tenemos que descargar Moodle para CentOS 8 desde su página oficial.

Visitando la zona de descargas encontraremos el enlace de acceso a la última versión estable de Moodle:

Encontraremos Moodle en paquetes con distinto formato de compresión, una versión .tgz y otra .zip. No son enlaces directos, sino que nos conducen a una página de descarga automática. Si en el momento de acceder existe una versión finalizada en +, es la más actualizada, puesto que se le habrán aplicado los parches disponibles desde el lanzamiento de la versión actual.

Puedes descargar el paquete desde el navegador, en este ejemplo copiaremos en enlace y descargaremos el paquete desde consola:

~$ wget https://download.moodle.org/download.php/direct/stable400/moodle-latest-400.tgz

Cómo instalar Moodle en CentOS 8

Antes de poder instalar Moodle en CentOS 8 hay que realizar una serie de preparativos del sistema para que el instalador no encuentre obstáculos posteriormente.

Preparativos de la base de datos

Como muchas aplicaciones web, Moodle se apoya sobre un servicio de bases de datos. En este tutorial explicamos cómo preparar los más usados en CentOS 8 y Moodle.

MariaDB/MySQL

Accedemos a MariaDB o MySQL con nuestro usuario administrador, root, etc. según como lo tengamos configurado, con el cliente de consola mysql y el usuario administrador que usemos:

~$ mysql -u root -p

Empezamos creando la base de datos:

> create database moodle_db charset utf8mb4 collate utf8mb4_unicode_ci;

Creamos el usuario sólo para acceso local, con su contraseña. En MySQL 5.x y MariaDB lo haríamos así:

> create user moodle_user@localhost identified by 'XXXXXXXX';

En MySQL 8.x, sin embargo, es importante especificar además el plugin de autenticación del usuario:

> create user moodle_user@localhost identified with mysql_native_password by 'XXXXXXXX';

Concedemos los permisos al usuario sobre la base de datos:

> grant all privileges on moodle_db.* to moodle_user@localhost;

Refrescamos la tabla de permisos y salimos del cliente:

> exit

PostgreSQL

Creamos un nuevo rol con contraseña:

~$ sudo -iu postgres createuser moodle -P

Y creamos la base de datos asociada sobre la que trabajará Moodle:

~$ sudo -iu postgres createdb moodle -O moodle

Eso es todo lo que necesitamos.

Preparativos de PHP

Moodle requiere que tengamos instaladas ciertas extensiones de PHP en CentOS 8, como pueden ser curl, gd, intl, json, mbstring, opcache, soap, xml, xmlrpc y zip.

~$ sudo yum install -y php-curl php-gd php-intl php-json php-mbstring php-opcache php-soap php-xml php-xmlrpc php-zip

Adicionalmente editaremos el archivo php.ini para realizar algún ajuste:

~$ sudo nano /etc/php.ini

Buscamos la directiva max_input_vars:

...
;max_input_vars = 1000
...

Activamos esta directiva borrando el carácter ; al inicio de línea y le damos el valor requerido:

...
max_input_vars = 5000
...

Guardamos los cambios y recargamos el servicio PHP para aplicar la nueva configuración:

~$ sudo systemctl reload php-fpm

Preparativos de los archivos

Ya podemos descomprimir el paquete de Moodle que descargamos anteriormente en su ubicación definitiva:

~$ sudo tar xf moodle-latest-400.tgz -C /var/www/html/

Además crearemos un directorio para datos de Moodle en la ruta por defecto que se usa en la instalación:

~$ sudo mkdir /var/www/moodledata

Para que Moodle pueda escribir en este directorio (a través del servidor web), cambiaremos el propietario al usuario con el que corre el servicio (apache en el caso de Apache):

~$ sudo chown apache: /var/www/moodledata/

Además, el instalador de Moodle debe poder guardar la configuración en el directorio de la aplicación, así que seguiremos una aproximación similar, cambiando la propiedad del directorio al usuario y grupo que usa el servidor web:

~$ sudo chown -R apache: /var/www/html/moodle/

Preparativos de SELinux

Si tenemos SELinux activado en CentOS 8, como ocurre por defecto, debemos realizar una serie de ajustes.

Además de haberle dado permisos de escritura, el directorio de Moodle debe tener contexto de lectura/escritura para el servidor web, así que definiremos este tipo de contexto:

~$ sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/moodle(/.*)?"

Y lo mismo ocurre con el directorio de datos de Moodle:

~$ sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/moodledata(/.*)?"

Definidos los nuevos contextos, aplicamos el del directorio de Moodle:

~$ sudo restorecon -R /var/www/html/moodle/

Y el que le corresponde al directorio de datos:

~$ sudo restorecon /var/www/moodledata/

Por otro lado, el servicio web y PHP deben poder conectar a Internet para descargar módulos y paquetes extra de Moodle, como los paquetes de idioma:

~$ sudo setsebool -P httpd_can_network_connect on

Apache

En el caso de que instales Moodle en una máquina no muy veloz, para pruebas, etc. es posible que durante la instalación se superen los tiempos de espera entre el servidor web y el servicio PHP, lo que dejaría la instalación a medias. Para evitarlo se puede configurar el tiempo máximo de espera mediante una configuración adicional de Apache, que crearemos en un archivo independiente:

~$ sudo nano /etc/httpd/conf.d/moodle.conf

Con el siguiente contenido:

<IfModule proxy_fcgi_module>
        Timeout 180
        ProxyTimeout 180
</IfModule>

Guardados los cambios y cerrado el archivo, habrá que recargar la configuración del servicio web:

~$ sudo systemctl reload httpd

Puedes alargar o acortar los tiempos de espera según tus propias necesidades, pero si la instalación falla, además de reconfigurar estos tiempos, habrá que borrar los directorios de Moodle, la base de datos e iniciar de nuevo el proceso.

Instalación web

Accedemos a la URL del sitio según la hayamos configurado y aparecerá el instalador web de Moodle.

Por ejemplo, la máquina en la que realizamos este tutorial es accesible en el dominio centos8.local.lan, así que teniendo en cuenta que hemos instalado Moodle en la ruta moodle/ de la raíz de documentos del sitio web por defecto, usaremos http://centos8.local.lan/moodle como URL.

Empezaremos eligiendo el idioma de la instalación y del sitio Moodle:

Seleccionamos el idioma que nos interese y continuamos.

Tendremos que confirmar las rutas de los directorios de Moodle, aunque sólo podemos modificar, si es necesario, el directorio de datos:

El instalador muestra los controladores de bases de datos disponibles, si hay varios en la lista desplegable elegiremos el apropiado para nuestro sistema:

A continuación debemos introducir los datos de conexión, tal como los preparamos anteriormente:

El instalador guardará su configuración y creará la infraestructura de bases de datos necesaria.

Antes de continuar, tenemos que confirmar que estamos de acuerdo con las condiciones de la licencia de Moodle:

Una página de comprobación de requisitos nos mostrará si nuestro sistema CentOS 8 cumple con todos los requerimientos necesarios para el funcionamiento de Moodle:

Si no cumples alguno, puedes intentar satisfacerlo y volver a recargar la página de requisitos.

Comenzará la instalación y se irá generando una larga lista de tareas y el resultado de las mismas:

Al terminar la instalación en sí, continuaremos completando el perfil del administrador del sitio:

Y también los datos del propio sitio Moodle:

La dirección de correo electrónico para el contacto de soporte es obligatoria, aunque no aparezca marcada como tal.

Cuando por fin termina la instalación, entramos directamente en el área personal con la sesión de administrador automáticamente iniciada:

¡Nuestro nuevo sitio Moodle ya está listo para empezar a trabajar con él!

Servicio Cron

Para que la plataforma pueda realizar sus tareas de mantenimiento en segundo plano, crearemos una tarea del servicio Cron dedicada a ello:

~$ sudo nano /etc/cron.d/moodle

El contenido será la siguiente línea:

*/1 * * * * apache /usr/bin/php /var/www/html/moodle/admin/cli/cron.php

Guardamos el archivo y la tarea será ejecutada en el intervalo configurado, es decir, cada minuto, según la configuración recomendada por Moodle.

Ghostscript para Moodle en CentOS 8

Para poder trabajar con edición de documentos PDF en nuestro nuevo sitio Moodle sobre CentOS 8 debemos instalar el paquete ghostscript:

~$ sudo yum install -y ghostscript

Tras la descarga e instalación podremos comprobar desde el panel de control que ha quedado correctamente instalado, visitando la solapa «Extensiones» de la sección «Administración del sitio«, buscando el apartado «Módulos de actividad» y dentro de este «Anotar PDF«. En esta última página encontraremos un enlace «Prueba del PATH de ghostscript«, que al visitarlo mostrará el resultado de la prueba:

Unoconv para Moodle en CentOS 8

Un complemento que se suele utilizar para la conversión de diversos formatos de documentos ofimáticos es Unoconv, que instalaremos desde los repositorios de CentOS 8:

~$ sudo yum install -y unoconv

Unoconv es una herramienta de línea de comandos, pero la mejor forma de integrarlo en Moodle es convertirlo en un servicio, para lo que crearemos su correspondiente archivo de configuración de Systemd:

~$ sudo nano /etc/systemd/system/unoconv.service

El contenido será algo como esto:

[Unit]
Description=Unoconv listener para CentOS 8
After=network.target remote-fs.target nss-lookup.target

[Service]
Type=fork
Environment="UNO_PATH=/usr/lib64/libreoffice/program"
ExecStart=/usr/bin/unoconv --listener

[Install]
WantedBy=multi-user.target

Guardamos el archivo y ya tendremos disponible el servicio unoconv o unoconv.service en CentOS 8.

Para que el servicio esté disponible en cada arranque de CentOS 8, lo habilitamos:

~$ sudo systemctl enable unoconv

Y para arrancar el servicio por primera vez, lo haremos de forma manual:

~$ sudo systemctl start unoconv

Podemos comprobar en cualquier momento el estado del servicio con el comando systemctl status unoconv:

En caso de que SELinux esté activado, habrá que permitir al servicio web el lanzamiento de los comandos necesarios para trabajar con Unoconv:

~$ sudo setsebool -P httpd_execmem on

Ya desde Moodle, en el área personal del usuario administrador accedemos a «Administración del sitio«, solapa «Extensiones«, y buscaremos el apartado «Convertidores de documentos«, donde seguiremos el enlace «Gestionar convertidores de documentos«.

Activamos Unoconv con el icono en forma de ojo:

Seguidamente abrimos el correspondiente enlace «Configuración«, que nos mostrará el resultado de la comprobación de la ruta de Unoconv en el sistema, y nos ofrecerá una prueba del complemento que realizaremos siguiendo el enlace «Probar la ruta de unoconv«.

Al realizar la prueba se convertirá un documento de ejemplo, que podremos descargar en formato PDF con el enlace «Download the coverted pdf file«:

Y todo funciona como era esperable.

Conclusión

Ahora ya sabes cómo preparar tu sistema CentOS 8 para instalar Moodle, de modo que puedes dejar lista esta plataforma de eLearning para empezar a trabajar con ella, sobre tu servidor o VPS.

¡Apoya comoinstalar.me!

Y si esta guía de instalación de Moodle en CentOS 8 te ha resultado útil, quizás quieras realizar una mínima aportación para el mantenimiento de este sitio y la creación de más guías de CentOS 8 y Moodle.

Puedes ayudarnos dejando 1 $ de propina en PayPal:

O, si te sientes especialmente agradecido, puedes invitarnos a un café:

¡Gracias!

¿Dudas, preguntas, sugerencias?

Si tienes dudas, preguntas, sugerencias, etc. siempre puedes dejar un comentario. Los comentarios se moderan para intentar luchar contra el SPAM, pero se revisan prácticamente a diario.

Valora esta entrada