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 à faible contact basée sur Citrix ADM Connect.
Pour plus d’informations, consultez la section Intégration simplifiée des instances Citrix ADC à l’aide de Citrix ADM connect.
Lorsque vous intégrez une instance ADC à Citrix 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 Citrix 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 mastools version en exécutant la cat /var/mastools/version.txt commande 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 Citrix. Lorsque vous contactez le support Citrix, vous devez fournir les informations de configuration d’ADM connect 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 Citrix ADM en jaune chaque fois que vous exécutez l’outil de diagnostic. Si vous souhaitez contacter le support Citrix, 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 à Citrix ADM, vous pouvez vérifier l’état de préparation de l’instance ADC 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 > Citrix ADC et cliquez sur Inventaire des actifs pour voir la nouvelle option de préparation à l’intégration qui indique 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, par exemple Examenrequis, OKou 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 Citrix ADM
Solution : assurez-vous de vérifier les paramètres du pare-feu et de vérifier que les points de terminaison Citrix ADM 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"
<!--NeedCopy-->
Si aucun problème n’a été détecté lors des contrôles de diagnostic et que le problème d’absence de connexion persiste, prenez note des informations de configuration de Citrix ADM (disponibles en jaune) et contactez le support Citrix.
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 d’exécution à sec intégré de l’agent
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.