Citrix Cloud

Installation de 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 requiert l’accès au cloud pour :

  • Authentifier l’utilisateur qui effectue l’installation
  • Valider les autorisations du programme d’installation
  • Télécharger et configurer les services Cloud Connector

Informations à consulter avant l’installation

Considérations et conseils en matière d’installation

  • N’installez pas le Cloud Connector sur un contrôleur de domaine Active Directory ou toute autre machine critique à votre infrastructure d’emplacement de ressources. La maintenance régulière du Cloud Connector exécute des opérations qui entraîneraient un arrêt de ces ressources supplémentaires.
  • Ne téléchargez et n’installez pas d’autres produits Citrix sur les machines hébergeant le Cloud Connector.
  • Ne téléchargez pas et n’installez pas le Cloud Connector sur des machines appartenant à d’autres déploiements de produits Citrix (par exemple, Delivery Controller dans un déploiement Citrix Virtual Apps and Desktops).
  • Ne mettez pas à niveau un Cloud Connector précédemment installé vers une version plus récente. Au lieu de cela, désinstallez l’ancien Cloud Connector et installez la nouvelle version.
  • Le programme d’installation du Cloud Connector est téléchargé depuis Citrix Cloud. Par conséquent, votre navigateur doit autoriser le téléchargement de fichiers exécutables.
  • Après l’installation, ne déplacez pas la machine qui héberge le Cloud Connector dans un autre domaine. Si vous souhaitez joindre la machine à un autre domaine, désinstallez le Cloud Connector et réinstallez-le une fois que la machine est jointe à l’autre domaine.
  • Une fois l’installation effectuée, conservez tous les Cloud Connector sous tension à tout moment pour garantir une connexion permanente à Citrix Cloud.

Considérations liées aux machines clonées

Chaque machine qui héberge 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 dans votre emplacement de ressources. Si vous avez l’intention d’héberger le Cloud Connector sur plusieurs machines dans votre emplacement de ressources et souhaitez utiliser des machines clonées, effectuez les opérations suivantes :

  1. Préparez le modèle de machine en fonction des exigences de votre environnement.
  2. Provisionnez le nombre de machines que vous prévoyez d’utiliser en tant que Cloud Connector.
  3. Installez le Cloud Connector sur chaque machine, soit manuellement soit à l’aide du 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.

Installation interactive

Vous pouvez télécharger et installer les Cloud Connector à l’aide de l’interface graphique du programme d’installation. Avant de procéder, vous devez créer un ou plusieurs emplacements de ressources dans la console de gestion Citrix Cloud sur lesquels déployer les Cloud Connector. Pour plus d’informations sur les emplacements de ressources, consultez Emplacement des ressources.

Créer un emplacement de ressources

  1. Connectez-vous en tant qu’administrateur Windows sur la machine sur laquelle vous souhaitez installer les Citrix Cloud Connector.
  2. Accédez à https://citrix.cloud.com et connectez-vous à votre compte administrateur.
  3. Dans la console Citrix Cloud, accédez à Emplacements de ressources dans le menu principal ou sélectionnez Modifier ou ajouter sous Emplacements de ressources en haut de la page.

    Emplacements des ressources

  4. Dans Emplacements de ressources, sélectionnez + Emplacement de ressources en haut de la page et enregistrez-le avec un nom unique.

    Ajouter nouvel emplacement de ressources

  5. Répétez ces étapes sur chaque machine que vous souhaitez utiliser en tant que Cloud Connector.

Téléchargez le logiciel Citrix Cloud Connector

  1. Localisez l’emplacement de ressources que vous souhaitez gérer et sélectionnez + Cloud Connector.

    Nouvel emplacement de ressources sans Connector

  2. Sélectionnez Télécharger dans la fenêtre qui s’ouvre. Enregistrez le fichier cwcconnector.exe dans un emplacement de fichier local sur la machine du Connector. Fenêtre Ajouter un Cloud Connector

Installer le logiciel Citrix Cloud Connector

  1. Cliquez avec le bouton droit sur cwcconnector.exe, puis sélectionnez Exécuter en tant qu’administrateur. Le programme d’installation vérifie la connectivité pour s’assurer que vous pouvez vous connecter à Citrix Cloud.
  2. Connectez-vous à Citrix Cloud lorsque vous y êtes invité.
  3. Pour installer et configurer Cloud Connector, suivez les instructions de l’assistant. Une fois l’installation terminée, le programme d’installation vérifie une dernière fois la connectivité pour vérifier la communication entre Cloud Connector et Citrix Cloud.
  4. Répétez ces étapes sur les autres machines que vous souhaitez utiliser en tant que Citrix Cloud Connector. Citrix recommande d’installer au moins deux composants Cloud Connector pour chaque emplacement de ressources pour garantir une haute disponibilité.

Citrix Cloud affiche le Cloud Connector nouvellement installé sur la page Connecteurs de votre emplacement de ressources.

Nouvel emplacement de ressources avec un Connector

Nouvel emplacement de ressources avec deux Connector

Après l’installation, Citrix Cloud enregistre votre domaine dans Gestion des identités et des accès > Domaines. Pour plus d’informations, consultez Gestion des identités et des accès.

Installation avec plusieurs clients et des emplacements de ressources existants

Si vous êtes l’administrateur de plusieurs comptes utilisateur, Citrix Cloud vous invite à sélectionner le compte client que vous souhaitez associer au Cloud Connector.

Si votre compte client dispose de plusieurs emplacements de ressources, Citrix Cloud vous invite à sélectionner l’emplacement de ressources à associer au Cloud Connector.

Installation avec ligne de commande

L’installation silencieuse ou automatisée est prise en charge. Cependant, il n’est pas recommandé d’utiliser le même programme d’installation pour des installations répétées. Téléchargez un nouveau Cloud Connector à partir de la page Emplacements des ressources de la console Citrix Cloud.

Exigences

Pour utiliser l’installation par ligne de commande avec Citrix Cloud, vous devez fournir les informations suivantes :

  • ID client du compte Citrix Cloud pour lequel vous installez le Cloud Connector. Cet ID apparaît en haut de l’onglet Accès aux API dans Gestion des identités et des accès.
  • ID client et secret du client API sécurisé que vous souhaitez utiliser pour installer le Cloud Connector. Pour acquérir ces valeurs, vous devez d’abord créer un client sécurisé. L’ID client et le secret garantissent que votre accès à l’API Citrix Cloud est sécurisé de manière appropriée. Lorsque vous créez un client sécurisé, le client fonctionne avec le même niveau d’autorisations d’administrateur que vous. Pour installer un Cloud Connector, vous devez utiliser un client sécurisé qui a été créé par un administrateur avec accès complet, ce qui signifie que le client sécurisé dispose également d’autorisations d’accès complet.
  • ID de l’emplacement de ressources que vous souhaitez associer au Cloud Connector. Pour récupérer cette valeur, cliquez sur 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.

Créer un client sécurisé

Lors de la création d’un client sécurisé, Citrix Cloud génère un ID client et un secret uniques. Vous devez fournir ces valeurs lorsque vous appelez l’API via la ligne de commande.

  1. Dans le menu Citrix Cloud, sélectionnez Gestion des identités et des accès, puis sélectionnez Accès aux API.
  2. Dans l’onglet Clients sécurisés, entrez un nom pour votre client et sélectionnez Créer un client. Citrix Cloud génère et affiche un ID client et un secret pour le client sécurisé.
  3. Sélectionnez Télécharger pour télécharger l’ID client et le secret en tant que fichier CSV et les stocker dans un emplacement sécurisé. Vous pouvez également sélectionner Copier pour acquérir manuellement chaque valeur. Lorsque vous avez terminé, sélectionnez Fermer pour revenir à la console.

Paramètres pris en charge

Pour garantir la sécurité des détails du client 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 les suivantes :

  • customerName obligatoire. ID du client affiché sur la page Accès aux API dans la console Citrix Cloud (sous Gestion des identités et des accès).
  • clientId obligatoire. ID de client sécurisé qu’un administrateur peut créer, situé sur la page Accès aux API
  • clientSecret obligatoire. Clé secrète sécurisée du client qui peut être téléchargée après création du client sécurisé. Située sur la page Accès aux API.
  • resourceLocationId recommandé. Identificateur unique d’un emplacement de ressources existant. Sélectionnez le bouton d’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 dans le compte.
  • acceptTermsOfService obligatoire. Doit être réglé sur true.

Exemple de fichier de configuration :

{
"customerName": "\*CustomerID\*",
"clientId": "\*ClientID\*",
"clientSecret": "\*ClientSecret\*",
"resourceLocationId": "\*ResourceLocationId\*",
"acceptTermsOfService": "true"
}

Exemple de ligne de commande qui installe à l’aide du fichier de paramètres :

CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json

Utilisez Start /Wait CWCConnector.exe /ParametersFilePath:value pour examiner un code d’erreur potentiel en cas de défaillance. Vous pouvez utiliser le mécanisme standard d’exécution de echo %ErrorLevel% une fois l’installation terminée.

Remarque :

L’utilisation de paramètres pour transmettre l’ID client et le secret client n’est plus prise en charge, le fichier de configuration doit être utilisé pour les installations automatisées.

Étapes suivantes

  1. Configurez le programme de mise à jour Citrix Cloud Connector. Pour plus d’informations sur les mises à jour Citrix Cloud Connector et la gestion des programmes de mises à jour, accédez à Mises à jour de Connector
  2. Configurez un fournisseur d’identité pour authentifier les abonnés de votre espace de travail. Vous pouvez remplacer le fournisseur d’identité Citrix défini par défaut par Active Directory ou d’autres fournisseurs d’identité dans la console Gestion des identités et des accès**. Pour plus d’informations, consultez Connecter Azure Active Directory à Citrix Cloud.

Résolution des problèmes d’installation

Cette section détaille différentes façons de diagnostiquer et de résoudre les problèmes que vous pourriez rencontrer lors de l’installation. Pour plus d’informations sur la résolution des problèmes d’installation, consultez le Guide de dépannage de 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 de Cloud Connector en accédant à %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup. Les journaux sont 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 - An unexpected error occurred (Une erreur inattendue s’est produite)
  • 2 - A prerequisite check failed (Échec de vérification des conditions préalables)
  • 0 - Installation completed successfully (L’installation s’est terminée avec succès)

Erreur d’installation

Si vous installez le logiciel Citrix Cloud Connector en cliquant deux fois sur le programme d’installation, le message d’erreur suivant peut s’afficher :

Can't reach this page.

Cette erreur peut se produire même si vous êtes connecté en tant qu’administrateur à la machine sur laquelle vous installez 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 garantir que Cloud Connector peut communiquer avec Citrix Cloud, vérifiez que les services Citrix suivants sont définis sur 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 Cloud Gateway
  • Citrix Remote Broker Provider
  • Citrix Remote HCL Server
  • Citrix Session Manager Proxy

Pour plus d’informations sur ces services, consultez la section Services installés.

Si vous continuez à rencontrer des échecs de connectivité, utilisez l’utilitaire Cloud Connector Connectivity Check Utility disponible dans le centre de connaissances du support Citrix. Pour plus d’informations, consultez CTX260337 sur le site Web du centre de connaissances.

L’outil peut être utilisé pour effectuer les tâches suivantes :

  • Tester si Citrix Cloud et ses services associés sont accessibles
  • Vérifier les paramètres dont la configuration est souvent incorrecte
  • Configurer les paramètres de proxy sur Citrix Cloud Connector

Pour plus d’informations sur la façon de résoudre un échec de vérification de connectivité, consultez l’article CTX224133 : Cloud Connector Connectivity Check Failed.

Installation de Cloud Connector