Application Delivery Management

Mettre à 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 licence 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 à 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 13.0. Après le début du processus de mise à niveau, ADM redémarre et les connexions existantes sont arrêtées et reconnectées à la fin de la mise à niveau. 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 13.0 :

  • Si vous effectuez une mise à niveau à partir de la version 11.1 ou 12.0 56.x et des versions précédentes, effectuez les opérations suivantes :

    1. Mettre à niveau à partir de la version existante vers 12.0 build 57.24.

    2. Mettez à niveau vers la dernière version de la version 12.1.

    3. Mise à niveau vers la version 13.0.

  • Si vous effectuez une mise à niveau à partir de 12.0 build 57.24 et versions ultérieures, commencez par mettre à niveau vers 12.1, puis vers 13.0.

  • Si vous effectuez une mise à niveau à partir de 12.1, vous pouvez directement mettre à niveau vers 13.0.

  • Si vous effectuez une mise à niveau vers 13.0 67.xx et versions ultérieures, effectuez d’abord la mise à niveau vers 13.0 64.xx puis vers 13.0 67.xx et versions ultérieures, pour une meilleure expérience utilisateur.

Points importants à noter avant la mise à niveau vers 13.0 67.xx et versions ultérieures

Lorsque vous mettez à niveau le logiciel ADM vers la version 13.0 67.xx et ultérieure, votre base de données ADM est également migrée. Cette migration de données se produit car ADM utilise désormais PostgreSQL version 10.11.

Remarque

La rétrogradation du logiciel ADM n’est pas prise en charge. Ne tentez pas de rétrograder.

Précautions recommandées :

  • Prenez un instantané du serveur Citrix ADM si vous effectuez une mise à niveau vers 13.0 67.xx et versions ultérieures.

  • 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é. Vérifiez l’interface graphique pour connaître la durée approximative de la mise à niveau.

  • 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. Ouvrez une session sur Citrix ADM avec les informations d’identification de l’administrateur.

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

    Mettre à niveau Citrix ADM

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

    Sélectionner le fichier de mise à niveau

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

    Télécharger une image

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

    Le processus de mise à niveau démarre.

Une fois votre configuration migrée, vous pouvez vous connecter à l’interface graphique ADM. Lors de l’ouverture de session, les données historiques commencent à migrer en arrière-plan pendant que vous pouvez continuer à travailler sur ADM.

13-0-67-x première ouverture de session

Lors de la migration des données historiques, certaines des anciennes données peuvent ne pas être disponibles. Le temps nécessaire à la migration de votre base de données dépend de la taille des données et du nombre de tables.

Vous pouvez surveiller la migration de la base de données à l’aide de l’interface graphique ADM. Cliquez sur Afficher la progression de la mise à niveau pour afficher l’ état de migration de la base

13-0-67-x première ouverture de session

Résolution des problèmes de migration de base de données

Pendant le processus de mise à niveau vers 13.0 67.xx et versions ultérieures, la migration des données historiques Web Insight peut parfois sembler bloquée. Dans de tels cas, pour vérifier les détails de la migration des données, procédez comme suit.

Connectez-vous à l’invite ADM shell et exécutez la commande suivante pour afficher les détails granulaires de la progression.


    cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status

<!--NeedCopy-->

Voici un exemple de sortie

    bash-3.2# cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
    Tue Oct  6 07:41:55 GMT 2020
    157 out of 127346 done in 54 seconds
    File
     /var/mps/db_upgrade/hist_table_mig_data/Web_Insight/af_app_client_server_resp_second_l3p_d7_dump
    bash-3.2#

 <!--NeedCopy-->

Dans cet exemple, af_app_client_server_resp_second_l3p_d7 est l’entrée en cours de mise à niveau. Et 157 entrées sur 127 346 sont migrées en 54 secondes.

Mettre à niveau une paire haute disponibilité de la version 12.1 vers la version 13.0

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

Remarque

Si vous mettez à niveau une paire haute disponibilité à partir de versions 12.0 ou antérieures, consultez la section Mise à niveau de Citrix ADM 12.1

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 :

  • Mettez à 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 vers 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.

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

    Mettre à niveau dr agent1

  5. Exécutez le script suivant :

    . /installmas

    Mettre à niveau dr agent2

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 de l’agent à l’aide des nsrecover informations d’identification.

  3. Assurez-vous que vous téléchargez l’image de mise à niveau de l’agent correcte. Voici un exemple de format de nom de fichier image :

    build-masagent-13.0-48.18.tgz

  4. Connectez-vous à l’agent sur site à l’aide des nsrecover informations d’identification.

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

    Mettre à niveau dr agent3

  6. Exécutez le script suivant :

    ./installmasagent

    Mettre à niveau dr agent4

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 Go), vous pouvez attacher un disque supplémentaire. Vous pouvez attacher plus de disque dans les déploiements mono-serveur et haute disponibilité.

Lorsque vous mettez à niveau Citrix ADM à partir de la version 12.1—13.0, 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 pour connecter 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 la façon d’attacher davantage de disques 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

A partir de Citrix ADM 12.1 build 49.23, l’architecture d’un 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 13.0 à partir de la version 12.0 ou 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 os-cs-lb-mon StyleBook et le script de migration, consultez Provisioning of Citrix ADC VPX instance on OpenStack using StyleBook