Citrix Virtual Apps and Desktops

Instalar VDAs usando scripts

Nota:

A Citrix não é responsável por problemas causados por scripts que são adaptados 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.

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

A mídia de instalação contém exemplos de scripts que instalam, atualizam ou removem Virtual Delivery Agents (VDA) de máquinas no Active Directory. Você também pode usar os scripts para fazer a manutenção das imagens mestre usadas por Machine Creation Services e Citrix Provisioning (anteriormente Provisioning Services).

Acesso necessário:

  • Os scripts precisam de acesso Todos Leem ao compartilhamento de rede onde o comando de instalação VDA está localizado. O comando de instalação é XenDesktopVdaSetup.exe no ISO do produto completo, 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 resultados centralmente para revisão e análise, os scripts precisam de acesso Todos Leem/Gravam 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 de script, o log do instalador e os logs de instalação do MSI. Cada tentativa de instalação ou remoção é gravada 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 de pesquisa de diretório padrão para encontrar uma instalação ou remoção com falha no compartilhamento de log central. Essas ferramentas oferecem uma alternativa para pesquisar localmente nas máquinas de destino.

Antes de iniciar uma instalação, leia e complete as tarefas em Preparar a instalação.

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 para instalar: SET DESIREDVERSION. Por exemplo, a versão 7 pode ser especificada como 7.0. 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 estão incluídas por padrão no script e são necessárias: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT.
  3. Usando scripts de inicialização de políticas de grupo, atribua o script à unidade organizacional que contém suas máquinas. Essa UO deve conter somente máquinas nas quais você deseja instalar o VDA. Quando as máquinas nessa UO são reinicializadas, o script é executado em todas elas. Um VDA é instalado em cada máquina que possui um sistema operacional suportado.

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 para remover: SET CHECK\_VDA\_VERSION. Por exemplo, a versão 7 pode ser especificada como 7.0. 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 scripts de inicialização de políticas de grupo, atribua o script à unidade organizacional que contém suas máquinas. Essa UO deve conter somente máquinas das quais você deseja remover o VDA. Quando as máquinas na UO são reinicializadas, 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 em geral está funcionando. Se o log não for copiado para o compartilhamento de log central como esperado, inspecione a máquina local mais detalhadamente. O script coloca dois arquivos de log de depuração na pasta %temp% de cada máquina:

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

    Revise os logs para assegurar-se de que o script:

    • Está em execução como esperado.
    • Detecta adequadamente o sistema operacional de destino.
    • Está configurado corretamente para apontar para ROOT do compartilhamento DEPLOYSHARE (contém o arquivo chamado AutoSelect.exe).
    • É capaz de se autenticar nos dois compartilhamentos: DEPLOYSHARE e LOG.
  • Para obter informações sobre como a Citrix reporta o resultado de instalações de componentes, consulte Códigos de retorno da instalação Citrix.

  • Na tela do Studio de um grupo de entrega, a entrada Installed VDA version no painel Details pode não refletir a versão instalada nas máquinas. A exibição de programas e recursos da máquina mostra a versão real do VDA.

  • Depois que um VDA é instalado, 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