Pods do Horizon - Instalar o plug-in do Universal Broker no Servidor de Conexão

Antes que um pod do Horizon possa participar de atribuições de várias nuvens intermediadas pelo Universal Broker, você deve instalar o plug-in do Universal Broker necessário em cada instância do Servidor de Conexão nesse pod. O plug-in do Universal Broker suporta a comunicação entre o serviço de intermediação e as instâncias do Servidor de Conexão em um pod.

Observação: A instalação do plug-in do Universal Broker só é necessária para pods do Horizon com base na tecnologia do Horizon Connection Server. Horizon Cloud pods no Microsoft Azure não exigem o plug-in Universal Broker.

Ao instalar o plug-in Universal Broker, tenha em mente as seguintes considerações:

• Você deve executar uma versão do EXE do instalador do plug-in Universal Broker compatível com a versão do Servidor de conexão, pois o código dentro de cada EXE do instalador contém um sinalizador que determina se o EXE do instalador será executado em uma determinada versão do Servidor de conexão.

  Para a relação entre o versão YYMM do Horizon e o controle de versão do estilo numérico, consulte KB 2143853.

  • Universal Broker versões do instalador do plug-in para versões do Servidor de Conexão e seus locais de download no Customer Connect

    Os instaladores do plug-in do Universal Broker são baixados do Customer Connect. Cada URL na tabela abaixo leva você a uma página de download na qual o plug-in Universal Broker reside na parte inferior dessa página.

    Ao carregar uma dessas URLs no navegador, role até a parte inferior para ver a entrada Universal Broker Plugin e seu número de versão. Clique no botão Download Agora para baixar essa versão. Ao clicar em Baixar Agora, se ainda não estiver conectado com suas credenciais do Customer Connect, a interface do usuário de login será exibida primeiro.

    Quando o Servidor de Conexão está executando a versão:	Este EXE do instalador do plug-in Universal Broker será executado nesse Servidor de Conexão:	Localização no Customer Connect: role até a parte inferior da página de downloads para ver o plug-in do 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: igual ao da versão 2206 (8.6)	As versões 22.01 e anteriores não estão mais disponíveis para download. Para obter o 22.01 e versões anteriores, os clientes com contratos de suporte ativos podem entrar em contato com o Suporte da Workspace ONE.
    2312 (8.12)	22.01: igual ao da versão 2206 (8.6)
    2309 (8.11)	22.01: igual ao da versão 2206 (8.6)
    2306 (8.10)	22.01: igual ao da versão 2206 (8.6)
    2303 (8.9)	22.01: igual ao da versão 2206 (8.6)
    2212 (8.8)	22.01: igual ao da versão 2206 (8.6)
    2209 (8.7)	22.01: igual ao da versão 2206 (8.6)
    2206 (8.6)	22.01
    2111 (8.4)	21.06
    2106 (8.3)	21.06: igual ao da versão 2111 (8.4)
    2103 (8.2)	21.03
    2012 (8.1)	21.01

• Se um pod tiver várias instâncias do Servidor de Conexão, você deverá instalar o Universal Broker Plug-in em cada instância do Servidor de Conexão.

• Você deve instalar a mesma versão do plug-in em todas as instâncias do Servidor de Conexão nos pods participantes. Por exemplo, se você atualizar o plug-in para uma versão posterior em uma instância do Servidor de Conexão, deverá atualizar o plug-in para essa mesma versão em todas as outras instâncias do Servidor de Conexão no pod.

• Se você adicionar uma nova instância do Servidor de conexão a um pod participante, deverá instalar o plug-in na nova instância do Servidor de conexão.

• Qualquer instalação de plug-in existente é perdida durante o upgrade de um Servidor de Conexão. Se você fizer upgrade da implantação do Horizon, deverá reinstalar o plug-in logo após o upgrade de cada instância do Servidor de Conexão para a versão mais recente.

  Por exemplo, se você fizer upgrade das instâncias do Servidor de Conexão para a versão 8.2 (2103), deverá instalar a versão 21.03 do plug-in nessas instâncias.

• Durante a instalação do plug-in, o instalador reinicia o serviço do Servidor de Conexão. Nesse momento, o sistema faz logoff de todas as sessões do console administrativo no Servidor de Conexão.

• Atualmente, o plug-in do Universal Broker é compatível apenas com IPv4.

• Ao trabalhar com a configuração Lightweight Directory Access Protocol (LDAP) em uma instância do Servidor de conexão com o plug-in Universal Broker instalado, observe as seguintes diretrizes:

  • Além de fazer uma cópia de backup da configuração LDAP, tire um snapshot da máquina virtual da instância do Servidor de Conexão atual. Se você usar o backup para restaurar a configuração LDAP para um estado anterior, poderá usar o snapshot para preencher a configuração LDAP restaurada com as informações exigidas pelo plug-in do Universal Broker para funcionar.
  • Ao restaurar a configuração LDAP para um estado anterior, use somente backups LDAP feitos após a instalação do plug-in no Servidor de Conexão.
  • Se você restaurar a configuração LDAP para um estado anterior à instalação do plug-in do Universal Broker, determinadas informações exigidas pelo plug-in estarão ausentes na configuração LDAP restaurada. Portanto, o plug-in não funcionará.

Após o download da versão correta do plug-in do Universal Broker para seu Servidor de Conexão, siga os procedimentos abaixo para instalar o plug-in nas instâncias do Servidor de Conexão do seu pod.

Instalando

• Para instalar o plug-in do Universal Broker silenciosamente em uma implantação em massa de instâncias do Servidor de Conexão, use o seguinte comando. Substitua X.X.X pelo número da versão e yyyyyyyy pelo número da compilação do instalador do qual você fez download. Substituir com a porta TCP que o plug-in-in usa para escutar e aceitar solicitações de entrada do cliente Universal Broker.

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

• Para instalar o plug-in do Universal Broker em uma instância individual do Servidor de Conexão, execute as etapas numeradas descritas mais adiante neste tópico.

Pré-requisitos

Antes de executar o instalador do Universal Broker Plugin em uma instância do Servidor de Conexão, verifique se:

• A instância do Servidor de Conexão está executando uma versão com suporte do Horizon 8.
• Você tem privilégios de administrador do Horizon e de administrador local no Servidor de Conexão. O instalador só é executado quando iniciado por um administrador com esses dois privilégios.
• Você tem uma versão do instalador do Universal Broker Plugin compatível para executar e instalar Universal Broker plug-in em sua versão específica do Servidor de Conexão, conforme descrito anteriormente nesta página.

Procedimento

1. Se necessário, coloque o arquivo de instalação do plug-in baixado no Servidor de Conexão.

2. Execute o .exe arquivo instalador.

3. Na tela Boas-vindas do assistente de instalação, clique em Avançar.

4. Aceite o contrato de licença de usuário final e clique em Avançar.

5. Na tela Configuração, especifique as informações de porta necessárias.

   1. Insira o número da porta TCP que o plug-in do Universal Broker usará para escutar e aceitar solicitações de entrada do cliente Universal Broker.

      Observação: O instalador valida se a porta especificada está disponível. Se a porta já tiver um processo em execução, uma mensagem de aviso será exibida, e a instalação será interrompida. Para continuar a instalação, você deve especificar uma porta TCP disponível.

   2. Marque Configurar Windows exceção de firewall automaticamente se quiser que o instalador configure a exceção de firewall necessária para permitir conexões de entrada por meio da porta especificada. Desmarque essa opção se quiser configurar a exceção do firewall manualmente.

      Observação: A exceção de firewall Windows é obrigatória para Universal Broker, quer você instrua o instalador a configurá-la, quer você mesmo a configure.

   3. Clique em Avançar.

6. Siga os prompts nas telas restantes do assistente para concluir a instalação do plug-in do Universal Broker no Servidor de Conexão.

Desinstalando

Importante: Se, posteriormente, você quiser desinstalar o Universal Broker Plugin ou a instância do Servidor de Conexão, siga esta ordem de desinstalação:

1. Primeiro, desinstale o Universal Broker Plugin.
2. Em seguida, desinstale o software do Servidor de Conexão.

Se você desinstalar primeiro o Servidor de Conexão, ocorrerá um erro no sistema, e não será possível desinstalar o Universal Broker Plugin.

Observação: Se você quiser alterar a porta que o plug-in do Universal Broker usa para escutar solicitações de entrada do cliente Universal Broker, faça o seguinte:

1. Na configuração LDAP do Servidor de Conexão, altere o pae-RCXServerPort valor da propriedade para o novo número de porta.
2. Reinicie o Servidor de Conexão.
3. Se necessário, atualize a exceção de firewall do Windows correspondente para permitir o tráfego de entrada por meio da nova porta.

A nova configuração de porta entra em vigor depois que o Servidor de Conexão e o Plug-in do Universal Broker completam suas sequências de reinicialização.

Ao atualizar um Servidor de Conexão do Horizon que já tem Universal Broker plug-in instalado

Quando você tiver um Horizon Connection Server executando uma versão anterior à 2412 e esse Horizon Connection Server já tiver uma versão anterior à 24.12 do plug-in Universal Broker instalada e quiser fazer upgrade desse Horizon Connection Server para a versão 2412 ou posterior, deverá aderir a essa sequência nesse Horizon Connection Server para instalar o Horizon Universal Broker Plugin 24.12 ou posterior:

1. Desinstale o plug-in do Horizon Universal Broker instalado.
2. Faça upgrade do Servidor de Conexão do Horizon para a versão 2412 ou posterior.
3. Em seguida, instale o plug-in mais recente do Horizon Universal Broker (versão 24.12 ou posterior).

Observação: Você só precisa atualizar o plug-in do Universal Broker ao atualizar o Horizon Connection Server para a versão 2412 ou posterior. Se você estiver executando versões do Horizon Connection Server anteriores à versão 2412 e tiver um plug-in do Universal Broker pré-24.12 já instalado no Horizon Connection Server, seu plug-in do Horizon Universal Broker compatível existente com versão anterior à 24.12 continuará funcionando.