From: Michael Friedrich Date: Tue, 9 Apr 2019 12:08:39 +0000 (+0200) Subject: Docs: Update installation for 2.11; remove EOL distributions X-Git-Tag: v2.11.0-rc1~158^2 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=478f087a3aee1c70b96d69b4e0b4ebb9b985e032;p=icinga2 Docs: Update installation for 2.11; remove EOL distributions --- diff --git a/doc/02-getting-started.md b/doc/02-getting-started.md index 1ea7c5c15..d532351ca 100644 --- a/doc/02-getting-started.md +++ b/doc/02-getting-started.md @@ -37,6 +37,11 @@ Community repositories: Packages for distributions other than the ones listed above may also be available. Please contact your distribution packagers. +> **Note** +> +> Windows is only supported for agent installations. Please refer +> to the [distributed monitoring chapter](06-distributed-monitoring.md#distributed-monitoring-setup-client-windows). + ### Package Repositories You need to add the Icinga repository to your package management configuration. @@ -47,7 +52,8 @@ The following commands must be executed with `root` permissions unless noted oth Debian: ``` -apt-get -y install apt-transport-https +apt-get update +apt-get -y install apt-transport-https wget gnupg wget -O - https://packages.icinga.com/icinga.key | apt-key add - @@ -63,7 +69,8 @@ apt-get update Ubuntu: ``` -apt-get -y install apt-transport-https +apt-get update +apt-get -y install apt-transport-https wget gnupg wget -O - https://packages.icinga.com/icinga.key | apt-key add - @@ -79,7 +86,8 @@ apt-get update Raspbian: ``` -apt-get -y install apt-transport-https +apt-get update +apt-get -y install apt-transport-https wget gnupg wget -O - https://packages.icinga.com/icinga.key | apt-key add - @@ -92,6 +100,22 @@ DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \ apt-get update ``` +##### Debian Backports Repository + +> **Note**: +> +> This repository is required since v2.11. + +Debian Stretch: + +``` +DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \ + echo "deb https://deb.debian.org/debian ${DIST}-backports main" > \ + /etc/apt/sources.list.d/${DIST}-backports.list + +apt-get update +``` + #### RHEL/CentOS/Fedora Repositories RHEL/CentOS 7: @@ -100,7 +124,7 @@ RHEL/CentOS 7: yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm ``` -RHEL/CentOS 6: +RHEL/CentOS 6 x64: ``` yum install https://packages.icinga.com/epel/icinga-rpm-release-6-latest.noarch.rpm @@ -112,7 +136,7 @@ Fedora 29: dnf install https://packages.icinga.com/fedora/icinga-rpm-release-29-latest.noarch.rpm ``` -#### RHEL/CentOS EPEL Repository +##### RHEL/CentOS EPEL Repository The packages for RHEL/CentOS depend on other packages which are distributed as part of the [EPEL repository](https://fedoraproject.org/wiki/EPEL). @@ -134,6 +158,9 @@ subscription-manager repos --enable rhel-6-server-optional-rpms #### SLES/OpenSUSE Repositories +The release repository also provides the required Boost 1.66+ packages +since v2.11. + SLES 15/12: ``` @@ -143,15 +170,6 @@ zypper ar https://packages.icinga.com/SUSE/ICINGA-release.repo zypper ref ``` -SLES 11: - -``` -rpm --import https://packages.icinga.com/icinga.key - -zypper ar https://packages.icinga.com/SUSE/ICINGA-release-11.repo -zypper ref -``` - openSUSE: ``` @@ -161,16 +179,6 @@ zypper ar https://packages.icinga.com/openSUSE/ICINGA-release.repo zypper ref ``` -#### SLES Security Repository - -The packages for SLES 11 depend on the `openssl1` package which is distributed -as part of the [SLES 11 Security Module](https://www.suse.com/communities/conversations/introducing-the-suse-linux-enterprise-11-security-module/). - -#### SLES 12 SDK - -Icinga 2 requires the `libboost_chrono1_54_0` package from the `SLES 12 SDK` repository. Refer to the SUSE Enterprise -Linux documentation for further information. - #### Alpine Linux Repositories Alpine Linux: diff --git a/doc/15-troubleshooting.md b/doc/15-troubleshooting.md index 7c62d3bb4..a11a5c54d 100644 --- a/doc/15-troubleshooting.md +++ b/doc/15-troubleshooting.md @@ -861,8 +861,6 @@ Fetch the `ca.crt` file from the client node and compare it to your master's `ca # diff -ur /var/lib/icinga2/certs/ca.crt test-client-ca.crt ``` -On SLES11 you'll need to use the `openssl1` command instead of `openssl`. - diff --git a/doc/16-upgrading-icinga-2.md b/doc/16-upgrading-icinga-2.md index 222f3c341..7ae6db20f 100644 --- a/doc/16-upgrading-icinga-2.md +++ b/doc/16-upgrading-icinga-2.md @@ -9,7 +9,13 @@ follow the instructions for v2.7 too. ## Upgrading to v2.11 -### Package Dependencies +### Packages + +EOL distributions where no packages are available with this release: + +* SLES 11 +* Ubuntu 14 LTS +* RHEL/CentOS 6 x86 #### Added: Boost 1.66+ @@ -19,7 +25,12 @@ details, please continue reading in [this issue](https://github.com/Icinga/icing The package dependencies have been updated for RPM/DEB already. On platforms where EPEL or Backports cannot satisfy this dependency, -we provide Boost as package on our [package repository](https://packages.icinga.com). +we provide Boost as package on our [package repository](https://packages.icinga.com): + +* SLES 12 (this replaces the SDK requirement) +* CentOS 6 x64 +* Debian Jessie +* Ubuntu Xenial/Bionic After upgrade, you may remove the old Boost packages (1.53 or anything above) if you don't need them anymore. diff --git a/doc/19-technical-concepts.md b/doc/19-technical-concepts.md index 7c040ae36..062e04948 100644 --- a/doc/19-technical-concepts.md +++ b/doc/19-technical-concepts.md @@ -913,7 +913,7 @@ below have been collected too. [This thread](https://www.reddit.com/r/cpp/commen also sheds more light in modern programming techniques. Our main "problem" with Icinga 2 are modern compilers supporting the full C++11 feature set. -Recent analysis have proven that gcc on CentOS 6 or SLES11 are too old to use modern +Recent analysis have proven that gcc on CentOS 6 are too old to use modern programming techniques or anything which implemens C++14 at least. Given the below projects, we are also not fans of wrapping C interfaces into