View source for Documentation ZFS

= Guide Complet : Déploiement de MariaDB avec ZFS sur db-B-001 =
Last updated: Friday, November 28, 2025

== Introduction ==
Ce guide complet explique comment configurer MariaDB avec InnoDB sur un serveur FreeBSD utilisant ZFS pour le stockage, en montant spécifiquement les datasets ''mysql-innodb-data'' et ''mysql-innodb-logs'' en dehors du répertoire ''/var/db/mysql''.

== Prérequis ==
* Serveur FreeBSD 14.3 avec ZFS et MariaDB 10.11.15 installés
* Pool ZFS ''arcology'' opérationnel avec espace disponible
* Accès root ou sudo
* Connaissances de base en administration système et ZFS

== Architecture Cible ==
* Datasets ZFS dédiés pour les données et logs InnoDB
* Points de montage personnalisés : ''/mysql-innodb-data'' et ''/mysql-innodb-logs''
* Configuration optimisée pour les performances
* Système de sauvegarde via snapshots ZFS

== Fichiers de Configuration MariaDB ==
Sur FreeBSD avec MariaDB :
* **Fichier principal de configuration** : ''/usr/local/etc/mysql/my.cnf''
* Fichiers complémentaires :
  * ''/usr/local/etc/my.cnf'' (lien symbolique vers le fichier principal)
  * ''/usr/local/etc/mysql/conf.d/server.cnf'' (configuration spécifique)

== Étapes de Déploiement ==

=== Phase 1 : Préparation de l'Environnement ===
==== 1.1 Vérification des versions ====
<syntaxhighlight lang="bash">
mysql --version
zpool list
zfs list
</syntaxhighlight>

==== 1.2 Création des datasets ZFS ====
<syntaxhighlight lang="bash">
# Création avec points de montage personnalisés
sudo zfs create -o mountpoint=/mysql-innodb-data arcology/mysql-innodb-data
sudo zfs create -o mountpoint=/mysql-innodb-logs arcology/mysql-innodb-logs

# Configuration des propriétés
sudo zfs set recordsize=16K arcology/mysql-innodb-data
sudo zfs set recordsize=128K arcology/mysql-innodb-logs
sudo zfs set primarycache=metadata arcology/mysql-innodb-data
sudo zfs set primarycache=metadata arcology/mysql-innodb-logs
</syntaxhighlight>

=== Phase 2 : Configuration des Permissions ===
<syntaxhighlight lang="bash">
sudo chown -R mysql:mysql /mysql-innodb-data
sudo chown -R mysql:mysql /mysql-innodb-logs
sudo chmod -R 750 /mysql-innodb-data
sudo chmod -R 750 /mysql-innodb-logs
</syntaxhighlight>

=== Phase 3 : Migration des Données ===
==== 3.1 Arrêt du service MariaDB ====
<syntaxhighlight lang="bash">
sudo service mysql-server stop
</syntaxhighlight>

==== 3.2 Déplacement des fichiers ====
<syntaxhighlight lang="bash">
sudo mv /var/db/mysql/ibdata1 /mysql-innodb-data/
sudo mv /var/db/mysql/ib_logfile* /mysql-innodb-logs/
</syntaxhighlight>

==== 3.3 Création des liens symboliques ====
<syntaxhighlight lang="bash">
sudo ln -s /mysql-innodb-data/ibdata1 /var/db/mysql/ibdata1
sudo ln -s /mysql-innodb-logs/ib_logfile* /var/db/mysql/
</syntaxhighlight>

=== Phase 4 : Configuration de MariaDB ===
==== 4.1 Modification du fichier principal ====
<syntaxhighlight lang="bash">
sudo nano /usr/local/etc/mysql/my.cnf
</syntaxhighlight>

Ajouter/modifier dans le fichier principal :
<syntaxhighlight lang="ini">
[mysqld]
datadir = /var/db/mysql
innodb_data_home_dir = /mysql-innodb-data
innodb_log_group_home_dir = /mysql-innodb-logs
innodb_data_file_path = ibdata1:10M:autoextend
skip-innodb_doublewrite
</syntaxhighlight>

==== 4.2 Vérification de la configuration ====
Pour vérifier que le bon fichier est utilisé :
<syntaxhighlight lang="bash">
mysql --print-defaults
</syntaxhighlight>

==== 4.3 Structure des fichiers de configuration ====
* ''/usr/local/etc/my.cnf'' → Lien symbolique vers ''/usr/local/etc/mysql/my.cnf''
* ''/usr/local/etc/mysql/my.cnf'' → **Fichier principal de configuration**
* ''/usr/local/etc/mysql/conf.d/'' → Répertoire pour les configurations modulaires

=== Phase 5 : Optimisation ===
==== 5.1 Activation de la compression ====
<syntaxhighlight lang="bash">
sudo zfs set compression=lz4 arcology/mysql-innodb-data
sudo zfs set compression=lz4 arcology/mysql-innodb-logs
</syntaxhighlight>

==== 5.2 Autres optimisations ZFS ====
<syntaxhighlight lang="bash">
# Désactivation du cache flush si matériel approprié
sudo zfs set zfs_nocacheflush=1 arcology

# Configuration de l'ARC pour métadonnées seulement
sudo zfs set primarycache=metadata arcology
</syntaxhighlight>

=== Phase 6 : Redémarrage et Vérification ===
<syntaxhighlight lang="bash">
sudo service mysql-server start
sudo tail -n 20 /var/db/mysql/windriver.err
</syntaxhighlight>

Vérification SQL :
<syntaxhighlight lang="sql">
SHOW VARIABLES LIKE 'innodb_data_home_dir';
SHOW VARIABLES LIKE 'innodb_log_group_home_dir';
</syntaxhighlight>

=== Phase 7 : Sauvegarde et Restauration ===
==== 7.1 Création de snapshots ====
<syntaxhighlight lang="bash">
sudo zfs snapshot arcology/mysql-innodb-data@$(date +%Y%m%d)
sudo zfs snapshot arcology/mysql-innodb-logs@$(date +%Y%m%d)
</syntaxhighlight>

==== 7.2 Procédure de restauration ====
<syntaxhighlight lang="bash">
# Arrêter MariaDB avant restauration
sudo service mysql-server stop

# Restauration
sudo zfs rollback arcology/mysql-innodb-data@20231128
sudo zfs rollback arcology/mysql-innodb-logs@20231128

# Redémarrer MariaDB
sudo service mysql-server start
</syntaxhighlight>

== Bonnes Pratiques pour la Configuration ==
1. **Toujours modifier le fichier principal** : ''/usr/local/etc/mysql/my.cnf''
2. Pour des configurations spécifiques, créer des fichiers dans ''/usr/local/etc/mysql/conf.d/''
3. Vérifier la syntaxe après modification :
   <syntaxhighlight lang="bash">
   sudo mysqld --verbose --help 2>/dev/null | head
   </syntaxhighlight>
4. Après modification, toujours redémarrer le service :
   <syntaxhighlight lang="bash">
   sudo service mysql-server restart
   </syntaxhighlight>

== Résolution des Problèmes Courants ==
=== Problème : MariaDB ne démarre pas ===
* Vérifier les permissions :
  <syntaxhighlight lang="bash">
  ls -la /mysql-innodb-data
  ls -la /var/db/mysql/
  </syntaxhighlight>
* Consulter les logs :
  <syntaxhighlight lang="bash">
  sudo tail -n 50 /var/db/mysql/windriver.err
  </syntaxhighlight>
* Vérifier la syntaxe du fichier de configuration :
  <syntaxhighlight lang="bash">
  sudo mysql --print-defaults
  sudo mysqld --verbose --help 2>/dev/null | head
  </syntaxhighlight>

=== Problème : Performances dégradées ===
* Vérifier la fragmentation :
  <syntaxhighlight lang="bash">
  zfs get fragmentation arcology/mysql-innodb-data
  </syntaxhighlight>
* Surveiller l'utilisation mémoire :
  <syntaxhighlight lang="bash">
  top
  </syntaxhighlight>
* Ajuster ''recordsize'' si nécessaire (16K pour OLTP, 128K pour les logs)

== Commandes Utiles ==
{| class="wikitable"
|-
! Action
! Commande
|-
| Vérifier l'état du pool ZFS
| <syntaxhighlight lang="bash">zpool status arcology</syntaxhighlight>
|-
| Lister les datasets
| <syntaxhighlight lang="bash">zfs list -t all</syntaxhighlight>
|-
| Vérifier les points de montage
| <syntaxhighlight lang="bash">df -h | grep mysql</syntaxhighlight>
|-
| Voir les propriétés d'un dataset
| <syntaxhighlight lang="bash">zfs get all arcology/mysql-innodb-data</syntaxhighlight>
|-
| Prendre un snapshot daté
| <syntaxhighlight lang="bash">sudo zfs snapshot arcology/mysql-innodb-data@$(date +%Y%m%d_%H%M)</syntaxhighlight>
|-
| Voir les snapshots existants
| <syntaxhighlight lang="bash">zfs list -t snapshot</syntaxhighlight>
|-
| Vérifier le fichier de configuration utilisé
| <syntaxhighlight lang="bash">mysql --print-defaults</syntaxhighlight>
|-
| Vérifier la syntaxe de configuration
| <syntaxhighlight lang="bash">sudo mysqld --verbose --help 2>/dev/null | head</syntaxhighlight>
|}

== Annexes ==
=== Configuration Avancée ZFS ===
Pour les environnements de production, considérer :
<syntaxhighlight lang="bash">
# Séparation des logs ZIL sur SSD
sudo zpool add arcology log /dev/ada2

# Configuration L2ARC pour cache supplémentaire
sudo zpool add arcology cache /dev/ada3
</syntaxhighlight>

=== Exemple de Script de Sauvegarde ===
<syntaxhighlight lang="bash">
#!/bin/sh
# Sauvegarde quotidienne des datasets MariaDB
POOL="arcology"
DATE=$(date +%Y%m%d_%H%M)

# Verrouillage des tables
mysql -e "FLUSH TABLES WITH READ LOCK; SYSTEM zfs snapshot $POOL/mysql-innodb-data@db_backup_$DATE; SYSTEM zfs snapshot $POOL/mysql-innodb-logs@db_backup_$DATE; UNLOCK TABLES;"
</syntaxhighlight>

=== Vérification de la Configuration ===
Pour voir tous les paramètres actifs :
<syntaxhighlight lang="sql">
SHOW VARIABLES;
</syntaxhighlight>

Pour voir les paramètres InnoDB spécifiques :
<syntaxhighlight lang="sql">
SHOW VARIABLES LIKE 'innodb%';
</syntaxhighlight>