Horizon 容器 - 在连接服务器上安装 Universal Broker 插件

要使某个 Horizon 容器能够参与由 Universal Broker 代理的多云分配，必须在该容器中的每个连接服务器实例上安装所需的 Universal Broker 插件。Universal Broker 插件支持代理服务与容器中的连接服务器实例之间的通信。

注意： 只有基于 Horizon Connection Server 技术的 Horizon 容器才需要安装 Universal Broker 插件。Microsoft Azure 中的 Horizon Cloud 容器不需要 Universal Broker 插件。

安装 Universal Broker 插件时，请注意以下事项：

• 您必须运行与连接服务器版本兼容的 Universal Broker 插件安装程序 EXE 版本，因为每个安装程序 EXE 内的代码都包含一个标记，用于确定安装程序 EXE 是否将在特定版本的连接服务器上运行。

  有关 Horizon YYMM 版本控制与数字样式版本控制之间的关系，请参阅 知识库文章 2143853。

  • 各个 Connection Server 版本的 Universal Broker 插件安装程序版本及其在 Customer Connect 中的下载位置

    Universal Broker 插件安装程序从 Customer Connect 下载。下表中的每个 URL 都会将您转到下载页面，其中 Universal Broker 插件位于该页面底部。

    在浏览器中加载其中一个 URL 时，滚动到底部以查看 Universal Broker 插件条目及其版本号。单击 “立即下载 ”按钮可下载该版本。单击 立即下载时，如果您尚未使用 Customer Connect 凭据登录，将首先显示登录 UI。

    当连接服务器运行以下版本时：	此 Universal Broker 插件安装程序 EXE 将在该连接服务器上运行：	Customer Connect 中的位置 - 滚动到下载页面底部以查看 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 - 与 2206 （8.6） 相同	版本 22.01 及更低版本不再公开提供下载。要获取 22.01 及更低版本，具有有效支持协议的客户可以联系 Omnissa 支持部门。
    2312 (8.12)	22.01 - 与 2206 （8.6） 相同
    2309 (8.11)	22.01 - 与 2206 （8.6） 相同
    2306 (8.10)	22.01 - 与 2206 （8.6） 相同
    2303 (8.9)	22.01 - 与 2206 （8.6） 相同
    2212 (8.8)	22.01 - 与 2206 （8.6） 相同
    2209 (8.7)	22.01 - 与 2206 （8.6） 相同
    2206 (8.6)	22.01
    2111 (8.4)	21.06
    2106 (8.3)	21.06 - 与 2111 （8.4） 相同
    2103 (8.2)	21.03
    2012 (8.1)	21.01

• 如果容器具有多个连接服务器实例，则必须在每个连接服务器实例上安装 Universal Broker 插件。

• 您必须在参与容器内的所有连接服务器实例上安装相同版本的插件。例如，如果在某个连接服务器实例上将该插件升级到更高版本，则还必须在容器内的每个其他连接服务器实例上将该插件升级到这一版本。

• 如果将新的连接服务器实例添加到参与容器中，则必须在新的连接服务器实例上安装该插件。

• 在连接服务器升级过程中，任何现有的插件安装都会丢失。如果要升级 Horizon 部署，则必须在将每个连接服务器实例升级到更高版本后立即重新安装该插件。

  例如，如果将连接服务器实例升级到版本 8.2 （2103），则必须在这些连接服务器实例上安装该插件的版本 21.03。

• 在插件安装过程中，安装程序会重新启动连接服务器服务。此时，系统会注销连接服务器上的所有管理控制台会话。

• 目前，Universal Broker 插件仅支持 IPv4。

• 在安装了 Universal Broker 插件的连接服务器实例中使用 LDAP 配置时，请遵循以下准则：

  • 除了创建 LDAP 配置的备份副本外，还要为当前连接服务器实例创建虚拟机快照。如果使用备份将 LDAP 配置还原到之前的状态，则可以使用快照在还原的 LDAP 配置中填充 Universal Broker 插件正常运行所需的信息。
  • 将 LDAP 配置还原到之前的状态时，仅使用在连接服务器上安装插件后创建的 LDAP 备份。
  • 如果将 LDAP 配置还原到在安装 Universal Broker 插件之前的状态，则还原的 LDAP 配置中将会缺失插件所需的某些信息。插件将因此无法正常运行。

下载适用于您的连接服务器版本的 Universal Broker 插件的正确版本后，请使用以下过程在您容器中的连接服务器实例上安装该插件。

正在安装

• 要在批量连接服务器实例部署上以静默方式安装 Universal Broker 插件，请使用以下命令。将 X.X.X 替换为版本号，将 yyyyyyyy 替换为您下载的安装程序的内部版本号。替换 <端口号> 与插件用于侦听和接受来自 Universal Broker 客户端的入站请求的 TCP 端口结合使用。

  horizon-universal-broker-plugin-X.X.X-yyyyyyyy-x64.exe /s /v"LISTENPORT=<portNumber> /qn"
  

• 要在单个连接服务器实例上安装 Universal Broker 插件，请按顺序依次执行本主题后面部分中所述的步骤。

必备条件

在连接服务器实例上运行 Universal Broker 插件安装程序之前，请确认：

• 连接服务器实例运行的是受支持的 Horizon 8 版本。
• 您在连接服务器上同时具有 Horizon 管理员特权和本地管理员特权。仅当由具有这两种特权的管理员启动时，安装程序才会运行。
• 您具有兼容的 Universal Broker 插件安装程序版本，以运行 Universal Broker 插件并将其安装到特定的连接服务器版本中，如本页前面所述。

步骤

1. 如果需要，请将下载的插件安装程序文件放在连接服务器上。

2. .exe运行安装程序文件。

3. 在安装程序向导的“欢迎使用”屏幕上，单击 下一步。

4. 接受最终用户许可协议，然后单击 下一步。

5. 在“配置”屏幕上，指定所需的端口信息。

   1. 输入 Universal Broker 插件用于侦听和接受来自 Universal Broker 客户端的入站请求的 TCP 端口号。

      注意： 安装程序将验证指定的端口是否可用。如果端口上已有正在运行的进程，则会显示一条警告消息并停止安装。要继续安装，必须指定可用的 TCP 端口。

   2. 如果希望安装程序配置允许入站连接通过指定端口所需的防火墙例外，请选择 自动配置 Windows 防火墙例外 。如果要手动配置防火墙例外，请取消选择此选项。

      注意： 对于 Universal Broker，必须配置此 Windows 防火墙例外，您可以指示安装程序配置该例外，也可以自行配置。

   3. 单击下一步。

6. 按照向导中其余屏幕上的提示操作，以在连接服务器上完成 Universal Broker 插件的安装。

正在卸载

重要提示： 如果您以后要卸载 Universal Broker 插件或连接服务器实例，请按照以下顺序进行卸载：

1. 首先，卸载 Universal Broker 插件。
2. 接下来，卸载连接服务器软件。

如果先卸载连接服务器，则会出现系统错误，并且您将无法卸载 Universal Broker 插件。

注意： 如果要更改 Universal Broker 插件用来侦听来自 Universal Broker 客户端的入站请求的端口，请执行以下操作：

1. 在连接服务器的 LDAP 配置中，将 属性的值 pae-RCXServerPort 更改为新的端口号。
2. 重新启动连接服务器。
3. 如果需要，请更新相应的 Windows 防火墙例外，以允许通过新端口的入站流量。

新端口配置将在连接服务器和 Universal Broker 插件完成其重新启动序列后生效。

升级已安装 Universal Broker 插件的 Horizon Connection Server 时

如果您的 Horizon Connection Server 运行的版本低于 版本 2412，并且 Horizon Connection Server 已安装 24.12 之前的 Universal Broker 插件版本，并且您希望将该 Horizon Connection Server 升级到版本 2412 或更高版本，则必须在该 Horizon Connection Server 上按照以下顺序安装 Horizon Universal Broker 插件 24.12 或更高版本：

1. 卸载现有安装的 Horizon Universal Broker 插件。
2. 将 Horizon Connection Server 升级到 2412 或更高版本。
3. 然后，安装最新的 Horizon Universal Broker 插件（版本 24.12 或更高版本）。

注意： 您只需在将 Horizon Connection Server 升级到版本 2412 或更高版本时，才需要升级 Universal Broker 插件。如果运行的 Horizon Connection Server 版本低于 2412，并且 Horizon Connection Server 中已安装低于 24.12 版本的 Universal Broker 插件，则低于 24.12 版本的现有兼容 Horizon Universal Broker 插件将继续正常工作。