Installation et configuration de l’agent Icinga2
1350 Views
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 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 :
```bash
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** :
```bash
yum -y install icinga2
```
Installez les plugins Nagios nécessaires aux vérifications :
```bash
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 :
```bash
systemctl enable icinga2
systemctl start icinga2
```
Vérifiez l’état du service :
```bash
systemctl status icinga2
```
---
## 5. Configuration du pare-feu (facultatif)
Si un pare-feu est activé (firewalld), autorisez le port de communication d’Icinga :
```bash
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 :
```bash
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 :
```bash
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 :
```bash
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/](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/](https://icinga.com/docs/icinga-2/latest/doc/05-distributed-monitoring/)