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_livecache 5 "20 Aug 2007" "Sun Cluster 3.2" "Sun Cluster Miscellaneous"
 NAME
SUNW.sap_livecache, sap_livecache - resource type implementation for failover SAP liveCache database

 DESCRIPTION

The SAP liveCache data service is managed by the Sun Cluster Resource Group Manager (RGM) and is configured as a LogicalHostname resource, a SAP liveCache database resource.


The SAP liveCache database depends on the SAP xserver which is managed by data service SUNW.sap_xserver. Dependency should be set between the SAP liveCache resource group and the SAP xserver resource group.


You must set the following properties for a SAP liveCache database 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
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 SAP liveCache. SAP liveCache restarts are controlled by the system-defined properties Thorough_Probe_Interval, Retry_Interval, and Retry_Count, as specified in their descriptions. You can modify the value
for this property at any time. 





.na
Monitor_retry_interval 
.ad


Type integer, default is 2. Indicates the time in minutes over which the failures of the fault monitor are counted and corresponds to the -t option passed to the pmfadm(1M) 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 liveCache database instance. You can modify the value for this property at any time.





.na
Failover_enabled
.ad


Type boolean; defaults to TRUE. Indicates whether to failover or not when retry_count is exceeded during retry_interval.





.na
Livecache_Name
.ad


Type string array. This property is the name of the liveCache database instance. Note the name is in uppercase (LC-NAME).





.na
Confdir_list
.ad


Type string array.This property only has one value which is the directory for livecache software and instance directories
Default is /sapdb.




 EXAMPLES

Example 1 Configuration Example


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



The following example creates a failover SAP liveCache database resource named lc-rs in an existing resource group called lc-rg. lc-rg must contain a LogicalHostName resource.


# clresourcetype register SUNW.sap_livecache 
# clresource create -g lc-rg -t SUNW.sap_livecache \
-p LiveCache_Name=LC4 lc-rs
 





In this example, LC4 is the SAP liveCache database instance name. The rest of the extension properties use the default values.



After the SAP liveCache database resource group and the SAP xserver resource group are created, set the dependency between them.


 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWsclc



 SEE ALSO

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


Sun Cluster 3.0 Data Services Installation and Configuration Guide