Truststore restoration failure after AEM LTS upgrade and content refresh

Truststore fails to restore correctly in Adobe Experience Manager (AEM) after upgrading to a Long-Term Support (LTS) version and performing a content refresh from a production to a development environment.

Description description

Environment

  • Adobe Experience Manager (AEM) 6.5.21 or later
  • Content refresh from production to development environment

Symptoms

  • Truststore fails to restore correctly after upgrade and content refresh
  • SAML authentication is impacted
  • Unable to access the AEM Author login page over HTTPS

Cause

The issue is caused by conflicting SAML-related packages or configurations that persist after the content refresh, interfering with truststore restoration and authentication functionality.

Resolution resolution

Follow these steps to resolve the issue.

  1. Identify and uninstall any SAML-related packages or configurations that may have been carried over during the content refresh.
  2. Remove any environment-specific SAML configuration paths from the repository using CRX/DE, especially those not required in the target environment.
  3. Reinstall the required deployment package for your environment to ensure all necessary components are present.
  4. Validate that authentication access is restored and that the AEM Author login page is accessible via HTTPS.
  5. To prevent recurrence, ensure that unnecessary SAML-related configurations are removed from all environments before performing future content refreshes.
recommendation-more-help
experience-cloud-kcs-help-kbarticles