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 la lance. 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
Consultez la section Configuration système requise avant l’installation.
Conseils post-déploiement
Après l’installation, maintenez tous les Cloud Connectors sous tension en permanence pour garantir une connexion continue à Citrix Cloud.
Mises à niveau
Les mises à niveau sont normalement gérées automatiquement par Citrix Cloud. Pour effectuer une mise à niveau manuelle, désinstallez d’abord l’ancien Cloud Connector avant d’installer la nouvelle version. Ne mettez pas à niveau un Cloud Connector précédemment installé avec une version plus récente. Ne mettez pas à niveau les composants individuels du Cloud Connector séparément.
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 des ressources :
- Dans le menu Citrix Cloud, sélectionnez Emplacements des ressources.
- Localisez l’emplacement des 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 en forme de points de suspension. Sélectionnez Supprimer le connecteur.
- 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éplacement de 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 des 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 de votre emplacement de ressources et que vous souhaitez utiliser des machines clonées, suivez les étapes suivantes :
- Préparez le modèle de machine en fonction des 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 sur laquelle le Cloud Connector est installé, les services du Cloud Connector ne fonctionneront 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 pour 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’installeur du Cloud Connector vous invite à sélectionner l’emplacement de ressources souhaité pendant l’installation.
Installation interactive
Vous pouvez télécharger et installer les Cloud Connectors à l’aide de l’interface d’installation graphique. Avant de faire cela, 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.
-
Accédez à 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 de connecteur.
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 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 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 connecteur sont remplies sur la machine.
Mise à niveau et tests initiaux
-
Après avoir mis à jour le Proxy Server et vérifié l’Advanced Connectivity Check, cliquez sur Install Cloud Connector.
-
Sur la page Sign-in, cliquez sur Sign in and Install.
-
La fenêtre Citrix Cloud Connectivity Test apparaît et l’état de la mise à niveau et des tests initiaux s’affiche, ainsi que les journaux d’événements.
-
Cliquez sur View logs 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 et les tests initiaux terminés, le test de connectivité Citrix Cloud s’affiche comme Successful, comme illustré dans l’image suivante. Les résultats de la vérification de la connectivité s’affichent dans la zone 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 de catalogues 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.
Créer des emplacements de ressources supplémentaires
- Depuis la console de gestion Citrix Cloud, cliquez sur le bouton de menu et sélectionnez Resource Locations.
- Cliquez sur + Resource Location et saisissez un nom significatif.
- Cliquez sur Enregistrer. Citrix Cloud affiche une vignette pour le nouvel emplacement de ressources.
- Cliquez sur Cloud Connectors, puis cliquez 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 des 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, 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 de ressources de la console Citrix Cloud.
Prérequis
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 « 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 de 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 Requis. 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 Requis. L’ID de principal sécurisé qu’un administrateur peut créer, situé sur la page Accès API.
- clientSecret Requis. Le secret de 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 d’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 Requis. 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 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 de
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 à une carte réseau spécifique, notez l’adresse IP de cette carte réseau. -
Dans une invite de commande 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 but est d’enregistrer quelle application 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, dans le registre, accédez à
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServeret créez uneDWORDnommé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 disponibles 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. Des 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 - Installation 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 s’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 avancée de la connectivité du Cloud Connector peut 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 avancée de la connectivité du Cloud Connector.
Pour plus d’informations sur la résolution d’un échec de vérification de la connectivité, consultez CTX224133 : Échec de la vérification de la connectivité du Cloud Connector.