HTTP 503 error due to incompatible S3 connector in AEM SP22/SP23
Description description
Environment
Adobe Experience Manager (AEM)
Issue/Symptoms
-
AEM becomes inaccessible after upgrading to Service Pack 22 or 23 with S3 datastore enabled
-
Displays HTTP ERROR 503:AuthenticationSupport service missing. Cannot authenticate request.
-
Logs show unresolved OSGi dependencies during startup, including:
- ERROR: Bundle ‘751’ Error starting … oak-blob-cloud-1.22.6.jar …
- Unable to resolve … osgi.wiring.package=org.apache.jackrabbit.guava.common.base(version
>=33.2.0)(!(version>=34.0.0))
Cause
The issue occurs due to incompatibility between the S3 Connector version (oak-blob-cloud-1.22.6.jar) and AEM Service Pack 22 or 23. The connector relies on specific versions of supporting libraries, such as Guava, which are mismatched in the upgraded environment. As a result, OSGi fails to resolve dependencies, preventing AEM from starting.
Resolution resolution
-
Confirm Connector Compatibility:
- For AEM SP22 or SP23, use S3 Connector v1.10.22.
- Download the required JARs from Adobe Distribution or Software Distribution.
-
Upgrade AEM Service Pack:
- Upgrade to SP22 or SP23 following Adobe’s standard documentation.
- AEM may fail to start due to an incompatible S3 connector.
-
Remove Incompatible Connector:
- Stop the AEM instance.
- Back up the following directory:
<aem-install>/crx-quickstart/install/ - Delete all contents of the install folder to remove old connector JARs and bundles.
-
Clear OSGi State:
- Start AEM and let it run for about 1 minute.
- Stop the instance again to ensure stale OSGi references are cleared.
-
Copy the v1.10.22 S3 connector JARs and any custom configuration files back into:
<aem-install>/crx-quickstart/install/ -
Start the AEM instance.
AEM should now start successfully with all OSGi dependencies resolved.