En este artículo explicamos cómo instalar MediaWiki en CentOS 7 paso a paso, de modo que puedas disponer de una herramienta tipo «wiki» para tu red local o sobre Internet en tu servidor o VPS CentOS.
Contenido
Antes de instalar MediaWiki en CentOS 7
Para seguir los pasos de esta guía de instalación de MediaWiki en CentOS 7 es importante contar con los siguientes requisitos mínimos:
- Una máquina CentOS 7 actualizada.
- Un entorno tipo LAMP (servidor web con servicio de bases de datos y PHP).
- Acceso a consola con un usuario con privilegios de sudo o el mismo root.
- Conexión a Internet.
Además necesitaremos algunas herramientas que podemos obtener desde los repositorios de CentOS 7, por lo que actualizaremos la información de dichos repositorios:
~$ sudo yum update
E instalaremos los paquetes necesarios:
~$ sudo yum install -y wget policycoreutils-python
Cómo descargar MediaWiki para CentOS 7
Vamos a descargar MediaWiki para CentOS 7 visitando la zona de descargas del sitio web oficial del proyecto:
Podemos descargar el paquete .tar.gz directamente desde el navegador o desde consola (si trabajas sobre una máquina remota) con el comando wget:
~$ wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.0.tar.gz
Cómo instalar MediaWiki en CentOS 7
Para instalar MediaWiki en CentOS 7 tendremos que realizar una serie de preparativos del sistema antes de poder lanzar el instalador web. Estos pasos son detallados a continuación.
Archivos
Descomprimirmos los archivos de MediaWiki directamente en la ubicación que nos interese:
~$ sudo tar xf mediawiki-1.36.0.tar.gz -C /var/www/html/
Como el nombre del subdirectorio que se crea contiene el número de versión en su nombre, puede ser interesante renombrarlo sin números para facilitar la instalación y mantenimiento:
~$ sudo mv /var/www/html/mediawiki-1.36.0/ /var/www/html/mediawiki
Base de datos
MediaWiki puede trabajar con distintos servicios de bases de datos en CentOS 7, así que en este tutorial veremos cómo preparar los más usados.
MariaDB/MySQL
Conectamos al servicio con el cliente de consola mysql y tu usuario administrador:
~$ mysql -u root -p
Creamos la base:
> create database mediawiki charset utf8mb4 collate utf8mb4_unicode_ci;
En MySQL 5 ó MariaDB creamos el usuario de forma simple:
> create user mediawiki@localhost identified by 'XXXXXXXX';
En MySQL 8 al crear el usuario es interesante especificar el plugin de acceso adecuado:
> create user mediawiki@localhost identified with mysql_native_password by 'XXXXXXXX';
Damos los privilegios sobre la base al usuario:
> grant all privileges on mediawiki.* to mediawiki@localhost;
Y cerramos la sesión:
> exit
PostgreSQL
Creamos un rol con contraseña:
~$ sudo -iu postgres createuser -P mediawiki
Y creamos la base de datos asociándola al rol anterior:
~$ sudo -iu postgres createdb mediawiki -O mediawiki
PHP
MediaWiki requiere la presencia en CentOS 7 de algunas extensiones de PHP que podemos instalar desde los repositorios del sistema:
~$ sudo yum install -y php-{gd,intl,mbstring,pecl-apcu,xml}
También necesitaremos la extensión que permita la conexión a la base de datos con la que vamos a trabajar, por ejemplo para MariaDB/MySQL:
~$ sudo yum install -y php-mysqlnd
O para PosgtreSQL:
~$ sudo yum install -y php-pgsql
Debemos recargar la configuración del servicio web para aplicar los cambios:
~$ sudo systemctl reload httpd
SELinux
Si tienes SELinux activado en CentOS 7, que es la configuración por defecto, habrá que permitir la conexión del servicio web a bases de datos a través de red, aunque el servicio sea local:
~$ sudo setsebool -P httpd_can_network_connect_db on
Instalador web
Accedemos al instalador web de MediaWiki en CentOS 7 desde un navegador añadiendo a la dirección IP o nombre DNS del servidor CentOS 7 la ruta de instalación.
Por ejemplo, la máquina CentOS 7 sobre la que hemos realizado este tutorial es accesible en el dominio centos7.local.lan, y hemos instalado MediaWiki en la ruta relativa mediawiki/, por lo que usaremos http://centos7.local.lan/mediawiki/ como URL:
Al ser la primera vez que accedemos se nos informa de que no existe el archivo de configuración y se nos facilita el enlace al instalador web.
El primer paso será el de selección de idioma:
Elegimos el idioma para la instalación y el idioma para el sitio wiki.
El siguiente paso es la comprobación de los requisitos del sistema:
Si has seguido los pasos anteriores la comprobación debería ser satisfactoria, de modo que podrás continuar con la instalación.
Es el momento de configurar la conexión a la base de datos:
Seleccionaremos el tipo de bases de datos sobre el que vamos a trabajar y consignaremos la información tal y como hicimos en pasos anteriores.
Se nos pregunta si deseamos utilizar la misma cuenta de la base de datos tanto para el acceso web como para la instalación:
Podemos contestar afirmativamente, ya que en caso contrario deberíamos crear una cuenta más, con menos privilegios.
Continuamos con el proceso de configuración de la instalación:
Introduciremos información de identificación del nuevo sitio wiki, la cuenta del administrador, etc.
Podemos dejar activada la opción «Hazme más preguntas» si queremos poder configurar más aspectos del nuevo sitio wiki.
En tal caso se mostrarán más opciones de configuración:
Se ofrece ayuda contextual para todas las posibles opciones de configuración disponibles.
En este momento es cuando estamos preparados para comenzar el verdadero proceso de instalación:
Se mostrará un resumen de las tareas de instalación así como de su resultado:
Cuando termina la instalación se genera un archivo LocalSettings.php que contiene la configuración del nuevo sitio wiki. Este archivo se descarga automáticamente, o podemos descargarlo a través del enlace mostrado:
De alguna forma debemos copiar o mover este archivo descargado al directorio de MediaWiki, ya sea de forma local, copiándolo remotamente, etc.
El archivo LocalSettings.php no tiene el contexto de SELinux adecuado para acceso por el servicio web, lo que arreglamos creando dicho contexto con semanage:
~$ sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/html/mediawiki/LocalSettings.php"
Y aplicándolo con restorecon:
~$ sudo restorecon /var/www/html/mediawiki/LocalSettings.php
Ahora podemos seguir el enlace «entrar en tu wiki«:
Siguiendo el enlace «Acceder» se presentará la página de inicio de sesión:
Introducimos las credenciales del usuario administrador que creamos durante la instalación y volveremos a la página principal con la sesión iniciada:
¡Listo! Ya podemos empezar a trabajar y personalizar sobre nuestra nueva wiki en CentOS 7 gracias a MediaWiki.
Conclusión
Ahora que sabes cómo instalar MediaWikie en CentOS 7 ya puedes desplegar este servicio web sobre tu servidor o VPS y documentar tus proyectos de forma colaborativa.
¡Apoya este sitio!
Si te ha sido de utilidad esta guía de instalación de MediaWiki en CentOS 7 y quieres agradecérnoslo colaborando con el mantenimiento de este sitio y la creación de nuevos tutoriales, puedes hacerlo invitándonos a un café:
O dejando 1 $ de propina con PayPal:
¡Gracias!
