Авамар: Увімкніть перегляд NFSv4 у клієнті Linux, налаштувавши avagent.cmd та avtar.cmd

Спостережувана поведінка

Спільний ресурс NFSv4 успішно монтується на сервері Linux, але інтерфейс Avamar UI не відображає жодних файлів або каталогів під час перегляду файлової системи клієнта Linux.

Перевірка монтування NFSv4 на сервері Linux

Адміністратор Linux підтвердив монтування за допомогою стандартних команд.

# 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

Деталі монтування з </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

Необов'язкова статистика монтування (може бути недоступною)

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

Короткий опис симптомів

• Спільний ресурс NFSv4 відображається у форматі df -h і /proc/mounts як правильно змонтований.
• Avamar UI не відображає жодних файлів або каталогів під змонтованим шляхом NFSv4 під час перегляду клієнта Linux.
• Адміністратор Linux підтверджує, що точка монтування працює на рівні ОС.

Avtar не має вбудованої можливості перегляду NFSv4.

Клієнт Avamar (avtar) не підтримує прямий перегляд точок монтування NFSv4 на серверах Linux, якщо не налаштовано конкретні прапорці командного рядка. Без цих прапорців інтерфейс Avamar UI не може відображати вміст спільного ресурсу NFSv4, навіть якщо спільний ресурс правильно змонтовано на сервері.

• Конфігурація клієнта Avamar за замовчуванням не включає --forcefs=nfs4 або --browse-nfs Параметри.
• Коли ці опції відсутні, avtar розглядає монтування NFS як непідтримуване і пригнічує списки каталогів.
• Це обмеження не залежить від параметрів експорту сервера NFS або параметрів монтування, які відображаються за допомогою mountstats (наприклад, vers=4.0, rw і жорсткий).

Відповідні конфігураційні файли та розташування

Avtar зчитує прапорці командного рядка з двох файлів, розташованих під інсталяцією Avamar /var Каталог. Шляхи за замовчуванням відрізняються залежно від операційної системи.
Якщо файли avagent.cmd і avtar.cmd не містять потрібних прапорців NFSv4, клієнт не може переглядати точку монтування.

Відсутні прапорці командного рядка

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

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

Відсутність цих записів є прямою причиною неможливості перегляду шари NFSv4 в інтерфейсі Avamar.

Увімкніть Avamar для перегляду точок монтування NFSv4 на клієнтах Linux.

Передумови

• Корінь або sudo доступ на клієнті Avamar Linux.
• Версія клієнта Avamar, яка підтримує NFSv4 (наприклад, клієнт CentOS 7).
• Доступ до інтерфейсу Avamar для перевірки точки монтування після налаштування.

Покрокова процедура

1. Створіть командні файли, якщо їх ще не існує.

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

2. Редагувати avagent.cmd і додайте прапорець 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. Редагувати avtar.cmd і додати той самий прапорець.

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

4. Перезапустіть клієнтський агент Avamar, щоб застосувати зміни.

# 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. Оновіть інтерфейс Avamar UI та перегляньте файлову систему клієнта.

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

Верифікація

• Переконайтеся, що точка монтування NFSv4 відображається в браузері файлів Avamar UI.
• Запустіть тестове резервне копіювання або відновлення невеликого файлу, розташованого на спільному ресурсі NFSv4, щоб забезпечити доступ до даних.
• Перевірте avagent зареєструвати будь-які помилки, пов'язані з обробкою NFS:

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

Додаткові інструменти

• mountstats перевіряє параметри монтування NFS на сервері Linux.
• df -h підтверджує, що спільний ресурс NFS змонтовано.
• Avamar UI для перегляду та підтвердження видимості точки монтування

systemctl status firewalld

iptables -L