Monitoramento e Solução de Problemas

Monitoramento de Atualizações Agendadas de VDA

VDAs e catálogos de máquinas têm dois atributos para ajudar a monitorar a prontidão e o status atual das atualizações de VDA que são visíveis como colunas que podem ser usadas para filtrar no Studio ou no painel de detalhes dos VDAs ou catálogos.

• Atualização de VDA
• Estado da Atualização de VDA

Atualização de VDA

A Atualização de VDA fornece informações sobre se o VDA ou o catálogo de máquinas tem o agente de atualização de VDA configurado e se os VDAs estão atualizados ou se uma atualização está disponível. Os status disponíveis são os seguintes:

Nota:

Para VDAs usando a trilha LTSR, um catálogo só será exibido como Atualizado se os VDAs estiverem na atualização cumulativa (CU) mais recente da versão de serviço de longo prazo (LTSR) mais recente. Se o VDA estiver na CU mais recente de uma versão LTSR anterior, a Atualização do VDA ainda será exibida como Disponível.

Estado da Atualização do VDA

O Estado de Atualização do VDA fornece informações sobre o status de uma atualização agendada. Os status do Estado de Atualização do VDA são os seguintes:

Solução de Problemas de Atualizações Agendadas do VDA

Se você encontrar falhas de atualização, os seguintes logs podem ajudá-lo a identificar e solucionar os problemas. Você também pode compartilhar esses logs com o Suporte Técnico da Citrix para agilizar o processo de assistência.

Logs de Instalação do VDA

Ao solucionar problemas de falhas de atualização, colete e revise os logs tanto da instalação inicial do VDA quanto da atualização com falha. Os logs de instalação e atualização podem ser encontrados nos seguintes locais.

• Os logs de instalação para instalações do VDA são colocados em:
  • %temp%/Citrix/XenDesktop Installer
• Os logs de atualização para instalações do VDA são colocados em um dos seguintes locais:
  • C:\Windows\Temp\Citrix\XenDesktop Installer ou
  • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

Versão do Agente de Atualização do VDA

Ao coletar dados para solucionar falhas de atualização através do VUS, é importante saber a versão do agente de atualização nos VDAs. Para verificar as versões do Agente de Atualização do VDA, use o seguinte cmdlet: Get-VusComponentVersion -ComponentType VUS. Ele lista todos os VDAs e suas versões do Agente de Atualização do VDA.

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

Observação:

O script é fornecido como um exemplo e pode precisar ser adaptado para se adequar ao seu ambiente específico. Recomendamos que você teste o script completamente 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 $_ }

Logs relacionados ao Agente de Atualização do VDA

Os logs do Agente de Atualização do VDA (VUA) podem fornecer informações essenciais para solucionar falhas de atualização e problemas de comunicação do VUA com o serviço de atualização do VDA. Os logs que você pode coletar incluem:

• Rastreamentos do Citrix Diagnostic Facility (CDF). O nome do módulo CDF é VdaUpgradeAgent.
• Logs de eventos do Windows. Visualize os logs em Visualizador de Eventos > Logs do Windows > Aplicativos > Serviço do Agente de Atualização do Citrix VDA.

Uma configuração de registro está disponível que permite aos administradores habilitar um arquivo de log rotativo que captura informações críticas para solução de problemas, ao mesmo tempo que impede que os arquivos de log cresçam demais. O tamanho total dos arquivos de log é limitado a 20 MB. Crie a seguinte chave de registro para habilitar o registro em um arquivo:

• Chave: HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile

• Nome do valor: LogToFile

• Tipo de valor: REG_DWORD

• Dados do valor:

  • 0 - rastreamento de arquivo desabilitado

  • 1 - rastreamento de arquivo habilitado

Para criar a chave de registro LogToFile em um VDA usando o PowerShell, use o seguinte cmdlet:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force

Para habilitar o LogToFile para grupos de máquinas em escala, considere criar o registro LogToFile em todas as unidades organizacionais (OUs) do VDA por meio da Preferência de Política de Grupo.

Nota:

• Quando LogToFile=1 é definido, os logs são gravados apenas no arquivo. Eles não aparecerão nos rastreamentos CDF.
• A reinicialização do serviço VDA Upgrade Agent é necessária para que a alteração do registro entre em vigor
• O arquivo de log é criado na pasta C:\ProgramData\Citrix\Update Services\Logs

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. Certifique-se de que os URLs relevantes foram adicionados à lista de permissões se a filtragem de URL estiver em vigor. Consulte Conectividade.

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

Você pode habilitar o rastreamento CDF ou definir LogToFile como 1 para capturar logs detalhados para análise. Se o problema de falha de 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” (Download falhou: Esta lista de controle de acesso não está em formato canônico e, portanto, não pode ser modificada), 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 seguinte comando. (O comando redefine as ACLs com as 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, em seguida, 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 os URLs relevantes foram adicionados à lista de permissões se a filtragem de URL estiver em vigor, especialmente os URLs da Lista de Revogação de Certificados (CRL) ou do Protocolo de Status de Certificado Online (OCSP) necessários para a verificação de revogação. Consulte Requisito de atualização do VDA.

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

Sugerimos habilitar o rastreamento CDF ou definir LogToFile como 1 para capturar logs 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 Agente de Atualização do VDA depende de chamadas de sistema do 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 os URLs CRL ou OCSP.

A CryptoAPI do Windows atualmente não oferece suporte a configurações de proxy. Revise a seção VDAs com configurações de proxy para configurar seus proxies VDA para facilitar chamadas CRL de saída.