Home | History | Annotate | Download | only in man5
 te
 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 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
 SUNW.jsas 5 "05 Sep 2007" "Sun Cluster 3.2" "Sun Cluster Miscellaneous"
 NAME
SUNW.jsas, jsas - resource type implementation for failover and multiple masters Sun Java System Application Server

 DESCRIPTION

The SUNW.jsas resource type represents the Sun Java System Application Server application in a Sun Cluster configuration.


Standard properties and extension properties that are defined for the SUNW.jsas resource type are described in the subsections that follow. To set these properties for an instance of the SUNW.jsas resource type, use the clresource(1CL) commands. 

 "Standard Properties"

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




.na
Default
.ad


Null string





.na
Tunable
.ad


Any time








.na
Retry_count
.ad




.na
Maximum
.ad


10





.na
Default
.ad


2





.na
Tunable
.ad


Any time








.na
Retry_interval
.ad




.na
Maximum
.ad


3600





.na
Default
.ad


480





.na
Tunable
.ad


Any time








.na
Thorough_probe_interval
.ad




.na
Maximum
.ad


3600





.na
Default
.ad


120





.na
Tunable
.ad


Any time







 "Extension Properties"

The extension properties of this resource type are as follows:


.na
Adminuser
.ad


The DAS adminstrative user name.


.na
Data type
.ad


String array





.na
Default
.ad


 No default defined





.na
Range
.ad


Not applicable





.na
Tunable
.ad


At creation








.na
Confdir_list
.ad


The complete path to the Sun Java System Application Server installation directory.


.na
Data type
.ad


String array





.na
Default
.ad


 /opt/SUNWappserver





.na
Range
.ad


Not applicable





.na
Tunable
.ad


At creation








.na
Domaindir
.ad


The full path to the domain directory.


.na
Data type
.ad


String





.na
Default
.ad


 Null





.na
Range
.ad


Not applicable





.na
Tunable
.ad


At creation








.na
Domain_name
.ad


The domain name.


.na
Data type
.ad


String





.na
Default
.ad


 No default defined





.na
Range
.ad


Not applicable





.na
Tunable
.ad


At creation








.na
Monitor_Uri_List
.ad


List of URIs to be probed. The Application Server agent sends HTTP/1.1 GET requests to each of the listed URIs.
The only response code that results in a failover of the resource is the response code 500 (Internal Server Error).


.na
Data type
.ad


String array





.na
Default
.ad


 Null





.na
Range
.ad


Not applicable





.na
Tunable
.ad


Any time








.na
Passwordfile
.ad


The full path to the file that contains the DAS administrative password.


.na
Data type
.ad


String





.na
Default
.ad


 No default defined





.na
Range
.ad


Not applicable





.na
Tunable
.ad


At creation








.na
Probe_timeout
.ad


The timeout value (in seconds) for the probe.


.na
Data type
.ad


Integer





.na
Default
.ad


 180





.na
Range
.ad


Minimum = 2





.na
Tunable
.ad


Any time







 EXAMPLES

Example 1 Creating a Resource for SUNW.jsas


For this example to work, you must first install the Sun Cluster HA for Sun Java System Application Server data service. This data service includes all the packages to make Sun Java System Application Server highly available.



This example creates a failover Domain Administration Server (DAS) resource. The resource is created in an existing failover resource group. To create this resource the following commands are run:


# clresourcetype register SUNW.jsas
# clresource create -g das-rg -t SUNW.jsas \e
-p Adminuser=admin \e
-p Domain_name=new-domain \e
-p Passwordfile=/global/disk1/passwordfile das-rs





In this example, the DAS resource group is named das-rg, the DAS resource is named das-rs, and values are specified for the extension properties that have no defaults.


 ATTRIBUTES

See attributes(5) for descriptions of the following attributes:







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscjsas



 SEE ALSO

clresourcetype(1CL), clresourcegroup(1CL), 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