Avamar: Aktivieren Sie das NFSv4-Browsen auf einem Linux-Client, indem Sie avagent.cmd und avtar.cmd konfigurieren.

Beobachtetes Verhalten

Die NFSv4-Freigabe wurde erfolgreich auf dem Linux-Server gemountet, aber die Avamar-Benutzeroberfläche zeigt beim Durchsuchen des Dateisystems des Linux-Clients keine Dateien oder Verzeichnisse an.

Überprüfung des NFSv4-Mount auf dem Linux-Server

Der Linux-Administrator bestätigte das Mounten mit Standardbefehlen.

# 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

Mount-Details von </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

Optionale Mount-Statistiken (möglicherweise nicht verfügbar)

Die Spalte mountstats Das Dienstprogramm ist möglicherweise nicht auf der Linux-Distribution vorhanden, was zusätzliche Diagnosen einschränken kann.

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

Zusammenfassung der Symptome

• Die NFSv4-Freigabe wird angezeigt in df -h und /proc/mounts wie korrekt montiert.
• Die Avamar-Benutzeroberfläche listet beim Durchsuchen des Linux-Clients keine Dateien oder Verzeichnisse unter dem gemounteten NFSv4-Pfad auf.
• Der Linux-Administrator bestätigt, dass der Einhängepunkt auf Betriebssystemebene funktioniert.

Avtar verfügt nicht über eine native NFSv4-Browsingfunktion.

Der Avamar Client (avtar) unterstützt kein direktes Durchsuchen von NFSv4-Einhängepunkten auf Linux-Servern, es sei denn, es sind spezielle Befehlszeilen-Flags konfiguriert. Ohne diese Markierungen kann die Avamar-Benutzeroberfläche den Inhalt der NFSv4-Freigabe nicht anzeigen, obwohl die Freigabe korrekt auf dem Server gemountet ist.

• Die Standardkonfiguration des Avamar -Clients umfasst Folgendes nicht: --forcefs=nfs4 oder --browse-nfs Optionen.
• Wenn diese Optionen nicht vorhanden sind, avtar Behandelt das NFS-Mount als nicht unterstützt und unterdrückt Verzeichnisauflistungen.
• Diese Einschränkung ist unabhängig von den Exporteinstellungen des NFS-Servers oder den Mount-Optionen, die von angezeigt werden mountstats (z. B. vers=4.0, rw und hard).

Relevante Konfigurationsdateien und Speicherorte

Avtar liest Befehlszeilen-Flags aus zwei Dateien, die sich unter der /var . Die Standardpfade unterscheiden sich je nach Betriebssystem.
Wenn die Dateien avagent.cmd und avtar.cmd enthalten nicht die erforderlichen NFSv4-Flags, kann der Client den Mount-Punkt nicht durchsuchen.

Fehlende Befehlszeilen-Flags

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

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

Das Fehlen dieser Einträge ist die direkte Ursache dafür, dass die NFSv4-Freigabe in der Avamar-Benutzeroberfläche nicht angezeigt werden kann.

Betriebssystem	Standard /var Pfad
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Aktivieren Sie Avamar zum Durchsuchen von NFSv4-Mount-Punkten auf Linux-Clients.

Voraussetzungen

• Root oder sudo Zugriff auf den Avamar Linux-Client.
• Avamar Clientversion, die NFSv4 unterstützt (z. B. CentOS 7-Client).
• Zugriff auf die Avamar-Benutzeroberfläche, um den Einhängepunkt nach der Konfiguration zu überprüfen.

Schritt-für-Schritt-Anleitung

1. Erstellen Sie die Befehlsdateien, wenn sie noch nicht vorhanden sind.

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

2. Bearbeiten avagent.cmd und fügen Sie das NFSv4-Flag hinzu.

# 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. Bearbeiten avtar.cmd und fügen Sie die gleiche Markierung hinzu.

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

4. Starten Sie den Avamar Client-Agent neu, um die Änderungen zu übernehmen.

# 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. Aktualisieren Sie die Avamar-Benutzeroberfläche und durchsuchen Sie das Clientdateisystem.

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

 

Überprüfung:

• Vergewissern Sie sich, dass der NFSv4-Einhängepunkt im Dateibrowser der Avamar-UI angezeigt wird.
• Führen Sie ein Testbackup oder eine Wiederherstellung einer kleinen Datei auf der NFSv4-Freigabe aus, um sicherzustellen, dass auf die Daten zugegriffen werden kann.
• Überprüfen Sie die Spalte avagent Protokollieren Sie alle Fehler im Zusammenhang mit der NFS-Handhabung:

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

 

Zusätzliche Tools

• mountstats Überprüfung der NFS-Mount-Optionen auf dem Linux-Server
• df -h bestätigt, dass die NFS-Freigabe gemountet ist.
• Avamar-Benutzeroberfläche zum Durchsuchen und Bestätigen der Sichtbarkeit des Mount-Punkts

Manchmal kann die Firewall auf dem Linux-Server Verbindungen zwischen dem Avamar Server und dem Client selbst blockieren.

Überprüfen Sie den Status der Linux-Firewall:

systemctl status firewalld

Überprüfen Sie die iptables Liste:

iptables -L

Wenn Firewall und iptables aktiviert sind, bitten Sie den Linux-Administrator, sie zum Testen zu deaktivieren. 

Wenn das Surfen nach Firewall und iptables deaktiviert ist, dann lassen Sie den Linux-Administrator eine benutzerdefinierte Firewall erstellen und iptables Regel, um den gesamten Datenverkehr zwischen Avamar und dem Linux-Server zuzulassen.