aem-replication

Configure, execute, and troubleshoot content replication for AEM 6.5 LTS environments.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill aem-replication-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aem-replication
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/aem-replication
Command: npx skills add https://github.com/aemgdc/aemdev --skill aem-replication-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing content distribution in Adobe Experience Manager 6.5 LTS requires coordinating replication agents, activation methods, programmatic APIs, and queue troubleshooting, and this Skill routes each request to the correct specialist workflow. ## Core Features & Use Cases - Agent Configuration: Set up default, Dispatcher Flush, and reverse replication agents with security best practices. - Content Activation: Publish and unpublish content via Quick Publish, Manage Publication, tree activation, packages, workflows, and scheduled on/off times. - Replication API: Use the Replicator, ReplicationOptions, ReplicationStatus, AgentManager, and ReplicationQueue Java APIs in custom OSGi services, servlets, and workflow steps. - Troubleshooting: Diagnose blocked queues, 401 errors, SSL failures, stale Dispatcher caches, and stuck Sling event jobs. - Use Case: When a production incident blocks the publish queue, the orchestrator workflow guides you through symptom gathering, root-cause diagnosis, fix implementation, and verification. ## Quick Start Ask the assistant to configure a default replication agent from Author to Publish in AEM 6.5 LTS and verify connectivity with a test page.

Frequently Asked Questions about aem-replication

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a replication agent in AEM 6.5?▼

Create the agent under Tools, Deployment, Replication on the Author instance, set the transport URI to the Publish receive servlet, provide service user credentials, and enable it. Test connectivity with the agent's test page before activating content.

How do I publish content programmatically in AEM 6.5?▼

Inject the Replicator OSGi service and call replicate with a JCR Session, ReplicationActionType.ACTIVATE, and the content path. Use ReplicationOptions to control synchronous execution, agent filtering, and version suppression.

Why is my AEM replication queue blocked?▼

Blocked queues usually result from network failures, expired credentials, or an unavailable Publish instance, and the first failed item blocks all subsequent FIFO entries. Force retry the failed item, clear it, or restart the replication bundles after fixing the root cause.

Does the AEM Replication API work in AEM as a Cloud Service?▼

No, AEM as a Cloud Service replaces replication agents with the Sling Distribution API and platform-managed content distribution. Custom code using com.day.cq.replication must be refactored to Cloud Service publishing workflows during migration.

Why is published content not appearing on the Dispatcher?▼

The Dispatcher cache was likely not invalidated because the flush agent is disabled or misconfigured. Verify the flush agent on Publish points to the dispatcher invalidate.cache endpoint and that dispatcher.any allows the Publish instance in allowedClients.