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.
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.
O AEM registra logs detalhados que você pode querer configurar para solucionar problemas de instalação. Para obter informações, consulte a Trabalhar com registros de auditoria e arquivos de log seção.
Ao iniciar o AEM WCM, 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.
A seção a seguir descreve alguns problemas de instalação e suas soluções.
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:
Verifique se você tem pelo menos a versão 1.6 do Java™ instalada.
Experimente um menu de contexto (geralmente clique com o botão direito do mouse) no WCM Quickstart do AEM e selecione "Abrir com…"
Verifique se Java™ ou Sun Java™ está listado e tente executar o AEM WCM com ele. Se você tiver várias versões do Java™ instaladas, selecione a compatível.
Se você tiver êxito nesta etapa e seu sistema operacional oferecer uma opção para sempre usar o programa selecionado para executar os arquivos .jar, selecione-o. Clicar duas vezes deve funcionar a partir de agora.
Às vezes, reinstalar a versão compatível do Java™ ajuda a restaurar a associação correta.
Você sempre pode executar o CRX usando a linha de comando ou scripts de iniciar/parar, conforme descrito anteriormente neste documento.
Consulte também Analisar problemas de memória.
O próprio CRX tem pouco espaço de memória. Se o aplicativo 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 o tamanho de pilha para 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 ficar sem memória. O processo pode continuar a ser executado após a geração do despejo de heap. Normalmente, um arquivo de despejo de heap é suficiente para analisar o problema.
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.
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:
Abra o sling.properties
arquivo sob o crx-quickstart/conf/
pasta
Localize a seguinte linha:
org.osgi.framework.bootdelegation=sun.,com.sun.
Substitua-o pelo seguinte:
org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*
Reinicie a instância.
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 na Implantar a aplicação Web AEM etapas para obter detalhes.
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.
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.
O Adobe recomenda que você faça backup do seu repositório antes de excluir o AEM. Se você excluir a variável <cq-installation-directory>, você também excluirá o repositório. Para manter os dados do repositório antes de excluir, mova ou copie o <cq-installation-directory>/crx-quickstart/repository pasta em outro lugar antes de excluir as outras pastas.
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.
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 JSP no JBoss® artigo.