Solução de problemas de instalação com o AEM troubleshooting

Esta seção inclui informações detalhadas sobre os registros disponíveis para ajudá-lo a solucionar problemas e também inclui informações sobre alguns dos problemas que você pode encontrar com o AEM.

Solução de problemas de desempenho do autor troubleshoot-author-performance

A análise de desempenho lento na instância de criação pode se tornar complexa. Como primeiro passo, é necessário descobrir em qual nível da pilha de tecnologia o desempenho está diminuindo.

A árvore decisória a seguir fornece orientação para restringir o gargalo.

Otimização básica basic-optimization

Configuração de arquivos de log e logs de auditoria configuring-log-files-and-audit-logs

O AEM registra logs detalhados que você pode querer configurar para solucionar problemas de instalação. Para obter informações, consulte a seção Trabalhando com registros de auditoria e arquivos de log.

Uso da Opção Detalhada using-the-verbose-option

Ao iniciar o WCM do AEM, você pode adicionar a opção -v (verboso) à linha de comando como em: java -jar cq-wcm-quickstart-<version>.jar -v.

A opção detalhada exibe parte da saída de log do Quickstart no console, para que possa ser usada para a solução de problemas.

Problemas comuns de instalação common-installation-issues

A seção a seguir descreve alguns problemas de instalação e suas soluções.

Clicar duas vezes no jar Quickstart não tem efeito ou abre o arquivo jar com outro programa (por exemplo, gerenciador de arquivos) double-clicking-the-quickstart-jar-does-not-have-any-effect-or-opens-the-jar-file-with-another-program-for-example-archive-manager

Esse problema geralmente indica um problema com a forma como o ambiente de desktop do sistema operacional está configurado para abrir arquivos com extensão .jar. Ela também pode indicar que você não tem o Java™ instalado ou que você está usando uma versão não compatível do Java™.

Como os arquivos jar usam o formato ZIP onipresente, alguns dos programas de arquivamento podem configurar automaticamente a área de trabalho para abrir arquivos jar como arquivos mortos.

Para solucionar problemas, faça o seguinte:

Meu aplicativo em execução no CRX emite erros de memória insuficiente my-application-running-on-crx-throws-out-of-memory-errors

O próprio CRX tem pouco espaço de memória. Se a aplicação em execução no CRX tiver requisitos de memória maiores ou solicitar operações com muita memória (por exemplo, transações grandes), a instância da JVM em que o CRX é executado deverá ser iniciada com configurações de memória apropriadas.

Use as opções de comando do Java™ para definir as configurações de memória da JVM (por exemplo, java -Xmx512m -jar crx*.jar para definir heapsize como 512 MB).

Especifique a opção de configuração de memória ao iniciar o WCM do AEM a partir da linha de comando. Os scripts de inicialização/parada do WCM do AEM ou os scripts personalizados para gerenciar a inicialização do WCM do AEM também podem ser modificados para definir as configurações de memória necessárias.

Se você já tiver definido o tamanho do heap como 512 MB, convém analisar mais detalhadamente o problema de memória criando um despejo de heap.

Para criar automaticamente um despejo de heap ao ficar sem memória, use o seguinte comando:

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar

Este método gera um arquivo de despejo de heap (java_…hprof) sempre que o processo fica sem memória. O processo pode continuar a ser executado após a geração do despejo de heap.

Geralmente, três arquivos de despejo de heap, coletados durante um período, são necessários para analisar o problema:

Eles podem ser comparados para ver as alterações e como os objetos estão usando a memória.

A tela de boas-vindas do AEM não é exibida no navegador após clicar duas vezes no AEM Quickstart the-aem-welcome-screen-does-not-display-in-the-browser-after-double-clicking-aem-quickstart

Em determinadas situações, as telas de boas-vindas do WCM do AEM não são exibidas automaticamente, mesmo que o repositório em si esteja sendo executado com êxito. Esse problema pode depender da configuração do sistema operacional, da configuração do navegador ou de fatores semelhantes.

O sintoma comum é que a janela AEM WCM Quickstart exibe "AEM WCM inicializando, aguardando inicialização do servidor…" Se essa mensagem for exibida por um tempo relativamente longo, insira o URL do WCM do AEM na janela do navegador manualmente, usando a porta 4502 padrão ou a porta em que a instância está sendo executada: http://localhost:4502/.

Além disso, os registros podem revelar o motivo pelo qual o navegador não está sendo iniciado.

Às vezes, a janela AEM WCM Quickstart exibe a mensagem "AEM WCM em execução em http://localhost:port/" e o navegador não é iniciado automaticamente. Nesse caso, clique no URL na janela AEM WCM Quickstart (é um hiperlink) ou insira manualmente o URL no navegador.

Se tudo falhar, verifique os logs para descobrir o que aconteceu.

O site não carrega ou falha intermitentemente com o Java™ 11 the-website-does-not-load-or-fails-intermittently-with-java11

Há um problema conhecido com o AEM 6.5 em execução no Java™ 11, no qual o site pode não ser carregado ou falhar intermitentemente.

Se esse problema ocorrer, faça o seguinte:

Solução de problemas de instalações com um servidor de aplicativos troubleshooting-installations-with-an-application-server

Página não encontrada retornada ao solicitar uma página geometrixx-outdoor page-not-found-returned-when-requesting-a-geometrixx-outdoor-page

Aplicável ao WebLogic 10.3.5 e JBoss® 5.1

Quando uma solicitação para a página geometrixx-outdoors/en retorna um erro 404 (Página não encontrada), é possível verificar novamente se você definiu a propriedade sling adicional no arquivo sling.properties necessário para esses Servidores de aplicativos específicos.

Consulte as etapas Implantar aplicativo Web AEM para obter detalhes.

O tamanho do cabeçalho de resposta pode ser maior que 4 KB response-header-size-can-be-greater-than-kb

Os erros 502 podem indicar que o servidor Web não pode lidar com o tamanho do cabeçalho de resposta HTTP AEM. O AEM pode gerar cabeçalhos de resposta HTTP que incluem cookies de tamanho superior a 4 KB. Certifique-se de que o container de servlet esteja configurado para que o tamanho máximo do cabeçalho de resposta possa exceder 4 KB.

Por exemplo, para Tomcat 7.0, o atributo maxHttpHeaderSize do Conector HTTP controla as limitações no tamanho do cabeçalho.

Desinstalação do Adobe Experience Manager uninstalling-adobe-experience-manager

Como o AEM é instalado em um único diretório, não há necessidade de um utilitário de desinstalação. A desinstalação pode ser tão simples quanto excluir todo o diretório de instalação, embora a forma como você desinstala o AEM dependa do que você deseja obter e qual armazenamento persistente você usa.

Se o armazenamento persistente estiver incorporado no diretório de instalação, por exemplo, na instalação padrão do TarPM, a exclusão de pastas também removerá os dados.

Se sua instalação do AEM usar armazenamento externo, por exemplo, um servidor de banco de dados, a remoção da pasta não removerá os dados automaticamente, mas removerá a configuração de armazenamento, o que dificultará a restauração do conteúdo JCR.

Os arquivos JSP não são compilados no JBoss® jsp-files-are-not-compiled-on-jboss

Se você instalar ou atualizar arquivos JSP para o Experience Manager no JBoss® e os servlets correspondentes não forem compilados, certifique-se de que o compilador JSP do JBoss® esteja configurado corretamente. Para obter informações, consulte a
Problemas de compilação de JSP no artigo JBoss®.