Solução de problemas

Abordagem Sistemática

1. Identificar Sintomas: Defina claramente o problema (por exemplo, impressora não aparece, trabalho travado, saída incorreta, impressão lenta).
2. Isolar Escopo: Determine quem é afetado (um usuário, vários usuários, aplicativo específico), quais impressoras estão envolvidas e de quais VDAs ou dispositivos cliente o problema ocorre.
3. Verificar o Básico: Verifique a conectividade de rede (VDA para servidor de impressão, cliente para VDA), certifique-se de que a impressora esteja online e funcional fora do Citrix®, verifique a impressão local a partir do cliente (para problemas de redirecionamento).
4. Revisar Políticas: Examine as configurações de política Citrix relevantes aplicadas ao usuário/sessão afetado usando ferramentas como o assistente de Modelagem de Política de Grupo Citrix ou verificando as configurações de política aplicadas no VDA. Certifique-se de que as configurações de política estejam configuradas conforme o esperado e que não haja conflitos óbvios.
5. Examinar Logs: Verifique os Logs de Eventos do Windows (logs de Aplicativo e Sistema, logs de PrintService) no VDA, dispositivo cliente e servidor de impressão (se aplicável). Verifique os logs específicos do Citrix, se ativados.3
6. Testar Componentes: Tente isolar o problema a um componente específico – tente imprimir de um aplicativo diferente, tente uma impressora diferente, teste com um driver genérico (como UPD ou Microsoft XPS Document Writer), verifique o status dos serviços Spooler de Impressão e Citrix Print Manager.
7. Consultar Recursos: Utilize a documentação do produto, artigos de suporte e fóruns da comunidade para problemas e soluções conhecidos.

Problemas Comuns e Soluções

• Falha ao Criar Impressoras Automaticamente / Impressoras Não Aparecendo na Sessão:
  • Causas Potenciais: Política de redirecionamento de impressora cliente desabilitada; Política de criação automática de impressoras cliente definida como 'Nenhum' ou filtrada incorretamente; Problema no spooler de impressão do dispositivo cliente; Problema no aplicativo Workspace; Problema de conectividade de rede entre cliente e VDA; Serviço Citrix Print Manager (CpSvc.exe) não em execução ou travado no VDA; Driver de impressora necessário ausente no VDA (se driver nativo for necessário); Política Citrix não aplicada corretamente à sessão.
  • Etapas de Solução de Problemas:
    1. Verifique se a política de redirecionamento de impressora cliente está 'Permitida' e se a criação automática de impressoras cliente está configurada corretamente para o usuário/sessão.
    2. Verifique o status do serviço CpSvc.exe no VDA; reinicie se necessário.
    3. Verifique o status do serviço Spooler de Impressão do Windows no VDA e no cliente; reinicie se necessário.
    4. Verifique a conectividade básica da rede.
    5. Teste a impressão localmente no dispositivo cliente.
    6. Certifique-se de que uma versão compatível do aplicativo Workspace esteja instalada.
    7. Verifique os logs de eventos do VDA em busca de erros relacionados a CpSvc ou à criação de impressoras.
    8. Force a atualização da política no VDA (gpupdate /force).
    9. Verifique as políticas aplicadas no VDA para confirmar que as configurações esperadas estão presentes.
    10. Se drivers nativos forem esperados, verifique se estão instalados no VDA.
    11. Verifique as configurações de redirecionamento de impressora RDS/Terminal Server na política local/de grupo no VDA.
    12. Procure e limpe entradas de impressora órfãs no registro do VDA.
• Falhas do Spooler de Impressão / Serviço Não Responsivo (no VDA ou Servidor de Impressão):
  • Causas Potenciais: Driver de impressora com falha ou incompatível (geralmente de terceiros); Trabalho de impressão corrompido na fila; Conflitos de driver; Recursos do sistema insuficientes.
  • Etapas de Solução de Problemas:
    1. Identifique o processo/módulo com falha usando os Logs de Eventos do Windows (o log de Aplicativos geralmente mostra falhas do spooler).
    2. Tente reiniciar o serviço Spooler de Impressão.
    3. Se a reinicialização falhar ou o problema se repetir, tente limpar a fila de impressão manualmente (Pare o serviço Spooler, exclua arquivos em C:\Windows\System32\spool\PRINTERS, Inicie o serviço Spooler).
    4. Identifique e remova o driver de impressora problemático. A remoção limpa pode exigir edições no registro.
    5. Teste com o UPD da Citrix ou um driver genérico da Microsoft.
    6. Verifique e limpe processadores de impressão órfãos no registro.
• Conflitos de Política / Configurações Ignoradas:
  • Causas Potenciais: Configurações de GPO substituindo políticas Citrix; Prioridades ou filtros de política Citrix conflitantes; Erros durante o processamento da política.
  • Etapas de Solução de Problemas:
    1. Use o assistente de Modelagem de Política de Grupo da Citrix para simular a aplicação da política para o usuário/VDA afetado.
    2. Verifique se os filtros de política (grupos de usuários, IPs de cliente, etc.) estão corretos.
    3. Verifique as prioridades da política no Studio/Web Studio.
    4. Bloqueie temporariamente a herança de GPO na UO do VDA para isolar problemas de política da Citrix.
    5. Examine os resultados do processamento da política no VDA (por exemplo, usando gpresult /h report.html).
    6. Simplifique o conjunto de políticas aplicado ao usuário/VDA e adicione as políticas de volta incrementalmente para encontrar o conflito.
• Problemas de Driver (Geral - Compatibilidade, Corrupção, Mapeamento):
  • Causas Potenciais: Driver não compatível com o SO do VDA ou versão do Citrix; Instalação do driver corrompida; Driver exigido pela política ausente no VDA; Conflito entre múltiplos drivers; Configuração incorreta da política de mapeamento de driver de impressora.
  • Etapas de Solução de Problemas:
    1. Tente imprimir com o Citrix UPD (configure a política de uso do driver de impressão universal).
    2. Verifique se o driver correto (nativo ou UPD) está sendo selecionado com base nas políticas aplicadas.
    3. Certifique-se de que os drivers nativos necessários estejam instalados corretamente no VDA (se usados).
    4. Verifique a documentação do fornecedor para compatibilidade do driver com CVAD e a versão do SO do VDA.
    5. Execute uma reinstalação limpa do driver problemático (desinstale, reinicie, instale).
    6. Revise e teste cuidadosamente as regras da política de mapeamento de driver de impressora.
    7. Minimize o número de drivers instalados no VDA.
• Impressão Lenta / Problemas de Desempenho:
  • Causas Potenciais: Congestionamento de rede ou alta latência (especialmente WAN); Trabalhos de impressão grandes e complexos (por exemplo, gráficos de alta resolução); Driver de impressora ineficiente; Otimizações de impressão (compressão, cache) desabilitadas ou mal configuradas; Roteamento ineficiente (por exemplo, conexão direta sobre WAN lenta).
  • Etapas de Solução de Problemas:
    1. Analise o caminho e o desempenho da rede entre VDA, cliente e servidor de impressão.
    2. Configure as políticas de limitação de largura de banda do Citrix para impressão.
    3. Habilite e configure as otimizações do UPD (compressão de imagem, cache de fonte/imagem) por meio das políticas de Impressão Universal.
    4. Para links WAN, desative a política Conexões diretas para servidores de impressão para forçar o tráfego sobre o canal ICA® compactado.
    5. Se estiver usando UPS, certifique-se de que esteja configurado de forma otimizada para a rede.
    6. Analise o próprio trabalho de impressão – reduza a resolução ou a complexidade, se possível.
    7. Teste com um driver diferente (por exemplo, UPD vs. nativo).
• Saída Incorreta (Caracteres Ausentes, Erros de Formatação, Orientação Errada):
  • Causas Potenciais: Fontes ausentes no VDA exigidas pelo documento/aplicativo; Substituição de fonte incorreta; Incompatibilidade do driver da impressora; Problema com formato UPD específico (por exemplo, EMF vs. XPS); Bug do aplicativo; Conflito com recursos de impressão avançados ativados na impressora cliente local.
  • Etapas de Solução de Problemas:
    1. Certifique-se de que todas as fontes necessárias estejam instaladas no VDA.
    2. Tente alterar a ordem da política de preferência do driver Universal (por exemplo, tente XPS antes de EMF).
    3. Teste a impressão do mesmo documento a partir de um aplicativo diferente.
    4. Teste a impressão para uma impressora física diferente ou uma impressora virtual (por exemplo, Microsoft XPS Document Writer).
    5. Tente usar um driver de impressora diferente (UPD vs. nativo, ou uma versão nativa diferente).
    6. Verifique as configurações de impressão e a configuração da página do aplicativo.
    7. Desative "Recursos de Impressão Avançados" nas propriedades da impressora local no dispositivo cliente.
    8. Verifique as configurações de orientação de impressão nas preferências e políticas do usuário.
• Serviço Citrix Print Manager (CpSvc.exe) Trava/Congela:
  • Causas Potenciais: Drivers de impressora que não respondem, deixando objetos órfãos no registro; Dados de política Citrix corrompidos relacionados à impressão; Contenção de recursos do sistema.
  • Etapas de Solução de Problemas:
    1. Siga as etapas para limpar entradas órfãs de impressora e processador de impressão do registro do VDA. Requer a interrupção dos serviços Print Spooler e CpSvc primeiro.
    2. Identifique e remova o(s) driver(s) de impressora problemático(s).
    3. Considere limpar as pastas de cache/chaves de registro da política Citrix no VDA e forçar uma atualização da política.
    4. Monitore o uso de recursos do VDA (CPU, Memória).
    5. Reinicie os serviços CpSvc e Print Spooler.
• Problemas com a Impressora PDF:
  • Causas Potenciais: Política de criação automática de Impressora Universal PDF desabilitada; Versão incompatível do VDA ou do aplicativo Workspace; Nenhum visualizador de PDF instalado no endpoint do cliente; Navegador não suportado usado (por exemplo, Edge) ou erro de configuração HTML5 (cabeçalhos CSP, config.js).
  • Etapas de Solução de Problemas:
    1. Verifique se a política de criação automática de Impressora Universal PDF está habilitada e aplicada.
    2. Confirme se o VDA e o aplicativo Workspace atendem aos requisitos mínimos de versão.
    3. Certifique-se de que um visualizador de PDF compatível (por exemplo, Adobe Reader, Chrome) esteja instalado e definido como padrão no cliente.
    4. Se estiver usando o aplicativo Workspace HTML5, verifique a compatibilidade do navegador e as configurações de configuration.js e cabeçalhos CSP.
    5. Reinicie a sessão Citrix após as alterações de política.

Solução de problemas básicos do usuário final

• Faça logoff completamente da sessão HDX™ e faça login novamente.
• Verifique o status da impressora local no dispositivo de endpoint (certifique-se de que esteja online, não pausada, sem erros).
• Reinicie o dispositivo de endpoint local.