Novell GROUPWISE 7 - INTERNET AGENT User manual

Internet Agent
XI
novdocx (en) 11 December 2007
701
XI
Internet Agent
Chapter 45, “Configuring Internet Addressing,” on page 703
Chapter 46, “Configuring Internet Services,” on page 717
Chapter 47, “Managing Internet Access,” on page 747
Chapter 48, “Configuring the Internet Agent,” on page 769
Chapter 49, “Monitoring the Internet Agent,” on page 775
Chapter 50, “Optimizing the Internet Agent,” on page 799
Chapter 51, “Connecting GroupWise Systems and Domains Using the Internet Agent,” on
page 805
Chapter 52, “Using Internet Agent Startup Switches,” on page 813

702 GroupWise 7 Administration Guide
novdocx (en) 11 December 2007

Configuring Internet Addressing
45
novdocx (en) 11 December 2007
703
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 703
Section 45.2, “Setting Up Internet Addressing,” on page 708
Section 45.3, “Transitioning from SMTP Gateway Aliases to Internet Addressing,” on
page 713
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 704
Section 45.1.2, “Internet Agents Used for Outbound Messages,” on page 704
Section 45.1.3, “Internet Domain Names,” on page 704
Section 45.1.4, “Preferred Address Format,” on page 704
Section 45.1.5, “Allowed Address Formats,” on page 707
Section 45.1.6, “Override Options,” on page 707

704 GroupWise 7 Administration Guide
novdocx (en) 11 December 2007
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 7 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]l.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.
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 705
novdocx (en) 11 December 2007
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 705
“userID.post_office@internet_domain_name” on page 705
“userID@internet_domain_name” on page 705
“firstname.lastname@internet_domain_name” on page 706
“lastname.firstname@internet_domain_name” on page 706
“firstinitial lastname@internet_domain_name” on page 706
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.

706 GroupWise 7 Administration Guide
novdocx (en) 11 December 2007
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).
firstinitial lastname@internet_domain_name
Advantages
Addresses are intuitive and easy to remember.

Configuring Internet Addressing 707
novdocx (en) 11 December 2007
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.joh[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.
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 710.

708 GroupWise 7 Administration Guide
novdocx (en) 11 December 2007
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 708
Section 45.2.2, “Enabling Internet Addressing,” on page 708
Section 45.2.3, “Overriding Internet Addressing Defaults,” on page 710
45.2.1 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 7 Installation Guide.
45.2.2 Enabling Internet Addressing
1In ConsoleOne, click Tools > GroupWise System Operations > Internet Addressing.
2In 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” on
page 710.
3To define an Internet domain, click Create to display the Internet Domain Name dialog box.

Configuring Internet Addressing 709
novdocx (en) 11 December 2007
4Specify the Internet domain you want to define in your GroupWise system, then click OK to
add it to the list of Internet domains.
5Repeat Step 3 and Step 4 for each Internet domain you want to define.
When you finish, 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 GroupWise 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 Section 45.2.3, “Overriding Internet
Addressing Defaults,” on page 710.
6If 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.
7In 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 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 704.
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 710.

710 GroupWise 7 Administration Guide
novdocx (en) 11 December 2007
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 [email protected], 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, [email protected]) 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.
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 710.
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.
45.2.3 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” on page 710
“Post Office Overrides” on page 711
“User/Resource Overrides” on page 712
Domain Overrides
At the domain level, you can override all Internet addressing defaults assigned to your GroupWise
system.
1In ConsoleOne, right-click a Domain object, then click Properties.