Avamar：通过配置 avagent.cmd 和 avtar.cmd在 Linux 客户端上启用 NFSv4 浏览

观察到的行为

NFSv4 共享已成功装载到 Linux 服务器上，但在浏览 Linux 客户端的文件系统时，Avamar UI 不显示任何文件或目录。

验证 Linux 服务器上的 NFSv4 装载

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 正确安装。
• 浏览 Linux 客户端时，Avamar UI 不会列出已装载的 NFSv4 路径下的任何文件或目录。
• Linux 管理员确认装载点在作系统级别正常工作。

Avtar 缺少本机 NFSv4 浏览功能。

Avamar Client （avtar） 不支持直接浏览 Linux 服务器上的 NFSv4 装载点，除非配置了特定的命令行标记。如果没有这些标记，Avamar UI 将无法显示 NFSv4 共享的内容，即使该共享已正确装载到服务器上也是如此。

• 默认 Avamar Client 配置不包括 --forcefs=nfs4 或 --browse-nfs 选项。
• 当缺少这些选项时， avtar 将 NFS 装载视为不受支持，并禁止目录列表。
• 此限制与 NFS 服务器的导出设置或 mountstats （例如 vers=4.0、 rw 和 hard）。

相关配置文件和位置

Avtar 从位于 Avamar 安装的两个文件中读取命令行标记 /var 目录下看到一个新的 res 目录。默认路径因作系统而异。
如果文件 avagent.cmd 和 avtar.cmd 不包含所需的 NFSv4 标记，客户端无法浏览装载点。

缺少命令行标志

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

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

缺少这些条目是无法在 Avamar UI 中查看 NFSv4 共享的直接原因。

使 Avamar 能够浏览 Linux 客户端上的 NFSv4 装载点。

前提条件

• Root 或 sudo 访问 Avamar Linux 客户端。
• 支持 NFSv4 的 Avamar Client 版本（例如 CentOS 7 客户端）。
• 配置后访问 Avamar UI 以验证装载点。

分步过程

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 Client 代理以应用更改。

# 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 验证 Linux 服务器上的 NFS 装载选项。
• df -h 确认 NFS 共享已装载。
• 用于浏览和确认装载点可见性的 Avamar UI

systemctl status firewalld

iptables -L