Dépanner les erreurs de déploiement des outils ONTAP
Suggérer des modifications
PDF
En cas de problème de déploiement, consultez les journaux et les codes d'erreur pour diagnostiquer et résoudre les problèmes. À partir de ONTAP tools for VMware vSphere 10.5, les ensembles de journaux collectés à partir des pods incluent les journaux de MongoDB, RabbitMQ et Vault, ainsi que l'état et la description de tous les pods. Ces éléments s'ajoutent aux journaux de service existants des ONTAP tools, améliorant ainsi la capacité de support et de dépannage.
Collectez les fichiers journaux
Vous pouvez collecter les fichiers journaux pour ONTAP tools for VMware vSphere à partir des options disponibles dans l'interface utilisateur du gestionnaire ONTAP tools. Le support technique peut vous demander de collecter les fichiers journaux pour aider à résoudre un problème.
|
La génération de journaux à partir du gestionnaire d'outils ONTAP inclut tous les journaux pour toutes les instances de serveur vCenter. La génération de journaux à partir de l'interface utilisateur du client vCenter est limitée au serveur vCenter sélectionné. |
-
Lancez ONTAP tools Manager depuis un navigateur Web :
https://<ONTAPtoolsIP>:8443/virtualization/ui/ -
Connectez-vous avec les identifiants d'administrateur ONTAP tools for VMware vSphere que vous avez fournis lors du déploiement.
-
Sélectionnez Log Bundles dans la barre latérale.
Cette opération peut prendre plusieurs minutes.
-
Sélectionnez Générer pour générer les fichiers journaux.
-
Saisissez le libellé du bundle de journaux et sélectionnez Générer.
Téléchargez le fichier tar.gz et envoyez-le au support technique.
Suivez les étapes ci-dessous pour générer un bundle de journaux à l'aide de l'interface utilisateur du client vCenter :
-
Connectez-vous au client vSphere.
-
Depuis la page d'accueil du vSphere Client, accédez à Support > Log bundle > Generate.
-
Indiquez l'étiquette du paquet journal et générez le paquet journal. Vous pouvez voir l'option de téléchargement lorsque les fichiers sont générés. Le téléchargement peut prendre un certain temps.
|
|
Le fichier journal généré remplace le fichier journal généré au cours des 3 derniers jours ou des dernières 72 heures. |
Codes d'erreur de déploiement
Vous pourriez rencontrer des codes d'erreur lors du déploiement, du redémarrage et des opérations de récupération des outils ONTAP pour VMware vSphere. Les codes d'erreur sont composés de cinq chiffres, où les deux premiers représentent le script ayant rencontré le problème et les trois derniers représentent le workflow spécifique dans ce script.
Tous les journaux d'erreurs sont enregistrés dans le fichier ansible-perl-errors.log sous le répertoire /var/log afin de faciliter le suivi et la résolution des problèmes. Ce fichier journal contient le code d'erreur et la tâche Ansible ayant échoué.
|
|
Les codes d'erreur affichés sur cette page sont fournis à titre indicatif uniquement. Veuillez contacter l'équipe d'assistance si l'erreur persiste ou si aucune solution n'est mentionnée. |
Le tableau suivant répertorie les codes d'erreur et les noms de fichiers correspondants.
Code d'erreur |
Nom du script |
00 |
firstboot-network-config.pl, mode déploiement |
01 |
firstboot-network-config.pl, mode mise à niveau |
02 |
firstboot-inputs-validation.pl |
03 |
firstboot-deploy-otv-ng.pl, déploiement, HA |
04 |
firstboot-deploy-otv-ng.pl, déploiement, non-HA |
05 |
firstboot-deploy-otv-ng.pl, reboot |
06 |
firstboot-deploy-otv-ng.pl, mise à niveau, HA |
07 |
firstboot-deploy-otv-ng.pl, mise à niveau, non-HA |
08 |
firstboot-otv-recovery.pl |
09 |
post-deploy-upgrade.pl |
Les trois derniers chiffres du code d'erreur indiquent l'erreur spécifique survenue dans le script :
Code d'erreur de déploiement |
Flux de travail |
Résolution |
049 |
Pour le réseau et la validation, le script Perl les assignera également prochainement. |
- |
050 |
La génération de la clé SSH a échoué |
Redémarrez la machine virtuelle principale (VM). |
053 |
Échec de l'installation de RKE2 |
Exécutez la commande suivante et redémarrez la VM principale ou redéployez : sudo rke2-killall.sh (toutes les VM) sudo rke2-uninstall.sh (toutes les VM). |
054 |
Échec de la configuration de kubeconfig |
Redéployer |
055 |
Échec du déploiement du registre |
Si le pod de registre est présent, attendez que le pod soit prêt, puis redémarrez la machine virtuelle principale ou redéployez. |
059 |
KubeVip le déploiement a échoué |
Assurez-vous que l'adresse IP virtuelle du plan de contrôle Kubernetes et l'adresse IP des outils ONTAP fournies lors du déploiement appartiennent au même VLAN et sont des adresses IP libres. Redémarrez si tous les points précédents sont corrects. Sinon, redéployez. |
060 |
Le déploiement de l'opérateur a échoué |
Redémarrer |
061 |
Le déploiement des services a échoué |
Effectuez un débogage Kubernetes de base comme get pods, get rs, get svc, etc. dans l'espace de noms ntv-system pour plus de détails et les journaux d'erreurs dans /var/log/ansible-perl-errors.log et /var/log/ansible-run.log, puis redéployez. |
062 |
Le déploiement des services ONTAP tools a échoué |
Consultez les journaux d'erreurs à /var/log/ansible-perl-errors.log pour plus de détails et redéployez. |
065 |
L'URL de la page Swagger est inaccessible |
Redéployer |
066 |
Les étapes de post-déploiement du certificat de passerelle ont échoué |
Pour récupérer/terminer la mise à niveau, procédez comme suit :
|
088 |
La configuration de la rotation des journaux pour journald a échoué |
Vérifiez que les paramètres réseau de la machine virtuelle sont compatibles avec l'hôte qui l'héberge. Vous pouvez essayer de migrer la machine virtuelle vers un autre hôte et de la redémarrer. |
089 |
La modification du propriétaire du fichier de configuration de rotation du journal récapitulatif a échoué |
Redémarrez la machine virtuelle principale. |
096 |
Installer le provisionneur de stockage dynamique |
- |
108 |
Le script de seeding a échoué |
- |
114 |
La mise à jour du certificat interne dans la collection MongoDB a échoué |
Si le déploiement échoue avec le code d'erreur 114, procédez comme suit :
|
Code d'erreur de redémarrage |
Flux de travail |
Résolution |
067 |
Délai d'attente du serveur rke2 expiré. |
- |
101 |
Échec de la réinitialisation du mot de passe de l'utilisateur Maint/Console. |
- |
102 |
Échec de la suppression du fichier de mot de passe lors de la réinitialisation du mot de passe de l'utilisateur Maint/Console. |
- |
103 |
Échec de la mise à jour du mot de passe du nouvel utilisateur Maint/Console dans le coffre-fort. |
- |
088 |
La configuration de la rotation des journaux pour journald a échoué. |
Vérifiez que les paramètres réseau de la machine virtuelle sont compatibles avec l'hôte qui l'héberge. Vous pouvez essayer de migrer la machine virtuelle vers un autre hôte et de la redémarrer. |
089 |
La modification du propriétaire du fichier de configuration de rotation du journal récapitulatif a échoué. |
Redémarrez la machine virtuelle. |