1. Make sure that the WebAccess Agent software is available in the software distribution directory you created in Step 6 in Section 14.1, Setting Up a New GroupWise System in a Linux Cluster.

2. Mount the WebAccess Agent partition (WebAccess Agent Clustering Worksheet item 1) where the WebAccess Agent message queues are located.

3. From the software distribution directory, start the GroupWise Installation program and select Configure GroupWise for Clustering.

   

4. Install the WebAccess Agent software, following the steps provided in Installing the Linux WebAccess Agent in Installing GroupWise WebAccess in the GroupWise 8 Installation Guide.

5. Configure the WebAccess Agent according to the GroupWise WebAccess Installation Summary Sheets that you filled out in Section 16.2, Planning the WebAccess Agent in a Linux Cluster, paying special attention to the cluster resource information on the Server Information page.

   

   As a result of selecting Configure GroupWise for Clustering on the preferred node, the following cluster-specific configuration actions are performed:

   • The WebAccess Agent startup file (webac80a.waa) is created in mount_point/groupwise/agents/share on the shared resource so that the WebAccess Agent uses the same startup file regardless of which cluster node it is running on. The --home switch includes the mount point and the path to the database so that the startup file is valid when mounted to each cluster node.

   • If this is the first GroupWise agent installed on this cluster node, the GroupWise High Availability service is automatically configured and its configuration file (gwha.conf) is created in the /etc/opt/novell/groupwise directory. If another GroupWise agent has already been installed on this cluster node, the gwha.conf file is updated to include the WebAccess Agent.

   • The clusterimport.conf file in the gwinst subdirectory of the software distribution directory from which you ran the GroupWise Installation program is updated, so that the cluster-specific information collected when you configured the WebAccess Agent on the preferred node is available when you install the WebAccess Agent on subsequent nodes.

   • The WebAccess Agent is not configured to start automatically on system startup. In a cluster, you do not want the WebAccess Agent to start automatically whenever a node restarts.

6. Continue with Running the WebAccess Agent Installation Program on Subsequent Nodes.

1. On the next node in the WebAccess Agent failover list, mount the WebAccess Agent partition (WebAccess Agent Clustering Worksheet item 1) where the WebAccess Agent message queues are located.

2. From the software distribution directory you created in Step 6 in Section 14.1, Setting Up a New GroupWise System in a Linux Cluster, start the GroupWise Installation program and select Configure GroupWise for Clustering.

   

   Because of the existence of the clusterimport.conf file in the gwinst subdirectory of the software distribution directory, a new installation option, Import Clustering Data, is now available on the main GroupWise Installation program page.

   

3. Install the WebAccess Agent software on the cluster node as usual, but do not use the Configure option.

4. On the main page of the Installation program, click Import Clustering Data, then click Next.

   

   All GroupWise agents that you have installed from the software distribution directory are listed, based on the information stored in the clusterimport.conf file.

5. Select the GroupWise agents that you want to configure on the current cluster node, then click OK.

   The Import Clustering Data option performs the following configuration actions for each subsequent node where you run it:

   • The grpwise script is created in the /etc/init.d directory on the current cluster node. It is configured specifically for the agents you just selected.

   • The GroupWise High Availability service is automatically configured on the current cluster node and its configuration file (gwha.conf) is created in the /etc/opt/novell/groupwise directory. It is configured specifically for the agents you just selected.

   Because the agent startup files and log files are stored on the shared resource, they do not need to be customized for each cluster node.

6. Repeat Step 1 through Step 5 for each cluster node in the WebAccess Agent failover list.

   After you install and configure the WebAccess Agent on each node in its failover list, the cluster node is ready for the WebAccess Agent to fail over to it.

7. Continue with Testing Your WebAccess Agent Installation on Each Node.

1. Test the WebAccess Agent by starting it with a user interface, as described in Starting the Linux WebAccess Agent in Installing GroupWise WebAccess in the GroupWise 8 Installation Guide.

   /opt/novell/groupwise/agents/bin/gwinter --show @webac80a.waa &
   

2. Stop the WebAccess Agent by closing the window that it is running in.

3. After you can see that the WebAccess Agent stopped successfully, test it by starting it as a daemon, as described in Starting the Linux GroupWise Agents as Daemons in Installing GroupWise Agents in the GroupWise 8 Installation Guide.

   /etc/inet.d/grpwise start webac80a
   /etc/inet.d/grpwise status webac80a
   

4. Stop the WebAccess Agent.

   /etc/inet.d/grpwise stop webac80a
   /etc/inet.d/grpwise status webac80a
   

5. Repeat Step 1 through Step 4for each node in the WebAccess Agent failover list.

6. Continue with Configuring Clustered Logging

To set up the load script in iManager:

1. Expand Clusters, then click Cluster Options.

2. In the Cluster field, browse to the Cluster object where the WebAccess Agent cluster resource is located.

3. Click the Cluster object to display the cluster resources that belong to the cluster.

4. Select the WebAccess Agent cluster resource that you created when you set up the WebAccess Agent partition, then click Properties.

   The default load script from a generic IP service template appears as follows:

   #!/bin/bash 
   . /opt/novell/ncs/lib/ncsfuncs
   
   # mount the file system
   exit_on_error mount -t reiserfs /dev/evms/vol /mnt/generic
   
   # add the IP address
   exit_on_error add_secondary_ipaddress a.b.c.d
   
   # start the service
   exit_on_error /etc/init.d/myservice start
   
   # return status
   exit 0
   

5. If this is an NSS volume or a shared pool, make the following changes to set up the WebAccess Agent load script:

   1. As needed, in the mount command, change reiserfs to whatever file system type is in use on nodes in the cluster.

   2. In the mount command, change vol to the actual device name in use on nodes in the cluster.

   3. In the mount command, change /mnt/generic to the mount point directory in use on nodes in the cluster.

   4. In the add_secondary_ipaddress command, change a.b.c.d to the secondary IP address of the WebAccess Agent partition (WebAccess Agent Clustering Worksheet item 1)

   5. In the start service command, change myservice start to the command to start the WebAccess Agent and its MTA.

      /etc/init.d/grpwise start domain
      /etc/init.d/grpwise start webac80a
      

6. If this is a traditional Linux volume, use the following load script:

   #! /bin/bash
   . /opt/novell/ncs/lib/ncsfunc
   
   # define the IP address
   RESOURCE_IP=123.123.1.
   
   # define the file system type
   MOUNT_FS=reiserf
   
   # define the device
   exit_on_error evms -f /var/opt/novell/ncs/ContainerActivate -rl
                                                    Share ‘uname -n‘
   MOUNT_DEV=/dev/evms/Share/dat
   
   # define the mount point
   MOUNT_POINT=/mnt/mount_point
   
   # mount the file system
   exit_on_error mount -t $MOUNT_FS $MOUNT_DEV $MOUNT_POINT
   
   # add the IP address
   exit_on_error add_secondary_ipaddress $RESOURCE_IP
   
   /etc/init.d/grpwise start domain
   /etc/init.d/grpwise start domain.webac80a
   
   exit 0
   

   Make the following changes to set up the load script for the agents:

   1. On the RESOURCE_IP line, change 123.123.1.1 to the secondary IP address of the GroupWise partition (WebAccess Agent Clustering Worksheet item 1)

   2. As needed on the MOUNT_FS line, change reiserfs to whatever file system type is in use on nodes in the cluster.

   3. On the MOUNT_DEV line, change /dev/evms/Share/dat to the actual device name in use on nodes in the cluster.

   4. On the MOUNT_POINT line, change /mnt/mount_point to the mount point directory in use on nodes in the cluster.

   5. Use the following command to start the MTA:

      /etc/init.d/grpwise start domain
      

   6. Use the following command to start the WebAccess Agent:

      /etc/init.d/grpwise start domain.webac80a.
      

7. Click OK to save the load script.

1. On the Cluster Resource Properties page of the WebAccess Agent cluster resource, click Scripts > Unload Script.

   The default unload script appears as follows:

   #!/bin/bash
   . /opt/novell/ncs/lib/ncsfuncs
   
   # request service stop
   ignore_error /etc/init.d/myservice stop
   
   # stop service otherwise
   sleep 8
   ignore_error fuser -k /mnt/generic
   
   # del the IP address
   ignore_error del_secondary_ipaddress a.b.c.d
   
   # umount the file system
   exit_on_error umount /mnt/generic
   
   # return status
   exit 0
   

2. If this is an NSS volume or a shared pool, make the following changes:

   1. In the request service stop section, change myservice stop to the command to stop the WebAccess Agent and its MTA.

      /etc/init.d/grpwise stop webac80a
      /etc/init.d/grpwise stop domain
      

   2. In the stop service otherwise section (used if the agents do not stop normally), remove these commands:

      sleep 8
      ignore_error fuser -k /mnt/generic
      
      

   3. Use these commands instead to stop the WebAccess Agent and its MTA:

      ignore_error /etc/init.d/grpwise stop webac80a
      ignore_error /etc/init.d/grpwise stop domain
      
      sleep 8
      
      ignore_error pkill -fx "/opt/novell/groupwise/agents/bin/gwinter
                                         @/webac80a.waa"
      ignore_error pkill -fx "/opt/novell/groupwise/agents/bin/gwmta
                                         @/path_to_startup_file/domain.mta"
      

   4. In the del IP address section, change a.b.c.d to the secondary IP address used in the load script.

   5. In the umount file system section, change /mnt/generic to the mount point directory used in the load script.

3. If this is a traditional Linux volume, use the following unload script:

   #!/bin/bash
   . /opt/novell/ncs/lib/ncsfuncs
   
   /etc/init.d/grpwise stop domain.webac80a
   /etc/init.d/grpwise stop domain
   
   # define the IP address
   RESOURCE_IP=172.16.5.18
   
   # define the mount point
   MOUNT_POINT=/mnt/mount_point
   
   sleep 8
   
   ignore_error fuser -k $MOUNT_POINT
   
   # del IP the address
   ignore_error del_secondary_ipaddress $RESOURCE_IP
   
   # umount the file system
   exit_on_error umount $MOUNT_POINT
   
   # return status
   exit 0
   

   Make the following changes to set up the unload script for the agents.

   1. Use the following command to stop the WebAccess Agent:

      /etc/init.d/grpwise stop domain.webac80a
      

   2. Use the following command to stop the MTA:

      /etc/init.d/grpwise stop domain
      

   3. On the RESOURCE_IP line, change 172.16.5.18 to the secondary IP address used in the load script.

   4. On the MOUNT_POINT line, change /mnt/mount_point to the mount point directory used in the load script.

   5. Adjust the sleep command as needed so that the agents can shut down normally on your system without being inadvertently killed. by the fuser -k command that follows.

   6. In the fuser -k command (used if the agents do not stop normally), change -k to -mk.

      The -m parameter obtains the PID numbers of the processes to kill.

4. Click OK to save the unload script.

1. On the Cluster Resource Properties page of the WebAccess Agent cluster resource, click General.

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

   • Fails over automatically if the node it is running on fails

   • Starts automatically on the next node in its failover list

   • Continues running at its failover location, even after its most preferred node is again available

     If you are considering changing these defaults, see the OES 11 Novell Cluster Services 2 for Linux Administration Guide .

2. Under Preferred Nodes, arrange the nodes in the cluster into the desired failover list for the WebAccess Agent (WebAccess Agent Clustering Worksheet item 3).

3. Click OK.

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

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

3. Continue with Verifying Post Office Links.

In the WebAccess 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 WebAccess Agent.

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

4. Make changes if necessary.

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

If you want the WebAccess Agent to always use its secondary IP address, rather than using the primary IP address:

1. Click GroupWise > Network Address.

2. In the TCP/IP Address field, provide the secondary IP address (WebAccess Agent Clustering Worksheet item 1) for the Internet Agent.

3. Select Bind Exclusively to TCP/IP Address.

4. Click OK.

5. Continue with Testing the WebAccess Agent in a Linux Cluster.