Avamar : Activez la navigation NFSv4 sur le client Linux en configurant avagent.cmd et avtar.cmd

Comportement observé

Le partage NFSv4 est monté avec succès sur le serveur Linux, mais l’interface utilisateur d’Avamar n’affiche aucun fichier ou répertoire lors de la navigation dans le système de fichiers du client Linux.

Vérification du montage NFSv4 sur le serveur Linux

L’administrateur Linux a confirmé le montage à l’aide de commandes standard.

# Display mounted filesystems
$ df -h
Filesystem            Size  Used Avail Use% Mounted on
devtmpfs               5.8G     0  5.8G   0% /dev
tmpfs                  5.8G     0  5.8G   0% /dev/shm
tmpfs                  5.8G    26M 5.8G   1% /run
tmpfs                  5.8G     0  5.8G   0% /sys/fs/cgroup
/dev/sda2              47G   24G   24G  51% /
/dev/sda5              44G  241M   43G   1% /home
/dev/sda1             950M  228M  723M  24% /boot
tmpfs                 1.2G   12K  1.2G   1% /run/user/42
tmpfs                 1.2G     0  1.2G   0% /run/user/1000
x.x.x.x:/data/col1/orb 70G   48G   22G  69% /mnt/ORBSHARE
tmpfs                 1.2G     0  1.2G   0% /run/user/0

Détails du montage à partir de </proc/mounts>

# Verify NFSv4 mount entry
$ cat /proc/mounts | grep -i nfs4
x.x.x.x:/data/col1/orb /mnt/ORBSHARE nfs4 rw,relatime,vers=4.0,rsize=1048576,wsize=1048576,namlen=255,hard,proto=tcp,timeo=600,retrans=2,sec=sys,clientaddr=10.xx.xx.xx,local_lock=none,addr=x.x.x.x 0 0

Statistiques de montage facultatives (peuvent ne pas être disponibles)

La commande mountstats L’utilitaire peut ne pas être présent sur la distribution Linux, ce qui peut limiter les diagnostics supplémentaires.

# Example output when mountstats is available
$ mountstats
Stats for x.x.x.x:/data/col1/orb mounted on /mnt/ORBSHARE:
  NFS mount options: rw,vers=4.0,rsize=1048576,wsize=1048576,namlen=255,acregmin=3,acregmax=60,acdirmin=30,acdirmax=60,hard,proto=tcp,timeo=600,retrans=2,sec=sys,clientaddr=10.xx.xx.xx,local_lock=none
  NFS server capabilities: caps=0xffd7,wtmult=512,dtsize=32768,bsize=0,namlen=255
  NFSv4 capability flags: bm0=0xffffffff,bm1=0xfdfffe,bm2=0x0,acl=0x0,pnfs=notconfigured
  NFS security flavor: 1  pseudoflavor: 0
  --- more output omitted ---

Résumé des symptômes

• Le partage NFSv4 s’affiche dans df -h et /proc/mounts correctement monté.
• L’interface utilisateur d’Avamar ne répertorie aucun fichier ou répertoire sous le chemin NFSv4 monté lors de la navigation sur le client Linux.
• L’administrateur Linux confirme que le point de montage est fonctionnel au niveau du système d’exploitation.

Avtar ne dispose pas de la fonctionnalité de navigation NFSv4 native.

Le client Avamar (avtar) ne prend pas en charge la navigation directe des points de montage NFSv4 sur les serveurs Linux, sauf si des balises de ligne de commande spécifiques sont configurées. Sans ces balises, l’interface utilisateur Avamar ne peut pas afficher le contenu du partage NFSv4, même si le partage est correctement monté sur le serveur.

• La configuration par défaut du client Avamar n’inclut pas --forcefs=nfs4 ou --browse-nfs Options.
• En l’absence de ces options, avtar Traite le montage NFS comme non pris en charge et supprime les listes de répertoires.
• Cette limitation est indépendante des paramètres d’exportation du serveur NFS ou des options de montage indiquées par mountstats (tels que vers=4.0, rw et hard).

Fichiers de configuration et emplacements pertinents

Avtar lit les indicateurs de ligne de commande à partir de deux fichiers situés sous la page d’accueil de l’installation d’Avamar. /var . Les chemins par défaut varient selon le système d’exploitation.
Si les fichiers avagent.cmd et avtar.cmd ne contiennent pas les balises NFSv4 requises, le client ne peut pas parcourir le point de montage.

Balises de ligne de commande manquantes

# Expected content of avagent.cmd
--browse-nfs --forcefs=nfs4

# Expected content of avtar.cmd
--forcefs=nfs4

L’absence de ces entrées est la cause directe de l’impossibilité d’afficher le partage NFSv4 dans l’interface utilisateur Avamar.

Système d’exploitation	Default /var Chemin
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Permet à Avamar de parcourir les points de montage NFSv4 sur les clients Linux.

Configuration requise

• Root ou sudo sur le client Linux Avamar.
• Version du client Avamar qui prend en charge NFSv4 (par exemple, client CentOS 7).
• Accès à l’interface utilisateur Avamar pour vérifier le point de montage après la configuration.

Procédure étape par étape

1. Créez les fichiers de commande s’ils n’existent pas déjà.

# CentOS 7, RHEL, or similar
$ touch /usr/local/avamar/var/avagent.cmd
$ touch /usr/local/avamar/var/avtar.cmd

2. Modifier avagent.cmd et ajoutez la balise NFSv4.

# Open the file with a text editor (vi, nano, etc.)
$ vi /usr/local/avamar/var/avagent.cmd
# Insert the following line (press i to enter insert mode in vi)
--browse-nfs --forcefs=nfs4
# Save and exit (Esc, :wq!)

3. Modifier avtar.cmd et ajoutez le même drapeau.

$ vi /usr/local/avamar/var/avtar.cmd
# Insert the following line
--forcefs=nfs4
# Save and exit

4. Redémarrez l’agent client Avamar pour appliquer les modifications.

# Using the service command (compatible with most RHEL‑based systems)
$ service avagent stop
$ service avagent start

# Or a single restart command
$ service avagent restart

5. Actualisez l’interface utilisateur Avamar et parcourez le système de fichiers du client.

# In the Avamar GUI:
1. Select the affected Linux client.
2. Click “Browse Filesystem”.
3. Navigate to the NFSv4 mount point (e.g., /mnt/ORBSHARE).

 

Vérification

• Vérifiez que le point de montage NFSv4 s’affiche dans le navigateur de fichiers de l’interface utilisateur Avamar.
• Exécutez un test de sauvegarde ou de restauration d’un petit fichier situé sur le partage NFSv4 pour vous assurer que les données sont accessibles.
• Consultez le fichier avagent consigner toutes les erreurs liées à la gestion NFS :

$ tail -n 20 /usr/local/avamar/var/log/avagent.log

 

Outils supplémentaires

• mountstats vérifie les options de montage NFS sur le serveur Linux.
• df -h confirme que le partage NFS est monté.
• Interface utilisateur Avamar permettant de naviguer et de confirmer la visibilité du point de montage

Parfois, le pare-feu d’un serveur Linux peut bloquer les connexions entre le serveur Avamar et le client lui-même.

Vérifiez l’état du pare-feu Linux :

systemctl status firewalld

Vérifiez le iptables liste:

iptables -L

Si le pare-feu et iptables sont activés, demandez à l’administrateur Linux de le désactiver pour les tests. 

Si la navigation fonctionne après le pare-feu et iptables est désactivée, puis demandez à l’administrateur Linux de créer un pare-feu personnalisé et iptables règle autorisant tout le trafic entre Avamar et Linux Server.