En este artículo abordamos cómo instalar MediaWiki en FreeBSD 12 paso a paso, con lo que podrás tener tu propio sitio web colaborativo tipo «wiki» aprovechando las capacidades de tu servidor o VPS FreeBSD.
Contenido
Antes de instalar MediaWiki en FreeBSD 12
En caso de que quieras seguir los pasos de esta guía de instalación de MediaWiki en FreeBSD 12 debes asegurarte de cumplir los siguientes requisitos:
- Un sistema FreeBSD 12 actualizado.
- El entorno o pila FAMP (servicio web con PHP y bases de datos).
- Un usuario con permisos de sudo.
- Acceso a Internet.
Si no dispones todavía del entorno necesario sin duda te será de utilidad consultar nuestra guía de instalación de la pila FAMP en FreeBSD 12.
Cómo descargar MediaWiki para FreeBSD 12
Vamos a descargar MediaWiki para FreeBSD 12 desde la página de descargas del sitio oficial del proyecto:
Encontraremos la última versión estable de MediaWiki en formato .zip y .tar.gz, que podremos descargar directamente desde el navegador, o también desde consola con el comando fetch:
~$ fetch https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.0.tar.gz
Cómo instalar MediaWiki en FreeBSD 12
El proceso de instalar MediaWiki en FreeBSD 12 implica la realización de una serie de tareas que permitirán que el instalador web pueda hacer su trabajo sin encontrar problemas. Veremo seguidamente todos estos preparativos.
Archivos de MediaWiki
Descomprimimos el paquete que acabamos de descargar en su ubicación definitiva:
~$ sudo tar xf mediawiki-1.36.0.tar.gz -C /usr/local/www/apache24
Como el directorio que se acaba de crear contiene el número de versión en el nombre, creamos un enlace simbólico sin números que permitirá facilitar la instalación y mantenimiento de MediaWiki:
~$ sudo ln -s /usr/local/www/apache24/mediawiki-1.36.0/ /usr/local/www/apache24/mediawiki
Servicio web
En el caso de Apache creamos un archivo de configuración para hacer accesible MediaWiki:
~$ sudo nano /usr/local/etc/apache24/Includes/mediawiki.conf
El contenido será la creación de un alias para el acceso web y el permiso de uso de archivos .htaccess para acceder a características avanzadas:
Alias /wiki /usr/local/www/apache24/mediawiki
<Directory /usr/local/www/apache24/mediawiki>
Require all granted
</Directory>
Guardamos el archivo y recargamos la configuración del servicio web:
~$ sudo service apache24 reload
PHP
MediaWiki necesita la presencia en FreeBSD 12 de ciertas extensiones que instalamos desde el repositorio del sistema:
~$ sudo pkg install -y php74-{ctype,dom,fileinfo,gd,iconv,intl,json,mbstring,openssl,pecl-apcu,session,xml}
Si tu versión de PHP es distinta, cambia el prefijo php74- por phpXX- en el comando anterior, según corresponda.
Recargamos la configuración del servicio web para que las extensiones estén disponibles:
~$ sudo service apache24 reload
Base de datos
Como cualquier aplicación web potente, MediaWiki trabaja sobre una base de datos, permitiéndose el uso de varios motores de los más usados en FreeBSD 12. Veremos cómo preparar algunos de ellos.
PostgreSQL
Creamos un rol con contraseña:
~$ sudo -u postgres createuser -P my_wiki
Y creamos la base de datos asociándola al rol anterior:
~$ sudo -u postgres createdb my_wiki -O my_wiki
MySQL/MariaDB
Conectamos con el cliente mysql y un usuario administrador:
~$ mysql -u root -p
Creamos la base de datos para MediaWiki:
> create database my_wiki charset utf8mb4 collate utf8mb4_unicode_ci;
En MariaDB o MySQL 5 creamos el usuario de la siguiente forma:
> create user my_wiki@localhost identified by 'XXXXXXXX';
Pero en MySQL 8 además es interesante especificar el plugin de autenticación más compatible:
> create user my_wiki@localhost identified with mysql_native_password by 'XXXXXXXX';
En cualquier caso, concedemos los permisos al usuario sobre la base:
> grant all privileges on my_wiki.* to my_wiki@localhost;
Y cerramos la sesión:
> exit
Instalador web
Ya podemos acceder al instalador web de MediaWiki para FreeBSD 12 desde el navegador, indicando la dirección IP, dominio, nombre DNS, ect. y la ruta o alias de la aplicación.
Por ejemplo, la máquina FreeBSD 12 sobre la que hemos preparado este tutorial es accesible en el subdominio freebsd12.local.lan, y hemos creado el alias /wiki, de manera que podemos usar http://freebsd12.local.lan/wiki como URL:
Como la aplicación no está configurada se nos muestra un enlace «set up the wiki» para acceder al instalador.
En la primera página del instalador elegimos el idioma para el usuario y para la aplicación:
A continuación se comprobará el entorno:
Si has seguido los pasos anteriores, todos los requisitos se cumplirán y podremos continuar con la instalación de MediaWiki.
Seguidamente debemos configurar la conexión al motor de bases de datos:
Seleccionaremos el tipo de motor de bases de datos que utilicemos e introduciremos base de datos, usuario y contraseña tal como los creamos anteriormente.
Podremos elegir si queremos trabajar con un usuario de la base de datos distinto al anterior para el acceso a la misma:
No es necesario utilizar distintos usuarios, pero si queremos hacerlo antes tendremos que crearlo, o dar permisos suficientes a alguno existente.
Pasamos a la configuración del sitio wiki:
Le daremos un nombre al sitio y crearemos el usuario administrador. Al final de esta página tendremos la oportunidad de acceder a otra página adicional de configuraciones:
Por fin tenemos configurado todo lo necesario para iniciar la instalación, aunque podríamos retroceder para hacer algún cambio:
El proceso de instalación apenas toma unos instantes, tras los cuales se mostrará el resultado de todas las operaciones realizadas:
La página de fin de instalación provocará la descarga automática del archivo de configuración del sitio wiki, llamado LocalSettings.php:
Si no trabajamos localmente tendremos que cargar de alguna forma (FTP, SSH, scp, etc.) este archivo en el servidor FreeBSD 12.
Asumiendo que este archivo ya está presente en el directorio de trabajo, habrá que copiarlo en el directorio de instalación:
~$ sudo cp LocalSettings.php /usr/local/www/apache24/mediawiki/
Hecho esto podemos utilizar la URL inicial, o seguir el enlace «entrar en tu wiki» de la página de fin de la instalación, para acceder a nuestro nuevo sitio wiki:
Podremos iniciar sesión con el usuario que creamos durante la instalación mediante el enlace «Acceder» del menú superior:
Se volverá a mostrar la página principal, pero ahora tendremos la oportunidad de empezar a realizar configuraciones y crear contenido:
¡Todo listo para trabajar con tu nuevo sitio wiki!
Conclusión
Ahora que sabes cómo instalar MediaWiki en FreeBSD 12 ya puedes utilizar tu servidor o VPS para ofrecer contenido web colaborativo al más puro estilo «wiki» como tantos sitios en Internet, tanto para tu red local como a través de Internet.
¡Apoya comoinstalar.me!
¿Ya funciona MediaWiki sobre tu sistema FreeBSD 12? En ese caso, si quieres agradecérnoslo aportando tu granito de arena al 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 desde PayPal:
¡Gracias!
