DocumentationAEM 6.4Administering Guide

Troubleshooting AEM troubleshooting-aem

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

The following section covers some issues that you may encounter when using AEM, together with suggestions on how to troubleshoot them.

NOTE
If you are troubleshooting authoring issues in AEM, see Troubleshooting for Authors.
NOTE
When experiencing problems it is also worthwhile checking the list of Known Issues for your instance (release and service packs).

Troubleshooting scenarios for Administrators troubleshooting-scenarios-for-administrators

The following table provides an overview of problems administrators may need to troubleshoot:

Role(s)
Problem
System Administrator
Double-clicking the Quickstart jar does not have any effect or opens the jar file with another program (for example, archive manager)
System Administrator
My application running on CRX throws out-of-memory errors
System Administrator
The AEM Welcome screen does not display in the browser after double-clicking AEM CM Quickstart

System Administrator

admin user

Making a Thread Dump

System Administrator

admin user

Checking for unclosed JCR sessions

Installation Issues installation-issues

See Common Installation Issues for information about the following troubleshooting scenarios:

  • Double-clicking the Quickstart jar has no effect or the JAR file with another program (such as archive manager).
  • Applications running on CRX throw out-of-memory errors.
  • The AEM Welcome screen does not display in the browser after double-clicking AEM Quickstart.

Methods for Troubleshooting Analysis methods-for-troubleshooting-analysis

Making a Thread Dump making-a-thread-dump

The thread dump is a list of all the Java threads that are currently active. If AEM does not respond properly, the thread dump can help you identify deadlocks or other problems.

Using Sling Thread Dumper using-sling-thread-dumper

  1. Open the AEM Web Console; for example at http://localhost:4502/system/console/.

  2. Select the Threads under Status tab.

screen_shot_2012-02-13at43925pm

Using jstack (command line) using-jstack-command-line

  1. Find the PID (process id) of the AEM Java instance.

    For example, you can use ps -ef or jps.

  2. Run:

    jstack <pid>

  3. This will show the thread dump.

NOTE
You can append the thread dumps to a log file by using the >> output redirection:
jstack <pid> >> /path/to/logfile.log

See the How to take Thread Dumps from a JVM documentation for more information

Checking for unclosed JCR sessions checking-for-unclosed-jcr-sessions

When functionality is developed for AEM WCM, JCR Sessions may be opened (comparable to opening a database connection). If the opened sessions are never closed, your system may experience following symptoms:

  • The system becomes slower.
  • You can see a lot of CacheManager: resizeAll entries in the log file; the following number (size=<x>) shows the number of caches, each sessions opens several caches.
  • From time to time the system runs out of memory (after a few hours, days, or weeks - depending on the severity).

To analyze unclosed sessions and find out which code is not closing a session, refer to the Knowledge Base article Analyze Unclosed Sessions.

Using the Adobe Experience Manager Web Console using-the-adobe-experience-manager-web-console

The status of the OSGi bundles can also give an early indication of possible issues.

  1. Open the AEM Web Console; for example at http://localhost:4502/system/console/.

  2. Select Bundles under OSGI tab.

  3. Check:

    • the Status of the bundles. If any are Inactive or Unsatisfied, then try to stop and restart the bundle. If the issue persists then you may need to investigate further using other methods.
    • whether any of the bundles have missing dependencies. Such details can be seen by clicking on the individual bundle Name, which is a link (the following example does not have any issues):

screen_shot_2012-02-13at44706pm

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8