En esta entrada veremos cómo instalar MediaWiki en FreeBSD 11 paso a paso, de modo que puedas tener tu propio sitio wiki sobre tu servidor o VPS FreeBSD.
Contenido
Antes de instalar MediaWiki en FreeBSD 11
Para poder completar los pasos de esta guía de instalación de MediaWiki en FreeBSD 11 será necesario partir de la siguiente base:
- Un servidor FreeBSD 11 actualizado.
- Un entorno o pila tipo FAMP (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 del entorno necesario puedes consultar previamente nuestra guía de instalación de la pila FAMP en FreeBSD 11, e incluso la guía de instalación de PostgreSQL en FreeBSD 11.
Cómo descargar MediaWiki en FreeBSD 11
Vamos a descargar MediaWiki para FreeBSD 11 desde la sección de descargas del sitio oficial, donde encontraremos el enlace al paquete .tar.gz de la última versión disponible.
Puedes realizar la descarga directamente desde el navegador o, si trabajas remotamente desde consola, descargar el paquete con el comando fetch:
~$ fetch https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.0.tar.gz
Cómo instalar MediaWiki en FreeBSD 11
Para instalar MediaWiki en FreeBSD 11 hay que realizar una serie de preparativos del sistema que detallamos a continuación.
Archivos de MediaWiki
Descomprimimos el paquete que acabamos de descargar directamente en su ubicación definitiva:
~$ sudo tar xf mediawiki-1.36.0.tar.gz -C /usr/local/www/apache24/
Como el nombre del subdirectorio que se crea contiene números de versión, puede ser interesante crear un enlace simbólico sin números:
~$ sudo ln -s /usr/local/www/apache24/mediawiki-1.36.0/ /usr/local/www/apache24/mediawiki
Esto facilitará la configuración y mantenimiento de la aplicación.
Servicio web
Para hacer navegable la aplicación, crearemos un alias para el servicio web desde un archivo de configuración independiente:
~$ sudo nano /usr/local/etc/apache24/Includes/mediawiki.conf
El contenido será el alias y el permiso de acceso al directorio:
Alias /wiki /usr/local/www/apache24/mediawiki
<Directory /usr/local/www/apache24/mediawiki>
Require all granted
</Directory>
En este caso hemos elegido /wiki/ como alias, pero puedes usar el que quieras.
Guardamos el archivo y recargamos la configuración del servicio web:
~$ sudo service apache24 reload
PHP
MediaWiki requiere la presencia en FreeBSD 11 de una serie de extensiones de este lenguaje de programación que instalaremos desde los repositorios del sistema. Elige la versión adecuada para tu sistema, en este artículo usamos la versión 7.4:
~$ sudo pkg install -y php74-dom php74-gd php74-intl php74-mbstring php74-pecl-APCu php74-openssl php74-xml php74-ctype php74-json php74-iconv php74-fileinfo php74-session
Para la versión 8.0 instalaríamos los siguientes paquetes:
~$ sudo pkg install -y php80-dom php80-gd php80-intl php80-mbstring php80-pecl-APCu php80-openssl php80-xml php80-ctype php80-iconv php80-fileinfo php80-session
También necesitaremos la extensión con la que conectar al servicio de bases de datos (indicando el paquete adecuado para la versión de PHP).
Por ejemplo, si vas a trabajar con MariaDB/MySQL, será necesaria la correspondiente extensión:
~$ sudo pkg install -y php74-mysqli
Y si vas a usar PostgreSQL habrá que instalar la suya:
~$ sudo pkg install -y php74-pgsql
Tras la instalación, recargamos la configuración del servicio web para que disponga de estas nuevas extensiones.
~$ sudo service apache24 reload
Bases de datos
MediaWiki puede trabajar con varios de los servicios de bases de datos más utilizados con FreeBSD 11, así que mostraremos cómo preparar los más populares.
MariaDB/MySQL
Conectamos al servicio con el cliente mysql:
~$ mysql -u root -p
Creamos la base de datos:
> create database mediawiki charset utf8mb4 collate utf8mb4_unicode_ci;
En el caso de MariaDB o MySQL 5, creamos el usuario de la forma habitual:
> create user mediawiki@localhost identified by 'XXXXXXXX';
Y en el caso de MySQL 8 lo creamos especificando el plugin de acceso compatible:
> create user mediawiki@localhost identified with mysql_native_password by 'XXXXXXXX';
Concedemos los permisos necesarios sobre la base de datos al usuario:
> grant all privileges on mediawiki.* to mediawiki@localhost;
Y cerramos la conexión:
> exit
PostgreSQL
Creamos un rol con contraseña:
~$ sudo -u postgres createuser -P mediawiki
Y creamos la base de datos, asociándola al nuevo rol:
~$ sudo -u postgres createdb mediawiki -O mediawiki
Instalador web
Para acceder al instalador web de MediaWiki en FreeBSD 11 desde un navegador añadiremos el alias que definimos anteriormente a la dirección IP, nombre DNS, dominio, etc. del servidor.
Por ejemplo, el servidor FreeBSD 11 sobre el que hemos preparado este tutorial es accesible en el subdominio freebsd11.local.lan, y hemos definido el alias /wiki/, así que podemos usar http://freebsd11.local.lan/wiki/ como URL.
Como MediaWiki no está instalado aún, se mostrará un enlace para acceder al instalador web.
En la primera página seleccionaremos el idioma:
A continuación se efectuará una comprobación de requisitos del sistema, mostrándose cuáles se cumplen y cuáles no:
Si has seguido los pasos anteriores, el sistema se encontrará en estado óptimo para continuar con el proceso de instalación.
Seguidamente configuramos la conexión a la base de datos:
Elegiremos el tipo de bases de datos (si hay más de uno disponible) e introduciremos el nombre de la base de datos, el usuario y su contraseña, tal como los creamos anteriormente.
Existe la posibilidad de usar otro usuario de la base de datos sólo para el acceso web, por lo que el instalador nos permite activarlo o no:
En este caso sólo trabajaremos con un usuario, tanto para el acceso como para la modificación de datos.
También tenemos que configurar datos de identificación del sitio, como nombre del wiki, usuario administrador, etc.
Al final de esta página de configuración se nos propone continuar con otra página de configuraciones más detalladas, que repasaremos para dejar a nuestro gusto:
Terminado todo el proceso de configuración, el instalador nos avisa de que el proceso de instalación está listo para comenzar:
Se mostrarán todas las tareas llevadas a cabo por el instalador y su resultado, que debería ser exitoso:
Al continuar se producirá la descarga automática de un archivo llamado LocalSettings.php que contiene la configuración del sitio wiki.
De alguna forma hay que copiar este archivo en el directorio de MediaWiki, ya sea a través de FTP, scp, etc. Para el caso del presente tutorial suponemos que el archivo está en nuestro directorio de usuario, por lo que lo copiaremos en su ubicación definitiva:
~$ sudo cp LocalSettings.php /usr/local/www/apache24/mediawiki
Hecho esto ya podemos entrar en el nuevo sitio wiki, para lo que usamos la URL original o seguimos el enlace «entrar en tu wiki» mostrado en la página actual de fin de la instalación.
Si queremos empezar a personalizar el sitio wiki o crear contenido seguiremos el enlace «Acceder» en el menú superior:
Iniciaremos sesión con el usuario administrador que configuramos anteriormente y ya podremos trabajar directamente sobre nuestro nuevo sitio wiki:
Conclusión
Ahora que sabes cómo instalar MediaWiki en FreeBSD 11 ya puedes crear tu propio sitio wiki en el que ir preparando contenido para tu comunidad.
¡Apoya comoinstalar.me!
¿Ya tienes tu nuevo sitio wiki funcionando gracias a esta guía? Si es así y te apetece agradecérnoslo, puedes ayudar al mantenimiento de este sitio y la creación de más guías y tutoriales invitándonos a un café:
O dejando 1 $ de propina con PayPal:
¡Gracias!
