Show Menu
TÓPICOS×

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.

Otimização básica

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.

Uso da 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 arquivamento)

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 emite erros de falta de memória

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.

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.html HTTP controla as limitações no tamanho do cabeçalho.

Uninstalling 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.
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 o artigo Problemas de compilação JSP no JBoss .