source: noc/nagios/cgi.cfg @ 990

Last change on this file since 990 was 990, checked in by mitchb, 14 years ago
If I'm going to deal with outages, I should be able to ACK them and schedule downtime too.
File size: 9.7 KB
Line 
1#################################################################
2#
3# CGI.CFG - CGI Configuration File for Nagios
4#
5#################################################################
6
7
8# MAIN CONFIGURATION FILE
9# This tells the CGIs where to find your main configuration file.
10# The CGIs will read the main and host config files for any other
11# data they might need.
12
13main_config_file=/etc/nagios2/nagios.cfg
14
15
16
17# PHYSICAL HTML PATH
18# This is the path where the HTML files for Nagios reside.  This
19# value is used to locate the logo images needed by the statusmap
20# and statuswrl CGIs.
21
22physical_html_path=/usr/share/nagios2/htdocs
23
24
25
26# URL HTML PATH
27# This is the path portion of the URL that corresponds to the
28# physical location of the Nagios HTML files (as defined above).
29# This value is used by the CGIs to locate the online documentation
30# and graphics.  If you access the Nagios pages with an URL like
31# http://www.myhost.com/nagios, this value should be '/nagios'
32# (without the quotes).
33
34url_html_path=/nagios2
35
36
37
38# CONTEXT-SENSITIVE HELP
39# This option determines whether or not a context-sensitive
40# help icon will be displayed for most of the CGIs.
41# Values: 0 = disables context-sensitive help
42#         1 = enables context-sensitive help
43
44show_context_help=1
45
46
47
48# NAGIOS PROCESS CHECK COMMAND
49# This is the full path and filename of the program used to check
50# the status of the Nagios process.  It is used only by the CGIs
51# and is completely optional.  However, if you don't use it, you'll
52# see warning messages in the CGIs about the Nagios process
53# not running and you won't be able to execute any commands from
54# the web interface.  The program should follow the same rules
55# as plugins; the return codes are the same as for the plugins,
56# it should have timeout protection, it should output something
57# to STDIO, etc.
58#
59# Note: The command line for the check_nagios plugin below may
60# have to be tweaked a bit, as different versions of the plugin
61# use different command line arguments/syntaxes.
62
63nagios_check_command=/usr/lib/nagios/plugins/check_nagios /var/cache/nagios2/status.dat 5 '/usr/sbin/nagios2'
64
65
66
67# AUTHENTICATION USAGE
68# This option controls whether or not the CGIs will use any
69# authentication when displaying host and service information, as
70# well as committing commands to Nagios for processing. 
71#
72# Read the HTML documentation to learn how the authorization works!
73#
74# NOTE: It is a really *bad* idea to disable authorization, unless
75# you plan on removing the command CGI (cmd.cgi)!  Failure to do
76# so will leave you wide open to kiddies messing with Nagios and
77# possibly hitting you with a denial of service attack by filling up
78# your drive by continuously writing to your command file!
79#
80# Setting this value to 0 will cause the CGIs to *not* use
81# authentication (bad idea), while any other value will make them
82# use the authentication functions (the default).
83
84use_authentication=1
85
86
87
88# DEFAULT USER
89# Setting this variable will define a default user name that can
90# access pages without authentication.  This allows people within a
91# secure domain (i.e., behind a firewall) to see the current status
92# without authenticating.  You may want to use this to avoid basic
93# authentication if you are not using a secure server since basic
94# authentication transmits passwords in the clear.
95#
96# Important:  Do not define a default username unless you are
97# running a secure web server and are sure that everyone who has
98# access to the CGIs has been authenticated in some manner!  If you
99# define this variable, anyone who has not authenticated to the web
100# server will inherit all rights you assign to this user!
101 
102default_user_name=guest
103
104
105
106# SYSTEM/PROCESS INFORMATION ACCESS
107# This option is a comma-delimited list of all usernames that
108# have access to viewing the Nagios process information as
109# provided by the Extended Information CGI (extinfo.cgi).  By
110# default, *no one* has access to this unless you choose to
111# not use authorization.  You may use an asterisk (*) to
112# authorize any user who has authenticated to the web server.
113
114authorized_for_system_information=presbrey@MIT.EDU,andersk@MIT.EDU,quentin@MIT.EDU,geofft@MIT.EDU,mitchb@MIT.EDU
115
116
117
118# CONFIGURATION INFORMATION ACCESS
119# This option is a comma-delimited list of all usernames that
120# can view ALL configuration information (hosts, commands, etc).
121# By default, users can only view configuration information
122# for the hosts and services they are contacts for. You may use
123# an asterisk (*) to authorize any user who has authenticated
124# to the web server.
125
126authorized_for_configuration_information=presbrey@MIT.EDU,andersk@MIT.EDU,quentin@MIT.EDU,geofft@MIT.EDU,mitchb@MIT.EDU
127
128
129
130# SYSTEM/PROCESS COMMAND ACCESS
131# This option is a comma-delimited list of all usernames that
132# can issue shutdown and restart commands to Nagios via the
133# command CGI (cmd.cgi).  Users in this list can also change
134# the program mode to active or standby. By default, *no one*
135# has access to this unless you choose to not use authorization.
136# You may use an asterisk (*) to authorize any user who has
137# authenticated to the web server.
138
139authorized_for_system_commands=presbrey@MIT.EDU,andersk@MIT.EDU,quentin@MIT.EDU,geofft@MIT.EDU,mitchb@MIT.EDU
140
141
142
143# GLOBAL HOST/SERVICE VIEW ACCESS
144# These two options are comma-delimited lists of all usernames that
145# can view information for all hosts and services that are being
146# monitored.  By default, users can only view information
147# for hosts or services that they are contacts for (unless you
148# you choose to not use authorization). You may use an asterisk (*)
149# to authorize any user who has authenticated to the web server.
150
151
152authorized_for_all_services=*
153authorized_for_all_hosts=*
154#authorized_for_all_services=presbrey@MIT.EDU,andersk@MIT.EDU
155#authorized_for_all_hosts=presbrey@MIT.EDU,andersk@MIT.EDU
156
157
158
159# GLOBAL HOST/SERVICE COMMAND ACCESS
160# These two options are comma-delimited lists of all usernames that
161# can issue host or service related commands via the command
162# CGI (cmd.cgi) for all hosts and services that are being monitored.
163# By default, users can only issue commands for hosts or services
164# that they are contacts for (unless you you choose to not use
165# authorization).  You may use an asterisk (*) to authorize any
166# user who has authenticated to the web server.
167
168authorized_for_all_service_commands=presbrey@MIT.EDU,andersk@MIT.EDU,quentin@MIT.EDU,geofft@MIT.EDU,mitchb@MIT.EDU
169authorized_for_all_host_commands=presbrey@MIT.EDU,andersk@MIT.EDU,quentin@MIT.EDU,geofft@MIT.EDU,mitchb@MIT.EDU
170
171
172
173
174# STATUSMAP BACKGROUND IMAGE
175# This option allows you to specify an image to be used as a
176# background in the statusmap CGI.  It is assumed that the image
177# resides in the HTML images path (i.e. /usr/local/nagios/share/images).
178# This path is automatically determined by appending "/images"
179# to the path specified by the 'physical_html_path' directive.
180# Note:  The image file may be in GIF, PNG, JPEG, or GD2 format.
181# However, I recommend that you convert your image to GD2 format
182# (uncompressed), as this will cause less CPU load when the CGI
183# generates the image.
184
185#statusmap_background_image=smbackground.gd2
186
187
188
189# DEFAULT STATUSMAP LAYOUT METHOD
190# This option allows you to specify the default layout method
191# the statusmap CGI should use for drawing hosts.  If you do
192# not use this option, the default is to use user-defined
193# coordinates.  Valid options are as follows:
194#       0 = User-defined coordinates
195#       1 = Depth layers
196#       2 = Collapsed tree
197#       3 = Balanced tree
198#       4 = Circular
199#       5 = Circular (Marked Up)
200
201default_statusmap_layout=5
202
203
204
205# DEFAULT STATUSWRL LAYOUT METHOD
206# This option allows you to specify the default layout method
207# the statuswrl (VRML) CGI should use for drawing hosts.  If you
208# do not use this option, the default is to use user-defined
209# coordinates.  Valid options are as follows:
210#       0 = User-defined coordinates
211#       2 = Collapsed tree
212#       3 = Balanced tree
213#       4 = Circular
214
215default_statuswrl_layout=4
216
217
218
219# STATUSWRL INCLUDE
220# This option allows you to include your own objects in the
221# generated VRML world.  It is assumed that the file
222# resides in the HTML path (i.e. /usr/local/nagios/share).
223
224#statuswrl_include=myworld.wrl
225
226
227
228# PING SYNTAX
229# This option determines what syntax should be used when
230# attempting to ping a host from the WAP interface (using
231# the statuswml CGI.  You must include the full path to
232# the ping binary, along with all required options.  The
233# $HOSTADDRESS$ macro is substituted with the address of
234# the host before the command is executed.
235# Please note that the syntax for the ping binary is
236# notorious for being different on virtually ever *NIX
237# OS and distribution, so you may have to tweak this to
238# work on your system.
239
240ping_syntax=/bin/ping -n -U -c 5 $HOSTADDRESS$
241
242
243
244# REFRESH RATE
245# This option allows you to specify the refresh rate in seconds
246# of various CGIs (status, statusmap, extinfo, and outages). 
247
248refresh_rate=60
249
250
251
252# SOUND OPTIONS
253# These options allow you to specify an optional audio file
254# that should be played in your browser window when there are
255# problems on the network.  The audio files are used only in
256# the status CGI.  Only the sound for the most critical problem
257# will be played.  Order of importance (higher to lower) is as
258# follows: unreachable hosts, down hosts, critical services,
259# warning services, and unknown services. If there are no
260# visible problems, the sound file optionally specified by
261# 'normal_sound' variable will be played.
262#
263#
264# <varname>=<sound_file>
265#
266# Note: All audio files must be placed in the /media subdirectory
267# under the HTML path (i.e. /usr/local/nagios/share/media/).
268
269#host_unreachable_sound=hostdown.wav
270#host_down_sound=hostdown.wav
271#service_critical_sound=critical.wav
272#service_warning_sound=warning.wav
273#service_unknown_sound=warning.wav
274#normal_sound=noproblem.wav
275
Note: See TracBrowser for help on using the repository browser.