Mettre à niveau NetScaler Console

Dernière publication : Oct 02, 2026
Important :
La licence basée sur fichier sera en fin de vie (EOL) à partir du April 15, 2026. Toutes les instances NetScaler (ADC, SVM) doivent être mises à niveau vers des versions conformes à LAS et passer à l'utilisation de licences basées sur LAS avant cette date. Les versions minimales requises de NetScaler compatibles avec LAS sont :
  • NetScaler ADC : 14.1–51.80, 13.1-60.29, 13.1-37.247 (FIPS), 14.1-66.68 (FIPS)
  • NetScaler SVM : 14.1–51.83, 13.1-60.30
Après le April 15, 2026, dans les versions 14.1-66.x et ultérieures de NetScaler ADC et SVM, une vérification liée à la mise à niveau sera déclenchée avant la mise à niveau de NetScaler. Cette vérification valide si votre NetScaler (ADC, SVM) utilise toujours une licence basée sur fichier, et si c'est le cas, la mise à niveau serait bloquée avec l'erreur « NetScaler Upgrade Blocked: File-based licensing in use ». Cette précaution empêche vos instances NetScaler de procéder à la mise à niveau et de devenir sans licence après le April 15, 2026. Contactez le support Citrix ou votre représentant ATS pour comprendre comment débloquer la mise à niveau et les risques qui y sont associés.
Related information
Gérer les paramètres système

Vérifications avant la mise à niveau

Avant de déclencher une mise à niveau depuis NetScaler Console, le système effectue automatiquement une vérification préalable à la mise à niveau pour valider la préparation du système et l'intégrité de l'image de mise à niveau. Cette vérification garantit que la mise à niveau se déroule sans problème et réduit la probabilité de rencontrer des échecs pendant le processus de mise à niveau.
Remarque :
La fonction de vérification préalable à la mise à niveau est disponible à partir de la version 14.1 build 56.x de NetScaler Console. La vérification s'exécute automatiquement avant chaque mise à niveau initiée via NetScaler Console sur site.
Si la vérification détecte des problèmes, NetScaler Console affiche des informations détaillées sur les écarts et vous invite à les résoudre avant de poursuivre la mise à niveau.
La vérification préalable à la mise à niveau comprend les validations suivantes :
  • Vérification de la disponibilité de la mémoire – Vérifie que NetScaler Console dispose de suffisamment de RAM disponible pour effectuer la mise à niveau en toute sécurité.
  • Vérification de l'espace disque – Garantit que l'espace disque libre requis est disponible pour l'extraction et l'installation de l'image de mise à niveau.
  • Vérification des exigences des fichiers image – Confirme que tous les fichiers image obligatoires requis pour la mise à niveau sont disponibles.
  • Vérification de l'intégrité du fichier image – Valide la somme de contrôle de l'image de mise à niveau pour s'assurer que le fichier est complet et non corrompu.
  • Vérification de la transition LAS - Vérifie si NetScaler Console utilise toujours des licences basées sur des fichiers pour les types de licences groupées ou flexibles après le April 15, 2026.
    Remarque :
    La vérification de la transition LAS prend effet le April 15, 2026 et s'applique aux types de licences groupées et flexibles. À partir de cette date, si vous tentez de mettre à niveau vers NetScaler Console 14.1-66.x ou une version ultérieure avec des licences basées sur des fichiers toujours utilisées, la mise à niveau ne sera pas autorisée. Cette vérification est effectuée pour éviter que votre NetScaler Console sur site ne procède à la mise à niveau après le April 15, 2026, et que les instances NetScaler ne deviennent sans licence après la mise à niveau. Si vous rencontrez cette restriction, vous devez contacter le support Citrix ou votre représentant ATS pour obtenir des conseils.
    L'erreur suivante s'affiche lorsque la vérification préalable à la mise à niveau LAS échoue :
    Échec de la vérification LAS
En plus des validations de ressources et de fichiers, NetScaler Console vérifie l'état et la connectivité du système pour garantir une mise à niveau sécurisée. La vérification comprend les contrôles suivants :
  • Vérification de l'intégrité de la base de données – Détecte les fichiers de base de données manquants ou corrompus pour éviter les échecs de mise à niveau.
  • État du canal de diffusion en continu de la base de données – Confirme que le canal de diffusion en continu est actif et opérationnel.
  • Connectivité du nœud secondaire – Assure une communication appropriée avec le nœud secondaire pour la redondance.
  • Vérification SSH sans mot de passe – Confirme que la connexion SSH sans mot de passe au nœud secondaire fonctionne.
La fonction de vérification préalable à la mise à niveau offre les avantages suivants :
  • L'exécution de ces validations avant la mise à niveau permet d'éviter les échecs causés par des ressources insuffisantes ou des fichiers image corrompus.
  • En identifiant les problèmes potentiels à l'avance, la vérification préalable à la mise à niveau améliore la fiabilité de la mise à niveau et minimise les temps d'arrêt dus aux efforts de récupération ou de réinstallation.
Pour mettre à niveau NetScaler Console :
  1. Accédez à Paramètres > Administration. Sous Maintenance du système, cliquez sur Mettre à niveau NetScaler Console.
  2. Sur la page Mettre à niveau NetScaler Console, téléchargez un nouveau fichier image en sélectionnant Local (votre ordinateur local) ou Appliance.
    Remarque
    Lorsque vous sélectionnez Appliance, assurez-vous que l'image de mise à niveau est disponible à l'emplacement /var/mps/mps_images dans NetScaler Console.
    Par défaut, l'image logicielle est nettoyée après une mise à niveau réussie.
  3. Cliquez sur OK.
    Mettre à niveau la console

Déblocage de la mise à niveau de NetScaler Console lorsque la vérification préalable à la mise à niveau LAS échoue

Utilisez cette option uniquement si vous devez procéder immédiatement à la mise à niveau de NetScaler Console et que vous comprenez et acceptez l'impact sur les licences décrit ci-dessous. Si votre objectif est de rester sous licence après la mise à niveau, contactez le support Citrix ou votre représentant ATS.
Conditions préalables : Vous devez disposer d'un accès shell à NetScaler Console ou à la VM et de privilèges suffisants pour créer des fichiers sous /var/tmp.
Pour débloquer la mise à niveau :
  1. Connectez-vous au shell de NetScaler Console.
  2. Créez le fichier d'indicateur de contournement.
    touch /var/tmp/skip_las_checks
  3. Relancez la mise à niveau. NetScaler Console détecte l'indicateur skip_las_checks et ignore la validation LAS, ce qui permet au processus de mise à niveau de se poursuivre.
Important :
Si vous ignorez la vérification préalable à la mise à niveau LAS et continuez alors que la licence groupée ou flexible basée sur des fichiers est toujours utilisée, toutes les instances NetScaler gérées devraient devenir sans licence après la mise à niveau de NetScaler Console.
Après la mise à niveau sur site de NetScaler Console, effectuez la transition LAS pour la licence groupée ou flexible et confirmez que chaque instance NetScaler est correctement licenciée.
Si vous avez besoin d'une approche alternative ou d'une assistance pour la séquence de transition, contactez le support Citrix ou votre représentant ATS.