-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
152 lines (110 loc) · 5.47 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
This is an implementation of the Service Availability Forum's
Hardware Platform Interface SNMP sub-agent.
Through this subagent one can includes support for multiple different
types of hardware including: IPMI, IBM Blade Center (via SNMP),
Linux Watchdog devices, and Sysfs based systems.
---------------------------------------------------------
PREREQUISITES
---------------------------------------------------------
The following software is required to build 'openhpi-subagent'
Any implementation that is based on SAF specification SAI-HPI-B.01.01.
Recommended: 'openhpi' >= 2.0.4
autoconf >= 2.57
automake >= 1.5
gcc >= 3.2.0
uuid.h (may be found in e2fsprogs-devel or uuid-dev)net-snmp >= 5.1.2
(Don't use earlier versions - the AgentX protocol had some
serious issues).
(Don't use 5.0.7 - it has a bug in the CONTAINER operations that
seg faults the sub-agent).
GLIB-2.1
---------------------------------------------------------
BUILD / INSTALLATION
---------------------------------------------------------
First time to extract the code:
run ./boostrap
This will generate all files needed to compile.
after running the bootstrap script, run:
./configure
then make (or make rpm)
and then (as root or with proper system install permissions)
make install (or install from the rpm).
It will generate the subagent code and put the configuration file
- hpiSubagent.conf in the NetSNMP configuration directory.
If you want to generate the guide, run:
make pdf-m
in the docs directory.
---------------------------------------------------------
RUNNING
---------------------------------------------------------
1. Configure your OpenHPI installation to work. Make sure that
/etc/openhpi/openhpi.conf lists the desired plugin.
2. Configure your NetSNMP configuration file (snmpd.conf) to include
"master agentx"
3. Start the NetSNMP daemon. (usually /etc/init.d/snmpd on various Linux distros).
note: see 'howto' file for further detail.
4. Start the hpiSubagent. (either use the runtime script: /etc/init.d/openhpi-subagent,
or just run it from the terminal). You should see something similar in the
syslog log file - /var/log/messages:
note: see 'howto' file for further detail.
...
Feb 6 10:53:37 konrad hpiSubagent[9890]: Not sending events during startup.
Feb 6 10:53:37 konrad hpiSubagent[9890]: Checking HPI infrastructure every 4 seconds.
Feb 6 10:53:37 konrad hpiSubagent[9890]: Max Event rows 1024.
...
5. Browse the MIB tree. When browsing the MIB tree, make sure you
load the MIB in your favorite SNMP browser. If you are using
NetSNMP commands, set the MIBS environment variable to ALL:
$export MIBS=ALL
And set the MIBDIRS enviroment variable to point to the the directory where the
OpenHPI MIB file is located (openhpi-subagent/mibs) or
copy the MIB file in to the NetSNMP MIB default directory (usually
/usr/share/snmp/mibs). To set the MIBDIRS, refer to 'man snmpcmd' or:
$export MIBDIRS=+~/openhpi-subagent/mib
After these step you should have no trouble browsing the HPI MIB:
$snmpwalk -v2c -c public localhost HPI-B0101-MIB::hpiB0101
HPI-B0101-MIB::saHpiSensorThdNegHysteresisIsWritable.1.1.false.11 = INTEGER: false(2)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisIsWritable.1.1.false.12 = INTEGER: false(2)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisIsWritable.1.1.false.13 = INTEGER: false(2)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.6 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.7 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.8 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.9 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.10 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.11 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.12 = INTEGER: float64(3)
HPI-B0101-MIB::saHpiSensorThdNegHysteresisType.1.1.false.13 = INTEGER: float64(3)
.....
6). If you want to receive traps make sure you are running a SNMP trap daemon
(NetSNMP provides one - snmptrapd).
Furthermore make sure that the SNMP daemon is configured to send traps
and specify its destination, such as:
"inform2sink <hostname>" in snmpd.conf.
Refer to 'man snmpd.conf' for more details.
---------------------------------------------------------
CLEANUP
---------------------------------------------------------
To remove the temporary build files, type:
make clean
If you are a maintainer, and need to remove all autogenerated files, type:
make clean
make maintainer-clean
---------------------------------------------------------
GENERAL RELEASE NOTES and WHAT'S NEW
---------------------------------------------------------
* First release of openhpi-subagent SAI-HPI-B.01.01 release compliant.
---------------------------------------------------------
FOR MORE INFO
---------------------------------------------------------
For more information please see the project website at
http://openhpi.sourceforge.net
Also visit SAForum's website at http://www.saforum.org
---------------------------------------------------------
BUGS
---------------------------------------------------------
See 'Openhpi' project' located on SourceForge for the
latest bug list.
Presently only single domain/session(s) is supported.
---------------------------------------------------------
DEFINES
---------------------------------------------------------