Como depurar um aplicativo AEM usando o eclipse

Descrição

Ambiente

  • Experience Manager 6.4
  • Experience Manager 6.5

Problemas/sintomas
Como depurar um aplicativo em execução em um servidor de AEM remoto (ou local)?

Resolução

Para depurar um aplicativo de AEM, você pode usar Depuração remota do Java.

Aviso: Não ative a depuração remota no ambiente de produção, a menos que seja necessário, pois isso pode afetar significativamente o desempenho do aplicativo.

Etapa 1: Adicionar o parâmetro JVM de depuração remota

Para usar a depuração remota, você deve começar a AEM com este parâmetro da JVM:
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

Você pode adicionar o parâmetro seguindo um destes procedimentos:

  • Adicione-o ao crx-quickstart/bin/start script CQ_JVM_OPTS variável de ambiente (para que seu servidor sempre inicie no modo de depuração).
  • Incluí-lo como um parâmetro ao iniciar o AEM com java -jar diretamente. Por exemplo, java -Xmx512m -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n -jar cq-author-4502.jar

Notas

  • Se necessário, você pode alterar a porta definida em "…address=8000,…" de 8000 a algo que funcione melhor no seu ambiente.
  • Se você notar que ele não está funcionando, evite bifurcar o processo java especificando a opção de linha de comando -nofork.
  • O script de início está localizado em crx-quickstart/bin

Etapa 2: Iniciar uma sessão de depuração remota

Para iniciar uma sessão de depuração remota a partir do Eclipse, faça o seguinte:

  1. Abra o Eclipse.
  2. Choose Executar  Configurações de depuração.
  3. Clique com o botão direito do mouse em Aplicativos Java Remotos e selecione Novo.
  4. Selecione seu projeto AEM em Projeto.
  5. Digite a porta na configuração "endereço" do parâmetro jvm definido acima. No exemplo, é a porta 8000 (e o nome do host da máquina à qual você está se conectando, provavelmente localhost)
  6. Para iniciar uma sessão de depuração, clique duas vezes em nova configuração na tela Configurações de depuração depois de salvá-la.

Nesta página