Notas de seguridad

MediaWiki es una aplicación web, y siguiendo estas instrucciones configurará un servidor web que se ejecuta en su computadora y puede ser expuesto a otras computadoras en la red. En particular, tenga en cuenta que PHP y otros códigos de Linux que se ejecutan en el servidor web pueden tener acceso a su unidad C:\ de Windows y pueden ser capaces de leer o modificar archivos, o ejecutar programas de Windows.

Se recomienda encarecidamente utilizar esto sólo para fines de desarrollo, no para el despliegue de servidores, y para limitar el acceso de red al servidor web para evitar abrir accidentalmente algo en la red. Sólo ejecute MediaWiki y extensiones en las que confíe.

Versiones de WSL

Hay dos versiones principales de WSL disponibles: la original, que emula la ABI del kernel Linux como un controlador de Windows, y la más reciente WSL2, que utiliza una máquina virtual Hyper-V especializada para ejecutar un kernel Linux nativo. Aunque MediaWiki debería funcionar con WSL1, la actualización de mayo de 2020 introduce WSL 2 como una alternativa. Es posible actualizar/desactualizar libremente entre WSL1 y WSL2.

WSL2 es compatible con más software, pero puede complicar un poco algunos escenarios de integración, ya que la máquina virtual tiene su propia dirección IP separada de localhost. (Los servidores son redireccionados a localhost, por lo que esto generalmente funciona bien para configurar un servidor web.)

Tenga en cuenta que WSL2 requiere compatibilidad de hardware para la virtualización y utiliza Hyper-V bajo el capó, pero está disponible tanto en Windows 10 Home como en Windows 10 Pro. WSL1 no requiere virtualización. Esto hará que sea más fácil para los desarrolladores instalarlo en máquinas existentes sin gastar dinero en una actualización a la edición Pro, pero puede tener problemas de compatibilidad con otro software de virtualización como VirtualBox (la versión 6.0 es la más antigua que puede coexistir con productos basados en Hyper-V).

Configuración de WSL

Para utilizar el modo WSL2, salga y ejecute en una sesión de PowerShell:

• wsl --set-version Ubuntu 2

La conversión de los sistemas de archivos puede demorarse unos minutos.

Para verificar qué versión de WSL está en uso haga lo siguiente:

• wsl -l -v

Instalación de dependencias

Primero, asegúrese de que la imagen del sistema esté actualizada: ejecute sudo apt update && sudo apt upgrade -y en la terminal de Ubuntu. Esto puede tardar unos minutos después de la primera instalación.

Instalar dependencias: sudo apt install apache2 composer git git-review imagemagick mysql-client mysql-server php php-apcu php-cli php-gd php-intl php-mbstring php-mysql php-xml zip

Servicios en ejecución

Es posible que tenga que iniciar los servicios manualmente:

• sudo service mysql start
• sudo service apache2 start
  • en WSL1, esto puede generar una alerta del cortafuegos de Windows sobre el puerto de escucha. Permítalo, pero considere limitarlo a redes "privadas" por seguridad.

Es posible que tenga que superar algunos obstáculos para establecer la contraseña de root en MySQL:

• Ejecute MySQL como root:
  • sudo mysql
• En la terminal de mysql ejecute:
  • use mysql;
  • alter user 'root'@'localhost' identified by 'your-password-here'; - Si esto falla, intente con update user set authentication_string=password('tu-contraseña-aquí'), plugin='mysql_native_password' where user='root';.
  • create user 'nombre_de_usuario'@'localhost' identified by 'tu-contraseña-aquí';
  • create database `nombre_de_base_de_datos`; - Esto debe coincidir con la base de datos wiki en el proceso de instalación
  • grant all on `nombre_de_base_de_datos`.* to 'nombre_de_usuario'@'localhost'; - Note those are backticks not single quotes around nombre_de_base_de_datos
  • flush privileges;
  • exit
• Ahora puede usar el nombre de usuario root, y la contraseña tu-contraseña-aquí cuando inicie sesión desde el instalador.

Instalación de MediaWiki

Clone las cosas desde Git como lo haría en un servidor Linux.

En Ubuntu, Apache está configurado por defecto para apuntar a /var/www/html como el directorio raíz, puede crear un directorio debajo de éste para probar o reconfigurar Apache con una ruta personalizada. Recomiendo /var/www/html/w para mantener la coherencia con la convención de que /w/index.php es la ruta principal del script.

• cd /var/www/html
• sudo mkdir w
• sudo chown your-user-name w
• cd w
• git clone https://gerrit.wikimedia.org/r/mediawiki/core.git . - No olvide el punto al final.
• cd skins
• git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git

Cola de trabajos

Es posible que desee o necesite ejecutar manualmente el procesador de cola de trabajos. Idealmente, esto debería hacerse a través del servidor web, pero en caso de apuro, se puede abrir la terminal de Ubuntu y ejecutar:

• cd /var/www/html/
• php maintenance/runJobs.php