Motivos de fallos y solución de problemas de Citrix Director
Las siguientes tablas describen las distintas categorías de fallos, los motivos y las acciones que debe llevar a cabo para resolver los problemas. Para obtener más información, consulte Enums, códigos de error y descripciones.
Errores de fallo de conexión
| Categoría | Motivo | Problema | Acción |
|---|---|---|---|
| N/D | [0] Desconocido. Este código de error no está asignado. | El servicio de supervisión no puede determinar el motivo del fallo de inicio o conexión notificado a partir de la información compartida por el servicio de intermediación. | Recopile los registros CDF en el controlador y póngase en contacto con el soporte de Citrix. |
| [0] Ninguno | [1] Ninguno | Ninguno | N/D |
| [2] Error de máquina | [2] Preparación de sesión | La solicitud de preparación de sesión del Delivery Controller al VDA falló. Posibles causas: Problemas de comunicación entre el Controller y el VDA, problemas experimentados por el Servicio de intermediación al crear una solicitud de preparación o problemas de red que impiden que el VDA acepte la solicitud. | Consulte los pasos de solución de problemas que se enumeran en el artículo del Centro de conocimientos, Solución de problemas de registro de Virtual Delivery Agent con Delivery Controllers en Citrix Virtual Apps and Desktops para problemas comunes que causan problemas de comunicación entre el Controller y el VDA. |
| [2] Error de máquina | [3] Tiempo de espera de registro agotado | El VDA se encendió, pero se agotó el tiempo de espera mientras intentaba registrarse con el Delivery Controller. | Verifique que el servicio Citrix Broker se esté ejecutando en el Delivery Controller y que el servicio Desktop se esté ejecutando en el VDA. Inicie cada uno si está detenido. |
| [1] Error de conexión del cliente | [4] Tiempo de espera de conexión agotado | El cliente no se conectó al VDA después de que el VDA se preparara para el inicio de la sesión. La sesión se intermedió correctamente, pero se agotó el tiempo de espera mientras se esperaba que el cliente se conectara al VDA. Posibles causas: Configuración del firewall, interrupciones de red o configuraciones que impiden las conexiones remotas. | Compruebe la consola de Director para ver si el cliente tiene actualmente una conexión activa, lo que significa que ningún usuario se ve afectado. Si no existe ninguna sesión, revise los registros de eventos en el cliente y en el VDA para detectar cualquier error. Resuelva cualquier problema de conectividad de red entre el cliente y el VDA. |
| [4] No hay licencias disponibles | [5] Licencias | La solicitud de licencia falló. Posibles causas: Número insuficiente de licencias o el servidor de licencias ha estado inactivo durante más de 30 días. | Verifique que el servidor de licencias esté en línea y accesible. Resuelva cualquier problema de conectividad de red con el servidor de licencias o reinicie el servidor de licencias si parece estar funcionando mal. Verifique que haya suficientes licencias en el entorno y asigne más si es necesario. |
| [1] ClientConnectionFailure | [6] Ticketing | Se produjo un error durante la emisión de tickets, lo que indica que la conexión del cliente al VDA no coincide con la solicitud intermediada. El Broker prepara un ticket de solicitud de inicio y lo entrega en el archivo ICA®. Cuando el usuario intenta iniciar una sesión, el VDA valida el ticket de inicio en el archivo ICA con el Broker. Posibles causas: el archivo ICA está dañado o el usuario intenta realizar una conexión no autorizada. | Verifique que el usuario tenga acceso a la aplicación o al escritorio según los grupos de usuarios definidos en los grupos de entrega. Indique al usuario que reinicie la aplicación o el escritorio para determinar si se trata de un problema puntual. Si el problema vuelve a ocurrir, revise los registros de eventos del dispositivo cliente en busca de errores. Verifique que el VDA al que el usuario intenta conectarse esté registrado. Si no está registrado, revise los registros de eventos en el VDA y resuelva cualquier problema de registro. |
| [1] ClientConnectionFailure | [7] Other | Se ha informado que una sesión se ha terminado desde el VDA después de que el cliente contactara inicialmente con el VDA, pero antes de que completara la secuencia de conexión. | Verifique si la sesión no fue terminada por el usuario antes del inicio. Intente reiniciar la sesión; si el problema persiste, recopile los registros CDF y póngase en contacto con el soporte de Citrix. |
| [1] ClientConnectionFailure | [8] GeneralFail | La sesión no se pudo iniciar. Posibles causas: Se solicitó un inicio intermediado mientras el intermediario aún se estaba iniciando o inicializando, o un error interno durante la fase de intermediación de un inicio. | Verifique que el servicio Citrix Broker Service esté en ejecución y vuelva a intentar iniciar la sesión. |
| [5] Configuration | [9] MaintenanceMode | El VDA, o el grupo de entrega al que pertenece el VDA, está en modo de mantenimiento. | Determine si se requiere el modo de mantenimiento. Deshabilite el modo de mantenimiento en el grupo de entrega o la máquina en cuestión si no es necesario e indique al usuario que intente volver a conectarse. |
| [5] Configuración | [10] AplicaciónDeshabilitada | Los usuarios finales no pueden acceder a la aplicación porque ha sido deshabilitada por el administrador. | Si la aplicación está destinada a estar disponible para uso en producción, habilítela e indique al usuario que se vuelva a conectar. |
| [4] NoHayLicenciasDisponibles | [11] FunciónDeLicenciaRechazada | La función que se está utilizando no está cubierta por las licencias existentes. | Póngase en contacto con un representante de ventas de Citrix para confirmar las funciones que están cubiertas por la edición y el tipo de licencia existentes de Citrix Virtual Apps and Desktops™. |
| [3] NoHayCapacidadDisponible | [13] LímiteDeSesionesAlcanzado | Todos los VDA están en uso y no hay capacidad para alojar más sesiones. Posibles causas: Todos los VDA están en uso (para VDA de SO de sesión única), o todos los VDA han alcanzado el número máximo de sesiones simultáneas configurado (para VDA de SO de varias sesiones). | Verifique si hay VDA en modo de mantenimiento. Deshabilite el modo de mantenimiento si no es necesario para liberar más capacidad. Considere aumentar el valor de Número máximo de sesiones en la configuración de la política de Citrix para permitir más sesiones por VDA de servidor. Considere agregar más VDA de SO de varias sesiones. Considere agregar más VDA de SO de sesión única. |
| [5] Configuración | [14] Protocolo no permitido | Los protocolos ICA y RDP no están permitidos. | Ejecute el comando de PowerShell Get-BrokerAccessPolicyRule en el controlador de entrega y compruebe que el valor de AllowedProtocols contenga todos los protocolos deseados. Este problema solo ocurre si hay una configuración incorrecta. |
| [5] Configuración | [15] Recurso no disponible | La aplicación o el escritorio al que el usuario intenta conectarse no está disponible. Es posible que esta aplicación o escritorio no exista, o que no haya VDA disponibles para ejecutarlo. Posibles causas: La aplicación o el escritorio se ha dejado de publicar, o los VDA que alojan la aplicación o el escritorio han alcanzado la carga máxima, o la aplicación o el escritorio está en modo de mantenimiento. | Compruebe que la aplicación o el escritorio sigue publicado y que los VDA no están en modo de mantenimiento. Determine si los VDA de SO multisesión están a plena carga. Si es así, aprovisione más VDA de SO multisesión. Compruebe que hay VDA de SO de sesión única disponibles para las conexiones. Aprovisione más VDA de SO de sesión única si es necesario. |
| [5] Configuración | [16] Reconexión de sesión activa deshabilitada | La sesión ICA está activa y conectada a un punto final diferente. Sin embargo, como la Reconexión de sesión activa está deshabilitada, el cliente no puede conectarse a la sesión activa. | En el controlador de entrega, compruebe que la Reconexión de sesión activa esté habilitada. Compruebe que el valor de DisableActiveSessionReconnect en el registro, en HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server, esté establecido en 0. |
| [2] Error de máquina | [17] No hay sesión para reconectar | El cliente intentó reconectarse a una sesión específica, pero la sesión se terminó. | Vuelva a intentar la reconexión del control del espacio de trabajo. |
| [2] Fallo de máquina | [18] Error al iniciar | El VDA no se puede encender para el inicio de la sesión. Este es un problema notificado por el hipervisor. | Si la máquina sigue apagada, intente iniciarla desde Citrix Studio. Si esto falla, revise la conectividad y los permisos del hipervisor. Si el VDA es una máquina aprovisionada por PVS, verifique en la consola de PVS que la máquina esté en ejecución. Si no, verifique que la máquina tenga asignado un vDisk personal, inicie sesión en el hipervisor para reiniciar la VM. |
| [2] Fallo de máquina | [19] Rechazado | El controlador de entrega envía una solicitud al VDA para prepararse para una conexión de un usuario final, pero el VDA rechaza activamente esta solicitud. | Verifique, mediante ping, que el controlador de entrega y el VDA puedan comunicarse correctamente. Si no, resuelva cualquier problema de firewall o de enrutamiento de red. |
| [2] Fallo de máquina | [20] Fallo del conjunto de configuración | El controlador de entrega no envió los datos de configuración necesarios, como la configuración de directivas y la información de sesión, al VDA durante el inicio de la sesión. Posibles causas: Problemas de comunicación entre el controlador y el VDA, problemas experimentados por el Servicio de Broker al crear una solicitud de conjunto de configuración, o problemas de red que impiden que el VDA acepte la solicitud. | - |
| [3] No hay capacidad disponible | [21] Se superó el número máximo total de instancias | Se ha alcanzado el número máximo de instancias de una aplicación. No se pueden abrir instancias adicionales de la aplicación en el VDA. Este problema está relacionado con la función de límites de aplicaciones. | Considere aumentar la configuración de la aplicación, Limitar el número de instancias que se ejecutan al mismo tiempo a un valor superior si la licencia lo permite. |
| [3] NoCapacityAvailable | [22] MaxPerUserInstancesExceeded | El usuario intenta abrir más de una instancia de una aplicación, pero la aplicación está configurada para permitir solo una instancia por usuario. Este problema está relacionado con la función de límites de aplicaciones. | Por defecto, solo se permite una instancia de la aplicación por usuario. Si se requieren varias instancias por usuario, considere desmarcar la configuración Limitar a una instancia por usuario en la configuración de la aplicación. |
| [1] ClientConnectionFailure | [23] Error de comunicación | El controlador de entrega intentó enviar información al VDA, como una solicitud para prepararse para una conexión, pero se produjo un error durante el intento de comunicación. Esto puede deberse a interrupciones de la red. | Si ya se ha iniciado, reinicie el servicio Desktop en el VDA para reiniciar el proceso de registro y verifique que el VDA se registre correctamente. Confirme que los controladores de entrega configurados para el VDA son precisos a través de los detalles en el registro de eventos de la aplicación. |
| [3] NoCapacityAvailable | [100] NoMachineAvailable El servicio de supervisión convierte [12] NoDesktopAvailable a este código de error. | El VDA asignado para iniciar la sesión está en un estado no válido o no está disponible. Posibles causas: El estado de energía del VDA es desconocido o no está disponible, el VDA no se reinició desde la última sesión del usuario, el uso compartido de sesiones está deshabilitado mientras la sesión actual requiere que esté habilitado, o el VDA fue eliminado del grupo de entrega o del sitio. | Verifique que el VDA esté en un grupo de entrega. Si no lo está, agréguelo al grupo de entrega adecuado. Verifique que haya suficientes VDA registrados y en estado listo para poder iniciar el escritorio compartido o la aplicación publicada solicitada por el usuario. Verifique que el hipervisor que aloja el VDA no esté en modo de mantenimiento. |
| [2] MachineFailure | [101] MachineNotFunctional. El servicio de supervisión convierte [12] NoDesktopAvailable a este código de error. | El VDA no está operativo. Posibles causas: El VDA se eliminó del grupo de entrega, el VDA no está registrado, el estado de energía del VDA no está disponible o el VDA está experimentando problemas internos. | Verifique que el VDA esté en un grupo de entrega. Si no lo está, agréguelo al grupo de entrega adecuado. Verifique que el VDA aparezca como encendido en Citrix Studio. Si el estado de energía es desconocido para varias máquinas, resuelva cualquier problema de conectividad con el hipervisor o fallos del host. Verifique que el hipervisor que aloja el VDA no esté en modo de mantenimiento. Reinicie el VDA una vez que se hayan solucionado estos problemas. |
Tipo de fallo de la máquina
| Código de error | ID de código de error | Problema | Acción |
|---|---|---|---|
| Desconocido | - | - | - |
| No registrado | 3 | - | - |
| MaxCapacity (representado como Carga máxima en Director) | 4 | La máquina informa que está a su capacidad máxima, es decir, Max Load Index | Asegúrese de que todos los hipervisores estén encendidos. Agregue más máquinas a los grupos de entrega afectados añadiendo más capacidad al hipervisor o añadiendo más hipervisores. |
| StuckOnBoot | 2 | La VM no completó su secuencia de arranque y no se comunica con el hipervisor. | Asegúrese de que la VM se haya iniciado correctamente en el hipervisor. Compruebe si hay otros mensajes en la VM, como problemas del SO. Asegúrese de que las herramientas del hipervisor estén instaladas en la VM. Asegúrese de que el VDA esté instalado en la VM. |
| FailedToStart | 1 | La VM experimentó problemas al intentar iniciarse en el hipervisor. | Consulte los registros del hipervisor. |
| Ninguno | 0 | - | - |
Motivo de anulación de registro de la máquina (aplicable cuando el tipo de fallo es No registrado o Desconocido)
| Código de error | ID de código de error | Problema | Acción |
|---|---|---|---|
| AgentShutdown | 0 | El VDA experimentó un apagado correcto. | Encienda el VDA si no espera que esté apagado según las directivas de administración de energía existentes. Revise los errores en los registros de eventos. |
| AgentSuspended | 1 | El VDA está en modo de hibernación o suspensión. | Saque el VDA del modo de hibernación. Considere deshabilitar la hibernación para los VDA de Citrix Virtual Apps and Desktops a través de la configuración de energía. |
| IncompatibleVersion | 100 | El VDA no puede comunicarse con el controlador de entrega debido a una falta de coincidencia en las versiones del protocolo de Citrix. | Alinee las versiones del VDA y del controlador de entrega. |
| AgentAddressResolutionFailed | 101 | El controlador de entrega no pudo resolver la dirección IP del VDA. | Verifique que la cuenta de máquina del VDA exista en AD. Si no, créela. Verifique que el nombre y la dirección IP del VDA en DNS sean precisos. Si no, corríjalos. Si es generalizado, valide la configuración de DNS en los controladores de entrega. Verifique la resolución de DNS desde el controlador ejecutando el comando nslookup. |
| 101 | El controlador de entrega no pudo resolver la dirección IP del VDA. | Verifique que la cuenta de máquina del VDA exista en AD. Si no, créela. Verifique que el nombre y la dirección IP del VDA en DNS sean precisos. Si no, corríjalos. | |
| AgentNotContactable | 102 | Se produjo un problema de comunicación entre el controlador de entrega y el VDA. | Utilice un ping para verificar que el controlador de entrega y el VDA puedan comunicarse correctamente. Si no, resuelva cualquier problema de firewall o de red. Consulte los pasos de solución de problemas que se enumeran en el artículo del Centro de conocimientos, Solución de problemas de registro del agente de entrega virtual con controladores de entrega en Citrix Virtual Apps and Desktops (CTX136668), para problemas comunes que causan problemas de comunicación entre el controlador y el VDA. |
| 102 | Se produjo un problema de comunicación entre el delivery controller y el VDA. | Consulte los pasos de solución de problemas que se enumeran en el artículo del Centro de conocimiento, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), para problemas comunes que causan problemas de comunicación entre el controlador y el VDA. Póngase en contacto con el soporte de Citrix. | |
| AgentWrongActiveDirectoryOU | 103 | Se produjo una configuración incorrecta de la detección de Active Directory. La OU específica del sitio (donde se almacena la información del controlador del sitio en AD) configurada en el registro del VDA es para un sitio diferente. | Asegúrese de que la configuración de Active Directory sea correcta o compruebe la configuración del registro. |
| EmptyRegistrationRequest | 104 | La solicitud de registro enviada desde el VDA al delivery controller estaba vacía. Esto puede deberse a una instalación de software del VDA dañada. | Reinicie el servicio de Escritorio en el VDA para reiniciar el proceso de registro y verifique que el VDA se registre correctamente a través del registro de eventos de la aplicación. |
| MissingRegistrationCapabilities | 105 | La versión del VDA no es compatible con el delivery controller. | Actualice el VDA o elimine el VDA y vuelva a instalarlo. |
| MissingAgentVersion | 106 | La versión del VDA no es compatible con el controlador de entrega. | Vuelva a instalar el software VDA si el problema afecta a todas las máquinas. |
| InconsistentRegistrationCapabilities | 107 | El VDA no puede comunicar sus capacidades al Broker. Esto puede deberse a una incompatibilidad entre las versiones del VDA y del controlador de entrega. Las capacidades de registro, que cambian con cada versión, se expresan de una forma que no coincide con la solicitud de registro. | Alinee las versiones del VDA y del controlador de entrega. |
| NotLicensedForFeature | 108 | La función que intenta utilizar no tiene licencia. | Compruebe su edición de licencias de Citrix, o elimine el VDA y vuelva a instalarlo. |
| 108 | La función que intenta utilizar no tiene licencia. | Contactar con soporte de Citrix. | |
| Versión de seguridad de credenciales no compatible | 109 | El VDA y el Delivery Controller no utilizan el mismo mecanismo de cifrado. | Alinee las versiones del VDA y del Delivery Controller. |
| Solicitud de registro no válida | 110 | El VDA realizó una solicitud de registro al Broker, pero el contenido de la solicitud está dañado o no es válido. | Consulte los pasos de solución de problemas que se enumeran en el artículo del Knowledge Center, Solución de problemas de registro de Virtual Delivery Agent con los Delivery Controllers en Citrix Virtual Apps and Desktops (CTX136668), para ver los problemas comunes que causan problemas de comunicación entre el Controller y el VDA. |
| Incompatibilidad de sesión única/multisesión | 111 | El tipo de sistema operativo del VDA no es compatible con el catálogo de máquinas o el grupo de entrega. | Agregue el VDA al tipo de catálogo de máquinas o grupo de entrega correcto que contenga máquinas con el mismo sistema operativo. |
| Nivel funcional demasiado bajo para el catálogo | 112 | El catálogo de máquinas está configurado con un nivel funcional de VDA superior al de la versión de VDA instalada. | Verifique que el nivel funcional del catálogo de máquinas del VDA coincida con el del VDA. Actualice o degrade el catálogo de máquinas para que coincida con el del VDA. |
| FunctionalLevelTooLowForDesktopGroup | 113 | El grupo de entrega está configurado con un nivel funcional de VDA superior al de la versión de VDA instalada. | Verifique que el nivel funcional del grupo de entrega del VDA coincida con el del VDA. Actualice o degrade el catálogo de máquinas para que coincida con el del VDA. |
| PowerOff | 200 | El VDA no se apagó correctamente. | Si se supone que el VDA debe estar encendido, intente iniciar el VDA desde Citrix Studio y verifique que se inicia y se registra correctamente. Solucione cualquier problema de arranque o registro. Revise los registros de eventos del VDA una vez que esté en funcionamiento para ayudar a determinar la causa raíz del apagado. |
| AgentRejectedSettingsUpdate | 203 | Se cambiaron o actualizaron configuraciones como las directivas de Citrix, pero hubo un error al enviar las actualizaciones al VDA. Esto puede ocurrir si las actualizaciones son incompatibles con la versión de VDA instalada. | Actualice el VDA si es necesario. Revise si las actualizaciones aplicadas son compatibles con la versión del VDA. |
| SessionPrepareFailure | 206 | El Broker no completó una auditoría de las sesiones que se están ejecutando en el VDA. | Si está generalizado, reinicie el servicio Citrix Broker en el controlador de entrega. |
| 206 | El Broker no completó una auditoría de las sesiones que se están ejecutando en el VDA. | Póngase en contacto con el soporte de Citrix. | |
| ContactLost | 207 | El controlador de entrega perdió la conexión con el VDA. Esto puede deberse a interrupciones de red. | Verifique que el servicio Citrix Broker se esté ejecutando en el controlador de entrega y que el servicio Desktop se esté ejecutando en el VDA. Inicie cada uno si está detenido. Si ya está iniciado, reinicie el servicio Desktop en el VDA para reiniciar el proceso de registro y verifique que el VDA se registre correctamente. Confirme que los controladores de entrega configurados para el VDA son precisos a través de los detalles en el registro de eventos de la aplicación. Utilice un ping para verificar que el controlador de entrega y el VDA puedan comunicarse correctamente. Si no, resuelva cualquier problema de firewall o de red. |
| 207 | El controlador de entrega perdió la conexión con el VDA. Esto puede deberse a interrupciones de red. | Verifique que el servicio Desktop se esté ejecutando en el VDA. Inícielo si está detenido. | |
| BrokerRegistrationLimitReached | 301 | El controlador de entrega ha alcanzado el número máximo configurado de VDA que pueden registrarse simultáneamente con él. De forma predeterminada, el controlador de entrega permite 10 000 registros simultáneos de VDA. | Considere la posibilidad de agregar controladores de entrega al sitio o crear un sitio. También puede aumentar el número de VDA que pueden registrarse simultáneamente con el controlador de entrega a través de la clave de registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Consulte el artículo del Centro de conocimientos, Entradas de clave de registro utilizadas por Citrix Virtual Apps and Desktops (CTX117446) para obtener más información. Aumentar este número podría requerir más recursos de CPU y memoria para el controlador. |
| SettingsCreationFailure | 208 | El Broker no construyó un conjunto de configuraciones y ajustes para enviar al VDA. Si el Broker no puede recopilar los datos, el registro falla y el VDA queda sin registrar. | Compruebe los registros de eventos en el controlador de entrega para detectar cualquier error. Reinicie el servicio Broker si no hay un problema específico evidente en los registros. Una vez reiniciado el servicio Broker, reinicie el servicio Desktop en los VDA afectados y verifique que se registran correctamente. |
| 208 | El Broker no construyó un conjunto de configuraciones y ajustes para enviar al VDA. Si el Broker no puede recopilar los datos, el registro falla y el VDA queda sin registrar. | Reinicie el servicio Desktop en los VDA afectados y verifique que se registran correctamente. Póngase en contacto con el soporte técnico de Citrix. | |
| SendSettingsFailure | 204 | El Broker no envió la configuración ni los datos de configuración al VDA. Si el Broker puede recopilar los datos pero no puede enviarlos, el registro falla. | Si se limita a un solo VDA, reinicie el servicio Desktop en el VDA para forzar el nuevo registro y valide que el VDA se registra correctamente a través del registro de eventos de la aplicación. Solucione cualquier error que aparezca. Consulte los pasos de solución de problemas que se enumeran en el artículo del Centro de conocimientos, Solución de problemas de registro del Virtual Delivery Agent con los controladores de entrega en Citrix Virtual Apps and Desktops (CTX136668), para problemas comunes que causan problemas de comunicación entre el controlador y el VDA. |
| AgentRequested | 2 | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
| DesktopRestart | 201 | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
| DesktopRemoved | 202 | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
| SessionAuditFailure | 205 | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
| UnknownError | 300 | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
| RegistrationStateMismatch | 302 | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
| Unknown | - | Se produjo un error desconocido. | Póngase en contacto con el soporte de Citrix. |
Motivos de fallos y solución de problemas de Citrix Director
Copiado
Error