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.sap_xserver 5 "20 Aug 2007" "Sun Cluster 3.2" "Sun Cluster Miscellaneous"
 NAME
SUNW.sap_xserver, sap_xserver - resource type implementation for scalable SAP xserver

 DESCRIPTION

The SAP xserver data service for Sun Cluster is managed by the Sun Cluster Resource Group Manager (RGM) and is configured as a scalable SAP xserver resource.


You must set the following properties on an SAP xserver resource using the clresource(1CL) command. 

 "Standard Properties"

See r-properties(5) for a description of the following resource properties.


.na
Retry_count 
.ad


Default: 2 
Tunable: Any time





.na
Retry_interval 
.ad


Default: 620 
Tunable: Any time





.na
Thorough_probe_interval 
.ad


Default: 60 
Tunable: Any time




 "Extension Properties"

.na
Confdir_list
.ad


Type string. The full path to the directory that contains the software and database instance of the applications that depend on the xserver. These applications can be any combination of the following applications:




SAP DB






SAP liveCache


Default is /sapdb.





.na
Independent_Program_Path
.ad


Type string. The full path to the directory that contains the following programs and libraries for SAP xserver:




Programs that are independent of the database software version






Libraries for the client runtime environment


A SUNW.sap_xserver resource determines the path to the x_server command from the value of this property. The x_server command resides in the bin subdirectory of the directory that this property specifies.
You can modify the value for this property only when the resource is disabled.





.na
Monitor_retry_count 
.ad


Type integer; default is 4. This property controls the restarts of the fault monitor. It indicates the number of times the fault monitor is restarted by the process monitor facility and corresponds to the -n option passed to the pmfadm(1M) command. The number of restarts is counted in a specified time window (see the property Monitor_retry_interval). Note that this property refers to the restarts
of the fault monitor itself, not the SAP xserver. The SAP xserver restarts are controlled by the system-defined properties Thorough_Probe_Interval and Retry_Interval, as specified in their descriptions. See clresource(1CL). You can modify the value for this property at any time. 





.na
Monitor_retry_interval 
.ad


Type integer, default is 2. Indicates period of time in minutes during which the PMF counts restarts of the fault monitor and corresponds to the -t option passed to the pmfadm command. If the number of times the fault monitor fails exceeds the
value of Monitor_retry_count within this period, the fault monitor is not restarted by the process monitor facility. You can modify the value for this property at any time. 





.na
Probe_timeout 
.ad


Type integer; default is 90. Indicates the time-out value (in seconds) used by the fault monitor to probe a SAP xserver instance. You can modify the value for this property at any time.





.na
Soft_Stop_Pct
.ad


Type integer. This property is the percentage of the Stop method timeout that is used to stop SAP xserver by using the SAP utility x_server stop. If this timeout is exceeded, the SIGKILL signal is used to stop all SAP xserver
processes. You can modify the value for this property at any time.
Default is 50.





.na
Xserver_User
.ad


Type string array. This property is the SAP xserver system administrator user name. You can modify the value for this property only when you have disabled the resource.
Default is root.




 EXAMPLES

Example 1 Configuration Example


For this example to work, you must first install the data service. 



The following example creates a scalable SAP xserver resource named xsvr-rs in a resource group called xsvr-rg. The xsvr-rg resource group does not contain a SharedAddress resource.


# clresourcegroup create -p Maximum_primaries=4 \
-p Desired_primaries=4 xsvr-rg 
# clresourcetype register SUNW.sap_xserver
# clresource create -g xsvr-rg -t SUNW.sap_xserver xsrv-rs 





In this example, SAP xserver will run on 4 cluster nodes. The SAP xserver extension properties use the default values.


 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWsclc



 SEE ALSO

pmfadm(1M), scha_resource_get(1HA), clresourcetype(1CL),clresource(1CL), clresourcegroup(1CL) ,attributes(5), r-properties(5) 


Sun Cluster 3.2 Data Service for SAP DB Guide, Sun Cluster 3.2 Data Service for SAP liveCache Guide