Motivi di errore e risoluzione dei problemi di Citrix Director

Le tabelle seguenti descrivono le diverse categorie di errore, i motivi e le azioni da intraprendere 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 di connessione segnalato dalle informazioni condivise dal servizio Brokering. Raccogliere i log CDF sul controller e contattare il supporto Citrix.
[0] Nessuno [1] Nessuno Nessuno N/D
[2] Errore macchina [2] Preparazione sessione La richiesta di preparazione della sessione dal controller di distribuzione al VDA è fallita. 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 distribuzione virtuale con i controller di distribuzione in Citrix Virtual Apps and Desktops per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
[2] Errore macchina [3] Timeout registrazione Il VDA è stato acceso, ma si è verificato un timeout durante il tentativo di registrazione con il controller di distribuzione. Verificare che il servizio Citrix Broker sia in esecuzione sul controller di distribuzione e che il servizio Desktop sia in esecuzione sul VDA. Avviare ciascuno se interrotto.
[1] Errore di connessione client [4] Timeout connessione 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 log eventi sul client e sul VDA per eventuali errori. Risolvere eventuali problemi di connettività di rete tra il client e il VDA.
[4] Nessuna licenza disponibile [5] Licenze La richiesta di licenza è fallita. 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] Errore di connessione client [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 è corrotto 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 distribuzione. 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 log 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 log eventi sul VDA e risolvere eventuali problemi di registrazione.
[1] Errore di connessione client [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] Errore di connessione client [8] Errore generale La sessione non è riuscita ad avviarsi. 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] Configurazione [9] Modalità di manutenzione Il VDA, o il gruppo di distribuzione 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 distribuzione 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 accessata 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à 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 Citrix Virtual Apps and Desktops™ esistenti.
[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 concorrenti consentite (per VDA OS a sessione multipla). 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 della policy Citrix per consentire più sessioni per VDA server. Considerare di aggiungere più VDA OS a sessione multipla. Considerare di aggiungere più VDA OS a sessione singola.
[5] Configurazione [14] Protocollo non consentito I protocolli ICA e RDP non sono consentiti. Eseguire il comando PowerShell Get-BrokerAccessPolicyRule sul controller di distribuzione e verificare che il valore AllowedProtocols elenchi tutti i protocolli desiderati. Questo problema si verifica solo se c’è una configurazione errata.
[5] Configurazione [15] Risorsa non disponibile L’applicazione o il desktop a cui l’utente sta tentando di connettersi non è disponibile. Questa applicazione o desktop potrebbe non esistere, o 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 a sessione multipla sono a pieno carico. In tal caso, eseguire il provisioning di più VDA OS a sessione multipla. 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] Configurazione [16] Riconnessione sessione attiva disabilitata 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 distribuzione, 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] Errore macchina [17] Nessuna sessione da riconnettere Il client ha tentato di riconnettersi a una sessione specifica ma la sessione è stata terminata. Riprovare la riconnessione del controllo dello spazio di lavoro.
[2] Errore macchina [18] Avvio fallito 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] Errore macchina [19] Rifiutato Il controller di distribuzione 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 distribuzione e il VDA possano comunicare correttamente. In caso contrario, risolvere eventuali problemi di firewall o di routing di rete.
[2] Errore macchina [20] Errore set di configurazione Il controller di distribuzione non ha inviato i dati di configurazione richiesti, come le impostazioni delle policy 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] Nessuna capacità disponibile [21] Numero massimo di istanze totali superato È 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 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] Nessuna capacità disponibile [22] Numero massimo di istanze per utente superato 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] Errore di connessione client [23] Errore di comunicazione Il controller di distribuzione 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 distribuzione configurati per il VDA siano accurati tramite i dettagli nel log eventi dell’applicazione.
[3] Nessuna capacità disponibile [100] Nessuna macchina disponibile. Il servizio di monitoraggio converte [12] NoDesktopAvailable in questo codice di errore. Il VDA assegnato per avviare la 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 distribuzione o dal sito. Verificare che il VDA sia in un gruppo di distribuzione. In caso contrario, aggiungerlo al gruppo di distribuzione 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] Errore macchina [101] Macchina non funzionante. 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 distribuzione, 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 distribuzione. In caso contrario, aggiungerlo al gruppo di distribuzione 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 macchina

Codice errore ID codice errore Problema Azione
Sconosciuto - - -
Non registrato 3 - -
Capacità massima (rappresentata come Carico massimo sulla console di Director) 4 La macchina si segnala alla massima capacità, ovvero all’indice di carico massimo Assicurarsi che tutti gli hypervisor siano accesi. Aggiungere più macchine ai gruppi di distribuzione interessati aggiungendo più capacità all’hypervisor o aggiungendo più hypervisor.
Bloccato all’avvio 2 La VM non ha completato la sua sequenza di avvio e non sta comunicando 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.
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
Arresto agente 0 Il VDA ha subito uno spegnimento controllato. Accendere il VDA se non ci si aspetta che sia spento in base alle policy di gestione dell’alimentazione esistenti. Esaminare eventuali errori nei log eventi.
Agente sospeso 1 Il VDA è in modalità ibernazione o sospensione. Disattivare la modalità di ibernazione del VDA. Considerare di disabilitare l’ibernazione per i VDA di Citrix Virtual Apps and Desktops tramite le impostazioni di alimentazione.
Versione incompatibile 100 Il VDA non può comunicare con il controller di distribuzione a causa di una mancata corrispondenza nelle versioni del protocollo Citrix. Allineare le versioni del VDA e del controller di distribuzione.
Risoluzione indirizzo agente fallita 101 Il controller di distribuzione 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 in DNS siano accurati. In caso contrario, correggerli. Se diffuso, convalidare le impostazioni DNS sui controller di distribuzione. Verificare la risoluzione DNS dal controller eseguendo il comando nslookup.
101 Il controller di distribuzione 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 in DNS siano accurati. In caso contrario, correggerli.
Agente non contattabile 102 Si è verificato un problema di comunicazione tra il controller di distribuzione e il VDA. Utilizzare un ping per verificare che il controller di distribuzione 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 distribuzione virtuale con i controller di distribuzione 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 controller di distribuzione 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 distribuzione virtuale con i controller di distribuzione 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.
OU Active Directory agente errata 103 Si è verificata una configurazione errata della scoperta 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.
Richiesta di registrazione vuota 104 La richiesta di registrazione inviata dal VDA al controller di distribuzione era vuota. Ciò può essere dovuto a un’installazione software VDA corrotta. Riavviare il servizio Desktop sul VDA per riavviare il processo di registrazione e verificare che il VDA si registri correttamente tramite il log eventi dell’applicazione.
Capacità di registrazione mancanti 105 La versione del VDA non è compatibile con il controller di distribuzione. Aggiornare il VDA o rimuovere il VDA e quindi reinstallarlo.
Versione agente mancante 106 La versione del VDA non è compatibile con il controller di distribuzione. Reinstallare il software VDA se il problema interessa tutte le macchine.
Capacità di registrazione incoerenti 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 distribuzione. 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 distribuzione.
Non licenziato per la funzionalità 108 La funzionalità che si sta tentando di utilizzare non è licenziata. Controllare l’edizione della licenza Citrix o rimuovere il VDA e quindi reinstallarlo.
108 La funzionalità che si sta tentando di utilizzare non è licenziata. Contattare il supporto Citrix.
Versione di sicurezza delle credenziali non supportata 109 Il VDA e il controller di distribuzione non utilizzano lo stesso meccanismo di crittografia. Allineare le versioni del VDA e del controller di distribuzione.
Richiesta di registrazione non valida 110 Il VDA ha effettuato una richiesta di registrazione al Broker ma il contenuto della richiesta è corrotto 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 distribuzione virtuale con i controller di distribuzione in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
Mancata corrispondenza sessione singola/multipla 111 Il tipo di sistema operativo del VDA non è compatibile con il catalogo macchine o il gruppo di distribuzione. Aggiungere il VDA al tipo di catalogo macchine corretto o al gruppo di distribuzione contenente macchine con lo stesso sistema operativo.
Livello funzionale troppo basso per il catalogo 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.
Livello funzionale troppo basso per il gruppo desktop 113 Il gruppo di distribuzione è impostato su un livello funzionale VDA superiore rispetto alla versione VDA installata. Verificare che il livello funzionale del gruppo di distribuzione del VDA corrisponda a quello del VDA. Aggiornare o declassare il catalogo macchine in modo che corrisponda a quello del VDA.
Spegnimento 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 log eventi sul VDA una volta ripristinato per aiutare a determinare la causa principale dello spegnimento.
Aggiornamento impostazioni agente rifiutato 203 Impostazioni come le policy 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 VDA.
Errore preparazione sessione 206 Il Broker non ha completato un audit delle sessioni in esecuzione sul VDA. Se diffuso, riavviare il servizio Citrix Broker sul controller di distribuzione.
206 Il Broker non ha completato un audit delle sessioni in esecuzione sul VDA. Contattare il supporto Citrix.
Contatto perso 207 Il controller di distribuzione 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 distribuzione 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 distribuzione configurati per il VDA siano accurati tramite i dettagli nel log eventi dell’applicazione. Utilizzare un ping per verificare che il controller di distribuzione e il VDA possano comunicare correttamente. In caso contrario, risolvere eventuali problemi di firewall o di rete.
207 Il controller di distribuzione 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. Avviare se interrotto.
Limite di registrazione Broker raggiunto 301 Il controller di distribuzione ha raggiunto il numero massimo configurato di VDA che possono registrarsi contemporaneamente. Per impostazione predefinita, il controller di distribuzione consente 10.000 registrazioni VDA concorrenti. Considerare di aggiungere controller di distribuzione al sito o di creare un sito. È anche possibile aumentare il numero di VDA consentiti per la registrazione contemporanea con il controller di distribuzione tramite la chiave di registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Per maggiori 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.
Errore creazione impostazioni 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 log eventi sul controller di distribuzione per eventuali errori. Riavviare il Broker Service se un problema specifico non è evidente nei log. Una volta riavviato il Broker Service, 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.
Errore invio impostazioni 204 Il Broker non ha inviato i dati di impostazione e 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 log 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 distribuzione virtuale con i controller di distribuzione in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
Agente richiesto 2 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Riavvio desktop 201 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Desktop rimosso 202 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Errore audit sessione 205 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Errore sconosciuto 300 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
Mancata corrispondenza stato registrazione 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