Update innerhalb einer phpBB-Version (Bsp: 3.3.x zu 3.3.x+1)

Beschreibung: Das ist eine Anleitung für ein Update innerhalb einer phpBB-Version wie z.B. von phpBB 3.2.x zu 3.2.x+1 oder von phpBB 3.3.x zu 3.3.x+1.

Kategorie: Wichtig, Installation und Update

Link zu diesem Artikel: Alles auswählen

[url=https://www.phpbb.de/kb/viewarticle?a=99&sid=7fdcb428cdb2f44e8424d1bb518596a0]Knowledge Base - Update innerhalb einer phpBB-Version (Bsp: 3.3.x zu 3.3.x+1)[/url]

Das ist eine Anleitung für ein Update innerhalb einer phpBB-Version wie z.B. von phpBB 3.2.x zu 3.2.x+1 oder von phpBB 3.3.x zu 3.3.x+1. Die Updateanleitung für das Update mit Versionssprung, also von phpBB 3.2.x auf phpBB 3.3.x, findest du hier: phpBB 3.3: Update von phpBB 3.2.x auf phpBB 3.3.x.

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 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.
  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 zu deaktivieren oder, falls erforderlich, komplett zu deinstallieren.
Gleiches gilt für neben prosilver vorhandene Styles.

Das manuelle Update

  1. 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
  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.
  6. Datenbankupdate durchführen auswählen.
  7. Wenn das Update erfolgreich war, den Ordner /install/ vom Server löschen.
  8. Die Extensions wieder aktivieren.
  9. Die Styles wieder aktivieren.
  10. Wartungsmodus wieder aufheben
--------------------------------------------------

Update via automatischem 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