Citrix DaaS

Upgrade de VDAs

Introdução

A Citrix mantém todos os componentes do Citrix DaaS (anteriormente Citrix Virtual Apps and Desktops Service) em sua implantação, exceto VDAs.

Antes de iniciar uma atualização do VDA:

Para atualizar um VDA, baixe um instalador de VDA e execute-o na máquina ou na imagem. Você pode usar a interface gráfica ou de linha de comando do instalador. Para obter orientação, consulte:

Se o VDA foi originalmente instalado usando VDAWorkstationCoreSetup.exe:

  • Você manterá essa configuração se atualizar o VDA com a versão mais recente do mesmo instalador.
  • Se você executar VDAWorkstationSetup.exe nessa máquina, poderá ativar os recursos que não são suportados em VDAWorkstationCoreSetup.exe. Lembre-se de que alguns desses recursos podem estar ativados por padrão no instalador VDAWorkstationSetup.exe. Você também pode instalar o aplicativo Citrix Workspace.

Nota:

Ao atualizar um VDA para a versão 7.17 ou uma versão posterior suportada, ocorre a reinicialização da máquina durante o processo de atualização. Essa reinicialização não pode ser evitada. A atualização é retomada automaticamente após a reinicialização (a menos que você especifique /noresume na linha de comando).

Depois de atualizar o VDA, atualize as imagens e os catálogos que usam esse VDA.

Atualizar VDAs usando a interface Full Configuration

Importante:

  • Uma boa prática que recomendamos é que você teste minuciosamente as atualizações do VDA antes de entrar em produção.
  • Você pode alternar entre o VDA CR e o VDA LTSR, desde que a mudança seja de uma versão anterior para uma versão posterior. Você não pode mudar de uma versão posterior para uma versão anterior porque isso é considerado um downgrade. Por exemplo, você não pode fazer o downgrade de 2212 CR para 2203 LTSR (qualquer CU), mas pode fazer o upgrade de 2112 CR para 2203 LTSR (qualquer CU).
  • Não há suporte para atualizações sob demanda (como hotfixes e patches entre as principais versões).

Usando a interface Full Configuration, você pode atualizar VDAs por catálogo ou por máquina. Você pode atualizá-los imediatamente ou em um horário agendado.

Para saber mais sobre o serviço de atualização do VDA, consulte Tech Brief: Citrix VDA Upgrade service. Você encontrará uma visão geral do serviço, informações detalhadas sobre como ele funciona e outros recursos úteis.

Pré-requisitos

  • Plano de controle: Citrix DaaS
  • Tipo de VDA: VDA com SO de sessão única ou multissessão
  • Versão do VDA: 2109 ou posterior, ou 2203 LTSR ou posterior

    Nota:

    Recomendamos usar o CR VDA mais recente ou o LTSR CU VDA mais recente.

  • Tipo de provisionamento: máquinas persistentes (como máquinas provisionadas por MCS, máquinas de acesso ao PC remoto, Citrix HDX Plus para Windows 365). Consulte Tipos de máquinas compatíveis.
  • Os VDAs devem ter o VDA Upgrade Agent instalado e o serviço deve estar em execução.
  • Você ter permissões para atualizar VDAs.
  • A atualização do VDA estar configurada com a trilha CR ou LTSR adequada em Full Configuration.
  • Os VDAs não estarem em uso. (Os usuários devem se desconectar deles.)

    Nota:

    Os upgrades são ignorados para quaisquer VDAs que estejam em uso ou em estado desconectado. Recomendamos agendar uma janela de atualização e solicitar que os usuários se desconectem dos VDAs.

  • Os VDAs não estarem no modo de manutenção. (O VDA pode ser colocado em modo de manutenção por um administrador. O VDA também pode ser colocado automaticamente no modo de manutenção se tiver excedido o máximo permitido de tentativas de registro.)
  • URLs relevantes adicionadas à lista de permissões se a filtragem de URL estiver em vigor. Consulte Requisito para atualização do VDA.
  • Os VDAs devem pertencer a um grupo de entrega e estar registrados no DaaS.
  • O nível funcional é definido corretamente para que o recurso de atualização do VDA esteja disponível para uso. Consulte Versões do VDA e níveis funcionais.
  • O VDA de destino suporta o sistema operacional do VDA atual.

Problemas conhecidos

Problema 1: Falha ao atualizar VDAs LTSR para versões de atualização cumulativa (CU) LTSR

As tentativas de atualizar VDAs LTSR para versões de atualização cumulativa (CU) LTSR podem falhar. Embora o processo de atualização pareça ter sido concluído com êxito na Full Configuration, a versão instalada do VDA não muda e o status volta para Upgrade Available após um ou dois minutos. O problema ocorre com VDAs que têm o VDA Upgrade Agent versão 7.35.0.7 ou anterior instalado.

Para contornar o problema, faça login no VDA e atualize o VDA Upgrade Agent para a versão 7.37.0.7 ou posterior (usando o instalador do VDA versão 2303 ou posterior). A partir da versão 7.37.0.7, o VDA Upgrade Agent oferece suporte à atualização automática para que agentes de versões anteriores executadas nos VDAs possam atualizar automaticamente para a versão mais recente. Com esse recurso de atualização automática, o serviço de atualização do VDA verifica a versão do VDA relatada pelo agente e, em seguida, agenda as atualizações para dentro de uma hora para atualizar automaticamente o agente para a versão mais recente. Esse recurso de atualização automática reduz seu esforço de manutenção.

Para que o agente no VDA seja atualizado automaticamente, certifique-se de fazer logoff das sessões para que o serviço de atualização do VDA possa iniciar as atualizações automáticas. Você pode fazer logoff das sessões em Full Configuration.

Fazer logoff das sessões em Full Configuration

Se o agente falhar na atualização automática, faça login no VDA e atualize o agente manualmente da seguinte forma:

  1. Execute o seguinte cmdlet para exibir o VDA Upgrade Agent no Painel de controle > Desinstalar ou alterar um programa.

    (Get-ChildItem  -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall' | ? { $\_.GetValue('DisplayName') -eq 'Citrix VDA Upgrade Agent Service - x64' }).GetValue('SystemComponent')
    (Get-ChildItem  -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall' | ? { $\_.GetValue('DisplayName') -eq 'Citrix VDA Upgrade Agent Service - x64' }) | Set-ItemProperty -Name SystemComponent -Value 0
    <!--NeedCopy-->
    
  2. Instale o VDA Upgrade Agent mais recente. Para realizar uma instalação silenciosa, use o seguinte cmdlet:

    • msiexec /i CitrixUpgradeAgent_x64.msi /q

Você pode identificar a versão do VDA Upgrade Agent usando o cmdlet ou um script. Consulte Solução de problemas.

Problema 2: Proxy não suportado

Atualmente, o VDA Upgrade Agent não oferece suporte a configurações de proxy. Essa limitação pode causar problemas de conectividade quando o agente tenta estabelecer conexões por meio de um servidor proxy.

Você pode aplicar uma solução alternativa para resolver o problema. Siga as etapas abaixo:

  1. Localize o arquivo de configuração do VDA Upgrade Agent em: C:\Program Files\Citrix\CitrixUpgradeAgent\Citrix.UpdateServices.UpdateAgent.exe.config.

  2. Abra o arquivo de configuração usando um editor de texto.

  3. Adicione as seguintes linhas no final do arquivo, substituindo ProxyServerName pelo nome real do servidor proxy:

    <system.net>
      <defaultProxy enabled="true" useDefaultCredentials="true">
        <proxy proxyaddress="http://PROXYSERVER:PORT" usesystemdefault="false" />
      </defaultProxy>
    </system.net>
    </configuration>
    <!--NeedCopy-->
    
  4. Reinicie o serviço Citrix VDA Upgrade Agent para aplicar a configuração atualizada.

Fluxo de trabalho geral

Um fluxo de trabalho geral para atualizar VDAs usando a interface Full Configuration é o seguinte:

  1. Ative a atualização de VDA para um catálogo.

  2. Atualize os VDAs por catálogo ou por máquina. Para obter mais informações, consulte Configurar o upgrade automático para VDAs.

    Nota:

    Ao programar atualizações de VDA para um catálogo, esteja ciente de que todas as máquinas do catálogo serão incluídas no escopo de atualização. Portanto, recomendamos fazer backup dessas máquinas antes de iniciar a atualização.

Solução de problemas

Se ocorrerem falhas de atualização, você pode usar os seguintes logs para solucionar problemas sozinho ou fornecer os logs ao entrar em contato com o Suporte Técnico Citrix para obter assistência.

  • Logs de instalação para instalação inicial do VDA em %temp%/Citrix/XenDesktop Installer

  • Logs de atualização em C:\Windows\Temp\Citrix\XenDesktop Installer

Para verificar as versões do VDA Upgrade Agent, use o seguinte cmdlet: Get-VusComponentVersion -ComponentType VUS. Ele lista todos os VDAs e suas versões do VDA Upgrade Agent.

Para obter os nomes do VDA, use o seguinte cmdlet: Get-BrokerMachine -UUID "<version number>", onde <version number> está a versão do VDA Upgrade Agent que você obtém do cmdlet Get-VusComponentVersion.

Para verificar as versões do VDA Upgrade Agent no nível de catálogo, você pode usar o seguinte script:

Nota:

O script serve como exemplo e talvez precise ser adaptado para se adequar ao seu ambiente específico. Recomendamos que você teste o script minuciosamente antes de usá-lo em um ambiente de produção.

Param(
    [Parameter (Mandatory=$true)]
    [string] $CatalogName
)

try
{
    $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID

    if($Uuids -eq $null)
    {
        throw "Cannot find CatalogName "+$CatalogName
    }
    Write-Output("Catalog Name passed is "+$CatalogName)

   foreach($Uuid in $Uuids)
    {
        $compVersion = Get-VusComponentVersion -MachineId $machine.UUID -ComponentType VUS
        $Machine = Get-BrokerMachine -UUID $compVersion.MachineId
        Write-Output("MachineName: "+$Machine.MachineName+", Machine UUID:"+$machine.MachineId+", VUA Version:"+$compVersion.Version)
    }
}
catch
{
    Write-Output("Exception Occured")
    Write-Host $_
}
<!--NeedCopy-->

Logs relacionados ao VDA Upgrade Agent

Você também pode coletar logs relacionados ao VDA Upgrade Agent. Os logs que você pode coletar incluem:

  • Rastreamentos do Citrix Diagnostic Facility (CDF).
  • Logs de eventos do Windows. Informações gravadas no Log de Eventos do Windows. Veja os logs em Event Viewer > Applications and Services Logs > Citrix VDA Upgrade Agent Service.

Se necessário, você pode modificar o arquivo de configuração do VDA Upgrade Agent para que os logs sejam gravados continuamente em um arquivo. Para habilitar o registro em log em um arquivo, siga estas etapas:

  1. Vá até a pasta C:\Program Files\Citrix\CitrixUpgradeAgent.

  2. Abra o arquivo Citrix.UpdateServices.UpdateAgent.exe.config.

  3. Mude o valor de LogToFile para 1.

  4. Reinicie o serviço Citrix VDA Upgrade Agent. Isso cria um arquivo de log em: C:\ProgramData\Citrix\Update Services\Logs.

Nota:

  • A ativação do registro em log em um arquivo grava logs continuamente, potencialmente consumindo espaço de armazenamento. Lembre-se de desativar o registro em log depois que o problema for resolvido. Para desativar o registro em log, primeiro defina LogToFile como 0 e reinicie o serviço Citrix VDA Upgrade Agent.
  • Quando LogToFile=1 estiver definido, os logs serão gravados somente no arquivo. Eles não aparecerão nos rastreamentos de CDF.

Solucionar falhas de download de atualização do VDA

Siga as etapas abaixo para solucionar e resolver falhas de download relacionadas ao recurso de atualização do VDA:

  1. Confirme que as URLs relevantes foram adicionadas à lista de permissões se a filtragem de URL estiver em vigor. Consulte Requisito para atualização do VDA.

  2. Depois de adicionar as URLs necessárias à lista de permissões, tente reagendar a atualização do VDA.

Você pode ativar o rastreamento de CDF ou definir LogToFile como 1 para capturar logs detalhados para análise. Se o problema de falha no download persistir, verifique os erros. Se você vir a seguinte mensagem de erro “Download Failed: This access control list is not in canonical form and therefore cannot be modified”, isso indica que as permissões na pasta C:/ProgramData/Citrix/UpgradeServices/Downloads/VDA estão incorretas. Para resolver o problema, faça o seguinte:

  • Opção 1: redefina as listas de controle de acesso (ACLs) na pasta usando o comando a seguir. (O comando redefine as ACLs com ACLs herdadas padrão para todos os arquivos correspondentes.)

    • icacls.exe "C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA" /reset /T /C /L /Q
  • Opção 2: exclua a pasta VDA em Downloads e agende a atualização do VDA.

Solucionar falhas de validação de atualização do VDA

Siga as etapas abaixo para solucionar e resolver falhas de download relacionadas ao recurso de atualização do VDA:

  1. Certifique-se de que as URLs relevantes tenham sido adicionadas à lista de permissões se a filtragem de URL estiver em vigor, especialmente as URLs da Lista de Revogação de Certificados (CRL) ou do Protocolo OCSP (Online Certificate Status Protocol), necessárias para a verificação da revogação. Consulte Requisito para atualização do VDA.

  2. Depois de adicionar as URLs necessárias à lista de permissões, tente reagendar a atualização do VDA.

Sugerimos ativar o rastreamento de CDF ou configurar LogToFile como 1 para capturar registros detalhados para análise. Os logs podem incluir os seguintes erros:

  • RevocationStatusUnknown
  • A função de revogação não conseguiu verificar o status de revogação do certificado.
  • A função de revogação não conseguiu verificar a revogação porque o servidor de revogação estava offline.

O VDA Upgrade Agent depende das chamadas do sistema Windows para validar certificados e realizar verificações de revogação. Os erros acima indicam que o agente não consegue estabelecer uma conexão com as URLs da CRL ou do OCSP.

Observe que o VDA Upgrade Agent atualmente não oferece suporte a configurações de proxy. As chamadas de saída de CRL e OCSP feitas pela CryptoAPI não reconhecem as configurações de proxy, o que pode resultar em falhas.

Se o seu ambiente tiver uma configuração de proxy, você poderá configurar o proxy do sistema no VDA para facilitar as chamadas de saída de CRL. Siga as etapas abaixo para configurar o proxy do sistema:

netsh winhttp import proxy source=ie

Or

netsh winhttp set proxy proxy-server=http://Proxy_Server:Port
<!--NeedCopy-->

Upgrade de VDAs usando o PowerShell

Você pode configurar as atualizações do VDA usando o SDK do Remote PowerShell. Para obter mais informações sobre o SDK do Remote PowerShell, consulte Citrix DaaS Remote PowerShell SDK.

A seguir estão os cmdlets do PowerShell:

  • Get-VusCatalog

    Use esse cmdlet para obter detalhes de um catálogo como Name, Uid, Uuid, UpgradeState (Available, UpToDate, Scheduled, Unknown), UpgradeType (CR/LTSR), Upgrade scheduled e StateId (status de Upgrade scheduled).

  • Get-VusMachine

    Use esse cmdlet para obter detalhes de uma máquina como MachineName, Uid, Uuid, UpgradeState (Available, UpToDate, Scheduled, Unknown), UpgradeType (CR/LTSR) e StateId (status de Upgrade scheduled).

  • Get-VusComponentVersion

    Use esse cmdlet para verificar se os VDAs relataram as versões dos componentes. Use MachineId para filtrar os VDAs. MachineId é o UUID de Get-BrokerMachine.

  • Get-VusAvailableVdaVersion

    Use esse cmdlet para verificar a versão mais recente do CR/LTSR lançada pelo VDA Update Service.

    Exemplo de cmdlet Get-VusAvailableVdaVersion

  • Set-VusCatalogUpgradeType

    Use esse cmdlet para definir o tipo de upgrade de um catálogo para CR ou LTSR. O tipo de upgrade só pode ser definido no nível do catálogo de máquinas.

  • New-VusMachineUpgrade

    Use esse cmdlet para configurar upgrades do VDA no nível da máquina.

  • New-VusCatalogSchedule

    Use esse cmdlet para programar upgrades do VDA no nível do catálogo de máquinas.

Exemplos de cmdlets no nível da máquina

  • Defina o tipo de upgrade.

    Exemplo: - Set-VusCatalogUpgradeType -CatalogName test-catalog -UpgradeType LTSR

  • Use Get-VusMachine para verificar UpgradeState das máquinas em um catálogo.

    Exemplo: - Get-VusMachine -CatalogName test-catalog

    Exemplo de cmdlet Get-VusMachine

    Se você perceber que UpgradeState é Unknown, um possível motivo é que o Citrix VDA Upgrade Agent instalado no VDA não relatou a versão ao VDA Update Service. Você pode usar o cmdlet Get-VusComponentVersion para verificar se o VDA relatou versões do componente. - Get-VusComponentVersion -MachineId ""

    Exemplo de cmdlet Get-VusComponentVersion

    Se nenhum resultado for exibido, verifique o seguinte:

    • O VDA faz parte de um catálogo e grupo de entrega.
    • O VDA Upgrade Agent está instalado no VDA e em execução. Se necessário, tente reiniciar o agente.

    Nota: Se não houver resultados, colete os rastreamentos do Citrix Diagnostic Facility ao reiniciar o VDA Upgrade Agent e solucione os problemas.

  • Agende atualizações do VDA. Antes de começar, esteja ciente do seguinte:

    • DurationInHours: permite que você forneça a duração em horas do processo de upgrade. Os VDAs serão colocados no modo de manutenção. O instalador do VDA será baixado e a atualização será realizada. Forneça uma duração mais longa se houver muitos VDAs a serem atualizados.
    • UpgradeNow: use essa opção para agendar um upgrade imediatamente ou definir ScheduledTimeInUtc.
    • ScheduledTimeInUtc: permite que você agende um upgrade para uma data e hora específicas.

    Exemplo:

    • New-VusMachineUpgrade -MachineUuid d664614a-cd37-44d6-b1f0-6f6b70f8299c -ScheduledTimeInUtc ([System.DateTime]::ParseExact("06/23/2023 03:35 PM", 'MM/dd/yyyy hh:mm tt', $null)) -DurationInHours 2

    Você pode usar MachineUuid, MachineUid e MachineName para agendar a atualização do VDA.

    Exemplo de cmdlet New-VusMachineUpgrade

  • Verifique o status do upgrade.

    Exemplo: - Get-VusMachine -MachineName test-machine-1

    Atualização em andamento

    Sucesso na atualização

  • Defina o tipo de atualização no nível do catálogo de máquinas.

    Exemplo: - Set-VusCatalogUpgradeType -CatalogName test-catalog -UpgradeType LTSR

  • Use Get-VusCatalog para verificar UpgradeState das máquinas em um catálogo:

    Exemplo: - Get-VusCatalog -Name test-catalog

    Exemplo de cmdlet Get-VusCatalog

    Se você perceber que UpgradeState é Unknown, um possível motivo é que o Citrix VDA Upgrade Agent instalado no VDA não relatou a versão ao VDA Update Service. Você pode usar o cmdlet Get-VusComponentVersion para verificar se o VDA relatou versões do componente. - Get-VusComponentVersion -MachineId ""

    Exemplo de cmdlet Get-VusComponentVersion

    Se nenhum resultado for exibido, verifique o seguinte:

    • O VDA faz parte de um catálogo e grupo de entrega.
    • O VDA Upgrade Agent está instalado no VDA e em execução. Se necessário, tente reiniciar o agente.

    Nota: Se não houver resultados, colete os rastreamentos do Citrix Diagnostic Facility ao reiniciar o VDA Upgrade Agent e solucione os problemas.

  • Agende atualizações do VDA. Antes de começar, esteja ciente do seguinte:

    • DurationInHours: permite que você forneça a duração em horas do processo de upgrade. Os VDAs no catálogo serão colocados no modo de manutenção. O instalador do VDA será baixado e a atualização será realizada em cada VDA. Forneça uma duração maior se o catálogo contiver muitos VDAs.
    • UpgradeNow: use essa opção para agendar um upgrade imediatamente ou definir ScheduledTimeInUtc.
    • ScheduledTimeInUtc: permite que você agende um upgrade para uma data e hora específicas.

    Exemplo:

    • New-VusCatalogSchedule -CatalogName test-catalog -ScheduledTimeInUtc ([System.DateTime]::ParseExact("06/23/2023 04:00 PM", 'MM/dd/yyyy hh:mm tt', $null)) -DurationInHours 4

    Você pode usar CatalogName, Uid e Uuid para agendar a atualização.

    Exemplo de cmdlet New-VusCatalogSchedule

  • Verifique o status do upgrade. Use o cmdlet Get-VusCatalog ou Get-VusMachine para verificar periodicamente o status do upgrade do VDA. Use MachineUuid, MachineUid e MachineName para filtrar os VDAs.

    Exemplo: - Get-VusCatalog -Name test-catalog

    Get-VusCatalog – atualização em andamento

    Use Get-VusMachine para ver o status de atualização do VDA de cada máquina em um catálogo.

    Get-VusMachin – status de atualização de cada máquina

Se o VDA tiver o Personal vDisk instalado

Se o componente Personal vDisk (PvD) já tiver sido instalado em um VDA, esse VDA não poderá ser atualizado para a versão 1912 LTSR ou posterior até que você remova o componente.

Essa instrução se aplica mesmo que você nunca tenha usado o PvD. Veja como o componente PvD pode ter sido instalado em versões anteriores:

  • Na interface gráfica do instalador do VDA, o PvD era uma opção na página Additional Components. O 7.15 LTSR e versões 7.x anteriores habilitavam essa opção por padrão. Portanto, se você aceitou os padrões (ou ativou explicitamente a opção em alguma versão), o PvD foi instalado.
  • Na linha de comando, a opção /baseimage instalou o PvD. Se você especificou essa opção ou usou um script que continha essa opção, o PvD foi instalado.

O que fazer

Se o instalador de VDA não detectar o componente PvD no VDA instalado atualmente, a atualização prosseguirá como de costume.

Se o instalador detectar o componente PvD no VDA atualmente instalado:

  • Interface gráfica: a atualização pausa. Uma mensagem pergunta se você deseja que o componente não suportado seja removido automaticamente. Quando você clica em OK, o componente é removido automaticamente e a atualização prossegue.

  • CLI: o comando falha se o instalador detectar o componente PvD. Para evitar a falha do comando, inclua a seguinte opção no comando: /remove_pvd_ack.

Se você quiser continuar usando o PvD em suas máquinas Windows 10 (1607 e anteriores, sem atualizações), o VDA 7.15 LTSR é a versão mais recente suportada. Esteja ciente de que o programa de suporte estendido para XenApp e XenDesktop 7.15 LTSR não se aplica aos VDAs usados com o Citrix DaaS. Para obter mais informações, consulte o Extended Support Customer Guide no Citrix Support Knowledge Center.

Sistemas operacionais anteriores

O artigo Requisitos do sistema lista os sistemas operacionais Windows suportados pelos VDAs com a versão atual.

  • Para VDAs LTSR, consulte o artigo de requisitos do sistema para a sua versão LTSR.
  • Para Linux VDAs, consulte a documentação do Linux Virtual Delivery Agent.

Para computadores Windows com sistemas operacionais que não têm mais suporte para instalação do VDA mais recente, você tem as seguintes opções.

Para ambientes não WVD:

  • Refaça a imagem da máquina para uma versão compatível do Windows e instale o novo VDA.
  • Se a nova imagem da máquina não for uma opção, mas você quiser atualizar o sistema operacional, desinstale o VDA antes de atualizar o sistema operacional. Caso contrário, o VDA estará em um estado sem suporte. Depois de atualizar o sistema operacional, instale o novo VDA.
  • Se a máquina tiver a versão 7.15 LTSR instalada (e você tentar instalar uma versão mais recente), uma mensagem informará que você está usando a versão mais recente suportada.
  • Se a máquina tiver uma versão anterior à 7.15 LTSR instalada, uma mensagem o levará até CTX139030 para obter informações. Você pode baixar VDAs 7.15 LTSR no site da Citrix.
Upgrade de VDAs