icingaweb2/doc/installation.md

100 lines
3.2 KiB
Markdown
Raw Normal View History

# 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`
### Databases
It is required to set up all used Databases correctly, which basically means to create all needed user accounts and to
create all database tables. You will find the installation guides for the different databases in the sections below:
*IMPORTANT*: Select a secure password instead of "icinga" and alter the config/authentication.ini accordingly.
#### MySQL
1. Create the user and the database
mysql -u root -p
mysql> CREATE USER `icingaweb`@`localhost` IDENTIFIED BY 'icinga';
mysql> CREATE DATABASE `icingaweb`;
mysql> GRANT ALL PRIVILEGES ON `icingaweb`.* TO `icingaweb`@`localhost`;
mysql> FLUSH PRIVILEGES;
mysql> quit
2. Create all tables (You need to be in the icinga2-web folder)
bash$ mysql -u root -p icingaweb < etc/schema/users.mysql.sql
#### PostgreSQL
1. Create the user and the database
sudo su postgres
psql
postgres=# CREATE USER icingaweb WITH PASSWORD 'icinga';
postgres=# CREATE DATABASE icingaweb;
postgres=# \q
2. Create all tables (You need to be in the icinga2-web folder)
bash$ psql -U icingaweb -a -f etc/schema/users.pgsql.sql
3. Enable trust authentication on localhost
Add the following lines to your pg_hba.conf (etc/postgresql/X.x/main/pg_hba.conf under debian, /var/lib/pgsql/data/pg_hba.conf for Redhat/Fedora)
to enable trust authentication for the icingaweb user when connecting from the localhost.
local icingaweb icingaweb trust
host icingaweb icingaweb 127.0.0.1/32 trust
host icingaweb icingaweb ::1/128 trust
And restart your databse ('service postgresql restart' or '/etc/init.d/postgresql-X.x reload')
Quick and Dirty
----------------
tdb.