{"id":445,"date":"2024-09-30T14:49:28","date_gmt":"2024-09-30T12:49:28","guid":{"rendered":"https:\/\/whoami.lausitz-event.info\/?p=445"},"modified":"2025-07-31T08:38:36","modified_gmt":"2025-07-31T06:38:36","slug":"icinga2-debian-12-installation","status":"publish","type":"post","link":"https:\/\/whoami.lausitz-event.info\/?p=445","title":{"rendered":"Icinga2 Debian 12 Installation"},"content":{"rendered":"

Installation Icinga per Hand<\/h2>\n\n

Vorbereitung der DB<\/h3>\n\n
apt install mariadb-server -y\nmysql_secure_installation<\/code><\/pre>\n\n
!!! danger \"Wichtig\"\nBei der Frage, ob f\u00fcr root die Unix Authentifizierung aktiviert werden soll, unbedingt y f\u00fcr Ja eingeben.<\/p>\n\n
mysql<\/code><\/pre>\n\n
-- Erstellen der Icinga-DB\ncreate database icingadb ;\ncreate user 'icingadb'@'localhost' identified by 'icingadb';\ngrant all privileges on icingadb.* to 'icingadb'@'localhost';\n\n-- Erstellen der Icinga-WebDB\ncreate database icingaweb2;\ncreate user 'icingaweb2'@'localhost' identified by 'icingaweb2';\ngrant all privileges on icingaweb2.* to 'icingaweb2'@'localhost';\n\n-- Privilegien neu laden und beenden\nflush privileges;\nexit;<\/code><\/pre>\n\n
Repo installieren<\/h3>\n\n
apt update\napt -y install apt-transport-https wget gnupg\n\nwget -O - https:\/\/packages.icinga.com\/icinga.key | gpg --dearmor -o \/usr\/share\/keyrings\/icinga-archive-keyring.gpg\n\nDIST=$(awk -F\"[)(]+\" '\/VERSION=\/ {print $2}' \/etc\/os-release); \\\n echo \"deb [signed-by=\/usr\/share\/keyrings\/icinga-archive-keyring.gpg] https:\/\/packages.icinga.com\/debian icinga-${DIST} main\" > \\\n \/etc\/apt\/sources.list.d\/${DIST}-icinga.list\n echo \"deb-src [signed-by=\/usr\/share\/keyrings\/icinga-archive-keyring.gpg] https:\/\/packages.icinga.com\/debian icinga-${DIST} main\" >> \\\n \/etc\/apt\/sources.list.d\/${DIST}-icinga.list\n\napt update\n\napt install icinga2 -y<\/code><\/pre>\n\n
!!! info \"Validierung der Konfiguration\"\nAn dieser Stelle (und auch sp\u00e4ter) kann die Konfiguration gepr\u00fcft werden.<\/p>\n\n
    icinga2 daemon -C<\/code><\/pre>\n\n
Installation der Standard Plugins<\/h3>\n\n
apt install monitoring-plugins -y<\/code><\/pre>\n\n
Aktivierung der API<\/h3>\n\n
icinga2 api setup<\/code><\/pre>\n\n
Danach Neustart von icinga<\/p>\n\n
systemctl restart icinga2<\/code><\/pre>\n\n
Aufsetzen von ICINGA-DB<\/h3>\n\n
!!! info\nDas ist ein neueres Feature, soll die Last von der bisherigen IDO-DB nehmen.<\/p>\n\n
Installation Redis-Package und Start des Dienstes<\/h4>\n\n
apt install icingadb-redis -y\n# systemctl enable --now icingadb-redis # Offenbar hat sich der Name ge\u00e4ndert daher ...\nsystemctl enable --now icingadb-redis-server<\/code><\/pre>\n\n
Aktivieren des ICINGA-DB-Features<\/h4>\n\n
icinga2 feature enable icingadb\nicinga2 feature list\nsystemctl restart icinga2.service<\/code><\/pre>\n\n
Installieren des ICINGA-DB Daemons<\/h4>\n\n
!!! info\nDer ICINGA-DB-Daemon<\/code>  synchronisiert die Monitoring-Daten zwischen <\/code>REDIS<\/code><\/code> und Datenbank.<\/p>\n\n
Paket installieren<\/h5>\n\n
apt install icingadb -y<\/code><\/pre>\n\n
Einrichtung<\/h5>\n\n
Zuerst Datenbank und Nutzer einrichten (siehe SQL am Anfang).<\/p>\n\n
Danach das Schema laden.<\/p>\n\n
mysql -u root icingadb <\/usr\/share\/icingadb\/schema\/mysql\/schema.sql<\/code><\/pre>\n\n
Anpassung der Konfiguration \/etc\/icingadb\/config.yml<\/code><\/code><\/p>\n\n
database:\n  type: mysql\n  host: localhost\n  database: icingadb\n  user: icingadb\n  password: xxxxxxxxxxx\nredis:\n  host: localhost\n  port: 6380\nlogging:\n  options:\nretention:\n  history-days: 180\n  sla-days: 180\n  options:<\/code><\/pre>\n\n
Zum Abschluss Start des Dienstes<\/p>\n\n
systemctl enable --now icingadb<\/code><\/pre>\n\n
Installation DB WEB<\/h4>\n\n
!!! warning\nDie vorherige Installation von php-fpm<\/code> ist wichtig, da sonst bei der Installation von <\/code>icingadb-web<\/code><\/code> auch\nphp<\/code> installiert wird, welches auch <\/code>apache2<\/code><\/code> als Abh\u00e4ngigkeit mit bringt.<\/p>\n\n
apt install php-fpm nginx -y\napt install icingadb-web -y<\/code><\/pre>\n\n\n\n
Installation Icinga Web<\/h3>\n\n
Erstellen einer Nginx Konfigurationsdatei<\/h4>\n\n
icingacli setup config webserver nginx --document-root \/usr\/share\/icingaweb2\/public > \/etc\/nginx\/conf.d\/icinga.conf<\/code><\/pre>\n\n
Jetzt noch default Config von nginx l\u00f6schen:<\/p>\n\n
rm -rf \/etc\/nginx\/sites-enabled\/default<\/code><\/p>\n\n
Die Datei ist noch zu folgendem Stand anzupassen:<\/p>\n\n
server {\n  listen *:80 default_server;\n  server_name _;\n\n  # nagvis inkl. php\n  location \/nagvis {\n    alias \/usr\/share\/nagvis\/share;\n    location ~ \\.php$ {\n      include snippets\/fastcgi-php.conf;\n      fastcgi_param SCRIPT_FILENAME $request_filename;\n      fastcgi_pass unix:\/run\/php\/php-fpm.sock;\n    }\n  }\n\n  ### INSTALLER START\n  location ~ ^\/icingaweb2\/index\\.php(.*)$ {\n    #fastcgi_pass 127.0.0.1:9000;\n    fastcgi_pass unix:\/run\/php\/php-fpm.sock ;\n    fastcgi_index index.php;\n    include fastcgi_params;\n    fastcgi_param SCRIPT_FILENAME \/usr\/share\/icingaweb2\/public\/index.php;\n    fastcgi_param ICINGAWEB_CONFIGDIR \/etc\/icingaweb2;\n    fastcgi_param REMOTE_USER $remote_user;\n  }\n\n  location ~ ^\/icingaweb2(.+)? {\n    alias \/usr\/share\/icingaweb2\/public;\n    index index.php;\n    try_files $1 $uri $uri\/ \/icingaweb2\/index.php$is_args$args;\n  }\n  ###INSTALLER END\n}<\/code><\/pre>\n\n
Neustart Nginx<\/p>\n\n
systemctl restart nginx<\/code><\/pre>\n\n
Erstellung des Setup-Token<\/h4>\n\n
Den Token in einen Texteditor kopieren. Dieser wird dann sp\u00e4ter w\u00e4hrend der Einrichtung in der Weboberfl\u00e4che ben\u00f6tigt.<\/p>\n\n
icingacli setup token create\nicingacli setup token show<\/code><\/pre>\n\n
Erstellen der DB<\/h4>\n\n
Siehe sql am Anfang<\/p>\n\n
Webinstaller<\/h4>\n\n
Vorab das Log-Verzeichnis anlegen<\/p>\n\n
chown www-data \/var\/log\/icingaweb2\/<\/code><\/pre>\n\n
apt install php-imagick -y<\/code><\/pre>\n\n