

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configuración de clientes de EFA
<a name="configure-efa-clients"></a>

Utilice los siguientes procedimientos para configurar su cliente de Lustre FSx para acceder a un sistema de archivos de Lustre mediante Elastic Fabric Adapter (EFA).

EFA es compatible con los clientes de Lustre que ejecutan los siguientes sistemas operativos:
+ Amazon Linux 2023 (AL2023)
+ Red Hat Enterprise Linux (RHEL) 9.5 o posterior
+ Ubuntu 22.04 o posterior con kernel versión 6.8\$1

El EFA es compatible con los clientes de Lustre que se indican a continuación. Para obtener más información, consulte [Instalación del cliente de Lustre](install-lustre-client.md).

EFA es compatible con las instancias Nitro v4 (o superior) que admiten EFA, excluida la familia de EC2 instancias trn2. Consulta los [tipos de instancias compatibles](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types) en la *Guía del EC2 usuario de Amazon*.

**Topics**
+ [Paso 1: Instalar los controladores necesarios](#install-required-drivers)
+ [Paso 2: configure EFA para el cliente de Lustre](#install-efa-on-client)
+ [Paso 3: interfaces de EFA](#add-efa-interfaces)

## Paso 1: Instalar los controladores necesarios
<a name="install-required-drivers"></a>

**nota**  
Si utiliza una [AMI de aprendizaje profundo](https://docs.aws.amazon.com/dlami/latest/devguide/what-is-dlami.html), puede omitir este paso, ya que el cliente Lustre, el controlador EFA y el controlador NVIDIA GPUDirect Storage (GDS) vienen preinstalados.

### Instale el cliente Lustre y el controlador EFA
<a name="install-lustre-client-efa-driver"></a>

**Para instalar rápidamente el cliente Lustre y el controlador EFA**

1. Descargue y descomprima el archivo que contiene el script de instalación:

   ```
   curl -O https://docs.aws.amazon.com/fsx/latest/LustreGuide/samples/install-fsx-lustre-client.zip
   unzip install-fsx-lustre-client.zip
   ```

1. Cambie a la `install-fsx-lustre-client` carpeta y ejecute el script de instalación:

   ```
   cd install-fsx-lustre-client
   sudo ./bin/install-fsx-lustre-client.sh --install-lustre --install-efa
   ```

   El script hace lo siguiente de forma automática:
   + Instala el cliente Lustre
   + Instala el controlador EFA
   + Verifica la instalación del cliente Lustre y del controlador EFA

   Para ver una lista de opciones y ejemplos de uso que puede usar con el script de `install-fsx-lustre-client.sh`, consulte el archivo de `README.md` en el archivo zip.

### Instale el controlador GDS (opcional)
<a name="install-gds-driver"></a>

Este paso solo es necesario si va a utilizar NVIDIA GPUDirect Storage (GDS) con for Lustre. FSx 

Requisitos:
+ Instancia Amazon EC2 P5, P5e, P5en o P6-B200
+ Controlador GDS de NVIDIA, versión 2.24.2 o superior

**Para instalar el controlador de almacenamiento NVIDIA en la instancia de cliente GPUDirect**

1. Clona el repositorio GDS de NVIDIA:

   ```
   git clone https://github.com/NVIDIA/gds-nvidia-fs.git
   ```

1. Compile e instale el controlador:

   ```
   cd gds-nvidia-fs/src/
   export NVFS_MAX_PEER_DEVS=128
   export NVFS_MAX_PCI_DEPTH=16
   sudo -E make
   sudo insmod nvidia-fs.ko
   ```

## Paso 2: configure EFA para el cliente de Lustre
<a name="install-efa-on-client"></a>

Para acceder a un FSx sistema de archivos de Lustre mediante una interfaz EFA, debe instalar los módulos EFA de Lustre y configurar las interfaces EFA.

### Configuración rápida
<a name="quick-setup"></a>

**Para configurar rápidamente su cliente Lustre**

1. Conéctate a tu EC2 instancia de Amazon.

1. Descargue y descomprima el archivo que contiene el script de configuración:

   ```
   curl -O https://docs.aws.amazon.com/fsx/latest/LustreGuide/samples/configure-efa-fsx-lustre-client.zip
   unzip configure-efa-fsx-lustre-client.zip
   ```

1. Cambie a la carpeta de `configure-efa-fsx-lustre-client` y ejecute el script de configuración:

   ```
   cd configure-efa-fsx-lustre-client
   # for regular IO
   sudo ./setup.sh
   
   # for NVIDIA GPUDirect Storage (GDS) IO
   sudo ./setup.sh --optimized-for-gds
   ```

   El script hace lo siguiente de forma automática:
   + Importa módulos de Lustre.
   + Configura las interfaces TCP y EFA.
   + Crea un servicio systemd para la configuración automática al reiniciar.

   Para ver una lista de opciones y ejemplos de uso que puede usar con el script de `setup.sh`, consulte el archivo de `README.md` en el archivo zip.

### Administrar el servicio systemd manualmente
<a name="manage-systemd-service"></a>

El archivo de servicio systemd se crea en/etc/systemd/system/configure- efa-fsx-lustre-client .service. Los siguientes son algunos comandos útiles relacionados con systemd:

```
# Check status
sudo systemctl status configure-efa-fsx-lustre-client.service

# View logs
sudo journalctl -u configure-efa-fsx-lustre-client.service
# View warnings/errors from dmesg
sudo dmesg
```

Para obtener más información, consulte el archivo de `README.md` en el archivo zip.

### Configuración de montaje automático (opcional)
<a name="auto-mount-configuration"></a>

Para obtener información sobre cómo montar automáticamente el sistema de archivos Amazon FSx for Lustre al arrancar, consulte[Montaje automático del sistema FSx de archivos de Amazon](mount-fs-auto-mount-onreboot.md).

## Paso 3: interfaces de EFA
<a name="add-efa-interfaces"></a>

Cada sistema FSx de archivos de Lustre tiene un límite máximo de 1024 conexiones EFA en todas las instancias del cliente.

El script de `configure-efa-fsx-lustre-client.sh` configura automáticamente las interfaces EFA en función del tipo de instancia.


| Tipo de instancia | Número predeterminado de interfaces EFA | 
| --- | --- | 
| p6e-gb200.36xlarge | 8 | 
| p6-b200.48xlarge | 8 | 
| p5en.48xlarge | 8 | 
| p5e.48xlarge | 8 | 
| p5.48xlarge | 8 | 
| Otras instancias con varias tarjetas de red | 2 | 
| Otras instancias con una sola tarjeta de red | 1 | 

Cada interfaz EFA configurada en una instancia cliente cuenta como una conexión frente al límite de 1024 conexiones EFA cuando se conecta a un FSx sistema de archivos de Lustre.

### Administración manual de las interfaces EFA
<a name="manage-interfaces-manually"></a>

Las instancias con más interfaces EFA suelen admitir un mayor rendimiento. Puede personalizar la cantidad de interfaces para optimizar el rendimiento de sus cargas de trabajo específicas, siempre y cuando se mantenga dentro del límite total de conexiones de la EFA.

Puede administrar manualmente las interfaces EFA mediante los siguientes comandos:

1. Vea las interfaces EFA disponibles:

   ```
   for interface in /sys/class/infiniband/*; do
       if [ ! -e "$interface/device/driver" ]; then continue; fi
       driver=$(basename "$(realpath "$interface/device/driver")")
       if [ "$driver" != "efa" ]; then continue; fi
       echo $(basename $interface)
   done
   ```

1. Vea las interfaces actualmente configuradas:

   ```
   sudo lnetctl net show
   ```

1. Agregue una interfaz EFA:

   ```
   sudo lnetctl net add --net efa --if device_name --peer-credits 32
   ```

   *device\$1name*Sustitúyalo por un nombre de dispositivo real de la lista del paso 1.

1. Elimine una interfaz EFA:

   ```
   sudo lnetctl net del --net efa --if device_name
   ```

   *device\$1name*Sustitúyalo por un nombre de dispositivo real de la lista del paso 2.