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

Vous pouvez utiliser NetScaler Application Delivery Management (ADM) pour 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.

Lorsque vous mettez à niveau votre instance NetScaler en créant une tâche de maintenance, effectuez le contrôle de pré-validation sur les instances que vous souhaitez mettre à niveau.

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

2. Vérifiez l’utilisation du disque : si le dossier /var possède moins de 6 Go d’espace et que le dossier /flash contient moins de 200 Mo d’espace, nettoyez l’espace disque. Vérifiez les chemins de dossier suivants pour nettoyer l’espace disque :

   • /var/nstrace
   • /var/log
   • /var/nslog
   • /var/tmp/support
   • /var/core
   • /var/crash
   • /var/nsinstall
   • /var/netscaler/nsbackup

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

Vous pouvez mettre à niveau une paire NetScaler HA 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.

Lorsque vous mettez à niveau une paire NetScaler HA, 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.

• Une fois la mise à niveau réussie de la paire HA, un message d’erreur apparaît dans l’historique des exécutions. Ce message s’affiche si vos nœuds de la paire HA se trouvent sur des versions ou des versions différentes. Ce message indique que la synchronisation entre le nœud principal et le nœud secondaire est désactivée.

Lorsque vous mettez à niveau un cluster NetScaler, l’ADM effectue une validation préalable à la mise à niveau sur l’instance spécifiée uniquement. Avant de procéder à la mise à niveau, vérifiez et résolvez les problèmes de personnalisation, d’utilisation du disque et de matériel sur les nœuds du cluster.

Créez une tâche de maintenance des mises à niveau pour mettre à niveau les instances NetScaler

Remarque

La mise à niveau de NetScaler d’une version supérieure vers une version inférieure n’est pas prise en charge. Par exemple, si votre instance NetScaler est 13.0 82.x, vous ne pouvez pas rétrograder l’instance NetScaler vers la version 13.0 79.x ou toute autre version antérieure.

1. Dans NetScaler ADM, accédez à Infrastructure > Tâches de mise à niveau. Cliquez sur le bouton Créer un travail.

   

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

   

3. Dans Sélectionner une instance, tapez le nom de votre choix pour Nom de la tâche.

4. 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 »).

   

5. Dans l’onglet Select Image, sélectionnez une image NetScaler depuis votre disque local ou parmi les images de génération.

   • Local  : sélectionnez le fichier de mise à niveau de l’instance sur votre machine locale.

   • Appliance  : sélectionnez le fichier de mise à niveau de l’instance dans un navigateur de fichiers NetScaler ADM. L’interface graphique NetScaler ADM affiche les fichiers d’instance présents sur. /var/mps/ns_images

   

   

   • 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 NetScaler ADM 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.
   • NetScaler ADM 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 NetScaler ADM à la fois.

6. 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érification des stratégies : si NetScaler ADM 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 du cluster, l’ADM effectue la validation préalable à la mise à niveau uniquement sur l’instance spécifiée et non sur les autres nœuds du cluster.

7. Facultatif, dans Scripts personnalisés, spécifiez les scripts à exécuter avant et après une mise à niveau d’instance. Utilisez l’une des méthodes suivantes pour exécuter les commandes :

   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.

   Une mise à niveau d’instance comporte plusieurs étapes. Vous pouvez désormais spécifier ces scripts à 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 aux étapes requises. Sinon, les scripts spécifiés ne s’exécutent pas.

   Vous pouvez importer un fichier script ou taper des commandes directement dans l’interface graphique ADM.

   • 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 les étapes de post-mise à niveau, vous pouvez utiliser le même script spécifié dans l’étape de pré-mise à niveau.

   

8. 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 HA en deux étapes, sélectionnez Effectuer une mise à niveau en deux étapes pour lesnœuds en HA.

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

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

   1. Sélectionnez l’une des options suivantes dans la liste des images logicielles  :

      • Local  : sélectionnez le fichier de mise à niveau de l’instance sur votre machine locale.

      • Appliance : sélectionnez le fichier de mise à niveau de l’instance dans un navigateur de fichiers ADM. L’interface graphique ADM affiche les fichiers d’instance présents sur /var/mps/mps_images.

   2. Spécifiez le moment où vous souhaitez télécharger l’image sur une instance :

      • Télécharger maintenant - Sélectionnez cette option pour télécharger l’image immédiatement. Toutefois, le travail de mise à niveau s’exécute à l’heure planifiée.

      • Télécharger au moment de l’exécution - Sélectionnez cette option pour télécharger l’image au moment de l’exécution de la tâche de mise à niveau.

      Pour une paire à 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.

   

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

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

   • 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 HA 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 réseau sur la paire NetScaler HA : ISSU garantit la mise à niveau sans interruption de service d’une paire NetScaler haute disponibilité. Cette option fournit une fonctionnalité de migration qui respecte les connexions existantes lors de la mise à niveau. Vous pouvez donc mettre à niveau une paire NetScaler HA sans interruption de service. 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.

   

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

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

   

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.

   

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. Consultez Nettoyer l’espace disque NetScaler.

   • Vérification des stratégies : si NetScaler ADM 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.

   

   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.

   

   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 à partir de l’interface graphique NetScaler ADM 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.

   

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.

      

   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.

      

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  :

Télécharger un rapport différentiel combiné d’une tâche de mise à niveau de NetScaler

Vous pouvez télécharger un rapport différentiel d’une tâche de mise à niveau de NetScaler si des scripts personnalisés sont spécifié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 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.

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