38.2 Setting Up the Internet Agent in a Cluster

You should already have reviewed Section 38.1, Planning the Internet Agent in a Cluster and filled out Section 38.4, Internet Agent Clustering Worksheet. You are now ready to complete the following tasks to set up the Internet Agent in a Microsoft cluster:

38.2.1 Setting Up the Internet Agent Resource Group

  1. Create the Internet Agent resource group and agent services resources (Internet Agent Clustering Worksheet item 1), as planned in Planning the Internet Agent Resource Group.

  2. To ensure successful short name resolution, add entries for the Internet Agent network name to support your preferred methods of short name resolution, as described in Configuring Short Name Resolution.

  3. To ensure that the Internet Agent has incoming and outgoing access to the Internet, make sure your firewall is properly configured, as described in Preparing Your Firewall for the Internet Agent.

  4. Continue with Creating a Domain for the Internet Agent.

38.2.2 Creating a Domain for the Internet Agent

The Internet Agent domain will be a secondary domain. To create it, follow the instructions in Section 37.3, Creating a New Secondary Domain in a Cluster, taking your information from the Internet Agent Clustering Worksheet, rather than the System Clustering Worksheet, then return to this point.

Do not create any post offices in the Internet Agent domain.

Continue with Installing the MTA for the Internet Agent Domain.

38.2.3 Installing the MTA for the Internet Agent Domain

The MTA for the Internet Agent domain can be installed just like any other MTA in your clustered GroupWise system. Follow the instructions in Installing the Agent Software in a Cluster, then return to this point.

You do not need to edit the MTA startup file.

Continue with Installing and Configuring the Internet Agent in a Cluster.

38.2.4 Installing and Configuring the Internet Agent in a Cluster

After you have created a domain for the Internet Agent and installed the MTA for that domain, you are ready to install and configure the Internet Agent.

Installing the Internet Agent Software in a Cluster

  1. Map a drive to the shared disk of the Internet Agent resource group (Internet Agent Clustering Worksheet item 1).

  2. Map a drive to c:\ on the first node in the cluster where you will set up the Internet Agent as a Windows service (System Clustering Worksheet item 2).

  3. If you plan to install the Internet Agent software to the shared disk of the Internet Agent resource group (Internet Agent Clustering Worksheet item 6), create the drive:\grpwise\gwia directory on the shared disk accessed in Step 1.

    or

    If you plan to install the Internet Agent software to each node in the cluster, create the c:\grpwise\gwia directory on the drive accessed in Step 2).

  4. Start the Internet Agent Installation program, following the steps provided in NetWare and Windows: Installing the Internet Agent Software in Installing the GroupWise Internet Agent in the GroupWise 8 Installation Guide.

  5. Install the Windows Internet Agent, keeping in mind the following cluster-specific details:

    • Use the Windows Internet Agent Clustering Worksheet that you filled out in Planning the Internet Agent Installation to fill in the fields during the Internet Agent installation process.

    • On the Installation Path page, be sure to browse through the mapped drive to the directory you created in Step 3 above. Be sure that Run WebAccess Agent as a Windows Service is selected.

    • On the GroupWise Domain page, be sure to browse through the drive you mapped in Step 1 to the domain directory on the shared disk.

    • On the Post Installation Task List page, deselect Launch Internet Agent Now so that the Installation program does not start the Internet Agent after installation is complete.

  6. Repeat Step 4 and Step 5, mapping a drive to each node in the cluster.

    Even if you installed the Internet Agent software to a shared disk, you need to repeat the installation process for each node so that the Internet Agent gets set up as a Windows service on each node.

  7. If you installed the software to each node in the cluster and you selected Yes for Consolidate Configuration Files? (under Internet Agent Clustering Worksheet item 6), copy the gwia.cfg file to the planned location on the shared disk, then delete it from the c:\grpwise\gwia directory on each node to avoid future confusion.

  8. Make sure you have completed all the tasks described in Installing the GroupWise Internet Agent in the GroupWise 8 Installation Guide.

  9. Continue with Enabling Internet Addressing for Your Clustered GroupWise System.

Enabling Internet Addressing for Your Clustered GroupWise System

Setting up Internet addressing for a clustered Internet Agent is no different from setting it up for an Internet Agent in a any other environment. Follow the instructions in Enabling Internet Addressing in System in the GroupWise 8 Administration Guide, then continue with Verifying Internet Agent Object Properties.

Verifying Internet Agent Object Properties

During installation of the Internet Agent, the Internet Agent object should have been configured correctly. However, it can be helpful to verify certain cluster-specific information in order to familiarize yourself with the configuration of a clustered Internet Agent.

Accessing Internet Agent Object Properties

  1. In ConsoleOne, browse to and select the Internet Agent domain in order to display its contents.

  2. Right-click the Internet Agent object, then click Properties.

  3. Continue with Verifying the Reference to the Volume Resource.

Verifying the Reference to the Network Name for Use by DNS

In the Internet Agent object properties page tabs:

  1. Click SMTP/MIME > Settings.

  2. Verify the contents of the Hostname/DNS “A Record” Name field.

    It displays the hostname as currently configured in DNS. It should match the network name of the domain resource group, not the name of a node in the cluster.

  3. Make changes if necessary.

  4. Continue with Verifying the Reference to the Network Name in Directory Paths.

Verifying the Reference to the Network Name in Directory Paths

In the Internet Agent object properties page tabs:

  1. Click Server Directories.

  2. Verify that the displayed directories match the network name of the domain resource group, not the name of a node in the cluster.

  3. Make changes if necessary.

  4. Continue with Verifying Post Office Links.

Verifying Post Office Links

In the Internet Agent object properties page tabs:

  1. Click Post Office Links.

  2. Verify that the Access Mode column displays C/S (for client/server mode) for all post offices serviced by the clustered Internet Agent.

  3. Verify that the Links column displays the IP addresses of the post office resource groups, not the IP addresses of any nodes in the cluster.

  4. Make changes if necessary.

  5. Continue with Forcing Use of the Internet Agent Resource Group IP Address.

Forcing Use of the Internet Agent Resource Group IP Address

If you want the Internet Agent to send outgoing messages on its resource group IP address, rather than using the default the node IP address:

  1. Click GroupWise > Network Address.

  2. In the TCP/IP Address field, provide the resource group IP address (Internet Agent Clustering Worksheet item 1) for the Internet Agent to use for sending outgoing messages.

  3. Click SMTP/MIME, then click Settings.

  4. Select Bind to TCP/IP Address at Connection Time.

  5. Click OK.

  6. Continue with Testing the Clustered Internet Agent.

38.2.5 Testing the Clustered Internet Agent

After you have set up the Internet Agent resource group, you can test it by manually bringing it online and taking it offline again.

Continue with Managing the Internet Agent in a Cluster.