2
STONITH module for IBM BladeCenter via OpenHPI
3
----------------------------------------------
6
Linux-HA bladehpi STONITH plugin requires OpenHPI 2.6+
7
OpenHPI requires Net-SNMP 5.0+
8
OpenHPI requires BladeCenter Management Module 1.08+
10
This STONITH module talks to IBM BladeCenters via SNMP through use of
11
the OpenHPI BladeCenter plugin (snmp_bc). For more information about
12
installing OpenHPI, setting up the BladeCenter SNMP agent, etc. please
13
visit http://www.openhpi.org/. Once OpenHPI is installed properly,
14
the STONITH plugin will automatically be built the next time Linux-HA
17
Use the OpenHPI configuration file (i.e. /etc/openhpi/openhpi.conf)
18
to configure the BladeCenters of interest to STONITH. For example,
19
the following excerpt:
24
entity_root = "{SYSTEM_CHASSIS,1}" # Required
25
host = "9.254.253.252" # Required
26
community = "community" # Version 1 Required.
27
version = "3" # Required. SNMP protocol version (1|3)
28
security_name = "userid" # Version 3 Required.
29
passphrase = "userpass" # Version 3. Required if security_level is authNoPriv or authPriv.
30
auth_type = "MD5" # Version 3. Passphrase encoding (MD5|SHA)
31
security_level = "authNoPriv" # Version 3. (noAuthNoPriv|authNoPriv|authPriv)
34
defines how to access the BladeCenter at 9.254.253.252 using SNMPV3
35
with an ID/password of userid/userpass. The entity_root must be
36
passed to the STONITH bladehpi plugin as its single required parameter.
37
For example, to query the list of blades present in the BladeCenter
38
configured above, run:
40
stonith -t bladehpi -p "{SYSTEM_CHASSIS,1}" -l
44
stonith -t bladehpi "entity_root={SYSTEM_CHASSIS,1}" -l
46
Use the BladeCenter Management Module web interface to set the Blade
47
Information to match "uname -n" for each blade in the cluster. For
48
example, with the BladeCeter configured above use a brower to access
49
http://9.254.253.252, login with userid/userpass, and then go to
50
Blade Tasks -> Configuration -> Blade Information, enter the proper
51
names, and select Save. Be aware that heartbeat must be restarted
52
before these changes take effect or, if using the OpenHPI daemon,
53
the daemon must be restarted.
55
More than one BladeCenter can be placed in the OpenHPI configuration
56
file by using different numbers with the entity_root. For example,
61
entity_root = "{SYSTEM_CHASSIS,1}" # Required
62
host = "9.254.253.252" # Required
66
entity_root = "{SYSTEM_CHASSIS,2}" # Required
67
host = "9.254.253.251" # Required
71
There is an optional parameter, soft_reset, that is true|1 if bladehpi
72
should use soft reset (power cycle) to reset nodes or false|0 if it
73
should use hard reset (power off, wait, power on); the default is
74
false. As an example, to override the default value the above stonith
77
stonith -t bladehpi -p "{SYSTEM_CHASSIS,1} true" -l
81
stonith -t bladehpi "entity_root={SYSTEM_CHASSIS,1} soft_reset=true" -l
83
The difference between the two is that a soft reset is much quicker
84
but may return before the node has been reset because bladehpi relies
85
on BladeCenter firmware to cycle the node's power, while a hard reset
86
is slower but guaranteed not to return until the node is dead because
87
bladehpi powers off the node, waits until it is off, then powers it
90
NOTE: Set the OPENHPI_CONF environment variable to contain the
91
fully-qualified path of the OpenHPI configuration file, for example:
93
export OPENHPI_CONF=/etc/openhpi/openhpi.conf
95
NOTE: If OpenHPI is not configured with --disable-daemon before being
96
built and installed, make sure that the OpenHPI daemon is running
97
before using the bladehpi plugin.
99
NOTE: If debugging of the environment is needed, configure OpenHPI
100
with --enable-debuggable and rebuild/reinstall, export
101
OPENHPI_DEBUG=YES, and run stonith commands with the -d option.