Beheben von Fehlern in AEM

Der folgende Abschnitt beschäftigt sich mit einigen Problemen, auf die Sie bei der Arbeit mit AEM stoßen können, und liefert entsprechende Lösungsvorschläge.

HINWEIS

Wenn Sie Probleme mit der Bearbeitung in AEM beheben wollen, lesen Sie den Abschnitt Fehlerbehebung für Autoren.

HINWEIS

Wenn Probleme auftreten, sollten Sie auch die Liste der bekannten Probleme für Ihre Instanz (Version und Service Packs) prüfen.

Fehlerbehebungsszenarien für Administratoren

Die folgende Tabelle bietet einen Überblick über Probleme, die Administratoren möglicherweise beheben müssen:

Rolle(en)	Problem
Systemadmin	Beim Doppelklicken auf die JAR-Datei für den Schnellstart passiert entweder gar nichts oder die Datei wird mit einem anderen Programm (z. B. der Archivverwaltung) geöffnet
Systemadmin	Über CRX ausgeführte Anwendung erzeugt Fehler wegen unzureichendem Arbeitsspeicher
Systemadmin	Der AEM-Willkommensbildschirm wird nach einem Doppelklick auf den AEM-CM-Schnellstart nicht im Browser angezeigt
Systemadmin Admin-Benutzer	Erstellen von Thread-Speicherauszügen
Systemadmin Admin-Benutzer	Überprüfung auf nicht beendete JCR-Sitzungen

Installationsprobleme

Weitere Informationen zu den folgenden Fehlerbehebungsszenarien finden Sie in Allgemeine Installationsprobleme:

Das Doppelklicken auf die Schnellstart-JAR-Datei hat keinen Effekt oder die Datei wird mit einem anderen Programm geöffnet (z. B. Archivmanager).
In CRX ausgeführte Anwendungen führen zu Fehlern aufgrund unzureichendem Speicherplatz.
Der AEM-Willkommensbildschirm wird nach einem Doppelklick auf den AEM-Schnellstart nicht im Browser angezeigt.

Methoden für die Fehlerbehebungsanalyse

Erstellen von Thread-Speicherauszügen

Ein Thread-Speicherauszug ist eine Liste aller Java-Threads, die derzeit aktiv sind. Wenn AEM nicht richtig reagiert, kann der Thread-Speicherauszug helfen, Deadlocks oder andere Probleme zu identifizieren.

Verwenden des Sling Thread Dumper

Öffnen Sie die AEM-Web-Konsole; zum Beispiel unter http://localhost:4502/system/console/.
Wählen Sie auf der Registerkarte Status die Option Threads aus.

screen_shot_2012-02-13at43925pm

Verwenden von jstack (Befehlszeile)

Suchen Sie die PID (Prozess-ID) der AEM-Java-Instanz.

Sie können beispielsweise ps -ef oder jps verwenden.
Ausführen:

jstack <pid>
Daraufhin wird der Thread-Speicherauszug angezeigt.

HINWEIS

Sie können die Thread-Speicherauszüge an eine Protokolldatei anhängen, indem Sie die >>-Ausgabeumleitung verwenden:

jstack <pid> >> /path/to/logfile.log

Weitere Informationen dazu finden Sie in der Dokumentation Erstellen von Thread-Speicherauszügen von einem JVM.

Überprüfung auf nicht beendete JCR-Sitzungen

Wenn Funktionen für AEM WCM entwickelt werden, werden möglicherweise JCR-Sitzungen geöffnet (vergleichbar mit dem Öffnen einer Datenbankverbindung). Werden die geöffneten Sitzungen nie geschlossen, können folgende Probleme in Ihrem System auftreten:

Das System wird langsamer.
Es befinden sich viele „CacheManager: resizeAll“-Einträge in der Protokolldatei. Die folgende Zahl (size=<x>) gibt die Anzahl an Caches an; jede Sitzung öffnet mehrere Caches.
Gelegentlich reicht der Speicherplatz des Systems nicht aus (nach einigen Stunden, Tagen oder Wochen – je nach Schweregrad).

Lesen Sie den Knowledgebase-Artikel Analysieren von nicht beendeten Sitzungen, um nicht beendete Sitzungen zu analysieren und festzustellen, welcher Code dazu führt, dass eine Sitzung nicht beendet wird.

Verwenden der Adobe Experience Manager-Web-Konsole

Der Status der OSGi-Pakete kann auch frühzeitig auf mögliche Probleme hinweisen.

Öffnen Sie die AEM-Web-Konsole; zum Beispiel unter http://localhost:4502/system/console/.
Wählen auf der Registerkarte OSGi die Option Pakete aus.
Überprüfen Sie Folgendes:
- den Status der Pakete. Falls Status wie „Inaktiv“ oder „Nicht erfüllt“ angezeigt werden, versuchen Sie, das Paket zu stoppen und neu zu starten. Wenn das Problem weiterhin besteht, müssen Sie dies mithilfe anderer Methoden weiter untersuchen.
- ob Pakete mit fehlenden Abhängigkeiten vorliegen. Dies können Sie herausfinden, indem Sie auf den einzelnen Paket-Namen klicken, bei dem es sich um einen Link handelt (im folgenden Beispiel sind keine Probleme aufgetreten):