Dépannage de connexion Citrix
La fonctionnalité de dépannage de connexion Citrix est conçue pour permettre aux utilisateurs finaux de résoudre efficacement par eux-mêmes les échecs potentiels 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.
Présentation
- 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 connexion effectue une analyse en temps réel des problèmes d’accessibilité vers le 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 vers 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 les problèmes de connexion spécifiques, tels que les erreurs réseau, l’indisponibilité du serveur ou les défaillances du VDA. Pour les administrateurs, des codes d’erreur détaillés sont fournis dans les journaux, catégorisés en erreurs côté serveur et côté client, servant de références précieuses pour une enquête plus approfondie.
Actions d’auto-récupération et de correction
La fonctionnalité de dépannage de connexion Citrix comprend 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 Store
- 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 connexion, vous devez disposer des versions suivantes de l’application Citrix Workspace :
- Application Citrix Workspace pour Mac : Version 2505 et ultérieure
- Application Citrix Workspace pour Windows : Version 2507 et ultérieure
- Application Citrix Workspace pour iOS : Version 2509 et ultérieure
- Application Citrix Workspace pour Android : Version 2509 et ultérieure
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 à partir d’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 des 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 la fin de la maintenance, puis réessayez. |
UnavailableDesktop |
Aucun bureau n’est disponible pour la connexion. | Patientez quelques minutes, puis réessayez. Si le problème persiste, contactez votre administrateur système. |
UnavailableAppProtectedDesktop |
App Protection est requis pour ouvrir les ressources protégées. | Mettez à niveau vers une version de l’application Citrix Workspace avec App Protection, 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 plus d’emplacements de session disponibles. | Patientez 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 s’est produite avec le certificat du serveur. | Contactez votre administrateur système pour obtenir de l’aide. |
PassthroughClientError |
Une session active est déjà en cours. | 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 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 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 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 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 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 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 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 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 Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
UTF8ConversionFailed |
Impossible d’analyser le fichier ICA. | Quittez et rouvrez 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 Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
ViewerOpenEventFailed |
Citrix Viewer n’a pas pu créer d’événement. | Essayez de lancer la ressource à partir de votre magasin à nouveau. Si le problème persiste, contactez votre administrateur système. |
ViewerLaunchTimeout |
Le lancement de Citrix Viewer a expiré. | Essayez de lancer la ressource à partir de votre magasin à nouveau. Si le problème persiste, contactez votre administrateur système. |
ViewerLaunchFailure |
Citrix Viewer n’a pas pu se lancer. | Essayez de lancer la ressource à partir de 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 à partir de votre magasin à nouveau. Si le problème persiste, contactez votre administrateur système. |
CertificateError |
Une erreur s’est produite avec le certificat du serveur. | Contactez votre administrateur système pour obtenir de l’aide. |
ResourceError |
Une erreur s’est produite lors de la tentative de démarrage de la ressource. Cela peut être dû à un problème de connexion au serveur. | Patientez 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. | Patientez 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 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 non valide. | Patientez 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. | Patientez 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 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 des 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 habituelles. 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 Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
Application Citrix Workspace pour Android
| Error ID | Description | Recommendation |
|---|---|---|
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 Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
retryReasonRebooting |
Une erreur s’est produite lors du lancement de la ressource. La station de travail demandée redémarre. | Quittez et rouvrez Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
retryReasonResuming |
Une erreur s’est produite lors du lancement de la ressource. La station de travail demandée reprend. | Quittez et rouvrez Citrix Workspace. Si le problème persiste, contactez votre administrateur système. |
generalProblem |
Un problème est survenu lors de la tentative d’ouverture de la ressource. | Quittez et rouvrez 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 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 des 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. | Patientez 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. | Patientez 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 connexion Citrix
Copié !
Échec !