====== ZABBIX ======

== Modifié par : ==
Adekoya Esther
\\ Mukengeshayi Seth
\\ Quentin Lemoigne
\\ Axel Maquaire-Lherondel

===== Installation =====
==== Prérequis : ====
Disposer d'une machine Debian 12 avec Apache2 et Mysql/Mariadb. 
Avant l’installation on met à jour les paquet avec un “apt update”, puis “apt upgarde”.


==== Installation  ====
L'installation de Zabbix sur une machine Debian 12 est décrite ici : https://www.zabbix.com/download?zabbix=6.4&os_distribution=debian&os_version=12&components=server_frontend_agent&db=mysql&ws=apache


==== Configurer le serveur ====
Dans le fichier //**/etc/zabbix/zabbix_server.conf**//, modifier les valeurs : <code lscript>

DBName= zabbix_db   	/* =>  mettre le nom de la BDD du serveur Zabbix */
DBUser=zabbix_user        /* => mettre le compte utilisateur bd */
DBPassword= pass    	/* =>  mettre le mot de passe */
</code>
après cette étape il faudra redémarrer zabbix :
“systemctl restart zabbix-server zabbix-agent apache2”

==== Configuration côté console Zabbix ====

On peut dès à présent accéder à ZABBIX en ligne (interface web) pour finir la configuration, il nous suffit juste de taper l’adresse IP dans l'URL d'un navigateur.

**//La connexion à la base de données//**. {{ :zabbixbd.png |}}

Ensuite paramètres le serveur Zabbix et une fois cette étape terminée on pourra accéder à l'outil ZABBIX

==== Configurer un hôte ====
=== Configurer l'hôte et lui associer les modèles ===

  - //Aller dans le menu Surveillances/hôtes//  \\ Puis "créer un hôte" en haut à droite   {{ :creer-hote.png |}} 
  - Ajouter les modèles adaptés à l'équipement (selon l'OS, les services, SNMP, etc) :  \\ Dans interface choisir entre la sureveillance par l'agent ZABBIX ou par SNMP, puis entrer l'ip de la machine à superviser\\  __<wrap em>Remarque</wrap>__ : Bien penser à cliquer sur **//ajouter//** après avoir sélectionné les modèles {{ :ajout-hote.png |}}


=== Définir la communauté SNMP sur le serveur cible ===

On peut définir la communauté pour l'ensemble des équipements (en l'appliquant au modèle), ou choisir de superviser des équipements de plusieurs communautés.

Pour définir la communauté sur un modèle, dans **// Administration/Macros //**, Enter le nom de communauté dans la case valeur.
{{ :commu.png |}}

Tous les équipements supervisés par ce modèle utiliseront alors cette communauté.


Pour définir la communauté pour un équipement précis, lors de la création de l'hôtes remplacer la macro par la communauté souhaité.
{{ :commu2.png |}}



==== Configuration sur l'équipement hôte ====

=== Sous linux : ===

  - Installer l'agent Zabbix  \\ 
<code lscript>
apt install zabbix-agent
</code>

  - Configurer l'agent \\ Dans le fichier //**/etc/zabbix/zabbix_agentd.conf**//, modifier les valeurs : <code lscript>
Server= x.x.x.x    	/* =>  mettre l'IP du serveur Zabbix */
ServerActive= x.x.x.x    	/* =>  mettre l'IP du serveur Zabbix */
Hostname=xxxxxxx	/* => mettre le même nom que dans la déclaration d'hôte sur le serveur */
</code>
  - Redémarrer l'agent : <code lscript> service zabbix-agent restart </code>

=== Sous Windows : ===

-Télécharger un agent zabbix sur le site https://www.zabbix.com/fr/download_agents correspond à la version de ZABBIX.

-exécuté le fichier téléchargé 
- cliquer sur next
{{ :agent1.png |}}
-entrer l'ip de vôtre serveur ZABBIX
{{ :agent2.png |}}
- Puis installer

=== Pour un équipement matériel avec SNMP ===

- Sur un serveur faire:\\
  * installer SNMP
<code lscript>
apt install snmp
</code>
  * dans le fichier /etc/snmp/snmpd.conf y entrer les information suivante:
- rocommunity nomDeCommunaute
- sysLocation adresseQuelconque
  * Puis redémarrer le service SNMP 
<code lscript>
systemctl restart snmpd.service
</code>

- Sur matériel réseau indiquer la communauté avec la commande:
<code lscript>
snmp-server community "MyCommunity"
</code>
===== importer/exporter des templates ====

Il est possible d'exporter des templates:\\
- aller dans le menu collecte de données/modeles\\
- cochet le template à exporter\\
- puis cliquer sur exporter
{{ :export.png |}}

Il est possible de télécharger des templates sur le site officiel de zabbix ou sur des site de communauté: https://www.zabbix.com/integrations \\
- puis importer le template (en haut à doite)
{{ :import.png |}}