From 9fdcfa49439440598acd72910d62b60c75d759a5 Mon Sep 17 00:00:00 2001 From: Michael Friedrich Date: Fri, 29 Sep 2017 10:41:01 +0200 Subject: [PATCH] Docs: Mention SELinux in Getting Started chapter refs icinga/icingaweb2#2973 refs #5632 --- doc/02-getting-started.md | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/doc/02-getting-started.md b/doc/02-getting-started.md index 2529726c3..5c4bf62e4 100644 --- a/doc/02-getting-started.md +++ b/doc/02-getting-started.md @@ -343,7 +343,7 @@ Examples: If you're stuck with configuration errors, you can manually invoke the [configuration validation](11-cli-commands.md#config-validation). -### FreeBSD +### FreeBSD On FreeBSD you need to enable icinga2 in your rc.conf @@ -351,6 +351,31 @@ On FreeBSD you need to enable icinga2 in your rc.conf # service icinga2 restart + +### SELinux + +SELinux is a mandatory access control (MAC) system on Linux which adds +a fine-grained permission system for access to all system resources such +as files, devices, networks and inter-process communication. + +Icinga 2 provides its own SELinux policy. `icinga2-selinux` is a policy package +for Red Hat Enterprise Linux 7 and derivatives. The package runs the targeted policy +which confines Icinga 2 including enabled features and running commands. + +RHEL/CentOS 7: + +``` +yum install icinga2-selinux +``` + +Fedora: + +``` +dnf install icinga2-selinux +``` + +Read more about SELinux in [this chapter](22-selinux.md#selinux). + ## Configuration Syntax Highlighting Icinga 2 ships configuration examples for syntax highlighting using the `vim` and `nano` editors. @@ -379,7 +404,7 @@ SLES/openSUSE: Alpine Linux: - # apk add icinga2-vim + # apk add icinga2-vim Ensure that syntax highlighting is enabled e.g. by editing the user's `vimrc` configuration file: