Dokumentation

Debugging einer AEM App mit Eclipse

Last update: Thu Mar 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Zum Debuggen eines AEM 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- (oder lokalen) AEM ausgeführt wird?

Auflösung resolution

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

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

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

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

Sie können den Parameter hinzufügen, indem Sie einen der folgenden Schritte ausführen:

  • Fügen Sie es Ihrer crx-quickstart/bin/start script CQ_JVM_OPTS Umgebungsvariable (damit Ihr Server immer im Debug-Modus gestartet wird).
  • Fügen Sie ihn als Parameter ein, wenn Sie AEM mit java -jar direkt. 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 den Java-Prozess abzubrechen, 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 zu starten:

  1. Öffnen Sie Eclipse.
  2. Auswählen  Ausführen  >   Debugkonfigurationen.
  3. Klicken Sie mit der rechten Maustaste auf Remote Java Applications und wählen Sie New.
  4. Wählen Sie Ihr AEM Projekt unter Projekt aus.
  5. Geben Sie den Port aus der Konfiguration "address"des oben definierten jvm-Parameters ein. Im Beispiel handelt es sich um Port 8000 (und den Hostnamen des Computers, mit dem Sie eine Verbindung herstellen möchten, höchstwahrscheinlich localhost)
  6. Um eine Debugging-Sitzung zu starten, doppelklicken Sie auf Ihre neue Konfiguration nach dem Speichern im Bildschirm "Konfigurationen debuggen".
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f