Monitoraggio e risoluzione dei problemi

Monitoraggio degli aggiornamenti VDA pianificati

I VDA e i cataloghi di macchine hanno due attributi per aiutare a monitorare la prontezza e lo stato attuale degli aggiornamenti VDA, visibili come colonne che possono essere utilizzate per filtrare in Studio o nel riquadro dei dettagli dei VDA o dei cataloghi.

• Aggiornamento VDA
• Stato aggiornamento VDA

Aggiornamento VDA

Aggiornamento VDA fornisce informazioni sul fatto che il VDA o il catalogo di macchine abbia l’agente di aggiornamento VDA configurato e se i VDA siano aggiornati o se sia disponibile un aggiornamento. Gli stati disponibili sono i seguenti:

Nota:

Per i VDA che utilizzano il percorso LTSR, un catalogo verrà visualizzato come Aggiornato solo se i VDA sono sull’ultimo aggiornamento cumulativo (CU) dell’ultima versione del servizio a lungo termine (LTSR). Se il VDA è sull’ultimo CU di una versione LTSR precedente, l’aggiornamento VDA verrà comunque visualizzato come Disponibile.

Stato dell’aggiornamento VDA

Lo stato di aggiornamento VDA fornisce informazioni sullo stato di un aggiornamento pianificato. Gli stati di aggiornamento VDA sono i seguenti:

Risoluzione dei problemi degli aggiornamenti VDA pianificati

Se si verificano errori di aggiornamento, i seguenti log possono aiutare a identificare e risolvere i problemi. È inoltre possibile condividere questi log con il supporto tecnico Citrix per accelerare il processo di assistenza.

Log di installazione VDA

Quando si risolvono i problemi relativi agli errori di aggiornamento, raccogliere ed esaminare i log sia per l’installazione iniziale del VDA che per l’aggiornamento non riuscito. I log per l’installazione e gli aggiornamenti sono disponibili nelle seguenti posizioni.

• I log di installazione per le installazioni VDA si trovano in:
  • %temp%/Citrix/XenDesktop Installer
• I log di aggiornamento per le installazioni VDA si trovano in:
  • C:\Windows\Temp\Citrix\XenDesktop Installer o
  • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

Versione dell’agente di aggiornamento VDA

Quando si raccolgono dati per risolvere i problemi di aggiornamento tramite VUS, è importante conoscere la versione dell’agente di aggiornamento sui VDA. Per controllare le versioni dell’agente di aggiornamento VDA, utilizzare il seguente cmdlet: Get-VusComponentVersion -ComponentType VUS. Elenca tutti i VDA e le relative versioni dell’agente di aggiornamento VDA.

Per controllare le versioni dell’agente di aggiornamento VDA a livello di catalogo, è possibile utilizzare il seguente script:

Nota:

Lo script è inteso come esempio e potrebbe dover essere adattato al proprio ambiente specifico. Si consiglia di testare lo script accuratamente prima di utilizzarlo in un ambiente di produzione.

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 $_ }

Log relativi all’agente di aggiornamento VDA

I log di VDA Upgrade Agent (VUA) possono fornire informazioni essenziali per la risoluzione dei problemi relativi agli errori di aggiornamento e ai problemi di comunicazione di VUA con il servizio di aggiornamento VDA. I log che è possibile raccogliere includono:

• Tracce di Citrix Diagnostic Facility (CDF). Il nome del modulo CDF è VdaUpgradeAgent.
• Log eventi di Windows. Visualizzare i log in Visualizzatore eventi > Registri di Windows > Applicazioni > Servizio agente di aggiornamento VDA Citrix.

È disponibile un’impostazione del Registro di sistema che consente agli amministratori di abilitare un file di log a rotazione che acquisisce informazioni critiche per la risoluzione dei problemi, impedendo al contempo che i file di log diventino troppo grandi. La dimensione totale dei file di log è limitata a 20 MB. Creare la seguente chiave del Registro di sistema per abilitare la registrazione su un file:

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

• Nome valore: LogToFile

• Tipo di valore: REG_DWORD

• Dati valore:

  • 0 - traccia file disabilitata

  • 1 - traccia file abilitata

Per creare la chiave di registro LogToFile su un VDA usando PowerShell, usa il seguente cmdlet:

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

Per abilitare LogToFile per gruppi di macchine su larga scala, considera la creazione del registro LogToFile su tutte le unità organizzative (OU) VDA tramite Preferenze Criteri di gruppo.

Nota:

• Quando LogToFile=1 è impostato, i log vengono scritti solo nel file. Non appariranno nelle tracce CDF.
• È necessario riavviare il servizio VDA Upgrade Agent affinché la modifica del registro abbia effetto.
• Il file di log viene creato nella cartella C:\ProgramData\Citrix\Update Services\Logs

Risolvere i problemi di download degli aggiornamenti VDA

Segui i passaggi seguenti per risolvere i problemi di download relativi alla funzionalità di aggiornamento VDA:

1. Assicurati che gli URL pertinenti siano stati aggiunti all’elenco consentiti se è attivo il filtro URL. Vedi Connettività.

2. Dopo aver aggiunto gli URL necessari all’elenco consentiti, prova a riprogrammare l’aggiornamento VDA.

Puoi abilitare la traccia CDF o impostare LogToFile su 1 per acquisire log dettagliati per l’analisi. Se il problema di download persiste, controlla gli errori. Se visualizzi il seguente messaggio di errore “Download Failed: This access control list is not in canonical form and therefore cannot be modified” (Download non riuscito: questo elenco di controllo degli accessi non è in forma canonica e pertanto non può essere modificato), indica che le autorizzazioni sulla cartella C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA non sono corrette.

Per risolvere il problema, esegui una delle seguenti operazioni:

• Opzione 1: Reimposta gli elenchi di controllo degli accessi (ACL) sulla cartella usando il seguente comando. (Il comando reimposta gli ACL con gli ACL ereditati predefiniti per tutti i file corrispondenti.)
  • icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
• Opzione 2: Eliminare la cartella VDA in Download e quindi pianificare l’aggiornamento VDA.

Risoluzione dei problemi relativi agli errori di convalida dell’aggiornamento VDA

Seguire i passaggi seguenti per risolvere i problemi relativi agli errori di download della funzionalità di aggiornamento VDA:

1. Assicurarsi che gli URL pertinenti siano stati aggiunti all’elenco consentiti se è attivo il filtro URL, in particolare gli URL della Certificate Revocation List (CRL) o dell’Online Certificate Status Protocol (OCSP) necessari per il controllo di revoca. Vedere Requisiti di aggiornamento VDA.

2. Dopo aver aggiunto gli URL necessari all’elenco consentiti, provare a riprogrammare l’aggiornamento VDA.

Si consiglia di abilitare la traccia CDF o di impostare LogToFile su 1 per acquisire log dettagliati per l’analisi. I log possono includere i seguenti errori:

• RevocationStatusUnknown
• La funzione di revoca non è riuscita a controllare lo stato di revoca del certificato.
• La funzione di revoca non è riuscita a controllare la revoca perché il server di revoca era offline.

L’agente di aggiornamento VDA si basa sulle chiamate di sistema di Windows per convalidare i certificati ed eseguire i controlli di revoca. Gli errori di cui sopra indicano che l’agente non è in grado di stabilire una connessione agli URL CRL o OCSP.

La CryptoAPI di Windows attualmente non supporta le impostazioni proxy. Esaminare la sezione VDA con configurazioni proxy per configurare i proxy VDA in modo da facilitare le chiamate CRL in uscita.