Mise à niveau de StoreFront™
La mise à niveau préserve votre configuration StoreFront et laisse les favoris des utilisateurs intacts. En revanche, la désinstallation de StoreFront supprime StoreFront et les services associés, les sites, les favoris (sur les serveurs autonomes) et la configuration associée.
Chemins de mise à niveau pris en charge
Vous pouvez effectuer la mise à niveau vers StoreFront 2402 à partir de :
- StoreFront 2311
- StoreFront 2308
- StoreFront 2203 LTSR (tout CU)
- StoreFront 1912 LTSR (tout CU)
- StoreFront 3.12 LTSR CU9
Pour effectuer la mise à niveau à partir de versions antérieures à 3.12 CU9, vous devez d’abord effectuer la mise à niveau vers StoreFront 3.12 CU9.
Avertissement :
Lorsque vous effectuez une mise à niveau à partir de versions antérieures à 1912, tous les sites Desktop Appliance de votre déploiement sont automatiquement supprimés. En guise d’alternative, Citrix recommande d’utiliser Citrix Workspace app Desktop Lock pour tous les cas d’utilisation non joints à un domaine.
Bon à savoir
- StoreFront ne prend pas en charge les déploiements multiserveurs contenant différentes versions de produit. Par conséquent, tous les serveurs d’un groupe de serveurs doivent être mis à niveau vers la même version avant d’accorder l’accès au déploiement.
- La mise à niveau concurrente n’est pas prise en charge pour les déploiements multiserveurs ; les serveurs doivent être mis à niveau séquentiellement.
- Avant de s’exécuter, la mise à niveau de StoreFront effectue des vérifications préalables. Si l’une de ces vérifications échoue, la mise à niveau ne démarre pas et vous êtes informé des échecs. Votre installation StoreFront reste inchangée. Après avoir corrigé la cause des échecs, relancez la mise à niveau.
- Si la mise à niveau de StoreFront échoue, votre installation StoreFront existante peut perdre sa configuration initiale. Restaurez votre installation StoreFront à un état fonctionnel, puis relancez la mise à niveau. Pour restaurer StoreFront à un état fonctionnel, envisagez les approches suivantes :
- restauration de l’instantané de machine virtuelle que vous avez créé avant la mise à niveau,
- importation de la configuration StoreFront que vous avez exportée avant la mise à niveau, consultez Exporter et importer la configuration StoreFront,
- application des conseils de dépannage dans Dépanner les problèmes de mise à niveau de StoreFront.
- Toutes les défaillances de mise à niveau de StoreFront qui se produisent à partir du méta-installateur Citrix Virtual Apps and Desktops sont signalées dans une boîte de dialogue, avec un lien vers le journal des défaillances pertinent.
-
Lancement hybride via les versions de StoreFront entre 1912 et 2203
Les versions de StoreFront entre 1912 et 2203 prennent en charge l’activation du lancement hybride d’applications et de bureaux virtuels activés avec des stratégies de protection des applications à l’aide d’une personnalisation comme suit :
Citrix® recommande de supprimer cette personnalisation lors de la mise à niveau vers StoreFront 2308 ou une version ultérieure.
Pour plus d’informations, consultez Lancement hybride via les versions de StoreFront entre 1912 et 2203
Préparation à la mise à niveau
Avant de commencer la mise à niveau, nous vous recommandons d’effectuer les étapes suivantes qui peuvent éviter un échec de la mise à niveau :
- Planifiez votre stratégie de sauvegarde avant la mise à niveau.
- Vérifiez que vous effectuez la mise à niveau à partir d’une version prise en charge.
- Téléchargez le programme d’installation de StoreFront depuis le site Web de Citrix.
Mise à niveau d’un serveur StoreFront unique
- Sauvegardez le serveur en créant un instantané de machine virtuelle.
- Exportez la configuration StoreFront existante. Si vous avez plusieurs serveurs dans un groupe de serveurs, exportez uniquement la configuration du groupe de serveurs à partir d’un seul serveur. À condition que vous ayez propagé toutes les modifications entre eux, tous les serveurs d’un groupe de serveurs conservent des copies identiques de la configuration. Cette sauvegarde vous permet de créer facilement un nouveau groupe de serveurs afin de pouvoir restaurer facilement la configuration en cas de problème. Notez que vous ne pourrez restaurer cette sauvegarde que sur un serveur exécutant la même version que celle à partir de laquelle elle a été exportée.
- Si vous avez apporté des modifications aux fichiers dans
C:\inetpub\wwwroot\Citrix\<StoreName>\App_DataouC:\inetpub\wwwroot\Citrix\<StoreName>Auth\App_Data, tels que default.ica et usernamepassword.tfrm, sauvegardez-les pour chaque magasin. Après la mise à niveau, vous pouvez les restaurer pour rétablir vos modifications. - Empêchez les utilisateurs de se connecter en supprimant le serveur de tout équilibreur de charge ou en bloquant les connexions d’une autre manière.
- Redémarrez le serveur.
- Assurez-vous qu’aucune application n’est en cours d’exécution, y compris la console de gestion StoreFront, les fenêtres d’invite de commandes et PowerShell ou toute autre application susceptible de verrouiller les fichiers StoreFront. Cela garantit que tous les fichiers StoreFront sont accessibles par le programme d’installation pendant la mise à niveau. Si le programme d’installation ne peut pas accéder à certains fichiers, ils ne sont pas remplacés et la mise à niveau échoue, entraînant la suppression de la configuration StoreFront existante.
- Assurez-vous qu’aucune fenêtre de l’Explorateur Windows ou d’invite de commandes n’est ouverte sur les répertoires contenant les fichiers StoreFront.
- Désactivez toutes les applications antivirus.
- Exécutez le fichier d’installation de la version requise de StoreFront.
Mise à niveau d’un groupe de serveurs StoreFront pendant une période de maintenance planifiée
Pour mettre à niveau un groupe de serveurs StoreFront composé de plusieurs serveurs, pendant une période d’indisponibilité planifiée, suivez les étapes suivantes :
- Désactivez l’accès des utilisateurs au groupe de serveurs en désactivant l’URL d’équilibrage de charge. Cela empêche les utilisateurs de se connecter au déploiement pendant le processus de mise à niveau.
- Mettez à niveau chaque serveur en suivant les instructions de la section Mise à niveau d’un serveur StoreFront unique.
- Vérifiez que tous les serveurs fonctionnent correctement.
- Activez l’accès des utilisateurs au groupe de serveurs mis à niveau en activant l’URL d’équilibrage de charge.
Mise à niveau d’un groupe de serveurs StoreFront sans interruption de service planifiée
La mise à niveau simultanée des serveurs d’un groupe de serveurs StoreFront en direct n’est pas prise en charge. Cependant, vous pouvez réaliser une mise à niveau en direct en créant un nouveau groupe de serveurs avec une configuration identique, en le mettant à niveau, puis en migrant les connexions utilisateur vers le nouveau groupe de serveurs. Les utilisateurs devront se réauthentifier auprès de StoreFront lorsqu’ils seront transférés entre les groupes de serveurs.
Par exemple, pour mettre à niveau un groupe de serveurs StoreFront composé de trois serveurs A, B et C :
- Exportez la configuration StoreFront à l’aide de Export-STFConfiguration. Cette sauvegarde est nécessaire car les serveurs sont réinitialisés aux paramètres d’usine plus tard dans le processus, ce qui supprime les données de configuration.
- Exportez les données d’abonnement du serveur A à l’aide de Export-STFStoreSubscriptions. Cette sauvegarde est nécessaire car les serveurs sont réinitialisés aux paramètres d’usine plus tard dans le processus, ce qui supprime les données d’abonnement. Consultez Gérer les données d’abonnement pour un magasin.
- Désactivez l’accès des utilisateurs au serveur C en le supprimant de l’équilibreur de charge. Cela empêche les utilisateurs de se connecter au serveur C pendant le processus de mise à niveau. L’équilibreur de charge continue d’envoyer des requêtes aux serveurs A et B.
- Utilisez le serveur A pour supprimer le serveur C du groupe. Les serveurs A et B continuent de fournir l’accès aux ressources de vos utilisateurs. Le serveur C est maintenant isolé du groupe de serveurs et est réinitialisé aux paramètres d’usine.
- Réinitialisez le serveur C isolé aux paramètres d’usine à l’aide de Clear-STFDeployment.
- Importez la configuration StoreFront que vous avez précédemment exportée dans le serveur C à l’aide de Import-STFConfiguration. Le serveur C a maintenant une configuration identique à l’ancien groupe de serveurs. Il n’est pas nécessaire de répéter cette étape ultérieurement. Un seul serveur a besoin d’une copie des données de configuration pour les propager à tout autre serveur qui rejoint le groupe.
- Mettez à niveau le serveur C en suivant les instructions de la section Mise à niveau d’un serveur StoreFront unique. Le serveur C a maintenant une configuration identique à l’ancien groupe de serveurs et est mis à niveau vers une nouvelle version de StoreFront.
- Importez les données d’abonnement que vous avez exportées précédemment dans le serveur C. Il n’est pas nécessaire de répéter cette étape ultérieurement. Un seul serveur a besoin d’une copie des données d’abonnement pour les propager à tout autre serveur qui rejoint le groupe.
- Répétez les étapes 3, 4, 5 et 7 à l’aide du serveur B (ne répétez pas l’étape 6). Pendant ce temps, seul le serveur A fournit aux utilisateurs l’accès aux ressources. Il est donc recommandé d’effectuer cette étape pendant les périodes de faible activité, lorsque la charge sur le groupe de serveurs StoreFront devrait être minimale.
- Joignez le serveur B au serveur C à l’aide du processus Rejoindre un groupe de serveurs existant. Cela donne un déploiement de serveur unique sur la version actuelle de StoreFront (serveur A) et un nouveau groupe de serveurs à deux nœuds sur la nouvelle version de StoreFront (serveurs B et C).
- Ajoutez les serveurs B et C au service d’équilibrage de charge afin qu’ils puissent prendre le relais du serveur A.
- Supprimez le serveur A de l’équilibreur de charge afin que les utilisateurs soient dirigés vers les serveurs B et C nouvellement mis à niveau.
- Répétez les étapes 5, 7, 10 et 11 à l’aide du serveur A (ne répétez pas l’étape 6). Le processus de mise à niveau du groupe de serveurs est maintenant terminé. Les serveurs A, B et C ont une configuration et des données d’abonnement identiques à celles du groupe d’origine.
Remarque :
Pendant la brève période où le serveur A est le seul serveur accessible, les favoris peuvent être perdus (étape 9). Cela peut entraîner une copie légèrement obsolète de la base de données d’abonnements du nouveau groupe de serveurs après la mise à niveau, et la perte de tout nouveau favori.
Cela n’a aucun impact fonctionnel car les données de favoris ne sont pas essentielles pour que les utilisateurs puissent se connecter et lancer des ressources. Les utilisateurs devraient cependant ajouter à nouveau une ressource aux favoris après que le serveur A ait été réinitialisé aux paramètres d’usine et rejoint le groupe nouvellement mis à niveau. Bien qu’il soit peu probable que plus de quelques enregistrements de favoris soient perdus, c’est une conséquence possible de la mise à niveau d’un environnement de production StoreFront en direct sans interruption de service.
Dépannage des problèmes de mise à niveau
-
Dans C:\Windows\Temp\StoreFront, ouvrez le dernier fichier CitrixMsi*.log et recherchez les erreurs d’exception.
Exceptions Thumbs.db Access : causées par des fichiers thumbs.db dans C:\inetpub\wwwroot\citrix ou dans ses sous-répertoires. Supprimez tous les fichiers thumbs.db trouvés.
Exceptions Cannot get exclusive file access \in use : restaurez l’instantané/la sauvegarde si disponible, ou redémarrez le serveur, et arrêtez manuellement tous les services StoreFront.
Exceptions Service cannot be started : restaurez l’instantané/la sauvegarde si disponible, ou installez la version complète de .NET framework 4.5 (pas le profil client).
- S’il n’y a pas d’erreurs d’exception dans CitrixMsi*.log, vérifiez l’Observateur d’événements > Delivery Services du serveur pour toute erreur contenant les messages d’erreur d’exception précédents. Suivez les conseils correspondants.
- S’il n’y a pas d’erreurs d’exception dans l’Observateur d’événements, vérifiez les journaux d’administration dans C:\Program Files\Citrix\Receiver StoreFront\logs pour toute erreur contenant les messages d’erreur d’exception précédents. Suivez les conseils correspondants.
Pour plus de détails sur les fichiers journaux, consultez Journaux d’installation.