Utiliser des tâches pour mettre à niveau les instances NetScaler

Dans la console NetScaler, vous pouvez mettre à niveau une ou plusieurs instances NetScaler. Vous devez connaître le cadre de licences et les types de licences avant de mettre à niveau une instance.

REMARQUE : si vous souhaitez mettre à niveau une instance dotée de stratégies classiques, nous vous recommandons de convertir les stratégies classiques en stratégies avancées avant de mettre à niveau l’instance, à l’aide de l’outil NSPEPI. Cela s’applique aux fonctionnalités prises en charge par l’outil NSPEPI. Pour plus d’informations, consultez la section Considérations relatives à la mise à niveau pour les configurations utilisant des stratégies classiques.

Logiciels requis

La console NetScaler effectue les contrôles de pré-validation suivants sur l’instance que vous souhaitez mettre à niveau :

  1. Vérifier l’espace disque  : nettoyez l’espace disque afin de disposer d’une capacité de disque suffisante pour la mise à niveau d’une instance. Résolvez les éventuels problèmes de disque.

  2. Rechercher des problèmes matériels de disque - Résolvez les problèmes matériels, le cas échéant.

  3. Rechercher des personnalisations - Sauvegardez vos personnalisations et supprimez-les des instances. Vous pouvez réappliquer la personnalisation sauvegardée après la mise à niveau de l’instance.

  4. Problèmesde stratégie : NetScaler ne prend pas en charge les stratégies classiques depuis 13.1la version. Avant de mettre à niveau une instance vers cette version, migrez les stratégies classiques vers les stratégies avancées.

    Pour plus d’informations, voir Stratégies classiques et avancées.

Considérations relatives à la mise à niveau pour les configurations NetScaler personnalisées

Il est important que les modifications de mise à niveau et vos personnalisations soient appliquées à une appliance NetScaler mise à niveau. Ainsi, si vous avez des fichiers de configuration personnalisés dans le répertoire /etc, consultez les considérations relatives à la mise à niveau pour les fichiers de configuration personnalisés avant de poursuivre la mise à niveau de l’appliance NetScaler. Voici les principales étapes que vous devez suivre :

  1. Étapes préalables à la mise à niveau dans NetScaler

  2. Mettez à niveau NetScaler à l’aide d’ADM. Pour effectuer la mise à niveau, suivez les instructions disponibles au début de la page.

  3. Étapes à suivre après la mise à niveau dans NetScaler

Les étapes de pré-mise à niveau et de post-mise à niveau doivent être effectuées sur chaque instance NetScaler. Toutefois, à l’étape 2, pour mettre à niveau NetScaler à l’aide d’ADM, toutes les instances NetScaler vulnérables peuvent être sélectionnées et mises à niveau ensemble.

Paire de haute disponibilité NetScaler

Lorsque vous mettez à niveau une paire NetScaler à haute disponibilité, tenez compte des points suivants :

  • Le nœud secondaire est mis à niveau en premier.

  • La synchronisation et la propagation des nœuds sont désactivées jusqu’à ce que les deux nœuds soient correctement mis à niveau.

  • Après la mise à niveau des paires haute disponibilité réussie, un message d’erreur s’affiche dans l’historique d’exécution. Ce message s’affiche si vos nœuds de la paire haute disponibilité sont sur différentes versions ou versions. Cela indique que la synchronisation entre les nœuds principaux et secondaires est désactivée.

Vous pouvez mettre à niveau une paire NetScaler à haute disponibilité en deux étapes :

  1. Créez un travail de mise à niveau et exécutez immédiatement sur l’un des nœuds ou planifiez plus tard.

  2. Planifiez ultérieurement l’exécution du travail de mise à niveau sur le nœud restant. Assurez-vous de planifier ce travail après la mise à niveau du nœud initial.

Clusters NetScaler

Lorsque vous mettez à niveau un cluster NetScaler, lors de la phase de validation préalable à la mise à niveau, la console NetScaler valide uniquement l’instance spécifiée. Vérifiez et résolvez donc les problèmes suivants sur les nœuds du cluster :

  • Personnalisation

  • Utilisation du disque

  • problèmes matériels

Création d’une tâche de mise à niveau de NetScaler

Pour créer une tâche de mise à niveau de NetScaler, procédez comme suit :

  1. Accédez à Infrastructure > Travaux de mise à niveau.

    Créer une tâche de maintenance

  2. Dans Créer des tâches de maintenance, sélectionnez Mettre à niveau NetScaler (standalone/High-Availability/Cluster) et cliquez sur Continuer.

    Sélectionnez la tâche de maintenance de mise

    Remarque :

    Pour mettre à niveau des groupes Autoscale, voir Mettre à niveau un groupe Autoscale .

  3. Dans l’onglet Sélectionner des instances ,

    1. Spécifiez le nom de votre choix pour le nom du poste.

    2. Cliquez sur Ajouter des instances pour ajouter les instances de NetScaler que vous souhaitez mettre à niveau.

      • Pour mettre à niveau une paire haute disponibilité NetScaler, sélectionnez les adresses IP de la paire haute disponibilité (indiquées par l’exposant « S » et « P »).

      • Pour mettre à niveau un cluster, sélectionnez l’adresse IP du cluster (indiquée par l’exposant « C »).

      Ajouter des instances à la tâche de maintenance de mise à niveau

    3. Cliquez sur OK.

  4. Dans l’onglet Sélectionner une image , sélectionnez une image NetScaler dans la bibliothèque d’images, dans le local ou dans l’appliance.

    • Sélectionnez dans la bibliothèqued’images : sélectionnez une image NetScaler dans la liste. Cette option répertorie toutes les images NetScaler disponibles sur le site Web de téléchargement de NetScaler.

      Images NetScaler

      Les images du logiciel NetScaler affichent les versions préférées avec l’icône en forme d’étoile. Et, les versions les plus téléchargées avec l’icône de signet.

    • Choisissez entre une application locale ou une appliance: vous pouvez télécharger l’image depuis votre ordinateur local ou depuis l’appliance NetScaler. Lorsque vous sélectionnez l’appliance NetScaler, l’interface graphique de la console NetScaler affiche les fichiers d’instance présents dans/var/mps/ns_images. Sélectionnez l’image dans l’interface graphique de la console NetScaler.

    • Ignorer le téléchargement de l’image vers NetScaler si l’image sélectionnée est déjà disponible - Cette option vérifie si l’image sélectionnée est disponible dans NetScaler. La tâche de mise à niveau ignore le téléchargement d’une nouvelle image et utilise l’image disponible dans NetScaler.

    • Nettoyer l’image logicielle de NetScaler en cas de mise à niveau réussie : cette option efface l’image téléchargée dans l’instance NetScaler après la mise à niveau de l’instance.

    Cliquez sur Suivant pour lancer la validation préalable à la mise à niveau sur les instances sélectionnées.

    Remarque :

    • Les images NetScaler téléchargées sont stockées dans l’agent et sont présentes dans/var/mps/adcimages. Ces images mises en cache peuvent être utilisées pour plusieurs mises à niveau de NetScaler, éliminant ainsi le besoin de télécharger une image à chaque mise à niveau.
    • La console NetScaler efface les images NetScaler mises en cache tous les trois jours en fonction de l’heure de dernière modification des images. Seuls les deux derniers fichiers image sont mis en cache dans l’agent à la fois.
  5. L’onglet Validation préalable à la mise à niveau contient les sections suivantes :
    • Instances prêtes à être mises à niveau. Vous pouvez poursuivre la mise à niveau de ces instances.

    • Instances bloquées lors de la mise à niveau. La mise à niveau de ces instances NetScaler est bloquée en raison d’erreurs de validation avant la mise à niveau.

      Vous pouvez vérifier et corriger les erreurs, puis cliquer sur Déplacer pour être prêt pour la mise à niveau pour les mettre à niveau. Si l’espace disque est insuffisant sur une instance, vous pouvez vérifier et nettoyer l’espace disque. Reportez-vous à la section Nettoyer l’espace disque de NetScaler.

    Rapport de validation avant mise à niveau

    • Vérificationdes stratégies : si NetScaler Console détecte des stratégies classiques non prises en charge, vous pouvez supprimer ces stratégies pour créer une tâche de mise à niveau.

    Important :

    Si vous spécifiez l’adresse IP d’un cluster, NetScaler Console effectue une validation préalable à la mise à niveau uniquement sur l’instance spécifiée et non sur les autres nœuds du cluster.

    Pour voir les divergences entre les nœuds principaux et secondaires lors d’une mise à niveau, sélectionnez le nœud haute disponibilité, puis cliquez sur Détails.

    Afficher les détails avant la mise à niveau

    Rapport sur les divergences de configuration avant mise à niveau

    • Divergences de configuration détectées dans le nœud principal haute disponibilité : affiche toutes les configurations trouvées dans le nœud secondaire de la paire NetScaler haute disponibilité, mais manquantes dans le nœud principal.

    • Divergences de configuration détectées dans le nœud secondaire haute disponibilité : affiche toutes les configurations trouvées dans le nœud principal de la paire NetScaler haute disponibilité, mais manquantes dans le nœud secondaire.

    Remarque :

    Vous pouvez ignorer les divergences suivantes pouvant apparaître dans les sections sur les divergences de configuration :

    • Configurations spécifiques à l’appareil, telles que les adresses IP.

    • Mots de passe ou certificats chiffrés, pouvant différer d’un nœud à l’autre, même si le mot de passe est identique.

    Vous pouvez examiner les divergences et choisir de les ignorer si elles ne sont pas pertinentes.

  6. Dans Scripts de validation, spécifiez les scripts à exécuter avant et après la mise à niveau d’une instance. Vous pouvez effectuer l’une des opérations suivantes :

    • Scripts de validation par défaut - Choisissez cette option pour exécuter les scripts de validation prédéfinis. Ces scripts sont exécutés avant et après la tâche de mise à niveau, générant un rapport diff pour le script de validation.

      Remarque :

      Vous ne pouvez ni modifier ni modifier cet ensemble de commandes prédéfini.

    • Scripts de validation personnalisés : choisissez cette option pour exécuter votre propre script de validation. Vous pouvez spécifier si vous souhaitez que les scripts soient exécutés avant ou après la mise à niveau. Un rapport de différences est généré uniquement si les mêmes scripts sont sélectionnés avant et après la mise à niveau.

    Scripts de validation

    Pour connaître l’ensemble de commandes de chaque configuration, cliquez sur Afficher les détails. Pour plus d’informations, consultez la section Utiliser des scripts personnalisés.

  7. Dans Planifier la tâche, sélectionnez l’une des options suivantes :

    • Mise à niveau maintenant : le travail de mise à niveau s’exécute immédiatement.

    • Planifier plus tard : sélectionnez cette option pour exécuter ce travail de mise à niveau ultérieurement. Spécifiez la date d’exécution et l’heure de début lorsque vous souhaitez mettre à niveau les instances.

    Si vous souhaitez mettre à niveau une paire NetScaler à haute disponibilité en deux étapes, sélectionnez Effectuer une mise à niveau en deux étapes pour les nœuds en haute disponibilité.

    Spécifiez la date d’exécution et l’ heure de début lorsque vous souhaitez mettre à niveau une autre instance dans la paire haute disponibilité.

    Mise à niveau de la haute disponibilité de NetScaler en deux étapes

    Pour plus d’informations, consultez la section Paire de haute disponibilité NetScaler .

  8. Dans Créer une tâche, spécifiez les détails suivants :

    Si vous planifiez le travail de mise à niveau, vous pouvez spécifier quand vous souhaitez télécharger l’image vers une instance :

    • Télécharger maintenant : sélectionnez cette option pour télécharger l’image immédiatement. Cependant, la tâche de mise à niveau s’exécute à l’heure prévue.

    • Charger au moment de l’exécution : sélectionnez cette option pour télécharger l’image au moment de l’exécution du travail de mise à niveau.

    Pour les paires à haute disponibilité, vous pouvez spécifier les nœuds sur lesquels vous souhaitez télécharger l’image :

    • Charger vers les nœuds principal et secondaire : chargez le fichier image de génération vers les nœuds principal et secondaire.

    • Charger uniquement vers le nœud secondaire : chargez le fichier image de génération uniquement vers le nœud secondaire. Une fois le nœud secondaire mis à niveau, un basculement se produit et le fichier image de génération est chargé vers le nouveau nœud secondaire qui était auparavant le nœud principal.

    Mise à niveau de haute disponibilité de NetScaler vers les nœuds

    Pour plus d’informations sur les scénarios de planification disponibles pour la paire haute disponibilité, consultez la section Planification des tâches de mise à niveau pour la paire haute disponibilité NetScaler .

    Pour plus d’informations sur les autres options de mise à niveau, consultez la section Options de mise à niveau de NetScaler .

  9. Cliquez sur Créer une tâche.

La tâche de mise à niveau apparaît dans Infrastructure > Tâches de mise à niveau. Lorsque vous modifiez une tâche existante, vous pouvez basculer vers n’importe quel onglet si les champs obligatoires sont déjà remplis. Par exemple, si vous êtes dans l’onglet Sélectionner une configuration, vous pouvez basculer vers l’onglet Aperçu des travaux.

Suspendre ou reprendre une tâche de mise à niveau planifiée

Vous pouvez également suspendre votre tâche de mise à niveau planifiée.

Pour utiliser cette fonctionnalité, accédez à Infrastructure > Tâches de mise à niveau , sélectionnez une tâche de mise à niveau planifiée existante, puis cliquez sur Arrêter pour suspendre la tâche. Pour reprendre la tâche de mise à niveau planifiée, cliquez sur Reprendre .

Arrêter ou reprendre les tâches planifiées

Remarque :

Si l’heure prévue pour la tâche de mise à niveau est dépassée après que vous ayez décidé de la reprendre, vous devez créer à nouveau la tâche de mise à niveau.

Réessayer les tâches de mise à niveau qui ont échoué

  1. Dans Infrastructure > Tâches de mise à niveau, sélectionnez la tâche de mise à niveau qui a échoué et cliquez sur Réessayer. Vous pouvez également accéder à Sélectionner une action > Réessayer la tâche de mise à niveau pour réessayer une tâche qui a échoué.

    Réessayer les tâches qui ont échoué

  2. Dans Select Instance, spécifiez les détails suivants :

    • Nom de la tâche : entrez un nom pour la mise à niveau.

    • Sélectionnez les instances NetScaler que vous souhaitez mettre à niveau dans la liste. Pour supprimer des instances, cliquez sur Supprimer.

    Cliquez sur Suivant pour commencer le processus de validation.

    Réessayer les tâches qui ont échoué

  3. L’onglet Validation préalable à la mise à niveau contient les sections suivantes :
    • Instances prêtes à être mises à niveau. Vous pouvez poursuivre la mise à niveau de ces instances.

    • Instances bloquées lors de la mise à niveau. La mise à niveau de ces instances NetScaler est bloquée en raison d’erreurs de validation avant la mise à niveau.

      Vous pouvez vérifier et corriger les erreurs, puis cliquer sur Déplacer pour être prêt pour la mise à niveau pour les mettre à niveau. Si l’espace disque est insuffisant sur une instance, vous pouvez vérifier et nettoyer l’espace disque. Reportez-vous à la section Nettoyer l’espace disque de NetScaler.

    • Vérificationdes stratégies : si NetScaler Console détecte des stratégies classiques non prises en charge, vous pouvez supprimer ces stratégies pour créer une tâche de mise à niveau.

    Réessayer les tâches qui ont échoué

    Cliquez sur Suivant.

  4. Dans Planifier la tâche, sélectionnez l’une des options suivantes :

    • Mise à niveau maintenant : le travail de mise à niveau s’exécute immédiatement.

    • Planifier plus tard : sélectionnez cette option pour exécuter ce travail de mise à niveau ultérieurement. Spécifiez la date d’exécution et l’heure de début lorsque vous souhaitez mettre à niveau les instances.

    Réessayer les tâches qui ont échoué

    Cliquez sur Réessayer.

Nettoyez l’espace disque de NetScaler

Si vous rencontrez un problème d’espace disque insuffisant lors de la mise à niveau d’une instance NetScaler, nettoyez l’espace disque depuis l’interface graphique de la console NetScaler elle-même.

  1. Dans l’onglet Validation préalable à la mise à niveau, la section Instances bloquées lors de la mise à niveau affiche les instances dont la mise à niveau a échoué en raison d’un espace disque insuffisant. Sélectionnez l’instance qui présente le problème d’espace disque.

  2. Cliquez sur Vérifier l’espace disque.

    Un volet Détails de l’espace disque apparaît. Ce volet affiche les instances, la mémoire utilisée et la mémoire disponible.

    Détails de l'espace disque

  3. Dans le volet Détails de l’espace disque, sélectionnez l’instance qui doit être nettoyée et effectuez l’une des opérations suivantes :

    1. Nettoyage de disque  : accédez aux dossiers ou répertoires requis et supprimez-les pour libérer de l’espace disque.

    2. Nettoyage rapide - Libérez rapidement de l’espace disque en supprimant plusieurs dossiers. Dans le volet Confirmer qui s’affiche, sélectionnez les dossiers que vous souhaitez supprimer, puis cliquez sur Oui.

      Nettoyage rapide

    3. Après avoir libéré de l’espace disque, vous pouvez vérifier si suffisamment d’espace disque est désormais disponible pour mettre à niveau l’instance. Dans la section Instances bloquées pour la mise à niveau, cliquez sur Revalider.

      Dans l’exemple suivant, de l’espace disque est disponible. Vous pouvez maintenant cliquer sur Déplacer vers Prêt pour la mise à niveau pour mettre à niveau l’instance ou sur Suivant pour passer à l’étape suivante.

      Valider le nettoyage

Utiliser des scripts personnalisés

Vous pouvez spécifier des scripts personnalisés lors de la création d’une tâche de mise à niveau NetScaler . Les scripts personnalisés sont utilisés pour vérifier les modifications avant et après la mise à niveau d’une instance NetScaler. Par exemple :

  • Version d’instance avant et après la mise à niveau.

  • État des interfaces, des nœuds haute disponibilité, des serveurs virtuels et des services avant et après la mise à niveau.

  • Les statistiques des serveurs et services virtuels.

  • Les routes dynamiques.

Spécifiez les scripts personnalisés à exécuter dans les étapes suivantes :

  • Avant mise à niveau : le script spécifié s’exécute avant la mise à niveau d’une instance.

  • Après mise à niveau avant basculement (applicable pour HA) : Cette étape s’applique uniquement au déploiement haute disponibilité. Le script spécifié s’exécute après la mise à niveau des nœuds, mais avant leur basculement.

  • Après mise à niveau (applicable pour autonome)/Après mise à niveau après basculement (applicable pour HA) : Le script spécifié s’exécute après la mise à niveau d’une instance dans le déploiement autonome. Dans le déploiement haute disponibilité, le script s’exécute après la mise à niveau des nœuds et leur basculement sur incident.

Remarque :

  • Assurez-vous d’activer l’exécution du script ou de la commande aux étapes requises. Sinon, les scripts spécifiés ne s’exécutent pas.

  • Le rapport diff n’est généré que si vous spécifiez le même script dans les étapes de pré-mise à niveau et de post-mise à niveau. Veillez donc à sélectionner Utiliser le même script qu’avant la mise à niveau dans les étapes qui suivent la mise à niveau. Consultez la section Télécharger un rapport de comparaison consolidé relatif à une tâche de mise à niveau de NetScaler.

Vous pouvez importer un fichier de script ou saisir des commandes directement dans l’interface graphique de la console NetScaler.

  • Importer les commandes à partir du fichier : sélectionnez le fichier d’entrée de commande à partir de votre ordinateur local.
  • Tapez les commandes : entrez les commandes directement dans l’interface graphique.

Dans la phase de post-mise à niveau, vous pouvez utiliser le même script que celui spécifié dans la phase de pré-mise à niveau.

Scripts personnalisés

Options de mise à niveau de NetScaler

Lorsque vous créez une tâche de mise à niveau NetScaler , vous pouvez sélectionner les options suivantes dans l’ onglet Créer une tâche :

  • Sauvegardez les instances de NetScaler avant de commencer la mise à niveau.: crée une sauvegarde des instances NetScaler sélectionnées.

  • Conserver l’état principal et secondaire des nœuds à haute disponibilité après la mise à niveau : sélectionnez cette option si vous souhaitez que la tâche de mise à niveau démarre un basculement après la mise à niveau de chaque nœud. De cette façon, le travail de mise à niveau conserve l’état principal et secondaire des nœuds.

  • Enregistrer la configuration NetScaler avant de commencer la mise à niveau : enregistre la configuration NetScaler en cours d’exécution avant de mettre à niveau les instances NetScaler.

  • Activez ISSU pour éviter les pannes de réseau sur une paireNetScaler HA - ISSU garantit une mise à niveau sans interruption sur une paire NetScaler haute disponibilité. Cette option fournit une fonctionnalité de migration qui respecte les connexions existantes lors de la mise à niveau. Vous pouvez ainsi mettre à niveau une paire NetScaler à haute disponibilité sans interruption. Spécifiez le délai de migration ISSU en minutes.

  • Recevoir le rapport d’exécution par e-mail - Envoie le rapport d’exécution par e-mail. Pour ajouter une liste de distribution d’e-mails, voir Créer une liste de distribution d’e-mails.

  • Recevoir le rapport d’exécution via la marge - Envoie le rapport d’exécution en marge. Pour ajouter un profil Slack, consultez Créer un profil Slack.

Création d'une tâche de mise à niveau et téléchargement d'une image sur NetScaler

Planification de tâches de mise à niveau pour une paire NetScaler à haute disponibilité

Le tableau suivant répertorie les différents scénarios de planification de la page Planifier une tâche et les options de mise à niveau correspondantes disponibles sur la page Créer une tâche  :

Quand souhaitez-vous exécuter la tâche de mise à niveau ? Quand souhaitez-vous télécharger l’image logicielle sur NetScaler ? Comment souhaitez-vous télécharger l’image de construction sur les nœuds HA ?
Passez à la version supérieure Non applicable Charger vers les nœuds principal et secondaire (option par défaut)
Programmez plus tard Charger au moment de l’exécution (option par défaut) Charger vers les nœuds principal et secondaire (option par défaut)
Charger maintenant
Planifier ultérieurement (lorsque l’option Effectuer une mise à niveau en deux étapes pour les nœuds dans HA est sélectionnée) Charger au moment de l’exécution (option par défaut) Charger vers le nœud secondaire uniquement (option par défaut et unique)
Charger maintenant

Télécharger un rapport de comparaison consolidé sur une tâche de mise à niveau de NetScaler

Dans la console NetScaler, vous pouvez télécharger un rapport de comparaison d’une tâche de mise à niveau de NetScaler. Pour ce faire, la tâche de mise à niveau doit disposer de scripts personnalisés. Un rapport diff contient les différences entre les sorties du script pré-mise à niveau et post-mise à niveau. Ce rapport vous permet de déterminer les modifications apportées à l’instance NetScaler après la mise à niveau.

Remarque :

Le rapport diff est généré uniquement si vous spécifiez le même script avant et après la mise à niveau.

Pour télécharger un rapport diff d’une tâche de mise à niveau, procédez comme suit :

  1. Accédez à Infrastructure > Tâches de configuration > Tâches de maintenance.

  2. Sélectionnez le travail de mise à niveau pour lequel vous souhaitez télécharger un rapport de diff.

  3. Cliquez sur Rapports de différé.

  4. Dans Rapports Diff, téléchargez un rapport de diff consolidé du travail de mise à niveau sélectionné.

    Dans cette page, vous pouvez télécharger l’un des rapports diff suivants :

    • Rapport de différentiel pré-basculement avant la mise à niveau et après mise à niveau
    • Rapport de diff pré vs post mise à niveau

    Télécharger un rapport de comparaison d'une tâche de mise à niveau de NetScaler