Adding an Additional Mail Host

---

If you want IMail Server to receive mail for a second e-mail domain that has its own users, you need to set up a virtual host for the second domain. For example, if your mail server provides mail service for the e-mail domain, domain1.com, and you also want it to provide mail service for another e-mail domain, domain2.com, you need to create a virtual host for domain2.com.

There are two types of virtual hosts:

• Virtual hosts with IP Addresses
• Virtual hosts without IP addresses

Note: Whether you use a virtual host with IP address or a virtual host without IP address, you need to make the proper DNS entries for your mail domain(s). See "Setting Up DNS for Multiple Mail Hosts" and your DNS documentation for information on creating these entries.

Virtual Hosts with IP Addresses

This is usually the recommended way to set up virtual hosts, because all of the capabilities of regular IMail Server hosts are available to virtual hosts with IP addresses. The only limitations of virtual hosts with IP addresses are:

• Each virtual host requires its own unique IP address.
• In Windows NT/2000, this requires the extra step of adding an IP address in the Windows NT TCP/IP configuration in the Control Panel (Network applet - > Protocols -> TCP/IP Protocol -> Advanced button.)

Note: If you are using Windows NT 3.5.1 or later, you can add up to five IP addresses in the Network applet. If you need to add more than five addresses, refer to the documentation for Windows NT/2000.

Virtual Hosts Without IP Addresses

Virtual hosts without IP addresses are easier to set up than those with IP addresses. For more information, see "Configuring a Virtual Host". The IMail Server computer will assign a virtual IP address for the selected domain. You can then use an MX record in your DNS to point the virtual host to the primary host (which has a real IP address). There are several limitations of virtual hosts without IP addresses:

• So that IMail Server can tell which virtual host the user is associated with, when the user logs on, they must enter the entire userid@hostname.com string for their user ID. Some mail clients will not be able to connect to the virtual host to read mail. This problem exists because some mail clients either have length restrictions for user IDs, or they clip the user ID at the @ sign. You can set up the virtual host to use a different character to separate the user ID from the hostname, but then you must tell users use this character in their logon user IDs (for example, userid#hostname.com). To change the character, see "Appendix G. Special Registry Values."
• The LDAP, Whois, and Finger servers do not work with virtual hosts without IP addresses.

Virtual hosts without IP addresses are recommended when you have a shortage of IP addresses, or when you want to forward all mail for a domain to a user at another domain. As an example of the latter:

• Your primary domain is called abracadabra.com
• You want all mail sent to merlin.com to be forwarded to info@abracadabra.com
• To accomplish this, set up a virtual host without an IP address for merlin.com and do not create any users for merlin.com
• Set up a nobody alias for merlin.com pointing to a user ID on abracadabra.com
• All mail to any user at merlin.com will be sent to the specified user at abracadabra.com

Configuring a Virtual Host

To configure a virtual host (assuming "Use Wizards" is turned off):

1. Select the "localhost" folder in the left panel.
2. Click the Add Host button.

The "Virtual Host Configuration" dialog box appears.

The Local Addresses list box shows all IP addresses set up in the Windows NT/2000 TCP/IP properties as well as any virtual IP addresses assigned by the IMail Server.

3. Select the IP address for the virtual host (in the Local Addresses list box) or click the Add button to assign a new virtual IP address to use for the new mail domain.
4. In the Official Host Name text box, enter the name of the
   mail host.

   The name you enter here will be used to address mail to the users on the virtual host. For example, if you enter mail.domain2.com as the mail host name, any users you add to the virtual host will receive mail at user@mail.domain2.com.

5. In the Aliases text box, specify alternate host names for which you want the computer to accept mail. For example, if your mail host name is mail.domain2.com, you can set an alias of domain2.com so that IMail Server accepts mail addressed to fred@mail.domain2.com and also fred@domain2.com. Multiple aliases are separated by a space. This field is limited to 255 characters.
6. In the Top Directory Name text box, enter the name of the directory where the directories for users, lists, and web files for this virtual host will be stored.

   In most cases, you will use a different directory for each virtual host that you create. It is possible for virtual hosts to share a single directory but then users that have the same names will actually share the same mailbox.

7. Select the type of user database you want to use for this host.

   Use IMail User Database
   Use Local NT User Database
   Use External User Database

   For a description of these options, see "User Registration and Authentication".

8. Enter the default parameters for mailboxes and messages. These parameters apply to all users on the virtual host.

   Default Max Mailbox Size. Enter the default maximum size in bytes (characters) for the total of all mailboxes in a user's account. If the total size exceeds the maximum, any new mail is returned to the sender. Enter zero for an unlimited size. For more information see "Additional Host Settings".

   Default Max Messages. Enter the default maximum number of messages (the total for all mailboxes) that will be allowed in a user's account. If the maximum is exceeded, any new mail is returned to the sender. Enter zero for an unlimited number. For more information see "Additional Host Settings".

   Single Message Max Size. The default maximum size (in bytes) for a single message sent to the server. If a message exceeds the maximum, it is returned to the sender. Enter zero for an unlimited size.

   Maximum User Count. The maximum number of users that can be registered for the domain. Enter zero for an unlimited number of users.

Note: Note that this does not apply to virtual domains that are based on the Windows NT user database or an external database. Furthermore, the displayed counts of users for domains that use the NT user database or an external database may not be correct.

Click Save to save the new virtual host configuration. Click Exit to close the "Virtual Host Configuration" dialog box.

9. After you have created the virtual host, you need to add user mail accounts. For information on creating and modifying user mail accounts, see "Working with User Mail Accounts"..

Additional Host Settings

Once the virtual host has been configured, it will appear in the left panel. Selecting the virtual host in the left panel, displays the host's General tab in the right panel. You can use this tab to alter the settings configured during the creation of the virtual host, and to access additional settings. The following options are available on this tab.

The first two items are not editable. They are:

Official Host Name. The name that will be used to address mail to the users on the mail host.

TCP/IP Address. The real or virtual IP address of the mail host.

Top directory. The name of the directory where the directories for users, lists, and web files for this host will be stored.

Host Aliases. Specify alternate host names for which you want the host to accept mail. For example, if the mail host name is mail.domain2.com, you can set an alias of domain2.com so that IMail Server accepts mail addressed to fred@mail.domain2.com and also fred@domain2.com. Multiple aliases are separated by a space.

Default Max Mailbox Size. Enter the default maximum size in bytes (characters) for the total of all mailboxes in a user's account. If the total size exceeds the maximum, any new mail is returned to the sender. Enter zero for an unlimited size.

This value is the default limit used when the Max Mailbox Size value, for a user's account, is set to zero. Changing this value will automatically change the limit for all user accounts on the host with zero for the Max Mailbox Size value. Otherwise, the user's Max Mailbox Size value will override.

Single Message Max Size. Enter the maximum size (in bytes) of a single message. Messages that exceed this size are returned to the sender. Enter zero for unlimited size.

Max Outbound Msg Size. The maximum size of an outbound message. Any message that is larger than the size entered here, will be bounced.

Full Mailbox Notify%. If there is anything entered in this box, the user will be notified when their mailbox is within a certain percentage of being full. For example, if 80 is entered in this box, the user will receive an e-mail when their mailbox is 80% full. The user will get a maximum of one message a day, for three days.

The e-mail message that is sent to the user is configurable. The text for this message can be customized by creating a Notify.txt file which should be placed in the top directory of the domain. If there is no Notify.txt file, the notification will contain the standard text as follows:

"User<!--imail.user--> Host <!--imail.host--> Your mailbox is nearly full, please remove some messages. If you have any questions, see your system administrator." The two tags will be replaced with the User ID and the domain.

Full Mailbox Notify Address. Enter the address of an additional address where an e-mail will be sent when a user's mailbox is almost full. For example, this could be the system administrators address.

Default Max Messages. Enter the default maximum number of messages (the total for all mailboxes) that will be allowed in a user's account. If the maximum is exceeded, any new mail is returned to the sender. Enter zero for an unlimited number.

This value is the default limit used when the Max Messages value for the user's account is zero. Changing this value will automatically change the limit for all accounts on the host which have zero for the Max Mailbox Msgs value. Otherwise, the user's Max Mailbox Msgs value will override.

Max Users. Enter the maximum number of users that can be registered for this mail host. Enter zero for an unlimited number. The box next to this setting displays the number of users that exist on the host.

Note: This setting does not apply to virtual domains that use the NT user database. The displayed counts of users for domains that use the NT user database may not be correct.

Virus Scanning. If you have IMail Anti-Virus installed, you will see a Virus Scanning option, which allows you to enable and disable virus scanning for the current domain only. If you do not have IMail Anti-Virus installed, you will not see this option.

Sub-mailbox Creation. This setting allows the administrator to specify what to do when a message arrives for a user and is addressed to a sub-mailbox which does not exist. Select one of the following actions:

• Create. Creates the sub-mailbox and delivers the message.
• Send to Inbox. Does not create the sub-mailbox. Instead the message is delivered to "main".
• Bounce. Bounces the mail as an invalid user.

In the User Database Type area, select one of the following:

• IMail Database
• NT Database
• External Database

Setting Up DNS for Multiple Mail Hosts

For background information about DNS setup, see "Appendix I: Mail Servers and the DNS".

For a virtual host with an IP address, you need to make the following entries in your DNS:

• An MX record for the mail domain (for example, mail.domain2.com). The MX record identifies the host name of the virtual host.
• An A record for the host name of the virtual host. The A record maps a host name to an IP address.
• A PTR record for the IP address of the virtual host. The PTR record maps an IP address to the host name and is used for reverse lookups.

As an example, the DNS entries for a virtual host for which the host name in IMail Server is mail.domain2.com would look like:

SOA 
$ORIGIN 
... 
domain2.com 
     IN MX 10 mail.domain2.com   (MX record) 
     mail IN A 156.21.50.10      (A record)  
	(PTR record 
5.50.21.156.in-addr.arpa.,type = PTR 
 host = mail.domain.com 

A DNS lookup for mail sent to user@domain2.com would find that the mail must be sent to the host mail.domain2.com.

For a virtual host without an IP address, you need to make only one entry in your DNS: an MX record for the mail domain (for example, mail.domain3.com). This MX record identifies the host name of the primary mail host. As an example, the DNS entries for a virtual host without IP address for which the host name is mail.domain3.com would look like:

SOA 
$ORIGIN 
... 
domain3.com 
     IN MX 10 mail.domain.com  

A DNS lookup for mail sent to user@domain3.com would find that the mail needs to be sent to the host mail.domain.com.

Ipswitch, Inc. http://www.ipswitch.com

©Ipswitch 2003