Resolver problemas de conexões de cliente

Ao encontrar problemas para ativar ou se conectar a um sistema de arquivos do Managed Lustre em uma VM ou instância do cliente, siga estas etapas para diagnosticar o problema.

Verificar se a instância do Managed Lustre está acessível

Primeiro, verifique se a instância do Managed Lustre está acessível na instância do cliente:

sudo lctl ping IP_ADDRESS@tcp

Para receber o valor de IP_ADDRESS, consulte Receber uma instância.

Um ping bem-sucedido retorna uma resposta semelhante a esta:

12345-0@lo
12345-10.115.0.3@tcp

Um ping com falha retorna o seguinte:

failed to ping 10.115.0.3@tcp: Input/output error

Se o ping falhar:

  • Verifique se a instância do Managed Lustre e a instância do cliente estão na mesma rede VPC. Compare a saída dos seguintes comandos:

    gcloud compute instances describe VM_NAME \
      --zone=VM_ZONE \
      --format='get(networkInterfaces[0].network)'
    
    gcloud lustre instances describe INSTANCE_NAME \
      --location=ZONE --format='get(network)'
    

    A saída é semelhante a esta:

    https://www.googleapis.com/compute/v1/projects/my-project/global/networks/my-network
    projects/my-project/global/networks/my-network
    

    A saída do comando gcloud compute instances describe é prefixada com https://www.googleapis.com/compute/v1/; tudo o que segue essa string precisa corresponder à saída do comando gcloud lustre instances describe.

  • Analise as regras de firewall e as configurações de roteamento da rede VPC para garantir que elas permitam o tráfego entre a instância do cliente e a instância do Managed Lustre.

Verificar a porta de aceitação do LNet (instâncias legadas)

Embora a flag --gke-support-enabled esteja obsoleta e não seja mais necessária ao criar novas instâncias do Managed Lustre, talvez você tenha instâncias mais antigas criadas com essa flag.

Se você estiver se conectando a uma instância legada em que o suporte do GKE foi ativado, configure o LNet em todas as instâncias do Compute Engine do cliente para usar accept_port 6988. Consulte Configurar o LNet para gke-support-enabled instâncias.

Para determinar se uma instância atual foi configurada com essa flag legada, execute o seguinte comando:

gcloud lustre instances describe INSTANCE_NAME \
  --location=LOCATION | grep gkeSupportEnabled

Se o comando retornar gkeSupportEnabled: true, será necessário configurar o LNet nas VMs do cliente.

Incompatibilidade da versão do kernel do Ubuntu com o cliente Lustre

Para instâncias do Compute Engine que executam o Ubuntu, a versão do kernel do Ubuntu precisa corresponder à versão específica dos pacotes de cliente do Lustre. Se as ferramentas de cliente do Lustre estiverem falhando, verifique se a instância do Compute Engine foi atualizada automaticamente para um kernel mais recente.

Para verificar a versão do kernel:

uname -r

A resposta é semelhante ao exemplo a seguir:

6.8.0-1029-gcp

Para verificar a versão do pacote de cliente do Lustre:

dpkg -l | grep -i lustre

A resposta é semelhante ao exemplo a seguir:

ii  lustre-client-modules-6.8.0-1029-gcp 2.14.0-ddn198-1  amd64  Lustre Linux kernel module (kernel 6.8.0-1029-gcp)
ii  lustre-client-utils                  2.14.0-ddn198-1  amd64  Userspace utilities for the Lustre filesystem (client)

Se houver uma incompatibilidade entre a versão do kernel listada nos dois comandos, você deve reinstalar os pacotes de cliente do Lustre.

Verificar erros do Lustre no dmesg

Muitos avisos e erros do Lustre são registrados no buffer de anel do kernel do Linux. O comando dmesg imprime o buffer de anel do kernel.

Para pesquisar mensagens específicas do Lustre, use grep em conjunto com dmesg:

dmesg | grep -i lustre

Ou, para procurar erros mais gerais que possam estar relacionados:

dmesg | grep -i error

A ativação do Lustre em uma VM multi-NIC falha

Quando uma VM tem vários controladores de interface de rede (NICs) e a instância do Managed Lustre está em uma VPC conectada a uma NIC secundária (por exemplo, eth1), a ativação da instância pode falhar. Para resolver esse problema, siga as instruções para ativar usando uma NIC secundária.

Não é possível se conectar do intervalo de sub-rede 172.17.0.0/16

Os clientes do Compute Engine e do GKE com um endereço IP no intervalo de sub-rede 172.17.0.0/16 não podem ativar instâncias do Managed Lustre.

Não é possível acessar o Managed Lustre de um projeto pareado

Para acessar a instância do Managed Lustre de uma VM em uma rede VPC pareada, use o Network Connectivity Center (NCC). O NCC permite conectar várias redes VPC e redes locais a um hub central, fornecendo conectividade entre elas.

Para instruções sobre como configurar o NCC, consulte a documentação do Network Connectivity Center.

A ativação falha em VMs protegidas (inicialização segura)

Não é possível ativar o Managed Lustre em VMs protegidas. A tentativa de carregar o módulo do kernel do Lustre em um ambiente de inicialização segura falha com o erro: ERROR: could not insert 'lustre': Required key not available.

Informações a serem incluídas em uma solicitação de suporte

Se você não conseguir resolver a falha de ativação, colete informações de diagnóstico antes de criar um caso de suporte. Você precisa ter acesso SSH à máquina do cliente para executar os comandos nesta seção.

O utilitário sosreport coleta registros do sistema e informações de configuração e gera um arquivo tar compactado.

Para gerar um sosreport, faça SSH na máquina do cliente. Em seguida, execute:

sudo sos report --all-logs --batch --tmp-dir=/var

Se o comando não for encontrado:

Rocky Linux e RHEL

Use o gerenciador de pacotes dnf para instalar o pacote sos:

sudo dnf install -y sos

Ubuntu

Use o gerenciador de pacotes apt para instalar o pacote sosreport:

sudo apt update
sudo apt install -y sosreport

Container-Optimized OS

Use o gerenciador de pacotes apt de dentro da caixa de ferramentas para instalar o pacote sosreport:

sudo toolbox
sudo apt install sosreport -y

Anexe o arquivo sosreport ao caso de suporte.

Para mais informações sobre o utilitário sosreport, consulte Coletar informações de depuração usando o sosreport.