Avant qu'un espace Horizon puisse faire partie d'attributions multicloud réparties par Universal Broker, vous devez installer le plug-in Universal Broker requis sur chaque instance du Serveur de connexion dans cet espace. Le plug-in Universal Broker prend en charge la communication entre le service d'intermédiation et les instances du Serveur de connexion dans un espace.
Lors de l'installation du plug-in Universal Broker, tenez compte des considérations suivantes :
- Vous devez exécuter une version du fichier EXE du programme d'installation du plug-in Universal Broker compatible avec votre version du Serveur de connexion, car le code dans chaque fichier EXE du programme d'installation contient un indicateur qui détermine si le fichier EXE du programme d'installation s'exécutera sur une version particulière du Serveur de connexion.
Pour en savoir plus sur la relation entre le contrôle de version YYMM d'Horizon et le contrôle de version de style numérique, reportez-vous à l'article 2143853 de la base de connaissances.
- Versions du programme d'installation du plug-in Universal Broker pour les versions du Serveur de connexion et leurs emplacements de téléchargement dans VMware Customer Connect
-
Les programmes d'installation du
plug-in Universal Broker sont téléchargés depuis
VMware Customer Connect. Chaque URL du tableau ci-dessous vous dirige vers une page de téléchargement sur laquelle se trouve le
plug-in Universal Broker en bas de cette page.
Lorsque vous chargez l'une de ces URL dans votre navigateur, faites défiler l'écran jusqu'en bas pour consulter l'entrée Plug-in Universal Broker et son numéro de version. Cliquez sur le bouton Télécharger maintenant pour télécharger cette version. Lorsque vous cliquez sur Télécharger maintenant, si vous n'êtes pas déjà connecté à l'aide de vos informations d'identification de VMware Customer Connect, l'interface utilisateur de connexion s'affiche en premier.
- Si un espace dispose de plusieurs instances du Serveur de connexion, vous devez installer le plug-in Universal Broker sur chacune de ces instances.
- Vous devez installer la même version du plug-in sur toutes les instances du Serveur de connexion dans les espaces participants. Par exemple, si vous mettez à niveau le plug-in vers une version ultérieure sur une instance du Serveur de connexion, vous devez mettre à niveau le plug-in vers cette même version sur toutes les autres instances du Serveur de connexion de l'espace.
- Si vous ajoutez une instance du Serveur de connexion à un espace participant, vous devez installer le plug-in sur la nouvelle instance du Serveur de connexion.
- Toute installation de plug-in existante est perdue lors d'une mise à niveau du Serveur de connexion. Si vous mettez à niveau votre déploiement d'Horizon, vous devez réinstaller le plug-in immédiatement après la mise à niveau de chaque instance du Serveur de connexion vers la version ultérieure.
Par exemple, si vous mettez à niveau vos instances du Serveur de connexion vers la version 8.2 (2103), vous devez installer la version 21.03 du plug-in sur ces instances du Serveur de connexion.
- Lors de l'installation du plug-in, le programme d'installation redémarre le service Serveur de connexion. À ce stade, le système déconnecte toutes les sessions de la console d'administration sur le Serveur de connexion.
- Actuellement, le plug-in Universal Broker prend uniquement en charge IPv4.
- Lorsque vous utilisez la configuration LDAP dans une instance du Serveur de connexion sur laquelle le plug-in Universal Broker est installé, tenez compte des directives suivantes :
- Outre la création d'une copie de sauvegarde de la configuration LDAP, prenez un snapshot de la machine virtuelle de l'instance actuelle du Serveur de connexion. Si vous utilisez la sauvegarde pour rétablir l'état antérieur de la configuration LDAP, vous pouvez utiliser le snapshot pour renseigner la configuration LDAP restaurée avec les informations requises par le plug-in Universal Broker pour fonctionner.
- Lors du rétablissement d'un état antérieur de la configuration LDAP, n'utilisez que les sauvegardes LDAP effectuées après l'installation du plug-in sur le Serveur de connexion.
- Si vous rétablissez l'état de la configuration LDAP antérieur à l'installation du plug-in Universal Broker, certaines informations requises par le plug-in seront manquantes dans la configuration LDAP restaurée. Par conséquent, le plug-in ne fonctionnera pas.
Après le téléchargement de la version appropriée du plug-in Universal Broker pour votre version du Serveur de connexion, utilisez les procédures suivantes pour installer le plug-in sur les instances du Serveur de connexion dans votre espace.
- Pour installer le plug-in Universal Broker en mode silencieux sur un déploiement en bloc d'instances du Serveur de connexion, utilisez la commande suivante. Remplacez X.X.X par le numéro de version et yyyyyyyy par le numéro de build du programme d'installation que vous avez téléchargé. Remplacez <portNumber> par le port TCP que le plug-in utilise pour écouter et accepter les demandes entrantes du client Universal Broker.
horizon-universal-broker-plugin-X.X.X-yyyyyyyy-x64.exe /s /v"LISTENPORT=<portNumber> /qn"
- Pour installer le plug-in Universal Broker sur une instance individuelle du Serveur de connexion, suivez les étapes numérotées décrites plus loin dans cette rubrique.
Conditions préalables
Avant d'exécuter le programme d'installation du plug-in Universal Broker sur une instance du Serveur de connexion, vérifiez les points suivants :
- L'instance du serveur de connexion exécute la version 7.11 ou une version ultérieure.
- Vous disposez à la fois de privilèges d'administrateur Horizon et d'administrateur local sur le Serveur de connexion. Le programme d'installation s'exécute uniquement lorsqu'il est lancé par un administrateur disposant de ces deux privilèges.
- Vous disposez d'une version du programme d'installation du plug-in Universal Broker compatible pour exécuter et installer le plug-in Universal Broker dans votre version spécifique du Serveur de connexion comme décrit précédemment sur cette page.
Procédure
- Si nécessaire, placez le fichier du programme d'installation du plug-in téléchargé sur le Serveur de connexion.
- Exécutez le fichier .exe du programme d'installation.
- Dans l'écran d'accueil de l'assistant d'installation, cliquez sur Suivant.
- Acceptez le contrat de licence utilisateur final et cliquez sur Suivant.
- Dans l'écran Configuration, indiquez les informations de port requises.
- Entrez le numéro de port TCP que le plug-in Universal Broker utilise pour écouter et accepter les demandes entrantes du client Universal Broker.
Note : Le programme d'installation confirme que le port spécifié est disponible. Si un processus est déjà en cours d'exécution sur le port, un message d'avertissement s'affiche et l'installation est arrêtée. Pour reprendre l'installation, vous devez indiquer un port TCP disponible.
- Sélectionnez Configurer automatiquement l'exception de pare-feu Windows si vous souhaitez que le programme d'installation configure l'exception de pare-feu requise pour autoriser les connexions entrantes via le port indiqué. Désélectionnez cette option si vous souhaitez configurer manuellement l'exception de pare-feu.
Note : L'exception de pare-feu Windows est obligatoire pour Universal Broker, que vous demandiez au programme d'installation de le configurer ou que vous le configuriez vous-même.
- Cliquez sur Suivant.
- Entrez le numéro de port TCP que le plug-in Universal Broker utilise pour écouter et accepter les demandes entrantes du client Universal Broker.
- Suivez les invites des écrans restants de l'assistant pour terminer l'installation du plug-in Universal Broker sur le Serveur de connexion.
Que faire ensuite
- Tout d'abord, désinstallez le plug-in Universal Broker.
- Ensuite, désinstallez le logiciel du Serveur de connexion.
Si vous désinstallez d'abord le Serveur de connexion, cela produit une erreur système et vous ne pourrez pas désinstaller le plug-in Universal Broker.
- Dans la configuration LDAP du Serveur de connexion, remplacez la valeur de la propriété
pae-RCXServerPort
par le nouveau numéro de port. - Redémarrez le Serveur de connexion.
- Si nécessaire, mettez à jour l'exception de pare-feu Windows correspondante pour autoriser le trafic entrant via le nouveau port.
La nouvelle configuration de port prend effet après que le Serveur de connexion et le plug-in Universal Broker terminent leurs séquences de redémarrage.