JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Services Reference Manual     Oracle Solaris Cluster 4.1
search filter icon
search icon

Document Information

Preface

OSC4DS 4

OSC4DS 5

apache(5)

asm_diskgroup(5)

dns(5)

iws(5)

ldom(5)

nfs(5)

ohs(5)

opmn(5)

oracle_external_proxy(5)

oracle_listener(5)

oracle_server(5)

ORCL.ohs(5)

ORCL.opmn(5)

ORCL.oracle_external_proxy(5)

ORCL.sapcentr(5)

ORCL.sapdia(5)

ORCL.saprepenq(5)

ORCL.saprepenq_preempt(5)

ORCL.sapstartsrv(5)

sapcentr(5)

sapdb(5)

sapdia(5)

sapenq(5)

sap_livecache(5)

saprepenq(5)

saprepenq_preempt(5)

saprepl(5)

sapscs(5)

sapstartsrv(5)

sapwebas(5)

sap_xserver(5)

sblgtwy(5)

sblsrvr(5)

scalable_asm_diskgroup_proxy(5)

scalable_asm_instance(5)

scalable_asm_instance_proxy(5)

scalable_rac_server_proxy(5)

SUNW.apache(5)

SUNW.asm_diskgroup(5)

SUNW.dns(5)

SUNW.iws(5)

SUNW.ldom(5)

SUNW.nfs(5)

SUNW.oracle_listener(5)

SUNW.oracle_server(5)

SUNW.sapdb(5)

SUNW.sapenq(5)

SUNW.sap_livecache(5)

SUNW.saprepl(5)

SUNW.sapscs(5)

SUNW.sapwebas(5)

SUNW.sap_xserver(5)

SUNW.sblgtwy(5)

SUNW.sblsrvr(5)

SUNW.scalable_asm_diskgroup_proxy(5)

SUNW.scalable_asm_instance(5)

SUNW.scalable_asm_instance_proxy(5)

SUNW.scalable_rac_server_proxy(5)

SUNW.wls(5)

wls(5)

Index

SUNW.sapenq

, sapenq

- resource type implementation for the SAP enqueue server component of Oracle Solaris Cluster HA for SAP Web Application Server

Description

The SUNW.sapenq resource type represents the SAP enqueue server component in an Oracle Solaris 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 replica server (represented by the SUNW.saprepl resource type), the SAP message server (represented by the SUNW.sapscs 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 Oracle Solaris Cluster HA for SAP Web Application Server data service.

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

Standard Properties

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

Retry_Count

The value of this property must be 0 if the SAP replica server is running. If the standalone SAP enqueue server is running without the SAP replica server, this property can be set to a non-zero value.

Maximum

2

Default

0

Tunable

Any time

Retry_Interval
Maximum

3600

Default

960

Tunable

Any time

Thorough_Probe_Interval
Maximum

3600

Default

120

Tunable

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:

Child_mon_level

The child process monitoring level for the process monitor facility (PMF). This property is equivalent to the -C option of pmfadm.

The default value of -1 indicates that child process monitoring will not be performed. Positive values indicate the desired level of child process monitoring.

Data type

Integer

Default

-1

Range

No range defined

Tunable

Any time

Enqueue_Instance_Number

The two-digit instance number for the SAP enqueue server. This is the value of SAPSYSTEM in the SAP profile for the SAP enqueue server.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

Enqueue_Profile

The full path to the SAP enqueue server profile.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

Enqueue_Server

The full path to the SAP enqueue server executable.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

Enqueue_Server_Monitor

The full path to the SAP enqueue server monitor executable.

Data type

String

Default

directory/ensmon, where directory is the full path to the directory where the SAP enqueue server executable is stored, as specified by the extension property Enqueue_Server.

Range

Not applicable

Tunable

When disabled

Log_Directory

The directory for the startup and monitor log files.

Data type

String

Default

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

Range

Not applicable

Tunable

When disabled

Monitor_retry_count

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

Data type

Integer

Default

4

Range

No range defined

Tunable

Any time

Monitor_retry_interval

The interval in minutes between restarts of the SAP enqueue server fault monitor.

Data type

Integer

Default

2

Range

No range defined

Tunable

Any time

Probe_timeout

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

Data type

Integer

Default

120

Range

Minimum = 2; no maximum defined

Tunable

Any time

SAP_User

The administration user for the SAP enqueue server.

Data type

String, where letters are in lowercase

Default

No default defined

Range

Not applicable

Tunable

When disabled

Stop_signal

The signal that is sent to the application to stop the SAP enqueue server application.

Data type

Integer

Default

2 (equivalent to SIGINT)

Range

1–37

Tunable

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 Oracle Solaris 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 -h central-lh \\ 
-N sc_ipmp0@1,sc_ipmp0@2,sc_ipmp0@3,sc_ipmp0@4 central-lh \\ 
central-lh-rs

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

# clresourcegroup online -M 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 repl-rg
# clreslogicalhostname create -g repl-rg -h 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 online -M 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 -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 TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/data-service/sapenq

See Also

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