Felsökning

I det här avsnittet finns detaljerad information om loggar som kan hjälpa dig att felsöka. Här finns även information om några av de problem som du kan råka ut för AEM.

Felsök författarprestanda

Det kan bli ganska komplicerat att analysera långsamma prestanda i redigeringsinstansen. Som ett första steg måste du ta reda på vilken nivå av teknikhögen som prestandan minskar.

Följande beslutsträd ger vägledning för att minska flaskhalsen.

chlimage_1-75

Grundläggande optimering

chlimage_1-76

Konfigurera loggfiler och granskningsloggar

AEM loggar som du kan behöva konfigurera för att felsöka installationsproblem. Mer information finns i avsnittet Arbeta med granskningsposter och loggfiler.

Använda alternativet Detaljerad

När du startar AEM WCM kan du lägga till alternativet -v (utförligt) på kommandoraden som i: java -jar cq-wcm-quickstart-<version>.jar -v.

I det utförliga alternativet visas några av QuickStart-loggutdata på konsolen, så de kan användas för felsökning.

Vanliga installationsproblem

I följande avsnitt beskrivs några installationsproblem och deras lösningar.

Att dubbelklicka på Quickstart-behållaren har ingen effekt eller öppnar burken-filen med ett annat program (t.ex. arkivhanteraren)

Detta tyder vanligtvis på ett problem med hur operativsystemets skrivbordsmiljö är konfigurerad att öppna filer med filnamnstillägget .jar. Det kan också tyda på att du inte har Java installerat eller att du använder en version av Java som inte stöds.

När man använder burkfiler i ZIP-format kan vissa av arkiveringsprogrammen automatiskt konfigurera skrivbordet så att burkfiler öppnas som arkivfiler.

Så här felsöker du:

  • Kontrollera att du har minst Java version 1.6 installerad.

  • Testa en snabbmeny (oftast högerklickning) i AEM WCM QuickStart och välj"Öppna med…"…"

  • Kontrollera om Java eller Sun Java visas och försök köra AEM WCM med det. Om du har flera Java-versioner installerade väljer du en som stöds.

    Om du lyckas med det här steget, och operativsystemet har ett alternativ för att alltid använda det valda programmet för att köra .jar-filerna, markerar du det. Dubbelklickning bör fungera från och med nu.

  • Ibland kan det vara bra att återställa den korrekta associationen genom att installera om den Java-version som stöds.

  • Du kan alltid köra CRX med kommandoraden eller starta/stoppa skript enligt beskrivningen tidigare i det här dokumentet.

Mitt program som körs på CRX orsakar fel av typen slut på minne

OBSERVERA

CRX har i sig mycket lite minnesutrymme. Om programmet som körs i CRX har större minneskrav eller begär minnesintensiva åtgärder (till exempel stora transaktioner), måste JVM-instansen där CRX körs startas med lämpliga minnesinställningar.

Använd Java-kommandoalternativen för att definiera minnesinställningar för JVM (t.ex. java -Xmx512m -jar crx*.jar för att ange heapsize till 512 MB).

Ange minnesinställningsalternativet när du startar AEM WCM från kommandoraden. AEM WCM-skript för start/stopp eller anpassade skript för hantering AEM WCM-start kan också ändras för att definiera de nödvändiga minnesinställningarna.

Om du redan har definierat stackstorleken till 512 MB kan du analysera minnesproblemet ytterligare genom att skapa en stackdump:

Använd följande kommando för att automatiskt skapa en stackdump när minnet tar slut:

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar

Detta genererar en heap dump-fil (java_…hprof) när minnet tar slut i processen. Processen kan fortsätta att köras efter att stackdumpen har skapats. Vanligtvis räcker det med en stackdumpfil för att analysera problemet.

AEM välkomstskärm visas inte i webbläsaren när du dubbelklickat AEM QuickStart

I vissa situationer visas inte AEM WCM-välkomstskärmar automatiskt även om själva databasen körs. Detta kan bero på operativsystemets konfiguration, webbläsarkonfigurationen eller liknande faktorer.

Det vanligaste symtomet är att AEM WCM QuickStart-fönstret visar"AEM WCM startar och väntar på att servern ska startas…" Om det meddelandet visas under en relativt lång tid anger du AEM WCM-URL:en i webbläsarfönstret manuellt med standardporten 4502 eller den port som instansen körs på: http://localhost:4502/.

Loggar kan också visa orsaken till att webbläsaren inte startas.

Ibland visas meddelandet "AEM WCM som körs på http://localhost:port/" i fönstret AEM WCM QuickStart och webbläsaren startar inte automatiskt. I så fall klickar du på URL:en i AEM WCM QuickStart-fönster (det är en hyperlänk) eller anger URL:en manuellt i webbläsaren.

Om allt annat misslyckas, kontrollera loggarna för att ta reda på vad som har hänt.

Webbplatsen läses inte in och misslyckas ibland med Java 11

Det finns ett känt fel med att AEM 6.5 körs på Java 11 där webbplatsen kanske inte läses in eller misslyckas regelbundet.

Om detta händer, följ nedanstående lösning:

  1. Öppna filen sling.properties under mappen crx-quickstart/conf/

  2. Leta reda på följande rad:

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

  3. Ersätt den med följande:

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

  4. Starta om instansen.

Felsöka installationer med en programserver

Sidan hittades inte när en geometrixx-outdoor-sida begärdes

Gäller WebLogic 10.3.5 och JBoss 5.1

När en begäran om geometrixx-outdoor/en page returnerar 404 (Page Not Foun), kan du kontrollera att du har angett den extra sling-egenskapen i filen sling.properties som behövs för dessa specifika programservrar.

Mer information finns i Distribuera AEM-stegen.

Svarshuvudets storlek kan vara större än 4 kB

502 fel kan indikera att webbservern inte kan hantera storleken på AEM HTTP-svarshuvud. AEM kan generera HTTP-svarshuvuden som innehåller cookies som är större än 4 kB. Kontrollera att serverbehållaren är konfigurerad så att den maximala svarshuvudets storlek kan överskrida 4 kB.

För Tomcat 7.0 styr attributet maxHttpHeaderSize i HTTP Connector begränsningar för rubrikstorlek.

Avinstallerar Adobe Experience Manager

Eftersom AEM installeras i en enda katalog behövs inget avinstallationsverktyg. Avinstallationen kan vara så enkel som att ta bort hela installationskatalogen, men hur du avinstallerar AEM beror på vad du vill uppnå och vilken beständig lagring du använder.

Om beständig lagring är inbäddad i installationskatalogen, till exempel i standardinstallationen av TPM, tas även data bort när du tar bort mappar.

OBSERVERA

Adobe rekommenderar att du säkerhetskopierar databasen innan du tar bort AEM. Om du tar bort hela <cq-installation-directory> tar du bort databasen. Om du vill behålla databasdata innan du tar bort, flyttar eller kopierar du mappen <cq-installation-directory>/crx-quickstart/database någon annanstans innan du tar bort de andra mapparna.

Om din installation av AEM använder extern lagring, till exempel en databasserver, tas inte data bort automatiskt när du tar bort mappen, men lagringskonfigurationen tas bort, vilket gör det svårt att återställa JCR-innehållet.

JSP-filer kompileras inte på JBoss

Om du installerar eller uppdaterar JSP-filer till Experience Manager på JBoss och motsvarande servrar inte kompileras kontrollerar du att JBoss JSP-kompilatorn är korrekt konfigurerad. Mer information finns i
JSP Compilation Issues in JBoss article.

På denna sida