Scripts de mantenimiento/Ejecución de scripts

Los scripts de mantenimiento deben ejecutarse desde la línea de comandos. Los usuarios que no accedan al servidor directamente desde su terminal normalmente establecerán una conexión a través de SSH.

• Para los usuarios de Linux/Unix, esto se hace utilizando el cliente SSH en un intérprete de comandos (shell).
• Para los usuarios de Windows, se puede utilizar la herramienta de línea de comandos SSH introducida en Windows 10, o alternativamente utilizar una herramienta de terceros como PuTTY que se muestra a continuación, o utilizar el Subsistema de Windows para Linux.

Entrar al servidor

Usuario de Linux/MacOS

La mayoría de los sistemas Linux y MacOS vienen con un cliente SSH incorporado. Así que no necesita ningún otro cliente SSH. Puede comprobar el cliente SSH en su sistema ejecutando el siguiente comando en su terminal.

Terminal

$ ssh -V

OpenSSH_8.6p1, LibreSSL 2.8.3

Si este comando arroja un error, entonces necesita instalar un cliente SSH en su sistema.

Debian/Ubuntu - sudo apt install openssh-client

MacOS - brew install openssh

Una vez que tenga el cliente SSH en su sistema, entonces puede ejecutar el siguiente comando para entrar en el servidor.

Terminal

$ ssh -p 22 root@examplewiki.com

Welcome to Ubuntu 18.04.5 LTS (GNU/Linux 4.15.0-161-generic x86_64)

 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/advantage

  System information as of Tue Feb 15 10:32:00 UTC 2022

  System load:  0.0                Processes:           106
  Usage of /:   29.8% of 24.06GB   Users logged in:     0
  Memory usage: 51%                IP address for eth0: XXX.XXX.XXX.XXX
  Swap usage:   0%                 IP address for eth1: 10.116.0.2

Last login: Tue Feb 15 10:27:28 2022 from XX.XXX.XX.XXX

root@-s-1vcpu:~#

El puerto predeterminado para la conexión SSH es 22 y el usuario es root. Pero el proveedor de alojamiento compartido proporciona el usuario y el número de puerto SSH personalizados. Sustituya estos valores por los suyos.

Ahora, puede ejecutar el script de mantenimiento de MediaWiki en el servidor.

Usuario de Windows

Para el usuario de Windows, hay dos formas de entrar en el servidor.

Cliente SSH nativo

Puede instalar/habilitar el cliente SSH usando la configuración de Windows en dispositivos Windows Server 2019 y Windows 10. Estos soportan SSH de forma nativa. Consulte la documentación oficial.

Para instalar el componente OpenSSH:

• Abra Settings, seleccione Apps > Apps & Features, después seleccione Optional Features.
• Revise la lista para ver si OpenSSH ya está instalado. Si no es así, en la parte superior de la página, seleccione Add a feature, después:
  • Busque el Cliente OpenSSH, luego haga clic en Install.

Se instalará el cliente SSH en su sistema. Ahora, puede conectarse mediante SSH al servidor utilizando PowerShell.

PowerShell

$ ssh -p 22 root@examplewiki.com

El puerto predeterminado para la conexión SSH es 22 y el usuario es root. Pero el proveedor de alojamiento compartido proporciona el usuario y el número de puerto SSH personalizados. Sustituya estos valores por los suyos.

Ahora, puede ejecutar el script de mantenimiento de MediaWiki en el servidor.

Putty (u otro cliente SSH de terceros)

Puede utilizar PuTTY u otro cliente SSH de terceros en una máquina Windows:

• Paso 1: Descargue y ejecute PuTTY, un emulador de terminal.
• Paso 2: En PuTTy, bajo el nombre de anfitrión (o dirección IP) introduzca la dirección IP de su sitio de alojamiento web (Contacte a su proveedor de sitios web si es necesario) y haga clic en abrir.
• Paso 3: Aparecerá una pantalla de comandos. En la línea iniciar sesión como: introduzca el nombre de usuario FTP.
• Paso 4: Introduzca la contraseña del usuario FTP.

Ahora, puede ejecutar el script de mantenimiento de MediaWiki en el servidor.

Ejecutando el script

Una vez que haya entrado en el servidor (véase "Entrar al servidor" más arriba) entonces podrá seguir estos pasos.

Paso 1: Vaya al directorio raíz de MediaWiki. En la mayoría de los casos, será /var/www/html

Terminal

root@-s-1vcpu:~# cd /var/www/html/

Paso 2: Ejecute el script

Terminal

root@-s-1vcpu:/var/www/html# php maintenance/run.php showSiteStats

Total edits       : 11
Number of articles:  3
Total pages       :  6
Number of users   :  2
Active users      :  0
Number of images  :  0

Si está utilizando un servidor Windows y obtiene un error (por ejemplo: php.exe is no valid Win32 application), intente lo siguiente.

$ php-cgi maintenance/run.php showSiteStats

o

$ C:\path\to\php\php-win.exe C:\path\to\mediawiki\maintenance\run.php showSiteStats

Desde MediaWiki 1.40, los scripts de mantenimiento deben invocarse indirectamente a través de maintenance/run.php. Invocar scripts de mantenimiento directamente activará una advertencia.

Si su script no se ejecuta y arroja una gran cantidad de mensajes de error, lo primero que debe intentar es configurar la variable de entorno MW_INSTALL_PATH para que apunte a la raíz de su instalación de MediaWiki. Esto ayudará a los scripts a encontrar los archivos necesarios, y es particularmente relevante cuando se ejecutan scripts de mantenimiento proporcionados por extensiones de terceros.

Opciones de línea de comandos estándar

Casi todos los scripts de PHP en /maintenance admiten varias opciones estándar:

Opción	Descripción
--help	Displays help message
--conf <path>	Location of LocalSettings.php, if not default (at parent directory of the script)
--dbuser <username>	Database account to use instead of the one specified in LocalSettings.php, not used for scripts that don't require a database connection or when SQLite database backend is used
--dbpass <password>	Database password to use instead of the one specified in LocalSettings.php, not used for scripts that don't require a database connection or when SQLite database backend is used
--globals	Output globals at the end of processing for debugging
--memory-limit <value>	Set memory limit for the script. Accepts ordinary numbers, standard php.ini abbreviations (1024K, 20M, 1G), max for no limit (will be used by default if omitted) and default for no change. (introducido en 1.17)
--quiet	Suppress non-error output
--wiki	Wiki ID for wiki farms. This may be of the form dbname or dbname-prefix. LocalSettings.php will be run with the MW_DB and MW_PREFIX constants defined accordingly.
--profiler	Profiler output format (usually "text"). (introducido en 1.22)
--mwdebug	Enable built-in MediaWiki development settings. (introducido en 1.31)

Instalaciones de MediaWiki que utilizan enlaces simbólicos

En los casos en los que los archivos PHP de MediaWiki estén vinculados mediante enlaces simbólicos a una instalación central, deberá especificar al script de mantenimiento la ruta del archivo LocalSettings.php. Por ejemplo

php maintenance/importImages.php --conf /var/www/html/LocalSettings.php /tmp/wikiimages .jpg .png .svg

Instalaciones de MediaWiki que utilizan configuraciones compartidas (tipo familia)

A veces MediaWiki se instala como una familia Wiki para muchos idiomas y las configuraciones (LocalSettings.php) se dividen en la parte común y las partes del idioma (ver Wiki family#Shared Settings ) donde la parte común se encuentra fuera del directorio /w y se accede usando un enlace relativo (require_once "../ExtensionSettings.php";). En este caso, los scripts de mantenimiento no funcionarán cuando se ejecuten en el directorio /w/maintenance. En su lugar, ejecútelos desde el directorio /w.

Sin acceso al intérprete de comandos (shell)

En muchos alojamientos compartidos, no tendrá acceso al intérprete de comandos. Las siguientes extensiones pueden ser útiles para ejecutar scripts de mantenimiento a través de la web.

• Maintenance
• MaintenanceShell