Zunächst sollten die Systemvoraussetzungen geprüft werden: Anforderungen für phpBB 3.1.x Wenn das phpBB 3.0.x auf einem sehr alten Server läuft kann es z.B. sein, dass ein Update der PHP Version erforderlich ist.
Beim erstmaligem Update von 3.0 auf 3.1 wird empfohlen, dass man eine der letzten 3.0-Versionen installiert hat (3.0.12, 3.0.13, 3.0.13-PL1 oder 3.0.14), wenn dein Board noch älter ist, am besten erst Updateanleitung für phpBB 3.0.x durchführen.
Ein Update einschließlich vorbereitender Maßnahmen sollten nie im laufenden Betrieb durchgeführt werden. Das Board sollte dafür deaktiviert werden (im Administrationsbereich unter Allgemein - Board-Konfiguration).
Da bei phpBB 3.1 die Modifikationen (MODs) einem Addon-System genannt "Extensions" gewichen sind, sind "3.0 MODs" unter phpBB 3.1 nicht mehr lauffähig. Dafür werden künftig Extensions installiert werden müssen: Installationsanleitung für eine Erweiterung (Extension) in phpBB 3.1
Zu manchen Modifikationen gehören Module, über die man die jeweilige Modifikation im Administrationsbereich konfigurieren kann. Diese Module müssen vor dem Update gelöscht werden. Siehe dazu auch diesen Artikel Modul Reste entfernen. Für MODs eingebaute Änderungen an phpBB Dateien müssen nicht rückgängig gemacht werden, da im Verlauf des Updates sämtliche phpBB Dateien entfernt werden. Zugehörige Datenbankänderungen müssen, abgesehen von den Modulen im Persönlichen Bereich, Moderationsbereich oder Admin-Bereich, nur in einigen Fällen entfernt werden.
Die Styles von 3.0.x sind nicht kompatibel mit 3.1.x. Deswegen müssen vor dem Update alle Styles außer prosilver im Administrationsbereich unter
Styles
gelöscht werden. Der Style prosilver darf nicht gelöscht werden.
Warnung: Das Backup der Dateien (z.B. per FTP-Client) und der Datenbank (z.B. per MySQLDumper) muss unbedingt vorher durchgeführt werden!
Hinweis: Es kann sinnvoll sein mit dem Support-Toolkit die Datenbank des phpBB 3.0.x vor dem Update zu bereinigen.
Deshalb empfehlen wird beim Update von 3.0 auf 3.1 folgendes Vorgehen:
- Backup der Datenbank und aller Forendateien (dabei beachten Binär (BINARY) != ASCII Was man bei dem Upload des Forums beachten sollte )
- alle Forendateien löschen, mit folgenden Ausnahmen:
- config.php
- files/
- images/
- store/
- phpBB 3.1 Dateien des Komplettpakets ins Forenhauptverzeichnis hochladen (dabei darauf achten, dass die config.php nicht überschrieben wird)
- danach das Datenbank-Update ausführen:
www.example.org/phpBB/install/database_update.php
- dabei muss das Update mehrfach per Klick auf einen Button fortgesetzt werden (niemals mehrfach auf den Button drücken, sondern abwarten!)
- Update nicht abbrechen
- Tab/Fenster des Datenbank-Updates nicht schließen
- Bei einem Fehlschlagen des Datenbank-Updates, muss der nächste Versuch erneut von der 3.0.x-Version durchgeführt werden!
php ./bin/phpbbcli.php db:migrate --safe-mode
ausführen. - Nach Abschluss des Updates den install Ordner vom Server löschen.
Danach können alle Extensions und Styles installiert werden.
Wichtig: MODs und Styles für phpBB 3.0 sind mit phpBB 3.1 nicht kompatibel!