AEM 6.5.21 AEM ACS Commons 5.3.4 : Clientlibs version not updating with deploy | Community
Skip to main content
New Member
February 7, 2025

AEM 6.5.21 AEM ACS Commons 5.3.4 : Clientlibs version not updating with deploy

  • February 7, 2025
  • 4 replies
  • 1270 views

Hi all - We are seeing an issue with versioning of clientlib after every deploy. We do not see clientlib cache getting clear which results in previous version# being returned even for an updated js/css file after deploy. We have to manually go and "touch" js.txt/css.txt file to see updated version. If we reduce md5 cache size to 0, we see updated version# after each deploy, this leads me to believe that ACS Commons is not able to update cache after each deploy. Can anyone help?

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.

4 replies

Shashi_Mulugu
Community Advisor
Community Advisor
February 8, 2025

@mayanksa can you please explain where you are seeing this issue? Author or publisher or dispatcher or CDN?

 

If it is at CDN or load balancer, do you have multiple publishers taking load?

MayankSaAuthor
New Member
February 10, 2025

This issue is on publish servers and has nothing to do with dispatcher/CDN. Issue is that ACS commons is unable to generate a new hash after deployment for clientlibs which is causing issues after deployment as old/stale versioned clientlibs are used

ManviSharma
Adobe Employee
Adobe Employee
February 9, 2025

Hi Mayank,

The issue you're experiencing is related to clientlib caching and versioning in AEM.

Possible Causes:

  1. Clientlib Caching: After deployment, updated clientlibs may not be immediately visible due to caching at both the browser and AEM levels.
  2. Version Hash Not Updating: AEM uses version hashes to manage clientlib updates. If the hash isn't updated due to configuration issues, old files may still be served.
  3. ACS Commons Versioned Clientlibs Conflict: If you're using ACS Commons for versioned clientlibs, it may conflict with AEM’s built-in versioning mechanism, especially in AEM as a Cloud Service.

Solutions:

1. Enable Strict Clientlib Versioning

Ensure that the OSGi configuration for Adobe Granite HTML Library Manager (com.adobe.granite.ui.clientlibs.impl.HtmlLibraryManagerImpl) has strict clientlib versioning enabled. You can also configure long-term cache keys, such as /.*;auto, in this setting.

2. Rebuild Clientlibs

Rebuilding clientlibs forces AEM to recompile them:

  • Use the /libs/granite/ui/content/dumplibs.rebuild.html endpoint to rebuild libraries. (This is typically restricted to author instances.)
  • For publish instances, you may need assistance from the CSME team to rebuild clientlibs.

Reference Documentation:

Content Consistency and Caching in AEM

 

SreenivasBr
Level 4
February 10, 2025

I have faced the same issue.

Workaround : Disable the versioning in the ACS Commons Versioned Clientlibs OSGi Config and then enable it back. It will start working.

Possible Solution : AEM supports clientlibs versioning OOTB. Refer - https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/implementing/content-delivery/caching#content-consistency

 

MayankSaAuthor
New Member
February 10, 2025

We are not on AEMCaaS, we rely on ACS Common for clientlib versioning. Enabling/disabling versioning with every release is not feasible in production. Hence i reached out to community to understand if others have run into this issue and possible solution

kautuk_sahni
Community Manager
Community Manager
February 18, 2025

@mayanksa Did you find the suggestions helpful? Please let us know if you need more information. If a response worked, kindly mark it as correct for posterity; alternatively, if you found a solution yourself, we’d appreciate it if you could share it with the community. Thank you!

Kautuk Sahni