Dépanner les erreurs de déploiement des outils ONTAP
En cas de problèmes de déploiement, consultez les journaux et les codes d'erreur pour diagnostiquer et résoudre les problèmes. À partir de ONTAP tools pour VMware vSphere 10.6, 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. ONTAP tools 10.6 ajoute également la journalisation d'audit pour améliorer la traçabilité lors du dépannage. Ces journaux viennent s'ajouter aux journaux de service existants d'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 le Gestionnaire d'outils ONTAP à partir d'un navigateur Web :
https://<ONTAPtoolsIP>:8443/virtualization/ui/ -
Connectez-vous à l'aide des outils ONTAP pour les informations d'identification d'administrateur VMware vSphere que vous avez fournies 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 lot de journaux et sélectionnez Generate.
Téléchargez le fichier tar.gz et envoyez-le au support technique.
Pour générer un bundle de journaux à l'aide de l'interface utilisateur du client vCenter, procédez comme suit :
-
Connectez-vous au client vSphere.
-
Depuis la page d'accueil de vSphere client, accédez à support > Log bundle > Generate.
-
Indiquez l'étiquette du fichier journal et générez-le. L'option de téléchargement s'affiche une fois les fichiers générés. Le téléchargement peut prendre un certain temps.
|
|
L'ensemble de journaux généré remplace l'ensemble de journaux généré au cours des 3 derniers jours ou des 72 dernières heures. |
Codes d'erreur de déploiement
Des codes d'erreur peuvent s'afficher lors du déploiement, du redémarrage et des opérations de restauration des outils ONTAP pour VMware vSphere. Les codes d'erreur sont composés de cinq chiffres, les deux premiers chiffres représentant le script qui a rencontré le problème, et les trois derniers chiffres représentent le flux de travail spécifique de ce script.
Tous les journaux d'erreurs sont enregistrés dans le fichier ansible-perl-errors.log sous le répertoire /var/log/otvng 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 fichier correspondants.
Code d'erreur |
Nom du script |
00 |
firstboot-network-config.pl, mode deploy |
01 |
firstboot-network-config.pl, mise à niveau du mode |
02 |
firstboot-inputs-validation.pl |
03 |
firstboot-deploy-otv-ng.pl, déploiement, haute disponibilité |
04 |
firstboot-deploy-otv-ng.pl, déploiement, non HA |
05 |
firstboot-deploy-otv-ng.pl, redémarrer |
06 |
firstboot-deploy-otv-ng.pl, mise à niveau, haute disponibilité |
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 de flux de travail spécifique dans le script :
Code d'erreur de déploiement |
Workflow |
Résolution |
049 |
Pour le réseau et la validation, le script perl les attribuera également sous peu |
- |
050 |
La génération de la clé SSH a échoué |
Redémarrez la machine virtuelle (VM) principale. |
053 |
Échec de l'installation de RKE2 |
Exécutez les opérations suivantes et redémarrez la machine virtuelle principale ou redéployez : Sudo rke2-killall.sh (toutes les VM) Sudo rke2-uninstall.sh (toutes les VM). |
054 |
Échec du paramétrage kubeconfig |
Redéploiement |
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 |
Échec du déploiement KubeVip |
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/otvng/ansible-perl-errors.log et /var/log/otvng/ansible-run.log, puis redéployez. |
062 |
Le déploiement des services d'outils ONTAP a échoué |
Consultez les journaux d'erreurs à l'emplacement /var/log/otvng/ansible-perl-errors.log pour plus de détails, puis redéployez. |
065 |
L'URL de la page swagger est inaccessible |
Redéploiement |
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 du journal pour journald a échoué |
Vérifiez les paramètres réseau de la machine virtuelle compatibles avec l'hôte sur lequel la machine virtuelle est hébergée. Vous pouvez essayer de migrer vers un autre hôte et redémarrer la machine virtuelle. |
089 |
La modification de la propriété du fichier de configuration de rotation du journal de synthèse a échoué |
Redémarrez la machine virtuelle principale. |
096 |
Installer le provisionneur de stockage dynamique |
- |
108 |
Echec du script d'amorçage |
- |
Redémarrez le code d'erreur |
Workflow |
Résolution |
067 |
Délai d'attente du serveur rke2 dépassé. |
- |
101 |
Echec de la réinitialisation du mot de passe utilisateur maint/Console. |
- |
102 |
Échec de la suppression du fichier de mot de passe lors de la réinitialisation du mot de passe utilisateur maint/Console. |
- |
103 |
Échec de la mise à jour du nouveau mot de passe utilisateur maint/Console dans le coffre-fort. |
- |
088 |
La configuration de la rotation du journal pour journald a échoué. |
Vérifiez les paramètres réseau de la machine virtuelle compatibles avec l'hôte sur lequel la machine virtuelle est hébergée. Vous pouvez essayer de migrer vers un autre hôte et redémarrer la machine virtuelle. |
089 |
La modification de la propriété du fichier de configuration de rotation du journal de synthèse a échoué. |
Redémarrez l'unité VM. |