grommunio-dbconf — Database-stored configuration tool
Configurations consist of key/value pairs organized in files, grouped by service. Each service can have an arbitrary number of configuration files, which in turn can contain an arbitrary number of unique keys.
Trigger commit hook for service, file or key
Delete service, file or key
Get file or single key
List available services, files or keys
Set a configuration key
Name of the service to configure
Name of the configuration file
Name of the configuration key
Value to store in the key
Indicate that all options have been specified and only names follow
Do not auto-commit
Only set if configuration key does not exist yet
Increase verbosity level (up to 3) to produce more diagnostic output
When modifying values, potential consumers can be notified of this change via commit hooks, for example by restarting the service using the configuration. For security reasons only a few white-listed commands are available (see section AVAILABLE COMMIT COMMANDS).
Commit hooks can be defined on
set operations always trigger commits at key level, while the commit
command can directly trigger key or service level hooks depending on
whether a file or key is specified.
If no hook is defined for a specific trigger level, it automatically falls through to the next lower level, in the order key > file > service.
Commit hooks for a service can be defined by setting
commit_service keys under
grommunio-dbconf/<service> to a valid command (see below).
Available Commit Commands¶
The following commands are available:
postconf -e $ENTRY
There are currently no file-level commands.
systemctl reload $SERVICE
systemctl restart $SERVICE
Command Variable Expansion¶
Commands can contain $-prefixed variables that are expanded before execution. The literal $$ can be used to generate a single $.
The following variables are valid:
$KEY=$VALUE(key level only)
Complete content of the modified file as newline separated key=value entries (file level only)
Name of the modified file (key and file level)
The modified key (key level only)
Name of the modified service
New value of the modified key (key level only)
grommunio-admin, grommunio-admin-mconf, grommunio-dbconf