Setting Up the Internet Agent in a Cluster

You should already have reviewed Planning the Internet Agent in a Cluster and filled out the Internet Agent Clustering Worksheet. You are now ready to complete the following tasks to set up the Internet Agent in a clustering environment:


Cluster-Enabling a Shared Volume for Use with the Internet Agent

To cluster-enable the Internet Agent shared volume:

  1. Complete the steps in the applicable section of Novell Cluster Services Overview and Installation for your version of NetWare:

    The Internet Agent Clustering Worksheet provides the volume to cluster-enable, the cluster-enabled volume IP address, and the failover path for the Internet Agent volume.

    For a review of the new Novell® eDirectoryTM objects that are created when you cluster-enable a shared volume, see Deciding Whether to Cluster-Enable the Shared Volumes Used by GroupWise.

    If you have installed the latest version of ConsoleOne® and the Novell Cluster Services snap-in, as described in Updating to the Latest ConsoleOne Snap-In, you will be able to rename the cluster-related objects in case your DNS name server cannot resolve object names that include the underscore (_) character.

  2. To ensure successful short name resolution, add entries for the Internet Agent virtual server 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.


Creating a Domain for the Internet Agent

The Internet Agent domain will be a secondary domain. To create it, follow the instructions in 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.


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. You do not need to modify the Volume Resource properties until after you have installed the Internet Agent.

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


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 Internet Agent volume (Internet Agent Clustering Worksheet item 1).

    The Internet Agent volume name will be cluster_volume. For assistance with mapping a drive to a cluster-enabled volume, see Configuring Short Name Resolution.

  2. If you selected vol:\system on Internet Agent Volume as the Internet Agent installation location (Internet Agent Clustering Worksheet item 6), create the vol:\system directory on the Internet Agent volume accessed in Step 1.

    or

    If you selected sys:\system on Each Node, decide which node you will install the Internet Agent to first, then map a drive to sys:\system on that node.

  3. Start the Internet Agent Installation program and install the NetWare® Internet Agent, following the steps provided in "Installing the Internet Agent Software on NetWare or Windows" in "Installing the GroupWise Internet Agent" in the GroupWise 6.5 Installation Guide. Keep in mind the following cluster-specific details:

    • Use the notes you made during Planning the Internet Agent Installation to fill in the fields during the Internet Agent installation process.
    • In the Installation Path dialog box, be sure to browse through the drive you mapped to the location you chose in Step 2 above. Deselect Update AUTOEXEC File and select Configure GroupWise Agents for Clustering.
    • In the GroupWise Domain dialog box, be sure to browse through the drive you mapped in Step 1 to the domain directory (Internet Agent Clustering Worksheet item 2).
    • The Internet Agent Installation program creates the gwia.ncf file, which includes the load command for the Internet Agent. You will use this information later when you create the load script for the Volume Resource object.
  4. If you need to install the Internet Agent to sys:\system to each node in the cluster:

    1. Repeat Step 3, mapping new drives as needed.

    2. If you selected Yes for Consolidate Multiple Configuration Files on Internet Agent Volume? (under Internet Agent Clustering Worksheet item 6), copy the gwia.cfg file to the planned location, then delete it from the sys:\system directories to avoid future confusion.

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

    The Internet Agent starts automatically immediately after Installation.

  6. Stop each Internet Agent you have installed before configuring it for clustering.

  7. Continue with Configuring the Internet Agent Volume Resource to Load and Unload the Internet Agent and Its MTA.


Configuring the Internet Agent Volume Resource to Load and Unload the Internet Agent and Its MTA

The properties of the Volume Resource object define how the Internet Agent volume functions within the cluster, how NLM programs are loaded and unloaded, and how failover and failback situations are handled. Complete the following tasks for the Internet Agent volume:


Modifying the Volume Resource Load Script for the Internet Agent

The volume resource load script executes whenever the Internet Agent volume comes online.

To set up the load script:

  1. In ConsoleOne, browse to and select the Cluster object.

    If necessary, click View > Console View to display its contents.

  2. Right-click the Volume Resource object (volume_SERVER), then click Properties > Load to display the default volume resource load script for the Internet Agent volume.

    The next step assumes that this is the first time you have edited this load script. If other GroupWise agents are already running from this volume, some of the modifications will already have been made.

  3. Make the following changes to the default load script:

    • Remove the trustmig command. It is not necessary to migrate trustees for the Internet Agent volume. Removing this line helps the load script to execute faster.
    • On NetWare 5.1, if you are using SLP as a short name resolution method, as described in Configuring Short Name Resolution, add the cvsbind add command for the Internet Agent volume to the load script.

      cvsbind add cluster_volume_SERVER IP_address

    • If you selected vol:\system on Internet Agent volume as the installation location (Internet Agent Clustering Worksheet items 4 and 6), add a search add command to add the new vol:\system directory to the server search path.

      search add volume:\system

    • If you selected sys:\system on each node as the installation location (Internet Agent Clustering Worksheet items 4 and 6) but you are storing the MTA startup file and the Internet Agent configuration file on the Internet Agent volume, add that location to the server search path.
    • If you selected No under Load Internet Agent and Its MTA in Protected Memory? (Internet Agent Clustering Worksheet item 8), add the following abend recovery options:

      set auto restart after abend = 2
      set auto restart after abend delay time = 0
      set auto restart down timeout = 60
      set developer option = off

      These settings provide the best possible handling of GroupWise databases in the event that an abend should occur within the cluster.

    • Transfer the MTA load command from the grpwise.ncf file located in the vol:\system directory into the load script. Use Ctrl+C and Ctrl+V to copy and paste text into the load script page. Then delete or rename the grpwise.ncf file to avoid future confusion.

      load volume:\system\gwmta.nlm @domain.mta

    • Add a delay so that the MTA is fully loaded before the Internet Agent starts to load:

      load delay.nlm
      delay 10

      The length of the delay varies from system to system; ten seconds is a good starting place.

    • Transfer the Internet Agent load command from the gwia.ncf file located in the vol:\system directory into the load script. Use Ctrl+C and Ctrl+V to copy and paste text into the load script page. Then delete or rename the gwia.ncf file to avoid future confusion.

      load volume:\system\gwia.nlm @gwia.cfg

    • If you selected Yes under Load Internet Agent and Its MTA in Protected Memory? (Internet Agent Clustering Worksheet item 8), add the address space parameter to the load commands to specify the protected address space where the Internet Agent and its MTA will run. Add a protection restart command for the address space name.

      load address space=addr_space_name
          volume:\system\gwmta.nlm @domain.mta
      load address space=addr_space_name
          volume:\system\gwia.nlm @gwia.cfg
      protection restart addr_space_name

    The result would look similar to the following example:


    Sample modified load script

    NOTE:  The set commands are needed in the load script only when the MTA and the Internet Agent are not running in protected memory. The address space parameters are needed in the load commands only when the MTA and the Internet Agent are running in protected memory.

  4. Click Apply to save the load script.

  5. If necessary, click OK to confirm that you must offline and then online the volume resource in order for the changes to take effect.

  6. Continue with Modifying the Volume Resource Unload Script for the Internet Agent.


Modifying the Volume Resource Unload Script for the Internet Agent

The volume resource unload script executes whenever the Internet Agent volume goes offline. Programs should be unloaded in the reverse order of how they were loaded. This ensures that supporting programs are not unloaded before programs that rely on them in order to function properly.

To set up the unload script:

  1. In ConsoleOne, in the properties pages for the Volume Resource object (volume_SERVER), click Unload to display the default volume resource unload script.

    The next step assumes that this is the first time you have edited this unload script. If other GroupWise agents are already running from this volume, some of the modifications will already have been made.

  2. Make the following changes to the default unload script:

    • If you selected Yes under Load Internet Agent and Its MTA in Protected Memory (Internet Agent Clustering Worksheet item 8), add an unload address space command and an unload kill address space command to ensure that the address space is completely cleaned up.

      unload address space=addr_space_name
      unload kill address space=addr_space_name

      If your system seems to be trying to kill the address space before the Internet Agent and its MTA have been completely unloaded, resulting in the agents hanging in the unloading state, set a delay of several seconds before issuing the unload kill address space command to allow the Internet Agent and its MTA adequate time to unload completely. The length of the delay varies from system to system; ten seconds is a good starting place.

      unload address space=addr_space_name
      delay 10
      unload kill address space=addr_space_name

    • If you selected No under Load Internet Agent and Its MTA in Protected Memory? (Internet Agent Clustering Worksheet items 8), create an unload command parallel to each load command that you placed in the load script.

      unload volume:\system\gwia.nlm
      unload volume:\system\gwmta.nlm

    • On NetWare 5.1, if you are using SLP as a short name resolution method, add the cvsbind del command for the Internet Agent volume to the unload script.

      cvsbind del cluster_volume_SERVER IP_address

    • Remove the trustmig command just like you did in the load script.

    The result would look similar to the following example:


    Sample modified unload script
  3. Click Apply to save the unload script.

  4. If necessary, click OK to confirm that you must offline and then online the volume resource in order for the changes to take effect.

  5. Continue with Setting the Failover Path and Policies for the Internet Agent.


Setting the Failover Path and Policies for the Internet Agent

To modify the failover path and policies for the Internet Agent volume resource:

  1. In ConsoleOne, in the properties pages for the Volume Resource object (volume_SERVER), click Nodes to display the default failover path for the Internet Agent volume resource.


    Default failover path for the volume resource
  2. Arrange the nodes in the cluster into the desired failover path for the Internet Agent volume (Internet Agent Clustering Worksheet item 3).

  3. Click Apply to save the failover path.

  4. Click Policies to display the default start, failover, and failback policies.


    Default start, failover, and failback policies

    The default policy settings are often appropriate. By default, a volume resource:

    • Fails over automatically if the node it is running on fails
    • Starts automatically on the next node in its failover path
    • Continues running at its failover location, even after its most preferred node is again available

    If you are considering changing these defaults, see the applicable section of Novell Cluster Services Overview and Installation for your version of NetWare:

  5. Click OK when you are finished editing the Internet Agent volume resource properties.

  6. 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 6.5 Administration Guide, then return to this point.


Verifying GWIA Object Properties

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


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

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

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


Verifying the Reference to the Volume Resource

In the GWIA object properties pages:

  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 Volume Resource object name (volume_SERVER) of the Internet Agent volume, not the name of a physical server in the cluster.

  3. Make changes if necessary.

  4. Continue with Verifying the Reference to the Virtual Server.


Verifying the Reference to the Virtual Server

In the GWIA object properties pages:

  1. Click Server Directories.

  2. Verify that the displayed directories match the virtual server name (cluster_volume_SERVER) associated with the Volume Resource object, not the name of a physical server in the cluster.

  3. Make changes if necessary.

  4. Continue with Verifying Post Office Links.


Verifying Post Office Links

In the GWIA object properties pages:

  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 Internet Agent.

  3. Verify that the Links column displays the secondary IP addresses of the GroupWise volumes where post offices reside, not the IP addresses of any physical servers in the cluster.

  4. Make changes if necessary.

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


Forcing Use of the Internet Agent Secondary IP Address

If you want the Internet Agent to send outgoing messages on its secondary IP address, rather than using the default of its primary IP address:

  1. Click GroupWise > Network Address.

  2. In the TCP/IP Address field, provide the secondary IP address (under 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 TCIP/IP Address at Connection Time.

  5. Click OK.

  6. Continue with Testing the Clustered Internet Agent.


Testing the Clustered Internet Agent

After you have configured the Internet Agent volume resource, you can test the load and unload scripts by bringing the Internet Agent volume online and taking it offline again.

  1. In ConsoleOne, select the Cluster object, then click View > Cluster State.


    Cluster State dialog box indicating the volume resource is offline

    The new Internet Agent volume resource shows Offline in the State column.

  2. Click the new Internet Agent volume resource, then click Online.


    Cluster State dialog box indicating the volume resource is running

    The State column for the volume resource now displays Running.

  3. Observe the server console where the Internet Agent and its MTA are loading to see that they start and run correctly.

    If you are using protected memory, you can use the protection command at the server console prompt to list all the address spaces on the node and what NLM programs are running in each one.

  4. Click the new Internet Agent volume resource, then click Offline.

    The State column for the volume resource returns to Offline.

  5. Observe the server console where the Internet Agent and its MTA are unloading to see that they shut down correctly.

    If you are using protected memory, you can use the protection command again to make sure that the address space used by the Internet Agent and its MTA is no longer present.

  6. Repeat Step 2 whenever you are ready to bring the new Internet Agent volume resource online permanently.

    On NetWare 6.x, these actions can also be performed from your Web browser. See Using NetWare Remote Manager on NetWare 6.x.

  7. Continue with Managing the Internet Agent in a Cluster.