Avamar: Aktivera NFSv4-surfning på Linux-klienten genom att konfigurera avagent.cmd och avtar.cmd

Observerat beteende

NFSv4-resursen har monterats på Linux-servern, men Avamar-användargränssnittet visar inga filer eller kataloger när du bläddrar i Linux-klientens filsystem.

Verifiering av NFSv4-montering på Linux-servern

Linux-administratören bekräftade monteringen med hjälp av standardkommandon.

# 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 från </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

Valfri monteringsstatistik (kanske inte är tillgänglig)

Informationen mountstats verktyget kanske inte finns i Linux-distributionen, vilket kan begränsa ytterligare diagnostik.

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

Symptomöversikt

• NFSv4-resursen visas i df -h och /proc/mounts som korrekt monterad.
• Avamar-användargränssnittet listar inga filer eller kataloger under den monterade NFSv4-sökvägen när du bläddrar i Linux-klienten.
• Linux-administratören bekräftar att monteringspunkten fungerar på operativsystemnivå.

Avtar saknar inbyggd NFSv4-surffunktion.

Avamar-klienten (avtar) stöder inte direkt bläddring av NFSv4-monteringspunkter på Linux-servrar om inte specifika kommandoradsflaggor har konfigurerats. Utan dessa flaggor kan Avamar-användargränssnittet inte visa innehållet på NFSv4-resursen, även om resursen är korrekt monterad på servern.

• Standardkonfigurationen för Avamar-klienten inkluderar inte --forcefs=nfs4 eller --browse-nfs Alternativ.
• När dessa alternativ saknas avtar behandlar NFS-monteringen som om den inte stöds och utelämnar kataloglistor.
• Den här begränsningen är oberoende av NFS-serverns exportinställningar eller de monteringsalternativ som visas av mountstats (t.ex. vers=4.0, rw, och hård).

Relevanta konfigurationsfiler och platser

Avtar läser kommandoradsflaggor från två filer som finns under Avamar-installationens /var katalog. Standardsökvägarna skiljer sig åt beroende på operativsystem.
Om filerna avagent.cmd och avtar.cmd inte innehåller de NFSv4-flaggor som krävs kan klienten inte bläddra i monteringspunkten.

Kommandoradsflaggor saknas

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

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

Frånvaron av dessa poster är den direkta orsaken till att det inte går att visa NFSv4-resursen i Avamar-användargränssnittet.

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

Aktivera Avamar för att bläddra bland NFSv4-monteringspunkter på Linux-klienter.

Förutsättningar

• Rot eller sudo åtkomst på Avamar Linux-klienten.
• Avamar-klientversion som stöder NFSv4 (till exempel CentOS 7-klient).
• Gå till Avamar-gränssnittet för att verifiera monteringspunkten efter konfigurationen.

Steg-för-steg-procedur

1. Skapa kommandofilerna om de inte redan finns.

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

2. Redigera avagent.cmd och lägg till NFSv4-flaggan.

# 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. Redigera avtar.cmd och lägg till samma flagga.

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

4. Starta om Avamar-klientagenten för att tillämpa ändringarna.

# 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. Uppdatera Avamar-gränssnittet och bläddra i klientens filsystem.

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

 

Verifiering

• Kontrollera att NFSv4-monteringspunkten visas i Avamar-gränssnittsfilläsaren.
• Kör en testsäkerhetskopiering eller återställning av en liten fil som finns på NFSv4-resursen för att säkerställa att data kan nås.
• Kontrollera avagent logg för eventuella fel relaterade till NFS-hantering:

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

 

Ytterligare verktyg

• mountstats verifierar NFS-monteringsalternativ på Linux-servern.
• df -h bekräftar att NFS-resursen är monterad.
• Avamar-användargränssnitt för bläddring och bekräftelse av monteringspunktens synlighet

Ibland kan brandväggen på Linux-servern blockera anslutningar mellan Avamar-servern och själva klienten.

Kontrollera status för Linux-brandväggen:

systemctl status firewalld

Verifiera iptables lista:

iptables -L

Om brandväggen och iptables är aktiverade ber du Linux-administratören att inaktivera det för testning. 

Om surfning fungerar efter brandvägg och iptables är inaktiverat och låt sedan Linux-administratören skapa en anpassad brandvägg och iptables för att tillåta all trafik mellan Avamar och Linux-servern.