Kézikönyv:Frissítés

Válassz ki egy módszert a fájlok átviteléhez:

• wget
• Biztonságos másolat SCP vagy WinSCP segítségével
• SSH File Transfer Protocol (SFTP)
• Egy FTP-kliens használatával.
• Lehet, hogy a tárhelyszolgáltató böngészőből használható fájlkezelőt biztosít.
• Más módszerekkel. Ezekről az angol Wikipédia Comparison of file transfer protocols szócikke ad áttekintést.

Olvasd el a mellékelt UPGRADE szöveges állományt.

1. Ellenőrizd a követelményeket
2. Olvasd el a RELEASE-NOTES fájlt
3. Olvasd el az UPGRADE fájlt
4. Készíts biztonsági mentést a fájlokról és az adatbázisról
5. Csomagold ki az új fájlokat
6. Frissítsd a kiterjesztéseket
7. Futtasd a frissítési szkriptet az adatbázis ellenőrzéséhez
8. Teszteld a frissítést
9. Távolítsd el a régi verzió maradványait

Figyelem:

MediaWiki from 1.32 to 1.35.4, 1.36.2, 1.37.0 contain a security issue that allow unprivileged editing of arbitrary page and arbitrary JavaScript execution. If you are using one of these versions and can not upgrade to a newer version, please see 2021-12 biztonsági kiadás/GYIK for a workaround.

Figyelem:

Do not upgrade from a MediaWiki version older than 1.33 to MediaWiki 1.39.1, or you may lose data! Upgrade to MediaWiki 1.35 first. See task T326071.

A MediaWiki 1.42 telepítéséhez szükség van az alábbiakra:

• PHP 8.1.0+
• Egy az alábbiak közül:
  • MariaDB 10.3.0+
  • MySQL 5.7.0+
  • PostgreSQL 10.0+
  • SQLite 3.8.0+

Ha PostgreSQL-t használsz, olvasd el a Manual:Upgrading Postgres oldalt.

További információkhoz látogass el a Kézikönyv:Telepítési követelmények és Kompatibilitás oldalakra.

A tarballban, illetve a Gitről letöltött/exportált állományok között több nagybetűs nevű fájlt találsz; ezek egyike a RELEASE-NOTES (wiki). Most van itt az idő a változások áttekintésére. Olvasd el az UPGRADE fájlban szereplő útmutatót is.

Teljesítménybeli okok miatt a feladatütemező által kezelt egyes adatbázis-műveletek késleltetve vannak. Ezek a feladatok az adatbázisban tárolódnak és a műveletek végrehajtását szabályozó paramétereket tartalmaznak. Mivel a paraméterek formátuma változhat a verziók között, a hibák elkerülése érdekében ajánlott ezeket a frissítés előtt futtatni. A függőben lévő feladatok futtatásához és a feladatlista kiürítéséhez a frissítés előtt futtasd a runJobs.php -t.

Részletes útmutató: Kézikönyv:Biztonsági mentés

Ugyan a frissítőszkriptek jól karbantartottak és stabilak, előfordulhatnak hibák. Az adatbázisséma frissítése előtt készíts biztonsági mentést az adatbázisról és a fájlokról is:

• MySQL, both SQL dump and XML dump are for use with the mysql command:

mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql
mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml

• PostgreSQL, database dump for use with pg_restore command:

pg_dump --create -Fc wikidb > file.db.dump

• SQLite, you use a MediaWiki script for making a backup:

php wikifolder/maintenance/sqlite.php --backup-to file

Ha nem rendelkezel parancssoros hozzáféréssel, töltsd le a MediaWikit és használd a 7zip programot a számítógépeden való kicsomagoláshoz.

A kicsomagolás után kedvenc FTP-klienseddel töltsd fel a fájlokat a szerverre.

A cPanelt számos tárhelyszolgáltató használja. Ez a módszer hatékony, mert a kicsomagolás a szerveren történik.

• Lépj be a wikit tartalmazó könyvtárba.
• Töltsd fel a mediawiki-1.xx.x.tar.gz fájlt. Lehet, hogy frissítened kell az oldalt ahhoz, hogy megjelenjen a feltöltött fájl.
• Csomagold ki a mediawiki-1.xx.x.tar.gz fájlt. Frissítsd az oldalt.
• Győződj meg róla, hogy a mediawiki-1.xx.x könyvtár létezik.
• Töröld a tar.gz fájlt.
• Copy all necessary skins, extensions, image folders, customizations, and the LocalSettings.php into the new folder. (Lásd alább.)
• 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.

You may need to run the command as sudo if you don't have full write permissions to the wiki install directories under your current user. When untarring a tarball package normally a new directory for the new wiki version will be created and you will have to copy the old configuration files and images directory from your old installation directory:

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

Az (Open)Solaris felhasználóinak a gtar-t vagy az alábbi parancsot kell használniuk:

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

• LocalSettings.php - contains your old configuration settings.

Then add to LocalSettings.php e.g. $wgLogo = "$wgScriptPath/images/logo.png";

Once done, make this new folder the published folder on the web server, or rename the old installation directory and then rename the new one to match the old name. Change ownership and group of everything so the web server has access to the files.

You will also need to install some external PHP libraries using Composer or a provided collection maintained for the Wikimedia wiki farm. More details on installing and updating external libraries can be found in the Git download documentation.

A small patch file is usually made available for a minor version upgrade. You'll need to download patch to use this. Manually download and extract the patch file from the dumps site or follow the directions with wget below. Patches are incremental, you can not skip a version.

Ha a régi verziót írtad felül, egyes régi állományok az új verzióban problémákat okozhatnak.

If you want a lot of extensions then downloading from Git is probably best. If you don't have Git but you want to upgrade a lot of extensions, you might consider using mwExtUpgrader.

<span id="Adapt_your_LocalSettings.php">

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

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";

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

Extensions are being adapted to use the new extension registration system. Extensions that are not adapted should use the old way of installing them. Refer to the installation instructions on the extension's page for more information.

Older versions of MediaWiki automatically generated a line in LocalSettings.php calling DefaultSettings.php . As of Version 1.38, this line is deprecated and does not work with many extensions. It needs to be removed.

Delete the following line:

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

If you are upgrading to 1.40 or above, Extension:RenameUser has been merged into core. If present, this line must be deleted from LocalSettings.php or the update will fail.

wfLoadExtension( 'Renameuser' );

Néhány változó elavulttá válhat vagy eltávolíthatjuk. Meglétük a LocalSettings.php-ben általában semmire nincs hatással. Az újabb verziókban újabb változókat vezethetünk be, vagy a korábbiak típusát megváltoztathatjuk. Általában próbálunk észszerű alapértelmezett értékeket használni, és változtatások esetén biztosítani a visszafelé való kompatibilitást. A változtatások ellenőrzéséhez mindig olvasd el a kiadási megjegyzéseket!

Az adatbázist két módon frissítheted: a parancssorból vagy böngészőből. Ha rendelkezel SSH-hozzáféréssel, akkor az előbbit ajánljuk, mivel így elkerülhető az időtúllépés vagy a kapcsolat bontása.

A szkript jelezni fogja, ha a szoftver PHP-függőségei elavultak.

$ php maintenance/run.php update.php

$ php maintenance/update.php

On a Linux server if you get an error, try performing the same command as root (by using the sudo command). Note for simple installations on Windows (e.g. with XAMPP ): First make sure that your web server (such as Apache) and your database (such as MySQL) are running. Then run update.php: right-click it, select Open With, and browse to PHP.exe. The resulting command prompt window will likely autoclose when the schema upgrade completes.

See Manual:Common errors and symptoms#MediaWiki requires PHP 7.4.3 or higher; you are using PHP 7.3.17

Ezt a hibás kiterjesztések és felületek okozhatják.

• Ellenőrizd, hogy a LocalSettings.php-ben rögzített kiterjesztések és felületek léteznek-e
• Ellenőrizd, hogy a kiterjesztések helyesen vannak telepítve (wfLoadExtension vagy require_once)
• A LocalSettings.php-ben kommenteld ki a kiterjesztések első felét. Ha ilyenkor az update.php működik, próbáld meg ennek a félnek a felét (azaz az összes kiterjesztés negyedét) kikommentelni. Ha a update.php továbbra sem működik, próbáld meg az első helyett a második felét kikommentelni, és így tovább. Egészen addig próbálkozz, amíg az update.php le nem fut.

Esetenként a szkript az alábbihoz hasonló hibával leállhat:

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

Ilyenkor győződj meg, hogy a gyökérkönyvtárban található LocalSettings.php -ben a $wgDBadminuser és $wgDBadminpassword változókat helyesen állítottad be: ezek az adatbázis eléréséhez szükséges felhasználónevet és jelszót tartalmazzák.

Egyes esetekben a régi $wgDBmwschema változó (Postgres esetén) olvasódik be táblanévként a $wgDBname helyett, még MySQL használatakor is. Ilyenkor a LocalSettings.php-ből töröld a $wgDBmwschema változót.

Esetenként az alábbi hibával találkozhatsz:

Cannot get command line arguments, register_argc_argv is set to false

1. Lépj be a ~/maintenance könyvtárba, ahol nyisd meg a php.ini állományt vagy hozd létre
2. Add hozzá a következő sort:

register_argc_argv=true

1. Futtasd a php update.php parancsot

Lásd még: update.php

For example, if your wiki is at http://example.org/w/index.php, then navigate to http://example.org/w/mw-config/index.php.

Figyelem:

If you use this method, make sure to change the name of the .htaccess file back after running the upgrade script! Otherwise, short URLs and possibly other stuff will be broken!

If you have copied your previous installation to another folder on the server, be sure to remove it or make it completely inaccessible from the web. It is very important to not leave old installations accessible from the web, since it completely defeats the purpose of upgrading, and leaves your server open to attacks.

Minor upgrades, within the same major version, say from 1.41.0 to 1.41.4, 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 updater script.

Attól függ: a MediaWiki 1.4 vagy régebbi verzióról való frissítéskor először az 1.5 verziót kell telepítened. Ha Latin-1 karakterkészletű wikit frissítesz, az 1.5-ben található upgrade1_5.php-val az adatbázist UTF-8-formátumúra kell alakítanod (ehhez a LocalSettings.php -ben a $wgUseLatin1 változót True értékre kell állítani). Ezután futtasd az update.php-t, majd a LocalSettings.php $wgLegacyEncoding változójában állítsd be a korábbi karakterkódolást (például windows-1252). Egykor a Wikipédia és más Wikimédia-wikik 1.4-ről 1.5-re való frissítése is így történt – lásd a kapcsolódó megjegyzéseket a Wikitechen. Az upgrade1.5 szkript futtatása előtt szükséges lehet a MediaWiki 1.4-re történő frissítés. Ha a Latin-1 karakterkészletet használó wikidről adatbázisdumpot (például MySQL) szeretnél készíteni, a $text tábla old_text mezőjét a karakterkódolási hibák elkerülése érdekében mediumtext helyett mediumblob értékre kell állítani!

A MediaWiki 1.5 és újabb 1.35-re való frissítése egy lépésben is elvégezhető. A tapasztalatok alapján az egylépcsős frissítés működik. Ha nem hiszed el, olvasd el ezt a listabejegyzést. Vedd figyelembe, hogy ilyenkor nagyobb eséllyel találkozhatsz PHP-hibákkal, mint az eggyel magasabb verziószámú kiadásra való frissítéskor. Ezek a hibák az egyenkénti frissítéskor is előjöttek volna, csak mindegyik a megfelelő verziónál. Ha frissítéskor kihagysz verziókat, az összes hibával egyszerre fogsz találkozni. Ez a verzióváltást nehezebbé teszi, de gondolj rá, hogy cserébe nem kell a kihagyott verziókra való frissítéssel foglalkoznod!

A MediaWiki 1.36 vagy későbbi verzióra frissítéskor a verzióváltás csak maximum a kettővel korábbi LTS kiadásról lehetséges (phab:T259771). Ez azt jelenti, hogy az igazán régi verziókról először az 1.35-re, majd arról az 1.36-ra kell váltanod.

Röviden: igen.

Hosszabban: attól függ, hogy a) mennyire fontosak az adataid, b) mennyire nehéz biztonsági mentést létrehoznod és c) mennyire vagy tapasztalt a MySQL-lel kapcsolatban.

A frissítés közbeni hibák miatt az adatbázis két verzió közötti, használhatatlan állapotba kerülhet. A frissítéskor bekövetkező PHP- vagy MySQL-hiba esetén az adatbázis részben frissített állapotba kerülhet. Ilyenkor lehetséges, hogy sok kézi munkával még menthető a helyzet. Azonban jóval egyszerűbb visszaállítani egy korábbi mentést a frissítőszkript futtatása előtti állapotból. Ellenkező esetben több órányi – felesleges – munkát adhatsz magadnak.

A helyreállítás gyakran bonyolult. A fórumok önkéntesei általában nem fognak örülni, ha hiányzó biztonsági mentés mellett kérsz tanácsot a frissítéssel kapcsolatos helyreállításhoz. Jobb, ha vissza tudod állítani a korábbi verziót, majd a megfelelő helyen jelzed a hibát.

<span id="Can_I_keep_my_LocalSettings.php?">

Igen, de szükség lehet kisebb módosításokra. A LocalSettings.php formátuma nagyrészt visszafelé kompatibilis. A LocalSettings.php-ban problémát okozó módosítások a kiadási megjegyzések „konfigurációs változtatások” szakaszában olvashatóak.

Általában igen, azonban ha Giten keresztül frissítesz, a wiki néhány másodpercre elérhetetlenné válhat.

Ha csak alverziók között frissítesz, elég a forrásfájlok cseréje.

Megjegyzés: az alábbiak feltételezik, hogy rendelkezel parancssori hozzáféréssel. Főverziók közötti váltáskor az alábbi lépéseket kövesd:

1. Csomagold ki az új verziót egy új könyvtárba
2. Készítsd elő a könyvtárat: másold át a meglévő LocalSettings.php-t, valamint a telepített kiterjesztéseket és egyedi felületeket (ha vannak ilyenek). Ellenőrizd a LocalSettings.php $wgLogo és $wgLogos változóit, majd szükség esetén másold át a logót az új könyvtárba.
3. A kiadási megjegyzésekben ellenőrizd, hogy módosítanod kell-e a LocalSettings.php-t.
4. A régi verzió könyvtárában illeszd be a LocalSettings.php-be az alábbi kódot. Ezzel az adatbázis a szerkesztésekkel szemben írásvédett lesz, azonban te elvégezheted a frissítést. A felhasználók a megadott üzenetet fogják látni, ha szerkeszteni próbálnak:
   
   $adminTask = ( PHP_SAPI === 'cli' || defined( 'MEDIAWIKI_INSTALL' ) );
   $wgReadOnly = $adminTask ? false : 'Upgrading to MediaWiki 1.42.3';
5. Az új könyvtárban futtasd a frissítőszkriptet vagy a webes telepítőt.
6. Másold át a képeket az új könyvtár megfelelő alkönyvtárába.
7. Cseréld meg a régi és új könyvtárat. (Ezzel a wiki újra szerkeszthető lesz, mivel a $wgReadOnly változó csak a régi könyvtár LocalSettings.php fájljában volt bekapcsolva.)

Iratkozz fel a mediawiki-announce levelezőlistára az új verziókkal kapcsolatos hírekért.

Az újabb kiadások a wikit és a tárhelyszolgáltatót a vandáloktól védő biztonsági frissítéseket kapnak, a régiek viszont nem (lásd: Verziók életciklusa ).

A főverziók hasznos újdonságokat tartalmaznak: részletekért lásd a kiadási megjegyzéseket.

• Greg Sabino Mullane blogposztja a verziófrissítésekről
• Súgó és támogatás – ha segítségre van szükséged vagy problémába ütköztél
• Kategória:Elavult MediaWiki-funkciók
• Kézikönyv:Biztonsági mentés
• Manual:Restoring a wiki from backup
• Manual:Moving a wiki
• Manual:Restoring wiki code from cached HTML - ha nincs működő biztonsági mentésed
• Manual:A MediaWiki telepítése