Sun Cluster 3.0 Data Services Installation and Configuration Guide

How to Register and Configure Sun Cluster HA for iPlanet Web Server

To register and configure the Sun Cluster HA for iPlanet Web Server data service, use the Cluster Module of Sun Management Center or the following command-line procedure.

To perform this procedure, you must have the following information:

Perform this procedure on any cluster member.

  1. Become superuser on a node in the cluster.

  2. Register the resource type for Sun Cluster HA for iPlanet Web Server.


    # scrgadm -a -t SUNW.iws
    
    -a

    Adds the data service resource type.

    -t SUNW.iws

    Specifies the predefined resource type name for your data service.

  3. Create a failover resource group to hold the network and application resources.

    For failover services, this resource group also holds the application resources.

    You can optionally select the set of nodes on which the data service can run with the -h option.


    # scrgadm -a -g fo-resource-group-name [-h nodelist]
    -g fo-resource-group-name

    Specifies the name of the failover resource group. This name can be your choice but must be unique for resource groups within the cluster.

    -h nodelist

    An optional comma-separated list of physical node names or IDs that identify potential masters. The order here determines the order in which the nodes are considered as primary during failover.


    Note -

    Use -h to specify the order of the node list. If all the nodes in the cluster are potential masters, you need not use the -h option.


  4. Verify that all network addresses that you are using have been added to your name service database.

    You should have done this verification as part of the Sun Cluster installation. For details, see the planning chapter in the Sun Cluster 3.0 Installation Guide.


    Note -

    To avoid any failures because of name service lookup, ensure that all logical host names and shared addresses are present in the server's and client's /etc/hosts file. Configure name service mapping in /etc/nsswitch.conf on the servers to first check the local files before trying to access NIS or NIS+.


  5. Add a network resource (logical host name or shared address) to the failover resource group.


    # scrgadm -a {-S | -L} -g fo-resource-group-name \
    -l network-resource,... [-j resource-name] \
    [-X auxnodelist=nodeid, ...] [-n network-interface-id-list]
    -S | -L

    You use -S for shared address resources or -L for logical host name resources.

    -g fo-resource-group-name

    Specifies the name of the failover resource group.

    -l network-resource, ...

    Specifies a comma-separated list of network resources to add. You can use the -j option to specify a name for the resources. If you do not do so, the network resources have the name of the first entry on the list.

    -j resource-name

    Specifies an optional resource name. If you do not supply this name, the name of the network resource defaults to the first name specified after the -l option.

    -X auxnodelist=nodeid, ...

    Specifies an optional comma-separated list of physical node IDs that identify cluster nodes that can host the shared address but never serve as a primary in the case of failover. These nodes are mutually exclusive with the nodes identified in nodelist for the resource group, if specified.

    -n network-interface-id-list

    Specifies an optional comma-separated list that identifies the NAFO groups on each node. All nodes in nodelist of the resource group must be represented in network-interface-list. If you do not specify this option, scrgadm attempts to discover a net adapter on the subnet identified by the hostname list for each node in nodelist.

  6. Scalable services only: Create a scalable resource group to run on all desired nodes of the cluster.

    If you are running Sun Cluster HA for iPlanet Web Server as a failover data service, skip Step 7.

    Create a resource group to hold a data service application resource. You must specify the maximum and desired number of primary nodes, as well as a dependency between this resource group and the failover resource group you created in Step 3. This dependency ensures that in the event of failover, the resource manager starts up the network resource before any data services that depend on it.


    # scrgadm -a -g resource-group-name \
    -y Maximum_primaries=m -y Desired_primaries=n \
    -y RG_dependencies=resource-group-name
    
    -y Maximum_primaries=m

    Specifies the maximum number of active primary nodes allowed for this resource group. If you do not assign a value to this property, the default is 1.

    -y Desired_primaries=n

    Specifies the desired number of active primary nodes allowed for this resource group. If you do not assign a value to this property, the default is 1.

    -y RG_dependencies= resource-group-name

    Identifies the resource group that contains the shared address resource on which the resource group being created depends.

  7. Scalable services only: Create an application resource in the scalable resource group.

    If you are running Sun Cluster HA for iPlanet Web Server as a failover data service, skip to Step 8. You can repeat this step to add multiple application resources (such as secure and insecure versions) to the same resource group.

    You might also want to set load balancing for the data service. To do so, use the two standard resource properties Load_balancing_policy and Load_balancing_weights. For a description of these properties, see Appendix A, Standard Properties. See also the examples that follow this section.


    # scrgadm -a -j resource-name -g ss-resource-group-name \
    -t resource-type-name -y Network_resources_used=network-resource, ... \
    -y Port_list=port-number/protocol, ... -y Scalable=True \
    -x Confdir_list=config-directory, ...
    -j resource-name

    Specifies the name of the resource to add.

    -g ss-resource-group-name

    Specifies the name of the scalable resource group into which the resources are to be placed.

    -t resource-type-name

    Specifies the type of the resource to add.

    -y Network_resources_used= network-resource, ...

    Specifies a comma-separated list of network resources that identify the shared addresses used by the data service.

    -y Port_list=port-number/protocol, ...

    Specifies a comma-separated list of port numbers and protocol to be used, for example, 80/tcp,81/tcp.

    -y Scalable=True

    Specifies a Boolean that is required for scalable services.

    -x Confdir_list=config-directory, ...

    Specifies a comma-separated list of the locations of the iPlanet configuration files. This is a required extension property for Sun Cluster HA for iPlanet Web Server.


    Note -

    A one-to-one mapping applies for Confdir_List and Port_List-that is, each of the values in one list must correspond to the values in the other list in the order specified.


  8. Failover services only: Create an application resource in the failover resource group.

    Perform this step only if you are running Sun Cluster HA for iPlanet Web Server as a failover data service. If you are running Sun Cluster HA for iPlanet Web Server as a scalable service, you must have performed Step 6 and Step 7 previously and must now go to Step 10. You can repeat this step to add multiple application resources (such as secure and insecure versions) to the same resource group.


    # scrgadm -a -j resource-name -g fo-resource-group-name \
    -t resource-type-name -y Network_resources_used=logical-hostname-list \
    -y Port_list=port-number/protocol \
    -x Confdir_list=config-directory
    
    -j resource-name

    Specifies the name of the resource to add.

    -g fo-resource-group-name

    Specifies the name of the failover resource group into which the resources are to be placed.

    -t resource-type-name

    Specifies the type of the resource to add.

    -y Network_resources_used=network-resource, ...

    Specifies a comma-separated list of network resources that identify the logical hosts used by the data service.

    -y Port_list=port-number/protocol

    Specifies the port number and protocol to be used, for example, 80/tcp. Port_list for failover services must have exactly one entry only because of the one-to-one mapping rule between Port_list and Confdir_list.

    -x Confdir_list=config-directory

    Specifies the location of the iPlanet configuration files. Confdir_list for failover services must have exactly one entry only. config-directory must contain a directory called config. This is a required extension property.


    Note -

    Optionally, you can set additional extension properties that belong to the iPlanet data service to override the default value. For a list of these properties, see Table 3-2.


  9. Bring the failover resource group online.


    # scswitch -Z -g fo-resource-group-name
    
    -Z

    Enables the network resource and fault monitoring, switches the resource group into a managed state, and brings it online.

    -g fo-resource-group-name

    Specifies the name of the failover resource group.

  10. Scalable services only: Bring the scalable resource group online.


    # scswitch -Z -g ss-resource-group-name
    
    -Z

    Enables the resource and monitor, moves the resource group to the managed state, and brings it online.

    -g ss-resource-group-name

    Specifies the name of the scalable resource group.

Example-Registering Scalable Sun Cluster HA for iPlanet Web Server

The following example shows how to register a scalable iPlanet service.


Cluster Information
Node names: phys-schost-1, phys-schost-2
Shared address: schost-1
Resource groups: sa-schost-1 (for shared addresses), 	iws-schost-1 (for scalable iPlanet application resources)
Resources: schost-1 (shared address),	iplanet-insecure (insecure iPlanet application resource). 
    iplanet-secure (secure iPlanet application resource)
 
(Add a failover resource group to contain shared addresses.)
# scrgadm -a -g sa-schost-1
 
(Add the shared address resource to the failover resource group.)
# scrgadm -a -S -g sa-schost-1 -l schost-1
 
(Add a scalable resource group.)
# scrgadm -a -g iws-schost-1 -y Maximum_primaries=2 \
-y Desired_primaries=2 -y RG_dependencies=sa-schost-1
 
(Register the iPlanet resource type.)
# scrgadm -a -t SUNW.iws
 
(Add an insecure iPlanet instance with default load balancing.)
# scrgadm -a -j iplanet-insecure -g iws-schost-1 \
-t SUNW.iws \
-x Confdir_List=/opt/iplanet/https-iplanet-insecure \
-y Scalable=True -y Network_resources_used=schost-1 \
-y Port_list=80/tcp
 
(Add a secure iPlanet instance with sticky IP load balancing.)
# scrgadm -a -j iplanet-secure -g iws-schost-1 \
-t SUNW.iws \ 
-x Confdir_List=/opt/iplanet/https-iplanet-secure \
-y Scalable=True -y Network_resources_used=schost-1 \
-y Port_list=443/tcp -y Load_balancing_policy=LB_STICKY \
-y Load_balancing_weight=40@1,60@2
 
(Bring the failover resource group online.)
# scswitch -Z -g sa-schost-1
 
(Bring the scalable resource group online.)
# scswitch -Z -g iws-schost-1

Example-Registering Failover Sun Cluster HA for iPlanet Web Server

The following example shows how to register a failover iPlanet service on a two- node cluster.


Cluster Information
Node names: phys-schost-1, phys-schost-2
Logical hostname: schost-1
Resource group: lh-schost-1 (for all resources), 
Resources: schost-1 (logical hostname), iplanet-insecure (insecure iPlanet application resource), 
  iplanet-secure (secure iPlanet application resource)
 
(Add the resource group to contain all resources.)
# scrgadm -a -g lh-schost-1
 
(Add the logical hostname resource to the resource group.)
# scrgadm -a -L -g lh-schost-1 -l schost-1 
 
(Register the iPlanet resource type.)
# scrgadm -a -t SUNW.iws
 
(Add an insecure iPlanet application resource instance.)
# scrgadm -a -j iplanet-insecure -g lh-schost-1 \
-t SUNW.iws -x Confdir_list=/opt/iplanet/conf \
-y Scalable=False -y Network_resources_used=schost-1 \
-y Port_list=80/tcp
 
(Add a secure iPlanet application resource instance.)
# scrgadm -a -j iplanet-secure -g lh-schost-1 \ 
-t SUNW.iws \ 
-x Confdir_List=/opt/iplanet/https-iplanet-secure \
-y Scalable=False -y Network_resources_used=schost-1 \ 
-y Port_list=443/tcp
 
(Bring the failover resource group online.)
# scswitch -Z -g lh-schost-1

Where to Go from Here

To set or modify resource extension properties, see "Configuring Sun Cluster HA for iPlanet Web Server Extension Properties".