Solução de Problemas de Conexão do Citrix
O recurso Solução de Problemas de Conexão do Citrix foi projetado para capacitar os usuários finais a solucionar problemas potenciais de falhas no lançamento de desktops ou aplicativos de forma eficaz por conta própria. Este aprimoramento visa fornecer aos usuários diagnósticos claros, recomendações potenciais e a capacidade de executar correções com um simples clique.
Visão Geral
-
O Citrix agora fornece mensagens de erro mais detalhadas e aprimoradas para ajudar os usuários a entender claramente a causa raiz das falhas de lançamento. O recurso Solução de Problemas de Conexão realiza análises em tempo real dos desafios de acessibilidade ao Virtual Delivery Agent (VDA) durante o processo de lançamento. Em seguida, ele apresenta mensagens de erro e recomendações amigáveis ao usuário, permitindo que os usuários resolvam o problema diretamente ou coletem logs para um tíquete de suporte, se necessário.
-
Caminhos de conexão analisados
O recurso diagnostica problemas potenciais de lançamento de aplicativos e desktops virtuais em pontos de conexão críticos, incluindo:
- Conectividade de rede do Cliente para o Gateway.
- Conexão do Gateway para o servidor StoreFront.
- Conexão do servidor StoreFront para o Broker.
-
Conexão do Broker para o VDA.
-
Mensagens de erro e diagnósticos aprimorados
-
Em caso de falhas de lançamento, o Citrix agora exibe mensagens de erro claras e amigáveis ao usuário que identificam problemas de conexão específicos, como erros de rede, indisponibilidade do servidor ou falhas do VDA. Para administradores, códigos de erro detalhados são fornecidos nos logs, categorizados em erros do lado do servidor e do lado do cliente, servindo como referências valiosas para uma investigação mais aprofundada.
-
Ações de autorrecuperação e correção
O recurso Solução de Problemas de Conexão do Citrix inclui etapas que os usuários podem seguir para se recuperar automaticamente de problemas comuns, minimizando assim a necessidade de intervenção do suporte. A seguir estão os problemas potenciais que podem ser resolvidos com correção guiada:
- Reiniciar o VDA
- Reiniciar o aplicativo Citrix Workspace (CWA) - Fazer login novamente no CWA
- Atualizar a lista de recursos
- Atualizar o aplicativo e tentar novamente
- Reconfigurar a loja
- Atualizar o CWA
- Reinstalar o CWA
- Verificar a rede
- Aguardar e tentar novamente
Requisitos do sistema
Para usar o recurso Solução de Problemas de Conexão, tenha as seguintes versões do aplicativo Citrix Workspace:
- Citrix Workspace app para Mac: Versão 2505 e posterior
- Citrix Workspace app para Windows: Versão 2507 e posterior
- Citrix Workspace app para iOS: Versão 2509 e posterior
- Citrix Workspace app para Android: Versão 2509 e posterior
Como usar
O recurso de Solução de Problemas de Conexão é habilitado por padrão para ambientes Citrix DaaS. Mensagens de erro granulares e aprimoradas, juntamente com recomendações de correção, são fornecidas tanto para sessões iniciadas pelo navegador quanto para sessões iniciadas diretamente pelo aplicativo nativo Citrix Workspace.
Considerações importantes
Embora o recurso ofereça recursos robustos de autoatendimento, é importante observar o seguinte:
- A ação de correção “Reiniciar VDA” não oferece suporte a sessões iniciadas por meio de um modo de inicialização híbrido (ou seja, baixar um arquivo ICA de um navegador e, em seguida, iniciá-lo com o aplicativo nativo Citrix Workspace).
Códigos de erro
Os códigos de erro são divididos entre erros do lado do servidor e erros do lado do cliente. A seguir, estão as tabelas com os códigos de erro.
Erros comuns do lado do servidor
| Error ID | Descrição | Recomendação |
|---|---|---|
ResourceNotFound |
O recurso foi removido pelo seu administrador. | Para uma lista atualizada de aplicativos e desktops disponíveis, atualize o aplicativo Citrix Workspace ou faça logoff e login novamente. |
WorkstationInMaintenance |
O desktop está em manutenção planejada. | Aguarde até que a manutenção seja concluída e tente novamente. |
UnavailableDesktop |
Não há desktops disponíveis para conexão. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
UnavailableAppProtectedDesktop |
Proteção de Aplicativo necessária para abrir recursos protegidos. | Atualize para uma versão do aplicativo Citrix Workspace com Proteção de Aplicativo ou entre em contato com o administrador do sistema para obter assistência. |
NotLicensed |
Não é possível iniciar o recurso porque o servidor não possui a licença apropriada. | Entre em contato com o administrador do sistema para obter assistência. |
NoMoreActiveSessions |
Não é possível iniciar o recurso porque não há slots de sessão disponíveis. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
GeneralAppLaunchError |
Ocorreu um erro desconhecido ao tentar abrir o recurso. | Entre em contato com o administrador do sistema para obter assistência. |
ResourceDisabled |
Seu administrador desabilitou o recurso. | Para uma lista atualizada de aplicativos e desktops disponíveis, atualize o aplicativo Citrix Workspace ou faça logoff e login novamente. |
Aplicativo Citrix Workspace para Windows
| Error ID | Descrição | Recomendação |
|---|---|---|
CertificateError |
Ocorreu um erro com o certificado do servidor. | Entre em contato com o administrador do sistema para obter assistência. |
PassthroughClientError |
Já existe uma sessão ativa. | Entre em contato com o administrador do sistema para obter assistência. |
IcaFileRetrieveError |
Ocorreu um erro ao tentar recuperar o arquivo ICA. | Entre em contato com o administrador do sistema para obter assistência. |
Icafileretrieveerrorreconnection |
Ocorreu um erro ao tentar recuperar o arquivo ICA durante a reconexão. | Entre em contato com o administrador do sistema para obter assistência. |
NoCWA |
Aplicativo Citrix Workspace necessário para abrir recursos. | Instale o aplicativo Citrix Workspace ou entre em contato com o administrador do sistema para obter assistência. |
CouldNotFindStore |
Não é possível recuperar a configuração de loja necessária para iniciar o recurso. | Remova a loja do Citrix Workspace e adicione-a novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
noclientinstalled |
Não é possível recuperar as informações necessárias para iniciar o recurso. | Atualize o aplicativo Citrix Workspace ou faça logoff e login novamente. |
AuthCancelled |
A sessão de autenticação expirou. | Para tentar resolver o problema, reautentique-se no Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
IcaFileLaunchError |
Ocorreu um erro ao tentar iniciar o arquivo ICA. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CouldNotContactStore |
Ocorreu um erro ao tentar se comunicar com o VDA. Isso pode ser devido a um problema de conexão com o servidor. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CCMError |
Não é possível iniciar o recurso devido a um erro do Gerenciador de Conexão. Código de erro: {errorCodeValue} | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CCMInitFailed |
Não é possível iniciar o recurso porque o Gerenciador de Conexão falhou ao inicializar. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CCMLoadFailed |
Não é possível iniciar o recurso porque o Gerenciador de Conexão falhou ao carregar. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
InvalidIcaParams |
Não é possível iniciar o recurso devido a parâmetros ICA incorretos. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
AppExiting |
Não é possível iniciar o recurso porque o aplicativo Citrix Workspace está sendo encerrado. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
UTF8ConversionFailed |
Não é possível analisar o arquivo ICA. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
MissingSoftware |
Você precisa de software adicional para usar este aplicativo. | Entre em contato com o administrador do sistema para obter assistência. |
Aplicativo Citrix Workspace para Mac
| Error ID | Descrição | Recomendação |
|---|---|---|
AuthCancelled |
A sessão de autenticação expirou. | Para tentar resolver o problema, primeiro autentique-se com suas credenciais. Se o problema persistir, entre em contato com o administrador do sistema. |
NetworkError |
Não é possível iniciar o recurso devido a um problema de conexão de rede. | Verifique sua conexão e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
ViewerNotFound |
O caminho do Citrix Viewer não pode ser encontrado. | Para tentar resolver o problema, desinstale e reinstale o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
ViewerOpenEventFailed |
O Citrix Viewer falhou ao criar um evento. | Tente iniciar o recurso de sua loja novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
ViewerLaunchTimeout |
O lançamento do Citrix Viewer atingiu o tempo limite. | Tente iniciar o recurso de sua loja novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
ViewerLaunchFailure |
O Citrix Viewer falhou ao iniciar. | Tente iniciar o recurso de sua loja novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
InvalidICAFile |
Não é possível iniciar o recurso porque o arquivo ICA é inválido. | Tente iniciar o recurso de sua loja novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
CertificateError |
Ocorreu um erro com o certificado do servidor. | Entre em contato com o administrador do sistema para obter assistência. |
ResourceError |
Ocorreu um erro ao tentar iniciar o recurso. Isso pode ser devido a um problema de conexão com o servidor. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
UnknownError |
Ocorreu um erro desconhecido ao tentar abrir o recurso. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
Aplicativo Citrix Workspace para iOS
| Error ID | Descrição | Recomendação |
|---|---|---|
credentialsMustChange |
Sua senha deve ser alterada. | Vá para as configurações da sua conta para alterar sua senha. Se o problema persistir, entre em contato com o administrador do sistema. |
noConfigurationFile |
Não é possível recuperar os dados de configuração necessários. | Para tentar resolver o problema, remova a loja do Citrix Workspace e adicione-a novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
http404Error |
Os recursos estão indisponíveis. | Entre em contato com o administrador do sistema para obter assistência. |
invalidTransactionId |
ID de transação inválido. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
credentialsExpired |
Sua senha expirou. | Vá para as configurações da sua conta para alterar sua senha. Se o problema persistir, entre em contato com o administrador do sistema. |
badAddressError |
Não foi possível encontrar o endereço do recurso. | Verifique sua conexão e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
accountDisabled |
Sua conta está desabilitada. | Entre em contato com o administrador do sistema para obter assistência. |
accountLockedOut |
Sua conta está temporariamente bloqueada. | Entre em contato com o administrador do sistema para obter assistência. |
storeServerConnectionError |
Ocorreu um erro ao tentar se comunicar com o servidor. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
internalServerError |
Ocorreu um erro desconhecido ao tentar se conectar com o servidor. | Entre em contato com o administrador do sistema para obter assistência. |
invalidXML |
Não foi possível abrir o recurso devido a um erro do serviço XML. | Entre em contato com o administrador do sistema para obter assistência. |
badCredentials |
Suas credenciais expiraram. | Para tentar resolver o problema, saia do Citrix Workspace e faça login novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
appRemoved |
O recurso foi removido ou desabilitado pelo seu administrador. | Para obter uma lista atualizada de aplicativos e áreas de trabalho disponíveis, atualize o aplicativo Citrix Workspace ou saia e faça login novamente. |
invalidLogonHours |
Não foi possível fazer login neste momento devido a restrições definidas pelo seu administrador. | Tente novamente durante o horário comercial normal. Se o problema persistir, entre em contato com o administrador do sistema. |
connectionError |
Não foi possível conectar-se ao servidor. Isso pode ser devido a um problema de conexão de rede. | Para tentar resolver o problema, feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
Aplicativo Citrix Workspace para Android
| Error ID | Description | Recommendation |
|---|---|---|
http404Error |
Não foi possível iniciar o recurso devido a um problema de conexão de rede. | Verifique sua conexão e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
couldNotConnectToWorkstation |
Não foi possível conectar-se à área de trabalho. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
retryReasonRebooting |
Ocorreu um erro ao iniciar o recurso. A estação de trabalho solicitada está reiniciando. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
retryReasonResuming |
Ocorreu um erro ao iniciar o recurso. A estação de trabalho solicitada está sendo retomada. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
generalProblem |
Algo deu errado ao tentar abrir o recurso. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
retryReasonUnknown |
Ocorreu um erro no arquivo ICA. | Feche e reabra o Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
appRemoved |
O recurso foi removido ou desabilitado pelo seu administrador. | Para obter uma lista atualizada de aplicativos e áreas de trabalho disponíveis, atualize o aplicativo Citrix Workspace ou saia e faça login. |
resourceError |
Ocorreu um erro ao tentar iniciar o arquivo ICA. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. Reinicie o VDA se for uma máquina dedicada. |
resourceUnavailable |
Ocorreu um erro ao tentar iniciar o arquivo ICA. | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o administrador do sistema. Reinicie o VDA se for uma máquina dedicada. |
Solução de Problemas de Conexão do Citrix
Copiado!
Falha!