Manual:Upgrading/es

Transferencia de archivos
Elige un método para transferir los archivos:


 * wget
 * Copia segura con SCP o WinSCP
 * SSH File Transfer Protocol (SFTP)
 * Usando un cliente FTP
 * En el caso de un servidor hospedado, la empresa que hospeda el servidor quizá ofrezca una interfaz para su administración vía navegador web; consulta con tu proveedor.
 * Algún otro método. Puedes ver una lista en List of file transfer protocols.

Pasos preliminares
Lee.


 * 1) Comprueba los requisitos
 * 2) Lee el archivo RELEASE-NOTES
 * 3) Lee el archivo UPGRADE
 * 4) Haz una copia de seguridad de los archivos existentes y de la base de datos
 * 5) Extrae los nuevos archivos
 * 6) Actualiza las extensiones
 * 7) Ejecuta el script de actualización para comprobar la base de datos
 * 8) Prueba la actualización
 * 9) Elimina restos de archivos que pudieron quedar de instalaciones anteriores

Comprobación de requisitos
MediaWiki requiere:


 * PHP +
 * Uno de los siguientes:
 * MySQL + (o MariaDB equivalente)
 * PostgreSQL +
 * SQLite +

Since Version 1.36, MediaWiki only commits to supporting upgrades from two LTS releases ago (see T259771). Upgrades from older versions of MediaWiki will have to be performed in multiple steps. This means that if you want to upgrade to 1.36 from 1.23 or earlier, you'll first have to upgrade your 1.23 wiki to 1.27 (or 1.35), and, from 1.27 (or 1.35), you'll be able to upgrade to 1.36.

Si estás usando PostgreSQL, lee también.

Para más información, lee y.

Lee las notas sobre cambios
En el archivo comprimido de la instalación, o en los archivos obtenidos desde Git, encontrarás algunos archivos cuyos nombres se encuentran complemente en mayúsculas. Uno de ellos contiene las notas sobre cambios:  (wiki). Ahora es el momento de abrirlo y ver qué es lo que ha cambiado en esta versión. También deberías leer las instrucciones del archivo UPGRADE.

Limpiar los trabajos pendientes
Por cuestiones de rendimiento, algunas acciones en la base de datos se realizan en diferido, gestionadas por la cola de trabajos. Estos trabajos se guardan en base de datos y contienen parámetros con información sobre acciones que deben realizarse. Se recomienda encarecidamente correr los trabajos pendientes antes de actualizar el wiki, para evitar que fallen en caso de que la especificación de los parámetros de estos trabajos cambie en la nueva versión. Usa para correr todos los trabajos pendientes y limpiar la cola de trabajos antes de realizar la actualización.

Haz una copia de seguridad de los archivos existentes y de la base de datos

 * Instrucciones completas en Manual: Hacer copia de seguridad de un wiki

Pese a que los scripts de actualización se mantienen al día y son robustos, siempre cabe la posibilidad de que algo pueda salir mal. Antes de proceder a actualizar la estructura de la base de datos, haz una copia de seguridad completa del wiki, que incluya tanto la base de datos como los archivos:


 * el contenido del wiki, empezando por la base de datos (asegúrate de que especificas correctamente el juego de caracteres, mira primero en LocalSettings.php). Puede ser una buena idea generar un volcado XML además del volcado SQL de la base de datos.
 * MySQL &mdash; tanto el volcado SQL como XML se pueden hacer con los comandos de la propia base de datos:

mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
 * PostgreSQL &mdash; volcado de base de datos para usar luego con el comando :

pg_dump --create -Fc wikidb > file.db.dump
 * SQLite &mdash; puedes usar un script de MediaWiki para crear la copia de seguridad:

php wikifolder/maintenance/sqlite.php --backup-to file
 * imágenes y otros archivos multimedia (el contenido del directorio, logotipo personalizado /skins/common/images/wiki.png)
 * archivos de configuración, como por ejemplo  y   (si está presente)
 * archivos del programa MediaWiki, incluyendo todas las apariencias y extensiones, especialmente si has hecho modificaciones.

Usando un archivo comprimido
Puedes poner los nuevos archivos en su lugar usando FTP o desde la línea de comandos. ¡Preferiblemente, usa la línea de comandos si tienes acceso a ella! La línea de comandos será mucho más rápida que tener que subir uno a uno los miles de archivos que componen la instalación vía FTP.

FTP o interfaz gráfico
Si no tienes acceso a tu servidor a nivel de línea de comandos, descarga el archivo comprimido de MediaWiki a tu ordenador local y usa 7zip para descomprimirlo.

Una vez extraídos los archivos, usa tu cliente FTP preferido para subir los directorios y archivos al servidor.

cPanel File Manager
cPanel is a popular interface provided by many web hosts. This method is efficient because the files are uncompressed on the server itself.


 * Navigate to the directory that holds your wiki folder.
 * Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
 * Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
 * Confirm that the mediawiki-1.xx.x folder is present.
 * Delete the tar.gz file.
 * Copy all necessary skins, extensions, image folders, customizations, and the LocalSettings.php into the new folder. (see below)
 * When you are ready to run update.php, rename your old wiki folder and your new wiki folder. (e.g. "w" becomes "w1.34" and then "mediawiki1.35.0" becomes "w") This step is easily reversible if you run into problems.

Línea de comandos
Es posible que necesites ejecutar el comando con  si tu cuenta de usuario no tiene permiso total de escritura para escribir en el directorio de instalación del wiki. Al extraer el paquete de MediaWiki normalmente se creará un nuevo directorio para la versión de MediaWiki, y tendrás que copiar los archivos de configuración y el directorio 'images' desde el directorio donde se encuentra la instalación anterior:

Los usuarios de (Open)Solaris tienen que usar gtar, o:

$ gzip -dc mediawiki-.tar.gz | tar xf -

Otros archivos
Tras extraer los archivos, deberás copiar o mover algunos archivos y directorios desde el antiguo directorio de instalación al nuevo:


 * , que contiene las opciones de configuración anteriores.
 * El directorio  (o   en versiones anteriores), que contiene todos los archivos subidos al wiki, salvo que hayas especificado un directorio de subida de archivos diferente. Deberás cambiar el propietario y los permisos como sea oportuno, por ejemplo con   y   si el usuario web es apache.
 * Extensiones del directorio . Deberías siempre usar versiones actualizadas de las extensiones; no se garantiza que las extensiones antiguas funcionen con una versión más reciente de MediaWiki.
 * Si estás usando un logotipo personalizado, también necesitas copiar este archivo desde la copia de seguridad. Antes de la versión 1.24 normalmente se encontraba en . A partir de la versión 1.24 se encuentra en , o en   si preferiste usarlo así. Entonces indícalo en LocalSettings.php, por ejemplo con.
 * For 1.35 you may need to restore the logos from wgLogos. Then add to LocalSettings.php e.g.
 * Apariencias personalizadas del directorio.
 * Cualquier modificación realizada a los anteriores archivos de instalación o a las extensiones.
 * Cualquier archivo .htaccess (si usas Apache y has definido alguna regla en ellos).

Una vez hecho esto, convierte este nuevo directorio en el directorio publicado en el servidor, o renombra el directorio de instalación anterior y después renombra el nuevo para que coincida con el nombre que estabas usando.

Usando Git
Si usas, exporta los archivos a un directorio vacío, y a continuación copia sólo los archivos modificados al nuevo directorio tal como se explica en la sección anterior.

También necesitarás instalar algunas bibliotecas de PHP externo que utilizan Compositor o una colección proporcionada mantenida para el Wikimedia wiki granja. Puedes encontrar más detalles sobre la instalación y actualización de las bibliotecas externas en la documentación de descarga desde Git.

Usando un parche
Por cada actualización menor normalmente también se publica un archivo de parches. You'll need to download patch to use this. Descarga y extrae el archivo de parches manualmente desde el sitio de volcados o sigue estas instrucciones con wget. Los parches son incrementales, por lo que no puedes saltarte ninguna versión.


 * 1) Cambia con cd al directorio principal de tu instalación de MediaWiki (el que contiene LocalSettings.php).
 * 2) Descarga el archivo de parches y descomprímelo con gunzip.
 * 3) Usa   para comprobar qué se cambiará (ejemplo:  )
 * 4) Si todo va bien, ejecuta patch nuevamente, pero esta vez sin.
 * 5) Visita Especial:Versión y deberías ver el nuevo número de versión en su lugar.

Archivos antiguos que pueden causar errores
Si descomprimiste los archivos directamente encima de la versión anterior, algunos archivos antiguos pueden causar problemas en la nueva versión.

Si no estás usando perfilado, pero tienes un archivo  en el directorio raíz de MediaWiki, puedes encontrarte errores que hacen referencia a. Borrar o renombrar el archivo  puede resolver este error. Si en el futuro activas el perfilado, puedes usar como plantilla el archivo, que también se encuentra en el directorio raíz de MediaWiki.

Desde MediaWiki 1.23 no existe ningún mecanismo de detección automática de archivos de apariencias; por lo tanto, tras actualizarte a la versión 1.23 o posteriores, asegúrate de que se han eliminado los antiguos archivos,  ,   y   del directorio  , así como los subdirectorios correspondientes del directorio. Para ayudarte a recordarlo, MediaWiki guardará avisos si encuentra uno cualquiera de estos antiguos elementos. También necesitarás modificar cualquier apariencia que se haya personalizado a fin de seguir la misma convención. Mira para más información.

MediaWiki 1.24 cambia las rutas de los archivos principales de las apariencias. Tras actualizarte a esta versión o a una posterior, debes asegurarte de que ya no están presentes los antiguos archivos,  ,   y   directamente en el directorio. Mira para más información.

Actualiza las extensiones
Algunas extensiones han sido actualizadas para que funcionen con la nueva versión de MediaWiki. Asegúrate de usar la versión más reciente de estas extensiones. Puede que necesites realizar actualizaciones manualmente en el caso de extensiones que hayas modificado.

Los distintos archivos de distribución basados en tar incluyen algunas extensiones y cuentan con control de versiones para ayudarte en caso de una actualización a elegir la versión adecuada para la versión que tengas instalada de MediaWiki.

El distribuidor de extensiones va bien para la mayoría de la gente que busca una instantánea de las extensiones que funcionan con las versiones soportadas de MediaWiki.

Si te propones descargar un gran número de extensiones, entonces probablemente sea mejor descargarlas desde Git. If you don't have Git but you want to upgrade a lot of extensions, you might consider using mwExtUpgrader.

Adapta tu LocalSettings.php
Si vas a usar el mismo archivo  que con la versión anterior, puede que necesites adaptarlo a cómo lo usan las nuevas versiones.

Registro de apariencias
Desde MediaWiki 1.24, las apariencias incluidas en el paquete -como Vector, Monobook, Modern y CologneBlue- ya no forman parte del núcleo de MediaWiki, y debes registrarlas explícitamente en  para poder usarlas, en caso contrario MediaWiki mostrará un aviso indicando que no tienes ninguna apariencia instalada.

Esto es lo que debes añadir a  cuando actualices desde una versión anterior a la 1.24 y quieras tener disponible alguna de estas apariencias:

El resto de apariencias pueden no haber sido todavía adaptadas al nuevo sistema de registro de apariencias, así que en caso de problemas, consulta la página de documentación de cada una de ellas para ver cómo registrarlas correctamente.

Registro de extensiones
Desde MediaWiki 1.25, las extensiones usan un nuevo sistema de registro de extensiones.

En versiones anteriores, tu  incluiría algo como esto:

Esto puede convertirse en:

Las extensiones están siendo adaptadas para usar el nuevo sistema de registro. Las extensiones que no se han adaptado deberían seguir usando el sistema antiguo de instalación. Para más información, consulta las instrucciones de instalación en la página de cada extensión.

Otras variables
Algunas variables pueden haber sido declaradas obsoletas o haberse eliminado completamente. Normalmente, tenerlas aún en  no tendrá efecto alguno. En las nuevas versiones de MediaWiki pueden añadirse nuevas variables, como también puede cambiar el tipo de una variable ya existente. Normalmente intentamos usar valores predeterminados para ellas que sean seguros, y en caso de cambiar su tipo, procuramos mantener compatibilidad hacia abajo. En cualquier caso, revisa las notas de lanzamiento para ver si ha habido algún cambio de este tipo.

Ejecuta el script de actualización
La base de datos de MediaWiki puede actualizarse de dos maneras: desde la línea de comandos, o desde el navegador. Si tienes acceso a tu servidor a nivel de línea de comandos, ésa es la manera recomendada, puesto que esto reduce el riesgo de que el proceso de actualización se vea interrumpido por una petición caducada o un reinicio en la conexión.

El script también intentará descargar cualquier software del que dependa MediaWiki y que no esté presente.

Línea de comandos
Accede a la línea de comandos de tu servidor, ya sea con una cuenta SSH o similar. Puedes acceder a la línea de comandos conectando con tu servidor vía SSH. Si el ordenador local desde el que estás trabajando corre Microsoft Windows, necesitarás una herramienta como PuTTY para poder usar SSH. Desde la línea de comandos, accede al directorio  y ejecuta el script de actualización:

$ php update.php

En un servidor linux si obtienes un error intenta ejecutar el mismo comando como raiz ( sudo php update.php ). Nota para instalaciones simples en Windows (por ejemplo, con ): First make sure that your web server (such as Apache) and your database (such as MySQL) are running. Then run : right-click it, select Open With, and browse to PHP.exe. The resulting command prompt window will likely autoclose when the schema upgrade completes.

Quizá te encuentres con un mensaje que dice que tu versión de PHP es muy antigua y que necesitas una versión más reciente. Tras ese mensaje, el proceso de actualización se cancela. El motivo de este error es que la línea de comandos está usando una versión de PHP distinta de la que se usa cuando se ejecuta MediaWiki desde el servidor web. Si te encuentras este mensaje, deberás comprobar si puedes ejcutar una versión más reciente de PHP en la línea de comando usando un comando distinto: podría ser por ejemplo php5 o php56 Que haya o no otra versión disponible, y en tal caso, bajo otro nombre, es algo que depende de la configuración de tu servidor. Si no puedes solucionarlo, consulta a tu proveedor, ellos seguramente sabrán si la hay.

MediaWiki examinará la estructura existente y la actualizará para trabajar con el nuevo código, añadiendo tablas y columnas según sea necesario.

What to do if php update.php fails to do anything, resulting in a quick pause and then return to command prompt
This can be caused by a malfunctioning extension or skin.

If this causes update.php to work, uncomment half of that half (so 1/4 of the extensions). If this does NOT cause update.php to work, uncomment the first half but comment out the second half, and then comment out half of the second half, etc. Repeat until update.php works to find the one that is failing.
 * Check that all extensions and skins called for in LocalSettings.php are present
 * Check that extensions are using the correct registration method (wfLoadExtension vs. require_once)
 * Comment out the first half of the extensions in LocalSettings.php.

Qué hacer en caso de un error "ALTER command denied to user" (o similar)
En caso de que el script cancele la actualización con un mensaje similar a

Error: 1142 ALTER command denied to user 'wiki'@'localhost' for table 'mytable' (localhost) ERROR: must be the owner of the mytable relation

esto significa que debes comprobar si has definido y  en tu archivo  (en el directorio raíz de MediaWiki). Estos valores son el nombre de usuario y la contraseña que necesita el script para poder acceder a la base de datos.

En algunos casos, una variable antigua $wgDBmwschema (para Postgres) parece ser usada para el nombre de tabla para actualizar, en vez de $wgDBname, incluso cuando se está usando mysql. Si se da este caso, simplemente borra la definición de $wgDBmwschema en LocalSettings.php.

Qué hacer en caso de un error "unexpected T_STRING"
Si estás ejecutando update.php desde la línea de comando, es posible que te encuentres este error:

 syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' \ in ~/maintenance/commandLine.inc on line 13

Esto ocurre cuando se ejecuta update.php con php4.

Si estás usando un servidor hospedado con un proveedor que proporciona tanto php4 como php5, deberás seguir los siguientes pasos:


 * 1) Desde la línea de comando, introduce el comando 'whereis php5'
 * 2) Una vez que hayas descubierto la ubicación de php5, pide un listado con el contenido del directorio php5/bin.
 * 3) Cuando conozcas el nombre del ejecutable PHP (que puede ser php o php5), teclea la ruta completa para ejecutar update.php.

He aquí un ejemplo:

 $ command -v php5 $ ls -la /usr/local/php5/bin $ /usr/local/php5/bin/php update.php

Qué hacer en caso de un error 'register_argc_argv is set to false'
Quizá te encuentres el error  Cannot get command line arguments, register_argc_argv is set to false


 * 1) Vé a ~/maintenance y edita el archivo 'php.ini', o créalo si no existe
 * 2) Añade una línea así:

 register_argc_argv=true


 * 1) Vuelve a ejecutar

Navegador web

 * Véase también 

Si tu base de datos tiene ya un tamaño considerable y se encuentra bajo uso intensivo, no deberías usar el actualizador vía web, dado que el proceso de actualización caducará cuando se alcance el tiempo máximo de ejecución establecido en PHP (maximum_execution_time). En este caso deberías usar update.php desde el interfaz de línea de comandos y no desde la web. Qué es exactamente un "tamaño considerable" es algo que depende de tu servidor (por ejemplo, su rendimiento, la carga de trabajo que tiene y el tiempo máximo de ejecución que concede PHP al script para cumplir su cometido). Si tu wiki es demasiado grande para el actualizador vía web y tu empresa de hospedaje no te da acceso mediante línea de comandos, entonces tendrás que trasladar tu wiki a otro proveedor, preferiblemente a uno que sí ofrezca acceso desde línea de comandos.

For example, if your wiki is at, then navigate to. Si se te pide una "contraseña de actualización", abre tu archivo y busca el valor de.
 * 1) Haz siempre una copia de seguridad de tu wiki antes de realizar cualquier labor de mantenimiento en la base de datos.
 * 1) Visita   desde tu navegador. Por ejemplo, si tu wiki está en , entonces abre.
 * 1) Elige tu idioma y pulsa 'Continuar'.
 * 2) La instalación existente debería detectarse automáticamente. Sigue las instrucciones en pantalla para actualizarla.

Puede suceder que el actualizador vía web parezca no funcionar: en lugar de ver la pantalla inicial de selección de idioma, podría salir una página vacía, posiblemente con algún mensaje de error. En este caso lo más probable es que tu servidor use reglas de reescritura (muy posiblemente para usar URLs cortos), que hacen que no aparezca el actualizador de mw-config/ sino una página wiki de Mw-config/, con una "M" en mayúsculas. En este caso, renombra el archivo .htaccess mientras se hace la actualización, con lo cual deberías poder acceder al actualizador vía web.

Prueba la actualización
Una vez que haya concluido la actualización, navega por el wiki y comprueba que estas operaciones funcionan como deberían:


 * Ver páginas
 * Editar páginas
 * Subir un archivo
 * Visitar Special:Version y comprobar que la versión que aparece es correcta y que las extensiones están presentes.

Remove leftovers from old installations
Si has copiado tu anterior instalación a otra carpeta en el servidor, asegúrate de eliminarla o hacerla completamente inaccesible de la web. Es muy importante no dejar instalaciones previas accesibles desde la web, ya que se pierde por completo el propósito de actualizar, y deja tu servidor expuesto a ataques.

Preguntas frecuentes


¿Cómo de difícil es actualizar MediaWiki?
Si el único archivo que has modificado es y estás actualizando desde la versión 1.5 o posterior, el proceso es muy sencillo. La cantidad de trabajo que lleva es de sólo unos minutos. Los cambios en la estructura de la base de datos llevarán un tiempo proporcional al tamaño de tu base de datos — potencialmente pueden ser varias horas en el caso de wikis con millones de páginas, mientras que si es un tamaño típico de unos pocos miles de páginas, normalmente será cuestión de unos segundos.

Las actualizaciones menores, dentro de la misma versión principal, desde .0 a, no requieren absolutamente ningún esquema de cambios. You can just update the files. The database needs no update, hence it is not necessary to run the updater script.

Actualizar desde la versión 1.4 o anteriores es algo potencialmente complicado porque se abandonó el soporte para los juegos de caracteres que no fuesen el UTF-8, y el esquema para almacenar texto en bloque fue modificado. Por favor, lee la sección correspondiente del archivo.

La actualización se vuelve más difícil si has modificado nuestro código fuente y no quieres que se sobreescriban tus cambios. Herramientas como diff, patch, Meld o WinMerge pueden resultarte útiles. También hay un problema potencial si estás usando extensiones cuyo mantenimiento ha sido abandonado; actualiza tus extensiones al mismo tiempo que actualizas MediaWiki.

Si has modificado la apariencia o usas una apariencia personalizada, muy posiblemente tengas que ajustarla para que funcione de nuevo con la nueva versión de MediaWiki.

¿Cómo actualizo desde una versión muy, muy antigua? ¿En uno, o en varios pasos?
Depende. Si estás actualizando desde MediaWiki 1.4 o una versión anterior, deberías actualizar primero a MediaWiki 1.5. Si estás actualizando desde un wiki que usa Latin-1, utiliza  (que encontrarás en el archivo de MediaWiki 1.5) para convertir las partes correspondientes de la base de datos a UTF-8 ( tiene que estar a TRUE en tu  para que esto funcione). A continuación, ejecuta, e indica en la variable  de LocalSettings.php el sistema de codificación usado anteriormente en el wiki (por ejemplo, windows-1252). Así es básicamente cómo se actualizaron Wikipedia y otros sitios de la Fundación Wikimedia cuando pasaron de MediaWiki 1.4 a la versión 1.5; mira el archivo de opciones en cuestión (¡ojo: este archivo es muy grande!) y algunas notas al respecto en Wikitech para más detalles. También es posible que necesites actualizar a MediaWiki 1.4 para poder ejecutar el script de actualización a la versión 1.5. Si quieres hacer un volcado de base de datos (p. ej. MySQL) del wiki en codificación Latin-1 wiki, asegúrate que el tipo del campo  en la tabla  es , no  , para evitar problemas con la codificación de caracteres.

Si estás actualizando desde MediaWiki 1.5 o posterior hasta 1.35 entonces puedes realizar la actualización en un sólo paso, desde tu vieja versión a la versión estable más reciente. La inmensa mayoría de informes, además de las pruebas automatizadas, indican que hacerlo en un único paso funciona perfectamente. Si no te lo crees, lee este mensaje de lista de correo. Sin embargo, has de tener en cuenta que al actualizar desde versiones muy antiguas, las posibilidades de que te encuentres errores de PHP son mayores que si estuvieses actualizando desde la versión inmediatamente anterior a la nueva. Habría recibido estos errores de todos modos, si no se hubiera saltado las versiones, pero los errores se habrían asociado con cada actualización individual. Instead, if you update several versions at once, you'll get the same set of errors all at the same time. Esto hará que la actualización sea más difícil, pero no olvides que ¡también te ahorras actualizar primero a todas las versiones que te estás saltando!

If you are upgrading to MediaWiki 1.36 or later, only upgrades from the last two LTS releases will be supported (T259771). This will mean that for very old versions, that you first upgrade to MediaWiki 1.35 and then upgrade to 1.36.

¿Debería hacer primero una copia de seguridad?
Respuesta breve: sí.

Respuesta más larga: depende de (a) en cuánto valoras tu información, (b) cómo de difícil sería hacer la copia de seguridad, y (c) la experiencia que tienes en el mantenimiento y administración de MySQL.

Un fallo en la actualización puede dejar tu base de datos en un estado inconsistente, a medio camino entre dos versiones distintas. Podría aparecer un error de PHP o de MySQL durante la actualización, dejando tu base de datos actualizada a medias. In such situations it may be possible to somehow fix this problem with much manual work. However, it will be way easier to just put a database backup from before running update.php in place and to continue with that. Otherwise you might have hours of - needless - work.

La recuperación de una situación así es a menudo complicada. Los voluntarios que atienden los foros de soporte es poco probable que reciban con agrado la noticia de que no tienes una copia de seguridad y que ahora necesitas ayuda para salvar los muebles porque ha habido corrupción de datos durante una actualización. Una situación más deseable sería que pudieses repetir el proceso echando mano de tu copia de seguridad, para a continuación informar del fallo identificando el componente de MediaWiki que causó la corrupción de datos durante el proceso de actualización.

¿Puedo conservar mi LocalSettings.php?
Sí, pero puede que tengas que hacer algunos pequeños cambios. El formato de es fundamentalmente compatible hacia abajo; los cambios que puedan afectar a la compatibilidad de LocalSettings.php se documentarán en la sección "Cambios en la configuración" de las notas de lanzamiento.

¿Puede mi wiki seguir funcionando mientras se actualiza?
Generalmente sí, aunque Git puede inutilizarlo temporalmente (durante unos pocos segundos).

Si estás actualizando entre versiones menores de MediaWiki, lo único que necesitas es sustituir los antiguos archivos con los nuevos.

Nota: lo que sigue da por supuesto que tienes acceso a nivel de línea de comandos. Si estás actualizando entre versiones mayores de MediaWiki, el procedimiento recomendado es el siguiente:


 * 1) Descomprime la nueva versión de MediaWiki a un nuevo directorio.
 * 2) Prepara el nuevo directorio: copia tu LocalSettings.php del antiguo directorio, así como las extensiones y apariencias personalizadas que puedas tener instaladas. Verifique la configuración de  y  en LocalSettings.php y, si fuese necesario, copia el archivo del logo del directorio antiguo al nuevo.
 * 3) En las notas de lanzamiento de la nueva versión, mira si hace falta hacer cambios en LocalSettings.php.
 * 4) Pon la base de datos en modo lectura insertando la siguiente variable en el LocalSettings.php del viejo directorio; los usuarios verán este mensaje si intentan editar una página durante el proceso de actualización:


 * 1) * Esta opción no sirve a partir de MediaWiki 1.27, donde también impide ejecutar el script de actualización. Una solución alternativa la puedes encontrar en la página . Consulta también.
 * 2) Ejecuta el script de actualización o el actualizador web en el nuevo directorio.
 * 3) Copia el subdirectorio 'images' del antiguo directorio al nuevo directorio.
 * 4) Intercambia el antiguo directorio con el nuevo.

¿Por qué actualizar?

 * Suscríbete a mediawiki-announce para recibir notificaciones de nuevos lanzamientos.

Porque suele ser fácil hacerlo, con un único paso para cambiarte a la versión más reciente y también vía web.

Las versiones recientes reciben correcciones en la seguridad que hacen que tu wiki y tu servidor estén mejor protegidos contra los vándalos, cosa que no ocurre con las versiones antiguas (véase ). ¡Ya sólo éso supone docenas de motivos para actualizarte!

Los lanzamientos donde hay un cambio de versión mayor traen nueva funcionalidad que te puede interesar: mira las notas de lanzamiento para más detalles. En caso de que necesites más argumentos para convencer a tus jefes de que te dejen actualizar una antigua versión, aquí va una lista:

InstantCommons no longer requires local files. Allow to block range of IPs. Added ability to search for contributions within an IP ranges at Special:Contributions. The was introduced. Add default edit rate limit of 90 edits/minute for all users. The "watch" feature can be enhanced with expiry dates.
 * Desde la versión, las ediciones pueden previsualizarse antes de guardar también como un diff.
 * Desde la versión hay un botón deshacer.
 * Desde la versión, patrullar en Especial:PáginasNuevas es mucho más sencillo.
 * Desde la versión, puedes renombrar (trasladar) archivos.
 * Desde la versión, puedes reparar las redirecciones dobles automáticamente.
 * Desde la versión está disponible.
 * If you have appropriate caching, since 1.17 optimizes pageload speeds a lot.
 * Desde la versión 1.17, ¡la ordenación de las categorías tiene sentido! (especialmente con caracteres que no usa el inglés); ampliado a 68 idiomas después de.
 * Desde las versiones y, la interfaz y los registros se dirigen correctamente a los usuarios de todos los idiomas y géneros (antes de la versión 1.15, no había distinción de ningún tipo por género).
 * In the skinning system was reworked, making it easier to reuse parts of existing skins in your own skins.
 * Desde la versión 1.20, los diffs son más legibles.
 * En las versiones 1.21 y 1.23, las notificaciones por correo electrónico se volvieron más claras y predecibles, haciendo que tu wiki sea más efectivo.
 * Desde la versión 1.22, la lucha contra el vandalismo (patrullar) consume menos tiempo.
 * In 1.24, password storage was improved to allow for better security.
 * Since 1.25, enhanced recent changes are available
 * In 1.26, the "ResourceLoader" mechanism was improved
 * In 1.27, the session management was reworked as well as the user authentication management completely modernized.
 * Since, the cache for rendered HTML of article pages improved.
 * Since, the Action API was reworked and improved. Also, user group assignments may now be done for a selectable period.
 * Since, the blocked users cannot change their email.
 * Since, some extensions are now part of the core, like , ,.
 * Since, MediaWiki supports over 350 languages.
 * Since, MediaWiki supports "partial blocks", where IPs and accounts can be restricted from editing particular pages or namespaces.
 * Since, more extensions part of the core: (for Lua modules), ,.
 * Since (a stable long-term support release),  is part of the core.

También, en empezamos a incluir en el archivo de MediaWiki algunas extensiones vitales, como un editor mejor y las herramientas anti-vandalismo ConfirmEdit y Nuke; en versiones más recientes se han ido añadiendo más. 

Véase también

 * Un artículo del blog de Greg Sabino Mullane que ofrece más detalles sobre las pequeñas actualizaciones
 * La mesa de ayuda, si necesitas ayuda o algo ha ido mal
 * - si tienes una copia de seguridad
 * - si tienes una copia de seguridad
 * - si tienes una copia de seguridad
 * - si tienes una copia de seguridad
 * - si tienes una copia de seguridad