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 Enums, códigos de erro e descrições.
Erros de falha de conexão
| Categoria | Motivo | Problema | Ação |
|---|---|---|---|
| N/D | [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 logs CDF no controlador e entre em contato com o suporte da Citrix. |
| [0] Nenhum | [1] Nenhum | Nenhum | N/D |
| [2] MachineFailure | [2] SessionPreparation | A solicitação de preparação de 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 Serviço de Broker 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] MachineFailure | [3] RegistrationTimeout | 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 estiver parado. |
| [1] ClientConnectionFailure | [4] ConnectionTimeout | 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 o cliente se conectar ao 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 para quaisquer erros. Resolva quaisquer problemas de conectividade de rede entre o cliente e o VDA. |
| [4] NoLicensesAvailable | [5] Licensing | 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 na Conexão do Cliente | [6] Emissão de Tickets | Ocorreu uma falha durante a emissão de tickets, indicando que a conexão do cliente com o VDA não corresponde à solicitação intermediada. Um ticket de solicitação de inicialização é preparado pelo Broker e entregue no arquivo ICA®. Quando o usuário tenta iniciar uma sessão, o VDA valida o ticket de inicialização 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 reiniciar o aplicativo ou desktop para determinar se é 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 na 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 completar a sequência de conexão. | Verifique se a sessão não foi encerrada pelo usuário antes do lançamento. Tente reiniciar a sessão; se o problema persistir, colete os logs CDF e entre em contato com o suporte da Citrix. |
| [1] Falha na Conexão do Cliente | [8] Falha Geral | A sessão falhou ao iniciar. Causas possíveis: Uma inicialização intermediada foi solicitada enquanto o broker ainda estava iniciando ou inicializando, ou um erro interno durante a fase de intermediação de uma inicialização. | Verifique se o Serviço de Broker da Citrix está em execução e tente iniciar a sessão novamente. |
| [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 reconectar. |
| [5] Configuração | [10] AplicativoDesabilitado | O aplicativo não pode ser acessado pelos usuários finais porque foi desabilitado pelo administrador. | Se o aplicativo for destinado a uso em produção, habilite o aplicativo e instrua o usuário a reconectar. |
| [4] SemLicençasDisponíveis | [11] RecursoDeLicençaRecusado | O recurso em uso 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] SemCapacidadeDisponível | [13] LimiteDeSessõesAtingido | 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 múltiplas 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 Citrix para permitir mais sessões por VDA de servidor. Considere adicionar mais VDAs de SO de múltiplas sessões. Considere adicionar mais VDAs de SO de sessão única. |
| [5] Configuração | [14] ProtocoloNãoPermitido | Os protocolos ICA e RDP não são permitidos. | Execute o comando PowerShell Get-BrokerAccessPolicyRule no delivery controller 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] RecursoIndisponí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 no modo de manutenção. Determine se os VDAs de SO multi-sessão estão com carga total. Se sim, provisione mais VDAs de SO multi-sessão. 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ãoDeSessãoAtivaDesabilitada | 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 consegue se conectar à sessão ativa. | No delivery controller, 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] FalhaNaMáquina | [17] NenhumaSessãoParaReconectar | 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 ao Iniciar | O VDA não pode ser ligado para o lançamento da sessão. Este é um problema relatado pelo hipervisor. | 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 hipervisor. 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 hipervisor 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ções | 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 Serviço de Broker ao criar uma solicitação de conjunto de configurações, 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] NoCapacityAvailable | [22] MaxPerUserInstancesExceeded | 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. Esse problema está relacionado ao recurso de limites de aplicativo. | Apenas uma instância do aplicativo é permitida por usuário por padrão. Se forem necessárias várias instâncias por usuário, considere desmarcar a configuração Limitar a uma instância por usuário nas configurações do aplicativo. |
| [1] ClientConnectionFailure | [23] Erro de comunicação | O Delivery Controller tentou enviar informações para o VDA, como uma solicitação para preparar 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 Delivery Controllers configurados para o VDA estão corretos por meio dos detalhes no log de eventos do aplicativo. |
| [3] NoCapacityAvailable | [100] NoMachineAvailable O serviço de monitoramento converte [12] NoDesktopAvailable 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 esteja 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 iniciar o desktop compartilhado publicado ou o aplicativo solicitado pelo usuário. Verifique se o hipervisor que hospeda o VDA não está em modo de manutenção. |
| [2] MachineFailure | [101] MachineNotFunctional. O serviço de monitoramento converte [12] NoDesktopAvailable 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 está não 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 hipervisor ou falhas do host. Verifique se o hipervisor 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 | - | - |
| MaxCapacity (representado como Carga Máxima no Director) | 4 | A máquina está se reportando com capacidade máxima, ou seja, Índice de Carga Máxima | Certifique-se de que todos os hipervisores estejam ligados. Adicione mais máquinas aos Grupos de Entrega afetados, adicionando mais capacidade ao hipervisor ou adicionando mais hipervisores. |
| PresoNaInicialização | 2 | A VM não concluiu sua sequência de inicialização e não está se comunicando com o hipervisor. | Certifique-se de que a VM inicializou com sucesso no hipervisor. Verifique outras mensagens na VM, como problemas de SO. Certifique-se de que as ferramentas do hipervisor estejam instaladas na VM. Certifique-se de que o VDA esteja instalado na VM. |
| FalhaAoIniciar | 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 passou por um desligamento normal. | 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 através 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 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 conseguem 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 controlador de entrega 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 controlador 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 controlador do site são armazenadas no AD) configurada no registro do VDA é para um Site diferente. | Certifique-se de que a configuração do Active Directory esteja correta, ou verifique as configurações do registro. |
| EmptyRegistrationRequest | 104 | A solicitação de registro enviada do VDA para o controlador de entrega 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 através do log de eventos do aplicativo. |
| MissingRegistrationCapabilities | 105 | A versão do VDA não é compatível com o controlador de entrega. | 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. | |
| Versão de segurança de credencial não suportada | 109 | O VDA e o controlador de entrega não estão usando o mesmo mecanismo de criptografia. | Alinhe as versões do VDA e do controlador de entrega. |
| Solicitação de Registro Inválida | 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, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controlador e o VDA. |
| Incompatibilidade de Sessão Única/Múltipla | 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. |
| Nível Funcional Muito Baixo Para o Catálogo | 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 corretamente. | 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 generalizado, reinicie o Serviço de Broker Citrix no controlador de entrega. |
| 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 controlador de entrega perdeu a conexão com o VDA. Isso pode ser causado por interrupções de rede. | Verifique se o Serviço de Broker Citrix 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. 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 controladores de entrega configurados para o VDA estão corretos através dos detalhes no log de eventos do Aplicativo. Use um ping para verificar se o controlador de entrega e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou rede. |
| 207 | O controlador de entrega 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 controlador de entrega atingiu o número máximo configurado de VDAs que podem se registrar simultaneamente com ele. Por padrão, o controlador de entrega permite 10.000 registros de VDA simultâneos. | Considere adicionar controladores de entrega ao Site ou criar um Site. Você também pode aumentar o número de VDAs permitidos para se registrar simultaneamente com o controlador de entrega através da chave de registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Consulte o artigo da Central de Conhecimento, Entradas de Chave de Registro Usadas pelo 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 controlador. |
| 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 falhará e o VDA ficará não registrado. | Verifique os logs de eventos no controlador de entrega para quaisquer erros. Reinicie o Serviço Broker se um problema específico não for evidente nos logs. Uma vez que o Serviço Broker seja 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 falhará e o VDA ficará 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 as configurações e dados de configuração para o VDA. Se o Broker conseguir coletar os dados, mas não conseguir enviá-los, o registro falhará. | Se limitado a um único VDA, reinicie o serviço Desktop no VDA para forçar o recadastro e valide se o VDA se registra com sucesso através 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, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controlador 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!