Monitoraggio e risoluzione dei problemi
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, visibili come colonne utilizzabili 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 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:
| Aggiornamento VDA (Studio) | Aggiornamento VDA (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 dell’aggiornamento VDA. |
| 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 dell’aggiornamento VDA. |
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, l’aggiornamento VDA verrà comunque visualizzato come Disponibile.
Stato aggiornamento VDA
Stato aggiornamento VDA fornisce informazioni sullo stato di un aggiornamento pianificato. Gli stati di Stato aggiornamento VDA sono i seguenti:
| Stato aggiornamento VDA (Studio) | Stato aggiornamento VDA (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 è stato completato 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
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 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 la risoluzione dei problemi relativi agli errori 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. Questo 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 accuratamente lo script 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 dell’agente di aggiornamento VDA (VUA) possono fornire informazioni essenziali per la risoluzione dei problemi relativi agli errori di aggiornamento e ai 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.
Per le versioni VUA 7.44 e successive
Nella versione 7.44 dell’agente del servizio di aggiornamento VDA (inclusa nella release 2503), è 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.
Per le versioni VUA precedenti alla 7.43
Se necessario, è possibile modificare il file di configurazione dell’agente di aggiornamento VDA in modo che i log vengano scritti continuamente in un file. Per abilitare la registrazione su un file, seguire questi passaggi:
- Accedere alla cartella
C:\Program Files\Citrix\CitrixUpgradeAgent. - Aprire il file
Citrix.UpdateServices.UpdateAgent.exe.config. - Modificare il valore di
LogToFilein1. - Riavviare il servizio Citrix VDA Upgrade Agent. Questo crea un file di log in:
C:\ProgramData\Citrix\Update Services\Logs.
Nota:
- L’abilitazione della registrazione su un file tramite il file .config scrive continuamente i log, consumando potenzialmente spazio di archiviazione. Ricordarsi di disabilitare la registrazione dopo che il problema è stato risolto. Per disabilitare la registrazione, impostare prima
LogToFilesu0e quindi riavviare il servizio Citrix VDA Upgrade Agent.- Quando
LogToFile=1è impostato, i log vengono scritti solo nel file. Non appariranno nelle tracce CDF.
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:
-
Assicurarsi che gli URL pertinenti siano stati aggiunti all’elenco consentiti se è attivo il filtro URL. Vedere Requisiti di aggiornamento VDA.
-
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 errore di download 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:
-
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.
-
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 è stata in grado di controllare lo stato di revoca per il certificato.
- La funzione di revoca non è stata in grado di 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.