Atualizar VDAs usando o Serviço de Atualização de VDA
Você pode iniciar atualizações de VDA por meio do serviço de atualização de VDA selecionando o catálogo de máquinas de destino, uma máquina individual ou um grupo de máquinas e, em seguida, selecionando “Atualizar VDAs”.
Observação:
A Citrix® recomenda fazer backup dos VDAs antes de realizar atualizações, sempre que possível.
Agendando Atualizações
O processo de atualização de VDA no Citrix pode ser realizado no nível do catálogo, no nível do grupo de máquinas ou no nível da máquina individual, dependendo dos requisitos. As atualizações podem ser configuradas para iniciar imediatamente ou podem ser agendadas para uma data e hora com até 7 dias de antecedência.
Considerações
-
Escopo de Catálogo vs. Grupo de Máquinas vs. Máquina: As atualizações de catálogo são ideais para atualizações em massa, enquanto a atualização de máquinas individualmente ou por grupos permite um controle mais granular.
-
Agendamento: As atualizações podem ser agendadas com até 7 dias de antecedência. Se estiver usando atualizações no nível do catálogo de máquinas, as máquinas adicionadas ao catálogo após o agendamento da atualização não serão incluídas como parte da atualização agendada existente.
Principais Diferenças
| Recurso | Atualização por Catálogo | Atualização por Máquina | Grupo de Máquinas |
|---|---|---|---|
| Escopo das atualizações | Catálogo inteiro | Máquina individual | Grupo de máquinas de um Catálogo de Máquinas |
| Controle de agendamento | Um único agendamento se aplica a todos os VDAs no catálogo de máquinas, ideal para operações de atualização em larga escala | Os VDAs são agendados individualmente, o que é usado principalmente para testes e atualizações únicas | Os VDAs são agendados em grupos, dando a você a flexibilidade de atualizar diferentes grupos de VDAs em momentos diferentes |
| Gerenciamento | Gerenciado por meio do nó de catálogos de máquinas no Web Studio ou do cmdlet New-VusCatalogSchedule
|
Gerenciado por meio do nó “Pesquisar” no Web Studio ou do cmdlet New-VusMachineUpgrade
|
Gerenciado por meio do nó “Pesquisar” no Web Studio, ou passando uma lista de máquinas para o cmdlet New-VusMachineUpgrade
|
| Caso de Uso | Atualizações em massa para um Catálogo de Máquinas inteiro | Controle granular para atualizações direcionadas e cenários de teste | Controle direcionado de um subconjunto de VDAs. Pode ser usado para escalonar as atualizações dentro de um catálogo |
| Versões de VDA disponíveis | Para CR e todas as versões LTSR de VDA atualmente suportadas, a versão mais recente, bem como as 2 versões anteriores (N-2), estão disponíveis para atualização. Consulte VDA versions available para obter mais informações | Para CR e todas as versões LTSR de VDA atualmente suportadas, a versão mais recente, bem como as 2 versões anteriores (N-2), estão disponíveis para atualização. Consulte VDA versions available para obter mais informações | Apenas a versão LTSR ou CR de VDA mais recente está disponível para atualização |
| Componentes Adicionais | Instala ou atualiza componentes de VDA em cada VDA. Deixar um componente desmarcado não desinstalará o recurso, mas o componente não será atualizado | Instala ou atualiza o componente de VDA no VDA. Deixar um componente desmarcado não desinstalará o recurso, mas o componente não será atualizado | Componentes adicionais não podem ser gerenciados pelo serviço de atualização de VDA ao atualizar um grupo de máquinas. Observação: Recursos adicionais, como “Habilitar Limpeza de Restauração”, estão disponíveis para atualizações de grupo de máquinas |
| Recursos Adicionais | Recursos adicionais podem ser habilitados ou atualizados | Recursos adicionais podem ser habilitados ou atualizados | Recursos adicionais podem ser habilitados ou atualizados |
| Concorrência | Controlado como uma configuração ao agendar a atualização. Consulte Concurrency para obter mais informações | Um único VDA é atualizado | Balanceamento de carga automático com base no número de VDAs selecionados como parte do agendamento da atualização |
| Limite de Falha | Um limite de falha pode ser definido para evitar futuras atualizações se um número fornecido de VDAs falhar nas atualizações. Consulte Failure Threshold para obter mais informações | Limites de falha não são aplicáveis para uma atualização por máquina | Limites de falha não estão disponíveis para atualizações de grupo de máquinas. Considere definir o tamanho do grupo de máquinas a ser atualizado para ser o número máximo de VDAs que seria uma quantidade aceitável de falhas |
Como funcionam as atualizações agendadas
O Agente de Atualização de VDA nos VDAs se comunica periodicamente com os Delivery Controllers para determinar se o VDA deve ser atualizado. Os VDAs podem ser agendados para atualização imediata ou com até 7 dias de antecedência. Ao agendar uma atualização com antecedência, você pode definir a data e a hora (em UTC) em que a atualização começa.
A duração da atualização define o período de tempo após o horário de início da atualização agendada durante o qual as atualizações ocorrem. Por padrão, para atualizações de catálogo de máquinas e grupo de máquinas, o Citrix equilibra a carga das atualizações de VDA durante a duração da atualização para melhorar o desempenho e evitar gargalos.
Assim que uma atualização começa, o VDA é colocado em modo de manutenção até que a atualização seja concluída. Se houver uma sessão presente no VDA, o VDA não será atualizado até que não haja sessões. Nenhuma nova sessão pode ser intermediada para o VDA quando ele está em modo de manutenção. Se um usuário se desconectar de uma sessão durante uma janela de atualização, o usuário não poderá se reconectar até que a atualização seja concluída.
O VDA continuará tentando uma atualização até que a duração da atualização agendada seja concluída. Se uma sessão estiver presente durante toda a duração da atualização, a atualização será cancelada e o modo de manutenção será desativado para o VDA. Considere uma duração de atualização mais longa para melhorar a taxa de sucesso da atualização do VDA.
Observação:
VDAs colocados manualmente em modo de manutenção antes de uma atualização agendada falharão na atualização.
Versões de VDA Disponíveis
O serviço de atualização de VDA mantém as versões N-2 do VDA para versões CR e as versões N-2 CU para todas as versões LTSR que são atualmente suportadas.
Quando uma nova versão do CVAD é lançada, você pode atualizar o VUS para incluir versões mais recentes do VDA sem atualizar todo o seu Site. O VUS usa um arquivo vda_releases.xml para preencher as versões de VDA disponíveis. O arquivo vda_releases.xmld está disponível no metainstaller do CVAD no seguinte local:
<CVAD-ISO>\Support\VdaUpdateServiceMetadata\vda_releases.xml
Para importar o arquivo vda_releases.xml mais recente para o VUS, execute o seguinte cmdlet:
Import-VusVdaReleasesMetadata -Path ‘[Path to vda_releases.xml]’
No Web Studio, ao atualizar um catálogo ou uma máquina individual, a interface do usuário solicita a versão para a qual você deseja atualizar seus VDAs.

Para determinar as versões de VDA disponíveis usando o PowerShell, use o cmdlet Get-VusAvailableVdaVersion.
Sem passar uma máquina ou um catálogo com o cmdlet, o cmdlet retornará a versão mais recente disponível para todas as trilhas de atualização.
Para obter as versões específicas disponíveis para um recurso, passe um VDA (-MachineName, -MachineUid ou -MachineUuid) ou catálogo (-CatalogName, -CatalogUid ou -CatalogUuid) com o cmdlet Get-VusAvailableVdaVersion.
Por exemplo:
Get-VusAvailableVdaVersion -CatalogName ‘[Name of your Machine Catalog]’

Componentes Adicionais
Componentes adicionais podem ser instalados ou atualizados ao atualizar VDAs por catálogo de máquinas ou por máquina individual. Se você não marcar um componente, ele não desinstalará o componente, mas o componente não será atualizado como parte da atualização geral do VDA.

Recursos
Recursos podem ser habilitados ou atualizados em VDAs por meio do serviço de atualização de VDA. Se você não marcar um recurso, ele não desabilitará o recurso, mas o recurso não será atualizado como parte da atualização geral do VDA.
Por padrão, a caixa de seleção “Habilitar limpeza de restauração” está selecionada. A Citrix recomenda habilitar o recurso de limpeza de restauração para facilitar o gerenciamento e melhorar a recuperação de atualizações com falha. Com o recurso habilitado, um ponto de restauração do sistema é criado antes do início da atualização. Se uma atualização falhar, o VDA é restaurado para o ponto de restauração do sistema. O ponto de restauração é excluído após a instalação bem-sucedida do VDA. Para obter mais informações, consulte Restore on install or upgrade failure.

Observação:
A Restauração do Sistema Windows é suportada apenas em sistemas operacionais de sessão única (por exemplo, Windows 10 e 11). O recurso Restauração do Sistema Windows deve estar habilitado no VDA para que o recurso “Habilitar limpeza de restauração” funcione. As atualizações podem falhar se “Habilitar restauração” ou “Habilitar limpeza de restauração” estiver selecionado, mas a Restauração do Sistema Windows não estiver configurada no VDA.
Concorrência
Ao atualizar catálogos de máquinas, o VUS permite que você defina um número máximo de VDAs que serão atualizados simultaneamente. Isso pode ajudar a reduzir a carga em sua conexão com a internet ou servidor de arquivos e, quando usado em conjunto com limites de falha, permite que você interrompa as atualizações se um número de VDAs falhar na atualização.
Assim que a atualização agendada começa, todos os VDAs no catálogo são colocados em modo de manutenção. Uma atualização começará em uma quantidade de VDAs que corresponde à configuração máxima de concorrência definida. Assim que uma atualização de VDA for concluída, outro VDA começará a ser atualizado para manter o número concorrente de VDAs sendo atualizados simultaneamente.
Se nenhuma concorrência for especificada para uma atualização agendada de catálogo de máquinas, a Citrix usa um valor de concorrência padrão com base no número total de VDAs no Catálogo e na duração da atualização.
As atualizações levam em média cerca de 30 minutos para serem concluídas, mas isso pode variar muito dependendo das condições ambientais. Considere definir sua concorrência para uma quantidade em que todos os VDAs possam ser atualizados na duração da atualização fornecida. Por exemplo, se você tiver 20 VDAs que devem ser atualizados em 4 horas, você precisa de 5 VDAs para atualizar por hora. Usando a duração média de atualização de 30 minutos, você pode definir o valor de concorrência para 3 para atender ao requisito de 5 atualizações de VDA por hora (3 atualizações a cada 30 minutos resultam em 6 atualizações por hora).
Limite de Falha
Ao atualizar catálogos de máquinas, use um limite de falha para evitar que mais VDAs sejam atualizados se um determinado número de VDAs tiver falhado. Os limites de falha podem reduzir o raio de impacto de problemas que causam falhas de atualização, diminuindo os esforços de solução de problemas para os administradores.
Os limites de falha impedem que quaisquer VDAs futuros iniciem atualizações, mas não interrompem os VDAs que já iniciaram a atualização. Por exemplo, se um catálogo de máquinas tiver 100 VDAs, a concorrência for definida para 10 VDAs e o limite de falha for definido para 3, se todas as atualizações de VDA falharem, pelo menos 13 VDAs terão tentado atualizar, e os 87 restantes nunca terão iniciado, e a atualização será cancelada.
10 VDAs concorrentes começam a ser atualizados no início da atualização agendada; se a primeira atualização falhar, outro VDA iniciará a atualização para manter as 10 atualizações simultâneas concorrentes. Se a segunda atualização falhar, outro VDA iniciará a atualização. Se a terceira atualização falhar, todos os VDAs que estão atualmente no processo de atualização continuarão, e o restante dos VDAs no agendamento da atualização terá sua atualização cancelada.
Local do Instalador do VDA
O instalador do VDA deve ser hospedado em um compartilhamento de arquivos local em seu ambiente. Os requisitos para o compartilhamento de arquivos e o instalador do VDA estão listados abaixo:
O compartilhamento de arquivos deve ter os seguintes pré-requisitos.
- Permissões de Compartilhamento de Arquivos
- Os compartilhamentos de rede que contêm pacotes de instaladores de VDA devem ter acesso de leitura para o serviço VDA Upgrade Agent, que é executado como Sistema Local (principal NT AUTHORITY\SYSTEM).
- VDAs Associados ao Domínio:
- A conta do Sistema Local (o VUA é executado como Sistema Local) usa credenciais de computador ao acessar compartilhamentos de rede.
- O compartilhamento de arquivos deve ter acesso de leitura para “Computadores do Domínio”.
- Nas “Configurações Avançadas de Compartilhamento”, “Compartilhamento de Arquivos e Impressoras” deve estar habilitado.
- VDAs Não Associados ao Domínio:
- A conta do Sistema Local (o VUA é executado como Sistema Local) usa ANONYMOUS LOGON ao acessar compartilhamentos de rede.
- No “Centro de Rede e Compartilhamento”, “Compartilhamento Protegido por Senha” deve estar desabilitado.
- Na guia “Segurança” das permissões da pasta, as permissões de acesso de leitura devem ser concedidas a ANONYMOUS LOGON.
- Nas “Configurações Avançadas de Compartilhamento”, “Compartilhamento de Arquivos e Impressoras” deve estar habilitado.
- O nome da pasta compartilhada deve ser adicionado à “Política de Segurança de Acesso à Rede”.
- Instalador do VDA
- O instalador do VDA deve ser baixado do site Citrix Downloads e colocado no compartilhamento de arquivos.
- O instalador de VDA relevante para o catálogo de máquinas deve ser baixado.
- Use o instalador de VDA de SO multi-sessão se o tipo de catálogo for multi-sessão.
- Use o instalador de VDA de SO de sessão única se o tipo de catálogo for sessão única.
- Para uma determinada atualização, a versão do instalador no compartilhamento de arquivos deve corresponder exatamente a uma versão publicada pelo VUS. Use o cmdlet PowerShell
Get-VusAvailableVersionpara determinar as versões disponíveis.
O caminho para o instalador deve ser um caminho de arquivo que inclua o executável. Por exemplo, \\hostname\VDA-Packages\VDAWorkstationSetup_2308.exe.

Ao usar o VUS via PowerShell, use o parâmetro -VdaWorkstationPackageUri (SO de sessão única) ou -VdaServerPackageUri (SO multi-sessão) ao agendar sua atualização.
Forçar Logoff de Sessões
Para aumentar o número de VDAs disponíveis para atualização durante uma atualização agendada, considere forçar o logoff das sessões de usuário durante a atualização. O logoff forçado ocorre quando a atualização começa para cada VDA individual, não no início da janela geral de atualização agendada.
Como diferentes VDAs começam a ser atualizados em momentos diferentes dentro do período agendado, os usuários só serão desconectados quando seu VDA específico iniciar a atualização.
Para forçar o logoff de sessões desconectadas durante atualizações agendadas usando o Web Studio, selecione a opção “Fazer logoff de sessões desconectadas”.
Para forçar o logoff de sessões ativas durante atualizações agendadas usando o Web Studio, selecione a opção “Fazer logoff de sessões ativas”. Se estiver fazendo logoff de sessões ativas, os usuários receberão uma notificação em sua sessão 10 minutos antes do início da atualização, lembrando-os de salvar seu trabalho antes de serem desconectados automaticamente.

Para forçar o logoff de sessões desconectadas durante atualizações agendadas usando o PowerShell, use o parâmetro -LogoffOption ao agendar sua atualização. As opções disponíveis para -LogoffOption estão listadas abaixo:
- ActiveSessionsOnly: Se uma sessão ativa estiver no VDA durante a janela de atualização agendada, o usuário será desconectado. Um banner será exibido 10 minutos antes de o usuário ser desconectado para fornecer um aviso. VDAs com sessões desconectadas não serão desconectados durante a janela de atualização. Se a sessão desconectada permanecer durante toda a janela de atualização, a atualização desse VDA será cancelada.
- DisconnectedSessionsOnly: Se uma sessão desconectada estiver presente no VDA durante a janela de atualização agendada, o usuário será desconectado. Os usuários não são notificados de que sua sessão desconectada será desconectada. VDAs com sessões ativas não serão desconectados durante a janela de atualização. Se a sessão ativa permanecer durante toda a janela de atualização, a atualização desse VDA será cancelada.
- ActiveAndDisconnectedSessions: Se uma sessão desconectada ou ativa estiver no VDA durante a janela de atualização agendada, o usuário será desconectado. Para sessões ativas, um banner será exibido 10 minutos antes de o usuário ser desconectado para fornecer um aviso.
- DoNotLogoff: Sessões ativas e desconectadas não são desconectadas. Se uma sessão estiver presente no VDA durante toda a duração do agendamento da atualização, a atualização será cancelada no final da janela de atualização agendada.
Sempre que possível, a Citrix recomenda forçar o logoff de sessões para aumentar o número de VDAs que são atualizados com sucesso.
Importante:
Forçar o logoff de sessões pode resultar na perda de trabalho não salvo pelos usuários em suas sessões.
Editar ou Cancelar o Fluxo de Trabalho do VDA
Depois de agendar as atualizações para um catálogo, você pode editar a hora de início e a duração da atualização ou cancelá-la completamente.
Para editar ou cancelar uma atualização usando a interface do usuário no nível do catálogo de máquinas, clique com o botão direito do mouse em um catálogo de máquinas com uma atualização agendada existente e clique em “Editar Atualização Agendada de VDA”. Para editar uma atualização existente no nível do catálogo de máquinas usando o PowerShell, use os cmdlets Set-VusCatalogUpgrade e Remove-VusCatalogUpgrade.
Para editar ou cancelar uma atualização no nível da máquina, no nó “Pesquisar”, clique com o botão direito do mouse em uma máquina com uma atualização agendada existente e clique em “Editar Atualização Agendada de VDA”. Você não pode editar a atualização agendada de VDA para várias máquinas simultaneamente. Para editar uma atualização existente no nível da máquina usando o PowerShell, use os cmdlets Set-VusMachineUpgrade e Remove-VusMachineUpgrade.