Adding a New Domain

Once SmarterMail has been installed, it's time to start adding domains.

Just a few pieces of information are needed in order to add a domain. Once this information is provided, the new domain is set up using the Domain Defaults that have been configured. However, system administrators can always modify any Domain Details as needed by simply clicking on its name on the Domains page.

Adding a Domain

To create a new domain, click the New button within the Domains section. The following custom configuration options will be available:

• Name - The name of the domain. For example, smartermail.com or example.com.
  Note: SmarterMail validates the domain name before it will let you save it. The name cannot start or end with a hyphen, and it cannot contain "-." or ".-" anywhere in it. Standard ASCII domain names must be 64 characters or less. Domains using non-Western/Unicode characters (Internationalized Domain Names, or IDNs) are also supported and are validated using their own set of rules for valid Unicode domain syntax. Additionally, the name cannot match one of SmarterMail's internally reserved domain names, and it must be unique across the server — you cannot add a domain name (or domain alias) that is already in use elsewhere on the installation.
• Hostname - The URL of the mail server (e.g., mail.domain.com) to be returned for an Autodiscover query by a user of that domain. This will also act as the URL for users to log in to the webmail client. SmarterMail will default this to mail.your-domain-name.com based on the Domain Defaults that are pre-configured on a new installation of SmarterMail. However, hostnames can be edited as needed and that default can be set to whatever the system administrator wants it to be.
• Folder - The directory in which all information (XML files, mail statistics, alias information, etc.) pertaining to the domain is saved.
Note: If the directory does not already exist, it will be created. This directory should be solely dedicated to SmarterMail. By default, SmarterMail saves domain information to c:\SmarterMail\Domains\.
• Split Domain - (Available in SmarterMail HA ONLY) This denotes that the domain being added will be split between 2 or more nodes in a SmarterMail HA cluster.
  Note: When a domain is created as a split domain, Folder Sharing and the Global Address List are automatically disabled for it, regardless of what is set in Domain Defaults, since sharing and the GAL only work reliably within a single node. In addition, SmarterMail checks for username conflicts across every node that will host part of the domain, since a single split domain cannot have two different users on two different nodes both trying to use the same username.
• Primary Domain Administrator Username - The primary domain administrator is responsible for adding and deleting email accounts and setting specific configurations for the domain. Domain administrator accounts also have the ability to send and receive email, manage contacts, etc., just like a user account. Enter the identifier the domain administrator will use to log into SmarterMail. Enter only the username, not the full address. For example, the "jdoe" portion of "jdoe@example.com".
  Note: The username is limited to 64 bytes, which is generally 64 standard ASCII characters (fewer if using multi-byte Unicode characters).
• Primary Domain Administrator Password - Enter the password associated to the domain administrator username.

Split Domains (SmarterMail HA ONLY)

Split domains are highlighted in the Domains list with a icon displaying two arrows pointing in opposite directions. A split domain is just that: a single domain whose mailboxes are split across 2 or more nodes. Splitting a domain is a good idea if the domain has a large number of mailboxes, or if it's an important customer whom you don't want temporarily affected should a node go down. Splitting accounts across multiple nodes increases the efficiency and resiliency of the domain in general, and it can help limit resource usage if the accounts are particularly busy or of very high use. Users can even be moved between nodes if their usage increases. For ISPs and hosting companies, a domain can be split if some users require additional features or services, such as MAPI & EWS access, EAS access, file storage, etc. These customers on tiered email hosting plans be be on one node while standard POP or IMAP customers are on another.

If a domain is split, it's worth noting that the information displayed for each instance of a split domain is pertinent only to that particular part of the domain on that particular node. For example:

In this screenshot, the Users and Disk Space only pertain to the domain on their respective nodes. So the domain on "node1" has 7 users, the domain on "node2" has 8 users. That means the total users for "split.smartertools.io" is 15, split across two nodes.

Important Notes Regarding Split Domains

• The GAL, Shared Resources and Sharing are disabled, by default. System administrators can turn these on, but when enabled, things like sharing and the GAL are only available to mailboxes on the same node. There is no sharing or GAL across nodes at this time. Therefore, if a group of mailboxes require sharing, they should all be placed on the same node.
• Mailing Lists for split domains can only be enabled on one node at a time. Therefor, if various users require access to their mailing lists, they all must be on the same node.