From 83d34c787d5d6072fa10aff494edb06150896924 Mon Sep 17 00:00:00 2001 From: Michael Friedrich Date: Fri, 14 Nov 2014 00:30:39 +0100 Subject: [PATCH] RPMs: Update README.md refs #6401 --- packages/rpm/README.md | 47 +++++++++++++++++++++++++++++++----------- 1 file changed, 35 insertions(+), 12 deletions(-) diff --git a/packages/rpm/README.md b/packages/rpm/README.md index 293682a76..6daf41a63 100644 --- a/packages/rpm/README.md +++ b/packages/rpm/README.md @@ -19,21 +19,32 @@ provided by Icinga (2) Core. setenforce 0 -## Webinterface Login +## Webserver Configuration + +Can be generated using the following local icingacli command: + + /usr/share/icingaweb2/bin/icingacli setup config webserver apache + +Pipe the output into `/etc/httpd/conf.d/icingaweb2.conf` or similar, +if not already existing. + +## Setup Wizard + +Navigate to `/icingaweb/setup` and follow the on-screen instructions. -The default credentials using the internal MySQL database are -`icingaadmin:icinga` ## Support Please use one of the listed support channels at https://support.icinga.org -## Internal DB Setup +## Manual Setup + +### Internal DB Setup Decide whether to use MySQL or PostgreSQL. -### MySQL +#### MySQL mysql -u root -p CREATE USER `icingaweb`@`localhost` IDENTIFIED BY 'icingaweb'; @@ -42,9 +53,9 @@ Decide whether to use MySQL or PostgreSQL. FLUSH PRIVILEGES; quit - mysql -u root -p icingaweb < /usr/share/doc/icingaweb2*/schema/mysql.sql + mysql -u root -p icingaweb < /usr/share/doc/icingaweb2*/schema/mysql.schema..sql -### PostgreSQL +#### PostgreSQL sudo su postgres psql @@ -61,16 +72,16 @@ in `/var/lib/pgsql/data/pg_hba.conf` and restart the PostgreSQL server. Now install the `icingaweb` schema - bash$ psql -U icingaweb -a -f /usr/share/doc/icingaweb2*/schema/pgsql.sql + bash$ psql -U icingaweb -a -f /usr/share/doc/icingaweb2*/schema/pgsql.schema.sql -## Configuration +### Configuration -### Module Configuration +#### Module Configuration The monitoring module is enabled by default. -### Backend configuration +#### Backend configuration `/etc/icingaweb2/resources.ini` contains the database backend information. By default the Icinga 2 DB IDO is used by the monitoring module in @@ -80,8 +91,20 @@ The external command pipe is required for sending commands and configured for Icinga 2 in `/etc/icingaweb2/modules/monitoring/instances.ini` -### Authentication configuration +#### Authentication configuration The `/etc/icingaweb2/authentication.ini` file uses the internal database as default. This requires the database being installed properly before allowing users to login via web console. + +#### Default User + +When not using the default setup wizard, you can generate a secure password hash with openssl +and insert that manually like so: + + openssl passwd -1 "yoursecurepassword" + + mysql -uicingaweb -p icingaweb + + mysql> INSERT INTO icingaweb_user (name, active, password_hash) VALUES ('icingaadmin', 1, '$yoursecurepassword_hash'); +