Aliases in Unified Configuration

From Messaging Server Technical Reference Wiki
Jump to: navigation, search


In Unified Configuration, plain MTA aliases (but see also Aliases in LDAP) are set as a named set of options under an alias group. At the simplest, an alias can be set as:


msconfig> set alias:alias-with-quoted-periods.alias_entry address-or-alias

e.g.,


msconfig> set alias:first\.last@subdomain\.domain.\com.alias_entry "mailbox@mailhost.domain.com"

where the alias-with-quoted-periods (appearing between alias: and .alias_entry) is the alias, and the value on the right hand side is an address or alias to which the alias translates.

Note that each period in the alias name itself must be quoted with the backslash character. After the alias name, an unquoted period marks the end of the alias name, and the start of an alias option. The alias_entry option is required, being the fundamental definition of the alias; additional alias options are optional.

An alias may translate to multiple addresses or aliases, (forming a so-called mail group). For such an alias, use multiple set commands, e.g.,


msconfig> set alias:first\.last@subdomain\.domain.\com.alias_entry "mailbox@mailhost.domain.com"
msconfig> set alias:first\.last@subdomain\.domain.\com.alias_entry "remote-mailbox@remote-domain.com"

Optionally, other alias options in addition to alias_entry may be set on an alias. Such optional alias options are especially relevant when defining a mailing list (which is merely a specially decorated form of alias, from the MTA's point of view), but may also be set on individual user aliases, e.g.:


msconfig> set alias:first\.last@subdomain\.domain\.com.alias_blocklimit 200

As an alternative to using msconfig set commands, you may instead issue the command edit aliases within msconfig to enter an interactive mode of editting aliases as if they were in the legacy configuration alias file; use :q to quit interactive editting mode, or :x to save your edits and exit interactive editting mode.


See also: