Avamar: Linux 클라이언트에서 avagent.cmd 및 avtar.cmd 구성하여 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

OMIMSSC에서 세부 정보 마운트 </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는 Linux 클라이언트를 탐색할 때 마운트된 NFSv4 경로 아래에 파일 또는 디렉토리를 나열하지 않습니다.
• Linux 관리자가 마운트 지점이 OS 레벨에서 작동하는지 확인합니다.

Avtar에는 기본 NFSv4 탐색 기능이 없습니다.

Avamar Client(avtar)는 특정 명령줄 플래그가 구성되어 있지 않으면 Linux 서버에서 NFSv4 마운트 지점의 직접 탐색을 지원하지 않습니다. 이러한 플래그가 없으면 NFSv4 공유가 서버에 올바르게 마운트되어 있어도 NFSv4 공유의 내용을 Avamar UI에 표시할 수 없습니다.

• 기본 Avamar Client 구성에는 --forcefs=nfs4 또는 --browse-nfs 옵션.
• 이러한 옵션이 없는 경우 avtar NFS 마운트를 지원되지 않는 것으로 처리하고 디렉토리 목록을 표시하지 않습니다.
• 이 제한은 NFS 서버의 내보내기 설정 또는 에 표시되는 마운트 옵션과 무관합니다. mountstats (예: vers=4.0, rw 및 hard).

관련 구성 파일 및 위치

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 마운트 지점을 탐색할 수 있도록 설정합니다.

필수 구성 요소

• 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