Motivos de fallo y solución de problemas de Citrix Director
Las siguientes tablas describen las diversas categorías de fallos, los motivos y las acciones que debe realizar para resolver los problemas. Para obtener más información, consulte Enumeraciones, códigos de error y descripciones.
Errores de conexión
| Categoría | Motivo | Problema | Acción |
|---|---|---|---|
| N/A | [0] Desconocido. Este código de error no está asignado. | El servicio de supervisión no puede determinar el motivo del error de inicio o conexión notificado a partir de la información compartida por el servicio de intermediación. | Recopila los registros CDF en el controlador y ponte en contacto con el servicio de asistencia de Citrix. |
| [0] Ninguno | [1] Ninguno | Ninguno | N/A |
| [2] ErrorDeMáquina | [2] PreparaciónDeSesión | La solicitud de preparación de sesión del controlador de entrega al VDA falló. Posibles causas: Problemas de comunicación entre el controlador y el VDA, problemas experimentados por el servicio Broker al crear una solicitud de preparación o problemas de red que provocan que el VDA no acepte la solicitud. | Consulta los pasos de solución de problemas que se enumeran en el artículo del centro de conocimiento, Solución de problemas de registro del Virtual Delivery Agent con los controladores de entrega en Citrix Virtual Apps and Desktops para problemas comunes que causan problemas de comunicación entre el controlador y el VDA. |
| [2] ErrorDeMáquina | [3] TiempoDeEsperaDeRegistro | El VDA se encendió, pero se produjo un tiempo de espera mientras intentaba registrarse con el controlador de entrega. | Verifica que el servicio Citrix Broker se esté ejecutando en el controlador de entrega y que el servicio Desktop se esté ejecutando en el VDA. Inicia cada uno si está detenido. |
| [1] ErrorDeConexiónDeCliente | [4] TiempoDeEsperaDeConexión | 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 produjo un 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. | Comprueba 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, revisa los registros de eventos en el cliente y en el VDA para detectar cualquier error. Resuelve cualquier problema de conectividad de red entre el cliente y el VDA. |
| [4] NoHayLicenciasDisponibles | [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. | Verifica que el servidor de licencias esté en línea y accesible. Resuelve cualquier problema de conectividad de red con el servidor de licencias o reinicia el servidor de licencias si parece estar funcionando mal. Verifica que haya suficientes licencias en el entorno y asigna más si es necesario. |
| [1] ErrorDeConexiónDeCliente | [6] EmisiónDeTickets | 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. | Verifica que el usuario tenga acceso a la aplicación o al escritorio según los grupos de usuarios definidos en los grupos de entrega. Indica 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, revisa los registros de eventos del dispositivo cliente para detectar errores. Verifica que el VDA al que el usuario intenta conectarse esté registrado. Si no está registrado, revisa los registros de eventos en el VDA y resuelve cualquier problema de registro. |
| [1] ErrorDeConexiónDeCliente | [7] Otro | Se ha informado que una sesión se terminó desde el VDA después de que el cliente contactara inicialmente con el VDA, pero antes de que completara la secuencia de conexión. | Verifica si el usuario no terminó la sesión antes del inicio. Intenta reiniciar la sesión; si el problema persiste, recopila los registros CDF y ponte en contacto con el servicio de asistencia de Citrix. |
| [1] ErrorDeConexiónDeCliente | [8] ErrorGeneral | La sesión no se pudo iniciar. Posibles causas: Se solicitó un inicio intermediado mientras el broker aún se estaba iniciando o inicializando, o un error interno durante la fase de intermediación de un inicio. | Verifica que el servicio Citrix Broker se esté ejecutando y vuelve a intentar iniciar la sesión. |
| [5] Configuración | [9] ModoDeMantenimiento | El VDA, o el grupo de entrega al que pertenece el VDA, está configurado en modo de mantenimiento. | Determina si el modo de mantenimiento es necesario. Deshabilita el modo de mantenimiento en el grupo de entrega o la máquina en cuestión si no es necesario e indica 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, habilita la aplicación e indica al usuario que vuelva a conectarse. |
| [4] NoHayLicenciasDisponibles | [11] FunciónDeLicenciaRechazada | La función que se está utilizando no está cubierta por las licencias existentes. | Ponte 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 configurado de sesiones simultáneas permitidas (para VDA de SO de varias sesiones). | Verifica si hay algún VDA en modo de mantenimiento. Deshabilita el modo de mantenimiento si no es necesario para liberar más capacidad. Considera 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. Considera agregar más VDA de SO de varias sesiones. Considera agregar más VDA de SO de sesión única. |
| [5] Configuración | [14] ProtocoloNoPermitido | Los protocolos ICA y RDP no están permitidos. | Ejecuta el comando de PowerShell Get-BrokerAccessPolicyRule en el controlador de entrega y verifica que el valor de AllowedProtocols tenga todos los protocolos deseados enumerados. Este problema ocurre solo si hay una configuración incorrecta. |
| [5] Configuración | [15] RecursoNoDisponible | 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á configurado en modo de mantenimiento. | Verifica que la aplicación o el escritorio aún estén publicados y que los VDA no estén en modo de mantenimiento. Determina si los VDA de SO de varias sesiones están a plena carga. Si es así, aprovisiona más VDA de SO de varias sesiones. Verifica que haya VDA de SO de sesión única disponibles para las conexiones. Aprovisiona más VDA de SO de sesión única si es necesario. |
| [5] Configuración | [16] ReconexiónDeSesiónActivaDeshabilitada | La sesión ICA está activa y conectada a un punto final diferente. Sin embargo, debido a que la Reconexión de sesión activa está deshabilitada, el cliente no puede conectarse a la sesión activa. | En el controlador de entrega, verifica que la Reconexión de sesión activa esté habilitada. Verifica que el valor de DisableActiveSessionReconnect en el registro, en HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server, esté establecido en 0. |
| [2] ErrorDeMáquina | [17] NoHaySesiónParaReconectar | El cliente intentó volver a conectarse a una sesión específica, pero la sesión se terminó. | Vuelve a intentar la reconexión del control del espacio de trabajo. |
| [2] ErrorDeMáquina | [18] ErrorDeArranque | El VDA no se puede encender para el inicio de la sesión. Este es un problema informado por el hipervisor. | Si la máquina aún está apagada, intenta iniciarla desde Citrix Studio. Si esto falla, revisa la conectividad y los permisos del hipervisor. Si el VDA es una máquina aprovisionada por PVS, verifica en la consola de PVS que la máquina se esté ejecutando. Si no, verifica que la máquina tenga asignado un vDisk personal, inicia sesión en el hipervisor para restablecer la VM. |
| [2] Fallo de la máquina | [19] Rechazado | El Delivery Controller envía una solicitud al VDA para preparar una conexión de un usuario final, pero el VDA rechaza activamente esta solicitud. | Verifica, mediante ping, que el Delivery Controller y el VDA pueden comunicarse correctamente. Si no es así, resuelve cualquier problema de firewall o de enrutamiento de red. |
| [2] Fallo de la máquina | [20] Fallo de ConfigurationSet | El Delivery Controller no envió los datos de configuración necesarios, como la configuración de directivas y la información de la sesión, al VDA durante el inicio de la sesión. Posibles causas: Problemas de comunicación entre el Controller y el VDA, problemas experimentados por el servicio Broker al crear una solicitud de ConfigurationSet, o problemas de red que impiden que el VDA acepte la solicitud. | - |
| [3] Sin 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. | Considera aumentar el valor de 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] Sin capacidad disponible | [22] Se superó el número máximo de instancias por usuario | El usuario intenta abrir más de una instancia de una aplicación, pero la aplicación está configurada para permitir solo una instancia de la aplicación por usuario. Este problema está relacionado con la función de límites de aplicaciones. | Solo se permite una instancia de la aplicación por usuario de forma predeterminada. Si se requieren varias instancias por usuario, considera desmarcar la configuración Limitar a una instancia por usuario en la configuración de la aplicación. |
| [1] Fallo de conexión del cliente | [23] Error de comunicación | El Delivery Controller intentó enviar información al VDA, como una solicitud para preparar una conexión, pero se produjo un error durante el intento de comunicación. Esto puede deberse a interrupciones de red. | Si ya se ha iniciado, reinicia el servicio Desktop en el VDA para reiniciar el proceso de registro y verifica que el VDA se registra correctamente. Confirma que los Delivery Controllers configurados para el VDA son correctos a través de los detalles en el registro de eventos de la aplicación. |
| [3] Sin capacidad disponible | [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 se eliminó del grupo de entrega o del sitio. | Verifica que el VDA esté en un grupo de entrega. Si no es así, agrégalo al grupo de entrega adecuado. Verifica que haya suficientes VDA registrados y en estado listo para poder iniciar el escritorio compartido publicado o la aplicación solicitada por el usuario. Verifica que el hipervisor que aloja el VDA no esté en modo de mantenimiento. |
| [2] Fallo de la máquina | [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. | Verifica que el VDA esté en un grupo de entrega. Si no es así, agrégalo al grupo de entrega adecuado. Verifica que el VDA aparezca como encendido en Citrix Studio. Si el estado de energía es desconocido para varias máquinas, resuelve cualquier problema de conectividad con el hipervisor o fallos del host. Verifica que el hipervisor que aloja el VDA no esté en modo de mantenimiento. Reinicia el VDA una vez que se hayan resuelto estos problemas. |
Tipo de fallo de máquina
| Código de error | ID de código de error | Problema | Acción |
|---|---|---|---|
| Desconocido | - | - | - |
| No registrado | 3 | - | - |
| Capacidad máxima (representada como Carga máxima en Director) | 4 | La máquina informa que está a su capacidad máxima, es decir, índice de carga máxima. | Asegúrate de que todos los hipervisores estén encendidos. Agrega más máquinas a los grupos de entrega afectados añadiendo más capacidad al hipervisor o añadiendo más hipervisores. |
| Atascado en el arranque | 2 | La VM no completó su secuencia de arranque y no se está comunicando con el hipervisor. | Asegúrate de que la VM se haya iniciado correctamente en el hipervisor. Busca otros mensajes en la VM, como problemas del sistema operativo. Asegúrate de que las herramientas del hipervisor estén instaladas en la VM. Asegúrate de que el VDA esté instalado en la VM. |
| Error al iniciar | 1 | La VM experimentó problemas al intentar iniciarse en el hipervisor. | Revisa los registros del hipervisor. |
| Ninguno | 0 | - | - |
Motivo de la anulación del 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 controlado. | Enciende el VDA si no esperas que esté apagado según las políticas de administración de energía existentes. Revisa los errores en los registros de eventos. |
| AgentSuspended | 1 | El VDA está en modo de hibernación o suspensión. | Saca el VDA del modo de hibernación. Considera 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. | Alinea las versiones del VDA y del controlador de entrega. |
| AgentAddressResolutionFailed | 101 | El controlador de entrega no pudo resolver la dirección IP del VDA. | Verifica que la cuenta de máquina del VDA exista en AD. Si no, créala. Verifica que el nombre y la dirección IP del VDA en DNS sean precisos. Si no, corrígelos. Si es generalizado, valida la configuración de DNS en los controladores de entrega. Verifica 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. | Verifica que la cuenta de máquina del VDA exista en AD. Si no, créala. Verifica que el nombre y la dirección IP del VDA en DNS sean precisos. Si no, corrígelos. | |
| AgentNotContactable | 102 | Se produjo un problema de comunicación entre el controlador de entrega y el VDA. | Usa un ping para verificar que el controlador de entrega y el VDA puedan comunicarse correctamente. Si no, resuelve cualquier problema de firewall o de red. Consulta 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. |
| 102 | Se produjo un problema de comunicación entre el controlador de entrega y el VDA. | Consulta 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. Ponte en contacto con el soporte de Citrix. | |
| AgentWrongActiveDirectoryOU | 103 | Se produjo una configuración incorrecta de 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úrate de que la configuración de Active Directory sea correcta o verifica la configuración del registro. |
| EmptyRegistrationRequest | 104 | La solicitud de registro enviada desde el VDA al controlador de entrega estaba vacía. Esto puede deberse a una instalación de software del VDA dañada. | Reinicia el servicio Desktop en el VDA para reiniciar el proceso de registro y verifica 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 controlador de entrega. | Actualiza el VDA o quita el VDA y luego vuelve a instalarlo. |
| MissingAgentVersion | 106 | La versión del VDA no es compatible con el controlador de entrega. | Vuelve a instalar el software del 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. | Alinea las versiones del VDA y del controlador de entrega. |
| NotLicensedForFeature | 108 | La función que intentas usar no tiene licencia. | Verifica tu edición de licencias de Citrix o quita el VDA y luego vuelve a instalarlo. |
| 108 | La función que intentas usar no tiene licencia. | Ponte en contacto con el soporte de Citrix. | |
| UnsupportedCredentialSecurity version | 109 | El VDA y el controlador de entrega no están usando el mismo mecanismo de cifrado. | Alinea las versiones del VDA y del controlador de entrega. |
| InvalidRegistrationRequest | 110 | El VDA realizó una solicitud de registro al Broker, pero el contenido de la solicitud está dañado o no es válido. | Consulta 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. |
| SingleMultiSessionMismatch | 111 | El tipo de sistema operativo del VDA no es compatible con el catálogo de máquinas o el grupo de entrega. | Agrega el VDA al tipo de catálogo de máquinas o grupo de entrega correcto que contenga máquinas con el mismo sistema operativo. |
| FunctionalLevelTooLowForCatalog | 112 | El catálogo de máquinas está configurado con un nivel funcional de VDA superior al de la versión de VDA instalada. | Verifica que el nivel funcional del catálogo de máquinas del VDA coincida con el del VDA. Actualiza o degrada 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. | Verifica que el nivel funcional del grupo de entrega del VDA coincida con el del VDA. Actualiza o degrada el catálogo de máquinas para que coincida con el del VDA. |
| PowerOff | 200 | El VDA no se apagó de forma controlada. | Si se supone que el VDA debe estar encendido, intenta iniciar el VDA desde Citrix Studio y verifica que se inicie y se registre correctamente. Soluciona cualquier problema de arranque o registro. Revisa los registros de eventos en el 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 políticas 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. | Actualiza el VDA si es necesario. Revisa si las actualizaciones que se aplicaron 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 es generalizado, reinicia 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. | Ponte en contacto con el soporte de Citrix. | |
| ContactLost | 207 | El controlador de entrega perdió la conexión con el VDA. Esto puede ser causado por interrupciones de red. | Verifica que el servicio Citrix Broker se esté ejecutando en el controlador de entrega y que el servicio Desktop se esté ejecutando en el VDA. Inicia cada uno si está detenido. Si ya está iniciado, reinicia el servicio Desktop en el VDA para reiniciar el proceso de registro y verifica que el VDA se registre correctamente. Confirma que los controladores de entrega configurados para el VDA sean precisos a través de los detalles en el registro de eventos de la aplicación. Usa un ping para verificar que el controlador de entrega y el VDA puedan comunicarse correctamente. Si no, resuelve cualquier problema de firewall o de red. |
| 207 | El controlador de entrega perdió la conexión con el VDA. Esto puede ser causado por interrupciones de red. | Verifica que el servicio Desktop se esté ejecutando en el VDA. Inícialo 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. Por defecto, el controlador de entrega permite 10 000 registros simultáneos de VDA. | Considera agregar controladores de entrega al sitio o crear un sitio. También puedes 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. Consulta el artículo del Centro de conocimiento, 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. | Verifica los registros de eventos en el controlador de entrega en busca de errores. Reinicia el servicio Broker si no hay un problema específico evidente en los registros. Una vez reiniciado el servicio Broker, reinicia el servicio Desktop en los VDA afectados y verifica que se registren 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. | Reinicia el servicio Desktop en los VDA afectados y verifica que se registren correctamente. Contacta con el soporte de Citrix. | |
| SendSettingsFailure | 204 | El Broker no envió los datos de configuración y ajustes al VDA. Si el Broker puede recopilar los datos pero no puede enviarlos, el registro falla. | Si se limita a un solo VDA, reinicia el servicio Desktop en el VDA para forzar el nuevo registro y valida que el VDA se registre correctamente a través del registro de eventos de la aplicación. Soluciona cualquier error que observes. Consulta los pasos de solución de problemas enumerados en el artículo del Centro de conocimiento, Solución de problemas de registro del Virtual Delivery Agent 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. |
| AgentRequested | 2 | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
| DesktopRestart | 201 | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
| DesktopRemoved | 202 | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
| SessionAuditFailure | 205 | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
| UnknownError | 300 | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
| RegistrationStateMismatch | 302 | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
| Unknown | - | Se produjo un error desconocido. | Contacta con el soporte de Citrix. |
Motivos de fallo y solución de problemas de Citrix Director
Copiado
Error