Konfigurationsdatei für vmm

vmm liest Konfigurationsparameter aus der Datei vmm.cfg. (vmm.cfg)

Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt wird mit dem in eckigen Klammern ’[’ und ’]’ eingefassten Namen des Abschnitts eingeleitet (z. B. [database]), gefolgt von ´Option = Wert´-Einträgen (z. B. host = 127.0.0.1).

Leerräume um das Gleichheitszeichen ’=’ und am Ende eine Wertes werden ignoriert.

Leerzeilen und Zeilen, die mit einer ’#’ oder einem ’;’ anfangen, werden ignoriert.

Jeder Wert ist von einem der folgenden Datentypen:

• Boolean, um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder ausgeschaltet/deaktiviert (false) ist
  Mögliche Werte für true sind: 1, yes, true und on.
  Mögliche Werte für false sind: 0, no, false und off.

• Int, eine Integer-Zahl, geschrieben ohne eine gebrochene oder dezimale Komponente
  Beispielsweise sind 1, 50 oder 321 Integer-Zahlen.

• String, eine Folge von Buchstaben und Zahlen
  Zum Beispiel: 'Wort', 'Hallo Welt' oder '/usr/bin/strings'

Suchreihenfolge

Standardmäßig sucht vmm die vmm.cfg in folgenden Verzeichnissen in dieser Reihenfolge:

• /root
  /usr/local/etc
  /etc
  

Die zuerst gefundene Datei wird verwendet.

• Bis einschließlich vmm-0.5 (Revision 105) ist das Konfigurationsverzeichnis hart codiert. Daher sucht vmm nach der Datei /usr/local/etc/vmm.cfg.

database-Abschnitt

Der database-Abschnitt wird verwendet, um die für den Datenbankzugriff benötigten Optionen festzulegen.

host

(String) Der Hostname oder die IP-Adresse des Datenbank-Servers

user

(String) Der Name des Datenbank-Benutzers

pass

(String) Das Passwort des Datenbank-Benutzers

name

(String) Name der zu verwendenden Datenbank

Beispiel:

[database]
host = localhost
user = vmm
pass = T~_:L4OYyl]TU?)
name = mailsys

maildir-Abschnitt

Im maildir-Abschnitt werden die für die Maildirs erforderlichen Optionen festgelegt.

name

(String) Standard-Name des Maildir-Verzeichnisses im Verzeichnis des jeweiligen Anwenders

folders

(String) Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die innerhalb des Maildirs erstellt werden sollen
Sollen innerhalb des Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein einzelner Doppelpunkt (’:’) als Wert zuzuweisen.

mode

(Int) Zugriffsbits des Maildirs in Dezimal-Schreibweise (Basis 10)
Beispiel: 'drwx------' → oktal 0700 → dezimal 448

diskusage

(Boolean) Mit dieser Option legt man fest, ob die aktuelle Festplattenbelegung des Maildirs mit den Accountinformationen ausgegeben werden

delete

(Boolean) Bestimmt, ob beim Löschen eines Accounts das Maildir rekursiv entfernt werden soll

Beispiel:

[maildir]
name = Maildir
folders = Drafts:Sent:Templates:Trash:INBOX.News
mode = 448
diskusage = false
delete = false

services-Abschnitt

Im services-Abschnitt werden die Standard-Beschränkungen für alle Konten festgelegt.

smtp

(Boolean) Legt fest, ob sich ein Anwender standardmäßig per SMTP einloggen können soll

pop3

(Boolean) Legt fest, ob sich ein Anwender standardmäßig per POP3 einloggen können soll

imap

(Boolean) Legt fest, ob sich ein Anwender standardmäßig per IMAP einloggen können soll

sieve

(Boolean) Legt fest, ob sich ein Anwender standardmäßig per MANAGESIEVE einloggen können soll

Beispiel:

[services]
smtp = true
pop3 = false
imap = true
sieve = true

domdir-Abschnitt

Im domdir-Abschnitt werden die Optionen der Domain-Verzeichnisse bestimmt.

base

(String) Alle Domain-Verzeichnisse werden unterhalb dieses Basis-Verzeichnisses angelegt

mode

(Int) Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis 10)
Beispiel: 'drwxrwx---' → octal 0770 → decimal 504

delete

(Boolean) Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain, inklusive aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll

Beispiel:

[domdir]
base = /srv/mail
mode = 504
delete = false

bin-Abschnitt

Der bin-Abschnitt wird verwendet, um Pfade zu Binaries, die von vmm benötigt werden, anzugeben.

dovecotpw

(String) Der absolute Pfad zum dovecotpw-Binary
Dieses wird verwendet, wenn als Passwort-Schema eines der folgenden verwendet wird: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5', 'LANMAN', 'NTLM' oder 'RPA'.

du

(String) Der absolute Pfad zu du
Dieses Binary wird verwendet, wenn die Festplattenbelegung eines Kontos ermittelt wird

postconf

(String) Der absolute Pfad zu Postfix’ postconf(1)
Dieses Binary wird verwendet, wenn vmm diverse Postfix-Einstellungen prüft, zum Beispiel virtual_alias_expansion_limit.

Beispiel:

[bin]
dovecotpw = /usr/sbin/dovecotpw
du = /usr/bin/du
postconf = /usr/sbin/postconf

misc-Abschnitt

Im misc-Abschnitt werden verschiedene Einstellungen festgelegt.

passwdscheme

(String) Passwort-Schema, in dem die Passwörter gespeichert werden
Für mögliche Werte siehe auch: dovecotpw -l

gid_mail

(Int) Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus mail_privileged_group der Datei dovecot.conf

forcedel

(Boolean) Legt fest, ob beim Löschen einer Domain alle vorhanden Konten und/oder Aliase, ohne Nachfrage, gelöscht werden sollen

transport

(String) Der Standard-Transport aller Domains und Konten

dovecotvers

(Int) Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version (siehe: dovecot --version).
Diese Option beeinflusst diverse Datenbankzugriffe. Da es zwischen Dovecot v1.0.x/v1.1.x und v1.2.x einige Änderungen gab. Zum Beispiel 11, falls dovecot --version den Wert 1.1.18 ausgibt.

Beispiel:

[misc]
passwdscheme = CRAM-MD5
gid_mail = 8
forcedel = false
transport = dovecot:
dovecotvers = 11

config-Abschnitt

Beim config-Abschnitt handelt es sich um einen internen Steuerungs-Abschnitt.

done

(Boolean) Diese Option hat den den Wert false, wenn vmm zum ersten Mal installiert wurde. Wenn die Datei vmm.cfg von Hand editiert wird, weisen Sie dieser Option abschließend den Wert true zu
Wird die Konfiguration über das Kommando vmm configure angepasst, wird der Wert dieser Option automatisch auf true gesetzt. Sollte diese Option den Wert false zugewiesen haben, so startet vmm beim nächsten Aufruf im interaktiven Konfigurations-Modus.

Beispiel:

[config]
done = true