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.

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.

In addition to this article, check the latest release notes for updates.

recommendation-more-help
experience-cloud-kcs-help-kbarticles