Product Documentation

Creating MX Records for a Mail Exchange Server

Nov 21, 2014

Mail Exchange (MX) records are used to direct email messages across the Internet. An MX record contains an MX preference that specifies the MX server to be used. The MX preference values range from 0 through 65536. An MX record contains a unique MX preference number. You can set the MX preference and the TTL values for an MX record.

When an email message is sent through the Internet, a mail transfer agent sends a DNS query requesting the MX record for the domain name. This query returns a list of host names of mail exchange servers for the domain, along with a preference number. If there are no MX records, the request is made for the Address record of that domain. A single domain can have multiple mail exchange servers.

To add an MX record by using the command line interface

At the command prompt, type the following commands to add an MX record and verify the configuration:

  • add dns mxRec <domain> -mx <string> -pref <positive_integer> [-TTL <secs>]
  • show dns mxRec <domain>

Example

 
> add dns mxRec example.com -mx mail.example.com -pref 1 
 Done 
> show dns mxRec example.com 
1)      Domain : example.com    MX Name : mail.example.com 
        Preference :   1        TTL : 5 secs 
 Done 
> 

To modify or remove an MX record by using the command line interface

  • To modify an MX record, type the set dns mxRec command, the name of the domain for which the MX record is configured, the name of the MX record, and the parameters to be changed, with their new values.
  • To set the TTL parameter to its default value, type the unset dns mxRec command, the name of the domain for which the MX record is configured, the name of the MX record, and -TTL without any TTL value. You can use the unset dns mxRec command to unset only the TTL parameter.
  • To remove an MX record, type the rm dns mxRec command, the name of the domain for which the MX record is configured, and the name of the MX record.

To add an MX record by using the configuration utility

Navigate to Traffic Management > DNS > Records > Mail Exchange Records and create an MX record.