Citrix ADC

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

January 21, 2021

Contribution de:

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 :

Problème

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

Résolution

Consultez le Matrice de compatibilité de l’appliance Citrix ADC MPX et vérifiez si la version logicielle est prise en charge sur le matériel Citrix ADC MPX.
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 le 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.
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, reportez-vous à la section Comment faire pour vérifier l’intégrité du système de fichiers d’une appliance Citrix ADC.
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.
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 sur le répertoire /var.
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
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
```
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>
```
Remarque : les jeux de patchs ne sont pris en charge que dans la version 9.3 ou ultérieure.
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.
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.
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.
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, reportez-vous à la section 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, reportez-vous à la section Sauvegarde et restauration d’une configuration de cluster.
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éaffecter les licences, reportez-vous à la rubrique suivante Présentation du système de licences.

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.

La version officielle de ce document est en anglais. Certains contenus de la documentation Citrix ont été traduits de façon automatique à des fins pratiques uniquement. Citrix n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Citrix à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Citrix, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Citrix ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

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

January 21, 2021

Contribution de:

January 21, 2021

Contribution de: