Citrix Virtual Apps and Desktops

Motivi di errore e risoluzione dei problemi di Citrix Director

Le tabelle seguenti descrivono le varie categorie di errore, le cause 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 di brokering. Raccogliere i log CDF sul controller e contattare il supporto Citrix.
[0] Nessuno [1] Nessuno Nessuno N/D
[2] ErroreMacchina [2] PreparazioneSessione La richiesta di preparazione della sessione dal delivery controller al VDA è fallita. 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, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
[2] ErroreMacchina [3] TimeoutRegistrazione Il VDA è stato acceso, ma si è verificato un timeout durante il tentativo di registrazione con il delivery controller. Verificare che il servizio Citrix Broker sia in esecuzione sul delivery controller e che il servizio Desktop sia in esecuzione sul VDA. Avviare ciascuno se interrotto.
[1] ErroreConnessioneClient [4] TimeoutConnessione Il client non si è connesso al VDA dopo che il VDA era stato preparato per l’avvio della sessione. La sessione è stata correttamente intermediata, 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 log eventi sul client e sul VDA per eventuali errori. Risolvere eventuali problemi di connettività di rete tra il client e il VDA.
[4] NessunaLicenzaDisponibile [5] Licenze La richiesta di licenza è fallita. Possibili cause: numero insufficiente di licenze o il server delle licenze è inattivo da più di 30 giorni. Verificare che il server delle licenze sia online e raggiungibile. Risolvere eventuali problemi di connettività di rete al server delle licenze o riavviare il server delle licenze se sembra non funzionare correttamente. Verificare che ci siano licenze sufficienti nell’ambiente e allocarne di più se necessario.
[1] ErroreConnessioneClient [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 delivery group. 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 eventuali 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] ErroreConnessioneClient [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] ErroreConnessioneClient [8] ErroreGenerico 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] ModalitàManutenzione Il VDA, o il delivery group a cui appartiene il VDA, è impostato in modalità manutenzione. Determinare se la modalità manutenzione è necessaria. Disabilitare la modalità manutenzione sul delivery group o sulla macchina in questione se non è necessaria e istruire l’utente a tentare di riconnettersi.
[5] Configurazione [10] ApplicazioneDisabilitata L’applicazione non può essere accessibile dagli utenti finali perché è stata disabilitata dall’amministratore. Se l’applicazione è destinata all’uso in produzione, abilitare l’applicazione e istruire l’utente a riconnettersi.
[4] NessunaLicenzaDisponibile [11] FunzionalitàLicenzaRifiutata 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] NessunaCapacitàDisponibile [13] LimiteSessioniRaggiunto Tutti i VDA sono in uso e non c’è capacità per ospitare altre sessioni. Possibili cause: tutti i VDA sono in uso (per VDA con OS a sessione singola) o tutti i VDA hanno raggiunto il numero massimo configurato di sessioni concorrenti consentite (per VDA con OS a sessione multipla). Verificare se ci sono VDA in modalità manutenzione. Disabilitare la modalità manutenzione se non è necessaria per liberare maggiore 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 con OS a sessione multipla. Considerare l’aggiunta di più VDA con 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 errata configurazione.
[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 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à manutenzione. Verificare che l’applicazione o il desktop sia ancora pubblicato e che i VDA non siano in modalità manutenzione. Determinare se i VDA con OS a sessione multipla sono a pieno carico. In tal caso, fornire più VDA con OS a sessione multipla. Verificare che ci siano VDA con OS a sessione singola disponibili per le connessioni. Fornire più VDA con OS a sessione singola se necessario.
[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] ErroreMacchina [17] NessunaSessioneDaRiconnettere Il client ha tentato di riconnettersi a una sessione specifica ma la sessione è stata terminata. Riprovare la riconnessione del controllo workspace.
[2] ErroreMacchina [18] AvvioFallito 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] ErroreMacchina [19] Rifiutato Il delivery controller 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 delivery controller e il VDA possano comunicare correttamente. In caso contrario, risolvere eventuali problemi di firewall o di routing di rete.
[2] ErroreMacchina [20] ErroreSetConfigurazione Il delivery controller 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] NessunaCapacitàDisponibile [21] MaxIstanzeTotaliSuperato È 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 dell’applicazione. Considerare di aumentare l’impostazione dell’applicazione, Limitare il numero di istanze in esecuzione contemporaneamente, a un valore più alto se la licenza lo consente.
[3] NessunaCapacitàDisponibile [22] MaxIstanzePerUtenteSuperato 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à 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] ErroreConnessioneClient [23] ErroreComunicazione Il delivery controller 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 delivery controller configurati per il VDA siano accurati tramite i dettagli nel log eventi dell’applicazione.
[3] NessunaCapacitàDisponibile [100] NessunaMacchinaDisponibile Il servizio di monitoraggio converte [12] NessunDesktopDisponibile in questo codice di errore. Il VDA assegnato per l’avvio della 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 si è 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 delivery group o dal sito. Verificare che il VDA sia in un delivery group. In caso contrario, aggiungerlo al delivery group 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à manutenzione.
[2] ErroreMacchina [101] MacchinaNonFunzionante. Il servizio di monitoraggio converte [12] NessunDesktopDisponibile in questo codice di errore. Il VDA non è operativo. Possibili cause: il VDA è stato rimosso dal delivery group, 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 delivery group. In caso contrario, aggiungerlo al delivery group 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à manutenzione. Riavviare il VDA una volta risolti questi problemi.

Tipo di errore della macchina

Codice errore ID codice errore Problema Azione
Sconosciuto - - -
NonRegistrato 3 - -
CapacitàMassima (rappresentata come Carico Massimo in Director) 4 La macchina si sta segnalando a capacità massima, ovvero Indice di Carico Massimo Assicurarsi che tutti gli hypervisor siano accesi. Aggiungere più macchine ai Delivery Group interessati aggiungendo maggiore capacità all’hypervisor o aggiungendo più hypervisor.
BloccatoAll’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 la VM per altri messaggi, come problemi del sistema operativo. Assicurarsi che gli strumenti dell’hypervisor siano installati sulla VM. Assicurarsi che il VDA sia installato sulla VM.
AvvioFallito 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
SpegnimentoAgente 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 log eventi.
AgenteSospeso 1 Il VDA è in modalità ibernazione o sospensione. Disattivare la modalità ibernazione del VDA. Considerare di disabilitare l’ibernazione per i VDA di Citrix Virtual Apps and Desktops tramite le impostazioni di alimentazione.
VersioneIncompatibile 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.
RisoluzioneIndirizzoAgenteFallita 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 in 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 in DNS siano accurati. In caso contrario, correggerli.
AgenteNonContattabile 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, Troubleshooting Virtual Delivery Agent Registration with delivery controllers 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, Troubleshooting Virtual Delivery Agent Registration with delivery controllers 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.
OUActiveDirectoryAgenteErrata 103 Si è verificata una configurazione errata di rilevamento di Active Directory. L’OU specifica del sito (dove le informazioni del controller del sito sono memorizzate 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.
RichiestaRegistrazioneVuota 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 log eventi dell’applicazione.
CapacitàRegistrazioneMancanti 105 La versione del VDA non è compatibile con il delivery controller. Aggiornare il VDA o rimuovere il VDA e quindi reinstallarlo.
VersioneAgenteMancante 106 La versione del VDA non è compatibile con il delivery controller. Reinstallare il software VDA se il problema sta interessando tutte le macchine.
CapacitàRegistrazioneIncoerenti 107 Il VDA non può comunicare le sue capacità al Broker. Ciò può essere dovuto a incompatibilità tra le versioni del VDA e del delivery controller. 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 delivery controller.
FunzionalitàNonLicenziata 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.
VersioneSicurezzaCredenzialiNonSupportata 109 Il VDA e il delivery controller non utilizzano lo stesso meccanismo di crittografia. Allineare le versioni del VDA e del delivery controller.
RichiestaRegistrazioneNonValida 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, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
MancataCorrispondenzaSessioneSingolaMultipla 111 Il tipo di sistema operativo del VDA non è compatibile con il catalogo macchine o il delivery group. Aggiungere il VDA al tipo di catalogo macchine o al delivery group corretto contenente macchine con lo stesso sistema operativo.
LivelloFunzionaleTroppoBassoPerCatalogo 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.
LivelloFunzionaleTroppoBassoPerGruppoDesktop 113 Il delivery group è impostato su un livello funzionale VDA superiore rispetto alla versione VDA installata. Verificare che il livello funzionale del delivery group 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 che è di nuovo attivo per aiutare a determinare la causa principale dello spegnimento.
AggiornamentoImpostazioniAgenteRifiutato 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. Esaminare se gli aggiornamenti applicati sono supportati con la versione VDA.
ErrorePreparazioneSessione 206 Il Broker non ha completato un audit delle sessioni in esecuzione sul VDA. Se diffuso, riavviare il servizio Citrix Broker sul delivery controller.
206 Il Broker non ha completato un audit delle sessioni in esecuzione sul VDA. Contattare il supporto Citrix.
ContattoPerso 207 Il delivery controller 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 delivery controller 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 delivery controller configurati per il VDA siano accurati tramite i dettagli nel log eventi dell’applicazione. 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.
207 Il delivery controller 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.
LimiteRegistrazioneBrokerRaggiunto 301 Il delivery controller ha raggiunto il numero massimo configurato di VDA che possono registrarsi contemporaneamente. Per impostazione predefinita, il delivery controller consente 10.000 registrazioni VDA concorrenti. Considerare di aggiungere delivery controller al Sito o di creare un Sito. È anche possibile aumentare il numero di VDA consentiti per la registrazione contemporanea con il delivery controller tramite la chiave di registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Per maggiori informazioni, consultare l’articolo del Knowledge Center, Registry Key Entries Used by Citrix Virtual Apps and Desktops (CTX117446). L’aumento di questo numero potrebbe richiedere più risorse CPU e memoria per il controller.
ErroreCreazioneImpostazioni 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 delivery controller 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.
ErroreInvioImpostazioni 204 Il Broker non ha inviato le impostazioni e i dati di configurazione al VDA. Se il Broker è in grado di raccogliere i dati ma non riesce a 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, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), per i problemi comuni che causano problemi di comunicazione tra il controller e il VDA.
AgenteRichiesto 2 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
RiavvioDesktop 201 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
DesktopRimosso 202 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
ErroreAuditSessione 205 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
ErroreSconosciuto 300 Si è verificato un errore sconosciuto. Contattare il supporto Citrix.
MancataCorrispondenzaStatoRegistrazione 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