Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Data Service for SAP NetWeaver Guide Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

## Tuning the HA for SAP NetWeaver Fault Monitors

Fault monitoring for the HA for SAP NetWeaver data service is provided by the following fault monitors:

- The fault monitor for the SAP `sapstartsrv` process

- The fault monitor for the SAP central services

- The fault monitor for the SAP replicated enqueue server

- The fault monitor for the SAP replicated enqueue preempter

- The fault monitor for the SAP dialogue instance

Each fault monitor is contained in a resource whose resource type is shown in the following table.

Table 1-3 Resource Types for the Fault Monitors of HA for SAP NetWeaver

Component | Resource Type
--- | ---
SAP `sapstartsrv` | `ORCL.sapstartsrv`
SAP central services | `ORCL.sapcentr`
SAP dialogue instance | `ORCL.sapdia`
SAP replicated enqueue server | `ORCL.saprepenq`
SAP replicated enqueue preempter | `ORCL.saprepenq_preempt`

System properties and extension properties of the resource types control the behavior of the fault monitors. The default values of these properties determine the preset behavior of the fault monitors. The preset behavior should be suitable for most Oracle Solaris Cluster installations. Therefore, you should tune the fault monitors only if you need to modify this preset behavior.

Tuning these fault monitors involves the following tasks:

- Setting the interval between fault monitor probes

- Setting the timeout for fault monitor probes

- Defining the criteria for persistent faults

- Specifying the failover behavior of a resource

Perform these tasks when you register and configure HA for SAP NetWeaver, as described in Registering and Configuring HA for SAP NetWeaver.

In addition, perform the following tasks for tuning the SAP NetWeaver profiles and Oracle Solaris Cluster resources:

- Ensure that the SAP enqueue server is not restarted upon process failures, by changing the `Restart_Program_01 = local $(_EN) pf=$(_PF)` line in the SAP central services profile to `Start_Program_01 = local $(_EN) pf=$(_PF)`. For example:

      #-----------------------------------------------------------------------
      # Start SAP enqueue server
      #-----------------------------------------------------------------------
      _EN = en.sap$(SAPSYSTEMNAME)_$(INSTANCE_NAME)
      Execute_03 = local rm -f $(_EN)
      Execute_04 = local ln -s -f $(DIR_EXECUTABLE)/enserver$(FT_EXE) $(_EN)
      Start_Program_01 = local $(_EN) pf=$(_PF)

- For every SAP central service resource of the type ORCL.sapcentr, set `retry_count` to 0.

      # clrs set -p Retry_count=0 resource name

- (Optional) For every `sapstart` service resource of the type ORCL.sapstartsrv, which includes either the SAP central services resource or the SAP replicated enqueue server resource of the type ORCL.saprepenq, you can set `Child_mon_level` to 5. Follow this for only the `sapstart` service resource which has the same instance name as the SAP central service and the SAP replicated enqueue server resources.

      # clrs set -p Child_mon_level=5 resource name

For detailed information about these tasks, see Tuning Fault Monitors for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide.

### Operation of the Fault Monitor for the SAP `sapstartsrv` Resource Type

To determine whether the SAP `sapstartsrv` process is operating correctly, the fault monitor for the SAP `sapstartsrv` resource type probes these resources periodically.

The probe uses the `sapcontrol` command to check the health of the `sapstartsrv` process.

    # su - sidadm -c "sapcontrol -nr instance number -function GetProcessList"

sidadm

  Specifies the SAP administrative user.

instance number

  Specifies the SAP instance number of the `sapstartsrv` process.

The return codes 0, 3, and 4 signal a healthy `sapstartsrv` process. Every other return code indicates a faulty `sapstartsrv` process

If the probe command times out, that is if it reaches 80% of the `probe_timeout` property, the return code of the probe command is determined by the `timeout_return` property.

The number of tolerated consecutive timeouts within `retry_interval` seconds is obtained by dividing 100 over `timeout_return`. If this number is greater than the number you obtain by dividing `retry_interval` by `thorough_probe_interval`, then timeouts will be tolerated forever.

For more information, see Tuning Fault Monitors for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide.

### Operation of the Fault Monitor for the SAP Central Services Resource Type

To determine whether the SAP central services are operating correctly, the fault monitor for the SAP central services resource type probes these resources periodically.

The probe uses the `sapcontrol` command to check the health of the `sapstartsrv` process.

    # su - sidadm -c "sapcontrol -nr instance number -function GetProcessList"

sidadm

  Specifies the SAP administrative user.

instance number

  Specifies the SAP instance number of the central service.

The return code indications are as follows:

- 1 signals an internal error.

- 3 signals that everything is running as expected.

- 4 indicates that everything is stopped and a failover is initiated.

- For all other return codes, the output off the `sapcontrol` command is evaluated for the status of the critical processes.

Critical processes are the message server, enqueue server, and the gateway reader, if available. The status of the different processes lead to different actions as shown in the following table.

GREEN | No action
YELLOW | The probe command returns with the number specified in the yellow property
GRAY | The probe indicates a restart
RED | The probe indicates a failover

If the probe command times out, that is if it reaches 80% of the `probe_timeout` property, the return code of the probe command is determined by the YELLOW property.

The number of tolerated consecutive YELLOW states or timeouts within `retry_interval` seconds is obtained by dividing 100 over `timeout_return`. If this number is greater than the number you obtain by dividing `retry_interval` by `thorough_probe_interval`, then timeouts and YELLOW states will be tolerated forever.

For more information, see Tuning Fault Monitors for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide.

### Operation of the Fault Monitor for the SAP Replicated Enqueue Server Resource Type

To determine whether the SAP central services are operating correctly, the fault monitor for the SAP replicated enqueue server resource type probes these resources periodically.

The probe uses the `sapcontrol` command to check the health of the `sapstartsrv` process.

    # su - sidadm -c "sapcontrol -nr instance number -function GetProcessList"

sidadm

  Specifies the SAP administrative user.

instance number

  Specifies the SAP instance number of the SAP replicated enqueue server.

The return code indications are as follows:

- 1 signals an internal error.

- 3 signals that everything is running perfectly.

- 4 signals that everything is stopped and a failover is initiated.

- For all other return codes, the output off the `sapcontrol` command is evaluated for the status of the critical processes.

The critical process is SAP replicated enqueue server. The status of the process lead to different actions as shown in the following table.

GREEN | No action
YELLOW | The probe command returns with the number specified in the yellow property
GRAY | The probe indicates a restart
RED | The probe indicates a failover

If the probe command times out, that is if it reaches 80% of the `probe_timeout` property, the return code of the probe command is determined by the YELLOW property.

The number of tolerated consecutive YELLOW states or timeouts within `retry_interval` seconds is obtained by dividing 100 over `timeout_return`. If this number is greater than the number you obtain by dividing `retry_interval` by `thorough_probe_interval`, then timeouts and YELLOW states will be tolerated forever.

For more information, see Tuning Fault Monitors for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide.

### Operation of the Fault Monitor for the SAP Dialogue Instance Resource Type

To determine whether the SAP dialogue instance is operating correctly, the fault monitor for the SAP dialogue instance resource type probes these resources periodically.

The probe uses the `sapcontrol` command to check the health of the dialogue instance process.

    # su - sidadm -c "sapcontrol -nr instance number -function GetProcessList"

sidadm

  Specifies the SAP administrative user.

instance number

  Specifies the SAP instance number of the dialogue instance process.

The return code indications are as follows:

- 1 signals an internal error.

- 3 signals that everything is running perfectly.

- 4 signals that everything is stopped and a failover is initiated.

- For all other return codes, the output off the `sapcontrol` command is evaluated for the status of the critical processes.

The critical processes depend on the deployment variation.

For a pure dialogue instance, the critical processes is as follows:

- disp+work, jstart, or jcontrol

For a combined instance the critical processes are as follows:

- disp+work, jstart, or jcontrol

- Enqueue server

- Message server

The status of a critical process leads to different actions as show in the following table.

GREEN | No action
YELLOW | The probe command returns with the number specified in the yellow property
GRAY | The probe indicates a restart
RED | The probe indicates a failover

If the probe command times out, that is if it reaches 80% of the `probe_timeout` property, the return code of the probe command is determined by the YELLOW property.

The number of tolerated consecutive YELLOW states or timeouts within `retry_interval` seconds is obtained by dividing 100 over `timeout_return`. If this number is greater than the number you obtain by dividing `retry_interval` by `thorough_probe_interval`, then timeouts and YELLOW states will be tolerated forever.

For more information, see Tuning Fault Monitors for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide.

### Operation of the Fault Monitor for the SAP Replicated Enqueue Preempter Resource Type

To determine whether the SAP replicated enqueue preempter is operating correctly, the fault monitor for the SAP replicated enqueue preempter service resource type probes these resources periodically.

The probe uses the `sapcontrol` command to check the health of the `sapstartsrv` process.

    # su - sidadm -c "sapcontrol -nr instance number -function GetProcessList"

sidadm

  Specifies the SAP administrative user.

instance number

  Specifies the SAP instance number of the `sapstartsrv` process.

The return code of 0 indicates that everything is running as expected. All other return codes indicate errors.

If the SAP central services and the SAP replicated enqueue server are running on the same node, the probe evaluates if a giveover is possible. If yes, it will initiate the giveover to reinstate the redundancy of the lock table.

If the probe command times out, that is if it reaches 80% of the `probe_timeout` property, the return code of the probe command is determined by the YELLOW property.

The number of tolerated consecutive timeouts within `retry_interval` seconds is obtained by dividing 100 over `timeout_return`. If this number is greater than the number you obtain by dividing `retry_interval` by `thorough_probe_interval`, then timeouts will be tolerated forever.

For more information, see Tuning Fault Monitors for Oracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and Administration Guide.

Copyright © 2012, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices |