Resolução de problemas

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

Solucionar problemas de desempenho do autor

Analisar o desempenho lento na instância de criação pode se tornar bastante complexo. Como primeira etapa, é necessário descobrir em qual nível da pilha de tecnologia o desempenho está diminuindo.

A seguinte árvore decisória fornece uma orientação para restringir o gargalo.

chlimage_1-75

Otimização básica

chlimage_1-76

Configurar arquivos de registro e registros de auditoria

AEM registra registros detalhados que talvez você queira configurar para solucionar problemas de instalação. Para obter informações, consulte a seção Trabalhando com registros de auditoria e arquivos de registro.

Usando a opção detalhada

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

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

Problemas comuns de instalação

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

Clicar no duplo do jar do Quickstart não tem nenhum efeito ou abre o arquivo jar com outro programa (por exemplo, gerenciador de arquivos)

Isso normalmente indica um problema com a forma como o ambiente para desktop do seu sistema operacional está configurado para abrir arquivos com a extensão .jar. Isso também pode indicar que você não tem o Java instalado ou que está usando uma versão não suportada 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 de arquivamento.

Para solucionar problemas, faça o seguinte:

  • Duplo verifique se você tem pelo menos a versão 1.6 do Java instalada.

  • Tente um menu de contexto (normalmente clique com o botão direito do mouse) no Início rápido AEM WCM e selecione "Abrir com…"

  • Verifique se Java ou Sun Java está listado e tente executar AEM WCM com ele. Se você tiver várias versões de Java instaladas, selecione a suportada.

    Se você tiver êxito com essa etapa, e seus sistemas operacionais ofertas uma opção para sempre usar o programa selecionado para executar os arquivos .jar, selecione-o. Clicar em duplo deve funcionar a partir de agora.

  • Às vezes, reinstalar a versão do Java compatível ajuda a restaurar a associação correta.

  • Você sempre pode executar o CRX usando a linha de comando ou scripts start/stop conforme descrito anteriormente neste documento.

Meu aplicativo em execução no CRX lança erros de falta de memória

OBSERVAÇÃO

Consulte também Analisar problemas de memória.

O próprio CRX tem uma memória muito baixa. 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 JVM em que o CRX é executado precisa ser iniciada com as configurações de memória apropriadas.

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

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

Se você já tiver definido o tamanho do seu heapsize para 512 MB, talvez você queira analisar o problema de memória ainda mais ao criar um despejo de heap:

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

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar &ast;.jar

Isso gera um arquivo de despejo heap (java_…hprof) sempre que o processo ficar sem memória. O processo pode continuar sendo executado depois que o despejo de heap for gerado. Normalmente, um arquivo de despejo heap é suficiente para analisar o problema.

A tela de boas-vindas do AEM não exibe no navegador depois de clicar duas vezes no Início rápido do AEM

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

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

Além disso, os registros podem revelar o motivo para o navegador não iniciar.

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

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

O site não carrega ou falha intermitentemente com o Java 11

Há um problema conhecido com a execução AEM 6.5 no Java 11, em que o site pode não carregar ou falhar intermitentemente.

Se isso acontecer, siga as seguintes soluções:

  1. Abra o arquivo sling.properties na pasta crx-quickstart/conf/

  2. Localize a seguinte linha:

    org.osgi.framework.bootdelegation=sun.,com.sun.

  3. Substitua-o pelo seguinte:

    org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*

  4. Reinicie a instância.

Solução de problemas de instalações com um servidor de aplicativos

Página não encontrada retornada ao solicitar uma página geometrixx-outdoor

Aplica-se ao WebLogic 10.3.5 e JBoss 5.1

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

Consulte as etapas Implantar AEM aplicativo da Web para obter detalhes.

O tamanho do cabeçalho de resposta pode ser maior que 4Kb

Os erros 502 podem indicar que o servidor da Web não pode lidar com o tamanho do cabeçalho de resposta HTTP AEM. AEM pode gerar cabeçalhos de resposta HTTP que incluem cookies de tamanho superior a 4 Kb. Certifique-se de que seu container de servlet esteja configurado de modo 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

Como 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 o diretório de instalação inteiro, embora a maneira como você desinstala o AEM dependa do que você deseja obter e do armazenamento persistente que 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.

OBSERVAÇÃO

O Adobe recomenda que você faça backup do repositório antes de excluir AEM. Se você excluir todo o <cq-installation-diretory>, excluirá o repositório. Para manter os dados do repositório antes de excluir, mova ou copie a pasta <cq-installation-diretory>/crx-quickstart/repository em outro lugar antes de excluir as outras pastas.

Se a instalação do AEM usar um 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 do armazenamento, o que dificulta a restauração do conteúdo do JCR.

Arquivos JSP não são compilados em JBoss

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now