Preparar para instalar
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 Universal Print Server, Federated Authentication Service e 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 o Citrix Virtual Apps and Desktops com o 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:
- Os serviços Microsoft Volume Shadow Copy e Microsoft Software Shadow Copy Provider estão em execução. Para obter mais informações, consulte Serviço de Cópia de Sombra de Volume.
- A versão do MS-Defender deve ser superior a 4.18.2105.5. Para obter mais informações, consulte Inteligência de segurança e atualizações de produtos do Microsoft Defender Antivirus.
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 suportados. 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 único servidor pode funcionar para avaliações, testes ou pequenas implantações de produção.
- 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 compatível 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 multiusuário no mesmo servidor. Inicie o instalador e selecione o Delivery Controller (além de quaisquer outros componentes principais que você deseja nessa máquina). Em seguida, inicie o instalador novamente e selecione o Virtual Delivery Agent para SO multiusuário.
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 exige sincronização.
Com XenServers, o estado de energia da máquina virtual pode aparecer como desconhecido, mesmo que pareça registrado. 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 do 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.
- (/pt-br/citrix-virtual-apps-desktops/2311/system-requirements.html) [Requisitos do sistema] lista os níveis funcionais do Active Directory suportados. (/pt-br/citrix-virtual-apps-desktops/2311/technical-overview/machine-identities/active-directory.html) [Ingressado no Active Directory] 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 mais informações:
- (/pt-br/citrix-virtual-apps-desktops/2311/secure/best-practices.html) [Melhores práticas de segurança]
- (/pt-br/citrix-virtual-apps-desktops/2311/secure/delegated-administration.html) [Administração delegada]
- Documentação da Microsoft para configuração do Active Directory
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 do produto completo, se o instalador 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 pelo Citrix. É devido a outros componentes instalados anteriormente na máquina. Se isso ocorrer, reinicie a máquina e, em seguida, inicie o instalador Citrix novamente.
Ao usar a interface de linha de comando, você pode evitar a verificação da reinicialização pendente incluindo a opção
/no_pending_reboot_checkno comando. -
Geralmente, se um componente tiver pré-requisitos, o instalador os implanta se não estiverem presentes. Alguns pré-requisitos podem exigir a 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 êxito, a instalação será interrompida com uma mensagem de erro. Os componentes instalados com êxito são mantidos. Você não precisa reinstalá-los.
-
O Citrix Analytics é coletado automaticamente quando você instala (ou atualiza) componentes. Por padrão, esses dados são carregados para a Citrix automaticamente quando a instalação é concluída. Além disso, ao instalar componentes, você é automaticamente inscrito no Programa de Melhoria da Experiência do Cliente (CEIP) da Citrix, que carrega 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 carregado) 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 para a 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 no 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 êxito se esse serviço estiver desabilitado.
-
A maioria das edições do Windows suportadas 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_ackpara 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 de múltiplas sessões, 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
É necessária uma reinicialização no 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 posterior compatível), ocorre uma reinicialização 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 compatível do .NET Framework esteja instalada antes de iniciar a instalação do VDA.
- Para máquinas com SO Windows de múltiplas sessões, 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 um VDA para a versão 7.17 ou uma versão posterior compatível, ocorre uma reinicialização 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 de “restauração em caso de falha” estiver ativado, 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 de “restauração em caso de falha” estiver ativado, 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 é iniciada com este recurso ativado, 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 é iniciada com este recurso ativado, 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á desativado.
Se você planeja ativar este recurso, certifique-se de que a restauração do sistema não esteja desativada 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 ativar 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.exesem quaisquer opções de restauração ou silenciosas), selecione a caixa de seleção Habilitar restauração automática se a atualização falhar na página Resumo.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
/enablerestoreou/enablerestorecleanupusando 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 será 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 será usado, mas será retido.
-
Instaladores
Instalador completo do produto
Usando o instalador completo do produto fornecido na 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 Windows para sistemas operacionais de sessão única ou multi-sessão.
- Instalar o componente
UpsServerdo 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 Workspace Environment Management™ Agent não está 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 detalhes, consulte VDI de Servidor.
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 do que a ISO completa 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
- Possuem máquinas físicas
- Possuem escritórios remotos
Por padrão, os arquivos nos VDAs autônomos de autoextração são extraídos para a pasta Temp. É necessário mais espaço em disco 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 essenciais 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 Gerenciamento de Perfil do Citrix 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 Citrix.
- Citrix Files para Windows.
- Citrix Files para Outlook.
O instalador VDAWorkstationCoreSetup.exe não instala nem contém um aplicativo Citrix Workspace para Windows.
Usar VDAWorkstationCoreSetup.exe é equivalente a usar o instalador do produto completo 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 ao PC na página Ambiente.
- Na interface de linha de comando: Especificar a opção
/remotepc. - Na interface de linha de comando: Especificar
/components vdamais a opção/excludeque lista todos os nomes de componentes adicionais válidos.
Você pode instalar os componentes/recursos omitidos posteriormente executando o instalador do produto completo. Essa ação permite que você instale 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 à versão 2003 do VDA e versões posteriores suportadas.
Códigos de retorno de instalação do Citrix
O log de instalação contém o resultado das instalações de componentes como um código de retorno do Citrix, não um valor da Microsoft.
- 0 = Sucesso
- 1 = Falha
- 2 = SucessoParcial
- 3 = SucessoParcialEReincializaçãoNecessária
- 4 = FalhaEReincializaçãoNecessária
- 5 = UsuárioCancelou
- 6 = ArgumentoDeLinhaDeComandoAusente
- 7 = VersãoMaisRecenteEncontrada
- 8 = SucessoReinicializaçã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 Servidor de Licenças RDS da Microsoft 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:
- 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.
- 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 a localização de recursos para tipos de host específicos:
- Ambientes de nuvem AWS
- Ambientes de virtualização XenServer
- Ambientes do Google Cloud
- Ambientes de nuvem do Microsoft Azure Resource Manager
- Ambientes do Microsoft System Center Configuration Manager
- Ambientes de virtualização do Microsoft System Center Virtual Machine Manager
- Ambientes de virtualização Nutanix
- Soluções de nuvem e parceiros Nutanix
- Ambientes de virtualização VMware
- Soluções de nuvem e parceiros VMware
Neste artigo
- Informações a serem revisadas antes da instalação
- Onde instalar os componentes
- Requisitos de permissão e do Active Directory
- Orientação de instalação, considerações e melhores práticas
- Instaladores
- Códigos de retorno de instalação do Citrix
- Configurar um Servidor de Licenças RDS da Microsoft para cargas de trabalho do Windows Server
- Mais informações