Avamar: Habilite la navegación de NFSv4 en el cliente Linux mediante la configuración de avagent.cmd y avtar.cmd

Comportamiento observado

El recurso compartido NFSv4 se montó correctamente en el servidor Linux, pero la interfaz del usuario de Avamar no muestra ningún archivo o directorio cuando se navega por el sistema de archivos del cliente Linux.

Verificación del montaje de NFSv4 en el servidor Linux

El administrador de Linux confirmó el montaje mediante comandos estándar.

# 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

Detalles de montaje en </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

Estadísticas de montaje opcionales (es posible que no estén disponibles)

La variable mountstats Es posible que la utilidad no esté presente en la distribución de Linux, lo que puede limitar los diagnósticos adicionales.

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

Resumen de síntomas

• El recurso compartido de NFSv4 aparece en df -h y /proc/mounts correctamente montado.
• La interfaz de usuario de Avamar no enumera ningún archivo o directorio en la ruta NFSv4 montada cuando se navega por el cliente Linux.
• El administrador de Linux confirma que el punto de montaje funcione en el nivel del sistema operativo.

Avtar carece de la funcionalidad de navegación nativa de NFSv4.

El Avamar Client (avtar) no admite la exploración directa de los puntos de montaje de NFSv4 en servidores Linux, a menos que se configuren marcas de línea de comandos específicas. Sin estas marcas, la interfaz del usuario de Avamar no puede mostrar el contenido del recurso compartido NFSv4, aunque este esté montado correctamente en el servidor.

• La configuración predeterminada del cliente Avamar no incluye el --forcefs=nfs4 o --browse-nfs Opciones.
• Cuando estas opciones están ausentes, avtar trata el montaje de NFS como no compatible y suprime las listas de directorios.
• Esta limitación es independiente de los ajustes de exportación del servidor NFS o de las opciones de montaje que se muestran en mountstats (por ejemplo, vers=4.0, rw y duro).

Ubicaciones y archivos de configuración pertinentes

Avtar lee las marcas de la línea de comandos de dos archivos ubicados en la instalación de Avamar /var directorio. Las rutas predeterminadas difieren según el sistema operativo.
Si los archivos avagent.cmd y avtar.cmd no contienen las marcas NFSv4 necesarias, el cliente no puede navegar por el punto de montaje.

Faltan marcas de línea de comandos

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

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

La ausencia de estas entradas es la causa directa de la incapacidad de ver el recurso compartido NFSv4 en la interfaz de usuario de Avamar.

Sistema operativo	Predeterminado /var Camino
Linux, AIX	/usr/local/avamar/var/
HP-UX y Solaris	/opt/AVMRclnt/var/

Permita que Avamar busque los puntos de montaje de NFSv4 en clientes Linux.

Requisitos previos

• Raíz o sudo acceso en el cliente Avamar Linux.
• Versión del cliente Avamar compatible con NFSv4 (como el cliente CentOS 7).
• Acceso a la interfaz de usuario de Avamar para verificar el punto de montaje después de la configuración.

Procedimiento paso a paso

1. Cree los archivos de comandos si aún no existen.

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

2. Editar avagent.cmd y agregue la marca 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. Editar avtar.cmd y agregue la misma bandera.

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

4. Reinicie el agente de cliente Avamar para aplicar los cambios.

# 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. Actualice la interfaz del usuario de Avamar y navegue por el sistema de archivos del cliente.

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

 

Verificación

• Confirme que el punto de montaje de NFSv4 aparezca en el navegador de archivos de la interfaz del usuario de Avamar.
• Ejecute un respaldo o una restauración de prueba de un archivo pequeño ubicado en el recurso compartido NFSv4 para asegurarse de que se pueda acceder a los datos.
• Compruebe el avagent Registre los errores relacionados con el manejo de NFS:

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

 

Herramientas adicionales

• mountstats Verifica las opciones de montaje de NFS en el servidor Linux.
• df -h confirma que el recurso compartido NFS está montado.
• Interfaz del usuario de Avamar para navegar y confirmar la visibilidad del punto de montaje

En ocasiones, el firewall del servidor Linux puede bloquear las conexiones entre el servidor Avamar y el cliente.

Verifique el estado del firewall de Linux:

systemctl status firewalld

Verifique el iptables lista:

iptables -L

Si el firewall y iptables están habilitados, solicite al administrador de Linux que lo deshabilite para realizar pruebas. 

Si la navegación funciona después del firewall y iptables está deshabilitado, haga que el administrador de Linux cree un firewall personalizado y iptables para permitir todo el tráfico entre Avamar y el servidor Linux.