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 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 StoreFront 2603 à partir de :
- StoreFront 1912 LTSR CU10
- StoreFront 2203 LTSR (tout CU)
- StoreFront 2402 LTSR (tout CU)
- StoreFront 2411
- StoreFront 2503
- StoreFront 2503.1
- StoreFront 2507 LTSR (tout CU)
- StoreFront 2511
Il n’est pas possible d’effectuer une mise à niveau de 2402 CU2 ou des CU ultérieurs 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 d’accorder 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, celle-ci effectue des vérifications préalables à la mise à niveau. 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, consultez Exporter et importer la configuration StoreFront,
- l’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 d’échec 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 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.
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 pourrez les restaurer pour rétablir vos modifications. - Empêchez les utilisateurs de se connecter en retirant le serveur de tout équilibreur de charge ou en bloquant les connexions par d’autres moyens.
- 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, ceux-ci 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 les 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 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 dans 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 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 retirant 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 retirer 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 à celle de 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 rejoignant le groupe.
- Mettez à niveau le serveur C en suivant les instructions de Mettre à niveau un seul serveur StoreFront. Le serveur C a maintenant une configuration identique à celle de 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 rejoignant 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.
- Retirez 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 courte 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 des abonnements dans 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 des 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épanner les problèmes de mise à niveau
-
Dans C:\Windows\Temp\StoreFront, ouvrez le plus récent 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 Impossible d’obtenir un 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 Le service ne peut pas être démarré : 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 > 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.