Résoudre les problèmes à l’aide de l’outil de diagnostic ou de l’interface graphique ADM
Remarque
L’outil de diagnostic s’applique uniquement aux instances ADC intégrées ou à intégrer à l’aide de l’intégration low-touch basée sur NetScaler ADM connect.
Pour plus d’informations, consultez la section Intégration simplifiée des instances NetScaler à l’aide de NetScaler ADM connect.
Lorsque vous intégrez une instance ADC à NetScaler ADM, vous pouvez rencontrer quelques problèmes qui empêchent l’intégration réussie de l’instance ADC. En tant qu’administrateur, vous devez connaître la raison de l’échec de l’intégration. Vous pouvez effectuer des contrôles de diagnostic à l’aide de l’outil de diagnostic lorsque vous :
-
Vous rencontrez des problèmes lors de l’intégration automatique ou de l’intégration basée sur des scripts
-
Vous voulez vous assurer que l’instance ADC est prête à être intégrée ?
-
Vous souhaitez analyser les problèmes liés aux instances ADC déjà intégrées qui affichent l’état « Inactif » dans l’interface graphique de NetScaler ADM
Si la connexion au service ADM est activée sur l’instance ADC, les détails du diagnostic sont automatiquement envoyés à Citrix et vous pouvez les consulter dans l’ interface graphique ADM. Si la connexion au service ADM n’est pas activée, vous pouvez utiliser l’outil de diagnostic manuellement.
Utiliser manuellement l’outil de diagnostic
L’outil de diagnostic est disponible dans le cadre de la mastools mise à niveau (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 ADC.
Pour exécuter l’outil de diagnostic :
-
À l’aide d’un client SSH, connectez-vous à l’instance ADC.
-
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 contrôles de diagnostic suivants :
-
nscli
-
Configuration DNS
-
connexion Internet
-
Connexion entre l’instance et l’ADM
-
Privilège utilisateur
Si les problèmes persistent même après le dépannage, vous pouvez contacter le support NetScaler. Lorsque vous contactez le support de NetScaler, vous devez fournir les informations de configuration de la connexion ADM qui s’affichent après l’exécution de l’outil de diagnostic.
Voici un exemple de résultats de diagnostic pour une instance ADC qui ne présente aucun problème :
-
1 — Affiche le type de contrôle diagnostique
-
2 — Affiche les résultats du contrôle 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 ADM en jaune chaque fois que vous exécutez l’outil de diagnostic. Si vous souhaitez contacter le support de NetScaler, vous devez fournir ces informations.
Validez la préparation de l’instance ADC pour l’intégration à l’aide de l’outil de diagnostic
Avant d’intégrer l’instance ADC à NetScaler ADM, vous pouvez vérifier si l’instance ADC est prête en exécutant l’outil de diagnostic sur l’instance ADC. Si l’instance ADC ne rencontre aucun problème et qu’elle est prête à être intégrée, l’outil affiche le message du périphérique non réclamé sur ADM .
Afficher les informations de diagnostic ADC dans l’interface graphique d’ADM
**Accédez à **Infrastructure > Instances > NetScaler et cliquez sur Asset Inventory pour voir la nouvelle option de préparation à l’ intégration qui fournit l’état de préparation à l’intégration de l’instance ADC, tel que Needs Review ou OK.**
-
Examen des besoins. L’instance ADC présente des problèmes qui doivent être résolus.
-
OK. L’instance ADC est prête à être intégrée.
Remarque
Si le champ Onboarding Readiness apparaît vide, cela signifie que l’instance ADC ne s’exécute pas avec la dernière image prenant en charge les diagnostics.
Si l’instance ADC rencontre des problèmes, l’option Needs Review apparaît et vous pouvez cliquer pour afficher plus de détails.
Une fois que vous avez cliqué sur Needs Review, la page Détails des diagnostics ADC affiche les détails du problème.
-
Catégorie. Fournit la catégorie de problème.
-
Status. Indique l’état du problème, tel que Nécessite une révision, OK ou Non applicable.
-
Recommandation. Fournit les recommandations nécessaires pour résoudre le problème.
Une fois le problème résolu, l’état de préparation à l’intégration passe à OK.
Dépanner
Voici certains des problèmes liés aux instances ADC et les étapes de résolution correspondantes :
Nom d’utilisateur ou mot de passe incorrect
Solution : 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 ADC, vous devez modifier les profils d’administration des instances. Pour plus d’informations, voir Modifier le profil d’administrateur.
Erreur de configuration DNS
Solution : Assurez-vous que le DNS est configuré ou que l’adresse IP du DNS est valide. Pour plus d’informations, consultez la section Configuration DNS.
Pas de connexion Internet
Solution : Assurez-vous que le paramètre du pare-feu ne bloque pas l’accès à Internet et que le proxy requis est configuré.
Aucune connexion au point de terminaison NetScaler ADM
Solution : vérifiez les paramètres du pare-feu et assurez-vous que les points de terminaison NetScaler ADM suivants ne sont pas bloqués par 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"
<!--NeedCopy-->
Si aucun problème n’est détecté lors des tests de diagnostic et que le problème d’absence de connexion persiste, prenez note des informations de configuration de NetScaler ADM (disponibles en jaune) et contactez le support NetScaler.
Lorsque vous effectuez un test pour vous assurer que l’instance ADC est prête à être intégrée, les problèmes suivants peuvent se produire :
Délai de fonctionnement à sec de l’agent intégré
Si les résultats de l’essai à sec ne sont pas extraits dans les 5 minutes, un message de temporisation s’affiche.
Recommandation : Il est recommandé de vérifier si l’instance ADC s’exécute avec la dernière image prenant en charge les diagnostics. De plus, dans le tableau de sélection des actifs, la colonne de préparation à l’intégration apparaît vide.
Contour rouge dans la liste déroulante du profil de l’appareil
L’authentification ADC échoue lors de l’exécution à sec et un contour rouge apparaît dans la liste déroulante du profil de l’appareil.
Recommandation : Entrez à nouveau les informations d’identification de l’administrateur utilisateur de l’ADC, créez le profil de l’appareil et cliquez sur Tester pour exécuter à nouveau l’exécution à sec.