Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Monitoraggio e risoluzione dei problemi

January 23, 2026
Grazie al contributo di: 
C

Monitoraggio degli aggiornamenti VDA pianificati

I VDA e i cataloghi di macchine dispongono di due attributi che consentono di monitorare la disponibilità e lo stato attuale degli aggiornamenti VDA. Questi attributi sono visibili come colonne e possono essere utilizzati per filtrare in Studio o nel riquadro dei dettagli dei VDA o dei cataloghi.

  • VDA Upgrade
  • VDA Upgrade State

VDA Upgrade

VDA Upgrade fornisce informazioni sull’eventuale configurazione dell’agente di aggiornamento VDA per il VDA o il catalogo di macchine e se i VDA sono aggiornati o se è disponibile un aggiornamento. Gli stati disponibili sono i seguenti:

VDA Upgrade (Studio) VDA Upgrade (PowerShell) Descrizione
Livello catalogo
Non configurato MissingUpgradeType Non è stata selezionata una traccia di aggiornamento (CR, LTSR, CR EAR o LTSR EAR) per il catalogo di macchine.
Pianificato UpgradeScheduled È pianificato un aggiornamento per il catalogo di macchine.
Disponibile UpgradeAvailable I VDA nel catalogo non sono sulla versione più recente della traccia di aggiornamento. Si consiglia un aggiornamento.
Aggiornato UpToDate I VDA nel catalogo sono sulla versione più recente della traccia di aggiornamento. Non è richiesta alcuna azione.
Sconosciuto Unknown Recupero dello stato più recente di VDA Upgrade.
Livello macchina
Non configurato MissingUpgradeType Non è stata selezionata una traccia di aggiornamento (CR, LTSR, CR EAR o LTSR EAR) per il catalogo di macchine del VDA.
Pianificato UpgradeScheduled È pianificato un aggiornamento per il VDA.
Disponibile UpgradeAvailable Il VDA non è sulla versione più recente della traccia di aggiornamento. Si consiglia un aggiornamento.
Aggiornato UpToDate Il VDA è sulla versione più recente della traccia di aggiornamento. Non è richiesta alcuna azione.
Verifica stato Unknown Recupero dello stato più recente di VDA Upgrade.

Nota:

Per i VDA che utilizzano la traccia 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, VDA Upgrade verrà comunque visualizzato come Disponibile.

VDA Upgrade State

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

Stato di VDA Upgrade (Studio) Stato di VDA Upgrade (PowerShell) Descrizione
Livello catalogo
Non pianificato NotScheduled Nessun aggiornamento è pianificato per il catalogo.
Pianificato UpgradeScheduled È pianificato un aggiornamento per il catalogo.
In corso UpgradeInProgress Un aggiornamento è in corso per il catalogo.
Annullato UpgradeCancelled Un aggiornamento è stato annullato per il catalogo. Ciò può essere dovuto a un annullamento manuale o al raggiungimento della soglia di errore.
Non riuscito UpgradeFailed Un aggiornamento pianificato per il catalogo non è riuscito.
Riuscito UpgradeSuccessful Un aggiornamento pianificato per il catalogo è stato completato con successo. Nota: un aggiornamento riuscito non significa che tutti i VDA nel catalogo siano stati aggiornati con successo.
- Empty Nessun aggiornamento pianificato per il catalogo.
Livello macchina
Pianificato UpgradeScheduled È pianificato un aggiornamento per il VDA.
In attesa di aggiornamento UpgradeInUpgradeWindow Un aggiornamento pianificato è attivo, ma il VDA non ha ancora iniziato l’aggiornamento. Vedere “Concorrenza” per maggiori informazioni su come gli aggiornamenti VDA sono bilanciati nel carico.
In corso UpgradeInProgress Il VDA è attualmente in fase di aggiornamento.
Annullato UpgradeCancelled Un aggiornamento pianificato è stato annullato per il VDA prima dell’inizio dell’aggiornamento.
Aggiornamento non riuscito UpgradeFailed Il VDA ha iniziato l’aggiornamento ma l’aggiornamento non è riuscito a completarsi con successo. Vedere “risoluzione dei problemi” per maggiori informazioni.
Riuscito UpgradeSuccess Il VDA è stato aggiornato con successo.
Convalida non riuscita UpgradeValidationFailed La convalida del certificato non è riuscita durante il download dei metadati per il programma di installazione VDA.
- Empty Nessun aggiornamento è pianificato per il VDA.

Risoluzione dei problemi relativi agli aggiornamenti VDA pianificati

In caso di errori di aggiornamento, i seguenti log possono aiutarti a identificare e risolvere i problemi. Puoi anche condividere questi log con il supporto tecnico Citrix per accelerare il processo di assistenza.

Log di installazione VDA

Quando si risolvono i problemi di aggiornamento non riusciti, 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 si trovano 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 non riusciti 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. Questo elenca tutti i VDA e le loro 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 $_ }
<!--NeedCopy-->

Log relativi all’agente di aggiornamento VDA

I log dell’agente di aggiornamento VDA (VUA) possono fornire informazioni essenziali per la risoluzione dei problemi di aggiornamento non riusciti e dei problemi di comunicazione del VUA con il servizio di aggiornamento VDA. I log che è possibile raccogliere includono:

  • Tracce Citrix Diagnostic Facility (CDF). Il nome del modulo CDF è VdaUpgradeAgent.
  • Log eventi di Windows. Visualizzare i log in Visualizzatore eventi > Log 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 rotante 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 del Registro di sistema LogToFile su un VDA utilizzando PowerShell, utilizzare 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, considerare la creazione del Registro di sistema 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 Agente di aggiornamento VDA affinché la modifica del Registro di sistema abbia effetto
  • Il file di log viene creato nella cartella C:\ProgramData\Citrix\Update Services\Logs

Risoluzione dei problemi relativi agli errori di download 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. Vedere Connettività.

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

È possibile abilitare la traccia CDF o impostare LogToFile su 1 per acquisire log dettagliati per l’analisi. Se il problema di download non riuscito persiste, controllare gli errori. Se viene visualizzato il seguente messaggio di errore “Download Failed: This access control list is not in canonical form and therefore cannot be modified,” indica che le autorizzazioni sulla cartella C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA non sono corrette.

Per risolvere il problema, eseguire una delle seguenti operazioni:

  • Opzione 1: Reimpostare gli elenchi di controllo di accesso (ACL) sulla cartella utilizzando 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 dell’elenco di revoche di certificati (CRL) o del protocollo di stato dei certificati online (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 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.

Monitoraggio e risoluzione dei problemi
January 23, 2026
Grazie al contributo di: 
C
January 23, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.