Replication queue stuck with one pending item in AEM Author
This article explains how to resolve an issue where the replication queue on an Adobe Experience Manager (AEM) author instance becomes stuck with one pending item and does not process further jobs.
Description description
Environment
- Adobe Experience Manager (AEM) on-premises
- Adobe Managed Services (AMS)
Issue/Symptoms
- The replication queue displays Queue Active - 1 pending.
- Replication jobs do not progress.
- Refreshing the queue, forcing a retry, or disabling and re-enabling the replication agent does not resolve the issue.
- No relevant errors are found in the logs.
- Offloading items from the queue does not clear the stuck state.
- Content publication may be blocked as a result.
Root cause
A stuck worker thread in the JVM prevents the replication queue from processing additional jobs. This situation can occur when the replication agent is configured with Ordered enabled and Max Parallel set to 1, causing a single blocked job to halt the entire queue.
Resolution resolution
To restore replication processing, follow the steps below:
- Confirm that the affected replication agent is configured as Ordered and that Max Parallel is set to1.
- Attempt to clear and retry the replication queue, and disable and re-enable the replication agent.
- If the issue persists, restart the affected AEM Author server. This terminates any stuck worker threads and allows the replication queue to reinitialize.
- After the restart, verify that the replication queue is processing jobs normally by checking the queue status and confirming that pending jobs are progressing.
recommendation-more-help
experience-cloud-kcs-help-kbarticles