AEM Publisher displays incorrect content after SegmentNotFoundException following OS patching
Resolve an issue where an Adobe Experience Manager (AEM) Publisher instance displays incorrect or outdated content after OS patching because of SegmentNotFoundException errors. Clone a new publisher instance from a healthy one and update your load balancer.
Description description
After performing OS patching and restarting an AEM Publisher instance, the instance displays incorrect or outdated content. This can occur when repository segment errors lead to SegmentNotFoundException, which blocks content replication and causes some content or nodes to become unreadable or corrupted. Other publisher instances in the environment may continue to function normally and serve the correct content.
Environment
Adobe Experience Manager (AEM) Managed Services (all versions)
Symptoms
- Publisher instance displays outdated or incorrect content.
- Content replication to the affected publisher is blocked.
- SegmentNotFoundException errors appear in logs.
- Some content or nodes are unreadable or corrupted.
Cause
Repository segment errors resulting in SegmentNotFoundException can block content replication and cause content corruption. This issue can surface after an OS patch and restart, but is not necessarily caused by the patching itself.
Resolution resolution
Complete the following steps to resolve the issue.
-
Validate repository health on the affected publisher instance by running an index consistency check to confirm index validity and identify any unreadable or corrupted nodes.
-
Assess the extent of repository corruption. If corruption is widespread (many unreadable nodes), targeted node removal is not practical and could result in significant data loss.
-
Restore from a healthy instance:
- Clone a new publisher instance from a validated, healthy publisher instance in your environment.
- Update your load balancer configuration to direct traffic to the new, healthy publisher instance.
- Remove the affected publisher instance from the load balancer to prevent serving incorrect content.
-
Verify that the new publisher instance serves the correct content and functions as expected.
-
Once validated, add the new publisher/dispatcher pair back to the load balancer.
Related reading
Fix inconsistencies in repository when SegmentNotFound reported in AEM 6.x