Motivi di errore e risoluzione dei problemi di Citrix Director

Le tabelle seguenti descrivono le varie categorie di errore, i motivi e le azioni necessarie per risolvere i problemi. Per maggiori informazioni, consultare 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 può determinare il motivo dell’errore di avvio o connessione segnalato dalle informazioni condivise dal servizio Broker. 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 controller di consegna al VDA non è riuscita. Possibili cause: Problemi di comunicazione tra il controller e il VDA, problemi riscontrati dal servizio Broker 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 consegna virtuale con i controller di consegna in Citrix Virtual Apps and Desktops per problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
[2] MachineFailure [3] RegistrationTimeout Il VDA è stato acceso, ma si è verificato un timeout durante il tentativo di registrazione con il controller di consegna. Verificare che il servizio Citrix Broker sia in esecuzione sul controller di consegna e che il servizio Desktop sia in esecuzione sul VDA. Avviarli se interrotti.
[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 correttamente intermediata, ma si è verificato un timeout in attesa che il client si connettesse 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 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 del 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. Istruire l’utente a 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 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] Other Una sessione è stata segnalata come terminata dal VDA dopo che il client ha inizialmente contattato il VDA ma prima di completare 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 L’avvio della sessione non è riuscito. Possibili cause: È stato richiesto un avvio intermediato mentre il broker era ancora in fase di avvio o inizializzazione, o 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] Configuration [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] Configuration [10] ApplicationDisabled 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] NoLicensesAvailable [11] LicenseFeature Refused 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 Citrix Virtual Apps and Desktops™ esistenti.
[3] NoCapacityAvailable [13] SessionLimitReached 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 concorrenti 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 l’aumento del 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] Configuration [14] DisallowedProtocol I protocolli ICA e RDP non sono consentiti. Eseguire il comando PowerShell Get-BrokerAccessPolicyRule sul controller di consegna e verificare che il valore AllowedProtocols elenchi tutti i protocolli desiderati. Questo problema si verifica solo se c’è una configurazione errata.
[5] Configuration [15] ResourceUnavailable 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 non pubblicato, o i VDA che ospitano l’applicazione o il desktop hanno raggiunto il carico massimo, o 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 OS multi-sessione sono a pieno carico. In tal caso, eseguire il provisioning di più VDA OS multi-sessione. Verificare che ci siano VDA OS a sessione singola disponibili per le connessioni. Eseguire il provisioning di più VDA OS a sessione singola se necessario.
[5] Configuration [16] ActiveSessionReconnectDisabled 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 controller di consegna, 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] MachineFailure [17] NoSessionToReconnect 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 questo fallisce, esaminare 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 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 servizio Broker 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à di limiti delle applicazioni. Considerare l’aumento dell’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 dell’applicazione per utente. Questo problema è correlato alla funzionalità di limiti delle applicazioni. 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] Communication error 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 l’avvio della sessione è in uno stato non valido o non disponibile. Possibili cause: Lo stato di alimentazione del VDA è sconosciuto o non disponibile, il VDA non si è riavviato dall’ultima sessione dell’utente, la condivisione della sessione è disabilitata mentre la sessione corrente richiede che sia abilitata, o il VDA è stato rimosso dal gruppo di consegna o dal sito. Verificare che il VDA sia in un gruppo di consegna. In caso contrario, aggiungerlo al gruppo di consegna appropriato. Verificare che ci siano VDA sufficienti 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 o il VDA sta riscontrando problemi interni. Verificare che il VDA sia 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 errori 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 di errore ID codice di errore Problema Azione
Sconosciuto - - -
Non registrato 3 - -
MaxCapacity (rappresentato come Carico massimo in Director) 4 La macchina segnala di essere alla massima capacità, ovvero all’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.
StuckOnBoot 2 La VM non ha completato la sequenza di avvio e non comunica con l’hypervisor. Assicurarsi che la VM si sia avviata correttamente sull’hypervisor. Controllare 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.
FailedToStart 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 di errore ID codice di errore Problema Azione
AgentShutdown 0 Il VDA ha subito uno spegnimento controllato. Accendere il VDA se non ci si aspetta che sia spento in base alle politiche di gestione dell’alimentazione esistenti. Esaminare eventuali errori nei registri eventi.
AgentSuspended 1 Il VDA è in modalità ibernazione o sospensione. Disattivare la modalità di 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 controller di consegna a causa di una mancata corrispondenza nelle versioni del protocollo Citrix. Allineare le versioni del VDA e del controller di consegna.
AgentAddressResolutionFailed 101 Il controller di consegna non è riuscito a risolvere l’indirizzo IP del VDA. Verificare che l’account della 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 diffuso, convalidare le impostazioni DNS sui controller di consegna. Verificare la risoluzione DNS dal controller eseguendo il comando nslookup.
101 Il controller di consegna non è riuscito a risolvere l’indirizzo IP del VDA. Verificare che l’account della 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 controller di consegna e il VDA. 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. 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 problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
102 Si è verificato un problema di comunicazione tra il controller di consegna e il VDA. 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 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’OU specifica del sito (dove le informazioni del controller del sito sono memorizzate in AD) configurata nel registro del 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 controller di consegna era vuota. Ciò può essere dovuto a un’installazione del 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 controller di consegna. Aggiornare il VDA o rimuovere il VDA e quindi reinstallarlo.
MissingAgentVersion 106 La versione del VDA non è compatibile con il controller di consegna. Reinstallare il software VDA se il problema interessa tutte le macchine.
InconsistentRegistrationCapabilities 107 Il VDA non può comunicare le sue capacità al Broker. Ciò può essere dovuto a incompatibilità tra le versioni del VDA e del controller di consegna. Le capacità di registrazione, che cambiano con ogni versione, sono espresse in una forma che non corrisponde alla richiesta di registrazione. Allineare le versioni del VDA e del controller di consegna.
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.
UnsupportedCredentialSecurity version 109 Il VDA e il controller di consegna non utilizzano lo stesso meccanismo di crittografia. Allineare le versioni del VDA e del controller di consegna.
InvalidRegistrationRequest 110 Il VDA ha effettuato 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 dell’agente di consegna virtuale con i controller di consegna in Citrix Virtual Apps and Desktops (CTX136668), per 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 declassare il 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 declassare il 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 riavviato 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ò verificarsi se gli aggiornamenti sono incompatibili con la versione VDA installata. Aggiornare il VDA se necessario. Verificare se gli aggiornamenti applicati sono supportati con la versione del VDA.
SessionPrepareFailure 206 Il Broker non ha completato un audit delle sessioni in esecuzione sul VDA. Se diffuso, riavviare il servizio Citrix Broker sul controller di consegna.
206 Il Broker non ha completato un audit 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. Avviarli se interrotti. 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 interrotto.
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 concorrenti. Considerare l’aggiunta di controller di consegna al sito o la creazione di un sito. È anche possibile aumentare il numero di VDA consentiti per la registrazione contemporanea con il controller di consegna tramite la chiave di registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Vedere l’articolo del Knowledge Center, Voci della chiave di registro utilizzate da Citrix Virtual Apps and Desktops (CTX117446) per maggiori informazioni. L’aumento di questo numero potrebbe richiedere più risorse CPU e memoria per il controller.
SettingsCreationFailure 208 Il Broker non ha costruito 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 log. Una volta riavviato il servizio Broker, riavviare il servizio Desktop sui VDA interessati e verificare che si registrino correttamente.
208 Il Broker non ha costruito 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 convalidare 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 dell’agente di consegna virtuale con i controller di consegna in Citrix Virtual Apps and Desktops (CTX136668), per 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.
Sconosciuto - Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Motivi di errore e risoluzione dei problemi di Citrix Director