Fehlerbehebung bei Installationsproblemen mit AEM

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.

Fehlerbehebung bei der Autorenleistung

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.

Grundlegende Optimierung

Protokolldateien und Prüfprotokolle konfigurieren

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.

Verwenden der Option „verbose“ (ausführlich)

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.

Häufige Installationsprobleme

Im folgenden Abschnitt werden einige Installationsprobleme und deren Lösungen beschrieben.

Ein Doppelklick auf die Schnellstart-JAR hat keine Auswirkungen oder öffnet die JAR-Datei mit einem anderen Programm (z. B. Archiv-Manager).

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.

Meine über CRX ausgeführte Anwendung erzeugt Fehler wegen unzureichendem Arbeitsspeicher

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.

Der AEM Begrüßungsbildschirm wird nach einem Doppelklick auf AEM Schnellstart nicht im Browser angezeigt

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.

Die Website wird nicht geladen oder schlägt mit Java™ 11 gelegentlich fehl

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:

1. Öffnen Sie die sling.properties-Datei unter dem Ordner crx-quickstart/conf/.

2. Suchen Sie die folgende Zeile:

   org.osgi.framework.bootdelegation=sun.,com.sun.

3. Ersetzen Sie sie durch die Folgende:

   org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*

4. Starten Sie die Instanz neu.

Fehlerbehebung bei Installationen mit einem Anwendungsserver

Seite nicht gefunden wurde bei Anforderung einer Geometrixx-Outdoor-Seite zurückgegeben

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.

Die Größe des Antwortheaders kann größer als 4 KB sein.

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.

Deinstallieren von Adobe Experience Manager

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.

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.

JSP-Dateien werden nicht auf JBoss® kompiliert

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.

Ressourcen für Business.Adobe.com

Ecommerce Integrations Auto Text Summarization Customer Communications Asset Collections Customer Experience Management Digital Signage