Motivos de falha e solução de problemas do Citrix Director
As tabelas a seguir descrevem as várias categorias de falha, os motivos e a ação que você precisa tomar para resolver os problemas. Para obter mais informações, consulte Enumerações, códigos de erro e descrições.
Erros de falha de conexão
| Categoria | Motivo | Problema | Ação |
|---|---|---|---|
| N/A | [0] Desconhecido. Este código de erro não está mapeado. | O serviço de Monitoramento não consegue determinar o motivo da falha de inicialização ou conexão relatada a partir das informações compartilhadas pelo serviço de Brokering. | Colete os logs CDF no controlador e entre em contato com o suporte da Citrix. |
| [0] Nenhum | [1] Nenhum | Nenhum | N/A |
| [2] Falha da Máquina | [2] Preparação da Sessão | A solicitação de preparação da sessão do controlador de entrega para o VDA falhou. Causas possíveis: Problemas de comunicação entre o controlador e o VDA, problemas encontrados pelo Broker Service ao criar uma solicitação de preparação ou problemas de rede que resultam na não aceitação da solicitação pelo VDA. | Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops para problemas comuns que causam problemas de comunicação entre o controlador e o VDA. |
| [2] Falha da Máquina | [3] Tempo Limite de Registro | O VDA foi ligado, mas ocorreu um tempo limite enquanto ele tentava se registrar com o controlador de entrega. | Verifique se o Citrix Broker Service está em execução no controlador de entrega e se o serviço Desktop está em execução no VDA. Inicie cada um se estiverem parados. |
| [1] Falha de Conexão do Cliente | [4] Tempo Limite de Conexão | O cliente não se conectou ao VDA depois que o VDA foi preparado para o lançamento da sessão. A sessão foi intermediada com sucesso, mas ocorreu um tempo limite enquanto aguardava a conexão do cliente com o VDA. Causas possíveis: Configurações de firewall, interrupções de rede ou configurações que impedem conexões remotas. | Verifique o console do Director para ver se o cliente tem uma conexão ativa no momento, o que significa que nenhum usuário é impactado. Se nenhuma sessão existir, revise os logs de eventos no cliente e no VDA em busca de erros. Resolva quaisquer problemas de conectividade de rede entre o cliente e o VDA. |
| [4] Nenhuma Licença Disponível | [5] Licenciamento | A solicitação de licenciamento falhou. Causas possíveis: Número insuficiente de licenças ou o servidor de licenças está inativo há mais de 30 dias. | Verifique se o servidor de licenças está online e acessível. Resolva quaisquer problemas de conectividade de rede com o servidor de licenças ou reinicie o servidor de licenças se ele parecer estar com mau funcionamento. Verifique se há licenças suficientes no ambiente e aloque mais, se necessário. |
| [1] Falha de Conexão do Cliente | [6] Emissão de Ticket | Ocorreu uma falha durante a emissão de ticket, indicando que a conexão do cliente com o VDA não corresponde à solicitação intermediada. Um ticket de solicitação de lançamento é preparado pelo Broker e entregue no arquivo ICA®. Quando o usuário tenta iniciar uma sessão, o VDA valida o ticket de lançamento no arquivo ICA com o Broker. Causas possíveis: O arquivo ICA está corrompido ou o usuário está tentando fazer uma conexão não autorizada. | Verifique se o usuário tem acesso ao aplicativo ou desktop com base nos grupos de usuários definidos nos grupos de entrega. Instrua o usuário a relançar o aplicativo ou desktop para determinar se este é um problema pontual. Se o problema ocorrer novamente, revise os logs de eventos do dispositivo cliente em busca de erros. Verifique se o VDA ao qual o usuário está tentando se conectar está registrado. Se não estiver registrado, revise os logs de eventos no VDA e resolva quaisquer problemas de registro. |
| [1] Falha de Conexão do Cliente | [7] Outro | Uma sessão foi relatada como encerrada pelo VDA depois que o cliente contatou inicialmente o VDA, mas antes de concluir a sequência de conexão. | Verifique se a sessão não foi encerrada pelo usuário antes do lançamento. Tente relançar a sessão; se o problema persistir, colete os logs CDF e entre em contato com o suporte da Citrix. |
| [1] Falha de Conexão do Cliente | [8] Falha Geral | A sessão falhou ao ser iniciada. Causas possíveis: Um lançamento intermediado foi solicitado enquanto o broker ainda estava iniciando ou inicializando, ou erro interno durante a fase de intermediação de um lançamento. | Verifique se o Citrix Broker Service está em execução e tente novamente iniciar a sessão. |
| [5] Configuração | [9] Modo de Manutenção | O VDA, ou o grupo de entrega ao qual o VDA pertence, está definido no modo de manutenção. | Determine se o modo de manutenção é necessário. Desative o modo de manutenção no grupo de entrega ou na máquina em questão, se não for necessário, e instrua o usuário a tentar se reconectar. |
| [5] Configuração | [10] Aplicativo Desabilitado | O aplicativo não pode ser acessado pelos usuários finais porque foi desabilitado pelo administrador. | Se o aplicativo for destinado ao uso em produção, habilite o aplicativo e instrua o usuário a se reconectar. |
| [4] Nenhuma Licença Disponível | [11] Recusa de Recurso de Licença | O recurso que está sendo usado não é coberto pelas licenças existentes. | Entre em contato com um representante de vendas da Citrix para confirmar os recursos cobertos pela edição e tipo de licença existentes do Citrix Virtual Apps and Desktops™. |
| [3] Nenhuma Capacidade Disponível | [13] Limite de Sessões Atingido | Todos os VDAs estão em uso e não há capacidade para hospedar mais sessões. Causas possíveis: Todos os VDAs estão em uso (para VDAs de SO de sessão única) ou todos os VDAs atingiram o número máximo configurado de sessões simultâneas permitidas (para VDAs de SO de várias sessões). | Verifique se há VDAs em modo de manutenção. Desative o modo de manutenção, se não for necessário, para liberar mais capacidade. Considere aumentar o valor de Número Máximo de Sessões na configuração da política da Citrix para permitir mais sessões por VDA de servidor. Considere adicionar mais VDAs de SO de várias sessões. Considere adicionar mais VDAs de SO de sessão única. |
| [5] Configuração | [14] Protocolo Não Permitido | Os protocolos ICA e RDP não são permitidos. | Execute o comando PowerShell Get-BrokerAccessPolicyRule no controlador de entrega e verifique se o valor de AllowedProtocols lista todos os protocolos desejados. Este problema ocorre apenas se houver uma configuração incorreta. |
| [5] Configuração | [15] Recurso Indisponível | O aplicativo ou desktop ao qual o usuário está tentando se conectar não está disponível. Este aplicativo ou desktop pode não existir, ou não há VDAs disponíveis para executá-lo. Causas possíveis: O aplicativo ou desktop foi despublicado, ou os VDAs que hospedam o aplicativo ou desktop atingiram a carga máxima, ou o aplicativo ou desktop está definido no modo de manutenção. | Verifique se o aplicativo ou desktop ainda está publicado e se os VDAs não estão em modo de manutenção. Determine se os VDAs de SO de várias sessões estão com carga total. Se sim, provisione mais VDAs de SO de várias sessões. Verifique se há VDAs de SO de sessão única disponíveis para conexões. Provisione mais VDAs de SO de sessão única, se necessário. |
| [5] Configuração | [16] Reconexão de Sessão Ativa Desabilitada | A sessão ICA está ativa e conectada a um endpoint diferente. No entanto, como a Reconexão de Sessão Ativa está desabilitada, o cliente não pode se conectar à sessão ativa. | No controlador de entrega, verifique se a Reconexão de Sessão Ativa está habilitada. Verifique se o valor de DisableActiveSessionReconnect no registro, em HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server, está definido como 0. |
| [2] Falha da Máquina | [17] Nenhuma Sessão para Reconectar | O cliente tentou se reconectar a uma sessão específica, mas a sessão foi encerrada. | Tente novamente a reconexão do controle de workspace. |
| [2] Falha da Máquina | [18] Falha na Inicialização | O VDA não pode ser ligado para o lançamento da sessão. Este é um problema relatado pelo hypervisor. | Se a máquina ainda estiver desligada, tente iniciar a máquina a partir do Citrix Studio. Se isso falhar, revise a conectividade e as permissões do hypervisor. Se o VDA for uma máquina provisionada por PVS, verifique no console do PVS se a máquina está em execução. Caso contrário, verifique se a máquina está atribuída a um Personal vDisk, faça login no hypervisor para redefinir a VM. |
| [2] Falha da Máquina | [19] Recusado | O controlador de entrega envia uma solicitação ao VDA para se preparar para uma conexão de um usuário final, mas o VDA recusa ativamente esta solicitação. | Verifique, via ping, se o controlador de entrega e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou roteamento de rede. |
| [2] Falha da Máquina | [20] Falha do Conjunto de Configuração | O controlador de entrega não enviou os dados de configuração necessários, como configurações de política e informações de sessão, para o VDA durante o lançamento da sessão. Causas possíveis: Problemas de comunicação entre o controlador e o VDA, problemas encontrados pelo Broker Service ao criar uma solicitação de conjunto de configuração ou problemas de rede que resultam na não aceitação da solicitação pelo VDA. | - |
| [3] Nenhuma Capacidade Disponível | [21] Máximo de Instâncias Totais Excedido | O número máximo de instâncias de um aplicativo foi atingido. Nenhuma instância adicional do aplicativo pode ser aberta no VDA. Este problema está relacionado ao recurso de limites de aplicativo. | Considere aumentar a configuração do aplicativo, Limitar o número de instâncias em execução ao mesmo tempo, para um valor mais alto, se o licenciamento permitir. |
| [3] Nenhuma Capacidade Disponível | [22] Máximo de Instâncias por Usuário Excedido | O usuário está tentando abrir mais de uma instância de um aplicativo, mas o aplicativo está configurado para permitir apenas uma única instância do aplicativo por usuário. Este problema está relacionado ao recurso de limites de aplicativo. | Apenas uma instância do aplicativo é permitida por usuário por padrão. Se várias instâncias por usuário forem necessárias, considere desmarcar a configuração Limitar a uma instância por usuário na configuração do aplicativo. |
| [1] Falha de Conexão do Cliente | [23] Erro de Comunicação | O controlador de entrega tentou enviar informações ao VDA, como uma solicitação para se preparar para uma conexão, mas ocorreu um erro durante a tentativa de comunicação. Isso pode ser causado por interrupções de rede. | Se já iniciado, reinicie o serviço Desktop no VDA para reiniciar o processo de registro e verifique se o VDA se registra com sucesso. Confirme se os controladores de entrega configurados para o VDA estão precisos por meio dos detalhes no log de eventos do aplicativo. |
| [3] Nenhuma Capacidade Disponível | [100] Nenhuma Máquina Disponível O serviço de Monitoramento converte [12] Nenhum Desktop Disponível para este código de erro. | O VDA atribuído para iniciar a sessão está em um estado inválido ou indisponível. Causas possíveis: O estado de energia do VDA é desconhecido ou indisponível, o VDA não reiniciou desde a última sessão do usuário, o compartilhamento de sessão está desabilitado enquanto a sessão atual exige que ele seja habilitado, ou o VDA foi removido do grupo de entrega ou do site. | Verifique se o VDA está em um grupo de entrega. Caso contrário, adicione-o ao grupo de entrega apropriado. Verifique se há VDAs suficientes registrados e em estado pronto para poder iniciar o desktop compartilhado publicado ou o aplicativo solicitado pelo usuário. Verifique se o hypervisor que hospeda o VDA não está em modo de manutenção. |
| [2] Falha da Máquina | [101] Máquina Não Funcional. O serviço de Monitoramento converte [12] Nenhum Desktop Disponível para este código de erro. | O VDA não está operacional. Causas possíveis: O VDA foi removido do grupo de entrega, o VDA não está registrado, o estado de energia do VDA está indisponível ou o VDA está enfrentando problemas internos. | Verifique se o VDA está em um grupo de entrega. Caso contrário, adicione-o ao grupo de entrega apropriado. Verifique se o VDA aparece como ligado no Citrix Studio. Se o estado de energia for desconhecido para várias máquinas, resolva quaisquer problemas de conectividade com o hypervisor ou falhas de host. Verifique se o hypervisor que hospeda o VDA não está em modo de manutenção. Reinicie o VDA assim que esses problemas forem resolvidos. |
Tipo de falha da máquina
| Código de Erro | ID do Código de Erro | Problema | Ação |
|---|---|---|---|
| Desconhecido | - | - | - |
| Não Registrado | 3 | - | - |
| Capacidade Máxima (representada como Carga Máxima no Director) | 4 | A máquina está relatando que atingiu a capacidade máxima, ou seja, o Índice de Carga Máxima. | Verifique se todos os hipervisores estão ligados. Adicione mais máquinas aos Grupos de Entrega afetados, adicionando mais capacidade ao hipervisor ou adicionando mais hipervisores. |
| Travado na Inicialização | 2 | A VM não concluiu sua sequência de inicialização e não está se comunicando com o hipervisor. | Verifique se a VM inicializou com sucesso no hipervisor. Verifique outras mensagens na VM, como problemas do sistema operacional. Verifique se as ferramentas do hipervisor estão instaladas na VM. Verifique se o VDA está instalado na VM. |
| Falha ao Iniciar | 1 | A VM encontrou problemas ao tentar iniciar no hipervisor. | Verifique os logs do hipervisor. |
| Nenhum | 0 | - | - |
Motivo de cancelamento de registro da máquina (aplicável quando o tipo de falha é Não Registrado ou Desconhecido)
| Código de Erro | ID do Código de Erro | Problema | Ação |
|---|---|---|---|
| AgentShutdown | 0 | O VDA foi desligado de forma controlada. | Ligue o VDA se você não espera que ele esteja desligado com base nas políticas de gerenciamento de energia existentes. Revise quaisquer erros nos logs de eventos. |
| AgentSuspended | 1 | O VDA está em modo de hibernação ou suspensão. | Tire o VDA do modo de hibernação. Considere desabilitar a hibernação para VDAs do Citrix Virtual Apps and Desktops por meio das configurações de energia. |
| IncompatibleVersion | 100 | O VDA não consegue se comunicar com o delivery controller devido a uma incompatibilidade nas versões do protocolo Citrix. | Alinhe as versões do VDA e do delivery controller. |
| AgentAddressResolutionFailed | 101 | O delivery controller não conseguiu resolver o endereço IP do VDA. | Verifique se a conta de máquina do VDA existe no AD. Caso contrário, crie-a. Verifique se o nome e o endereço IP do VDA no DNS estão corretos. Caso contrário, corrija-os. Se for um problema generalizado, valide as configurações de DNS nos delivery controllers. Verifique a resolução de DNS a partir do controller executando o comando nslookup. |
| 101 | O delivery controller não conseguiu resolver o endereço IP do VDA. | Verifique se a conta de máquina do VDA existe no AD. Caso contrário, crie-a. Verifique se o nome e o endereço IP do VDA no DNS estão corretos. Caso contrário, corrija-os. | |
| AgentNotContactable | 102 | Ocorreu um problema de comunicação entre o delivery controller e o VDA. | Use um ping para verificar se o delivery controller e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou rede. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controller e o VDA. |
| 102 | Ocorreu um problema de comunicação entre o delivery controller e o VDA. | Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controller e o VDA. Entre em contato com o suporte da Citrix. | |
| AgentWrongActiveDirectoryOU | 103 | Ocorreu uma configuração incorreta de descoberta do Active Directory. A OU específica do site (onde as informações do controller do site são armazenadas no AD) configurada no registro do VDA é para um Site diferente. | Verifique se a configuração do Active Directory está correta ou verifique as configurações do registro. |
| EmptyRegistrationRequest | 104 | A solicitação de registro enviada do VDA para o delivery controller estava vazia. Isso pode ser devido a uma instalação de software VDA corrompida. | Reinicie o serviço Desktop no VDA para reiniciar o processo de registro e verifique se o VDA se registra corretamente por meio do log de eventos do aplicativo. |
| MissingRegistrationCapabilities | 105 | A versão do VDA não é compatível com o delivery controller. | Atualize o VDA ou remova o VDA e reinstale-o. |
| MissingAgentVersion | 106 | A versão do VDA não é compatível com o delivery controller. | Reinstale o software VDA se o problema estiver afetando todas as máquinas. |
| InconsistentRegistrationCapabilities | 107 | O VDA não consegue comunicar suas capacidades ao Broker. Isso pode ser devido à incompatibilidade entre as versões do VDA e do delivery controller. As capacidades de registro, que mudam a cada versão, são expressas em um formato que não corresponde à solicitação de registro. | Alinhe as versões do VDA e do delivery controller. |
| NotLicensedForFeature | 108 | O recurso que você está tentando usar não está licenciado. | Verifique sua edição de licenciamento Citrix ou remova o VDA e reinstale-o. |
| 108 | O recurso que você está tentando usar não está licenciado. | Entre em contato com o suporte da Citrix. | |
| UnsupportedCredentialSecurity version | 109 | O VDA e o delivery controller não estão usando o mesmo mecanismo de criptografia. | Alinhe as versões do VDA e do delivery controller. |
| InvalidRegistrationRequest | 110 | O VDA fez uma solicitação de registro ao Broker, mas o conteúdo da solicitação está corrompido ou é inválido. | Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controller e o VDA. |
| SingleMultiSessionMismatch | 111 | O tipo de sistema operacional do VDA não é compatível com o catálogo de máquinas ou grupo de entrega. | Adicione o VDA ao tipo de catálogo de máquinas ou grupo de entrega correto que contenha máquinas com o mesmo sistema operacional. |
| FunctionalLevelTooLowForCatalog | 112 | O catálogo de máquinas está configurado para um nível funcional de VDA superior à versão do VDA instalada. | Verifique se o nível funcional do catálogo de máquinas do VDA corresponde ao do VDA. Atualize ou faça downgrade do catálogo de máquinas para corresponder ao do VDA. |
| FunctionalLevelTooLowForDesktopGroup | 113 | O grupo de entrega está configurado para um nível funcional de VDA superior à versão do VDA instalada. | Verifique se o nível funcional do grupo de entrega do VDA corresponde ao do VDA. Atualize ou faça downgrade do catálogo de máquinas para corresponder ao do VDA. |
| PowerOff | 200 | O VDA não foi desligado de forma controlada. | Se o VDA deveria estar ligado, tente iniciar o VDA a partir do Citrix Studio e verifique se ele inicializa e se registra corretamente. Solucione quaisquer problemas de inicialização ou registro. Revise os logs de eventos no VDA assim que ele estiver novamente ativo para ajudar a determinar a causa raiz do desligamento. |
| AgentRejectedSettingsUpdate | 203 | Configurações como políticas Citrix foram alteradas ou atualizadas, mas houve um erro ao enviar as atualizações para o VDA. Isso pode ocorrer se as atualizações forem incompatíveis com a versão do VDA instalada. | Atualize o VDA, se necessário. Verifique se as atualizações aplicadas são compatíveis com a versão do VDA. |
| SessionPrepareFailure | 206 | O Broker não concluiu uma auditoria das sessões em execução no VDA. | Se for um problema generalizado, reinicie o Serviço Citrix Broker no delivery controller. |
| 206 | O Broker não concluiu uma auditoria das sessões em execução no VDA. | Entre em contato com o suporte da Citrix. | |
| ContactLost | 207 | O delivery controller perdeu a conexão com o VDA. Isso pode ser causado por interrupções de rede. | Verifique se o Serviço Citrix Broker está em execução no delivery controller e se o serviço Desktop está em execução no VDA. Inicie cada um, se estiverem parados. Se já estiverem iniciados, reinicie o serviço Desktop no VDA para reiniciar o processo de registro e verifique se o VDA se registra com sucesso. Confirme se os delivery controllers configurados para o VDA estão corretos por meio dos detalhes no log de eventos do aplicativo. Use um ping para verificar se o delivery controller e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou rede. |
| 207 | O delivery controller perdeu a conexão com o VDA. Isso pode ser causado por interrupções de rede. | Verifique se o serviço Desktop está em execução no VDA. Inicie-o se estiver parado. | |
| BrokerRegistrationLimitReached | 301 | O delivery controller atingiu o número máximo configurado de VDAs que podem se registrar simultaneamente. Por padrão, o delivery controller permite 10.000 registros simultâneos de VDA. | Considere adicionar delivery controllers ao Site ou criar um Site. Você também pode aumentar o número de VDAs permitidos para se registrar simultaneamente com o delivery controller por meio da chave de registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Consulte o artigo da Central de Conhecimento, Registry Key Entries Used by Citrix Virtual Apps and Desktops (CTX117446) para obter mais informações. Aumentar esse número pode exigir mais recursos de CPU e memória para o controller. |
| SettingsCreationFailure | 208 | O Broker não construiu um conjunto de configurações para enviar ao VDA. Se o Broker não conseguir coletar os dados, o registro falha e o VDA se torna não registrado. | Verifique os logs de eventos no delivery controller em busca de erros. Reinicie o Serviço Broker se um problema específico não for evidente nos logs. Assim que o Serviço Broker for reiniciado, reinicie o serviço Desktop nos VDAs afetados e verifique se eles se registram com sucesso. |
| 208 | O Broker não construiu um conjunto de configurações para enviar ao VDA. Se o Broker não conseguir coletar os dados, o registro falha e o VDA se torna não registrado. | Reinicie o serviço Desktop nos VDAs afetados e verifique se eles se registram com sucesso. Entre em contato com o suporte da Citrix. | |
| SendSettingsFailure | 204 | O Broker não enviou dados de configurações para o VDA. Se o Broker conseguir coletar os dados, mas não conseguir enviá-los, o registro falha. | Se limitado a um único VDA, reinicie o serviço Desktop no VDA para forçar o novo registro e valide se o VDA se registra com sucesso por meio do log de eventos do aplicativo. Solucione quaisquer erros observados. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controller e o VDA. |
| AgentRequested | 2 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| DesktopRestart | 201 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| DesktopRemoved | 202 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| SessionAuditFailure | 205 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| UnknownError | 300 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| RegistrationStateMismatch | 302 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| Unknown | - | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
Motivos de falha e solução de problemas do Citrix Director
Copiado!
Falha!