Selecting the Internet Agent Platform

The Internet Agent is available as a NetWare NLM^TM program, a Linux executable, and a Windows executable.

Selecting the Internet Agent Installation Directory

You should install the Internet Agent on the same server where the domain directory is located. The Internet Agent installation directory depends on the platform where you are installing it.

Consider these platform-specific guidelines:

• NetWare: When installing the NetWare Internet Agent, we recommend you use the sys:\system directory on the NetWare server. This simplifies access to the Internet Agent configuration file and ensures that the NLM program is in the server's search path. If you use a different directory, you must add that directory to the server's search path.

• Linux: The Linux Internet Agent is automatically installed to the bin and lib subdirectories under /opt/novell/groupwise/agents.

• Windows: The default installation directory is c:\grpwise\gwia. However, you can install the Internet Agent to any directory you want.

Gathering Domain and Gateway Information

The Internet Agent requires a GroupWise gateway directory in which to store configuration information and work files. The gateway directory must be located under a GroupWise domain directory. The default directory name is GWIA on NetWare and Windows, gwia on Linux. If you change the name on NetWare, use a maximum of 8 characters in the new name. If you change the name on Linux, use lowercase letters.

After you specify the domain directory location and a gateway directory name, the Installation Advisor creates the gateway directory under the domain\wpgate directory (for example, provo\wpgate\gwia on NetWare and Windows, provo/wpgate/gwia on Linux).

Selecting the Gateway Object Name

The Internet Agent also requires a GroupWise Gateway object in Novell eDirectory. This object stores the Internet Agent's information and enables configuration of the agent through ConsoleOne^®.

The Internet Agent's object is created below the Domain object. If you have multiple domains, the Installation Advisor uses the Domain object associated with the domain directory where you are creating the Internet Agent's gateway directory.

Specifying the Internet Mail Domain Name for Your GroupWise System

When e-mail users across the Internet address messages to GroupWise users, the address includes the Internet mail domain for your GroupWise system (for example, novell.com). Typically, the Internet mail domain name for your GroupWise system is the name of your company, with its accompanying domain type (.com, .edu, etc.).

Handling Outbound Mail

If the Internet Agent is connected to the Internet and is able to perform DNS name resolution, it can send messages from GroupWise users across the Internet to Internet users. However, you might prefer to keep the Internet Agent behind your firewall. To accomplish this, you can configure the Internet Agent to route all outbound messages to a relay host.

Clustering the NetWare Internet Agent

Novell Cluster Services is a server clustering system that ensures high availability and manageability of critical network resources including volumes (where GroupWise domains reside) and applications (such as the Internet Agent). Novell Cluster Services supports failover, failback, and migration of individually managed cluster resources.

The NetWare Internet Agent can be configured to take advantage of the fault-tolerant environment provided by Novell Cluster Services if the following requirements are met:

• The domain where the Internet Agent is installed has already been created on a shared NSS volume in the cluster.
• The NetWare Internet Agent is being installed to a server that is part of the same cluster.

When the agents are configured for clustering, their startup files are configured with shared volume names rather than specific server names. In addition, the POA is configured to more effectively re-establish logins with GroupWise clients when a failover or migration situation arises.

Additional configuration of the Internet Agent object in ConsoleOne is required to complete the agent setup in a clustering environment, as described in "Implementing the Internet Agent in a Novell Cluster" in "Novell Cluster Services" in the GroupWise 6.5 Interoperability Guide.

Configuring the Windows Internet Agent

When you install the Windows Internet Agent, you have choices about how the Internet Agent interacts with the Windows operating system.

• Configuring the Windows Internet Agent as a Service
• Using SNMP Traps to Monitor the Windows Internet Agent

Enabling the Internet Agent Web Console

The Internet Agent console enables you to monitor the Internet Agent from the server where it is running. If you want, you can enable the Internet Agent's Web console. The Web console lets you view the Internet Agent's statistical and diagnostic information through a Web browser, which is useful if want to see the Internet Agent's activity without physically visiting the agent's server.

You access the Web console by entering the Internet Agent's network address and HTTP port number in a Web browser (for example, http://172.16.5.18:7211). If necessary, you can change the Internet Agent's default HTTP port number (9850).

If you want to restrict access to the Web console, you can assign a username and password. This can be any username and password you want. By default, the username and password are passed through an unsecure connection between the Web browser and the Internet Agent. Therefore, we recommend that you do not use an existing eDirectory or Windows username and password unless you secure this connection using SSL. For information about securing the Internet Agent's connections, see "Internet Agent" in the GroupWise 6.5 Administration Guide.

Gathering LDAP Information (Linux Only)

If you are installing the Linux Internet Agent, the Installation Advisor needs to access eDirectory through LDAP. eDirectory access is required in order to create the Internet Agent object. To obtain access, the Installation Advisor needs the IP address and port number of an LDAP server, along with a username and password to log in with. Because the Linux Installation Advisor uses LDAP to access eDirectory, you must provide the username in LDAP format. For example:

cn=admin,ou=users,o=corporate

If you want to secure the connection to eDirectory with SSL, you can specify a certificate file. For background information about SSL, see "Encryption and Certificates" in "Security" in the GroupWise 6.5 Administration Guide.