Avamar: Aktiver NFSv4-surfing på Linux-klienten ved å konfigurere avagent.cmd og avtar.cmd

Summary: Avamar kan ikke bla gjennom en Network File System-montering versjon 4 (NFSv4) på Linux med mindre avagent.cmd og avtar.cmd i /var-katalogen inkluderer '--browse-nfs' '--forcefs=nfs4'; start avagensen på nytt, og monteringen vises i det grafiske brukergrensesnittet (UI). ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Symptoms

Observert atferd

NFSv4-delingen er vellykket montert på Linux-serveren, men Avamar-brukergrensesnittet viser ingen filer eller kataloger når du blar gjennom Linux-klientens filsystem.

Verifisering av NFSv4-montering på Linux-serveren

Linux-administrator bekreftet monteringen ved hjelp av standardkommandoer.

# 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


Monteringsdetaljer fra </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


Valgfri monteringsstatistikk (kan være utilgjengelig)

Informasjonen i mountstats verktøyet er kanskje ikke til stede på Linux-distribusjonen, noe som kan begrense ytterligere diagnostikk.
# 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 ---


Symptomsammendrag

  • NFSv4-deling vises i df -h og /proc/mounts som riktig montert.
  • Avamar-grensesnittet viser ingen filer eller kataloger under den monterte NFSv4-banen når du surfer på Linux-klienten.
  • Linux-administratoren bekrefter at monteringspunktet fungerer på operativsystemnivå.

Cause

Avtar mangler innfødt NFSv4-nettleserfunksjon.

Avamar-klienten (avtar) støtter ikke direkte surfing på NFSv4-monteringspunkter på Linux-servere med mindre spesifikke kommandolinjeflagg er konfigurert. Uten disse flaggene kan ikke Avamar-grensesnittet vise innholdet i den delte NFSv4-ressursen, selv om den delte ressursen er riktig montert på serveren.

  • Standard Avamar-klientkonfigurasjon omfatter ikke --forcefs=nfs4 eller --browse-nfs Alternativer.
  • Når disse alternativene er fraværende, avtar behandler NFS-monteringen som ikke støttes, og skjuler katalogoppføringer.
  • Denne begrensningen er uavhengig av NFS-serverens eksportinnstillinger eller monteringsalternativene som vises av mountstats (for eksempel vers=4.0, RW og hardt).

Relevante konfigurasjonsfiler og plasseringer

Avtar leser kommandolinjeflagg fra to filer under Avamar-installasjonens /var adressebok. Standardbanene varierer etter operativsystem.
Hvis filene avagent.cmd og avtar.cmd ikke inneholder de nødvendige NFSv4-flaggene, kan klienten ikke bla gjennom monteringspunktet.


Manglende kommandolinjeflagg

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

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

Fraværet av disse oppføringene er den direkte årsaken til at NFSv4-delingen ikke kan vises i Avamar-brukergrensesnittet.

Operativsystem Standard /var Sti
Linux, AIX /usr/local/avamar/var/
HP-UX, Solaris /opt/AVMRclnt/var/

Resolution

Gjør at Avamar kan bla gjennom NFSv4-monteringspunkter på Linux-klienter.


FORSIKTIG: Endring av Avamar-kommandofiler kan påvirke alle sikkerhetskopierings- og gjenopprettingsoperasjoner på klienten. Utfør disse trinnene bare etter at du har bekreftet et gyldig vindu for sikkerhetskopiering og kontrollert at du har en gjeldende sikkerhetskopi av klientdataene.

FORSIKTIG: Feil redigering av kommandofilene kan forhindre avagent service fra start. Behold en kopi av originalfilene før du gjør endringer.

MERK: Standardplasseringen til /var Katalogen varierer etter operativsystem. Bruk banen som samsvarer med klientoperativsystemet.


Forhåndskrav

  • rot eller sudo tilgang på Avamar Linux-klienten.
  • Avamar-klientversjon som støtter NFSv4 (for eksempel CentOS 7-klient).
  • Tilgang til Avamar-brukergrensesnittet for å kontrollere monteringspunktet etter konfigurasjon.

Trinnvis prosedyre

  1. Opprett kommandofilene hvis de ikke allerede finnes.
# CentOS 7, RHEL, or similar
$ touch /usr/local/avamar/var/avagent.cmd
$ touch /usr/local/avamar/var/avtar.cmd
  1. Rediger avagent.cmd og legg til NFSv4-flagget.
# 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!)
  1. Rediger avtar.cmd og legge til samme flagg.
$ vi /usr/local/avamar/var/avtar.cmd
# Insert the following line
--forcefs=nfs4
# Save and exit
  1. Start Avamar-klientagenten på nytt for å ta i bruk endringene.
# Using the service command (compatible with most RHEL‑based systems)
$ service avagent stop
$ service avagent start

# Or a single restart command
$ service avagent restart
  1. Oppdater Avamar-brukergrensesnittet, og bla gjennom klientfilsystemet.
# 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).
 

Verifisering

  • Bekreft at NFSv4-monteringspunktet vises i Avamar UI-filleseren.
  • Kjør en testsikkerhetskopiering eller gjenoppretting av en liten fil på NFSv4-delingen for å sikre at data er tilgjengelig.
  • Sjekk ikonet avagent logge for eventuelle feil knyttet til NFS-håndtering:
$ tail -n 20 /usr/local/avamar/var/log/avagent.log
 

Tilleggsverktøy

  • mountstats bekrefter monteringsalternativer for NFS på Linux-serveren.
  • df -h bekrefter at NFS-aksjen er montert.
  • Avamar-brukergrensesnittet for visning og monteringspunktets synlighet

Additional Information

Noen ganger kan brannmuren på Linux-serveren blokkere tilkoblinger mellom Avamar-serveren og selve klienten.

Bekreft status for Linux-brannmur:
systemctl status firewalld
Kontroller at iptables liste:
iptables -L
Hvis brannmuren og iptables er aktivert, be Linux-administratoren om å deaktivere den for testing. 

Hvis surfing fungerer etter brannmur og iptables er deaktivert, må Linux-administratoren opprette en tilpasset brannmur og iptables -regelen for å tillate all trafikk mellom Avamar og Linux-serveren.

Affected Products

Avamar

Products

Avamar
Article Properties
Article Number: 000071502
Article Type: Solution
Last Modified: 22 Oct 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.