Troubleshoot QCDR Entitlement Revalidation and Scheduler Health

QCDR entitlement above Basic depends on one canonical Joomla Scheduled Task: QC Dynamic Replacer Entitlement Revalidation. Diagnose task structure and actual scheduler execution separately; recreating tasks does not fix a Joomla runner that is not waking up.

Read Entitlement Automation Integrity

Open QCDR → Status. The card reports the Task plugin, number of published canonical tasks, validation cadence, Last execution, Last exit code, and Next execution.

A structurally healthy installation needs the QCDR Task plugin installed/enabled with its files present, Joomla Scheduled Tasks available, exactly one published canonical task, and a cadence between 1 and 60 minutes.

Interpret the Common Structural Failures

  • Missing task: the canonical task row does not exist.
  • Unpublished/disabled: no canonical task is enabled.
  • Duplicate: more than one canonical Entitlement Revalidation task is enabled.
  • Too slow: cadence is greater than 60 minutes or cannot be determined as valid.
  • Task plugin problem: plugin disabled or files missing.

Any structural failure makes paid/preview Effective entitlement fall back to Basic as a security measure.

Use Repair Entitlement Task When Appropriate

A Joomla Super User can use Repair Entitlement Task when QCDR reports repair is possible. Repair enables the Task plugin, creates/normalizes the canonical task, publishes the canonical row, restores the required cadence, and disables duplicate candidates.

If the physical Task plugin files are missing, reinstall the current QCDR package instead of repeatedly pressing Repair.

If Structure Is Healthy but Runs Are Late

Look at Last execution, Last exit code, and Next execution. A non-zero last exit code indicates the most recent run failed. If Next execution is overdue while the task is structurally correct, verify that a Joomla scheduler runner is active.

Low-traffic sites often need a reliable external/CLI/webcron-style Joomla scheduler wake-up strategy. Do not create a second QCDR task to compensate for a runner that is not executing scheduled work.

Refresh After Repair

Once task structure and Joomla scheduler execution are healthy, use Refresh Entitlement and confirm the Status card returns to the expected Base/Effective tier and future automatic check timing.

Community Discussion

Want to compare workflows, share practical tips, or discuss how you use this QCDR feature? Visit the QC Dynamic Replacer Community. For private support, bug reports, account-specific issues, or feature requests, use the QuantaCade support system.