Risoluzione dei problemi di connessione Citrix
La funzionalità Risoluzione dei problemi di connessione Citrix è progettata per consentire agli utenti finali di risolvere autonomamente ed efficacemente potenziali errori di avvio di desktop o applicazioni. Questo miglioramento mira a fornire agli utenti diagnostiche chiare, potenziali raccomandazioni e la possibilità di eseguire correzioni con un semplice clic.
Panoramica
-
Citrix offre ora messaggi di errore più granulari e migliorati per aiutare gli utenti a comprendere chiaramente la causa principale degli errori di avvio. La funzionalità Risoluzione dei problemi di connessione esegue un’analisi in tempo reale delle difficoltà di raggiungibilità del Virtual Delivery Agent (VDA) durante il processo di avvio. Presenta quindi messaggi di errore e raccomandazioni di facile comprensione per l’utente, 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 visualizza ora messaggi di errore chiari e di facile comprensione per l’utente 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, fungendo da riferimenti preziosi per un’indagine più approfondita.
-
Azioni di auto-recupero e risoluzione
La funzionalità Risoluzione dei problemi di connessione Citrix include passaggi che gli utenti possono intraprendere per recuperare automaticamente da problemi comuni, riducendo così 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) - Effettua nuovamente l’accesso 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, è necessario disporre delle 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 usare
La funzionalità di risoluzione dei problemi di connessione è abilitata per impostazione predefinita per gli ambienti Citrix DaaS. Vengono forniti messaggi di errore granulari e migliorati, insieme a raccomandazioni per la risoluzione, sia per le sessioni avviate tramite browser che per le sessioni avviate direttamente tramite l’app nativa Citrix Workspace.
Considerazioni importanti
Sebbene la funzionalità offra robuste 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 o 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 dell’app Citrix Workspace con Protezione app o 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 |
App Citrix Workspace richiesta 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 da 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, eseguire nuovamente l’autenticazione in 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 Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
CouldNotContactStore |
Si è verificato un errore durante il tentativo di comunicare con il VDA. Ciò potrebbe essere dovuto a un problema di connessione al server. | Chiudere e riaprire 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 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 Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
CCMLoadFailed |
Impossibile avviare la risorsa perché Connection Manager non è riuscito a caricarsi. | Chiudere e riaprire 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 Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
AppExiting |
Impossibile avviare la risorsa perché l’app Citrix Workspace è in fase di chiusura. | Chiudere e riaprire Citrix Workspace. Se il problema persiste, contattare l’amministratore di sistema. |
UTF8ConversionFailed |
Impossibile analizzare il file ICA. | Chiudere e riaprire 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 può essere trovato. | Per provare a risolvere il problema, disinstallare e reinstallare 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 |
L’avvio di Citrix Viewer è andato in timeout. | Provare ad avviare nuovamente la risorsa dal proprio store. Se il problema persiste, contattare l’amministratore di sistema. |
ViewerLaunchFailure |
Citrix Viewer non è riuscito ad avviarsi. | Provare ad avviare nuovamente 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 nuovamente 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. |
App Citrix Workspace 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 provare a risolvere il problema, rimuovere lo store da Citrix Workspace, quindi aggiungerlo di nuovo. Se il problema persiste, contattare l’amministratore di sistema. |
http404Error |
Le risorse non sono disponibili. | Contattare l’amministratore di sistema per assistenza. |
invalidTransactionId |
ID transazione non valido. | Attenda qualche minuto, quindi riprovi. Se il problema persiste, contatti l’amministratore di sistema. |
credentialsExpired |
La Sua password è scaduta. | Vada alle impostazioni dell’account per modificare la password. Se il problema persiste, contatti l’amministratore di sistema. |
badAddressError |
Impossibile trovare l’indirizzo della risorsa. | Controlli la connessione e riprovi. Se il problema persiste, contatti l’amministratore di sistema. |
accountDisabled |
Il Suo account è disabilitato. | Contatti l’amministratore di sistema per assistenza. |
accountLockedOut |
Il Suo account è temporaneamente bloccato. | Contatti l’amministratore di sistema per assistenza. |
storeServerConnectionError |
Si è verificato un errore durante il tentativo di comunicazione con il server. | Attenda qualche minuto, quindi riprovi. Se il problema persiste, contatti l’amministratore di sistema. |
internalServerError |
Si è verificato un errore sconosciuto durante il tentativo di connessione al server. | Contatti l’amministratore di sistema per assistenza. |
invalidXML |
Impossibile aprire la risorsa a causa di un errore del servizio XML. | Contatti l’amministratore di sistema per assistenza. |
badCredentials |
Le Sue credenziali sono scadute. | Per provare a risolvere il problema, si disconnetta da Citrix Workspace e quindi si riconnetta. Se il problema persiste, contatti l’amministratore di sistema. |
appRemoved |
La risorsa è stata rimossa o disabilitata dall’amministratore. | Per un elenco aggiornato delle app e dei desktop disponibili, aggiorni l’app Citrix Workspace oppure si disconnetta e si riconnetta. |
invalidLogonHours |
Impossibile accedere in questo momento a causa di restrizioni impostate dall’amministratore. | Riprovi durante l’orario di lavoro regolare. Se il problema persiste, contatti l’amministratore di sistema. |
connectionError |
Impossibile connettersi al server. Ciò può essere dovuto a un problema di connessione di rete. | Per provare a risolvere il problema, chiuda e riapra Citrix Workspace. Se il problema persiste, contatti 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. | Controlli la connessione e riprovi. Se il problema persiste, contatti l’amministratore di sistema. |
couldNotConnectToWorkstation |
Impossibile connettersi al desktop. | Chiuda e riapra Citrix Workspace. Se il problema persiste, contatti l’amministratore di sistema. |
retryReasonRebooting |
Si è verificato un errore durante l’avvio della risorsa. La workstation richiesta è in fase di riavvio. | Chiuda e riapra Citrix Workspace. Se il problema persiste, contatti l’amministratore di sistema. |
retryReasonResuming |
Si è verificato un errore durante l’avvio della risorsa. La workstation richiesta è in fase di ripristino. | Chiuda e riapra Citrix Workspace. Se il problema persiste, contatti l’amministratore di sistema. |
generalProblem |
Si è verificato un errore durante il tentativo di aprire la risorsa. | Chiuda e riapra Citrix Workspace. Se il problema persiste, contatti l’amministratore di sistema. |
retryReasonUnknown |
Si è verificato un errore nel file ICA. | Chiuda e riapra Citrix Workspace. Se il problema persiste, contatti l’amministratore di sistema. |
appRemoved |
La risorsa è stata rimossa o disabilitata dall’amministratore. | Per un elenco aggiornato delle app e dei desktop disponibili, aggiorni l’app Citrix Workspace oppure si disconnetta e si riconnetta. |
resourceError |
Si è verificato un errore durante il tentativo di avviare il file ICA. | Attenda qualche minuto, quindi riprovi. Se il problema persiste, contatti l’amministratore di sistema. Riavvii il VDA se è una macchina dedicata. |
resourceUnavailable |
Si è verificato un errore durante il tentativo di avviare il file ICA. | Attenda qualche minuto, quindi riprovi. Se il problema persiste, contatti l’amministratore di sistema. Riavvii il VDA se è una macchina dedicata. |
Risoluzione dei problemi di connessione Citrix
Copiato!
Non riuscito!