phpBB 3.3: Update von phpBB 3.2.x auf phpBB 3.3.x

Beschreibung: Dieser Artikel erläutert die einzelnen Schritte eines Updates von phpBB 3.2.x. zu phpBB 3.3.x.

Kategorie: Wichtig, Installation und Update

Link zu diesem Artikel: Alles auswählen

[url=https://www.phpbb.de/kb/viewarticle?a=14&sid=2d5ef126732ae6168bbdf3e51ef2a4b8]Knowledge Base - phpBB 3.3: Update von phpBB 3.2.x auf phpBB 3.3.x[/url]

Dieser Artikel erläutert die einzelnen Schritte eines Updates von phpBB 3.2.x. zu phpBB 3.3.x.

I. Vorbemerkungen

Auch bei diesem Update gibt es mehrere Möglichkeiten, dieses durchzuführen:
  1. Die bevorzugte und empfohlene Methode => das manuelle Upgrade, auch "File Replacement Methode" genannt:
    Hierbei werden manuell alle alten Dateien der Installation (mit wenigen Ausnahmen) entfernt und durch die eines aktuellen 3.3 Komplettpaketes ersetzt.
    Das darauf von der Installationsroutine durchgeführte Datenbankupdate schließt den Upgradevorgang ab.
    Der Vorteil hierbei: es ist der einfachste und sicherste Weg zu einem 3.3 Board.
    Voraussetzung: es wurden keine manuellen Anpassungen am Kerncode vorgenommen, die erhalten bleiben müssen.
    .
  2. nicht empfohlen: Update via "automatischem Updater":
    Hierbei übernimmt die Updateroutine den kompletten Vorgang nach Hochladen des automatischen Updaterpaketes.
    Vorteil: am Kern-Code vorgenommene Anpassungen können übernommen werden
    Nachteile: abhängig von der zu wählenden Routine können dennoch Schritte verbleiben, die vom Benutzer selbst durchgeführt werden müssen und daher eine mögliche Fehlerquelle darstellen.
    Weiterhin bleibt ein Restrisiko bestehen, dass es während des Updatelaufs zu nicht aufgefangenen Fehlern oder Unregelmäßigkeiten kommen könnte, die dann zu einem nicht stabil laufenden Board führen oder zusätzliche manuelle Nacharbeit erfordern.
    Diese Methode ist daher nur für Benutzer geeignet, die über entsprechende Erfahrung bzw. Kenntnisse verfügen und Änderungen am Kerncode vorgenommen haben.
    .
  3. Upgrade über das Command Line Interface (CLI => Kommandozeile)
    Im Prinzip das gleiche Vorgehen wie beim manuellen Update, außer dass das Datenbankupdate über die Kommandozeile bzw. das Command Line Interface von phpBB 3.3 angestoßen wird.
    Voraussetzung: Konsolenzugriff auf den Server
.
Sicherheitshalber sollte die gewählte Variante an einer Kopie des Boards durchgespielt werden, um mögliche Probleme beim späteren Upgrade des Live Boards bereits im Vorfeld erkennen und ausschließen zu können.
Um eine Kopie eures Boards zu erstellen, könnt ihr die Anleitung aus Mit dem Board umziehen nutzen
Aufgrund der weiterentwickelten Codebasis kann es beim Einsatz bestimmter Extensions zu Inkompatibilitäten beim Betrieb unter einer phpBB 3.3-Version kommen. Es wird daher angeraten, noch vor dem eigentlichen Upgrade die im Board installierten Extensions auf bestehende Kompatibilität mit der neuen phpBB 3.3-Version zu prüfen und gegebenenfalls zu deaktivieren oder, falls erforderlich, komplett zu deinstallieren.
Gleiches gilt für neben prosilver vorhandene Styles.
Glossar:
a) Installationsverzeichnis (auf dem Server):
Das Verzeichnis auf dem Server, in dem sich die Ordner und Files des phpBB Paketes befinden (= das Verzeichnis, in dem auch die Konfigurationsdatei config.php liegt).
Bei Pfadangaben innerhalb dieses Artikels wird hierfür <phpbb_root> verwendet.

II. Manuelles Update

  1. Vorbereitungen:
    1. Prüfen, ob die Systemvoraussetzungen erfüllt sind: u.a. PHP minimum 7.1.3 oder höher, inklusive PHP 7.4
    2. Board in den Wartungsmodus versetzen
    3. Sofern noch nicht geschehen: vollständiges Backup von Datenbank und allen Dateien im phpBB-Installationsverzeichnis machen und lokal speichern (siehe hierzu auch: MySQL Backup)
    4. Das aktuelle deutsche Komplettpaket im Downloadbereich auf phpbb.de herunterladen und lokal entpacken
    5. In dem entpackten Archiv die dort enthaltene Datei config.php suchen und löschen (falls in Deinem Board eine modifizierte .htaccess eingesetzt ist, dann hier auch diese löschen)
    6. Falls installierte Extensions vorhanden sind => diese deaktivieren
    7. Im ACP des Boards alle Styles außer prosilver deaktivieren
    8. Falls Captchas eingesetzt wurden, die nicht zur Grundausstattung von phpBB gehören: im ACP das Captcha auf eines der Standardcaptchas zurücksetzen.
  2. Upgrade:
    1. Im Installationsverzeichnis des Boards alle Dateien/Ordner löschen außer:
      • config.php
      • .htaccess (falls modifiziert)
      • /files
      • /images
      • Optional: /ext => wenn installierte Extensions vorhanden sind
      • Optional: /styles => wenn weitere Styles neben prosilver vorhanden sind, die erhalten bleiben sollen
      • Optional: /store (hier werden u.a. übers ACP generierte Datenbank-Backups gespeichert)
    2. Den Inhalt des oben ausgepackten Ordners "phpBB3" (minus der config.php ;) ) des Komplettpakets ins Installationsverzeichnis auf dem Server hochladen.
      Noch vorhandene Dateien kannst Du dabei überschreiben lassen (deswegen ja auch vorher die config.php aus dem hochzuladenden Komplettpaket entfernen ;) )
    3. Wenn alles erfolgreich und fehlerfrei hochgeladen wurde: im Browser die Adresse des Installationsordners aufrufen => <pfad_zum_board>/install/
      (Sollte dies wider Erwarten nicht die Startseite des Updatemoduls aufrufen, dann alternativ mit <pfad_zum_board>/install/app.php erneut versuchen.)
    4. Sollte das Installationsmodul nicht in Deutsch angezeigt werden: dies kann rechts oben in der Sprachauswahl korrigiert werden.
    5. Von den Tabs links oben "Aktualisieren" anklicken
    6. Da bereits alle Dateien durch neue ersetzt wurden bekommst Du als Option nur noch "Datenbankupdate durchführen" angeboten => auswählen und bestätigen, um das DB-Update zu starten.
    7. Wenn dieser Lauf erfolgreich abgeschlossen ist: das /install Verzeichnis auf dem Server löschen oder umbenennen und Dich im ACP anmelden
    8. Die vor Upgradebeginn deaktivierten Extensions nacheinander und einzeln wieder aktivieren und jeweils ausführlich testen. Extensions, die hierbei Fehler aufzeigen, gegebenenfalls bis zur Veröffentlichung einer bereinigten oder für eure 3.3.x-Version validierten Revision deaktiviert lassen.
    9. Wartungsmodus wieder aufheben

--------------------------------------------------

III. Upgrade mittels des automatischen Updatepakets

  1. Vorbereitungen:
    1. Prüfen, ob die Systemvoraussetzungen erfüllt sind: u.a. PHP minimum 7.1.3 oder höher, inklusive PHP 7.4
    2. Board in den Wartungsmodus versetzen
    3. Sofern noch nicht geschehen: vollständiges Backup von Datenbank und allen Dateien im phpBB-Installationsverzeichnis machen und lokal speichern (siehe hierzu auch: MySQL Backup)
    4. Das aktuelle deutsche automatische Updatepaket im Downloadbereich auf phpbb.de herunterladen und lokal entpacken (es enthält drei Ordner: /docs, /install & /vendor)
    5. Falls installierte Extensions vorhanden sind => diese deaktivieren
    6. Im ACP des Boards alle Styles außer prosilver deaktivieren
    7. Falls Captchas eingesetzt wurden, die nicht zur Grundausstattung von phpBB gehören: im ACP das Captcha auf eines der Standardcaptchas zurücksetzen.
  2. Upgrade:
    1. Im Installationsverzeichnis des Boards folgende Ordner löschen:
      • /docs
        /vendor
    2. Den Inhalt des oben ausgepackten Ordners "phpBB3" des automatischen Updatepakets ins Installationsverzeichnis auf dem Server hochladen.
    3. Wenn alles erfolgreich und fehlerfrei hochgeladen wurde: im Browser die Adresse des Installationsordners aufrufen => <pfad_zum_board>/install/
      (Sollte dies wider Erwarten nicht die Startseite des Upgrademoduls aufrufen, dann alternativ mit <pfad_zum_board>/install/app.php erneut versuchen.)
    4. Falls die folgende Seite auf Englisch angezeigt werden sollte, rechts oben bei "Select language" eines der beiden deutschen Sprachoptionen wählen und "Ändern" klicken
    5. Von den Tabs links oben "Update" bzw. "Aktualisiere" anklicken => auf dieser Seite erhältst Du Informationen zu den Optionen der Dateienaktualisierung, unter denen Du später wählen kannst.
      • Manuelle Aktualisierung:
        Es wird Dir ein Archiv mit den geänderten Dateien zum Download angeboten. Dieses lädst Du auf Deinen Rechner herunter, entpackst es und lädst die darin enthaltenen Ordner/Dateien per FTP wieder ins phpBB-Installationsverzeichnis auf dem Server hoch.
      • Automatische Aktualisierung über FTP:
        Im Unterschied zur vorgenannten Methode werden hier die geänderten Daten automatisch in die Verzeichnisse der phpBB-Installation geschrieben.
        Hierzu müssen in einem späteren Schritt die FTP-Anmeldedaten angegeben werden - bitte bereithalten.
    6. Nach der automatischen Prüfung der Systemvoraussetzungen bei "Umfang des durchzuführenden Updates" die Option Die Dateien und die Datenbank aktualisieren wählen und bestätigen.
    7. In der darauffolgenden Maske "Methoden zur Dateiaktualisierung" die Optionen wie folgt setzen und absenden:
      • "Methode zur Datei-Aktualisierung" => "Geänderte Dateien in Archiv herunterladen"
      • "Archiv-Format für Download auswählen" => ".zip"
    8. Im darauf folgenden Lauf erfolgt ein Vergleich der vorhandenen 3.2.x Dateien mit den Dateien der zu installierenden Version 3.3.x
      Das Ergebnis dieser Prüfung wird in drei Abschnitte gegliedert angezeigt:
      • "Zu löschende Dateien":
        Diese Aufstellung umfasst alle Dateien der alten Installation, die in der neuen Version nicht mehr vorhanden sind und daher entfernt werden müssen.
      • "Geänderte Dateien":
        Hier werden alle Dateien geführt, die aufgrund manueller Codeänderungen nicht mehr mit den original 3.2.x Dateien identisch sind und daher nicht im Zuge des Updates durch neue der Version 3.3.x ersetzt werden können.
        Der automatische Updater versucht, die vorgenommenen Änderungen mit dem neuen Code zusammen zu führen.
      • "Neu hinzuzufügende Dateien":
        Liste aller neu mit diesem Release hinzugekommenen Dateien
      • "Nicht geänderte Dateien":
        Lister aller Dateien, die unverändert übernommen werden können und daher erhalten bleiben
    9. Nach Bestätigen werden die Dateien aktualisiert und ein Archiv mit den durch das Updatee geänderten erstellt, das Du durch Klick auf "Herunterladen" auf Deinen Rechner lädst und dort entpackst (die Maske geöffnet lassen).
    10. Die entpackten Ordner und Dateien ins Installationsverzeichnis des Boards auf dem Server hochladen und eventuell vorhandene "Altdateien" dabei überschreiben lassen
    11. Zurück in der Maske auf "Daten erneut prüfen" klicken => sollten bei ersten Lauf nicht alle geänderten Dateien korrekt erfasst worden sein, kannst Du hier den Vorgang Download > entpacken > hochladen wiederholen
    12. Nach Upload der Dateien auf " mit Update fortfahren" klicken => dies startet das Datenbankupdate
    13. Wenn dieser Lauf erfolgreich abgeschlossen ist: das /install Verzeichnis auf dem Server löschen oder umbenennen und Dich im ACP anmelden
    14. Die vor Upgradebeginn deaktivierten Extensions nacheinander und einzeln wieder aktivieren und jeweils ausführlich testen. Extensions, die hierbei Fehler aufzeigen, gegebenenfalls bis zur Veröffentlichung einer bereinigten oder für eure 3.3.x-Version validierten Revision deaktiviert lassen.
    15. Wartungsmodus wieder aufheben

--------------------------------------------------

IV. Upgrade über das Command Line Interface (CLI / Kommandozeile)

  1. Vorbereitungen:
    Identisch mit (A) des manuellen Upgrades
  2. Upgrade:
    1. Identisch mit den Schritten (1) und (2) des manuellen Upgrades.
    2. Die Punkte (3) bis (6) des manuellen Upgrades entfallen und werden ersetzt durch:
      Im Verzeichnis [/install] eine Datei config.yml erstellen mit folgendem Inhalt:

      Code: Alles auswählen

      updater:
              type: db_only
      Zur Konsole wechseln und im Ordner /install die phpbbcli.php aufrufen. Abhängig von der Serverkonfiguration sind zwei Varianten möglich:
      1. Code: Alles auswählen

        ./phpbbcli.php update config.yml
      2. Code: Alles auswählen

        php ./phpbbcli.php update config.yml
    3. Weiter mit den Schritten B.7 ff des manuellen Upgrades