# Installation et configuration de Zabbix Server sur Ubuntu Server

## 1. Architecture et identifiants

### Composants

<table id="bkmrk-composant-fonction-z"><thead><tr><th>Composant</th><th>Fonction</th></tr></thead><tbody><tr><td>Zabbix Server</td><td>Collecte et traite les données de supervision</td></tr><tr><td>MySQL</td><td>Stocke la configuration et les données</td></tr><tr><td>Apache et PHP</td><td>Fournissent l’interface web</td></tr><tr><td>Zabbix Agent</td><td>Permet de superviser le serveur lui-même</td></tr></tbody></table>

Les paquets officiels Zabbix prennent en charge cette architecture avec MySQL et Apache.

### Ne pas confondre les comptes

<table id="bkmrk-compte-utilisation-c"><thead><tr><th>Compte</th><th>Utilisation</th></tr></thead><tbody><tr><td>Compte administrateur Linux / <code>root</code></td><td>Administration d’Ubuntu</td></tr><tr><td><code>root</code> MySQL</td><td>Administration de MySQL</td></tr><tr><td><code>zabbix</code> MySQL</td><td>Connexion de Zabbix à sa base</td></tr><tr><td><code>Admin</code> Zabbix</td><td>Connexion à l’interface web</td></tr></tbody></table>

Sur Ubuntu, le compte `root` MySQL utilise normalement l’authentification par socket : `sudo mysql` permet alors de se connecter sans mot de passe MySQL. Cela ne signifie pas que les mots de passe Linux et MySQL sont identiques.

Dans cette documentation, remplacez partout :

```
MOT_DE_PASSE_BDD
```

par un mot de passe fort et unique. Il devra être identique lors de la création de l’utilisateur MySQL, dans `DBPassword` et dans l’assistant web. Zabbix recommande un mot de passe unique pour son utilisateur de base de données.

Le mot de passe utilisé pendant notre échange n’est volontairement pas reproduit dans cette documentation.

## 2. Préparer Ubuntu

### Mettre à jour les paquets et installer les outils

```
sudo apt update
sudo apt upgrade -y
sudo apt install -y wget ca-certificates nano locales
```

### Configurer le fuseau horaire

```
sudo timedatectl set-timezone Europe/Paris
timedatectl
```

## 3. Installer et démarrer MySQL

```
sudo apt install -y mysql-server
sudo systemctl enable --now mysql
sudo systemctl status mysql --no-pager
```

L’état attendu est :

```
Active: active (running)
```

Ubuntu installe MySQL avec le paquet `mysql-server`. En cas de problème de démarrage, le journal du service est le premier élément à consulter.

```
sudo journalctl -u mysql -n 50 --no-pager
```

### Vérifier la connexion administrateur

```
sudo mysql
```

Vous devez obtenir l’invite :

```
mysql>
```

Pour quitter :

```
EXIT;
```

Si votre installation utilise un mot de passe pour `root` MySQL plutôt que l’authentification par socket, utilisez :

```
mysql -u root -p
```

Le mot de passe demandé est alors celui de `root` MySQL.

## 4. Installer le dépôt et les paquets Zabbix

### Ajouter le dépôt officiel Zabbix 7.4 pour Ubuntu 24.04

```
wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb

sudo dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

sudo apt update
```

Ce paquet de dépôt est spécifique à Ubuntu 24.04 et à la branche Zabbix 7.4.

### Installer les composants

```
sudo apt install -y \
  zabbix-server-mysql \
  zabbix-frontend-php \
  zabbix-apache-conf \
  zabbix-sql-scripts \
  zabbix-agent
```

Les paquets officiels permettent l’installation du serveur, de l’interface web et de l’agent avec MySQL et Apache.

Arrêtez le serveur Zabbix pendant l’initialisation de la base :

```
sudo systemctl stop zabbix-server
```

## 5. Créer la base de données

Connectez-vous à MySQL :

```
sudo mysql
```

Exécutez les commandes SQL suivantes, après avoir remplacé `MOT_DE_PASSE_BDD` :

```
CREATE DATABASE zabbix
CHARACTER SET utf8mb4
COLLATE utf8mb4_bin;

CREATE USER 'zabbix'@'localhost'
IDENTIFIED BY 'MOT_DE_PASSE_BDD';

GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';

SET GLOBAL log_bin_trust_function_creators = 1;

EXIT;
```

Zabbix recommande `utf8mb4` avec la collation `utf8mb4_bin`. L’option temporaire permet de créer les déclencheurs nécessaires à l’import lorsque la journalisation binaire est activée.

### Tester l’utilisateur Zabbix

```
mysql -u zabbix -p zabbix -e "SHOW TABLES;"
```

À l’invite :

```
Enter password:
```

entrez le mot de passe choisi pour l’utilisateur MySQL `zabbix`.

À ce stade, une base vide ne retourne aucune table. C’était la situation rencontrée pendant notre installation, avant l’import du schéma.

## 6. Importer le schéma et les données initiales

### Localiser le fichier SQL fourni par le paquet

```
dpkg -L zabbix-sql-scripts | grep '/mysql/server.sql.gz$'
```

Selon le paquet installé, le chemin peut notamment être :

```
/usr/share/zabbix-sql-scripts/mysql/server.sql.gz
```

ou :

```
/usr/share/zabbix/sql-scripts/mysql/server.sql.gz
```

Utilisez le chemin réellement affiché sur votre serveur.

### Importer la base

Pour le premier chemin :

```
zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz \
  | mysql --default-character-set=utf8mb4 -u zabbix -p zabbix
```

Pour le second :

```
zcat /usr/share/zabbix/sql-scripts/mysql/server.sql.gz \
  | mysql --default-character-set=utf8mb4 -u zabbix -p zabbix
```

Saisissez le mot de passe de l’utilisateur `zabbix`, puis attendez le retour à l’invite du terminal.

La création de la base seule ne suffit pas : Zabbix nécessite également l’import du schéma et des données initiales.

> Lancez une seule commande d’import, correspondant au fichier trouvé. Si une erreur apparaît, conservez le message et ne relancez pas aveuglément l’import sur une base partiellement remplie.

### Vérifier l’import

```
mysql -u zabbix -p zabbix -e "SELECT * FROM dbversion;"
```

Le résultat doit contenir les colonnes :

```
mandatory
optional
```

### Désactiver l’option temporaire

```
sudo mysql
```

Puis :

```
SET GLOBAL log_bin_trust_function_creators = 0;
EXIT;
```

Cette option peut être désactivée après un import réussi du schéma.

## 7. Configurer la connexion du serveur Zabbix

Sauvegardez le fichier avant modification :

```
sudo cp /etc/zabbix/zabbix_server.conf \
  /etc/zabbix/zabbix_server.conf.bak
```

Ouvrez-le :

```
sudo nano /etc/zabbix/zabbix_server.conf
```

Modifiez les paramètres existants :

```
DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=MOT_DE_PASSE_BDD
```

`DBHost` désigne l’hôte MySQL, et `DBPassword` le mot de passe de l’utilisateur de la base. Pour une base locale, `localhost` permet une connexion par socket.

### Points de vigilance

- Remplacez `MOT_DE_PASSE_BDD` par la valeur réellement choisie.
- Retirez le `#` devant les paramètres que vous activez.
- Ne placez jamais le mot de passe dans `DBHost`.
- Ne conservez pas plusieurs lignes actives pour le même paramètre.
- N’ajoutez pas de guillemets autour du mot de passe dans ce fichier.

Dans Nano :

1. `Ctrl+O` pour enregistrer.
2. Entrée pour confirmer.
3. `Ctrl+X` pour quitter.

## 8. Activer Apache et démarrer les services

### Modules Apache

```
sudo a2enmod proxy proxy_fcgi
sudo apache2ctl configtest
```

Le contrôle Apache doit indiquer :

```
Syntax OK
```

### Vérifier si PHP-FPM est utilisé

```
systemctl list-unit-files 'php*-fpm.service'
```

Ne reprenez pas automatiquement `php8.5-fpm` depuis notre échange : le service doit correspondre à la version réellement installée.

Si PHP-FPM est utilisé, redémarrez et activez le service affiché. Par exemple, uniquement si `php8.3-fpm.service` existe :

```
sudo systemctl restart php8.3-fpm
sudo systemctl enable php8.3-fpm
```

PHP-FPM, lorsqu’il est utilisé par le serveur web, constitue un service distinct à redémarrer notamment après l’ajout de locales.

### Démarrer Zabbix et Apache

```
sudo systemctl restart zabbix-server zabbix-agent apache2
sudo systemctl enable zabbix-server zabbix-agent apache2
```

### Vérifier les services

```
sudo systemctl status zabbix-server zabbix-agent apache2 --no-pager
```

Puis consulter le journal applicatif :

```
sudo tail -n 50 /var/log/zabbix/zabbix_server.log
```

Un service `active (running)` n’est pas une preuve suffisante de bon fonctionnement : pendant notre installation, le processus restait actif alors que la connexion MySQL échouait.

## 9. Terminer l’installation dans le navigateur

Ouvrez :

```
http://IP_DU_SERVEUR/zabbix
```

Avec Apache, `/zabbix` est l’URL d’accès habituelle de l’interface installée par paquets

### Paramètres de connexion à la base

<table id="bkmrk-champ-valeur-type-de"><thead><tr><th>Champ</th><th>Valeur</th></tr></thead><tbody><tr><td>Type de base de données</td><td><code>MySQL</code></td></tr><tr><td>Hôte de base de données</td><td><code>localhost</code></td></tr><tr><td>Port</td><td><code>0</code> — port par défaut</td></tr><tr><td>Nom de la base de données</td><td><code>zabbix</code></td></tr><tr><td>Stockage des identifiants</td><td><code>Texte brut</code>, pour cette installation sans coffre</td></tr><tr><td>Utilisateur</td><td><code>zabbix</code></td></tr><tr><td>Mot de passe</td><td>Le mot de passe choisi pour la base</td></tr></tbody></table>

La base doit déjà exister et son schéma doit avoir été importé avant de terminer l’assistant.

Poursuivez ensuite :

1. Vérifiez les prérequis.
2. Renseignez les paramètres de base.
3. Choisissez un nom pour le serveur.
4. Sélectionnez le fuseau horaire `Europe/Paris`.
5. Vérifiez le résumé et terminez l’installation.

### Première connexion

<table id="bkmrk-champ-valeur-initial"><thead><tr><th>Champ</th><th>Valeur initiale</th></tr></thead><tbody><tr><td>Nom d’utilisateur</td><td><code>Admin</code></td></tr><tr><td>Mot de passe</td><td><code>zabbix</code></td></tr></tbody></table>

Respectez le A majuscule dans `Admin`. Changez immédiatement le mot de passe après la première connexion. Après cinq tentatives incorrectes consécutives, l’interface applique par défaut une pause de 30 secondes.

## 10. Activer les langues française et anglaise

Si une langue apparaît grisée, vérifiez les locales du serveur web :

```
locale -a
```

Ouvrez :

```
sudo nano /etc/locale.gen
```

Activez les lignes utiles en retirant leur `#` :

```
en_GB.UTF-8 UTF-8
en_US.UTF-8 UTF-8
fr_FR.UTF-8 UTF-8
```

Générez-les :

```
sudo locale-gen
```

Redémarrez Apache :

```
sudo systemctl restart apache2
```

Si PHP-FPM est utilisé, redémarrez également son service réel, par exemple :

```
sudo systemctl restart php8.3-fpm
```

Rechargez le navigateur avec `Ctrl+F5`, puis choisissez la langue dans les paramètres du profil utilisateur. La documentation Zabbix précise que les locales UTF-8 doivent être présentes et que le serveur web ainsi que PHP-FPM doivent être redémarrés pour les prendre en compte.

## 11. Valider l’installation

### État des services

```
sudo systemctl is-active mysql zabbix-server zabbix-agent apache2
```

Chaque service doit répondre :

```
active
```

### Connexion à la base

```
mysql -u zabbix -p zabbix -e "SELECT * FROM dbversion;"
```

### Écoute du serveur Zabbix

```
sudo ss -lntp | grep ':10051'
```

Le port `10051` est le port serveur utilisé par défaut, notamment pour la communication vérifiée par l’interface web.

### Tableau de bord

Dans le widget « System information », vérifiez :

```
Zabbix server is running: Yes
```

Si l’état reste sur `No`, consultez d’abord le journal Zabbix et la connectivité entre l’interface et le serveur, plutôt que de réinstaller la base.

## 12. Dépannage : erreurs rencontrées pendant l’installation

### A. Socket MySQL introuvable

```
Can't connect to local MySQL server through socket
'/var/run/mysqld/mysqld.sock' (2)
```

Vérifiez d’abord que MySQL est installé et démarré :

```
sudo systemctl status mysql --no-pager
sudo systemctl start mysql
sudo journalctl -u mysql -n 50 --no-pager
```

Le service arrêté ou en échec peut empêcher la création du socket. Le journal MySQL permet de rechercher la cause ; ne créez pas manuellement le fichier `.sock`.

### B. Aucun mot de passe envoyé à MySQL

```
Access denied for user 'zabbix'@'localhost'
(using password: NO)
```

Si l’erreur vient d’une commande manuelle, utilisez `-p` et renseignez le mot de passe à l’invite :

```
mysql -u zabbix -p zabbix
```

Si elle vient du journal Zabbix, vérifiez que la ligne suivante existe et n’est pas commentée :

```
DBPassword=MOT_DE_PASSE_BDD
```

Puis :

```
sudo systemctl restart zabbix-server
```

Pendant notre installation, cette erreur indiquait que le serveur ne transmettait aucun mot de passe, même si la connexion de l’interface web était déjà configurée.

### C. Mot de passe placé dans le champ hôte

```
Unknown MySQL server host '...'
```

Si le texte entre guillemets correspond à votre mot de passe, corrigez :

```
DBHost=localhost
DBPassword=MOT_DE_PASSE_BDD
```

`DBHost` et `DBPassword` sont deux paramètres différents : le premier identifie le serveur MySQL, le second contient le secret de connexion.

### D. Table `dbversion` introuvable

```
Impossible de déterminer la version actuelle
de la base de données Zabbix :
la table "dbversion" est introuvable.
```

Vérifiez les tables :

```
mysql -u zabbix -p zabbix -e "SHOW TABLES;"
```

- Aucune table : importez le schéma, comme à l’étape 6.
- Des tables existent : recherchez un import partiel ou une mauvaise base sélectionnée avant toute réimportation.

La base Zabbix nécessite le schéma et les données initiales, pas uniquement un `CREATE DATABASE`.

### E. Service actif, mais interface sur `No`

```
Zabbix server is running: No
```

Exécutez :

```
sudo tail -n 60 /var/log/zabbix/zabbix_server.log
sudo ss -lntp | grep ':10051'
```

Vérifiez :

1. La connexion MySQL dans le journal.
2. Les paramètres `DBHost`, `DBName`, `DBUser` et `DBPassword`.
3. L’écoute du port serveur.
4. La destination configurée pour joindre le serveur depuis l’interface.

Le statut systemd confirme la présence du processus, pas la disponibilité complète de Zabbix.

### F. Connexion à l’interface refusée

Sur une installation neuve :

```
Utilisateur : Admin
Mot de passe : zabbix
```

N’utilisez ni le compte `root` Linux, ni `root` MySQL, ni le mot de passe de la base. Si plusieurs essais ont échoué, attendez au moins 30 secondes avant de réessayer.

## 13. Sécurité et sauvegarde

Avant une utilisation en production :

- Changez le mot de passe par défaut du compte `Admin`.
- Utilisez un mot de passe de base unique et conservez-le dans un gestionnaire de mots de passe.
- Protégez l’accès web avec HTTPS et limitez son exposition au réseau d’administration.
- Ne rendez pas MySQL accessible à distance pour cette architecture locale.
- Sauvegardez la base ainsi que les fichiers de configuration.
- Testez la restauration avant de considérer la sauvegarde comme opérationnelle.

### Exemple de sauvegarde locale

Depuis un shell administrateur, pour une installation utilisant l’authentification MySQL par socket :

```
sudo -i
install -d -m 700 /root/backups-zabbix
umask 077
```

Sauvegardez la base :

```
mysqldump \
  --single-transaction \
  --routines \
  --triggers \
  --events \
  zabbix \
  > "/root/backups-zabbix/zabbix-$(date +%F-%H%M%S).sql"
```

Sauvegardez les configurations :

```
tar -czf \
  "/root/backups-zabbix/config-$(date +%F-%H%M%S).tar.gz" \
  /etc/zabbix /etc/apache2 /etc/mysql
```

Puis quittez le shell administrateur :

```
exit
```

Si `root` MySQL utilise un mot de passe, ajoutez `-u root -p` à la commande `mysqldump`. Ubuntu documente `mysqldump` comme outil de sauvegarde logique et recommande des sauvegardes régulières de MySQL.

Les archives de configuration peuvent contenir des mots de passe : elles doivent rester protégées et une copie sécurisée doit être conservée hors du serveur.

## 14. Commandes utiles au quotidien

<table id="bkmrk-action-commande-%C3%89tat"><thead><tr><th>Action</th><th>Commande</th></tr></thead><tbody><tr><td>État du serveur</td><td><code>sudo systemctl status zabbix&#45;server &#45;&#45;no&#45;pager</code></td></tr><tr><td>Redémarrage du serveur</td><td><code>sudo systemctl restart zabbix&#45;server</code></td></tr><tr><td>Journal Zabbix en direct</td><td><code>sudo tail &#45;f &#47;var&#47;log&#47;zabbix&#47;zabbix&#95;server&#46;log</code></td></tr><tr><td>Journal MySQL</td><td><code>sudo journalctl &#45;u mysql &#45;n 50 &#45;&#45;no&#45;pager</code></td></tr><tr><td>État d’Apache</td><td><code>sudo systemctl status apache2 &#45;&#45;no&#45;pager</code></td></tr><tr><td>Validation Apache</td><td><code>sudo apache2ctl configtest</code></td></tr><tr><td>Vérification du port serveur</td><td><code>sudo ss &#45;lntp &#92;&#124; grep &#39;&#58;10051&#39;</code></td></tr><tr><td>Vérification de la base</td><td><code>mysql &#45;u zabbix &#45;p zabbix &#45;e &#34;SELECT &#42; FROM dbversion&#59;&#34;</code></td></tr></tbody></table>

Pour votre installation actuelle, les derniers points à valider sont la disparition des erreurs MySQL dans le journal, l’écoute sur le port `10051` et l’état « Zabbix server is running: Yes » dans le tableau de bord.