Avamar: Habilitar a navegação NFSv4 no client Linux configurando avagent.cmd e avtar.cmd

Comportamento observado

O compartilhamento NFSv4 é montado com sucesso no servidor Linux, mas a interface do usuário do Avamar não exibe nenhum arquivo ou diretório ao navegar no file system do client Linux.

Verificação da montagem do NFSv4 no servidor Linux

O administrador do Linux confirmou a montagem usando comandos padrão.

# 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

Detalhes da montagem a partir de </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

Estatísticas de montagem opcionais (pode não estar disponível)

A coluna mountstats utilitário pode não estar presente na distribuição Linux, o que pode limitar diagnósticos adicionais.

# 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 ---

Resumo dos sintomas

• O compartilhamento NFSv4 é exibido em df -h e /proc/mounts conforme montado corretamente.
• A interface do usuário do Avamar não lista nenhum arquivo ou diretório no caminho NFSv4 montado ao navegar no client Linux.
• O administrador do Linux confirma que o ponto de montagem está funcional no nível do sistema operacional.

O Avtar não tem o recurso nativo de navegação NFSv4.

O Avamar Client (avtar) não dá suporte à navegação direta de pontos de montagem NFSv4 em servidores Linux, a menos que indicadores de linha de comando específicos estejam configurados. Sem esses indicadores, a interface do usuário do Avamar não pode exibir o conteúdo do compartilhamento NFSv4, mesmo que o compartilhamento esteja montado corretamente no servidor.

• A configuração padrão do Avamar Client não inclui o --forcefs=nfs4 ou --browse-nfs Opções.
• Quando essas opções estiverem ausentes, avtar Trata a montagem NFS como incompatível e suprime as listagens de diretório.
• Essa limitação é independente das configurações de exportação do servidor NFS ou das opções de montagem mostradas por mountstats (como vers=4.0, rw e hard).

Arquivos e locais de configuração relevantes

O Avtar lê os indicadores de linha de comando de dois arquivos localizados na instalação do Avamar /var diretório. Os caminhos padrão diferem de acordo com o sistema operacional.
Se os arquivos avagent.cmd e avtar.cmd não contêm os indicadores NFSv4 necessários, o client não pode procurar o ponto de montagem.

Indicadores de linha de comando ausentes

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

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

A ausência dessas entradas é a causa direta da incapacidade de visualizar o compartilhamento NFSv4 na interface do usuário do Avamar.

Sistema operacional	Padrão /var Caminho
Linux, AIX	/usr/local/avamar/var/
HP-UX, Solaris	/opt/AVMRclnt/var/

Habilite o Avamar para procurar pontos de montagem NFSv4 em clients Linux.

Pré-requisitos

• Raiz ou sudo acesso no Avamar Linux client.
• Versão do client Avamar compatível com NFSv4 (como o client CentOS 7).
• Acesso à interface do usuário do Avamar para verificar o ponto de montagem após a configuração.

Procedimento passo a passo

1. Crie os arquivos de comando, caso eles ainda não existam.

# CentOS 7, RHEL, or similar
$ touch /usr/local/avamar/var/avagent.cmd
$ touch /usr/local/avamar/var/avtar.cmd

2. Edit avagent.cmd e adicione o indicador 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. Edit avtar.cmd e adicione a mesma bandeira.

$ vi /usr/local/avamar/var/avtar.cmd
# Insert the following line
--forcefs=nfs4
# Save and exit

4. Reinicie o agente do Avamar Client para aplicar as alterações.

# 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. Atualize a interface do usuário do Avamar e navegue até o file system do client.

# 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).

 

Verificação

• Confirme se o ponto de montagem NFSv4 é exibido no navegador de arquivos da interface do usuário do Avamar.
• Execute um backup ou uma restauração de teste de um pequeno arquivo localizado no compartilhamento NFSv4 para garantir que os dados possam ser acessados.
• Verifique a coluna avagent registro de quaisquer erros relacionados ao tratamento do NFS:

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

 

Ferramentas adicionais

• mountstats verifica as opções de montagem NFS no servidor Linux.
• df -h confirma se o compartilhamento NFS está montado.
• Interface do usuário do Avamar para navegar e confirmar a visibilidade do ponto de montagem

Às vezes, o firewall no servidor Linux pode bloquear conexões entre o servidor Avamar e o próprio client.

Verifique o status do firewall do Linux:

systemctl status firewalld

Verifique o iptables lista:

iptables -L

Se firewall e iptables estão ativados, peça ao administrador do Linux para desativá-lo para teste. 

Se a navegação funcionar após o firewall e iptables está desativada, em seguida, peça ao administrador do Linux para criar um firewall personalizado e iptables regra para permitir todo o tráfego entre o Avamar e o servidor Linux.