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

Page Emplacements des ressources avec le guide d'installation de Cloud Connector

Pour créer votre premier emplacement de ressources

  1. Ouvrez une session en tant qu’administrateur sur la machine sur laquelle vous allez installer le Cloud Connector. Windows Server 2012 R2, Windows Server 2016 ou Windows Server 2019 doit être installé sur la machine ; elle doit être jointe à un domaine et avoir un accès sortant à Internet.
  2. Visitez https://citrix.cloud.com et connectez-vous avec les informations d’identification que vous avez reçues dans l’e-mail de Citrix Cloud. La console de gestion Citrix Cloud s’affiche.
  3. À partir du bouton de menu dans le coin supérieur gauche, sélectionnez Emplacements des ressources.
  4. Sur la page Emplacements des ressources, cliquez sur Télécharger pour télécharger le logiciel Cloud Connector.
  5. Cliquez avec le bouton droit sur le programme d’installation de Cloud Connector, 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.
  6. Connectez-vous à Citrix Cloud lorsque vous y êtes invité.
  7. Suivez l’assistant pour installer et configurer le Cloud Connector. Une fois l’installation terminée, le programme d’installation vérifie une dernière fois la connectivité pour vérifier la communication du connecteur avec le cloud.
  8. Répétez ces étapes sur les autres machines que vous souhaitez utiliser en tant que Cloud Connector.

Après l’installation, Citrix Cloud enregistre votre domaine dans Gestion des identités et des accès. Pour de plus amples informations, consultez la section 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.

Utilisez Start /Wait CWCConnector.exe /parameter: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.

Paramètres pris en charge

Vous pouvez récupérer une liste des paramètres pris en charge en exécutant CWCConnector /?.

  • /Customer: requis. 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: requis. ID de client sécurisé qu’un administrateur peut créer, situé sur la page Accès aux API
  • /ClientSecret: requis. 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: requis. Identificateur unique d’un emplacement de ressources existant. Sélectionnez le bouton 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: requis. La valeur par défaut est Yes.

Exemple de ligne de commande avec tous les paramètres requis :

CWCConnector.exe /q /Customer:\*Customer\*  /ClientId:\*ClientId\*  /ClientSecret:\*ClientSecret\*  /ResourceLocationId:\*ResourceLocationId\*  /AcceptTermsOfService:\*true\*

Résolution des problèmes

Tests de connectivité

Vous pouvez tenter de diagnostiquer et de résoudre les problèmes rencontrés lors de l’installation à l’aide de l’utilitaire Cloud Connector Connectivity Check. L’utilitaire peut être utilisé pour :

  • Tester si Citrix Cloud et ses services associés sont accessibles
  • Configurer les paramètres de proxy sur le Cloud Connector

Erreur d’installation

Si vous installez le logiciel 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 Cloud Connector. Pour éviter cette erreur, exécutez le logiciel 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.

Journaux d’installation

Les journaux d’installation se trouvent dans %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup.

Les journaux sont ajoutés à %ProgramData%\Citrix\WorkspaceCloud\InstallLogs après l’installation.

Codes de sortie

  • 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)
Installation de Cloud Connector