ocf_heartbeat_SAPHanaTopology(7)

1OCF_HEARTBEAT_SAPHAN(7)       OCF resource agents      OCF_HEARTBEAT_SAPHAN(7)
2
3
4

NAME

6       ocf_heartbeat_SAPHanaTopology - Analyzes SAP HANA System Replication
7       Topology.
8

SYNOPSIS

10       SAPHanaTopology [start | stop | status | monitor | meta-data |
11                       validate-all]
12

DESCRIPTION

14       This RA analyzes the SAP HANA topology and "sends" all findings via the
15       node status attributes to all nodes in the cluster. These attributes
16       are taken by the SAPHana RA to control the SAP Hana Databases. In
17       addition it starts and monitors the local saphostagent.
18
19       1. Interface to monitor a HANA system: landscapeHostConfiguration.py
20       landscapeHostConfiguration.py has some detailed output about HANA
21       system status and node roles. For our monitor the overall status is
22       relevant. This overall status is reported by the returncode of the
23       script: 0: Internal Fatal 1: ERROR 2: WARNING 3: INFO (maybe a switch
24       of the resource running) 4: OK The SAPHanaTopology resource agent will
25       interpret returncodes 1 as NOT-RUNNING (or 1 failure) and returncodes
26       2+3+4 as RUNNING. SAPHanaTopology scans the output table of
27       landscapeHostConfiguration.py to identify the roles of the cluster
28       node. Roles means configured and current role of the nameserver as well
29       as the indexserver.
30
31       2. Interface is hdbnsutil The interface hdbnsutil is used to check the
32       "topology" of the system replication as well as the current
33       configuration (primary/secondary) of a SAP HANA database instance. A
34       second task of the interface is the posibility to run a system
35       replication takeover (sr_takeover) or to register a former primary to a
36       newer one (sr_register).
37
38       3. saphostctrl The interface saphostctrl uses the function
39       ListInstances to figure out the virtual host name of the SAP HANA
40       instance. This is the hostname used during the HANA installation.
41

SUPPORTED PARAMETERS

43       SID
44           The SAP System Identifier (SID)
45
46           (required, string, no default)
47
48       InstanceNumber
49           The SAP Instance Number
50
51           (required, string, no default)
52
53       DIR_EXECUTABLE
54           Path to the SAP Hana Instance executable directory. If not set the
55           RA tries /usr/sap/$SID/$InstanceName/exe. While InstanceName is the
56           string of "HDB" and $InstanceNumber for SAP Hana databases.
57
58           (optional, string, no default)
59
60       SAPHanaFilter
61           OUTDATED
62
63           (optional, string, no default)
64

SUPPORTED ACTIONS

66       This resource agent supports the following actions (operations):
67
68       start
69           Starts the resource. Suggested minimum timeout: 180.
70
71       stop
72           Stops the resource. Suggested minimum timeout: 60.
73
74       status
75           Performs a status check. Suggested minimum timeout: 60.
76
77       monitor
78           Performs a detailed status check. Suggested minimum timeout: 60.
79           Suggested interval: 60.
80
81       validate-all
82           Performs a validation of the resource configuration. Suggested
83           minimum timeout: 5.
84
85       meta-data
86           Retrieves resource agent metadata (internal use only). Suggested
87           minimum timeout: 5.
88
89       methods
90           Suggested minimum timeout: 5.
91

EXAMPLE

93       The following is an example configuration for a SAPHanaTopology
94       resource using the crm(8) shell:
95
96           primitive p_SAPHanaTopology ocf:heartbeat:SAPHanaTopology \
97             params \
98               SID=string \
99               InstanceNumber=string \
100             op monitor depth="0" timeout="60" interval="60"
101

AUTHOR

106       Linux-HA contributors (see the resource agent source for information
107       about individual authors)
108
109
110
111resource-agents 3.9.2             03/24/2017           OCF_HEARTBEAT_SAPHAN(7)