Portal:Grupo Técnico de EcuRed/Marco

Como motor de wiki se utiliza la versión 1.16.0 de MediaWiki. Es independiente de la plataforma, por lo cual puede ser utilizado tanto para realizar la instalación sobre plataforma Linux como Windows.

Instalación

Requisitos previos

El software MediaWiki está escrito en lenguaje PHP y utiliza como sistema de almacenamiento una base de datos. Los prerrequisitos para la instalación de la versión actual 1.16 son los siguientes:

Instalación de la MediaWiki

Durante el proceso de instalación habrá que introducir diferente información relacionada con:

  1. Acceso a MediaWiki.
  2. Comprobación del entorno.
  3. Configuración del sitio.
  4. Configuración del email.
  5. Configuración de la base de datos.
  6. Completar la instalación.
  7. Problemas encontrados.
  8. Los parámetros que se introduzcan pueden ser cambiados posteriormente en los ficheros de configuración.


Una vez que se tiene el archivo con la versión de la MediaWiki que se utilizará, se descomprime y se extrae en el directorio raíz del servidor web. El directorio creado (en nuestro caso MediaWiki 1.16.0) puede ser cambiado de nombre, por ejemplo a wiki.

1. Acceso a MediaWiki

Para acceder al script de instalación se escribe en el navegador web: http://localhost/wiki y se nos mostraría la pantalla inicial.

2. Comprobación del entorno

Siguiendo el enlace que se muestra, MediaWiki procede a la comprobación del entorno, donde chequea que están disponibles todos los requisitos para que pueda funcionar correctamente; como por ejemplo las versiones de PHP y de la base de datos.

Si tras unos segundos se muestra el mensaje Environment checked. You can install MediaWiki, entonces podemos proseguir la instalación. Si por el contrario falta algún requisito, nos muestra en un mensaje qué es lo que falta y habrá que volver a instalarlo y volver a ejecutar el script de instalación, siguiendo el paso anterior.

3. Configuración del sitio

Se introducirán parámetros relacionados con el sitio wiki:

  • Wiki name: El nombre del sitio wiki.
  • Contact e-mail: El email de contacto de la persona que administrará el sitio.
  • Languaje: El lenguaje de interfaz.
  • Copyright/license: La licencia de los contenidos del sitio. Hay 3 tipos de licencia:
    • Sin licencia: El texto y las imágenes no tienen copyright. Cualquiera podrá copiar y usar estos contenidos.
    • GNU free documentation license: Licencia de documentación libre de GNU. Las limitaciones de los contenidos pueden verse aquí. Es la usada por la wikipedia.
    • Licencia Creative Commons o CC: Existen varias licencias de este tipo. Pueden verse aquí.
  • Admin username: Nombre de usuario del administrador.
  • Password: Contraseña del administrador del wiki.
  • Password confirm: Repetir la contraseña.
  • Object caching: Si se desea activar el sistema de cacheo de páginas, útil cuando el sitio es visitado por muchos usuarios.
  • Memcached servers: Especifica el servidor de caché.

4. Configuración del email

Se introducirán parámetros relacionados con las notificaciones por email. Por defecto, la mayoría de opciones están habilitadas, si se dejan como están es necesario configurar un servidor de correo electrónico. Aunque se habiliten, no funcionarán si no existe un servidor de correo.

  • E-mail features (global): Por defecto, las notificaciones generales están habilitadas, como el envío de recordatorio de una contraseña o permitir el envío de e-mails entre usuarios.
  • User-to-user e-mail: Para permitir el envío de emails entre usuarios sin que se publiquen sus direcciones.
  • E-mail notification about changes: Para que se envíe un email cuando el usuario lo especifique sobre cambios en una página, o sólo para las discusiones de página.
  • E-mail address authentication: Para que sea necesario introducir un email cuando se registre el usuario, además se debe confirmar la cuenta mediante email.

5. Configuración de la base de datos

A continuación se muestran los parámetros a configurar relacionados con la base de datos:

  • Database type: Tipo de base de datos. Aparece por defecto la base de datos instalada.
  • Database host: Donde se encuentra la base de datos. En este caso, como está instalada en el mismo PC, será la dirección IP del PC o Localhost.
  • Database name: Nombre de la base de datos, por defecto es Wikidb.
  • DB username: Nombre de usuario que se creará para el acceso a la base de datos. Por defecto es wikiuser.
  • DB password: Contraseña para el acceso del usuario de la base de datos. Tiene una longitud mínima de 6 caracteres.
  • DB password confirm: Repetir la contraseña.
  • Superuser account: Si no se posee permiso de creación en la base de datos, debemos darle los permisos necesarios al usuario anterior o marcar esta opción.
  • Superuser name: El nombre del administrador de la base de datos.
  • Superuser password: Contraseña del administrador de la base de datos.
  • Opciones específicas de la base de datos: No es necesario modificar este apartado, únicamente si se precisa una configuración más específica:
    • Database Table Prefix: Prefijo si se precisa acceder a una base de datos compartida con otros wikis o con otra aplicación web, para evitar conflictos.
    • Storage engine: Para seleccionar una tecnología de base de datos que proporciona acciones adicionales, como bloqueo de registros o un estándar de formato de datos. Puede seleccionarse InnoDB o MyISAM.
    • Database character set: Para modificar la configuración de almacenamiento de datos.

6. Completar la instalación

Una vez se hayan introducido todos los parámetros requeridos se procederá a la instalación. Pulsamos el botón, y si algo ha fallado, muestra un error y vuelve a la misma pantalla para que se pueda corregir. Cuando esté todo correcto, MediaWiki creará la base de datos, las tablas necesarias y el fichero de configuración. Para completar la instalación, hay que mover el archivo de configuración config/localsettings.php al directorio raíz del wiki, y para acceder a él se sigue el enlace de la pantalla.

7. Problemas encontrados

Cuando se introduce un parámetro que no es correcto, aparece un mensaje en rojo sobre el parámetro que causa problemas. Se debe corregir para continuar la instalación.