Zum Inhalt springen

MediaWiki/Aktualisierung: Unterschied zwischen den Versionen

Aus Foxwiki
Keine Bearbeitungszusammenfassung
 
(320 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
Alle Updates sollten zeitnah installiert werden!
'''MediaWiki/Aktualisierung''' - Update und Upgrade


= Konfiguration ermitteln =
== Beschreibung ==
$ grep '$wgDB' mediawiki-1.35.1/LocalSettings.php
; Update vs. Upgrade
 
=== Neue Version ===
; Mailingliste abonnieren
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce Mailingliste MediaWiki-Ankündigungen]
 
; Neuerungen in MediaWiki 1.44
* [https://www.pro.wiki/news/whats-new-in-mediawiki-1-44 Highlights from MediaWiki 1.44]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/MediaWiki_1.44 Release notes]
* [https://www.mediawiki.org/wiki/Heading_HTML_changes Heading HTML changes]
 
=== Kompatibilität ===
; Braking changes
 
 
{{:MediaWiki/Datensicherung}}
 
== Durchführung ==
=== Vorbereitung ===
; Verzeichnis-Strukur
<syntaxhighlight lang="wikitext"" highlight="1">
webhome
├── backup
└── mediawiki
</syntaxhighlight>
 
; Eigene Version ermitteln
* [[Spezial:Version]]
 
; Download
* https://www.mediawiki.org/wiki/Download
 
Beispiel
<syntaxhighlight lang="bash" highlight="1" line copy>
wget https://releases.wikimedia.org/mediawiki/1.44/mediawiki-1.44.0.tar.gz
</syntaxhighlight>
 
==== Konfiguration ====
; Auslesen
<syntaxhighlight lang="bash" highlight="1" line copy>
grep '$wgDB' mediawiki/LocalSettings.php
</syntaxhighlight>
 
Beispiel
<syntaxhighlight lang="bash" highlight="" line>
  $wgDBtype = "mysql";
  $wgDBtype = "mysql";
  $wgDBserver = "127.0.0.1";
  $wgDBserver = "127.0.0.1";
  $wgDBuser = "wgDBuser";
  $wgDBname = wgDBname;
  $wgDBname = "wgDBname";
  $wgDBuser = wgDBuser;
  $wgDBpassword = "wgDBpassword";
  $wgDBpassword = wgDBpassword;
  $wgDBprefix = "";
  $wgDBprefix = "";
  $wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
  $wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
</syntaxhighlight>
; Variablen setzen
Datenbankname
<syntaxhighlight lang="bash" highlight="1" line copy>
export wgDBname="wgDBname"
</syntaxhighlight>


= Backup =
Datenbankbenutzer
== SQL Database Dump ==
<syntaxhighlight lang="bash" highlight="1" line copy>
$ mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql
export wgDBuser="wgDBuser"
</syntaxhighlight>


== Filesystem structure ==
$ tar -czf backup/wiki_2020-04-12.tar.gz wiki/


= Download =
Neue Version
* https://www.mediawiki.org/wiki/Download
<syntaxhighlight lang="bash" highlight="1" line copy>
$ wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.2.tar.gz
export NewWikiVersion=mediawiki-1.44.0
</syntaxhighlight>


= Entpacken =
<!--
== Archiv entpacken ==
<syntaxhighlight lang="bash" highlight="1" line copy>
$ tar -xzf mediawiki-1.35.2.tar.gz
export wgDBpassword="wgDBpassword"
</syntaxhighlight>
-->
=== Archiv entpacken ===
<syntaxhighlight lang="bash" highlight="1" line copy>
tar -xf $NewWikiVersion.tar.gz
</syntaxhighlight>


= Zugriffsrechte anpassen =
=== Daten übertragen ===
# chown -R user.group mediawiki-1.35.2
<syntaxhighlight lang="bash" highlight="1-6" line copy>
cp -au \
mediawiki/images/ \
mediawiki/skins/ \
mediawiki/extensions/ \
mediawiki/LocalSettings.php \
$NewWikiVersion/
</syntaxhighlight>


= Daten von alter Installation übertragen =
<syntaxhighlight lang="bash" highlight="1" line copy>
== LocalSettings.php ==
cp -au mediawiki/resources/assets/ $NewWikiVersion/resources/
$ cp -ai mediawiki-1.35.0/LocalSettings.php mediawiki-1.35.2/
</syntaxhighlight>


== Images ==
=== Konfiguration anpassen ===
$ cp -ai mediawiki-1.35.0/images/ mediawiki-1.35.2/
; [https://www.mediawiki.org/wiki/Special:MyLanguage/MediaWiki_1.44 Versionshinweise] auf Änderungen prüfen
{| class="wikitable options big"
|-
! Ä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
|}


== Extensions ==
=== Einstiegspunkt ändern ===
$ cp -au mediawiki-1.35.0/extensions/ mediawiki-1.35.2/
<syntaxhighlight lang="bash" highlight="1" line copy>
mv mediawiki mediawiki.old ; mv $NewWikiVersion mediawiki
</syntaxhighlight>


== resources/assets/ ==
=== Update-Skript ===
$ cp -aiu mediawiki-1.35.0/resources/assets/ mediawiki-1.35.2/resources/
* Abhängigkeiten auflösen
* Datenbank aktualisieren


= LocalSettings.php anpassen =
<syntaxhighlight lang="bash" highlight="1" line copy>
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.
php8.2 mediawiki/maintenance/update.php --force
</syntaxhighlight>


=== Veränderte Variablen ===
; Alternativ
* Einige Variablen könnten obsolet geworden oder gar entfernt worden sein.
Aktualisierung per Webbrowser
* Diese in <tt>LocalSettings.php</tt> zu haben wird für gewöhnlich keinen Effekt haben.  
* https://wiki.foxtom.de/mw-config/index.php
* 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.


= Extensions-Updates =
{{:MediaWiki/Extension/Update}}
* 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.
* 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 =
<noinclude>
* 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.
* Das Skript wird auch versuchen jede fehlende Abhängigkeit herunterzuladen, welche MediaWiki benötigt.
$ sudo -u web7 php update.php


= Links =
== Anhang ==
== Interne Links ==
=== Siehe auch ===
TODO
=== Dokumentation ===
== Weblinks ==
# 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].
# [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 80: Zeile 142:
# [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]]
 
</noinclude>

Aktuelle Version vom 15. Juli 2025, 12:23 Uhr

MediaWiki/Aktualisierung - Update und Upgrade

Beschreibung

Update vs. Upgrade

Neue Version

Mailingliste abonnieren
Neuerungen in MediaWiki 1.44

Kompatibilität

Braking changes


MediaWiki/Datensicherung

Fehler bei der Extension-Installation können das Wiki unbrauchbar machen

  • daher MUSS zuvor eine Datensicherung durchgeführt werden

Datenbank

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

Dateisystem

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


Durchführung

Vorbereitung

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

Beispiel

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

Konfiguration

Auslesen
grep '$wgDB' mediawiki/LocalSettings.php

Beispiel

 $wgDBtype = "mysql";
 $wgDBserver = "127.0.0.1";
 $wgDBname = wgDBname;
 $wgDBuser = wgDBuser;
 $wgDBpassword = wgDBpassword;
 $wgDBprefix = "";
 $wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
Variablen setzen

Datenbankname

export wgDBname="wgDBname"

Datenbankbenutzer

export wgDBuser="wgDBuser"


Neue Version

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

Erweiterungen aktuell halten!
  • 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

Links

Weblinks

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