phpBB 3.2 - Upgrade von phpBB 3.1

Dieser Artikel erläutert die einzelnen Schritte des Upgrades von phpBB 3.1.x auf 3.2.x.

I. Vorbemerkungen



Auch bei diesem Upgrade gibt es wieder 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.2 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.2 Board, da ohnehin ein großer Teil der Code-Dateien ersetzt oder angepasst werden müssten und daher nicht mehr weiterverwendet werden können.
    Voraussetzung: es wurden keine manuellen Anpassungen am Kerncode vorgenommen, die erhalten bleiben müssen.
    .
  2. nicht empfohlen: Upgrade via "automatischem Updater":
    Wichtiger Hinweis: Aufgrund eines Bugs in der Upgraderoutine für die Varianten "Automatische Aktualisierung über FTP" kann es bei dieser Methode zu Fehlern im Upgradeprozess kommen. Von daher wird aktuell bis zu dessen Behebung vom Einsatz des automatischen Updaters abgeraten.

    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 Upgradelaufs 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 Core Code vorgenommen haben.
    .
  3. Upgrade über das Command Line Interface (CLI => Kommandozeile)
    Im Prinzip das gleiche Vorgehen wie beim manuellen Upgrade, außer dass das Datenbankupdate über die Kommandozeile bzw. das Command Line Interface von phpBB 3.2 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 gegenüber phpBB 3.1 weiterentwickelten Codebasis kann es beim Einsatz bestimmter für 3.1 entwickelter Extensions zu Inkompatibilitäten beim Betrieb unter phpBB 3.2 kommen. Es wird daher angeraten, noch vor dem eigentlichen Upgrade die im Board installierten Extensions auf bestehende 3.2-Kompatibilität 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 in der Version 5.4.x.
    2. Board in den Wartungsmodus versetzen
      => Admin-Bereich > Tab: Allgemein > Board-Einstellungen > Board deaktivieren: "ja", (die Begründung ist optional)
    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. Prüfen, ob bei Verwendung von MySQL als Datenbanksystem in der config.php der Datenbanktreiber mit mysqli angegeben ist, ansonsten ändern:

      Code: Alles auswählen

      $dbms = 'phpbb\db\driver\mysqli';

      (Hintergrund: in PHP 7.x wird der ältere mysql-Treiber nicht länger unterstützt und wurde daher entfernt. Dies kann bei einem späteren Wechsel der PHP-Version auf 7.x zu Problemen und Fehlern beim Betrieb des Boards führen.}
    5. Das aktuelle deutsche Komplettpaket im Downloadbereich auf phpbb.de herunterladen und lokal entpacken
    6. 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)
    7. Falls installierte Extensions vorhanden sind => diese deaktivieren
    8. Im ACP des Boards alle Styles außer prosilver deaktivieren
    9. 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 Upgrademoduls 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. Bitte beachten / wichtig:
      Im darauffolgenden Bildschirm werden zwei Optionen angezeigt, die noch bestätigt werden müssen:
      Die im Paket enthaltene VigLink Extension wurde im Laufe des Upgradeprozesses bereits installiert und zur Aktivierung vorgesehen (!) - wenn Du dies wieder rückgängig machen willst, dann hier unbedingt die bereits markierte Option wieder abwählen und bestätigen!

      .
    9. 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 3.2 validierten Revision deaktiviert lassen.
    10. Wartungsmodus wieder aufheben


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

III. Upgrade mittels des automatischen Updatepakets


Wichtiger Hinweis: Aufgrund eines Bugs in der Upgraderoutine für die Varianten "Automatische Aktualisierung über FTP" kann es bei dieser Methode zu Fehlern im Upgradeprozess kommen. Von daher wird aktuell bis zu dessen Behebung vom Einsatz des automatischen Updaters abgeraten.


  1. Vorbereitungen:

    1. Prüfen, ob die Systemvoraussetzungen erfüllt sind: u.a. PHP minimum in der Version 5.4.x.
    2. Board in den Wartungsmodus versetzen
      => Admin-Bereich > Tab: Allgemein > Board-Einstellungen > Board deaktivieren: "ja", (die Begründung ist optional)
    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. Prüfen, ob bei Verwendung von MySQL als Datenbanksystem in der config.php der Datenbanktreiber mit mysqli angegeben ist, ansonsten ändern:

      Code: Alles auswählen

      $dbms = 'phpbb\db\driver\mysqli';

      (Hintergrund: in PHP 7.x wird der ältere mysql-Treiber nicht länger unterstützt und wurde daher entfernt. Dies kann bei einem späteren Wechsel der PHP-Version auf 7.x zu Problemen und Fehlern beim Betrieb des Boards führen.}
    5. Das aktuelle deutsche automatische Updatepaket im Downloadbereich auf phpbb.de herunterladen und lokal entpacken (es enthält drei Ordner: /docs, /install & /vendor)
    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 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älts 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"
        [Wichtig: Ausschließlich diese Option wählen => nur sie ist nicht vom oben erwähnten Bug betroffen!]
      • "Archiv-Format für Download auswählen" => ".zip"
    8. Im darauf folgenden Lauf erfolgt ein Vergleich der vorhandenen 3.1 Dateien mit den Dateien der zu installierenden Version3.2
      Das Ergebnis dieser Prüfung wird in drei Abschnitte geliedert angezeigt:
      • "Zu löschende Dateien":
        Diese Aufstellung umfasst alle Dateien der 3.1 Installation, die in der Version 3.2 nicht mehr vorhanden sind und daher entfernt werden müssen.
      • "Geänderte Dateien":
        Hier werden alle 3.1 Dateien geführt, die aufgrund manueller Codeänderungen nicht mehr mit den original 3.1 Dateien identisch sind und daher nicht im Zuge des Upgrades durch neue der Version 3.2 ersetzt werrden 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 3.2 hinzugekommener Dateien
      • "Nicht geänderte Dateien":
        Lister aller 3.1 Dateien, die unverändert in 3.2 übernommen werden können und daher erhalten bleiben
    9. Nach Bestätigen werden die Dateien aktualisiert und ein Archiv mit den durch das Upgrade 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. Bitte beachten / wichtig:
      Im darauffolgenden Bildschirm werden zwei Optionen angezeigt, die noch bestätigt werden müssen:
      Die im Paket enthaltene VigLink Extension wurde im Laufe des Upgradeprozesses bereits installiert und zur Aktivierung vorgesehen (!) - wenn Du dies wieder rückgängig machen willst, dann hier unbedingt die bereits markierte Option wieder abwählen und bestätigen!

      .
    15. 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 3.2 validierten Revision deaktiviert lassen.
    16. 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

Zuletzt bearbeitet: 22.02.2017 20:32 von • Der Artikel wurde 3105 mal angeschaut.