Risoluzione dei problemi di connessione Citrix
La funzionalità di risoluzione dei problemi di connessione Citrix è progettata per consentire agli utenti finali di risolvere autonomamente in modo efficace potenziali errori di avvio di desktop o applicazioni. Questo miglioramento mira a fornire agli utenti una diagnostica chiara, potenziali raccomandazioni e la possibilità di eseguire correzioni con un semplice clic.
Panoramica
Citrix ora offre messaggi di errore più granulari e migliorati per aiutare gli utenti a comprendere chiaramente la causa principale degli errori di avvio. La funzionalità di risoluzione dei problemi di connessione esegue un’analisi in tempo reale dei problemi di raggiungibilità del Virtual Delivery Agent (VDA) durante il processo di avvio. Presenta quindi messaggi di errore e raccomandazioni di facile utilizzo, consentendo agli utenti di risolvere il problema direttamente o di raccogliere i log per un ticket di supporto, se necessario.
Percorsi di connessione analizzati
La funzionalità diagnostica potenziali problemi di avvio di app e desktop virtuali attraverso punti di connessione critici, tra cui:
- Connettività di rete dal client al Gateway.
- Connessione dal Gateway al server StoreFront.
- Connessione dal server StoreFront al Broker.
- Connessione dal Broker al VDA.
Messaggi di errore e diagnostica migliorati
In caso di errori di avvio, Citrix ora visualizza messaggi di errore chiari e di facile utilizzo che individuano problemi di connessione specifici, come errori di rete, indisponibilità del server o errori VDA. Per gli amministratori, i codici di errore dettagliati sono forniti nei log, categorizzati in errori lato server e lato client, che fungono da riferimenti preziosi per un’indagine più approfondita.
Azioni di auto-recupero e risoluzione
La funzionalità di risoluzione dei problemi di connessione Citrix include passaggi che gli utenti possono intraprendere per recuperare automaticamente da problemi comuni, riducendo al minimo la necessità di intervento del supporto. Di seguito sono riportati i potenziali problemi che possono essere risolti con una risoluzione guidata:
- Riavvia VDA
- Riavvia l’app Citrix Workspace (CWA) - Accedi di nuovo a CWA
- Aggiorna l’elenco delle risorse
- Aggiorna l’app e riprova
- Riconfigura lo store
- Aggiorna CWA
- Reinstalla CWA
- Controlla la rete
- Attendi e riprova
Requisiti di sistema
Per utilizzare la funzionalità Risoluzione dei problemi di connessione, sono necessarie le seguenti versioni dell’app Citrix Workspace:
- Citrix Workspace app per Mac: Versione 2505 e successive
- Citrix Workspace app per Windows: Versione 2507 e successive
- Citrix Workspace app per iOS: Versione 2509 e successive
- Citrix Workspace app per Android: Versione 2509 e successive
Come si usa
La funzionalità Risoluzione problemi di connessione è abilitata per impostazione predefinita per gli ambienti Citrix DaaS. Messaggi di errore granulari e migliorati, insieme a raccomandazioni per la risoluzione, vengono forniti sia per le sessioni avviate tramite browser sia per le sessioni avviate direttamente tramite l’app nativa Citrix Workspace.
Considerazioni importanti
Sebbene la funzionalità offra solide capacità self-service, è importante notare quanto segue:
- L’azione di risoluzione “Riavvia VDA” non supporta le sessioni avviate tramite una modalità di avvio ibrida (ovvero, scaricare un file ICA da un browser e quindi avviarlo con l’app nativa Citrix Workspace).
Codici di errore
I codici di errore sono suddivisi tra errori lato server ed errori lato client. Di seguito sono riportate le tabelle con i codici di errore.
Errori comuni lato server
| ID errore | Descrizione | Raccomandazione |
|---|---|---|
ResourceNotFound |
La risorsa è stata rimossa dall’amministratore. | Per un elenco aggiornato di app e desktop disponibili, aggiornare l’app Citrix Workspace oppure disconnettersi e accedere di nuovo. |
WorkstationInMaintenance |
Il desktop è in manutenzione programmata. | Attendere il completamento della manutenzione, quindi riprovare. |
UnavailableDesktop |
Non ci sono desktop disponibili a cui connettersi. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
UnavailableAppProtectedDesktop |
Protezione app richiesta per aprire le risorse protette. | Eseguire l’aggiornamento a una versione di Citrix Workspace app con Protezione app, oppure contattare l’amministratore di sistema per assistenza. |
NotLicensed |
Impossibile avviare la risorsa perché al server manca la licenza appropriata. | Contattare l’amministratore di sistema per assistenza. |
NoMoreActiveSessions |
Impossibile avviare la risorsa perché non ci sono slot di sessione disponibili. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
GeneralAppLaunchError |
Si è verificato un errore sconosciuto durante il tentativo di aprire la risorsa. | Contattare l’amministratore di sistema per assistenza. |
ResourceDisabled |
L’amministratore ha disabilitato la risorsa. | Per un elenco aggiornato di app e desktop disponibili, aggiornare l’app Citrix Workspace o disconnettersi e accedere di nuovo. |
App Citrix Workspace per Windows
| ID errore | Descrizione | Raccomandazione |
|---|---|---|
CertificateError |
Si è verificato un errore con il certificato del server. | Contattare l’amministratore di sistema per assistenza. |
PassthroughClientError |
Esiste già una sessione attiva. | Contattare l’amministratore di sistema per assistenza. |
IcaFileRetrieveError |
Si è verificato un errore durante il tentativo di recuperare il file ICA. | Contattare l’amministratore di sistema per assistenza. |
Icafileretrieveerrorreconnection |
Si è verificato un errore durante il tentativo di recuperare il file ICA durante la riconnessione. | Contattare l’amministratore di sistema per assistenza. |
NoCWA |
È necessaria l’app Citrix Workspace per aprire le risorse. | Installare l’app Citrix Workspace o contattare l’amministratore di sistema per assistenza. |
CouldNotFindStore |
Impossibile recuperare la configurazione dello store richiesta per avviare la risorsa. | Rimuovere lo store dall’app Citrix Workspace, quindi aggiungerlo di nuovo. Se il problema persiste, contattare l’amministratore di sistema. |
noclientinstalled |
Impossibile recuperare le informazioni richieste per avviare la risorsa. | Aggiornare l’app Citrix Workspace o disconnettersi e accedere di nuovo. |
AuthCancelled |
La sessione di autenticazione è scaduta. | Per provare a risolvere il problema, riautenticarsi nell’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
IcaFileLaunchError |
Si è verificato un errore durante il tentativo di avviare il file ICA. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
CouldNotContactStore |
Si è verificato un errore durante il tentativo di comunicazione con il VDA. Ciò potrebbe essere dovuto a un problema di connessione al server. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
CCMError |
Impossibile avviare la risorsa a causa di un errore di Connection Manager. Codice errore: {errorCodeValue} | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
CCMInitFailed |
Impossibile avviare la risorsa perché Connection Manager non è riuscito a inizializzarsi. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
CCMLoadFailed |
Impossibile avviare la risorsa perché il Connection Manager non è riuscito a caricarsi. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
InvalidIcaParams |
Impossibile avviare la risorsa a causa di parametri ICA errati. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
AppExiting |
Impossibile avviare la risorsa perché l’app Citrix Workspace si sta chiudendo. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
UTF8ConversionFailed |
Impossibile analizzare il file ICA. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
MissingSoftware |
È necessario un software aggiuntivo per utilizzare questa app. | Contattare l’amministratore di sistema per assistenza. |
App Citrix Workspace per Mac
| ID errore | Descrizione | Raccomandazione |
|---|---|---|
AuthCancelled |
La sessione di autenticazione è scaduta. | Per provare a risolvere il problema, autenticarsi prima con le proprie credenziali. Se il problema persiste, contattare l’amministratore di sistema. |
NetworkError |
Impossibile avviare la risorsa a causa di un problema di connessione di rete. | Controllare la connessione e riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
ViewerNotFound |
Il percorso di Citrix Viewer non è stato trovato. | Per provare a risolvere il problema, disinstallare e reinstallare l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
ViewerOpenEventFailed |
Citrix Viewer non è riuscito a creare un evento. | Provare ad avviare nuovamente la risorsa dal proprio store. Se il problema persiste, contattare l’amministratore di sistema. |
ViewerLaunchTimeout |
Il lancio di Citrix Viewer è scaduto. | Provare ad avviare la risorsa dal proprio store. Se il problema persiste, contattare l’amministratore di sistema. |
ViewerLaunchFailure |
Avvio di Citrix Viewer non riuscito. | Provare ad avviare la risorsa dal proprio store. Se il problema persiste, contattare l’amministratore di sistema. |
InvalidICAFile |
Impossibile avviare la risorsa perché il file ICA non è valido. | Provare ad avviare la risorsa dal proprio store. Se il problema persiste, contattare l’amministratore di sistema. |
CertificateError |
Si è verificato un errore con il certificato del server. | Contattare l’amministratore di sistema per assistenza. |
ResourceError |
Si è verificato un errore durante il tentativo di avviare la risorsa. Ciò potrebbe essere dovuto a un problema di connessione al server. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
UnknownError |
Si è verificato un errore sconosciuto durante il tentativo di aprire la risorsa. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
Citrix Workspace app per iOS
| ID errore | Descrizione | Raccomandazione |
|---|---|---|
credentialsMustChange |
La password deve essere modificata. | Andare alle impostazioni dell’account per modificare la password. Se il problema persiste, contattare l’amministratore di sistema. |
noConfigurationFile |
Impossibile recuperare i dati di configurazione richiesti. | Per tentare di risolvere il problema, rimuovere lo store da Citrix Workspace app, quindi aggiungerlo di nuovo. Se il problema persiste, contattare l’amministratore di sistema. |
http404Error |
Le risorse non sono disponibili. | Contatta l’amministratore di sistema per assistenza. |
invalidTransactionId |
ID transazione non valido. | Attendi qualche minuto, quindi riprova. Se il problema persiste, contatta l’amministratore di sistema. |
credentialsExpired |
La tua password è scaduta. | Vai alle impostazioni dell’account per modificare la password. Se il problema persiste, contatta l’amministratore di sistema. |
badAddressError |
Impossibile trovare l’indirizzo della risorsa. | Controlla la connessione e riprova. Se il problema persiste, contatta l’amministratore di sistema. |
accountDisabled |
Il tuo account è disabilitato. | Contatta l’amministratore di sistema per assistenza. |
accountLockedOut |
Il tuo account è temporaneamente bloccato. | Contattare l’amministratore di sistema per assistenza. |
storeServerConnectionError |
Si è verificato un errore durante il tentativo di comunicazione con il server. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
internalServerError |
Si è verificato un errore sconosciuto durante il tentativo di connessione al server. | Contattare l’amministratore di sistema per assistenza. |
invalidXML |
Impossibile aprire la risorsa a causa di un errore del servizio XML. | Contattare l’amministratore di sistema per assistenza. |
badCredentials |
Le credenziali sono scadute. | Per provare a risolvere il problema, disconnettersi dall’app Citrix Workspace e quindi accedere di nuovo. Se il problema persiste, contattare l’amministratore di sistema. |
appRemoved |
La risorsa è stata rimossa o disabilitata dall’amministratore. | Per un elenco aggiornato di app e desktop disponibili, aggiornare l’app Citrix Workspace o disconnettersi e accedere di nuovo. |
invalidLogonHours |
Impossibile accedere in questo momento a causa delle restrizioni impostate dall’amministratore. | Riprovare durante l’orario di lavoro. Se il problema persiste, contattare l’amministratore di sistema. |
connectionError |
Impossibile connettersi al server. Ciò potrebbe essere dovuto a un problema di connessione di rete. | Per provare a risolvere il problema, chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
App Citrix Workspace per Android
| ID errore | Descrizione | Raccomandazione |
|---|---|---|
http404Error |
Impossibile avviare la risorsa a causa di un problema di connessione di rete. | Controllare la connessione e riprovare. Se il problema persiste, contattare l’amministratore di sistema. |
couldNotConnectToWorkstation |
Impossibile connettersi al desktop. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
retryReasonRebooting |
Si è verificato un errore durante l’avvio della risorsa. La workstation richiesta è in fase di riavvio. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
retryReasonResuming |
Si è verificato un errore durante l’avvio della risorsa. La workstation richiesta è in fase di ripristino. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
generalProblem |
Si è verificato un errore durante il tentativo di aprire la risorsa. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
retryReasonUnknown |
Si è verificato un errore nel file ICA. | Chiudere e riaprire l’app Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
appRemoved |
La risorsa è stata rimossa o disabilitata dall’amministratore. | Per un elenco aggiornato di app e desktop disponibili, aggiornare l’app Citrix Workspace oppure disconnettersi e accedere di nuovo. |
resourceError |
Si è verificato un errore durante il tentativo di avviare il file ICA. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. Riavviare il VDA se si tratta di una macchina dedicata. |
resourceUnavailable |
Si è verificato un errore durante il tentativo di avviare il file ICA. | Attendere qualche minuto, quindi riprovare. Se il problema persiste, contattare l’amministratore di sistema. Riavviare il VDA se si tratta di una macchina dedicata. |
Risoluzione dei problemi di connessione Citrix
Copiato!
Non riuscito!