diff --git a/doc/02-getting-started.md b/doc/02-getting-started.md index 2373c7e61e8..df2634c4808 100644 --- a/doc/02-getting-started.md +++ b/doc/02-getting-started.md @@ -13,13 +13,21 @@ First off you have to install Icinga 2. The preferred way of doing this is to use the official package repositories depending on which operating system and distribution you are running. +Official repositories ([support matrix](https://icinga.com/support/details/)): + Distribution | Repository ------------------------|--------------------------- Debian | [Icinga Repository](https://packages.icinga.com/debian/) Ubuntu | [Icinga Repository](https://packages.icinga.com/ubuntu/) + Raspbian | [Icinga Repository](https://packages.icinga.com/raspbian/) RHEL/CentOS | [Icinga Repository](https://packages.icinga.com/epel/) openSUSE | [Icinga Repository](https://packages.icinga.com/openSUSE/) SLES | [Icinga Repository](https://packages.icinga.com/SUSE/) + +Community repositories: + + Distribution | Repository + ------------------------|--------------------------- Gentoo | [Upstream](https://packages.gentoo.org/package/net-analyzer/icinga2) FreeBSD | [Upstream](https://www.freshports.org/net-mgmt/icinga2) OpenBSD | [Upstream](http://ports.su/net/icinga/core2,-main) @@ -34,13 +42,21 @@ available. Please contact your distribution packagers. You need to add the Icinga repository to your package management configuration. The following commands must be executed with `root` permissions unless noted otherwise. +#### Debian/Ubuntu/Raspbian Repositories + Debian: ``` apt-get -y install apt-transport-https wget -O - https://packages.icinga.com/icinga.key | apt-key add - -echo 'deb https://packages.icinga.com/debian icinga-stretch main' >/etc/apt/sources.list.d/icinga.list + +DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \ + echo "deb https://packages.icinga.com/debian icinga-${DIST} main" > \ + /etc/apt/sources.list.d/${DIST}-icinga.list + echo "deb-src https://packages.icinga.com/debian icinga-${DIST} main" >> \ + /etc/apt/sources.list.d/${DIST}-icinga.list + apt-get update ``` @@ -50,60 +66,50 @@ Ubuntu: apt-get -y install apt-transport-https wget -O - https://packages.icinga.com/icinga.key | apt-key add - -echo 'deb https://packages.icinga.com/ubuntu icinga-xenial main' >/etc/apt/sources.list.d/icinga.list -apt-get update -``` -RHEL/CentOS 7: +. /etc/os-release; if [ ! -z ${UBUNTU_CODENAME+x} ]; then DIST="${UBUNTU_CODENAME}"; else DIST="$(lsb_release -c| awk '{print $2}')"; fi; \ + echo "deb https://packages.icinga.com/ubuntu icinga-${DIST} main" > \ + /etc/apt/sources.list.d/${DIST}-icinga.list + echo "deb-src https://packages.icinga.com/ubuntu icinga-${DIST} main" >> \ + /etc/apt/sources.list.d/${DIST}-icinga.list -``` -yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm +apt-get update ``` -RHEL/CentOS 6: +Raspbian: ``` -yum install https://packages.icinga.com/epel/icinga-rpm-release-6-latest.noarch.rpm -``` - -Fedora 27: +apt-get -y install apt-transport-https -``` -dnf install https://packages.icinga.com/fedora/icinga-rpm-release-27-latest.noarch.rpm -``` +wget -O - https://packages.icinga.com/icinga.key | apt-key add - -Fedora 26: +DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \ + echo "deb https://packages.icinga.com/raspbian icinga-${DIST} main" > \ + /etc/apt/sources.list.d/icinga.list + echo "deb-src https://packages.icinga.com/raspbian icinga-${DIST} main" >> \ + /etc/apt/sources.list.d/icinga.list -``` -dnf install https://packages.icinga.com/fedora/icinga-rpm-release-26-latest.noarch.rpm +apt-get update ``` -SLES 12: +#### RHEL/CentOS/Fedora Repositories -``` -zypper ar https://packages.icinga.com/SUSE/ICINGA-release.repo -zypper ref -``` - -SLES 11: +RHEL/CentOS 7: ``` -zypper ar https://packages.icinga.com/SUSE/ICINGA-release-11.repo -zypper ref +yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm ``` -openSUSE: +RHEL/CentOS 6: ``` -zypper ar https://packages.icinga.com/openSUSE/ICINGA-release.repo -zypper ref +yum install https://packages.icinga.com/epel/icinga-rpm-release-6-latest.noarch.rpm ``` -Alpine Linux: +Fedora 29: ``` -echo "http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repositories -apk update +dnf install https://packages.icinga.com/fedora/icinga-rpm-release-29-latest.noarch.rpm ``` #### RHEL/CentOS EPEL Repository @@ -126,6 +132,35 @@ subscription-manager repos --enable rhel-7-server-optional-rpms subscription-manager repos --enable rhel-6-server-optional-rpms ``` +#### SLES/OpenSUSE Repositories + +SLES 15/12: + +``` +rpm --import https://packages.icinga.com/icinga.key + +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: + +``` +rpm --import https://packages.icinga.com/icinga.key + +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 @@ -136,7 +171,15 @@ as part of the [SLES 11 Security Module](https://www.suse.com/communities/conver 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 Notes +#### Alpine Linux Repositories + +Alpine Linux: + +``` +echo "http://dl-cdn.alpinelinux.org/alpine/edge/main" >> /etc/apk/repositories +echo "http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repositories +apk update +``` The example provided assumes that you are running Alpine edge, which is the -dev branch and is a rolling release. If you are using a stable version please "pin" the edge repository on the latest Icinga 2 package version. @@ -155,20 +198,20 @@ Debian/Ubuntu: apt-get install icinga2 ``` -RHEL/CentOS 6: +RHEL/CentOS 7 and Fedora: ``` yum install icinga2 -chkconfig icinga2 on -service icinga2 start +systemctl enable icinga2 +systemctl start icinga2 ``` -RHEL/CentOS 7 and Fedora: +RHEL/CentOS 6: ``` yum install icinga2 -systemctl enable icinga2 -systemctl start icinga2 +chkconfig icinga2 on +service icinga2 start ``` SLES/openSUSE: @@ -268,7 +311,7 @@ SLES/OpenSUSE | monitoring-plugins | [server:monitoring](https://build. Debian/Ubuntu | monitoring-plugins | - | /usr/lib/nagios/plugins FreeBSD | monitoring-plugins | - | /usr/local/libexec/nagios Alpine Linux | monitoring-plugins | - | /usr/lib/monitoring-plugins -OS X | nagios-plugins | [MacPorts](https://www.macports.org), [Homebrew](https://brew.sh) | /opt/local/libexec or /usr/local/sbin +macOS | monitoring-plugins | [MacPorts](https://www.macports.org), [Homebrew](https://brew.sh) | /opt/local/libexec or /usr/local/sbin The recommended way of installing these standard plugins is to use your distribution's package manager. @@ -286,9 +329,7 @@ yum install nagios-plugins-all ``` The packages for RHEL/CentOS depend on other packages which are distributed -as part of the [EPEL repository](https://fedoraproject.org/wiki/EPEL). Please -make sure to enable this repository by following -[these instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F). +as part of the [EPEL repository](#package-repositories-rhel-epel). Fedora: @@ -578,16 +619,6 @@ systemctl start mariadb mysql_secure_installation ``` -RHEL/CentOS 6: - -``` -yum install mysql-server mysql -chkconfig mysqld on -service mysqld start - -mysql_secure_installation -``` - SUSE: ``` @@ -717,15 +748,6 @@ Debian/Ubuntu: apt-get install postgresql ``` -RHEL/CentOS 6: - -``` -yum install postgresql-server postgresql -chkconfig postgresql on -service postgresql initdb -service postgresql start -``` - RHEL/CentOS 7: ``` @@ -902,14 +924,6 @@ systemctl enable httpd systemctl start httpd ``` -RHEL/CentOS 6: - -``` -yum install httpd -chkconfig httpd on -service httpd start -``` - SUSE: ```