CDDL HEADER START
The contents of this file are subject to the terms of the
Common Development and Distribution License (the "License").
You may not use this file except in compliance with the License.
You can obtain a copy of the license at CDDL.txt
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at CDDL.txt.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]
CDDL HEADER END
Copyright 2008 Sun Microsystems, Inc.
All rights reserved. Use is subject to license terms.
The SUNW.s1as resource type represents the Sun Java System Application Server application in a Sun Cluster configuration.
You must set the following properties on an SUNW.s1as resource by using scrgadm(1M).
See r_properties(5) for a complete description of the following resource properties.
.na Network_resources_used (string array) .ad A list of logical-hostname or shared-address network resources upon which this resource has a dependency. This list contains all network-address resources that appear in the properties Resource_dependencies, Resource_dependencies_weak, Resource_dependencies_restart, or Resource_dependencies_offline_restart. This property is updated automatically by the RGM, based on the setting of the resource-dependencies properties. You do not set this property directly. Instead, use the Resource_dependencies property.
.na Category .ad Conditional/Optional
.na Default .ad The empty list
.na Tunable .ad Any time
.na Resource_dependencies (string array) .ad Specifies a list of resources upon which a resource depends. This list includes any logical-hostname or shared-address network resources that are used by a resource. The default value for this property is null. You can specify one or more resource names. Each network resource can contain one or more logical host names. See the clreslogicalhostname(1CL) and clressharedaddress(1CL) man pages for more information. You can specify an alternate kind of dependency by using the Resource_dependencies_weak, Resource_dependencies_restart, or Resource_dependencies_offline_restart property instead of the Resource_dependencies property. For more information, see the r_properties(5) man page.
.na Category .ad Optional
.na Default .ad The empty list
.na Tunable .ad Any time
.na Port_list .ad Default: No default Tunable: Any time
.na Retry_count .ad Default: 2 Tunable: Any time
.na Retry_interval .ad Default: 480 Tunable: Any time
.na Thorough_probe_interval .ad Default: 120 Tunable: Any time
.na Confdir_list .ad Type string array. This property is a path name set to install-dir/domains/domain/server which is the path name of an s1as instance directory. You must specify this property at resource creation time.
.na Monitor_Uri_List .ad Type string array; defaults to "". This property allows you to ensure that application components are responding by querying the configured URIs. The Monitor_Uri_List property is used for detailed fault monitoring of Sun Java System Application Server. The fault monitor periodically performs HTTP GET command for the URIs. The monitor takes action if the HTTP request returns with response code 500 "Internal Server Error" or if the application server does not respond. An example URI setting is http://logical-hostname/App/tester. If the configured URIs are implemented by using a Servlet in the application server, detailed monitoring of the application server JVM (Java Virtual Machine) is possible. Either the Monitor_Uri_List or the Network_Resources_Used and the Port_List properties must be set. If Network_Resources_Used, Port_List, and Monitor_Uri_List are all set, the fault monitor will probe the ports and the URIs provided. Setting Port_List to include the IIOP listeners helps to ensure that the application server is listening and responding to IIOP requests.
.na Probe_timeout .ad Type string; defaults to 120 seconds. This property is tunable anytime and sets the timeout value for the probe.
Example 1 Creating a Failover s1as Resource in an Existing Group
For this example to work, you must first install the SUNWscs1as data service package. This example creates a failover s1as resource named appsrv-rs in an existing resource group named appsrv-rg. The appsrv-rg resource group contains a LogicalHostname resource, which identifies the logical hostname associated with the resource group.
(Register the SUNW.s1as resource type.) # scrgadm -a -t SUNW.s1as (Create a Sun Java System 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
In the preceding example, the s1as resource created is named appserver-rs, with a corresponding s1as instance in the directory /global/appsrv/domains/scdomain/server1.
Example 2 Creating a Failover s1as Resource Listening on a Specified Port
For this example to work, you must first install the SUNWscs1as data service package. This example creates a failover s1as resource named appserver-secure, which listens on port 443 in an existing resource group named app-rg.
example# scrgadm -a -t SUNW.s1as example# scrgadm -a -j appserver-secure -t SUNW.s1as -g app-rg -x Confdir_list=/global/s1as/domains/domain1/server2 -y Network_resources_used=schost-1 -x Monitor_Uri_list=http://schost-1:80/servlet/monitor -y Port_list=443/tcp
Example 3 Configuring s1as in a Scalable Resource Group
In this example a scalable resource group, s1as-rg, is created with Maximum_primaries and Desired_primaries equal to three. A Sun Java System Application Server resource named scalable-app-server1 is then created in this resource group with a configuration directory of /global/s1as/domains/domain1/server1 . The URI http://localhost:8000/servlets/testservlet is specified to the extension property Monitor_uri_list.
example# scrgadm -a -g s1as-rg -y Maximum_primaries=3 -y Desired_primaries=3 example# scrgadm -a -g s1as-rg -j scalable-app-server1 -t SUNW.s1as -x Confdir_list=/global/s1as/domains/domain1/server1 -x Monitor_uri_list=http://localhost:8000/servlets/testservlet
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWscs1as |
scrgadm(1M), scswitch(1M), scha_resource_get(3HA), pmfadm(1M), attributes(5), r_properties(5), scalable_service(5)
Sun Cluster Data Service for Sun Java System Application Server Guide for Solaris OS, and Sun Cluster Data Services Planning and Administration Guide for Solaris OS
Terms of Use |
Privacy |
Trademarks |
Copyright Policy |
Site Guidelines |
Help
Your use of this web site or any of its content or software indicates your agreement to be bound by these Terms of Use.
Copyright © 1995-2008 Sun Microsystems, Inc.