grommunio-admin dbconf
grommunio-admin dbconf — Verwaltung datenbankgestützter Konfigurationen.
Zusammenfassung
Abschnitt betitelt „Zusammenfassung“grommunio-admin dbconf (commit | delete) SERVICE [FILE [KEY]]
grommunio-admin dbconf get SERVICE FILE [KEY]
grommunio-admin dbconf list [SERVICE [FILE [KEY]]]
grommunio-admin dbconf set [-b] [-i] [--] SERVICE FILE KEY VALUE
Beschreibung
Abschnitt betitelt „Beschreibung“grommunio dbconf bietet die Möglichkeit, Konfigurationen an einem einzigen Ort zu speichern und zu verwalten und sie gleichzeitig in verteilten Systemen verfügbar zu machen. Die Konfigurationen werden in der zentralen MySQL-Datenbank gespeichert und können über grommunio-dbconf(1) und grommunio-admin-dbconf(1) abgerufen werden.
Obwohl beide Tools im Wesentlichen die gleiche Funktionalität bieten, weist grommunio-dbconf(1) eine deutlich bessere Leistung auf und ist für den schnellen Zugriff auf die Konfiguration vorgesehen.
Konfigurationen bestehen aus Schlüssel-Wert-Paaren, die in Dateien organisiert und nach Diensten gruppiert sind. Jeder Dienst kann eine beliebige Anzahl von Konfigurationsdateien haben, die wiederum eine beliebige Anzahl eindeutiger Schlüssel enthalten können.
Befehle
Abschnitt betitelt „Befehle“commit
Commit-Hook für einen Dienst, eine Datei oder einen Schlüssel auslösen
delete
Dienst, Datei oder Schlüssel löschen
get
Datei oder einzelnen Schlüssel abrufen
list
Verfügbare Dienste, Dateien oder Schlüssel auflisten
set
Konfigurationsschlüssel festlegen
Optionen
Abschnitt betitelt „Optionen“SERVICE
Name des zu konfigurierenden Dienstes
FILE
Name der Konfigurationsdatei
KEY
Name des Konfigurationsschlüssels
VALUE
Im Schlüssel zu speichernder Wert
--
Gibt an, dass alle Optionen angegeben wurden und nun nur noch Namen folgen
-b, --batch
Nicht automatisch festschreiben
-i, --init
Nur setzen, wenn der Konfigurationsschlüssel noch nicht vorhanden ist
grommunio-admin
Abschnitt betitelt „grommunio-admin“Auch die Modelle grommunio-admin, API und CLI sind dbconf-Nutzer. Dadurch können Systemadministratoren bestimmte Konfigurationen ändern, ohne auf das Dateisystem zugreifen zu müssen und ohne dass ein Neustart des API erforderlich ist.
Die folgenden Dateien und Schlüssel sind aussagekräftig, wenn sie unter dem Dienst grommunio-admin abgelegt werden:
Mehrserver-Konfiguration
Abschnitt betitelt „Mehrserver-Konfiguration“policy
Richtlinie zur Serverauswahl für neu erstellte Benutzer und Domänen in Umgebungen mit mehreren Servern. Mögliche Werte sind balanced, first, last, random und round-robin. Die Standardeinstellung ist round-robin.
Commit-Hooks
Abschnitt betitelt „Commit-Hooks“Beim Ändern von Werten können potenzielle Nutzer über Commit-Hooks über diese Änderung informiert werden, beispielsweise durch einen Neustart des Dienstes unter Verwendung der Konfiguration. Aus Sicherheitsgründen stehen nur wenige Befehle auf der Whitelist zur Verfügung (siehe Abschnitt VERFÜGBARE COMMIT-BEFEHLE).
Commit-Hooks können auf den Ebenen key, file oder service definiert werden. set-Operationen lösen immer Commits auf Schlüsselebene aus, während der Befehl commit je nachdem, ob eine Datei oder ein Schlüssel angegeben ist, direkt Hooks auf Schlüssel- oder Dienstebene auslösen kann.
Wenn für eine bestimmte Auslösestufe kein Hook definiert ist, wird automatisch die nächstniedrigere Stufe in der Reihenfolge key > file > service.
Commit-Hooks für einen Dienst können durch die Einstellung der Schlüssel commit_key, commit_file und commit_service unter grommunio-dbconf/<service> auf einen gültigen Befehl gesetzt werden (siehe unten).
Verfügbare Commit-Befehle
Abschnitt betitelt „Verfügbare Commit-Befehle“Die folgenden Befehle stehen zur Verfügung:
Schlüssel
Abschnitt betitelt „Schlüssel“postconf -e $ENTRY
postconf -e $FILE_S && systemctl reload postfix
Service
Abschnitt betitelt „Service“systemctl reload $SERVICE
systemctl restart $SERVICE
Da es schwierig sein kann, sich die Befehle auf der Whitelist zu merken, und diese sich in Zukunft ändern können, stehen Makros zur Verfügung, die zu Befehlen auf der Whitelist erweitert werden.
Die folgenden Makros sind definiert:
Schlüssel
Abschnitt betitelt „Schlüssel“#POSTCONF -> postconf -e $ENTRY
#POSTCONF -> sudo postconf -e $FILE_S && systemctl reload postfix
Service
Abschnitt betitelt „Service“#RELOAD -> systemctl reload $SERVICE
#RESTART -> systemctl restart $SERVICE
Erweiterung von Befehlsvariablen
Abschnitt betitelt „Erweiterung von Befehlsvariablen“Befehle können Variablen enthalten, denen ein Präfix in der Form $ vorangestellt ist und die vor der Ausführung ersetzt werden. Das Literal $$ kann verwendet werden, um ein einzelnes $ zu erzeugen.
Die folgenden Variablen sind zulässig:
ENTRY
Wird zu $KEY=$VALUE erweitert (nur auf Schlüsselebene)
FILE
Der gesamte Inhalt der geänderten Datei als durch Zeilenumbrüche getrennte Schlüssel-Wert-Einträge (nur auf Dateiebene)
FILE_S
Der gesamte Inhalt der geänderten Datei als durch Leerzeichen getrennte Schlüssel-Wert-Einträge (nur auf Dateiebene)
FILENAME
Name der geänderten Datei (Schlüssel- und Dateiebene)
KEY
Der geänderte Schlüssel (nur auf Schlüsselebene)
SERVICE
Name des geänderten Dienstes
VALUE
Neuer Wert des geänderten Schlüssels (nur auf Schlüsselebene)
Siehe auch
Abschnitt betitelt „Siehe auch“grommunio-admin(1), grommunio-admin-config(1), grommunio-admin-mconf(1). grommunio-dbconf(1)