Manual:Upgrading to 1.6/de



Nachdem eine gewisse Zeit des Fluchen, Schwitzen, Kodieren und Zanken vergangen ist, hat MediaWiki 1.6 die stabile Freigabe erhalten. Sie haben hoffentlich die Zeit auf die optimale Art und Weise verbracht und haben die neuen Eigenschaften erforscht. Für das Update wurde diese nützliche Benutzeranweisung erstellt. Der Prozeß dauert im Durchschnitt weniger als 10 Minuten.

Hinweis: Dieses Benutzeranweisung wurde mit der grundlegenden Annahme geschrieben, das Sie von einer bestehenden MediaWiki 1.5 auf MediaWiki 1.6 updaten wollen. Wenn nicht, so sollten Sie vorher nach anderen Dokumenten in diesem Wiki suchen, die Ihnen weiter helfen können.

Übersicht
Zuerst, lesen Sie die UPGRADE-Datei, welche in der Installation von der MediaWiki Version 1.6 enthalten ist.

So wie bei allem MediaWiki-Updates sind die grundlegenden Voraussetzungen immer dieselben:


 * 1) Überprüfen Sie die Anforderungen
 * 2) Lesen Sie die Versionshinweise
 * 3) Machen Sie ein Backup der Datenbank und der Dateien
 * 4) Entpacken Sie die neuen Dateien
 * 5) Starten Sie das Updateskript zur Überprüfung der Datenbank
 * 6) Aktualisieren Sie die Erweiterungen
 * 7) Testen Sie die neue Version

Überprüfung der Anforderungen
MediaWiki 1.6 benötigt:


 * PHP 4.3.2 oder höher
 * Ältere Versionen werden nicht mehr funktionieren


 * MySQL 4.0 oder höher
 * Die Unterstützung für MySQL 3.x wurde schon mit der Version 1.6 aufgegeben

Lesen der Versionshinweise
Innerhalb der tar-Distribution oder innerhalb der Dateien die unter Subversion stehen, gibt es eine vielzahl von großgeschriebenen Dateien, ein davon enthält  die Versionshinweise. Jetzt ist es an der Zeit, diese zu öffnen und herauszufinden, was in 1.6 verändert wurde.

Backup der bestehenden Dateien und der Datenbank
Die Updatesripte sind gut und robust sind, aber es kann immer etwas schief gehen. Bevor Sie also fortfahren, machen Sie bitte ein aktuelle vollständige Datenbanksicherung des Wiki, einschließlich der Datenbankdateien und die Programmdateien.

Datenbank
Machen Sie ein vollständiges Backup der Datenbank in dem das Wiki enthalten ist, bevor Sie die Updatescripte starten. Dieses dient dazu, falls es zu einem Ausfall des Scriptupdates kommt den alten Zustand wieder herzustellen. Hierfür gibt es eine Vielzahl von Utilities was dies kann, eines davon ist MySQL dump, welches als Unterstützung von der MySQL-Ssoftware mitgeliefert ist. Für wenig geübte, finden Sie weiteres sehr gutes PHP-Tool unter http://www.mysqldumper.de.

Einstellungen
Machen Sie eine Kopie der LocalSettings.php Datei, welches die Einstellungen enthält, die für die Anpassung Ihrer MediaWiki-Installation verantwortlich ist.

Hochgeladene Dateien
Wenn das Hochladen in Ihrem Wiki aktiviert worden ist, dann benötigen Sie auch eine Sicherung des gesammten Upload-Verzeichnisses. iIm Standardfall heißt dies Verzeichnis images, genaueres finden Sie hierzu in Ihrer LocalSettings.php Datei.

Erweiterungen und Benutzeransichten (Skins)
Machen Sie eine Kopie des extensions Verzeichnisses, und falls Sie die Benutzeransichten angepasst haben, auch diese Dateien.

Entpacken Sie die neuen Dateien
Holen Sie sich das tarball-Paket, welches Sie sich von SourceForge downloaden können und entpacken Sie es; wenn sie die Subversion benutzen, exportieren sie datei ein leeres Verzeichnis. Ersetzen Sie alle bestehenden Dateien der MediaWiki 1.5 Installation durch die neue MediaWiki Version 1.6, behalten Sie dabei die Verzeichnisstruktur bei. Nun ist der Sourcecode aktuell.

Starten Sie das Updatesript
Hinweis: Erzeugen Sie aus der AdminSettings.sample eine Datei mit Namen AdminSettings.php im Hauptverzeichnis Ihres Wiki, und aktuallisieren Sie die Informationen in der Datei. Der Benutzer in der Datei benötigt einen vollständigen Zugriff auf die Datenbank (Der Hauptbenutzer für die Datenbankverbindung des Wiki's hat im Normalfall dies nicht).

Die bevorzugte Methode zum Durchführen des Updates wird die Kommandozeile benutzt, jedoch ist es auch möglich, einen webbasierten Shellzugang zu benutzten.

Kommandozeile
Von der Kommandozeile, oder einer SSH Shell doer ähnliches, wechseln Sie in das Verzeichnis maintenance</tt> und führen folgendes Script aus:

$ php update.php

MediaWiki wird Ihre bestehende Installation überprüfen und dies an den neuen Sourcecode anpassen, hiezu wird das Script Tabellen und Spalten hinzufügen. Nach Abschluß dies Scriptes muss noch das Script refreshLinks.php</tt> zusätzlich durchgeführt werden: Dies sorgt für ein Update der Tabelleninhalte.

Alternativ: phpShell
Wenn Sie keinen direkten Kommandozeilenzugriff haben, dann gibt es noch die Option über phpShell, welches eine Kommandozeile für PHP Funktionen simuliert. Dieses wird nich auf allen Webhostings funktionieren.

Wenn man solch eine Lösung verwendet, ist es häufig wünschenswert, die Countdownperiode am Anfang des Scriptes zu überspringen. Hierzu benötigen Sie die Option --quick</tt> als Parameter für das Script, welches man so aufruft:

$ php update.php --quick

Erneute Installation
Eine weitere Alternative ist, das Script durch eine erneute Installation über das Webinterface auszuführen. Dies geht so:


 * 1) Umbenennung der Datei LocalSettings.php</tt> nach LocalSettings.php.old</tt>
 * 2) Verändern Sie das Verzeichnis config</tt> so, das es von Webserver beschreibbar (755 oder 777) ist
 * 3) Rufen Sie die Indexseite des Wiki auf, um die Installation zu starten

Füllen Sie die Felder mit den selben Werten, wie bei der ersten Installation. Wenn der Installationsprozess startet, dann überprüft das Script die bestehenden Tabellen und passt Sie auf die neue Version an. Wenn die Installation vollständig ist, so wird eine neue LocalSettings.php</tt> erzeugt.


 * 1) Löschen Sie die Konfigurationsdatei
 * 2) Benennen Sie die gesicherte LocalSettings.php.old</tt> zurück nach LocalSettings.php</tt>
 * 3) Stellen den Zugriffschutz für das Verzeichnis config</tt> wieder her

Testen der neuen Version
Wenn Sie mit dem Update fertig sind, browsen Sie durch Ihr Wiki und überprüfen Sie die Basisfunktionen wie Anzeigen, Bearbeiten, Erzeugen und Löschen. Besuchen Sie Special:Version und überprüfen Sie, ob die korrekte Version angezeigt wird.