Zum Inhalt springen

MediaWiki/Aktualisierung: Unterschied zwischen den Versionen

Aus Foxwiki
Die 5 zuletzt angesehenen Seiten:  more » touch » .bash_aliases/Beispiel » MediaWiki/Aktualisierung
Keine Bearbeitungszusammenfassung
 
(252 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
= Umgebung =
'''MediaWiki/Aktualisierung''' - Update und Upgrade
mediawiki -> mediawiki-1.36.1/
mediawiki-1.36.1


= Vorbereitung =
== Beschreibung ==
export NewWikiVersion = mediawiki-1.36.2
; Update vs. Upgrade


== Download ==
=== Neue Version ===
Aktuelle Version [https://www.mediawiki.org/wiki/Download herunterladen]
; Mailingliste abonnieren
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce Mailingliste MediaWiki-Ankündigungen]


$ '''wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.37.2.tar.gz'''
; 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]


== Konfiguration ermitteln ==
=== Kompatibilität ===
$ '''grep '$wgDB' PRODUCTIVE/LocalSettings.php'''
; Braking changes
$wgDBserver = '''"$wgDBserver"''';
$wgDBuser = '''"wgDBuser"''';
$wgDBname = '''"wgDBname"''';
$wgDBpassword = '''"wgDBpassword"''';


== Datensicherung ==
=== Datenbank ===
$ '''mysqldump --user=''$wgDBuser'' --password=''$wgDBpassword'' ''$wgDBname'' > ../backup/''$wgDBname''_$(date -I).sql'''


=== Dateisystem ===
{{:MediaWiki/Datensicherung}}
$ '''tar -czf backup/wiki_$(date -I).tar.gz wiki/'''


= Archiv entpacken =
== Durchführung ==
$ '''tar -xf $NewWikiVersion.tar.gz'''
=== Vorbereitung ===
; Verzeichnis-Strukur
<syntaxhighlight lang="wikitext"" highlight="1">
webhome
├── backup
└── mediawiki
</syntaxhighlight>


= Daten übertragen =
; Eigene Version ermitteln
cp -auv mediawiki/images/ $NewWikiVersion
* [[Spezial:Version]]
cp -auv mediawiki/skins/ $NewWikiVersion
cp -auv mediawiki/extensions/ $NewWikiVersion
cp -auv mediawiki/resources/assets/ $NewWikiVersion/resources/
cp -auv mediawiki/LocalSettings.php $NewWikiVersion/


= Konfiguration anpassen =
; Download
Wird die gleiche <tt>LocalSettings.php</tt> wie in der alten Version muss diese eventuell angepasst werden, um mit der neuen Version kompatibel zu sein. In any case, take a look at the release notes to see those changes.
* https://www.mediawiki.org/wiki/Download
* Variablen könnten obsolet geworden oder entfernt worden sein.
** Diese haben in der <tt>LocalSettings.php</tt> gewöhnlich keinen Effekt.
* Neue Variablen können in neueren Versionen hinzugefügt worden sein, oder 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.


= Extensions-Updates =
Beispiel
* Certain extensions have been updated to work with the new version of MediaWiki.
<syntaxhighlight lang="bash" highlight="1" line copy>
* Be sure to upgrade to the latest versions of such extensions.
wget https://releases.wikimedia.org/mediawiki/1.44/mediawiki-1.44.0.tar.gz
* You might need to perform manual updates to custom extensions.
</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.  
* [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 many 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 many extensions, you might consider using [https://www.mediawiki.org/wiki/MwExtUpgrader mwExtUpgrader].


= Aktualisierungsskript =
==== Konfiguration ====
Nach dem Ersetzen der Programmdateien muss noch die Datenbank aktualisiert werden. Dabei werden auch fehlende Abhängigkeit aufgelöst.
; Auslesen
$ php7.4 mediawiki/maintenance/update.php --force
<syntaxhighlight lang="bash" highlight="1" line copy>
grep '$wgDB' mediawiki/LocalSettings.php
</syntaxhighlight>


Beispiel
<syntaxhighlight lang="bash" highlight="" line>
$wgDBtype = "mysql";
$wgDBserver = "127.0.0.1";
$wgDBname = wgDBname;
$wgDBuser = wgDBuser;
$wgDBpassword = wgDBpassword;
$wgDBprefix = "";
$wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=binary";
</syntaxhighlight>


Die Aktualisierung kann auch per Webbrowser durchgeführt werden
; Variablen setzen
https://wiki.foxtom.de/mw-config/index.php
Datenbankname
<syntaxhighlight lang="bash" highlight="1" line copy>
export wgDBname="wgDBname"
</syntaxhighlight>


= Links =
Datenbankbenutzer
== Interne Links ==
<syntaxhighlight lang="bash" highlight="1" line copy>
TODO
export wgDBuser="wgDBuser"
== 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].  
 
 
Neue Version
<syntaxhighlight lang="bash" highlight="1" line copy>
export NewWikiVersion=mediawiki-1.44.0
</syntaxhighlight>
 
<!--
<syntaxhighlight lang="bash" highlight="1" line copy>
export wgDBpassword="wgDBpassword"
</syntaxhighlight>
-->
=== Archiv entpacken ===
<syntaxhighlight lang="bash" highlight="1" line copy>
tar -xf $NewWikiVersion.tar.gz
</syntaxhighlight>
 
=== Daten übertragen ===
<syntaxhighlight lang="bash" highlight="1-6" line copy>
cp -au \
mediawiki/images/ \
mediawiki/skins/ \
mediawiki/extensions/ \
mediawiki/LocalSettings.php \
$NewWikiVersion/
</syntaxhighlight>
 
<syntaxhighlight lang="bash" highlight="1" line copy>
cp -au mediawiki/resources/assets/ $NewWikiVersion/resources/
</syntaxhighlight>
 
=== Konfiguration anpassen ===
; [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
|}
 
=== Einstiegspunkt ändern ===
<syntaxhighlight lang="bash" highlight="1" line copy>
mv mediawiki mediawiki.old ; mv $NewWikiVersion mediawiki
</syntaxhighlight>
 
=== 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
 
{{:MediaWiki/Extension/Update}}
 
<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 72: 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:Verwaltung]]
=== 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.