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.

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.

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

2. 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]

3. Register the resource type for the Sun ONE Application Server.

   # scrgadm -a -t SUNW.s1as

4. 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.

5. 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.

6. 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