You stupid, stupid thing. "Offset unknown" is *NOT* OK.
[mirror/dsa-nagios.git] / config / static / cgi.cfg
1 #############################################################################
2 ## THIS FILE IS COPIED TO THE FINAL LOCATION USING PUPPET
3 ## ITS AUTHORITATIVE HOME IS THE DSA-NAGIOS CONFIGURATION GIT
4 #############################################################################
5
6
7 #################################################################
8 #
9 # CGI.CFG - Sample CGI Configuration File for Nagios 
10 #
11 #################################################################
12
13
14 # MAIN CONFIGURATION FILE
15 # This tells the CGIs where to find your main configuration file.
16 # The CGIs will read the main and host config files for any other
17 # data they might need.
18
19 main_config_file=/etc/nagios3/nagios.cfg
20
21
22
23 # PHYSICAL HTML PATH
24 # This is the path where the HTML files for Nagios reside.  This
25 # value is used to locate the logo images needed by the statusmap
26 # and statuswrl CGIs.
27
28 physical_html_path=/usr/share/nagios3/htdocs
29
30
31
32 # URL HTML PATH
33 # This is the path portion of the URL that corresponds to the
34 # physical location of the Nagios HTML files (as defined above).
35 # This value is used by the CGIs to locate the online documentation
36 # and graphics.  If you access the Nagios pages with an URL like
37 # http://www.myhost.com/nagios, this value should be '/nagios'
38 # (without the quotes).
39
40 url_html_path=/nagios3
41
42
43
44 # CONTEXT-SENSITIVE HELP
45 # This option determines whether or not a context-sensitive
46 # help icon will be displayed for most of the CGIs.
47 # Values: 0 = disables context-sensitive help
48 #         1 = enables context-sensitive help
49
50 show_context_help=1
51
52
53
54 # PENDING STATES OPTION
55 # This option determines what states should be displayed in the web
56 # interface for hosts/services that have not yet been checked.
57 # Values: 0 = leave hosts/services that have not been check yet in their original state
58 #         1 = mark hosts/services that have not been checked yet as PENDING
59
60 use_pending_states=1
61
62 nagios_check_command=/usr/lib/nagios/plugins/check_nagios /var/cache/nagios3/status.dat 5 '/usr/sbin/nagios3'
63
64
65 # AUTHENTICATION USAGE
66 # This option controls whether or not the CGIs will use any 
67 # authentication when displaying host and service information, as
68 # well as committing commands to Nagios for processing.  
69 #
70 # Read the HTML documentation to learn how the authorization works!
71 #
72 # NOTE: It is a really *bad* idea to disable authorization, unless
73 # you plan on removing the command CGI (cmd.cgi)!  Failure to do
74 # so will leave you wide open to kiddies messing with Nagios and
75 # possibly hitting you with a denial of service attack by filling up
76 # your drive by continuously writing to your command file!
77 #
78 # Setting this value to 0 will cause the CGIs to *not* use
79 # authentication (bad idea), while any other value will make them
80 # use the authentication functions (the default).
81
82 use_authentication=1
83
84
85
86
87 # x509 CERT AUTHENTICATION
88 # When enabled, this option allows you to use x509 cert (SSL)
89 # authentication in the CGIs.  This is an advanced option and should
90 # not be enabled unless you know what you're doing.
91
92 use_ssl_authentication=0
93
94
95
96
97 # DEFAULT USER
98 # Setting this variable will define a default user name that can
99 # access pages without authentication.  This allows people within a
100 # secure domain (i.e., behind a firewall) to see the current status
101 # without authenticating.  You may want to use this to avoid basic
102 # authentication if you are not using a secure server since basic
103 # authentication transmits passwords in the clear.
104 #
105 # Important:  Do not define a default username unless you are
106 # running a secure web server and are sure that everyone who has
107 # access to the CGIs has been authenticated in some manner!  If you
108 # define this variable, anyone who has not authenticated to the web
109 # server will inherit all rights you assign to this user!
110  
111 #default_user_name=guest
112
113
114
115 # SYSTEM/PROCESS INFORMATION ACCESS
116 # This option is a comma-delimited list of all usernames that
117 # have access to viewing the Nagios process information as
118 # provided by the Extended Information CGI (extinfo.cgi).  By
119 # default, *no one* has access to this unless you choose to
120 # not use authorization.  You may use an asterisk (*) to
121 # authorize any user who has authenticated to the web server.
122
123 authorized_for_system_information=*
124
125
126
127 # CONFIGURATION INFORMATION ACCESS
128 # This option is a comma-delimited list of all usernames that
129 # can view ALL configuration information (hosts, commands, etc).
130 # By default, users can only view configuration information
131 # for the hosts and services they are contacts for. You may use
132 # an asterisk (*) to authorize any user who has authenticated
133 # to the web server.
134
135 authorized_for_configuration_information=*
136
137
138
139 # SYSTEM/PROCESS COMMAND ACCESS
140 # This option is a comma-delimited list of all usernames that
141 # can issue shutdown and restart commands to Nagios via the
142 # command CGI (cmd.cgi).  Users in this list can also change
143 # the program mode to active or standby. By default, *no one*
144 # has access to this unless you choose to not use authorization.
145 # You may use an asterisk (*) to authorize any user who has
146 # authenticated to the web server.
147
148 authorized_for_system_commands=nagiosadmin
149
150
151
152 # GLOBAL HOST/SERVICE VIEW ACCESS
153 # These two options are comma-delimited lists of all usernames that
154 # can view information for all hosts and services that are being
155 # monitored.  By default, users can only view information
156 # for hosts or services that they are contacts for (unless you
157 # you choose to not use authorization). You may use an asterisk (*)
158 # to authorize any user who has authenticated to the web server.
159
160
161 authorized_for_all_services=*
162 authorized_for_all_hosts=*
163
164
165
166 # GLOBAL HOST/SERVICE COMMAND ACCESS
167 # These two options are comma-delimited lists of all usernames that
168 # can issue host or service related commands via the command
169 # CGI (cmd.cgi) for all hosts and services that are being monitored. 
170 # By default, users can only issue commands for hosts or services 
171 # that they are contacts for (unless you you choose to not use 
172 # authorization).  You may use an asterisk (*) to authorize any
173 # user who has authenticated to the web server.
174
175 authorized_for_all_service_commands=nagiosadmin
176 authorized_for_all_host_commands=nagiosadmin
177
178
179
180
181 # STATUSMAP BACKGROUND IMAGE
182 # This option allows you to specify an image to be used as a 
183 # background in the statusmap CGI.  It is assumed that the image
184 # resides in the HTML images path (i.e. /usr/local/nagios/share/images).
185 # This path is automatically determined by appending "/images"
186 # to the path specified by the 'physical_html_path' directive.
187 # Note:  The image file may be in GIF, PNG, JPEG, or GD2 format.
188 # However, I recommend that you convert your image to GD2 format
189 # (uncompressed), as this will cause less CPU load when the CGI
190 # generates the image.
191
192 #statusmap_background_image=smbackground.gd2
193
194
195
196 # DEFAULT STATUSMAP LAYOUT METHOD
197 # This option allows you to specify the default layout method
198 # the statusmap CGI should use for drawing hosts.  If you do
199 # not use this option, the default is to use user-defined
200 # coordinates.  Valid options are as follows:
201 #       0 = User-defined coordinates
202 #       1 = Depth layers
203 #       2 = Collapsed tree
204 #       3 = Balanced tree
205 #       4 = Circular
206 #       5 = Circular (Marked Up)
207
208 default_statusmap_layout=5
209
210
211
212 # DEFAULT STATUSWRL LAYOUT METHOD
213 # This option allows you to specify the default layout method
214 # the statuswrl (VRML) CGI should use for drawing hosts.  If you
215 # do not use this option, the default is to use user-defined
216 # coordinates.  Valid options are as follows:
217 #       0 = User-defined coordinates
218 #       2 = Collapsed tree
219 #       3 = Balanced tree
220 #       4 = Circular
221
222 default_statuswrl_layout=4
223
224
225
226 # STATUSWRL INCLUDE
227 # This option allows you to include your own objects in the 
228 # generated VRML world.  It is assumed that the file
229 # resides in the HTML path (i.e. /usr/local/nagios/share).
230
231 #statuswrl_include=myworld.wrl
232
233
234
235 # PING SYNTAX
236 # This option determines what syntax should be used when
237 # attempting to ping a host from the WAP interface (using
238 # the statuswml CGI.  You must include the full path to
239 # the ping binary, along with all required options.  The
240 # $HOSTADDRESS$ macro is substituted with the address of
241 # the host before the command is executed.
242 # Please note that the syntax for the ping binary is
243 # notorious for being different on virtually ever *NIX
244 # OS and distribution, so you may have to tweak this to
245 # work on your system.
246
247 ping_syntax=/bin/ping -n -U -c 5 $HOSTADDRESS$
248
249
250
251 # REFRESH RATE
252 # This option allows you to specify the refresh rate in seconds
253 # of various CGIs (status, statusmap, extinfo, and outages).  
254
255 refresh_rate=90
256
257
258
259 # ESCAPE HTML TAGS
260 # This option determines whether HTML tags in host and service
261 # status output is escaped in the web interface.  If enabled,
262 # your plugin output will not be able to contain clickable links.
263
264 escape_html_tags=1
265
266
267
268
269 # SOUND OPTIONS
270 # These options allow you to specify an optional audio file
271 # that should be played in your browser window when there are
272 # problems on the network.  The audio files are used only in
273 # the status CGI.  Only the sound for the most critical problem
274 # will be played.  Order of importance (higher to lower) is as
275 # follows: unreachable hosts, down hosts, critical services,
276 # warning services, and unknown services. If there are no
277 # visible problems, the sound file optionally specified by
278 # 'normal_sound' variable will be played.
279 #
280 #
281 # <varname>=<sound_file>
282 #
283 # Note: All audio files must be placed in the /media subdirectory
284 # under the HTML path (i.e. /usr/local/nagios/share/media/).
285
286 #host_unreachable_sound=hostdown.wav
287 #host_down_sound=hostdown.wav
288 #service_critical_sound=critical.wav
289 #service_warning_sound=warning.wav
290 #service_unknown_sound=warning.wav
291 #normal_sound=noproblem.wav
292
293
294
295 # URL TARGET FRAMES
296 # These options determine the target frames in which notes and 
297 # action URLs will open.
298
299 action_url_target=_blank
300 notes_url_target=_blank
301
302
303
304
305 # LOCK AUTHOR NAMES OPTION
306 # This option determines whether users can change the author name 
307 # when submitting comments, scheduling downtime.  If disabled, the 
308 # author names will be locked into their contact name, as defined in Nagios.
309 # Values: 0 = allow editing author names
310 #         1 = lock author names (disallow editing)
311
312 lock_author_names=1
313
314
315
316
317 # SPLUNK INTEGRATION OPTIONS
318 # These options allow you to enable integration with Splunk
319 # in the web interface.  If enabled, you'll be presented with
320 # "Splunk It" links in various places in the CGIs (log file,
321 # alert history, host/service detail, etc).  Useful if you're
322 # trying to research why a particular problem occurred.
323 # For more information on Splunk, visit http://www.splunk.com/
324
325 # This option determines whether the Splunk integration is enabled
326 # Values: 0 = disable Splunk integration
327 #         1 = enable Splunk integration
328
329 #enable_splunk_integration=1
330
331
332 # This option should be the URL used to access your instance of Splunk
333
334 #splunk_url=http://127.0.0.1:8000/
335
336