Mettre à niveau 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 ainsi que les services, sites, favoris (sur les serveurs autonomes) et la configuration associés.
Chemins de mise à niveau pris en charge
Vous pouvez effectuer une mise à niveau vers la dernière CU de StoreFront 2203 à partir de :
- StoreFront 2203 LTSR (version initiale ou toute CU)
- StoreFront 1912 LTSR (toute CU)
- StoreFront 3.12 LTSR CU9
Pour effectuer une mise à niveau à partir de versions antérieures à la version 3.12 CU9, vous devez d’abord effectuer une mise à niveau vers StoreFront 3.12 CU9.
Avertissement :
Lorsque vous effectuez une mise à niveau à partir de versions antérieures à la version 1912, tous les sites Desktop Appliance de votre déploiement sont automatiquement supprimés. À la place, 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 multi-serveurs 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.
- StoreFront ne prend pas en charge les déploiements multi-serveurs contenant différents systèmes d’exploitation de serveur. Par conséquent, tous les serveurs d’un groupe de serveurs doivent utiliser le même système d’exploitation Windows Server.
- La mise à niveau simultanée n’est pas prise en charge pour les déploiements multi-serveurs ; les serveurs doivent être mis à niveau séquentiellement.
- Avant l’exécution de la mise à niveau de StoreFront, des vérifications préalables à la mise à niveau sont effectuées. 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 :
- la restauration de l’instantané de machine virtuelle que vous avez créé avant la mise à niveau,
- l’importation de la configuration StoreFront que vous avez exportée avant la mise à niveau (voir Exporter et importer la configuration StoreFront),
- l’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-programme d’installation de Citrix Virtual Apps and Desktops sont signalées dans une boîte de dialogue, avec un lien vers le journal des défaillances pertinent.
Préparer 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 une mise à niveau à partir d’une version prise en charge.
- Téléchargez le programme d’installation de StoreFront depuis le site Web de Citrix.
Mettre à niveau un seul serveur StoreFront
- 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èmes. 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 de ligne de commande 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’aucun explorateur Windows ou invite de commande n’est ouvert sur les répertoires contenant des fichiers StoreFront.
- Désactivez toutes les applications antivirus.
- Exécutez le fichier d’installation de la version requise de StoreFront.
Mettre à niveau un groupe de serveurs StoreFront pendant une période d’indisponibilité planifiée pour la maintenance
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 Mettre à niveau un seul serveur StoreFront.
- 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.
Mettre à niveau un groupe de serveurs StoreFront sans période d’indisponibilité 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 doivent se réauthentifier auprès de StoreFront lorsqu’ils sont 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 d’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 orphelin du groupe de serveurs et est réinitialisé aux paramètres d’usine.
- Réinitialisez le serveur C orphelin aux paramètres d’usine à l’aide de Clear-STFDeployment.
- Importez la configuration StoreFront que vous avez précédemment exportée vers 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 plus tard. 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 Mettre à niveau un seul serveur StoreFront. 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 précédemment exportées vers le serveur C. Il n’est pas nécessaire de répéter cette étape plus tard. 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 Joindre 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 pour le 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 une ressource à leurs 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.
Dépanner les problèmes de mise à niveau
- Dans C:\Windows\Temp\StoreFront, ouvrez le dernier fichier CitrixMsi*.log et recherchez les erreurs d’exception. Exceptions d’accès à Thumbs.db : 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 d’accès exclusif au fichier \en cours d’utilisation : restaurez l’instantané/la sauvegarde si disponible, ou redémarrez le serveur, et arrêtez manuellement tous les services StoreFront. Exceptions de démarrage de service impossible : 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 le Observateur d’événements > Services de livraison 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.