23.2 Setting Up the Internet Agent in a Windows Cluster

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

23.2.1 Setting Up the GWIA Resource Group

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

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

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

  4. Continue with Creating a Domain for the GWIA.

23.2.2 Creating a Domain for the GWIA

The GWIA domain will be a secondary domain. To create it, follow the instructions in Section 22.3, Creating a New Secondary Domain in a Windows 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 GWIA domain.

Continue with Installing the MTA for the GWIA Domain.

23.2.3 Installing the MTA for the GWIA Domain

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

You do not need to edit the MTA startup file.

Continue with Installing and Configuring the GWIA in a Windows Cluster.

23.2.4 Installing and Configuring the GWIA in a Windows Cluster

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

Installing the GWIA Software in a Windows Cluster

  1. Map a drive to the shared disk of the GWIA 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 GWIA as a Windows service (System Clustering Worksheet item 2).

  3. (Conditional) If you plan to install the GWIA software to the shared disk of the GWIA resource group (Internet Agent Clustering Worksheet item 6), create the drive:\Progarm Files\Novell\Groupwise Server\GWIA directory on the shared disk accessed in Step 1.

    or

    If you plan to install the GWIA software to each node in the cluster, create the c:\Program Files\Novell\GroupWise Server\GWIA directory on the drive accessed in Step 2).

  4. Start the GWIA Installation program, following the steps provided in Windows: Installing the GWIA Software in Installing the GroupWise Internet Agent in the GroupWise 2012 Installation Guide.

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

    • Use the Windows Internet Agent Clustering Worksheet that you filled out in Section 23.1, Planning the Internet Agent in a Windows Cluster to fill in the fields during the GWIA 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 Internet 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 GWIA 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 GWIA software to a shared disk, you need to repeat the installation process for each node so that the GWIA is set up as a Windows service on each node.

  7. (Conditional) 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:\Program Files\Novell\GroupWise Server\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 2012 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 GWIA is no different from setting it up for a GWIA in a any other environment. Follow the instructions in Enabling Internet Addressing in System in the GroupWise 2012 Administration Guide, then continue with Verifying GWIA Object Properties.

Verifying GWIA Object Properties

During installation of the GWIA, the GWIA 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 GWIA.

Accessing GWIA Object Properties
  1. In ConsoleOne, browse to and select the GWIA domain in order to display its contents.

  2. Right-click the GWIA object, then click Properties.

  3. Continue with Verifying the Reference to the Network Name for Use by DNS.

Verifying the Reference to the Network Name for Use by DNS

In the GWIA 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. (Conditional) 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 GWIA 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. (Conditional) Make changes if necessary.

  4. Continue with Verifying Post Office Links.

Verifying Post Office Links

In the GWIA 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 GWIA.

  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. (Conditional) Make changes if necessary.

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

Forcing Use of the GWIA Resource Group IP Address

If you want the GWIA 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 (GWIA Clustering Worksheet item 1) for the GWIA 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 GWIA.

23.2.5 Testing the Clustered GWIA

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

Continue with Managing the Internet Agent in a Windows Cluster.