ADC

Considérations relatives à la mise à niveau pour les configurations utilisant des stratégies classiques

Les stratégies classiques sont déconseillées depuis NetScaler version 12.0 build 56.20. À partir de la version 13.1, la prise en charge classique des stratégies est supprimée de certaines fonctionnalités. Pour connaître la liste complète des fonctionnalités ou commandes qui ne sont pas prises en charge depuis la version 13.1, consultez le Tableau 2 de l’ avis d’annonce de changement de statut pour les fonctionnalités et fonctionnalités basées sur des stratégies de NetScaler Classic.

Comme condition préalable à la mise à niveau vers la version 13.1 ou ultérieure, nous vous recommandons de convertir les politiques classiques en politiques avancées pour les fonctionnalités prises en charge par l’outil NSPEPI. Pour connaître les fonctionnalités prises en charge par l’outil NSPEPI, consultez la section Commandes ou fonctionnalités gérées par l’outil de conversion nspepi . Si vous ne passez pas aux stratégies avancées avant la mise à niveau, celle-ci échoue en raison d’une configuration non valide.

Important :

Avant de procéder à la mise à niveau vers la version 13.1 ou ultérieure, nous vous recommandons d’exécuter l’outil de vérification de préconfiguration. Cet outil garantit que votre configuration ne contient pas de commandes liées aux fonctionnalités obsolètes ou supprimées. Si des commandes sont liées aux fonctionnalités obsolètes ou supprimées, l’outil génère une erreur et la configuration risque d’être perdue. Nous vous recommandons de télécharger la dernière version de l’outil de vérification de préconfiguration à partir du lien public GitHub -. https://github.com/citrix/ADC-scripts/tree/master/nspepi

Pour plus d’informations, consultez l’ outil de vérification de préconfiguration avant la mise à niveau.

En cas d’erreur lors de la vérification de préconfiguration, nous vous recommandons d’utiliser l’outil nspepi pour convertir les configurations non valides en configurations valides. Téléchargez la dernière version de l’outil nspepi depuis le lien public GitHub - https://github.com/citrix/ADC-scripts/tree/master/nspepi. Pour plus d’informations sur la conversion des expressions de stratégie à l’aide de l’outil nspepi, consultez la section Conversion d’expressions de stratégie à l’aide de l’outil NSPEPI.

L’outil nspepi ne gère pas la conversion pour quelques commandes ou fonctionnalités. Voir Commandes ou fonctionnalités non gérées par l’outil de conversion nspepi pour obtenir la liste complète.

Procédez comme suit pour chaque configuration différente que vous devez convertir :

  1. Exécutez l’outil nspepi sur Citrix ADC version 12.1 ou 13.0 pour convertir le fichier ns.conf. L’outil NSPEPI génère deux fichiers avec les préfixes new_ et warn_. Le fichier avec le préfixe new_ contient la configuration convertie et le fichier avec le préfixe warn_ contient les avertissements et les erreurs.
  2. Vérifiez le fichier avec le préfixe warn_ et corrigez les erreurs (le cas échéant).
  3. Testez la configuration convertie. Appliquez la configuration convertie à l’aide de l’une des options suivantes :
    1. Exécutez la clear config -f basic commande, puis procurez-vous la configuration convertie en exécutant la source /nsconfig/new_ns.conf commande.
    2. Supprimez les commandes classiques manuellement (en dissociant et en supprimant les stratégies), puis créez la configuration convertie en exécutant la commande source /nsconfig/new_ns.conf.

      Remarque :

      Des erreurs « La ressource existe déjà » peuvent s’afficher pour les configurations qui ne sont pas effacées à l’aide de la commande clear config -f basic. Vous pouvez ignorer ces erreurs.

  4. Enregistrez la configuration.

Après avoir réussi à convertir des configurations non valides en configurations valides, vérifiez s’il existe d’autres conditions préalables, puis procédez à la mise à niveau. Pour plus d’informations, consultez Mettre à niveau et rétrograder une appliance NetScaler.

Considérations relatives à la mise à niveau pour les configurations utilisant des stratégies classiques