Documentation

cq-dam-cfm-graphql bundle activation failure after upgrade in AEM

Last update: Mon Feb 16 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

After upgrading to AEM 6.5.21 (this is not a version‑specific issue, so it can occur on any version) and installing the Forms add-on package, the cq-dam-cfm-graphql bundle fails to start due to unresolved dependencies related to com.adobe.cq.ui.wcm.commons. This issue is caused by a missing or incorrect configuration in the FilterResolverHookFactory component, which prevents the required dependency from resolving correctly. To fix this issue, update the configuration to restore the required package resolution.

Description description

Environment

Adobe Experience Manager (AEM) Forms, v6.5.21

Issue/Symptoms

  • The cq‑dam‑cfm‑graphql bundle fails to start and remains in an unresolved state.
  • Error logs show unresolved osgi.wiring.package dependencies for com.adobe.cq.ui.wcm.commons because of version constraints.
  • The error message references FilterResolverHookFactory preventing resolution due to invalid component configuration.
  • The Forms add-on package disappears from Package Manager after installation and restart.

Resolution resolution

To fix this issue, follow these steps:

  1. Open the OSGi Web Console at /system/console/configMgr on the affected server.
  2. Find the configuration for com.adobe.granite.apicontroller.FilterResolverHookFactory.
  3. Compare this configuration with a working server where the cq-dam-cfm-* bundles are active.
  4. Add or correct the entries to include cq-dam-cfm-* under the com.adobe.cq.ui.commons package, as observed on a working server.
  5. Save the configuration and apply the changes.
  6. Refresh or restart bundles using /system/console/bundles.
  7. Verify that the cq-dam-cfm-graphql bundle transitions to an active state and no longer reports unresolved dependencies.

Note: If the issue continues after you update the configuration, check that all relevant service packs and add‑ons are installed according to the official AEM 6.5.21 release notes, and compare bundle versions across servers if needed.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f