Zum Inhalt

Drovio Server konfigurieren

Sie können Drovio Server über die Administrationsoberfläche oder über die Konfigurationsdateien einrichten. In beiden Fällen werden die Änderungen übernommen, während der Server läuft: die Konfigurationsdatei wird überwacht und eine Änderung wird innerhalb weniger Sekunden wirksam, ohne die laufenden Sitzungen zu unterbrechen.

Drei Ausnahmen erfordern einen Neustart

  • Die Plugins. Der Abschnitt plugin_management wird beim Start gelesen und nicht im laufenden Betrieb neu geladen. Ein Plugin hinzuzufügen, zu entfernen oder umzukonfigurieren wird daher erst nach einem Neustart wirksam. Integrationen wie die Slack-Integration fallen in diesen Fall.
  • Der HTTP-Listener. tls, http_port und https_port werden ein einziges Mal gelesen, wenn der Server zu lauschen beginnt. Sie danach zu ändern bleibt bis zum Neustart wirkungslos. Unter Linux werden keystore und keystore_password auf dem laufenden Listener erneut angewandt, wenn der Server SIGUSR2 empfängt. Siehe HTTPS aktivieren.
  • Das SSO. Die SAML- und OIDC-Clients werden beim Start aufgebaut. SSO zu aktivieren oder zu deaktivieren wird sofort wirksam, doch die Einstellungen eines Anbieters zu ändern erfordert einen Neustart. Siehe SSO.

Alles Übrige wird bei laufendem Server angewandt. Siehe Dienst starten und stoppen für Ihre Plattform.

Über die Administrationsoberfläche

Die Administrationsoberfläche liegt lokal unter der Adresse:

http://localhost:8090/admin

Ersetzen Sie localhost durch Ihre tatsächliche IP-Adresse, wenn Sie von einer anderen Maschine aus darauf zugreifen. Gelingt Ihnen das nicht, lesen Sie Fehlerbehebung.

Administrationsoberfläche von Drovio Server: Anmeldung

Den ersten Administrator anlegen

Eine neue Serverinstanz hat keinen Administrator. Beim ersten Start schreibt sie ein Einrichtungstoken neben ihre Konfigurationsdatei, wo nur der Systemadministrator es lesen kann:

/etc/drovio-server/admin-setup.token

C:\ProgramData\Drovio\Drovio Server\admin-setup.token

config/admin-setup.token, neben docker-compose.yml.

Öffnen Sie die Administrationsoberfläche. Solange kein Administrator existiert, führt jede Seite der Oberfläche zu Create the first administrator. Geben Sie das Token ein, dann Ihre E-Mail-Adresse, den Namen, der den anderen Administratoren angezeigt wird, und ein Passwort. Das Passwort braucht mindestens 12 Zeichen, und ein gängiges Passwort wird abgelehnt.

Der Server löscht das Token, sobald der Administrator angelegt ist: Es lässt sich kein zweites Mal verwenden.

Im Cluster

Nur ein Knoten schreibt das Token. Sein Log zeigt, welcher, in einer Zeile, die mit There is no administrator yet beginnt.

Administratoren

Administratoren melden sich mit ihrer E-Mail-Adresse an. Weitere Administratoren können Sie auf der Seite Administrators hinzufügen, über die Sie auch ihre Passwörter ändern oder sie entfernen können. Jeder Administrator kann seinen Anzeigenamen und sein Passwort unter Profile ändern, direkt im Avatar-Menü.

Ist der E-Mail-Versand aktiviert, kann ein Administrator seine Adresse direkt nach der Anmeldung mit einem per E-Mail gesendeten Code bestätigen.

Der Server sendet Benachrichtigungen an die Administratoren, deren Adresse bestätigt ist: nur noch wenige Lizenzen zum Zuordnen übrig, ungewöhnlich viele gesendete E-Mail-Codes, ein bald ablaufendes Single-Sign-On-Zertifikat sowie die Benachrichtigungen der Integrationen und Plugins.

Jeder Administrator kann unter Notifications, direkt im Avatar-Menü, auswählen, welche Benachrichtigungen er erhalten möchte.

Aktualisierung von einer Version vor 3.7.0

Ältere Versionen haben die Administratoren in admin.properties neben der Konfigurationsdatei festgelegt. Beim ersten Start nach der Aktualisierung überträgt Drovio Server sie in die Datenbank und benennt die Datei dann in admin.properties.migrated um. Sie können sie bedenkenlos löschen, sobald jeder Administrator migriert ist.

Diese Administratoren haben noch keine E-Mail-Adresse und müssen wie folgt vorgehen:

  1. Folgen Sie auf der Anmeldeseite Migrating from admin.properties?. Der Link wird angezeigt, solange noch ein Administrator zu migrieren ist.
  2. Melden Sie sich mit dem Benutzernamen und Passwort aus admin.properties an.
  3. Geben Sie Ihre E-Mail-Adresse und den Namen ein, der den anderen Administratoren angezeigt wird.
  4. Ist der E-Mail-Versand aktiviert, geben Sie den an diese Adresse gesendeten Code ein.
  5. Ersetzen Sie das Passwort, wenn es die obigen Regeln nicht erfüllt, wie das frühere Standardpasswort admin / admin.

Ab dann melden Sie sich mit Ihrer E-Mail-Adresse an.

Sobald Sie angemeldet sind, öffnen Sie die Seite Settings wie unten gezeigt, um zur Konfigurationsoberfläche zu gelangen.

Administrationsoberfläche von Drovio Server: Einstellungen

Von dort aus können Sie jede von Drovio Server verwendete Einstellung ändern. Die Konfigurationsreferenz beschreibt jedes Feld im Detail.

Eine Einstellung, die Sie sofort ändern sollten

Die URL, die auf diesen Server verweist: HTTP server → URL, nötig für Benachrichtigungen und Benutzereinladungen.

Über die Konfigurationsdateien

Drovio Server wird über eine JSON-Datei konfiguriert:

Öffnen Sie /etc/drovio-server/settings.conf.

Öffnen Sie C:\ProgramData\Drovio\Drovio Server\settings.conf.

Die Konfiguration liegt im JSON-Format vor. Jedes Feld ist in der Konfigurationsreferenz beschrieben.

Ihr JWT-Geheimnis

http.jwt_secret signiert die Sitzungen der Benutzer und die Token an der API. Seit Version 3.6.7 erzeugt jede Installation beim ersten Start ein Geheimnis, ob über die Installationsprogramme für Windows und Linux oder über die Docker-Images. Sie müssen nichts tun.

Installationen, die mit Version 3.6.6 oder älter bereitgestellt wurden, trugen den im Paket ausgelieferten Wert. Ersetzen Sie ihn durch eine eigene Zufallszeichenfolge, etwa die Ausgabe von openssl rand -base64 32. Angemeldete Benutzer werden dadurch abgemeldet.

Weiterführende Themen