BlueSpice Betriebshandbuch

Zielsetzung

Ziel dieser Betriebsanleitung ist es, Ihnen eine reibungslose und erfolgreiche Ausführung von BlueSpice in Ihrer IT-Umgebung zu ermöglichen. Sie soll Ihre Fragen als Entscheider, IT-Prüfer und Serveradministratoren unter anderem zu folgenden Fragen beantworten:

• Woher bekomme ich Informationen über BlueSpice und die Entwicklung von BlueSpice?
• Was muss ich beim Betrieb von BlueSpice beachten?
• Wie kann ich BlueSpice sichern und überwachen?

Die aktuellste Version finden Sie unter https://de.wiki.bluespice.com/wiki/Setup:BlueSpice_Betriebshandbuch. Dieses Handbuch enthält allgemeine Informationen. Sie können es jederzeit auf Ihr lokales BlueSpice kopieren und entsprechend Ihren Prozess- und Dokumentationsanforderungen ändern. Da sich die IT-Umgebung im Laufe der Zeit durch Aktualisierungen und Umstrukturierungen ändern kann, ist es ratsam, die Informationen im Betriebshandbuch auf Aktualität zu überprüfen.

Der Aufbau dieses Handbuchs basiert auf den Empfehlungen des Bundesamtes für Informationssicherheit, die hier zu finden sind.

Überblick

Systemüberblick

BlueSpice ist eine webbasierte Client-Server-Anwendung. Auf der Serverseite werden ein Webserver (Nginx), die Skriptsprache PHP, zwei Datenbanken (MariaDB, MongoDB), JAVA-Anwendungsserver (Tomcat), NodeJS-Server und OpenSearch verwendet. Auf dem Server ist einzig die Installation einer Container-Laufzeitumgebung erforderlich.

BlueSpice kann in einer verteilten Umgebung ausgeführt werden. Bestimmte Dienste können auf einzelnen Servern bereitgestellt werden. Ein mögliches Szenario besteht darin, den WebFrontend-Service horizontal zu skalieren.

In der Regel besteht eine Inhouse-Installation von BlueSpice aus einer Produktionsumgebung und einer entsprechenden Testumgebung. In Szenarien mit erhöhten SLAs wird vor der Produktion eine zusätzliche QS-Umgebung als Zwischenschritt verwendet.

Eigentümer, Verantwortliche und Kontakte

Die Entwicklung und Pflege von BlueSpice erfolgt durch:

Hallo Welt! GmbH
Bruderwöhrdstraße 29
93055 Regensburg
Deutschland
https://www.hallowelt.com

Bei technischen Fragen wenden Sie sich bitte an den Hallo Welt! GmbH-Support unter support@hallowelt.com.

Bei Fragen zu Ihrem Vertrag wenden Sie sich bitte an das Verkaufsteam der Hallo Welt! GmbH unter sales@hallowelt.com .

Betriebszeiten

In der Regel werden BlueSpice-Instanzen rund um die Uhr ausgeführt. Der Betrieb wird von der IT-Abteilung des Unternehmens oder deren Dienstleistern verwaltet. Hallo Welt! bietet Unterstützung und Anleitung während der Bürozeiten (8 - 18 Uhr MEZ / MESZ).

System- und Revisionshistorie

Alle BlueSpice Versionen sind im BlueSpice Helpdesk dokumentiert: https://de.wiki.bluespice.com/wiki/Setup:Release_Historie

Alle Änderungen können in unseren aktuellen und archivierten Release Notes nachvollzogen werden: https://de.wiki.bluespice.com/wiki/Setup:Release_Notes

Dokumentation

BlueSpice pflegt eine Online-Dokumentation, die ständig auf dem neuesten Stand gehalten wird: https://de.wiki.bluespice.com

Ein Benutzerhandbuch steht zur Verfügung: https://de.wiki.bluespice.com/wiki/Benutzerhandbuch

Die Administration ist hier dokumentiert: https://de.wiki.bluespice.com/wiki/Adminhandbuch

Zusätzlich gibt es ein Benutzerforum: https://community.bluespice.com/

Neuigkeiten zum Produkt finden Sie in unserem Blog: https://bluespice.com/de/kategorie/news-wissen/

Außerdem versenden wir regelmäßig einen BlueSpice Newsletter. Hier können Sie sich anmelden: https://bluespice.com/de/

Folgen Sie uns für weitere Informationen auf SocialMedia: https://bsky.app/profile/bluespice-wiki.bsky.social, https://fosstodon.org/@bluespice, https://www.youtube.com/@BlueSpiceVideo

Installationsanleitung

BlueSpice pflegt eine Online-Installationsanleitung: https://de.wiki.bluespice.com//wiki/Setup:Installationsanleitung

Systemarchitektur und Schnittstellen

Der folgende Abschnitt gibt einen Überblick über die Komponenten von BlueSpice und wie diese miteinander und mit ihrer Umgebung interagieren.

Systemintegration

BlueSpice ist eine Webanwendung, die in Ihre IT-Umgebung integriert werden kann, insbesondere Authentifizierung und E-Mail.

Serverarchitektur

Intern besteht BlueSpice aus mehreren Komponenten, die Teile der Funktionalität bereitstellen.

Komponenten und Verantwortlichkeiten

Server, Betriebssystem, Lizenzen und Software-Infrastruktur werden normalerweise von der IT Ihres Unternehmens verwaltet.

Hallo Welt! verwaltet normalerweise die Anwendung und die erforderlichen Komponenten.

Es können besondere vertragliche Vereinbarungen bestehen.

Externe Schnittstellen (zu anderen Organisationen)

Technisch gesehen kann BlueSpice so eingerichtet werden, dass es vollständig in sich geschlossen arbeitet (wenden Sie sich an unseren Support, wenn Sie Fragen zu Ihrer Instanz haben). Auf dem Server werden keine externen Quellen abgefragt. In der Standardinstallation gibt es Inhaltsmodule, die Daten aus externen Quellen auf der Clientseite (Browser) beziehen:

• maps: Eingebettete Karten werden von Google oder OpenStreetMap gesammelt.
• widgets: Der Zweck von Widgets besteht darin, Inhalte aus öffentlichen Quellen wie YouTube anzuzeigen.

Auf der organisatorischen Seite bietet das Team von Hallo Welt! GmbH normalerweise 3rd-Level Support für abonnierte BlueSpice-Instanzen. Die Hallo Welt! GmbH arbeitet mit der internen IT des Unternehmens sowie mit IT-Infrastrukturanbietern der Kunden zusammen.

IT-interne Schnittstellen

Eine Standardinstallation von BlueSpice stellt eine Verbindung zu den folgenden Diensten her, um voll funktionsfähig zu sein:

• Benutzerverzeichnis: BlueSpice kann so konfiguriert werden, dass es sich bei einem Unternehmensbenutzerverzeichnis (normalerweise Active Directory) authentifiziert. Die verwendeten Protokolle sind OpenIdConnect, SAML und LDAP.
• E-Mail: BlueSpice muss mit einem E-Mail-Server verbunden sein, um Benachrichtigungen senden zu können.

API

BlueSpice verfügt über eine API-Schnittstelle.

• Anweisungen zum Umgang mit der API finden Sie hier: https://www.mediawiki.org/wiki/API:Main_page/de
• Eine umfassende Liste der API-Module finden Sie hier: https://de.wiki.bluespice.com/w/api.php

Installation und Systemvoraussetzungen

Systemvoraussetzungen

Die aktuellen Systemvoraussetzungen sind hier dokumentiert: https://de.wiki.bluespice.com/wiki/Setup:Systemanforderungen

Softwarekatalog

Alle BlueSpice-Komponenten sind im Softwarekatalog aufgeführt: https://de.wiki.bluespice.com/wiki/Setup:Softwarekatalog

Konfigurationsänderungen

Konfigurationsänderungen können in Minor und Major Releases auftreten. Bitte beachten Sie die hier bereitgestellten Upgrade-Informationen: https://de.wiki.bluespice.com/wiki/Setup:Installationsanleitung/Upgrade

Aufnahme und Unterbrechung des Betriebs

Ungeplanter Serverausfall

Identifizieren Sie, welcher Dienst nicht ausgeführt wird und starten Sie diesen Dienst neu.

Der laufende Betrieb

Benutzerverwaltung

• Alle Benutzer werden in der Anwendung verwaltet. Einzelheiten finden Sie unter: https://de.wiki.bluespice.com/wiki/Handbuch:Erweiterung/BlueSpiceUserManager

Überwachung

Abgesehen von den allgemeinen zu überwachenden Parametern (Speicherplatz, CPU-Auslastung, Speichernutzung) können die folgenden Dienste auf Verfügbarkeit überwacht werden:

• Webserver: Pingen Sie die Anmeldeseite des Wikis an: <wiki_url>/Special:Login
• Datenbank: Überprüfen Sie die Datenbankverbindung mit der Authentifizierung mit Benutzername und Kennwort.

Wenn einer dieser Dienste nicht verfügbar ist, ist BlueSpice entweder nicht betriebsbereit oder unterliegt funktionalen Einschränkungen.

Fehlersuche

Beachten Sie bei Fehlern die Fehlerprotokolle:

• Öffnen Sie im Webbrowser die Konsole und suchen Sie nach JavaScript-Fehlern.
• Überprüfen Sie das Fehlerprotokoll und das PHP-Fehlerprotokoll des Webservers.

Fehlerbehebung

Wenn ein oder mehrere Dienste nicht funktionieren:

• Überprüfen Sie die verfügbaren Systemressourcen, insbesondere den freien Speicherplatz.
• Starten Sie alle Dienste neu.

Wenn das Problem weiterhin besteht, wenden Sie sich an den BlueSpice-Support.

Leistungskennziffern

Server

Es gelten folgende Standardparameter für Server:

• Speicherplatz < 80% Auslastung.
• Die CPU-Auslastung sollte nicht länger als 1 Sekunde auf 100% ansteigen.
• Die Systemauslastung (load average) sollte nicht mehr als die Anzahl der CPU-Kerne betragen.
• Die durchschnittliche Speichernutzung sollte 90% nicht überschreiten.
• Vermeiden Sie bei GNU / Linux-Systemen eine hohe Auslastung des Swap-Speicherplatzes.

Das PHP-Fehlerprotokoll sollte keine Fehlermeldungen vom Typ FATAL oder WARNING anzeigen.

Client

Die Referenzseite Spezial:Version sollte unter 4 Sekunden ohne Browser-Cache und unter 2,5 Sekunden mit aktiviertem Browser-Cache geladen werden.

Bekannte Beschränkungen

Funktionale Beschränkungen

Funktionalität:

• bluespice/web : Erforderlich für BlueSpice-Grundoperationen.
• bluespice/task : Erforderlich für BlueSpice-Grundoperationen.
• bluespice/database: Erforderlich für BlueSpice-Grundoperationen.
• bluespice/pdf: Erforderlich für PDF
• bluespice/search: Erforderlich für ExtendedSearch und verschiedene Titelauswahlfelder
• bluespice/diagram: Erforderlich für die Bearbeitung von Diagrammen
• bluespice/collabpads: Erforderlich für die simultante Bearbeitung von Wikiseiten
• bluespice/collabpads-database: Erforderlich für den Betrieb von bluespice/collabpads
• bluespice/formula: Erforderlich für die Darstellung von mathematischen und chemischen Formeln
• bluespice/proxy: Erforderlich für die BlueSpice-Grundoperationen

Technische Beschränkungen

Updates vom Typ "major" and "minor" können aufgrund von Datenbankmigrationsvorgängen eine Systemausfallzeit erfordern.

Kapazitätsbezogene Beschränkungen

Die Antwortzeiten hängen von den Serverressourcen ab, vor allem von der CPU-Leistung.

Die Anzahl der gleichzeitigen Benutzer, die ein Server verarbeiten kann, hängt direkt von der Speichergröße des Servers und der CPU-Leistung ab.

Bitte beachten Sie: Wir empfehlen dringend ein separates Testsystem. Dies kann zur Vorbereitung von Updates/Upgrades, zum Debuggen und zum Sammeln von Größeninformationen verwendet werden. Wenn kein Testsystem vorhanden ist, können gelegentliche Ausfallzeiten auftreten, wenn Debugging- und Wartungsvorgänge durchgeführt werden.

Archivierung und Löschen von Daten

Bewegungsdaten

Die folgenden Speicherorte speichern Bewegungsdaten, die bei Datenverlust nicht wiederhergestellt werden können und regelmäßig gesichert werden müssen:

• In den Datenbanken werden die meisten Daten von BlueSpice gespeichert, einschließlich Artikel, Benutzer und Aktionsprotokolle.
• Die Volumes der verschiedenen Services speichern zusätzliche Produktivdaten.
  • Daten im Volume des bluespice/search können gegebenenfalls wiederhergestellt werden

Log-Dateien und Fehler-Dateien

Die verschiedenen Services schreiben ihre Logs in den Standard-Output. Die verwendete Container-Laufzeitumgebung verwaltet diesen.

Sicherheitsbestimmungen

Internetzugang

Für Standardvorgänge benötigt BlueSpice keinen Internetzugang. BlueSpice tätigt keine ausgehenden Anrufe. Weitere Informationen finden Sie im Abschnitt Externe Schnittstellen.

Zugriff auf unterstützende Dienste

Unterstützende Dienste laufen in Containern und sind falls nicht anders konfiguriert nur von der Hauptanwendung aus erreichbar.

Datenschutz

Die Einhaltung der DSGVO wird von der BlueSpice Datenschutzzentrale übernommen. Weitere Informationen finden Sie hier: https://de.wiki.bluespice.com/wiki/Handbuch:Erweiterung/BlueSpicePrivacy

Rechtliche Informationen

Alle rechtlichen Informationen, einschließlich des Subskriptionsvertrags, der DSGVO-Informationen, des Vertrags über Auftragsverarbeitung (AVV) und der Antibestechungsrichtlinien sowie den Softwarekatalog finden Sie auf der BlueSpice-Homepage: https://bluespice.com/de/vertraege-und-richtlinien/

PDF-Ausschluss - Start

---

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

PDF-Ausschluss - Ende

Wird im Wiki von einem "Artikel" gesprochen, so ist damit in der Regel der Inhalt einer Einzelseite gemeint. Im Zusammenhang mit im Wiki erstellten Büchern ist ein Artikel oft gleichbedeutend mit einem Buchkapitel.

Wird im Wiki von einem "Artikel" gesprochen, so ist damit in der Regel der Inhalt einer Einzelseite gemeint. Im Zusammenhang mit im Wiki erstellten Büchern ist ein Artikel oft gleichbedeutend mit einem Buchkapitel.