Motivi di errore e risoluzione dei problemi di Citrix Director

Le tabelle seguenti descrivono le varie categorie di errore, i motivi e le azioni da intraprendere per risolvere i problemi. Per maggiori informazioni, vedere Enumerazioni, codici di errore e descrizioni.

Errori di connessione

Categoria Motivo Problema Azione
N/D [0] Sconosciuto. Questo codice di errore non è mappato. Il servizio di monitoraggio non è in grado di determinare il motivo dell’errore di avvio o di connessione segnalato dalle informazioni condivise dal servizio di brokering. Raccogliere i log CDF sul controller e contattare il supporto Citrix.
[0] Nessuno [1] Nessuno Nessuno N/D
[2] MachineFailure [2] SessionPreparation La richiesta di preparazione della sessione dal delivery controller al VDA non è riuscita. Possibili cause: Problemi di comunicazione tra il controller e il VDA, problemi riscontrati dal Broker Service durante la creazione di una richiesta di preparazione, o problemi di rete che impediscono al VDA di accettare la richiesta. Fare riferimento ai passaggi per la risoluzione dei problemi elencati nell’articolo del Knowledge Center, Risoluzione dei problemi di registrazione dell’agente di recapito virtuale con i controller di recapito in Citrix Virtual Apps and Desktops per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
[2] MachineFailure [3] RegistrationTimeout Il VDA era acceso, ma si è verificato un timeout durante il tentativo di registrazione con il delivery controller. Verificare che il Citrix Broker Service sia in esecuzione sul delivery controller e che il servizio Desktop sia in esecuzione sul VDA. Avviare ciascuno se interrotto.
[1] ClientConnectionFailure [4] ConnectionTimeout Il client non si è connesso al VDA dopo che il VDA è stato preparato per l’avvio della sessione. La sessione è stata intermediata con successo, ma si è verificato un timeout durante l’attesa della connessione del client al VDA. Possibili cause: Impostazioni del firewall, interruzioni di rete o impostazioni che impediscono le connessioni remote. Controllare la console di Director per vedere se il client ha attualmente una connessione attiva, il che significa che nessun utente è interessato. Se non esiste alcuna sessione, esaminare i registri eventi sul client e sul VDA per eventuali errori. Risolvere eventuali problemi di connettività di rete tra il client e il VDA.
[4] NoLicensesAvailable [5] Licensing La richiesta di licenza non è riuscita. Possibili cause: Numero insufficiente di licenze, o il server delle licenze è inattivo da più di 30 giorni. Verificare che il server licenze sia online e raggiungibile. Risolvere eventuali problemi di connettività di rete al server licenze o riavviare il server licenze se sembra non funzionare correttamente. Verificare che ci siano licenze sufficienti nell’ambiente e allocarne di più se necessario.
[1] ClientConnectionFailure [6] Ticketing Si è verificato un errore durante il ticketing, indicando che la connessione client al VDA non corrisponde alla richiesta intermediata. Un ticket di richiesta di avvio viene preparato dal Broker e consegnato nel file ICA®. Quando l’utente tenta di avviare una sessione, il VDA convalida il ticket di avvio nel file ICA con il Broker. Possibili cause: il file ICA è danneggiato o l’utente sta tentando di effettuare una connessione non autorizzata. Verificare che l’utente abbia accesso all’applicazione o al desktop in base ai gruppi di utenti definiti nei gruppi di consegna. Chiedere all’utente di riavviare l’applicazione o il desktop per determinare se si tratta di un problema isolato. Se il problema si ripresenta, esaminare i registri eventi del dispositivo client per individuare errori. Verificare che il VDA a cui l’utente sta tentando di connettersi sia registrato. Se non registrato, esaminare i registri eventi sul VDA e risolvere eventuali problemi di registrazione.
[1] ClientConnectionFailure [7] Altro Una sessione è stata segnalata come terminata dal VDA dopo che il client ha inizialmente contattato il VDA ma prima che completasse la sequenza di connessione. Verificare se la sessione non è stata terminata dall’utente prima dell’avvio. Provare a riavviare la sessione; se il problema persiste, raccogliere i log CDF e contattare il supporto Citrix.
[1] ClientConnectionFailure [8] GeneralFail La sessione non è riuscita ad avviarsi. Possibili cause: è stato richiesto un avvio intermediato mentre il broker era ancora in fase di avvio o inizializzazione, oppure si è verificato un errore interno durante la fase di intermediazione di un avvio. Verificare che il servizio Citrix Broker sia in esecuzione e riprovare ad avviare la sessione.
[5] Configurazione [9] MaintenanceMode Il VDA, o il gruppo di consegna a cui appartiene il VDA, è impostato in modalità di manutenzione. Determinare se la modalità di manutenzione è necessaria. Disabilitare la modalità di manutenzione sul gruppo di consegna o sulla macchina in questione se non è necessaria e istruire l’utente a tentare di riconnettersi.
[5] Configurazione [10] Applicazione disabilitata L’applicazione non può essere accessibile dagli utenti finali perché è stata disabilitata dall’amministratore. Se l’applicazione è destinata a essere disponibile per l’uso in produzione, abilitare l’applicazione e istruire l’utente a riconnettersi.
[4] Nessuna licenza disponibile [11] Funzionalità di licenza rifiutata La funzionalità in uso non è coperta dalle licenze esistenti. Contattare un rappresentante di vendita Citrix per confermare le funzionalità coperte dall’edizione e dal tipo di licenza esistenti di Citrix Virtual Apps and Desktops™.
[3] Nessuna capacità disponibile [13] Limite sessioni raggiunto Tutti i VDA sono in uso e non c’è capacità per ospitare più sessioni. Possibili cause: Tutti i VDA sono in uso (per VDA OS a sessione singola), o tutti i VDA hanno raggiunto il numero massimo configurato di sessioni simultanee consentite (per VDA OS multi-sessione). Verificare se ci sono VDA in modalità di manutenzione. Disabilitare la modalità di manutenzione se non è necessaria per liberare più capacità. Considerare di aumentare il valore di Numero massimo di sessioni nell’impostazione dei criteri Citrix per consentire più sessioni per VDA server. Considerare l’aggiunta di più VDA OS multi-sessione. Considerare l’aggiunta di più VDA OS a sessione singola.
[5] Configurazione [14] ProtocolloNonConsentito I protocolli ICA e RDP non sono consentiti. Eseguire il comando PowerShell Get-BrokerAccessPolicyRule sul delivery controller e verificare che il valore AllowedProtocols contenga tutti i protocolli desiderati. Questo problema si verifica solo in caso di configurazione errata.
[5] Configurazione [15] RisorsaNonDisponibile L’applicazione o il desktop a cui l’utente sta tentando di connettersi non è disponibile. Questa applicazione o desktop potrebbe non esistere, oppure non ci sono VDA disponibili per eseguirla. Possibili cause: l’applicazione o il desktop è stato annullato dalla pubblicazione, oppure i VDA che ospitano l’applicazione o il desktop hanno raggiunto il carico massimo, oppure l’applicazione o il desktop è impostato in modalità di manutenzione. Verificare che l’applicazione o il desktop sia ancora pubblicato e che i VDA non siano in modalità di manutenzione. Determinare se i VDA del sistema operativo multi-sessione sono a pieno carico. In tal caso, eseguire il provisioning di altri VDA del sistema operativo multi-sessione. Verificare che siano disponibili VDA del sistema operativo a sessione singola per le connessioni. Se necessario, eseguire il provisioning di altri VDA del sistema operativo a sessione singola.
[5] Configurazione [16] RiconnessioneSessioneAttivaDisabilitata La sessione ICA è attiva e connessa a un endpoint diverso. Tuttavia, poiché la Riconnessione sessione attiva è disabilitata, il client non può connettersi alla sessione attiva. Sul delivery controller, verificare che la Riconnessione sessione attiva sia abilitata. Verificare che il valore di DisableActiveSessionReconnect nel registro, sotto HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server, sia impostato su 0.
[2] GuastoMacchina [17] NessunaSessioneDaRiconnettere Il client ha tentato di riconnettersi a una sessione specifica, ma la sessione è stata terminata. Riprovare la riconnessione del controllo workspace.
[2] MachineFailure [18] SpinUpFailed Il VDA non può essere acceso per l’avvio della sessione. Questo è un problema segnalato dall’hypervisor. Se la macchina è ancora spenta, provare ad avviarla da Citrix Studio. Se l’operazione non riesce, controllare la connettività e le autorizzazioni dell’hypervisor. Se il VDA è una macchina con provisioning PVS, verificare nella console PVS che la macchina sia in esecuzione. In caso contrario, verificare che alla macchina sia assegnato un Personal vDisk, accedere all’hypervisor per ripristinare la VM.
[2] MachineFailure [19] Refused Il controller di consegna invia una richiesta al VDA per prepararsi a una connessione da parte di un utente finale, ma il VDA rifiuta attivamente questa richiesta. Verificare tramite ping che il controller di consegna e il VDA possano comunicare correttamente. In caso contrario, risolvere eventuali problemi di firewall o di routing di rete.
[2] MachineFailure [20] ConfigurationSet Failure Il controller di consegna non ha inviato i dati di configurazione richiesti, come le impostazioni dei criteri e le informazioni sulla sessione, al VDA durante l’avvio della sessione. Possibili cause: problemi di comunicazione tra il controller e il VDA, problemi riscontrati dal Broker Service durante la creazione di una richiesta di set di configurazione o problemi di rete che impediscono al VDA di accettare la richiesta. -
[3] NoCapacityAvailable [21] MaxTotalInstancesExceeded È stato raggiunto il numero massimo di istanze di un’applicazione. Non è possibile aprire ulteriori istanze dell’applicazione sul VDA. Questo problema è correlato alla funzionalità dei limiti delle applicazioni. Considera di aumentare l’impostazione dell’applicazione, Limita il numero di istanze in esecuzione contemporaneamente a un valore più alto se la licenza lo consente.
[3] NoCapacityAvailable [22] MaxPerUserInstancesExceeded L’utente sta tentando di aprire più di un’istanza di un’applicazione, ma l’applicazione è configurata per consentire una sola istanza per utente. Questo problema è correlato alla funzionalità dei limiti dell’applicazione. Per impostazione predefinita, è consentita una sola istanza dell’applicazione per utente. Se sono richieste più istanze per utente, considerare di deselezionare l’impostazione Limita a una istanza per utente nelle impostazioni dell’applicazione.
[1] ClientConnectionFailure [23] Errore di comunicazione Il controller di consegna ha tentato di inviare informazioni al VDA, come una richiesta di preparazione per una connessione, ma si è verificato un errore durante il tentativo di comunicazione. Ciò può essere causato da interruzioni di rete. Se già avviato, riavviare il servizio Desktop sul VDA per riavviare il processo di registrazione e verificare che il VDA si registri correttamente. Confermare che i controller di consegna configurati per il VDA siano accurati tramite i dettagli nel registro eventi dell’applicazione.
[3] NoCapacityAvailable [100] NoMachineAvailable Il servizio di monitoraggio converte [12] NoDesktopAvailable in questo codice di errore. Il VDA assegnato per avviare la sessione si trova in uno stato non valido o non è disponibile. Possibili cause: lo stato di alimentazione del VDA è sconosciuto o non disponibile, il VDA non è stato riavviato dall’ultima sessione dell’utente, la condivisione della sessione è disabilitata mentre la sessione corrente richiede che sia abilitata, oppure il VDA è stato rimosso dal gruppo di consegna o dal sito. Verificare che il VDA si trovi in un gruppo di consegna. In caso contrario, aggiungerlo al gruppo di consegna appropriato. Verificare che ci siano sufficienti VDA registrati e in stato pronto per poter avviare il desktop condiviso pubblicato o l’applicazione richiesta dall’utente. Verificare che l’hypervisor che ospita il VDA non sia in modalità di manutenzione.
[2] MachineFailure [101] MachineNotFunctional. Il servizio di monitoraggio converte [12] NoDesktopAvailable in questo codice di errore. Il VDA non è operativo. Possibili cause: Il VDA è stato rimosso dal gruppo di consegna, il VDA non è registrato, lo stato di alimentazione del VDA non è disponibile, oppure il VDA sta riscontrando problemi interni. Verificare che il VDA si trovi in un gruppo di consegna. In caso contrario, aggiungerlo al gruppo di consegna appropriato. Verificare che il VDA risulti acceso in Citrix Studio. Se lo stato di alimentazione è sconosciuto per diverse macchine, risolvere eventuali problemi di connettività all’hypervisor o guasti dell’host. Verificare che l’hypervisor che ospita il VDA non sia in modalità di manutenzione. Riavviare il VDA una volta risolti questi problemi.

Tipo di errore della macchina

Codice errore ID codice errore Problema Azione
Sconosciuto - - -
Non registrato 3 - -
MaxCapacity (rappresentata come Carico massimo in Director) 4 La macchina si sta segnalando alla capacità massima, ovvero l’indice di carico massimo Assicurarsi che tutti gli hypervisor siano accesi. Aggiungere più macchine ai gruppi di consegna interessati aggiungendo più capacità all’hypervisor o aggiungendo più hypervisor.
Bloccato all’avvio 2 La VM non ha completato la sequenza di avvio e non comunica con l’hypervisor. Assicurarsi che la VM sia stata avviata correttamente sull’hypervisor. Verificare la presenza di altri messaggi sulla VM, come problemi del sistema operativo. Assicurarsi che gli strumenti dell’hypervisor siano installati sulla VM. Assicurarsi che il VDA sia installato sulla VM.
Avvio fallito 1 La VM ha riscontrato problemi durante il tentativo di avvio sull’hypervisor. Controllare i log dell’hypervisor.
Nessuno 0 - -

Motivo della deregistrazione della macchina (applicabile quando il tipo di errore è Non registrato o Sconosciuto)

Codice errore ID codice errore Problema Azione
AgentShutdown 0 Il VDA ha subito un arresto controllato. Accendere il VDA se non ci si aspetta che sia spento in base alle politiche di gestione dell’alimentazione esistenti. Controllare eventuali errori nei registri eventi.
AgentSuspended 1 Il VDA è in modalità ibernazione o sospensione. Disattivare la modalità ibernazione del VDA. Considerare la disabilitazione dell’ibernazione per i VDA di Citrix Virtual Apps and Desktops tramite le impostazioni di alimentazione.
IncompatibleVersion 100 Il VDA non può comunicare con il delivery controller a causa di una mancata corrispondenza nelle versioni del protocollo Citrix. Allineare le versioni del VDA e del delivery controller.
AgentAddressResolutionFailed 101 Il delivery controller non è riuscito a risolvere l’indirizzo IP del VDA. Verificare che l’account macchina VDA esista in AD. In caso contrario, crearlo. Verificare che il nome e l’indirizzo IP del VDA nel DNS siano accurati. In caso contrario, correggerli. Se il problema è diffuso, convalidare le impostazioni DNS sui delivery controller. Verificare la risoluzione DNS dal controller eseguendo il comando nslookup.
101 Il delivery controller non è riuscito a risolvere l’indirizzo IP del VDA. Verificare che l’account macchina VDA esista in AD. In caso contrario, crearlo. Verificare che il nome e l’indirizzo IP del VDA nel DNS siano accurati. In caso contrario, correggerli.
AgentNotContactable 102 Si è verificato un problema di comunicazione tra il delivery controller e il VDA. Utilizzare un ping per verificare che il delivery controller e il VDA possano comunicare correttamente. In caso contrario, risolvere eventuali problemi di firewall o di rete. Fare riferimento ai passaggi per la risoluzione dei problemi elencati nell’articolo del Knowledge Center, Risoluzione dei problemi di registrazione dell’agente di consegna virtuale con i controller di consegna in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
102 Si è verificato un problema di comunicazione tra il delivery controller e il VDA. Fare riferimento ai passaggi per la risoluzione dei problemi elencati nell’articolo del Knowledge Center, Risoluzione dei problemi di registrazione di Virtual Delivery Agent con i delivery controller in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA. Contattare il supporto Citrix.
AgentWrongActiveDirectoryOU 103 Si è verificata una configurazione errata del rilevamento di Active Directory. L’unità organizzativa (OU) specifica del sito (dove le informazioni del controller del sito sono archiviate in AD) configurata nel registro VDA è per un sito diverso. Assicurarsi che la configurazione di Active Directory sia corretta o controllare le impostazioni del registro.
EmptyRegistrationRequest 104 La richiesta di registrazione inviata dal VDA al delivery controller era vuota. Ciò può essere dovuto a un’installazione software VDA danneggiata. Riavviare il servizio Desktop sul VDA per riavviare il processo di registrazione e verificare che il VDA si registri correttamente tramite il registro eventi dell’applicazione.
MissingRegistrationCapabilities 105 La versione del VDA non è compatibile con il delivery controller. Aggiornare il VDA o rimuovere il VDA e quindi reinstallarlo.
MissingAgentVersion 106 La versione del VDA non è compatibile con il delivery controller. Reinstallare il software VDA se il problema interessa tutte le macchine.
InconsistentRegistrationCapabilities 107 Il VDA non può comunicare le proprie capacità al Broker. Ciò può essere dovuto a un’incompatibilità tra le versioni del VDA e del delivery controller. Le capacità di registrazione, che cambiano a ogni versione, sono espresse in una forma che non corrisponde alla richiesta di registrazione. Allineare le versioni del VDA e del delivery controller.
NotLicensedForFeature 108 La funzionalità che si sta tentando di utilizzare non è concessa in licenza. Controllare l’edizione della licenza Citrix o rimuovere il VDA e quindi reinstallarlo.
108 La funzionalità che si sta tentando di utilizzare non è concessa in licenza. Contattare il supporto Citrix.
Versione UnsupportedCredentialSecurity 109 Il VDA e il delivery controller non utilizzano lo stesso meccanismo di crittografia. Allineare le versioni del VDA e del delivery controller.
InvalidRegistrationRequest 110 Il VDA ha inviato una richiesta di registrazione al Broker, ma il contenuto della richiesta è danneggiato o non valido. Fare riferimento ai passaggi per la risoluzione dei problemi elencati nell’articolo del Knowledge Center, Risoluzione dei problemi di registrazione di Virtual Delivery Agent con i delivery controller in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
SingleMultiSessionMismatch 111 Il tipo di sistema operativo del VDA non è compatibile con il catalogo macchine o il gruppo di consegna. Aggiungere il VDA al tipo di catalogo macchine o al gruppo di consegna corretto contenente macchine con lo stesso sistema operativo.
FunctionalLevelTooLowForCatalog 112 Il catalogo macchine è impostato su un livello funzionale VDA superiore rispetto alla versione VDA installata. Verificare che il livello funzionale del catalogo macchine del VDA corrisponda a quello del VDA. Aggiornare o eseguire il downgrade del catalogo macchine in modo che corrisponda a quello del VDA.
FunctionalLevelTooLowForDesktopGroup 113 Il gruppo di consegna è impostato su un livello funzionale VDA superiore rispetto alla versione VDA installata. Verificare che il livello funzionale del gruppo di consegna del VDA corrisponda a quello del VDA. Aggiornare o eseguire il downgrade del catalogo macchine in modo che corrisponda a quello del VDA.
PowerOff 200 Il VDA non si è spento correttamente. Se il VDA dovrebbe essere acceso, provare ad avviarlo da Citrix Studio e verificare che si avvii e si registri correttamente. Risolvere eventuali problemi di avvio o registrazione. Esaminare i registri eventi sul VDA una volta che è di nuovo attivo per aiutare a determinare la causa principale dello spegnimento.
AgentRejectedSettingsUpdate 203 Impostazioni come i criteri Citrix sono state modificate o aggiornate, ma si è verificato un errore nell’invio degli aggiornamenti al VDA. Ciò può accadere se gli aggiornamenti non sono compatibili con la versione VDA installata. Aggiornare il VDA se necessario. Verificare se gli aggiornamenti applicati sono supportati dalla versione del VDA.
SessionPrepareFailure 206 Il Broker non ha completato un controllo delle sessioni in esecuzione sul VDA. Se diffuso, riavviare il servizio Citrix Broker sul controller di consegna.
206 Il Broker non ha completato un controllo delle sessioni in esecuzione sul VDA. Contattare il supporto Citrix.
ContactLost 207 Il controller di consegna ha perso la connessione con il VDA. Ciò può essere causato da interruzioni di rete. Verificare che il servizio Citrix Broker sia in esecuzione sul controller di consegna e che il servizio Desktop sia in esecuzione sul VDA. Avviare ciascuno se interrotto. Se già avviato, riavviare il servizio Desktop sul VDA per riavviare il processo di registrazione e verificare che il VDA si registri correttamente. Confermare che i controller di consegna configurati per il VDA siano accurati tramite i dettagli nel registro eventi dell’applicazione. Utilizzare un ping per verificare che il controller di consegna e il VDA possano comunicare correttamente. In caso contrario, risolvere eventuali problemi di firewall o di rete.
207 Il controller di consegna ha perso la connessione con il VDA. Ciò può essere causato da interruzioni di rete. Verificare che il servizio Desktop sia in esecuzione sul VDA. Avviarlo se è arrestato.
BrokerRegistrationLimitReached 301 Il controller di consegna ha raggiunto il numero massimo configurato di VDA che possono registrarsi contemporaneamente. Per impostazione predefinita, il controller di consegna consente 10.000 registrazioni VDA simultanee. Valutare l’aggiunta di controller di consegna al sito o la creazione di un sito. È inoltre possibile aumentare il numero di VDA autorizzati a registrarsi contemporaneamente al controller di consegna tramite la chiave di registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Per ulteriori informazioni, consultare l’articolo del Knowledge Center, Voci della chiave di registro utilizzate da Citrix Virtual Apps and Desktops (CTX117446). L’aumento di questo numero potrebbe richiedere più risorse di CPU e memoria per il controller.
SettingsCreationFailure 208 Il Broker non ha creato un set di impostazioni e configurazioni da inviare al VDA. Se il Broker non è in grado di raccogliere i dati, la registrazione fallisce e il VDA diventa non registrato. Controllare i registri eventi sul controller di consegna per eventuali errori. Riavviare il servizio Broker se un problema specifico non è evidente nei registri. Una volta riavviato il servizio Broker, riavviare il servizio Desktop sui VDA interessati e verificare che si registrino correttamente.
208 Il Broker non ha creato un set di impostazioni e configurazioni da inviare al VDA. Se il Broker non è in grado di raccogliere i dati, la registrazione fallisce e il VDA diventa non registrato. Riavviare il servizio Desktop sui VDA interessati e verificare che si registrino correttamente. Contattare il supporto Citrix.
SendSettingsFailure 204 Il Broker non ha inviato le impostazioni e i dati di configurazione al VDA. Se il Broker può raccogliere i dati ma non è in grado di inviarli, la registrazione fallisce. Se limitato a un singolo VDA, riavviare il servizio Desktop sul VDA per forzare la nuova registrazione e verificare che il VDA si registri correttamente tramite il registro eventi dell’applicazione. Risolvere eventuali errori riscontrati. Fare riferimento ai passaggi per la risoluzione dei problemi elencati nell’articolo del Knowledge Center, Risoluzione dei problemi di registrazione di Virtual Delivery Agent con i delivery controller in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
AgentRequested 2 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
DesktopRestart 201 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
DesktopRemoved 202 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
SessionAuditFailure 205 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
UnknownError 300 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
RegistrationStateMismatch 302 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Unknown - Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Motivi di errore e risoluzione dei problemi di Citrix Director