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.sapscs 5 "20 Aug 2007" "Sun Cluster 3.2" "Sun Cluster Miscellaneous"
 NAME
SUNW.sapscs, sapscs - resource type implementation for the SAP message server component of Sun Cluster HA for SAP Web Application Server

 DESCRIPTION

The SUNW.sapscs resource type represents the SAP message server component in a Sun Cluster configuration. 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 web application server component (represented by the SUNW.sapwebas resource type).


The SAP enqueue server resource and the SAP message server resource must be in the same failover group (called the SAP central services resource group), because they fail over together. The SAP replica server resource must be in a different failover resource group from the SAP enqueue server
resource, because the SAP replica server resource must not fail over with the SAP enqueue server resource.


The resource group affinities must be set to ensure that the SAP central services resource group fails over to the node where the SAP replica resource group has been running and that the SAP replica resource group fails over to another available node.


The resource dependencies must be set to ensure that the SAP replica server resource depends on the SAP enqueue server resource being online.


With the resource group affinities and resource dependencies set as described above, if the SAP enqueue server experiences any hardware or software failure, the SAP central services resource group will fail over to the node where the SAP replica resource group has been running and the SAP
replica resource group will fail over to another available node. If the SAP message server experiences any failure, the SAP message server resource will be restarted locally a configurable number of times before a failover is initiated.


Create all these dependencies when you configure the Sun Cluster HA for SAP Web Application Server 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.sapscs resource type are described in the subsections that follow. To set these properties for an instance of the SUNW.sapscs 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


3600





.na
Default
.ad


970





.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
Failover_Enabled
.ad


Specifies whether to fail over when Retry_Count is exceeded during Retry_Interval.


.na
Data type
.ad


Boolean





.na
Default
.ad


TRUE





.na
Range
.ad


TRUE or FALSE





.na
Tunable
.ad


Any time








.na
Monitor_Retry_Count
.ad


The maximum number of restarts by the process monitor facility (PMF) that are allowed for the SAP message server
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 message server fault monitor.


.na
Data type
.ad


Integer





.na
Default
.ad


2





.na
Range
.ad


No range defined





.na
Tunable
.ad


Any time








.na
Msg_Server_Monitor
.ad


The SAP message server probe executable.


.na
Data type
.ad


String





.na
Default
.ad


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





.na
Range
.ad


Not applicable





.na
Tunable
.ad


When disabled








.na
Msg_Server_Port
.ad


The listen port of the SAP message server.
If no value is specified for this property, the initial default value is 0. In this case a derived default value is calculated to be 3600 + SAP_Instance_Number. If the listen port of the SAP message server to be probed is not equivalent to 3600 + SAP_Instance_Number, for example, in the case of two SAP message servers, specify a value for this property.


.na
Data type
.ad


Integer





.na
Default
.ad


0





.na
Range
.ad


0 - 65535





.na
Tunable
.ad


When disabled








.na
Probe_Timeout
.ad


The timeout value in seconds that the SAP message server fault monitor uses to probe an SAP message server 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 message server 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 message server 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 message server.


.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
Scs_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
Scs_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







 EXAMPLES

Example 1 Creating Resources for SUNW.sapenq, SUNW.sapscs, and SUNW.saprepl


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 SAP central services resource group contains the SAP enqueue server resource, the SAP message server resource, and the logical host resource. The following commands are an example of creating the SAP central services resource group:


# clresourcegroup create central-rg
# clreslogicalhostname create -g central-rg -l central-lh  
-N sc_ipmp0@1,sc_ipmp0@2,sc_ipmp0@3,sc_ipmp0@4 central-lh-rs





To bring online the SAP central services resource group, the following command is run:


# clresourcegroup -emM central-rg





The failover SAP replica resource group contains the SAP replica server resource and a logical host resource. The following commands are an example of creating the SAP replica resource group:


# clresourcegroup create -g repl-rg
# clreslogicalhostname create -g repl-rg -l repl-lh  
-N sc_ipmp0@1,sc_ipmp0@2,sc_ipmp0@3,sc_ipmp0@4 repl-lh-rs





To bring online the SAP replica server resource group, the following command is run:


# clresourcegroup -emM repl-rg





Setting weak positive resource group affinity between the SAP central services resource group and the SAP replica resource group ensures that, in case of failover, the SAP central services resource group fails over to the node where the SAP replica resource group has been running. The following
command is an example of setting this affinity:


# clresourcegroup set -p RG_affinities=+repl-rg central-rg





The two resource groups must be mastered on different nodes before the strong negative affinity can be set. Therefore, either the SAP central services resource group or the SAP replica resource group must be switched to another node. The following command is an example of switching the SAP
central services resource group to another node:


# clresourcegroup switch -n Node2 central-rg 





Setting strong negative resource group affinity between the SAP replica resource group and the SAP central services resource group ensures that, in case of failover, after the SAP central services resource group fails over to the node where the SAP replica resource group has been running,
the SAP replica resource group will fail over to another available node. The following command is an example of setting this affinity:


# clresourcegroup set -p RG_affinities=--central-rg repl-rg





To register the resource types, the following commands are run:


# clresourcetype register SUNW.sapenq
# clresourcetype register SUNW.sapscs
# clresourcetype register SUNW.saprepl





To create the SAP enqueue server resource in the SAP central services resource group, the following command is run:


# clresource create -g central-rg -t SUNW.sapenq  
-p Enqueue_Profile=/usr/sap/SC3/SYS/profile/SC3_SCS01_central-lh  
-p Enqueue_Server=/sapmnt/SC3/exe/enserver  
-p SAP_User=sc3adm -p Enqueue_Instance_Number=01 enq-rs





To create the SAP message server resource in the SAP central services resource group, the following command is run:


# clresource create -g central-rg -t SUNW.sapscs  
-p SAP_SID=SC3 -p SAP_Instance_Number=01  
-p SAP_Instance_Name=SCS01  
-p Msg_Server_Port=3601 msg-rs





To create the SAP replica server resource in the SAP replica resource group, the following command is run:


# clresource create -g repl-rg -t SUNW.saprepl  
-p Replica_Profile=/usr/sap/SC3/SYS/profile/SC3_REP01  
-p Replica_Server=/sapmnt/SC3/exe/enrepserver  
-p SAP_User=sc3adm  
-p Resource_Dependencies=enq-rs repl-rs




 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscsapscs



 SEE ALSO

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