5.3 Setting Up WebAccess in a Cluster

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

5.3.1 Cluster-Enabling a Shared Volume for Use with the WebAccess Agent

  1. Complete the cluster-enabling steps in the applicable section of cluster documentation for your version of NetWare, as listed in Section 1.0, Introduction to GroupWise 7 and Novell Cluster Services on NetWare.

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

    For a review of the new Novell eDirectory™ objects that are created when you cluster-enable a shared volume, see Section 2.6, 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, you can 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 WebAccess Agent virtual server to support your preferred methods of short name resolution, as described in Configuring Short Name Resolution.

  3. Continue with Creating a Domain for the WebAccess Agent.

5.3.2 Creating a Domain for the WebAccess Agent

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

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

Continue with Installing the MTA for the WebAccess Agent Domain.

5.3.3 Installing the MTA for the WebAccess Agent Domain

The MTA for the WebAccess 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 WebAccess Agent.

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

5.3.4 Installing and Configuring the WebAccess Agent in a Cluster

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

Installing the WebAccess Agent Software in a Cluster

The WebAccess Agent is the component of your WebAccess installation that accesses post offices and libraries to retrieve information for WebAccess client users.

  1. Map a drive to the WebAccess Agent volume (WebAccess Clustering Worksheet item 1) where the WebAccess domain is located.

    The WebAccess 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 WebAccess Agent volume as the WebAccess Agent installation location (WebAccess Clustering Worksheet item 7), create the vol:\system directory on the WebAccess Agent volume accessed in Step 1.

    or

    if you selected sys:\system on each node, decide which node you will install the WebAccess agent to first, then map a drive to its sys:\system directory.

  3. Start the WebAccess Installation program and install the NetWare WebAccess Agent, following Step 1 through Step 5 provided in Installing the WebAccess Agent in Installing GroupWise WebAccess in the GroupWise 7 Installation Guide. Keep in mind the following cluster-specific details:

    • In the Components dialog box, select only GroupWise WebAccess Agent.

      Do not install the WebAccess Application at this time.

    • Use items 2 through 12 on the GroupWise WebAccess Installation Worksheet that you filled out in Planning the WebAccess Installation to fill in the fields during the WebAccess Agent installation process.

    • In the Network Address dialog box, select Configure GroupWise Agents for Clustering.

    • In the Installation Path dialog box, be sure to browse through the drive you mapped to the location you chose in Step 2 above.

    • In the Gateway Directory dialog box, be sure to browse to the domain directory through the drive you mapped in Step 1 above.

    • In the Start Applications dialog box, deselect Start the GroupWise WebAccess Agent.

    • The WebAccess Installation program creates the strtweb.ncf and stopweb.ncf files, which include the load and unload commands for the WebAccess Agent. You use this information later when you create the load and unload scripts for the WebAccess Volume Resource object.

  4. If you need to install the WebAccess Agent to sys:\system on multiple nodes in the cluster, repeat Step 4, mapping new drives as needed.

  5. Make sure you have completed all the WebAccess Agent tasks described in NetWare and Windows: Setting Up GroupWise WebAccess in Installing GroupWise WebAccess in the GroupWise 7 Installation Guide, but do not start the WebAccess Agent at this time.

  6. Continue with Configuring the WebAccess Agent Volume Resource to Load and Unload the WebAccess Agent and Its MTA.

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

The properties of the Volume Resource object define how the WebAccess 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 WebAccess Agent volume:

Modifying the Volume Resource Load Script for the WebAccess Agent

The volume resource load script executes whenever the WebAccess 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 WebAccess Agent volume.

    The next step assumes that this is the first time you have edited the load script. If other GroupWise agents are already running from this volume, some of the modifications have already 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 WebAccess 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 WebAccess Agent volume to the load script.

      cvsbind add cluster_volume_SERVER IP_address
      
    • If you selected vol:\system on WebAccess Agent volume as the installation location (WebAccess Clustering Worksheet items 5 and 7), 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 (WebAccess Clustering Worksheet items 5 and 7) but you are storing the MTA startup file on the WebAccess Agent volume, add that location to the server search path.

    • If you marked No under Load WebAccess Agent and Its MTA in Protected Memory? (WebAccess Clustering Worksheet item 9), 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 WebAccess Agent starts to load:

      load delay 
      delay 10
      

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

    • Transfer the WebAccess Agent load command from the strtweb.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.

      load volume:\system\gwinter.nlm 
           /ph=volume:\domain\wpgate\webac70a
           /user=username /PASSWORD=password
      
    • If you marked Yes under Load WebAccess Agent and Its MTA in Protected Memory? (WebAccess Clustering Worksheet item 9), add the address space parameter to the load commands to specify the protected address space where the WebAccess 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\gwinter.nlm 
           /ph=volume:\domain\wpgate\webac70a
           /user=username /password=password
      protection restart addr_space_name
      

    The result would look similar to the following example:

    Sample load script

    NOTE:The set commands are needed only when the MTA and the WebAccess Agent are not running in protected memory. The address space parameters are needed in the load commands only when the MTA and the WebAccess 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 WebAccess Agent.

Modifying the Volume Resource Unload Script for the WebAccess Agent

The volume resource unload script executes whenever the WebAccess 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 the unload script. If other GroupWise agents are already running from this volume, some of the modifications have already been made.

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

    • If you marked Yes under Load WebAccess Agent and Its MTA in Protected Memory? (WebAccess Clustering Worksheet item 9), 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 WebAccess 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 WebAccess 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 marked No under Load WebAccess Agent and Its MTA in Protected Memory? (WebAccess Clustering Worksheet items 9), create an unload command parallel to each load command that you placed in the load script.

      unload gwinter.nlm
      unload gwmta.nlm
      
    • On NetWare 5.1, if you are using SLP as a short name resolution method, add the cvsbind del command for the WebAccess 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 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 WebAccess Agent.

Setting the Failover Path and Policies for the WebAccess Agent

To modify the failover path and policies for the WebAccess 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 WebAccess Agent volume resource.

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

  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 section about failover and failback mode modes in the clustering documentation for your version of NetWare, as listed in Section 1.0, Introduction to GroupWise 7 and Novell Cluster Services on NetWare.

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

  6. Continue with Installing and Configuring the WebAccess Agent in a Cluster.

Installing and Configuring the WebAccess Application in a Cluster

If you have clustered your Web server, you must install the WebAccess Application on each node where the Web server is installed, as described in Installing the WebAccess Application and WebPublisher Application in Installing GroupWise WebAccess in the GroupWise 7 Installation Guide.

5.3.5 Testing Your Clustered WebAccess Installation

Remember that the WebAccess Agent volume resource and the WebAccess Application on your Web server are separate and could fail over to different nodes at different times.

To thoroughly test your WebAccess installation:

  1. Make sure the initial combination of WebAccess Agent volume resource and the WebAccess Application installed on your Web server is functioning properly.

  2. Migrate the WebAccess Agent volume resource to each node on its failover path, making sure it functions with your Web server.

  3. If your Web server is clustered, migrate the Web server cluster resource to a different node, migrate the WebAccess Agent volume resource to each node in the Web server cluster resource failover path, then make sure each combination works.

  4. Repeat Step 3 for each Web server cluster resource.