

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instalar o cliente do Lustre
<a name="install-lustre-client"></a>

Para montar o sistema de arquivos do Amazon FSx para Lustre usando uma instância do Linux, comece pela instalação do cliente de código aberto do Lustre. Em seguida, dependendo da versão do seu sistema operacional, use um dos procedimentos a seguir. Para obter informações sobre a compatibilidade do kernel, consulte [Compatibilidade com sistema de arquivos e kernel do cliente do Lustre](lustre-client-matrix.md).

Se você estiver usando um cliente Lustre com EFA (Elastic Fabric Adapter), consulte. [Como configurar clientes do EFA](configure-efa-clients.md)

Se sua instância de computação não estiver executando o kernel do Linux especificado nas instruções de instalação e você não puder alterar o kernel, será possível criar seu próprio cliente do Lustre. Para obter mais informações, consulte [Compiling Lustre](http://wiki.lustre.org/Compiling_Lustre) na Wiki do Lustre.

## Amazon Linux
<a name="lustre-client-amazon-linux"></a>

### Para instalar o cliente do Lustre no Amazon Linux 2023
<a name="install-lustre-client-amazon-linux-2023"></a>

1. Abra um terminal no seu cliente.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao executar o comando apresentado a seguir.

   ```
   uname -r
   ```

1. Analise a resposta do sistema e compare-a com o seguinte requisito mínimo de kernel para instalar o cliente do Lustre no Amazon Linux 2023:
   + Requisito mínimo do kernel 6.12: 6.12\*
   + Requisito mínimo do kernel 6.1: 6.1.79-99.167.amzn2023

   Se sua instância do EC2 atender ao requisito mínimo do kernel, siga para a etapa e instale o cliente do Lustre.

   Se o comando retornar um resultado inferior ao requisito mínimo para o kernel, atualize o kernel e reinicialize a instância do Amazon EC2 ao executar o comando apresentado a seguir.

   ```
   sudo dnf -y update kernel && sudo reboot
   ```

   Confirme se o kernel foi atualizado usando o comando **uname -r**.

1. Faça download e instale o cliente do Lustre com o comando a seguir.

   ```
   sudo dnf install -y lustre-client
   ```

### Para instalar o cliente do Lustre no Amazon Linux 2
<a name="install-lustre-client-amazon-linux-2"></a>

1. Abra um terminal no seu cliente.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao executar o comando apresentado a seguir.

   ```
   uname -r
   ```

1. Analise a resposta do sistema e compare-a com os seguintes requisitos mínimos de kernel para instalar o cliente do Lustre no Amazon Linux 2:
   + Requisito mínimo para o kernel 5.10: 5.10.144-127.601.amzn2
   + Requisito mínimo para o kernel 5.4: 5.4.214-120.368.amzn2
   + Requisito mínimo para o kernel 4.14: 4.14.294-220.533.amzn2

   Se sua instância do EC2 atender aos requisitos mínimos do kernel, siga para a etapa e instale o cliente do Lustre.

   Se o comando retornar um resultado inferior ao requisito mínimo para o kernel, atualize o kernel e reinicialize a instância do Amazon EC2 ao executar o comando apresentado a seguir.

   ```
   sudo yum -y update kernel && sudo reboot
   ```

   Confirme se o kernel foi atualizado usando o comando **uname -r**.

1. Faça download e instale o cliente do Lustre com o comando a seguir.

   ```
   sudo amazon-linux-extras install -y lustre
   ```

   Se não for possível atualizar o kernel para o requisito mínimo para o kernel, você poderá instalar o cliente com a versão 2.10 herdada usando o comando apresentado a seguir.

   ```
   sudo amazon-linux-extras install -y lustre2.10
   ```

### Para instalar o cliente do Lustre no Amazon Linux
<a name="install-lustre-client-amazon-linux"></a>

1. Abra um terminal no seu cliente.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao executar o comando apresentado a seguir. O cliente do Lustre requer o kernel `4.14, version 104` ou superior do Amazon Linux. 

   ```
   uname -r
   ```

1. Execute um destes procedimentos:
   + Se o comando retornar `4.14.104-78.84.amzn1.x86_64` ou uma versão superior à 4.14, faça download e instale o cliente do Lustre usando o comando a seguir.

     ```
     sudo yum install -y lustre-client
     ```
   +  Se o comando retornar um resultado inferior a `4.14.104-78.84.amzn1.x86_64`, atualize o kernel e reinicialize a instância do Amazon EC2 ao executar o comando apresentado a seguir. 

     ```
     sudo yum -y update kernel && sudo reboot
     ```

     Confirme se o kernel foi atualizado usando o comando **uname -r**. Em seguida, faça download e instale o cliente do Lustre conforme descrito anteriormente.

## CentOS, Rocky Linux e Red Hat
<a name="lustre-client-rhel"></a>

### Para instalar o Lustre cliente no Red Hat e no Rocky Linux 9.0 ou 9.3—9.7
<a name="install-lustre-client-RH9"></a>

É possível instalar e atualizar pacotes de clientes do Lustre compatíveis com Red Hat Enterprise Linux (RHEL) e Rocky Linux usando o repositório de pacotes yum do cliente do Lustre do Amazon FSx. Esses pacotes são assinados para ajudar a garantir que não foram violados antes ou durante o download. A instalação do repositório falhará se você não instalar a chave pública correspondente em seu sistema.

**Como adicionar o repositório de pacotes yum do cliente do Lustre para Amazon FSx**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx ao usar o comando apresentado a seguir.

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. Importe a chave ao usar o comando apresentado a seguir.

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. Adicione o repositório e atualize o gerenciador de pacotes usando o comando apresentado a seguir.

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/9/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**Para configurar o repositório yum do cliente do Lustre para o Amazon FSx**

Por padrão, o repositório de pacotes yum do cliente do Lustre para Amazon FSx é configurado para instalar o cliente do Lustre que é compatível com a versão do kernel inicialmente disponibilizada com a mais recente versão compatível do Rocky Linux e RHEL 9. Para instalar um cliente do Lustre compatível com a versão do kernel que você está usando, é possível editar o arquivo de configuração do repositório.

Esta seção descreve como determinar qual kernel você está executando, se é necessário editar a configuração do repositório e como editar o arquivo de configuração.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao usar o comando apresentado a seguir.

   ```
   uname -r
   ```

1. Execute um destes procedimentos:
   + Se o comando retornar `5.14.0-611*`, não será necessário modificar a configuração do repositório. Prossiga para o procedimento **Como instalar o cliente do Lustre**.
   +  Se o comando retornar`5.14.0-570*`, você deverá editar a configuração do repositório para que ela aponte para o Lustre cliente da versão 9.6 do Rocky Linux e do RHEL.
   +  Se o comando retornar`5.14.0-503*`, você deverá editar a configuração do repositório para que ela aponte para o Lustre cliente da versão 9.5 do Rocky Linux e do RHEL.
   +  Se o comando retornar`5.14.0-427*`, você deverá editar a configuração do repositório para que ela aponte para o Lustre cliente da versão 9.4 do Rocky Linux e do RHEL.
   +  Se o comando retornar `5.14.0-362.18.1`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões Rocky Linux e RHEL 9.3.
   +  Se o comando retornar `5.14.0-70*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões Rocky Linux e RHEL 9.0.

1. Edite o arquivo de configuração do repositório a fim de direcionar para uma versão específica do RHEL usando o comando apresentado a seguir. Substitua {{`specific_RHEL_version`}} pela versão do RHEL que você precisa usar.

   ```
   sudo sed -i 's#9#{{specific_RHEL_version}}#' /etc/yum.repos.d/aws-fsx.repo
   ```

   Por exemplo, para apontar para a versão 9.6, `{{specific_RHEL_version}}` substitua por `9.6` no comando, como no exemplo a seguir.

   ```
   sudo sed -i 's#9#9.6#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. Use o comando apresentado a seguir para limpar o cache do yum.

   ```
   sudo yum clean all
   ```

**Para instalar o cliente do Lustre**
+ Instale os pacotes do repositório usando o comando apresentado a seguir.

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### Informações adicionais (Rocky Linux e Red Hat 9.0 e mais recentes)
<a name="lustre-client-RH9-additional-info"></a>

Os comandos anteriores instalam os dois pacotes necessários para montar e interagir com o sistema de arquivos do Amazon FSx. O repositório inclui pacotes adicionais do Lustre, como um pacote que contém o código-fonte e pacotes que contêm testes, sendo possível instalá-los ao seu critério. Para listar todos os pacotes disponíveis no repositório, use o comando apresentado a seguir.

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

Para fazer download do rpm de origem, que contém um tarball do código-fonte upstream e o conjunto de patches que aplicamos, use o comando apresentado a seguir.

```
 sudo yumdownloader --source kmod-lustre-client
```

Quando você executa uma atualização do yum, uma versão mais recente do módulo é instalada, se disponível, e a versão existente é substituída. Para evitar que a versão instalada no momento seja removida na atualização, adicione uma linha como a apresentada a seguir ao seu arquivo `/etc/yum.conf`.

```
installonlypkgs=kernel, kernel-PAE, installonlypkg(kernel), installonlypkg(kernel-module), 
              installonlypkg(vm), multiversion(kernel), kmod-lustre-client
```

 Esta lista inclui os pacotes padrão somente para a instalação, especificados na página de manual `yum.conf`, e o pacote `kmod-lustre-client`.

### Para instalar o cliente do Lustre no CentOS e Red Hat 8.2–8.10 ou no Rocky Linux 8.4–8.10
<a name="install-lustre-client-RH8.2"></a>

É possível instalar e atualizar pacotes de clientes do Lustre compatíveis com Red Hat Enterprise Linux (RHEL), Rocky Linux e CentOS usando o repositório de pacotes yum do cliente do Lustre do Amazon FSx. Esses pacotes são assinados para ajudar a garantir que não foram violados antes ou durante o download. A instalação do repositório falhará se você não instalar a chave pública correspondente em seu sistema.

**Como adicionar o repositório de pacotes yum do cliente do Lustre para Amazon FSx**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx ao usar o comando apresentado a seguir.

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. Importe a chave ao usar o comando apresentado a seguir.

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. Adicione o repositório e atualize o gerenciador de pacotes usando o comando apresentado a seguir.

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/8/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**Para configurar o repositório yum do cliente do Lustre para o Amazon FSx**

Por padrão, o repositório de pacotes yum do cliente do Lustre para Amazon FSx é configurado para instalar o cliente do Lustre que é compatível com a versão do kernel inicialmente disponibilizada com a mais recente versão compatível do CentOS, Rocky Linux e RHEL 8. Para instalar um cliente do Lustre compatível com a versão do kernel que você está usando, é possível editar o arquivo de configuração do repositório.

Esta seção descreve como determinar qual kernel você está executando, se é necessário editar a configuração do repositório e como editar o arquivo de configuração.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao usar o comando apresentado a seguir.

   ```
   uname -r
   ```

1. Execute um destes procedimentos:
   + Se o comando retornar `4.18.0-553*`, não será necessário modificar a configuração do repositório. Prossiga para o procedimento **Como instalar o cliente do Lustre**.
   +  Se o comando retornar `4.18.0-513*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS, Rocky Linux e RHEL 8.9.
   +  Se o comando retornar `4.18.0-477*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS, Rocky Linux e RHEL 8.8.
   +  Se o comando retornar `4.18.0-425*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS, Rocky Linux e RHEL 8.7.
   +  Se o comando retornar `4.18.0-372*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS, Rocky Linux e RHEL 8.6.
   +  Se o comando retornar `4.18.0-348*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS, Rocky Linux e RHEL 8.5.
   +  Se o comando retornar `4.18.0-305*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS, Rocky Linux e RHEL 8.4.
   +  Se o comando retornar `4.18.0-240*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS e RHEL 8.3.
   +  Se o comando retornar `4.18.0-193*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS e RHEL 8.2.

1. Edite o arquivo de configuração do repositório a fim de direcionar para uma versão específica do RHEL usando o comando apresentado a seguir.

   ```
   sudo sed -i 's#8#{{specific_RHEL_version}}#' /etc/yum.repos.d/aws-fsx.repo
   ```

   Por exemplo, para apontar para a versão 8.9, substitua `{{specific_RHEL_version}}` por `8.9` no comando.

   ```
   sudo sed -i 's#8#8.9#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. Use o comando apresentado a seguir para limpar o cache do yum.

   ```
   sudo yum clean all
   ```

**Para instalar o cliente do Lustre**
+ Instale os pacotes do repositório usando o comando apresentado a seguir.

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### Informações adicionais (CentOS, Rocky Linux e Red Hat 8.2 e versões mais recentes)
<a name="lustre-client-RH8.2-additional-info"></a>

Os comandos anteriores instalam os dois pacotes necessários para montar e interagir com o sistema de arquivos do Amazon FSx. O repositório inclui pacotes adicionais do Lustre, como um pacote que contém o código-fonte e pacotes que contêm testes, sendo possível instalá-los ao seu critério. Para listar todos os pacotes disponíveis no repositório, use o comando apresentado a seguir. 

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

Para fazer download do rpm de origem, que contém um tarball do código-fonte upstream e o conjunto de patches que aplicamos, use o comando apresentado a seguir.

```
 sudo yumdownloader --source kmod-lustre-client
```

Quando você executa uma atualização do yum, uma versão mais recente do módulo é instalada, se disponível, e a versão existente é substituída. Para evitar que a versão instalada no momento seja removida na atualização, adicione uma linha como a apresentada a seguir ao seu arquivo `/etc/yum.conf`.

```
installonlypkgs=kernel, kernel-PAE, installonlypkg(kernel), installonlypkg(kernel-module), 
              installonlypkg(vm), multiversion(kernel), kmod-lustre-client
```

 Esta lista inclui os pacotes padrão somente para a instalação, especificados na página de manual `yum.conf`, e o pacote `kmod-lustre-client`.

### Para instalar o cliente do Lustre no CentOS e no Red Hat 7.7, 7.8 ou 7.9 (instâncias x86\_64)
<a name="install-lustre-client-Centos-7"></a>

É possível instalar e atualizar pacotes de clientes do Lustre compatíveis com Red Hat Enterprise Linux (RHEL) e CentOS usando o repositório de pacotes yum do cliente do Lustre do Amazon FSx. Esses pacotes são assinados para ajudar a garantir que não foram violados antes ou durante o download. A instalação do repositório falhará se você não instalar a chave pública correspondente em seu sistema.

**Como adicionar o repositório de pacotes yum do cliente do Lustre para Amazon FSx**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx usando o comando apresentado a seguir.

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. Importe a chave usando o comando apresentado a seguir.

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. Adicione o repositório e atualize o gerenciador de pacotes usando o comando apresentado a seguir.

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/el/7/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**Para configurar o repositório yum do cliente do Lustre para o Amazon FSx**

Por padrão, o repositório de pacotes yum do cliente do Lustre para Amazon FSx é configurado para instalar o cliente do Lustre que é compatível com a versão do kernel inicialmente disponibilizada com a mais recente versão compatível do CentOS e RHEL 7. Para instalar um cliente do Lustre compatível com a versão do kernel que você está usando, é possível editar o arquivo de configuração do repositório. 

Esta seção descreve como determinar qual kernel você está executando, se é necessário editar a configuração do repositório e como editar o arquivo de configuração.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao usar o comando apresentado a seguir.

   ```
   uname -r
   ```

1. Execute um destes procedimentos:
   + Se o comando retornar `3.10.0-1160*`, não será necessário modificar a configuração do repositório. Prossiga para o procedimento **Como instalar o cliente do Lustre**.
   +  Se o comando retornar `3.10.0-1127*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS e RHEL 7.8.
   +  Se o comando retornar `3.10.0-1062*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS e RHEL 7.7.

1. Edite o arquivo de configuração do repositório a fim de direcionar para uma versão específica do RHEL usando o comando apresentado a seguir.

   ```
   sudo sed -i 's#7#{{specific_RHEL_version}}#' /etc/yum.repos.d/aws-fsx.repo
   ```

   Para direcionar para a versão 7.8, substitua `{{specific_RHEL_version}}` por `7.8` no comando.

   ```
   sudo sed -i 's#7#7.8#' /etc/yum.repos.d/aws-fsx.repo
   ```

   Para direcionar para a versão 7.7, substitua `{{specific_RHEL_version}}` por `7.7` no comando.

   ```
   sudo sed -i 's#7#7.7#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. Use o comando apresentado a seguir para limpar o cache do yum.

   ```
   sudo yum clean all
   ```

**Para instalar o cliente do Lustre**
+ Instale os pacotes do cliente do Lustre diretamente do repositório usando o comando a seguir.

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### Informações adicionais (CentOS e Red Hat 7.7 e versões mais recentes)
<a name="lustre-client-Centos-7-additional-info"></a>

Os comandos anteriores instalam os dois pacotes necessários para montar e interagir com o sistema de arquivos do Amazon FSx. O repositório inclui pacotes adicionais do Lustre, como um pacote que contém o código-fonte e pacotes que contêm testes, sendo possível instalá-los ao seu critério. Para listar todos os pacotes disponíveis no repositório, use o comando apresentado a seguir. 

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

Para fazer download do rpm de origem que contém um tarball do código-fonte upstream e o conjunto de patches que aplicamos, use o comando apresentado a seguir.

```
 sudo yumdownloader --source kmod-lustre-client
```

Quando você executa uma atualização do yum, uma versão mais recente do módulo é instalada, se disponível, e a versão existente é substituída. Para evitar que a versão instalada no momento seja removida na atualização, adicione uma linha como a apresentada a seguir ao seu arquivo `/etc/yum.conf`.

```
installonlypkgs=kernel, kernel-big‐mem, kernel-enterprise, kernel-smp,
              kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE,
              kernel-PAE-debug, kmod-lustre-client
```

 Esta lista inclui os pacotes padrão somente para a instalação, especificados na página de manual `yum.conf`, e o pacote `kmod-lustre-client`.

### Para instalar o Lustre cliente no CentOS 7.8 ou 7.9 (instâncias) Arm-based AWS Graviton-powered
<a name="install-lustre-client-Centos-7-arm"></a>

Você pode instalar e atualizar pacotes de Lustre clientes a partir do repositório de pacotes yum Lustre do cliente Amazon FSx que sejam compatíveis com o CentOS 7 para instâncias EC2. Arm-based AWS Graviton-powered Esses pacotes são assinados para ajudar a garantir que não foram violados antes ou durante o download. A instalação do repositório falhará se você não instalar a chave pública correspondente em seu sistema.

**Como adicionar o repositório de pacotes yum do cliente do Lustre para Amazon FSx**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx usando o comando apresentado a seguir.

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

   ```
   curl https://fsx-lustre-client-repo-public-keys.s3.amazonaws.cn/fsx-rpm-public-key.asc -o /tmp/fsx-rpm-public-key.asc
   ```

1. Importe a chave usando o comando apresentado a seguir.

   ```
   sudo rpm --import /tmp/fsx-rpm-public-key.asc
   ```

1. Adicione o repositório e atualize o gerenciador de pacotes usando o comando apresentado a seguir.

   ```
   sudo curl https://fsx-lustre-client-repo.s3.amazonaws.com/centos/7/fsx-lustre-client.repo -o /etc/yum.repos.d/aws-fsx.repo
   ```

**Para configurar o repositório yum do cliente do Lustre para Amazon FSx**

Por padrão, o repositório de pacotes yum do cliente do Lustre para Amazon FSx é configurado para instalar o cliente do Lustre que é compatível com a versão do kernel inicialmente disponibilizada com a mais recente versão compatível do CentOS 7. Para instalar um cliente do Lustre compatível com a versão do kernel que você está usando, é possível editar o arquivo de configuração do repositório. 

Esta seção descreve como determinar qual kernel você está executando, se é necessário editar a configuração do repositório e como editar o arquivo de configuração.

1. Determine qual kernel está em execução, no momento, na sua instância de computação ao usar o comando apresentado a seguir.

   ```
   uname -r
   ```

1. Execute um destes procedimentos:
   + Se o comando retornar `4.18.0-193*`, não será necessário modificar a configuração do repositório. Prossiga para o procedimento **Como instalar o cliente do Lustre**.
   +  Se o comando retornar `4.18.0-147*`, você deverá editar a configuração do repositório a fim de direcioná-la para o cliente do Lustre para as versões CentOS 7.8.

1. Edite o arquivo de configuração do repositório a fim de direcionar para a versão do CentOS 7.8 usando o comando apresentado a seguir.

   ```
   sudo sed -i 's#7#7.8#' /etc/yum.repos.d/aws-fsx.repo
   ```

1. Use o comando apresentado a seguir para limpar o cache do yum.

   ```
   sudo yum clean all
   ```

**Para instalar o cliente do Lustre**
+ Instale os pacotes do repositório usando o comando apresentado a seguir.

  ```
  sudo yum install -y kmod-lustre-client lustre-client
  ```

#### Informações adicionais (CentOS 7.8 ou 7.9 para instâncias EC2) Arm-based AWS Graviton-powered
<a name="lustre-client-Centos-7-arm-additional-info"></a>

Os comandos anteriores instalam os dois pacotes necessários para montar e interagir com o sistema de arquivos do Amazon FSx. O repositório inclui pacotes adicionais do Lustre, como um pacote que contém o código-fonte e pacotes que contêm testes, sendo possível instalá-los ao seu critério. Para listar todos os pacotes disponíveis no repositório, use o comando apresentado a seguir. 

```
yum --disablerepo="*" --enablerepo="aws-fsx" list available
```

Para fazer download do rpm de origem, que contém um tarball do código-fonte upstream e o conjunto de patches que aplicamos, use o comando apresentado a seguir.

```
 sudo yumdownloader --source kmod-lustre-client
```

Quando você executa uma atualização do yum, uma versão mais recente do módulo é instalada, se disponível, e a versão existente é substituída. Para evitar que a versão instalada no momento seja removida na atualização, adicione uma linha como a apresentada a seguir ao seu arquivo `/etc/yum.conf`.

```
installonlypkgs=kernel, kernel-big‐mem, kernel-enterprise, kernel-smp,
              kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE,
              kernel-PAE-debug, kmod-lustre-client
```

 Esta lista inclui os pacotes padrão somente para a instalação, especificados na página de manual `yum.conf`, e o pacote `kmod-lustre-client`.

## Ubuntu com tamanho de página padrão (4KB)
<a name="lustre-client-ubuntu"></a>

### Para instalar o Lustre cliente no Ubuntu 18.04, 20.04, 22.04 ou 24.04 com o tamanho de página padrão (4KB)
<a name="install-lustre-client-Ubuntu"></a>

É possível obter pacotes do Lustre usando o repositório Ubuntu do Amazon FSx. Para validar que o conteúdo do repositório não foi violado antes ou durante o download, uma assinatura GNU Privacy Guard (GPG) é aplicada aos metadados do repositório. A instalação do repositório falhará, a menos que você tenha a chave GPG pública adequada instalada no sistema.

1. Abra um terminal no seu cliente.

1. Siga estas etapas para adicionar o repositório do Amazon FSx para Ubuntu:

   1. Se você ainda não registrou um repositório do Amazon FSx para Ubuntu na instância do cliente, faça download e instale a chave pública obrigatória. Use o seguinte comando.

      ```
      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null
      ```

   1. Adicione o repositório de pacotes do Amazon FSx ao gerenciador de pacotes local usando o comando apresentado a seguir.

      ```
      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'
      ```

1. Determine qual kernel está em execução na instância do cliente no momento e realize atualizações, conforme necessário. Para obter uma lista dos kernels necessários para o Lustre cliente no Ubuntu, tanto para instâncias EC2 baseadas em x86 quanto para instâncias EC2 alimentadas por processadores Arm-based Graviton, consulte. AWS [Clientes do Ubuntu](lustre-client-matrix.md#ubuntu-clients)

   1. Execute o comando apresentado a seguir para determinar qual kernel está em execução.

      ```
      uname -r
      ```

   1. Execute o comando apresentado a seguir a fim de atualizar para as versões mais recentes do kernel do Ubuntu e do Lustre e, em seguida, reinicialize.

      ```
      sudo apt install -y linux-aws lustre-client-modules-aws && sudo reboot
      ```

       Se sua versão do kernel for maior que a versão mínima do kernel para instâncias EC2 baseadas em x86 e instâncias Graviton-based EC2, e você não quiser atualizar para a versão mais recente do kernel, você pode instalar Lustre o kernel atual com o comando a seguir. 

      ```
      sudo apt install -y lustre-client-modules-$(uname -r)
      ```

      Os dois pacotes do Lustre que são necessários para montar e interagir com o seu sistema de arquivos do FSx para Lustre estão instalados. Opcionalmente, é possível instalar pacotes relacionados adicionais, como um pacote que contém o código-fonte e pacotes que contém testes, os quais estão inclusos no repositório.

   1. Liste todos os pacotes disponíveis no repositório ao usar o comando apresentado a seguir. 

      ```
      sudo apt-cache search ^lustre
      ```

   1. (Opcional) Se quiser que a atualização do sistema também sempre atualize os módulos do cliente do Lustre, certifique-se de que o pacote `lustre-client-modules-aws` esteja instalado usando o comando a seguir.

      ```
      sudo apt install -y lustre-client-modules-aws
      ```

**nota**  
Se você receber um erro `Module Not Found`, consulte [Como solucionar erros de módulos ausentes](#ubuntu-missing-module).

### Como solucionar erros de módulos ausentes
<a name="ubuntu-missing-module"></a>

Se você receber um erro `Module Not Found` ao realizar a instalação de qualquer versão do Ubuntu, faça o seguinte:

Faça downgrade do kernel para a versão mais recente com suporte. Liste todas as versões disponíveis do pacote “lustre-client-modules” e instale o kernel correspondente. Para fazer isso, execute o seguinte comando.

```
sudo apt-cache search lustre-client-modules
```

Por exemplo, se a versão mais recente inclusa no repositório for `lustre-client-modules-5.4.0-1011-aws`, faça o seguinte:

1. Instale o kernel para o qual este pacote foi desenvolvido usando os comandos apresentados a seguir.

   ```
   sudo apt-get install -y linux-image-5.4.0-1011-aws
   ```

   ```
   sudo sed -i 's/GRUB_DEFAULT=.\+/GRUB\_DEFAULT="Advanced options for Ubuntu>Ubuntu, with Linux 5.4.0-1011-aws"/' /etc/default/grub
   ```

   ```
   sudo update-grub
   ```

1. Reinicialize a instância usando o comando apresentado a seguir.

   ```
   sudo reboot
   ```

1. Instale o cliente do Lustre usando o comando a seguir.

   ```
   sudo apt-get install -y lustre-client-modules-$(uname -r)
   ```

## Ubuntu com tamanho de página de 64 KB
<a name="lustre-client-ubuntu-64k"></a>

### Para instalar o Lustre cliente em Ubuntu24.04 (ARM64) com tamanho de página de 64 KB
<a name="install-lustre-client-ubuntu-64k"></a>

É possível obter pacotes do Lustre usando o repositório Ubuntu do Amazon FSx. Para validar que o conteúdo do repositório não foi violado antes ou durante o download, uma assinatura GNU Privacy Guard (GPG) é aplicada aos metadados do repositório. A instalação do repositório falhará, a menos que você tenha a chave GPG pública adequada instalada no sistema.

1. Abra um terminal no seu cliente.

1. Verifique se sua instância está usando um tamanho de página de 64 KB. A saída deve ser`65536`.

   ```
   getconf PAGESIZE
   ```

   

1. Siga estas etapas para adicionar o repositório do Amazon FSx para Ubuntu:

   1. Se você ainda não registrou um repositório do Amazon FSx para Ubuntu na instância do cliente, faça download e instale a chave pública obrigatória. Use o seguinte comando.

      ```
      wget -O - https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-ubuntu-public-key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/fsx-ubuntu-public-key.gpg >/dev/null
      ```

   1. Adicione o repositório de pacotes do Amazon FSx ao gerenciador de pacotes local usando o comando apresentado a seguir.

      ```
      sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/fsx-ubuntu-public-key.gpg] https://fsx-lustre-client-repo.s3.amazonaws.com/ubuntu $(lsb_release -cs) main" > /etc/apt/sources.list.d/fsxlustreclientrepo.list && apt-get update'
      ```

1. Determine qual kernel está em execução na instância do cliente no momento e realize atualizações, conforme necessário. Sua versão do kernel Ubuntu 24 deve ser `6.14.0-1018-aws-64k` ou posterior.

   1. Execute o comando apresentado a seguir para determinar qual kernel está em execução.

      ```
      uname -r
      ```

   1. Execute o comando apresentado a seguir para atualizar para as versões mais recentes do kernel do Ubuntu e do Lustre e, em seguida, reinicialize.

      ```
      sudo apt install -y linux-aws-64k lustre-client-modules-aws-64k && sudo reboot
      ```

      Se sua versão do kernel `6.14.0-1018-aws-64k` for maior que a das instâncias do Graviton-based EC2 e você não quiser atualizar para a versão mais recente do kernel, você pode instalar Lustre para o kernel atual com o comando a seguir.

      ```
      sudo apt install -y lustre-client-modules-$(uname -r)
      ```

      Os dois pacotes do Lustre que são necessários para montar e interagir com o seu sistema de arquivos do FSx para Lustre estão instalados. Opcionalmente, é possível instalar pacotes relacionados adicionais, como um pacote que contém o código-fonte e pacotes que contém testes, os quais estão inclusos no repositório.

   1. Liste todos os pacotes disponíveis no repositório ao usar o comando apresentado a seguir.

      ```
      sudo apt-cache search ^lustre
      ```

   1. (Opcional) Se quiser que a atualização do sistema também sempre atualize os módulos do cliente do Lustre, certifique-se de que o pacote `lustre-client-modules-aws-64k` esteja instalado usando o comando a seguir.

      ```
      sudo apt install -y lustre-client-modules-aws-64k
      ```

## SUSE Linux
<a name="lustre-client-suse"></a>

### Para instalar o cliente do Lustre no SUSE Linux 12 SP3, SP4 ou SP5
<a name="install-lustre-client-SUSE-Linux"></a>

**Para instalar o cliente do Lustre no SUSE Linux 12 SP3**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx ao usar o comando apresentado a seguir.

   ```
   sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc
   ```

1. Importe a chave ao usar o comando apresentado a seguir.

   ```
   sudo rpm --import fsx-sles-public-key.asc
   ```

1. Adicione o repositório para o cliente do Lustre usando o comando a seguir.

   ```
   sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo
   ```

1. Faça download e instale o cliente do Lustre com os comandos a seguir.

   ```
   sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
   sudo sed -i 's#SLES-12#SP3#' /etc/zypp/repos.d/aws-fsx.repo
   sudo zypper refresh
   sudo zypper in lustre-client
   ```

**Para instalar o cliente do Lustre no SUSE Linux 12 SP4**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx ao usar o comando apresentado a seguir.

   ```
   sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc
   ```

1. Importe a chave ao usar o comando apresentado a seguir.

   ```
   sudo rpm --import fsx-sles-public-key.asc
   ```

1. Adicione o repositório para o cliente do Lustre usando o comando a seguir.

   ```
   sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo
   ```

1. Execute um destes procedimentos:
   + Se você tiver instalado o SP4 diretamente, faça download e instale o cliente do Lustre com os comandos a seguir.

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo sed -i 's#SLES-12#SP4#' /etc/zypp/repos.d/aws-fsx.repo
     sudo zypper refresh
     sudo zypper in lustre-client
     ```
   + Se você tiver migrado do SP3 para o SP4 e adicionado previamente o repositório do Amazon FSx para o SP3, faça download e instale o cliente do Lustre com os comandos a seguir.

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo sed -i 's#SP3#SP4#' /etc/zypp/repos.d/aws-fsx.repo
     sudo zypper ref
     sudo zypper up --force-resolution lustre-client-kmp-default
     ```

**Para instalar o cliente do Lustre no SUSE Linux 12 SP5**

1. Abra um terminal no seu cliente.

1. Instale a chave pública rpm do Amazon FSx ao usar o comando apresentado a seguir.

   ```
   sudo wget https://fsx-lustre-client-repo-public-keys.s3.amazonaws.com/fsx-sles-public-key.asc
   ```

1. Importe a chave ao usar o comando apresentado a seguir.

   ```
   sudo rpm --import fsx-sles-public-key.asc
   ```

1. Adicione o repositório para o cliente do Lustre usando o comando a seguir.

   ```
   sudo wget https://fsx-lustre-client-repo.s3.amazonaws.com/suse/sles-12/SLES-12/fsx-lustre-client.repo
   ```

1. Execute um destes procedimentos:
   + Se você tiver instalado o SP5 diretamente, faça download e instale o cliente do Lustre com os comandos a seguir.

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo zypper refresh
     sudo zypper in lustre-client
     ```
   + Se você tiver migrado do SP4 para o SP5 e adicionado previamente o repositório do Amazon FSx para o SP4, faça download e instale o cliente do Lustre com os comandos a seguir.

     ```
     sudo sed -i 's#SP4#SLES-12' /etc/zypp/repos.d/aws-fsx.repo
     sudo zypper ref
     sudo zypper up --force-resolution lustre-client-kmp-default
     ```

**nota**  
Pode ser necessário reinicializar a instância de computação para que o cliente conclua a instalação.