diff --git a/doc/02-Installation.md b/doc/02-Installation.md index 79c3cf850..ea2bd2720 100644 --- a/doc/02-Installation.md +++ b/doc/02-Installation.md @@ -13,25 +13,12 @@ thoroughly. * PHP >= 5.3.0 w/ gettext, intl, mbstring and OpenSSL support * Default time zone configured for PHP in the php.ini file * LDAP PHP library when using Active Directory or LDAP for authentication -* Icinga 1.x w/ IDO; Icinga 2.x w/ IDO feature enabled +* Icinga 2.x w/ IDO feature enabled or Icinga 1.x w/ IDO * The IDO table prefix must be icinga_ which is the default * MySQL or PostgreSQL PHP libraries * cURL PHP library when using the Icinga 2 API for transmitting external commands -### PageSpeed Module Incompatibility -It seems that Web 2 is not compatible with the PageSpeed module. Please disable the PageSpeed module using one of the -following methods. - -**Apache**: -``` -ModPagespeedDisallow "*/icingaweb2/*" -``` - -**Nginx**: -``` -pagespeed Disallow "*/icingaweb2/*"; -``` ## Installing Icinga Web 2 from Package @@ -61,12 +48,12 @@ Below is a list with **examples** for various distributions. **Debian Jessie**: ``` wget -O - http://packages.icinga.com/icinga.key | apt-key add - -echo 'deb http://packages.icinga.com/debian icinga-jessie main' >/etc/apt/sources.list.d/icinga.list +echo 'deb http://packages.icinga.com/debian icinga-stretch main' >/etc/apt/sources.list.d/icinga.list apt-get update ``` > INFO > -> For other Debian versions just replace jessie with your distribution's code name. +> For other Debian versions just replace `stretch` with your distribution's code name. **Ubuntu Xenial**: ``` @@ -78,18 +65,14 @@ apt-get update > > For other Ubuntu versions just replace xenial with your distribution's code name. -**RHEL and CentOS**: +**RHEL and CentOS 7**: ``` -rpm --import http://packages.icinga.com/icinga.key -curl -o /etc/yum.repos.d/ICINGA-release.repo http://packages.icinga.com/epel/ICINGA-release.repo -yum makecache +yum install https://packages.icinga.com/epel/7/release/noarch/icinga-rpm-release-7-2.el7.centos.noarch.rpm ``` -**Fedora**: +**Fedora 25**: ``` -rpm --import http://packages.icinga.com/icinga.key -curl -o /etc/yum.repos.d/ICINGA-release.repo http://packages.icinga.com/fedora/ICINGA-release.repo -yum makecache +dnf install https://packages.icinga.com/fedora/25/release/noarch/icinga-rpm-release-25-1.fc25.noarch.rpm ``` **SLES 11**: @@ -120,10 +103,16 @@ apk update > Latest version of Icinga Web 2 is in the edge repository, which is the -dev branch. #### RHEL/CentOS Notes +The packages for RHEL/CentOS depend on other packages which are distributed +as part of the [EPEL repository](https://fedoraproject.org/wiki/EPEL). -The packages for RHEL/CentOS depend on other packages which are distributed as part of the -[EPEL repository](http://fedoraproject.org/wiki/EPEL). Please make sure to enable this repository by following -[these instructions](http://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). +CentOS 7/6: +``` +yum install epel-release +``` + +If you are using RHEL you need enable the `optional` repository and then install +the [EPEL rpm package](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). > Please note that installing Icinga Web 2 on **RHEL/CentOS 5** is not supported due to EOL versions of PHP and PostgreSQL. @@ -484,6 +473,24 @@ password = "api" Finally visit Icinga Web 2 in your browser to login as `icingaadmin` user: `/icingaweb2`. +## Troubleshooting + +### PageSpeed Module Incompatibility + +It seems that Web 2 is not compatible with the PageSpeed module. Please disable the PageSpeed module using one of the +following methods. + +**Apache**: +``` +ModPagespeedDisallow "*/icingaweb2/*" +``` + +**Nginx**: +``` +pagespeed Disallow "*/icingaweb2/*"; +``` + + ## Automating the Installation of Icinga Web 2 If you are automating the installation of Icinga Web 2, you may want to skip the wizard and do things yourself.