Citrix Virtual Apps and Desktops

Instalar VDAs usando o SCCM

Observação:

A Citrix não se responsabiliza por problemas que surjam devido à 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 quaisquer problemas da Citrix relacionados à instalação, abra um caso de suporte técnico com os logs de instalação relevantes usando o portal de Suporte da Citrix.

Visão geral

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

A Citrix não recomenda usar o VDA Cleanup Utility como parte de uma instalação ou atualização do VDA. Use o VDA Cleanup Utility apenas no caso limitado em que o instalador do VDA tenha falhado anteriormente.

Reinicializações

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

  • Uma reinicialização pode ser necessária para atualizações pendentes ou reinicializações de instalações de software anteriores.
  • Arquivos previamente bloqueados por outros processos podem precisar de atualizações, forçando uma reinicialização extra.
  • Alguns componentes opcionais no instalador do 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

Após identificar todos os pré-requisitos e reinicializações, use o SCCM Task Sequencer para concluir o seguinte:

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

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

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

  • Ao atualizar um VDA, a máquina na qual ele está instalado deve estar em modo de manutenção, sem sessões.
  • Quando uma instalação do VDA é executada pela primeira vez em uma máquina, o instalador do VDA que está sendo usado é copiado para essa máquina.
    • Ao usar um instalador do VDA diferente de VDAWorkstationCoreSetup_XXXX.exe, o instalador do VDA é copiado para %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Ao usar VDAWorkstationCoreSetup_XXXX.exe, o instalador do VDA é copiado para %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe. `
  • O local do diretório do instalador do VDA também é armazenado 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 mostre a interface do usuário durante a instalação, para que o SCCM tenha controle do processo de instalação.
    • /NOREBOOT: Suprima o instalador do VDA de reiniciar automaticamente. O SCCM aciona as reinicializações quando necessário.
    • /NORESUME: Geralmente, quando uma reinicialização é necessária durante a instalação, o instalador do VDA define uma chave de registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Quando a máquina reinicia, o Windows usa a chave para iniciar o instalador do VDA. Isso é 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 o SCCM

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

  1. TAREFA1 do SCCM: Prepare a máquina reiniciando-a.
  2. TAREFA2 do SCCM: Inicie 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 do 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 estará concluída e uma reinicialização será necessária.
      • Se um código de retorno for 3, reinicie a máquina e, em seguida, passe o controle para a TAREFA3 do SCCM.
  3. TAREFA3 do SCCM: Continue a instalação do VDA.
    1. Se a TAREFA2 do SCCM não retornar 0 ou 8, a instalação deverá ser continuada após a conclusão da reinicialização.
    2. A TAREFA3 do SCCM se repete até que o instalador do VDA retorne 0 ou 8 (indicando uma instalação bem-sucedida) ou 3 (indicando que a TAREFA3 do SCCM deve ser repetida). Trate qualquer outro código de retorno como um erro, e a TAREFA3 do SCCM deve relatar um erro e parar.
    3. Retome a instalação do VDA executando o instalador do VDA apropriado (XenDesktopVdaSetup.exe na maioria dos casos, ou XenDesktopRemotePCSetup.exe se VDAWorkstationCoreSetup_XXXX.exe foi usado) do local onde foi copiado (conforme descrito em Definir a sequência de tarefas), sem parâmetros de linha de comando. (O instalador do VDA usa os parâmetros que salvou durante a primeira execução do instalador.)
    4. Observe o código de retorno do instalador do VDA.
      • 0 ou 8: Sucesso, instalação concluída, reinicialização necessária.
      • 3: A instalação não está concluída. Reinicie a máquina e repita a TAREFA3 do SCCM até que 0 ou 8 seja retornado. Trate qualquer outro código de retorno como um erro, e a TAREFA3 do SCCM deve relatar um erro e terminar.

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

Exemplos de comando de instalação do VDA

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

Comandos de instalação para Acesso Remoto a PC

  • O comando a seguir usa o instalador VDA principal 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 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 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 o SCCM