Monitoraggio e risoluzione dei problemi
Monitoraggio degli aggiornamenti VDA pianificati
-
I VDA e i cataloghi di macchine dispongono di due attributi che aiutano a monitorare la preparazione 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:
| 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 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, 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:
| VDA Upgrade State (Studio) | VDA Upgrade State (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
In caso di errori di aggiornamento, i seguenti log possono aiutarvi a identificare e risolvere i problemi. Potete anche condividere questi log con il supporto tecnico Citrix per accelerare il processo di assistenza.
Log di installazione VDA
Durante la risoluzione dei problemi relativi agli errori di aggiornamento, raccogliete ed esaminate i log sia per l’installazione iniziale del VDA sia 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 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 vostro 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 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 di 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 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 di registro per abilitare la registrazione su un file:
-
Chiave:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force -
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 utilizzando PowerShell, usare il seguente cmdlet:
-
[[CODE_BLOCK_0]]
Per abilitare LogToFile per gruppi di macchine su larga scala, considerare la creazione della chiave di 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.
Per le versioni di VUA precedenti alla 7.43
Se necessario, è possibile modificare il file di configurazione di VDA Upgrade Agent in modo che i log vengano scritti continuamente in un file. Per abilitare la registrazione su un file, seguire questi passaggi:
- Andare 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 aver risolto il problema. 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.
Risolvere i problemi di download degli aggiornamenti VDA
Seguire i passaggi seguenti per risolvere i problemi di download relativi alla funzionalità di aggiornamento VDA:
-
Assicurarsi che gli URL pertinenti siano stati aggiunti all’elenco consentiti se è in atto il filtro URL. Vedere Requisiti per l’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 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,” (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, eseguire una delle seguenti operazioni:
-
Opzione 1: Reimpostare gli elenchi di controllo degli accessi (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.
Risolvere i problemi di convalida degli aggiornamenti VDA
Seguire i passaggi seguenti per risolvere i problemi di download relativi alla funzionalità di aggiornamento VDA:
-
Assicurarsi che gli URL pertinenti siano stati aggiunti all’elenco consentiti se è in atto 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 per l’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 è riuscita a controllare lo stato di revoca per il certificato.
- La funzione di revoca non è riuscita a controllare la revoca perché il server di revoca era offline.
VDA Upgrade Agent 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.
Windows CryptoAPI attualmente non supporta le impostazioni proxy. Esaminare la sezione VDA con configurazioni proxy per configurare i proxy VDA per facilitare le chiamate CRL in uscita.