diff --git a/Makefile.in b/Makefile.in index 4e138a451..2eb75df8f 100644 --- a/Makefile.in +++ b/Makefile.in @@ -6,11 +6,18 @@ INSTALL=@INSTALL@ INSTALL_OPTS=@INSTALL_OPTS@ INSTALL_OPTS_WEB=@INSTALL_OPTS_WEB@ +default: + @echo "Icinga2Web make targets: " + @echo " -install: \t\t Install the application and overwrite configs" + @echo " -update: \t\t Install the application without touching the configs" + @echo " -install-apache-config: \t Install the apache configuration" + # # Installs the whole application w\o httpd configurations # install: install-static-files install-runtime-dirs +update: install-application # # Removes files created by ./configure # @@ -43,7 +50,7 @@ install-tests: copy-folder-tests # # Install configurations for apache2 # -install-apache-configs: +install-apache-config: $(INSTALL) -m 644 $(INSTALL_OPTS) "./etc/apache/icinga2web.conf" $(WWW_CONF_PATH)/icinga2web.conf; # diff --git a/doc/installation.md b/doc/installation.md new file mode 100644 index 000000000..438b3df9a --- /dev/null +++ b/doc/installation.md @@ -0,0 +1,46 @@ + +# Installation + +## configure && make + +### Basic installation + +If you like to configurea and install icinga2-web from the command line or +if you want to create packages, configure and make is the best choice for installation. + + +` +./configure && make install && make install-apache2-config +` +will install the application to the default target (/usr/local/icinga2-web). Also +an apache configuration entry is added to your apache server, so you should restart +your web server according to your systems configuration. + +### Installation directory + +If you want to install the application to a different directory, use the --prefix flag in your +configure call: +` +./configure --prefix=/my/target/directory +` + +### Authentication + +By default, icinga2-web will be installed to authenticate againts its internal database, +but you can configure it to use ldap-authentication by adding the `--with-ldap-authentication` +flag. You must provide the authentication details for your ldap server by using the --with-ldap-* flags. +To see a full list of the flags, call `./configure --help` + +### Icinga backend + +The default option for icinga2web is to configure all icinga backends with the default settings (for example +/usr/local/icinga/ as the icinga directory) but only enable statusdat. To use a different backend, +call `--with-icinga-backend=` and provide ido, livestatus or statusdat as an option. To further configure +your backend, take a look at the various options described in `./configure --help` + + + +Quick and Dirty +---------------- + +tdb.