Managing domains

Once you have configured vmm you may start with management. Before you create accounts or aliases you must create a domain. What you can do besides creating domains is written on down here.

Creating a domain

Syntax:

• vmm domainadd domainname [transport]
  vmm da domainname [transport]

Domains will be created with this subcommand.
When a domain is created the directory of the domain will be also created.
Optionally you could specify a transport, which differs from the configured one. This transport will be the default transport for all accounts you create in this domain.

The following example shows the creation of the domains example.org and pаypal.tld. For the domain pаypal.tld a deviating transport is indicated.

hostname ~ # vmm domainadd example.org
hostname ~ # vmm da pаypal.tld virtual:
hostname ~ #

Domain information

Syntax:

• vmm domaininfo domainname [details]
  vmm di domainname [details]

This subcommand is used to display information about a domain.
Optionally you may specify the argument details. Possible values for details are:

accounts

to list additionally all existing accounts

aliasdomains

to list additionally all assigned alias domains

aliases

to list additionally all available aliases addresses

relocated

to list additionally all relocated users

full

to list additionally all information mentioned above

The following example shows retrieving domain information:

hostname ~ # vmm domaininfo pаypal.tld
Domain information
------------------
        Domainname.....: xn--pypal-4ve.tld (pаypal.tld)
        GID............: 70676
        Transport......: dovecot:
        Domaindir......: /srv/mail/x/70676
        Aliasdomains...: 0
        Accounts.......: 0
        Aliases........: 0
        Relocated......: 0

hostname ~ # vmm di example.com relocated
Domain information
------------------
        Domainname.....: example.com
        GID............: 70312
        Transport......: dovecot:
        Domaindir......: /srv/mail/8/70312
        Aliasdomains...: 0
        Accounts.......: 33
        Aliases........: 1
        Relocated......: 2

Available relocated users
-------------------------
        b.user@example.com
        z.user@example.com

hostname ~ #

Modifying transport

Syntax:

• vmm domaintransport domainname transport [force]
  vmm dt domainname transport [force]

Use this subcommand if you want to specify another transport for accounts that will be created from now on.
If the new transport should be used also for all existing accounts you have to give the keyword force.

Example: Modifying the default transport of the domain pаypal.tld:

hostname ~ # vmm dt pаypal.tld dovecot:
hostname ~ #

Deleting Domains

Syntax:

• vmm domaindelete domainname [delalias|deluser|delall]
  vmm dd domainname [delalias|deluser|delall]

If a domain is no longer used, it can be deleted with the subcommand domaindelete, resp. its short form dd.
Depending on your configuration it may happen that vmm will warn you about existing accounts and/or aliases. In this case the requested action will be aborted. If you are sure, the domain should be deleted with all of its accounts and/or alias addresses, you have to specify one of the following keywords:

delalias

to enforce the deletion of the domain incl. all of its alias addresses

deluser

to enforce the deletion of the domain incl. all of its accounts

delall

to enforce the deletion of the domain incl. all of its accounts and aliases

Existing entries in the relocated table as well as possible alias domains, which are assigned to the domain that should be deleted, will be implicitly deleted.

Example: Deleting a domain:

hostname ~ # vmm domaindelete whatever.tld
hostname ~ #