Update auf BlueSpice 3.0

Dieses Dokument beschreibt die Schritte zur Durchführung eines Updates von BlueSpice 2.27.x auf die Version 3.0.

Hinweise zum Dokument

• Beim Editieren von Konfigurationsdateien mit einem Texteditor müssen die Dateien in UTF-8 Kodierung ohne BOM (Byte Order Mark) gespeichert werden.
• Der Platzhalter <installpath-bluespice> steht stellvertretend für den Pfad zu Ihrer BlueSpice-Installation, z.B. C:\bluespice\var\www (Windows bei Beachtung der Dokumentation "Ordnerstruktur unter Windows") oder /var/www/bluespice (Linux).
• Der Platzhalter <tomcat-webapps> steht stellvertretend für den Pfad zum Webapps-Verzeichnis Ihres Tomcat-Servers, z.B. C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps (Windows) oder /var/lib/tomcat9/webapps (Linux).

Vorgehen

Es empfiehlt sich eine Neuinstallation von BlueSpice 3 parallel zu BlueSpice 2 anzulegen, ohne jedoch den Installer von BlueSpice 3 auszuführen.

Voraussetzungen

Für das Update von BlueSpice auf die Version 3. wird MediaWiki in der Version 1.31 benötigt. Dieses muss im Browser unter <bluespice-url> erreichbar sein. Sollte Ihre bisherige BlueSpice-Installation noch kein MediaWiki 1.31 verwenden, so besuchen Sie für weitere Informationen die Updateanleitung von MediaWiki 1.23.x auf 1.27.x.

Fertigen Sie unbedingt als allererstes ein komplettes Backup Ihrer Installation an.

Anpassung der LocalSettings.php

Öffnen Sie die Datei <installpath-bluespice>/LocalSettings.php. Suchen Sie darin folgende Zeilen:

# End of automatically generated settings.
# Add more configuration options below.

Löschen Sie alle nachfolgenden Zeilen. Sollten Sie an dieser Stelle - abgesehen von den aus der alten Installationsanleitung geschilderten Schritte - weitere Konfigurationen selbständig vorgenommen haben, so behalten Sie diese zusätzlichen Konfigurationen in jedem Fall bei.

Fügen Sie anschließend ganz am Ende der LocalSettings.php folgende Zeile ein:

require_once "$IP/LocalSettings.BlueSpice.php";

Speichern und schließen Sie die Datei wieder.

Seit der BlueSpice-Version 2.27.1 sind alle Default-Einstellungen sowie die einzelnen Module von BlueSpice ausgelagert, somit wird BlueSpice nur noch mit dieser einen Zeile in MediaWiki integriert. Für technische Informationen hierzu besuchen Sie die Dokumentation für fortgeschrittene Benutzer.

Update von BlueSpice

Öffnen Sie nun eine Kommandozeile und wechseln in den Ordner <installpath-bluespice>. Führen Sie dort folgenden Befehl aus:

php maintenance/update.php (Linux)
php maintenance\update.php (Windows))

Achten Sie unter Windows darauf, dass die Umgebungsvariablen korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.

Beachten Sie unter Linux, dass Sie nach dem Ausführen der update.php die Dateisystemrechte neu anpassen müssen.

Sobald das Script mit der Meldung "Done" abgeschlossen ist, fahren Sie mit dem nächsten Schritt fort.

Sollte das Script während des Durchlaufs abbrechen, so starten Sie es bitte erneut.

Installation des Webservice für den LatexRenderer (nur BlueSpice pro)

Ab der Version BlueSpice pro 2.27.2 wurde die Erweiterung "Math" durch den BlueSpiceLatexRenderer ersetzt. LatexRenderer ist ausschließlich Bestandteil von BlueSpice pro.

Bitte beachten Sie, dass Sie den nötigen Webservice hierfür installieren.

Löschen Sie im Rahmen Ihres Updates den Ordner <installpath-bluespice>/extensions/Math.

Die Verwendung des Tags <math></math> wird nicht geändert, dies übernimmt nun der BlueSpiceLatexRenderer.

Überprüfung der Installation

Rufen Sie <bluespice-url> in Ihrem Browser auf. BlueSpice sollte nun erfolgreich auf die Version 3.0 upgedated und ein Login mit Ihren Zugangsdaten möglich sein.