Citrix ADC

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

October 5, 2021

Contribution de:

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 :

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.
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.
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.
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.
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.
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
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

```
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>

```
Remarque : Les patsets sont pris en charge uniquement dans la version 9.3 ou ultérieure.
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.
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.
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.
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.
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.

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 rétrogradation

October 5, 2021

Contribution de:

October 5, 2021

Contribution de: