Zur Navigation

Upgrade auf JKBB 4.2

1 Jörg Kruse

Im folgenden wird ein Upgrade auf die Version 4.2.2 beschrieben

(wer das Forum neu installieren möchte, kann das betreffende Paket auf der Downloadseite herunterladen und muss der im Paket enthaltenen Installations-Anweisung folgen)

1. Systemvoraussetzungen

mind. JKBB 2.1.0

mind. PHP 5.6

mind. MySQL 5.5 oder MariaDB 10.0

Die aktuell verwendeten Versionen werden im Adminbereich unter System-Infos angezeigt

Eine ältere JKBB-Version muss ggf. zuerst auf Version 2.1 aktualisiert werden, siehe hierzu diesen Thread

Plugins für JKBB 2 funktionieren nicht unter JKBB 4 und müssen nach dem Upgrade durch die betreffenden Plugins für die Version 3 oder 4 ersetzt werden

2. Vorbereitungen

Zur Sicherheit sollte ein Backup von Datenbank und Forenverzeichnis erstellt werden, welches wieder eingespielt kann, falls das Upgrade schiefläuft.

Des weiteren empfehle ich, vor dem Upgrade den Papierkorb zu leeren (Admin -> Papierkorb -> endgültig löschen)

3. Download des Upgrade-Pakets:

Download von zip Datei oder tar.gz Datei

4. Entpacken der Archiv-Datei

In dem Paket nicht enthalten ist die Konfigurations-Datei /includes/config.php - diese wird durch das Upgrade folglich nicht überschrieben. Andere Dateien müssen bei eigenen Änderungen ggf. neu angepasst werden, man sollte also vor dem Überschreiben ein Backup der geänderten Dateien erstellen.

5. Manuelle Anpassungen

(Die folgenden Anpassungen beziehen sich auf ein Upgrade von JKBB 3.1.1 oder älter)

Bei Verwendung der internen Datenschutzseite sollte die Datei /includes/content/datenschutz.php neu angepasst werden, insbesondere hinsichtlich den Anforderungen der DSGVO. Eine Musterdatei gibt es in der neuen Forenversion nicht mehr, man kann die Punkte, welche die Forensoftware betreffen, diesem Thread entnehmen:

https://jkbb.de/forum/datenschutzerklaerung-t-441-1

Wegen der Umstellung auf HTML5 können umfangreichere Anpassungen von selbst erstellten CSS-Dateien notwendig sein.

6. Hochladen der Verzeichnisse und Dateien

Zuerst sicherheitshalber im Forum als Admin einloggen, dann die Verzeichnisse und Dateien der neuen Forenversion per FTP hochladen. (Das Verzeichnis /docs und die Datei README müssen nicht mit hochgeladen werden). Nach dem Hochladen der Dateien befindet sich das Forum bis zum Datenbank-Update im Wartungsmodus

7. Datenbank-Update

Im Browser die Seite upgrade.php aufrufen - also je nach Installationsort des Forums z.B. https://example.com/upgrade.php oder https://example.com/forum/upgrade.php

Wenn anschließend im Adminbereich unter den System-Infos der Hinweis "Die Datenbank ist auf dem neuesten Stand." zu lesen ist, ist das Upgrade erfolgreich abgeschlossen. Die Datei upgrade.php kann dann gelöscht werden.

8. Probleme

Bei Problemen oder Unklarheiten, bitte hier melden lächel

Falls bei einem Upgrade von JKBB 2 auf 4 die Forensoftware den Installationspfad nicht mehr erkennt, was sich dadurch äußern könnte, dass das Layout nicht angezeigt wird, und Links ins Leere gehen, kann den Installationspfad in der Datei /includes/config.php angeben, z.B.:

$u_path = '/forum/';

Bitte hier Bescheid geben, falls dieses Problem bei euch aufgetreten ist

9. Plugins aktualisieren (bei Upgrade von JKBB 2)

Plugins für JKBB 2 müssen durch Plugin-Pakete für JKBB 3 oder 4 ersetzt werden

10. ggf. altes Layout wiederherstellen

Im Adminbereich kann bei Bedarf unter "Allgemeine Konfiguration" durch Auswahl der alten CSS-Datei responsive-1.css bzw. der selbst erstellen CSS-Datei das klassische bzw. eigene Layout wiederhergestellt werden. Nach einem Upgrade von JKBB 3.1.1 oder älter muss die CSS-Datei vorher angepasst werden!

21.12.2022 15:00 | geändert: 10.08.2023 14:44

Thema geschlossen, keine Antwort mehr möglich.