Adobe Experience Manager: Repository requirements for AEM 6.5 LTS SP1, SP2, and SP3
Description description
AEM 6.5 LTS SP1, SP2, and SP3 have known issues that can corrupt the repository and cause a SegmentNotFoundException (SNFE). Apply the required measures to prevent these issues.
This article provides additional guidance on the mandatory requirements documented in the release notes.
Environment
AEM 6.5 LTS Service Pack 1, Service Pack 2, Service Pack 3
Resolution resolution
AEM 6.5 LTS SP1, SP2, and SP3 require the following three mandatory steps. Complete all three steps immediately after you install each service pack.
Requirement 1. Install the hotfix
Download the hotfix for your service pack version from Software Distribution, and then install it with Package Manager.
- AEM 6.5 LTS SP1: cq-6.5.lts.1-hotfix-GRANITE-74366-1.0.zip
- AEM 6.5 LTS SP2: cq-6.5.lts.2-hotfix-GRANITE-74316-1.0.zip
- AEM 6.5 LTS SP3: cq-6.5.lts.3-hotfix-GRANITE-74457-1.0.zip
Requirement 2. Add the Java options
Each version also requires additional Java options. Add the following options to the AEM start script, and restart the AEM instance.
- AEM 6.5 LTS SP1: -Doak.segment.cleanup.skipDanglingFutureReclaim=true
- AEM 6.5 LTS SP2: -Doak.segment.cleanup.skipDanglingFutureReclaim=true -Doak.compaction.legacy=true
- AEM 6.5 LTS SP3: -Doak.segment.cleanup.skipDanglingFutureReclaim=true
Requirement 3. Download the specific oak-run version
Each service pack requires a specific version of the oak-run tool. For offline compaction and other operations that use oak-run, download the version specified in the release notes from Software Distribution, and use that version.
- AEM 6.5 LTS SP1: oak-run-1.78.1-B010.jar
- AEM 6.5 LTS SP2: oak-run-1.88.1-B012.jar
- AEM 6.5 LTS SP3: oak-run-2.4.1-B002.jar
In addition to this article, check the latest release notes for updates.