설명서Experience Cloud KCS

AEM Forms 6.5에서 워크플로우 동기화 중 SegmentNotFoundException 해결

마지막 업데이트: 2026년 8월 15일

이 문서에서는 특히 전체 저장소 압축이 대량 쓰기 작업과 겹치는 경우 예약된 유지 관리 후 Adobe Experience Manager(AEM) Forms 6.5에서 발생할 수 있는 워크플로우 동기화 실패와 SegmentNotFoundException 오류를 해결하는 방법에 대해 설명합니다.

설명 description

환경

Adobe Experience Manager(AEM) Forms 6.5(OSGi, 독립 실행형)

문제/증상

  • 예약된 유지 관리 후에 워크플로우 동기화가 실패하거나 누락되었습니다.
  • 영향을 받는 기간 동안에는 양식 제출 및 워크플로우를 진행할 수 없습니다.
  • 잠시 후 문제가 자동으로 해결됩니다.
  • 영향을 받는 워크플로 작업의 로그에 다음 오류가 표시됩니다. org.apache.jackrabbit.oak.segment.SegmentNotFoundException
  • 이 문제는 간단한 유지 관리 작업이 아닌 전체 압축이 실행되는 날에 따라 다릅니다.

원인

이 문제는 전체 압축 프로세스가 활성 워크플로우 작업에서 여전히 참조되는 이전 세대 TAR 파일을 다시 호출하기 때문에 발생합니다. 대량 쓰기 작업(예: 전체 LDAP 동기화)이 전체 압축과 겹치는 경우 진행 중인 워크플로우에 필요한 세그먼트가 삭제되어 SegmentNotFoundException 오류가 발생합니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 따르십시오.

  1. 낮은(비프로덕션) 환경에서 절차를 확인하여 명령, 예상 출력 및 전반적인 프로세스를 파악합니다.

  2. 프로덕션을 변경하기 전에 저장소의 완전하고 일관된 백업 또는 스냅샷을 만듭니다.

  3. oak-run 도구를 사용하여 저장소 일관성 검사를 수행합니다.

    1. 저장소 수준 작업을 실행하기 전에 AEM 인스턴스가 오프라인 상태인지 확인하십시오.

    2. 다음 명령을 실행합니다(<path-to-oak-run.jar> 및 <path-to-repository>을(를) 실제 경로로 바꾸기).

      java -jar <path-to-oak-run.jar> check <path-to-repository>

    3. 다운타임을 최소화하기 위해 가능한 경우 운영 저장소의 백업 복사본에 대해 분석을 실행합니다.

  4. LDAP 동기화 및 전체 압축 작업의 일정을 검토 및 조정하여 특히 쓰기 작업이 많은 작업 중에 겹치지 않도록 합니다. 다른 시간에 전체 압축을 실행하거나 압축을 실행하는 동안 과도한 쓰기 작업이 발생하지 않도록 하십시오.

  5. 변경 사항을 구현한 후 워크플로우 실행을 모니터링하고 SegmentNotFoundException 오류가 반복되는지 기록합니다.

  6. AEM error.log 및 워크플로우 로그에서 SegmentNotFoundException 패턴을 확인하십시오.

  7. 문제가 지속되면 일관성 검사를 반복하고 작업 일정을 검토하여 추가 조정을 수행합니다.

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