Solução de problemas do Adobe Experience Manager troubleshooting-aem

A seção a seguir aborda alguns problemas que você pode encontrar ao usar o AEM (Adobe Experience Manager), juntamente com sugestões sobre como solucioná-los.

NOTE
Se você estiver solucionando problemas de criação no AEM, consulte Solução de problemas para autores.
NOTE
Quando você tiver problemas, também vale a pena verificar a lista de Problemas conhecidos para sua instância (versão e service packs).

Cenários de solução de problemas para administradores troubleshooting-scenarios-for-administrators

A tabela a seguir fornece uma visão geral dos problemas que os administradores podem solucionar:

Função
Problema
Administrador do sistema
Clicar duas vezes no jar Quickstart não tem efeito ou abre o arquivo jar com outro programa (por exemplo, gerenciador de arquivos)
Administrador do sistema
Meu aplicativo em execução no CRX emite erros de memória insuficiente
Administrador do sistema
A tela de boas-vindas do AEM não é exibida no navegador após clicar duas vezes no AEM CM Quickstart

Administrador do sistema

usuário administrador

Fazendo um despejo de encadeamento

Administrador do sistema

usuário administrador

Verificando sessões JCR não fechadas

Problemas de instalação installation-issues

Consulte Problemas Comuns de Instalação para obter informações sobre os seguintes cenários de solução de problemas:

  • Clicar duas vezes no jar Quickstart não tem efeito ou o arquivo JAR com outro programa (como o gerenciador de arquivos).
  • Os aplicativos em execução no CRX apresentam erros de falta de memória.
  • A tela de boas-vindas do AEM não é exibida no navegador após clicar duas vezes no AEM Quickstart.

Métodos de análise de solução de problemas methods-for-troubleshooting-analysis

Fazendo um despejo de encadeamento making-a-thread-dump

O despejo de thread é uma lista de todas as threads do Java™ que estão ativas no momento. Se o AEM não responder corretamente, o despejo de encadeamento pode ajudar a identificar bloqueios ou outros problemas.

Uso do Sling Thread Dumper using-sling-thread-dumper

  1. Abra o Console da Web do AEM; por exemplo, em https://localhost:4502/system/console/.
  2. Selecione a guia Threads em Status.

screen_shot_2012-02-13at43925pm

Usando jstack (linha de comando) using-jstack-command-line

  1. Localize o PID (ID do processo) da instância do Java™ AEM.

    Por exemplo, você pode usar ps -ef ou jps.

  2. Executar:

    jstack <pid>

  3. Mostra o despejo de thread.

NOTE
Você pode anexar os despejos de thread a um arquivo de log usando o redirecionamento de saída >>:
jstack <pid> >> /path/to/logfile.log

Consulte a documentação Como remover despejos de thread de uma JVM para obter mais informações

Verificando sessões JCR não fechadas checking-for-unclosed-jcr-sessions

Quando a funcionalidade é desenvolvida para o WCM do AEM, as sessões JCR podem ser abertas (comparável à abertura de uma conexão de banco de dados). Se as sessões abertas nunca forem fechadas, o sistema pode apresentar os seguintes sintomas:

  • O sistema fica mais lento.
  • Você pode ver grande parte das entradas do CacheManager: resizeAll no arquivo de log; o seguinte número (size=<x>) mostra o número de caches, cada sessão abre vários caches.
  • Periodicamente, o sistema fica sem memória (após algumas horas, dias ou semanas - dependendo da gravidade).

Para analisar sessões não fechadas e descobrir qual código não está fechando uma sessão, consulte o artigo da Base de Dados de Conhecimento Analisar sessões não fechadas.

Uso do console da Web do Adobe Experience Manager using-the-adobe-experience-manager-web-console

O status dos pacotes OSGi também pode fornecer uma indicação antecipada de possíveis problemas.

  1. Abra o Console da Web do AEM; por exemplo, em https://localhost:4502/system/console/.

  2. Selecione Pacotes na guia OSGI.

  3. Verificar:

    • o Status dos pacotes. Se algum estiver Inativo ou Insatisfeito, tente parar e reiniciar o pacote. Se o problema persistir, investigue mais usando outros métodos.
    • se algum dos pacotes tem dependências ausentes. Esses detalhes podem ser vistos ao clicar no Nome do pacote individual, que é um link (o exemplo a seguir não tem problemas):

screen_shot_2012-02-13at44706pm

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2