Novell GROUPWISE 8 - INTERNET AGENT User manual

Internet Agent
XI
715
novdocx (en) 22 June 2009
XI
Internet Agent
Chapter 45, “Configuring Internet Addressing,” on page 717
Chapter 46, “Configuring Internet Services,” on page 731
Chapter 47, “Managing Internet Access,” on page 763
Chapter 48, “Configuring the Internet Agent,” on page 785
Chapter 49, “Monitoring the Internet Agent,” on page 793
Chapter 50, “Optimizing the Internet Agent,” on page 817
Chapter 51, “Connecting GroupWise Systems and Domains Using the Internet Agent,” on
page 823
Chapter 52, “Using Internet Agent Startup Switches,” on page 831

716 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009

Configuring Internet Addressing
45
717
novdocx (en) 22 June 2009
45
Configuring Internet Addressing
By default, GroupWise®uses a proprietary address format consisting of a user’s ID, post office, and
domain (userID.post_office.domain). However, when you install the GroupWise Internet Agent,
GroupWise also supports native Internet-style addressing consisting of a username and Internet
domain name (for example, userID@Internet_domain_name).
Internet-style addressing is the preferred addressing format if you are connected to the Internet,
because with Internet-style addressing, users have the same address within the GroupWise system as
they do outside the GroupWise system. For example, if John Smith’s address at Novell®is
[e-mail], this address can be used by users within the GroupWise system and users
external to the system.
To set up Internet addressing, you do the following:
Define Internet domain names for your GroupWise system. You can have one or more domain
names (for example, novell.com, gw.novell.com, and support.novell.com).
Set up the default Internet address format for use when displaying user addresses in the
GroupWise Address Book and sent messages. There are six formats that can be assigned at the
system, domain, post office, or user level. In addition, there is a free-form format that can be
used at the user level.
Designate the address formats that can be used to address messages to your GroupWise users.
There are five possible formats to choose from. You can allow all five formats, or only one.
Specify the default Internet Agent to be used when sending messages from your GroupWise
system to the Internet. This becomes your system’s default Internet Agent for outbound
messages sent from all domains; however, if you have multiple Internet Agents, you can
override this setting by assigning Internet Agents at the domain level.
The following sections help you plan and set up Internet addressing:
Section 45.1, “Planning Internet Addressing,” on page 717
Section 45.2, “Setting Up Internet Addressing,” on page 722
Section 45.3, “Transitioning from SMTP Gateway Aliases to Internet Addressing,” on
page 727
45.1 Planning Internet Addressing
The following sections help you prepare to set up Internet-style addressing for your GroupWise
system:
Section 45.1.1, “Internet Agent Requirement,” on page 718
Section 45.1.2, “Internet Agents Used for Outbound Messages,” on page 718
Section 45.1.3, “Internet Domain Names,” on page 718
Section 45.1.4, “Preferred Address Format,” on page 718
Section 45.1.5, “Allowed Address Formats,” on page 721
Section 45.1.6, “Override Options,” on page 722

718 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
45.1.1 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 8 Installation Guide.
45.1.2 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 handles 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 is 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.
45.1.3 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, [e-mail],
[e-mail], and [email protected]om). 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.
45.1.4 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

Configuring Internet Addressing 719
novdocx (en) 22 June 2009
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” on page 719
“userID.post_office@internet_domain_name” on page 719
“userID@internet_domain_name” on page 719
“firstname.lastname@internet_domain_name” on page 720
“lastname.firstname@internet_domain_name” on page 720
“firstinitial lastname@internet_domain_name” on page 721
userID.post_office.domain@internet_domain_name
Advantages
Reliable format. GroupWise guarantees that each address is unique.
Identical usernames can be used in different post offices.
Disadvantages
Addresses tend to be long and hard to remember.
Addresses might change over time as users are moved from one post office to another.
userID.post_office@internet_domain_name
Advantages
Guarantees uniqueness if all your post offices have unique names.
Identical usernames can be placed in different post offices.
Disadvantages
Addresses tend to be long and hard to remember.
Addresses might change over time as users are moved from one post office to another.
userID@internet_domain_name
Advantages
Addresses are short and easy to remember.

720 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
Backwards-compatible with previous versions of GroupWise. (Users won’t need to update
their business cards.)
Addresses do not change as users are moved.
Disadvantages
When you first enable this address format, you might have duplicate user IDs in your
GroupWise system. However, in the future, ConsoleOne®prevents you from creating duplicate
user IDs within the same Internet domain name. The same user ID can be used in different
Internet domains without problem.
firstname.lastname@internet_domain_name
Advantages
Addresses are intuitive and easy to remember.
Addresses do not change as users are moved.
Disadvantages
When you first enable this address format, you might have duplicate first and last names in
your GroupWise system. However, in the future, ConsoleOne prevents you from creating users
with the same first and last names within the same Internet domain name. The same first name
and last name combination can be used in different Internet domains without problem.
The probability of conflicts increases if any user’s first and last names match any GroupWise
domain or post office name, if any two users have the same first and last names, or if any two
users have the opposite first and last names (such as James Dean and Dean James).
lastname.firstname@internet_domain_name
Advantages
Addresses are intuitive and easy to remember.
Addresses do not change as users are moved.
Disadvantages
When you first enable this address format, you might have duplicate first and last names in
your GroupWise system. However, in the future, ConsoleOne prevents you from creating users
with the same first and last names within the same Internet domain name. The same last name
and first name combination can be used in different Internet domains without a problem.
The probability of conflicts increases if any user’s first and last names match any GroupWise
domain or post office name, if any two users have the same first and last names, or if any two
users have the opposite first and last names (such as James Dean and Dean James).

Configuring Internet Addressing 721
novdocx (en) 22 June 2009
firstinitial lastname@internet_domain_name
Advantages
Addresses are intuitive and easy to remember.
Addresses do not change as users are moved.
Disadvantages
When you first enable this address format, you might have duplicate first initial and last names
in your GroupWise system. However, in the future, ConsoleOne prevents you from creating
users with the same first initials and last names within the same Internet domain name. The
same first initial and last name combination can be used in different Internet domains without
problem
The probability of conflicts increases when using first initials instead of complete first names.
45.1.5 Allowed Address Formats
The preferred Internet domain and preferred address format apply to user addresses as displayed in
the GroupWise Address Book or in the address displayed on 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:
[email protected]
[e-mail]
[e-mail]
peterson.jo[email protected]m
[e-mail]
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.

722 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
45.1.6 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 Section 45.2.3, “Overriding Internet Addressing Defaults,” on page 725.
45.2 Setting Up Internet Addressing
The following sections help you to set up Internet addressing:
Section 45.2.1, “Installing the Internet Agent,” on page 722
Section 45.2.2, “Enabling Internet Addressing,” on page 722
Section 45.2.3, “Overriding Internet Addressing Defaults,” on page 725
45.2.1 Installing the Internet Agent
Before you can set up Internet addressing, you must install the GroupWise Internet Agent for at least
one domain. If you have not already installed the agent, see “Installing the GroupWise Internet
Agent” in the GroupWise 8 Installation Guide.
45.2.2 Enabling Internet Addressing
1In ConsoleOne, click Tools > GroupWise System Operations > Internet Addressing.
2On the Internet Domains tab, click Create.

Configuring Internet Addressing 723
novdocx (en) 22 June 2009
3Specify the Internet domain name (for example, Corporate.com), then click OK to set up the
first Internet domain for your GroupWise system.
4If you want your GroupWise system to receive e-mail addressed to additional Internet domain
names:
4a Repeat Step 2 and Step 3.
4b When you are finished adding Internet domain names to the list, select the preferred
Internet domain name for your GroupWise system, then click Set Preferred.
The preferred Internet domain name is used in addresses published in the GroupWise
Address Book and in the To field of sent messages. This can be overridden on the Internet
Addressing properties pages for domains, post offices, users, and resources. For more
information, see Section 45.2.3, “Overriding Internet Addressing Defaults,” on page 725.
5In the Internet Agent for Outbound SMTP/MIME Messages list, select the Internet Agent to use
as the default Internet Agent for your GroupWise system.
By default, all GroupWise domains use 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, as described in “Domain Overrides” on
page 725.
6Click the Addressing Formats tab.

724 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
7In the Preferred Address Format field, select your GroupWise 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 field if it is not overridden at a lower level. For a list of the available
addressing formats and their respective advantages and disadvantages, see Section 45.1.4,
“Preferred Address Format,” on page 718.
You can override the preferred address format at the domain, post office, and user/resource
levels. For more information, see Section 45.2.3, “Overriding Internet Addressing Defaults,”
on page 725.
8If 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 properties) contains the last name and whose
Given Name field starts with the first initial.
For example, if the recipient’s address is [e-mail], 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 [e-mail]). In this case, you could publish users’
addresses as the first initial last name (for example, [e-mail]) and enable this
option so that the Internet Agent resolves the addresses to the appropriate users.
9In the Allowed Address Formats list, select the address formats that you want to be supported
for incoming messages. GroupWise delivers a message to the recipient if any of the allowed
formats have been used in the address. By default, all formats are supported.
You can override the allowed address formats at the domain, post office, and user/resource
levels. For more information, see Section 45.2.3, “Overriding Internet Addressing Defaults,”
on page 725.
10 Click OK to save your changes.
If you changed the preferred address format, you are prompted to update the Internet e-mail
address (User object > General > Identification > E-Mail Address) for all affected users. The
Internet e-mail address is the address returned in response to LDAP queries to eDirectoryTM. 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 and configured.