ADC

Résolution des problèmes liés aux processus d’installation, de mise à niveau et de mise à niveau

Si l’appliance ne fonctionne pas comme prévu après l’installation, la mise à niveau ou la rétrogradation, la première chose à faire est de vérifier les causes les plus fréquentes du problème.

Ressources pour le dépannage

Pour obtenir de meilleurs résultats, utilisez les ressources suivantes pour résoudre un problème lié à l’installation, à la mise à niveau ou à la rétrogradation d’un Citrix ADC :

  • Fichiers de configuration de l’appliance. Dans le cas d’une paire haute disponibilité, les fichiers de configuration des deux appliances.
  • Les fichiers suivants de la ou des appliance (s) :
    • Les fichiers newnslog pertinents.
    • Le fichier ns.log.
    • Le fichier de messages.
  • Diagramme de topologie de réseau.

Questions et résolutions

Voici les problèmes d’installation, de mise à niveau et de mise à niveau les plus courants, ainsi que des conseils pour les résoudre :

  1. Problème

    La mise à niveau d’une appliance Citrix ADC MPX échoue en raison de l’incompatibilité matérielle et logicielle.

    Résolution

    Consultez la matrice de compatibilité matérielle et logicielle Citrix ADC MPX et vérifiez si la version logicielle est prise en charge sur le matériel Citrix ADC MPX.

  2. Problème

    La mise à niveau d’une appliance Citrix ADC VPX échoue en raison de l’incompatibilité de l’appliance Citrix ADC VPX et de l’hyperviseur.

    Résolution

    Consultez la matrice de compatibilité de l’appliance Citrix ADC VPX et de l’hyperviseur et vérifiez si le modèle d’appliance Citrix ADC VPX est pris en charge sur l’hyperviseur.

  3. Problème

    La mise à niveau d’une appliance Citrix ADC échoue en raison d’erreurs matérielles.

    Résolution

    Valider l’intégrité de l’appliance Citrix ADC. Si vous disposez d’une appliance matérielle Citrix ADC, Citrix vous recommande fsck d’exécuter une vérification de disque et de valider l’intégrité du disque dur Citrix ADC.

    Pour plus d’informations, consultez Comment vérifier l’intégrité du système de fichiers d’une appliance Citrix ADC.

  4. Problème

    Mise à niveau d’une appliance Citrix ADC à l’aide des stalls de l’interface graphique.

    Résolution

    Actualisez le navigateur pour vérifier si la mise à niveau progresse ou non.

  5. Problème

    Échec de la mise à niveau d’une appliance Citrix ADC en raison d’un espace insuffisant dans le répertoire /var

    Résolution

    Libérez de l’espace sur le répertoire /var. Pour plus d’informations, reportez-vous à la section Comment libérer de l’espace dans le répertoire /var.

  6. Problème

    Le Citrix ADC n’est pas accessible après la mise à niveau logicielle

    Cause

    Au cours du processus de mise à niveau logicielle, si le fichier de configuration de la version et de la version existantes ne correspond pas au fichier de configuration de la version et de la version antérieures, l’appliance ne peut pas charger la configuration et l’adresse IP par défaut est attribuée à l’appliance.

    Résolution

    • Vérifiez que l’appliance est accessible depuis la console.
    • Vérifiez l’adresse NSIP et les itinéraires sur l’appliance.
      • Si l’adresse IP a changé pour l’adresse IP 192.168.100.1 par défaut, modifiez l’adresse IP comme requis.
      • Vérifiez que l’appliance est accessible.
  7. Problème

    Lors d’une mise à niveau, si j’exécute la commande pour la synchronisation, le message suivant s’affiche :

    La commande a échoué sur le nœud secondaire mais a réussi sur le nœud principal.

    Résolution

    N’exécutez aucune commande dépendante (définissez /unset /bind /unbind) lorsque la synchronisation haute disponibilité (HA) est en cours.

  8. Problème

    Lors d’un processus de mise à niveau, le trafic ne passe pas par le nouveau nœud principal lorsque vous exécutez la commande force de basculement.

    Résolution

    • Vérifiez les problèmes liés à la topologie du réseau et aux configurations des commutateurs.
    • Exécutez la commande set L2param -garpreply ENABLED pour activer la réponse GARP.
    • Essayez d’utiliser le MAC virtuel s’il n’est pas déjà utilisé.
    • Exécutez la commande sendarp —a à partir du nœud principal.
  9. Problème

    Après la mise à niveau ou la rétrogradation d’une appliance Citrix ADC, la connexion à l’appliance échoue via SSH.

    Résolution

    Effectuez les opérations suivantes dans l’appliance Citrix ADC :

    • Supprimez les clés d’hôte anciennes ou non sécurisées à /nsconfig/ssh/ssh_host_*.
    • Vérifiez la configuration SSHD personnalisée sur /nsconfig/sshd_config et vérifiez si elle est toujours pertinente et compatible. Renommez ou supprimez la configuration SSHD personnalisée en conséquence.
    • Redémarrage à froid de l’appliance Citrix ADC
  10. Problème

    Dans une paire HA, après avoir exécuté la commande force HA basculement, les périphériques continuent à redémarrer. Le périphérique secondaire ne vient pas après une mise à niveau.

    Résolution

    Vérifiez si le répertoire /var est plein. Si c’est le cas, supprimez les anciens fichiers d’installation. Exécutez la commande df —h pour afficher l’espace disque disponible.

  11. Problème

    Après la mise à niveau d’une paire HA, l’un des nœuds est répertorié comme état UNKNOWN.

    Résolution

    • Vérifiez si les deux nœuds exécutent la même version. Si les builds ne sont pas identiques et que les nœuds HA présentent une incompatibilité de version, certains champs sont affichés comme INCONNU lorsque vous exécutez la commande show ha node.
    • Vérifiez si l’appliance secondaire est accessible.
  12. Problème

    Après la mise à niveau du Citrix ADC, l’interface montre que la plupart des serveurs virtuels et des services d’équilibrage de charge sont DOWN.

    Résolution

    Vérifiez que l’adresse SNIP est active sur l’appliance secondaire. Tapez également la commande show service pour voir si le service est en cours d’exécution.

  13. Problème

    Après avoir effectué une mise à niveau, tous les serveurs virtuels sont en panne sur l’appliance secondaire.

    Résolution

    Activez l’état HA et la synchronisation HA en exécutant les commandes suivantes :

    • set node hastate enable
    • set node hasync enable

    La désactivation de l’HA n’est pas recommandée.

  14. Problème

    Après avoir effectué une rétrogradation, le Citrix ADC ne démarre pas correctement.

    Résolution

    Vérifiez si la licence correcte a été installée.

  15. Problème

    Dans une paire HA, certaines fonctionnalités ne sont pas synchronisées après l’exécution d’une mise à niveau.

    Résolution

    Exécutez la commande sync ha file misc pour synchroniser les fichiers de configurations du nœud principal au nœud secondaire.

  16. Problème

    Pendant le redémarrage, le message d’erreur suivant s’affiche :

    Une ou plusieurs commandes dans ns.conf ont échoué Que dois-je faire ?

    Résolution

    Assurez-vous qu’aucune commande dans le fichier ns.conf ne dépasse la limite de 255 octets. Dans les commandes qui créent des stratégies trop longues pour la limite de 255 octets, vous pouvez utiliser des jeux de motifs pour raccourcir les stratégies.

    Exemple :

    add cs policy p11 -rule 'HTTP.REQ.URL.ENDSWITH_ANY("ctx_file_extensions")'
    Done
    <!--NeedCopy-->
    

    ctx_file_extensions est un jeu de patchs par défaut qui couvre un grand nombre d’extensions. En plus des jeux de motifs par défaut, vous pouvez créer des jeux de motifs définis par l’utilisateur. Ajoutez un jeu de patset en exécutant la commande suivante :

    add patset <name>
    <!--NeedCopy-->
    

    Remarque : les jeux de patchs ne sont pris en charge que dans la version 9.3 ou ultérieure.

  17. Problème

    Lors de la mise à niveau d’une appliance Citrix ADC VPX, on m’a dit de libérer de l’espace dans /var. Quels fichiers puis-je supprimer ?

    Résolution

    Supprimez les anciens fichiers d’installation du répertoire /var/tmp/. Supprimez également les fichiers indésirables de /flash.

  18. Problème

    Il n’y a pas de connectivité à l’interface utilisateur graphique (GUI) lorsque vous exécutez la commande Force HA basculement sur incident sur l’appliance secondaire.

    Résolution

    Connectez-vous à l’appliance secondaire à l’aide de l’interface de ligne de commande et activez l’accès à l’interface graphique en exécutant la <IP> commande set ns ip -gui enabled.

  19. Problème

    Après avoir effectué une mise à niveau, et lorsque je clique sur un lien sur l’interface graphique qui doit charger une applet java (Assistant de mise à niveau ou Assistant de licence), le message d’erreur suivant apparaît : la version de l’interface graphique ne correspond pas à la version du noyau. Veuillez fermer cette instance, effacer le cache du plug-in java et rouvrir.

    Résolution

    • Ouvrez une session sur le Citrix ADC à l’aide de l’interface graphique.
    • Accédez à Citrix ADC Gateway > Paramètres globaux.
    • Cliquez sur Modifier les paramètres globaux sous Paramètres.
    • Dans le volet d’informations, sous Expérience client, sélectionnez Par défaut dans la liste des thèmes de l’interface utilisateur.
    • Cliquez sur OK.
  20. Problème

    Si la mise à niveau d’une appliance Citrix ADC a échoué pour une raison quelconque, comment restaurer l’appliance à l’aide des fichiers sauvegardés ?

    Résolution

    Si la mise à niveau échoue, restaurez l’appliance à la version précédente de l’appliance Citrix ADC à l’aide des fichiers sauvegardés. Pour plus d’informations, voir Sauvegarde et restauration d’une appliance Citrix ADC.

    Pour plus d’informations sur la sauvegarde et la restauration d’une configuration de cluster Citrix ADC, voir Sauvegarde et restauration d’une configuration de cluster.

  21. Problème

    Si des licences sont manquantes après une mise à niveau échouée d’une appliance Citrix ADC, comment résoudre le problème ?

    Résolution

    Si une licence est manquante ou si vous souhaitez réallouer les licences, reportez-vous à la rubrique Présentation des licencesci-dessous.

Remarque

Ces étapes de dépannage s’appliquent également aux problèmes de perte de configuration lors de la rétrogradation du logiciel sur plusieurs versions.

Pour tout autre problème, consultez les notes de mise à jour, les articles du Centre de connaissances et les FAQ.

Résolution des problèmes liés aux processus d’installation, de mise à niveau et de mise à niveau