Upgrade instructions for the 5.2.0 Service Pack 1 release (September 2026)
This article covers the upgrade instructions and the compatibility matrix for 5.2.0 Service Pack 1 release of Adobe Experience Manager Guides.
For more information about the new features and enhancements, view What’s new in the 5.2.0 Service Pack 1 release.
For the list of issues that have been fixed in this release, view Fixed issues in the 5.2.0 Service Pack 1 release.
Compatibility matrix
This section lists the compatibility matrix for the software applications supported by Experience Manager Guides 5.2.0 Service Pack 1 release.
For more details, view the Technical requirements section in the On-Premise Installation and Configuration Guide.
Java SDK resources
Use the following resources when developing custom Java plugins or integrations with Experience Manager Guides. Ensure that the SDK version matches your installed Experience Manager Guides release.
For more details, view Configure and use the API JAR from Maven Central repository.
FrameMaker and FrameMaker Publishing Server
Oxygen Connector
Knowledge base template version
New AEM Site template version
Prerequisites
Before you start the Experience Manager Guides 5.2.0 Service Pack 1 upgrade process, ensure that you have:
- Upgraded to Experience Manager Guides version 5.2.0.
- (Optional) Closed all translation tasks.
- Changed the log level to INFO for
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptclass and append these logs in a new log file, for example,logs/translation_upgrade.log.
Upgrade path for Experience Manager Guides 5.2.0 Service Pack 1
You can easily upgrade your current version of Experience Manager Guides to version 5.2.0 Service Pack 1 on AEM 6.5 or AEM 6.5 LTS.
- For AEM 6.5 LTS: Experience Manager Guides 5.2.0 Service Pack 1 is supported only with AEM 6.5 LTS Service Pack 2.
- For AEM 6.5: Experience Manager Guides 5.2.0 Service Pack 1 is supported only with AEM 6.5 Service Pack 24, 23,and 22.
- If you are currently on AEM 6.5 and plan to move to AEM 6.5 LTS, make sure to complete the AEM upgrade first before proceeding with the Experience Manager Guides 5.2.0 upgrade. For details, view Upgrading to Adobe Experience Manager (AEM) 6.5 LTS.
- If you are currently on AEM 6.5 and plan to move to AEM 6.5 Service Pack 24 or later, make sure to complete the AEM upgrade first. Once done, reinstall the Experience Manager Guides 5.2.0. before installing Experience Manager Guides 5.2.1.
Before you proceed with upgrading to version 5.2.0 Service Pack 1 of Experience Manager Guides, you must consider the following points:
- If you are using version 5.2.0, then you can directly upgrade to version 5.2.0 Service Pack 1.
- If you are using version 5.0.0, 5.0.3, 5.1.0, 5.1.3 or 5.1.4, then you can directly upgrade to version 5.2.0.
- If you are using version 4.6.3, 4.6.4, 5.0.x, then you can directly upgrade to version 5.1.0.
- If you are using version 4.6.0, 4.6.1, then you need to upgrade to version 4.6.3 or 4.6.4 or 5.0.0 before upgrading to version 5.1.0.
- If you are using version 4.3.x, 4.2, 4.2.1 (Hotfix 4.2.1.3), 4.1, or 4.1.x then you need to upgrade to version 4.4 before upgrading to version 5.1.0.
- If you are using version 4.0 you need to upgrade to version 4.2 before upgrading to version 4.3.x.
- If you are using version 3.8.5, you need to upgrade to version 4.0 before upgrading to version 4.2.
- If you are on a version prior to 3.8.5, refer to the Upgrade Experience Manager Guides section in the product-specific installation guide available on Adobe Experience Manager Guides help PDF archive.
Upgrade process for Experience Manager Guides 5.2.0 Service Pack 1
- Download the 5.2.0 Service Pack 1 version package from Adobe Software Distribution Portal.
- Install the version package on which you want to upgrade and wait till the bundle is installed.
- (Optional) Upgrade Oxygen connector plugin released with version you are upgrading to.
- Clear the browser cache after installing the package.
- If you have enabled the setting
Enable markup find and replaceto access the Find and replace feature in source view for previously captured content, you must reindex theguidesAssetLuceneindex. For details, view Reindexing for Find and replace.