Sun Java System Messaging Server 6.3 Administration Guide

3.5.2 VCS Installation and Configuration Notes

The following instructions describe how to configure Messaging Server as an HA service, by using Veritas Cluster Server.

The default main.cf configuration file sets up a resource group called ClusterService that launches the VCSweb application. This group includes network logical host IP resources like csgnic and webip. In addition, the ntfr resource is created for event notification.

ProcedureTo Configure Messaging Server as an HA Service by Using Veritas Cluster Server

  1. Launch Cluster Explorer from one of the nodes.

    Note that these Veritas Cluster Server instructions assume you are using the graphical user interface to configure Messaging Server as an HA service.

    To launch Cluster Explorer, run the following command:


    # /opt/VRTSvcs/bin/hagui

    The VRTScscm package must be installed in order to use the GUI.

  2. Using the cluster explorer, add a service group called MAIL-RG.

  3. Add s1ms_dg disk group resource of type DiskGroup to the service group MAIL-RG and enable it.

  4. Add s1ms_mt mount resource of type Mount to the service group MAIL-RG.

    1. Be sure to click the Link button to enable linking resources, if they are not already enabled.

  5. Create a link between s1ms_mt and s1ms_dg. Enable the resource s1ms_mt.

    The figure depicts the dependency tree:

    Figure 3–5 Veritas Cluster Server Dependency Tree 1

    This image depicts the dependencies in a Veritas Cluster.

  6. Run the Communications Suite Installer to install the Messaging Server.

    1. Run the Messaging Server Initial Runtime Configuration from the primary node (for example, Node_A) to install Messaging Server.

    2. Install the Veritas Cluster Server agent package, SUNWmsgvc, (located in the Messaging Server Product subdirectory on the Sun Java Communications Suite CD) by using the pkgadd(1M) command.

      Messaging Server and the Veritas agent are now installed on Node_A.

  7. Switch to the backup node (for example, Node_B).

  8. Run the Communications Suite Installer to install Messaging Server on the backup node (Node_B).

  9. After installing Messaging Server, use the useconfig utility to obviate the need for creating an additional initial runtime configuration on the backup node (Node_B). The useconfig utility allows you to share a single configuration between multiple nodes in an HA environment. This utility is not meant to upgrade or update an existing configuration. See 3.3.3 Using the useconfig Utility.

    The Veritas agent is now installed on Node_B.

  10. From the Veritas Cluster Server Cluster Manager, Select Import Types... from the File menu which will display a file selection box.

  11. Import the MsgSrvTypes.cf file from the /etc/VRTSvcs/conf/config directory. Import this type file. Note that you need to be on a cluster node to find this file.

  12. Now create a resource of type MsgSrv (for example, Mail). This resource requires the logical host name property to be set.

  13. The Mail resource depends on s1ms_mt and webip. Create links between the resources as shown in the following dependency tree:

    Figure 3–6 Veritas Cluster Dependency Tree

    This image depicts the dependencies in a Veritas Cluster.

    1. Enable all resources and bring Mail online.

    2. All servers should be started.

  14. Switch over to Node_A and check if the High Availability configuration is working.