Using a Global Domain document to set up a server to receive mail for multiple Internet domains

Every organization has a primary Internet domain name -- for example, renovations.com -- by which it is known to the rest of the world. By default, Domino® considers the local, primary Internet domain to be the domain specified in the server's host name. For example, for a server with the host name Server1.renovations.com, both Server1.renovations.com and renovations.com are considered local Internet domains. The server does not accept messages addressed to recipients in any other Internet domain.

About this task

In addition to having a primary Internet domain, some organizations use alternate Internet domain names. If your organization uses more than one Internet domain name, you'll want Domino® to consider other domain suffixes as local. Using multiple Internet domain names typically results when:

An organization changes names
An organization acquires or merges with another company that already has an existing Internet domain name, and users continue to use the other Internet domain in their addresses
You set up a mail topology to route messages addressed to other subsidiaries through your firewall before routing the messages to the Internet or another private network
You set up a mail topology specifically to include more than one Internet domain name

If for any of the preceding reasons people in your organization have addresses in an Internet domain other than the primary domain, create a Global Domain document. A Global Domain document identifies the Internet domains that are considered to be internal to a Domino® domain and for which the local domain can accept mail. By default, the Domino® Directory does not contain a Global domain document. Within the Global Domain document, you specify one primary Internet domain name and multiple secondary domains. Secondary domains are listed as alternate Internet domain aliases.

Settings in the Global domain document are static and loaded only at server initialization. You cannot dynamically refresh settings by restarting or updating the Router ( by means of the TELL ROUTER UPDATE CONFIG command).

Note: For servers using the SMTP MTA, the Global domain document also specifies the Domino® domains allowed to send outbound SMTP mail through this Domino® domain.

You must ensure that the DNS is set up to include all the Internet domain names that your company uses.

Use the Global domain document to define:

The Internet domains considered to be internal to the local Domino® domain and for which the local domain can accept inbound SMTP mail --for example, renovations.com, sales.renovations.com, and so on.
Rules for converting the sender's Notes® mail address to an Internet address in outbound SMTP messages in which the Internet address is not already specified.

A Global domain document is required if you have multiple Internet domains, multiple Domino® domains within the local Internet domain, or use the Domino® SMTP inbound controls.

To create a Global Domain document

Procedure

Make sure you already have a Configuration Settings document for the server(s) to be configured.
From the Domino® Administrator, click the Configuration tab and then expand the Messaging section.
Choose Domains, and then click Add Domain.

On the Basics tab, complete these fields:

Table 1. Basics tab
Field	Enter
Domain type	Choose Global Domain
Global domain name	A word or phrase that describes the domain. Never use the name of an existing domain for your Global Domain If the Global domain uses the SMTP MTA to send SMTP mail, the name entered in this field must match the name of the Global domain specified in the Server document of the SMTP MTA server (MTAs tab - Global domain name field). If the entries do not match, the SMTP MTA fails to load and the server console displays the following message: `Unable to get Global domain in the Name and Address book`
Global domain role	Choose one: R5/R6/R7/R8 Internet Domains or R4.x SMTP MTA - For Domino® Release 5 and later SMTP servers, or Domino® servers that use the SMTP MTA to send Internet mail. X 400 MTA - For Domino® servers that use an X 400 MTA to send Internet mail.
Use as default Global Domain (for use with Internet protocols except HTTP)	In an Domino® Directory that contains multiple Global domain documents, select this field to designate the current document as the default. A Domino® directory can contain one default Global domain document only. If you designate this Global domain document as the default, servers in this Domino® domain use its settings to control address lookup and construction on outbound SMTP messages that don't have the sender's Internet address. Address conversion settings in other Global domain documents in the directory is ignored. When there are multiple Global domain documents, but none is designated the default, the Router uses the address construction rules from Global domain document that is listed last alphabetically in the Domino® Directory. However, in this case, the Router does not use the Primary Internet domain defined in this Global domain document uses to construct the outbound sender's Internet address; instead, it constructs the address using the domain suffix entered in the Fully qualified Internet host name field on the Basics tab of the server's Server document. Note: If address lookup is enabled on a Configuration Settings document that applies to the server, the Router ignores the address lookup setting on the default Global domain document.

Click the Restrictions tab and complete these fields:

Table 2. Restrictions tab fields
Field	Enter
Domino domains and aliases	Specifies the names of the Domino® domains that comprise the global domain. including the name of the local Domino® domain. To ensure that the Router correctly forms the reply address for users sending outbound mail, list the name of each Domino® Domain that uses this Global Domain. For Domino® domains with names that contain non-ASCII characters, include an alternative, or alias, domain name that consists of ASCII characters only, and separate the two names with the separator character defined in the next field. Domino® uses the ASCII name in SMTP communications, which do not support non-ASCII content. When mail is received for an address in the format Admin%AliasName@renovations.com, the receiving server converts the Alias name to the actual Domino® domain name and then routes the message to the specified domain.
Alias separator character	Specifies the character used to separate non-ASCII domain names from their ASCII domain alias equivalents. The default is an equal (=) sign.

Click the Conversions tab, complete these fields, and then save the document.

The address conversion settings in the following table apply to any message sent over SMTP from servers in this Domino® domain regardless of whether the recipient is in the local Internet domain or an external Internet domain.

While this document shows fields for the X.400 Address, these do not apply to your SMTP configuration and should remain blank, unless you previously configured an X.400 MTA within this global domain.

Table 3. Conversions tab - SMTP Address Conversion
Field	Enter
Local primary Internet domain	The primary Internet domain name that your company uses to represent themselves to the outside world -- for example, renovations.com. On outbound messages, the SMTP server or SMTP MTA appends the entry in this field as the Internet domain suffix when constructing the sender's Internet return address on an outbound SMTP message. This lets organizations composed of multiple subsidiaries to appear as a single organization to the Internet. For example, if you enter renovations.com, all outbound SMTP mail originating within the organization will have a return address of renovations.com. This is true even when there are multiple outbound SMTP servers configured within the same Notes® Global domain. To use different Internet domains in the return addresses of mail sent from different servers in your organization, for example, renovations.com and renovations.co.uk, you must have a Global Domain document for each primary domain name. The Internet domains listed in this field and the alternate domain aliases field comprise the internal Internet domain. For inbound messages, the SMTP server or SMTP MTA verifies the addresses of all messages recipients against these entries. Messages for recipients in the listed domains are accepted for local delivery. This field supports a maximum of 64KB of text.
Alternate Internet domain aliases	Additional Internet domain names that your company uses -- for example, sales.renovations.com, renovations.co.uk, and so forth. Alternate Internet domain aliases serve as aliases for the primary Internet domain name. SMTP servers in this Global domain will accept inbound mail for all the Internet domains aliases listed in this field or the local primary Internet domain field. Inbound SMTP mail is restricted to the domains listed. You can explicitly name the Internet domains to be included in this Global domain, or use a leading wildcard character (''), to represent all subdomains for a given primary domain; for example, .iris.com. Wildcards are valid when used as the first character of an entry only. You cannot use a wildcard to represent a top-level domain name or a subset of the characters in a domain or subdomain name. For example, the following are not valid wildcard entries: iris., is.com, iris*.com. Note: When a server sends and receives Internet mail for multiple Internet domains, if you want each user's address to reflect the identity of their own domain, be sure to complete the Internet address field in each Person document. Otherwise outbound mail sent from user's in your alternate Internet domains will always appear to be sent from the primary domain. This field supports a maximum of 64KB of text.
Internet address lookup	Specifies whether the server checks the sender's Person document for an Internet address if the message does not include one in the. Choose one: Enabled - The SMTP server or MTA obtains the sender's Internet address from the Internet address field of the Person document. By default, the first entry containing an @ sign will be used and assumed to be the senders Internet address. If there is no entry containing an @ sign, the senders address will be formed based on the remaining Global domain settings, built off of the Local part formed from field, the Notes domains included field and the Notes Domain position field. If the person document is not located in the name and address book(s), the Router constructs the sender's address for the Common Name followed by an @ sign and the first Internet domain name listed in the Internet domain suffix field. For users who do not have an Internet address specified in their Person document, the Domino® server looks for a fully-formed Internet address in the User name or Short name/UserID field of the Person document. If no address is found, Domino® constructs the sender's address based on information in the SMTP Address Conversion section of the Global Domain document. Disabled - (default) The SMTP server or MTA does not look up the sender's Internet address from the Domino® Directory. Instead it constructs the sender's Internet address from the conversion rules in the Global domain document. Note: If the lookups are enabled in the Configuration Settings document (in the field Lookup Internet address for all Notes addresses when Internet address is not defined in document on the MIME-Conversion Options-Outbound tab), the Router ignores this setting in the Global Domain document and performs the address lookup when necessary.
Local part formed from	Specifies how the server builds the local part of the sender's Internet return address on outbound messages. Choose one of the following: Full name - The server forms the local part of the Internet return address from the sender's complete Notes® hierarchical name. Spaces in the name are replaced with a separator character (default is underscore '_'). For example: John_Smith/Sales/Renovations Common name - The server forms the local part of the Internet return address from the sender's Common name. Spaces in the name are replaced with a separator character. For example: John_Smith Short name - The server forms the local part of the Internet return address from the entry in Short name/UserID field of the sender's Person document. If the Short name/Internet address field has an entry containing an @ sign, the server uses the first entry with an @ sign as the Internet address. If the short name field contains multiple entries, the first entry with an explicit Internet address is used.
Domino domain(s) included	Specifies the number of Domino® domains that the Router includes when constructing the sender's Internet return address on messages converted for SMTP routing. If the Global domain consists of multiple Domino® domains, include Domino® domain information in the Internet address to ensure proper return routing of message replies. Choose one: None - The sender's Internet address does not include the names of any Domino® domains. When converting messages for SMTP routing, the Router removes the names of the Domino® domains found in the Domino domains and aliases field on the Restrictions tab. This option allows for a shorter Internet address in the format User_Name@renovations.com. Use this option in conjunction with Directory Assistance to ensure successful routing of message replies destined for other Domino® domains. One - The sender's Internet address includes the name of the originating Domino® domain only. For example, User_Name%Domain1@renovations.com, where Domain1 is the Domino® domain of the sending user. Use this option in conjunction with Directory Assistance to ensure successful routing of message replies destined for other Domino® domains. All - The sender's Internet address includes the name of all of the Domino® domains that a message traverses before conversion, except for the current domain (the domain of the sending SMTP server). For example, User_Name%Domain1%Domain2@renovations.com, where Domain1 is the Domino® domain of the sending user and Domain2 is the name of the domain of the server that transferred the message to the current domain. If the current Domino® domain does have access to the Domino® Directories of the other members of the Global domain, use this setting to ensure proper routing of replies to the outbound address.
Domino domain(s) position	Specifies the position of Domino® domain names in the sender's Internet address relative to the @ sign. Left of '@' - (default) Domino® domain names in the sender's Internet address are placed after the local part of the address, separated from it and from each other by the specified separator character. For example, John_Smith%Sales@renovations.com Right of '@' - Domino® domain names in the sender's Internet address are placed after the @, preceding the Internet domain name. The separator character in this case must be a period ( .). For example, John_Smith@sales.renovations.com
Domino domain separator	Specifies the character that used to separate Domino® domains in the sender's Internet address. The separator character selected determines the Domino domain(s) position field whereas that can be used. Choose one: % - percent sign - (default) - Select this option only if you selected Left of '@' in the Domino domain(s) position field. . - period - Select this option for use with either value in the Domino domain(s) position field. Note: Do not use the period as the separator character when the Domino domain(s) position is set to Left of '@' and either of the following variables is set in the server's NOTES.INI file: SMTP_LEFT_DOT_NEVER_DOMAIN=1 or SMTP_REPLACE_DOTS_OFF=1. These variables prevent the server from considering a period (.) in an inbound address as a Domino® domain separator. For example, in the address John.Smith.Sales@renovations.com, the server will be unable to interpret Sales as the name of a Domino® domain.
Address example	Provides a visual representation of the format the Router will use to construct the Internet reply addresses on messages sent over SMTP from servers controlled by this Global domain document. The content of this field changes dynamically based on the settings in the Domino domain(s) included , Domino domain(s) position and Domino domain separator fields. This field is not editable.
Outbound mail restriction	Specifies whether the SMTP MTA restricts users in Notes® domains not named in this Global Domain from sending mail to the Internet. This field does not apply to Domino® Release 5 and later servers. Choose one: Restrict to global domain - Before converting the format of Internet mail for outbound transfer, the SMTP MTA checks whether the sender's Notes® domain is listed in the Notes domains and aliases on the Restrictions tab. If the SMTP MTA determines that the message originated outside of a member notes domain or traveled through one, the message is rejected and returned to the sender in a non-delivery notification. Unrestricted - (default) All Internet mail routed to the SMTP MTA is converted and sent outbound. There is no verification done on outbound messages.
Address format	Specifies the format that the SMTP MTA uses to construct the sender's Internet address on outbound messages This field does not apply to Domino® Release 5 and later servers. Choose one: Address only - Creates the sender's outbound address in RFC 821 Format, for example, jsmith@renovations.com. Name and Address - (default) Creates the sender's outbound in RFC 822 Format, consisting of a Friendly name or phrase, and the RFC 821 address; for example, John Smith <jsmith@renovations.com>. The phrase portion of the address is obtained from the user's common name, short name, or full name, as specified in the Local Part Formed from field. Note: If the Internet Address Lookup field is set to enabled, the SMTP MTA searches the sender's Person document for an Internet address and uses that address if available, rather than the one specified in this field.

Restart the server to put the changes into effect. The server reloads information in the Global Domain document into memory only after a restart.

What to do next

If a Domino® server uses ETRN to pull mail for multiple Internet domains from another mail host, you can set up the Connection document to that host to request mail for alternate Internet domains. Details can be found in the topic Routing mail over transient connections.