Installation de Cloud Connector

Vous pouvez installer le logiciel Cloud Connector de manière interactive ou à l’aide de l’installation silencieuse ou automatisée.

Lors de l’installation, le Cloud Connector requiert l’accès au cloud pour authentifier l’utilisateur effectuant l’installation, valider les autorisations du programme d’installation et télécharger et configurer les services fournis par le Cloud Connector. L’installation s’effectue avec les privilèges de l’utilisateur qui lance l’installation.

Exigences

  • Assurez-vous que chaque machine sur laquelle vous installez le Cloud Connector répond à la configuration système requise décrite dans Détails techniques sur Citrix Cloud Connector.
  • Assurez-vous que les machines sur lesquelles vous allez installer le Cloud Connector remplissent les Exigences en terme de connexion Internet.
  • Si vous installez le Cloud Connector dans un environnement doté d’un proxy Web ou de règles de pare-feu strictes, consultez la section Configuration du pare-feu et du proxy d’un Cloud Connector pour prendre connaissance des exigences avant de poursuivre l’installation.
  • Vous pouvez uniquement installer le Cloud Connector sur une machine appartenant au domaine. Si la machine n’appartient pas à un domaine, le programme d’installation du Cloud Connector empêche l’installation.
  • Le Cloud Connector doit pouvoir accéder aux contrôleurs de domaine parent (racine) ainsi qu’aux contrôleurs de domaine enfant de l’infrastructure Active Directory (pour compléter les workflows Active Directory) dans lesquels le Cloud Connector est installé. Pour plus d’informations, consultez les articles de support de Microsoft suivants :
  • La machine sur laquelle vous installez le Cloud Connector doit être synchronisée avec l’heure UTC.
  • 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.
  • Désactivez la configuration de sécurité renforcée d’Internet Explorer (IE ESC). Si cette configuration est activée, le Cloud Connector ne pourra pas se connecter à Citrix Cloud.
  • Assurez-vous que FIPS n’est pas activé sur la machine sur laquelle vous installez le Cloud Connector. Le Cloud Connector n’est pas pris en charge sur les machines compatibles FIPS. Si vous tentez d’installer le Cloud Connector sur une machine compatible FIPS, l’installation échoue.

Remarques importantes

  • Conservez tous les Cloud Connector sous tension à tout moment pour garantir une connexion permanente à Citrix Cloud.
  • 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 faisant partie 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.
  • Citrix recommande vivement d’activer Windows Update sur toutes les machines hébergeant le Cloud Connector. Lors de la configuration de Windows Update, téléchargez et installez automatiquement les mises à jour, mais n’autorisez pas les redémarrages automatiques. La plate-forme Citrix Cloud se charge des redémarrages, et ne les autorise que pour un seul Cloud Connector à la fois, au besoin. Vous pouvez également contrôler quand la machine est redémarrée après une mise à jour à l’aide de la stratégie de groupe. Pour plus d’informations, voir https://docs.microsoft.com/en-us/windows/deployment/update/waas-restart.
  • Citrix recommande l’installation d’au moins deux (2) Cloud Connector dans chaque emplacement de ressources. En règle générale, le nombre de Cloud Connector que vous devez installer est de N+1, où N est la capacité nécessaire pour prendre en charge l’infrastructure dans votre emplacement de ressources. Ceci garantit la continuité de la connexion entre Citrix Cloud et votre emplacement de ressources au cas où un Cloud Connector devient indisponible.
  • Chaque forêt Active Directory que vous prévoyez d’utiliser avec Citrix Cloud doit être accessible par deux Cloud Connector à tout moment.
  • Après l’installation, ne déplacez pas la machine qui héberge le Cloud Connector dans un autre domaine. Si la machine doit être jointe à un autre domaine, désinstallez le Cloud Connector et réinstallez-le une fois que la machine est jointe à l’autre domaine.

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 pris 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 ou Windows Server 2016 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. Lancez le programme d’installation de Cloud Connector. 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 les étapes 1 à 4 sur les autres machines que vous voulez 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 (non interactif)

L’installation silencieuse ou automatisée est prise en charge. Toutefois, il n’est pas recommandé d’utiliser le même programme d’installation pour des installations répétées sur une période donnée. 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 les codes d’erreur potentiels en cas de défaillance. Cette opération peut être effectuée à l’aide du 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. Pour récupérer l’ID, cliquez sur le bouton d’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\*

Codes de sortie

  • 1603 - An unexpected error occured (Une erreur inattendue s’est produite).
  • 2 - A prerequiste check failed (Échec de vérification des conditions requises).
  • 0 - Installation completed successfully (Installation terminée avec succès).

Journaux d’installation

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

En outre, les journaux sont ajoutés à %ProgramData%\Citrix\WorkspaceCloud\InstallLogs après l’installation.