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:
- Leia este artigo inteiro, para saber o que esperar.
- Leia a política de ciclo de vida do Citrix DaaS.
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:
- Instaladores de VDA
- Instalar VDAs usando a interface gráfica
- Instalar VDAs usando a linha de comando
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 emVDAWorkstationCoreSetup.exe
. Lembre-se de que alguns desses recursos podem estar ativados por padrão no instaladorVDAWorkstationSetup.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.
Se o agente falhar na atualização automática, faça login no VDA e atualize o agente manualmente da seguinte forma:
-
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-->
-
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:
-
Localize o arquivo de configuração do VDA Upgrade Agent em:
C:\Program Files\Citrix\CitrixUpgradeAgent\Citrix.UpdateServices.UpdateAgent.exe.config
. -
Abra o arquivo de configuração usando um editor de texto.
-
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-->
-
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:
-
Ative a atualização de VDA para um catálogo.
- Você pode ativar a atualização do VDA ao criar um catálogo.
- Você pode ativar a atualização do VDA ao editar um catálogo.
-
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:
-
Vá até a pasta
C:\Program Files\Citrix\CitrixUpgradeAgent
. -
Abra o arquivo
Citrix.UpdateServices.UpdateAgent.exe.config
. -
Mude o valor de
LogToFile
para1
. -
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
como0
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:
-
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.
-
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:
-
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.
-
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
eStateId
(status deUpgrade 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) eStateId
(status deUpgrade 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 deGet-BrokerMachine
. -
Get-VusAvailableVdaVersion
Use esse cmdlet para verificar a versão mais recente do CR/LTSR lançada pelo VDA Update Service.
-
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 verificarUpgradeState
das máquinas em um catálogo.Exemplo: -
Get-VusMachine -CatalogName test-catalog
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 cmdletGet-VusComponentVersion
para verificar se o VDA relatou versões do componente. -Get-VusComponentVersion -MachineId ""
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 definirScheduledTimeInUtc
. -
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
eMachineName
para agendar a atualização do VDA. -
-
Verifique o status do upgrade.
Exemplo: -
Get-VusMachine -MachineName test-machine-1
Exemplos de cmdlet no nível de catálogo
-
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 verificarUpgradeState
das máquinas em um catálogo:Exemplo: -
Get-VusCatalog -Name test-catalog
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 cmdletGet-VusComponentVersion
para verificar se o VDA relatou versões do componente. -Get-VusComponentVersion -MachineId ""
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 definirScheduledTimeInUtc
. -
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
eUuid
para agendar a atualização. -
-
Verifique o status do upgrade. Use o cmdlet
Get-VusCatalog
ouGet-VusMachine
para verificar periodicamente o status do upgrade do VDA. UseMachineUuid
,MachineUid
eMachineName
para filtrar os VDAs.Exemplo: -
Get-VusCatalog -Name test-catalog
Use
Get-VusMachine
para ver o status de atualização do VDA de cada máquina em um catálogo.
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.