Installation du Cloud Connector
Vous pouvez installer le logiciel Cloud Connector de manière interactive ou en utilisant la ligne de commande.
-
L’installation s’effectue avec les privilèges de l’utilisateur qui lance l’installation. Le Cloud Connector nécessite un accès au cloud pour :
- Authentifier l’utilisateur qui effectue l’installation
- Valider les autorisations de l’installateur
-
Télécharger et configurer les services Cloud Connector
-
Informations à consulter avant l’installation
- Configuration système requise : Pour préparer les machines destinées à héberger le Cloud Connector.
- Section Exclusions d’antivirus de l’article Tech Zone Bonnes pratiques en matière de sécurité des points de terminaison et d’antivirus : Fournit des directives pour vous aider à déterminer l’équilibre approprié entre sécurité et performances pour les Cloud Connectors dans votre environnement. Citrix recommande fortement de revoir ces directives avec les équipes antivirus et de sécurité de votre organisation, et d’effectuer des tests rigoureux en laboratoire avant de les appliquer à un environnement de production.
- Exigences système et de connectivité : Pour s’assurer que toutes les machines hébergeant le Cloud Connector peuvent communiquer avec Citrix Cloud.
- Configuration du proxy et du pare-feu du Cloud Connector : Si vous installez le Cloud Connector dans un environnement doté d’un proxy web ou de règles de pare-feu strictes.
-
Considérations relatives à la mise à l’échelle et à la taille des Cloud Connectors : Fournit des détails sur les capacités maximales testées et les recommandations de bonnes pratiques pour la configuration des machines destinées à héberger le Cloud Connector.
-
Considérations et conseils d’installation
- N’installez pas le Cloud Connector sur un contrôleur de domaine Active Directory ou toute autre machine critique pour l’infrastructure de votre emplacement de ressources. La maintenance régulière du Cloud Connector effectue des opérations machine qui entraînent une interruption de ces ressources supplémentaires.
- Ne téléchargez ni n’installez d’autres produits Citrix® sur les machines hébergeant le Cloud Connector.
- Ne mettez pas à niveau les composants individuels du Cloud Connector séparément.
- Ne téléchargez ni n’installez le Cloud Connector sur des machines appartenant à d’autres déploiements de produits Citrix (par exemple, des Delivery Controllers dans un déploiement Citrix Virtual Apps and Desktops™ sur site).
- Ne mettez pas à niveau un Cloud Connector précédemment installé avec une version plus récente. Désinstallez plutôt l’ancien Cloud Connector, puis installez le nouveau.
- L’installateur du Cloud Connector est téléchargé depuis Citrix Cloud. Votre navigateur doit donc autoriser le téléchargement de fichiers exécutables.
- Si vous utilisez l’installateur graphique, vous devez avoir un navigateur installé et le navigateur système par défaut configuré.
Conseils post-déploiement
Après l’installation, maintenez tous les Cloud Connectors sous tension en permanence pour assurer une connexion continue à Citrix Cloud.
Renommer les machines
Après l’installation, ne renommez pas la machine hébergeant le Cloud Connector. Si vous devez modifier le nom du serveur ultérieurement, effectuez les tâches suivantes :
- Supprimez la machine de l’emplacement de ressources :
- Dans le menu Citrix Cloud, sélectionnez Emplacements de ressources.
- Localisez l’emplacement de ressources que vous souhaitez gérer, puis sélectionnez la vignette Cloud Connectors.
- Localisez la machine que vous souhaitez gérer, puis cliquez sur le menu des points de suspension. Sélectionnez Supprimer le Connector.
- Désinstallez le logiciel Cloud Connector.
- Renommez la machine.
- Installez la dernière version du logiciel Cloud Connector, comme décrit dans cet article.
Déplacer des machines vers un autre domaine
Après l’installation, ne déplacez pas la machine hébergeant le Cloud Connector vers un autre domaine. Si vous devez joindre la machine à un autre domaine ultérieurement, effectuez les tâches suivantes :
- Supprimez la machine de l’emplacement de ressources.
- Désinstallez le logiciel Cloud Connector.
- Dissociez la machine de son domaine actuel et rejoignez la machine au nouveau domaine.
- Installez la dernière version du logiciel Cloud Connector, comme décrit dans cet article.
Considérations relatives aux machines clonées
Chaque machine hébergeant le Cloud Connector doit avoir un SID et un ID de connecteur uniques afin que Citrix Cloud puisse communiquer de manière fiable avec les machines de votre emplacement de ressources. Si vous avez l’intention d’héberger le Cloud Connector sur plusieurs machines dans votre emplacement de ressources et que vous souhaitez utiliser des machines clonées, suivez les étapes suivantes :
- Préparez le modèle de machine conformément aux exigences de votre environnement.
- Provisionnez le nombre de machines que vous avez l’intention d’utiliser comme Cloud Connectors.
- Installez le Cloud Connector sur chaque machine, manuellement ou en utilisant le mode d’installation silencieuse.
L’installation du Cloud Connector sur un modèle de machine (avant le clonage) n’est pas prise en charge. Si vous clonez une machine avec le Cloud Connector installé, les services Cloud Connector ne s’exécuteront pas et la machine ne pourra pas se connecter à Citrix Cloud.
Considérations relatives aux services
Les étapes d’installation de cet article décrivent le processus de déploiement des Cloud Connectors, quel que soit le service pour lequel ils sont utilisés.
Lors du déploiement de Cloud Connectors pour Citrix DaaS, vérifiez que les domaines AD où résident les connecteurs sont actifs et n’apparaissent pas comme « inutilisés » dans la console Citrix Cloud. Si vous spécifiez un domaine inutilisé lors de la configuration du catalogue de machines dans Citrix DaaS, une erreur peut se produire. Pour plus d’informations, consultez Ajouter un type de ressource ou activer un domaine inutilisé dans Citrix Cloud dans la documentation produit de Citrix DaaS.
Pour des considérations supplémentaires concernant d’autres services, consultez la documentation du service.
Emplacements de ressources par défaut
Si vous n’avez pas d’emplacements de ressources dans votre compte Citrix Cloud et que vous installez des Cloud Connectors dans votre domaine, l’emplacement de ressources créé par Citrix Cloud devient l’emplacement de ressources par défaut. Vous ne pouvez avoir qu’un seul emplacement de ressources par défaut dans votre compte. Si nécessaire, vous pouvez créer des emplacements de ressources supplémentaires dans Citrix Cloud, puis sélectionner celui que vous souhaitez lorsque vous installez des Cloud Connectors dans d’autres domaines.
Alternativement, vous pouvez d’abord créer les emplacements de ressources dont vous avez besoin dans la console, avant d’installer les Cloud Connectors dans vos domaines. L’installateur du Cloud Connector vous invite à sélectionner l’emplacement de ressources souhaité pendant l’installation.
Installation interactive
Vous pouvez télécharger et installer des Cloud Connectors à l’aide de l’interface de l’installateur graphique. Avant de le faire, vous devez créer un ou plusieurs emplacements de ressources dans la console de gestion Citrix Cloud pour y déployer des Cloud Connectors. Pour plus d’informations sur les emplacements de ressources, consultez Emplacements de ressources.
Télécharger le logiciel Citrix Cloud Connector™
-
Connectez-vous en tant qu’administrateur Windows à la machine sur laquelle vous avez l’intention d’installer les Citrix Cloud Connectors.
-
Visitez https://citrix.cloud.com et connectez-vous à votre compte administrateur.
-
Dans la console Citrix Cloud, accédez à Emplacements des ressources depuis le menu principal.
-
Si vous n’avez pas encore d’emplacement de ressources, cliquez sur l’icône plus (+) ou sélectionnez Ajouter un emplacement de ressources. Pour plus d’informations, consultez créer un emplacement de ressources.
-
Localisez l’emplacement de ressources que vous souhaitez gérer et sélectionnez + Cloud Connectors.
-
Sélectionnez Télécharger dans la fenêtre qui s’ouvre. Enregistrez le fichier cwcconnector.exe dans un emplacement de fichier local sur votre machine Connector.
Installer le logiciel Citrix Cloud Connector
-
Prérequis
-
- Cliquez avec le bouton droit sur le fichier d’installation
cwcconnector.exeet sélectionnez Exécuter en tant qu’administrateur. L’installateur effectue une vérification initiale de la connectivité pour s’assurer que vous pouvez vous connecter à Citrix Cloud avant d’installer le Cloud Connector.
- Cliquez avec le bouton droit sur le fichier d’installation
-
- Cliquez sur Gérer pour mettre à jour le serveur proxy.
Remarque :
Un seul serveur proxy est pris en charge en raison d’une limitation de Microsoft WinHTTP. Pour plus d’informations, consultez Problèmes d’AutoProxy dans WinHTTP
-
Cliquez sur Vérification avancée de la connectivité pour exécuter une vérification détaillée afin de s’assurer que les exigences de connectivité de base pour l’installation du Connector sont remplies sur la machine.
Mise à niveau initiale et tests
-
Après avoir mis à jour le Serveur proxy et vérifié la Vérification avancée de la connectivité, cliquez sur Installer le Cloud Connector.
-
Sur la page Connexion, cliquez sur Se connecter et installer.
-
- La fenêtre Test de connectivité Citrix Cloud apparaît et l’état de la mise à niveau initiale et des tests est affiché avec les journaux d’événements.
-
Cliquez sur Afficher les journaux pour ouvrir le répertoire
(C:\ProgramData\Citrix\WorkspaceCloud\InstallLogs)qui contient tous les journaux de débogage de la vérification de la connectivité. -
Une fois la mise à niveau initiale et les tests terminés, le test de connectivité Citrix Cloud sera Réussi, comme illustré dans l’image suivante. Les résultats de la vérification de la connectivité sont affichés dans la boîte du journal des événements après la première mise à niveau.
Activer les domaines inutilisés
Si vous créez des emplacements de ressources et déployez des Cloud Connectors pour Citrix DaaS™, vérifiez que les domaines AD que vous utilisez avec Citrix DaaS sont actifs et ne sont pas considérés comme inutilisés. Si vous spécifiez un domaine inutilisé lors de la configuration des catalogues de machines dans Citrix DaaS, une erreur pourrait se produire.
Pour plus d’informations, consultez Ajouter un type de ressource ou activer un domaine inutilisé dans Citrix Cloud dans la documentation produit de Citrix DaaS.
Créer des emplacements de ressources supplémentaires
- Depuis la console de gestion Citrix Cloud, cliquez sur le bouton de menu et sélectionnez Emplacements des ressources.
- Cliquez sur + Emplacement des ressources et saisissez un nom significatif.
- Cliquez sur Enregistrer. Citrix Cloud affiche une vignette pour le nouvel emplacement de ressources.
- Cliquez sur Cloud Connectors, puis sur Télécharger pour acquérir le logiciel Cloud Connector.
- Sur chaque machine préparée, installez le logiciel Cloud Connector à l’aide de l’assistant d’installation ou de l’installation en ligne de commande. Citrix Cloud vous invite à sélectionner l’emplacement de ressources que vous souhaitez associer au Cloud Connector.
Installation avec plusieurs clients et emplacements de ressources existants
Si vous êtes administrateur de plusieurs comptes clients, Citrix Cloud vous invite à sélectionner le compte client que vous souhaitez associer au Cloud Connector.
Si votre compte client possède déjà plusieurs emplacements de ressources, Citrix Cloud vous invite à sélectionner l’emplacement de ressources que vous souhaitez associer au Cloud Connector.
Installation en ligne de commande
L’installation silencieuse ou automatisée est prise en charge. Cependant, le programme d’installation du connecteur est régulièrement mis à jour et il est donc recommandé de télécharger la dernière version du programme d’installation pour chaque installation. Téléchargez un nouveau programme d’installation de Cloud Connector depuis la page Emplacements des ressources dans la console Citrix Cloud.
Pour utiliser l’installation en ligne de commande avec Citrix Cloud, vous devez fournir les informations suivantes :
- L’ID client du compte Citrix Cloud pour lequel vous installez le Cloud Connector. Cet ID apparaît en haut de l’onglet Accès API dans Gestion des identités et des accès.
- L’ID et le secret du principal sécurisé que vous souhaitez utiliser pour installer le Cloud Connector. Pour acquérir ces valeurs, vous devez d’abord créer un principal sécurisé. Le principal sécurisé doit être créé avec un « Accès complet ». Pour plus d’informations sur la création d’un principal de service, consultez Créer un principal de service. Une fois que vous disposez de l’ID et du secret du principal sécurisé, vous pouvez poursuivre l’installation du Cloud Connector.
-
L’ID d’emplacement de ressources pour l’emplacement de ressources que vous souhaitez associer au Cloud Connector. Pour récupérer cette valeur, sélectionnez le bouton ID situé sous le nom de l’emplacement de ressources sur la page Emplacements des ressources. Si vous ne fournissez pas cette valeur, Citrix Cloud utilise l’ID de l’emplacement de ressources par défaut.
-
Paramètres pris en charge
-
Pour garantir la sécurité de l’ID et du secret du principal sécurisé, un fichier de configuration JSON doit être fourni au programme d’installation. Ce fichier doit être supprimé une fois l’installation terminée. Les valeurs prises en charge pour le fichier de configuration sont :
- customerName Obligatoire. L’ID client affiché sur la page Accès API dans la console Citrix Cloud (dans Gestion des identités et des accès).
- clientId Obligatoire. L’ID du principal sécurisé qu’un administrateur peut créer, situé sur la page Accès API.
- clientSecret Obligatoire. Le secret du principal sécurisé qui peut être téléchargé après la création du principal sécurisé. Situé sur la page Accès API.
- resourceLocationId Recommandé. L’identifiant unique d’un emplacement de ressources existant. Sélectionnez le bouton ID pour récupérer l’ID de l’emplacement de ressources sur la page Emplacements des ressources dans la console Citrix Cloud. Si aucune valeur n’est spécifiée, Citrix Cloud utilise l’ID du premier emplacement de ressources du compte.
-
acceptTermsOfService Obligatoire. Doit être défini sur true.
-
Exemple de fichier de configuration
{
"customerName": "CustomerID",
"clientId": "SecurePrincipalID",
"clientSecret": "ClientSecret",
"resourceLocationId": "ResourceLocationId",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->
Exemple de commande
La commande suivante installe silencieusement le logiciel Cloud Connector à l’aide d’un fichier de configuration JSON :
CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->
Utilisez /q pour spécifier une installation silencieuse.
Utilisez Start /Wait CWCConnector.exe /ParametersFilePath:value pour examiner un code d’erreur potentiel en cas d’échec. Vous pouvez utiliser le mécanisme standard d’exécution de echo %ErrorLevel% une fois l’installation terminée.
Configuration HTTPS
Pour permettre aux appliances StoreFront™ et NetScaler Gateway de se connecter en toute sécurité au Cloud Connector et de chiffrer toutes les données, il est fortement recommandé d’activer HTTPS. Cela nécessite un certificat SSL.
- Le certificat doit inclure le nom de domaine complet (FQDN) utilisé pour atteindre le connecteur comme nom commun ou nom alternatif du sujet. Si vous avez déployé un équilibreur de charge devant le connecteur, utilisez le FQDN de l’équilibreur de charge.
- Le certificat peut être signé par une autorité de certification d’entreprise ou une autorité de certification publique.
- Tous les serveurs StoreFront et de passerelle qui se connectent au Cloud Connector doivent faire confiance au certificat.
Pour activer HTTPS :
-
Créez ou importez un certificat approprié dans le magasin de certificats personnels. Pour plus d’informations sur la gestion des certificats, consultez Gérer les certificats.
-
Ouvrez le certificat, accédez à l’onglet Détails et notez l’empreinte numérique, en ignorant les espaces.
-
Déterminez l’adresse IP à laquelle lier le certificat. Normalement, vous pouvez utiliser l’adresse IP
0.0.0.0pour l’appliquer à toutes les adresses IPv4. Si IPv6 est activé, utilisez[::]pour l’appliquer à toutes les adresses IPv6. Si vous souhaitez appliquer la modification uniquement à un adaptateur réseau spécifique, notez l’adresse IP de cet adaptateur réseau. -
Dans une invite de commandes avec élévation de privilèges, exécutez
netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID} <!--NeedCopy-->Vous pouvez utiliser n’importe quel GUID valide pour l’AppId. Son objectif est d’enregistrer l’application qui a ajouté la liaison. Cependant, la liaison s’applique à toutes les applications utilisant ce port.
Par exemple :
C:\> netsh http add sslcert ipport=0.0.0.0:443 certhash=BC96F958848639FD101A793B87915D5F2829B0B6 appid={6DE9BEFD-F4CB-4D63-8681-E88012D6F5F1} SSL Certificate successfully added <!--NeedCopy--> -
Pour désactiver HTTP, accédez au Registre à l’emplacement
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServeret créez une valeurDWORDnomméeXMLServicesEnableNonSSLavec la valeur 0.
Étapes suivantes
- Configurez le calendrier de mise à jour du Citrix Cloud Connector. Pour plus d’informations sur les mises à jour du Citrix Cloud Connector et la gestion des calendriers de mise à jour, consultez Mises à jour du connecteur.
- Si vous utilisez StoreFront, configurez StoreFront afin qu’il puisse utiliser le connecteur pour atteindre DaaS afin d’énumérer et de lancer des ressources. S’il s’agit du premier connecteur dans un nouveau déploiement DaaS, créez un nouveau flux de ressources. S’il s’agit d’un connecteur supplémentaire, il est recommandé, pour des raisons de résilience, d’ajouter tous les Cloud Connectors à la liste des serveurs de votre flux de ressources DaaS existant. Pour plus d’informations, consultez Gérer les ressources mises à disposition dans les magasins.
- Si vous utilisez StoreFront avec une passerelle NetScaler, vous pouvez utiliser le connecteur pour atteindre l’autorité de ticket sécurisé (STA) de Citrix Cloud. Pour plus d’informations, consultez Configurer les passerelles Citrix.
- S’il s’agit du premier connecteur sur un domaine Active Directory particulier, vous pouvez connecter ce domaine à Citrix Cloud. Pour plus d’informations, consultez Pour connecter votre Active Directory à Citrix Cloud.
Dépannage des problèmes d’installation
Cette section détaille quelques méthodes de diagnostic et de résolution des problèmes que vous pourriez rencontrer lors de l’installation. Pour plus de conseils sur le dépannage des problèmes d’installation, consultez le Guide de dépannage du Citrix Cloud Connector.
Journaux d’installation
Vous pouvez résoudre les problèmes rencontrés lors de l’installation en consultant d’abord les fichiers journaux disponibles.
Les événements survenus pendant l’installation sont disponibles dans l’Observateur d’événements Windows. Vous pouvez également consulter les journaux d’installation du Cloud Connector, qui se trouvent à l’emplacement %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup. Les journaux sont également ajoutés à %ProgramData%\Citrix\WorkspaceCloud\InstallLogs après l’installation.
Codes de sortie
Les codes de sortie suivants peuvent être renvoyés en fonction du succès ou de l’échec du processus d’installation :
- 1603 - Une erreur inattendue s’est produite
- 2 - Une vérification des prérequis a échoué
- 0 - L’installation s’est terminée avec succès
Erreur d’installation
Si vous installez le logiciel Citrix Cloud Connector en double-cliquant sur le programme d’installation, vous pourriez recevoir le message d’erreur suivant :
Can't reach this page.
Cette erreur peut se produire même si vous êtes connecté à la machine en tant qu’administrateur pour installer le Citrix Cloud Connector. Pour éviter cette erreur, exécutez le logiciel Citrix Cloud Connector en tant qu’administrateur en cliquant avec le bouton droit sur le programme d’installation et en sélectionnant Exécuter en tant qu’administrateur.
Échecs de connectivité
Pour vous assurer que le Cloud Connector peut communiquer avec Citrix Cloud, confirmez que les services Citrix suivants sont à l’état Démarré :
- Citrix Cloud AD Provider
- Citrix Cloud Agent Logger
- Citrix Cloud Agent System
- Citrix Cloud Agent Watchdog
- Citrix Cloud Credential Provider
- Citrix Config Synchronizer Service
- Citrix High Availability Service
- Citrix NetScaler® CloudGateway
- Citrix Remote Broker Provider
- Citrix Remote HCL Server
- Citrix Session Manager Proxy
Pour plus d’informations sur ces services, consultez Services installés.
L’outil de vérification de connectivité avancée du Cloud Connector peut vous aider à vérifier que le Cloud Connector peut atteindre Citrix Cloud et ses services associés.
Pour plus d’informations, consultez Outil de vérification de connectivité avancée du Cloud Connector.
Pour plus d’informations sur la résolution d’un échec de vérification de connectivité, consultez CTX224133: Cloud Connector Connectivity Check Failed.