Avamar: Aktivér NFSv4-browsing på Linux-klient ved at konfigurere avagent.cmd og avtar.cmd

Observeret adfærd

NFSv4-sharet er korrekt monteret på Linux-serveren, men Avamar-brugergrænsefladen viser ingen filer eller mapper, når du gennemser Linux-klientens filsystem.

Verificering af NFSv4-montering på Linux-serveren

Linux-administratoren bekræftede monteringen ved hjælp af 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 monteringsstatistik (fås muligvis ikke)

Ikonet mountstats hjælpeprogrammet findes muligvis ikke i Linux-distributionen, hvilket kan begrænse yderligere diagnosticering.

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

Resumé af symptomer

• NFSv4-sharet vises i df -h og /proc/mounts som korrekt monteret.
• Avamar UI viser ingen filer eller mapper under den aktiverede NFSv4-sti, når du gennemser Linux-klienten.
• Linux-administratoren bekræfter, at monteringspunktet fungerer på OS-niveau.

Avtar mangler indbygget NFSv4-browsingfunktion.

Avamar-klienten (avtar) understøtter ikke direkte browsing af NFSv4-tilslutningspunkter på Linux-servere, medmindre specifikke kommandolinjeflag er konfigureret. Uden disse flag kan Avamar-brugergrænsefladen ikke vise indholdet af NFSv4-delingen, selvom delingen er korrekt monteret på serveren.

• Avamar-standardklientkonfigurationen omfatter ikke --forcefs=nfs4 eller --browse-nfs indstillinger.
• Når disse muligheder er fraværende, avtar behandler NFS-monteringen som ikke-understøttet og undertrykker mappeoversigter.
• Denne begrænsning er uafhængig af NFS-serverens eksportindstillinger eller de tilslutningsmuligheder, der vises ved mountstats (såsom vers=4.0, RW og hårdt).

Relevante konfigurationsfiler og placeringer

Avtar læser kommandolinjeflag fra to filer, der er placeret under Avamar-installationens /var mappe. Standardstierne varierer afhængigt af operativsystemet.
Hvis filerne avagent.cmd og avtar.cmd ikke indeholder de påkrævede NFSv4-flag, kan klienten ikke gennemse monteringspunktet.

Manglende kommandolinjeflag

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

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

Fraværet af disse poster er den direkte årsag til manglende evne til at se NFSv4-sharet i Avamar-brugergrænsefladen.

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

Giv Avamar mulighed for at gennemse NFSv4-tilslutningspunkter på Linux-klienter.

Forudsætninger

• rod eller sudo adgang på Avamar Linux-klienten.
• Avamar-klientversion, der understøtter NFSv4 (f.eks. CentOS 7-klient).
• Adgang til Avamar UI for at kontrollere tilslutningspunktet efter konfiguration.

Trin-for-trin procedure

1. Opret kommandofilerne, hvis de ikke allerede findes.

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

2. Redigering avagent.cmd , og tilføj NFSv4-flaget.

# 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. Redigering avtar.cmd og tilføj det samme flag.

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

4. Genstart Avamar Client Agent for at anvende ændringerne.

# 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. Opdater Avamar-brugergrænsefladen, og gennemse 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).

 

Verifikation

• Bekræft, at NFSv4-monteringspunktet vises i Avamar UI-filbrowseren.
• Kør en testsikkerhedskopiering eller gendannelse af en lille fil, der er placeret på NFSv4-sharet, for at sikre, at der er adgang til data.
• Tjek avagent log for eventuelle fejl relateret til NFS-håndtering:

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

 

Flere værktøjer

• mountstats verificerer NFS-tilslutningsmuligheder på Linux-serveren.
• df -h bekræfter, at NFS-sharet er aktiveret.
• Avamar UI til browsing og bekræftelse af monteringspunktets synlighed

Nogle gange kan firewallen på Linux-serveren blokere forbindelser mellem Avamar-serveren og selve klienten.

Bekræft status for Linux-firewall:

systemctl status firewalld

Kontroller iptables liste:

iptables -L

Hvis firewall og iptables er aktiveret, skal du bede Linux-administratoren om at deaktivere den til test. 

Hvis browsing fungerer efter firewall og iptables er deaktiveret, så få Linux-administratoren til at oprette en brugerdefineret firewall og iptables regel om at tillade al trafik mellem Avamar og Linux-serveren.