This is an old revision of the document!


DNS Zone Template for sMX

Our sMX panel makes use of secondary MX record entries to facilitate mail delivery to the sMX server. MX records include a 'weight' value and this value is used to determine the priority of mailserver delivery. Secondary MX entries are determined by having a higher relative weight than the record associated with the primary mailserver. The numbers themselves are not relevant as absolute values so much as they are as compared to other weights. For instance, consider for mail1 and mail2 the following entries that will function identically:

example.com    3600   IN  MX  1   mail1.example.com
example.com    3600   IN  MX  2   mail2.example.com

example.com    3600   IN  MX  10   mail1.example.com
example.com    3600   IN  MX  20   mail2.example.com
 
example.com    3600   IN  MX  5      mail1.example.com
example.com    3600   IN  MX  2000   mail2.example.com

Mail1 would be considered the 'primary' mailserver and mail2 would be considered the 'secondary' mailserver in these cases. Wikipedia has a nice writeup on the function of weights for a more verbose description for the inquisitive:MX Record Priorities. For this tutorial, we'll stick to 0 for primary MX servers and 10 for secondary ones.

Editing the Zone Template

In order to allow newly create accounts to automatically be setup for use with an sMX server, the default zone templates need to be modified. In the WHM, jump to Main » DNS Functions » Edit Zone Templates and select the zone template you wish to edit. Please see this guide for information on which template to edit. A sample template for **standard* has been included below with the SMX modification.

; cPanel %cpversion%
; Zone file for %domain%
$TTL %ttl%
@      %nsttl%	IN      SOA     %nameserver%. %rpemail%. (
		%serial%	; serial, todays date+todays
		86400		; refresh, seconds
		7200		; retry, seconds
		3600000		; expire, seconds
		86400 )		; minimum, seconds
  
%domain%. %nsttl% IN NS %nameserver%.
%domain%. %nsttl% IN NS %nameserver2%.
%domain%. %nsttl% IN NS %nameserver3%.
%domain%. %nsttl% IN NS %nameserver4%.

%nameserverentry%. IN A %nameservera%
%nameserverentry2%. IN A %nameservera2%
%nameserverentry3%. IN A %nameservera3%
%nameserverentry4%. IN A %nameservera4%

%domain%. IN A %ip%

localhost.%domain%. IN A 127.0.0.1

%domain%. IN MX 0 %domain%.
%domain%. IN MX 10 smx.yourdomain.com. ; add this line and change to your SMX hostname

mail IN CNAME %domain%.
www IN CNAME %domain%.
ftp IN CNAME %domain%.

Note that the part that reads smx.yourdomain.com needs to be changed to a valid hostname for your sMX server. Once done performing the edit click the Save button and you're all set!

Existing Domain Zones

The sMX plugin will automatically install backup MX records for all of the existing zones on each clustered server. The zone template change above is for domains added after the initial sMX configuration.