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 las notas sobre los cambios que se han hecho en el software
 * 3) Haz una copia de seguridad de los archivos existentes y de la base de datos
 * 4) Extrae los nuevos archivos
 * 5) Actualiza las extensiones
 * 6) Ejecuta el script de actualización para comprobar la base de datos
 * 7) Comprueba la actualización

Comprobación de requisitos
MediaWiki requiere:


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

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.

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 images, logotipo personalizado /skins/common/images/wiki.png)
 * archivos de configuración, como por ejemplo LocalSettings.php y .htaccess (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.

Deberías extraer los archivos en un nuevo directorio vacío en el servidor. Si extraes los archivos de la nueva versión directamente encima de los antiguos en lugar de hacerlo en un directorio nuevo, deberás seguir las instrucciones descritas en Haz una copia de seguridad de los archivos existentes y de la base de datos; de no hacerlo, si has realizado alguna modificación en los archivos de instalación, podrías perder esas modificaciones, quedándote sin referencias para aplicarlas de nuevo. Extraer los archivos directamente encima de tu copia actual de MediaWiki puede también dejar por ahí archivos de la versión anterior que podrían interferir con el código de la nueva versión. Te recomendamos que extraigas los nuevos archivos en un nuevo directorio, y que entonces apliques en el nuevo directorio las modificaciones que estimes oportunas (restaurar 'LocalSettings.php', la carpeta 'images', las extensiones y otras personalizaciones como pueden ser las apariencias personalizadas).

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.

Línea de comandos
Es posible que necesites ejecutar el comando con sudo 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:

$ cd /path/to/your/new/installation/ $ wget https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz $ tar -xvzf mediawiki-.tar.gz $ rm mediawiki-.tar.gz

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: 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.
 * , 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.
 * 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).

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.

Si estás actualizándote a MediaWiki 1.25 o a una versión posterior, también tendrás que instalar una serie de bibliotecas PHP externas, ya sea usando Composer o bien el conjunto que se proporciona y que está mantenido para la granja de wikis de Wikimedia. Encontrarás más detalles sobre la instalación y actualización de bibliotecas externas en la documentación para la descarga desde Git.

Usando un parche
Por cada actualización menor normalmente también se publica un archivo de parches. 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.

Adapta tu LocalSettings.php
Si vas a usar el mismo archivo LocalSettings.php 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 LocalSettings.php 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 LocalSettings.php cuando actualices desde una versión anterior a la 1.24 y quieras tener disponible alguna de estas apariencias:

Este código es para MediaWiki 1.25 y posteriores. Para MediaWiki 1.24 necesitas usar este código:

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 LocalSettings.php</tt> 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 LocalSettings.php</tt> 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 maintenance</tt> y ejecuta el script de actualización:

$ php update.php Si estás usando Linux y te encuentras un error, prueba a ejecutar el mismo comando como raíz ( sudo php maintenance/update.php ). En el caso de un paquete integrado para Windows (por ejemplo, ), asegúrate primero de que tanto tu servidor web (como Apache) como el motor de la base de datos (por ejemplo, MySQL) están corriendo, y entonces ejecuta update.php pulsando sobre él con el botón secundario del ratón, eligiendo "Abrir con..." y eligiendo PHP.exe dondequiera que lo tengas instalado; la ventana de comandos que se abre probablemente se cerrará por sí sola cuando concluya la actualización de la estructura de la base de datos.

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 comando puede usar una versión de PHP distinta de la que tú tienes cuando ejecutas 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 qué 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.

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.

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: <pre style="overflow:auto;"> 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: <pre style="overflow:auto;"> $ whereis 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 <pre style="overflow:auto;"> Cannot get command line arguments, register_argc_argv is set to false

<pre style="overflow:auto;"> register_argc_argv=true
 * 1) Vé a ~/maintenance y edita el archivo 'php.ini', o créalo si no existe
 * 2) Añade una línea así:
 * 1) Vuelve a ejecutar 'php update.php'

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.

It might happen that the web-updater does not seem to work: Instead of seeing the initial language selection screen, you might see an empty wiki page, possibly with some error message. In this case it is most likely that your webserver uses Rewrite Rules (most likely for short URLs), which do not show you the updater at mw-config/, but a wiki page at Mw-config/, with capital "M". In this case, rename the .htaccess file for the time of the update. Then you should be able to access the web-updater.
 * 1) Haz siempre una copia de seguridad de tu wiki antes de realizar cualquier labor de mantenimiento en la base de datos.
 * 2) Visita /mw-config/</tt> desde tu navegador. Por ejemplo, si tu wiki está en  http://example.org/w/index.php </tt>, entonces abre  http://example.org/w/mw-config/ </tt>.
 * 3) Elige tu idioma y pulsa 'Continuar'.
 * 4) The existing installation should be detected. Follow the instructions on the screen to upgrade it. If asked for the "upgrade key", open your  file and look for the key assigned to.

Test the update
Once the upgrade has been completed, browse to the wiki and check that the following operations work as expected:
 * Viewing pages
 * Editing pages
 * Uploading a file
 * Visit Special:Version and check that the version shown is correct and that the extensions are present.

Preguntas frecuentes
<section begin=FAQ />

¿Qué tan difícil es actualizar?
If the only file you have modified is, and you are upgrading from 1.5 or later, the process is very simple. The amount of human work involved is only a few minutes. The database schema changes will take an amount of time proportional to the size of your database — potentially hours for wikis with millions of pages, but for a more typical size of a few thousand pages, it is usually done in seconds.

Minor upgrades, within the same major version, say from 1.13.0 to 1.13.1, do not require any schema changes at all. You can just update the files. The database needs no update, hence it is not necessary to run the installer script.

Upgrading from 1.4 or earlier is potentially complicated because support for character sets other than UTF-8 was dropped, and the schema for storing bulk text changed. Please read the relevant section in the UPGRADE</tt> file.

Upgrading becomes difficult if you have modified our source code, and you don't want your changes to be overwritten. Tools such as diff, patch, Meld or WinMerge may be useful. There is also potential for trouble if you are using unmaintained extensions. Upgrade your extensions at the same time as you upgrade MediaWiki.

If you have modified the skin or use a custom skin you very likely will have to adjust it to work again with the new version of MediaWiki.
 * Instead of patching your "global" css and js (javascript) files everytime you can simply add the code to your MediaWiki:Common.js and MediaWiki:Common.css pages. As these are part of the database which will be reused when you upgrade, you will not have to patch the MediaWiki core files any more.

¿Cómo actualizo desde una versión muy antigua? ¿En uno o en varios pasos?
It depends: If you are upgrading from MediaWiki 1.4 or older, you should upgrade to MediaWiki 1.5 first. If you are upgrading from a Latin-1 wiki, use upgrade1_5.php (found in MediaWiki 1.5) to convert the relevant parts of the database to UTF-8 ( needs to be set to true in your for this to work). Next, run update.php, and then set the option in LocalSettings.php to the encoding previously used by the wiki (e.g. windows-1252). This is basically how Wikipedia and other Wikimedia Foundation sites were upgraded from MediaWiki 1.4 to 1.5 – see the relevant settings file (warning: huge page!) and some related notes at Wikitech. You may need to upgrade to MediaWiki 1.4 before running the upgrade1.5 script.

If you are upgrading from MediaWiki 1.5 or newer, you can upgrade in one step, from your old version to the latest stable version. The vast majority of reports, as well as automated testing, indicate that doing it in one step works just fine. If you have trouble believing this, read this mailing list post. However, please note that when you update from old versions, chances that you will encounter PHP errors are bigger than when you upgrade from the version directly previous to the new version. You would have received these errors anyway, also if you had not skipped versions, but if you had each time done each single update. Only will you - when you skipped versions - get them all at the same time. This will make the upgrade more difficult, but do not forget that you did not have the trouble updating to the intermediate versions, which you skipped!

If upgrading from a MediaWiki version below 1.19, you may need to add the sha1 field to the revision table manually before running the update script (see and a relevant support desk thread).

¿Debería hacer una copia de respaldo?
Respuesta corta: sí.

Long answer: It depends on a) how much you value your data, b) how hard it is to create a backup and c) how confident you are with MySQL maintenance and administration.

An upgrade failure may leave your database in an inconsistent state, in between two versions. A PHP or MySQL error might happen during upgrade leaving your database partly upgraded. 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.

Recovery is often complex. Volunteers on the support forums are unlikely to be impressed if you neglect to make a backup and then need help to recover from upgrade-related corruption. A better outcome is if you can revert to your backup, and then report the bug against the corresponding MediaWiki project in the upgrade process which caused the corruption.

¿Puedo conservar mi LocalSettings.php?
Yes, but you may have to make some minor changes. The format of is largely backwards compatible. Changes which break LocalSettings.php compatibility will be documented in the "configuration changes" section of the release notes.

¿Puede mi wiki seguir funcionando mientras se actualiza?
Generally yes, however Git may temporarily (for a few seconds) break it.

If you are upgrading between minor releases of MediaWiki, all you need to do is update the source files.

Note: the following assumes you have command line access. If you are upgrading between major releases of MediaWiki, the preferred procedure is as follows:
 * 1) Unpack the new version of MediaWiki into a new directory
 * 2) Prepare that new directory: copy your current LocalSettings.php from the old directory, copy any installed extensions and custom skins (if any).
 * 3) In the release notes for the new version, see if any changes need to be made to LocalSettings.php.
 * 4) Place the database in read-only mode by inserting the following variable into LocalSettings.php in the old directory - users will see this message if they attempt an edit during the upgrade process:
 * 5) Run the update script or the web updater in the new directory.
 * 6) Copy the images from the images sub-directory from the old directory to the new directory.
 * 7) Swap the old directory and the new directory.

¿Por qué actualizar?

 * ''Subscribe to mediawiki-announce to be notified of new releases.

Because it's usually easy enough, a single step from your version to latest and also via web.

Recent releases receive security fixes to keep your wiki and your host safe from vandals, while old releases don't (see ). That makes dozens good reasons to upgrade!

New major releases come with new features, which you might want to use: see the release notes for details. In case you need additional arguments to convince your bosses to let you upgrade from a pretty old version, here is a summary:


 * Since 1.5, edits can be previewed before saving also as diff.
 * Since 1.9, an undo button is available.
 * Since 1.12, patrolling on Special:NewPages is much easier.
 * Since 1.13, you can rename (move) files.
 * Since 1.14, you can fix double redirects automatically.
 * Since 1.16, is available.
 * If you have appropriate caching, since 1.17 optimizes pageload speeds a lot.
 * Since 1.17, category sorting makes sense! (especially for non-English letters); extended to 68 languages after 1.21.
 * Since 1.18 and 1.19, users of all languages and genders are correctly addressed by the interface and logs (before 1.15, no gender at all).
 * In 1.19 the skinning system was reworked making it easier to reuse parts of existing skins in your own skins.
 * Since 1.20, diffs are better readable.
 * In 1.21 and 1.23, email notifications become clearer and more predictable, making your wiki more effective.
 * Since 1.22, vandal fighting (patrolling) is less time-consuming.

See also the list of the most voted fixed issues on up to 2014.

Also, in MediaWiki 1.18 we started bundling some vital extensions, like a better editor and anti-vandalism tools ConfirmEdit and Nuke; more have been added in later releases. <section end=FAQ />

Véase también

 * Greg Sabino Mullane's Blog post provides some more detail about point release upgrades.
 * Project:Support desk if you need help or something went wrong
 * (if you don't have a successful backup)
 * (if you don't have a successful backup)
 * (if you don't have a successful backup)
 * (if you don't have a successful backup)
 * (if you don't have a successful backup)