Instalar VDAs
Importante:
- Se você estiver atualizando e sua versão atual tiver o software Personal vDisk ou AppDisks instalado, consulte Remover PvD, AppDisks e hosts não compatíveis.
- Os binários distribuídos pela Citrix® agora são assinados. Binários assinados indicam que são validados por certificados gerados pela Citrix ou por certificados autênticos de terceiros.
Existem dois tipos de VDAs para máquinas Windows: VDA para SO multi-sessão e VDA para SO de sessão única. (Para obter informações sobre VDAs para máquinas Linux, consulte a documentação do Linux Virtual Delivery Agent).
Antes de iniciar uma instalação, revise Preparar para instalar e conclua todas as tarefas de preparação.
Antes de instalar os VDAs, instale os componentes principais. Você também pode criar o site antes de instalar os VDAs.
Este artigo descreve a sequência do assistente de instalação ao instalar um VDA. Equivalentes de linha de comando são fornecidos. Para obter detalhes, consulte Instalar usando a linha de comando.
Etapa 1. Baixar o software do produto e iniciar o assistente
Se você estiver usando o instalador completo do produto:
- Se você ainda não baixou o ISO do produto:
- Use suas credenciais de conta Citrix para acessar a página de download do Citrix Virtual Apps and Desktops™. Baixe o arquivo ISO do produto.
- Descompacte o arquivo. Opcionalmente, grave um DVD do arquivo ISO.
-
Use uma conta de administrador local na imagem ou máquina onde você está instalando o VDA. Insira o DVD na unidade ou monte o arquivo ISO. Se o instalador não iniciar automaticamente, clique duas vezes no aplicativo AutoSelect na unidade montada.
O assistente de instalação é iniciado.
Se você estiver usando um pacote autônomo:
- Use suas credenciais de conta Citrix para acessar a página de download do Citrix Virtual Apps and Desktops. Baixe o pacote apropriado:
-
VDAServerSetup_2402.exe: VDA para SO multi-sessão versão -
VDAWorkstationSetup_2402.exe: VDA para SO de sessão única versão -
VDAWorkstationCoreSetup_2402.exe: VDA de Serviços Principais para SO de sessão única versão
-
-
Clique com o botão direito do mouse no pacote e escolha “Executar como administrador”.
O assistente de instalação é iniciado.
Etapa 2. Escolher qual produto instalar
Clique em “Iniciar” ao lado do produto a ser instalado: Citrix Virtual Apps ou Citrix Virtual Desktops. (Se a máquina já tiver um componente Citrix Virtual Apps ou Citrix Virtual Desktops instalado, esta página não aparecerá.)
Opção de linha de comando: /xenapp para instalar o Citrix Virtual Apps. O Citrix Virtual Desktops é instalado se esta opção for omitida.
Etapa 3. Selecionar o VDA
Selecione a entrada “Virtual Delivery Agent”. O instalador sabe se está sendo executado em um SO de sessão única ou multi-sessão, portanto, oferece apenas o tipo de VDA apropriado.
Por exemplo, ao executar o instalador em uma máquina Windows Server 2019, a opção VDA para SO multi-sessão está disponível. A opção VDA para SO de sessão única não é oferecida.
Se você tentar instalar (ou atualizar para) um VDA Windows em um SO que não é compatível com esta versão do Citrix Virtual Apps and Desktops, uma mensagem o guiará para informações sobre as opções.
Etapa 4. Especificar como o VDA será usado
Na página “Ambiente”, especifique como você planeja usar o VDA, indicando se você usa esta máquina como uma imagem para provisionar mais máquinas.
A opção que você escolher afeta quais ferramentas do Citrix Provisioning™ são instaladas automaticamente (se houver) e os valores padrão na página Componentes Adicionais do instalador do VDA.
Vários MSIs (de provisionamento e outros) são instalados automaticamente quando você instala um VDA. A única maneira de evitar a instalação é com a opção /exclude em uma instalação de linha de comando.
Escolha uma das seguintes opções:
-
Criar uma imagem mestre MCS: Selecione esta opção para instalar um VDA em uma imagem de VM, se você planeja usar o Machine Creation Services™ para provisionar VMs. Esta opção instala o Machine Identity Service. Esta é a opção padrão.
Opção de linha de comando:
/mastermcsimageou/masterimage
Importante:
A mídia de instalação ou imagem ISO deve ser montada localmente. A montagem de uma imagem ISO a partir de uma unidade de rede para fins de instalação de software não é suportada.
-
Criar uma imagem mestre usando o Citrix Provisioning ou ferramentas de provisionamento de terceiros: Selecione esta opção para instalar um VDA em uma imagem de VM, se você planeja usar o Citrix Provisioning ou ferramentas de provisionamento de terceiros (como o Microsoft System Center Configuration Manager) para provisionar VMs.
Opção de linha de comando:
/masterpvsimage -
(Aparece apenas em máquinas com SO multi-sessão) Habilitar conexões intermediadas a um servidor: Selecione esta opção para instalar um VDA em uma máquina física ou virtual que não será usada como uma imagem para provisionar outras máquinas.
Opção de linha de comando:
/remotepc -
(Aparece apenas em máquinas com SO de sessão única) Habilitar Acesso Remoto ao PC: Selecione esta opção para instalar um VDA em uma máquina física para uso com o Acesso Remoto ao PC.
Opção de linha de comando:
/remotepc
Clique em “Avançar”.
Esta página não aparece:
- Se você estiver atualizando um VDA
- Se você estiver usando o instalador
VDAWorkstationCoreSetup_2308.exe,VDAServerSetup_2308.exeouVDAWorkstationSetup_2308.exe
Etapa 5. Selecionar os componentes a serem instalados e o local de instalação
Na página “Componentes principais”:
-
Local: Por padrão, os componentes são instalados em
C:\Program Files\Citrix. Este padrão é adequado para a maioria das implantações. Se você especificar um local diferente, esse local deve ter permissões deexecutepara o serviço de rede. -
Componentes: Por padrão, o aplicativo Citrix Workspace para Windows não é instalado com o VDA. Se você estiver usando o instalador
VDAWorkstationCoreSetup.exe, o aplicativo Citrix Workspace para Windows nunca é instalado, portanto, esta caixa de seleção não é exibida.
Clique em “Avançar”.
Opções de linha de comando: /installdir, /components vda,plugin para instalar o VDA e o aplicativo Citrix Workspace para Windows.
Nota:
Você pode optar por instalar, atualizar ou desinstalar o aplicativo Citrix Workspace™ durante uma instalação, atualização ou desinstalação do VDA nos seguintes cenários:
- Durante uma instalação do VDA, você pode optar por instalar o aplicativo Citrix Workspace. Por padrão, o aplicativo Citrix Workspace não é instalado durante a instalação do VDA.
- Durante uma atualização do VDA, se o aplicativo Citrix Workspace ainda não estiver instalado no VDA, você pode optar por instalar o aplicativo Citrix Workspace.
- Durante uma atualização do VDA, se a versão do aplicativo Citrix Workspace puder ser atualizada, a opção de atualizar o aplicativo Citrix Workspace será exibida.
- Durante uma desinstalação do VDA, você pode optar por não desinstalar o aplicativo Citrix Workspace. Por padrão, o aplicativo Citrix Workspace é desinstalado durante a desinstalação do VDA.
Etapa 6. Instalar componentes adicionais
A página “Componentes Adicionais” contém caixas de seleção para habilitar ou desabilitar a instalação de outros recursos e tecnologias com o VDA. Em uma instalação de linha de comando, você pode usar a opção /exclude ou /includeadditional para omitir ou incluir expressamente um ou mais componentes disponíveis:
- /includeadditional “componente”[,”componente”] …
- /exclude “componente”[,”componente”] …
A tabela a seguir indica a configuração padrão dos itens nesta página. A configuração padrão depende da opção que você selecionou na página “Ambiente”.
| Página Componentes Adicionais | Página Ambiente: “Imagem mestre com MCS” ou “Imagem mestre com Citrix Provisioning” selecionada | Página Ambiente: “Habilitar conexões intermediadas a um servidor” (para SO multi-sessão) ou “Acesso Remoto ao PC” (para SO de sessão única) selecionada |
|---|---|---|
| Personalização Citrix para App-V - VDA | Não selecionado | Não selecionado |
| Camada de Personalização do Usuário | Não selecionado | Não exibido porque não é válido para este caso de uso. |
| Gerenciamento de Perfil Citrix | Selecionado | Não selecionado |
| Plug-in WMI do Gerenciamento de Perfil Citrix | Selecionado | Não selecionado |
| Agente de Atualização do VDA Citrix | Não selecionado | Não selecionado |
| Backup e Restauração Citrix | Não selecionado | Não selecionado |
| Driver de E/S MCS Citrix | Não selecionado | Não selecionado |
| Citrix Rendezvous V2 | Não selecionado | Não selecionado |
Esta página não aparece se:
- Você estiver usando o instalador
VDAWorkstationCoreSetup.exe. Além disso, as opções de linha de comando para os componentes adicionais não são válidas com esse instalador. - Você estiver atualizando um VDA e todos os componentes adicionais já estiverem instalados. Se alguns dos componentes adicionais já estiverem instalados, a página listará apenas os componentes que não estão instalados.
Selecione ou desmarque as seguintes caixas de seleção. (Os componentes podem aparecer em uma ordem diferente no instalador.)
-
Personalização Citrix para App-V: Instale este componente se você usar aplicativos de pacotes Microsoft App-V. Para obter detalhes, consulte Implantar e entregar aplicativos App-V.
Opção de linha de comando:
/includeadditional "Citrix Personalization for App-V – VDA"para habilitar a instalação do componente,/exclude "Citrix Personalization for App-V – VDA"para impedir a instalação do componente. -
Camada de Personalização do Usuário Citrix: Instala o MSI para a camada de personalização do usuário. Para obter detalhes, consulte Camada de personalização do usuário.
Este componente aparece apenas ao instalar um VDA em uma máquina Windows 10 de sessão única.
Opção de linha de comando:
/includeadditional "User Personalization Layer"para habilitar a instalação do componente,/exclude "User Personalization Layer"para impedir a instalação do componente. -
Gerenciamento de Perfil Citrix: Este componente gerencia as configurações de personalização do usuário em perfis de usuário. Para obter detalhes, consulte Gerenciamento de Perfil.
Excluir o Gerenciamento de Perfil Citrix da instalação afeta o monitoramento e a solução de problemas de VDAs com o Citrix Director. Nas páginas “Detalhes do usuário” e “Ponto de extremidade”, o painel “Personalização” e o painel “Duração do logon” falham. Nas páginas “Painel” e “Tendências”, o painel “Duração média do logon” exibe dados apenas para máquinas que têm o Gerenciamento de Perfil instalado.
Mesmo que você esteja usando uma solução de gerenciamento de perfil de usuário de terceiros, a Citrix recomenda que você instale e execute o Serviço de Gerenciamento de Perfil Citrix. A ativação do Serviço de Gerenciamento de Perfil Citrix não é obrigatória.
Opção de linha de comando:
/includeadditional "Citrix Profile Management"para habilitar a instalação do componente,/exclude "Citrix Profile Management"para impedir a instalação do componente. -
Plug-in WMI do Gerenciamento de Perfil Citrix: Este plug-in fornece informações de tempo de execução do Gerenciamento de Perfil em objetos WMI (Windows Management Instrumentation) (por exemplo, provedor de perfil, tipo de perfil, tamanho e uso do disco). Os objetos WMI fornecem informações de sessão ao Director.
Opção de linha de comando:
/includeadditional "Citrix Profile Management WMI Plug-in"para habilitar a instalação do componente,/exclude "Citrix Profile Management WMI Plug-in"para impedir a instalação do componente. -
Agente de Atualização do VDA: Aplicável apenas a implantações do Citrix DaaS (anteriormente serviço Citrix Virtual Apps and Desktops). Permite que o VDA participe do recurso de Atualização do VDA. Você pode usar esse recurso para atualizar os VDAs de um catálogo a partir do console de gerenciamento, imediatamente ou em um horário agendado. Se este agente não estiver instalado, você pode atualizar um VDA executando o instalador do VDA na máquina.
Opções de linha de comando:
/includeadditional "Citrix VDA Upgrade Agent"para habilitar a instalação do componente,/exclude "Citrix VDA Upgrade Agent"para impedir a instalação do componente. -
Cache de gravação MCSIO para otimização de armazenamento: Instala o driver de E/S do Citrix MCS. Para obter mais informações, consulte Armazenamento compartilhado por hipervisores e Configurar cache para dados temporários.
Opções de linha de comando:
/includeadditional "Citrix MCS IODriver"para habilitar a instalação do componente,/exclude "Citrix MCS IODriver"para impedir a instalação do componente. -
Configuração de Proxy: Instale este componente se você planeja usar o protocolo Rendezvous com o Gateway Service, VDA Upgrade Service e assim por diante, em seu ambiente, e você tem um proxy não transparente em sua rede para conexões de saída, especifique o proxy aqui. Apenas proxies HTTP são suportados.
Se você instalar este componente, especifique o endereço do proxy ou o caminho do arquivo PAC na página “Configuração de Proxy Rendezvous”. Para obter detalhes do recurso, consulte Protocolo Rendezvous.
Opção de linha de comando:
/includeadditional "Citrix Rendezvous V2"para habilitar a instalação do componente,/exclude "Citrix Rendezvous V2"para impedir a instalação do componente. -
Backup e Restauração Citrix: Se uma instalação ou atualização do VDA falhar, este componente pode retornar a máquina a um backup que foi feito antes da instalação ou atualização.
Certifique-se de que os pré-requisitos da Microsoft sejam atendidos conforme mencionado em Preparar para instalar.
Opção de linha de comando:
/includeadditional "Citrix Backup and Restore"para habilitar a instalação do componente,/exclude "Citrix Backup and Restore"para impedir a instalação do componente.
Nota:
Se a otimização de armazenamento MCS estiver habilitada, o backup ou a restauração para o sistema operacional Windows Server ou desktop pode falhar. Para resolver isso, desabilite a opção de otimização de armazenamento MCS no meta instalador.
Etapa 7. Endereços do Delivery Controller™
Na página “Delivery Controller”, escolha como você deseja inserir os endereços dos Controllers instalados. A Citrix recomenda que você especifique os endereços enquanto estiver instalando o VDA (“Fazer manualmente”). O VDA não pode se registrar em um Controller até que tenha essas informações. Se um VDA não puder se registrar, os usuários não poderão acessar aplicativos e desktops nesse VDA.
- Fazer manualmente: (padrão) Insira o FQDN de um Controller instalado e clique em “Adicionar”. Se você instalou mais Controllers, adicione os endereços deles.
- Fazer mais tarde (Avançado): Se você escolher esta opção, o assistente pedirá para você confirmar o que deseja fazer antes de continuar. Para especificar endereços mais tarde, você pode executar novamente o instalador ou usar a Política de Grupo Citrix. O assistente também o lembrará na página “Resumo”.
- Escolher locais do Active Directory: Válido apenas quando a máquina está unida a um domínio e o usuário é um usuário de domínio.
- Usar Token WebSocket (Pré-visualização Técnica): Cria um VDA WebSocket. O WebSocketToken é para o token que é necessário.
- Deixar o Machine Creation Services fazer isso automaticamente: Válido apenas ao usar o MCS para provisionar máquinas.
Clique em “Avançar”. Se você selecionou “Fazer mais tarde (Avançado)”, será solicitado que você confirme que especificará os endereços do Controller mais tarde.
Outras considerações:
- O endereço não pode conter caracteres não alfanuméricos.
- Se você especificar endereços durante a instalação do VDA e na Política de Grupo, as configurações da política substituirão as configurações fornecidas durante a instalação.
- O registro bem-sucedido do VDA exige que as portas do firewall usadas para se comunicar com o Controller estejam abertas. Essa ação é habilitada por padrão na página “Firewall” do assistente.
- Depois de especificar os locais do Controller (durante ou após a instalação do VDA), você pode usar o recurso de atualização automática para atualizar os VDAs quando os Controllers forem adicionados ou removidos. Para obter detalhes sobre como os VDAs descobrem e se registram nos Controllers, consulte Registro do VDA.
Opção de linha de comando: /controllers
Etapa 8. Configuração de Proxy
A página “Configuração de Proxy” aparece apenas se você habilitou a caixa de seleção “Configuração de Proxy” na página “Componentes Adicionais”.
- Selecione se você especificará a origem do proxy por endereço de proxy ou caminho do arquivo PAC.
-
Especifique o endereço do proxy ou o caminho do arquivo PAC.
- Formato do endereço do proxy:
http://<url-or-ip>:<port> - Formato do arquivo PAC:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- Formato do endereço do proxy:
O firewall para a porta do proxy deve estar aberto para que o teste de conexão seja bem-sucedido. Se uma conexão não puder ser feita com o proxy, você pode escolher se deseja continuar com a instalação do VDA.
Opção de linha de comando: /proxyconfig
Etapa 9. Habilitar ou desabilitar recursos
Na página “Recursos”, use as caixas de seleção para habilitar ou desabilitar os recursos que você deseja usar.
-
Usar Assistência Remota do Windows: Quando este recurso está habilitado, a Assistência Remota do Windows é usada com o recurso de sombreamento de usuário do Director. A Assistência Remota do Windows abre as portas dinâmicas no firewall. (Padrão = desabilitado)
Opção de linha de comando:
/enable_remote_assistance -
Usar Transporte de Áudio em Tempo Real para áudio: Habilite este recurso se a voz sobre IP for amplamente utilizada em sua rede. O recurso reduz a latência e melhora a resiliência do áudio em redes com perdas. Ele permite que os dados de áudio sejam transmitidos usando RTP sobre transporte UDP. (Padrão = desabilitado)
Opção de linha de comando:
/enable_real_time_transport -
Usar compartilhamento de tela: Quando habilitado, as portas usadas pelo compartilhamento de tela são abertas no firewall do Windows. (Padrão = desabilitado)
Opção de linha de comando:
/enable_ss_ports -
Este VDA está instalado em uma VM na nuvem: Esta configuração ajuda a Citrix a identificar corretamente os locais de recursos para implantações de VDA locais e de serviço (Citrix Cloud™) para fins de telemetria. Este recurso não tem impacto na utilização do lado do cliente. Habilite esta configuração se sua implantação usar o Citrix DaaS (Padrão = desabilitado).
Opção de linha de comando:
/xendesktopcloud
Clique em “Avançar”.
Etapa 10. Portas do firewall
Na página “Firewall”, por padrão, as portas são abertas automaticamente se o Serviço de Firewall do Windows estiver em execução, mesmo que o firewall não esteja habilitado. Esta configuração padrão é adequada para a maioria das implantações. Para obter informações sobre portas, consulte Portas de rede.
Clique em “Avançar”.
Opção de linha de comando: /enable_hdx_ports
Etapa 11. Revisar pré-requisitos e confirmar a instalação
A página “Resumo” lista o que será instalado. Use o botão “Voltar” para retornar às páginas anteriores do assistente e alterar as seleções.
Quando estiver pronto, clique em “Instalar”.
Se os pré-requisitos não estiverem instalados ou habilitados, a máquina pode reiniciar uma ou mais vezes. Consulte Preparar para instalar.
Etapa 12. Diagnóstico
Na página “Diagnóstico”, escolha se deseja participar do Citrix Call Home. Se você optar por participar (o padrão), clique em “Conectar”. Quando solicitado, insira suas credenciais de conta Citrix.
Depois que suas credenciais forem validadas (ou se você optar por não participar), clique em “Avançar”.
Ao usar o instalador completo do produto, se você clicar em “Conectar” na página “Diagnóstico” sem primeiro selecionar “Coletar informações de diagnóstico”, depois de fechar a caixa de diálogo “Conectar aos Serviços Citrix Insight”, o botão “Avançar” será desabilitado. Você não pode ir para a próxima página. Para reabilitar o botão “Avançar”, selecione e desmarque imediatamente “Coletar informações de diagnóstico”.
Para obter mais informações, consulte Call Home.
Etapa 13. Concluir esta instalação
A página “Concluir” contém marcas de seleção verdes para todos os pré-requisitos e componentes que foram instalados e inicializados com sucesso.
Clique em “Concluir”. Por padrão, a máquina reinicia automaticamente. Embora você possa desabilitar esta reinicialização automática, o VDA não pode ser usado até que a máquina reinicie.
Próximas etapas
Repita o procedimento acima para instalar VDAs em outras máquinas ou imagens, se necessário.
Depois de instalar todos os VDAs, inicie o Studio. Se você ainda não criou um site, o Studio o guiará automaticamente para essa tarefa. Depois disso, o Studio o guiará para criar um catálogo de máquinas e, em seguida, um grupo de entrega. Consulte:
Citrix Optimizer
O Citrix Optimizer é uma ferramenta para SO Windows que ajuda os administradores Citrix a otimizar VDAs, removendo e otimizando vários componentes.
Após instalar um VDA e concluir a reinicialização final, baixe e instale o Citrix Optimizer. Consulte CTX224676. O artigo CTX contém o pacote de download, além de instruções sobre como instalar e usar o Citrix Optimizer.
Personalizar um VDA
Para personalizar um VDA instalado:
- No recurso do Windows para remover ou alterar programas, selecione “Citrix Virtual Delivery Agent” ou “Citrix Remote PC Access/VDI Core Services VDA”. Em seguida, clique com o botão direito do mouse e selecione “Alterar”.
-
Selecione “Personalizar Configurações do Virtual Delivery Agent”. Quando o instalador for iniciado, você poderá alterar:
- Endereços do Controller
- Porta TCP/IP para registrar com o Controller (padrão = 80)
- Se as portas do Firewall do Windows devem ser abertas automaticamente
Solução de problemas
-
Para obter informações sobre como a Citrix relata os resultados das instalações de componentes, consulte Códigos de retorno de instalação da Citrix.
-
Na exibição do Studio para um grupo de entrega, a entrada “Versão do VDA instalada” no painel “Detalhes” pode não ser a versão instalada nas máquinas. A exibição de Programas e Recursos do Windows da máquina mostra a versão real do VDA.
-
Depois que um VDA é instalado, ele não pode entregar aplicativos ou um desktop aos usuários até que se registre em um Delivery Controller.
Para saber mais sobre os métodos de registro do VDA e como solucionar problemas de registro, consulte Registro do VDA.
Limitação conhecida
Ao usar o aplicativo Citrix Workspace para Windows versão 1912 ou anterior, a sessão é encerrada após um tempo. Este problema foi corrigido nas versões LTSR e CR mais recentes do aplicativo Citrix Workspace. Para obter mais informações sobre as versões de lançamento suportadas, consulte Citrix Workspace app for Windows / Citrix Receiver for Windows Long Term Service Releases.
Neste artigo
- Etapa 1. Baixar o software do produto e iniciar o assistente
- Etapa 2. Escolher qual produto instalar
- Etapa 3. Selecionar o VDA
- Etapa 4. Especificar como o VDA será usado
- Etapa 5. Selecionar os componentes a serem instalados e o local de instalação
- Etapa 6. Instalar componentes adicionais
- Etapa 7. Endereços do Delivery Controller™
- Etapa 8. Configuração de Proxy
- Etapa 9. Habilitar ou desabilitar recursos
- Etapa 10. Portas do firewall
- Etapa 11. Revisar pré-requisitos e confirmar a instalação
- Etapa 12. Diagnóstico
- Etapa 13. Concluir esta instalação
- Próximas etapas
- Citrix Optimizer
- Personalizar um VDA
- Solução de problemas
- Limitação conhecida