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