Skip to content

Commit

Permalink
Docs: Update supported package repos in Getting Started chapter
Browse files Browse the repository at this point in the history 
- Add Raspbian
- Link to support matrix
- Use generic source list generators for Debian/Ubuntu
- Reorder dependent repo chapters (EPEL, etc.)
- Drop el6 instructions for IDO

(cherry picked from commit 1c546a7)
  • Loading branch information
Michael Friedrich committed Mar 19, 2019
1 parent 0716189 commit 2fdc1cc
Showing 1 changed file with 85 additions and 71 deletions.
156 changes: 85 additions & 71 deletions doc/02-getting-started.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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 <a id="package-repositories-debian-ubuntu-raspbian"></a>

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
```

Expand All @@ -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 <a id="package-repositories-rhel-centos-fedora"></a>

```
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 <a id="package-repositories-rhel-epel"></a>
Expand All @@ -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 <a id="package-repositories-sles-opensuse"></a>

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 <a id="package-repositories-sles-security"></a>

The packages for SLES 11 depend on the `openssl1` package which is distributed
Expand All @@ -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 <a id="package-repositories-alpine-notes"></a>
#### Alpine Linux Repositories <a id="package-repositories-alpine"></a>

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.
Expand All @@ -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:
Expand Down Expand Up @@ -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.
Expand All @@ -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:

Expand Down Expand Up @@ -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:

```
Expand Down Expand Up @@ -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:

```
Expand Down Expand Up @@ -902,14 +924,6 @@ systemctl enable httpd
systemctl start httpd
```

RHEL/CentOS 6:

```
yum install httpd
chkconfig httpd on
service httpd start
```

SUSE:

```
Expand Down

0 comments on commit 2fdc1cc

Please sign in to comment.