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 et 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 StoreFront 2511 à partir de :
- StoreFront 1912 LTSR CU10
- StoreFront 2203 LTSR (toute CU)
- StoreFront 2402 LTSR (toute CU)
- StoreFront 2407
- StoreFront 2411
- StoreFront 2503
- StoreFront 2503.1
- StoreFront 2507 LTSR (toute CU)
Il n’est pas possible de mettre à niveau de 2402 CU2 ou des CU ultérieures vers 2407 ou 2411.
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 que vous n’accordiez l’accès au déploiement.
- 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 de 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 Résoudre les problèmes de mise à niveau.
- 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 les échecs de 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 que vous puissiez facilement restaurer 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 de n’avoir aucune fenêtre de l’Explorateur Windows ou d’invite de commandes ouverte 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 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 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 interruption planifiée
La mise à niveau simultanée des serveurs d’un groupe de serveurs StoreFront en production n’est pas prise en charge. Cependant, vous pouvez effectuer 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 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 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 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 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 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 en utilisant le 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 est censée ê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 en utilisant le 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 de nouveau un favori à une ressource 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.
Résoudre les 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).
- Si aucune erreur d’exception n’est présente dans CitrixMsi*.log, vérifiez les 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.
- Si aucune erreur d’exception n’est présente 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.