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 用戶端 （avtar） 不支援直接流覽 Linux 伺服器上的 NFSv4 掛載點，除非配置了特定的命令行標誌。若沒有這些旗標，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

缺少這些項目是無法在 Avamar UI 中檢視 NFSv4 共用的直接原因。

可讓 Avamar 瀏覽 Linux 用戶端上的 NFSv4 固定點。

先決條件

• 根或 sudo 在 Avamar Linux 用戶端上存取。
• 支援 NFSv4 的 Avamar 用戶端版本 （例如 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 用戶端代理程式以套用變更。

# 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