Update von BlueSpice 4.5 auf 5.1

Versionskompatibilität*Wenn Sie von einer Version < 4.4 aktualisieren möchten, ist der Zwischenschritt der Aktualisierung auf 4.4 erforderlich.

• Wenn Sie von einem Docker-Container 4.4 auf 5.1 aktualisieren möchen, aktualisieren Sie zuerst auf 4.5.

Update-Szenario prüfen

Mit Version 4.5 von BlueSpice gab es zwei Installationsoptionen:

Container-Stack (bluespice-deploy)

Wenn Sie BlueSpice 4.5 bereits als Docker Container installiert haben, folgen Sie folgender Update-Anleitung auf BlueSpice 5:

→ Upgrade von bluespice-deploy Installation

Direkte Installation (klassischer Tarball)

Wenn Sie BlueSpice 4.5 mit einer komprimierten tar-Datei installiert haben, folgen Sie folgender Update-Anleitung auf BlueSpice 5:

→ Upgrade von klassischer Tarball-Installation

Je nachdem, von welcher Installationsoption Sie ausgehen, kann das Update auf BlueSpice Version 5.1 unterschiedliche Schritte erfordern.

Backup erstellenBevor Sie einen der folgenden Schritte ausführen, erstellen Sie unbedingt ein Backup aller Datenbanken und Dateisystemspeicherorte, die mit dem Prozess in Zusammenhang stehen.

Sonderfälle

Bevor Sie die Datenbankschema-Updates durchführen, können basierend auf der zuvor installierten BlueSpice-Version und optional aktivierten Erweiterungen einige kleinere Änderungen an der Datenbank erforderlich sein.

Erweiterung: OATHAuth

In manchen Fällen müssen die Erweiterungstabellen vor dem Update manuell zur Datenbank hinzugefügt werden.

Erweiterung: OpenIDConnect

In manchen Fällen muss dieser Patch vor dem Update angewendet werden.

ALTER TABLE openid_connect DROP COLUMN oidc_id;
ALTER TABLE openid_connect ADD PRIMARY KEY (oidc_user);

Doppelte SchlüsselFalls die Tabelle openid_connect doppelte Einträge von oidc_subject enthält, können Sie alle Duplikate mit einem abschließenden Schrägstrich im Feld oidc_issuer sicher entfernen.

Externe MySQL/MariaDB-Datenbank

Wenn Ihr Wiki vor dem Update einen externen Datenbankserver verwendet und Sie diesen auch nach dem Update weiterhin nutzen möchten, stellen Sie sicher, dass die Task-Runner-Prozesse Ihres Wikis vor dem Update vollständig beendet sind:

• Bei 4.5-Installationen mit Docker-Containern stellen Sie Folgendes sicher:
  1. Der vorherige Stack ist gestoppt.
  2. Der zugehörige Daemon-Dienst bluespice.service ist entfernt/deaktiviert.
  3. Die Container im vorherigen Stack sind beendet und starten nicht automatisch nach einem Serverneustart.
• Bei 4.5-Installationen direkt im Linux-System des Host-Rechners:
  1. Überprüfen Sie die Crontab-Attribute für Ihren Root-Benutzer und kommentieren Sie die entsprechenden Zeilen für Job-Runner und Prozess-Runner aus.
  2. Überprüfen und beenden Sie die verbleibenden Prozesse.

Collabpads-Datenbankaktualisierung

Die einfachste Möglichkeit, von MongoDB 4.4 auf 8.0 zu aktualisieren, ist das Exportieren und Importieren der Datenbanken:

Beispiel:

Führen Sie unter Mongo 4.4 Folgendes aus: mongodump --db <dbname> --gzip --archive > /tmp/collabpads_dump.gz Führen Sie unter Mongo 8.0 Folgendes aus: mongorestore --gzip --archive=/tmp/collabpads_dump.gz

SAML-Authentifizierung

Wenn Sie SAML mit der vorherigen Version verwendet haben von BlueSpice müssen Sie den Dienstanbieter wahrscheinlich erneut bei Ihrem Identitätsanbieter registrieren.

Laden Sie dazu die neue Datei metadata.xml von https://<wikiserver>/_sp/module.php/saml/sp/metadata.php/default-sp herunter.

PDF-Ausschluss - Start

---

Feedback zur Dokumentation ist im Community-Forum möglich.

PDF-Ausschluss - Ende

Protokoll zur Verschlüsselung und Authentifizierung der Kommunikation zwischen Webserver und Browser im World Wide Web.