Citrix Solução de Problemas de Conexão
O recurso Citrix Solução de Problemas de Conexão foi projetado para capacitar os usuários finais a solucionar problemas potenciais de falhas de inicialização de desktops ou aplicativos de forma eficaz. 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
A Citrix agora oferece mensagens de erro mais granulares e aprimoradas para ajudar os usuários a entender claramente a causa raiz das falhas de inicialização. O recurso Solução de Problemas de Conexão realiza uma análise em tempo real dos desafios de acessibilidade ao Virtual Delivery Agent (VDA) durante o processo de inicialização. 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 possíveis problemas de inicialização 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 com o servidor StoreFront.
- Conexão do servidor StoreFront com o Broker.
- Conexão do Broker com o VDA.
Mensagens de erro e diagnósticos aprimorados
Em caso de falhas de inicialização, a 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 remediação
O recurso Citrix Solução de Problemas de Conexão 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 remediação guiada:
- Reiniciar 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 Solucionar Problemas de Conexão, tenha as seguintes versões do aplicativo Citrix Workspace:
- Aplicativo Citrix Workspace para Mac: Versão 2505 e posterior
- Aplicativo Citrix Workspace para Windows: Versão 2507 e posterior
- Aplicativo Citrix Workspace para iOS: Versão 2509 e posterior
- Aplicativo Citrix Workspace para Android: Versão 2509 e posterior
Como usar
O recurso Solução de Problemas de Conexão é ativado 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 depois 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
| ID do Erro | 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 desativou o recurso. | Para obter 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
| ID do erro | 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 |
O 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 foi possível recuperar a configuração de armazenamento necessária para iniciar o recurso. | Remova o armazenamento do aplicativo Citrix Workspace e adicione-o novamente. Se o problema persistir, entre em contato com o administrador do sistema. |
noclientinstalled |
Não foi 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 aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
IcaFileLaunchError |
Ocorreu um erro ao tentar iniciar o arquivo ICA. | Saia e reabra o aplicativo 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. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CCMError |
Não foi possível iniciar o recurso devido a um erro do Connection Manager. Código de erro: {errorCodeValue} | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CCMInitFailed |
Não foi possível iniciar o recurso porque o Connection Manager falhou ao inicializar. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
CCMLoadFailed |
Não foi possível iniciar o recurso porque o Gerenciador de Conexões falhou ao carregar. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
InvalidIcaParams |
Não foi possível iniciar o recurso devido a parâmetros ICA incorretos. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
AppExiting |
Não foi possível iniciar o recurso porque o aplicativo Citrix Workspace está sendo encerrado. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
UTF8ConversionFailed |
Não foi possível analisar o arquivo ICA. | Saia e reabra o aplicativo 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
| ID do Erro | Descrição | Recomendação |
|---|---|---|
AuthCancelled |
A sessão de autenticação expirou. | Para tentar resolver o problema, primeiro autenticar com suas credenciais. Se o problema persistir, entre em contato com o administrador do sistema. |
NetworkError |
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. |
ViewerNotFound |
O caminho do Citrix Viewer não pode ser encontrado. | Para tentar resolver o problema, desinstale e reinstale o aplicativo 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 foi 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
| ID do erro | 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 foi possível recuperar os dados de configuração necessários. | Para tentar resolver o problema, remova a loja do aplicativo 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á desativada. | 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 ao 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 aplicativo 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 desativado 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. |
invalidLogonHours |
Não é 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 é 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 aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
Aplicativo Citrix Workspace para Android
| ID do Erro | Descrição | Recomendação |
|---|---|---|
http404Error |
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. |
couldNotConnectToWorkstation |
Não é possível conectar-se à área de trabalho. | Saia e reabra o aplicativo 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. | Saia e reabra o aplicativo 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. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
generalProblem |
Algo deu errado ao tentar abrir o recurso. | Saia e reabra o aplicativo Citrix Workspace. Se o problema persistir, entre em contato com o administrador do sistema. |
retryReasonUnknown |
Ocorreu um erro no arquivo ICA. | Saia e reabra o aplicativo 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 uma lista atualizada de aplicativos e desktops disponíveis, atualize o aplicativo Citrix Workspace ou faça logoff e login novamente. |
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. |
Citrix Solução de Problemas de Conexão
Copiado!
Falha!