Avamar: Povolte procházení NFSv4 v klientovi Linux konfigurací avagent.cmd a avtar.cmd

Pozorované chování

Sdílená složka NFSv4 je úspěšně připojena k serveru Linux, ale uživatelské rozhraní Avamar při procházení systému souborů klienta Linux nezobrazuje žádné soubory ani adresáře.

Ověření připojení NFSv4 na serveru Linux

Správce systému Linux potvrdil připojení pomocí standardních příkazů.

# 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

Podrobnosti o připojení z </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

Volitelná statistika připojení (nemusí být k dispozici)

Skript mountstats Nástroj nemusí být přítomen v distribuci Linux, což může omezit další diagnostiku.

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

Souhrn příznaků

• Sdílená složka systému NFSv4 se zobrazí v df -h a /proc/mounts jako správně namontované.
• Při procházení klienta pro systém Linux uživatelské rozhraní Avamar neuvádí žádné soubory ani adresáře v připojené cestě NFSv4.
• Správce systému Linux potvrdí, že přípojný bod je funkční na úrovni operačního systému.

Avtar postrádá nativní schopnost procházení NFSv4.

Klient Avamar (avtar) nepodporuje přímé procházení přípojných bodů NFSv4 na serverech Linux, pokud nejsou nakonfigurovány specifické příznaky příkazového řádku. Bez těchto příznaků nemůže uživatelské rozhraní Avamar zobrazit obsah sdílené složky NFSv4, i když je sdílená složka správně připojena k serveru.

• Výchozí konfigurace klienta Avamar nezahrnuje --forcefs=nfs4 nebo --browse-nfs volby.
• Pokud tyto možnosti chybí, avtar zachází s připojením NFS jako s nepodporovaným a potlačuje výpisy adresářů.
• Toto omezení je nezávislé na nastavení exportu serveru NFS nebo na možnostech připojení zobrazených mountstats (například vers=4.0, rw a hard).

Relevantní konfigurační soubory a umístění

Služba Avtar čte příznaky příkazového řádku ze dvou souborů umístěných v části /var adresáře. Výchozí cesty se liší podle operačního systému.
Pokud soubory avagent.cmd a avtar.cmd neobsahují požadované příznaky NFSv4, klient nemůže procházet přípojný bod.

Chybějící příznaky příkazového řádku

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

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

Absence těchto položek je přímou příčinou nemožnosti zobrazit sdílenou složku NFSv4 v uživatelském rozhraní Avamar.

Operační systém	Default /var Cesta
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Povolte softwaru Avamar procházet přípojné body NFSv4 v klientech se systémem Linux.

Požadavky

• Kořenový certifikát nebo sudo přístupu v klientovi Avamar Linux.
• Verze klienta Avamar, která podporuje NFSv4 (například klient CentOS 7).
• Po konfiguraci přejděte do uživatelského rozhraní Avamar a ověřte přípojný bod.

Postup krok za krokem

1. Vytvořte soubory příkazů, pokud ještě neexistují.

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

2. Úprava avagent.cmd a přidejte příznak NFSv4.

# 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. Úprava avtar.cmd a přidejte stejný příznak.

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

4. Restartujte agenta klienta Avamar, aby se změny projevily.

# 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. Aktualizujte uživatelské rozhraní Avamar a procházejte systém souborů klienta.

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

 

Ověření

• Ujistěte se, že se v prohlížeči souborů uživatelského rozhraní Avamar zobrazuje přípojný bod NFSv4.
• Spusťte testovací zálohu nebo obnovení malého souboru umístěného ve sdílené složce NFSv4, abyste zajistili přístup k datům.
• Zkontrolujte sloupec avagent zaznamenávat případné chyby související se zpracováním NFS:

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

 

Další nástroje

• mountstats ověří možnosti připojení NFS na serveru Linux.
• df -h , potvrzuje, že je sdílená složka NFS připojena.
• Uživatelské rozhraní Avamar pro procházení a potvrzení viditelnosti přípojného bodu

Někdy může brána firewall na serveru se systémem Linux blokovat připojení mezi serverem Avamar a samotným klientem.

Ověřte stav linuxové brány firewall:

systemctl status firewalld

Ověřte iptables seznam:

iptables -L

Pokud firewall a iptables jsou povoleny, požádejte správce Linuxu, aby je zakázal pro testování. 

Pokud procházení funguje po bráně firewall a iptables je zakázáno, požádejte správce systému Linux o vytvoření vlastní brány firewall a iptables Pravidlo pro povolení veškerého provozu mezi softwarem Avamar a serverem Linux.