Documentation produit
StoreFront
Current Release 2203 LTSR 1912 LTSR 1909 1906 1903 3.12
Voir PDF

Installer, configurer, mettre à niveau et désinstaller

June 23, 2022
Contributeur: 
C

Avant l’installation et la configuration

Pour installer et configurer StoreFront, effectuez les étapes suivantes dans l’ordre :

  1. Si vous prévoyez d’utiliser StoreFront pour fournir des ressources Citrix Virtual Apps and Desktops aux utilisateurs, assurez-vous que le serveur StoreFront est membre du domaine Microsoft Active Directory contenant les comptes de vos utilisateurs ou d’un domaine qui a une relation d’approbation avec le domaine des comptes utilisateur.

    Important :

    • Pour les déploiements sur un seul serveur, vous pouvez installer StoreFront sur un serveur n’appartenant pas à un domaine.
    • StoreFront ne peut pas être installé sur un contrôleur de domaine.

  2. S’il n’est pas déjà installé, StoreFront requiert Microsoft.NET Framework, qui peut être téléchargé depuis Microsoft. Microsoft.NET doit être installé avant de pouvoir installer StoreFront.

  3. Éventuellement, si vous prévoyez de configurer un déploiement StoreFront comprenant de multiples serveurs, configurez un environnement à équilibrage de charge pour vos serveurs StoreFront.

    Pour utiliser Citrix ADC pour l’équilibrage de charge, définissez un serveur virtuel pour remplacer vos serveurs StoreFront. Pour plus d’informations sur la configuration de Citrix ADC pour l’équilibrage de charge, consultez Équilibrage de charge avec Citrix ADC.

    1. Assurez-vous que l’équilibrage de charge est activé sur votre appliance Citrix ADC.

    2. Pour chaque serveur StoreFront, créez des services d’équilibrage de charge HTTP ou SSL individuels, selon les besoins, à l’aide du type de contrôle StoreFront.

    3. Configurez les services de manière à insérer l’adresse IP du client dans l’en-tête HTTP X-Forwarded-For aux demandes transmises à StoreFront, ce qui remplace toute stratégie globale.

      StoreFront requiert les adresses IP des utilisateurs pour établir des connexions à leurs ressources.

    4. Créez un serveur virtuel et liez les services au serveur virtuel.

    5. Sur le serveur virtuel, configurez la persistance à l’aide de l’adresse IP du client ou de la méthode Cookie Insert. Assurez-vous que la durée de vie (TTL) est suffisante pour permettre aux utilisateurs de rester connectés au serveur aussi longtemps que nécessaire.

      La persistance garantit que seule la charge de la connexion utilisateur initiale est équilibrée, après quoi les demandes ultérieures de cet utilisateur sont redirigées vers le même serveur StoreFront.

  4. Activez les fonctionnalités suivantes (facultatif).

    • Fonctionnalités de .NET Framework > .NET Framework, ASP.NET

    Si vous le souhaitez, vous pouvez activer les rôles suivants et leurs dépendances sur le serveur StoreFront.

    • Serveur Web (IIS) > Serveur Web > Fonctionnalités HTTP communes > Document par défaut > Erreurs HTTP > Contenu statique > Redirection HTTP

    • Serveur Web (IIS) > Serveur Web > État de santé et diagnostics > Journalisation HTTP

    • Serveur Web (IIS) > Serveur Web > Sécurité > Filtrage des demandes > Authentification Windows

      Le programme d’installation de StoreFront vérifie que toutes les fonctionnalités et tous les rôles de serveur ci-dessus sont activés.

  5. Installez StoreFront.

    Si vous souhaitez que le serveur fasse partie d’un groupe de serveurs StoreFront, l’emplacement d’installation de StoreFront et les paramètres des sites Web IIS, tels que le chemin d’accès physique et les ID de site, doivent être identiques.

  6. Vous pouvez éventuellement configurer Microsoft Internet Information Services (IIS) pour HTTPS si vous prévoyez d’utiliser le protocole HTTPS pour sécuriser les communications entre StoreFront et les machines des utilisateurs.

    HTTPS est requis pour l’authentification par carte à puce. Par défaut, l’application Citrix Workspace nécessite des connexions HTTPS aux magasins. Pour configurer IIS afin de pouvoir utiliser une adresse URL de base HTTPS dans StoreFront, créez une liaison HTTPS au site Web par défaut et associez-la au certificat de serveur StoreFront. Pour plus d’informations sur l’ajout d’une liaison HTTPS à un site IIS, consultez Sécuriser votre déploiement StoreFront.

  7. Assurez-vous que votre pare-feu et autres périphériques réseau autorisent l’accès au port TCP 80 ou 443, aussi bien à l’intérieur qu’à l’extérieur du réseau d’entreprise. En outre, vérifiez que tous les pare-feu ou autres périphériques sur votre réseau interne ne bloquent pas le trafic des ports TCP non attribués.

    Lorsque vous installez StoreFront, une règle pare-feu Windows est configurée pour activer l’accès à l’exécutable de StoreFront via un port TCP aléatoirement sélectionné à partir de tous les ports non réservés. Ce port est utilisé pour les communications entre les serveurs StoreFront dans un groupe de serveurs.

  8. Si vous prévoyez d’utiliser de multiples sites Web Internet Information Services (IIS), après la création des sites Web dans IIS, utilisez le SDK PowerShell pour créer un déploiement StoreFront dans chacun de ces sites Web IIS. Pour de plus amples informations, consultez la section Sites Web Internet Information Services (IIS) multiples.

    Remarque :

    StoreFront désactive la console de gestion lorsqu’il détecte de multiples sites et affiche un message à cet effet.

  9. Utilisez la console de gestion Citrix StoreFront pour configurer votre serveur.

Installer StoreFront

Important

Pour éviter des erreurs et la perte de données lors de l’installation de StoreFront, assurez-vous que toutes les applications sont fermées et qu’aucune autre tâche ou opération n’est en cours d’exécution sur le système cible.

  1. Téléchargez le programme d’installation à partir de la page de téléchargement.

  2. Ouvrez une session sur le serveur StoreFront en utilisant un compte disposant d’autorisations d’administrateur local.

  3. Assurez-vous que le logiciel Microsoft .NET Framework requis est installé sur le serveur.

  4. Recherchez le fichier CitrixStoreFront-x64.exe, puis exécutez-le en tant qu’administrateur.

  5. Lisez et acceptez le contrat de licence, puis cliquez sur Suivant.

  6. Si la page Vérifier les composants requis s’affiche, cliquez sur Suivant.

  7. Sur la page Prêt pour l’installation, vérifiez que les prérequis et les composants StoreFront sont répertoriés pour l’installation et cliquez sur Installer.

    Avant l’installation des composants, les rôles suivants sont activés s’ils ne sont pas déjà configurés sur le serveur.

    • Serveur Web (IIS) > Serveur Web > Fonctionnalités HTTP communes > Document par défaut > Erreurs HTTP > Contenu statique > Redirection HTTP

    • Serveur Web (IIS) > Serveur Web > État de santé et diagnostics > Journalisation HTTP

    • Serveur Web (IIS) > Serveur Web > Sécurité > Filtrage des demandes > Authentification Windows

    • Serveur Web (IIS) > Outils de gestion > Console de gestion IIS, Scripts et outils de gestion IIS

    Les fonctionnalités suivantes sont également activées si elles ne sont pas déjà configurées.

    • Fonctionnalités de .NET Framework > .NET Framework, ASP.NET

  8. Une fois l’installation terminée, cliquez sur Terminer. La console de gestion Citrix StoreFront démarre automatiquement. Vous pouvez également accéder à StoreFront à partir de l’écran de démarrage.

    Boîte de dialogue de confirmation

  9. Dans la console de gestion Citrix StoreFront, cliquez sur Créer un nouveau déploiement.

    1. Spécifiez l’URL du serveur StoreFront dans la zone URL de base.
    2. Sur la page Nom du magasin, spécifiez un nom pour votre magasin, puis cliquez sur Suivant.

Sur la page Delivery Controller, entrez les détails des déploiements Citrix Virtual Apps and Desktops qui fournissent les ressources que vous souhaitez mettre à disposition dans le magasin.

  1. Définissez les champs Type de transport et Port, tels que HTTP et port 80, ou HTTPS et port 443, puis cliquez sur OK.

  2. Sur la page Accès distant, sélectionnez Aucun. Si vous utilisez Citrix Gateway, sélectionnez Aucun tunnel VPN et entrez les détails de votre passerelle.

  3. Sur la page Accès distant, sélectionnez Créer. Une fois que le magasin a été créé, cliquez sur Terminer.

Les utilisateurs peuvent désormais accéder au magasin via le site Citrix Receiver pour Web, ce qui leur permet d’accéder à leurs bureaux et applications via une page Web.

L’adresse URL permettant aux utilisateurs d’accéder au site Citrix Receiver pour Web du nouveau magasin s’affiche. Par exemple : example.net/Citrix/StoreWeb/. Ouvrez une session at accédez à la nouvelle interface utilisateur de l’application Citrix Workspace.

Site Citrix Receiver pour Web

Pour installer StoreFront à partir d’une invite de commandes

  1. Ouvrez une session sur le serveur StoreFront en utilisant un compte disposant d’autorisations d’administrateur local.

  2. Assurez-vous que toutes les exigences requises pour l’installation de StoreFront sont remplies avant d’installer StoreFront. Référez-vous à Avant l’installation et la configuration pour plus de détails.

  3. Accédez à votre support d’installation ou votre package de téléchargement, recherchez CitrixStoreFront-x64.exe et copiez le fichier dans un emplacement temporaire sur le serveur.

  4. Depuis une invite de commandes, accédez au dossier contenant le fichier d’installation, puis saisissez la commande suivante.

    CitrixStoreFront-x64.exe [-silent] [-INSTALLDIR installationlocation] [-WINDOWS_CLIENT filelocation\filename.exe] [-MAC_CLIENT filelocation\filename.dmg]
<!--NeedCopy-->

    Utilisez l’argument -silent pour effectuer une installation silencieuse de StoreFront et de tous les logiciels requis. Par défaut, StoreFront est installé sur C:\Program Files\Citrix\Receiver StoreFront. Toutefois, vous pouvez spécifier un autre emplacement d’installation à l’aide de l’argument -INSTALLDIR, où installationlocation est le répertoire dans lequel installer StoreFront. Si vous souhaitez que le serveur fasse partie d’un groupe de serveurs StoreFront, l’emplacement d’installation de StoreFront et les paramètres des sites Web IIS, tels que le chemin d’accès physique et les ID de site, doivent être identiques.

    Par défaut, si un site Citrix Receiver pour Web ne peut pas détecter l’application Citrix Workspace sur une machine Windows ou Mac OS X, l’utilisateur est invité à télécharger et installer la version appropriée de l’application Citrix Workspace pour sa plate-forme à partir du site Web de Citrix. Vous pouvez modifier ce comportement afin que les utilisateurs téléchargent les fichiers d’installation de l’application Citrix Workspace à partir du serveur StoreFront plutôt que du site Web. Pour plus d’informations, consultez la section Configurer la manière dont les ressources s’affichent auprès des utilisateurs.

    Si vous envisagez de modifier cette configuration, spécifiez les arguments -WINDOWS_CLIENT et -MAC_CLIENT afin de copier les fichiers d’installation de Citrix Receiver pour Windows ou de l’application Citrix Workspace pour Windows et de Citrix Receiver pour Mac ou de l’application Citrix Workspace pour Mac, respectivement, sur l’emplacement approprié de votre déploiement StoreFront. Remplacez filelocation par le répertoire contenant le fichier d’installation que vous voulez copier et filename par le nom du fichier d’installation. Les fichiers d’installation de Citrix Receiver pour Windows ou de l’application Citrix Workspace pour Windows et de Citrix Receiver pour Mac ou de l’application Citrix Workspace pour Mac sont inclus dans votre support d’installation Citrix Virtual Apps and Desktops.

CEIP

Si vous choisissez de participer au Programme d’amélioration de l’expérience utilisateur (CEIP), des informations d’utilisation et des statistiques anonymes sont envoyées à Citrix pour nous aider à améliorer la qualité et les performances des produits Citrix.

Par défaut, vous êtes automatiquement inscrit au programme CEIP lorsque vous installez StoreFront. Le premier chargement de données se produit approximativement sept jours après l’installation de StoreFront. Vous pouvez modifier cette valeur par défaut dans un paramètre de registre. Si vous modifiez le paramètre de registre avant d’installer StoreFront, cette valeur est utilisée. Si vous modifiez le paramètre de registre avant de mettre à niveau StoreFront, cette valeur est utilisée.

Avertissement :

Toute utilisation incorrecte de l’Éditeur du Registre peut générer des problèmes sérieux, pouvant vous obliger à réinstaller le système d’exploitation. Citrix ne peut garantir la possibilité de résoudre les problèmes provenant d’une mauvaise utilisation de l’Éditeur du Registre. Vous assumez l’ensemble des risques liés à l’utilisation de l’Éditeur du Registre. Veillez à faire une copie de sauvegarde de votre registre avant de le modifier.

Paramètre de registre qui contrôle le chargement automatique des outils d’analyse (valeur par défaut=1) :

Location: HKLM:\Software\Citrix\Telemetry\CEIP
Name: Enabled
Type: REG_DWORD
Value: 0 = disabled, 1 = enabled
<!--NeedCopy-->

Par défaut, la propriété Enabled est masquée dans le registre. Si elle n’est pas spécifiée, la fonctionnalité de chargement automatique est activée.

L’applet de commande PowerShell suivante désactive l’inscription au programme CEIP :

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0

Remarque :

Le paramètre de registre contrôle le chargement automatique des informations d’utilisation et des statistiques anonymes pour tous les composants sur le même serveur. Par exemple, si vous avez installé StoreFront sur le même serveur que le Delivery Controller et que vous décidez de ne pas prendre part au programme CEIP à l’aide du paramètre de Registre, ce choix s’applique aux deux composants.

Données CEIP collectées à partir de StoreFront

Le tableau suivant présente des exemples de types d’informations anonymes collectées. Les données ne contiennent aucun détail permettant d’identifier le client.

Données Description
Version de StoreFront Chaîne indiquant la version installée de StoreFront. Par exemple, « 3.8.0.0 »
Nombre de magasins Compteur pour le nombre de magasins dans le déploiement.
Nombre de serveurs dans le groupe de serveurs Compteur pour le nombre de serveurs dans le groupe de serveurs.
Nombre de Delivery Controller par magasin Liste des valeurs numériques indiquant le nombre de Delivery Controller disponibles pour chaque magasin dans le déploiement.
HTTPS activé Chaîne indiquant si le protocole HTTPS est activé pour le déploiement (« True » ou « False »).
Paramètre HTML5 pour Citrix Receiver pour Web Liste des chaînes indiquant le paramètre de Receiver pour HTML5 pour chaque site Receiver pour Web (« Always », « Fallback », or « Off »).
Contrôle de l’espace de travail activé pour l’application Citrix Workspace/Citrix Receiver Liste des booléens indiquant si le « Contrôle de l’espace de travail » est activé pour chaque site Receiver pour Web (« True » ou « False »).
Accès à distance activé pour le magasin Liste des chaînes indiquant si l’« Accès à distance » est activé pour chaque magasin du déploiement (« ENABLED » ou « DISABLED »).
Nombre de passerelles Compteur du nombre de passerelles Citrix Gateway configurées dans le déploiement.

Citrix Analytics Service

Si vous êtes un client Citrix Cloud et que vous disposez d’un déploiement StoreFront local, vous pouvez configurer StoreFront de manière à ce que les données soient envoyées à Citrix Analytics Service dans Citrix Cloud. Une fois la configuration effectuée, l’application Citrix Workspace et les sites Citrix Receiver pour Web accessibles à partir de navigateurs compatibles HTML5 envoient des événements relatifs à l’utilisateur à Citrix Analytics pour traitement. Citrix Analytics regroupe des mesures sur les utilisateurs, les applications, les points de terminaison, les réseaux et les données pour fournir des informations complètes sur le comportement des utilisateurs. Pour en savoir plus sur cette fonctionnalité dans la documentation de Citrix Analytics, consultez la section Intégrer des sites Virtual Apps and Desktops à l’aide de StoreFront.

Pour configurer ce comportement, procédez comme suit :

  • Téléchargez un fichier de configuration à partir de Citrix Analytics.
  • Importez les données Citrix Analytics dans votre déploiement StoreFront local à l’aide de PowerShell.

Une fois StoreFront configuré, l’application Citrix Workspace peut envoyer des données à partir des magasins StoreFront lorsque Citrix Analytics Service le demande.

Important :

Votre déploiement StoreFront doit pouvoir contacter les adresses suivantes sur le port 443 pour que cette fonctionnalité fonctionne correctement et utilise les services Citrix Cloud :

  • https://*.cloud.com
  • https://*.citrixdata.com

Télécharger le fichier de configuration à partir de Citrix Analytics

Important :

Un fichier de configuration contenant des informations sensibles est requis pour la configuration initiale. Conservez le fichier en toute sécurité après le téléchargement. Ne partagez pas ce fichier avec quiconque en dehors de votre organisation. Après la configuration, vous pouvez supprimer ce fichier. Si vous devez réappliquer la configuration sur une autre machine, vous pouvez télécharger à nouveau le fichier à partir de la console de gestion de Citrix Analytics Service.

  1. Connectez-vous à Citrix Cloud (https://citrix.cloud.com/) à l’aide d’un compte d’administrateur.
  2. Sélectionnez un client Citrix Cloud.

  3. Cliquez sur Gérer pour ouvrir la console de gestion de Citrix Analytics Service.

    Mosaïque Analytics

  4. Dans la console de gestion de Citrix Analytics Service, sélectionnez Settings > Data Sources.
  5. Dans la carte Virtual Apps and Desktops, sélectionnez l’icône de menu (⋮), puis sélectionnez Connect StoreFront deployment.
  6. Sur la page Connect StoreFront Deployment, sélectionnez Download File pour télécharger le fichier StoreFrontConfigurationFile.json.

Exemple de fichier de configuration 

{
  "customerId": "<yourcloudcustomer>",
  "enablementService": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/<yourcloudcustomer>/XenDesktop/<deviceid>/dsconfigdata",
  "cwsServiceKey": "PFJTPn…….. T4=",
  "enablementServiceStatus": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/storefront/config",
  "instanceId": "d98f21d0-56e0-11e9-ba52-5136d90862fe",
  "name": "CASSingleTenant"
}
<!--NeedCopy-->

où

customerId est l’ID unique du client Citrix Cloud actuel.

cwsServiceKey est une clé unique identifiant le compte client Citrix Cloud actuel.

instanceID est un ID généré utilisé pour signer des requêtes (sécurisées) effectuées à partir de l’application Citrix Workspace vers Citrix Analytics. Si vous enregistrez plusieurs serveurs StoreFront ou groupes de serveurs avec Citrix Cloud, chacun possède un ID instanceID unique.

Importer les données Citrix Analytics dans votre déploiement StoreFront

  1. Copiez le fichier StoreFrontConfigurationFile.json dans un dossier approprié sur le serveur StoreFront local (ou un serveur dans un groupe de serveurs StoreFront). Les commandes suivantes supposent que le fichier est enregistré sur le bureau.
  2. Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.

  3. Exécutez les commandes suivantes :

    Import-STFCasConfiguration -Path "$Env:UserProfile\Desktop\StoreFrontConfigurationFile.json"
Get-STFCasConfiguration
<!--NeedCopy-->

  4. Cette commande renvoie une copie des données importées et l’affiche dans la console PowerShell.

    get stf cas configuration

Remarque :

Les serveurs StoreFront locaux, qui sont installés sur Windows Server 2012 R2, peuvent nécessiter l’installation manuelle des composants logiciels C++ Runtime, afin qu’ils puissent s’inscrire auprès de CAS. Si StoreFront est installé lors de l’installation de Citrix Virtual Apps and Desktops, cette étape n’est pas requise, car le métainstaller CVAD installe déjà les composants C++ Runtime. Si StoreFront est installé en utilisant uniquement le métainstaller CitrixStoreFront-x64.exe sans C++ Runtime, il peut ne pas réussir à s’inscrire auprès de Citrix Cloud après l’importation du fichier de configuration CAS.

Propager les données Citrix Analytics vers un groupe de serveurs StoreFront

Si vous effectuez ces actions sur un groupe de serveurs StoreFront, vous devez propager les données Citrix Analytics importées à tous les membres du groupe de serveurs. Cette étape n’est pas nécessaire dans un déploiement de serveur StoreFront unique.

Pour propager les données, utilisez l’une des approches suivantes :

  • Utilisez la console de gestion StoreFront.
  • Utilisez l’applet de commande PowerShell Publish-STFServerGroupConfiguration.

Vérifier l’ID du groupe de serveurs StoreFront

Pour vérifier si votre déploiement s’est correctement enregistré auprès de Citrix Analytics Service, vous pouvez utiliser PowerShell pour afficher l’ID ServerGroupID de votre déploiement.

  1. Connectez-vous à votre serveur StoreFront ou à un serveur StoreFront dans le groupe de serveurs.
  2. Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.

  3. Exécutez les commandes suivantes :

    $WebConfigPath = "C:\Program Files\Citrix\Receiver StoreFront\Framework\FrameworkData\Framework.xml"
$XMLObject = (Get-Content $WebConfigPath) -as [Xml]
$XMLObject.framework.properties.property
<!--NeedCopy-->

    Par exemple, ces commandes génèrent une sortie comme suit :

    name value
---- -----
ClusterId 8b8ff5c8-44ba-46e4-87f0-2df8cff31432
HostBaseUrl https://storefront.example.com/
SelectedIISWebSiteId 1
AdminConsoleOperationMode Full
<!--NeedCopy-->

Arrêter d’envoyer des données à Citrix Analytics à partir de StoreFront

  1. Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.

  2. Exécutez les commandes suivantes :

    Remove-STFCasConfiguration

    Get-STFCasConfiguration

    Get-STFCasConfiguration ne renvoie aucune valeur si les données Citrix Analytics précédemment importées ont été supprimées.

  3. Si vous effectuez ces actions sur un groupe de serveurs StoreFront, propagez la modification et supprimez les données Citrix Analytics importées de tous les membres du groupe de serveurs. Sur un serveur du groupe de serveurs, exécutez la commande suivante :

    Publish-STFServerGroupConfiguration

  4. Sur tous les autres membres du groupe de serveurs, exécutez la commande suivante pour confirmer que la configuration de Citrix Analytics a bien été supprimée de tous les serveurs du groupe :

    Get-STFCasConfiguration

  5. Connectez-vous à Citrix Cloud (https://citrix.cloud.com/) à l’aide d’un compte d’administrateur.
  6. Sélectionnez un client Citrix Cloud.
  7. Cliquez sur Gérer pour ouvrir la console de gestion de Citrix Analytics Service.
  8. Dans la console de gestion de Citrix Analytics Service, sélectionnez Settings > Data Sources.

  9. Dans la carte Virtual App and Desktops, sélectionnez le nombre de StoreFront deployment :

    Groupes de serveurs StoreFront

  10. Identifiez le déploiement StoreFront que vous souhaitez supprimer en faisant référence à son URL de base de l’hôte et son ID ServerGroupID.

  11. Dans le menu (⋮), sélectionnez Remove StoreFront deployment from Analytics.

    Groupes de serveurs StoreFront

Remarque :

Si vous supprimez la configuration côté serveur, mais pas à partir de Citrix Analytics, l’entrée StoreFront deployment reste dans Citrix Analytics, mais ne reçoit aucune donnée de StoreFront. Si vous supprimez la configuration de Citrix Analytics uniquement, l’entrée StoreFront deployment est de nouveau ajoutée lors du prochain recyclage du pool d’applications (effectué lors d’une réinitialisation IIS ou automatiquement toutes les 24 heures).

Configurer StoreFront pour utiliser un proxy Web pour contacter Citrix Cloud et s’enregistrer auprès de Citrix Analytics

Si StoreFront est placé sur un serveur Web hôte derrière un proxy Web, l’enregistrement auprès de Citrix Analytics échoue. Si les administrateurs StoreFront utilisent un proxy HTTP dans leur déploiement Citrix, le trafic StoreFront lié à Internet doit passer par le proxy Web avant d’atteindre Citrix Analytics dans le cloud. StoreFront n’utilise pas automatiquement les paramètres proxy du système d’exploitation d’hébergement ; une configuration supplémentaire est requise pour demander au magasin d’envoyer le trafic sortant via le proxy Web. Vous pouvez définir une configuration de proxy <system.net> en ajoutant une nouvelle section au fichier web.config du magasin. Effectuez cette opération pour chaque magasin sur le serveur StoreFront qui est utilisé pour envoyer des données à Citrix Analytics.

Méthode 1 – Définir la configuration du proxy de magasin via Powershell pour un ou plusieurs magasins (recommandé)

L’exécution du script Powershell Config-StoreProxy.ps1 automatise ce processus pour un ou plusieurs magasins et insère automatiquement le fichier XML valide pour configurer <system.net>. Le script sauvegarde également le fichier web.config store sur le bureau de l’utilisateur actuel, ce qui permet de restaurer le fichier web.config non modifié si nécessaire.

Remarque :

L’exécution répétée du script peut entraîner l’ajout de plusieurs copies du fichier XML <system.net>. Chaque magasin ne devrait avoir qu’une seule entrée pour <system.net>. L’ajout de plusieurs copies empêche la configuration du proxy de magasin de fonctionner correctement.

  1. Ouvrez PowerShell ISE et sélectionnez Exécuter en tant qu’administrateur.

  2. Définissez $Stores = @("Store","Store2") pour inclure les magasins que vous souhaitez configurer avec un proxy Web.

  3. Spécifiez :

    • une adresse IP OU
    • un nom de domaine complet pour le proxy Web

  4. Exécutez les applets de commande PowerShell suivants :

    $Stores = @("Store","Store2")
$ProxyIP = "10.0.0.1"
$ProxyFQDN = "proxyserver.example.com"
$ProxyPort = 8888

# Set this for every Store using Stores array
function Set-StoreProxyServer() # Tested with both IP and FQDN
{
    [CmdletBinding()]
    param([Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][array]$Stores,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][string]$ProxyIP,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][string]$ProxyFQDN,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][int]$ProxyPort)

    foreach($Store in $Stores)
    {
        Write-Host "Backing up the Store web.config file for store $Store before making changes..." -ForegroundColor "Yellow"
        Write-Host "`n"

        if(!(Test-Path "$env:UserProfile\desktop$Store"))
        {
            Write-Host "Creating $env:UserProfile\desktop$Store\ directory for backup..." -ForegroundColor "Yellow"
            New-Item -Path "$env:UserProfile\desktop$Store" -ItemType "Directory" | Out-Null
            Write-Host "`n"
        }

        Write-Host "Copying c:\inetpub\wwwroot\Citrix$Store\web.config to $env:UserProfile\desktop$Store..." -ForegroundColor "Yellow"
        Copy-Item -Path "c:\inetpub\wwwroot\Citrix$Store\web.config" -Destination "$env:UserProfile\desktop$Store" -Force | Out-Null

        if(Test-Path "$env:UserProfile\desktop$Store\web.config")
        {
            Write-Host "$env:UserProfile\desktop$Store\web.config file backed up" -ForegroundColor "Green"
        }
        else
        {
            Write-Host "$env:UserProfile\desktop$Store\web.config file NOT found!" -ForegroundColor "Red"
        }
        Write-Host "`n"

        Write-Host "Setting the proxy server to $ProxyAddress for Store $Store..." -ForegroundColor "Yellow"
        Write-Host "`n"

        $StoreConfigPath = "c:\inetpub\wwwroot\Citrix$Store\web.config"
        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]

        if([string]::IsNullOrEmpty($ProxyFQDN))
        {
            $ProxyServer = ("HTTP://$ProxyIP"+":"+$ProxyPort)
        }
        else
        {
            $ProxyServer = ("HTTP://$ProxyFQDN"+":"+$ProxyPort)
        }

        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]

        # Create 3 elements
        $SystemNet = $XMLObject.CreateNode("element","system.net","")
        $DefaultProxy = $XMLObject.CreateNode("element","defaultProxy","")
        $Proxy = $XMLObject.CreateNode("element","proxy","")
        $Proxy.SetAttribute("proxyaddress","$ProxyServer")
        $Proxy.SetAttribute("bypassonlocal","true")

        # Move back up the XML tree appending new child items in reverse order
        $DefaultProxy.AppendChild($Proxy)
        $SystemNet.AppendChild($DefaultProxy)
        $XMLObject.configuration.AppendChild($SystemNet)

        # Save the modified XML document to disk
        $XMLObject.Save($StoreConfigPath)

        Write-Host "Getting the proxy configuration for c:\inetpub\wwwroot\Citrix$Store..." -ForegroundColor "Yellow"
        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]
        $ConfiguredProxyServer = $XMLObject.configuration.'system.net'.defaultProxy.proxy.proxyaddress | Out-Null
        Write-Host ("Configured proxy server for Store $Store"+": "+ $ConfiguredProxyServer) -ForegroundColor "Green"
        Write-Host "`n"
    }
    Write-Host "Restarting IIS..." -ForegroundColor "Yellow"
    IISReset /RESTART
}

Set-StoreProxyServer -Stores $Stores -ProxyFQDN $ProxyFQDN -ProxyPort $ProxyPort
# OR
Set-StoreProxyServer -Stores $Stores -ProxyIP $ProxyIP -ProxyPort $ProxyPort
<!--NeedCopy-->

  5. Vérifiez que C:\inetpub\wwwroot\Citrix<magasin>\web.config contient maintenant une nouvelle section <system.net> à la fin du fichier web.config.

            </dependentAssembly>
    </assemblyBinding>
</runtime>
<system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
</configuration>
<!--NeedCopy-->

  6. Importez les données de Citrix Analytics comme décrit dans la section Importer les données Citrix Analytics dans votre déploiement StoreFront.

Méthode 2 – Ajouter manuellement une section <system.net> au fichier web.config du magasin

Cette opération doit être effectuée pour chaque magasin sur le serveur StoreFront qui est utilisé pour envoyer des données à Citrix Analytics.

  1. Sauvegardez le fichier web.config du magasin et copiez-le vers un autre emplacement en dehors de C:\inetpub\wwwroot\Citrix<magasin>\web.config.

  2. Modifiez le fichier XML suivant avec vos paramètres de proxy à l’aide d’une combinaison Nom de domaine complet + Port ou d’une combinaison Adresse IP + Port.

    Par exemple, à l’aide d’une combinaison Nom de domaine complet + Port, utilisez l’élément <system.net> suivant :

    <system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
<!--NeedCopy-->

    Par exemple, à l’aide d’une combinaison Adresse IP + Port, utilisez l’élément <system.net> suivant :

    <system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://10.0.0.1:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
<!--NeedCopy-->

  3. À la fin du fichier web.config du magasin, insérez l’élément <system.net> approprié comme indiqué ici :

    <runtime>
<gcServer enabled="true" />
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
    <assemblyIdentity name="System.Web.MVC" publicKeyToken="31BF3856AD364E35" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
    </dependentAssembly>
</assemblyBinding>
</runtime>

Insert the <system.net> element here

</configuration>
<!--NeedCopy-->

  4. Importez les données de Citrix Analytics comme décrit dans la section Importer les données Citrix Analytics dans votre déploiement StoreFront.

Mettre à niveau StoreFront

Avertissement :

Lorsque vous effectuez une mise à niveau vers StoreFront 1912, tous les sites Desktop Appliance de votre déploiement sont automatiquement supprimés. Si vous devez conserver vos sites Desktop Appliance, n’effectuez pas de mise à niveau. Citrix recommande également d’utiliser l’application Citrix Workspace Desktop Lock pour tous les cas d’utilisation ne faisant pas partie d’un domaine.

La mise à niveau permet également de préserver votre configuration StoreFront ainsi que les données d’abonnement aux applications si bien que les utilisateurs n’ont pas besoin de se réabonner à toutes leurs applications. En revanche, la désinstallation de StoreFront supprime StoreFront et les services, les sites et les données d’abonnement aux applications (sur des serveurs autonomes) associés, ainsi que la configuration associée.

À savoir

  • La mise à niveau de la version du système d’exploitation sur un serveur exécutant StoreFront n’est pas prise en charge. Citrix vous recommande d’installer StoreFront sur une nouvelle installation du système d’exploitation.
  • La mise à niveau vers la version actuelle de StoreFront (Current Release) à partir d’une version plus ancienne qui est maintenant en fin de vie n’est pas prise en charge. Pour plus d’informations, voir CTX200356.
  • StoreFront ne prend pas en charge les déploiements sur plusieurs serveurs contenant différentes versions de produit ; par conséquent tous les serveurs d’un groupe doivent être mis à niveau vers la même version avant de se voir accorder l’accès au déploiement.
  • StoreFront ne prend pas en charge les déploiements sur plusieurs serveurs contenant différents systèmes d’exploitation de serveur ; par conséquent tous les serveurs d’un groupe doivent être sur le même système d’exploitation Windows Server.
  • La mise à niveau simultanée n’est pas prise en charge pour les déploiements contenant de multiples serveurs ; les serveurs doivent être mis à niveau de manière séquentielle.
  • Tous les magasins qui utilisent l’expérience utilisateur classique sont mis à jour pour utiliser l’expérience unifiée lors de la mise à niveau vers cette version de StoreFront. Nous vous recommandons d’informer les utilisateurs des changements de la nouvelle expérience apportés par cette mise à niveau, décrits dans la section Expérience utilisateur unifiée. Si vous avez personnalisé l’expérience unifiée, vos personnalisations sont préservées lorsque vous effectuez une mise à niveau vers cette version de StoreFront. Vérifiez que l’apparence de vos personnalisations est toujours adaptée à la nouvelle expérience unifiée.
  • Avant que la mise à niveau StoreFront ne s’exécute, elle effectue des vérifications préalables à la mise à niveau. Si une vérification préalable à la mise à niveau échoue, la mise à niveau ne démarre pas et vous êtes averti des échecs. Votre installation StoreFront reste inchangée. Après avoir corrigé les erreurs, réexécutez la mise à niveau.
  • Si la mise à niveau de StoreFront échoue, votre installation StoreFront existante risque de perdre sa configuration initiale. Restaurez votre installation StoreFront à un état fonctionnel, puis réexécutez la mise à niveau. Pour restaurer StoreFront à un état fonctionnel, tenez compte des approches suivantes :
  • Tous les échecs de mise à niveau de StoreFront qui se produisent à partir du metainstaller Citrix Virtual Apps and Desktops sont signalés dans une boîte de dialogue contenant un lien vers le journal des échecs correspondant.

Se préparer à la mise à niveau

Avant de démarrer la mise à niveau, nous vous recommandons d’effectuer les étapes suivantes afin d’éviter l’échec de la mise à niveau :

  • Planifiez votre stratégie de sauvegarde avant la mise à niveau.
  • Si vous avez apporté des modifications aux 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 pouvez les restaurer pour rétablir vos modifications.
  • Fermez toutes les autres applications sur le serveur StoreFront.
  • Fermez la console de gestion StoreFront.
  • Fermez toutes les lignes de commande et les fenêtres de PowerShell.
  • Fermez tous les dossiers liés à StoreFront tels que C:\inetpub\wwwroot\Citrix\Store et C:\inetpub\wwwroot\Citrix\StoreWeb. Cela empêche l’Explorateur Windows d’appliquer un verrou exclusif sur ces dossiers.
  • Avant de procéder à la mise à niveau d’un serveur, redémarrez-le pour vous assurer qu’aucun verrou exclusif n’existe sur les fichiers ou dossiers StoreFront. (Le redémarrage du processus de l’Explorateur, par exemple en fermant toutes les instances de l’Explorateur Windows, n’est pas suffisant).
  • Exécutez la mise à niveau immédiatement sans démarrer d’autres programmes sur le serveur.
  • Mettez à niveau le serveur à l’aide d’un compte d’administration n’exécutant aucune autre installation et un nombre minimum d’autres applications.

Mettre à niveau un serveur StoreFront autonome

  1. Déconnectez les utilisateurs du déploiement StoreFront pour les empêcher d’accéder aux serveurs durant la mise à niveau. Ceci garantit que tous les fichiers StoreFront sont accessibles par le programme d’installation lors de la mise à niveau. Si le programme d’installation ne peut pas accéder aux fichiers, ils ne peuvent pas être remplacés, ce qui entraîne l’échec de la mise à niveau et la suppression de la configuration de StoreFront.

  2. Sauvegardez le serveur en créant un instantané de la VM.

  3. Exportez la configuration existante de StoreFront (recommandé).

  4. Exécutez le fichier d’installation de cette version de StoreFront.

Mettre à niveau un groupe de serveurs StoreFront

La mise à niveau de groupes de serveurs StoreFront implique l’utilisation d’un des serveurs pour supprimer les autres serveurs du groupe. Les serveurs supprimés conservent la configuration liée au groupe, ce qui peut les empêcher d’être associés à un nouveau groupe de serveurs. Avant de pouvoir être réutilisés pour créer de nouveaux groupes de serveurs ou en tant que serveurs StoreFront autonomes, ils doivent être réinitialisés aux paramètres d’usine ou réinstallés sur StoreFront.

Avant de procéder à la mise à niveau d’un groupe de serveurs, procédez comme suit :

  • Sauvegardez tous les serveurs du groupe en créant des instantanés de VM. Cela vous permet de revenir rapidement à un groupe opérationnel de serveurs à trois nœuds si la mise à niveau ne se déroule pas comme prévu.
  • Exportez la configuration existante de StoreFront (recommandé). Exportez uniquement la configuration du groupe de serveurs à partir d’un serveur. Si vous avez propagé toutes les modifications sur les serveurs, 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.

Exemple 1 – Mettre à niveau un groupe de serveurs StoreFront à trois nœuds lors d’un temps d’arrêt planifié réservé à la maintenance

Cette procédure décrit la mise à niveau d’un groupe de serveurs StoreFront composé de trois serveurs A, B et C, pendant des temps d’arrêt planifiés.

  1. Désactivez l’accès utilisateur au groupe de serveurs en désactivant l’URL d’équilibrage de charge. Cela empêche les utilisateurs de se connecter au déploiement lors de la mise à niveau.

  2. Utilisez le serveur A pour supprimer les serveurs B et C du groupe.

    Les serveurs B et C sont désormais « orphelins » au sein du groupe de serveurs.

  3. Mettez à niveau le serveur A en exécutant le fichier d’installation de cette version de StoreFront.
  4. Assurez-vous que le serveur A a bien été mis à niveau.
  5. Sur les serveurs B et C, désinstallez la version actuellement installée de StoreFront, puis installez la nouvelle version de StoreFront.

  6. Associez les serveurs B et C au serveur A mis à niveau pour créer un groupe de serveurs mis à niveau. Ce groupe de serveurs se compose d’un serveur mis à niveau (A) et de deux serveurs récemment installés (B et C).

    Ce processus (Joindre un groupe de serveurs existant) propage automatiquement toutes les données de configuration et d’abonnement aux nouveaux serveurs B et C.

  7. Vérifiez que tous les serveurs fonctionnent correctement.
  8. Activez l’accès de l’utilisateur au groupe de serveurs mis à niveau en activant l’URL d’équilibrage de charge.

Exemple 2 – Mettre à niveau un groupe de serveurs StoreFront à trois nœuds sans temps d’arrêt planifié

Cette procédure décrit la mise à niveau d’un groupe de serveurs StoreFront composé de trois serveurs A, B et C, sans temps d’arrêt planifié.

Avant de procéder à la mise à niveau d’un groupe de serveurs, procédez comme suit :

  1. Exportez les données d’abonnement à partir du serveur A à l’aide de la commande 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 et de configuration. Consultez Gérer les données d’abonnement d’un magasin.

  2. Désactivez l’accès de l’utilisateur au serveur C en désactivant le service d’équilibrage de charge qui représente le serveur C. Cela empêche les utilisateurs de se connecter au serveur C pendant le processus de mise à niveau. Maintenez le service d’équilibrage de charge représentant les serveurs A et B activés, afin que vos utilisateurs puissent continuer à les utiliser.
  3. Utilisez le serveur A pour supprimer le serveur C du groupe. Les serveurs A et B continuent de fournir un accès aux ressources de vos utilisateurs. Le serveur C est désormais « orphelin » au sein du groupe de serveurs et est réinitialisé aux paramètres d’usine.
  4. Réinitialisez les paramètres d’usine par défaut du serveur orphelin C à l’aide de Clear-STFDeployment.
  5. Importez la configuration de StoreFront que vous avez précédemment exportée sur le serveur C à l’aide de Import-STFConfiguration. Le serveur C a désormais 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 sur les autres serveurs qui sont associés au groupe.
  6. Mettez à niveau le serveur C en exécutant le fichier d’installation de cette version de StoreFront. Le serveur C a désormais une configuration identique à l’ancien groupe de serveurs et est mis à niveau vers une nouvelle version de StoreFront.
  7. 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 sur les autres serveurs qui sont associés au groupe.
  8. Répétez les étapes 2, 3, 4 et 6 à l’aide du serveur B (ne répétez pas l’étape 5). Pendant ce temps, seul le serveur A fournit aux utilisateurs un accès aux ressources. Il est donc recommandé d’effectuer cette étape pendant les périodes de travail plus calmes, où la charge sur le groupe de serveurs StoreFront devrait être minime.
  9. Associez le serveur B au serveur C à l’aide du processus Joindre un groupe de serveurs existant. Cela permet d’obtenir 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).
  10. Activez les services d’équilibrage de charge sur les serveurs B et C afin qu’ils puissent prendre la place du serveur A.
  11. Désactivez le service d’équilibrage de charge sur le serveur A afin que les utilisateurs soient dirigés vers les serveurs B et C récemment mis à niveau.
  12. Répétez les étapes 2 à 6 à l’aide du serveur A. Le processus de mise à niveau du groupe de serveurs est maintenant terminé. Les données de configuration et d’abonnement des serveurs A, B et C sont identiques à celles du groupe d’origine.

Remarque :

Pendant la brève période où le serveur A est le seul serveur accessible, les abonnements peuvent être perdus (étape 9). En effet, le nouveau groupe de serveurs peut disposer d’une copie légèrement obsolète de la base de données d’abonnement après la mise à niveau et tout nouvel enregistrement d’abonnement peut être perdu.

Cela n’a aucun impact fonctionnel car les données d’abonnement ne sont pas essentielles pour permettre aux utilisateurs de se connecter et de lancer des ressources. Les utilisateurs devront cependant s’abonner à nouveau à une ressource une fois le serveur A réinitialisé aux paramètres d’usine et associé au groupe récemment mis à niveau. Bien qu’il soit peu probable que plus de quelques enregistrements d’abonnement soient perdus, il s’agit d’une conséquence possible de la mise à niveau d’un environnement de production StoreFront actif sans temps d’arrêt planifié.

Configurer StoreFront

Lors du premier démarrage de la console de gestion Citrix StoreFront, deux options sont disponibles.

  • Créer un déploiement. Configurez le premier serveur StoreFront dans un nouveau déploiement StoreFront. Les déploiements sur un seul serveur sont particulièrement adaptés à l’évaluation de StoreFront ou aux déploiements de production de petite taille. Une fois que vous avez configuré votre premier serveur StoreFront, vous pouvez ajouter plus de serveurs au groupe à tout moment pour augmenter la capacité de votre déploiement.
  • Joindre un groupe de serveurs existant. Ajoutez un autre serveur à un déploiement StoreFront. Sélectionnez cette option pour augmenter rapidement la capacité de votre déploiement StoreFront. L’équilibrage de charge externe est requis pour les déploiements comprenant plusieurs serveurs. Pour ajouter un serveur, vous devez pouvoir accéder à un serveur existant du déploiement. Citrix vous recommande de ne pas ajouter plus de 6 serveurs à un groupe de serveurs.

Désinstallez StoreFront

En plus du produit lui-même, la désinstallation de StoreFront supprime le service d’authentification, les magasins, les sites Citrix Receiver pour Web et les adresses URL XenApp Services, ainsi que les configurations associées à ces composants. Le Subscription Store Service contenant les données d’abonnement des applications est également supprimé. Dans les déploiements sur un serveur unique, les détails des abonnements utilisateur aux applications sont par conséquent perdus. Toutefois, dans les déploiements contenant de multiples serveurs, ces données sont conservées sur les autres serveurs dans le groupe. Les composants activés par le programme d’installation de StoreFront, tels que les fonctionnalités .NET Framework et les services de rôle de serveur Web (IIS), ne sont pas supprimés du serveur lors de la désinstallation de StoreFront.

  1. Ouvrez une session sur le serveur StoreFront en utilisant un compte disposant d’autorisations d’administrateur local.
  2. Fermez la console d’administration StoreFront si elle est ouverte.
  3. Fermez toutes les sessions PowerShell qui ont pu être utilisées pour gérer StoreFront via son SDK PowerShell.
  4. Sur l’écran Démarrer de Windows ou l’écran Applications, accédez à la vignette Citrix StoreFront. Cliquez avec le bouton droit sur la vignette et cliquez sur Désinstaller.
  5. Dans la boîte de dialogue Programmes et fonctionnalités, sélectionnez Citrix StoreFront et cliquez sur Désinstaller pour supprimer tous les composants StoreFront du serveur.
  6. Dans la boîte de dialogue Désinstaller Citrix StoreFront, cliquez sur Oui. Une fois la désinstallation terminée, cliquez sur OK.
Installer, configurer, mettre à niveau et désinstaller
June 23, 2022
Contributeur: 
C
June 23, 2022
Contributeur: 
C

Dans cet article

Commentaires sur le site | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement
© 1999- Cloud Software Group, Inc. All rights reserved.