Dépannage de la connexion Citrix
La fonctionnalité de dépannage de la connexion Citrix est conçue pour permettre aux utilisateurs finaux de résoudre efficacement eux-mêmes les éventuels échecs de lancement de bureaux ou d’applications. Cette amélioration vise à fournir aux utilisateurs des diagnostics clairs, des recommandations potentielles et la possibilité d’exécuter des correctifs en un simple clic.
Vue d’ensemble
Citrix fournit désormais des messages d’erreur plus granulaires et améliorés pour aider les utilisateurs à comprendre clairement la cause première des échecs de lancement. La fonctionnalité de dépannage de la connexion effectue une analyse en temps réel des problèmes d’accessibilité au Virtual Delivery Agent (VDA) pendant le processus de lancement. Elle présente ensuite des messages d’erreur et des recommandations conviviaux, permettant aux utilisateurs de résoudre le problème directement ou de collecter des journaux pour un ticket de support si nécessaire.
Chemins de connexion analysés
La fonctionnalité diagnostique les problèmes potentiels de lancement d’applications et de bureaux virtuels à travers les points de connexion critiques, notamment :
- Connectivité réseau du client à la passerelle.
- Connexion de la passerelle au serveur StoreFront.
- Connexion du serveur StoreFront au Broker.
- Connexion du Broker au VDA.
Messages d’erreur et diagnostics améliorés
En cas d’échec de lancement, Citrix affiche désormais des messages d’erreur clairs et conviviaux qui identifient des problèmes de connexion spécifiques, tels que des erreurs réseau, l’indisponibilité du serveur ou des défaillances du VDA. Pour les administrateurs, des codes d’erreur détaillés sont fournis dans les journaux, classés en erreurs côté serveur et côté client, servant de références précieuses pour une investigation plus approfondie.
Actions d’auto-récupération et de correction
La fonctionnalité de dépannage de la connexion Citrix inclut des étapes que les utilisateurs peuvent suivre pour se rétablir automatiquement des problèmes courants, minimisant ainsi le besoin d’intervention du support. Voici les problèmes potentiels qui peuvent être résolus avec une correction guidée :
- Redémarrer le VDA
- Redémarrer l’application Citrix Workspace (CWA) - Se reconnecter à CWA
- Actualiser la liste des ressources
- Actualiser l’application et réessayer
- Reconfigurer le magasin
- Mettre à niveau CWA
- Réinstaller CWA
- Vérifier le réseau
- Attendre et réessayer
Configuration système requise
Pour utiliser la fonctionnalité de dépannage de la connexion, disposez des versions suivantes de l’application Citrix Workspace :
- Application Citrix Workspace pour Mac : Version 2505 et versions ultérieures
- Application Citrix Workspace pour Windows : Version 2507 et versions ultérieures
- Application Citrix Workspace pour iOS : Version 2509 et versions ultérieures
- Application Citrix Workspace pour Android : Version 2509 et versions ultérieures
Comment utiliser
La fonctionnalité de dépannage de connexion est activée par défaut pour les environnements Citrix DaaS. Des messages d’erreur granulaires et améliorés, ainsi que des recommandations de correction, sont fournis pour les sessions lancées via un navigateur et les sessions lancées directement via l’application native Citrix Workspace.
Considérations importantes
Bien que la fonctionnalité offre de solides capacités en libre-service, il est important de noter ce qui suit :
- L’action de correction « Redémarrer le VDA » ne prend pas en charge les sessions lancées via un mode de lancement hybride (c’est-à-dire, le téléchargement d’un fichier ICA depuis un navigateur, puis son lancement avec l’application native Citrix Workspace).
Codes d’erreur
Les codes d’erreur sont répartis entre les erreurs côté serveur et les erreurs côté client. Voici les tableaux avec les codes d’erreur.
Erreurs courantes côté serveur
| ID d’erreur | Description | Recommandation |
|---|---|---|
ResourceNotFound |
La ressource a été supprimée par votre administrateur. | Pour obtenir une liste à jour des applications et bureaux disponibles, actualisez l’application Citrix Workspace ou déconnectez-vous et reconnectez-vous. |
WorkstationInMaintenance |
Le bureau est en maintenance planifiée. | Attendez que la maintenance soit terminée, puis réessayez. |
UnavailableDesktop |
Aucun bureau n’est disponible pour la connexion. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
UnavailableAppProtectedDesktop |
Protection des applications requise pour ouvrir les ressources protégées. | Mettez à niveau vers une version de l’application Citrix Workspace avec Protection des applications, ou contactez votre administrateur système pour obtenir de l’aide. |
NotLicensed |
Impossible de lancer la ressource car le serveur ne dispose pas de la licence appropriée. | Contactez votre administrateur système pour obtenir de l’aide. |
NoMoreActiveSessions |
Impossible de lancer la ressource car il n’y a pas de créneaux de session disponibles. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
GeneralAppLaunchError |
Une erreur inconnue s’est produite lors de la tentative d’ouverture de la ressource. | Contactez votre administrateur système pour obtenir de l’aide. |
ResourceDisabled |
Votre administrateur a désactivé la ressource. | Pour obtenir une liste à jour des applications et bureaux disponibles, actualisez l’application Citrix Workspace ou déconnectez-vous et reconnectez-vous. |
Application Citrix Workspace pour Windows
| ID d’erreur | Description | Recommandation |
|---|---|---|
CertificateError |
Une erreur est survenue avec le certificat du serveur. | Contactez votre administrateur système pour obtenir de l’aide. |
PassthroughClientError |
Il existe déjà une session active. | Contactez votre administrateur système pour obtenir de l’aide. |
IcaFileRetrieveError |
Une erreur s’est produite lors de la tentative de récupération du fichier ICA. | Contactez votre administrateur système pour obtenir de l’aide. |
Icafileretrieveerrorreconnection |
Une erreur s’est produite lors de la tentative de récupération du fichier ICA pendant la reconnexion. | Contactez votre administrateur système pour obtenir de l’aide. |
NoCWA |
L’application Citrix Workspace est requise pour ouvrir les ressources. | Installez l’application Citrix Workspace ou contactez votre administrateur système pour obtenir de l’aide. |
CouldNotFindStore |
Impossible de récupérer la configuration de magasin requise pour lancer la ressource. | Supprimez le magasin de l’application Citrix Workspace, puis ajoutez-le à nouveau. Si le problème persiste, contactez votre administrateur système. |
noclientinstalled |
Impossible de récupérer les informations requises pour lancer la ressource. | Actualisez l’application Citrix Workspace ou déconnectez-vous et reconnectez-vous. |
AuthCancelled |
La session d’authentification a expiré. | Pour tenter de résoudre le problème, réauthentifiez-vous dans l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
IcaFileLaunchError |
Une erreur s’est produite lors de la tentative de démarrage du fichier ICA. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
CouldNotContactStore |
Une erreur s’est produite lors de la tentative de communication avec le VDA. Cela peut être dû à un problème de connexion au serveur. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
CCMError |
Impossible de lancer la ressource en raison d’une erreur du gestionnaire de connexion. Code d’erreur : {errorCodeValue} | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
CCMInitFailed |
Impossible de lancer la ressource car le gestionnaire de connexion n’a pas pu s’initialiser. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
CCMLoadFailed |
Impossible de lancer la ressource car le gestionnaire de connexion n’a pas pu se charger. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
InvalidIcaParams |
Impossible de lancer la ressource en raison de paramètres ICA incorrects. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
AppExiting |
Impossible de lancer la ressource car l’application Citrix Workspace est en cours de fermeture. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
UTF8ConversionFailed |
Impossible d’analyser le fichier ICA. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
MissingSoftware |
Vous avez besoin d’un logiciel supplémentaire pour utiliser cette application. | Contactez votre administrateur système pour obtenir de l’aide. |
Application Citrix Workspace pour Mac
| ID d’erreur | Description | Recommandation |
|---|---|---|
AuthCancelled |
La session d’authentification a expiré. | Pour tenter de résoudre le problème, authentifiez-vous d’abord avec vos informations d’identification. Si le problème persiste, contactez votre administrateur système. |
NetworkError |
Impossible de lancer la ressource en raison d’un problème de connexion réseau. | Vérifiez votre connexion et réessayez. Si le problème persiste, contactez votre administrateur système. |
ViewerNotFound |
Le chemin d’accès de Citrix Viewer est introuvable. | Pour tenter de résoudre le problème, désinstallez et réinstallez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
ViewerOpenEventFailed |
Citrix Viewer n’a pas réussi à créer un événement. | Essayez de lancer la ressource depuis votre Store à nouveau. Si le problème persiste, contactez votre administrateur système. |
ViewerLaunchTimeout |
Le lancement de Citrix Viewer a expiré. | Essayez de lancer la ressource depuis votre magasin à nouveau. Si le problème persiste, contactez votre administrateur système. |
ViewerLaunchFailure |
Échec du lancement de Citrix Viewer. | Essayez de lancer la ressource depuis votre magasin à nouveau. Si le problème persiste, contactez votre administrateur système. |
InvalidICAFile |
Impossible de lancer la ressource car le fichier ICA est invalide. | Essayez de lancer la ressource depuis votre magasin à nouveau. Si le problème persiste, contactez votre administrateur système. |
CertificateError |
Une erreur est survenue avec le certificat du serveur. | Contactez votre administrateur système pour obtenir de l’aide. |
ResourceError |
Une erreur est survenue lors de la tentative de démarrage de la ressource. Cela peut être dû à un problème de connexion au serveur. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
UnknownError |
Une erreur inconnue s’est produite lors de la tentative d’ouverture de la ressource. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
Application Citrix Workspace pour iOS
| ID d’erreur | Description | Recommandation |
|---|---|---|
credentialsMustChange |
Votre mot de passe doit être modifié. | Accédez aux paramètres de votre compte pour modifier votre mot de passe. Si le problème persiste, contactez votre administrateur système. |
noConfigurationFile |
Impossible de récupérer les données de configuration requises. | Pour tenter de résoudre le problème, supprimez le magasin de l’application Citrix Workspace, puis ajoutez-le à nouveau. Si le problème persiste, contactez votre administrateur système. |
http404Error |
Les ressources ne sont pas disponibles. | Contactez votre administrateur système pour obtenir de l’aide. |
invalidTransactionId |
ID de transaction invalide. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
credentialsExpired |
Votre mot de passe a expiré. | Accédez aux paramètres de votre compte pour modifier votre mot de passe. Si le problème persiste, contactez votre administrateur système. |
badAddressError |
Impossible de trouver l’adresse de la ressource. | Vérifiez votre connexion et réessayez. Si le problème persiste, contactez votre administrateur système. |
accountDisabled |
Votre compte est désactivé. | Contactez votre administrateur système pour obtenir de l’aide. |
accountLockedOut |
Votre compte est temporairement verrouillé. | Contactez votre administrateur système pour obtenir de l’aide. |
storeServerConnectionError |
Une erreur s’est produite lors de la tentative de communication avec le serveur. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
internalServerError |
Une erreur inconnue s’est produite lors de la tentative de connexion au serveur. | Contactez votre administrateur système pour obtenir de l’aide. |
invalidXML |
Impossible d’ouvrir la ressource en raison d’une erreur du service XML. | Contactez votre administrateur système pour obtenir de l’aide. |
badCredentials |
Vos informations d’identification ont expiré. | Pour tenter de résoudre le problème, déconnectez-vous de l’application Citrix Workspace, puis reconnectez-vous. Si le problème persiste, contactez votre administrateur système. |
appRemoved |
La ressource a été supprimée ou désactivée par votre administrateur. | Pour obtenir une liste à jour des applications et bureaux disponibles, actualisez l’application Citrix Workspace ou déconnectez-vous et reconnectez-vous. |
invalidLogonHours |
Impossible de se connecter pour le moment en raison de restrictions définies par votre administrateur. | Réessayez pendant les heures de travail normales. Si le problème persiste, contactez votre administrateur système. |
connectionError |
Impossible de se connecter au serveur. Cela peut être dû à un problème de connexion réseau. | Pour tenter de résoudre le problème, quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
Application Citrix Workspace pour Android
| ID d’erreur | Description | Recommandation |
|---|---|---|
http404Error |
Impossible de lancer la ressource en raison d’un problème de connexion réseau. | Vérifiez votre connexion et réessayez. Si le problème persiste, contactez votre administrateur système. |
couldNotConnectToWorkstation |
Impossible de se connecter au bureau. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
retryReasonRebooting |
Une erreur s’est produite lors du lancement de la ressource. Le poste de travail demandé est en cours de redémarrage. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
retryReasonResuming |
Une erreur s’est produite lors du lancement de la ressource. Le poste de travail demandé est en cours de reprise. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
generalProblem |
Une erreur s’est produite lors de la tentative d’ouverture de la ressource. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
retryReasonUnknown |
Une erreur s’est produite dans le fichier ICA. | Quittez et rouvrez l’application Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
appRemoved |
La ressource a été supprimée ou désactivée par votre administrateur. | Pour obtenir une liste à jour des applications et bureaux disponibles, actualisez l’application Citrix Workspace ou déconnectez-vous et reconnectez-vous. |
resourceError |
Une erreur s’est produite lors de la tentative de démarrage du fichier ICA. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. Redémarrez le VDA s’il s’agit d’une machine dédiée. |
resourceUnavailable |
Une erreur s’est produite lors de la tentative de démarrage du fichier ICA. | Attendez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. Redémarrez le VDA s’il s’agit d’une machine dédiée. |
Dépannage de la connexion Citrix
Copié !
Échec !