From 546184d08a3264a6edfdef054c35016ffc442272 Mon Sep 17 00:00:00 2001
From: mtrossevin <mtrossevin+intra@evolix.fr>
Date: Tue, 5 Sep 2023 17:58:08 +0200
Subject: [PATCH] Documentation export NFS

---
 HowtoGlusterFS.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/HowtoGlusterFS.md b/HowtoGlusterFS.md
index c8c83470..8bc3c62d 100644
--- a/HowtoGlusterFS.md
+++ b/HowtoGlusterFS.md
@@ -205,3 +205,52 @@ Celui-ci surveille :
 * (si voulu, et par défaut) que le check de "Bitrot" ne retourne aucune erreur.
 
 Ce plugin a besoin de tourner en tant que `root`.
+
+## Export de volumes par NFS
+
+> Glusterd peut techniquement exporté nativement un volume par NFS mais cette fonctionnalité n'est pas compilé dans le paquet dans les dépôts Debian.
+
+> L'export par Ganesha est aussi nécessaire pour faire de la Haute Disponibilité avec NFS.
+
+L'export d'un volume GlusterFS par NFS peut se faire par [Ganesha](https://nfs-ganesha.github.io/). Pour ce faire, il faut installer les paquets `nfs-ganesha` et `nfs-ganesha-gluster` :
+
+~~~
+apt install nfs-ganesha nfs-ganesha-gluster
+~~~
+
+Il faut ensuite définir un export tel que :
+
+~~~
+EXPORT {
+    Export_Id = <nombre>; # Identifiant interne à Ganesha pour cet export, doit être un nombre entre 1 et 65535
+
+    Path = "<volume_path>"; # Chemin du volume à être exporter, peut être '/<volume_name>' par exemple
+    Pseudo = "<pseudo_path>"; # pseudo chemin pour NFSv4
+
+    Access_Type = <None|RW|RO|MDONLY|MDONLY_RO>;
+
+    FSAL {
+        Name = "GLUSTER";
+        Hostname = "<nom_de_domaine|adresse_ip>"; # Adresse du serveur glusterfs à contacté, probablement localhost
+        Volume = "<nom_du_volume_glusterfs>";
+    }
+}
+~~~
+
+et configuré ganesha pour glusterfs (fichier: `/etc/ganesha/ganesha.conf`):
+
+~~~
+NFS_Core_Param {
+    NSM_Use_Caller_Name = true;
+}
+
+%include "</chemin/vers/fichier/configurant/l'export>"
+~~~
+
+Puis redémarrer ganesha :
+
+~~~
+systemctl restart nfs-ganesha.service
+~~~
+
+L'export devrait maintenant être en place.