1
Im folgenden wird ein Upgrade auf die Version 4.4.0 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
Bei einem Upgrade von JKBB 4.2 oder älter sollte, falls ein eigenes Stylesheet verwendet wird, dort noch dieser Code hinzugefügt werden:
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
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.:
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 (bei Upgrade von JKBB 4.1 oder älter)
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!
(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
Bei einem Upgrade von JKBB 4.2 oder älter sollte, falls ein eigenes Stylesheet verwendet wird, dort noch dieser Code hinzugefügt werden:
.js .no-js,
.no-js .js {
display: none;
}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
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 (bei Upgrade von JKBB 4.1 oder älter)
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!