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 (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
 SUNW.sapwebas 5 "30 Aug 2007" "Sun Cluster 3.2" "Sun Cluster Miscellaneous"
 NAME
SUNW.sapwebas, sapwebas - resource type implementation for the SAP web application server component of Sun Cluster HA for SAP Web Application Server

 DESCRIPTION

The SUNW.sapwebas resource type represents the following components in a Sun Cluster Configuration: SAP web application server; J2EE Engine; SAP web Application Server with the J2EE Engine. This resource type is part of a set of resource types for the SAP Web Application
Server platform. The other components are the SAP enqueue server (represented by the SUNW.sapenq resource type), the SAP replica server (represented by the SUNW.saprepl resource type), and the SAP message server (represented by the SUNW.sapscs resource
type).


The components represented by the SUNW.sapwebas resource may be configured as a failover resource or a scalable resource.


The SAP web application server component resource depends on the database resource being online. The J2EE Engine component depends on the database resource and the SAP message server. You create these dependencies when you configure the Sun Cluster HA for SAP Web Application Server data
service and the J2EE Engine data service. For more information, see Sun Cluster Data Service for SAP Web Application Server Guide for Solaris OS.


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

 "Standard Properties"

Standard resource properties are overridden for this resource type as follows:


.na
Retry_Count
.ad




.na
Maximum
.ad


5





.na
Default
.ad


2





.na
Tunable
.ad


Any time








.na
Retry_Interval
.ad




.na
Maximum
.ad


4600





.na
Default
.ad


4320





.na
Tunable
.ad


Any time








.na
Thorough_Probe_Interval
.ad




.na
Maximum
.ad


3600





.na
Default
.ad


120





.na
Tunable
.ad


Any time








For a description of these standard resource properties, see r_properties(5).

 "Extension Properties"

The extension properties of this resource type are as follows:


.na
Monitor_Retry_Count
.ad


The maximum number of restarts by the process monitor facility (PMF) that are allowed for the SAP web application
server component fault monitor.


.na
Data type
.ad


Integer





.na
Default
.ad


4





.na
Range
.ad


No range defined





.na
Tunable
.ad


Any time








.na
Monitor_Retry_Interval
.ad


The interval in minutes between restarts of the SAP web application server component fault monitor.


.na
Data type
.ad


Integer





.na
Default
.ad


2





.na
Range
.ad


No range defined





.na
Tunable
.ad


Any time








.na
Probe_Timeout
.ad


The timeout value in seconds that the SAP web application server component fault monitor uses to probe an SAP web application
server component instance.


.na
Data type
.ad


Integer





.na
Default
.ad


120





.na
Range
.ad


Minimum = 2; no maximum defined





.na
Tunable
.ad


Any time








.na
SAP_Instance_Name
.ad


The name of the SAP web application server component instance. This is INSTANCE_NAME in the SAP
profile.


.na
Data type
.ad


String





.na
Default
.ad


None defined





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
SAP_Instance_Number
.ad


The two-digit SAP system number for the SAP web application server component instance. This is SAPSYSTEM in
the SAP profile.


.na
Data type
.ad


String





.na
Default
.ad


None defined





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
SAP_SID
.ad


The SAP system ID. This is SAPSYSTEMNAME in the SAP profile.


.na
Data type
.ad


String





.na
Default
.ad


None defined





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
SAP_User
.ad


The administration user for the SAP web application server component.


.na
Data type
.ad


String, where letters are in lowercase





.na
Default
.ad


<SAPSID>adm





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
SAP_Instance_Type
.ad


The Instance type on the specified Host. The possible values of this extension property are as follows:




ABAP \(emspecifies that SAP Web AS ABAP central instance is installed on the host.






J2EE \(emspecifies that SAP Web AS Java engine is deployed on the host.






ABAP_J2EE \(emspecifies that SAP Web AS ABAP and SAP Web AS Java engine are deployed on the host.




.na
Data type
.ad


Enum





.na
Default
.ad


ABAP





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
Log_Directory
.ad


The directory for the startup and monitor log files.


.na
Data type
.ad


String





.na
Default
.ad


The home directory of the administration user, as specified by the extension property SAP_User.





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
Webas_Shutdown_Script
.ad


The full path to the shut-down script for the instance.


.na
Data type
.ad


String





.na
Default
.ad


/usr/sap/<SAPSID>/SYS/exe/run/stopsap





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
Webas_Startup_Script
.ad


The full path to the start-up script for the instance.


.na
Data type
.ad


String





.na
Default
.ad


/usr/sap/<SAPSID>/SYS/exe/run/startsap





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
Webas_Use_Pmf
.ad


Determines if the start-up script process tree is run under Process Monitor Facility (PMF). The possible values of this
extension property are as follows:




True - Specifies that the start-up script process tree is run under PMF.






False - Specifies that the start-up script process tree is not run under PMF.




.na
Data type
.ad


Boolean





.na
Default
.ad


TRUE





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled







 EXAMPLES

Example 1 Creating a Failover Resource for SUNW.sapwebas


For this example to work, you must first install the Sun Cluster HA for SAP Web Application Server data service, which includes all the packages to make the SAP Web Application Server components highly available.



The failover resource group for the SAP web application server component contains the SAP web application server component resource and the logical host resource. The following commands are an example of creating the failover resource group for the SAP web application server component:


# clresourcegroup create fo-webas-rg
# clreslogicalhostname create -g fo-webas-rg -l webas-lh  
-n sc_ipmp0@1,sc_ipmp0@2,sc_ipmp0@3,sc_ipmp0@4





To bring online the failover resource group for the SAP web application server component, the following command is run:


# clresourcegroup -emM fo-webas-rg





To register the resource type, the following command is run:


# clresourcetype register SUNW.sapwebas





To create a SAP web application server component resource in the failover resource group, the following command is run:


# clresource create -g fo-webas-rg -t SUNW.sapwebas  
-p SAP_SID=SC3 -p SAP_Instance_Number=08  
-p SAP_Instance_Name=D08  
-p Resource_Dependencies=db-webas-rs,msg-rs webas-rs 





Example 2 Creating a Scalable Resource for SUNW.sapwebas


For this example to work, you must first install the Sun Cluster HA for SAP Web Application Server data service, which includes all the packages to make the SAP Web Application Server components highly available.



The scalable resource group for the SAP web application server component contains the SAP web application server component resource and the logical host resource. The following commands are an example of creating the scalable resource group for the SAP web application server component:


# clresourcegroup create  
-p Maximum_primaries=4  
-p Desired_primaries=4  
sc-webas-rg
# clreslogicalhostname create -g sc-webas-rg -l webas-lh  
-N sc_ipmp0@1,sc_ipmp0@2,sc_ipmp0@3,sc_ipmp0@4





To bring online the scalable resource group for the SAP web application server component, the following command is run:


# clresourcegroup -emM sc-webas-rg





To register the resource type, the following command is run:


# clresourcetype register SUNW.sapwebas





To create a SAP web application server component resource in the scalable resource group, the following command is run:


# clresource create -g sc-webas-rg -t SUNW.sapwebas  
-p SAP_SID=SC3 -p SAP_Instance_Number=08  
-p SAP_Instance_Name=D08  
-p Resource_Dependencies=db-webas-rs,msg-rs webas-rs




 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscsapwebas



 SEE ALSO

clresource(1CL), clresourcegroup(1CL),clresourcetype(1CL), attributes(5), r_properties(5), SUNW.sapenq(5), SUNW.sapscs(5), SUNW.saprepl(5)