-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
141 lines (94 loc) · 4.9 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
check_sstcam Nagios Plugin README
---------------------
This plugin checks the alarm directory of a SUN Storagetek Common Array Manager.The CAM is a management software for SUN StorEdge 6130 and SUN StorageTek 6140
and 6540 Storage arrays. Warnings and failures of the managed systems will be
written as files into the alarm directory. The check_sstcam plugin reads this
directory periodically and forwards newly reported alerts to Nagios.
* For instructions on installing this plugin for use with Nagios,
see below. In addition, generic instructions for the GNU toolchain
can be found in the INSTALL file.
* For major changes between releases, read the CHANGES file.
* For information on detailed changes that have been made,
read the Changelog file.
* This plugins is self documenting. All plugins that comply with
the basic guidelines for development will provide detailed help when
invoked with the '-h' or '--help' options.
You can check for the latest plugin at:
http://www.consol.de/opensource/check-sstcam
Send mail to [email protected] for assistance.
Please include the OS type and version that you are using.
Also, run the plugin with the '-v' option and provide the resulting
version information. Of course, there may be additional diagnostic information
required as well. Use good judgment.
How to "compile" the check_sstcam script.
--------------------------------------------------------
1) Run the configure script to initialize variables and create a Makefile, etc.
./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-perl=PATH_TO_PERL --with-alarm-dir=ALARMDIR --with-status-dir=STATUSDIR
a) Replace BASEDIRECTORY with the path of the directory under which Nagios
is installed (default is '/usr/local/nagios')
b) Replace SOMEUSER with the name of a user on your system that will be
assigned permissions to the installed plugins (default is 'nagios')
c) Replace SOMEGRP with the name of a group on your system that will be
assigned permissions to the installed plugins (default is 'nagios')
d) Replace PATH_TO_PERL with the path where a perl binary can be found.
Besides the system wide perl you might have installed a private perl
just for the nagios plugins (default is the perl in your path).
e) Replace ALARMDIR with the path where your CAM installation writes
the alarm files.
(default is /var/opt/SUNWsefms/store/Alarms).
f) Replace STATUSDIR with the path where you want to keep the status
information between the single runs of check_sstcam.
(default is $HOME/var/tmp).
2) "Compile" the plugin with the following command:
make
This will produce a "check_sstcam" script. You will also find
a "check_sstcam.pl" which you better ignore. It is the base for
the compilation filled with placeholders. These will be replaced during
the make process.
3) Install the compiled plugin script with the following command:
make install
The installation procedure will attempt to place the plugin in a
'libexec/' subdirectory in the base directory you specified with
the --prefix argument to the configure script.
4) Verify that your configuration files for Nagios contains
the correct paths to the new plugin.
Command line parameters
-----------------------
-n <device>
If you want monitor just one specific storage system instead of all
known to the CAM, you specify it's name here.
-f <configfile>
If you want to monitor more than one storage system but not all of them
(which is the default), you can name them in a config file.
-p | --persistent
Using this parameter causes the plugin to exit critical as long as
there is an alarm file. (If you set this parameter, do _not_ set
is_volatile to 1)
Format of the configuration file
--------------------------------
check_sstcam interprets a configuration file, which contains the names of
all storage systems you want to monitor. It is a simple piece of perl-code
where the names are the elements of an array called @devicenames.
Example:
@devicenames = qw(The-6540-storage-1st-floor Treefrog-1);
How to call check_sstcam from Nagios
--------------------------------------
Only newly occurred alarms shall be reported. If the same error is found
through a second run of check_sstcam, the plugin will report OK.
The service definition must be defined like this:
define service {
service_description check_sstcam
# the CAM software runs on host hundsglump.muc
host_name hundsglump.muc
check_command check_nrpe!check_sstcam
is_volatile 1
check_period 7x24
max_check_attempts 1
...
}
If you don't understand what is_volatile means, do read the nagios
documentation on this topic.
That's it. If you have any problems or questions, feel free to send mail
--
Gerhard Lausser <[email protected]>