~ubuntu-branches/ubuntu/precise/nagios-snmp-plugins/precise : revision 1

1

<HTML>

2

<HEAD>

3

<TITLE>Nagios plugins</TITLE>

4

5

6

<!--

7

.Default { font-family: verdana,arial,serif; font-size: 10pt; }

8

.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}

9

.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}

10

.Email { font-family: verdana,arial,serif; font-size: 10pt;}

11

.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }

12

.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}

13

.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}

14

.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}

15

.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }

16

.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}

17

.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }

18

.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }

19

.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }

20

A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }

21

A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }

22

A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }

23

A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }

24

-->

25

</STYLE>

26

</HEAD>

27

28

29

30

31

32

33

34

<tr>

35

36

37

38

39

40

41

<tr>

42

43

</tr>

44

<tr>

45

46

</tr>

47

<tr>

48

<td>

49

</td>

50

</tr>

51

<tr>

52

53

</tr>

54

</table>

55

56

57

58

</td>

59

60

61

62

63

64

<tr>

65

66

67

68

</tr>

69

70

<tr>

71

72

<td>

73

74

75

76

Last update : Jan 11 2007

77

78

</td>

79

80

</tr>

81

82

<tr>

83

84

85

86

87

FIRST, look at the web page associated

88

with every script.

89

Running the scripts :

90

- <a href="#FAQ1">The scripts outputs "Can't

91

locate Net/SNMP.pm in @INC....."</a>

92

-<a href="#FAQ2"> How do I install Net::SNMP

93

perl module</a>

94

- <a href="#FAQ3">What are the supported platforms

95

to run the scripts on ?</a>

96

- <a href="#FAQ4">How do I get help on the

97

options ?</a>

98

- <a href="#FAQ5">Return code of X is out of

99

bounds</a>

100

- <a href="#FAQ6">Are these plugins compatible

101

with Nagios 2.0 ?</a>

102

- <a href="#FAQ7"> ERROR: XXXXXX : Expected

103

OBJECT IDENTIFIER in dotted notation. </a>

104

- <a href="#FAQ8">"No Output" using

105

Nagios 2</a>

106

- <a href="#FAQ9">Getting : "ERROR: Size

107

table :Message size exceeded buffer maxMsgSize"</a>

108

Misc

109

110

- <a href="#FAQM3">Are these scripts secure

111

?</a>

112

- <a href="#FAQM1">How can I get help ? Is

113

there a mailling list ? a forum ?</a>

114

- <a href="#FAQM2">Can I donate to help this

115

project ?</a>

116

<hr>

117

<a name="FAQ1"></a>The scripts outputs "Can't

118

locate Net/SNMP.pm in @INC....."

119

You don't have Net::SNMP installed, see below

120

<a name="FAQ2"></a>How do I install Net::SNMP

121

perl module ?

122

There are 2 ways of doing this

123

1) By CPAN (best)

124

on command line, as root :

125

126

[your_host]# perl -MCPAN -e shell

127

cpan shell -- CPAN exploration and modules installation (v1.76)

128

ReadLine support enabled

129

cpan> install Net::SNMP

130

131

If it's the first time you run CPAN, it will

132

probably ask you some (simple) questions.

133

CPAN will also ask you to satisfy some dependencies

134

(Crypt::DES, Digest::MD5, etc..).

135

2) "By hand"

136

137

Get the folowings modules (tar.gz format) on

138

139

- Crypt::DES

140

- Digest::MD5

141

- Digest::SHA1

142

- Digest::HMAC

143

- Net::SNMP

144

145

for each one (you must install Net::SNMP at the end) :

146

tar zxf <module>.tar.gz

147

cd <module>

148

perl Makefile.pl

149

make test

150

make install

151

<a name="FAQ3"></a>What are the supported

152

platforms to run the scripts on ?

153

Most Linux, maybe some unixes and maybe Cygwin.

154

Actually anything you can run perl on.

155

If you can install the latest Net::SNMP module, then the perl version

156

should be OK.

157

<a name="FAQ4"></a>How do I get help on the

158

options ?

159

Just run <script> -h on the command

160

line.

161

162

163

<a name="FAQ5"></a>Return code of X is out

164

of bounds

165

Have a look at : <a href="http://www.nagios.org/faqs/viewfaq.php?faq_id=17">http://www.nagios.org/faqs/viewfaq.php?faq_id=17</a>

166

In case of return code 127, try putting perl

167

in the command line definition :

168

define command{

169

command_name check_disk

170

command_line /usr/bin/perl $USER1$/check_snmp_storage.pl

171

-C $ARG1$ [........]

172

}

173

174

<a name="FAQ6"></a>Are these plugins compatible

175

with Nagios 2.0 ?

176

Yes.

177

<a name="FAQ7"></a>ERROR: XXXXXX : Expected OBJECT IDENTIFIER in dotted notation.

178

179

Upgrade your Net::SNMP module version (5 is good, 4 maybe OK, 3 gives this error)

180

This happens with Debian Woody (Net::SNMP version 3.6).

181

I have special patches if you can't upgrade : contact me.

182

<a name="FAQ8"></a>"No Output" using

183

Nagios 2

184

It's a "bug" of embeded perl. It

185

has been corrected in latest Nagios releases.

186

You can :

187

188

- Add a patch if your nagios release is old.

189

Here is a patch made by Gavin Carr for the p1.pl file to correct

190

this (it should be in nagios CVS shortly). <a href="http://nagios.manubulon.com/p1-print.pl.patch">http://nagios.manubulon.com/p1-print.pl.patch</a>

191

192

- Upgrade Nagios.

193

194

- add "/usr/bin/perl" before the script command so Nagios

195

won't use embeded perl.

196

<a name="FAQ9"></a>Getting : "ERROR:

197

Size table :Message size exceeded buffer maxMsgSize"

198

Your snmp table is too big.

199

Some of my scripts (check_snmp_storage and

200

check_snmp_process) now have an option (-o) to set this directly

201

on command line (thx to Makina Corpus for the patch).

202

In other scripts, try adding :

203

$session->max_msg_size(5000);

204

205

After the session has been initialized.

206

207

<a name="FAQM3"></a>Are these scripts secure ?

208

Not at all ! You must secure the Nagios server.

209

Nobody else than the nagios user should be allowed to even think

210

about running these scripts.

211

212

<a name="FAQM1"></a>How can I get help ? Is

213

there a mailling list ? a forum ?

214

Go to the sourceforge project page for all this : <a href=http://sourceforge.net/projects/nagios-snmp/>Nagios-snmp</a>

215

<a name="FAQM2"></a>Can

216

I donate to help this project ?

217

Of course you can, I just haven't got any idea

218

of how, so just send a postcard to my son (Jolan) with a nice drawing (or buy a cookie to your son/daughter/nephew/grand-ma...).

219

You can get my postal address on my resume (<a href="http://www.manubulon.com/cvpproy.htm">www.manubulon.com/cvpproy.htm</a>).

220

He will answer you when he knows how to write (in several years).

221

</td>

222

223

</tr>

224

<tr>

225

<td>

226

This project is also hosted by :

227

228

229

</td>

230

</tr>

231

232

</table>

233

234

</td>

235

236

</tr>

237

238

</table>

239

240

241

242

</BODY>

243

244

</HTML>

245