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

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

REMARQUE : Si vous souhaitez mettre à niveau une instance dotée de politiques classiques, nous vous recommandons de convertir les politiques classiques en politiques avancées avant de mettre à niveau l’instance, à l’aide de l’outil NSPEPI. Ceci s’applique aux fonctionnalités prises en charge par l’outil NSPEPI. Pour plus d’informations, consultez Considérations de mise à niveau pour les configurations avec des politiques classiques.

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

Contrôles de pré-validation

1. Vérifiez les 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 a moins de 6 Go d’espace et le dossier /flash a moins de 200 Mo d’espace, nettoyez l’espace disque. Vérifiez les chemins de dossiers 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. Vérifiez les problèmes matériels du disque - Résolvez les problèmes matériels, le cas échéant.

4. Vérifier les nœuds STAYPRIMARY et STAYSECONDARY - Pour un NetScaler HA, la mise à niveau est bloquée pour les nœuds dans les états STAYPRIMARY et STAYSECONDARY. Ces nœuds sont identifiés lors de la vérification de pré-validation et répertoriés sous Instances bloquées de la mise à niveau.

Paire haute disponibilité NetScaler

Lorsque vous mettez à niveau une paire NetScaler HA, notez les 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 mis à niveau avec succès.

• Après la mise à niveau réussie de la paire HA, un message d’erreur apparaît dans l’historique d’exécution. Ce message apparaît si vos nœuds de la paire HA sont sur des builds 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.

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

1. Créez une tâche de mise à niveau et exécutez-la immédiatement sur l’un des nœuds ou planifiez-la ultérieurement.

2. Planifiez la tâche de mise à niveau pour qu’elle s’exécute ultérieurement sur le nœud restant. Assurez-vous de planifier cette tâche après la mise à niveau du nœud initial.

Clusters NetScaler

Lorsque vous mettez à niveau un cluster NetScaler, la console NetScaler effectue une validation préalable à la mise à niveau uniquement sur l’instance spécifiée. 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éer une tâche de maintenance de mise à niveau pour mettre à niveau les instances NetScaler

Note

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 13.0 79.x ou toute autre version antérieure.

1. Dans la console NetScaler, 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 (autonome/haute disponibilité/cluster) et cliquez sur Continuer.

   

3. Dans Sélectionner l’instance, saisissez un nom de votre choix pour Nom du travail.

4. Cliquez sur Ajouter des instances pour ajouter les instances 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 Sélectionner l’image , sélectionnez une image NetScaler à partir de votre lecteur local ou des images de build.

   • Local - Sélectionnez le fichier de mise à niveau de l’instance à partir de votre machine locale.

   • Appareil - Sélectionnez le fichier de mise à niveau de l’instance à partir d’un navigateur de fichiers de la console NetScaler. L’interface graphique de la console NetScaler affiche les fichiers d’instance présents dans /var/mps/ns_images.

   

   

   • Ignorer le téléchargement de l’image sur 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 lors d’une 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 démarrer la validation de pré-mise à niveau sur les instances sélectionnées.

Note:

• Les images NetScaler téléchargées sont stockées dans l’agent NetScaler Console 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 NetScaler Console à la fois.

1. L’onglet Validation préalable à la mise à niveau affiche les sections suivantes :

   • Instances prêtes pour la mise à niveau. Vous pouvez continuer la mise à niveau de ces instances.

   • Instances bloquées à partir de la mise à niveau. Ces instances NetScaler sont bloquées lors de la mise à niveau en raison d’erreurs de validation préalables à la mise à niveau.

     Vous pouvez consulter, rectifier les erreurs, puis cliquer sur Passer à prêt pour la mise à niveau pour les mettre à niveau. Si vous rencontrez un manque d’espace disque sur une instance, vous pouvez vérifier et nettoyer l’espace disque. Voir, Nettoyer l’espace disque NetScaler.

   

   • Vérification de la stratégie: si NetScaler Console trouve 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, la console NetScaler effectue la validation préalable à la mise à niveau uniquement sur l’instance spécifiée et non sur les autres nœuds du cluster.

Pour afficher les écarts entre les nœuds principaux et secondaires lors d'une mise à niveau, sélectionnez le nœud haute disponibilité et cliquez sur **Détails**.

![Rapport de validation préalable à la mise à niveau](/en-us/netscaler-application-delivery-management-software/media/upgrade-jobs-ha-details.png)

![Rapport de validation préalable à la mise à niveau](/en-us/netscaler-application-delivery-management-software/media/upgrade-primary-secondary-diff.png)

-  **Écarts de configuration trouvés dans le nœud principal de HA** - Affiche toutes les configurations trouvées dans le nœud secondaire de la paire haute disponibilité NetScaler mais manquantes dans le nœud principal.

-  **Écarts de configuration trouvés dans le nœud secondaire de HA** - Affiche toutes les configurations trouvées dans le nœud principal de la paire haute disponibilité NetScaler mais manquantes dans le nœud secondaire.

> **Note:**
> 
> Vous pouvez ignorer les divergences suivantes qui peuvent apparaître dans les sections de divergences de configuration :
> 
> - Configurations spécifiques à l'appareil, telles que les adresses IP.
> 
> - Mots de passe ou certificats cryptés, qui peuvent différer entre les nœuds, même si le mot de passe est le même.
> 
> Vous pouvez examiner les divergences et choisir de les ignorer si elles ne sont pas pertinentes.

1. Dans Scripts de validation, spécifiez les scripts à exécuter avant et après une mise à niveau d’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 de différence pour le script de validation.

     Note:

     Vous ne pouvez pas modifier ou éditer cet ensemble prédéfini de commandes.

   • Scripts de validation personnalisés - Choisissez cette option pour exécuter votre 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érence est généré uniquement si les mêmes scripts sont sélectionnés avant et après la mise à niveau.

   Pour connaître l’ensemble des commandes de chaque configuration, cliquez sur Afficher les détails.

   

   Dans Scripts de validation 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 une mise à niveau d’une instance NetScaler. Par exemple:

   • La version de l’instance avant et après la mise à niveau.
   • L’é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 itinéraires dynamiques.

   Une mise à niveau d’instance comporte plusieurs étapes. Vous pouvez désormais spécifier ces scripts à exécuter aux étapes suivantes :

   • Pré-mise à niveau: Le script spécifié s’exécute avant la mise à niveau d’une instance.

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

   • Post-mise à niveau (applicable pour autonome) / Post-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.

Note:

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 de script ou saisir des commandes directement dans l'interface graphique de la console NetScaler.

-  **Utiliser le même script que pour la pré-mise à niveau**: Utiliser le même script personnalisé pour la pré-mise à niveau, le pré-basculement et la post-mise à niveau.
-  **Importer des commandes à partir d'un fichier**: Sélectionnez le fichier d'entrée de commande à partir de votre ordinateur local.
-  **Tapez les commandes**: Entrez les commandes directement sur l'interface graphique.

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

   • Mettre à niveau maintenant - La tâche de mise à niveau s’exécute immédiatement.

   • Planifier plus tard - Sélectionnez cette option pour exécuter cette tâche 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 les nœuds dans 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.

     

2. Dans Créer un travail, spécifiez les détails suivants :

   1. Sélectionnez l’une des options suivantes dans la liste Image logicielle:

      • Local - Sélectionnez le fichier de mise à niveau de l’instance à partir de votre machine locale.

      • Appareil - Sélectionnez le fichier de mise à niveau de l’instance à partir d’un navigateur de fichiers. L’interface graphique de la console NetScaler affiche les fichiers d’instance présents dans /var/mps/mps_images.

   2. Spécifiez quand 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. Cependant, la tâche de mise à niveau s’exécute à l’heure prévue.

      • 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 du travail de mise à niveau.

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

      • Télécharger sur les nœuds principal et secondaire: Télécharger le fichier image de build sur les nœuds principal et secondaire.

      • Télécharger uniquement sur le nœud secondaire: Télécharger le fichier image de build uniquement sur le nœud secondaire. Une fois le nœud secondaire mis à niveau, un basculement se produit et le fichier image de build est téléchargé sur le nouveau nœud secondaire qui était auparavant le nœud principal.

   

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

   • Nettoyer l’image logicielle de NetScaler lors d’une 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 NetScaler avant de démarrer la mise à niveau. - Crée une sauvegarde des instances NetScaler sélectionnées.

   • Maintenir 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 manière, le travail de mise à niveau maintient l’état principal et secondaire des nœuds.

   • Enregistrer la configuration NetScaler avant de démarrer la mise à niveau - Enregistre la configuration NetScaler en cours d’exécution avant de mettre à niveau les instances NetScaler.

   • Activer ISSU pour éviter les pannes de réseau sur la paire NetScaler HA - ISSU garantit la mise à niveau sans interruption de service sur une paire haute disponibilité NetScaler. 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 temps d’arrêt. Spécifiez le délai d’expiration de la 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 par e-mail, voir Créer une liste de distribution par e-mail.

   • Recevoir le rapport d’exécution via Slack - Envoie le rapport d’exécution dans Slack. Pour ajouter un profil Slack, voir Créer un profil Slack.

   Cliquez sur Créer un travail.

La tâche de mise à niveau apparaît dans Infrastructure > Tâches de mise à niveau. Lorsque vous modifiez un travail existant, vous pouvez passer à n’importe quel onglet si les champs obligatoires sont déjà remplis. Par exemple, si vous êtes dans l’onglet Sélectionner la configuration , vous pouvez passer à l’onglet Aperçu du travail .

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 et cliquez sur Arrêter pour suspendre la tâche. Pour reprendre la tâche de mise à niveau planifiée, cliquez sur Reprendre.

Note:

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

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

1. Dans Infrastructure > Upgrade Jobs, sélectionnez la tâche de mise à niveau ayant échoué et cliquez sur Retry. Alternativement, vous pouvez également aller dans Sélectionner une action > Réessayer la tâche de mise à niveau pour réessayer une tâche ayant échoué.

   

2. Dans Sélectionnez l’instance, spécifiez les détails suivants :

   • Nom du travail - Saisissez 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 affiche les sections suivantes :

   • Instances prêtes pour la mise à niveau. Vous pouvez continuer la mise à niveau de ces instances.

   • Instances bloquées à partir de la mise à niveau. Ces instances NetScaler sont bloquées lors de la mise à niveau en raison d’erreurs de validation préalables à la mise à niveau.

     Vous pouvez consulter, rectifier les erreurs, puis cliquer sur Passer à prêt pour la mise à niveau pour les mettre à niveau. Si vous rencontrez un manque d’espace disque sur une instance, vous pouvez vérifier et nettoyer l’espace disque. Voir, Nettoyer l’espace disque NetScaler.

   • Vérification de la stratégie: si NetScaler Console trouve 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 :

   • Mettre à niveau maintenant: La tâche de mise à niveau s’exécute immédiatement.

   • Planifier plus tard: Sélectionnez cette option pour exécuter cette tâche 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.

Nettoyer 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 de la console NetScaler elle-même.

1. Dans l’onglet Validation préalable à la mise à niveau , la section Instances bloquées 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 un problème d’espace disque.

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

   Une page Détails de l’espace disque apparaît. Cette page 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 nécessite un nettoyage 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 apparaît, sélectionnez les dossiers que vous souhaitez supprimer et cliquez sur Oui.

      

   3. Après avoir libéré 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 de la mise à niveau , cliquez sur Revalider.

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

      

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

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

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

Vous pouvez télécharger un rapport de différence d’une tâche de mise à niveau NetScaler si des scripts personnalisés sont spécifiés. Un rapport de différences contient les différences entre les sorties des scripts de pré-mise à niveau et de post-mise à niveau. Avec ce rapport, vous pouvez déterminer les modifications survenues sur l’instance NetScaler après la mise à niveau.

Note

Le rapport de différence est généré uniquement 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 de différences d’une tâche de mise à niveau, procédez comme suit :

1. Accédez à Infrastructure > Tâches de mise à niveau.

2. Sélectionnez la tâche de mise à niveau pour laquelle vous souhaitez télécharger un rapport de différence.

3. Cliquez sur Rapports de différences.

4. Dans Rapports de différences, téléchargez un rapport de différences consolidé de la tâche de mise à niveau sélectionnée.

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

   • Rapport de différence avant et après la mise à niveau avant le basculement
   • Rapport de différence avant et après la mise à niveau