- Go to the list of replication agents (/etc/replication/agents.author.html)
- For each replication agent, do the following:
- Make sure that the agent is enabled.
- Verify the connectivity with the publish instance by clicking Test Connection. If it fails, make sure that on TCP network level, the server hosting the CQ author instance can connect to the port of the publish instance.
- Open the replication log via the "View Log" link and check when the last replication attempt was successful.
- Note the first payload path in the replication queue. Then try to clear the first element of the replication queue. Then, verify whether the replication resumes (starting with CQ5.4). Once it resumes, activate the first payload noted in the queue again.
- Check with the CRX Content Explorer, and make sure that there is no /bin/receive node on the publish instance. Otherwise, delete it.
- Check with the CRX Content Explorer, and make sure that there is no /bin/replicate node on the author instance. Otherwise, delete it.
At that point, we can consider the replications agents are configured correctly. If the logs show no replication attempt for a few minutes, then try the following corrective actions to unblock the queues, in this order, checking between each step if the replication resumes.
- Disable the replication agent, then re-enable it.
- Restart the replication bundle in the Felix console (http://host:port/system/console/bundles/com.day.cq.cq-replication).
- Restart the Apache Sling Event Support bundle (http://host:port/system/console/bundles/org.apache.sling.event).
- Restart the Apache Felix EventAdmin (http://host:port/system/console/bundles/org.apache.felix.eventadmin).
If the above fails, then clearing manually the queue might be the last option.
One can achieve this by getting rid directly of the Sling Jobs with topic =replication agent name.
Quickest way to do this is to use CRXDE Lite (http://host:port/crx/de/index.jsp), and delete the node:
So for example with the default publish agent:
Note this is considered as an exceptional workaround action, contact AEM Support anyway if such a case occurs.
In versions of AEM 5.4 and earlier, replication queues can sometimes be polluted by entries that cannot be removed through the OOTB Clear Queue link.
In this case, you can use the Replication Queue Cleaning tool attached here. It brings enhanced functionalities to clear queue entries.
- Install the attached package using package manager.
- Go to http://<host>:<port>/apps/tools/components/cleanReplication/run.html. Or, go to http://<host>:<port>/etc/replication/agents.author.html. Click your agent and you see various options.
- First do dry run and see if entries are getting deleted.
- Then select all checkboxes and click Run Clean Replication.
- There is also a failed replication Listener configuration. You can configure it to send an email if replication fails.
More details about tool at http://www.wemblog.com/2012/07/how-to-clear-replication-queue-in-cq.html
Disclaimer: The tool was designed by the AEM Support tool, and does not belong to the AEM Product as such. Therefore, it didn't undergo extensive QA, and comes with the same warnings as an official hot fix:
THE HOT FIX PACKAGE IS PROVIDED “AS IS” AND WITHOUT WARRANTY OF ANY KIND, INCLUDING WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, SATISFACTORY QUALITY, LACK OF VIRUSES, TITLE, NON-INFRINGEMENT, ACCURACY OR COMPLETENESS OF RESPONSES, RESULTS, LACK OF NEGLIGENCE AND/OR LACK OF WORKMANLIKE EFFORT. ADOBE DOES NOT WARRANT AGAINST ANY BUG, ERROR, OMISSION, DEFECT, DEFICIENCY, OR NONCONFORMITY IN THE HOT FIX. HOT FIX PACKAGES ARE NOT TESTED BY QA. USE AT YOUR OWN RISK. ADOBE RECOMMENDS THAT THIS HOT FIX PACKAGE BE USED FOR DEVELOPMENT PURPOSES. IF YOU MUST APPLY THIS HOT FIX PACKAGE TO A PRODUCTION SYSTEM, YOU SHOULD THOROUGHLY TEST YOUR APPLICATION. ADOBE CANNOT BE HELD RESPONSIBLE FOR ANY DAMAGE THAT COULD BE CAUSED BY THIS HOT FIX PACKAGE.
Version 1.6: Fixed NPE when accessing Replication agents stored under etc/replication/agents.publish/.