The CQ5 content replication appears to be blocked.

Editors can create content, but the activated pages are not updated on the CQ5 publish instance.

Make sure that each replication agent is enabled and configured correctly.

  1.  Go to the list of replication agents (/etc/replication/agents.author.html)
  2.  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.

Restart replication agents and related bundles

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.

  1. Disable the replication agent, then re-enable it.
  2. Restart the replication bundle in the Felix console (http://host:port/system/console/bundles/com.day.cq.cq-replication).
  3. Restart the Apache Sling Event Support bundle (http://host:port/system/console/bundles/org.apache.sling.event).
  4. Restart the Apache Felix EventAdmin (http://host:port/system/console/bundles/org.apache.felix.eventadmin).

Force the queue clearance by deleting corresponding Sling Jobs

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:

/var/eventing/jobs/assigned/%INSTANCE-SLING-ID%/%REPLICATION-AGENT-FULL-ID%

So for example with the default publish agent:

/var/eventing/jobs/assigned/e23dd09d-83f1-4735-a77c-394df479214c/com.day.cq.replication.job.publish

Note this is considered as an exceptional workaround action, contact AEM Support anyway if such a case occurs. 

Use the Replication Queue Cleaning assistant (ONLY WITH CQ <= 5.4)

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.

  1. Install the attached package using package manager.
  2. 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.
  3. First do dry run and see if entries are getting deleted.
  4. Then select all checkboxes and click Run Clean Replication.
  5. 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.

Change log:

Version 1.6: Fixed NPE when accessing Replication agents stored under etc/replication/agents.publish/.

Download

Applies to

  • CQ 5.2.1
  • CQ 5.3
  • CQ 5.4
  • CQ 5.5
  • AEM 5.6.x

 

Other Related Articles:

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy