Dépannage de la mise à niveau du vérificateur d'état
Suggérer des modifications
PDF
Apprenez à dépanner les problèmes courants de l'outil de vérification de l'état de la mise à niveau et à résoudre les erreurs pouvant bloquer la planification de la mise à niveau d'ONTAP.
Résoudre les problèmes
+
Problème : erreurs d'authentification ou d'identifiant
Symptômes:
Failed to fetch cluster details for <cluster-ip> Error connecting to ONTAP cluster: 401 Unauthorized Missing cluster credentials
Ces erreurs indiquent que Upgrade Health Checker ne parvient pas à s'authentifier auprès du cluster ONTAP en utilisant les identifiants fournis. Cela peut être dû à un nom d'utilisateur ou un mot de passe incorrect, à des autorisations insuffisantes pour le compte utilisateur, ou à un compte verrouillé ou désactivé.
Solutions :
-
Vérifiez que le nom d'utilisateur et le mot de passe sont corrects
-
Vérifiez que l'utilisateur dispose des autorisations suffisantes pour l'API REST ONTAP
-
Vérifiez si le compte est verrouillé ou désactivé
./uhc --test-connectivity cluster
+
Problème : La mise à jour automatique échoue
Symptômes:
Auto-update failed: ... Failed to download update
Ces erreurs indiquent que Upgrade Health Checker ne parvient pas à se connecter à Internet pour rechercher ou télécharger les mises à jour. Cela peut être dû à des problèmes de connectivité réseau, à des règles de pare-feu bloquant l'accès ou à des paramètres de proxy qui ne sont pas configurés correctement.
Solutions :
-
Vérifiez la connectivité internet :
./uhc --test-connectivity autoupdate
-
Vérifier l'espace disque (1 Go requis) :
df -h <location of uhc>
Problème : Le démarrage du binaire est long
Cause : Le fichier binaire est autonome et doit se décompresser avant son exécution.
Comportement attendu : La première exécution peut prendre quelques secondes à se charger. Ceci est normal. + +
Problème : « Permission refusée » ou « Impossible d’exécuter le binaire » sur /tmp
Symptômes:
[Errno 13] Permission denied OSError: [Errno 13] Permission denied: '/tmp/_MEI...' Cannot execute binary file
Cette erreur peut se produire lorsque l'outil ne parvient pas à exécuter les fichiers dans le /tmp répertoire, qui est utilisé pour extraire et exécuter les composants de l'outil. Cela peut être causé par des permissions restrictives sur le /tmp répertoire ou par des politiques de sécurité empêchant l'exécution à partir de cet emplacement.
Solutions :
-
Vérifiez si
/tmpanoexecété activé :
mount | grep /tmp # If you see noexec in the output, this is the issue.
-
[[étape 2]] Remonter
/tmpavecexec(nécessite les droits d'administrateur système root) :
# Temporary fix sudo mount -o remount,exec /tmp # Permanent fix - edit /etc/fstab # Change "noexec" to "exec" for /tmp mount point
mkdir -p /custom-tmp-path # This only needs to be done one time. TMPDIR=/custom-tmp-path ./uhc # The TMPDIR prefix has to be added every time.
|
Le chemin personnalisé doit d'abord exister pour que cette solution de contournement fonctionne. S'il n'existe pas déjà, il n'est pas créé et le système revient à l'utilisation de /tmp.
|
Problème : Délai de connexion dépassé
Symptômes:
Connection timeout Request timeout
Solutions :
-
Vérifiez la connectivité réseau au cluster
-
Vérifiez qu'aucun pare-feu ne bloque le trafic HTTPS (443)
-
Vérifiez que le cluster répond correctement et n'est pas soumis à une charge importante +
Problème : espace disque insuffisant
Symptômes:
Not enough disk space available OSError: [Errno 28] No space left on device
Solutions :
-
Vérifier l'espace disque :
df -h /tmp df -h .
-
Nettoyer les anciens runs :
# Remove old run directories rm -rf runs/<old_run_directories>
-
Nettoyer les fichiers temporaires :
# Remove temporary files rm -rf /tmp/_MEI*
+
Problème : Chemin d'exécution invalide
Symptômes:
Invalid basepath_runs: <error> RUNS path is not set Cannot create tarball: basepath_runs '<path>' does not exist
Solutions :
-
Vérifiez que le répertoire de sortie des exécutions existe et est accessible en écriture
-
Spécifiez un chemin valide via l'interface de ligne de commande :
--runs-path /valid/path -
Configurer dans config.yaml :
APP.RUNS_PATH: "/valid/path"+
Problème : version ONTAP cible non valide
Symptômes:
Invalid ONTAP version: '<version>' does not exist Invalid ONTAP version: '<version>' is not a recognized ONTAP version Downgrade is not supported. Target version must be greater than or equal to the current version.
Solutions :
-
Vérifiez le format de la chaîne de version cible (par exemple "9.16.1")
-
Assurez-vous que la version cible est plus récente ou égale à la version actuelle du cluster
-
Utilisez « current » pour conserver la version ONTAP existante :
--target-ontap-version=current+
Problème : Échec de la vérification de la signature
Symptômes:
Signature verification failed Invalid code signature
Cause : Le fichier de mise à jour téléchargé est peut-être corrompu ou a été altéré.
Solution :
-
Mise à jour manuelle - à télécharger depuis le site d'assistance NetApp
-
Vérifier la signature manuellement :
openssl dgst -sha256 -verify UHC-Linux-public.pub -signature uhc.sig uhc
+
Problème : Échec du téléchargement des données de télémétrie
Symptômes:
body.7z upload failed Telemetry endpoint is not reachable
Solutions :
-
Vérifiez la connectivité au point de terminaison de télémétrie :
./uhc --test-connectivity telemetry
+
Problème : fichier de verrouillage « MISE À JOUR EN COURS »
Symptômes:
MISE À JOUR EN COURS
Une autre instance de mise à jour automatique UHC est en cours. Veuillez patienter jusqu'à la fin de la mise à jour avant de relancer.
Cause : Un fichier de verrouillage existe suite à une précédente mise à jour.
Solutions :
-
Veuillez patienter : La mise à jour se termine généralement en 1 à 2 minutes.
-
Vérifier si les données sont obsolètes : (nettoyage automatique après 1 heure):
ls -la uhc_update.lock # If older than 1 hour, it will be auto-cleaned
-
[[étape 3]] Nettoyage manuel, si nécessaire :
rm uhc_update.lock