Solucionar erros de implantação das ONTAP tools
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.
|
|
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. |
-
Inicie o ONTAP tools Manager a partir de um navegador da web:
https://<ONTAPtoolsIP>:8443/virtualization/ui/ -
Faça login com as credenciais de administrador das ONTAP tools for VMware vSphere que você forneceu durante a implantação.
-
Selecione Pacotes de Logs na barra lateral.
Essa operação pode levar vários minutos.
-
Selecione Gerar para gerar os arquivos de log.
-
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:
-
Faça login no cliente vSphere.
-
Na página inicial do vSphere Client, acesse Suporte > Pacote de logs > Gerar.
-
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.
|
|
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.
|
|
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:
|
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:
|
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. |