Dépanner les problèmes à l'aide de l'outil de diagnostic ou de l'interface graphique de NetScaler Console
Remarque
L'outil de diagnostic est applicable uniquement aux instances NetScaler intégrées ou à intégrer à l'aide de l'intégration à faible intervention basée sur Console Advisory Connect.
Pour plus d'informations, consultez Intégration à faible intervention des instances NetScaler à l'aide de NetScaler Console connect.
Lorsque vous intégrez une instance NetScaler à NetScaler Console, vous pouvez rencontrer des problèmes qui empêchent l'intégration réussie de l'instance NetScaler. En tant qu'administrateur, vous devez connaître la raison de l'échec de l'intégration. Vous pouvez effectuer des vérifications de diagnostic à l'aide de l'outil de diagnostic lorsque vous :
-
Rencontrez des problèmes lors de l'intégration automatique ou de l'intégration basée sur script
-
Voulez vous assurer que l'instance NetScaler est prête à être intégrée
-
Voulez analyser les problèmes des instances NetScaler déjà intégrées qui affichent le statut « Arrêté » dans l'interface graphique de NetScaler Console
Si Console Advisory Connect est activé sur l'instance NetScaler, les détails de diagnostic sont automatiquement envoyés à Citrix et vous pouvez les consulter dans l'interface graphique de NetScaler Console. Si Console Advisory Connect n'est pas activé, vous pouvez utiliser manuellement l'outil de diagnostic.
Utiliser manuellement l'outil de diagnostic
L'outil de diagnostic est disponible dans le cadre de la mise à niveau
mastools (13.1-2.x ou version ultérieure) et accessible à l'adresse /var/mastools/scripts. Vous pouvez vérifier la version mastools en exécutant la commande cat /var/mastools/version.txt dans l'instance NetScaler.
Pour exécuter l'outil de diagnostic :
-
À l'aide d'un client SSH, connectez-vous à l'instance NetScaler.
-
Tapez shell et appuyez sur Entrée pour passer en mode bash.
-
Tapez
cd /var/mastools/scripts. -
Tapez
sh mastools_diag.
L'outil démarre et affiche les résultats des vérifications de diagnostic suivantes :
-
la commande nscli
-
Configuration DNS
-
Connexion Internet
-
Connexion de l'instance à ADM
-
Privilège utilisateur
Si les problèmes persistent même après le dépannage, vous pouvez contacter le support. Lorsque vous contactez le support, vous devez fournir les informations de configuration qui s'affichent après l'exécution de l'outil de diagnostic.
Voici un exemple de résultats de diagnostic pour une instance NetScaler qui ne présente aucun problème :
-
1 – Affiche le type de vérification de diagnostic
-
2 – Affiche les résultats de la vérification de diagnostic en vert ou en rouge. Le vert indique que le résultat est réussi et le rouge indique que le résultat n'est pas réussi.
-
3 – Affiche les informations de configuration de NetScaler Console en jaune chaque fois que vous exécutez l'outil de diagnostic. Si vous souhaitez contacter le support NetScaler, vous devez fournir ces informations.
Valider la préparation de l'instance NetScaler pour l'intégration à l'aide de l'outil de diagnostic
Avant d'intégrer l'instance NetScaler à NetScaler Console, vous pouvez vérifier la préparation de l'instance NetScaler en exécutant l'outil de diagnostic sur l'instance NetScaler. Si l'instance NetScaler ne présente aucun problème et est prête à être intégrée, l'outil affiche le message device not claimed on ADM.
Afficher les informations de diagnostic NetScaler dans l'interface graphique de NetScaler Console
Accédez à Infrastructure > Instances > NetScaler et cliquez sur Inventaire des ressources pour voir la nouvelle option État de préparation à l'intégration qui fournit l'état de préparation à l'intégration de l'instance NetScaler, tel que Nécessite une révision ou OK.
-
Nécessite une révision. L'instance NetScaler présente des problèmes qui doivent être résolus.
-
OK. L'instance NetScaler est prête à être intégrée.
Remarque :
Si l'option État de préparation à l'intégration apparaît vide, cela signifie que l'instance NetScaler ne fonctionne pas avec la dernière image prenant en charge le diagnostic.
Si l'instance NetScaler présente des problèmes, l'option Nécessite une révision apparaît, et vous pouvez cliquer dessus pour afficher plus de détails.
Après avoir cliqué sur Nécessite une révision, la page Détails du diagnostic NetScaler affiche les détails du problème.
-
Catégorie. Fournit la catégorie du problème.
-
Statut. Fournit le statut du problème, tel que Nécessite une révision, OK ou Non applicable.
-
Recommandation. Fournit la recommandation requise pour résoudre le problème.
Après avoir résolu le problème, le statut dans l'état de préparation à l'intégration passe à OK.
Dépannage
Voici quelques-uns des problèmes d'instance NetScaler et leurs étapes de dépannage :
Nom d'utilisateur ou mot de passe invalide
Solution de contournement : Assurez-vous que le nom d'utilisateur et le mot de passe fournis dans le profil d'administrateur sont corrects. Si vous avez modifié le mot de passe de l'instance NetScaler, vous devez modifier les profils d'administrateur des instances. Pour plus d'informations, consultez Modifier le profil d'administrateur.
Erreur de configuration DNS
Solution de contournement : Assurez-vous que le DNS est configuré ou que l'adresse IP du DNS est valide. Pour plus d'informations, consultez Configuration DNS.
Pas de connexion Internet
Solution de contournement : Assurez-vous que le paramètre du pare-feu ne bloque pas l'accès à Internet et que le proxy requis est configuré.
Pas de connexion au point de terminaison NetScaler Console
Solution de contournement : Vérifiez les paramètres du pare-feu et assurez-vous que les points de terminaison NetScaler Console suivants ne sont pas bloqués dans le pare-feu :
ADM_GRP_EP = "adm.cloud.com"
ADM_AGENT_EP = "agent.adm.cloud.com"
ADM_TRUST_EP = "trust.citrixnetworkapi.net"
ADM_DOWNLOAD_EP = "download.citrixnetworkapi.net"
Si aucun problème n'est détecté lors des vérifications de diagnostic et que le problème de connexion persiste, notez les informations de configuration de NetScaler Console (disponibles en jaune) et contactez le support NetScaler.
Lorsque vous effectuez un essai pour vous assurer que l'instance NetScaler est prête à être intégrée, les problèmes suivants peuvent être rencontrés :
Délai d'expiration de l'exécution à blanc de l'agent intégré
Si les résultats de l'exécution à blanc ne sont pas récupérés dans les 5 minutes, un message de délai d'attente apparaît.
Délai d'attente(/en-us/netscaler-console-service/media/onboarding-timeout.png)
Recommandation : Il est recommandé de vérifier si l'instance NetScaler fonctionne avec la dernière image prenant en charge les diagnostics. De plus, dans le tableau de sélection des actifs, la colonne « Onboarding Readiness » apparaît vide.
Contour rouge sur la liste déroulante du profil de l'appareil
L'authentification NetScaler échoue lors de l'exécution à blanc et un contour rouge apparaît sur la liste déroulante du profil de l'appareil.
Erreur de profil(/en-us/netscaler-console-service/media/builtin-agent-dry-run.png)
Recommandation : Saisissez à nouveau les informations d'identification de l'administrateur utilisateur NetScaler, créez le profil de l'appareil et cliquez sur Tester pour exécuter à nouveau l'exécution à blanc.