Citrix Cloud

Installation de Cloud Connector

Vous pouvez installer le logiciel Cloud Connector de manière interactive ou à l’aide de 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 mettez pas à niveau les différents composants du Cloud Connector séparément.
  • 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 sur site).
  • 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.
  • Si vous utilisez le programme d’installation graphique, un navigateur doit être installé et le navigateur système par défaut doit être configuré.

Conseils après le déploiement

Une fois l’installation effectuée, conservez tous les Cloud Connector sous tension à tout moment pour garantir une connexion permanente à Citrix Cloud.

Renommer des 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, procédez comme suit :

  1. Supprimez la machine de l’emplacement des ressources :
    1. Dans le menu Citrix Cloud, sélectionnez Emplacements des ressources.
    2. Localisez l’emplacement de ressources que vous souhaitez gérer et sélectionnez la tuile Cloud Connector.
    3. Localisez la machine que vous souhaitez gérer, puis cliquez sur le menu des points de suspension. Sélectionnez Retirer connecteur.
  2. Désinstallez le logiciel Cloud Connector.
  3. Renommez la machine.
  4. 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 qui héberge le Cloud Connector dans un autre domaine. Si vous devez ultérieurement associer la machine à un autre domaine, procédez comme suit :

  1. Supprimez la machine de l’emplacement des ressources.
  2. Désinstallez le logiciel Cloud Connector.
  3. Dissociez la machine de son domaine actuel et joignez la machine au nouveau domaine.
  4. Installez la dernière version du logiciel Cloud Connector, comme décrit dans cet article.

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.

Considérations relatives aux services

Les étapes d’installation décrites dans cet article décrivent le processus de déploiement des Cloud Connector, quel que soit le service pour lequel ils sont utilisés.

Lorsque vous déployez des Cloud Connector pour Citrix DaaS, vérifiez que les domaines AD dans lesquels résident les connecteurs sont actifs et ne sont pas affichés comme « inutilisés » dans la console Citrix Cloud. Si vous spécifiez un domaine inutilisé lors de la création 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 du produit Citrix DaaS.

Pour des considérations supplémentaires sur d’autres services, consultez la documentation du service en question.

Emplacement de ressources par défaut

Si vous n’avez aucun emplacement de ressources dans votre compte Citrix Cloud et que vous installez des Cloud Connector 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 Connector dans d’autres domaines.

Vous pouvez également créer les emplacements de ressources dont vous avez besoin dans la console, avant d’installer les Cloud Connector dans vos domaines. Le programme d’installation de Cloud Connector vous invite à sélectionner l’emplacement de ressources que vous souhaitez lors de l’installation.

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 des ressources, consultez la section 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

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. (Facultatif) Si nécessaire, cliquez sur Configurer le proxy pour ajouter un serveur proxy. Vous êtes invité à ajouter les informations du proxy.
  3. Cliquez sur Se connecter et installer pour vous connecter à Citrix Cloud.
  4. 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.
  5. 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 de plus amples informations, consultez la section Gestion des identités et des accès.

Activer les domaines inutilisés

Si vous créez des emplacements de ressources et déployez des Cloud Connector 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 création 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 du produit Citrix DaaS.

Créer des emplacements de ressources supplémentaires

  1. Dans la console de gestion Citrix Cloud, cliquez sur le bouton de menu et sélectionnez Emplacements des ressources.
  2. Cliquez sur + Emplacement des ressources et saisissez un nom significatif.
  3. Cliquez sur Enregistrer. Citrix Cloud affiche une vignette pour le nouvel emplacement des ressources.
  4. Cliquez sur Cloud Connector, puis sur Télécharger pour acquérir le logiciel Cloud Connector.
  5. Sur chaque machine préparée, installez le logiciel Cloud Connector à l’aide de l’assistant d’installation ou de l’installation par 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 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"
}
<!--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 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 CloudGateway
  • 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 Citrix. Pour plus d’informations, consultez l’article 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