From 8e64c0b239a226213de0c0643d4a9657a3fb0efd Mon Sep 17 00:00:00 2001 From: Eric Lippmann Date: Wed, 29 Jun 2022 10:08:45 +0200 Subject: [PATCH] Update docs (#4838) --- doc/02-Installation.md | 34 +++++++++++++++++++++++----------- 1 file changed, 23 insertions(+), 11 deletions(-) diff --git a/doc/02-Installation.md b/doc/02-Installation.md index 5f75e4d6a..fcd91cb84 100644 --- a/doc/02-Installation.md +++ b/doc/02-Installation.md @@ -32,12 +32,15 @@ thoroughly. ## Installation Requirements -* [Icinga 2](https://icinga.com/products/icinga-2/) with the IDO database backend (MySQL or PostgreSQL) +* [Icinga 2](https://icinga.com/docs/icinga-2) and [Icinga DB](https://icinga.com/docs/icinga-db) to + monitor your infrastructure * A web server, e.g. Apache or Nginx -* PHP version >= 7.2 +* PHP version ≥ 7.2 ### Optional Requirements -* For exports to PDF also the following PHP modules are required: mbstring, GD, Imagick + +* The [pdfexport](https://github.com/Icinga/icingaweb2-module-pdfexport) module (≥0.10) is required for the + export to PDF * LDAP PHP library when using Active Directory or LDAP for authentication ## Add Icinga Package Repository @@ -281,9 +284,16 @@ yum install icingaweb2 icingacli ## Install the Web Server -Make sure you have a web server with PHP up and running before moving on. -Please refer to the [installation requirements](#installation-requirements) for details about supported versions. -Depending on your OS you might have to install, and configure the web server separately. +Ensure that you have a web server with PHP installed before proceeding, +such as Apache or Nginx with PHP version ≥ 7.2. Depending on your operating system, +you may need to install and configure the web server separately. +An Apache configuration file to serve Icinga Web is already installed. +If you want to use Nginx, you must manually create a configuration file using the following command. +Save the output as a new file in the web server configuration directory: + +```bash +icingacli setup config webserver nginx --document-root /usr/share/icingaweb2/public +``` ## Prepare Web Setup @@ -381,13 +391,15 @@ mv icingaweb2-2.9.5 icingaweb2 You will need to install certain dependencies depending on your setup: -* [Icinga 2](https://icinga.com/products/icinga-2/) with the IDO database backend (MySQL or PostgreSQL) +* [Icinga 2](https://github.com/Icinga/icinga2) and [Icinga DB](https://github.com/Icinga/icingadb) to + monitor your infrastructure * A web server, e.g. Apache or Nginx -* PHP version >= 7.2 -* [Icinga PHP Library (ipl)](https://github.com/Icinga/icinga-php-library) (>= 0.9) -* [Icinga PHP Thirdparty](https://github.com/Icinga/icinga-php-thirdparty) (>= 0.11) +* PHP version ≥ 7.2 +* [Icinga PHP Library (ipl)](https://github.com/Icinga/icinga-php-library) (≥ 0.9) +* [Icinga PHP Thirdparty](https://github.com/Icinga/icinga-php-thirdparty) (≥ 0.11) * The following PHP modules must be installed: cURL, json, gettext, fileinfo, intl, dom, OpenSSL and xml -* For exports to PDF also the following PHP modules are required: mbstring, GD, Imagick +* The [pdfexport](https://github.com/Icinga/icingaweb2-module-pdfexport) module (≥0.10) is required for the + export to PDF * LDAP PHP library when using Active Directory or LDAP for authentication * MySQL or PostgreSQL PHP libraries