Sun Cluster 3.1 Data Service for Sun ONE Application Server

Registering and Configuring the Sun Cluster HA for Sun ONE Application Server

The following procedures describe how to use the scrgadm command to register and configure the Sun Cluster HA for Sun ONE Application Server. The Sun Cluster HA for Sun ONE Application Server can be configured as a failover data service or as a service that is mastered by multiple nodes at the same time.

Note –

See “Tools for Data Service Resource Administration” in Sun Cluster 3.1 Data Service Planning and Administration Guide for general information about registering and configuring data services.

To perform these procedures, you need the following information about your configuration.

The resource type name for the Sun Cluster HA for Sun ONE Application Server, SUNW.s1as.
The names of the cluster nodes that can master the data service.
If you configure Sun Cluster HA for Sun ONE Application Server as a failover data service, you must know the network resource that clients use to access the Sun Cluster HA for Sun ONE Application Server. Normally, you set up this network resource when you install the cluster. See “Standard Versus Clustered Client/Server Configuration” in Sun Cluster 3.1 Concepts Guide for details on network resources.
The ports where the Sun ONE Application Server listens including HTTP and IIOP listeners.
The path to the server configuration data for the Sun ONE Application Server instance.

How to Register and Configure the Sun Cluster HA for Sun ONE Application Server as a Failover Data Service

Perform the following steps to complete a Sun Cluster HA for Sun ONE Application Server failover configuration. You can also use this procedure to configure a domains administrative server to be a failover resource.

Become superuser on a cluster member.

Add a resource group for Sun ONE Application Server if you have not performed the steps in Configuring and Activating Network Resources for Failover.
# scrgadm -a -g resource-group [-h nodelist]

Add the logical hostname resource to the resource group if you have not performed the steps in Configuring and Activating Network Resources for Failover.
# scrgadm -a -L -g resource-group -l logical-hostname

Register the resource type for the data service.
# scrgadm -a -t SUNW.s1as
-a

Adds the data service resource type

-t SUNW.s1as

Specifies the predefined resource type name

Add the application server resource instance to the failover resource group that you created for your network resources.

# scrgadm -a -j resource -g resource-group \
-t SUNW.s1as \
-x Confdir_list=install-directory/domains/domain/server \
-y Network_resources_used=logical hostname \
-y Port_list=port/tcp,port/tcp \
-x Monitor_uri_list=http://logical-hostname[:port][/path]

The resource group that contains the application resources is the same resource group that you created for your network resources in “Creating a Resource Group” in Sun Cluster 3.1 Data Service Planning and Administration Guide.

-j resource: Specifies the Sun ONE Application Server application resource name.
-y Network_resources_used=network-resource: Specifies a comma-separated list of network resources in resource-group.
-t SUNW.s1as: Specifies the type of resource to add.
-x Confdir_list=install-directory/domains/domain/server: Specifies a path for your Sun ONE Application Server configuration directory. The Confdir_list extension property is required and must have exactly one entry.
-y Port_list=port-number/protocol: Specifies a comma-separated list of the port number and the protocol to be used, for example, 80/tcp. If the Monitor_Uri_list is set, the Port_list setting is optional.
-x Monitor_Uri_list=logical-hostname[:port][/path]: Specifies a comma-separated list of URIs from which Sun Cluster HA for Sun ONE Application Server makes requests. The Monitor_Uri_list extension property is required if the Port_list property is not set.

Bring the resource group online.
# scswitch -Z -g resource-group
-Z

Enables the resource and its monitor.

-g resource-group

Specifies the name of the application resource group that is being enabled.

Verify that the resource group and application server resource is online.
# scstat -g # ps -ef

Example—Registering and Configuring Sun Cluster HA for Sun ONE Application Server as a Failover Data Service

This example shows how to register Sun Cluster HA for Sun ONE Application Server as a failover data service.

Cluster Information
Node names: phys-schost-1, phys-schost-2
Logical hostname: schost-1
Resource group: appsrv-rg (for all resources)
Resources: schost-1 (logical hostname),
SUNW.s1as (Sun ONE Application Server application resource)
 
(Create a failover resource group.)
# scrgadm -a -g appsrv-rg -h phys-schost-1,phys-schost-2
 
(Add a logical hostname resource to the resource group.)
# scrgadm -a -L -g appsrv-rg -l schost-1
 
(Register the SUNW.s1as resource type.)
# scrgadm -a -t SUNW.s1as 

(Create a Sun ONE Application Server resource and add it to the resource group.)
# scrgadm -a -j appsrv-rs -g appsrv-rg \
-t SUNW.s1as \
-x Confdir_list=/global/appsrv/domains/scdomain/server1 \ 
-y Network_resources_used=schost-1 \
-y Port_list=80/tcp,3700/tcp \
-x Monitor_Uri_list=http://schost-1:80/servlet/monitor
 
(Bring the application resource group online.)
# scswitch -Z -g appsrv-rg

Example—Registering and Configuring the `admin-server` as a Failover Data Service

This example shows how the admin-server can be configured as part of the failover resource group created in the above example.

Cluster Information
Node names: phys-schost-1, phys-schost-2
Logical hostname: schost-1
Resource group: appsrv-rg (for all resources)
Resources: schost-1 (logical hostname), 
(Create a Sun ONE Application Server resource and add it to the resource group.)
# scrgadm -a -j admin-rs -g appserv-rg \
-t SUNW.s1as \
-x Confdir_list=/global/appsrv/domains/scdomain/admin-server \
-y Network_resources_used=schost-1 \
-y Port_list=4848/tcp \
-x Monitor_Uri_List=http://schost-1:4848

How to Register and Configure Sun Cluster HA for Sun ONE Application Server as a Service Mastered on Multiple Nodes

This procedure assumes that you installed the data service packages during your initial Sun Cluster HA for Sun ONE Application Server installation. If you did not install the Sun ONE Application Server packages as part of your initial installation, go to How to Install the SUNWscs1as Package to install the data service packages.

Before you begin to register and configure Sun Cluster HA for Sun ONE Application Server as a service mastered on multiple nodes at the same time, consider the following requirements.

You must have the Sun ONE Web Server Plugin installed and configured. See Installing and Configuring the Sun ONE Web Server Plugin.
You must specify at least one entry for the Monitor_URI_List extension property. If there are no deployed applications that need to be monitored, use a simple Uniform Resource Identifier (URI) such as http://localhost/.

See Multiple Masters Configuration Overview for conceptual information related to this procedure.

Note –

The Sun ONE Application Server administrative server might not display the correct status of an application server instance that is configured as a service mastered on multiple nodes.

Become superuser on one of the nodes in the cluster that hosts the application server.

Add a resource group for the Sun ONE Application Server.

# scrgadm -a -g resource-group \
-y Maximum_primaries=value \
-y Desired_primaries=value [-h nodelist]

Add the Sun ONE Application Server resource instance to the resource group.
# scrgadm -a -j resource -g resource-group -t SUNW.s1as -x Confdir_list=install-directory/domains/domain/server -x Monitor_Uri_List=http://localhost[:port][/path]
-j resource

Specifies the Sun ONE Application Server application resource name.

-t SUNW.s1as

Specifies the type of resource to add.

-x Confdir_list=install-directory/domains/domain/server

Specifies a path for your Sun ONE Application Server configuration directory. The Confdir_list extension property is required and must have exactly one entry.

-x Monitor_Uri_list=localhost[:port][/path]

Specifies URIs from which Sun Cluster HA for Sun ONE Application Server makes requests. The Monitor_Uri_list extension property is required.

Verify installation and configuration of the front-end web tier.

See How to Install and Configure the Sun ONE Web Server Plugin for procedural information.

Enable the scalable resource group and its monitor.
# scswitch -Z -g resource-group
-Z

Enables the resource and its monitor.

-g resource-group

Specifies the name of the application resource group that is being enabled.

Example 1–1 Registering and Configuring Sun Cluster HA for Sun ONE Application Server As a Service Mastered on Multiple Nodes

This example shows how to register Sun Cluster HA for Sun ONE Application Server as a service mastered on two nodes at the same time.

Cluster Information
Node names: phys-schost-1, phys-schost-2
Resource group: appsrv-rg (for all resources)
 
(Create a scalable resource group.)
# scrgadm -a -g appserv-rg  -y Maximum_primaries=2 \
-y Desired_primaries=2 -h phys-schost-1,phys-schost-2
 
(Register the SUNW.s1as resource type.)
# scrgadm -a -t SUNW.s1as 

(Create a Sun ONE Application Server resource and add it to the 
resource group.)
# scrgadm -a -j appsrv-rs -g appsrv-rg -t SUNW.s1as \
-x Confdir_list=/global/appserver/domains/scdomain/server1 \ 
-x Monitor_Uri_list=http://localhost:8000/servlet/monitor
 
(Enable the application resource group.)
# scswitch -Z -g appsrv-rg