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 pode determinar o motivo da falha de início ou conexão relatada a partir das informações compartilhadas pelo serviço Broker. | Colete os logs CDF no controlador e entre em contato com o suporte da Citrix. |
| [0] Nenhum | [1] Nenhum | Nenhum | N/A |
| [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 experimentados pelo Serviço Broker ao criar uma solicitação de preparação ou problemas de rede resultando 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 Serviço Broker da 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 estiver parado. |
| [1] ClientConnectionFailure | [4] ConnectionTimeout | O cliente não se conectou ao VDA depois que o VDA foi preparado para o início 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 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] ClientConnectionFailure | [6] Ticketing | 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 início é preparado pelo Broker e entregue no arquivo ICA®. Quando o usuário tenta iniciar uma sessão, o VDA valida o ticket de início 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 este é um problema isolado. Se o problema ocorrer novamente, revise os logs de eventos do dispositivo cliente para erros. Verifique se o VDA ao qual o usuário está tentando se conectar está registrado. Se não registrado, revise os logs de eventos no VDA e resolva quaisquer problemas de registro. |
| [1] ClientConnectionFailure | [7] Other | Uma sessão foi relatada como encerrada a partir do 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 início. Tente reiniciar a sessão; se o problema persistir, colete os logs CDF e entre em contato com o suporte da Citrix. |
| [1] ClientConnectionFailure | [8] GeneralFail | A sessão falhou ao iniciar. Causas possíveis: Um início intermediado foi solicitado enquanto o broker ainda estava iniciando ou inicializando, ou erro interno durante a fase de intermediação de um início. | Verifique se o Serviço Broker da Citrix está em execução e tente iniciar a sessão novamente. |
| [5] Configuration | [9] MaintenanceMode | O VDA, ou o grupo de entrega ao qual o VDA pertence, está definido em 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] Configuration | [10] ApplicationDisabled | O aplicativo não pode ser acessado pelos usuários finais porque foi desabilitado pelo administrador. | Se o aplicativo for destinado a estar disponível para uso em produção, habilite o aplicativo e instrua o usuário a reconectar. |
| [4] NoLicensesAvailable | [11] LicenseFeature Refused | 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 que são cobertos pela edição e tipo de licença do Citrix Virtual Apps and Desktops™ existente. |
| [3] NoCapacityAvailable | [13] SessionLimitReached | 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 de política da 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] Configuration | [14] DisallowedProtocol | 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] Configuration | [15] ResourceUnavailable | 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 em 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 múltiplas sessões estão com carga total. Se sim, provisione mais VDAs de SO de múltiplas 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] Configuration | [16] ActiveSessionReconnectDisabled | 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] MachineFailure | [17] NoSessionToReconnect | O cliente tentou reconectar a uma sessão específica, mas a sessão foi encerrada. | Tente novamente a reconexão do controle de workspace. |
| [2] MachineFailure | [18] SpinUpFailed | O VDA não pode ser ligado para o início 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. Se não, verifique se a máquina está atribuída a um Personal vDisk, faça login no hypervisor para redefinir a VM. |
| [2] MachineFailure | [19] Refused | O controlador de entrega envia uma solicitação ao VDA para preparar 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. Se não, resolva quaisquer problemas de firewall ou roteamento de rede. |
| [2] MachineFailure | [20] ConfigurationSet Failure | 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 início da sessão. Causas possíveis: Problemas de comunicação entre o controlador e o VDA, problemas experimentados pelo Serviço Broker ao criar uma solicitação de conjunto de configuração ou problemas de rede resultando na não aceitação da solicitação pelo VDA. | - |
| [3] NoCapacityAvailable | [21] MaxTotalInstancesExceeded | 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. Este problema está relacionado ao recurso de limites de aplicativo. | Apenas uma instância do aplicativo é permitida por usuário por padrão. Se múltiplas 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] ClientConnectionFailure | [23] Communication error | O controlador de entrega tentou enviar informações ao 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 controladores de entrega 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. Se não, adicione-o ao grupo de entrega apropriado. Verifique se há VDAs suficientes registrados e em estado pronto para poder iniciar o desktop ou aplicativo compartilhado publicado solicitado pelo usuário. Verifique se o hypervisor 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. Se não, 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ãoRegistrado | 3 | - | - |
| CapacidadeMáxima (representada 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 hypervisors estejam ligados. Adicione mais máquinas aos Grupos de Entrega afetados, adicionando mais capacidade ao hypervisor ou adicionando mais hypervisors. |
| PresoNaInicialização | 2 | A VM não concluiu sua sequência de inicialização e não está se comunicando com o hypervisor. | Certifique-se de que a VM inicializou com sucesso no hypervisor. Verifique outras mensagens na VM, como problemas de SO. Certifique-se de que as ferramentas do hypervisor estejam instaladas na VM. Certifique-se de que o VDA esteja instalado na VM. |
| FalhaAoIniciar | 1 | A VM experimentou problemas ao tentar iniciar no hypervisor. | Verifique os logs do hypervisor. |
| Nenhum | 0 | - | - |
Motivo de desregistro 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 |
|---|---|---|---|
| DesligamentoDoAgente | 0 | O VDA experimentou um desligamento elegante. | 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. |
| AgenteSuspenso | 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 via configurações de energia. |
| VersãoIncompatível | 100 | O VDA não pode se comunicar com o controlador de entrega devido a uma incompatibilidade nas versões do protocolo Citrix. | Alinhe as versões do VDA e do controlador de entrega. |
| FalhaNaResoluçãoDeEndereçoDoAgente | 101 | O controlador de entrega não conseguiu resolver o endereço IP do VDA. | Verifique se a conta de máquina do VDA existe no AD. Se não, crie-a. Verifique se o nome e o endereço IP do VDA no DNS estão corretos. Se não, corrija-os. Se generalizado, valide as configurações de DNS nos controladores de entrega. Verifique a resolução de DNS a partir do controlador executando o comando nslookup. |
| 101 | O controlador de entrega não conseguiu resolver o endereço IP do VDA. | Verifique se a conta de máquina do VDA existe no AD. Se não, crie-a. Verifique se o nome e o endereço IP do VDA no DNS estão corretos. Se não, corrija-os. | |
| AgenteNãoContactável | 102 | Ocorreu um problema de comunicação entre o controlador de entrega e o VDA. | Use um ping para verificar se o controlador de entrega e o VDA podem se comunicar com sucesso. Se não, resolva quaisquer problemas de firewall ou rede. 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. |
| 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, 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. Entre em contato com o suporte da Citrix. | |
| OUDoActiveDirectoryDoAgenteIncorreta | 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. |
| SolicitaçãoDeRegistroVazia | 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 via log de eventos do aplicativo. |
| CapacidadesDeRegistroAusentes | 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. |
| VersãoDoAgenteAusente | 106 | A versão do VDA não é compatível com o controlador de entrega. | Reinstale o software VDA se o problema estiver afetando todas as máquinas. |
| CapacidadesDeRegistroInconsistentes | 107 | O VDA não pode comunicar suas capacidades ao Broker. Isso pode ser devido a incompatibilidade entre as versões do VDA e do controlador de entrega. 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 controlador de entrega. |
| NãoLicenciadoParaRecurso | 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ãoDeSegurançaDeCredencialNãoSuportada | 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çãoDeRegistroInvá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. |
| IncompatibilidadeDeSessãoÚnicaMú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 correto ou grupo de entrega contendo máquinas com o mesmo sistema operacional. |
| NívelFuncionalMuitoBaixoParaCatálogo | 112 | O catálogo de máquinas está definido para um nível funcional de VDA mais alto do que a 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. |
| NívelFuncionalMuitoBaixoParaGrupoDeDesktop | 113 | O grupo de entrega está definido para um nível funcional de VDA mais alto do que a 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. |
| Desligar | 200 | O VDA não foi desligado de forma elegante. | 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 online para ajudar a determinar a causa raiz do desligamento. |
| AgenteRejeitouAtualizaçãoDeConfigurações | 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. Revise se as atualizações aplicadas são suportadas pela versão do VDA. |
| FalhaNaPreparaçãoDaSessão | 206 | O Broker não concluiu uma auditoria das sessões em execução no VDA. | Se generalizado, reinicie o Serviço Broker da 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. | |
| ContatoPerdido | 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 Broker da 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 estiver parado. 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 corretos por meio 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. Se não, 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. | |
| LimiteDeRegistroDoBrokerAtingido | 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 por meio 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. |
| FalhaNaCriaçãoDeConfigurações | 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 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 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. | |
| FalhaNoEnvioDeConfigurações | 204 | O Broker não enviou dados de configurações para o VDA. Se o Broker puder 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 via 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. |
| AgenteSolicitado | 2 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| ReinicializaçãoDoDesktop | 201 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| DesktopRemovido | 202 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| FalhaNaAuditoriaDeSessão | 205 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| ErroDesconhecido | 300 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| IncompatibilidadeDeEstadoDeRegistro | 302 | Ocorreu um erro desconhecido. | Entre em contato com o suporte da Citrix. |
| Desconhecido | - | 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!