Resolver problemas de conexões de cliente

Ao encontrar problemas para montar ou se conectar a um sistema de arquivos Managed Lustre em uma VM ou instância 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 pode ser acessada pela 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 tem o prefixo https://www.googleapis.com/compute/v1/. Tudo o que segue essa string precisa corresponder à saída do comando gcloud lustre instances describe.

  • Revise 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 da LNet (instâncias legadas)

Embora a flag --gke-support-enabled esteja descontinuada e não seja mais necessária ao criar novas instâncias do Managed Lustre, talvez você tenha instâncias mais antigas que foram 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 LNet para instâncias gke-support-enabled.

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, configure o LNet nas VMs de cliente.

Incompatibilidade entre a versão do kernel do Ubuntu e 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 as versões do kernel listadas nos dois comandos, reinstale os pacotes de cliente do Lustre.

Verificar se há 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 com dmesg:

dmesg | grep -i lustre

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

dmesg | grep -i error

A montagem 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 montagem da instância pode falhar. Para resolver esse problema, siga as instruções para fazer a montagem 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 montar instâncias do Managed Lustre.

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

Se as VMs clientes ou os clusters do GKE estiverem em uma rede VPC com peering e não puderem se conectar à instância do Managed Lustre, verifique o seguinte:

  • Roteamento do Network Connectivity Center (NCC):o peering de VPC sozinho não roteia o tráfego para a conexão de acesso a serviços particulares usada pelo Managed Lustre. Para se conectar a redes VPC com peering, é necessário conectar as duas redes pelo Network Connectivity Center (NCC).
  • Regras de firewall:verifique se as regras de firewall na rede VPC do host e na rede VPC com peering permitem o tráfego TCP nas portas 988 e 6988 entre as sub-redes do cliente e o intervalo de IP alocado ($CIDR_BLOCK) da instância.

Para instruções de configuração detalhadas e comandos gcloud, consulte Configurar uma rede VPC.

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

O Managed Lustre não pode ser montado em VMs protegidas. A tentativa de carregar o módulo de 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 não for possível resolver a falha de montagem, colete informações de diagnóstico antes de criar um caso de suporte. Você precisa ter acesso SSH à máquina 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 cliente. Depois, 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 dentro da toolbox para instalar o pacote sosreport:

sudo toolbox
sudo apt install sosreport -y

Anexe o arquivo sosreport ao seu caso de suporte.

Para mais informações sobre o utilitário sosreport, consulte Como coletar informações de depuração com o sosreport.