Debugging einer AEM-App mit Eclipse

Zum Debuggen einer AEM-Anwendung können Sie Java-Remote-Debugging.

Beschreibung description

Umgebung

  • Adobe Experience Manager (AEM) 6.4
  • Adobe Experience Manager (AEM) 6.5

Probleme/Symptome

Wie kann ich eine Anwendung debuggen, die auf einem Remote-AEM-Server (oder einem lokalen) ausgeführt wird?

Auflösung resolution

Zum Debuggen einer AEM-Anwendung können Sie Java-Remote-Debugging.

Warnung: Sie in Ihrer Produktionsumgebung kein Remote-Debugging, es sei denn, dies ist erforderlich, da es die Leistung Ihrer Anwendung erheblich beeinträchtigen könnte.

Schritt 1: Hinzufügen des JVM-Parameters „Remote Debugging“

Um das Remote-Debugging zu verwenden, müssen Sie AEM mit diesem JVM-Parameter starten:
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

Sie können den Parameter wie folgt hinzufügen:

  • Fügen Sie es Ihrer crx-quickstart/bin/start-Skript- CQ_JVM_OPTS Umgebungsvariablen hinzu (sodass der Server immer im Debugging-Modus gestartet wird).
  • Schließen Sie es als Parameter ein, wenn Sie AEM direkt mit java -jar starten. Beispiel: java -Xmx512m -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n -jar cq-author-4502.jar

Hinweise

  • Bei Bedarf können Sie den unter "…,address=8000,…“ definierten Port von 8000 in einen Port ändern, der in Ihrer Umgebung besser funktioniert.
  • Wenn Sie bemerken, dass es nicht funktioniert, vermeiden Sie es, den Java-Prozess zu verzweigen, indem Sie die Befehlszeilenoption -nofork angeben.
  • Das Startskript befindet sich unter crx-quickstart/bin

Schritt 2: Starten einer Remote-Debugging-Sitzung

Gehen Sie wie folgt vor, um eine Remote-Debugging-Sitzung von Eclipse aus zu starten:

  1. Öffnen Sie Eclipse.
  2. Wählen Sie Ausführen >   Debug-Konfigurationen.
  3. Klicken Sie mit der rechten Maustaste auf Remote-Java-Anwendungen und wählen Sie Neu.
  4. Wählen Sie Ihr AEM-Projekt unter Projekt aus.
  5. Geben Sie den Port aus der „address“-Konfiguration des oben definierten jvm-Parameters ein. Im Beispiel ist es Port 8000 (und der Hostname des Computers, mit dem Sie eine Verbindung herstellen, höchstwahrscheinlich localhost)
  6. Um eine Debugsitzung zu starten, doppelklicken Sie auf Ihre neue Konfiguration im Bildschirm „Debugkonfigurationen“, nachdem Sie sie gespeichert haben.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f