En esta ocasión veremos cómo instalar MediaWiki en CentOS 8 paso a paso, para que puedas trabajar con este popular CMS o sistema de contenido tipo «wiki» desde tu servidor o VPS CentOS.
Contenido
Antes de instalar MediaWiki en CentOS 8
Con el fin de poder seguir los pasos de esta guía de instalación de MediaWiki en CentOS 8 será preciso partir de la siguiente base:
- Una máquina CentOS 8 actualizada.
- El entorno o pila tipo LAMP (servicio web con PHP y bases de datos).
- Acceso a consola con un usuario con permisos de sudo.
- Conexión a Internet.
Si no dispones aún del entorno necesario, puede ser de utilidad consultar previamente nuestra guía de instalación de la pila LAMP en CentOS 8 o nuestra guía de instalación de PostgreSQL en CentOS 8.
También necesitamos algunas herramientas 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 tar wget
Cómo descargar MediaWiki para CentOS 8
Vamos a descargar MediaWiki para CentOS 8 desde el sitio de descargas oficial para asegurarnos de obtener la última versión estable:
Descargamos el paquete .tar.gz disponible directamente desde el navegador o desde consola si trabajamos remotamente con alguna utilidad como wget:
~$ wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.0.tar.gz
Cómo instalar MediaWiki en CentOS 8
Para instalar MediaWiki en CentOS 8 tendremos que seguir una serie de pasos que preparen el sistema y así poder lanzar el instalador web. Describimos estos pasos con detalle a continuación.
Archivos de MediaWiki
Descomprimimos el paquete que acabamos de descargar en la ruta que nos interese, según la forma de integrar esta aplicación en el servicio web (en este caso sencillo formará parte del sitio web por defecto):
~$ sudo tar xf mediawiki-1.36.0.tar.gz -C /var/www/html/
Como el subdirectorio que se crea contiene números de versión, podemos renombrarlo o crear un enlace simbólico que facilite la configuración y mantenimiento:
~$ sudo ln -s /var/www/html/mediawiki-1.36.0/ /var/www/html/wiki
Finalmente, cambiamos la propiedad de los archivos al usuario con el que corre el servicio web:
~$ sudo chown -R apache: /var/www/html/mediawiki-1.36.0/
PHP
MediaWiki exige la presencia en CentOS 8 de algunas extensiones de PHP que podemos instalar fácilmente desde los repositorios:
~$ sudo yum install -y php-gd php-intl php-pecl-apcu
Base de datos
Como cualquier aplicación web compleja, MediaWiki trabaja sobre una base de datos, admitiendo varios de los motores más usados en CentOS 8.
PostgreSQL
Creamos el usuario que administrará la base de datos:
~$ sudo -iu postgres createuser -P wiki
Y creamos la base de datos, asociándola al nuevo usuario:
~$ sudo -iu postgres createdb wiki -O wiki
MariaDB/MySQL
Conectamos al servicio con el cliente mysql y un usuario administrador:
~$ mysql -u root -p
Creamos la base de datos para MediaWiki:
> create database wiki;
En MariaDB o MySQL 5 creamos el usuario de la forma habitual:
> create user wiki@localhost identified by 'XXXXXXXX';
Pero en MySQL 8 conviene especificar el plugin de autenticación compatible:
> create user wiki@localhost identified with mysql_native_password by 'XXXXXXXX';
Especificamos los permisos del usuario sobre la base:
> grant all privileges on wiki.* to wiki@localhost;
Y cerramos la conexión:
> exit
SELinux
Es necesario permitir la conexión al servicio de bases de datos desde el servicio web, para lo que utilizamos la herramienta setsebool:
~$ sudo setsebool -P httpd_can_network_connect_db on
Instalador web
Es el momento de acceder al instalador web de MediaWiki para CentOS 8 desde un navegador, para lo que introduciremos la dirección (IP, nombre DNS, dominio, etc.) añadiendo la ruta de instalación.
Por ejemplo, la máquina CentOS 8 sobre la que hemos preparado este tutorial es accesible en el subdominio centos8.local.lan, y hemos instalado MediaWiki en la ruta wiki/ dentro del sitio principal, por lo que podemos usar http://centos8.local.lan/wiki/ como URL de acceso:
Como no está instalado y configurado, nos remite al instalador web, al que accedemos siguiendo el enlace «set up the wiki«.
En la primera página del instalador elegimos el idioma para la instalación y para el sitio wiki:
Seguidamente se realiza la comprobación del entorno para MediaWiki:
Si has seguido los pasos anteriores, todos los requisitos imprescindibles para la instalación deberían cumplirse. En caso contrario se informará del problema concreto, que habrá que solucionar para poder continuar.
El siguiente paso será la configuración de la conexión a la base de datos:
Seleccionamos el tipo de motor de bases de datos y cumplimentamos los datos de conexión, tal como los creamos en pasos anteriores.
Continuamos con la configuración del usuario de acceso a la base de datos:
Es posible utilizar usuarios distintos para la instalación y para el acceso al sitio wiki, pero lo habitual es usar el mismo (que es el único que hemos creado en este tutorial).
A continuación configuramos datos de personalización del sitio:
También creamos un usuario administrador con el que poder acceder tras la instalación.
Al final de esta página se nos pregunta si deseamos realizar más ajustes de configuración, que es lo aconsejable, por lo que la siguiente página mostrará muchas más opciones de personalización:
Terminada toda la configuración, estamos listos para iniciar el verdadero proceso de instalación de MediaWiki en CentOS 8:
El proceso es muy rápido y mostrará el resultado de todas las operaciones que realice:
Finalizada la instalación se descarga automáticamente un archivo LocalSettings.php que es la configuración del sitio wiki y que debemos copiar en el directorio de instalación de MediaWiki que preparamos anteriormente.
En este ejemplo suponemos que hemos descargado el archivo en nuestro directorio de inicio. Si trabajamos remotamente habrá que cargar de alguna manera este archivo en el servidor CentOS 8.
~$ sudo mv LocalSettings.php /var/www/html/mediawiki-1.36.0/
Antes de continuar hay que tener en cuenta que el archivo LocalSettings.php carece del contexto de SELinux adecuado para ser accesible vía web, por lo que debemos aplicárselo con el comando restorecon:
~$ sudo restorecon -R /var/www/html/mediawiki-1.36.0/
Ya podemos entrar a MediaWiki utilizando la URL que utilizamos anteriormente o siguiendo el enlace «entrar en tu wiki» de la página actual del instalador:
Para iniciar sesión con el usuario que creamos durante la instalación, seguiremos el enlace «Acceder» del menú superior:
Iniciada la sesión volveremos a la página principal del sitio wiki, pero ya podremos empezar a personalizarlo y crear contenido:
Conclusión
Ahora que sabes cómo instalar MediaWiki en CentOS 8 ya puedes empezar a crear una comunidad de contenidos y usuarios fácilmente desde tu servidor o VPS CentOS, para documentar todo tipo de proyectos.
¡Apoya comoinstalar.me!
¿Ya funciona MediaWiki en tu sistema CentOS 8? Si es así y quieres agradecérnoslo colaborando con el mantenimiento de este sitio y la creación de más artículos y tutoriales, puedes hacerlo invitándonos a un café:
O dejando una propina de 1 $ desde PayPal:
¡Gracias!