Jump to content

Manual:Actualització

From mediawiki.org
This page is a translated version of the page Manual:Upgrading and the translation is 100% complete.
Languages:
Baixar un paquet informàtic

Visió general bàsica

Transferència de fitxers

Trieu un mètode per transferir fitxers:

Preliminar

Llegiu el UPGRADE.

  1. Comproveu els requisits
  2. Llegiu el fitxer RELEASE-NOTES
  3. Llegiu el fitxer UPGRADE
  4. Feu una còpia de seguretat dels fitxers existents i de la base de dades
  5. Desempaquetar els fitxers nous
  6. Actualitzeu les extensions
  7. Executeu l'script d'actualització per comprovar la base de dades
  8. Proveu l'actualització
  9. Elimineu les restes de les instal·lacions antigues

Comprovació dels requisits

Atenció Atenció: MediaWiki versions 1.32 through 1.35.4, 1.36.2, and 1.37.0 contain a security issue that allow unprivileged editing of arbitrary pages and arbitrary JavaScript execution. If you are using one of these versions and can not upgrade to a newer version, please see 2021-12 security release/FAQ for a workaround.

MediaWiki 1.46 requereix:

  • PHP 8.3.0+
  • Un dels següents:
    • MariaDB 10.3.0+
    • MySQL 5.7.0+
    • PostgreSQL 10.0+
    • SQLite 3.31.0+
Since version 1.36, MediaWiki commits to supporting upgrades from up to two LTS releases ago (see T259771). Upgrades from older versions of MediaWiki have to be performed in multiple steps. For example, to upgrade from 1.38 (or earlier) to 1.46, first upgrade your wiki to 1.39 (or 1.43), and then, you'll be able to upgrade to 1.46.

Si feu servir PostgreSQL, llegiu també Manual:Upgrading Postgres .

Per a més informació, llegiu el Manual:Requisits d'instal·lació i Compatibility .

Llegiu les notes de la versió

Dins del fitxer tarball, o dins dels fitxers descarregats/exportats des de Git, hi ha diversos fitxers amb noms en majúscules, un dels quals conté les RELEASE-NOTES (wiki). Ara és el moment d'obrir-lo i descobrir què s'ha canviat en aquesta versió. També hauríeu de llegir les instruccions del fitxer UPGRADE.

Esborrar les tasques pendents

Per motius de rendiment, algunes accions a la base de dades es retarden i les gestiona la cua de tasques. Aquestes tasques s'emmagatzemen a la base de dades i contenen paràmetres amb informació sobre les accions que s'haurien de realitzar. Es recomana executar aquestes tasques pendents abans d'actualitzar la wiki, per evitar que fallin en cas que l'especificació dels paràmetres d'aquestes tasques canviï en la nova versió. Utilitzeu runJobs.php per executar totes les tasques pendents i esborrar la cua abans de fer l'actualització.

Feu una còpia de seguretat dels fitxers existents i de la base de dades

Instruccions completes: Manual:Fer una còpia de seguretat d'un wiki

Tot i que els scripts d'actualització estan ben mantinguts i són robustos, les coses encara podrien anar malament. Abans d'actualitzar l'esquema de la base de dades, feu una còpia de seguretat completa del wiki, incloent-hi tant la base de dades com els fitxers:

  • el contingut del wiki, des de la base de dades, (assegureu-vos que heu especificat correctament el conjunt de caràcters, primer comproveu LocalSettings.php). Pot ser una bona idea crear un abocament de dades XML a més de l'abocament de dades de la base de dades SQL.
  • MySQL, tant el dump SQL com el dump XML, s'han d'utilitzar amb l'ordre mysql:
mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql
mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
  • PostgreSQL, dump de base de dades per utilitzar amb l'ordre pg_restore:
pg_dump --create -Fc wikidb > file.db.dump
  • SQLite, utilitzeu un script MediaWiki per fer una còpia de seguretat:
php wikifolder/maintenance/run.php SqliteMaintenance --backup-to file
  • imatges i altres fitxers multimèdia (el contingut del directori images, el logotip personalitzat /skins/common/images/wiki.png)
  • fitxers de configuració, p. ex. LocalSettings.php i .htaccess (si n'hi ha)
  • fitxers del programa de MediaWiki, incloent-hi totes les aparences i extensions, especialment si les heu modificat.

Desempaquetar els fitxers nous

Utilitzar un paquet tarball (*)

(*) tarball = un fitxer de tipus tar, que du fitxers comprimits per a fer una instal·lació.

Podeu col·locar els fitxers nous mitjançant FTP o la línia d'ordres. Feu servir la línia d'ordres, si hi teniu accés! L'ús de la línia d'ordres serà molt més ràpid que haver de carregar cadascun dels milers de fitxers mitjançant FTP.

Hauríeu de col·locar el tarball descomprimit en una carpeta nova i buida al vostre servidor. Si, en canvi, extraieu la nova versió directament a sobre de la versió antiga, en lloc de fer-ho en un directori nou, heu de seguir les instruccions descrites a Còpia de seguretat dels fitxers existents i de la base de dades: en cas contrari, si heu fet alguna personalització, podeu esborrar-la de manera que no us quedi cap referència per tornar-la a aplicar. L'extracció directa d'un tarball sobre la vostra còpia de MediaWiki en funcionament pot deixar fitxers de la versió antiga (en funcionament) de MediaWiki que poden interferir amb el codi actualitzat. Es recomana que descomprimiu els nous fitxers en un directori nou i, a continuació, aplicar les personalitzacions al directori nou (restaurar LocalSettings.php, la carpeta d'imatges, les extensions i altres personalitzacions com ara aparences personalitzades).

FTP o interfície gràfica

Si no podeu accedir a la línia d'ordres del vostre servidor, descarregueu el tarball de MediaWiki a l'ordinador local i utilitzeu 7zip per fer l'extracció del seu contingut al vostre PC local.

Després d'extreure els fitxers localment, utilitzeu el vostre programari client FTP preferit per carregar directoris i fitxers al servidor.

Gestor de fitxers cPanel

cPanel és una interfície popular proporcionada per molts proveïdors d'allotjament web. Aquest mètode és eficient perquè els fitxers es descomprimeixen al mateix servidor.

  • Navegueu al directori que conté la vostra carpeta wiki.
  • Carregueu el fitxer mediawiki-1.xx.x.tar.gz. És possible que hàgiu de prémer "Torna a carregar" per veure'l.
  • Extraieu el fitxer mediawiki-1.xx.x.tar.gz. Torneu a carregar-lo.
  • Confirmeu que la carpeta mediawiki-1.xx.x hi sigui.
  • Suprimiu el fitxer tar.gz.
  • Copieu totes les aparences, extensions, carpetes d'imatges, personalitzacions, i el LocalSettings.php, necessàries, a la carpeta nova. (Vegeu més avall.)
  • Quan estigueu a punt per executar update.php, canvieu el nom de la vostra carpeta wiki antiga i la vostra carpeta wiki nova. (per exemple, "w" esdevé "w1.34" i després "mediawiki1.35.0" esdevé "w"). Aquest pas és fàcilment reversible si teniu problemes.

Línia d'ordres

Potser haureu d'executar l'ordre com a sudo si no teniu permisos d'escriptura complets als directoris d'instal·lació de la wiki amb el vostre usuari actual. Quan es descomprimeix un tarball, normalment es crearà un directori nou per a la nova versió de la wiki i haureu de copiar els fitxers de configuració antics i el directori d'imatges del vostre directori d'instal·lació antic:

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

Els usuaris de Solaris (obert) haurien d'utilitzar gtar o: 

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

Altres fitxers

Després d'extreure els arxius del tarball, hauríeu de copiar o moure alguns fitxers i carpetes del directori d'instal·lació antic al nou:

  • LocalSettings.php - conté els vostres paràmetres de configuració antics.
  • El directori images (o uploads en versions anteriors), que conté tots els fitxers carregats al wiki, tret que hàgiu triat un directori de càrrega diferent i canvieu la propietat i els permisos. find ./images -type d -exec chmod 755 {} \; i chgrp -R apache images (per exemple, si el vostre usuari web és apache).
  • Algunes extensions al directori extensions. Sempre hauríeu de tenir les extensions actualitzades; no es garanteix que les extensions antigues funcionin amb una versió més nova de MediaWiki.
  • En cas que utilitzeu un logotip personalitzat, aquest fitxer també s'ha de restaurar des d'una còpia de seguretat. Abans de la versió 1.24, el logotip sol ser a skins/common/images/. Després de la versió 1.24, el logotip sol ser a resources/assets/ o images/ si aquest és el que heu triat d'utilitzar. A continuació, afegiu-ho a LocalSettings.php, per exemple, $wgLogo = "$wgScriptPath/images/logo.png";
  • Per a la versió 1.35, potser haureu de restaurar els logotips de wgLogos . A continuació, afegiu-ho a LocalSettings.php, per exemple, $wgLogos = [ '1x' => "path/to/1x_version.png", '2x' => "path/to/2x_version.png", 'svg' => "path/to/svg_version.svg" ];
  • Aparences personalitzades des del directori skins.
  • Qualsevol modificació feta als fitxers o extensions d'instal·lació antics.
  • Qualsevol fitxer .htaccess (si utilitzeu Apache i hi heu definit alguna regla).

Un cop fet això, feu que aquesta nova carpeta sigui la carpeta publicada al servidor web o canvieu el nom del directori d'instal·lació antic i després canvieu el nom del nou perquè coincideixi amb el nom antic. Canvieu la propietat i el grup de tot perquè el servidor web tingui accés als fitxers.

Ús de Git

Si feu servir Git , exporteu els fitxers a un directori buit i, a continuació, copieu els fitxers personalitzats antics a aquesta nova ubicació tal com es descriu a la secció anterior.

També haureu d'instal·lar algunes biblioteques PHP externes mitjançant Composer o una col·lecció proporcionada que es manté per a la granja de wikis de Wikimedia. Podeu trobar més detalls sobre la instal·lació i l'actualització de biblioteques externes a la documentació de descàrrega de Git.

Instal·lar un pedaç

Normalment, per a una actualització d'una versió menor es publica un petit "fitxer de pedaç". Haureu de descarregar patch per instal·lar-lo. Baixeu i extraieu manualment el fitxer del pedaç del lloc de dumps o seguiu les instruccions amb wget a continuació. Els pedaços són incrementals, no podeu saltar-vos una versió.

  1. cd al vostre directori principal de MediaWiki (el que té LocalSettings.php).
  2. Baixeu el fitxer del pedaç i descomprimiu-lo amb gunzip.
  3. Utilitzeu patch -p1 --dry-run per comprovar què es canviarà (per exemple, patch -p1 --dry-run -i mediawiki-x.xx.x.patch)
  4. Si tot està bé, torneu a executar patch, però sense --dry-run.
  5. Reviseu la vostra Especial:Versió i hauríeu de veure el número de versió nou.

Fitxers restants que poden causar errors

Si heu descomprimit en el directori d'instal·lació antic, alguns fitxers antics poden causar problemes amb la nova versió.

Actualització d'extensions

S'han d'actualitzar certes extensions per tal que funcionin amb la nova versió de MediaWiki. Assegureu-vos d'actualitzar a les últimes versions d'aquestes extensions. És possible que hàgiu de fer actualitzacions manuals a les extensions personalitzades.

Diferents tarballs inclouen alguns subconjunts d'extensions i tenen control de versions que us ajuden en l'actualització, triant la correcta per a la vostra versió de MediaWiki.

El distribuïdor d'extensions funciona bé per a la majoria de persones que volen una instantània de les extensions que funcionaran amb les versions compatibles de MediaWiki.

Si us proposeu descarregar moltes extensions, la descàrrega des de Git és probablement la millor opció. Si no teniu Git però voleu actualitzar moltes extensions, podeu considerar utilitzar mwExtUpgrader.

<span id="Adapt_your_LocalSettings.php">

Adapteu el vostre LocalSettings.php

Quan utilitzeu LocalSettings.php per a la darrera versió, potser necessiteu adaptar-lo a com l'utilitzen les noves versions:

Registre d'aparences

MediaWiki version:
≥ 1.24

Des de MediaWiki 1.24, les aparences incloses com Vector, Monobook, Modern i CologneBlue ja no formen part del nucli de MediaWiki i s'han de registrar explícitament a LocalSettings.php per utilitzar-les; en cas contrari, MediaWiki avisarà que no teniu les aparences instal·lades.

Això és el que cal afegir a LocalSettings.php quan s'actualitza des de versions anteriors a la 1.24 i es vol tenir disponible una d'aquestes aparences: 

wfLoadSkin( 'Vector' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Modern' );
wfLoadSkin( 'CologneBlue' );

Pot ser que altres aparences encara no estiguin adaptades al nou sistema de registre d'aparences, així que consulteu la pàgina de documentació sobre cada aparença per veure com registrar-la correctament en cas de problemes.

Registre d'extensions

MediaWiki version:
≥ 1.25

Des de MediaWiki 1.25, les extensions utilitzen un nou sistema de registre d'extensions.

Anteriorment, el vostre LocalSettings.php incloïa alguna cosa semblant a: 

require_once "$IP/extensions/Cite/Cite.php";
require_once "$IP/extensions/Gadgets/Gadgets.php";
require_once "$IP/extensions/ImageMap/ImageMap.php";
require_once "$IP/extensions/InputBox/InputBox.php";
require_once "$IP/extensions/Nuke/Nuke.php";
require_once "$IP/extensions/ParserFunctions/ParserFunctions.php";
require_once "$IP/extensions/Poem/Poem.php";
require_once "$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php";
require_once "$IP/extensions/WikiEditor/WikiEditor.php";

Això es pot convertir a: 

wfLoadExtension( 'Cite' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'WikiEditor' );

Les extensions s'estan adaptant per utilitzar el nou sistema de registre d'extensions. Les extensions que no estiguin adaptades haurien d'utilitzar la manera antiga d'instal·lar-les. Consulteu les instruccions d'instal·lació a la pàgina de l'extensió, per obtenir més informació.

Elimineu una línia de DefaultSettings.php (si cal)

MediaWiki version:
≥ 1.38

Les versions anteriors de MediaWiki generaven automàticament una línia a LocalSettings.php que anomenava DefaultSettings.php . A partir de la versió 1.38, aquesta línia està obsoleta i no funciona amb moltes extensions. Cal eliminar-la.

Elimineu la línia següent: 

require_once( "$IP/includes/DefaultSettings.php" );

Elimineu RenameUser de LocalSettings.php

MediaWiki version:
≥ 1.40

Si esteu actualitzant a la versió 1.40 o superior, Extension:RenameUser s'ha fusionat amb el nucli. Si hi és, cal eliminar aquesta línia de LocalSettings.php o l'actualització fallarà. 

wfLoadExtension( 'Renameuser' );

Elimineu Interwiki de LocalSettings.php

MediaWiki version:
≥ 1.44

Si esteu actualitzant a la versió 1.44 o superior, Extension:Interwiki s'ha fusionat amb el nucli. Si hi és, cal eliminar aquesta línia de LocalSettings.php. 

wfLoadExtension( 'Interwiki' );

Assegureu-vos de comprovar Noves funcions orientades a l'usuari a la versió 1.44 per veure alguns paràmetres d'Interwiki que s'han eliminat o han canviat de nom.

Altres variables

Algunes variables poden estar obsoletes o fins i tot eliminades. Tenir-les a LocalSettings.php normalment no tindrà cap efecte. Es poden afegir noves variables a les versions més noves o algunes variables existents poden canviar el seu tipus. Normalment, intentem utilitzar valors per defecte sensats per a elles i, en cas de canvi de tipus, ser compatibles amb versions anteriors. En qualsevol cas, mireu les notes de la versió per veure aquests canvis.

Executeu l'script d'actualització

Podeu actualitzar la base de dades MediaWiki de dues maneres: des de la línia d'ordres o des del navegador web. Si teniu accés al vostre servidor, es recomana actualitzar des de la línia d'ordres, ja que això redueix el risc que el procés d'actualització s'interrompi per un temps d'espera o per un reinici de la connexió.

L'script també us notificarà si alguna de les dependències PHP del nucli de MediaWiki està desactualitzada.

Línia d'ordres

Accediu a la línia d'ordres del vostre servidor o a un intèrpret d'ordres SSH o similar. Podeu accedir a la línia d'ordres connectant-vos al vostre servidor mitjançant SSH. Les versions actuals de tots els principals sistemes operatius (inclosos Windows 10 i 11) contenen un client OpenSSH de línia d'ordres, sigui per defecte o com a funció instal·lable. Si l'ordinador local on treballeu utilitza Microsoft Windows, potser voldreu (o, si és la versió 8.1 o anterior, haureu d'instal·lar) PuTTY, que té una interfície semblant a un assistent (o una eina similar). 

Des de la línia d'ordres o l'intèrpret d'ordres, executeu l'script d'actualització:
MediaWiki version:
≥ 1.40
 
$ php maintenance/run.php update
MediaWiki version:
≤ 1.39
 
$ php maintenance/update.php

En un servidor Linux, si rebeu un error, proveu d'executar la mateixa ordre com a root (utilitzant l'ordre sudo). Nota per a instal·lacions senzilles a Windows (per exemple, amb XAMPP ): Primer assegureu-vos que el vostre servidor web (com ara Apache) i la vostra base de dades (com ara MySQL) estiguin en funcionament. A continuació, executeu update.php: feu-hi clic amb el botó dret, seleccioneu Open With i navegueu fins a PHP.exe. La finestra de l'indicador d'ordres resultant probablement es tancarà automàticament quan s'acabi l'actualització de l'esquema.

MediaWiki inspeccionarà l'esquema existent i l'actualitzarà perquè funcioni amb el codi nou, afegint taules i columnes segons calgui.

Si utilitzeu una base de dades compartida, heu de passar el paràmetre ----doshared si voleu que les taules compartides s'actualitzin. En cas contrari, l'script d'actualització no les tocarà.

Què cal fer si diu "MediaWiki requereix PHP x.y.z o superior; esteu utilitzant PHP x.w.v"

Vegeu Manual:Errors i símptomes comuns#MediaWiki requereix PHP 7.4.3 o superior; esteu utilitzant PHP 7.3.17

Què cal fer si php update.php no fa res, cosa que provoca una pausa ràpida i després es torna a la línia d'ordres

Això pot ser causat per una extensió o una aparença que no funciona correctament.

  • Comproveu que totes les extensions i aparences que es demanen a LocalSettings.php siguin presents
  • Comproveu que les extensions utilitzen el mètode de registre correcte (wfLoadExtension vs. require_once)
  • Deixeu com a comentari la primera meitat de les extensions a LocalSettings.php. Si això fa que update.php funcioni, descomenteu la meitat d'aquesta meitat (és a dir, 1/4 de les extensions). Si això NO fa que update.php funcioni, descomenteu la primera meitat, però deixeu com a comentari la segona meitat i després deixeu com a comentari la meitat de la segona meitat, etc. Repetiu fins que update.php funcioni per trobar la que falla.

Què cal fer en cas de l'error "ALTER command denied to user" (o similar)

En cas que els scripts s'avorten amb un missatge similar a: 

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

Això significa que heu de comprovar que heu definit $wgDBadminuser i $wgDBadminpassword al vostre fitxer LocalSettings.php (al directori principal). Aquests són l'usuari i la contrasenya que necessita aquest script per accedir a la base de dades.

En alguns casos, sembla que es llegeix una variable $wgDBmwschema antiga (per a Postgres) perquè el nom de la taula s'actualitzi en lloc de $wgDBname, fins i tot quan s'utilitza MySQL. Si aquest és el cas, només cal eliminar la definició $wgDBmwschema a LocalSettings.php.

Què cal fer en cas d'error 'register_argc_argv is set to false'

És possible que us trobeu amb l'error: 

Cannot get command line arguments, register_argc_argv is set to false
  1. Aneu a ~/maintenance. Editeu un fitxer php.ini existent o creeu-ne un.
  2. Afegiu una línia com la següent:
register_argc_argv=true
  1. Torneu a executar php update.php

MediaWiki version:
≥ 1.17
Vegeu també update.php

Si la vostra base de dades ja és gran i té un ús de producció elevat, no hauríeu d'utilitzar l'actualitzador web, per exemple, perquè el procés d'actualització expirarà quan s'assoleixi el temps_d'execució_màxim (maximum_execution_time). En aquest cas, hauríeu d'utilitzar update.php des de la interfície de línia d'ordres (no des del web). Què és exactament "massa gran" depèn del vostre servidor (per exemple, del seu rendiment, la càrrega i de quin és el màxim temps d'execució de PHP executant un script). Si el vostre wiki és massa gran per a l'actualitzador web i el vostre proveïdor d'allotjament no permet l'accés des de la línia d'ordres, heu de migrar el vostre wiki a un altre compte d'allotjament, preferiblement a un que tingui accés a l'intèrpret d'ordres.

  1. Feu sempre una còpia de seguretat abans de realitzar el manteniment de la base de dades.
  2. Navegueu pel vostre navegador web fins a /mw-config/index.php. Per exemple, si el vostre wiki es troba a http://example.org/w/index.php, navegueu fins a http://example.org/w/mw-config/index.php.
  3. Seleccioneu el vostre idioma i feu clic a Continua.
  4. S'hauria de detectar la instal·lació existent. Seguiu les instruccions que apareixen a la pantalla per actualitzar-la.
    Si us demanen la "contrasenya d'actualització" (upgrade key), obriu el fitxer LocalSettings.php i busqueu la que està assignada a $wgUpgradeKey .

Pot ser que l'actualitzador via web no sembli funcionar: en comptes de veure la pantalla inicial de selecció d'idioma, és possible que vegeu una pàgina wiki buida, possiblement amb algun missatge d'error. En aquest cas, és molt probable que el vostre servidor web utilitzi regles de reescriptura (molt probablement per a URL curtes), que no us mostren l'actualitzador a mw-config/, sinó una pàgina wiki a Mw-config/, amb "M" majúscula. En aquest cas, canvieu el nom del fitxer .htaccess per al moment de l'actualització. Aleshores, hauríeu de poder accedir a l'actualitzador via web.

Atenció Atenció: Si utilitzeu aquest mètode, assegureu-vos de tornar a canviar el nom del fitxer .htaccess després d'executar l'script d'actualització! En cas contrari, les URL curtes i possiblement altres coses es trencaran!

Proveu l'actualització

Un cop finalitzada l'actualització, navegueu fins al wiki i comproveu que les operacions següents funcionin com s'espera:

  • Visualització de pàgines
  • Edició de pàgines
  • Càrrega d'un fitxer
  • Visiteu Special:Version i comproveu que la versió que es mostra és correcta i que les extensions són presents.

Elimineu les restes d'instal·lacions antigues

Si heu copiat la instal·lació anterior a una altra carpeta del servidor, assegureu-vos d'eliminar-la o de fer-la completament inaccessible des del web. És molt important no deixar les instal·lacions antigues accessibles des del web, ja que això frustra completament l'objectiu de l'actualització i deixa el servidor exposat a atacs.

Preguntes freqüents

Quant difícil és actualitzar?

Si l'únic fitxer que heu modificat és LocalSettings.php i esteu actualitzant des de la versió 1.5 o posterior, el procés és molt senzill. La quantitat de treball humà implicat és de només uns minuts. Els canvis d'esquema de la base de dades trigaran un temps proporcional a la mida de la vostra base de dades; potencialment hores per a wikis amb milions de pàgines, però per a una mida més típica d'uns quants milers de pàgines, normalment es fa en segons.

Les actualitzacions menors, dins de la mateixa versió principal, per exemple, de la 1.45.0 a la 1.45.4, no requereixen cap canvi d'esquema. Podeu simplement actualitzar els fitxers. La base de dades no necessita cap actualització, per tant, no cal executar l'script d'actualització.

L'actualització des de la versió 1.4 o anterior és potencialment complicada perquè s'ha eliminat la compatibilitat amb conjunts de caràcters diferents de UTF-8 i s'ha canviat l'esquema per emmagatzemar text massiu. Si us plau, llegiu la secció pertinent del fitxer UPGRADE.

L'actualització es torna difícil si heu modificat el nostre codi font i no voleu que els vostres canvis se sobreescriguin. Eines com ara diff, patch, Meld o WinMerge poden ser útils. També hi ha la possibilitat de problemes si feu servir extensions no mantingudes. Actualitzeu les extensions alhora que actualitzeu MediaWiki.

Si heu modificat l'aparença o feu servir una aparença personalitzada, és molt probable que hàgiu d'ajustar-la perquè torni a funcionar amb la nova versió de MediaWiki.

En comptes d'aplicar pedaços als vostres fitxers CSS i JS (JavaScript) "globals" cada vegada, podeu simplement afegir el codi a les vostres pàgines MediaWiki:Common.js i MediaWiki:Common.css. Com que aquestes formen part de la base de dades que es reutilitzarà quan actualitzeu, ja no haureu d'aplicar pedaços als fitxers del nucli de MediaWiki.

Com puc actualitzar des d'una versió molt antiga? En un pas o en diversos passos?

MediaWiki version:
≤ 1.4

Depèn: si esteu actualitzant des de MediaWiki 1.4 o anterior, primer heu d'actualitzar a MediaWiki 1.5. Si esteu actualitzant des d'un wiki Latin-1, utilitzeu upgrade1_5.php (que es troba a MediaWiki 1.5) per convertir les parts rellevants de la base de dades a UTF-8 ($wgUseLatin1 ha d'estar definit com a true al vostre LocalSettings.php perquè això funcioni). A continuació, executeu update.php i, a continuació, configureu l'opció $wgLegacyEncoding a LocalSettings.php a la codificació que utilitzava anteriorment el wiki (per exemple, windows-1252). Bàsicament, així és com es van actualitzar la Viquipèdia i altres llocs de la Fundació Wikimedia de MediaWiki 1.4 a 1.5; vegeu algunes notes relacionades a Wikitech. És possible que hàgiu d'actualitzar a MediaWiki 1.4 abans d'executar l'script upgrade1.5. Si voleu fer un abocament de dades (per exemple, MySQL) del vostre wiki de Latin-1, assegureu-vos que el tipus del camp old_text a la taula text sigui mediumblob, no mediumtext, per evitar problemes de codificació dels caràcters.

MediaWiki versions:
1.5 – 1.35

Si esteu actualitzant de MediaWiki 1.5 o més recent a 1.35, podeu actualitzar en un sol pas. La gran majoria d'informes, així com les proves automatitzades, indiquen que fer-ho en un sol pas funciona correctament. Si teniu problemes per creure-ho, llegiu aquesta publicació de la llista de correu. Tanmateix, tingueu en compte que quan actualitzeu des de versions antigues, les possibilitats que trobeu errors de PHP són més grans que quan actualitzeu des de la versió directament anterior a la nova versió. Hauríeu rebut aquests errors de totes maneres, si no haguéssiu saltat versions, però els errors haurien estat associats a cada actualització individual. En canvi, si actualitzeu diverses versions alhora, obtindreu el mateix conjunt d'errors tots alhora. Això dificultarà l'actualització, però no oblideu que no heu tingut la molèstia d'actualitzar a les versions intermèdies, que us heu saltat!

MediaWiki version:
≥ 1.35

Si esteu actualitzant a MediaWiki 1.36 o posterior, només s'admetran les actualitzacions de les dues últimes versions LTS (phab:T259771). Això vol dir que per a versions molt antigues, primer heu d'actualitzar a MediaWiki 1.35 i després a 1.43, i després (si voleu actualitzar a una versió que no sigui LTS) actualitzeu a 1.46.0.

Hauria de fer una còpia de seguretat primer?

Resposta curta: Sí.

Resposta llarga: Depèn de a) quant valoreu les vostres dades, b) la dificultat de crear una còpia de seguretat i c) la confiança que teniu amb el manteniment i l'administració de MySQL.

Un error d'actualització pot deixar la vostra base de dades en un estat inconsistent, entre dues versions. Es pot produir un error de PHP o MySQL durant l'actualització que deixi la vostra base de dades parcialment actualitzada. En aquestes situacions, pot ser possible solucionar aquest problema d'alguna manera amb molta feina manual. Tanmateix, serà molt més fàcil simplement fer una còpia de seguretat de la base de dades abans d'executar update.php i continuar amb això. En cas contrari, podríeu tenir hores de treball, innecessari.

La recuperació sovint és complexa. És poc probable que els voluntaris dels fòrums de suport ho rebin amb il·lusió si us oblideu de fer una còpia de seguretat i després necessiteu ajuda per recuperar-la de la corrupció relacionada amb l'actualització. Un millor resultat és si podeu tornar a la vostra còpia de seguretat i després informar de l'error contra el projecte MediaWiki corresponent en el procés d'actualització que va causar la corrupció.

<span id="Can_I_keep_my_LocalSettings.php?">

Puc conservar el meu LocalSettings.php?

Sí, però potser haureu de fer alguns canvis menors. El format de LocalSettings.php és en gran part compatible amb versions anteriors. Els canvis que trenquin la compatibilitat amb LocalSettings.php es documentaran a la secció "canvis de configuració" de les notes de la versió.

Pot el meu wiki romandre en línia mentre s'actualitza?

Generalment sí, però si actualitzeu mitjançant Git, és possible que Git el talli temporalment (durant uns segons).

Si esteu actualitzant entre versions menors de MediaWiki, només heu d'actualitzar els fitxers font.

Nota: el següent pressuposa que teniu accés a la línia d'ordres. Si esteu actualitzant entre versions principals de MediaWiki, el procediment preferit és el següent:

  1. Descomprimiu la nova versió de MediaWiki en un directori nou
  2. Prepareu aquest directori nou: copieu el vostre LocalSettings.php actual del directori antic, copieu les extensions instal·lades i les aparences personalitzades (si n'hi ha). Comproveu la configuració $wgLogo i $wgLogos a LocalSettings.php i, si cal, copieu el fitxer del logotip del directori antic al directori nou.
  3. A les notes de la versió de la nova versió, vegeu si cal fer algun canvi a LocalSettings.php.
  4. Al directori antic, editeu LocalSettings.php i inseriu el codi següent. Això posarà la base de dades en mode de només lectura per a l'activitat wiki normal, sense restringir les vostres pròpies accions d'actualització. Els usuaris veuran el missatge proporcionat si intenten una edició durant el procés d'actualització:
    $adminTask = ( PHP_SAPI === 'cli' || defined( 'MEDIAWIKI_INSTALL' ) );
    $wgReadOnly = $adminTask ? false : 'Upgrading to MediaWiki 1.46.0';
  5. Executeu l'script d'actualització o l'actualitzador web al directori nou.
  6. Copieu les imatges del subdirectori d'imatges del directori antic al directori nou.
  7. Intercanvieu el directori antic i el directori nou. (Això farà que la base de dades torni a ser escrivible, perquè $wgReadOnly només estava definit al LocalSettings.php del directori antic.)

Per què actualitzar?

Subscriviu-vos a mediawiki-announce per rebre notificacions de les noves versions.

Les versions recents reben correccions de seguretat per mantenir el vostre wiki i el vostre allotjament a resguard dels vàndals, mentre que les versions antigues no (vegeu Cicle de vida de les versions ).

Les noves versions importants inclouen noves funcions que potser voldràs utilitzar: consulteu les notes de la versió per obtenir més informació.


Vegeu també

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Upgrading/ca&oldid=8330453"