Internet Agent Requirement

Internet addressing requires you to have the GroupWise Internet Agent installed in your GroupWise system. The Internet Agent connects your GroupWise system to the Internet. To install the Internet Agent, see "Installing the GroupWise Internet Agent" in the GroupWise 6.5 Installation Guide.

Internet Agents Used for Outbound Messages

Each domain in your GroupWise system must be assigned an Internet Agent for outbound messages. A domain's assigned Internet Agent handle all outbound messages sent by the domain's users.

If your GroupWise system includes only one Internet Agent, that Internet Agent must be assigned to all domains and will be used for all outbound messages.

If your GroupWise system includes multiple Internet Agents, you must decide which Internet Agent you want to be responsible for outbound messages for each domain. You must select one Internet Agent as your system's default Internet Agent, but you can override the default at each domain.

Internet Domain Names

You must associate at least one Internet domain (novell.com, gw.novell.com, support.novell.com, or so forth) with your GroupWise system. These Internet domains need to exist in the domain name service (DNS).

After you have associated Internet domains with your GroupWise system, all users in your system can be addressed using any of the domains (for example, jsmith@novell.com, jsmith@gw.novell.com, and jsmith@support.novell.com). The addresses can be used both internally and externally.

Preferred Internet Domain Name

You must assign each GroupWise user a preferred Internet domain. GroupWise uses the preferred Internet domain name when constructing the e-mail address that are displayed in the GroupWise Address Book and in the To field of sent messages.

To make this process easier, GroupWise lets you assign a preferred Internet domain to be used as the default for your GroupWise system (for example, novell.com). The system's preferred Internet domain is applied to all users in your GroupWise system. However, you can override the system's preferred Internet domain at the domain, post office, or user level, meaning that different users within your GroupWise system can be assigned different preferred Internet domains. For example, users in one domain can be assigned gw.novell.com as their preferred Internet domain while users in another domain are assigned support.novell.com.

Preferred Address Format

You must choose a preferred address format for your GroupWise users. GroupWise uses the preferred address format, along with the preferred Internet domain, to construct the e-mail addresses that are published in the GroupWise Address Book and in the To field of sent messages.

GroupWise supports the following address formats:

userID.post_office.domain@internet_domain_name

userID.post_office@internet_domain_name

userID@internet_domain_name

firstname.lastname@internet_domain_name

lastname.firstname@internet_domain_name

firstinital lastname@internet_domain_name

As with the preferred Internet domain, you must assign a preferred address format to be used as the default for your GroupWise system. The system's preferred address format is applied to all users in your GroupWise system. However, you can override the system's preferred address format at the domain, post office, and user/resource level.

The following sections explain some of the advantages and disadvantages of each address format:

• userID.post_office.domain@internet_domain_name
• userID.post_office@internet_domain_name
• userID@internet_domain_name
• firstname.lastname@internet_domain_name
• lastname.firstname@internet_domain_name
• firstinitial lastname@internet_domain_name

Allowed Address Formats

The preferred Internet domain and preferred address format apply to user addresses as displayed in the GroupWise Address Book or sent messages.

The allowed address formats, on the other hand, determine which address formats are accepted by the Internet Agent. There are five possible allowed formats:

userID.post_office@internet_domain_name

userID@internet_domain_name

firstname.lastname@internet_domain_name

lastname.firstname@internet_domain_name

firstinital lastname@internet_domain_name

If you select all five formats, the Internet Agent accepts messages addressed to users in any of the formats. For example, John Peterson would receive messages sent using any of the following addresses:

jpeterson.research@novell.com

jpeterson@novell.com

john.peterson@novell.com

peterson.john@novell.com

jpeterson@novell.com

You must designate the allowed address formats to be used as the default formats for your GroupWise system. The system's allowed address formats are applied to all users in your GroupWise system. However, you can override the system's allowed address formats at the domain, post office, and user/resource level.

For example, assume you have two John Petersons with userIDs of jpeterson and japeterson. The userID.post_office and userID address formats do not cause message delivery problems, but the firstname.lastname, lastname.firstname, and firstinitial lastname address formats do. To overcome this problem, you could disallow the three problem formats for these users at the user level.

Override Options

In spite of the best planning, some e-mail addresses do not fit the rules and are not processed correctly. You can handle such addresses by overriding the regular address processing, as described in Overriding Internet Addressing Defaults.

Installing the Internet Agent

Before you can set up Internet addressing, you must install the GroupWise Internet Agent. If you have not already installed the agent, see "Installing the GroupWise Internet Agent" in the GroupWise 6.5 Installation Guide.

Enabling Internet Addressing

1. In ConsoleOne, click the Tools menu > GroupWise System Operations > Internet Addressing.

   
   

2. In the Internet Agent for Outbound SMTP/MIME Messages list, select the Internet Agent to use as the default Internet Agent for your system.

   By default, each domain uses this Internet Agent for outbound messages sent by users in the domain. If you have multiple Internet Agents in your GroupWise system, you can override the default setting at the domain level. For more information, see Domain Overrides.

3. To define an Internet domain, click Create to display the Internet Domain Name dialog box.

   
   

4. Enter the Internet domain you want to define in your GroupWise system, then click OK to add it to the list of Internet domains.

5. Repeat Step 3 and Step 4 for each Internet domain you want to define.

   When you've finished, all Internet domains you want to define should be listed in the Internet Domain Names box.

   
   

   The preferred Internet domain is indicated by a check mark. This is the Internet domain name that is used when GroupWise constructs a user's preferred e-mail address. A preferred e-mail address is the address that is published in the system address book and in the To field of sent messages. You can override the preferred Internet domain name at the domain, post office, and user/resource levels. For more information, see Overriding Internet Addressing Defaults.

6. If the Internet domain you want to be the default preferred domain for your GroupWise system is not already selected, select the desired Internet domain, then click Set Preferred Name.

7. In the Preferred Address Format list, select your system's default Internet address format.

   This is the format that is used when displaying addresses in the GroupWise Address Book and in a message's From box if it is not overridden at a lower level. For a list of the available addressing formats and their respective advantages and disadvantages, see Preferred Address Format.

   You can override the preferred address format at the domain, post office, and user/resource levels. For more information, see Overriding Internet Addressing Defaults.

8. If desired, turn on the Enable "First Initial Last Name" Matching for Incoming Mail option.

   This option allows the Internet Agent to resolve addresses for incoming messages by performing "first initial last name" lookups on the username portion of the address. When doing so, the Internet Agent uses the first letter of the username as the first initial and the remainder of the username as the last name. It then resolves the address to any GroupWise users whose Last Name field (in their eDirectory User object record) contains the last name and whose Given Name field starts with the first initial.

   For example, if the recipient's address is jpeterson@novell.com, the first initial would be J and the last name would be Peterson. The address would resolve to the user whose Last Name field is Peterson and Given Name field starts with J. If more than one user's given name starts with J (for example, John and Janice), the message is undeliverable.

   This option is useful if you want to be able to use the UserID@Internet_domain_name format but your userIDs do not really reflect your users' actual names (for example, John Peterson's user ID is 46789 so his address is 46789@novell.com). In this case, you could publish users' addresses as their first initial last name (for example, jpeterson@novell.com) and enable this option so that the Internet Agent resolves the addresses to the appropriate users.

9. In the Allowed Address Formats list, select the address formats that you want to be supported for incoming messages. GroupWise will deliver a message to the recipient if any of the allowed formats have been used in the address.

   You can override the allowed address formats at the domain, post office, and user/resource levels. For more information, see Overriding Internet Addressing Defaults.

10. Click OK to save your changes.

    If you changed the preferred address format, you are prompted to update the Internet e-mail address (General tab > Identification page > E-Mail Address field) for all affected users. The Internet e-mail address is the address returned in response to LDAP queries to eDirectory. It is recommended that you allow this update; however, performing it for the entire GroupWise system might take a while.

At this point, Internet addressing is enabled.

Overriding Internet Addressing Defaults

All domains, post offices, and users/resources in your GroupWise system inherit the defaults (Internet Agent for outbound messages, preferred Internet domain name, preferred address format, and allowed address formats) you established when enabling Internet addressing for your system. However, if desired, you can override these defaults for individual domains, post offices, or users/resources.

• Domain Overrides
• Post Office Overrides
• User/Resource Overrides