]> granicus.if.org Git - icinga2/blobdiff - doc/icinga2.8
Update 08-advanced-topics.md
[icinga2] / doc / icinga2.8
index 9d03201707c187a8cfec6c0bd07811d49b2deaf7..81fd9dba84373228f5d0b696b0c4bfa56f0610c5 100644 (file)
@@ -1,57 +1,98 @@
-.TH ICINGA2 "1" "November 2014" "icinga2 - The Icinga 2 network monitoring daemon" "System Administration Utilities"
+.TH ICINGA2 "8" "October 2015" "icinga2 - The Icinga 2 network monitoring daemon"
 .SH NAME
-icinga2 \- manual page for icinga2 - The Icinga 2 network monitoring daemon
-.SH DESCRIPTION
 icinga2 \- The Icinga 2 network monitoring daemon
-.SS "Usage:"
-.IP
-icinga2 daemon [<arguments>]
-.PP
-Starts Icinga 2.
-.SS "Global options:"
+
+.SH SYNOPSIS
+.B icinga2
+.I command
+[
+.I command options
+][
+.I global options
+]
+
+.I command
+:= [
+.B api | console | daemon | feature | node | object | pki | repository | troubleshoot | variable
+]
+.B --help
+
+.SH DESCRIPTION
+
+Icinga 2 is an open source monitoring system which checks the availability of your network resources, notifies users of outages, and generates performance data for reporting.
+
+Scalable and extensible, Icinga 2 can monitor large, complex environments across multiple locations.
+
+.SH OPTIONS
+Details for specific command options can be viewed by invoking the command name with
+.B --help
+parameter.
+
+.SS Global options
+.TP
+.B -h,--help
+Show this help message.
+.TP
+.B -V,--version
+Show version information.
 .TP
-\fB\-h\fR [ \fB\-\-help\fR ]
-show this help message
+.B --color
+Use VT100 color codes even when stdout is not a terminal.
 .TP
-\fB\-V\fR [ \fB\-\-version\fR ]
-show version information
+.BI "-D, --define" " arg"
+Define a constant.
 .TP
-\fB\-\-color\fR
-use VT100 color codes even when stdout is not a terminal
+.BI "-l, --library" " arg"
+Load a library.
 .TP
-\fB\-D\fR [ \fB\-\-define\fR ] arg
-define a constant
+.BI "-I, --include" " arg"
+Add include search directory.
 .TP
-\fB\-l\fR [ \fB\-\-library\fR ] arg
-load a library
+.BI "-x, --log-level" " [ debug | notice | information | warning | critical ]"
+Specify the log level for the console log, default is
+.B information.
 .TP
-\fB\-I\fR [ \fB\-\-include\fR ] arg
-add include search directory
-.HP
-\fB\-x\fR [ \fB\-\-log\-level\fR ] arg
-specify the log level for the console log
-.SS "Command options:"
+.BI "-X, --script-debugger"
+Enables the script debugger. When an exception occurs or the 'debugger' keyword
+is encountered in a user script Icinga 2 launches the script debugger that
+allows the user to debug the script.
+
+.SS daemon options
+The CLI command daemon provides the functionality to start/stop Icinga 2.
+Furthermore it provides the configuration validation.
+
 .TP
-\fB\-c\fR [ \fB\-\-config\fR ] arg
-parse a configuration file
+.BI "-c, --config" " arg"
+Using this option you can specify one or more configuration files.
+Config files are processed in the order they are specified on the command-line.
+
+When no configuration file is specified and the
+.B --no-config
+is not used, Icinga 2 automatically falls back to using the configuration file
+.B SysconfDir + "/icinga2/icinga2.conf"
+(where SysconfDir is usually
+.BI "/etc" ")."
+
 .TP
-\fB\-z\fR [ \fB\-\-no\-config\fR ]
-start without a configuration file
+.B "-z, --noconfig"
+Start without a configuration file.
 .TP
-\fB\-C\fR [ \fB\-\-validate\fR ]
-exit after validating the configuration
+.B "-C, --validate"
+This option can be used to check if your configuration files contain errors.
+If any errors are found the exit status is 1, otherwise 0 is returned.
 .TP
-\fB\-e\fR [ \fB\-\-errorlog\fR ] arg log fatal errors to the specified log file (only works
-in combination with \fB\-\-daemonize\fR)
+.BI "-e, --errorlog" " arg"
+Log fatal errors to the specified log file (only works in combination with
+.BR "--daemonize" ")."
 .TP
-\fB\-d\fR [ \fB\-\-daemonize\fR ]
-detach from the controlling terminal
+.B "-d, --daemonize"
+Detach from the controlling terminal.
 .SH "REPORTING BUGS"
-Report bugs at <https://dev.icinga.org/>
+Report bugs at <https://github.com/Icinga/icinga2>
 .br
-Icinga home page: <http://www.icinga.org/>
+Icinga home page: <https://www.icinga.com/>
 .SH COPYRIGHT
-Copyright \(co 2012\-2014 Icinga Development Team (http://www.icinga.org)
+Copyright \(co 2012\-2014 Icinga Development Team (https://www.icinga.com)
 License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl2.html>
 .br
 This is free software: you are free to change and redistribute it.