doc/web/source/howto/manage_alias_domains.rst
author Pascal Volk <user@localhost.localdomain.org>
Mon, 27 Aug 2012 20:49:31 +0000
changeset 594 cdbe200c0ecc
parent 591 2b165e90e225
permissions -rw-r--r--
VMM/serviceset: Fixed a conditional ProgrammingError. Affects only setups with Dovecot < v1.2.beta2. Actually the SQL query in method ServiceSet._load_by_services wasn't updated. Removed unnecessary code, which would have also produced a ProgrammingError, if it would have been correct.

======================
Managing alias domains
======================
An alias domain is an alias for a domain that was previously added with the
subcommand :ref:`domainadd`.
All accounts, aliases and relocated users from the domain will be also
available in the alias domain.
In the following is to be assumed that example.net is an alias for example.com.

Postfix will not accept erroneously e-mails for unknown.user\@example.net
and bounce them back later to the mostly faked sender.
Postfix will immediately reject all e-mails addressed to nonexistent users.

This behavior is ensured as long as you use the recommended database queries
in your :file:`{$config_directory}/pgsql-*.cf` configuration files.

aliasdomainadd
--------------
Syntax:
 | **vmm aliasdomainadd** *fqdn destination*
 | **vmm ada** *fqdn destination*

This subcommand adds the new alias domain (*fqdn*) to the *destination*
domain that should be aliased.

Example:

.. code-block:: console

 root@host:~# vmm aliasdomainadd example.net example.com

aliasdomaindelete
-----------------
Syntax:
 | **vmm aliasdomaindelete** *fqdn*
 | **vmm add** *fqdn*

Use this subcommand if the alias domain *fqdn* should be removed.

Example:

.. code-block:: console

 root@host:~# vmm aliasdomaindelete e.g.example.com

aliasdomaininfo
---------------
Syntax:
 | **vmm aliasdomaininfo** *fqdn*
 | **vmm adi** *fqdn*

This subcommand shows to which domain the alias domain *fqdn* is assigned to.

Example:

.. code-block:: console

 root@host:~# vmm adi example.net
 Alias domain information
 ------------------------
         The alias domain example.net belongs to:
             * example.com

aliasdomainswitch
-----------------
Syntax:
 | **vmm aliasdomainswitch** *fqdn destination*
 | **vmm aos** *fqdn destination*

If the destination of the existing alias domain *fqdn* should be switched
to another *destination* use this subcommand.

Example:

.. code-block:: console

 root@host:~# vmm aliasdomainswitch example.name example.org