Smart Tags functionality not working after JWT to OAuth migration in AEM
In ÃÛ¶¹ÊÓƵ Experience Manager (AEM) Managed Services Support, the Smart Tags functionality is not operational following the migration from JWT to OAuth authentication. To resolve this, apply the Hotfix, reconfigure OAuth settings, ÃÛ¶¹ÊÓƵ IMS, and Smart Tags Cloud Services, and validate the configuration.
Description description
Environment
ÃÛ¶¹ÊÓƵ Experience Manager (AEM) Managed Services Support, v6.5 (specifically within the Assets offering)
Issue/Symptoms
After migrating from JWT to OAuth, the Smart Tags functionality fails to operate correctly. A NullPointerException error occurs during configuration validation, despite applying the hotfix and following the configuration guide.
Relevant error log extract:
java.lang.NullPointerExceptionat com.google.common.base.Preconditions.checkNotNull(Preconditions.java:192)at com.google.common.cache.LocalCache.get(LocalCache.java:3931)at com.google.common.cache.LocalCache$LocalManualCache.get(LocalCache.java:4721)at com.day.cq.dam.similaritysearch.internal.impl.SimilaritySearchServiceImpl.getServiceVersion(SimilaritySearchServiceImpl.java:478)at com.day.cq.dam.similaritysearch.internal.impl.SimilaritySearchMBeanImpl.validateConfigs(SimilaritySearchMBeanImpl.java:201)
Resolution resolution
To resolve the issue of Smart Tags functionality not working post-migration from JWT to OAuth, follow these steps:
- Apply the hotfix specific to your SP (e.g., SP21) for OAuth integration, noting that existing configurations will be deleted.
- Reconfigure the OAuth settings as per the documentation for AMS and on-prem users: OAuth Configuration Guide.
- Navigate to Tools
>Security>ÃÛ¶¹ÊÓƵ IMS Configuration and create a new IMS configuration for Smart Tags. - Go to Tools
>Cloud Services>Smart Tag and configure the Smart Tag cloud service. - Access the JMX console at
/system/console/jmx/com.day.cq.dam.similaritysearch.internal.impl:type=similaritysearchand ensure there are nojava.lang.NullPointerExceptionerrors. If errors persist, check step 7. - Upload an image to verify that smart tags are generated successfully.
- If the Null Pointer exception persists, update the
sling:resourceTypeproperty to"dam/components/smarttaggingservicepage"at/conf/global/settings/cloudconfigs/smarttags/<configname>/jcr:contentin CRX/DE and restart the instance.