Avamar: Abilitare l'esplorazione NFSv4 sul client Linux configurando avagent.cmd e avtar.cmd

Comportamento osservato

La condivisione NFSv4 viene montata correttamente sul server Linux, ma l'interfaccia utente di Avamar non visualizza alcun file o directory durante l'esplorazione del file system del client Linux.

Verifica del mount NFSv4 sul server Linux

L'amministratore Linux ha confermato il mount utilizzando i comandi 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

Dettagli di montaggio da </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

Statistiche di mount opzionali (potrebbero non essere disponibili)

La colonna mountstats potrebbe non essere presente sulla distribuzione Linux, il che può limitare ulteriori attività diagnostiche.

# 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 ---

Riepilogo dei sintomi

• La condivisione NFSv4 viene visualizzata in df -h e /proc/mounts correttamente montato.
• L'interfaccia utente di Avamar non elenca file o directory nel percorso NFSv4 montato durante l'esplorazione del client Linux.
• L'amministratore Linux conferma che il mount point è funzionante a livello di sistema operativo.

Avtar non dispone della funzionalità di navigazione NFSv4 nativa.

L'Avamar Client (avtar) non supporta l'esplorazione diretta dei mount point NFSv4 sui server Linux, a meno che non siano configurati flag della riga di comando specifici. Senza questi flag, l'interfaccia utente di Avamar non può visualizzare il contenuto della condivisione NFSv4, anche se la condivisione è montata correttamente sul server.

• La configurazione predefinita dell'Avamar Client non include --forcefs=nfs4 oppure --browse-nfs Opzioni.
• Quando queste opzioni sono assenti, avtar tratta il mount NFS come non supportato ed elimina gli elenchi di directory.
• Questa limitazione è indipendente dalle impostazioni di esportazione del server NFS o dalle opzioni di montaggio mostrate da mountstats (come ad esempio vers=4.0, rw e hard).

File di configurazione e percorsi pertinenti

Avtar legge i flag della riga di comando da due file situati sotto il file di installazione di Avamar /var . I percorsi predefiniti variano in base al sistema operativo.
Se i file avagent.cmd e avtar.cmd non contengono i flag NFSv4 richiesti, il client non può sfogliare il mount point.

Flag della riga di comando mancanti

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

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

L'assenza di queste voci è la causa diretta dell'impossibilità di visualizzare la condivisione NFSv4 nell'interfaccia utente di Avamar.

Sistema operativo	Default /var Sentiero
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Consentire ad Avamar di sfogliare i mount point NFSv4 sui client Linux.

Prerequisiti

• Radice o sudo accedere al client Linux Avamar.
• Versione di Avamar Client che supporta NFSv4 (ad esempio client CentOS 7).
• Accesso all'interfaccia utente di Avamar per verificare il mount point dopo la configurazione.

Procedura dettagliata

1. Creare i file di comando se non esistono già.

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

2. Modificare avagent.cmd e aggiungere il flag 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. Modificare avtar.cmd e aggiungere la stessa bandiera.

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

4. Riavviare l'agent client Avamar per applicare le modifiche.

# 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. Aggiornare l'interfaccia utente di Avamar e sfogliare il file system del 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).

 

Verifica

• Verificare che il mount point NFSv4 sia visualizzato nel file browser dell'interfaccia utente di Avamar.
• Eseguire un backup o un ripristino di prova di un file di piccole dimensioni situato sulla share NFSv4 per assicurarsi che sia possibile accedere ai dati.
• Controllare la colonna avagent Registrare eventuali errori relativi alla gestione NFS:

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

 

Strumenti aggiuntivi

• mountstats verifica le opzioni di mount NFS sul server Linux.
• df -h conferma che la condivisione NFS è montata.
• Interfaccia utente di Avamar per l'esplorazione e la conferma della visibilità del mount point

A volte il firewall sul server Linux può bloccare le connessioni tra l'Avamar Server e il client stesso.

Verificare lo stato del firewall Linux:

systemctl status firewalld

Verificare il iptables lista:

iptables -L

Se firewall e iptables sono abilitati, chiedere all'amministratore Linux di disabilitarlo per il test. 

Se la navigazione funziona dopo il firewall e iptables è disabilitato, quindi chiedere all'amministratore Linux di creare un firewall personalizzato e iptables per consentire tutto il traffico tra Avamar e Linux Server.