Citrix Virtual Apps and Desktops

Instalar VDAs usando scripts

Observação:

A Citrix não se responsabiliza por problemas causados por scripts adaptados para corresponder aos ambientes de produção do cliente. Para quaisquer problemas de instalação relacionados à Citrix, abra um caso de suporte técnico com os logs de instalação relevantes usando o portal de Suporte da Citrix.

Este artigo se aplica à instalação de VDAs em máquinas com sistemas operacionais Windows. Para obter informações sobre VDAs para sistemas operacionais Linux, consulte a documentação do Linux Virtual Delivery Agent.

A mídia de instalação contém scripts de exemplo que instalam, atualizam ou removem Virtual Delivery Agents (VDAs) para máquinas no Active Directory. Você também pode usar os scripts para manter imagens mestre usadas pelo Machine Creation Services™ e pelo Citrix Provisioning (anteriormente Provisioning Services).

Acesso necessário:

  • Os scripts precisam de acesso de Leitura para Todos ao compartilhamento de rede onde o comando de instalação do VDA está localizado. O comando de instalação é XenDesktopVdaSetup.exe no ISO completo do produto, ou VDAWorkstationSetup.exe ou VDAServerSetup.exe em um instalador autônomo.
  • Os detalhes de log são armazenados em cada máquina local. Para registrar os resultados centralmente para revisão e análise, os scripts precisam de acesso de Leitura e Gravação para Todos ao compartilhamento de rede apropriado.

Para verificar os resultados da execução de um script, examine o compartilhamento de log central. Os logs capturados incluem o log do script, o log do instalador e os logs de instalação do MSI. Cada tentativa de instalação ou remoção é registrada em uma pasta com carimbo de data/hora. O título da pasta indica o resultado da operação com o prefixo PASS ou FAIL. Você pode usar ferramentas padrão de pesquisa de diretório para encontrar uma instalação ou remoção com falha no compartilhamento de log central. Essas ferramentas oferecem uma alternativa à pesquisa local nas máquinas de destino.

Antes de iniciar qualquer instalação, leia e conclua as tarefas em Preparar para instalar.

Instalar ou atualizar VDAs usando o script

  1. Obtenha o script de exemplo InstallVDA.bat em \Support\AdDeploy\ na mídia de instalação. A Citrix recomenda que você faça um backup do script original antes de personalizá-lo.
  2. Edite o script:
    • Especifique a versão do VDA a ser instalada: SET DESIREDVERSION. O valor completo pode ser encontrado na mídia de instalação no arquivo ProductVersion.txt. No entanto, uma correspondência completa não é necessária.
    • Especifique o compartilhamento de rede onde o instalador será invocado. Aponte para a raiz do layout (o ponto mais alto da árvore). A versão apropriada do instalador (32 bits ou 64 bits) é chamada automaticamente quando o script é executado. Por exemplo: SET DEPLOYSHARE=\\fileserver1\share1.
    • Opcionalmente, especifique um local de compartilhamento de rede para armazenar logs centralizados. Por exemplo: SET LOGSHARE=\\fileserver1\log1).
    • Especifique as opções de configuração do VDA conforme descrito em Instalar usando a linha de comando. As opções /quiet e /noreboot são incluídas por padrão no script e são obrigatórias: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME.
  3. Usando os Scripts de Inicialização da Política de Grupo, atribua o script à OU que contém suas máquinas. Esta OU deve conter apenas máquinas nas quais você deseja instalar o VDA. Quando as máquinas nessa OU são reiniciadas, o script é executado em todas elas. Um VDA é instalado em cada máquina que possui um sistema operacional compatível.

Remover VDAs usando o script

  1. Obtenha o script de exemplo UninstallVDA.bat em \Support\AdDeploy\ na mídia de instalação. A Citrix recomenda que você faça um backup do script original antes de personalizá-lo.
  2. Edite o script.
    • Especifique a versão do VDA a ser removida: SET CHECK\_VDA\_VERSION. O valor completo pode ser encontrado na mídia de instalação no arquivo ProductVersion.txt (como 7.0.0.3018). No entanto, uma correspondência completa não é necessária.
    • Opcionalmente, especifique um local de compartilhamento de rede para armazenar logs centralizados.
  3. Usando os Scripts de Inicialização da Política de Grupo, atribua o script à OU que contém suas máquinas. Esta OU deve conter apenas máquinas das quais você deseja remover o VDA. Quando as máquinas na OU são reiniciadas, o script é executado em todas elas. O VDA é removido de cada máquina.

Solução de problemas

  • O script gera arquivos de log internos que descrevem o progresso da execução do script. O script copia um log Kickoff_VDA_Startup_Script para o compartilhamento de log central segundos após o início da implantação. Você pode verificar se o processo geral está funcionando. Se este log não for copiado para o compartilhamento de log central conforme o esperado, solucione o problema inspecionando a máquina local. O script coloca dois arquivos de log de depuração na pasta %temp% em cada máquina:

    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    Revise esses logs para garantir que o script esteja:

    • Executando conforme o esperado.
    • Detectando corretamente o sistema operacional de destino.
    • Configurado corretamente para apontar para a ROOT do compartilhamento DEPLOYSHARE (contém o arquivo chamado AutoSelect.exe).
    • Capaz de autenticar nos compartilhamentos DEPLOYSHARE e LOG.
  • Para obter informações sobre como a Citrix relata o resultado 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 Installed VDA version no painel Details pode não ser a versão instalada nas máquinas. A exibição de programas e recursos da máquina mostra a versão real do VDA.

  • Após a instalação de um VDA, ele não pode entregar aplicativos ou uma área de trabalho aos usuários até que se registre em um Delivery Controller.

    Para saber mais sobre os métodos de registro de VDA e como solucionar problemas de registro, consulte Registro de VDA.

Instalar VDAs usando scripts