vmm verwenden

vmm ist das leicht zu verwendende Kommandozeilen Tool des Virtual Mail Managers. Es ermöglicht eine einfache und schnelle Administration des Mailservers. Die allgemeine Kommandosyntax sieht wie folgt aus:

vmm Unterbefehl Objekt [ Argument ]

Von jedem Unterbefehl gibt es jeweils eine lange und kurze Variante. Bei beiden Formen ist die Groß-/Kleinschreibung zu berücksichtigen. Die Unterbefehle sind nach ihrer Funktionalität zusammengefasst:

• Allgemeine Unterbefehle, siehe unten

• Domain Unterbefehle

• Alias-Domain Unterbefehle

• Account Unterbefehle

• Alias-Adresse Unterbefehle

• Relocated Unterbefehle

Ein Objekt ist je nach Kontext:

• ein Domain-Name
• eine E-Mail-Adresse
• eine UID

Aber zu jeder Regel gehören auch Ausnahmen. Der Großteil der allgemeinen Unterbefehle funktioniert ohne die Angabe eines Objekts.

vmm konfigurieren

Syntax:

• vmm configure [Abschnitt]
  vmm cf [Abschnitt]

Der Unterbefehl configure startet den interaktiven Konfiguration-Modus für alle Konfigurations-Abschnitte. Wurde das optionale Argument Abschnitt angegeben, werden nur die Optionen des angegebenen Abschnitts angezeigt und können geändert werden. In VmmConfig sind alle Konfigurations-Optionen beschrieben.
Folgende Abschnitte sind vorhanden:

• database
• maildir
• services
• domdir
• bin
• misc

Das folgende Beispiel zeigt die Neukonfiguration des Konfigurations-Abschnitts database:

hostname ~ # vmm configure database
Verwende Konfigurationsdatei: /usr/local/etc/vmm.cfg

* Konfigurations Abschnitt: „database“
Neuer Wert für Option host [10.11.12.13]: 10.11.12.246
Neuer Wert für Option user [usr_4711]: vmm
Neuer Wert für Option name [mailsys]:
Neuer Wert für Option pass [2w41r65qba15rf4ucr]:

hostname ~ #

E-Mail-Adresse anhand der UID ermitteln

Syntax:

• vmm getuser userid
  vmm gu userid

Sollte nur die UID eines Benutzers verfügbar sein, zum Beispiel aus der Prozessliste, kann mit dem Unterbefehl getuser die dazugehörige E-Mail-Adresse ermittelt werden.
Beispiel:

hostname ~ # vmm getuser 79801
Account Informationen
---------------------
        UID............: 79801
        GID............: 70312
        Address........: john.doe@example.com

hostname ~ #

Domains auflisten/suchen

Syntax:

• vmm listdomains [Muster]
  vmm ld [Muster]

Dieser Unterbefehl ermöglicht es, alle eingerichteten Domains aufzulisten. Dabei wird allen Domain-Namen entweder '[+]', für primäre Domains, oder '[-]', für Alias-Domains, vorangestellt. Die Ausgabe kann durch die Angabe ein optionales Suchmusters reduziert werden.
Um eine Wildcard-Suche durchzuführen, kann dem Muster am Anfang und/oder Ende ein %-Zeichen angefügt werden.

Folgendes Beispiel zeigt die Suche nach allen Domains, deren Namen mit 'example.' anfängt:

hostname ~ # vmm listdomains example.%
Übereinstimmende Domains
------------------------
        [+] example.com
        [-]     example.net
        [+] example.org

hostname ~ #

Übersicht Unterbefehle

Syntax:

• vmm help
  vmm h

Verwenden Sie diesen Unterbefehl, um sich eine Übersicht aller verfügbaren Unterbefehle anzeigen zu lassen.

Versionsinformationen

Syntax:

• vmm version
  vmm v

Dieser Unterbefehl gibt die Version von vmm aus.
Beispiel:

[root@host ~]# vmm version
vmm, Version 0.5.2 (vom 09.09.2009)
Python 2.5.4 auf FreeBSD

vmm is free software and comes with ABSOLUTELY NO WARRANTY.
[root@host ~]#