Zum Hauptinhalt springen

Betrieb

Dieses Kapitel beschreibt die Konfiguration des CMS-Servers. In NeuroomNet-Installationen übernimmt das die Installation, die Werte stehen dort in etcd.

Konfiguration​

Der Server liest beim Start:

  1. config.json im Serververzeichnis,
  2. config.custom.json daneben (überschreibt einzelne Schlüssel),
  3. etcd, falls die Umgebungsvariablen ETCD_HOST und ETCD_REALM gesetzt sind. Gelesen werden alle Schlüssel unter <ETCD_REALM>[.<ETCD_NAMESPACE>].cms., Punkte im Schlüssel ergeben verschachtelte Objekte, Werte sind JSON. Beispiel: neuroomnet.nn.cms.httpPort → 29912.
SchlüsselBedeutung
dbUriMongoDB-Verbindung inkl. Datenbankname, z. B. mongodb://localhost:27017/cms
dbConfigzusätzliche Optionen für den MongoDB-Treiber
httpPortPort des Webservers, Voreinstellung in config.json: 29912
httpAuthAnmeldeverfahren: ./auth/basic oder ./auth/oidc (siehe Anmeldung)
webAdmin, webAdminPassName und Kennwort des Administrator-Kontos
ignoreAccountCaseKontennamen ohne Unterscheidung von Groß- und Kleinschreibung (verhindert Konten, die sich nur darin unterscheiden)
diskUploadHochgeladene Dateien vor der Übernahme auf der Festplatte zwischenspeichern statt im Speicher
oidcEinstellungen für OIDC, siehe Anmeldung
headerSSOEinstellungen für Header-SSO, siehe Anmeldung
previewAdmin, previewAdminPass, previewDatabaseZugang und Ablage des eingebauten Vorschau-Servers

Mediendateien liegen in der MongoDB (GridFS). Eine Sicherung der Datenbank umfasst also auch die Dateien.

Verschlüsselung​

Liegen im Serververzeichnis die Dateien ssl.crt und ssl.key mit Inhalt, startet der Server mit HTTPS, sonst mit HTTP. In NeuroomNet-Installationen läuft das CMS hinter nginx, der die Verschlüsselung übernimmt (Port 444).

Erweiterungen​

Das CMS kann beim Start Erweiterungen (Plugins) laden, die eigene Endpunkte und Aktionen ergänzen. Welche geladen sind, melden /version und /plugins. Die Plugin-Schnittstelle ist hier nicht beschrieben.