Citrix ADC

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

Si la solution matérielle-logicielle ne fonctionne pas comme prévu une fois le processus d’installation, de mise à niveau ou de mise à niveau antérieure terminé, la première chose à faire est de rechercher les causes les plus courantes 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 :

  • Les fichiers de configuration de la solution matérielle-logicielle. Dans le cas d’une paire haute disponibilité, les fichiers de configuration des deux solutions matérielles-logicielles.
  • Les fichiers suivants de la ou des solutions matérielle-logicielles :
    • Les fichiers newnslog pertinents.
    • Le fichier ns.log.
    • Le fichier de messages.
  • Un diagramme de topologie du réseau.

Problèmes et résolutions

Voici les problèmes d’installation, de mise à niveau et de rétrogradation 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 d’une 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’un dispositif 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

    La mise à niveau d’une appliance Citrix ADC à l’aide de l’interface graphique se bloque.

    Résolution

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

  5. Problème

    La mise à niveau d’une appliance Citrix ADC échoue en raison du manque d’espace 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 du logiciel

    Cause

    Au cours du processus de mise à niveau du logiciel, 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 à la solution matérielle-logicielle.

    Résolution

    • Vérifiez que la solution matérielle-logicielle est accessible depuis la console.
    • Vérifiez l’adresse NSIP et les routes sur la solution matérielle-logicielle.
      • Si l’adresse IP est passée à l’adresse IP 192.168.100.1 par défaut, modifiez l’adresse IP si nécessaire.
      • Vérifiez que la solution matérielle-logicielle est accessible.
  7. Problème

    Au cours d’une mise à niveau, si j’exécute la commande de synchronisation, le message suivant apparaît :

    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 (set /unset /bind /unbind) lorsque la synchronisation haute disponibilité (HA) est en cours.

  8. Problème

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

    Résolution

    • Recherchez 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 un MAC virtuel s’il n’est pas déjà utilisé.
    • Exécutez la commande sendarp —a depuis le 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 à l’adresse /nsconfig/ssh/ssh_host_*.
    • Consultez la configuration SSHD personnalisée à l’adresse /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 Forcer le basculement HA, les périphériques continuent de redémarrer. Le périphérique secondaire n’apparaît 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 versions ne sont pas identiques et que les nœuds HA ne correspondent pas à la version, certains champs sont affichés comme UNKNOWN lorsque vous exécutez la commande show ha node.
    • Vérifiez si la solution matérielle-logicielle secondaire est accessible.
  12. Problème

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

    Résolution

    Vérifiez que l’adresse SNIP est active sur la solution matérielle-logicielle 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 le dispositif secondaire.

    Résolution

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

    • définir le nœud hastate enable
    • activer le mode hasync du nœud

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

  14. Problème

    Après avoir effectué une mise à niveau antérieure, 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 une mise à niveau.

    Résolution

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

  16. Problème

    Au cours du 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 du 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 modèles 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 patset 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 patset en exécutant la commande suivante :

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

    Remarque : Les patsets sont pris en charge uniquement dans la version 9.3 ou ultérieure.

  17. Problème

    Lors de la mise à niveau d’une appliance Citrix ADC VPX, on me dit de libérer de l’espace dans /var. Quels fichiers dois-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 forcer le basculement HA sur le dispositif secondaire.

    Résolution

    Ouvrez une session sur 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 de 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. Fermez cette instance, videz le cache du plug-in Java et rouvrez-la.

    Résolution

    • Ouvrez une session sur 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 l’échec de la mise à niveau 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 rétrogradation