Avamar: Włącz przeglądanie NFSv4 na kliencie Linux, konfigurując avagent.cmd i avtar.cmd

Zaobserwowane zachowanie

Udział NFSv4 został pomyślnie zamontowany na serwerze Linux, ale interfejs użytkownika Avamar nie wyświetla żadnych plików ani katalogów podczas przeglądania systemu plików klienta Linux.

Weryfikacja zamontowania NFSv4 na serwerze Linux

Administrator Linuksa potwierdził zamontowanie za pomocą standardowych poleceń.

# 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

Szczegóły montażu od </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

Opcjonalne statystyki montowania (mogą być niedostępne)

Polecenie mountstats narzędzie może nie być obecne w dystrybucji systemu Linux, co może ograniczyć dodatkową diagnostykę.

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

Podsumowanie objawów

• Udział NFSv4 pojawia się w df -h i /proc/mounts prawidłowo zamontowany.
• Interfejs użytkownika Avamar nie wyświetla żadnych plików ani katalogów w ramach zamontowanej ścieżki NFSv4 podczas przeglądania klienta Linux.
• Administrator systemu Linux potwierdza, że punkt montowania działa na poziomie systemu operacyjnego.

Avtar nie ma natywnej możliwości przeglądania NFSv4.

Klient Avamar (avtar) nie obsługuje bezpośredniego przeglądania punktów montowania NFSv4 na serwerach Linux, chyba że skonfigurowano określone flagi wiersza poleceń. Bez tych flag interfejs użytkownika Avamar nie może wyświetlić zawartości udziału NFSv4, nawet jeśli udział jest prawidłowo zamontowany na serwerze.

• Domyślna konfiguracja klienta Avamar nie obejmuje --forcefs=nfs4 lub --browse-nfs Opcje.
• Gdy te opcje są nieobecne, avtar traktuje montowanie NFS jako nieobsługiwane i pomija listy katalogów.
• Ograniczenie to jest niezależne od ustawień eksportu serwera NFS lub opcji montowania pokazanych przez mountstats (np. vers=4.0, rw i twardy).

Odpowiednie pliki konfiguracyjne i lokalizacje

Avtar odczytuje flagi wiersza poleceń z dwóch plików znajdujących się w katalogu instalacji Avamar /var . Domyślne ścieżki różnią się w zależności od systemu operacyjnego.
Jeśli pliki avagent.cmd i avtar.cmd nie zawierają wymaganych flag NFSv4, klient nie może przeglądać punktu montowania.

Brak flag wiersza poleceń

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

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

Brak tych wpisów jest bezpośrednią przyczyną braku możliwości wyświetlenia udziału NFSv4 w interfejsie użytkownika Avamar.

System operacyjny	Domyślny /var Ścieżka
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Włącz Avamar w celu przeglądania punktów montowania NFSv4 na klientach z systemem Linux.

Wymagania wstępne

• Korzeń lub sudo dostęp na kliencie Avamar Linux.
• Wersja klienta Avamar obsługująca protokół NFSv4 (np. klient CentOS 7).
• Dostęp do interfejsu użytkownika Avamar w celu weryfikacji punktu montowania po konfiguracji.

Procedura krok po kroku

1. Utwórz pliki poleceń, jeśli jeszcze nie istnieją.

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

2. Edycja avagent.cmd i dodaj flagę 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. Edycja avtar.cmd i dodaj tę samą flagę.

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

4. Uruchom ponownie agenta klienta Avamar, aby zastosować zmiany.

# 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. Odśwież interfejs użytkownika Avamar i przejdź do systemu plików 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).

 

Weryfikacja

• Upewnij się, że punkt montowania NFSv4 jest widoczny w przeglądarce plików interfejsu użytkownika Avamar.
• Uruchamianie testowej kopii zapasowej lub przywracanie małego pliku znajdującego się w udziale NFSv4, aby zapewnić dostęp do danych.
• Sprawdź kolumnę avagent rejestr dla wszelkich błędów związanych z obsługą NFS:

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

 

Inne narzędzia

• mountstats weryfikacja opcji montowania NFS na serwerze Linux.
• df -h Potwierdza, że udział NFS jest zamontowany.
• Interfejs użytkownika Avamar do przeglądania i potwierdzania widoczności punktu montowania

Czasami zapora na serwerze Linux może blokować połączenia między serwerem Avamar a samym klientem.

Sprawdź stan zapory systemu Linux:

systemctl status firewalld

Sprawdź, czy parametr iptables lista:

iptables -L

Jeśli zapora i iptables są włączone, poproś administratora Linuksa o wyłączenie go do testowania. 

Jeśli przeglądanie działa po zaporze sieciowej i iptables jest wyłączony, poproś administratora systemu Linux o utworzenie niestandardowej zapory i iptables reguła zezwalająca na cały ruch między Avamarem a serwerem Linux.