man/de/man5/vmm.cfg.5.rst
branchv0.6.x
changeset 176 cc0d79842fdf
parent 170 d9ca5c46c1fa
child 177 ec2e1df8bb10
equal deleted inserted replaced
175:b241272eb1bd 176:cc0d79842fdf
     5 ---------------------------
     5 ---------------------------
     6 Konfigurationsdatei für vmm
     6 Konfigurationsdatei für vmm
     7 ---------------------------
     7 ---------------------------
     8 
     8 
     9 :Author:         Pascal Volk <neverseen@users.sourceforge.net>
     9 :Author:         Pascal Volk <neverseen@users.sourceforge.net>
    10 :Date:           2010-01-18
    10 :Date:           2010-01-25
    11 :Version:        vmm-0.6.0
    11 :Version:        vmm-0.6.0
    12 :Manual group:   vmm Manual
    12 :Manual group:   vmm Manual
    13 :Manual section: 5
    13 :Manual section: 5
    14 
    14 
    15 .. contents::
    15 .. contents::
    74 ACCOUNT
    74 ACCOUNT
    75 -------
    75 -------
    76 Die Optionen des Abschnitts **account** legen Konto-spezifische
    76 Die Optionen des Abschnitts **account** legen Konto-spezifische
    77 Einstellungen fest.
    77 Einstellungen fest.
    78 
    78 
    79 ``delete_directory`` : *Boolean*
    79 ``delete_directory (Vorgabe: false)`` : *Boolean*
    80     Bestimmt das Verhalten von **vmm**\(1) beim Löschen eines Kontos.
    80     Bestimmt das Verhalten von **vmm**\(1) beim Löschen eines Kontos.
    81     Wenn der Wert dieser Option *true* ist, wird das Home-Verzeichnis des
    81     Wenn der Wert dieser Option *true* ist, wird das Home-Verzeichnis des
    82     zu löschenden Anwenders rekursiv gelöscht.
    82     zu löschenden Anwenders rekursiv gelöscht.
    83 
    83 
    84 ``directory_mode`` : *Int*
    84 ``directory_mode (Vorgabe: 448)`` : *Int*
    85     Zugriffsbits des Home-Verzeichnisses, sowie aller enthaltenen
    85     Zugriffsbits des Home-Verzeichnisses, sowie aller enthaltenen
    86     Verzeichnisse, in Dezimal-Schreibweise (Basis 10).
    86     Verzeichnisse, in Dezimal-Schreibweise (Basis 10).
    87 
    87 
    88     | Beispiel: 'drwx------' -> oktal 0700 -> dezimal 448
    88     | Beispiel: 'drwx------' -> oktal 0700 -> dezimal 448
    89 
    89 
    90 ``disk_usage`` : *Boolean*
    90 ``disk_usage (Vorgabe: false)`` : *Boolean*
    91     Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes
    91     Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes
    92     Mal mit **du**\(1) ermittelt und mit den Konto-Informationen ausgegeben
    92     Mal mit **du**\(1) ermittelt und mit den Konto-Informationen ausgegeben
    93     werden soll.
    93     werden soll.
    94 
    94 
    95     Bei umfangreichen Maildirs kann das langsam sein. Falls Sie Quotas
    95     Bei umfangreichen Maildirs kann das langsam sein. Falls Sie Quotas
    96     aktiviert haben, wird der **vmm**-Unterbefehl **userinfo** ebenfalls
    96     aktiviert haben, wird der **vmm**-Unterbefehl **userinfo** ebenfalls
    97     die aktuelle Quota-Nutzung des Kontos mit ausgegeben. Sie können auch
    97     die aktuelle Quota-Nutzung des Kontos mit ausgegeben. Sie können auch
    98     eines der optionalen Argumente **du** oder **full** an **userinfo**
    98     eines der optionalen Argumente **du** oder **full** an **userinfo**
    99     übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu lassen.
    99     übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu lassen.
   100 
   100 
   101 ``imap`` : *Boolean*
   101 ``imap (Vorgabe: true)`` : *Boolean*
   102     Bestimmt, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
   102     Bestimmt, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.
   103 
   103 
   104 ``password_length`` : *Int*
   104 ``password_length (Vorgabe: 8)`` : *Int*
   105     Diese Option legt die Anzahl der Zeichen für automatisch erzeugte
   105     Diese Option legt die Anzahl der Zeichen für automatisch erzeugte
   106     Passwörter fest. Alle Werte kleiner als 8 werden auf 8 erhöht.
   106     Passwörter fest. Alle Werte kleiner als 8 werden auf 8 erhöht.
   107 
   107 
   108 ``pop3``
   108 ``pop3 (Vorgabe: true)`` : *Boolean*
   109     Bestimmt, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
   109     Bestimmt, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.
   110 
   110 
   111 ``random_password`` : *Boolean*
   111 ``random_password (Vorgabe: false)`` : *Boolean*
   112     Mit dieser Option wird bestimmt , ob **vmm**\(1) ein zufälliges Passwort
   112     Mit dieser Option wird bestimmt , ob **vmm**\(1) ein zufälliges Passwort
   113     generieren soll, wenn kein Passwort an den **useradd** Unterbefehl
   113     generieren soll, wenn kein Passwort an den **useradd** Unterbefehl
   114     übergeben wurde. Ist der Wert dieser Option *false*, wird **vmm** Sie
   114     übergeben wurde. Ist der Wert dieser Option *false*, wird **vmm** Sie
   115     auffordern, ein Passwort für den neun Account einzugeben.
   115     auffordern, ein Passwort für den neun Account einzugeben.
   116 
   116 
   117     Sie können die Länge für automatisch generierte Passwörter mit der
   117     Sie können die Länge für automatisch generierte Passwörter mit der
   118     Option **password_length** konfigurieren.
   118     Option **password_length** konfigurieren.
   119 
   119 
   120 ``sieve`` : *Boolean*
   120 ``sieve (Vorgabe: true)`` : *Boolean*
   121     Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden
   121     Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden
   122     können sollen.
   122     können sollen.
   123 
   123 
   124 ``smtp`` : *Boolean*
   124 ``smtp (Vorgabe: true)`` : *Boolean*
   125     Bestimmt, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden
   125     Bestimmt, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden
   126     können sollen.
   126     können sollen.
   127 
   127 
   128 Beispiel::
   128 Beispiel::
   129 
   129 
   141 BIN
   141 BIN
   142 ---
   142 ---
   143 Im **bin**-Abschnitt werden Pfade zu Binaries angegeben, die von
   143 Im **bin**-Abschnitt werden Pfade zu Binaries angegeben, die von
   144 **vmm**\(1) benötigt werden.
   144 **vmm**\(1) benötigt werden.
   145 
   145 
   146 ``dovecotpw`` : *String*
   146 ``dovecotpw (Vorgabe: /usr/sbin/dovecotpw)`` : *String*
   147     Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur
   147     Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur
   148     Hash-Erzeugung verwendet, wenn **misc.password_scheme** einen der
   148     Hash-Erzeugung verwendet, wenn **misc.password_scheme** einen der
   149     nachfolgenden Werte hat: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5',
   149     nachfolgenden Werte hat: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5',
   150     'LANMAN', 'NTLM' oder 'RPA'.
   150     'LANMAN', 'NTLM' oder 'RPA'.
   151 
   151 
   152 ``du`` : *String*
   152 ``du (Vorgabe: /usr/bin/du)`` : *String*
   153     Der absolute Pfad zu **du**\(1). Dieses Binary wird verwendet, wenn
   153     Der absolute Pfad zu **du**\(1). Dieses Binary wird verwendet, wenn
   154     die Festplattenbelegung eines Kontos ermittelt wird.
   154     die Festplattenbelegung eines Kontos ermittelt wird.
   155 
   155 
   156 ``postconf`` : *String*
   156 ``postconf (Vorgabe: /usr/sbin/postconf)`` : *String*
   157     Der absolute Pfad zu Postfix' **postconf**\(1). Dieses Binary wird
   157     Der absolute Pfad zu Postfix' **postconf**\(1). Dieses Binary wird
   158     verwendet, wenn **vmm**\(1) diverse Postfix-Einstellungen prüft, zum
   158     verwendet, wenn **vmm**\(1) diverse Postfix-Einstellungen prüft, zum
   159     Beispiel das `virtual_alias_expansion_limit`.
   159     Beispiel das `virtual_alias_expansion_limit`.
   160 
   160 
   161 Beispiel::
   161 Beispiel::
   168 CONFIG
   168 CONFIG
   169 ------
   169 ------
   170 Beim **config**-Abschnitt handelt es sich um einen internen
   170 Beim **config**-Abschnitt handelt es sich um einen internen
   171 Steuerungs-Abschnitt.
   171 Steuerungs-Abschnitt.
   172 
   172 
   173 ``done`` : *Boolean*
   173 ``done (Vorgabe: false)`` : *Boolean*
   174     Diese Option hat den Wert *false*, wenn **vmm**\(1) zum ersten Mal
   174     Diese Option hat den Wert *false*, wenn **vmm**\(1) zum ersten Mal
   175     installiert wurde. Wenn Sie die Datei *vmm.cfg* von Hand editieren,
   175     installiert wurde. Wenn Sie die Datei *vmm.cfg* von Hand editieren,
   176     weisen Sie dieser Option abschließend den Wert *true* zu. Wird die
   176     weisen Sie dieser Option abschließend den Wert *true* zu. Wird die
   177     Konfiguration über das Kommando **vmm configure** angepasst, wird der
   177     Konfiguration über das Kommando **vmm configure** angepasst, wird der
   178     Wert dieser Option automatisch auf *true* gesetzt.
   178     Wert dieser Option automatisch auf *true* gesetzt.
   188 DATABASE
   188 DATABASE
   189 --------
   189 --------
   190 Der **database**-Abschnitt wird verwendet, um die für den Datenbankzugriff
   190 Der **database**-Abschnitt wird verwendet, um die für den Datenbankzugriff
   191 benötigten Optionen festzulegen.
   191 benötigten Optionen festzulegen.
   192 
   192 
   193 ``host`` : *String*
   193 ``host (Vorgabe: localhost)`` : *String*
   194     Der Hostname oder die IP-Adresse des Datenbank-Servers.
   194     Der Hostname oder die IP-Adresse des Datenbank-Servers.
   195 
   195 
   196 ``name`` : *String*
   196 ``name (Vorgabe: mailsys)`` : *String*
   197     Der Name der zu verwendenden Datenbank.
   197     Der Name der zu verwendenden Datenbank.
   198 
   198 
   199 ``pass`` : *String*
   199 ``pass (Vorgabe: Nichts)`` : *String*
   200     Das Passwort des Datenbank-Benutzers.
   200     Das Passwort des Datenbank-Benutzers.
   201 
   201 
   202 ``user`` : *String*
   202 ``user (Vorgabe: Nichts)`` : *String*
   203     Der Name des Datenbank-Benutzers.
   203     Der Name des Datenbank-Benutzers.
   204 
   204 
   205 Beispiel::
   205 Beispiel::
   206 
   206 
   207     [database]
   207     [database]
   212 
   212 
   213 DOMAIN
   213 DOMAIN
   214 ------
   214 ------
   215 Im **domain**-Abschnitt werden Domain-spezifische Informationen konfiguriert.
   215 Im **domain**-Abschnitt werden Domain-spezifische Informationen konfiguriert.
   216 
   216 
   217 ``auto_postmaster`` : *Boolean*
   217 ``auto_postmaster (Vorgabe: true)`` : *Boolean*
   218     Ist der Wert dieser Option *true*, wird **vmm**\(1) beim Anlegen einer
   218     Ist der Wert dieser Option *true*, wird **vmm**\(1) beim Anlegen einer
   219     Domain automatisch einen postmaster-Account erstellen.
   219     Domain automatisch einen postmaster-Account erstellen.
   220 
   220 
   221 ``delete_directory`` : *Boolean*
   221 ``delete_directory (Vorgabe: false)`` : *Boolean*
   222     Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain,
   222     Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain,
   223     inklusive aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll.
   223     inklusive aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll.
   224 
   224 
   225 ``directory_mode`` : *Int*
   225 ``directory_mode (Vorgabe: 504)`` : *Int*
   226     Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis
   226     Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis
   227     10).
   227     10).
   228 
   228 
   229     | Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504
   229     | Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504
   230 
   230 
   231 ``force_deletion`` : *Boolean*
   231 ``force_deletion (Vorgabe: false)`` : *Boolean*
   232     Erzwingt das Löschen aller zugeordneten Konten und Aliase beim Löschen
   232     Erzwingt das Löschen aller zugeordneten Konten und Aliase beim Löschen
   233     einer Domain.
   233     einer Domain.
   234 
   234 
   235 Beispiel::
   235 Beispiel::
   236 
   236 
   243 MAILDIR
   243 MAILDIR
   244 -------
   244 -------
   245 Im **maildir**-Abschnitt werden die für die Maildirs erforderlichen Optionen
   245 Im **maildir**-Abschnitt werden die für die Maildirs erforderlichen Optionen
   246 festgelegt.
   246 festgelegt.
   247 
   247 
   248 ``folders`` : *String*
   248 ``folders (Vorgabe: Drafts:Sent:Templates:Trash)`` : *String*
   249     Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die
   249     Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die
   250     innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des
   250     innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des
   251     Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein
   251     Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein
   252     einzelner Doppelpunkt ('**:**') als Wert zuzuweisen.
   252     einzelner Doppelpunkt ('**:**') als Wert zuzuweisen.
   253 
   253 
   254     Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein
   254     Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein
   255     einzelner Punkt ('**.**') als Separator zu verwenden.
   255     einzelner Punkt ('**.**') als Separator zu verwenden.
   256 
   256 
   257 ``name`` : *String*
   257 ``name (Vorgabe: Maildir)`` : *String*
   258     Der Standard-Name des Maildir-Verzeichnisses im Verzeichnis des
   258     Der Standard-Name des Maildir-Verzeichnisses im Verzeichnis des
   259     jeweiligen Anwenders.
   259     jeweiligen Anwenders.
   260 
   260 
   261 Beispiel::
   261 Beispiel::
   262 
   262 
   266 
   266 
   267 MISC
   267 MISC
   268 ----
   268 ----
   269 Im **misc**-Abschnitt werden verschiedene Einstellungen festgelegt.
   269 Im **misc**-Abschnitt werden verschiedene Einstellungen festgelegt.
   270 
   270 
   271 ``base_directory`` : *String*
   271 ``base_directory (Vorgabe: /srv/mail)`` : *String*
   272     Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses
   272     Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses
   273     angelegt.
   273     angelegt.
   274 
   274 
   275 ``password_scheme`` : *String*
   275 ``password_scheme (Vorgabe: CRAM-MD5)`` : *String*
   276     Das zu verwendende Passwort-Schema (siehe auch: **dovecotpw -l**).
   276     Das zu verwendende Passwort-Schema (siehe auch: **dovecotpw -l**).
   277 
   277 
   278 ``gid_mail`` : *Int*
   278 ``gid_mail (Vorgabe: 8)`` : *Int*
   279     Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus
   279     Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus
   280     `mail_privileged_group` der Datei *dovecot.conf*.
   280     `mail_privileged_group` der Datei *dovecot.conf*.
   281 
   281 
   282 ``transport`` : *String*
   282 ``transport (Vorgabe: dovecot:)`` : *String*
   283     Der Standard-Transport aller Domains und Konten. Siehe auch:
   283     Der Standard-Transport aller Domains und Konten. Siehe auch:
   284     **transport**\(5)
   284     **transport**\(5)
   285 
   285 
   286 ``dovecot_version`` : *Int*
   286 ``dovecot_version (Vorgabe: 12)`` : *Int*
   287     Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version
   287     Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version
   288     (siehe: **dovecot --version**).
   288     (siehe: **dovecot --version**).
   289 
   289 
   290     Wenn das Kommando **dovecot --version** zum Beispiel *1.1.18* ausgibt,
   290     Wenn das Kommando **dovecot --version** zum Beispiel *1.1.18* ausgibt,
   291     ist dieser Option der Wert **11** zuzuweisen.
   291     ist dieser Option der Wert **11** zuzuweisen.