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クライアントを参照するときに、マウントされたNFSv4パスの下にファイルまたはディレクトリーがAvamar UIに一覧表示されません。
• Linux管理者は、マウント ポイントがOSレベルで機能することを確認します。

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インストールの下にある2つのファイルからコマンド ライン フラグを読み取ります。 /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 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 Agentを再起動して、変更を適用します。

# 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