Skip to main content
ONTAP tools for VMware vSphere 105
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Solucionar erros de implantação das ONTAP tools

Colaboradores netapp-revathid

Se você encontrar problemas de implantação, revise os logs e os códigos de erro para diagnosticar e resolver problemas. A partir do ONTAP tools for VMware vSphere 10.5, os pacotes de logs coletados dos pods incluem logs do MongoDB, RabbitMQ e Vault, juntamente com o status e as descrições de todos os pods. Esses logs são fornecidos além dos logs de serviço existentes do ONTAP tools, aprimorando a capacidade de suporte e a solução de problemas.

Colete os arquivos de log

Você pode coletar arquivos de log para ONTAP tools for VMware vSphere a partir das opções disponíveis na interface de usuário do ONTAP tools Manager. O suporte técnico pode solicitar que você colete os arquivos de log para ajudar na solução de um problema.

Observação A geração de logs a partir do ONTAP tools Manager inclui todos os logs de todas as instâncias do servidor vCenter. A geração de logs a partir da interface de usuário do cliente vCenter é limitada ao servidor vCenter selecionado.
Passos
  1. Inicie o ONTAP tools Manager a partir de um navegador da web: https://<ONTAPtoolsIP>:8443/virtualization/ui/

  2. Faça login com as credenciais de administrador das ONTAP tools for VMware vSphere que você forneceu durante a implantação.

  3. Selecione Pacotes de Logs na barra lateral.

    Essa operação pode levar vários minutos.

  4. Selecione Gerar para gerar os arquivos de log.

  5. Insira o rótulo para o pacote de logs e selecione Gerar.

    Baixe o arquivo tar.gz e envie-o para o suporte técnico.

Siga os passos abaixo para gerar um pacote de logs usando a interface de usuário do cliente vCenter:

Passos
  1. Faça login no cliente vSphere.

  2. Na página inicial do vSphere Client, acesse Suporte > Pacote de logs > Gerar.

  3. Forneça o rótulo do pacote de logs e gere o pacote de logs. Você verá a opção de download quando os arquivos forem gerados. O download pode levar algum tempo.

Observação O pacote de logs gerado substitui o pacote de logs gerado nos últimos 3 dias ou 72 h.

Códigos de erro de implantação

Você pode encontrar códigos de erro durante a implantação, reinicialização e operações de recuperação das ONTAP tools for VMware vSphere. Os códigos de erro têm cinco dígitos, onde os dois primeiros dígitos representam o script que encontrou o problema e os três últimos dígitos representam o fluxo de trabalho específico dentro desse script.

Todos os registros de erros são gravados no arquivo ansible-perl-errors.log, localizado no diretório /var/log, para facilitar o rastreamento e a resolução de problemas. Este arquivo de log contém o código de erro e a tarefa Ansible que falhou.

Observação Os códigos de erro fornecidos nesta página são apenas para referência. Entre em contato com a equipe de suporte se o erro persistir ou se não houver resolução mencionada.

A tabela a seguir lista os códigos de erro e os nomes de arquivo correspondentes.

Código de erro

Nome do script

00

firstboot-network-config.pl, modo deploy

01

firstboot-network-config.pl, modo upgrade

02

firstboot-inputs-validation.pl

03

firstboot-deploy-otv-ng.pl, implantar, HA

04

firstboot-deploy-otv-ng.pl, deploy, non-HA

05

firstboot-deploy-otv-ng.pl, reinicializar

06

firstboot-deploy-otv-ng.pl, upgrade, HA

07

firstboot-deploy-otv-ng.pl, atualização, não HA

08

firstboot-otv-recovery.pl

09

post-deploy-upgrade.pl

Os três últimos dígitos do código de erro indicam o erro específico no fluxo de trabalho dentro do script:

Código de erro de implantação

Fluxo de trabalho

Resolução

049

Para rede e validação, o script Perl também os atribuirá em breve

-

050

A geração da chave SSH falhou

Reinicie a máquina virtual (VM) primária.

053

Falha ao instalar o RKE2

Execute os seguintes comandos e reinicie a VM primária ou reimplemente: sudo rke2-killall.sh (todas as VMs) sudo rke2-uninstall.sh (todas as VMs).

054

Falha ao configurar o kubeconfig

Reimplantar

055

Falha ao implantar o registry

Se o pod de registro estiver presente, aguarde até que ele esteja pronto e, em seguida, reinicie a VM primária ou reimplante.

059

KubeVip A implantação falhou

Certifique-se de que o endereço IP virtual para o plano de controle do Kubernetes e o endereço IP das ONTAP tools fornecidos durante a implantação pertençam à mesma VLAN e sejam endereços IP livres. Reinicie se todos os pontos anteriores estiverem corretos. Caso contrário, reimplemente.

060

A implantação do operador falhou

Reiniciar

061

A implantação dos serviços falhou

Execute a depuração básica do Kubernetes, como get pods, get rs, get svc e assim por diante, no namespace ntv-system para obter mais detalhes e logs de erros em /var/log/ansible-perl-errors.log e /var/log/ansible-run.log e reimplante.

062

A implantação dos serviços das ONTAP tools falhou

Consulte os registros de erros em /var/log/ansible-perl-errors.log para obter mais detalhes e reimplemente.

065

O URL da página Swagger não está acessível

Reimplantar

066

As etapas pós-implantação para o certificado de gateway falharam

Siga as etapas abaixo para recuperar/concluir a atualização:

  • Ativar shell de diagnóstico.

  • Execute o comando 'sudo perl /home/maint/scripts/post-deploy-upgrade.pl --postDeploy'.

  • Verifique os registros em /var/log/post-deploy-upgrade.log.

088

A configuração de rotação de logs para o journald falhou

Verifique as configurações de rede da máquina virtual que são compatíveis com o host no qual a máquina virtual está hospedada. Você pode tentar migrar para outro host e reiniciar a máquina virtual.

089

A alteração da propriedade do arquivo de configuração de rotação do log de resumo falhou

Reinicie a máquina virtual primária.

096

Instale o provisionador de armazenamento dinâmico

-

108

O script de seeding falhou

-

114

A atualização do certificado interno na coleção do MongoDB falhou

Se a implantação falhar com o código de erro 114, siga os passos abaixo:

  • Ative o shell de diagnóstico.

  • Execute o seguinte comando: sudo perl /home/maint/scripts/post-deploy-upgrade.pl --internal_cert_update_collection

  • Analise os registros em /var/log/otvng/post-deploy-upgrade.log

Código de erro de reinicialização

Fluxo de trabalho

Resolução

067

A espera pelo rke2-server expirou.

-

101

Falha ao redefinir a senha do usuário de manutenção/console.

-

102

Falha ao excluir o arquivo de senha durante a redefinição da senha do usuário de manutenção/console.

-

103

Falha ao atualizar a senha do novo usuário de manutenção/console no cofre.

-

088

A configuração de rotação de logs para o journald falhou.

Verifique as configurações de rede da máquina virtual que são compatíveis com o host no qual a máquina virtual está hospedada. Você pode tentar migrar para outro host e reiniciar a máquina virtual.

089

A alteração da propriedade do arquivo de configuração de rotação do log de resumo falhou.

Reinicie a máquina virtual.