Motivos de fallo y solución de problemas en Citrix Director
En las tablas siguientes, se describen las distintas categorías de errores, los motivos de estos y la acción necesaria 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/D | [0] Unknown. 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 desde el servicio de intermediación. | Recopile registros de CDF en el Controller y contacte con la asistencia de Citrix. |
| [0] None | [1] None | Ninguno | N/D |
| [2] MachineFailure | [2] SessionPreparation | Ha fallado la solicitud de preparación de sesión enviada desde el Delivery Controller al VDA. Causas posibles: Problemas de comunicación entre el Controller y el VDA, problemas que tiene el Broker Service al crear una solicitud de preparación o problemas de red que provocan que el VDA no acepte la solicitud. | Consulte los pasos de solución de problemas indicados en el artículo Solución de problemas al registrar Virtual Delivery Agent en Delivery Controllers en Citrix Virtual Apps and Desktops de Knowledge Center para ver los motivos frecuentes de problemas de comunicación entre el Controller y el VDA. |
| [2] MachineFailure | [3] RegistrationTimeout | El VDA estaba encendido, pero se agotó el tiempo de espera al intentar registrarse en el Delivery Controller. | Compruebe que Citrix Broker Service se está ejecutando en el Delivery Controller y que Desktop Service se está ejecutando en el VDA. Si estos servicios están detenidos, inícielos. |
| [1] ClientConnectionFailure | [4] ConnectionTimeout | El cliente no se conectó al VDA, aunque el VDA estuviera preparado para iniciar la sesión. La sesión se negoció correctamente, pero se el tiempo de espera se agotó mientras se esperaba a que el cliente se conectara al VDA. Causas posibles: Configuración del firewall, interrupciones de red o configuraciones que impiden las conexiones remotas. | Consulte la consola de Director para ver si el cliente tiene alguna conexión activa, lo que significa que ningún usuario se ve afectado. Si no hay ninguna sesión, revise los registros de eventos en el cliente y en el VDA en busca de errores. Resuelva los problemas que haya relacionados con la conectividad de red entre el cliente y el VDA. |
| [4] NoLicensesAvailable | [5] Licensing | Ha fallado la solicitud de licencias. Causas posibles: Cantidad insuficiente de licencias, o bien, el servidor de licencias ha estado inactivo durante más de 30 días. | Compruebe que el servidor de licencias esté en línea y sea accesible. Resuelva los problemas de conectividad de red que hubiera con el servidor de licencias o reinicie el servidor de licencias si parece que no funciona correctamente. Verifique que hay licencias suficientes en el entorno y asigne más si es necesario. |
| [1] ClientConnectionFailure | [6] Ticketing | Ocurrió un error de tíquets, que indica que la conexión del cliente al VDA no coincide con la solicitud del broker. El broker prepara un tíquet de solicitud de inicio y lo entrega en el archivo ICA. Cuando el usuario intenta iniciar una sesión, el VDA valida con el broker el tíquet de inicio presente en el archivo ICA. Causas posibles: El archivo ICA está dañado o el usuario intenta realizar una conexión no autorizada. | Verifique que el usuario tiene acceso a la aplicación o al escritorio en función de los grupos de usuarios definidos en los grupos de entrega. Indique al usuario que vuelva a iniciar la aplicación o el escritorio para determinar si se trata de un problema puntual. Si el problema se vuelve a producir, revise los registros de eventos del dispositivo cliente en busca de errores. Compruebe que el VDA al que el usuario está intentando conectarse está registrado. Si no está registrado, revise los registros de eventos en el VDA y resuelva los problemas de registro. |
| [1] ClientConnectionFailure | [7] Otros | El VDA notificó que la sesión fue terminada después de que el cliente contactara inicialmente con el VDA pero antes de completarse la secuencia de conexión. | Verifique que la sesión no fue terminada por el usuario antes del inicio. Intente volver a iniciar la sesión. Si el problema continúa, recopile registros de CDF y contacte con el servicio de asistencia de Citrix. |
| [1] ClientConnectionFailure | [8] GeneralFail | La sesión no se inició. Causas posibles: Se solicitó un inicio con broker mientras este todavía estaba iniciándose o inicializándose, o bien, se produjo un error interno durante la fase del broker de un inicio. | Verifique que Citrix Broker Service se está ejecutando 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. Inhabilite 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] Configuration | [10] ApplicationDisabled | La aplicación fue inhabilitada por el administrador y los usuarios finales no pueden acceder a ella. | Si la aplicación tiene que estar disponible para su uso en producción, habilítela y pida al usuario que se reconecte. |
| [4] NoLicensesAvailable | [11] LicenseFeature Refused | La función utilizada no está cubierta por las licencias existentes. | Contacte con un representante de ventas de Citrix para verificar las funciones que están cubiertas por el tipo de licencias y la edición de Citrix Virtual Apps and Desktops que tiene. |
| [3] NoCapacityAvailable | [13] SessionLimitReached | Todos los VDA están en uso y no hay capacidad para alojar sesiones adicionales. Causas posibles: Todos los VDA están ocupados (para VDA con SO de sesión única), o bien, todos los VDA han alcanzado el máximo configurado de sesiones simultáneas permitidas (para VDA con SO multisesión). | Compruebe si hay algún VDA en modo de mantenimiento. Desactive el modo de mantenimiento si no es necesario para obtener más capacidad. Puede aumentar el valor de Número máximo de sesiones en la configuración de directiva de Citrix para permitir más sesiones por VDA de servidor. También puede agregar más VDA con SO multisesión. Asimismo, tenga en cuenta la opción de agregar más VDA con SO de sesión única. |
| [5] Configuration | [14] DisallowedProtocol | Los protocolos ICA y RDP no están permitidos. | Ejecute el comando Get-BrokerAccessPolicyRule de PowerShell en un Delivery Controller y compruebe si el valor de AllowedProtocols incluye todos los protocolos necesarios. Este problema se produce solo si hay una configuración incorrecta. |
| [5] Configuration | [15] ResourceUnavailable | La aplicación o el escritorio al que el usuario intenta conectarse no está disponible. Es posible que esta aplicación o escritorio no existan, o bien, no haya agentes VDA disponibles para ejecutarlos. Causas posibles: Se ha anulado la publicación de la aplicación o el escritorio, o bien, los agentes VDA que alojan la aplicación o el escritorio han alcanzado la carga máxima, o bien, la aplicación o el escritorio están en modo de mantenimiento. | Verifique que la aplicación o el escritorio aún siguen publicados y que los VDA no están en modo de mantenimiento. Determine si los VDA con SO multisesión están a plena carga. Si es así, aprovisione más VDA con SO multisesión. Compruebe que haya VDA con SO de sesión única disponibles para las conexiones. Aprovisione más VDA con SO de sesión única si es necesario. |
| [5] Configuration | [16] ActiveSessionReconnectDisabled | La sesión ICA está activa y conectada a otro dispositivo de punto final. Sin embargo, dado que la reconexión para sesiones activas está inhabilitada, el cliente no puede conectarse a la sesión activa. | En el Controller, compruebe que la reconexión para sesiones activas está habilitada. Compruebe que el valor de DisableActiveSessionReconnect en el Registro, en HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server está establecido en 0. |
| [2] MachineFailure | [17] NoSessionToReconnect | El cliente intentó reconectarse a una sesión específica, pero la sesión fue terminada. | Vuelva a intentar la reconexión de control del espacio de trabajo. |
| [2] MachineFailure | [18] SpinUpFailed | El VDA no se puede encender para iniciar la sesión. Se trata de un problema del que informa el hipervisor. | Si la máquina sigue apagada, intente iniciarla desde Citrix Studio. Si eso falla, revise la conectividad y los permisos del hipervisor. Si el VDA es una máquina aprovisionada con PVS, compruebe en la consola de PVS que la máquina se está ejecutando. Si no es el caso, compruebe que la máquina tiene asignado un disco Personal vDisk, e inicie sesión en el hipervisor para restablecer la máquina virtual. |
| [2] MachineFailure | [19] Refused | El Delivery Controller envía una solicitud al VDA para prepararse para una conexión desde un usuario final, pero el VDA rechaza activamente esta solicitud. | Verifique por ping que el Controller y el VDA puedan comunicarse correctamente. De lo contrario, resuelva cualquier problema de enrutamiento de red o firewall. |
| [2] MachineFailure | [20] ConfigurationSet Failure | El Delivery Controller no envió al VDA los datos de configuración requeridos, tales como información de la sesión y configuración de directivas, durante el inicio de la sesión. Causas posibles: Problemas de comunicación entre el Controller y el VDA, problemas que tiene el Broker Service al crear una solicitud de configuración o problemas de red que provocan que el VDA no acepte la solicitud. | - |
| [3] NoCapacityAvailable | [21] MaxTotalInstancesExceeded | Se alcanzó la cantidad máxima 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 la opción de incrementar el valor del parámetro de la aplicación Limitar la cantidad de instancias ejecutadas a la vez a, si el sistema de licencias lo permite. |
| [3] NoCapacityAvailable | [22] MaxPerUserInstancesExceeded | El usuario está intentando abrir más de una instancia de una aplicación, pero dicha aplicación está configurada para permitir ejecutar solo una instancia por usuario. Este problema está relacionado con la función de límites de aplicaciones. | De forma predeterminada, solo se permite una instancia de la aplicación por usuario. Si se requieren varias instancias por usuario, puede desmarcar Limitar a una sola instancia por usuario en la configuración de la aplicación. |
| [1] ClientConnectionFailure | [23] Communication error | El Delivery Controller intentó enviar información al VDA (por ejemplo, una solicitud para prepararse para una conexión), pero ocurrió un error durante el intento de comunicación. Este error puede deberse a interrupciones de la red. | Si ya se ha iniciado, reinicie Desktop Service en el VDA para reiniciar el proceso de registro y compruebe que el VDA se registra correctamente. Confirme que los Controllers configurados para el VDA son los correctos. Para ello, consulte los datos del 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 estado del VDA asignado para iniciar la sesión no es válido, o el VDA no está disponible. Causas posibles: 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á inhabilitado pero la sesión actual requiere que esté habilitado, o bien, el VDA se quitó del grupo de entrega o del sitio. | Compruebe que el VDA se encuentra en el grupo de entrega. De lo contrario, agréguelo al grupo de entrega apropiado. Verifique que haya suficientes VDA registrados y preparados para el inicio de la aplicación o el escritorio compartidos y publicados que ha solicitado 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. Causas posibles: El VDA se quitó del grupo de entrega, el VDA no está registrado, el estado de energía del VDA no está disponible o el VDA tiene problemas internos. | Compruebe que el VDA se encuentra en el grupo de entrega. De lo contrario, agréguelo al grupo de entrega apropiado. Compruebe que el VDA se muestra como encendido en Citrix Studio. Si se desconoce el estado de energía de varias máquinas, resuelva cualquier problema que haya relacionado con la conectividad al hipervisor o con errores 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 del código de error | Problema | Acción |
|---|---|---|---|
| Desconocido | - | - | - |
| Sin registrar | 3 | - | - |
| MaxCapacity (representada como Carga máxima en Director) | 4 | La máquina se notifica a sí misma en su capacidad máxima; es decir, al llegar al índice de carga máxima | Compruebe que todos los hipervisores están iniciados. Agregue más máquinas a los grupos de entrega afectados mediante más capacidad para el hipervisor o con más hipervisores. |
| StuckOnBoot | 2 | La VM no completó su secuencia de arranque y no se está comunicando con el hipervisor. | Compruebe que la máquina virtual ha arrancado correctamente en el hipervisor. Compruebe si hay otros mensajes en la VM, tales como problemas de SO. Compruebe que la VM tiene instaladas las herramientas de hipervisor. Compruebe que el VDA está instalado en la VM. |
| FailedToStart | 1 | La VM tuvo problemas al intentar iniciarse en el hipervisor. | Consulte los registros del hipervisor. |
| Ninguno | 0 | - | - |
Motivo de anulación del registro de la máquina (se aplica cuando el tipo de fallo es Sin registrar o Desconocido)
| Código de error | ID del código de error | Problema | Acción |
|---|---|---|---|
| AgentShutdown | 0 | El VDA se apagó correctamente. | Encienda el VDA si no debería estar apagado según las directivas de administración de energía existentes. Revise los errores que haya en los registros de eventos. |
| AgentSuspended | 1 | El VDA está en modo de suspensión o hibernación. | Saque al VDA del modo de hibernación. Considere la opción de inhabilitar la hibernación de los VDA de Citrix Virtual Apps and Desktops en los parámetros de energía. |
| IncompatibleVersion | 100 | El VDA no se puede comunicar con el Delivery Controller debido a que las versiones del protocolo de Citrix no coinciden. | Equipare las versiones del VDA y del Delivery Controller. |
| AgentAddressResolutionFailed | 101 | El Delivery Controller no pudo resolver la dirección IP del VDA. | Compruebe que la cuenta de la máquina del VDA existe en AD. Si no es así, créela. Compruebe que sean correctos el nombre y la dirección IP del VDA en DNS. Si no es así, corríjalos. Si se trata de un problema generalizado, compruebe los parámetros de DNS en los Controllers. Verifique la resolución de DNS desde el Controller. Para ello, ejecute el comando nslookup. |
| 101 | El Delivery Controller no pudo resolver la dirección IP del VDA. | Compruebe que la cuenta de la máquina del VDA existe en AD. Si no es así, créela. Compruebe que sean correctos el nombre y la dirección IP del VDA en DNS. Si no es así, corríjalos. | |
| AgentNotContactable | 102 | Hubo un problema de comunicación entre el Delivery Controller y el VDA. | Utilice ping para comprobar que el Delivery Controller y el VDA pueden comunicarse. Si no es el caso, resuelva los problemas de firewall o red que haya. Consulte los pasos de solución de problemas indicados en el artículo Solución de problemas al registrar Virtual Delivery Agent en Delivery Controllers en Citrix Virtual Apps and Desktops (CTX136668) de Knowledge Center para ver los motivos frecuentes de problemas de comunicación entre el Controller y el VDA. |
| 102 | Hubo un problema de comunicación entre el Delivery Controller y el VDA. | Consulte los pasos de solución de problemas indicados en el artículo Solución de problemas al registrar Virtual Delivery Agent en Delivery Controllers en Citrix Virtual Apps and Desktops (CTX136668) de Knowledge Center para ver los motivos frecuentes de problemas de comunicación entre el Controller y el VDA. Contacte con la asistencia de Citrix. | |
| AgentWrongActiveDirectoryOU | 103 | Configuración incorrecta de la detección de Active Directory. La unidad organizativa específica del sitio (donde se guarda la información de Controllers del sitio en AD) configurada en el Registro del VDA corresponde a otro sitio. | Compruebe que la configuración de Active Directory es correcta o consulte los parámetros del Registro. |
| EmptyRegistrationRequest | 104 | La solicitud de registro enviada desde el VDA al Delivery Controller estaba vacía. Puede deberse a una instalación dañada del software del VDA. | Reinicie Desktop Service en el VDA para reiniciar el proceso de registro y compruebe si el VDA se registra correctamente. Para ello, consulte los registros de eventos de aplicación. |
| MissingRegistrationCapabilities | 105 | La versión del VDA no es compatible con el Delivery Controller. | Actualice el VDA, o quítelo y vuelva a instalarlo. |
| MissingAgentVersion | 106 | La versión del VDA no es compatible con el Delivery Controller. | Reinstale el software del VDA si el problema afecta a todas las máquinas. |
| InconsistentRegistrationCapabilities | 107 | El VDA no puede comunicar sus capacidades al broker. Puede deberse a una incompatibilidad entre las versiones del VDA y del Delivery Controller. Las capacidades de registro, que cambian con cada versión, están expresadas de una forma que no coincide con la solicitud de registro. | Equipare las versiones del VDA y del Delivery Controller. |
| NotLicensedForFeature | 108 | La función que intenta usar no tiene licencia. | Consulte su edición de Citrix Licensing o quite el VDA y vuelva a instalarlo. |
| 108 | La función que intenta usar no tiene licencia. | Contacte con la asistencia de Citrix. | |
| UnsupportedCredentialSecurity version | 109 | El VDA y el Delivery Controller no están usando el mismo mecanismo de cifrado. | Equipare las versiones del VDA y del Delivery Controller. |
| InvalidRegistrationRequest | 110 | El VDA hizo una solicitud de registro al broker, pero el contenido de la solicitud de registro está dañado o no es válido. | Consulte los pasos de solución de problemas indicados en el artículo Solución de problemas al registrar Virtual Delivery Agent en Delivery Controllers en Citrix Virtual Apps and Desktops (CTX136668) de Knowledge Center para ver los motivos frecuentes de problemas de comunicación entre el Controller 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. | Agregue la máquina 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á definido con un nivel funcional de VDA superior al de la versión de VDA instalada. | Compruebe que el nivel funcional del catálogo de máquinas del VDA coincide con el del VDA. Actualice o revierta la versión del catálogo de máquinas para que coincida con la del VDA. |
| FunctionalLevelTooLowForDesktopGroup | 113 | El grupo de entrega está definido con un nivel funcional de VDA superior al de la versión de VDA instalada. | Compruebe que el nivel funcional del grupo de entrega del VDA coincide con el del VDA. Actualice o revierta la versión del catálogo de máquinas para que coincida con la del VDA. |
| PowerOff | 200 | El VDA no se apagó correctamente. | Si el VDA debiera estar encendido, intente iniciarlo desde Citrix Studio y compruebe que arranca y se registra correctamente. Solucione cualquier problema de arranque o registro. Consulte los registros de eventos en el VDA una vez que se haya iniciado para determinar la causa del apagado. |
| AgentRejectedSettingsUpdate | 203 | Se cambiaron o actualizaron algunos parámetros, tales como directivas de Citrix, pero hubo un error al enviar las actualizaciones al VDA. Puede ocurrir si las actualizaciones son incompatibles con la versión de VDA que está instalada. | Actualice el VDA si fuera necesario. Compruebe si esa versión del VDA admite las actualizaciones en cuestión. |
| SessionPrepareFailure | 206 | El broker no completó una auditoría de las sesiones activas en el VDA. | Si el problema es generalizado, reinicie Citrix Broker Service en el Delivery Controller. |
| 206 | El broker no completó una auditoría de las sesiones activas en el VDA. | Contacte con la asistencia de Citrix. | |
| ContactLost | 207 | El Delivery Controller perdió la conexión con el VDA. Esto puede deberse a interrupciones de la red. | Compruebe que Citrix Broker Service se está ejecutando en el Delivery Controller y que Desktop Service se está ejecutando en el VDA. Si estos servicios están detenidos, inícielos. Si ya se ha iniciado, reinicie Desktop Service en el VDA para reiniciar el proceso de registro y compruebe que el VDA se registra correctamente. Confirme que los Controllers configurados para el VDA son los correctos. Para ello, consulte los datos del registro de eventos de la aplicación. Utilice ping para comprobar que el Delivery Controller y el VDA pueden comunicarse. Si no es el caso, resuelva los problemas de firewall o red que haya. |
| 207 | El Delivery Controller perdió la conexión con el VDA. Esto puede deberse a interrupciones de la red. | Compruebe que Desktop Service se está ejecutando en el VDA. Si este servicio está detenido, inícielo. | |
| BrokerRegistrationLimitReached | 301 | El Delivery Controller ha alcanzado la cantidad máxima configurada de VDA que se pueden registrar simultáneamente en él. De forma predeterminada, el Delivery Controller permite 10 000 registros de VDA simultáneos. | Considere la opción de agregar Delivery Controllers al sitio o crear un sitio nuevo. También puede aumentar la cantidad de VDA que se pueden registrar simultáneamente en el Delivery Controller. Para ello, modifique la clave de Registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Consulte el artículo Entradas de clave de Registro utilizadas por Citrix Virtual Apps and Desktops (CTX117446) de Knowledge Center para obtener más información. Al aumentar esta cantidad, puede que el Controller requiera más recursos de CPU y memoria. |
| SettingsCreationFailure | 208 | El broker no construyó ningún conjunto de parámetros y configuraciones que enviar al VDA. Si el broker no puede recopilar los datos, el registro falla y se anula el registro del VDA. | Consulte los registros de eventos del Controller en busca de errores. Si no ve un problema claro en los registros de eventos, reinicie Broker Service. Una vez reiniciado Broker Service, reinicie Desktop Service en los VDA afectados y compruebe que se registran correctamente. |
| 208 | El broker no construyó ningún conjunto de parámetros y configuraciones que enviar al VDA. Si el broker no puede recopilar los datos, el registro falla y se anula el registro del VDA. | Reinicie Desktop Service en los VDA afectados y compruebe que se registran correctamente. Contacte con la asistencia de Citrix. | |
| SendSettingsFailure | 204 | El broker no envió datos de parámetros y configuraciones al VDA. Si el broker puede reunir los datos pero no puede enviarlos, el registro falla. | Si el problema se limita a un solo VDA, reinicie Desktop Service en el VDA para forzar un nuevo registro y compruebe que el VDA se registra correctamente. Para esto último, consulte los eventos de aplicación. Solucione los errores que vea. Consulte los pasos de solución de problemas indicados en el artículo Solución de problemas al registrar Virtual Delivery Agent en Delivery Controllers en Citrix Virtual Apps and Desktops (CTX136668) de Knowledge Center para ver los motivos frecuentes de problemas de comunicación entre el Controller y el VDA. |
| AgentRequested | 2 | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
| DesktopRestart | 201 | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
| DesktopRemoved | 202 | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
| SessionAuditFailure | 205 | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
| UnknownError | 300 | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
| RegistrationStateMismatch | 302 | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
| Desconocido | - | Ocurrió un error desconocido. | Contacte con la asistencia de Citrix. |
Motivos de fallo y solución de problemas en Citrix Director
Copiado
Error