Manual:Upgrading/nl



Basisoverzicht


Bestandoverdracht
Kies een methode om de bestanden op te halen:


 * wget
 * Beveiligde kopie van SCP of WinSCP
 * SSH File Transfer Protocol (SFTP)
 * Een FTP-client gebruiken.
 * Het hosting bedrijf kan een bestandsbeheer interface aanbieden via de webbrowser; vraag het na bij uw provider.
 * Een andere methode. Er is een lijst op transfer protocollen

Voorafgaand
Lees.


 * 1) Controleer de vereisten
 * 2) Lees het bestand RELEASE-NOTES
 * 3) Lees het bestand UPGRADE
 * 4) Maak een reservekopie van alle bestanden en de database.
 * 5) Pak de nieuwe bestanden uit
 * 6) Upgrade extensies
 * 7) Run het update-script om de database te controleren
 * 8) Test de update
 * 9) Resten van oude installaties verwijderen



Controleer vereisten
MediaWiki vereist:


 * PHP +
 * Een van de volgende:
 * MariaDB +
 * MySQL +
 * PostgreSQL +
 * SQLite +

Sinds versie 1.36, MediaWiki ondersteunt alleen upgrades van de laatste twee major LTS-releases (T259771). Upgrades van oudere versies zullen in meerdere stappen gedaan moeten worden. Als u naar 1.36 wilt upgraden en u heeft 1.23 of ouder, dan moet u eerst upgraden van 1.23 wiki naar 1.27 (of 1.35), daarna naar 1.27 (of 1.35) en daarna naar 1.36.

Wanneer u PostgreSQL gebruikt, lees alstublieft ook.

Voor meer informatie, lees alstublieft de en.



Lees de release notes
In de tarball distributie of in de bestanden opgehaald uit Git, zitten een aantal bestanden met bestandsnamen in hoofdletters, een daarvan bevat de  (wiki). Nu is het tijd op dat bestand te openen om te kijken wat er in deze release is gewijzigd. Lees ook de instructies in het bestand UPGRADE.



Lopende jobs wissen
Vanwege de performance worden acties in de database soms uitgesteld, dit word tin een job queue (wachtrij) beheert. Deze jobs worden opgeslagen in de database en bevatten parameters met informatie over de acties die uitgevoerd moeten worden. Wij bevelen aan dat u deze nog uit te voeren jobs nu uitvoert voordat u de wiki gaat upgraden, dit om te voorkomen dat de parameterinformatie van een job in de nieuwe versie anders is. Gebruik op al deze pending jobs uit te voeren en de wachtrij te legen voor het doen van de upgrade.



Een reservekopie maken van bestaande bestanden en de database

 * Volledige instructies: 

Hoewel de scripts om te upgraden robuust en goed onderhouden zijn, kan er natuurlijk altijd iets mis gaan. Maak daarom voor een upgrade van de database altijd een complete backup van de wiki, dus zowel de database als de bestanden:


 * De inhoud van de wiki, van de database, (zorg dat de character set goed is aangegeven, controleer eerst LocalSettings.php). Misschien is het een goed idee om een XML-dump aan te maken als aanvulling op de SQL-database dump.
 * MySQL, de SQL-dump en de XML-dump voor gebruik met het  commando:

mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
 * PostgreSQL, database dump voor gebruik met het  commando:

pg_dump --create -Fc wikidb > file.db.dump
 * SQLite, u gebruikt een MediaWiki-script voor het maken van een back-up:

php wikifolder/maintenance/sqlite.php --backup-to file
 * afbeeldingen en andere media-bestanden (de inhoud van de map , aangepast logo /skins/common/images/wiki.png)
 * configuratie-bestanden, bijv.  en   (indien aanwezig)
 * MediaWiki's programma bestanden, inclusief alle skins en extensies, zeker als u ze heeft gewijzigd.



De nieuwe bestanden uitpakken


Een tarball package gebruiken
U kunt de nieuwe bestanden plaatsen met behulp van FTP of de commando-regel. (Als u daar toegang tot heeft.) Met de commando-regel gaat het het snelst, want het zijn duizenden bestanden die anders met FTP geladen moeten worden.



FTP of grafisch
Als u de commando-regel op uw server niet kunt benaderen, download dan de MediaWiki tarball naar uw eigen computer en gebruik 7zip om daar de tarball uit te pakken.

Na het lokaal uitpakken van de bestanden, gebruik uw favoriete FTP programma om het up te loaden naar de server.



cPanel Bestandsbeheer
cPanel is een populaire interface die door veel webhosts ter beschikking wordt gesteld. Deze methode is efficiënt omdat de bestanden op de server worden uitgepakt.


 * Ga naar de map waar uw wiki map staat.
 * Upload het bestand mediawiki-1.xx.x.tar.gz. Mogelijk moet het even verversen om het bestand te zien.
 * Pak het bestand mediawiki-1.xx.x.tar.gz uit. Opnieuw laden.
 * Controleer of de map mediawiki-1.xx.x aanwezig is.
 * Verwijder het bestand tar.gz.
 * Kopieer alle benodigde skins, extensies, mappen met afbeeldingen, aanpassingen en de LocalSettings.php in de nieuwe map. (Zie onder.)
 * Als u klaar bent om update.php uit voeren, hernoem dan uw oude en nieuwe wiki mappen. (bijv: "w" wordt "w1.34" en dan "mediawiki1.35.0" wordt "w".) Zo kunt u, met de source, eenvoudig terug bij problemen.



Opdrachtprompt
Mogelijk moet u het commando als  uitvoeren als u niet volledige schrijfrechten heeft op de wiki installatie mappen. Bij het uitpakken van een tarball package wordt er normaal gesproken een nieuwe map voor de nieuw wiki versie aangemaakt en dient u oude configuratie-bestanden en mappen met afbeeldingen uit uw oude installatie map over te zetten:

(Open)Solaris gebruikers moeten gtar gebruiken, of:

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



Andere bestanden
Na het uitpakken van de tarball, dient u enkele mappen en bestanden uit de oude installatie te kopiëren of te verplaatsen naar de nieuwe installatie:
 * - bevat uw oude configuratie-instellingen.
 * De map  (in oudere versies  ), deze map bevat alle in de wiki geüploade bestanden, tenzij u hiervoor een andere map heeft ingesteld, wijzig de eigenaar en de rechten.   en   (bijvoorbeeld als u web-user apache is).
 * Enkele extensies in de map . U dient altijd bijgewerkte extensies te krijgen; er is geen garantie dat oudere versies van extensies werken op de nieuwere versie van MediaWiki.
 * Als u een eigen logo gebruikt, dan moet dit bestand ook worden teruggezet uit de oude installatie. Voor versie 1.24 staat het logo meestal in  . Daarna meestal in   of , degene wat u besloten heeft. Voeg het toe aan LocalSettings.php bijv.
 * Voor 1.35 moet u mogelijk de logo's terugzetten uit . Voeg dan aan LocalSettings.php bijv.
 * Aangepaste skins vanuit de map.
 * Alle aanpassingen gedaan aan de oude installatie-bestanden of extensies.
 * Elk htaccess bestand (als u Apache gebruikt en in dat bestand regels heeft aangemaakt).

Als u klaar bent, maak dan deze nieuwe map de gepubliceerde map op de webserver, of wijzig de namen van de oude en nieuwe installatie mappen zo dat de nieuwe map de oorspronkelijke naam van de oude map heeft.



Met Git
Bij gebruik van, exporteer de bestanden naar een lege locatie en kopieer de oude aangepaste bestanden naar de nieuwe locatie zoals in het vorige gedeelte is aangegeven.

U dient ook enkele externe PHP libraries te installeren met Composer of een door een wiki-farm aangeleverde verzameling. Meer details over het installeren en updaten van externe libraries staat in de Git download documentatie.



Een patch gebruiken
Als het een beperkte upgrade (minor version) is, dan is er meestal een bestand beschikbaar voor deze 'patch'. U kunt dit bestand gebruiken. Download patch. Pak het patchbestand uit na het downloaden van de dumps site of volg de onderstaande aanwijzingen met wget. Patches zijn aanvullingen, u kunt geen  versie overslaan.


 * 1) cd naar de MediaWiki hoofdmap (de map met  LocalSettings.php).
 * 2) Download het patch-bestand en gunzip het.
 * 3) Gebruik   om te controleren wat de wijzigingen zijn (bijv.,  )
 * 4) Als het klopt, voer patch nog een keer uit, maar dan zonder.
 * 5) Controleer uw Special:Version en u moet het nieuwe versie-nummer zien staan.



Overblijvende bestanden die foutmeldingen kunnen veroorzaken
Als u het uitpakken over de oude versie heen doet, dan kunnen enkele oude bestanden problemen veroorzaken in de nieuwe versie.

Als u geen profiling gebruikt, maar een bestand  in de MediaWiki root map heeft staan, dan kunt u foutmeldingen krijgen met referenties naar. Het verwijderen of hernoemen van het bestand  lost deze fout op. Het bestand, ook in de root, kan als een sjabloon dienen als u in de toekomst toch profiling wilt inschakelen.

In MediaWiki 1.23 wordt het automatisch bepalen van de skin ontraden voor de kern bestanden. Na het upgraden naar deze versie, dient u er voor te zorgen dat de oude bestanden,  ,   en   direct in de map   staan als ook dat de bijbehorende submappen in de map   worden verwijderd. MediaWiki zal hiervoor waarschuwen als de gegevens er nog staan. (Pas ook de aangepaste skins aan om aan een gelijksoortige conventie te voldoen.) Details:.

MediaWiki 1.24 wijzigt de paden van de kern skin bestanden. Na het upgraden moet u ervoor zorgen dat de oude bestanden,  ,   en   die in de map   zelf staan, worden verwijderd. Details:.



Extensies bijwerken
Er zijn extensies aangepast om met deze nieuwe versie van de MediaWiki te kunnen werken. Zorg ervoor dat u de meest recente versie van deze extensies gebruikt. Mogelijk moet u daarvoor handmatige wijzigingen aanbrengen op aangepaste extensies.

Verschillende tarballs bevatten subsets van extensies en hebben een versie-aanduiding die u helpt te kiezen welke versie tarball u nodig heeft bij uw eigen versie van de MediaWiki.

Extension Distributor werkt goed als u een een snapshot wil van de extensies die zullen werken met de versies van de MediaWiki die zij ondersteunen.

Als u veel extensies wilt downloaden dan kan dat vast het best via Git. Als u geen Git heeft maar wel veel extensies wilt upgraden, overweeg dan om mwExtUpgrader te gebruiken.

<span id="Adapt_your_LocalSettings.php">

LocalSettings.php bijwerken
Indien dezelfde  van de oude versie wordt gebruikt, kan het zijn dat deze bijgewerkt moet worden aan hoe nieuwe versies er mee omgaan:

<span id="Skin_registration">

Skin registratie
Vanaf MediaWiki 1.24 zijn gebundelde skins als Vector, Monobook, Modern en CologneBlue niet langer deel van de kern van MediaWiki, ze moeten geregistreerd worden in  om ze te kunnen gebruiken, andere meldt MediaWiki dat u geen geïnstalleerde skin bezit.

Voeg daarom dit toe aan  bij het upgraden van versies ouder dan 1.24 als u een van die genoemde skins beschikbaar wilt hebben:

Andere skins kunnen nog niet aan het nieuwe skin registratie systeem zijn toegevoegd, lees de documentatie pagina van elk skin om te zien hoe u het moet registeren in het geval u een probleem heeft met het gebruik van die skin.

<span id="Extension_registration">

Extensie registratie
Sinds MediaWiki 1.25 gebruiken extensies het extensie registratie systeem.

Daarom zal uw  iets bevatten als:

Dit kan worden gewijzigd naar:

Extensies worden aangepast om het nieuwe extensie registratie systeem te gebruiken. Extensies die niet aangepast zijn, moeten de oude manier van installeren volgen. Lees de installatie instructies op de pagina van de extensie voor meer informatie.

<span id="Other_variables">

Andere variabelen
Sommige variabele kunnen overbodig of verwijderd worden. Ze in  laten staan heeft gewoonlijk geen effect. Nieuwe variabelen kunnen toegevoegd worden in nieuwere versies, of bestaande variabelen kunnen een ander type krijgen. Wij proberen om dezelfde standaarden voor ze te gebruiken, in geval van het wijzigen van het type proberen we compatibel te zijn met de oude versie. Wij bekijken in ieder geval de notities over de release om de wijzigingen te zien.

<span id="Run_the_update_script">

Het updatescript uitvoeren
U kunt de MediaWiki database op twee manieren upgraden: Of met de commando-regel of via de webbrowser. Als u toegang heeft tot de shell op uw server, dan bevelen wij upgraden vans de commando-regel aan, hierdoor wordt het onderbreken van de upgrade door een time-out of een verbindingsprobleem voorkomen.

Het script zal ook proberen een eventueel ontbrekende afhankelijkheid te downloaden.

<span id="Command_line">

Opdrachtprompt
Benader de commando-regel van uw server via de SSH shell of iets soortgelijks. Als u op een lokale PC onder Microsoft Windows werkt, dan heeft u een tool als PuTTY nodig om SSH te gebruiken. Op de commando-regel of de shell, wijzig de map  en voer het update script uit:

$ php update.php

Als u op een Linux server een fout krijgt, probeer dan hetzelfde commando als root ( sudo php update.php ). Notitie voor eenvoudige installaties op Windows (bijv. ): Controleer eerst of uw webserver (bijv. Apache) en uw database-server (bijv. MySQL) uitgevoerd worden. Voer daarna  uit: rechtsklikken, kies openen met en blader naar PHP.exe. Het scherm van de commando-regel kan automatisch gesloten worden na het afronden van de upgrade.

U kunt een melding krijgen dat uw PHP-versie te oud is en dat er voor de MediaWiki een recentere verse nodig is. Na die melding wordt de upgrade afgebroken. De commando-regel kan een andere PHP-versie gebruiken dat degene die u heeft bij het uitvoeren van MediaWiki op de webserver. Als u deze melding krijgt, controleer dan of u een nieuwere versie van PHP op de shell kunt uitvoeren. Of er een andere versie beschikbaar is, is afhankelijk van de configuratie van uw webserver. Als het niet werkt, vraag et uw webhoster; die weten vast een oplossing.

MediaWiki zal het bestaande schema bekijken en het het bijwerken met de nieuwe code, door o.a. tabellen en velden toe te voegen als dat nodig is.

<span id="What_to_do_if_php_update.php_fails_to_do_anything,_resulting_in_a_quick_pause_and_then_return_to_command_prompt">

Wat te doen als php update.php mislukt
Dit kan veroorzaakt worden door niet goed werkende extensie of skin.


 * Controleer of alle extensies en skins die in LocalSettings.php aangeroepen worden, aanwezig zijn
 * Controleer of de extensies de goede registratie methode gebruiken (wfLoadExtension versus require_once)
 * Zet de eerste helft van de extensies in LocalSettings.php op commentaar. Als update.php dan wel werkt, maak dan de helft van die extensies weer actief. Er staat dan dus nog een kwart op commentaar. Het idee is dus om door steeds een kleiner aantal op commentaar te hebben en te kijken of het werkt, als het opeens wel werkt dan zet u de helft van de niet weer actief gemaakte weer op commentaar. Herhaal dit totdat update.php werkt en u er maar een op commentaar heeft staan.

<span id="What_to_do_in_case_of_&quot;ALTER_command_denied_to_user&quot;_error_(or_similar)">

Wat te doen bij een fout als "ALTER command denied to user"
Als het scripts afbreekt met een melding als:

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

Dit betekent dat u moet controleren dat en  zijn gedefinieerd in het bestand   (in de hoofdmap). Dit de de gebruiker en het wachtwoord dat het script nodig heeft om de database te kunnen benaderen.

In enkele gevallen lijkt een oude variabele $wgDBmwschema (voor Postgres) de tabelnaam voor update te lezen in plaats van $wgDBname, zelfs als er MySQL wordt gebruikt. Als dat het geval is, verwijder dan de definitie van $wgDBmwschema in LocalSettings.php.

<span id="What_to_do_in_case_of_&quot;unexpected_T_STRING&quot;_error">

Wat te doen bij een fout "unexpected T_STRING"
Bij het uitvoeren van update.php op de commando-regel trad vroeger soms de volgende fout op:

<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

Deze fout trad op wanneer update.php onder php4 werd uitgevoerd.

Als uw webhost in het verleden zowel php4 als php5 aanbood, dan moest u het volgende doen:


 * 1) op de commando-regel invoeren van: 'whereis php5'
 * 2) na het aangeven van de locatie van het php5 pad, geeft het een lijst met de inhoud van de map php5/bin
 * 3) na het bepalen van de naam van de PHP executable (of PHP of php5), voer de hele padnaam in om update.php uit te voeren.

Een voorbeeld:

<pre style="overflow:auto;"> $ command -v php5 $ ls -la /usr/local/php5/bin $ /usr/local/php5/bin/php update.php

<span id="What_to_do_in_case_of_&#039;register_argc_argv_is_set_to_false&#039;_error">

Wat te doen bij een fout 'register_argc_argv is set to false'
U kunt de volgende fout krijgen: <pre style="overflow:auto;"> Cannot get command line arguments, register_argc_argv is set to false


 * 1) Ga naar ~/maintenance. Wijzig het bestaande bestand 'php.ini' of maak er een aan.
 * 2) Voeg de volgende regel toe:

<pre style="overflow:auto;"> register_argc_argv=true


 * 1) Voer   opnieuw uit

<span id="Web_browser">

Webbrowser

 * Zie ook 

Als uw database al groot is en veel gebruikt wordt, gebruik dan liever niet de updater via het web, het proces van updaten zal waarschijnlijk in een time-out eindigen als de maximum_execution_time is bereikt. In dat geval moet u update.php dus via de commando-regel uitvoeren. De grens voor groot wordt bepaald door uw webserver (bijv. performance, de drukte en wat de maximum execution time van PHP is). Als u de commando-regel niet mag gebruiken van uw webhost, kies dan maar een andere webhost voor uw wiki.


 * 1) Voer altijd een backup uit alvorens database-onderhoud te doen.
 * 2) Navigeer met uw webbrowser naar  . Als uw wiki bijvoorbeeld op   is, navigeer dan naar.
 * 3) Kies uw taal en kies doorgaan.
 * 4) De bestaande installatie moet herkend worden. Volg de instructies op het scherm om de upgrade te doen. Als er gevraagd wordt om de "upgrade key", zoek dan in uw bestand  naar de waarde van.

Het kan lijken dat de webupdater niet werkt, in plaats van het initiële scherm met de taalselectie ziet u dan een lege wiki-pagina, eventueel met een fouttekst. Waarschijnlijk gebruikt uw webserver dan Rewrite Rules (meestal voor kortere URL's), dan ziet u de updater niet op mw-config/, maar een wiki-pagina op Mw-config/, dus met een hoofdletter. Hernoem in dat geval dan het bestand .htaccess even tijdelijk tijdens de update. Probeer na het hernoemen de webupdater te starten.

<span id="Test_the_update">

De update testen
Controleer, na het upgraden, of de wiki nog werkt, test de volgende zaken:


 * Pagina's tonen
 * Pagina's bewerken
 * Bestand uploaden
 * Ga naar Special:Version en kijk of de versie de nieuwe versie is, kijk ook of de extensies aanwezig zijn.

<span id="Remove_leftovers_from_old_installations">

Resten van oude installaties verwijderen
Als u de vorige installatie in een andere map heeft gezet op de server, zorg dan dat die ouder versie weg is of niet benaderbaar via een webbrowser. Het is belangrijk om een oudere versie niet benaderbaar te hebben via het web, u voert immers niet voor niets een nieuwe versie in, ook kan uw server hierdoor aangevallen worden.

<span id="Frequently_asked_questions">

Veelgestelde vragen
<section begin=FAQ />

<span id="How_hard_is_it_to_upgrade?">

Hoe lastig is het om te upgraden?
Als het enige bestand dat u heeft gewijzigd is, en u upgrade vanaf 1.5 of later, dan is het een simpel proces van een paar minuten handmatig werk. Het wijzigen van het database-schema duurt even, afhankelijk van de grootte van de database. Dat kan uren duren voor wiki's met miljoenen pagina's, maar bij een paar duizend pagina's gaat het in een paar seconden.

Kleine upgrades, het beginnummer van de versie blijft gelijk ( .0 -> ), hebben waarschijnlijk geen schema-wijzigingen. U kunt de bestanden wijzigen.

Upgraden vanaf 1.4 of ouder is mogelijk gecompliceerd vanwege de ondersteuning voor karaktersets anders dan UTF-8 is vervallen. Daarnaast is het schema voor opslaan bulk tekst gewijzigd. Lees de betreffende sectie in het bestand.

Upgraden wordt lastig als er in uw wiki aanpassingen van de broncode zijn gedaan, en u die wijzigingen wilt behouden. Gebruik zo nodig hulpmiddelen als diff, patch, Meld en WinMerge. Er kan ook een probleem zijn als uw wiki niet meer onderhouden extensies gebruikt. Zorg dat uw extensies actueel zijn, voor en na de upgrade van MediaWiki.

Bij aanpassingen in een skin of het gebruik van een eigen skin, u dient waarschijnlijk uw wijzigingen / toevoegingen weer opnieuw aan te brengen.

<span id="How_do_I_upgrade_from_a_really_old_version?_In_one_step,_or_in_several_steps?">

Hoe doe ik een upgrade vanaf een hele oude versie? In een keer, of in stappen?
Dat hangt af op u upgrade van MediaWiki 1.4 of ouder, upgrade in dat geval eerst naar MediaWiki 1.5. Als u een Latin-1 wiki bijwerkt, gebruik dan upgrade1_5.php (staat in MediaWiki 1.5) om de teksten in de database te converteren naar UTF-8 ( moet op true staan in uw bestand ). Voer daarna update.php uit, zet de optie option in LocalSettings.php op de eerder gebruikte encoding (bijv. windows-1252). Op een vergelijkbare manier zijn o.a. Wikipedia geupgrade van MediaWiki 1.4 naar 1.5. Zie instellingenpagina voor enwiki en enkele notities op Wikitech. Mogelijk moet u eerst upgraden naar MediaWiki 1.4 voordat u het script upgrade1.5 kunt uitvoeren. Als u een dump van de database wilt maken (bijv. MySQL) van uw Latin-1 wiki, zorg dan dat het type van de  veld in de tabel  table   is, niet , anders kunt u problemen krijgen van de character encoding.

Als u upgrade vanaf MediaWiki 1.5 of nieuwer naar 1.35, dan kunt u in een stap upgraden, van uw oude versie naar de laatste stabiele versie. De rapporten en het automatische testen geven aan dat dit in een stap kan. Als u het niet gelooft, lees dan dit e-mail bericht. Echter, door versies over te slaan neemt de kans toe dat u PHP fouten krijgt, dan als u upgrade van de voorlaatste versie. Maar dan had u die foutmeldingen bij een eerdere (overgeslagen) upgrades gekregen. Door updates in een keer in te halen, verzamelt u dus ook de foutmeldingen in een keer. Het maakt de upgrade wel lastiger, wij raden af om een upgrade van een stabiele versie van MediaWiki over te slaan.

Als u upgrade naar MediaWiki 1.36 of nieuwer, worden alleen upgrades van de laatste twee LTS releases ondersteund (T259771). Dat betekent dat u bij oudere versies eerst moet upgraden naar MediaWiki 1.35 en daarna kunt upgraden naar 1.36.

<span id="Should_I_back_up_first?">

Moet ik eerst een backup maken?
In het kort: Ja.

Het lange antwoord: het hangt af van a) hoeveel uw gegevens u waard zijn, b) hoe moeilijk het is om een back-up te maken en c) hoe goed u thuis bent in MySQL onderhoud en beheer.

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.

<span id="Can_I_keep_my_LocalSettings.php?">

Kan LocalSettings.php behouden blijven?
Yes, but you may have to make some minor changes. The format of is largely backward compatible. Changes which break LocalSettings.php compatibility will be documented in the "configuration changes" section of the release notes.

<span id="Can_my_wiki_stay_online_while_it_is_upgrading?">

Kan de wiki online blijven bij het upgraden?
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:

$adminTask = ( ===  ||  ); = $adminTask ? : ;  (This will make the database writable again, because  was only set in the old directory's LocalSettings.php.)
 * 1) Unpack the new version of MediaWiki into a new directory
 * 1) Prepare that new directory: copy your current LocalSettings.php from the old directory, copy any installed extensions and custom skins (if any). Check  and  settings in LocalSettings.php and if necessary copy logo file from the old directory to the new directory.
 * 1) In the release notes for the new version, see if any changes need to be made to LocalSettings.php.
 * 1) In the old directory, edit LocalSettings.php and insert the following code. This will place the database in read-only mode for regular wiki activity, without restricting your own update actions. Users will see the message provided if they attempt an edit during the upgrade process:
 * 1) Run the update script or the web updater in the new directory.
 * 1) Copy the images from the images sub-directory from the old directory to the new directory.
 * 1) Swap the old directory and the new directory.

<span id="Why_upgrade?">

Waarom bijwerken?

 *  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:

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.
 * Sinds, wijzigingen kunnen eerst bekeken worden voor ze worden opgeslagen ook de verschillen.
 * Sinds, er is een knop ongedaan maken beschikbaar.
 * Sinds, toezicht houden via Speciale pagina's is veel eenvoudiger geworden.
 * Sinds, het hernoemen (verplaatsen) van bestanden is nu mogelijk.
 * Sinds, het automatisch verbeteren van dubbele verwijzingen.
 * Sinds, is beschikbaar.
 * 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.
 * Since and, users of all languages and genders are correctly addressed by the interface and logs (before 1.15, no gender at all).
 * In the skinning system was reworked, making it easier to reuse parts of existing skins in your own skins.
 * Since 1.20, diffs are more 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.
 * 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 , ,.
 * Sinds, MediaWiki ondersteunt meer dan 350 talen.
 * Since, MediaWiki supports "partial blocks", where IPs and accounts can be restricted from editing particular pages or namespaces.
 * Sinds, meer extensies maken deel uit de core: (voor Lua modules), ,.
 * Sinds (een LTS release), is  deel van de core. De functie "Volg" kan worden uitgebreid met vervaldatums.

Also, in 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 /> <span id="See_also">

Zie ook

 * 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
 * - als u geen back-up heeft
 * - als u geen back-up heeft
 * - als u geen back-up heeft
 * - als u geen back-up heeft
 * - als u geen back-up heeft