

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 seu sistema de arquivos Amazon FSx for Lustre a partir de uma instância Linux, primeiro instale o cliente de código abertoLustre. 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\$1
   + 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>

Você pode instalar e atualizar pacotes de Lustre clientes compatíveis com o Red Hat Enterprise Linux (RHEL) e o Rocky Linux a partir do repositório de pacotes yum do FSx Lustre cliente Amazon. 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.

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

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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 FSx Lustre do cliente Amazon**

O repositório de pacotes yum do FSx Lustre cliente Amazon é configurado por padrão para instalar o Lustre cliente compatível com a versão do kernel que foi enviada inicialmente com a versão mais recente suportada do Rocky Linux e do 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 seu sistema de FSx arquivos da Amazon. 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>

Você pode instalar e atualizar pacotes de Lustre clientes compatíveis com Red Hat Enterprise Linux (RHEL), Rocky Linux e CentOS a partir do repositório de pacotes yum do FSx Lustre cliente Amazon. 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.

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

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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 FSx Lustre do cliente Amazon**

O repositório de pacotes yum do FSx Lustre cliente Amazon é configurado por padrão para instalar o Lustre cliente compatível com a versão do kernel que foi inicialmente fornecida com as versões mais recentes suportadas 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 seu sistema de FSx arquivos da Amazon. 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\$164)
<a name="install-lustre-client-Centos-7"></a>

Você pode instalar e atualizar pacotes de Lustre clientes compatíveis com Red Hat Enterprise Linux (RHEL) e CentOS a partir do repositório de pacotes yum do cliente FSx Lustre Amazon. 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.

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

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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 FSx Lustre do cliente Amazon**

O repositório de pacotes yum do FSx Lustre cliente Amazon é configurado por padrão para instalar o Lustre cliente compatível com a versão do kernel que foi enviada inicialmente com as versões mais recentes suportadas do CentOS e do 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 seu sistema de FSx arquivos da Amazon. 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 baseadas em Arm baseadas em Graviton) AWS
<a name="install-lustre-client-Centos-7-arm"></a>

Você pode instalar e atualizar pacotes de Lustre clientes do repositório de pacotes yum do FSx Lustre cliente Amazon que sejam compatíveis com o CentOS 7 para instâncias EC2 baseadas em Graviton baseadas em ARM AWS . 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.

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

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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 FSx Lustre do cliente Amazon**

O repositório de pacotes yum do FSx Lustre cliente Amazon é configurado por padrão para instalar o Lustre cliente compatível com a versão do kernel que foi inicialmente fornecida com a versão mais recente 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 baseadas em AWS Arm baseadas em Graviton)
<a name="lustre-client-Centos-7-arm-additional-info"></a>

Os comandos anteriores instalam os dois pacotes necessários para montar e interagir com seu sistema de FSx arquivos da Amazon. 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>

Você pode obter Lustre pacotes do repositório Amazon FSx Ubuntu. 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 Amazon FSx Ubuntu:

   1. Se você ainda não registrou um repositório Amazon FSx Ubuntu na sua instância cliente, baixe e instale a chave pública necessá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 FSx pacotes da Amazon ao seu gerenciador de pacotes local usando o comando 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 exigidos para o cliente do Lustre no Ubuntu para instâncias do EC2 baseadas em x86 e para instâncias do EC2 baseadas em Arm habilitadas por processadores Graviton da AWS , consulte [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 superior à versão mínima para instâncias do EC2 baseadas em x86 e para instâncias do EC2 baseadas no Graviton, e você não quiser atualizar para a versão mais recente do kernel, poderá instalar o Lustre para o kernel atual com o comando a seguir. 

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

      Os dois Lustre pacotes necessários para montar e interagir com seu sistema de arquivos FSx for 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 lustre-client-modules pacote 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 no Ubuntu24.04 (ARM64) com tamanho de página de 64 KB
<a name="install-lustre-client-ubuntu-64k"></a>

Você pode obter Lustre pacotes do repositório Amazon FSx Ubuntu. 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 Amazon FSx Ubuntu:

   1. Se você ainda não registrou um repositório Amazon FSx Ubuntu na sua instância cliente, baixe e instale a chave pública necessá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 FSx pacotes da Amazon ao seu gerenciador de pacotes local usando o comando 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 do que a das instâncias EC2 baseadas em Graviton 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 Lustre pacotes necessários para montar e interagir com seu sistema de arquivos FSx for 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 Lustre cliente no SUSE Linux 12 SP3, SP4, ou SP5
<a name="install-lustre-client-SUSE-Linux"></a>

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

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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 Lustre cliente no SUSE Linux 12 SP4**

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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ê instalou SP4 diretamente, baixe e instale o Lustre cliente com os seguintes comandos.

     ```
     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ê migrou de SP3 para SP4 e adicionou anteriormente o FSx repositório da Amazon SP3, baixe e instale o Lustre cliente com os seguintes comandos.

     ```
     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 Lustre cliente no SUSE Linux 12 SP5**

1. Abra um terminal no seu cliente.

1. Instale a chave pública FSx rpm da Amazon usando o comando 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ê instalou SP5 diretamente, baixe e instale o Lustre cliente com os seguintes comandos.

     ```
     sudo zypper ar --gpgcheck-strict fsx-lustre-client.repo
     sudo zypper refresh
     sudo zypper in lustre-client
     ```
   + Se você migrou de SP4 para SP5 e adicionou anteriormente o FSx repositório da Amazon SP4, baixe e instale o Lustre cliente com os seguintes comandos.

     ```
     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.