Zuletzt bearbeitet vor 3 Wochen
von Margit Link-Rodrigue

Update von BlueSpice 4.5 auf 5.1

Version vom 5. Juni 2025, 12:25 Uhr von Margit Link-Rodrigue (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
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.

Mit Version 4.5 von BlueSpice gab es zwei Installationsoptionen:

  1. bluespice-deploy Container-Stack → Upgrade von bluespice-deploy Installation
  2. Klassisches Tarball → Upgrade von klassischer Tarball-Installation

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

Backup erstellen

Bevor 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[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

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

Erweiterung: OpenIDConnect[Bearbeiten | Quelltext bearbeiten]

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üssel

Falls 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.

Collabpads-Datenbankaktualisierung[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

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