Managing Serviceguard Extension for SAP Version A.06.00 for Linux, December 2012

Other methods provided by SAP's sapcontrol command for instance shutdown work in the
similar way.
HP Serviceguard Manager displays a package alert that lists the manually halted instances of a
package. The service monitoring for a halted instance is automatically suspended until you restart
the instance.
HP Serviceguard Manager displays a package alert (see Figure 11 (page 21)) that lists the manually
halted instances of a package. The SGeSAP software service monitoring for a halted instance is
automatically suspended until you restart the instance.
The cluster package configuration also allows blocking any administrator-driven instance stop
attempt via the SAP startup framework. In this case, if a stop operation is triggered anyways, the
sapstartsrv.log file contains the following entries:
trusted unix domain socket user is stopping SAP System …
SAP HA Trace: Reported package name is ERS41SYA
SAP HA Trace: Reported resource name is SYA_ERS41
SAP HA Trace: SAP_HA_FindSAPInstance returns: SAP_HA_OK …
SAP HA Trace: sap_stop_blocked=yes is set in package config
SAP HA Trace: The stop request is blocked by the cluster …
NOTE: If the SGeSAP HA library is configured in the SAP instance profile, SAP system
administrators can stop and restart clustered Netweaver instances without interacting with the
cluster software explicitly. Instance status is visualized in the Serviceguard Manager GUI which
continues to provide a full picture of components that are up to the cluster administrators. The
SGeSAP monitoring suspends operation while the instance is manually stopped.
Packages that have several Netweaver instances configured, continue to monitor all the instances
that are not manually halted. If any actively monitored instance fails, it results in a failover and
restart of the whole package.
One of the methods to restart a manually halted instance is to issue the following command:
sapcontrol -nr <instnr> -function Start
Any other startup method provided by SAP's sapcontrol command works in the similar way.
Example of messages added to the package log:
<date> root@<node> sapdisp.mon[xxx]: (sapdisp.mon,check_if_stopped):
Manual start operation detected for DVEBMGS41
<date> root@<node> sapdisp.mon[xxx]: (sapdisp.mon,check_if_stopped):
Resume monitored operation of DVEBMGS41
If the instance fails to start, the service monitor enters the yellow state. The yellow state is printed
as a warning to the package log and displayed as a package alert in the HP Serviceguard
Manager.
<date> root@<node> sapdisp.mon[xxx]: (sapdisp.mon,check_if_stopped):
Resume monitored operation of DVEBMGS41
<date> root@<node> sapdisp.mon[xxx]: (sapdisp.mon,dispmon_monitors):
WARNING: Dispatcher of DVEBMGS41 - monitor state:YELLOW,2
The service monitor remains in yellow state for up to five monitoring intervals. Then, it changes
to red state and fails the package with the next monitoring interval. If another instance halt
operation is issued while the monitor is in yellow or red state, the monitoring is suspended again
and the package failover is prevented. This occurs regardless of whether the manual halt succeeds
or not. It is an effective way to prevent undesirable failovers.
24 SAP cluster administration