test

Sun Java System Calendar Server 6.3 Administration Guide

6.6.3 Installing and Configuring High Availability for Calendar Server 6.3 Software

This section contains instructions for the tasks involved in installing and configuring high availability for Calendar Server.

Perform each of the following tasks in turn to complete the configuration:

ProcedureTo Prepare Each Node of the Cluster

  1. Install Calendar Server on the Primary and Secondary nodes of the cluster, using the Communications Suite 5 installer.

    Note –

    Be sure to specify the same installation root on all nodes.

    1. At the Specify Installation Directories panel, answer with the installation root for both nodes.

      This will install the Calendar Server binaries in the following directory:/install-root/SUNWics5/cal. This directory is called the Calendar Server base (cal-svr-base).

    2. Choose the Configure Later option.

    3. After the installation is complete, verify that the files are installed.

      # pwd
/cal-svr-base

# ls -rlt

total 16
drwxr-xr-x   4 root     bin          512 Dec 14 12:52 share
drwxr-xr-x   3 root     bin          512 Dec 14 12:52 tools
drwxr-xr-x   4 root     bin         2048 Dec 14 12:52 lib
drwxr-xr-x   2 root     bin         1024 Dec 14 12:52 sbin
drwxr-xr-x   8 root     bin          512 Dec 14 12:52 csapi
drwxr-xr-x  11 root     bin         2048 Dec 14 12:52 html

  2. Run the Directory Preparation Script (comm_dssetup.pl) against your existing Directory Server LDAP.

    This prepares your Directory Server by setting up new LDAP schema, index, and configuration data.

    For instructions and further information about running comm_dssetup.pl, see Chapter 8, Directory Preparation Tool (comm_dssetup.pl), in Sun Java Communications Suite 5 Installation Guide.

ProcedureTo Set Up the Primary Node

Use the Sun Cluster command line interface as indicated to set up HA on the first node.

Note –

Refer to 6.5 Naming Conventions for All Examples in this Deployment Example for Configuring High Availability in Calendar Server Version 6.3 as a key for directory names and Sun Cluster resource names in the examples.

  1. Register the Calendar Server and HAStoragePlus resource

    ./scrgadm -a -t SUNW.HAStoragePlus
./scrgadm -a -t SUNW.scics

  2. Create a failover Calendar Server resource group.

    For example, the following instruction creates the calendar resource group CAL-RG with the primary node as Node1 and the secondary, or failover, node as Node2.

    ./scrgadm -a -g CAL-RG -h node1,node2

  3. Create a logical hostname resource in the Calendar Server resource group and bring the resource group online.

    For example, the following instructions create the logical hostname resource LOG-HOST-RS, and then brings the resource group CAL-RG online.

    ./scrgadm -a -L -g CAL-RG -l LOG-HOST-RS
./scrgadm -c -j LOG-HOST-RS -y    \
      R_description="LogicalHostname resource for LOG-HOST-RS"
./scswitch -Z -g CAL-RG

  4. Create and enable the HAStoragePlus resource.

    For example, the following instructions create and enable the HAStoragePlus resource CAL-HASP-RS.

    scrgadm -a -j CAL-HASP-RS -g CAL-RG -t 
     SUNW.HAStoragePlus:4 -x FilesystemMountPoints=/cal
scrgadm -c -j CAL-HASP-RS -y 
     R_description="Failover data service resource for SUNW.HAStoragePlus:4"
scswitch -e -j CAL-HASP-RS

ProcedureTo Run the Configuration Utility (csconfigurator.sh) on the Primary Node

  1. Run the configuration program.

    For example, from the /cal-svr-base/sbin directory:

    # pwd
     /cal-svr-base/sbin

# ./csconfigurator.sh

    For further information about running the configuration script, see Chapter 2, Initial Runtime Configuration Program for Calendar Server 6.3 software (csconfigurator.sh)also in this guide.

  2. At the Run Time Configuration panel, deselect both Calendar Server startup options.

  3. At the Directories panel, configure all directories on a shared disk. Use the following locations:

    Config Directory

    /share-disk-dir/config

    Database Directory

    /share-disk-dir/csdb

    Attachment Store Directory

    /share-disk-dir/store

    Logs Directory

    /share-disk-dir/logs

    Temporary Files Directory

    /share-disk-dir/tmp

    Once you have finished specifying the directories, choose Create Directory.

  4. At the Archive and Hot Backup panel, specify the following choices:

    Archive Directory

    /share-disk-dir/csdb/archive

    Hot Backup Directory

    /share-disk-dir/csdb/hotbackup

    When you have finished specifying the directories, choose the Create Directory option.

  5. Verify that the configuration is successful.

    Look at the end of the configuration output to make sure it says: “All Tasks Passed.” The following example shows the last part of the configuration output. 

    ...
All Tasks Passed. Please check install log 
/var/sadm/install/logs/Sun_Java_System_Calendar_Server_install.B12141351
 for further details.

    For a larger sample of the output, see 6.11 Example Output from the Calendar Configuration Program (Condensed)

  6. Click Next to finish configuration.

ProcedureTo Configure the Secondary Node

  1. Switch to the secondary node.

    Using the Sun Cluster command line interface, switch to the secondary node. For example, the following command switches the resource group to the secondary (failover) node, Node2:

    scswitch -z -g CAL-RG -h Node2

  2. Create a symbolic link from the Calendar Server config directory to the config directory of the Shared File System.

    For example, perform the following commands:

    # pwd
/cal-svr-base

# ln -s /share-disk-dir/config .
    Note –

    Do not forget the dot (.) at the end of the ln command.

  3. Configure Calendar Server on the secondary node using the state file from the primary node configuration.

    Share the configuration of the primary node by running the state file created when you ran the configuration program.

    For example, run the following command:

    # /cal-svr-base/sbin/csconfigurator.sh -nodisplay -noconsole -novalidate

    Check that all the tasks passed as with the first time you ran the configuration program.

  4. Edit the Configuration File (ics.conf)

    Edit the ics.conf file by adding the following parameters to the end of the file. The logical hostname of the calendar resource is LOG-HOST-RS.

    Note –

    Back up your ics.conf file before performing this step.

    ! The following are the changes for making Calendar Server
! Highly Available
!
local.server.ha.enabled="yes"
local.server.ha.agent="SUNWscics"
service.http.listenaddr="IPAddress"
local.hostname="LOG-HOST-RS"
local.servername="LOG-HOST-RS"
service.ens.host="LOG-HOST-RS"
service.http.calendarhostname="LOG-HOST-RS-Domain.com"
local.autorestart="yes"
service.listenaddr="IPAddress"

  5. Create the Calendar Server resource group and enable it.

    For this example, the resource group name is CAL-SVR-RS. You will also be required to supply the logical host resource name and the HAStoragePlus resource name.

    ./scrgadm -a -j CAL-SVR-RS -g CAL-RG 
     -t SUNW.scics -x ICS_serverroot=/cal-svr-base 
     -y Resource_dependencies=CAL-HASP-RS,LOG-HOST-RS

./scrgadm -e -j CAL-SVR-RS

  6. Test the successful creation of the calendar resource group by performing a fail over. 

    ./ scswitch -z -g CAL-RG -h Node1

    When you have finished this step, you have completed the creation and configuration of the asymmetric high availability system for Calendar Server. The section that follows explains how to set up logging on Sun Cluster for debug purposes.

    You have now finished the installation and configuration of an asymmetric Calendar Server HA system.