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 des 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 règles 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.

Si vous ne parvenez pas à convertir les stratégies classiques avant la mise à niveau, vous pouvez choisir de les convertir en stratégies avancées pendant la mise à niveau. Dans le cadre de la mise à niveau, vous pouvez choisir l’une des options décrites dans le tableau suivant lors de l’exécution de la commande ./installns.

Option Description
Aucune option En cas d’erreur lors de la vérification de préconfiguration, l’installation s’arrête. Vous devez convertir les stratégies classiques en stratégies avancées pour poursuivre le processus de mise à niveau.
-M L’outil NSPEPI est exécuté dans le cadre de l’installation et convertit les stratégies classiques en stratégies avancées.
-Y Cette option n’est pas recommandée. Dans cette option, la vérification de préconfiguration est ignorée et, par conséquent, toute configuration valide risque d’être perdue.

Pour convertir les stratégies classiques en stratégies avancées lors de la mise à niveau, sélectionnez l’option -M. L’option -M déclenche l’outil NSPEPI et met à jour le fichier ns.conf existant avec la configuration modifiée. L’ancienne configuration est présente sur /nsconfig/ns.conf_old à titre de référence future.

./installns -M`
<!--NeedCopy-->

Si vous constatez une erreur lors de la conversion avancée des stratégies, contactez l’assistance NetScaler.

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.

Remarque :

Si vous disposez de stratégies classiques et que vous souhaitez les convertir en stratégies avancées lors de la mise à niveau, vous pouvez appliquer la procédure de mise à niveau normale (configuration haute disponibilité, en cluster ou autonome), mais utilisez l’option « -M » avec la commande installns.

Si vous souhaitez convertir la configuration avant la mise à niveau, effectuez les étapes suivantes pour chaque configuration :

  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 :

      le message d’erreur « La ressource existe déjà » peut 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

Dans cet article