Espaces Horizon - Installer le plug-in Universal Broker sur le Serveur de connexion

Avant qu'un espace Horizon puisse faire partie d'attributions multicloud intermédiées 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.

Remarque : l'installation du plug-in Universal Broker n'est requise que pour les espaces Horizon basés sur la technologie d'Horizon Connection Server. Les espaces Horizon Cloud dans Microsoft Azure ne nécessitent pas le plug-in Universal Broker.

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 plus d'informations sur la relation entre le contrôle de version AAMM d'Horizon et le contrôle de version de style numérique, reportez-vous à l'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 Customer Connect

    Les programmes d'installation du plug-in Universal Broker sont téléchargés à partir de 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 vers le bas pour voir 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é avec vos informations d'identification Customer Connect, l'interface utilisateur de connexion s'affiche en premier.

    Lorsque votre Serveur de connexion exécute la version :	Le fichier EXE du programme d'installation du plug-in Universal Broker s'exécute sur ce Serveur de connexion :	Emplacement dans Customer Connect : faites défiler l'écran jusqu'au bas de la page des téléchargements pour afficher le plug-in Universal Broker
    2503 (8.15)	24.12	https://customerconnect.omnissa.com/downloads/details?downloadGroup=HCS-CC-250&productId=1585&rPId=118981
    2412 (8.14)	24.12	https://customerconnect.omnissa.com/downloads/details?downloadGroup=HCS-CC-250&productId=1585&rPId=118981
    2406 (8.13)	22.01 - identique à 2206 (8.6)	Les versions 22.01 et antérieures ne sont généralement plus disponibles au téléchargement. Pour obtenir 22.01 et versions antérieures, les clients disposant de contrats de support actifs peuvent contacter le support Omnissa.
    2312 (8.12)	22.01 - identique à 2206 (8.6)
    2309 (8.11)	22.01 - identique à 2206 (8.6)
    2306 (8.10)	22.01 - identique à 2206 (8.6)
    2303 (8.9)	22.01 - identique à 2206 (8.6)
    2212 (8.8)	22.01 - identique à 2206 (8.6)
    2209 (8.7)	22.01 - identique à 2206 (8.6)
    2206 (8.6)	22.01
    2111 (8.4)	21.06
    2106 (8.3)	21.06 - identique à 2111 (8.4)
    2103 (8.2)	21.03
    2012 (8.1)	21.01

• 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 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 de l'état antérieur de la configuration LDAP, utilisez uniquement 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 avoir téléchargé 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.

Installation

• 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é. Remplacer avec 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 une version prise en charge d'Horizon 8.
• 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

1. Si nécessaire, placez le fichier du programme d'installation du plug-in téléchargé sur le Serveur de connexion.

2. Exécutez le fichier du programme d'installation .exe .

3. Sur l'écran d'accueil de l'assistant du programme d'installation, cliquez sur Suivant.

4. Acceptez le contrat de licence utilisateur final et cliquez sur Suivant.

5. Dans l'écran Configuration, spécifiez les informations de port requises.

   1. Entrez le numéro de port TCP que le plug-in Universal Broker utilisera pour écouter et accepter les demandes entrantes du client Universal Broker.

      Remarque : 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 spécifier un port TCP disponible.

   2. 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 spécifié. Désélectionnez cette option si vous souhaitez configurer manuellement l'exception de pare-feu.

      Remarque : 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.

   3. Cliquez sur Suivant.

6. Suivez les invites des écrans restants de l'assistant pour terminer l'installation du plug-in Universal Broker sur le Serveur de connexion.

Désinstallation

À noter : Si, ultérieurement, vous souhaitez désinstaller le plug-in Universal Broker ou l'instance du Serveur de connexion, suivez cet ordre de désinstallation :

1. Tout d'abord, désinstallez le plug-in Universal Broker.
2. Ensuite, désinstallez le logiciel Serveur de connexion.

Si vous désinstallez d'abord le Serveur de connexion, une erreur système se produit et vous ne pourrez pas désinstaller le plug-in Universal Broker.

Remarque : Si vous souhaitez modifier le port que le plug-in Universal Broker utilise pour écouter les demandes entrantes du client Universal Broker, procédez comme suit :

1. Dans la configuration LDAP du Serveur de connexion, remplacez la valeur de la pae-RCXServerPort propriété par le nouveau numéro de port.
2. Redémarrez le Serveur de connexion.
3. 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.

Lors de la mise à niveau d'une instance d'Horizon Connection Server sur laquelle le plug-in Universal Broker est déjà installé

Lorsqu'une instance d'Horizon Connection Server exécute une version d'antérieure à la version 2412, qu'une version antérieure à la version 24.12 du plug-in Universal Broker est installée sur cette instance d'Horizon Connection Server et qu'elle est installée et que vous souhaitez la mettre à niveau vers la version 2412 ou une version ultérieure, vous devez respecter cette séquence sur cette instance d'Horizon Connection Server pour installer le plug-in Horizon Universal Broker 24.12 ou version ultérieure :

1. Désinstallez le plug-in Horizon Universal Broker existant.
2. Mettez à niveau Horizon Connection Server vers 2412 ou version ultérieure.
3. Installez ensuite le dernier plug-in Horizon Universal Broker (version 24.12 ou ultérieure).

Remarque : Vous devez uniquement mettre à niveau le plug-in Universal Broker lorsque vous mettez à niveau votre Horizon Connection Server vers la version 2412 ou ultérieure. Si vous exécutez Horizon Connection Server de versions antérieures à la version 2412 et qu'un plug-in Universal Broker antérieur à la version 24.12 est déjà installé sur l'Horizon Connection Server, votre plug-in Horizon Universal Broker compatible existant de version antérieure à 24.12 continuera de fonctionner.