1 #################################################################
3 # CGI.CFG - Sample CGI Configuration File for Nagios
5 #################################################################
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.
13 main_config_file=/etc/nagios3/nagios.cfg
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
22 physical_html_path=/usr/share/nagios3/htdocs
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).
34 url_html_path=/nagios3
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
48 # PENDING STATES OPTION
49 # This option determines what states should be displayed in the web
50 # interface for hosts/services that have not yet been checked.
51 # Values: 0 = leave hosts/services that have not been check yet in their original state
52 # 1 = mark hosts/services that have not been checked yet as PENDING
56 nagios_check_command=/usr/lib/nagios/plugins/check_nagios /var/cache/nagios3/status.dat 5 '/usr/sbin/nagios3'
59 # AUTHENTICATION USAGE
60 # This option controls whether or not the CGIs will use any
61 # authentication when displaying host and service information, as
62 # well as committing commands to Nagios for processing.
64 # Read the HTML documentation to learn how the authorization works!
66 # NOTE: It is a really *bad* idea to disable authorization, unless
67 # you plan on removing the command CGI (cmd.cgi)! Failure to do
68 # so will leave you wide open to kiddies messing with Nagios and
69 # possibly hitting you with a denial of service attack by filling up
70 # your drive by continuously writing to your command file!
72 # Setting this value to 0 will cause the CGIs to *not* use
73 # authentication (bad idea), while any other value will make them
74 # use the authentication functions (the default).
81 # x509 CERT AUTHENTICATION
82 # When enabled, this option allows you to use x509 cert (SSL)
83 # authentication in the CGIs. This is an advanced option and should
84 # not be enabled unless you know what you're doing.
86 use_ssl_authentication=0
92 # Setting this variable will define a default user name that can
93 # access pages without authentication. This allows people within a
94 # secure domain (i.e., behind a firewall) to see the current status
95 # without authenticating. You may want to use this to avoid basic
96 # authentication if you are not using a secure server since basic
97 # authentication transmits passwords in the clear.
99 # Important: Do not define a default username unless you are
100 # running a secure web server and are sure that everyone who has
101 # access to the CGIs has been authenticated in some manner! If you
102 # define this variable, anyone who has not authenticated to the web
103 # server will inherit all rights you assign to this user!
105 #default_user_name=guest
109 # SYSTEM/PROCESS INFORMATION ACCESS
110 # This option is a comma-delimited list of all usernames that
111 # have access to viewing the Nagios process information as
112 # provided by the Extended Information CGI (extinfo.cgi). By
113 # default, *no one* has access to this unless you choose to
114 # not use authorization. You may use an asterisk (*) to
115 # authorize any user who has authenticated to the web server.
117 authorized_for_system_information=*
121 # CONFIGURATION INFORMATION ACCESS
122 # This option is a comma-delimited list of all usernames that
123 # can view ALL configuration information (hosts, commands, etc).
124 # By default, users can only view configuration information
125 # for the hosts and services they are contacts for. You may use
126 # an asterisk (*) to authorize any user who has authenticated
129 authorized_for_configuration_information=*
133 # SYSTEM/PROCESS COMMAND ACCESS
134 # This option is a comma-delimited list of all usernames that
135 # can issue shutdown and restart commands to Nagios via the
136 # command CGI (cmd.cgi). Users in this list can also change
137 # the program mode to active or standby. By default, *no one*
138 # has access to this unless you choose to not use authorization.
139 # You may use an asterisk (*) to authorize any user who has
140 # authenticated to the web server.
142 authorized_for_system_commands=nagiosadmin
146 # GLOBAL HOST/SERVICE VIEW ACCESS
147 # These two options are comma-delimited lists of all usernames that
148 # can view information for all hosts and services that are being
149 # monitored. By default, users can only view information
150 # for hosts or services that they are contacts for (unless you
151 # you choose to not use authorization). You may use an asterisk (*)
152 # to authorize any user who has authenticated to the web server.
155 authorized_for_all_services=*
156 authorized_for_all_hosts=*
160 # GLOBAL HOST/SERVICE COMMAND ACCESS
161 # These two options are comma-delimited lists of all usernames that
162 # can issue host or service related commands via the command
163 # CGI (cmd.cgi) for all hosts and services that are being monitored.
164 # By default, users can only issue commands for hosts or services
165 # that they are contacts for (unless you you choose to not use
166 # authorization). You may use an asterisk (*) to authorize any
167 # user who has authenticated to the web server.
169 authorized_for_all_service_commands=nagiosadmin
170 authorized_for_all_host_commands=nagiosadmin
175 # STATUSMAP BACKGROUND IMAGE
176 # This option allows you to specify an image to be used as a
177 # background in the statusmap CGI. It is assumed that the image
178 # resides in the HTML images path (i.e. /usr/local/nagios/share/images).
179 # This path is automatically determined by appending "/images"
180 # to the path specified by the 'physical_html_path' directive.
181 # Note: The image file may be in GIF, PNG, JPEG, or GD2 format.
182 # However, I recommend that you convert your image to GD2 format
183 # (uncompressed), as this will cause less CPU load when the CGI
184 # generates the image.
186 #statusmap_background_image=smbackground.gd2
190 # DEFAULT STATUSMAP LAYOUT METHOD
191 # This option allows you to specify the default layout method
192 # the statusmap CGI should use for drawing hosts. If you do
193 # not use this option, the default is to use user-defined
194 # coordinates. Valid options are as follows:
195 # 0 = User-defined coordinates
200 # 5 = Circular (Marked Up)
202 default_statusmap_layout=5
206 # DEFAULT STATUSWRL LAYOUT METHOD
207 # This option allows you to specify the default layout method
208 # the statuswrl (VRML) CGI should use for drawing hosts. If you
209 # do not use this option, the default is to use user-defined
210 # coordinates. Valid options are as follows:
211 # 0 = User-defined coordinates
216 default_statuswrl_layout=4
221 # This option allows you to include your own objects in the
222 # generated VRML world. It is assumed that the file
223 # resides in the HTML path (i.e. /usr/local/nagios/share).
225 #statuswrl_include=myworld.wrl
230 # This option determines what syntax should be used when
231 # attempting to ping a host from the WAP interface (using
232 # the statuswml CGI. You must include the full path to
233 # the ping binary, along with all required options. The
234 # $HOSTADDRESS$ macro is substituted with the address of
235 # the host before the command is executed.
236 # Please note that the syntax for the ping binary is
237 # notorious for being different on virtually ever *NIX
238 # OS and distribution, so you may have to tweak this to
239 # work on your system.
241 ping_syntax=/bin/ping -n -U -c 5 $HOSTADDRESS$
246 # This option allows you to specify the refresh rate in seconds
247 # of various CGIs (status, statusmap, extinfo, and outages).
254 # This option determines whether HTML tags in host and service
255 # status output is escaped in the web interface. If enabled,
256 # your plugin output will not be able to contain clickable links.
264 # These options allow you to specify an optional audio file
265 # that should be played in your browser window when there are
266 # problems on the network. The audio files are used only in
267 # the status CGI. Only the sound for the most critical problem
268 # will be played. Order of importance (higher to lower) is as
269 # follows: unreachable hosts, down hosts, critical services,
270 # warning services, and unknown services. If there are no
271 # visible problems, the sound file optionally specified by
272 # 'normal_sound' variable will be played.
275 # <varname>=<sound_file>
277 # Note: All audio files must be placed in the /media subdirectory
278 # under the HTML path (i.e. /usr/local/nagios/share/media/).
280 #host_unreachable_sound=hostdown.wav
281 #host_down_sound=hostdown.wav
282 #service_critical_sound=critical.wav
283 #service_warning_sound=warning.wav
284 #service_unknown_sound=warning.wav
285 #normal_sound=noproblem.wav
290 # These options determine the target frames in which notes and
291 # action URLs will open.
293 action_url_target=_blank
294 notes_url_target=_blank
299 # LOCK AUTHOR NAMES OPTION
300 # This option determines whether users can change the author name
301 # when submitting comments, scheduling downtime. If disabled, the
302 # author names will be locked into their contact name, as defined in Nagios.
303 # Values: 0 = allow editing author names
304 # 1 = lock author names (disallow editing)
311 # SPLUNK INTEGRATION OPTIONS
312 # These options allow you to enable integration with Splunk
313 # in the web interface. If enabled, you'll be presented with
314 # "Splunk It" links in various places in the CGIs (log file,
315 # alert history, host/service detail, etc). Useful if you're
316 # trying to research why a particular problem occurred.
317 # For more information on Splunk, visit http://www.splunk.com/
319 # This option determines whether the Splunk integration is enabled
320 # Values: 0 = disable Splunk integration
321 # 1 = enable Splunk integration
323 #enable_splunk_integration=1
326 # This option should be the URL used to access your instance of Splunk
328 #splunk_url=http://127.0.0.1:8000/