Solución de problemas de conexión de Citrix
La función de solución de problemas de conexión de Citrix está diseñada para permitir a los usuarios finales solucionar eficazmente los 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 de 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 soporte 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 señalan problemas de conexión específicos, como errores de red, indisponibilidad del servidor o fallos de VDA. Para los administradores, se proporcionan códigos de error detallados en los registros, categorizados 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 remediación
La función de 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 del soporte. A continuación, se presentan los posibles problemas que se pueden resolver con una remediación guiada:
- Reiniciar VDA
- Reiniciar la aplicación Citrix Workspace (CWA) - Volver a iniciar sesión en CWA
- Actualizar la lista de recursos
- Actualizar la aplicación e intentarlo de nuevo
- Reconfigurar el almacén
- Actualizar CWA
- Reinstalar CWA
- Comprobar la red
- Esperar e intentarlo de nuevo
Requisitos del sistema
Para usar la función Solucionar problemas de conexión, debe tener 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 los entornos de Citrix DaaS. Se proporcionan mensajes de error granulares y mejorados, junto con recomendaciones de solución, tanto para las sesiones iniciadas desde el navegador 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 remediación “Reiniciar VDA” no admite sesiones iniciadas a través de un modo de inicio híbrido (es decir, descargar un archivo ICA de un navegador y luego iniciarlo con la aplicación nativa Citrix Workspace).
Códigos de error
Los códigos de error se dividen entre 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
| ID de error | Descripción | Recomendación |
|---|---|---|
ResourceNotFound |
El recurso fue eliminado por su administrador. | Para obtener una lista actualizada de las aplicaciones y escritorios disponibles, actualice la aplicación Citrix Workspace o cierre sesión y vuelva a iniciarla. |
WorkstationInMaintenance |
El escritorio está en mantenimiento programado. | Espere a que finalice el mantenimiento y, a continuación, inténtelo de nuevo. |
UnavailableDesktop |
No hay escritorios disponibles a los que conectarse. | Espere unos minutos y, a continuación, inténtelo de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
UnavailableAppProtectedDesktop |
Se requiere App Protection para abrir recursos protegidos. | Actualice a una versión de la aplicación Citrix Workspace con App Protection, o póngase en contacto con el administrador del sistema para obtener ayuda. |
NotLicensed |
No se puede iniciar el recurso porque al servidor le falta la licencia adecuada. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
NoMoreActiveSessions |
No se puede iniciar el recurso porque no hay ranuras de sesión disponibles. | Espere unos minutos y, a continuación, inténtelo de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
GeneralAppLaunchError |
Se produjo un error desconocido al intentar abrir el recurso. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
ResourceDisabled |
El administrador ha inhabilitado el recurso. | Para obtener una lista actualizada de las aplicaciones y los escritorios disponibles, actualice la aplicación Citrix Workspace o cierre la sesión y vuelva a iniciarla. |
Aplicación Citrix Workspace para Windows
| ID de error | Descripción | Recomendación |
|---|---|---|
CertificateError |
Se produjo un error con el certificado del servidor. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
PassthroughClientError |
Ya hay una sesión activa. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
IcaFileRetrieveError |
Se produjo un error al intentar recuperar el archivo ICA. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
Icafileretrieveerrorreconnection |
Se produjo un error al intentar recuperar el archivo ICA durante la reconexión. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
NoCWA |
Se requiere la aplicación Citrix Workspace para abrir los recursos. | Instale la aplicación Citrix Workspace o póngase en contacto con el administrador del sistema para obtener ayuda. |
CouldNotFindStore |
No se puede recuperar la configuración de almacén necesaria para iniciar el recurso. | Quite el almacén de la aplicación Citrix Workspace y, a continuación, vuelva a agregarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
noclientinstalled |
No se puede recuperar la información necesaria para iniciar el recurso. | Actualice la aplicación Citrix Workspace o cierre la sesión y vuelva a iniciarla. |
AuthCancelled |
La sesión de autenticación ha caducado. | Para intentar resolver el problema, vuelva a autenticarse en la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
IcaFileLaunchError |
Se produjo un error al intentar iniciar el archivo ICA. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
CouldNotContactStore |
Se produjo un error al intentar comunicarse con el VDA. Esto podría deberse a un problema de conexión con el servidor. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
CCMError |
No se puede iniciar el recurso debido a un error del Administrador de conexiones. Código de error: {errorCodeValue} | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
CCMInitFailed |
No se puede iniciar el recurso porque el Administrador de conexiones no se pudo inicializar. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
CCMLoadFailed |
No se puede iniciar el recurso porque el Administrador de conexiones no se pudo cargar. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
InvalidIcaParams |
No se puede iniciar el recurso debido a parámetros ICA incorrectos. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
AppExiting |
No se puede iniciar el recurso porque la aplicación Citrix Workspace se está cerrando. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
UTF8ConversionFailed |
No se puede analizar el archivo ICA. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
MissingSoftware |
Necesita software adicional para usar esta aplicación. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
Aplicación Citrix Workspace para Mac
| ID de error | Descripción | Recomendación |
|---|---|---|
AuthCancelled |
La sesión de autenticación ha caducado. | Para intentar resolver el problema, primero autentíquese con sus credenciales. Si el problema persiste, póngase en contacto con el administrador del sistema. |
NetworkError |
No se puede iniciar el recurso debido a un problema de conexión de red. | Compruebe su conexión y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
ViewerNotFound |
No se encuentra la ruta de Citrix Viewer. | Para intentar resolver el problema, desinstale y vuelva a instalar la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
ViewerOpenEventFailed |
Citrix Viewer no pudo crear un evento. | Intente iniciar el recurso desde su tienda de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
ViewerLaunchTimeout |
El inicio de Citrix Viewer ha agotado el tiempo de espera. | Intente iniciar el recurso desde su Store de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
ViewerLaunchFailure |
Citrix Viewer no se pudo iniciar. | Intente iniciar el recurso desde su Store de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
InvalidICAFile |
No se puede iniciar el recurso porque el archivo ICA no es válido. | Intente iniciar el recurso desde su Store de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
CertificateError |
Se produjo un error con el certificado del servidor. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
ResourceError |
Se produjo un error al intentar iniciar el recurso. Esto podría deberse a un problema de conexión con el servidor. | Espere unos minutos y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
UnknownError |
Se produjo un error desconocido al intentar abrir el recurso. | Espere unos minutos y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
Aplicación Citrix Workspace para iOS
| ID de error | Descripción | Recomendación |
|---|---|---|
credentialsMustChange |
Debe cambiar su contraseña. | Vaya a la configuración de su cuenta para cambiar su contraseña. Si el problema persiste, póngase en contacto con el administrador del sistema. |
noConfigurationFile |
No se pueden recuperar los datos de configuración necesarios. | Para intentar resolver el problema, quite el almacén de la aplicación Citrix Workspace y vuelva a añadirlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
http404Error |
Los recursos no están disponibles. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
invalidTransactionId |
ID de transacción no válido. | Espere unos minutos y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
credentialsExpired |
Su contraseña ha caducado. | Vaya a la configuración de su cuenta para cambiar la contraseña. Si el problema persiste, póngase en contacto con el administrador del sistema. |
badAddressError |
No se puede encontrar la dirección del recurso. | Compruebe su conexión y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
accountDisabled |
Su cuenta está inhabilitada. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
accountLockedOut |
Su cuenta está bloqueada temporalmente. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
storeServerConnectionError |
Se produjo un error al intentar comunicarse con el servidor. | Espere unos minutos y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
internalServerError |
Se produjo un error desconocido al intentar conectarse al servidor. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
invalidXML |
No se puede abrir el recurso debido a un error del servicio XML. | Póngase en contacto con el administrador del sistema para obtener ayuda. |
badCredentials |
Sus credenciales han caducado. | Para intentar resolver el problema, cierre sesión en la aplicación Citrix Workspace y vuelva a iniciarla. Si el problema persiste, póngase en contacto con el administrador del sistema. |
appRemoved |
El recurso fue eliminado o deshabilitado por su administrador. | Para obtener una lista actualizada de las aplicaciones y escritorios disponibles, actualice la aplicación Citrix Workspace o cierre la sesión y vuelva a iniciarla. |
invalidLogonHours |
No se puede iniciar sesión en este momento debido a las restricciones establecidas por el administrador. | Inténtelo de nuevo durante el horario laboral habitual. Si el problema persiste, póngase en contacto con el 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, cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
Aplicación Citrix Workspace para Android
| ID de error | Descripción | Recomendación |
|---|---|---|
http404Error |
No se puede iniciar el recurso debido a un problema de conexión de red. | Compruebe su conexión e inténtelo de nuevo. Si el problema persiste, póngase en contacto con el administrador del sistema. |
couldNotConnectToWorkstation |
No se puede conectar al escritorio. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
retryReasonRebooting |
Se produjo un error al iniciar el recurso. La estación de trabajo solicitada se está reiniciando. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
retryReasonResuming |
Se produjo un error al iniciar el recurso. La estación de trabajo solicitada se está reanudando. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
generalProblem |
Algo salió mal al intentar abrir el recurso. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
retryReasonUnknown |
Se produjo un error en el archivo ICA. | Cierre y vuelva a abrir la aplicación Citrix Workspace. Si el problema persiste, póngase en contacto con el administrador del sistema. |
appRemoved |
El recurso fue eliminado o deshabilitado por su administrador. | Para obtener una lista actualizada de las aplicaciones y escritorios disponibles, actualice la aplicación Citrix Workspace o cierre y vuelva a iniciar sesión. |
resourceError |
Se produjo un error al intentar iniciar el archivo ICA. | Espere unos minutos y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. Reinicie el VDA si es una máquina dedicada. |
resourceUnavailable |
Se produjo un error al intentar iniciar el archivo ICA. | Espere unos minutos y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el administrador del sistema. Reinicie el VDA si es una máquina dedicada. |