===== vmm=====-----------------------------------------------------------------------------Kommandozeilenprogramm zur Verwaltung von E-Mail-Domains, -Konten und -Aliase-----------------------------------------------------------------------------:Author: Pascal Volk <neverseen@users.sourceforge.net>:Date: 2010-01-30:Version: vmm-0.6.0:Manual group: vmm Manual:Manual section: 1..contents:::backlinks: top:class: htmloutSYNOPSIS========vmm *Unterbefehl**Objekt* [ *Argumente* ]BESCHREIBUNG============**vmm** (a virtual mail manager) ist ein Kommandozeilenprogramm fürAdministratoren/Postmaster zur Verwaltung von (Alias-) Domains, Konten undAlias-Adressen. Es wurde entwickelt für Dovecot und Postfix mit einemPostgreSQL-Backend.UNTERBEFEHLE============Von jedem Unterbefehl gibt es jeweils eine lange und kurze Variante. DieKurzform ist in Klammern geschrieben. Bei beiden Formen ist dieGroß-/Kleinschreibung zu berücksichtigen.ALLGEMEINE UNTERBEFEHLE-----------------------.._configure:``configure (cf) [ Sektion ]`` Startet den interaktiven Konfiguration-Modus für alle Sektionen der Konfiguration. Dabei wird der aktuell konfigurierte Wert einer jeden Option in eckigen Klammern ausgegeben. Sollte kein Wert konfiguriert sein, wird der Vorgabewert der jeweiligen Option in in eckigen Klammern angezeigt. Um den angezeigten Wert unverändert zu übernehmen, ist dieser mit der Eingabe-Taste zu bestätigen. Wurde das optionale Argument *Sektion* angegeben, werden nur die Optionen der angegebenen Sektion angezeigt und können geändert werden. Folgende Sektionen sind vorhanden:| - **account**| - **bin**| - **database**| - **domain**| - **maildir**| - **misc** Beispiel:: vmm configure domain Verwende Konfigurationsdatei: /usr/local/etc/vmm.cfg * Konfigurations Sektion: „domain“ Neuer Wert für Option directory_mode [504]: Neuer Wert für Option delete_directory [False]: 1 Neuer Wert für Option auto_postmaster [True]: Neuer Wert für Option force_deletion [False]: on.._getuser:``getuser (gu) userid`` Wenn nur eine UserID vorhanden ist, zum Beispiel aus der Prozessliste, kann mit dem Unterbefehl **getuser** die E-Mail-Adresse des Users ermittelt werden. Beispiel:: vmm getuser 70004 Account Informationen --------------------- UID............: 70004 GID............: 70000 Address........: c.user@example.com.._listdomains:``listdomains (ld) [ Muster ]`` Dieser Unterbefehl listet alle verfügbaren Domains auf. Allen Domains wird ein Präfix vorangestellt. Entweder ein '[+]', falls es sich um eine primäre Domain handelt, oder ein '[-]', falls es sich um eine Alias-Domain handelt. Die Ausgabe kann reduziert werden, indem ein optionales *Muster* angegeben wird. Um eine Wildcard-Suche durchzuführen kann das **%**-Zeichen am Anfang und/oder Ende des *Musters* verwendet werden. Beispiel:: vmm listdomains %example% Übereinstimmende Domains ------------------------ [+] example.com [-] e.g.example.com [-] example.name [+] example.net [+] example.org.._help:``help (h)`` Dieser Unterbefehl gibt alle verfügbaren Kommandos auf der Standardausgabe (stdout) aus. Danach beendet sich **vmm**..._version:``version (v)`` Gibt Versionsinformationen zu **vmm** aus.DOMAIN UNTERBEFEHLE-------------------.._domainadd:``domainadd (da) Domain [ Transport ]`` Fügt eine neue *Domain* in die Datenbank ein und erstellt das Domain-Verzeichnis. Ist das optionale Argument *Transport* angegeben, wird der Vorgabe-Transport (|misc.transport|_) aus |vmm.cfg(5)|_ für diese *Domain* ignoriert und der angegebene *Transport* verwendet. Der angegebene*Transport* ist gleichzeitig der Vorgabe-Transport für alle neuen Konten, die unter dieser Domain eingerichtet werden. Beispiele:: vmm domainadd support.example.com smtp:mx1.example.com vmm domainadd sales.example.com.._domaininfo:``domaininfo (di) Domain [ Details ]`` Dieser Unterbefehl zeigt Information zur angegeben *Domain* an. Um detaillierte Informationen über die *Domain* zu erhalten, kann das optionale Argument *Details* angegeben werden. Ein möglicher Wert für*Details* kann eines der folgenden fünf Schlüsselwörter sein:``accounts`` um alle existierenden Konten aufzulisten``aliasdomains`` um alle zugeordneten Alias-Domains aufzulisten``aliases`` um alle verfügbaren Alias-Adressen aufzulisten``relocated`` um alle Adressen der relocated Users aufzulisten``full`` um alle oben genannten Informationen aufzulisten Beispiel:: vmm domaininfo sales.example.com Domain Informationen -------------------- Domainname.....: sales.example.com GID............: 70002 Transport......: dovecot: Domaindir......: /home/mail/5/70002 Aliasdomains...: 0 Accounts.......: 0 Aliases........: 0 Relocated......: 0.._domaintransport:``domaintransport (dt) Domain Transport [ force ]`` Ein neuer *Transport* für die angegebene *Domain* kann mit diesem Unterbefehl festgelegt werden. Wurde das optionale Schlüsselwort **force** angegeben, so werden alle bisherigen Transport-Einstellungen, der in dieser Domain vorhandenen Konten, mit dem neuen *Transport* überschrieben. Andernfalls gilt der neue *Transport* nur für Konten, die zukünftig erstellt werden. Beispiel:: vmm domaintransport support.example.com dovecot:.._domaindelete:``domaindelete (dd) Domain [ delalias | deluser | delall ]`` Mit diesem Unterbefehl wird die angegebene *Domain* gelöscht. Sollten der *Domain* Konten und/oder Aliase zugeordnet sein, wird **vmm** die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden. Sollten Sie sich Ihres Vorhabens sicher sein, so kann optional eines der folgenden Schlüsselwörter angegeben werden: **delalias**, **deluser** oder **delall**. Sollten Sie wirklich immer wissen was Sie tun, so editieren Sie Ihre*vmm.cfg* und setzen den Wert der Option |domain.force_deletion|_ auf true. Dann werden Sie beim Löschen von Domains nicht mehr wegen vorhanden Konten/Aliase gewarnt.ALIAS-DOMAIN UNTERBEFEHLE-------------------------.._aliasdomainadd:``aliasdomainadd (ada) Aliasdomain Zieldomain`` Mit diesem Unterbefehl wird der *Zieldomain* die Alias-Domain*Aliasdomain* zugewiesen. Beispiel:: vmm aliasdomainadd example.name example.com.._aliasdomaininfo:``aliasdomaininfo (adi) Aliasdomain`` Dieser Unterbefehl informiert darüber, welcher Domain die Alias-Domain*Aliasdomain* zugeordnet ist. Beispiel:: vmm aliasdomaininfo example.name Alias-Domain Informationen -------------------------- Die Alias-Domain example.name gehört zu: * example.com.._aliasdomainswitch:``aliasdomainswitch (ads) Aliasdomain Zieldomain`` Wenn das Ziel der vorhandenen *Aliasdomain* auf eine andere *Zieldomain* geändert werden soll, ist dieser Unterbefehl zu verwenden. Beispiel:: vmm aliasdomainswitch example.name example.org.._aliasdomaindelete:``aliasdomaindelete (add) Aliasdomain`` Wenn die Alias-Domain mit dem Namen *Aliasdomain* gelöscht werden soll, ist dieser Unterbefehl zu verwenden. Beispiel:: vmm aliasdomaindelete e.g.example.comKONTO UNTERBEFEHLE------------------.._useradd:``useradd (ua) Adresse [ Passwort ]`` Mit diesem Unterbefehl wird ein neues Konto für die angegebene *Adresse* angelegt. Wurde kein *Passwort* angegeben wird **vmm** dieses im interaktiven Modus erfragen. Beispiele:: vmm ua d.user@example.com 'A 5ecR3t P4s5\\/\\/0rd' vmm ua e.user@example.com Neues Passwort eingeben: Neues Passwort wiederholen:.._userinfo:``userinfo (ui) Adresse [ Details ]`` Dieser Unterbefehl zeigt einige Informationen über das Konto mit der angegebenen *Adresse* an. Wurde das optionale Argument *Details* angegeben, werden weitere Informationen ausgegeben. Mögliche Werte für *Details* sind:``aliases`` um alle Alias-Adressen, mit dem Ziel *Adresse*, aufzulisten``du`` um zusätzlich die Festplattenbelegung des Maildirs eines Kontos anzuzeigen. Soll die Festplattenbelegung jedes Mal mit der **userinfo** ermittelt werden, ist in der *vmm.cfg* der Wert der Option |account.disk_usage|_ auf true zu setzen.``full`` um alle oben genannten Informationen anzuzeigen.._username:``username (un) Adresse 'Bürgerlicher Name'`` Der Bürgerliche Name des Konto-Inhabers mit der angegebenen *Adresse* kann mit diesem Unterbefehl gesetzt/aktualisiert werden. Beispiel:: vmm un d.user@example.com 'John Doe'.._userpassword:``userpassword (up) Adresse [ Passwort ]`` Das *Passwort* eines Kontos kann mit diesem Unterbefehl aktualisiert werden. Wurde kein *Passwort* angegeben wird **vmm** dieses im interaktiven Modus erfragen. Beispiel:: vmm up d.user@example.com 'A |\\/|0r3 5ecur3 P4s5\\/\\/0rd?'.._usertransport:``usertransport (ut) Adresse Transport`` Mit diesem Unterbefehl kann ein abweichender *Transport* für das Konto mit der angegebenen *Adresse* bestimmt werden. Beispiel:: vmm ut d.user@example.com smtp:pc105.it.example.com.._userdisable:``userdisable (u0) Adresse [ Service ]`` Soll ein Anwender keinen Zugriff auf einen oder alle Service haben, kann der Zugriff mit diesem Unterbefehl beschränkt werden. Wurde weder ein *Service* noch das Schlüsselwort **all** angegeben, werden alle Services (**smtp**, **pop3**, **imap**, und **sieve**) für das Konto mit der angegebenen *Adresse* deaktiviert. Andernfalls wird nur der Zugriff auf den angegeben *Service* gesperrt. Beispiele:: vmm u0 b.user@example.com imap vmm userdisable c.user@example.com.._userenable:``userenable (u1) Adresse [ Service ]`` Um den Zugriff auf bestimmte oder alle gesperrten Service zu gewähren, wird dieser Unterbefehl verwendet. Wurde weder ein *Service* noch das Schlüsselwort **all** angegeben, werden alle Services (**smtp**, **pop3**, **imap**, und **sieve**) für das Konto mit der angegebenen *Adresse* aktiviert. Andernfalls wird nur der Zugriff auf den angegeben *Service* gestattet..._userdelete:``userdelete (ud) Adresse [ delalias ]`` Verwenden Sie diesen Unterbefehl um, das Konto mit der angegebenen*Adresse* zu löschen. Sollte es einen oder mehrere Aliase geben, deren Zieladresse mit der*Adresse* des zu löschenden Kontos identisch ist, wird **vmm** die Ausführung des Befehls mit einer entsprechenden Fehlermeldung beenden. Um dieses zu umgehen, kann das optionale Schlüsselwort **delalias** angegebenen werden.ALIAS UNTERBEFEHLE------------------.._aliasadd:``aliasadd (aa) Alias Ziel`` Mit diesem Unterbefehl werden neue Aliase erstellt. Beispiele:: vmm aliasadd john.doe@example.com d.user@example.com vmm aa support@example.com d.user@example.com vmm aa support@example.com e.user@example.com.._aliasinfo:``aliasinfo (ai) Alias`` Informationen zu einem Alias können mit diesem Unterbefehl ausgegeben werden. Beispiel:: vmm aliasinfo support@example.com Alias Informationen ------------------- E-Mails für support@example.com werden weitergeleitet an: * d.user@example.com * e.user@example.com.._aliasdelete:``aliasdelete (ad) Alias [ Ziel ]`` Verwenden Sie diesen Unterbefehl um den angegebenen *Alias* zu löschen. Wurde die optionale Zieladresse *Ziel* angegeben, so wird nur diese Zieladresse vom angegebenen *Alias* entfernt. Beispiel:: vmm ad support@example.com d.user@example.comRELOCATED UNTERBEFEHLE----------------------.._relocatedadd:``relocatedadd (ra) alte_adresse neue_adresse`` Um einen neuen relocated User anzulegen kann dieser Unterbefehl verwendet werden. Dabei ist *alte_adresse* die ehemalige Adresse des Benutzers, zum Beispiel b.user@example.com, und *neue_adresse* die neue Adresse, unter der Benutzer erreichbar ist. Beispiel:: vmm relocatedadd b.user@example.com b-user@company.tld.._relocatedinfo:``relocatedinfo (ri) alte_adresse`` Dieser Unterbefehl zeigt die neue Adresse des relocated Users mit*alte_adresse*. Beispiel:: vmm relocatedinfo b.user@example.com Relocated Informationen ----------------------- Der Benutzer „b.user@example.com“ ist erreichbar unter „b-user@company.tld“.._relocateddelete:``relocateddelete (rd) alte_adresse`` Mit diesem Unterbefehl kann der relocated User mit *alte_adresse* gelöscht werden. Beispiel:: vmm relocateddelete b.user@example.comDATEIEN=======*/root/vmm.cfg* | Wird verwendet, falls vorhanden.*/usr/local/etc/vmm.cfg* | Wird verwendet, sollte obige Datei nicht gefunden werden.*/etc/vmm.cfg* | Wird verwendet, falls obengenannte Dateien nicht existieren.SIEHE AUCH==========|vmm.cfg(5)|_COPYING=======vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschriebenund sind unter den Bedingungen der BSD Lizenz lizenziert...include:: ../../substitute_links.rst..include:: ../../substitute_links_1.rst