MediaWiki/Update: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
 
(352 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
Alle Updates sollten zeitnah installiert werden!
'''MediaWiki/Aktualisierung''' - Update und Upgrade


= Backup =
== Beschreibung ==
== SQL Datenbank Dump ==
; Update vs. Upgrade


mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql
=== Neue Version ===
; Mailingliste abonnieren
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki-Ankündigungen]


= Download =
=== Kompatibilität ===
* Braking changes beachten/testen


https://www.mediawiki.org/wiki/Download
== Vorbereitung ==
; Konfiguration auslesen
<syntaxhighlight lang="bash" highlight="1" line copy>
grep '$wgDB' mediawiki/LocalSettings.php
</syntaxhighlight>


  $ wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.tar.gz
Beispiel
<syntaxhighlight lang="bash" highlight="" line>
  $wgDBtype = "mysql";
$wgDBserver = "127.0.0.1";
$wgDBname = wgDBname;
$wgDBuser = wgDBuser;
$wgDBpassword = wgDBpassword;
…
</syntaxhighlight>


= Entpacken =
; Variablen setzen
== Archiv entpacken ==
Beispiele
$ tar -xzf mediawiki-1.35.1.tar.gz
{| class="table table-striped table-hover col1bold"
|-
| Datenbankname ||
<syntaxhighlight lang="bash" highlight="0" copy>
export wgDBname="wgDBname"
</syntaxhighlight>
|-
| Datenbankbenutzer ||
<syntaxhighlight lang="bash" highlight="0" copy>
export wgDBuser="wgDBuser"
</syntaxhighlight>
|-
| Passwort ||
<syntaxhighlight lang="bash" highlight="0" copy>
export wgDBpassword="wgDBpassword"
</syntaxhighlight>
|-
| Neue Version ||
<syntaxhighlight lang="bash" highlight="" copy>
export NewWikiVersion="mediawiki-1.46.2"
</syntaxhighlight>
|}


= Zugriffsrechte anpassen =
<!--
# chown -R web7.client3 mediawiki-1.35.1
<syntaxhighlight lang="bash" highlight="1" line copy>
export wgDBpassword="wgDBpassword"
</syntaxhighlight>
-->


= Daten von alter Installation übertragen =
== Datensicherung ==
LocalSettings.php
{{:MediaWiki/Datensicherung}}
$ cp -ai mediawiki-1.35.0/LocalSettings.php mediawiki-1.35.1/


Images
== Durchführung ==
$ cp -ai mediawiki-1.35.0/images/ mediawiki-1.35.1/
=== Vorbereitung ===
; Verzeichnis-Strukur
<syntaxhighlight lang="wikitext"" highlight="1">
webhome
├── backup
└── mediawiki
</syntaxhighlight>


Extensions
; Eigene Version ermitteln
$ cp -au mediawiki-1.35.0/extensions/ mediawiki-1.35.1/
* [[Spezial:Version]]


resources/assets/
; Download
$ cp -aiu mediawiki-1.35.0/resources/assets/ mediawiki-1.35.1/resources/
'''https://www.mediawiki.org/wiki/Download'''


= Deine LocalSettings.php anpassen =
Beispiel
<syntaxhighlight lang="bash" highlight="1" line copy>
wget https://releases.wikimedia.org/mediawiki/1.46/mediawiki-1.46.2.tar.gz
</syntaxhighlight>


If you use the same <tt>LocalSettings.php</tt> from the old version, you may need to adapt it to how new versions handle it:
=== Archiv entpacken ===
<syntaxhighlight lang="bash" highlight="1" line copy>
tar -xf $NewWikiVersion.tar.gz
</syntaxhighlight>


=== Andere Variablen ===
=== Daten übertragen ===
<syntaxhighlight lang="bash" highlight="1-6" line copy>
cp -au \
mediawiki/images/ \
mediawiki/skins/ \
mediawiki/extensions/ \
mediawiki/LocalSettings.php \
$NewWikiVersion/
</syntaxhighlight>


Einige Variablen könnten obsolet geworden oder gar entfernt worden sein. Diese in <tt>LocalSettings.php</tt> zu haben wird für gewöhnlich keinen Effekt haben. Neue Variablen können in neueren Versionen hinzugefügt worden sein, oder einige existierende Variablen ihren Typ geändert haben. We usually try to use sane defaults for them, and in case of type change, be backwards compatible. In any case, take a look at the release notes to see those changes.
<syntaxhighlight lang="bash" highlight="1" copy>
cp -au mediawiki/resources/assets/ $NewWikiVersion/resources/
</syntaxhighlight>


= Extensions-Updates =
=== Konfiguration anpassen ===
; [https://www.mediawiki.org/wiki/Special:MyLanguage/MediaWiki_1.46 Versionshinweise] auf Änderungen prüfen
{| class="table table-striped table-hover col1bold col1nowrap"
|-
! Änderung !! Beschreibung
|-
| Entfallene Variablen || Keine Wirkung mehr, müssen ggf. angepasst werden
|-
| Neue Variablen || Müssen ggf. ergänzt werden
|-
| Änderung des Variablen-Typs || Datentyp einer Variable kann sich geändert haben, Es wird versucht, vernünftige Standardwerte zu verwenden, und im Falle einer Typänderung abwärtskompatibel zu sein
|}


Certain extensions have been updated in order to work with the new version of MediaWiki. Be sure to upgrade to the latest versions of such extensions. You might need to perform manual updates to custom extensions.  
=== Einstiegspunkt ändern ===
<syntaxhighlight lang="bash" highlight="1" line copy>
mv mediawiki mediawiki.old ; mv $NewWikiVersion mediawiki
</syntaxhighlight>


Different [https://www.mediawiki.org/wiki/Special:MyLanguage/tarballs tarballs] include some subsets of extensions and have versioning which helps you upgrade choosing the right one for your MediaWiki core release.
=== Update-Skript ===
* Abhängigkeiten auflösen
* Datenbank aktualisieren


[https://www.mediawiki.org/wiki/Special:ExtensionDistributor Extension Distributor] works well for most people who want a snapshot of extensions that will work with their supported versions of MediaWiki.  
<syntaxhighlight lang="bash" highlight="1" line copy>
php8.5 mediawiki/maintenance/update.php --force
</syntaxhighlight>


If you want a lot of extensions then [https://www.mediawiki.org/wiki/Special:MyLanguage/Download_from_Git 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 [https://www.mediawiki.org/wiki/MwExtUpgrader mwExtUpgrader].
; Alternativ
Aktualisierung per Webbrowser
* https://wiki.foxtom.de/mw-config/index.php


= Aktualisierungsskript =
{{:MediaWiki/Extension/Update}}


Sie können die MediaWiki-Datenbank auf zwei Arten aktualisieren: Entweder von der Kommandozeile oder vom Webbrowser aus. Wenn Sie Shell-Zugang zu Ihrem Server haben, wird ein Upgrade von der Kommandozeile aus empfohlen, da dies das Risiko verringert, dass der Upgrade-Prozess durch einen Timeout oder einen Verbindungsreset unterbrochen wird.
<noinclude>


Das Skript wird auch versuchen jede fehlende Abhängigkeit herunterzuladen, welche MediaWiki benötigt.  
== Anhang ==
=== Siehe auch ===
=== Dokumentation ===
# [https://www.mediawiki.org/wiki/Project:Support_desk Project:Support desk] if you need help or something went wrong
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Kategorie:/MediaWiki_deprecated_or_obsolete_features Kategorie/MediaWiki deprecated or obsolete features]
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Backing_up_a_wiki Anleitung:Backup eines Wikis]
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Restoring_a_wiki_from_backup Manual:Restoring a wiki from backup]
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Moving_a_wiki Manual:Moving a wiki]
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Restoring_wiki_code_from_cached_HTML Manual:Restoring wiki code from cached HTML] - wenn du kein erfolgreiches Backup hast
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Installing Manual:Installing]


$ sudo -u web7 php update.php
=== Links ===
==== Weblinks ====
# Greg Sabino Mullane's Blog post provides some [https://blog.endpoint.com/2014/10/mediawiki-minor-upgrade-with-patches.html more detail about point release upgrades].  


== Siehe auch ==
[[Kategorie:MediaWiki/Verwaltung]]


* Greg Sabino Mullane's Blog post provides some [http://blog.endpoint.com/2014/10/mediawiki-minor-upgrade-with-patches.html more detail about point release upgrades].
</noinclude>
* [https://www.mediawiki.org/wiki/Project:Support_desk Project:Support desk] if you need help or something went wrong
 
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Category:MediaWiki_deprecated_or_obsolete_features Category:MediaWiki deprecated or obsolete features]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Backing_up_a_wiki Anleitung:Backup eines Wikis]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Restoring_a_wiki_from_backup Manual:Restoring a wiki from backup]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Moving_a_wiki Manual:Moving a wiki]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Restoring_wiki_code_from_cached_HTML Manual:Restoring wiki code from cached HTML] - wenn du kein erfolgreiches Backup hast
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Installing Manual:Installing]
 
[[Category:Wiki]]

Aktuelle Version vom 20. Oktober 2026, 10:43 Uhr

MediaWiki/Aktualisierung - Update und Upgrade

Beschreibung

Update vs. Upgrade

Neue Version

Mailingliste abonnieren

Kompatibilität

  • Braking changes beachten/testen

Vorbereitung

Konfiguration auslesen
grep '$wgDB' mediawiki/LocalSettings.php

Beispiel

 $wgDBtype = "mysql";
 $wgDBserver = "127.0.0.1";
 $wgDBname = wgDBname;
 $wgDBuser = wgDBuser;
 $wgDBpassword = wgDBpassword;
 …
Variablen setzen

Beispiele

Datenbankname
export wgDBname="wgDBname"
Datenbankbenutzer
export wgDBuser="wgDBuser"
Passwort
export wgDBpassword="wgDBpassword"
Neue Version
export NewWikiVersion="mediawiki-1.46.2"


Datensicherung

MediaWiki/Datensicherung - Backup von Dateien und Datenbank

Beschreibung

Fehler beim Update können die Installation unbrauchbar machen

Datenbank

mysqldump --user=$wgDBuser --password $wgDBpassword | gzip > ../backup/"$wgDBname"_$(date -I).sql.gz

Dateisystem

tar -czvf ../backup/mediawiki_$(date -I).tar.gz mediawiki/


Durchführung

Vorbereitung

Verzeichnis-Strukur
webhome
├── backup
└── mediawiki
Eigene Version ermitteln
Download

https://www.mediawiki.org/wiki/Download

Beispiel

wget https://releases.wikimedia.org/mediawiki/1.46/mediawiki-1.46.2.tar.gz

Archiv entpacken

tar -xf $NewWikiVersion.tar.gz

Daten übertragen

cp -au \
mediawiki/images/ \
mediawiki/skins/ \
mediawiki/extensions/ \
mediawiki/LocalSettings.php \
$NewWikiVersion/
cp -au mediawiki/resources/assets/ $NewWikiVersion/resources/

Konfiguration anpassen

Versionshinweise auf Änderungen prüfen
Änderung Beschreibung
Entfallene Variablen Keine Wirkung mehr, müssen ggf. angepasst werden
Neue Variablen Müssen ggf. ergänzt werden
Änderung des Variablen-Typs Datentyp einer Variable kann sich geändert haben, Es wird versucht, vernünftige Standardwerte zu verwenden, und im Falle einer Typänderung abwärtskompatibel zu sein

Einstiegspunkt ändern

mv mediawiki mediawiki.old ; mv $NewWikiVersion mediawiki

Update-Skript

  • Abhängigkeiten auflösen
  • Datenbank aktualisieren
php8.5 mediawiki/maintenance/update.php --force
Alternativ

Aktualisierung per Webbrowser

Erweiterungen aktualisieren

  • Kompatibilität mit neuen Versionen von MediaWiki
  • Fehler beheben
  • Sicherheitsprobleme lösen
  • Neue Funktionen ermöglichen

mwExtUpgrader

Erweiterungen mit mwExtUpgrader aktualisieren

Beispiel
php8.2 mwExtUpgrader.phar
Note that this release of code is not stable. Do not use for production.
Welcome to use mwExtUpgrader. This script can help you bulk upgrade MediaWiki extensions.
Continue with this action? (y/n) y
Please type the absolute path to the MediaWiki directory: /var/www/wiki.foxtom.de/wiki/mediawiki
mwExtUpgrader detected your MediaWiki version is 1.43.0
Confirm version to be upgraded (default: 1.43)
 [0] 1.39
 [1] 1.42
 [2] 1.43
 >
ExtensionDistributor unsupported PdfBook
PageOwnership unsupported REL1_43
SubpageNavigation unsupported REL1_43
ExtensionDistributor unsupported DownloadBook
CodeEditor successfully upgraded
MultimediaViewer successfully upgraded
Renameuser successfully upgraded
Cite successfully upgraded
[...]

Manuell aktualisieren

Möglicherweise müssen eigene Erweiterungen manuell aktualisiert werden



Anhang

Siehe auch

Dokumentation

  1. Project:Support desk if you need help or something went wrong
  2. Kategorie/MediaWiki deprecated or obsolete features
  3. Anleitung:Backup eines Wikis
  4. Manual:Restoring a wiki from backup
  5. Manual:Moving a wiki
  6. Manual:Restoring wiki code from cached HTML - wenn du kein erfolgreiches Backup hast
  7. Manual:Installing
  1. Greg Sabino Mullane's Blog post provides some more detail about point release upgrades.