Zum Inhalt springen

MediaWiki/Aktualisierung: Unterschied zwischen den Versionen

Aus Foxwiki
K Dirkwagner verschob die Seite MediaWiki/Update nach MediaWiki/Aktualisierung
 
(287 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
Alle Updates sollten zeitnah installiert werden!
'''MediaWiki/Update''' - Software-Aktualisierung


= Konfiguration ermitteln =
== Beschreibung ==
$ grep '$wgDB' mediawiki-1.35.1/LocalSettings.php
; Mailingliste abonnieren
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce Mailingliste MediaWiki-Ankündigungen]


= Backup =
; Neuerungen in MediaWiki 1.44
== SQL Database Dump ==
* [https://www.pro.wiki/news/whats-new-in-mediawiki-1-44 Highlights from MediaWiki 1.44]
$ mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql
* [https://www.mediawiki.org/wiki/Special:MyLanguage/MediaWiki_1.44 Release notes]
* [https://www.mediawiki.org/wiki/Heading_HTML_changes Heading HTML changes]


== Filesystem structure ==
== Vorbereitung ==
$ tar -czf backup/wiki_2020-04-12.tar.gz wiki/
; Version ermitteln
* [[Spezial:Version]]


= Download =
; Download
* https://www.mediawiki.org/wiki/Download
* https://www.mediawiki.org/wiki/Download
$ wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.2.tar.gz


= Entpacken =
Beispiel
== Archiv entpacken ==
<syntaxhighlight lang="bash" highlight="1" line copy>
$ tar -xzf mediawiki-1.35.2.tar.gz
wget https://releases.wikimedia.org/mediawiki/1.44/mediawiki-1.44.0.tar.gz
</syntaxhighlight>


= Zugriffsrechte anpassen =
== Datensicherung ==
  # chown -R user.group mediawiki-1.35.2
==== Konfiguration auslesen ====
<syntaxhighlight lang="bash" highlight="1" line copy>
grep '$wgDB' mediawiki/LocalSettings.php
  $wgDBtype = "mysql";
$wgDBserver = "127.0.0.1";
$wgDBname = wgDBname;
$wgDBuser = wgDBuser;
$wgDBpassword = wgDBpassword;
$wgDBprefix = "";
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
</syntaxhighlight>


= Daten von alter Installation übertragen =
<syntaxhighlight lang="bash" highlight="1-3" line copy>
== LocalSettings.php ==
export wgDBname="wgDBname"
$ cp -ai mediawiki-1.35.0/LocalSettings.php mediawiki-1.35.2/
export wgDBuser="wgDBuser"
export wgDBpassword="wgDBpassword"
</syntaxhighlight>


== Images ==
==== Datenbank ====
$ cp -ai mediawiki-1.35.0/images/ mediawiki-1.35.2/
<syntaxhighlight lang="bash" highlight="1" line copy>
mysqldump --user=$wgDBuser --password $wgDBname | gzip > ../backup/$wgDBname_$(date -I).sql.gz
</syntaxhighlight>


== Extensions ==
==== Dateisystem ====
$ cp -au mediawiki-1.35.0/extensions/ mediawiki-1.35.2/
<syntaxhighlight lang="bash" highlight="1" line copy>
tar -czf ../backup/wiki_$(date -I).tar.gz mediawiki/
</syntaxhighlight>


== resources/assets/ ==
== Durchführung ==
$ cp -aiu mediawiki-1.35.0/resources/assets/ mediawiki-1.35.2/resources/
Neue Version in Variable speichern
<syntaxhighlight lang="bash" highlight="1" line copy>
export NewWikiVersion=mediawiki-1.44.0
</syntaxhighlight>


= LocalSettings.php anpassen =
=== Archiv entpacken ===
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.
<syntaxhighlight lang="bash" highlight="1" line copy>
tar -xf $NewWikiVersion.tar.gz
</syntaxhighlight>


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


= Extensions-Updates =
<syntaxhighlight lang="bash" highlight="1" line copy>
* Certain extensions have been updated in order to work with the new version of MediaWiki.
cp -au mediawiki/resources/assets/ $NewWikiVersion/resources/
* Be sure to upgrade to the latest versions of such extensions.
</syntaxhighlight>
* You might need to perform manual updates to custom extensions.
* 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.
* [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.
* 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].


= Aktualisierungsskript =
=== Konfiguration anpassen ===
* Sie können die MediaWiki-Datenbank auf zwei Arten aktualisieren: Entweder von der Kommandozeile oder vom Webbrowser aus.  
[https://www.mediawiki.org/wiki/Special:MyLanguage/MediaWiki_1.44 Versionshinweise] auf Änderungen prüfen
* 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.  
{| class="wikitable options big"
* Das Skript wird auch versuchen jede fehlende Abhängigkeit herunterzuladen, welche MediaWiki benötigt.
|-
$ sudo -u web7 php update.php
! Ä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
|}


= Links =
=== Einstiegspunkt ändern ===
== Interne Links ==
<syntaxhighlight lang="bash" highlight="1" line copy>
TODO
mv mediawiki mediawiki.old ; mv $NewWikiVersion mediawiki
== Weblinks ==
</syntaxhighlight>
# 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].  
 
=== Update-Skript ===
* Abhängigkeiten auflösen
* Datenbank aktualisieren
 
<syntaxhighlight lang="bash" highlight="1" line copy>
php8.2 mediawiki/maintenance/update.php --force
</syntaxhighlight>
 
; Alternativ
Aktualisierung per Webbrowser
* https://wiki.foxtom.de/mw-config/index.php
 
=== Erweiterungen aktualisieren ===
* Manche Erweiterungen wurden aktualisiert, um mit der neuen Version von MediaWiki zu funktionieren
* Stellen Sie sicher, dass Sie auf die neuesten Versionen dieser Erweiterungen aktualisieren
 
==== mwExtUpgrader ====
Erweiterungen mit [https://www.mediawiki.org/wiki/MwExtUpgrader mwExtUpgrader] aktualisieren
 
; Beispiel
<syntaxhighlight lang="bash" highlight="1,4,5,12-15" line copy>
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
[...]
 
</syntaxhighlight>
 
==== Manuell aktualisieren ====
Möglicherweise müssen eigene Erweiterungen manuell aktualisiert werden
* Verschiedene [https://www.mediawiki.org/wiki/Special:MyLanguage/tarballs tarballs] enthalten einige Untergruppen von Erweiterungen und haben eine Versionierung, die Ihnen hilft, die richtige für Ihre MediaWiki-Kernversion zu wählen.  
* [https://www.mediawiki.org/wiki/Special:ExtensionDistributor Extension Distributor] funktioniert gut für die meisten Leute, die einen Schnappschuss von Erweiterungen wollen, die mit ihren unterstützten Versionen von MediaWiki funktionieren werden.
* Wenn Sie viele Erweiterungen aktualisieren wollen, ist [https://www.mediawiki.org/wiki/Special:MyLanguage/Download_from_Git downloading from Git] wahrscheinlich am besten.  
 
<noinclude>
 
== 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/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/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: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:Restoring_a_wiki_from_backup Manual:Restoring a wiki from backup]  
Zeile 73: Zeile 157:
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Installing Manual:Installing]
# [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Installing Manual:Installing]


[[Category:Wiki]]
=== 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].
 
[[Kategorie:MediaWiki/Verwaltung]]
[[Kategorie:MediaWiki/Extension]]
</noinclude>

Aktuelle Version vom 13. Juli 2025, 10:30 Uhr

MediaWiki/Update - Software-Aktualisierung

Beschreibung

Mailingliste abonnieren
Neuerungen in MediaWiki 1.44

Vorbereitung

Version ermitteln
Download

Beispiel

wget https://releases.wikimedia.org/mediawiki/1.44/mediawiki-1.44.0.tar.gz

Datensicherung

Konfiguration auslesen

grep '$wgDB' mediawiki/LocalSettings.php
 $wgDBtype = "mysql";
 $wgDBserver = "127.0.0.1";
 $wgDBname = wgDBname;
 $wgDBuser = wgDBuser;
 $wgDBpassword = wgDBpassword;
 $wgDBprefix = "";
 $wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
export wgDBname="wgDBname"
export wgDBuser="wgDBuser"
export wgDBpassword="wgDBpassword"

Datenbank

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

Dateisystem

tar -czf ../backup/wiki_$(date -I).tar.gz mediawiki/

Durchführung

Neue Version in Variable speichern

export NewWikiVersion=mediawiki-1.44.0

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.2 mediawiki/maintenance/update.php --force
Alternativ

Aktualisierung per Webbrowser

Erweiterungen aktualisieren

  • Manche Erweiterungen wurden aktualisiert, um mit der neuen Version von MediaWiki zu funktionieren
  • Stellen Sie sicher, dass Sie auf die neuesten Versionen dieser Erweiterungen aktualisieren

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

  • Verschiedene tarballs enthalten einige Untergruppen von Erweiterungen und haben eine Versionierung, die Ihnen hilft, die richtige für Ihre MediaWiki-Kernversion zu wählen.
  • Extension Distributor funktioniert gut für die meisten Leute, die einen Schnappschuss von Erweiterungen wollen, die mit ihren unterstützten Versionen von MediaWiki funktionieren werden.
  • Wenn Sie viele Erweiterungen aktualisieren wollen, ist downloading from Git wahrscheinlich am besten.


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

Links

Weblinks

  1. Greg Sabino Mullane's Blog post provides some more detail about point release upgrades.