Dieser Abschnitt enthält detaillierte Informationen zu den verfügbaren Protokollen, die Ihnen bei der Fehlerbehebung helfen, sowie Informationen zu einigen Problemen, auf die Sie möglicherweise bei AEM stoßen.
Die Analyse der langsamen Leistung in der Authoring-Instanz kann komplex werden. Als ersten Schritt muss ermittelt werden, auf welchem Niveau der Technologie-Stack die Leistung abnimmt.
Der folgende Entscheidungsbaum bietet Anleitungen zur Eingrenzung des Engpässen.
AEM protokolliert detaillierte Protokolle, die Sie zur Fehlerbehebung bei Installationsproblemen konfigurieren möchten. Weitere Informationen finden Sie im Abschnitt Arbeiten mit Prüfdatensätzen und Protokolldateien.
Wenn Sie AEM WCM starten, können Sie die Option „-v“ für „verbose“ zur Befehlszeile hinzufügen. Beispiel: java -jar cq-wcm-quickstart-<Version>.jar -v.
Die ausführliche Option zeigt einige Ausgaben des Schnellstartprotokolls in der Konsole an, damit sie zur Fehlerbehebung verwendet werden können.
Im folgenden Abschnitt werden einige Installationsprobleme und deren Lösungen beschrieben.
Dieses Problem weist normalerweise auf ein Problem mit der Konfiguration der Desktop-Umgebung Ihres Betriebssystems zum Öffnen von Dateien mit der Erweiterung .jar hin. Sie kann auch darauf hinweisen, dass Java™ nicht installiert ist oder dass Sie eine nicht unterstützte Version von Java™ verwenden.
Da JAR-Dateien das allgegenwärtige ZIP-Format verwenden, können einige Archivierungsprogramme den Desktop automatisch so konfigurieren, dass JAR-Dateien als Archivdateien geöffnet werden.
Gehen Sie zur Fehlerbehebung wie folgt vor:
Vergewissern Sie sich, dass Sie mindestens Java™ Version 1.6 installiert haben.
Probieren Sie ein Kontextmenü (in der Regel Rechtsklick) auf den AEM WCM-Schnellstart aus und wählen Sie "Öffnen mit…"
Überprüfen Sie, ob Java™ oder Sun Java™ aufgelistet ist, und versuchen Sie, AEM WCM damit auszuführen. Wenn mehrere Java™-Versionen installiert sind, wählen Sie die unterstützte Version aus.
Wenn dieser Schritt erfolgreich ist und Ihr Betriebssystem eine Option anbietet, das ausgewählte Programm immer zum Ausführen der JAR-Dateien zu verwenden, wählen Sie es aus. Doppelklicken sollte von nun an funktionieren.
Manchmal hilft die Neuinstallation der unterstützten Java™-Version dabei, die korrekte Zuordnung wiederherzustellen.
Sie können CRX immer mit der Befehlszeile oder Start-/Stopp-Skripten ausführen, wie zuvor in diesem Dokument beschrieben.
Siehe auch Analysieren von Speicherproblemen.
CRX selbst hat einen geringen Speicherbedarf. Wenn die in CRX ausgeführte Anwendung größere Speicheranforderungen hat oder speicherintensive Vorgänge anfordert (z. B. große Transaktionen), muss die JVM-Instanz, in der CRX ausgeführt wird, mit den entsprechenden Speichereinstellungen gestartet werden.
Verwenden Sie Java™-Befehlsoptionen, um die Speichereinstellungen der JVM zu definieren (z. B. java -Xmx512m -jar crx*.jar , um die Heapgröße auf 512 MB festzulegen).
Geben Sie die Speichereinstellungsoption beim Starten AEM WCM über die Befehlszeile an. Die AEM WCM Start-/Stopp-Skripte oder benutzerdefinierten Skripte zur Verwaltung AEM WCM-Starts können ebenfalls geändert werden, um die erforderlichen Speichereinstellungen zu definieren.
Wenn Sie die Heap-Größe bereits auf 512 MB festgelegt haben, können Sie das Speicherproblem näher untersuchen, indem Sie ein Heap-Abbild erstellen:
Verwenden Sie den folgenden Befehl, um automatisch ein Heap-Abbild zu erstellen, wenn nicht genügend Arbeitsspeicher verfügbar ist:
java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar
Diese Methode generiert eine Heap-Dump-Datei (java_…hprof) immer dann, wenn dem Prozess der Speicher ausgeht. Der Prozess kann nach der Erstellung des Heap-Dumps fortgesetzt werden. Normalerweise reicht eine Heap-Dump-Datei aus, um das Problem zu analysieren.
In bestimmten Situationen werden die AEM WCM-Begrüßungsbildschirme nicht automatisch angezeigt, obwohl das Repository selbst erfolgreich ausgeführt wurde. Dieses Problem kann von der Einrichtung des Betriebssystems, der Browserkonfiguration oder ähnlichen Faktoren abhängen.
Ein häufiges Symptom ist, dass im AEM WCM-Schnellstartfenster die Meldung „AEM WCM starting up, waiting for server startup…“ angezeigt wird. Wenn diese Nachricht relativ lange angezeigt wird, geben Sie die AEM WCM-URL manuell unter Verwendung des standardmäßigen 4502-Anschlusses oder des Anschlusses ein, an dem die Instanz ausgeführt wird: http://localhost:4502/
Außerdem können Protokolle den Grund dafür enthalten, dass der Browser nicht gestartet wird.
Manchmal wird im AEM WCM-Schnellstartfenster die Meldung "AEM WCM wird auf http://localhost:port/ ausgeführt"angezeigt und der Browser startet nicht automatisch. Klicken Sie in diesem Fall auf die URL im AEM WCM-Schnellstartfenster (es handelt sich um einen Hyperlink) oder geben Sie die URL manuell im Browser ein.
Wenn alles andere fehlschlägt, überprüfen Sie die Protokolle, um herauszufinden, was passiert ist.
Es gibt ein bekanntes Problem, bei dem AEM 6.5 auf Java™ 11 ausgeführt wird, bei dem die Website möglicherweise nicht zeitweise geladen wird oder fehlschlägt.
Tritt dieses Problem auf, führen Sie folgende Schritte aus:
Öffnen Sie die sling.properties
-Datei unter dem Ordner crx-quickstart/conf/
.
Suchen Sie die folgende Zeile:
org.osgi.framework.bootdelegation=sun.,com.sun.
Ersetzen Sie sie durch die Folgende:
org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*
Starten Sie die Instanz neu.
Gilt für WebLogic 10.3.5 und JBoss® 5.1
Wenn eine Anforderung an die Seite "geometrixx-outdoors/en"den Wert 404 (Seite nicht gefunden) zurückgibt, können Sie erneut überprüfen, ob Sie die zusätzliche sling-Eigenschaft in der Datei sling.properties festgelegt haben, die für diese spezifischen Anwendungsserver erforderlich ist.
Weitere Informationen finden Sie unter Bereitstellen der AEM-Web-Anwendung.
502-Fehler können darauf hinweisen, dass der Webserver die Größe des AEM HTTP-Antwortheaders nicht verarbeiten kann. AEM können HTTP-Antwort-Header generieren, die Cookies mit einer Größe von mehr als 4 KB enthalten. Stellen Sie sicher, dass Ihr Servlet-Container so konfiguriert ist, dass die maximale Größe des Antwort-Headers 4 KB überschreiten kann.
Beispiel: Für Tomcat 7.0 ist das Attribut maxHttpHeaderSize des HTTP-Connector steuert Beschränkungen der Header-Größe.
Da AEM in einem einzigen Ordner installiert wird, ist kein Deinstallationsdienstprogramm erforderlich. Die Deinstallation kann so einfach sein wie das Löschen des gesamten Installationsordners. Wie Sie deinstallieren, hängt jedoch davon ab, was Sie erreichen und welchen persistenten Speicher Sie verwenden AEM.
Wenn persistenter Speicher in das Installationsverzeichnis eingebettet ist, z. B. in der standardmäßigen TarPM-Installation, werden beim Löschen von Ordnern auch Daten entfernt.
Adobe empfiehlt, das Repository zu sichern, bevor Sie AEM löschen. Wenn Sie die gesamte <cq-installation-directory>, löschen Sie auch das Repository. Sichern Sie die Repository-Daten vor dem Löschen, indem Sie den Ordner „<cq-installation-directory>/crx-quickstart/repository“ an einen anderen Speicherort verschieben oder kopieren, bevor Sie die anderen Ordner löschen.
Wenn Ihre AEM externen Speicher verwendet, z. B. einen Datenbankserver, werden die Daten beim Entfernen des Ordners nicht automatisch entfernt. Dadurch wird jedoch die Speicherkonfiguration entfernt, was die Wiederherstellung des JCR-Inhalts erschwert.
Wenn Sie JSP-Dateien auf JBoss® installieren oder auf Experience Manager aktualisieren und die entsprechenden Servlets nicht kompiliert sind, stellen Sie sicher, dass der JBoss® JSP-Compiler korrekt konfiguriert ist. Weitere Informationen finden Sie unter
JSP-Kompilierungsprobleme in JBoss® Artikel.