Instalación de MediaWiki 1.10 en Debian

0
13341

Creación: 19-07-2007

Índice de contenidos

1. Introducción

Hace tiempo que las "wikis" están de moda, y no es para menos. Podríamos decir que, básicamente, una wiki es una web colaborativa donde varios usuarios editan los contenidos para compartir conocimiento.

Teniendo en cuenta esto, una wiki se puede convertir en una potente herramienta para el desarrollo de proyectos software, ya que permitiría de forma sencilla y centralizada, por ejemplo mantener toda la documentación de los proyectos. Permitiendo a todos los desarrolladores ir evolucionando esta información, y acceder a ella de forma muy sencilla a través de su navegador.

En este tutorial vamos a ver como instalara MediaWiki (http://www.mediawiki.org).
Este es un sistema de wiki con licencia GPL, que inicialmente se construyo para la Wikipedia (http://www.wikipedia.org), aunque luego se ha usado para muchos otros sistemas (por ejemplo para la mozilla wiki http://wiki.mozilla.org).

MediaWiki guardará los contenidos en una base de datos MySQL, con la ventaja adicional de que guarda el histórico de cambios de forma que si nos equivocamos resulta sencillo volver a la versión anterior del contenido.

MediaWiki está escrito en PHP.

2. Entorno

El tutorial está escrito usando el siguiente entorno:

  • Hardware: Portátil Asus G1 (Core 2 Duo a 2.1 GHz, 2048 MB RAM, 120 GB HD).
  • Sistema Operativo: GNU / Linux, Debian (unstable), Kernel 2.6.21, KDE 3.5
  • Apache 2.2.4-1
  • MediaWiki 1.10.1-1

3. Instalación

Hacemos la instalación con el sistema de paquetes de Debian:

# apt-get -u install mediawiki mediawiki-extension

Esto nos instalará la última versión de MediaWiki, a día de hoy la 1.10.

¡¡¡ Precaución !!!

En algunos entornos "limpios", donde es la primera vez que instalamos MediaWiki nos podemos encontrar con el siguiente problema al intentar instalar con apt-get:

Reading package fields... Done
Reading package status... Done
Retrieving bug reports... Done
Parsing Found/Fixed information... Done
Preconfiguring packages ...
mediawiki1.10 failed to preconfigure, with exit status 1
Selecting previously deselected package mediawiki1.10.
(Reading database ... 147889 files and directories currently installed.)
Unpacking mediawiki1.10 (from .../mediawiki1.10_1.10.1-1_all.deb) ...
Setting up mediawiki1.10 (1.10.1-1) ...
dpkg: error processing mediawiki1.10 (--configure):
   subprocess post-installation script returned error exit status 1
Errors were encountered while processing:
    mediawiki1.10
E: Sub-process /usr/bin/dpkg returned an error code (1)
A package failed to install. Trying to recover:
Setting up mediawiki1.10 (1.10.1-1) ...
dpkg: error processing mediawiki1.10 (--configure):
    subprocess post-installation script returned error exit status 1
Errors were encountered while processing:
    mediawiki1.10

Para solventar esto hay que instalar antes la versión 1.9 de MediaWiki con apt-get install mediawiki1.9, y después instalar la 1.10. Una vez tengamos instalada la 1.10 podemos quitar la 1.9 con apt-get --purge remove mediawiki1.9

Esto se debe a un problema en los scripts de configuración de MediaWiki 1.10, hay abierto un bug y esperemos que los chicos de Debian (por cierto, muy simpáticos y colaborativos) lo solucionen pronto.

¡¡¡ Fin de precaución !!!

También existen algunos paquetes sugeridos. Entre estos podemos encontrar cosas como:

  • mediawiki-math para transformar fórmulas matemáticas en bonitas imágenes
  • paquete de extensiones mediawiki-extension
  • php5-gd para manipular imágenes para usar «thumbnailing» (la recomendación es usar este módulo en lugar de ImageMagick).
  • uso de cache

Estos paquetes no son estrictamente necesarios, aunque nos permitirán sacarle el mayor jugo a MediaWiki (podéis elegir los que realmente os interesan):

# apt-get -u install php5-gd mediawiki-extension

Ahora vamos a editar el fichero /etc/mediawiki1.10/apache.conf y vamos a descomentar la 3 línea donde se define el alias. Esta línea indica con que URL queremos acceder a nuestra MediaWiki. Por ejemplo yo lo cambio y pongo (ojo que no se os olvide quitar la para descomentar la línea):

Alias /wikitentia
/var/lib/mediawiki1.10

Fijaros que lo he llamado /wikitentia, esta será la URL que luego pondremos en el navegador para acceder (http://localhost/wikitentia).

Ahora reiniciamos el Apache 2 para asegurarnos de que coge los cambios:

# /etc/init.d/apache2 restart

4. Configuración

Si todo ha ido bien, podemos acceder a la URL http://localhost/wikitentia y nos deberíamos ver lo siguiente:

Es decir MediaWiki está lista para auto configurarse Pulsamos sobre "set up the wiki" y nos aparecerá una página donde deberemos poner nuestros valores de configuración:

Vamos moviéndonos hacia abajo:

Aquí hemos configurado el nombre de nuestra MediaWiki, un correo de contacto, el idioma, que tipo de licencia van a tener los contenidos alojados en la MediaWiki, el usuario y clave de administrador de la MediaWiki. Si tenemos cache (acordaros que NO la instalamos en el paso anterior).

Seguimos bajando:

Configuramos las preferencias de correo electrónico. Yo lo he dejado todo con los valores por defecto.

Seguimos bajando:

Configuramos la conexión a la base de datos. Este punto es importante !!! Debemos indicar donde está nuestro MySQL, el nombre que le va ha dar a la base de datos y el nombre y clave del usuario que se va a crear en la base de datos. También le marcamos la opción "Use superuser account" y le indicamos un usuario con permisos para crear la base de datos y el usuario de la MediaWiki, en el ejemplo yo he usado el usuario root de la base de datos.

Lo que va ha hacer MediaWiki es comprobar si todavía no existen las tablas, y en tal caso las crea. Es decir, si la base de datos ya está creada no hará nada.

Seguimos bajando:

Ya sólo nos queda pulsar sobre el botón Install MediaWiki!

Si todo va correctamente nos saldrá la siguiente pantalla:

En este punto habrá creado la base de datos y el usuario.

¡¡¡ Atención !!!
Puede ser que en la pantalla anterior no vemos el mensaje "Installation successful!" (me ha pasado en algunas instalaciones), y si vamos al directorio /var/www/wikitentia/config veremos que no ha creado el fichero LocalSettings.php. Si es el caso lo que tenéis que hacer es simplemente darle al
botón de refrescar de vuestro navegador (para que ejecute otra vez la misma página). Es posible que el navegador os pregunte si queréis reenviar la información para recargar la página, le decís que sí. El resultado debería ser el siguiente:

Se puede ver como ha intentado volver a crear las tablas, pero no hay problema, lo tiene controlado. Lo importante es que al final dice en verde "Installation successful!"

Ya sólo queda una cosita:

# cd /etc/mediawiki1.10

ln -s /var/lib/mediawiki1.10/config/LocalSettings.php

Con esto conseguimos que la configuración de MediaWiki esté apuntando al ficherito que se acaba de crear con el proceso que acabamos de ver.

Si ahora volvemos a acceder a http://localhost/wikitentia deberíamos ver:

Enhorabuena !!!

Esta vez si que lo hemos instalado correctamente y ya podemos empezar a añadir nuestros contenidos 😀

5. Conclusiones

A veces el proceso no es todo lo sencillo que nos gustaría pero el resultado merece la pena con creces.

Por qué hemos elegido MeidaWiki y no otro sistema de wiki, bueno, ya hemos visto un tutorial de Bugzilla
(https://adictosaltrabajo.com/tutoriales/tutoriales.php?pagina=debianBugzilla3.0)
y MediaWiki se integra con él, así que, quien sabe, quizás alguien escriba un tutorial de como hacer la integración 😉

6. Sobre el autor

Alejandro Pérez García, Ingeniero en Informática (especialidad de Ingeniería del Software)

Socio fundador de Autentia (Formación, Consultoría, Desarrollo de sistemas transaccionales)

mailto:alejandropg@autentia.com

Autentia Real Business Solutions S.L. – "Soporte a Desarrollo"

http://www.autentia.com

 

Alejandro Pérez García
Alejandro es socio fundador de Autentia y nuestro experto en Java EE, Linux y optimización de aplicaciones empresariales. Ingeniero en Informática y Certified ScrumMaster. Seguir @alejandropgarci Si te gusta lo que ves, puedes contratarle para darte ayuda con soporte experto, impartir cursos presenciales en tu empresa o para que realicemos tus proyectos como factoría (Madrid). Puedes encontrarme en Autentia: Ofrecemos servicios de soporte a desarrollo, factoría y formación.

DEJA UNA RESPUESTA

Por favor ingrese su comentario!

He leído y acepto la política de privacidad

Por favor ingrese su nombre aquí

Información básica acerca de la protección de datos

  • Responsable:
  • Finalidad:
  • Legitimación:
  • Destinatarios:
  • Derechos:
  • Más información: Puedes ampliar información acerca de la protección de datos en el siguiente enlace:política de privacidad