Avamar. Включите просмотр NFSv4 на клиенте Linux, настроив avagent.cmd и avtar.cmd

Наблюдаемое поведение

Общий ресурс NFSv4 успешно смонтирован на сервере Linux, но пользовательский интерфейс Avamar не отображает файлы или каталоги при просмотре файловой системы клиента 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

Дополнительная статистика монтирования (может быть недоступна)

Переменная mountstats Утилита может отсутствовать в дистрибутиве Linux, что может ограничить возможность дополнительной диагностики.

# 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 не отображает файлы или каталоги в смонтированном пути NFSv4 при просмотре клиента Linux.
• Администратор Linux подтверждает, что точка монтирования работает на уровне ОС.

В Avtar отсутствует встроенная поддержка просмотра веб-страниц по NFSv4.

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

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

Соответствующие файлы конфигурации и их расположение

Avtar считывает флаги командной строки из двух файлов, расположенных в папке /var . Пути по умолчанию различаются в зависимости от операционной системы.
Если файлы avagent.cmd и avtar.cmd не содержат требуемых флагов NFSv4, клиент не может перейти к точке монтирования.

Отсутствующие флаги командной строки

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

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

Отсутствие этих записей является непосредственной причиной невозможности просмотра общего ресурса NFSv4 в пользовательском интерфейсе Avamar.

Операционная система	Default /var Путь
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Разрешите Avamar просматривать точки монтирования NFSv4 на клиентах Linux.

Предварительные условия

• Root или sudo на клиенте 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 и перейдите к клиентской файловой системе.

# 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.
• Выполните тестовое резервное копирование или восстановление небольшого файла, расположенного в сетевой папке NFSv4, чтобы обеспечить доступ к данным.
• Проверьте файл avagent Запишите в журнал любые ошибки, связанные с обработкой NFS:

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

 

Дополнительные инструменты

• mountstats проверяет параметры монтирования NFS на сервере Linux.
• df -h Подтверждает, что сетевая папка NFS смонтирована.
• Пользовательский интерфейс Avamar для просмотра и подтверждения видимости точки монтирования

Иногда межсетевой экран на сервере Linux может блокировать соединения между Avamar Server и клиентом.

Проверьте состояние межсетевого экрана Linux:

systemctl status firewalld

Убедитесь, что iptables список:

iptables -L

Если межсетевой экран и iptables включены, попросите администратора Linux отключить его для тестирования. 

Если просмотр веб-страниц работает после брандмауэра и iptables отключено, то администратор Linux создаст пользовательский брандмауэр и iptables , чтобы разрешить весь трафик между Avamar и сервером Linux.