Documentation Produit
Application Delivery Management
14.1 - Current Release 13.1 13.0 12.1
Voir PDF

Mettre à niveau

February 1, 2024
Contributeur: 
C

Chaque version de Citrix ADM offre des fonctionnalités nouvelles et mises à jour avec des fonctionnalités améliorées. Citrix vous recommande de mettre à niveau Citrix ADM vers la dernière version pour bénéficier des nouvelles fonctionnalités et des corrections de bogues. Une liste complète des améliorations, des problèmes connus et des corrections de bogues est incluse dans les notes de mise à jour accompagnant chaque annonce de publication. Il est également important de comprendre le cadre de licences et les types de licences qui peuvent être utilisés avant de commencer la mise à niveau. Pour plus d’informations sur les licences Citrix ADM, reportez-vous à la section Gestion

Les informations relatives au chemin de mise à niveau sont également disponibles dans le Guide de mise à niveau Citrix

Avant de procéder à la mise à niveau

Téléchargez le package de mise à niveau depuis la page de téléchargements de Citrix ADM et suivez les instructions de cet article pour mettre à niveau votre système vers la dernière version 12.1. Une fois l’opération de mise à niveau démarrée, Citrix ADM redémarre et les connexions existantes sont interrompues et reconnectées lorsque la mise à niveau est terminée avec succès. La configuration existante est conservée, mais Citrix ADM ne traite aucune donnée tant que la mise à niveau n’est pas terminée.

Important

La version et la version de Citrix ADM doivent être égales ou supérieures à celles de votre version et build de Citrix ADC. Par exemple, si vous avez installé Citrix ADM 12.1 Build 50.39, assurez-vous d’avoir installé Citrix ADC 12.1 Build 50.28/50.31 ou une version antérieure.

Points à noter avant la mise à niveau vers la version 12.1 :

  • Si vous effectuez une mise à niveau vers la version Citrix ADM 12.1 build 48.18 à partir de la version 11.1 ou de la version 12.0 antérieure à 56.x, effectuez les étapes suivantes.

    • Mise à niveau de la version existante vers la version 12.0 57.24.

    • Ensuite, passez à la dernière version de la version 12.1.

      Vous devez suivre ce processus en deux étapes car certaines procédures de nettoyage sont requises pour réussir la mise à niveau vers la version 12.1. Ces procédures ne sont disponibles qu’à partir de 12.0 build 56.x.

  • Avec la version 12.1, le déploiement de haute disponibilité permet de configurer une adresse IP flottante sur le nœud principal et d’éliminer le besoin d’un équilibreur de charge Citrix ADC distinct. En raison de cette amélioration, le déploiement haute disponibilité doit se trouver sur le même sous-réseau. Si votre déploiement actuel concerne différents sous-réseaux, vous devez consulter cet article pour en savoir plus sur le processus de mise à niveau.

  • Avec la version 12.1, la prise en charge de la sauvegarde avancée a été supprimée. La fonctionnalité de sauvegarde avancée n’est plus disponible après la mise à niveau vers Citrix ADM 12.1. Consultez cet article pour plus de détails.

Remarque

Vous ne pouvez pas rétrograder Citrix ADM d’une version 12.1 vers une version antérieure.

Précautions recommandées :

  • Sauvegardez le serveur Citrix ADM avant de procéder à la mise à niveau.

  • Après la mise à niveau, vous devrez peut-être rétablir les connexions entre le serveur Citrix ADM et les instances gérées. Une invite de confirmation vous avertit que les connexions peuvent échouer si vous continuez.

  • Pour les serveurs Citrix ADM dans une configuration haute disponibilité, lors de la mise à niveau, n’apportez aucune modification de configuration sur aucun des nœuds.

    Avertissement

    N’actualisez pas le navigateur tant que le processus de mise à niveau n’est pas terminé. Le processus de mise à niveau peut prendre quelques minutes.

  • Après la mise à niveau, le nœud actif peut changer dans une paire de haute disponibilité.

Mettre à niveau un seul serveur Citrix ADM

Pour mettre à niveau un serveur Citrix ADM unique :

  1. Dans un navigateur Web, saisissez l’adresse IP du serveur Citrix ADM.

    Remarque

    Pour les serveurs Citrix ADM en mode haute disponibilité, saisissez l’adresse IP de l’un des serveurs Citrix ADM de la paire HA ou du serveur virtuel d’équilibrage de charge.

  2. Dans les champs Nom d’utilisateur et Mot de passe , entrez les informations d’identification de l’administrateur.

  3. Accédez à Système >  Administrations du système . Sous le sous-titreAdministration du système, cliquez sur Mettre à niveau Citrix ADM.

    Image localisée

  4. Sur la pageMettre à niveau Citrix ADM, activez la case à cocherNettoyer l’image logicielle lors de la mise à niveau réussie pour supprimer les fichiers image après la mise à niveau. La sélection de cette option supprime automatiquement les fichiers image Citrix ADM lors de la mise à niveau.

    Remarque

    Cette option est sélectionnée par défaut. Si vous ne cochez pas cette case avant de commencer le processus de mise à niveau, vous devez supprimer manuellement les images.

    Image localisée

  5. Vous pouvez ensuite télécharger un nouveau fichier image en sélectionnantLocal (votre machine locale) ouAppliance. Le fichier de construction doit être présent sur l’appliance virtuelle Citrix ADM.

    Image localisée

    La boîte de dialogue Confirmer s’affiche. Cliquez sur OK.

  6. Cliquez sur OK.

    Le processus de mise à niveau démarre.

Mise à niveau d’une paire à haute disponibilité provenant de versions antérieures vers la version 12.1

Pour les serveurs Citrix ADM en mode haute disponibilité, vous pouvez effectuer la mise à niveau en accédant au nœud actif ou à l’adresse IP du serveur virtuel d’équilibrage de charge. Les deux serveurs Citrix ADM sont automatiquement mis à niveau vers la dernière version une fois que vous lancez le processus de mise à niveau dans l’un ou l’autre des serveurs.

Important

Points à noter lors de la mise à niveau de Citrix ADM en mode haute disponibilité

Lors de la mise à niveau de Citrix ADM en mode haute disponibilité vers la version 12.1 à partir d’une version antérieure, la connexion haute disponibilité est établie en interne par le script « join HA » qui s’exécute sur le nœud secondaire. La durée du processus de mise à niveau dépend de l’infrastructure réseau, des données présentes dans la base de données et de la vitesse de la liaison. Le rétablissement de la connexion entre les deux nœuds peut prendre quelques heures. Pendant cette période, le nœud principal ne reçoit aucun battement cardiaque du nœud secondaire. Une notification s’affiche en cas de battement de cœur manquant sur l’interface utilisateur principale jusqu’à ce que le processus de mise à niveau soit terminé. Une fois le processus de mise à niveau terminé, le nœud secondaire redémarre et le déploiement de haute disponibilité est terminé.

Remarque

Pour connaître l’état de la mise à niveau, connectez-vous à chaque nœud via SSH, exécutez les commandes suivantes et vérifiez la sortie :

installations de pgrep -lf

maintenance de pgrep -lf

pgrep -lf join_streaming_replication

pgrep -lf pg_basebackup

Si l’une de ces commandes indique un processus en cours d’exécution sur l’un des nœuds, la mise à niveau est en cours et ne doit pas être interrompue. Ne redémarrez pas Citrix ADM pendant cette période et n’essayez pas de forcer le basculement sur le nœud secondaire.

Une fois le processus de mise à niveau terminé, il se peut que vous ne puissiez pas vous connecter avec nsroot/nsroot ou vos informations d’identification utilisateur. Cela est dû au fait que le sous-système Citrix ADM n’a pas complètement redémarré ou que la migration est peut-être toujours en cours. Ne redémarrez pas Citrix ADM et ne tentez pas de récupérer le mot de passe. Cela peut avoir un effet indésirable et le système peut se comporter de manière incohérente. Si nécessaire, vous pouvez essayer de vous connecter à l’aide des <your_password_for_the_nsroot_user>informations d’identification nsrecover/.

Après la mise à niveau et avant de commencer les opérations, assurez-vous que les nœuds principal et secondaire sont mis à niveau et que le redémarrage est terminé.

Remarque

Vous ne pouvez pas mettre à niveau Citrix ADM en mode haute disponibilité à l’aide de l’interface de ligne de commande.

Licences groupées sur des serveurs Citrix ADM en haute disponibilité :

Lorsque les serveurs Citrix ADM sont déployés en mode haute disponibilité, le fichier de licence est joint au nœud principal et configuré (nœud verrouillé) avec l’ID d’hôte ou l’adresse MAC du serveur principal. La fonctionnalité de licences groupées est désormais prise en charge par Citrix ADM en haute disponibilité à partir de la version 12.1. Pour configurer la fonctionnalité de licences groupées sur les deux nœuds, vous devez disposer de fichiers de licence identiques sur les deux nœuds. Pour installer une licence identique sur le nœud secondaire, vous devez réhéberger la licence sur l’HostID (adresse MAC) du nœud secondaire.

Envisagez un scénario dans lequel Citrix ADM dispose de deux nœuds de serveur S1 et S2 en mode haute disponibilité. Le fichier de licence d’origine, L1, est installé sur le serveur S1. Le fichier de licence L2 réhébergé doit maintenant être attribué à S2.

Suivez les étapes pour mettre à niveau Citrix ADM en mode haute disponibilité de 12.0 vers 12.1 et configurer la fonctionnalité de licences groupées :

  1. Connectez-vous au nœud principal des serveurs Citrix ADM en mode haute disponibilité et effectuez le processus de mise à niveau.

  2. Installez le fichier de licence L2 réhébergé sur le nœud de serveur secondaire S2.

    À l’heure actuelle :

    • Si S2 est le nœud principal, vous pouvez installer la licence L2 en accédant à l’interface graphique de cette instance.

    • Si S2 est le nœud secondaire, vous devez effectuer manuellement un basculement afin que S2 devienne désormais le nœud principal. Installez la licence L2 sur le nouveau nœud principal à l’aide de l’interface graphique.
      Cela est dû au fait que vous ne pouvez accéder qu’au serveur principal en haute disponibilité via l’interface graphique.

  3. Configurez l’adresse IP flottante sur le nouveau nœud principal.

  4. Supprimez les adresses IP du serveur de licences sur les instances Citrix ADC et reconfigurez-les pour utiliser l’adresse IP flottante. Effectuez cette opération sur toutes les instances de Citrix ADC.

Citrix vous recommande d’effectuer la mise à niveau des licences groupées à haute disponibilité Citrix ADM en créant une fenêtre de maintenance sur les instances Citrix ADC. En effet, la suppression du serveur de licences et l’ajout d’une adresse IP flottante entraînent le retour temporaire des instances Citrix ADC à la bande passante minimale prise en charge.

Scénarios de mise à niveau de haute disponibilité

Il peut y avoir deux scénarios dans lesquels les serveurs Citrix ADM sont déployés en mode haute disponibilité.

  • Les serveurs principal et secondaire sont déployés sur le même sous-réseau.

  • Les serveurs principal et secondaire sont déployés dans différents sous-réseaux.

Ce document de mise à niveau vous aide à mettre à niveau Citrix ADM dans ces deux scénarios.

  • Mise à niveau d’une configuration haute disponibilité sur le même sous-réseau

  • Mise à niveau d’une configuration de haute disponibilité dans différents sous-réseaux

Mettre à niveau une configuration à haute disponibilité sur le même sous-réseau

La mise à niveau des serveurs Citrix ADM déployés en mode haute disponibilité sur le même sous-réseau est gérée automatiquement par Citrix ADM 12.1.

Pour mettre à niveau Citrix ADM déployé en mode haute disponibilité sur le même sous-réseau :

  1. Connectez-vous au nœud principal et accédez à Système > Administrations système.

  2. SousAdministration du système, cliquez sur Mettre à niveau Citrix ADM.  

  3. En cas d’erreur lors de la mise à niveau, le message d’erreur suivant s’affiche. Suivez les instructions indiquées dans le message sur le serveur principal.

    Image localisée

  4. Dans le cadre du processus de mise à niveau, vous devez effectuer une procédure de nettoyage via la CLI. Pendant le processus de nettoyage, le nœud secondaire devient le nœud principal. L’ancien nœud principal n’est pas accessible via son interface graphique. Ne redémarrez pas l’ancien nœud principal ainsi que le nouveau nœud principal pendant que le processus de nettoyage est en cours. Une fois le processus de nettoyage terminé, poursuivez la procédure de mise à niveau via le nouveau nœud principal.

  5. Une fois le processus de mise à niveau terminé, les deux nœuds doivent synchroniser leurs bases de données. Le temps nécessaire à la synchronisation complète et à l’apparition du nouveau nœud secondaire dépend des données présentes dans les bases de données.

    Remarque

    Une fois la mise à niveau réussie, vous devez configurer l’adresse IP flottante à l’aide de l’interface utilisateur Citrix ADM.

  6. Pour configurer une adresse IP flottante, accédez àSystème > Déploiement > Configurer une adresse IP flottante pour le mode haute disponibilité.

  7. Spécifiez l’adresse IP flottante comme indiqué dans l’image suivante et cliquez surOK.

    Image localisée

Mettre à niveau une configuration de haute disponibilité dans différents sous-réseaux

La mise à niveau des serveurs Citrix ADM déployés en mode haute disponibilité sur différents sous-réseaux doit être gérée par un administrateur.

Dans ce scénario, le nœud Citrix ADM HA 1 (principal) se trouve dans le sous-réseau 1 et le nœud Citrix ADM HA 2 (secondaire) se trouve dans le sous-réseau 2.

Pour mettre à niveau Citrix ADM déployé en mode haute disponibilité sur différents sous-réseaux :

  1. Interrompez manuellement la configuration de haute disponibilité. Pour plus d’informations, consultez la section Désactivation de la haute disponibilité.

  2. Mettez à niveau le nœud autonome Citrix ADM 1. Pour plus d’informations sur la mise à niveau de Citrix ADM, consultez la section Mettre à niveau un seul serveur Citrix ADM.

  3. Configurez et enregistrez un nouveau nœud autonome Citrix ADM 3 dans le sous-réseau 1.

  4. Après avoir enregistré le nœud 1 et le nœud 3, déployez ces deux nœuds en mode haute disponibilité. Pour plus de détails, voir Déploiement du nœud principal et du nœud secondaire en tant que paire à haute disponibilité.

    Remarque

    La configuration de l’adresse IP flottante est obligatoire.

  5. Supprimez le nœud Citrix ADM 2.

Mettre à niveau une paire à haute disponibilité des versions 12.1 précédentes vers la dernière version

Vous pouvez mettre à niveau les serveurs Citrix ADM déployés en haute disponibilité depuis une version 12.1 antérieure vers une version 12.1 ultérieure.

Pour mettre à niveau Citrix ADM déployé en mode haute disponibilité :

  1. Téléchargez le fichier image Citrix ADM 12.1 build 49.37 depuis la page de téléchargement de Citrix.com.

  2. Connectez-vous au nœud principal et accédez à Système > Administrations système.

  3. Sous Administration du système, cliquez sur Mettre à niveau Citrix ADM .

  4. Accédez au dossier dans lequel se trouve l’image.

    Lors de la mise à niveau, n’apportez aucune modification de configuration à l’un ou l’autre des nœuds.

    Avertissement

    • N’actualisez pas le navigateur tant que le processus de mise à niveau n’est pas terminé. Le processus de mise à niveau peut prendre quelques minutes.

    Après la mise à niveau, le nœud actif peut changer dans une paire de haute disponibilité.

Mettre à niveau le déploiement de reprise après sinistre Citrix ADM

La mise à niveau du déploiement de reprise après sinistre Citrix ADM se fait en deux étapes :

Vous devez d’abord mettre à niveau les nœuds Citrix ADM configurés en mode haute disponibilité sur le site principal. Plus tard, vous devez mettre à niveau le nœud de reprise après sinistre.

Assurez-vous d’avoir mis à niveau les serveurs Citrix ADM déployés en haute disponibilité avant de mettre à niveau le nœud de reprise après sinistre.

Mettre à niveau le nœud de reprise après sinistre Citrix ADM

  1. Télécharger le fichier image de mise à niveau Citrix ADM à partir du site de téléchargement Citrix.

  2. Téléchargez ce fichier sur le nœud de reprise après sinistre à l’aide des informations d’identification « nsrecover ».

  3. Connectez-vous au nœud de reprise après sinistre à l’aide des informations d’identification « nsrecover ».

    Image localisée

  4. Accédez au dossier dans lequel vous avez placé le fichier image et décompressez le fichier.

  5. Exécutez le script suivant :

    . /installmas

    Image localisée

Mettre à niveau les agents sur site pour un déploiement multisite

La mise à niveau du déploiement de l’agent Citrix ADM s’effectue en trois étapes. Assurez-vous d’avoir effectué les tâches suivantes avant de mettre à niveau les agents sur site :

  1. Mettez à niveau les serveurs Citrix ADM déployés en haute disponibilité.

  2. Mettez à niveau le nœud de reprise après sinistre Citrix ADM.

    Pour plus d’informations, consultez Mettre à niveau le déploiement de récupération d’urgence Citrix ADM.

Mettre à niveau l’agent sur site

  1. Télécharger le fichier image de mise à niveau de l’agent Citrix ADM à partir du site de téléchargement Citrix.

  2. Téléchargez ce fichier sur le nœud Agent à l’aide des informations d’identification « nsrecover ».

  3. Assurez-vous que vous téléchargez l’image de mise à niveau de l’agent correcte. Le nom du fichier image est au format suivant :

    build-masagent-12.1-48.18.tgz

  4. Connectez-vous à l’agent local à l’aide des informations d’identification « nsrecover ».

  5. Accédez au dossier dans lequel vous avez placé le fichier image et décompressez le fichier.

    Image localisée

  6. Exécutez le script suivant :

    . /installer masagent

    Image localisée

Supprimer la prise en charge de la fonctionnalité de sauvegarde et de restauration avancées de Citrix ADM

Au lieu d’utiliser la fonctionnalité de sauvegarde avancée pour effectuer une sauvegarde complète de votre serveur Citrix ADM, vous pouvez désormais utiliser la nouvelle fonctionnalité de reprise d’activité disponible dans Citrix ADM version 12.1 pour effectuer une sauvegarde complète de votre configuration de haute disponibilité Citrix ADM et vous aider à résoudre les cas d’utilisation liés à la continuité des activités.

Important

  1. La fonctionnalité de sauvegarde avancée n’est plus disponible après la mise à niveau vers Citrix ADM 12.1. Pour supprimer la fonctionnalité de sauvegarde avancée et continuer à sauvegarder à l’aide de la fonctionnalité de reprise après sinistre, voir Sauvegarder votre Citrix ADM après la mise à niveau vers Citrix ADM 12.1. La reprise après sinistre est prise en charge uniquement avec Citrix ADM HA.

  2. Pour continuer à effectuer une sauvegarde partielle du serveur Citrix ADM incluant les fichiers de configuration, les détails de l’instance, les données système, etc., puis pour restaurer votre serveur Citrix ADM dans le cadre d’un déploiement autonome (sauvegarde partielle), consultez Comment sauvegarder et restaurer votre serveur Citrix ADM dans un déploiement à serveur unique.

En cas de sinistre sur le serveur principal, utilisez la fonction de reprise après sinistre pour démarrer et configurer Citrix ADM sur le même serveur principal sans perdre de données. La fonctionnalité n’est disponible que sur les serveurs Citrix ADM déployés dans une configuration haute disponibilité à partir de la version 12.1 de Citrix ADM.

Sauvegardez votre serveur Citrix ADM après la mise à niveau vers Citrix ADM 12.1

Pour continuer à sauvegarder votre serveur Citrix ADM, Citrix recommande ce qui suit :

  1. Supprimez vos paramètres de sauvegarde à distance sur Citrix ADM en procédant comme suit :

    1. Accédez à Système > Administration du système > Paramètres avancés de sauvegarde du système.

    2. Sur la page Configurer les paramètres de sauvegarde avancés, sélectionnez Non pour désactiver les sauvegardes à distance.

    3. Cliquez sur Appliquer les paramètres. Attendez que votre serveur Citrix ADM redémarre et appliquez les paramètres modifiés.

    4. Supprimez votre nœud de sauvegarde à distance.

  2. Déployez et configurez un nouveau serveur Citrix ADM, créez une configuration haute disponibilité avec le serveur Citrix ADM existant qui a été redémarré à l’étape ci-dessus.

  3. Configurez la reprise après sinistre pour continuer à sauvegarder et à restaurer les données. Pour plus d’informations sur la reprise après sinistre, voirConfigurer la reprise après sinistre pour une haute disponibilité.

Ajouter un disque supplémentaire au serveur Citrix ADM

Si vos besoins en stockage Citrix ADM dépassent l’espace disque par défaut (120 gigaoctets), vous pouvez joindre un disque supplémentaire. Vous pouvez associer des disques supplémentaires à la fois dans le cadre de déploiements à serveur unique et à haute disponibilité.

Lorsque vous effectuez la mise à niveau de Citrix ADM de la version 12.0 vers la version 12.1, les partitions que vous aviez créées sur le disque supplémentaire dans la version précédente restent les mêmes. Les partitions ne sont pas supprimées et ne sont pas redimensionnées.

La procédure d’attachement d’un disque supplémentaire reste la même dans la version mise à niveau. Vous pouvez maintenant utiliser le nouvel outil de partitionnement de disque dans Citrix ADM pour créer des partitions dans le disque nouvellement ajouté. Vous pouvez également utiliser l’outil pour redimensionner les partitions du disque supplémentaire existant. Pour plus d’informations sur la façon d’attacher des disques supplémentaires et d’utiliser le nouvel outil de partitionnement de disque, consultez Comment attacher un disque supplémentaire à Citrix ADM.

Provisionner des instances Citrix ADC dans OpenStack à l’aide de StyleBooks

À partir de Citrix ADM 12.1 build 49.23, l’architecture du flux de travail d’orchestration OpenStack a été mise à jour. Le workflow utilise désormais Citrix ADM StyleBooks pour configurer les instances Citrix ADC. Si vous effectuez une mise à niveau vers Citrix ADM 12.1 build 49.23 à partir de la version 12.0 ou de la version 12.1 build 48.18, vous devez exécuter le script de migration suivant :

/mps/scripts/migration_scripts/migrate_configurations.py
<!--NeedCopy-->

Pour plus d’informations sur le StyleBook « os-cs-lb-mon » et le script de migration, consultez Provisioning d’une instance Citrix ADC VPX sur OpenStack à l’aide de StyleBook

Mettre à niveau
February 1, 2024
Contributeur: 
C
February 1, 2024
Contributeur: 
C

Dans cet article

Commentaires sur le site | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.