This procedure describes how to use the Oracle Solaris Cluster maintenance commands to register and configure HA for Oracle iPlanet Web Server in a failover configuration.
To perform this procedure, you must have the following information.
The name of the resource type for HA for Oracle iPlanet Web Server. This name is SUNW.iws.
The names of the cluster nodes that master the data service. For a failover service, only one node can master a data service at a time.
The logical hostname (for failover services) or shared address (for scalable services) that clients use to access the data service.
The path to the Oracle iPlanet binaries. You can install the binaries on the local disks or the cluster file system. See Configuration Guidelines for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide for a discussion of the advantages and disadvantages of each location.
Ensure that the /etc/netmasks file has IP-address subnet and netmask entries for all logical hostnames. If necessary, edit the /etc/netmasks file to add any missing entries.
# clresourcetype register SUNW.iws
You can optionally select the set of nodes on which the data service can run with the –n option.
# clresourcegroup create [-n node[,…]] resource-group
Specifies the name of the failover resource group. This name can be your choice but must be unique for resource groups within the cluster.
Specifies a comma-separated, ordered list of nodes that can master this resource group.
This list is optional. If you omit this list, the global zone of each cluster node can master the resource group.
You should have performed this verification during the Oracle Solaris Cluster installation. See the planning chapter in the Oracle Solaris Cluster Software Installation Guide for details.
# clreslogicalhostname create -g resource-group \ -h logical-hostname[,…] \ [-p auxnodelist=node] [-N netiflist] resource-name
Specifies the name of the failover resource group.
Specifies a comma-separated list of logical hostnames that this resource is to make available.
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 if failover occurs. These nodes are mutually exclusive with the nodes identified in nodelist for the resource group, if specified.
Specifies the name of the resource group. This name can be your choice but must be unique for resource groups within the cluster.
Specifies an optional, comma-separated list that identifies the IPMP groups that are on each node . The format of each entry in the list is netif@node. The replaceable items in this format are as follows:
Specifies an IPMP group name, such as sc_ipmp0, or a public network interface card (NIC). If you specify a public NIC, Oracle Solaris Cluster attempts to create the required IPMP groups.
Specifies the name or ID of a node.
This list is optional. If you omit this list, Oracle Solaris Cluster attempts to create the required IPMP groups.
Specifies the name of the resource.
You can repeat this step to add multiple application resources (such as SSL and non-SSL based versions) to the same resource group.
# clresource create -g resource-group \ -t resource-type \ -p Confdir_list=config-directory \ -p Resource_dependencies=logical-hostname-list,.. \ -p Port_list=port-number/protocol resource
Specifies the name of the failover resource group into which the resources are to be placed.
Specifies the type of the resource to add.
Specifies the location of the Oracle iPlanet configuration files. The Confdir_list file for failover services must have exactly one entry only. The config-directory must contain a directory called config. HA for Oracle iPlanet Web Server requires this extension property.
Specifies a comma-separated list of network resources that identify the logical hosts that the data service uses.
Specifies the port number and protocol to use, 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.
Specifies the name of the resource to add.
The resource is created in the enabled state.
# clresourcegroup online -M resource-group
Specifies the name of the failover resource group.
Cluster Information Node names: phys-schost-1, phys-schost-2 Logical hostname: schost-1 Resource group: resource-group-1 (for all resources) Resources: schost-1 (logical hostname), app-insecure-1 (non-SSL based application resource), app-secure-1 (SSL-based application resource) (Add the resource group to contain all resources.) # clresourcegroup create resource-group-1 (Add the logical hostname resource to the resource group.) # clreslogicalhostname create -g resource-group-1 -h schost-1 resource-name schost-1 (Register the resource type for the HA for Oracle iPlanet Web Server.) # clresourcetype register SUNW.iws (Add a non-SSL based application resource instance.) # clresource create -g resource-group-1 -t SUNW.iws \ -p Confdir_list=/opt/SUNwbsrv/conf -p Scalable=False \ -p Resource_dependencies=schost-1 -p Port_list=80/tcp app-insecure-1 (Add an SSL-based application resource instance.) # clresource create -g resource-group-1 -t SUNW.iws \ -p Confdir_List=/opt/SUNwbsrv/https-app-secure-1 -p Scalable=False \ -p Resource_dependencies=schost-1 -p Port_list=443/tcp app-secure-1 (Bring the failover resource group online.) # clresourcegroup online -M resource-group-1Example 5 Registering a Failover HA for Oracle iPlanet Web Proxy Server on a Two-Node Cluster
Cluster Information Node names: phys-schost-1, phys-schost-2 Logical hostname: schost-1 Resource group: resource-group-1 (for all resources) Resources: schost-1 (logical hostname), app-insecure-1 (non-SSL based application resource), app-secure-1 (SSL-based application resource) (Add the resource group to contain all resources.) # clresourcegroup create resource-group-1 (Add the logical hostname resource to the resource group.) # clreslogicalhostname create -g resource-group-1 -h schost-1 (Register the resource type for the HA for Oracle iPlanet Web Proxy Server.) # clresourcetype register SUNW.iws (Add a non-SSL based application resource instance.) # clresource create -g resource-group-1 -t SUNW.iws \ -p Confdir_list=/opt/SUNwbproxy/proxy-insecure-1 -p Scalable=False \ -p Resource_dependencies=schost-1 -p Port_list=80/tcp app-insecure-1 (Add an SSL-based application resource instance.) # clresource create -g resource-group-1 -t SUNW.iws \ -p Confdir_List=/opt/SUNwbproxy/proxy-secure-1 -p Scalable=False \ -p Resource_dependencies=schost-1 -p Port_list=443/tcp app-secure-1 (Bring the failover resource group online.) # clresourcegroup online -M resource-group-1
In this example, it is assumed that the global file system is being used. If a failover file system is used, you must set the dependency on the HAStoragePlus resource using the Resource_dependencies extension property during resource creation.