Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Preparar para instalar

January 23, 2026
Contribuição de: 
C

A implantação do Citrix Virtual Apps and Desktops™ começa com a instalação dos seguintes componentes. Este processo prepara a entrega de aplicativos e desktops para usuários dentro do seu firewall.

  • Um ou mais Delivery Controllers
  • Citrix Director
  • Citrix StoreFront™
  • Citrix License Server
  • Um ou mais Citrix Virtual Delivery Agents (VDAs)
  • Componentes e tecnologias opcionais, como o Universal Print Server, o Federated Authentication Service e o Self-Service Password Reset

Para usuários fora do seu firewall, instale e configure um componente extra, como o Citrix Gateway. Para uma introdução, consulte Integrar Citrix Virtual Apps and Desktops com Citrix Gateway.

Nota:

Certifique-se de que os seguintes pré-requisitos da Microsoft sejam atendidos no SO do servidor e no SO da estação de trabalho:

Se sua implantação incluir cargas de trabalho do Windows Server, configure um Microsoft RDS License Server.

Você pode usar o instalador completo do produto no ISO do produto para implantar muitos componentes e tecnologias. Você pode usar um instalador VDA autônomo para instalar VDAs. Os instaladores VDA autônomos estão disponíveis no site de download da Citrix. Todos os instaladores oferecem interfaces gráficas e de linha de comando. Consulte Instaladores.

O ISO do produto contém scripts de exemplo que instalam, atualizam ou removem VDAs para máquinas em um Active Directory. Você também pode usar os scripts para gerenciar imagens usadas pelo Machine Creation Services (MCS) e Citrix Provisioning (anteriormente Provisioning Services). Para obter detalhes, consulte Instalar VDAs usando scripts.

Informações a serem revisadas antes da instalação

  • Visão geral técnica: Para se familiarizar com o produto e seus componentes.
  • Segurança: Ao planejar seu ambiente de implantação.
  • Problemas conhecidos: Problemas que você pode encontrar nesta versão.
  • Bancos de dados: Saiba mais sobre os bancos de dados do sistema e como configurá-los. Durante a instalação do Controller, você pode instalar o SQL Server Express para usar como banco de dados do site. Você configura a maioria das informações do banco de dados ao criar um site, após instalar os componentes principais.
  • Acesso Remoto a PC: Se você estiver implantando um ambiente que permite que seus usuários acessem suas máquinas físicas no escritório remotamente.
  • Conexões e recursos: Se você estiver usando um hipervisor ou outro serviço para hospedar ou provisionar VMs para aplicativos e desktops. Você pode configurar a primeira conexão ao criar um site (após instalar os componentes principais). Configure seu ambiente de virtualização antes disso.
  • Microsoft System Center Configuration Manager: Se você estiver usando o ConfigMgr para gerenciar o acesso a aplicativos e desktops, ou se estiver usando o recurso Wake on LAN com o Acesso Remoto a PC.
  • Conexões de host de nuvem pública: Se você tiver uma Licença de Direitos Híbridos, poderá criar conexões de host para a nuvem pública. Para obter informações relacionadas à Licença de Direitos Híbridos, consulte Renovações de Direitos Híbridos. Para obter informações relacionadas ao direito à nuvem pública e os motivos para essa alteração, consulte CTX270373.

Onde instalar os componentes

Revise os Requisitos do sistema para plataformas, sistemas operacionais e versões suportadas. Os pré-requisitos dos componentes são instalados automaticamente, exceto quando indicado. Consulte a documentação do Citrix StoreFront e do Citrix License Server para suas plataformas e pré-requisitos suportados.

Você pode instalar os componentes principais no mesmo servidor ou em servidores diferentes.

  • A instalação de todos os componentes principais em um servidor pode funcionar para implantações de avaliação, teste ou pequenas produções.
  • Para acomodar futuras expansões, considere instalar os componentes em servidores diferentes. Por exemplo, instalar o Studio em uma máquina diferente do servidor onde você instalou o Controller permite gerenciar o site remotamente.

  • Para a maioria das implantações de produção, é recomendável instalar os componentes principais em servidores separados.

    Instale o Citrix License Server e as licenças antes de instalar outros componentes em outros servidores.

  • Para instalar um componente suportado em um Server CoreOS (como um Delivery Controller), você deve usar a linha de comando. Esse tipo de SO não oferece uma interface gráfica, então instale o Studio e outras ferramentas em outro lugar e, em seguida, aponte-os para o servidor Controller.

Você pode instalar um Delivery Controller™ e um VDA para SO multi-sessão no mesmo servidor. Inicie o instalador e selecione o Delivery Controller (além de quaisquer outros componentes principais que você desejar nessa máquina). Em seguida, inicie o instalador novamente e selecione o Virtual Delivery Agent para SO multi-sessão.

Certifique-se de que cada sistema operacional tenha as atualizações mais recentes.

Certifique-se de que todas as máquinas tenham os relógios do sistema sincronizados. A infraestrutura Kerberos que protege a comunicação entre as máquinas requer sincronização.

Com XenServers, o estado de energia da máquina virtual pode aparecer como desconhecido, mesmo que pareça registrada. Para resolver esse problema, edite o valor da chave de registro HostTime para desabilitar a sincronização de tempo com o host:

HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"

Dica:

O valor padrão é HostTime="UTC". Altere este valor para algo diferente de UTC, por exemplo, Local. Essa alteração desabilita efetivamente a sincronização de tempo com o host.

Orientações de otimização para máquinas Windows 10 de sessão única estão disponíveis em CTX216252.

Onde NÃO instalar componentes:

  • Não instale nenhum componente em um controlador de domínio do Active Directory.
  • A instalação de um Controller em um nó em uma instalação de cluster do SQL Server, instalação de espelhamento do SQL Server ou em um servidor executando o Hyper-V não é suportada.

Se você tentar instalar ou atualizar um VDA em um SO Windows que esta versão do produto não suporta, uma mensagem o guiará para um artigo que descreve as opções.

Requisitos de permissão e Active Directory

Você deve ser um usuário de domínio e um administrador local nas máquinas onde você está instalando os componentes.

Para usar um instalador VDA autônomo, você deve ter privilégios administrativos elevados ou usar Executar como administrador.

Configure seu domínio do Active Directory antes de iniciar uma instalação.

  • Requisitos do sistema lista os níveis funcionais do Active Directory suportados. Active Directory unido contém mais informações.
  • Você deve ter pelo menos um controlador de domínio executando os Serviços de Domínio do Active Directory.
  • Não instale nenhum componente do Citrix Virtual Apps and Desktops em um controlador de domínio.
  • Não use uma barra (/) ao especificar nomes de Unidades Organizacionais no Studio.

A conta de usuário do Windows usada para instalar o Citrix License Server é configurada automaticamente como um administrador completo de administração delegada.

Para obter mais informações:

Orientação de instalação, considerações e melhores práticas

Durante a instalação de qualquer componente

  • Ao instalar ou atualizar um Delivery Controller, Studio, License Server ou Director a partir da mídia completa do produto, se o instalador da Citrix detectar que uma reinicialização está pendente de uma instalação anterior do Windows na máquina, o instalador para com o código de saída/retorno 9. Você será solicitado a reiniciar a máquina.

    Esta não é uma reinicialização forçada da Citrix. É devido a outros componentes instalados anteriormente na máquina. Se isso ocorrer, reinicie a máquina e, em seguida, inicie o instalador da Citrix novamente.

    Ao usar a interface de linha de comando, você pode evitar a verificação de reinicialização pendente incluindo a opção /no_pending_reboot_check no comando.

  • Geralmente, se um componente tiver pré-requisitos, o instalador os implanta se não estiverem presentes. Alguns pré-requisitos podem exigir uma reinicialização da máquina.

  • Ao criar objetos antes, durante e após a instalação, especifique nomes exclusivos para cada objeto. Por exemplo, forneça nomes exclusivos para redes, grupos, catálogos e recursos.

  • Se um componente não for instalado com sucesso, a instalação para com uma mensagem de erro. Os componentes que foram instalados com sucesso são mantidos. Você não precisa reinstalá-los.

  • Os Citrix Analytics são coletados automaticamente quando você instala (ou atualiza) componentes. Por padrão, esses dados são enviados para a Citrix automaticamente quando a instalação é concluída. Além disso, ao instalar componentes, você é automaticamente inscrito no Citrix Customer Experience Improvement Program (CEIP), que envia dados anônimos.

    Durante a instalação, você também pode optar por participar de outras tecnologias Citrix que coletam diagnósticos para manutenção e solução de problemas. Para obter informações sobre esses programas, consulte Citrix Insight Services.

  • O Google Analytics é coletado (e posteriormente enviado) automaticamente quando você instala (ou atualiza) o Studio. Após instalar o Studio, você pode alterar essa configuração com a chave de registro HKLM\Software\Citrix\DesktopStudio\GAEnabled. Um valor de 1 habilita a coleta e o upload, 0 desabilita a coleta e o upload.

  • Se uma instalação de VDA falhar, um analisador MSI analisa o log MSI com falha, exibindo o código de erro exato. O analisador sugere um artigo CTX, se for um problema conhecido. O analisador também coleta dados anonimizados sobre o código de erro da falha. Esses dados são incluídos com outros dados coletados pelo CEIP. Se você encerrar a inscrição no CEIP, os dados coletados pelo analisador MSI não serão mais enviados à Citrix.

Durante a instalação do VDA

  • O Citrix Workspace™ app para Windows está disponível, mas não é instalado por padrão ao instalar um VDA. Você ou seus usuários podem baixar e instalar (e atualizar) o Citrix Workspace app para Windows e outros aplicativos Citrix Workspace do site da Citrix. Alternativamente, você pode disponibilizar esses aplicativos Citrix Workspace a partir do seu servidor StoreFront. Consulte a documentação do StoreFront.

  • O Serviço de Spooler de Impressão da Microsoft deve estar habilitado. Você não pode instalar um VDA com sucesso se esse serviço estiver desabilitado.

  • A maioria das edições suportadas do Windows vem com o Microsoft Media Foundation já instalado. Se a máquina não tiver o Media Foundation (como as edições N), vários recursos multimídia não serão instalados e não funcionarão.

    • Redirecionamento de Mídia do Windows
    • Redirecionamento de Vídeo HTML5
    • Redirecionamento de Webcam HDX™ RealTime

    Você pode reconhecer a limitação, ou encerrar a instalação do VDA e reiniciá-la mais tarde, após instalar o Media Foundation. Na interface gráfica, essa escolha é apresentada em uma mensagem. Na linha de comando, você pode usar a opção /no_mediafoundation_ack para reconhecer a limitação.

  • Ao instalar o VDA, um novo grupo de usuários local chamado Direct Access Users é criado automaticamente. Em um VDA para SO de sessão única, este grupo se aplica apenas a conexões RDP. Em um VDA para SO multi-sessão, este grupo se aplica a conexões ICA® e RDP.

  • O VDA deve ter endereços de Controller válidos para se comunicar. Caso contrário, as sessões não podem ser estabelecidas. Você pode especificar os endereços do Controller ao instalar o VDA ou posteriormente. Lembre-se de que isso deve ser feito. Para obter mais informações, consulte Registro do VDA.

Reinicializações após e durante a instalação do VDA

Uma reinicialização é necessária ao final da instalação do VDA. Essa reinicialização ocorre automaticamente por padrão.

Ao atualizar um VDA para a versão 7.17 (ou uma versão suportada posterior), uma reinicialização ocorre durante a atualização. Isso não pode ser evitado.

Para minimizar o número de reinicializações necessárias durante a instalação do VDA:

  • Certifique-se de que uma versão suportada do .NET Framework esteja instalada antes de iniciar a instalação do VDA.
  • Para máquinas com SO Windows multi-sessão, instale e habilite os serviços de função RDS antes de instalar o VDA.

Se você não instalar esses pré-requisitos antes de instalar o VDA:

  • Se você estiver usando a interface gráfica ou a interface de linha de comando sem a opção /noreboot, a máquina reinicia automaticamente após a instalação do pré-requisito.
  • Se você estiver usando a interface de linha de comando com a opção /noreboot, você deve iniciar a reinicialização.

Ao atualizar uma versão do VDA, uma reinicialização ocorre durante a atualização. Isso não pode ser evitado.

Restaurar em caso de falha na instalação ou atualização

Nota:

Este recurso está disponível para VDAs de sessão única e multi-sessão.

Se uma instalação ou atualização de VDA de sessão única falhar, e o recurso “restaurar em caso de falha” estiver habilitado, a máquina é retornada a um ponto de restauração que foi definido antes do início da instalação ou atualização.

Se uma instalação ou atualização de VDA multi-sessão falhar, e o recurso “restaurar em caso de falha” estiver habilitado, a máquina é retornada a um backup que foi realizado antes do início da instalação ou atualização.

Quando uma instalação ou atualização de VDA de sessão única começa com este recurso habilitado, o instalador cria um ponto de restauração do sistema antes de iniciar a instalação ou atualização real. Se a instalação ou atualização do VDA falhar, a máquina é retornada ao estado do ponto de restauração. A pasta %temp%/Citrix contém logs de implantação e outras informações sobre a restauração.

Quando uma instalação ou atualização de VDA multi-sessão começa com este recurso habilitado, o instalador cria um backup do servidor antes de iniciar a instalação ou atualização real. Se a instalação ou atualização do VDA falhar, a máquina é retornada ao estado do backup. A pasta %temp%/Citrix contém logs de implantação e outras informações sobre a restauração. O tempo para criar o backup do servidor é baseado no tamanho do backup necessário e na quantidade de recursos disponíveis para o servidor. O backup é armazenado em C:\WindowsImageBackup\servername.

Por padrão, este recurso está desabilitado.

Se você planeja habilitar este recurso, certifique-se de que a restauração do sistema não esteja desabilitada por meio de uma configuração de GPO (Computer Configuration > Administrative Templates > System > System Restore).

Nota:

Esta configuração de GPO não se aplica à restauração de um VDA multi-sessão.

Para habilitar este recurso ao instalar ou atualizar um VDA de sessão única ou multi-sessão:

  • Ao usar a interface gráfica de um instalador VDA (como usar Autostart ou o comando XenDesktopVDASetup.exe sem nenhuma opção de restauração ou silenciosa), selecione a caixa de seleção Enable automatic restore if update fails na página Summary.

    Se a instalação/atualização for concluída com sucesso, o ponto de restauração/backup não é usado, mas é retido.

  • Execute um instalador VDA com a opção /enablerestore ou /enablerestorecleanup usando a linha de comando.

    • Se você usar a opção /enablerestorecleanup, e a instalação/atualização for concluída com sucesso, o ponto de restauração/backup do servidor é removido automaticamente.

    • Se você usar a opção /enablerestore, e a instalação/atualização for concluída com sucesso, o ponto de restauração não é usado, mas é retido.

Instaladores

Instalador completo do produto

Usando o instalador completo do produto fornecido no ISO, você pode:

  • Instalar, atualizar ou remover componentes principais: Delivery Controller, Studio, Director e License Server.
  • Instalar ou atualizar o StoreFront.
  • Instalar ou atualizar VDAs do Windows para sistemas operacionais de sessão única ou multi-sessão.
  • Instalar o componente UpsServer do Universal Print Server em seus servidores de impressão.
  • Instalar o Federated Authentication Service.
  • Instalar o Session Recording.

  • Instalar o Workspace Environment Management.

    Nota:

    O instalador do agente do Workspace Environment Management™ não é localizado. Ele está disponível apenas em inglês.

Para entregar um desktop de um SO multi-sessão para um usuário (por exemplo, para desenvolvimento web), use a interface de linha de comando do instalador completo do produto. Para obter detalhes, consulte Server VDI.

Instaladores VDA autônomos

Os instaladores VDA autônomos estão disponíveis nas páginas de download da Citrix. (Eles não estão disponíveis na mídia de instalação do produto.) Os instaladores VDA autônomos são muito menores que o ISO completo do produto. Eles acomodam mais facilmente implantações que:

  • Usam pacotes de Distribuição Eletrônica de Software (ESD) que são preparados ou copiados localmente
  • Têm máquinas físicas
  • Têm escritórios remotos

Por padrão, os arquivos nos VDAs autônomos autoextraíveis são extraídos para a pasta Temp. Mais espaço em disco é necessário na máquina ao extrair para a pasta Temp do que ao usar o instalador completo do produto. No entanto, os arquivos extraídos para a pasta Temp são automaticamente excluídos após a conclusão da instalação. Alternativamente, você pode usar o comando /extract com um caminho absoluto.

Três instaladores VDA autônomos estão disponíveis para download.

VDAServerSetup.exe:

Instala um VDA para SO multi-sessão. Ele suporta todas as opções de VDA para SO multi-sessão que estão disponíveis com o instalador completo do produto.

VDAWorkstationSetup.exe:

Instala um VDA para SO de sessão única. Ele suporta todas as opções de VDA para SO de sessão única que estão disponíveis com o instalador completo do produto.

VDAWorkstationCoreSetup.exe:

Instala um VDA para SO de sessão única otimizado para implantações de Acesso Remoto a PC ou instalações VDI principais. O Acesso Remoto a PC usa máquinas físicas. As instalações VDI principais são VMs que não estão sendo usadas como uma imagem. Ele instala apenas os serviços principais necessários para conexões VDA nessas implantações. Portanto, ele suporta apenas um subconjunto das opções válidas com os instaladores completos do produto ou VDAWorkstationSetup.exe.

Este instalador não instala nem contém os componentes usados para:

  • App-V.
  • Gerenciamento de Perfil. Excluir o Citrix Profile Management da instalação afeta as exibições do Citrix Director. Para obter detalhes, consulte Instalar VDAs.
  • Serviço de Identidade da Máquina.
  • Ferramentas de Suporte da Citrix.
  • Citrix Files para Windows.
  • Citrix Files para Outlook.

O instalador VDAWorkstationCoreSetup.exe não instala nem contém um Citrix Workspace app para Windows.

Usar VDAWorkstationCoreSetup.exe é equivalente a usar o instalador completo do produto ou VDAWorkstationSetup para instalar um VDA de SO de sessão única e uma das seguintes opções:

  • Na interface gráfica: Selecionar a opção Acesso Remoto a PC na página Environment.
  • Na interface de linha de comando: Especificar a opção /remotepc.
  • Na interface de linha de comando: Especificar /components vda mais a opção /exclude que lista todos os nomes de componentes adicionais válidos.

Você pode instalar os componentes/recursos omitidos posteriormente executando o instalador completo do produto. Essa ação permite instalar todos os componentes ausentes.

O instalador VDAWorkstationCoreSetup.exe instala automaticamente o MSI de Redirecionamento de Conteúdo do Navegador. Esta instalação automática se aplica ao VDA release 2003 e versões suportadas posteriores.

Códigos de retorno da instalação da Citrix

O log de instalação contém o resultado das instalações de componentes como um código de retorno da Citrix, não um valor da Microsoft.

  • 0 = Sucesso
  • 1 = Falha
  • 2 = SucessoParcial
  • 3 = SucessoParcialEReinicializaçãoNecessária
  • 4 = FalhaEReinicializaçãoNecessária
  • 5 = UsuárioCancelou
  • 6 = ArgumentoDeLinhaDeComandoAusente
  • 7 = VersãoMaisRecenteEncontrada
  • 8 = SucessoEReinicializaçãoNecessária
  • 9 = ReinicializaçãoPorBloqueioDeArquivo
  • 10 = Abortado
  • 11 = MídiaComFalha
  • 12 = LicençaComFalha
  • 13 = Pré-verificaçãoComFalha
  • 14 = VerificaçãoDeReinicializaçãoPendenteAbortada
  • -1 = Sair

Por exemplo, ao usar ferramentas como o Microsoft System Center Configuration Manager, uma instalação de VDA por script pode parecer falhar quando o log de instalação contém o código de retorno 3. Isso pode ocorrer quando o instalador do VDA está aguardando uma reinicialização que você deve iniciar (por exemplo, após a instalação de um pré-requisito de função RDS em um servidor). Uma instalação de VDA é considerada bem-sucedida somente depois que todos os pré-requisitos e componentes selecionados são instalados, e a máquina é reiniciada após a instalação.

Alternativamente, você pode encapsular sua instalação em scripts CMD (que retornam códigos de saída da Microsoft) ou alterar os códigos de sucesso em seu pacote do Configuration Manager.

Configurar um Microsoft RDS License Server para cargas de trabalho do Windows Server

Este produto acessa os recursos de sessão remota do Windows Server ao entregar uma carga de trabalho do Windows Server, como o Windows 2016. Isso geralmente requer uma licença de acesso de cliente dos Serviços de Área de Trabalho Remota (RDS CAL). O VDA deve ser capaz de contatar um servidor de licenças RDS para solicitar RDS CALs. Instale e ative o servidor de licenças. Para obter mais informações, consulte o documento da Microsoft Ativar o Servidor de Licenças dos Serviços de Área de Trabalho Remota. Para ambientes de prova de conceito, você pode usar o período de carência fornecido pela Microsoft.

Com este método, você pode fazer com que este serviço aplique as configurações do servidor de licenças. Você pode configurar o servidor de licenças e o modo por usuário no console RDS na imagem. Você também pode configurar o servidor de licenças usando as configurações de Política de Grupo da Microsoft. Para obter mais informações, consulte o documento da Microsoft Licenciar sua implantação RDS com licenças de acesso de cliente (CALs).

Para configurar o servidor de licenças RDS usando as configurações de Política de Grupo:

  1. Instale um Servidor de Licenças dos Serviços de Área de Trabalho Remota em uma máquina disponível. A máquina deve estar sempre disponível. As cargas de trabalho do produto Citrix devem ser capazes de alcançar este servidor de licenças.
  2. Especifique o endereço do servidor de licenças e o modo de licença por usuário usando a Política de Grupo da Microsoft. Para obter detalhes, consulte o documento da Microsoft Especificar o Modo de Licenciamento da Área de Trabalho Remota para um Servidor Host de Sessão RD.

As cargas de trabalho do Windows 10 exigem a ativação apropriada da licença do Windows 10. Recomendamos que você siga a documentação da Microsoft para ativar as cargas de trabalho do Windows 10.

Mais informações

Para configurar o local do recurso para tipos de host específicos:

Preparar para instalar
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.