Update-Anleitung für die phpBB-Versionen 3.1, 3.2 und 3.3

Beschreibung: Beschreibung der drei verschiedenen Updatemethoden

Kategorie: Wichtig, Installation und Update

Link zu diesem Artikel: Alles auswählen

[url=https://www.phpbb.de/kb/viewarticle?a=108]Knowledge Base - Update-Anleitung für die phpBB-Versionen 3.1, 3.2 und 3.3[/url]

Das ist eine Update-Anleitung für die phpBB-Versionen 3.1, 3.2 und 3.3. Für ein Upgrade von 3.0 auf eine höhere Version gibt es diese Anleitung: phpBB 3.2/3.3 - Upgrade von phpBB 3.0

Es gibt mehrere Möglichkeiten, das Update durchzuführen. Die empfohlene Methode ist das manuelle Update. Daneben gibt es noch das Update via automatischem Updater und das Update über die Kommandozeile. Diese beiden letzteren Methoden sollte nur von erfahrenen Usern durchgeführt werden.

Für alle drei Updatemethoden sind folgende Vorbereitungsarbeiten notwendig:
  1. Systemvoraussetzungen prüfen. Darauf achten, dass die entsprechende PHP-Version installiert ist.
  2. Verwendete Styles und Extensions in einem Testforum mit der neuen phpBB-Version ausprobieren
  3. Board in den Wartungsmodus versetzen (deaktivieren via ACP).
  4. Backup erstellen (Datenbank und Dateien). Siehe auch: MySQL Backup
  5. Das aktuelle deutsche Komplettpaket herunterladen und entpacken.
  6. Die Datei config.php aus dem entpackten Komplettpaket löschen.
  7. Extensions deaktivieren (optional).
  8. Alle Styles außer prosilver deaktivieren.
  9. Captchas ausschalten oder auf phpBB-Standard setzen.
Nun erfolgt das Update selbst.
Sicherheitshalber sollte die gewählte Variante an einer Kopie des Boards durchgespielt werden, um mögliche Probleme beim späteren Update 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 höheren phpBB-Version kommen. Es wird daher angeraten, noch vor dem eigentlichen Update die im Board installierten Extensions auf bestehende Kompatibilität mit der neuen phpBB-Version zu prüfen, und gegebenenfalls bis zur Aktualisierung zu deaktivieren, oder, falls erforderlich, komplett zu deinstallieren (deaktivieren + Arbeitsdaten löschen).
Gleiches gilt für neben prosilver vorhandene weitere Styles.

Das manuelle Update

  1. Im entpackten Komplettpaket folgende Verzeichnisse löschen:
    • files/
    • images/
    • store/
    • optional .htaccess (falls modifiziert, z.B. um ein Portal als Startseite zu deklarieren)
    • und falls noch nicht geschehen die Datei config.php
  2. Im Hauptverzeichnis des Boards alle Dateien und Ordner löschen außer:
    • config.php
    • .htaccess (falls modifiziert)
    • /files
    • /images
    • Optional: /ext => falls er Extensions enthält
    • Optional: /styles => falls er weitere Styles neben prosilver enthält
    • Optional: /store => falls er Backups enthält. Wichtig: sollte der Ordner Dateien enthalten, die auf install_config.php, *.lock oder migration* enden , so musst du diese zwingend aus diesem Ordner löschen.
  3. Die Dateien des Komplettpakets hochladen. Die mögliche Frage zum Überschreiben von Dateien bejahen und Verzeichnisse integrieren, NICHT überschreiben, falls danach gefragt wird.
  4. Im Browser die Adresse des Installationsordners aufrufen => <pfad_zum_board>/install/app.php.
    Alternativ kann die Installation auch über diese URL <pfad_zum_board>/install/ gestartet werden.
  5. Rechts oben zu Deutsch als Sprache wechseln.
  6. Links oben Aktualisieren anklicken.
  7. Datenbankupdate durchführen auswählen. (Die Warnung, dass kein gültiges Update-Verzeichnis gefunden wurde, ignorieren!)
  8. Wenn das Update erfolgreich war, den Ordner /install/ vom Server löschen.
  9. Die Extensions nacheinander einzeln wieder aktivieren und Funktion prüfen.
  10. Die Styles wieder aktivieren.
  11. Wartungsmodus wieder aufheben (im Administrationsbereich unter Allgemein/Board-EinstellungenBoard wieder aktivieren.)
--------------------------------------------------

Update via Geänderte-Core-Dateien Updater

  1. Im Hauptverzeichnis des Boards folgende Ordner löschen:
    • /docs
    • /vendor
  2. Die Dateien des Komplettpakets hochladen.
  3. Im Browser die Adresse des Installationsordners aufrufen => <pfad_zum_board>/install/.
    Alternativ kann die Installation auch über diese URL <pfad_zum_board>/install/app.php gestartet werden
  4. Rechts oben zu Deutsch als Sprache wechseln.
  5. Links oben Aktualisieren anklicken
    • Manuelle Aktualisierung:
      Den Ordner mit den geänderten Dateien herunterladen und entpacken. Die Ordner und Dateien per FTP ins Hauptverzeichnis hochladen.
    • Automatische Aktualisierung über FTP:
      Bei dieser Methode werden 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. Bei 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. Die Dateien werden nun mit den Dateien der zu installierenden Version verglichen.
    Das Ergebnis dieser Prüfung wird wie folgt angezeigt:
    • Zu löschende Dateien:
      alle Dateien der alten Installation, die in der neuen Version nicht mehr vorhanden sind und daher entfernt werden müssen.
    • Geänderte Dateien:
      alle modifizierten Dateien, die mit den neuen Dateien verzahnt werden müssen.
    • Neu hinzuzufügende Dateien:
      alle hinzugekommenen Dateien.
    • Nicht geänderte Dateien:
      enthält alle Dateien, die unverändert übernommen werden können.
  9. Nach Bestätigung werden die Dateien aktualisiert und ein Ordner mit den adaptieren Dateien erstellt. Den Ordner herunterladen und entpacken.
  10. Die entpackten Ordner und Dateien ins Hauptverzeichnis hochladen und eventuell vorhandene Altdateien dabei überschreiben lassen
  11. Die Daten erneut prüfen. Sollten beim ersten Durchgang 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 und das Datenbankupdate starten.
  13. Wenn das Update erfolgreich war, den Ordner /install/ vom Server löschen.
  14. Die Extensions wieder aktivieren.
  15. Die Styles wieder aktivieren.
  16. Wartungsmodus wieder aufheben
--------------------------------------------------

Update über das Command Line Interface (CLI / Kommandozeile)

  1. Identisch mit den Schritten (1) und (2) des manuellen Updates.
  2. Die Punkte (3) bis (6) des manuellen Updates 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:
  3. Weiter mit den Schritten (7) bis (10) des manuellen Updates