Avamar: Schakel NFSv4-browsen op de Linux-client in door avagent.cmd en avtar.cmd te configureren

Waargenomen gedrag

De NFSv4-share wordt gekoppeld aan de Linux-server, maar de Avamar UI geeft geen bestanden of mappen weer wanneer u door het bestandssysteem van de Linux-client bladert.

Verificatie van NFSv4-koppeling op de Linux-server

De Linux-administrator heeft de koppeling bevestigd met behulp van standaardopdrachten.

# 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

Montagegegevens vanaf </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

Optionele montagestatistieken (mogelijk niet beschikbaar)

De mountstats hulpprogramma is mogelijk niet aanwezig op de Linux-distributie, waardoor aanvullende diagnostiek kan worden beperkt.

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

Samenvatting van de symptomen

• NFSv4-share wordt weergegeven in df -h als /proc/mounts als correct gemonteerd.
• De Avamar UI vermeldt geen bestanden of mappen onder het gekoppelde NFSv4-pad wanneer u door de Linux-client bladert.
• De Linux-beheerder bevestigt dat het koppelpunt werkt op OS-niveau.

Avtar mist native NFSv4-browsemogelijkheden.

De Avamar-client (avtar) biedt geen ondersteuning voor direct bladeren door NFSv4-koppelpunten op Linux-servers, tenzij specifieke opdrachtregelvlaggen zijn geconfigureerd. Zonder deze vlaggen kan de Avamar UI de inhoud van de NFSv4-share niet weergeven, ook al is de share correct op de server gekoppeld.

• De standaard Avamar clientconfiguratie bevat niet de --forcefs=nfs4 of --browse-nfs Opties.
• Wanneer deze opties ontbreken, avtar behandelt de NFS-koppeling als niet-ondersteund en onderdrukt directoryvermeldingen.
• Deze beperking is onafhankelijk van de exportinstellingen van de NFS-server of de koppelingsopties die worden weergegeven door mountstats (zoals vers=4.0, rw en hard).

Relevante configuratiebestanden en -locaties

Avtar leest opdrachtregelvlaggen van twee bestanden die zich onder de /var map. De standaardpaden verschillen per besturingssysteem.
Als de bestanden avagent.cmd als avtar.cmd niet de vereiste NFSv4-vlaggen bevatten, kan de client niet door het koppelpunt bladeren.

Ontbrekende opdrachtregelvlaggen

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

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

Het ontbreken van deze vermeldingen is de directe oorzaak van het onvermogen om het NFSv4-aandeel in de Avamar UI weer te geven.

Besturingssysteem	Verstek /var Pad
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Hiermee kunt u instellen dat Avamar door NFSv4-koppelpunten kan bladeren op Linux-clients.

Vereisten

• Wortel of sudo toegang op de Avamar Linux-client.
• Avamar clientversie die NFSv4 ondersteunt (zoals CentOS 7-client).
• Toegang tot de Avamar UI om het koppelpunt na configuratie te controleren.

Stap-voor-stap procedure

1. Maak de opdrachtbestanden als ze nog niet bestaan.

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

2. Bewerken avagent.cmd en voeg de NFSv4-vlag toe.

# 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. Bewerken avtar.cmd en voeg dezelfde vlag toe.

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

4. Start de Avamar Client Agent opnieuw op om de wijzigingen toe te passen.

# 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. Vernieuw de Avamar UI en navigeer door het clientbestandssysteem.

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

 

Controle

• Controleer of het NFSv4-koppelpunt wordt weergegeven in de bestandsbrowser van de Avamar UI.
• Voer een testback-up of -herstel uit van een klein bestand op de NFSv4-share om ervoor te zorgen dat er toegang is tot de data.
• Controleer de avagent logboek voor fouten met betrekking tot NFS-afhandeling:

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

 

Extra tools

• mountstats controleert NFS-koppelingsopties op de Linux-server.
• df -h bevestigt dat de NFS-share is gekoppeld.
• Avamar UI voor bladeren en het bevestigen van de zichtbaarheid van het koppelpunt

Soms blokkeert de firewall op de Linux-server verbindingen tussen de Avamar-server en de client zelf.

Controleer de status van de Linux-firewall:

systemctl status firewalld

Controleer de iptables lijst:

iptables -L

Als firewall en iptables zijn ingeschakeld, vraagt u de Linux-beheerder om deze uit te schakelen voor het testen. 

Als browsen werkt na firewall en iptables is uitgeschakeld, laat de Linux-beheerder dan een aangepaste firewall maken en iptables regel om al het verkeer tussen Avamar en de Linux-server toe te staan.