Documentation produit

Mettre à niveau un déploiement

May 31, 2026
Contributeur: 
C

Introduction

Vous pouvez mettre à niveau certains déploiements vers des versions plus récentes sans avoir à configurer de nouvelles machines ou de nouveaux sites au préalable. C’est ce qu’on appelle une mise à niveau sur place.

Pour savoir quelles versions de Citrix Virtual Apps and Desktops vous pouvez mettre à niveau, consultez les Versions que vous pouvez mettre à niveau.

Avant de procéder à la mise à niveau vers l’une des versions de Citrix Virtual Apps and Desktops, assurez-vous que les dates de vos services Customer Success Services actuels sont valides et n’ont pas expiré. Pour plus d’informations, consultez l’article Licences de renouvellement des services Customer Success Services.

Pour démarrer une mise à niveau, exécutez le programme d’installation de la nouvelle version afin de mettre à niveau les composants principaux, les VDA et certains autres composants précédemment installés. Ensuite, vous mettez à niveau la base de données et le site.

Vous pouvez mettre à niveau tout composant pouvant être installé avec le programme d’installation complet du produit (et les programmes d’installation VDA autonomes), si une version plus récente est disponible. Pour les autres composants qui ne sont pas installés avec le programme d’installation complet du produit (tels que Citrix Provisioning™ et Profile Management), consultez la documentation de ce composant pour obtenir des conseils. Pour les mises à niveau d’hôtes, consultez la documentation appropriée.

Passez en revue toutes les informations de cet article avant de commencer une mise à niveau.

Séquence de mise à niveau

Le diagramme suivant présente les étapes de la séquence de mise à niveau. La Procédure de mise à niveau contient les détails de chaque étape du diagramme.

Diagramme de flux de la séquence de mise à niveau

Remarque :

Pour éviter les échecs, vous devez mettre à niveau tous les Delivery Controllers et la base de données avant d’effectuer toute tâche liée au provisioning et aux groupes de mise à disposition, telle que la création d’un nouveau catalogue de machines, la suppression d’un catalogue de machines, la mise à jour d’une machine dans un groupe de mise à disposition, etc.

Licences Hybrid Rights

Les licences Hybrid Rights sont des licences d’abonnement basées sur une durée qui sont fournies, en plus de l’abonnement au service cloud, lorsqu’un client passe d’une licence perpétuelle à un abonnement au service cloud ou effectue une mise à niveau. Vous pouvez également acheter un module complémentaire Hybrid Rights avec vos abonnements DaaS.

Si vous disposez d’une licence Hybrid Rights avec un attribut SaaS, lorsque vous effectuez une mise à niveau vers Citrix Virtual Apps and Desktops™ LTSR 2203 et versions ultérieures, vous devenez éligible pour accéder à des fonctionnalités non disponibles avec Citrix Virtual Apps and Desktops LTSR 1912. Ces fonctionnalités incluent le provisionnement et l’hébergement de charges de travail dans des clouds publics, tels que Microsoft Azure, AWS EC2 et Google Cloud. Avant de déployer le nouveau fichier de licence, mettez à jour votre License Server vers la version la plus récente.

Si vous avez accès à une licence Hybrid Rights sans attribut SaaS, suivez ces étapes pour obtenir l’accès à la nouvelle licence Hybrid Rights avec attribut SaaS :

Remarque :

  1. Accédez au portail de gestion des licences citrix.com et téléchargez le nouveau fichier de licence Hybrid Rights avec les droits de provisionnement cloud activés (attribut SaaS). Pour plus d’informations, consultez Télécharger les licences. L’image suivante montre le fichier de licence Hybrid Rights avec l’attribut SaaS dans la section Incréments.

    Attribut SaaS dans le fichier de licence

  2. Installez le fichier de licence Hybrid Rights sur le License Server. Pour plus d’informations, consultez Installer les licences.
  3. S’il y a un changement dans les éditions ou le modèle de licence, assurez-vous d’exécuter la commande broker pour définir l’édition et le modèle, puis démarrez la mise à niveau sur place. Pour plus d’informations sur les commandes Broker, consultez la section SDK PowerShell Broker.

Pour plus d’informations sur la prise en charge du cloud public avec les versions actuelles et les versions de service à long terme de Citrix Virtual Apps and Desktops, consultez CTX270373.

Procédure de mise à niveau

La plupart des principaux composants du produit peuvent être mis à niveau en exécutant le programme d’installation du produit sur la machine contenant le composant.

Si une machine contient plusieurs composants (par exemple, Studio et License Server), tous les composants de cette machine sont mis à niveau si le support du produit contient des versions plus récentes de leur logiciel.

Pour utiliser les programmes d’installation :

  • Pour exécuter l’interface graphique du programme d’installation complet du produit, connectez-vous à la machine, puis insérez le support ou montez le lecteur ISO pour la nouvelle version. Double-cliquez sur AutoSelect.
  • Pour utiliser l’interface de ligne de commande, exécutez la commande appropriée. Voir Installer à l’aide de la ligne de commande.

Étape 1 : Préparation

Avant de commencer une mise à niveau, assurez-vous d’être prêt. Lisez et effectuez toutes les tâches nécessaires :

Étape 2 : Mettre à niveau le serveur de licences

Si l’installation inclut une nouvelle version du logiciel Citrix License Server, mettez à niveau ce composant en premier, avant tout autre composant.

Si vous n’avez pas encore déterminé si votre serveur de licences est compatible avec la nouvelle version, il est essentiel d’exécuter le programme d’installation sur le serveur de licences avant de mettre à niveau tout autre composant principal.

Étape 3 : Mettre à niveau StoreFront™

Si le support d’installation contient une nouvelle version du logiciel StoreFront, exécutez le programme d’installation sur la machine contenant le serveur StoreFront.

  • Dans l’interface graphique, choisissez Citrix StoreFront dans la section Étendre le déploiement.
  • À partir de la ligne de commande, exécutez CitrixStoreFront-x64.exe, qui est disponible dans le dossier x64 du support d’installation de Citrix Virtual Apps and Desktops.

Étape 4 : Mettre à niveau Director

Si le support d’installation contient une nouvelle version du logiciel Director, exécutez le programme d’installation sur la machine contenant Director.

Étape 5 : Mettre à niveau Citrix Provisioning

Le support d’installation de Citrix Provisioning est disponible séparément du support d’installation de Citrix Virtual Apps and Desktops. Pour savoir comment installer et mettre à niveau le serveur Citrix Provisioning et le logiciel des périphériques cibles, consultez la documentation produit de Citrix Provisioning.

Étape 6 : Mettre à niveau la moitié des Delivery Controllers

Par exemple, si votre site dispose de quatre Controllers, exécutez le programme d’installation sur deux d’entre eux.

Laisser la moitié des Controllers actifs permet aux utilisateurs d’accéder au site. Les VDA peuvent s’enregistrer auprès des Controllers restants. Il peut arriver que le site ait une capacité réduite en raison du nombre inférieur de Controllers disponibles. La mise à niveau n’entraîne qu’une brève interruption de l’établissement de nouvelles connexions client pendant les dernières étapes de la mise à niveau de la base de données. Les Controllers mis à niveau ne peuvent pas traiter les requêtes tant que l’ensemble du site n’est pas mis à niveau.

Si votre site ne dispose que d’un seul Controller, il est inopérant pendant la mise à niveau.

Des tests préliminaires du site sont exécutés sur le premier Controller, avant le début de la mise à niveau proprement dite. Pour plus de détails, consultez Tests préliminaires du site.

Étape 7 : Mettre à niveau Studio

Si vous n’avez pas encore mis à niveau Web Studio (parce qu’il se trouvait sur la même machine qu’un autre composant), exécutez le programme d’installation sur la machine contenant Studio.

Remarque :

Après la mise à niveau de Web Studio, les informations de version peuvent ne pas être mises à jour immédiatement. Il peut vous être demandé de mettre à niveau Web Studio même s’il est déjà à jour. Pour résoudre le problème, accédez au serveur Web Studio, ouvrez le Gestionnaire des services Internet (IIS), accédez à Page de démarrage > Sites > Site Web par défaut, et sélectionnez Redémarrer dans le volet Gérer le site Web.

Étape 8 : Redémarrer Studio

Redémarrez le Web Studio mis à niveau. Le processus de mise à niveau reprend automatiquement.

Étape 9 : Mettre à niveau la base de données et le site

Remarque :

Pour éviter les échecs, vous devez mettre à niveau tous les Delivery Controllers et la base de données avant d’effectuer l’une des tâches liées au provisionnement et aux groupes de mise à disposition, telles que la création d’un nouveau catalogue de machines, la suppression d’un catalogue de machines, la mise à jour d’une machine dans un groupe de mise à disposition, etc.

Consultez Préparation pour connaître les autorisations requises pour mettre à jour le schéma des bases de données SQL Server.

  • Si vous disposez des autorisations suffisantes pour mettre à jour le schéma de la base de données SQL Server, vous pouvez lancer une mise à niveau automatique de la base de données. Poursuivez avec Mettre à niveau la base de données et le site automatiquement.
  • Si vous ne disposez pas d’autorisations de base de données suffisantes, vous pouvez lancer une mise à niveau manuelle à l’aide de scripts, et procéder avec l’aide de votre administrateur de base de données (quelqu’un qui dispose des autorisations requises). Pour une mise à niveau manuelle, l’utilisateur de Studio génère les scripts, puis exécute les scripts qui activent et désactivent les services. L’administrateur de base de données exécute d’autres scripts qui mettent à jour le schéma de la base de données, en utilisant l’utilitaire SQLCMD ou SQL Server Management Studio en mode SQLCMD. Poursuivez avec Mettre à niveau la base de données et le site manuellement.
  • Si vous disposez d’un déploiement multi-zones et que vous souhaitez mettre à niveau la base de données et le site automatiquement, Citrix recommande que la mise à niveau du schéma de la base de données soit effectuée dans la même zone qui héberge les bases de données SQL Server du site. Sinon, la mise à niveau automatique de la base de données et du site pourrait échouer.

Citrix recommande fortement de sauvegarder la base de données avant la mise à niveau. Voir CTX135207. Pendant une mise à niveau de la base de données, les services du produit sont désactivés. Pendant ce temps, les contrôleurs ne peuvent pas établir de nouvelles connexions pour le site, planifiez donc avec soin.

Mettre à niveau la base de données et le site automatiquement

  1. Démarrez le Studio nouvellement mis à niveau.
  2. Indiquez que vous souhaitez démarrer la mise à niveau du site automatiquement et confirmez que vous êtes prêt.

La mise à niveau de la base de données et du site se poursuit.

Mettre à niveau la base de données et le site manuellement

  1. Démarrez le Studio nouvellement mis à niveau.
  2. Indiquez que vous souhaitez mettre à niveau le site manuellement. L’assistant vérifie la compatibilité du serveur de licences et demande une confirmation.

  3. Confirmez que vous avez sauvegardé la base de données.

    L’assistant génère et affiche les scripts et une liste de contrôle des étapes de mise à niveau. Si le schéma d’une base de données n’a pas changé depuis la version du produit mise à niveau, ce script n’est pas généré. Par exemple, si le schéma de la base de données de journalisation ne change pas, le script UpgradeLoggingDatabase.sql n’est pas généré.

  4. Exécutez les scripts suivants dans l’ordre indiqué.

    • DisableServices.ps1 : L’utilisateur de Studio exécute ce script PowerShell sur un Controller pour désactiver les services du produit.
    • UpgradeSiteDatabase.sql : L’administrateur de base de données exécute ce script SQL sur le serveur contenant la base de données du site.
    • UpgradeMonitorDatabase.sql : L’administrateur de base de données exécute ce script SQL sur le serveur contenant la base de données Monitor.
    • UpgradeLoggingDatabase.sql : L’administrateur de base de données exécute ce script SQL sur le serveur contenant la base de données de journalisation de la configuration. Exécutez ce script uniquement si cette base de données change (par exemple, après l’application d’un correctif).
    • EnableServices.ps1 : L’utilisateur de Studio exécute ce script PowerShell sur un Controller pour activer les services du produit.

    Une fois la mise à niveau de la base de données terminée et les services du produit activés, Studio teste automatiquement l’environnement et la configuration, puis génère un rapport HTML. Si des problèmes sont identifiés, vous pouvez restaurer la sauvegarde de la base de données. Après avoir résolu les problèmes, vous pouvez mettre à niveau la base de données à nouveau.

  5. Une fois les tâches de la liste de contrôle terminées, cliquez sur Terminer la mise à niveau.

Étape 10 : Mettre à niveau les Delivery Controllers restants

Depuis le Studio nouvellement mis à niveau, sélectionnez Citrix Studio nom-du-site dans le volet de navigation. Dans l’onglet Tâches courantes, sélectionnez Mettre à niveau les Delivery Controllers restants.

Remarque :

Pour rendre Mettre à niveau les Delivery Controller restants disponible, créez au moins un catalogue de machines et un groupe de mise à disposition pour le site.

Après avoir terminé la mise à niveau et confirmé son achèvement, fermez puis rouvrez Studio. Studio peut demander une mise à niveau supplémentaire du site pour enregistrer les services du Controller sur le site, ou pour créer un ID de zone s’il n’existe pas.

Étape 11 : Mettre à niveau les VDA

Important :

Si vous mettez à niveau un VDA vers la version 1912 ou ultérieure, consultez Mise à niveau des VDA vers la version 1912 ou ultérieure.

Exécutez le programme d’installation du produit sur les machines contenant des VDA.

Si vous avez utilisé Machine Creation Services™ et une image principale pour créer des machines, accédez à votre hôte et mettez à niveau le VDA sur l’image principale. Vous pouvez utiliser n’importe quel programme d’installation de VDA disponible.

Si vous avez utilisé Citrix Provisioning pour créer des machines, consultez la documentation produit de Citrix Provisioning pour obtenir des instructions sur la mise à niveau.

Étape 12 : Mettre à jour les catalogues de machines et les groupes de mise à disposition

Étape 13 : Après la mise à niveau

Mettez à niveau les autres composants de votre déploiement. Pour obtenir des conseils, consultez la documentation produit suivante :

Si vous devez remplacer le logiciel Microsoft SQL Server Express LocalDB par une version ultérieure, consultez Remplacer SQL Server Express LocalDB.

Mise à niveau du dbschema

Lorsque vous mettez à jour votre déploiement, plusieurs schémas de base de données peuvent être mis à niveau. Le tableau suivant répertorie les schémas de base de données mis à niveau au cours du processus :

Mises à jour du schéma de base de données

Définition des termes :

  • Site : Magasin de données du site. La mise à jour du schéma de base de données est effectuée dans le magasin de données du site.
  • Moniteur : Magasin de données du moniteur. La mise à jour du schéma de base de données est effectuée dans le magasin de données du moniteur.
  • Config : Table de configuration. La version de Desktop Studio, les informations de licence, ou les deux, sont mises à jour dans la table de configuration.
  • Journalisation : Magasin de données de journalisation. La mise à jour du schéma de base de données est effectuée dans le magasin de données de journalisation.

Mettre à niveau les VDA vers la version 2203 ou ultérieure

Si le composant Personal vDisk (PvD) a déjà été installé sur un VDA, ce VDA ne peut pas être mis à niveau vers la version 2203 ou ultérieure. Pour utiliser le nouveau VDA, vous devez désinstaller le VDA actuel, puis installer le nouveau VDA.

Cette instruction s’applique même si vous n’avez jamais utilisé PvD.

Voici comment le composant PvD a pu être installé dans les versions antérieures :

  • Dans l’interface graphique de l’installeur VDA, PvD était une option sur la page Composants supplémentaires.
  • Sur la ligne de commande, l’option /baseimage installait PvD. Si vous avez spécifié cette option, ou utilisé un script qui la contenait, PvD a été installé.

Si vous ne savez pas si votre VDA a PvD installé, exécutez l’installeur du nouveau VDA (2203 ou version ultérieure) sur la machine ou l’image.

  • Si PvD est installé, un message apparaît, indiquant qu’il existe un composant incompatible.
    • Depuis l’interface graphique, cliquez sur Annuler sur la page contenant le message, puis confirmez que vous souhaitez fermer l’installeur.
    • Depuis la CLI, la commande échoue simplement avec le message affiché.
  • Si PvD n’est pas installé, la mise à niveau se poursuit.

Que faire

Si le VDA n’a pas PvD installé, suivez la procédure de mise à niveau habituelle.

Si le VDA a PvD installé :

  1. Désinstallez le VDA actuel.
  2. Installez le nouveau VDA.

Si vous souhaitez continuer à utiliser PvD sur vos machines Windows 10 (1607 et versions antérieures, sans mises à jour), VDA 7.15 LTSR est la dernière version prise en charge.

Remarque :

Puis-je utiliser Personal vDisk avec des bureaux Windows 7 dans XenApp et XenDesktop 7.15 LTSR ?

Citrix a exclu Personal vDisk (PvD) de XenApp et XenDesktop 7.6 LTSR, ce qui a été annoncé en janvier 2016. De plus, Citrix a annoncé l’abandon de la technologie PvD et recommande aux clients de commencer à utiliser Citrix App Layering à l’avenir. Citrix App Layering (version 4.4 et ultérieure) est un composant compatible de XenApp et XenDesktop 7.15 LTSR. Cependant, pour aider les clients disposant de déploiements PvD existants sur Windows 7 à migrer vers la technologie Citrix App Layering, Citrix a décidé de fournir un support limité dans le temps pour les déploiements PvD pour les bureaux Windows 7 via les mises à jour cumulatives (CU) de XenApp et XenDesktop 7.15 LTSR jusqu’au 14 janvier 2020. Le composant PvD sera supprimé des CU LTSR et ne sera plus pris en charge après le 14 janvier 2020. De plus, l’utilisation de PvD pour Windows 7 au-delà du 14 janvier 2020 rendra les sites LTSR non conformes. De même, PvD pour Windows 10 reste exclu de 7.15 LTSR. Par conséquent, les clients ne doivent pas l’utiliser avec leurs sites 7.15 LTSR.

Supprimer PvD, AppDisks et les hôtes non pris en charge

Les technologies et types d’hôtes suivants ne sont pas pris en charge dans les déploiements de Citrix Virtual Apps and Desktops 7 Current Release :

  • Personal vDisks (PvD) pour le stockage des données à côté des machines virtuelles des utilisateurs dans les catalogues. La fonctionnalité de couche de personnalisation utilisateur gère désormais la persistance des utilisateurs.
  • AppDisks pour la gestion des applications utilisées dans les groupes de mise à disposition.
  • Types d’hôtes : Azure Classic, CloudPlatform (le produit Citrix d’origine).
    • Pour les types d’hôtes pris en charge dans cette version, consultez Configuration système requise.
    • Pour plus d’informations sur les autres façons de continuer à utiliser ARM et AWS, consultez CTX270373.

Si votre déploiement actuel utilise des PvD ou des AppDisks, ou a des connexions à des types d’hôtes non pris en charge (par exemple, Microsoft Azure Classic), vous ne pouvez effectuer la mise à niveau vers la version 2006 (ou des versions ultérieures prises en charge) qu’après avoir supprimé les éléments qui utilisent ces technologies. Si votre déploiement actuel utilise des connexions d’hôte de cloud public (par exemple, AWS), assurez-vous de disposer d’une licence Hybrid Rights avant la mise à niveau. Lorsque le programme d’installation détecte une ou plusieurs des technologies non prises en charge ou des connexions d’hôte sans licence Hybrid Rights, la mise à niveau est suspendue ou arrêtée, et un message explicatif apparaît. Les journaux du programme d’installation contiennent des détails.

Pour garantir une mise à niveau réussie, examinez et suivez les instructions applicables pour la suppression des éléments non pris en charge.

Même si vous n’avez pas utilisé PvD ou AppDisks dans votre déploiement, des MSI associés peuvent avoir été inclus dans une installation ou une mise à niveau VDA antérieure. Avant de pouvoir mettre à niveau vos VDA vers la version 2006 (ou une version ultérieure prise en charge), vous devez supprimer ce logiciel, même si vous ne l’avez jamais utilisé. Lorsque vous utilisez l’interface graphique, cette suppression peut être effectuée pour vous, ou vous pouvez inclure des options de suppression lorsque vous utilisez la CLI. Pour plus de détails, consultez Mise à niveau des VDA dotés de composants PvD ou AppDisks.

Supprimer PvD

Une mise à niveau de déploiement ne peut pas réussir tant que vous n’avez pas supprimé toutes les machines configurées pour utiliser PvD. Cela affecte les catalogues et les groupes de mise à disposition.

Pour supprimer PvD des groupes et des catalogues :

  1. Dans Studio, si un groupe de mise à disposition contient des machines d’un catalogue qui utilise PvD, supprimez ces machines du groupe.
  2. Dans Studio, supprimez tous les catalogues contenant des machines qui utilisent PvD.

Mises à niveau VDA : La mise à niveau du déploiement ne détecte pas si les VDA ont les composants AppDisk ou PvD installés. Cependant, les programmes d’installation VDA le font. Pour plus de détails, consultez VDA dotés de composants PvD ou AppDisks.

Si vous prévoyez d’utiliser App Layering au lieu de PvD, consultez Migration de PvD vers App Layering pour plus d’informations sur le déplacement des données.

Supprimer les AppDisks

Une mise à niveau du déploiement ne peut pas se poursuivre tant que vous n’avez pas supprimé les AppDisks de tous les groupes de mise à disposition qui les utilisent, puis supprimé les AppDisks eux-mêmes.

  1. Sélectionnez Groupes de mise à disposition dans le volet de navigation de Studio.
  2. Sélectionnez un groupe, puis cliquez sur Gérer les AppDisks dans le volet Actions.
  3. Cliquez sur l’action qui supprime l’AppDisk du groupe.
  4. Répétez les étapes 2 et 3 pour chaque groupe de mise à disposition qui utilise des AppDisks.
  5. Sélectionnez AppDisks dans le volet de navigation de Studio.
  6. Sélectionnez un AppDisk et cliquez sur l’action qui supprime l’AppDisk.
  7. Répétez les étapes 5 et 6 pour chaque AppDisk.

Mises à niveau de VDA : La mise à niveau du déploiement ne détecte pas si les VDA ont les composants AppDisk ou PvD installés. Cependant, les programmes d’installation de VDA le font. Pour plus de détails, consultez VDA avec des composants PvD ou AppDisks.

Supprimer les éléments d’hôte non pris en charge

Une mise à niveau du déploiement vers la version 2006 (ou une version ultérieure prise en charge) ne peut pas se poursuivre si le site a des connexions à des types d’hôtes non pris en charge, tels que Citrix CloudPlatform ou Microsoft Azure Classic. Effectuez les tâches suivantes avant de tenter une mise à niveau.

Depuis Studio :

VDA avec des composants PvD ou AppDisks

Si les composants qui activent les technologies PvD et AppDisks sont installés sur un VDA, ce VDA ne peut pas être mis à niveau tant que ces composants n’ont pas été supprimés.

Remarque :

Lors de la mise à niveau vers la version 1912, vous deviez désinstaller le VDA actuel, puis installer le nouveau VDA. Dans cette version, il vous est demandé si vous souhaitez que Citrix supprime le composant, puis poursuive la mise à niveau.

Les composants AppDisk et PvD ont pu être installés dans des versions antérieures du VDA, même si vous n’avez jamais utilisé ces technologies :

  • Interface graphique : Dans les programmes d’installation du VDA, la page Composants supplémentaires contenait l’option Citrix AppDisk / Personal vDisk. Les versions 7.15 LTSR et antérieures de 7.x ont activé cette option par défaut. Ainsi, si vous avez accepté les paramètres par défaut (ou explicitement activé l’option dans toute version qui la proposait), ce composant a été installé.
  • CLI : La spécification de l’option /baseimage a installé le composant.

Que faire

Si le programme d’installation du VDA ne détecte pas les composants AppDisks ou PvD dans le VDA actuellement installé, la mise à niveau se déroule normalement.

Si le programme d’installation détecte des composants AppDisks ou PvD dans le VDA actuellement installé :

  • Interface graphique : La mise à niveau est interrompue. Un message vous demande si vous souhaitez que les composants non pris en charge soient supprimés automatiquement. Si vous cliquez sur OK, les composants sont supprimés automatiquement et la mise à niveau se poursuit.

  • CLI : Pour éviter l’échec de la commande, incluez les options suivantes dans la commande :

    • /remove_appdisk_ack
    • /remove_pvd_ack

Limitations

Les limitations suivantes s’appliquent aux mises à niveau :

  • Installation sélective des composants : Si vous installez ou mettez à niveau des composants vers la nouvelle version, mais choisissez de ne pas mettre à niveau d’autres composants (sur des machines différentes) qui nécessitent une mise à niveau, Studio vous le rappelle. Par exemple, supposons qu’une mise à niveau inclut de nouvelles versions du Controller et de Studio. Vous mettez à niveau le Controller, mais vous n’exécutez pas le programme d’installation sur la machine où Studio est installé. Studio ne vous permettra pas de continuer à gérer le site tant que vous n’aurez pas mis à niveau Studio.

    Vous n’êtes pas obligé de mettre à niveau les VDA, mais Citrix recommande de mettre à niveau tous les VDA pour vous permettre d’utiliser toutes les fonctionnalités disponibles.

  • Versions préliminaires ou d’évaluation technologique : Vous ne pouvez pas effectuer de mise à niveau à partir d’une version préliminaire, d’une version d’évaluation technologique ou d’une version d’aperçu.

  • Composants sur des systèmes d’exploitation antérieurs : Vous ne pouvez pas installer les VDA actuels sur des systèmes d’exploitation qui ne sont plus pris en charge par Microsoft ou Citrix. Pour plus d’informations, consultez la section Systèmes d’exploitation antérieurs.

  • Environnements/sites mixtes : Si vous devez continuer à exécuter des sites d’anciennes versions et des sites de versions actuelles, consultez la section Considérations relatives aux environnements mixtes.

  • Sélection du produit : Lorsque vous effectuez une mise à niveau à partir d’une version antérieure, vous ne choisissez ni ne spécifiez le produit (Citrix Virtual Apps ou Citrix Virtual Apps and Desktops) qui a été défini lors de l’installation.

Considérations relatives aux environnements mixtes

Lors de la mise à niveau, Citrix vous recommande de mettre à niveau tous les composants et VDA afin que vous puissiez accéder à toutes les fonctionnalités nouvelles et améliorées de votre édition et de votre version.

Par exemple, bien que vous puissiez utiliser les VDA actuels dans des déploiements contenant des versions antérieures du Controller, les nouvelles fonctionnalités de la version actuelle pourraient ne pas être disponibles. Des problèmes d’enregistrement VDA peuvent également survenir lors de l’utilisation de versions non actuelles.

Dans certains environnements, il est possible que vous ne puissiez pas mettre à niveau tous les VDA vers la version la plus récente. Dans ce cas, lorsque vous créez un catalogue de machines, vous pouvez spécifier la version du VDA installée sur les machines. (C’est ce qu’on appelle le niveau fonctionnel.) Par défaut, ce paramètre spécifie la version VDA minimale recommandée. La valeur par défaut est suffisante pour la plupart des déploiements. Envisagez de modifier le paramètre pour une version antérieure uniquement si le catalogue contient des VDA antérieurs à la valeur par défaut. Le mélange de versions VDA dans un catalogue de machines n’est pas recommandé.

Si un catalogue est créé avec le paramètre de version VDA minimale par défaut, et qu’une ou plusieurs machines ont un VDA antérieur à la version par défaut, ces machines ne peuvent pas s’enregistrer auprès du Controller et ne fonctionneront pas.

Pour plus d’informations, consultez la section Versions VDA et niveaux fonctionnels.

Plusieurs sites avec des versions différentes

Lorsque votre environnement contient des sites avec des versions de produits différentes (par exemple, un site XenDesktop 7.18 et un site Citrix Virtual Apps and Desktops 1909), Citrix recommande d’utiliser StoreFront pour agréger les applications et les bureaux de différentes versions de produits. Pour plus de détails, consultez la documentation StoreFront.

Dans un environnement mixte, continuez à utiliser les versions de Studio et Director pour chaque version, mais assurez-vous que les différentes versions sont installées sur des machines distinctes.

Systèmes d’exploitation antérieurs

Supposons que vous ayez installé une version antérieure d’un composant sur une machine exécutant une version de système d’exploitation (OS) prise en charge. Vous souhaitez maintenant utiliser une version plus récente du composant, mais ce système d’exploitation n’est plus pris en charge pour la version actuelle du composant.

Par exemple, supposons que vous ayez installé un VDA de serveur sur une machine Windows Server 2016. Vous souhaitez maintenant mettre à niveau ce VDA vers la version actuelle, mais Windows Server 2016 n’est pas pris en charge dans la version actuelle vers laquelle vous effectuez la mise à niveau.

Si vous tentez d’installer ou de mettre à niveau un composant sur un système d’exploitation qui n’est plus autorisé, un message d’erreur s’affiche, tel que « Impossible d’installer sur ce système d’exploitation ».

Ces considérations s’appliquent à la mise à niveau des versions Current Release et Long Term Service Release. (Cela n’affecte pas l’application des CU à une version LTSR.)

Suivez les liens pour savoir quels systèmes d’exploitation sont pris en charge :

Systèmes d’exploitation non valides

Le tableau suivant répertorie les systèmes d’exploitation antérieurs qui ne sont pas valides pour l’installation/la mise à niveau de composants dans la version actuelle. Il indique la dernière version de composant valide prise en charge pour chaque système d’exploitation répertorié, et la version de composant à partir de laquelle l’installation et la mise à niveau sont devenues non valides.

Les systèmes d’exploitation du tableau incluent les Service Packs et les mises à jour.

Système d’exploitation Composant/fonctionnalité Dernière version valide Installation/mise à niveau impossible à partir de la version
Windows 7 et Windows 8 VDA 7.15 LTSR 7.16
Windows 7 et Windows 8 Autres composants du programme d’installation 7.17 7.18
Versions de Windows 10 antérieures à 1607 VDA 7.15 LTSR 7.16
Version Windows 10 x86 VDA 1906.2.0 1909
Windows Server 2008 R2 VDA 7.15 LTSR 7.16
Windows Server 2008 R2 Autres composants du programme d’installation 7.17 7.18
Windows Server 2012 VDA 7.15 LTSR 7.16
Windows Server 2012 Autres composants du programme d’installation 7.17 7.18
Windows Server 2012 R2 Autres composants du programme d’installation * 1912 LTSR 2003
Windows Server 2012 R2 VDI de serveur 7.15 LTSR 7.16
Windows Server 2016 VDI de serveur 7.15 LTSR 7.16

Windows XP et Windows Vista ne sont pas valides pour les composants ou technologies 7.x.

* S’applique à Delivery Controller, Studio, Director et aux VDA.

Ce que vous pouvez faire

Vous avez le choix. Vous pouvez :

Continuer avec le système d’exploitation actuel

Ces méthodes sont réalisables pour les VDA. Si vous souhaitez continuer à utiliser des machines avec l’ancien système d’exploitation, vous pouvez choisir l’une des options suivantes :

  • Continuer à utiliser la version du composant installée.
  • Télécharger la dernière version valide du composant, puis mettre à niveau le composant vers cette version. (Ceci suppose que la dernière version valide du composant n’est pas déjà installée.)

Par exemple, vous avez un VDA 7.14 sur une machine Windows 7 SP1. La dernière version valide de VDA sur les machines Windows 7 est XenApp et XenDesktop 7.15 LTSR. Vous pouvez soit continuer à utiliser la version 7.14, soit télécharger un VDA 7.15 LTSR, puis mettre à niveau votre VDA vers cette version. Ces versions antérieures de VDA fonctionnent dans des déploiements contenant des Delivery Controllers avec des versions plus récentes. Par exemple, un VDA 7.15 LTSR peut se connecter à un Controller Citrix Virtual Apps and Desktops 7 1808.

Réinitialiser ou mettre à niveau la machine

Ces méthodes sont réalisables pour les VDA et les autres machines qui n’ont pas de composants principaux (tels que les Delivery Controllers) installés. Choisissez l’une des options suivantes :

  • Après avoir mis la machine hors service (en activant le mode maintenance et en permettant la fermeture de toutes les sessions), vous pouvez la réinitialiser avec une version de système d’exploitation Windows prise en charge, puis installer la dernière version du composant.
  • Pour mettre à niveau le système d’exploitation d’une machine VDA sans la réinitialiser, vous devez d’abord installer la version du VDA prise en charge sur le système d’exploitation vers lequel vous effectuez la mise à niveau ou mettre à niveau le VDA après la mise à niveau du système d’exploitation. Dans le cas contraire, le logiciel Citrix ne sera pas pris en charge. Vous pouvez effectuer une mise à niveau vers les versions de système d’exploitation minimales suivantes lors d’une mise à niveau sur place sans désinstaller le VDA :
  • Si la version de Windows vers laquelle vous prévoyez de mettre à niveau ne correspond pas à la directive susmentionnée, vous devez désinstaller le VDA avant de mettre à niveau le système d’exploitation, puis installer une version de VDA prise en charge une fois la mise à niveau du système d’exploitation terminée.

Ajouter de nouvelles machines, puis supprimer les anciennes machines

Cette méthode est réalisable si vous devez mettre à niveau le système d’exploitation sur des machines contenant un Delivery Controller™ ou un autre composant principal.

Citrix recommande que tous les Controllers d’un site aient le même système d’exploitation. La séquence de mise à niveau suivante minimise l’intervalle pendant lequel différents Controllers ont des systèmes d’exploitation différents.

  1. Prenez un instantané de tous les Delivery Controllers du site, puis sauvegardez la base de données du site.
  2. Installez de nouveaux Delivery Controllers sur des serveurs vierges avec des systèmes d’exploitation pris en charge.
  3. Ajoutez les nouveaux Controllers au site.
  4. Supprimez les Controllers qui s’exécutent sur des systèmes d’exploitation non valides pour la version actuelle. Suivez les recommandations pour la suppression des Controllers dans Delivery Controllers.

Préparation

Avant de commencer une mise à niveau, examinez les informations suivantes et effectuez les tâches nécessaires.

Remarque :

Bien que la mise à niveau des VDA ait lieu plus tard dans la séquence de mise à niveau, il est judicieux de choisir un programme d’installation et d’examiner la procédure avant de commencer la mise à niveau, afin de savoir à quoi vous attendre.

Choisir un programme d’installation et une interface

Utilisez le programme d’installation complet du produit à partir de l’ISO du produit pour mettre à niveau les composants. Vous pouvez mettre à niveau les VDA à l’aide du programme d’installation complet du produit ou de l’un des programmes d’installation VDA autonomes. Tous les programmes d’installation offrent des interfaces graphiques et en ligne de commande.

Pour plus d’informations, consultez Programmes d’installation.

Spécificités de l’installation : Une fois que vous avez terminé les travaux de préparation et que vous êtes prêt à démarrer le programme d’installation, l’article d’installation vous montre ce que vous verrez (si vous utilisez l’interface graphique) ou ce que vous devez taper (si vous utilisez l’interface de ligne de commande).

Si vous avez initialement installé un VDA à session unique avec le programme d’installation VDAWorkstationCoreSetup.exe, Citrix recommande d’utiliser ce programme d’installation pour le mettre à niveau. Si vous utilisez le programme d’installation VDA complet du produit ou le programme d’installation VDAWorkstationSetup.exe pour mettre à niveau le VDA, les composants qui étaient initialement exclus peuvent être installés, à moins que vous ne les omettiez/excluez expressément de la mise à niveau.

Lors de la mise à niveau d’un VDA vers la version actuelle, un redémarrage de la machine se produit pendant le processus de mise à niveau. (Cette exigence a commencé avec la version 7.17.) Cela ne peut pas être évité. La mise à niveau reprend automatiquement après le redémarrage (sauf si vous spécifiez /noresume sur la ligne de commande).

Actions de base de données

Sauvegardez les bases de données du site, de la surveillance et de la journalisation de la configuration. Suivez les instructions de CTX135207. Si des problèmes sont découverts après la mise à niveau, vous pouvez restaurer la sauvegarde.

Pour plus d’informations sur la mise à niveau des versions de SQL Server qui ne sont plus prises en charge, consultez Vérification de la version de SQL Server. (Ceci fait référence au SQL Server utilisé pour les bases de données du site, de la surveillance et de la journalisation de la configuration.)

Microsoft SQL Server Express LocalDB est installé automatiquement, pour être utilisé avec le cache d’hôte local. Si vous devez remplacer une version antérieure, la nouvelle version doit être SQL Server Express LocalDB 2019. Pour plus de détails sur le remplacement de SQL Server Express LocalDB par la nouvelle version après la mise à niveau des composants et du site, consultez Remplacer SQL Server Express LocalDB.

Assurez-vous que votre licence Citrix est à jour

Pour un aperçu complet de la gestion des licences Citrix, consultez Activer, mettre à niveau et gérer les licences Citrix.

Vous pouvez utiliser le programme d’installation complet du produit pour mettre à niveau le serveur de licences. Ou, vous pouvez télécharger et mettre à niveau les composants de licence séparément. Consultez Mettre à niveau.

Avant la mise à niveau, assurez-vous que la date de vos services Customer Success / maintenance logicielle / Subscription Advantage est valide pour la nouvelle version du produit. La date doit être au moins le 15/11/2021.

Assurez-vous que votre serveur de licences Citrix est compatible

Assurez-vous que votre serveur de licences Citrix est compatible avec la nouvelle version. Il existe deux façons de procéder :

  • Avant de mettre à niveau d’autres composants Citrix, exécutez le programme d’installation XenDesktopServerSetup.exe à partir de l’image ISO sur la machine contenant un Delivery Controller. En cas de problèmes d’incompatibilité, le programme d’installation les signale et propose des étapes recommandées pour les résoudre.

  • À partir du répertoire XenDesktop Setup sur le support d’installation, exécutez la commande : .\LicServVerify.exe -h <license-server-fqdn> -p 27000 -v. L’affichage indique si le serveur de licences est compatible. Si le serveur de licences est incompatible, mettez à niveau le serveur de licences.

Sauvegardez toutes les modifications StoreFront

Avant de commencer une mise à niveau, si vous avez modifié des fichiers dans C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data, tels que default.ica et usernamepassword.tfrm, sauvegardez-les pour chaque magasin. Après la mise à niveau, vous pourrez les restaurer pour rétablir vos modifications.

Fermez les applications et les consoles

Avant de commencer une mise à niveau, fermez tous les programmes susceptibles de provoquer des verrous de fichiers, y compris les consoles d’administration et les sessions PowerShell.

Le redémarrage de la machine garantit que tous les verrous de fichiers sont libérés et qu’aucune mise à jour Windows n’est en attente.

Avant de commencer une mise à niveau, arrêtez et désactivez tous les services d’agent de surveillance tiers.

Assurez-vous de disposer des autorisations appropriées

En plus d’être un utilisateur de domaine, vous devez être un administrateur local sur les machines où vous mettez à niveau les composants du produit.

La base de données du site et le site peuvent être mis à niveau automatiquement ou manuellement. Pour une mise à niveau automatique de la base de données, les autorisations de l’utilisateur Studio doivent inclure la capacité à mettre à jour le schéma de la base de données SQL Server (par exemple, le rôle de base de données db_securityadmin ou db_owner). Pour plus de détails, consultez Bases de données.

Si l’utilisateur Studio ne dispose pas de ces autorisations, l’initialisation d’une mise à niveau manuelle de la base de données génère des scripts. L’utilisateur Studio exécute certains des scripts depuis Studio. L’administrateur de la base de données exécute d’autres scripts, à l’aide d’un outil tel que SQL Server Management Studio.

Autres tâches de préparation

  • Sauvegardez les modèles et mettez à niveau les hyperviseurs, si nécessaire
  • Effectuez toutes les autres tâches de préparation dictées par votre plan de continuité des activités.

Tests préliminaires du site

Lorsque vous mettez à niveau les Delivery Controllers et un site, des tests préliminaires du site sont exécutés avant le début de la mise à niveau proprement dite. Ces tests vérifient :

  • La base de données du site est accessible et a été sauvegardée
  • Les connexions aux services Citrix essentiels fonctionnent correctement
  • L’adresse du serveur de licences Citrix est disponible
  • La base de données de journalisation de la configuration est accessible
  • Assurez-vous de disposer d’une licence Hybrid Rights si vous souhaitez ajouter des connexions d’hôte de cloud public (par exemple, AWS). Dans le cas contraire, le test préliminaire du site se met en pause ou s’arrête, et un message explicatif apparaît.

Après l’exécution des tests, vous pouvez afficher un rapport des résultats. Vous pouvez ensuite corriger les problèmes détectés et exécuter à nouveau les tests. Le fait de ne pas exécuter les tests préliminaires du site et de ne pas résoudre les problèmes peut avoir un impact sur le fonctionnement de votre site.

Le rapport contenant les résultats des tests est un fichier HTML (PreliminarySiteTestResult.html) situé dans le même répertoire que les journaux d’installation. Ce fichier est créé s’il n’existe pas. S’il existe, son contenu est écrasé.

Exécuter les tests

  • Lorsque vous utilisez l’interface graphique de l’installateur pour la mise à niveau, l’assistant inclut une page où vous pouvez démarrer les tests, puis afficher le rapport. Une fois les tests exécutés, le rapport consulté et les problèmes détectés résolus, vous pouvez relancer les tests. Lorsque les tests sont terminés avec succès, cliquez sur Suivant pour continuer avec l’assistant.
  • Lorsque vous utilisez l’interface de ligne de commande pour la mise à niveau, les tests s’exécutent automatiquement. Par défaut, si un test échoue, la mise à niveau n’est pas effectuée. Après avoir consulté le rapport et résolu les problèmes, relancez la commande.

Citrix recommande d’exécuter systématiquement les tests préliminaires du site, puis de résoudre les problèmes avant de poursuivre la mise à niveau du Controller et du site. Le bénéfice potentiel justifie amplement les quelques instants nécessaires à l’exécution des tests. Cependant, vous pouvez ignorer cette action recommandée.

  • Lors de la mise à niveau avec l’interface graphique, vous pouvez choisir d’ignorer les tests et de poursuivre la mise à niveau.
  • Lors de la mise à niveau à partir de la ligne de commande, vous ne pouvez pas ignorer les tests. Par défaut, un test de site échoué entraîne l’échec de l’installateur, sans effectuer la mise à niveau. Généralement, si vous incluez l’option /ignore_site_test_failure, les échecs de test sont ignorés et la mise à niveau se poursuit. (Voir Vérification de la version de SQL Server pour les exceptions.)

Lors de la mise à niveau de plusieurs Controllers

Lorsque vous démarrez une mise à niveau sur un Controller, puis démarrez une mise à niveau d’un autre Controller sur le même site (avant que la première mise à niveau ne soit terminée) :

  • Si les tests préliminaires du site sont terminés sur le premier Controller, la page des tests préliminaires du site n’apparaît pas dans l’assistant sur l’autre Controller.
  • Si les tests sur le premier Controller sont en cours lorsque vous démarrez la mise à niveau sur l’autre Controller, la page des tests du site apparaît dans l’assistant sur l’autre Controller. Cependant, si les tests sur le premier Controller se terminent, seuls les résultats des tests du premier Controller sont conservés.

Échecs de test non liés à la santé du site

  • Si les tests préliminaires du site échouent en raison d’une mémoire insuffisante, libérez de la mémoire, puis relancez les tests.
  • Si vous avez l’autorisation de mettre à niveau, mais pas d’exécuter les tests du site, les tests préliminaires du site échouent. Pour résoudre ce problème, relancez l’installateur avec un compte utilisateur disposant de l’autorisation d’exécuter les tests.

Vérification de la version de SQL Server

Un déploiement réussi de Citrix Virtual Apps and Desktops nécessite une version prise en charge de Microsoft SQL Server pour les bases de données du site, du moniteur et de la journalisation de la configuration. La mise à niveau d’un déploiement Citrix avec une version de SQL Server qui n’est plus prise en charge peut entraîner des problèmes de fonctionnalité, et le site ne sera pas pris en charge.

Pour savoir quelles versions de SQL Server sont prises en charge pour la version de Citrix vers laquelle vous effectuez la mise à niveau, consultez l’article Configuration système requise pour cette version.

Lors de la mise à niveau d’un Controller, le programme d’installation de Citrix vérifie la version de SQL Server actuellement installée utilisée pour les bases de données du site, du moniteur et de la journalisation de la configuration.

  • Si la vérification détermine que la version de SQL Server actuellement installée n’est pas une version prise en charge dans la version de Citrix vers laquelle vous effectuez la mise à niveau :

    • Interface graphique : La mise à niveau s’arrête avec un message. Cliquez sur J’ai compris, puis sur Annuler pour fermer le programme d’installation de Citrix. (Vous ne pouvez pas poursuivre la mise à niveau.)
    • Interface de ligne de commande : la commande échoue (même si vous avez inclus l’option /ignore_db_check_failure avec la commande).

    Mettez à niveau la version de SQL Server, puis redémarrez la mise à niveau de Citrix.

  • Si la vérification ne peut pas déterminer quelle version de SQL Server est actuellement installée, vérifiez si votre version actuellement installée est prise en charge dans la version vers laquelle vous effectuez la mise à niveau (Configuration système requise).

    • Interface graphique : La mise à niveau s’arrête avec un message.

      • Si la version de SQL Server actuellement installée est prise en charge, cliquez sur J’ai compris pour fermer le message, puis cliquez sur Suivant pour poursuivre la mise à niveau de Citrix.
      • Si la version de SQL Server actuellement installée n’est pas prise en charge, cliquez sur J’ai compris pour fermer le message, puis cliquez sur Annuler pour mettre fin à la mise à niveau de Citrix. Mettez à niveau votre SQL Server vers une version prise en charge, puis redémarrez la mise à niveau de Citrix.

    • Interface de ligne de commande : La commande échoue avec un message. Après avoir fermé le message :

      • Si la version de SQL Server actuellement installée est prise en charge, exécutez à nouveau la commande avec l’option /ignore_db_check_failure.
      • Si la version de SQL Server actuellement installée n’est pas prise en charge, mettez à niveau votre SQL Server vers une version prise en charge. Exécutez à nouveau la commande pour démarrer la mise à niveau de Citrix.

Mise à niveau de SQL Server

Si vous installez de nouveaux serveurs SQL Server et migrez la base de données du site, les chaînes de connexion doivent être mises à jour.

Si le site utilise actuellement SQL Server Express pour la base de données du site (que Citrix a automatiquement installé lors de la création du site) :

  1. Installez la dernière version de SQL Server Express.
  2. Détachez la base de données.
  3. Attachez la base de données au nouveau SQL Server Express.
  4. Migrez les chaînes de connexion.

Pour plus d’informations, consultez Configuration des chaînes de connexion et la documentation produit de Microsoft SQL Server.

Remplacer SQL Server Express LocalDB

Microsoft SQL Server Express LocalDB est une fonctionnalité de SQL Server Express que le cache d’hôte local utilise de manière autonome. Le cache d’hôte local ne nécessite aucun composant de SQL Server Express autre que SQL Server Express LocalDB.

Citrix ne met pas automatiquement à jour SQL Server Express LocalDB. Pour mettre à jour la version de SQL Server Express LocalDB, suivez les instructions de cette section.

  • Lors de la mise à niveau des Delivery Controller vers Citrix Virtual Apps and Desktops version 2203 LTSR ou versions ultérieures, la version prise en charge est SQL Server Express LocalDB 2019 ou SQL Server Express LocalDB 2022.

Ce dont vous avez besoin :

  • Le support d’installation de Citrix Virtual Apps and Desktops.
  • L’outil PsExec de la boîte à outils Windows Sysinternals.

Procédure :

  1. Terminez la mise à niveau de vos composants, bases de données et site Citrix Virtual Apps and Desktops. (Ces mises à niveau de base de données affectent les bases de données du site, de la surveillance et de la journalisation de la configuration. Elles n’affectent pas la base de données du cache d’hôte local qui utilise SQL Server Express LocalDB.)
  2. Connectez-vous au Delivery Controller où vous souhaitez mettre à jour SQL Server Express LocalDB.
  3. Téléchargez PsExec depuis Microsoft et placez-le dans un emplacement facilement accessible sur ce Delivery Controller, tel que C:\Temp.
  4. Arrêtez le service Citrix High Availability sur le Delivery Controller à partir des services système Windows.

  5. Ouvrez l’invite de commandes sur le Delivery Controller, accédez à l’emplacement de PsExec (par exemple, C:\Temp), puis exécutez la commande suivante pour élever l’invite de commandes avec le compte Service réseau :

    psexec -i -u "NT AUTHORITY\NETWORKSERVICE" cmd
<!--NeedCopy-->
  6. Exécutez whoami pour confirmer que l’invite de commandes s’exécute en tant que compte Service réseau. Vous devez obtenir la sortie suivante : nt authority\networkservice.

  7. Utilisez l’invite de commandes pour accéder à l’instance SQL LocalDB :

    • Si vous effectuez une mise à niveau depuis SQL LocalDB 2014 :

       cd "C:\Program Files\Microsoft SQL Server\120\Tools\Binn"
 <!--NeedCopy-->

    • Si vous effectuez une mise à niveau depuis SQL LocalDB 2017 :

       cd "C:\Program Files\Microsoft SQL Server\140\Tools\Binn"
 <!--NeedCopy-->

    • Si vous effectuez une mise à niveau depuis SQL LocalDB 2019 :

       cd "C:\Program Files\Microsoft SQL Server\150\Tools\Binn"
 <!--NeedCopy-->

  8. Arrêtez et supprimez l’instance SQL LocalDB : CitrixHA.

    SqlLocalDB stop CitrixHA

SqlLocalDB delete CitrixHA
<!--NeedCopy-->

  9. Supprimez les fichiers suivants du Delivery Controller :

    C:\Windows\ServiceProfiles\NetworkService\HADatabaseName.*
C:\Windows\ServiceProfiles\NetworkService\HADatabaseName_log.*
C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName.* (if exists)
C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName_log.* (if exists)
<!--NeedCopy-->
  10. Désinstallez votre SQL LocalDB SQL Server Express existant du Delivery Controller à l’aide de la fonctionnalité Windows native de suppression de programmes.
  11. Redémarrez le Delivery Controller une fois la désinstallation terminée.
  12. Arrêtez le service de haute disponibilité Citrix sur le Delivery Controller à partir des services système Windows.
  13. Montez le support d’installation de Citrix Virtual Apps and Desktops sur votre Delivery Controller.

  14. Installez SQL Server Express LocalDB 2022 en tant qu’administrateur sur le Delivery Controller.

    1. Utilisez le fichier sqllocaldb.msi dans le dossier Support > SQLLocalDB du support d’installation de Citrix Virtual Apps and Desktops. Par exemple, si le support d’installation est monté sur la lettre E drive, le fichier se trouve à l’emplacement E:\Support\SQLLocalDB\sqllocaldb.msi. Un redémarrage est nécessaire pour terminer l’installation.
    2. La nouvelle base de données SQL LocalDB doit être dans C:\Program Files\Microsoft SQL Server\160\Tools\Binn.
  15. Démarrez le service de haute disponibilité Citrix sur le Delivery Controller à partir des services système Windows.

  16. Dans l’invite de commandes du Delivery Controller, accédez à C:\Program Files\Microsoft SQL Server\160\Tools\Binn et exécutez SqlLocalDB i pour confirmer que l’instance CitrixHA a été créée. Le CitrixHA doit être inclus dans la liste des instances renvoyées.

    Remarque :

    La création de la base de données CitrixHA peut prendre jusqu’à 15 minutes après le démarrage du service de haute disponibilité Citrix.

  17. Assurez-vous que les fichiers de base de données du cache d’hôte local sont créés pour confirmer que le service de haute disponibilité (broker secondaire) peut prendre le relais si nécessaire.

    1. Sur le Delivery Controller, accédez à C:\Windows\ServiceProfiles\NetworkService.
    2. Vérifiez que HaDatabaseName.mdf et HaDatabaseName_log.ldf sont créés.
  18. Répétez les étapes sur les autres Delivery Controllers.
Mettre à niveau un déploiement
May 31, 2026
Contributeur: 
C
May 31, 2026
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | 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.