Solución de problemas de conexión de Citrix
La función Solución de problemas de conexión de Citrix está diseñada para que los usuarios finales puedan solucionar problemas de forma eficaz por sí mismos en caso de posibles errores de inicio de escritorios o aplicaciones. Esta mejora tiene como objetivo proporcionar a los usuarios diagnósticos claros, posibles recomendaciones y la capacidad de ejecutar correcciones con un simple clic.
Información general
- Citrix ahora ofrece mensajes de error más detallados y mejorados para ayudar a los usuarios a comprender claramente la causa raíz de los errores de inicio. La función Solución de problemas de conexión realiza un análisis en tiempo real de los desafíos de accesibilidad al Virtual Delivery Agent (VDA) durante el proceso de inicio. Luego presenta mensajes de error y recomendaciones fáciles de usar, lo que permite a los usuarios resolver el problema directamente o recopilar registros para un ticket de asistencia si es necesario.
Rutas de conexión analizadas
La función diagnostica posibles problemas de inicio de aplicaciones y escritorios virtuales en puntos de conexión críticos, incluidos:
- Conectividad de red del cliente a Gateway.
- Conexión de Gateway al servidor StoreFront.
- Conexión del servidor StoreFront a Broker.
- Conexión de Broker a VDA.
Mensajes de error y diagnósticos mejorados
- En caso de errores de inicio, Citrix ahora muestra mensajes de error claros y fáciles de usar que identifican problemas de conexión específicos, como errores de red, indisponibilidad del servidor o fallos del VDA. Para los administradores, se proporcionan códigos de error detallados en los registros, clasificados en errores del lado del servidor y del lado del cliente, que sirven como referencias valiosas para una investigación más profunda.
Acciones de autorrecuperación y corrección
La función Solución de problemas de conexión de Citrix incluye pasos que los usuarios pueden seguir para recuperarse automáticamente de problemas comunes, minimizando así la necesidad de intervención de asistencia. A continuación se presentan los posibles problemas que se pueden resolver con una corrección guiada:
- Reiniciar el VDA
- Reiniciar la aplicación Citrix Workspace (CWA) - Volver a iniciar sesión en CWA
- Actualizar la lista de recursos
- Actualizar la aplicación y volver a intentarlo
- Reconfigurar el almacén
- Actualizar CWA
- Reinstalar CWA
- Comprobar la red
- Esperar y volver a intentarlo
Requisitos del sistema
Para usar la función Solución de problemas de conexión, ten las siguientes versiones de la aplicación Citrix Workspace:
- Aplicación Citrix Workspace para Mac: Versión 2505 y posteriores
- Aplicación Citrix Workspace para Windows: Versión 2507 y posteriores
- Aplicación Citrix Workspace para iOS: Versión 2509 y posteriores
- Aplicación Citrix Workspace para Android: Versión 2509 y posteriores
Cómo usar
La función Solucionar problemas de conexión está habilitada de forma predeterminada para entornos de Citrix DaaS. Se proporcionan mensajes de error detallados y mejorados, junto con recomendaciones de solución, tanto para las sesiones iniciadas desde el explorador como para las sesiones iniciadas directamente a través de la aplicación nativa Citrix Workspace.
Consideraciones importantes
Aunque la función ofrece sólidas capacidades de autoservicio, es importante tener en cuenta lo siguiente:
- La acción de solución “Reiniciar VDA” no admite sesiones iniciadas mediante un modo de inicio híbrido (es decir, descargar un archivo ICA desde un explorador y luego iniciarlo con la aplicación nativa Citrix Workspace).
Códigos de error
Los códigos de error se dividen en errores del lado del servidor y errores del lado del cliente. A continuación, se muestran las tablas con los códigos de error.
Errores comunes del lado del servidor
| Error ID | Descripción | Recomendación |
|---|---|---|
ResourceNotFound |
El recurso fue eliminado por tu administrador. | Para obtener una lista actualizada de las aplicaciones y los escritorios disponibles, actualiza la aplicación Citrix Workspace o cierra la sesión y vuelve a iniciarla. |
WorkstationInMaintenance |
El escritorio está en mantenimiento programado. | Espera a que finalice el mantenimiento y vuelve a intentarlo. |
UnavailableDesktop |
No hay escritorios disponibles para conectarse. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
UnavailableAppProtectedDesktop |
Se requiere App Protection para abrir recursos protegidos. | Actualiza a una versión de la aplicación Citrix Workspace con App Protection o ponte en contacto con tu administrador del sistema para obtener asistencia. |
NotLicensed |
No se puede iniciar el recurso porque al servidor le falta la licencia adecuada. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
NoMoreActiveSessions |
No se puede iniciar el recurso porque no hay ranuras de sesión disponibles. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
GeneralAppLaunchError |
Se produjo un error desconocido al intentar abrir el recurso. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
ResourceDisabled |
Tu administrador ha inhabilitado el recurso. | Para obtener una lista actualizada de las aplicaciones y los escritorios disponibles, actualiza la aplicación Citrix Workspace o cierra la sesión y vuelve a iniciarla. |
Aplicación Citrix Workspace para Windows
| Error ID | Descripción | Recomendación |
|---|---|---|
CertificateError |
Se produjo un error con el certificado del servidor. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
PassthroughClientError |
Ya hay una sesión activa. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
IcaFileRetrieveError |
Se produjo un error al intentar recuperar el archivo ICA. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
Icafileretrieveerrorreconnection |
Se produjo un error al intentar recuperar el archivo ICA durante la reconexión. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
NoCWA |
Se requiere la aplicación Citrix Workspace para abrir los recursos. | Instala la aplicación Citrix Workspace o ponte en contacto con tu administrador del sistema para obtener asistencia. |
CouldNotFindStore |
No se puede recuperar la configuración de almacén necesaria para iniciar el recurso. | Quita el almacén de Citrix Workspace y, a continuación, vuelve a agregarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
noclientinstalled |
No se puede recuperar la información necesaria para iniciar el recurso. | Actualiza la aplicación Citrix Workspace o cierra la sesión y vuelve a iniciarla. |
AuthCancelled |
La sesión de autenticación caducó. | Para intentar resolver el problema, vuelve a autenticarte en Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
IcaFileLaunchError |
Se produjo un error al intentar iniciar el archivo ICA. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
CouldNotContactStore |
Se produjo un error al intentar comunicarse con el VDA. Esto podría deberse a un problema de conexión del servidor. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
CCMError |
No se puede iniciar el recurso debido a un error del Administrador de conexiones. Código de error: {errorCodeValue} | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
CCMInitFailed |
No se puede iniciar el recurso porque el Administrador de conexiones no se pudo inicializar. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
CCMLoadFailed |
No se puede iniciar el recurso porque el Administrador de conexiones no se pudo cargar. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
InvalidIcaParams |
No se puede iniciar el recurso debido a parámetros ICA incorrectos. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
AppExiting |
No se puede iniciar el recurso porque la aplicación Citrix Workspace se está cerrando. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
UTF8ConversionFailed |
No se puede analizar el archivo ICA. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
MissingSoftware |
Necesitas software adicional para usar esta aplicación. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
Aplicación Citrix Workspace para Mac
| Error ID | Descripción | Recomendación |
|---|---|---|
AuthCancelled |
La sesión de autenticación caducó. | Para intentar resolver el problema, primero autentícate con tus credenciales. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
NetworkError |
No se puede iniciar el recurso debido a un problema de conexión de red. | Comprueba tu conexión y vuelve a intentarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
ViewerNotFound |
No se encuentra la ruta de Citrix Viewer. | Para intentar resolver el problema, desinstala y vuelve a instalar Citrix Workspace. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
ViewerOpenEventFailed |
Citrix Viewer no pudo crear un evento. | Intenta iniciar el recurso desde tu almacén de nuevo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
ViewerLaunchTimeout |
El inicio de Citrix Viewer agotó el tiempo de espera. | Intenta iniciar el recurso desde tu almacén de nuevo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
ViewerLaunchFailure |
Citrix Viewer no se pudo iniciar. | Intenta iniciar el recurso desde tu almacén de nuevo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
InvalidICAFile |
No se puede iniciar el recurso porque el archivo ICA no es válido. | Intenta iniciar el recurso desde tu almacén de nuevo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
CertificateError |
Se produjo un error con el certificado del servidor. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
ResourceError |
Se produjo un error al intentar iniciar el recurso. Esto podría deberse a un problema de conexión del servidor. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
UnknownError |
Se produjo un error desconocido al intentar abrir el recurso. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
Aplicación Citrix Workspace para iOS
| Error ID | Descripción | Recomendación |
|---|---|---|
credentialsMustChange |
Tu contraseña debe cambiarse. | Ve a la configuración de tu cuenta para cambiar tu contraseña. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
noConfigurationFile |
No se pueden recuperar los datos de configuración necesarios. | Para intentar resolver el problema, quita el almacén de Citrix Workspace y, a continuación, vuelve a agregarlo. Si el problema persiste, ponte en contacto con tu administrador del sistema. |
http404Error |
Los recursos no están disponibles. | Ponte en contacto con tu administrador del sistema para obtener asistencia. |
invalidTransactionId |
ID de transacción no válido. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, contacta con tu administrador del sistema. |
credentialsExpired |
Tu contraseña ha caducado. | Ve a la configuración de tu cuenta para cambiar tu contraseña. Si el problema persiste, contacta con tu administrador del sistema. |
badAddressError |
No se puede encontrar la dirección del recurso. | Comprueba tu conexión y vuelve a intentarlo. Si el problema persiste, contacta con tu administrador del sistema. |
accountDisabled |
Tu cuenta está deshabilitada. | Contacta con tu administrador del sistema para obtener asistencia. |
accountLockedOut |
Tu cuenta está bloqueada temporalmente. | Contacta con tu administrador del sistema para obtener asistencia. |
storeServerConnectionError |
Se produjo un error al intentar comunicarse con el servidor. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, contacta con tu administrador del sistema. |
internalServerError |
Se produjo un error desconocido al intentar conectarse al servidor. | Contacta con tu administrador del sistema para obtener asistencia. |
invalidXML |
No se puede abrir el recurso debido a un error del servicio XML. | Contacta con tu administrador del sistema para obtener asistencia. |
badCredentials |
Tus credenciales han caducado. | Para intentar resolver el problema, cierra sesión en Citrix Workspace y vuelve a iniciarla. Si el problema persiste, contacta con tu administrador del sistema. |
appRemoved |
El recurso fue quitado o deshabilitado por tu administrador. | Para obtener una lista actualizada de las aplicaciones y escritorios disponibles, actualiza la aplicación Citrix Workspace o cierra sesión y vuelve a iniciarla. |
invalidLogonHours |
No se puede iniciar sesión en este momento debido a las restricciones establecidas por tu administrador. | Vuelve a intentarlo durante el horario laboral habitual. Si el problema persiste, contacta con tu administrador del sistema. |
connectionError |
No se puede conectar con el servidor. Esto puede deberse a un problema de conexión de red. | Para intentar resolver el problema, cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, contacta con tu administrador del sistema. |
Aplicación Citrix Workspace para Android
| Error ID | Descripción | Recomendación |
|---|---|---|
http404Error |
No se puede iniciar el recurso debido a un problema de conexión de red. | Comprueba tu conexión y vuelve a intentarlo. Si el problema persiste, contacta con tu administrador del sistema. |
couldNotConnectToWorkstation |
No se puede conectar con el escritorio. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, contacta con tu administrador del sistema. |
retryReasonRebooting |
Se produjo un error al iniciar el recurso. La estación de trabajo solicitada se está reiniciando. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, contacta con tu administrador del sistema. |
retryReasonResuming |
Se produjo un error al iniciar el recurso. La estación de trabajo solicitada se está reanudando. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, contacta con tu administrador del sistema. |
generalProblem |
Algo salió mal al intentar abrir el recurso. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, contacta con tu administrador del sistema. |
retryReasonUnknown |
Se produjo un error en el archivo ICA. | Cierra y vuelve a abrir Citrix Workspace. Si el problema persiste, contacta con tu administrador del sistema. |
appRemoved |
El recurso fue quitado o deshabilitado por tu administrador. | Para obtener una lista actualizada de las aplicaciones y escritorios disponibles, actualiza la aplicación Citrix Workspace o cierra sesión y vuelve a iniciarla. |
resourceError |
Se produjo un error al intentar iniciar el archivo ICA. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, contacta con tu administrador del sistema. Reinicia el VDA si es una máquina dedicada. |
resourceUnavailable |
Se produjo un error al intentar iniciar el archivo ICA. | Espera unos minutos y vuelve a intentarlo. Si el problema persiste, contacta con tu administrador del sistema. Reinicia el VDA si es una máquina dedicada. |