Voici une version complète et claire de la documentation en **Markdown**, prête à être intégrée dans un wiki technique ou un dépôt Git : ````markdown # Installation et configuration de l’agent Icinga2 Cette documentatio…

Installation et configuration de l’agent Icinga2

Last updated: April 2026
Reading time: ~3 min
Audience: Boxis customers and administrators.

What you'll accomplish

Complete the configuration or task described in this guide for your Boxis service.

Prerequisites

Access to the interface, device, or server described below.
Information or credentials you received from Boxis (contract, welcome e-mail, or client area).

Note Boxis: Offers and screens may differ slightly depending on your product. When in doubt, open a support ticket with your service reference.

Voici une version complète et claire de la documentation en Markdown, prête à être intégrée dans un wiki technique ou un dépôt Git :

# Installation et configuration de l’agent Icinga2

Cette documentation explique comment installer et configurer **Icinga2** sur un serveur CentOS / RHEL 7, ainsi que la procédure pour connecter un client (agent).

---

## 1. Pré-requis

Avant de commencer, assurez-vous que :
- Vous disposez des droits **root** ou **sudo**.
- Le serveur a un accès Internet pour récupérer les paquets.
- Le port **5665/tcp** est ouvert sur le firewall pour la communication entre le serveur et les agents.

---

## 2. Installation du dépôt Icinga

Importez la clé GPG officielle d’Icinga :

```bash
rpm --import https://packages.icinga.com/icinga.key

Installez ensuite le dépôt RPM :

yum -y install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm

3. Installation d’Icinga2 et des plugins Nagios

Installez le paquet principal icinga2 :

yum -y install icinga2

Installez les plugins Nagios nécessaires aux vérifications :

yum -y install nagios-plugins-all

4. Démarrage et activation du service

Démarrez Icinga2 et activez-le pour qu’il se lance automatiquement au démarrage du système :

systemctl enable icinga2
systemctl start icinga2

Vérifiez l’état du service :

systemctl status icinga2

5. Configuration du pare-feu (facultatif)

Si un pare-feu est activé (firewalld), autorisez le port de communication d’Icinga :

firewall-cmd --permanent --add-port=5665/tcp
firewall-cmd --reload

6. Configuration du client (agent Icinga2)

Sur le client à superviser, répétez les étapes d’installation ci-dessus pour installer Icinga2 et les plugins.

Ensuite, exécutez le script d’enrôlement de l’agent fourni par le serveur Icinga. Ce script configure la connexion sécurisée entre le client et le serveur (certificats, endpoint, zone, etc.).

Par exemple :

curl -s https://monitoring.mondomaine.tld/icinga-agent-setup.sh | bash

⚠️ Remplacez l’URL ci-dessus par celle de votre propre serveur Icinga2.

7. Redémarrage du service sur le client

Après l’exécution du script agent, redémarrez le service Icinga2 sur le client :

systemctl restart icinga2

8. Vérification de la connexion

Sur le serveur, vérifiez que le client apparaît bien dans la liste des hôtes et que les checks s’exécutent correctement.

Exemples de commandes utiles :

icinga2 object list --type Host
journalctl -u icinga2 -f

9. Conclusion

L’installation de l’agent Icinga2 est maintenant terminée. Le client est connecté et prêt à être supervisé par le serveur principal.

Pour aller plus loin :

Documentation officielle : https://icinga.com/docs/icinga-2/latest/
Configuration avancée des zones et endpoints : https://icinga.com/docs/icinga-2/latest/doc/05-distributed-monitoring/

Expected result

The product behaves as described in each step (connectivity, message, or UI state).

If something goes wrong

Repeat the step and check for typos (hostnames, passwords, ports).
Note the exact error message or screenshot.
Open a ticket in the Boxis client area with the service name, time of the test, and any trace (e.g. traceroute) if it is a network issue.