Citrix Application Delivery Management

Mise à niveau

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 sectionGestion des licences.

Les informations sur le 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 à partir de la page Téléchargements 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 terminées 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.

Points à noter avant la mise à niveau vers 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 opérations suivantes.

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

    • Ensuite, mettez à niveau vers 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 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 se trouve sur 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 en configuration haute disponibilité, lors de la mise à niveau, n’apportez aucune modification de configuration sur 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 un seul serveur Citrix ADM

Pour mettre à niveau un serveur Citrix ADM unique :

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

    Remarque

    Pour les serveurs Citrix ADM en mode haute disponibilité, tapez 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’utilisateuretMot de passe, entrez les informations d’identification de l’administrateur.

  3. Accédez àSystème>Administrations 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.

Mettre à niveau une paire haute disponibilité des versions antérieures vers la version 12.1

Pour les serveurs Citrix ADM en mode haute disponibilité, vous pouvez effectuer une 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 12.1 à partir d’une version antérieure, la connexion haute disponibilité est établie en interne par le script « Joindre HA » qui s’exécute sur le nœud secondaire. Le temps nécessaire pour le 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. Il peut prendre quelques heures pour rétablir la connexion entre les deux nœuds. Pendant cette période, le nœud principal ne reçoit aucun battement de cœur du nœud secondaire. Vous voyez une notification pour pulsations manquantes 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 haute disponibilité est terminé.

Remarque

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

pgrep -lf installmas

pgrep -lf maintenance

pgrep -lf join_streaming_réplication

pgrep -lf pg_basebackup

Si l’une de ces commandes affiche 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 ou 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 s’explique par le fait que le sous-système Citrix ADM n’a pas complètement redémarré ou que la migration est toujours en cours. Ne redémarrez pas Citrix ADM ou ne tentez pas de récupération de mot de passe. Cela pourrait avoir un effet indésirable et le système pourrait se comporter de façon 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 démarrer 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 dans les serveurs Citrix ADM dans une haute disponibilité :

Lorsque les serveurs Citrix ADM sont déployés en mode haute disponibilité, le fichier de licence est attaché au nœud principal et configuré (verrouillage de nœud) avec l’adresse Hostid ou 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 licence groupée 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.

Considérez un scénario où Citrix ADM a 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 réhébergé L2 doit maintenant être attribué à S2.

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

  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 réhébergé L2 sur le nœud du serveur secondaire S2.

    En ce moment :

    • 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 pouvez accéder uniquement 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 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. Cela est dû au fait que la suppression du serveur de licences et l’ajout d’adresse IP flottante entraînent le retour temporaire des instances Citrix ADC à la prise en charge de la bande passante minimale.

Des scénarios de mise à niveau 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 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. S’il y a une 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 la procédure de nettoyage via l’interface de ligne de commande. 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é, continuez 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 au nouveau nœud secondaire à venir 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 l’adresse IP flottante, accédez àSystème > Déploiement > Configurer l’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 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, Citrix ADM HA nœud 1 (principal) se trouve dans le sous-réseau 1 et Citrix ADM HA nœud 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. Casser manuellement la configuration de haute disponibilité. Pour de plus amples 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, reportez-vous à 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 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é d’une version 12.1 antérieure à 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 à partir de la page de téléchargements 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 où 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. 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 est un processus 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 de plus amples informations, consultez Mettre à niveau le déploiement de reprise après sinistre 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. 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 sur site à 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 :

    . /installmasagent

    image localisée

Supprimer la prise en charge de la fonctionnalité de sauvegarde et 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 après sinistre disponible dans Citrix ADM version 12.1 pour effectuer une sauvegarde complète de votre configuration haute disponibilité Citrix ADM et aider à l’utilisation de la continuité d’activité cas.

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 poursuivre la sauvegarde à l’aide de la fonctionnalité de reprise après sinistre, reportez-vous à la section Sauvegardez 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 qui inclut les fichiers de configuration, les détails de l’instance, les données système, etc., puis pour restaurer votre serveur Citrix ADM dans un déploiement autonome (sauvegarde partielle), reportez-vous à la section Comment faire pour sauvegarder et restaurer votre serveur Citrix ADM dans un déploiement à serveur unique.

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

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

Pour continuer à sauvegarder votre serveur Citrix ADM Citrix, 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 système.

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

    3. Cliquez sur Appliquer les paramètres. Veuillez patienter que votre serveur Citrix ADM redémarre et applique 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, consultezConfigurer la reprise après sinistre pour une haute disponibilité.

Ajouter un disque supplémentaire au serveur Citrix ADM

Si votre besoin de stockage Citrix ADM dépasse l’espace disque par défaut (120 gigaoctets), vous pouvez attacher un disque supplémentaire. Vous pouvez attacher un disque supplémentaire dans les déploiements à serveur unique et à haute disponibilité.

Lorsque vous mettez à niveau Citrix ADM de la version 12.0 vers 12.1, les partitions que vous avez créées sur le disque supplémentaire de la version antérieure 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 dans le disque supplémentaire existant. Pour plus d’informations sur l’attachement de disques supplémentaires et l’utilisation du nouvel outil de partitionnement de disque, reportez-vous à la section Comment faire pour 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 workflow 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 migrtaion, voir Provisionnement de l’instance Citrix ADC VPX sur OpenStack à l’aide de StyleBook