Citrix Virtual Apps and Desktops

Instalar VDAs usando SCCM

Nota:

A Citrix não é responsável por problemas causados pela implantação de um Virtual Delivery Agent (VDA) usando ferramentas de distribuição de software, como o Microsoft System Center Configuration Manager (SCCM), adaptadas para corresponder aos ambientes de produção do cliente. Para qualquer problema relacionado à instalação da Citrix, abra um caso de suporte técnico com os logs de instalação relevantes usando o portal de suporte Citrix.

Visão geral

Para implantar com êxito um Virtual Delivery Agent (VDA) usando o Microsoft System Center Configuration Manager (SCCM) ou ferramentas de distribuição de software semelhantes, a Citrix recomenda o uso do instalador do VDA em uma sequência de etapas.

A Citrix não recomenda o uso do VDA Cleanup Utility como parte de uma instalação ou atualização de VDA. Use o VDA Cleanup Utility somente na eventualidade de o instalador do VDA ter falhado anteriormente.

Reinicializações

O número necessário de reinicializações durante a instalação do VDA depende do ambiente. Por exemplo:

  • Uma reinicialização pode ser necessária no caso de atualizações pendentes, ou reinicializações das instalações de software anteriores podem ocorrer.
  • Além disso, arquivos previamente bloqueados por outros processos podem precisar de atualizações, forçando uma reinicialização extra.
  • Alguns componentes opcionais no instalador de VDA (como o Citrix Profile Management e o Citrix Files) podem exigir uma reinicialização.

O SCCM Task Sequencer gerencia todas as reinicializações necessárias.

Definir a sequência de tarefas

Depois de identificar todos os pré-requisitos e reinicializações, use o sequenciador de tarefas do SCCM para:

  • O VDA pode ser instalado a partir de uma cópia acessível da mídia de instalação ou usando um dos instaladores autônomos de VDA:

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    Para obter mais informações sobre instaladores de VDA, consulte Instaladores.

  • Ao atualizar um VDA, a máquina na qual ele está instalado deve estar no modo de manutenção, sem sessões.
  • Quando uma instalação de VDA é executada pela primeira vez em uma máquina, o instalador de VDA que está sendo usado é copiado para essa máquina.
    • Quando usar um instalador de VDA diferente de VDAWorkstationCoreSetup_XXXX.exe, o instalador de VDA será copiado para %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Quando usar VDAWorkstationCoreSetup_XXXX.exe, o instalador de VDA será copiado para %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe. `
  • A localização do diretório do instalador de VDA também é armazenada no registro “HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.
  • Adicione as opções de linha de comando /NOREBOOT, /NORESUME e /QUIET às suas opções de linha de comando.
    • /QUIET: não mostra a interface do usuário durante a instalação, para que o SCCM tenha controle do processo de instalação.
    • /NOREBOOT: impede o instalador de VDA de reiniciar automaticamente. Os gatilhos do SCCM são reiniciados quando necessário.
    • /NORESUME: normalmente, quando uma reinicialização é necessária durante a instalação, o instalador de VDA define uma chave de registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Quando a máquina é reinicializada, o Windows usa a chave para iniciar o instalador de VDA. Esse é um problema para o SCCM, porque o SCCM não pode monitorar a instalação e capturar o código de saída.

Exemplo de sequência de instalação usando SCCM

O exemplo a seguir mostra a sequência de instalação.

  1. SCCM TASK1: Reinicializar a máquina para prepará-la.
  2. SCCM TASK2: Iniciar a instalação do VDA.
    1. Adicione as opções /quiet, /noreboot e /noresume às suas opções de linha de comando.
    2. Execute o instalador VDA de sua escolha (imagem local ou um dos instaladores mínimos).
    3. O SCCM deve capturar o código de retorno.
      • Se o código de retorno for 0 ou 8, a instalação foi concluída e é necessária reinicializar.
      • Se um código de retorno for 3, reinicie a máquina e passe o controle para SCCM TASK3.
  3. SCCM TASK3: Continuar a instalação do VDA.
    1. Se SCCM TASK2 não retornar 0 ou 8, a instalação continuará após a conclusão da reinicialização.
    2. O SCCM TASK3 se repete até que o instalador de VDA retorne um 0 ou 8 (indicando uma instalação bem-sucedida) ou um 3 (indicando que SCCM TASK3 deve ser repetido). Trate qualquer outro código de retorno como erro; o SCCM TASK3 irá informar o erro e parar.
    3. Retome a instalação do VDA executando o instalador de VDA apropriado (XenDesktopVdaSetup.exe na maioria dos casos, ou XenDesktopRemotePCSetup.exe se VDAWorkstationCoreSetup_XXXX.exe foi usado) a partir do local onde foi copiado (conforme descrito em Definir a sequência de tarefas), sem parâmetros de linha de comando. (O instalador de VDA usa os parâmetros salvos durante a primeira execução do instalador.)
    4. Fique atento ao código de retorno do instalador de VDA.
      • 0 ou 8: sucesso, instalação concluída, reinicialização necessária.
      • 3: instalação não concluída. Reinicialize a máquina e repita o SCCM TASK3 até que um 0 ou 8 seja retornado. Trate qualquer outro código de retorno como erro; o SCCM TASK3 irá informar o erro e encerrar.

Para obter mais informações sobre códigos de retorno, consulte Códigos de retorno de instalação Citrix.

Exemplos de comando de instalação de VDA

As opções de instalação disponíveis variam, dependendo de qual instalador é usado. Consulte os seguintes artigos para obter detalhes da opção de linha de comando.

Comandos de instalação para Remote PC Access

  • O comando a seguir usa o instalador de VDA básico de sessão única (VDAWorkstationCoreSetup.exe):

    VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

  • O comando a seguir usa o instalador de VDA completo de sessão única (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /remotepc /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

Comando de instalação para VDI dedicado

  • O comando a seguir usa o instalador de VDA completo de sessão única (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

Instalar VDAs usando SCCM