Oak-run.jar 색인화 사용 사례 oak-run-jar-indexing-use-cases

Oak-run은 AEM JMX 콘솔을 통해 이러한 사용 사례의 실행을 오케스트레이션하지 않고도 명령줄에서 인덱싱 사용 사례를 지원합니다.

oak 색인 관리에 oak-run.jar index 명령 접근 방식을 사용하면 다음과 같은 중요한 이점이 있습니다.

아래 섹션에서는 샘플 명령을 제공합니다. Oak-run index 명령은 모든 NodeStore 및 BlobStore 설정을 지원합니다. 아래에 제공된 예제는 FileDataStore 및 SegmentNodeStore가 있는 설정에 관한 것입니다.

사용 사례 1 - 색인 일관성 검사 usercase1indexconsistencycheck

이는 색인 손상과 관련된 사용 사례입니다. 어떤 색인이 손상되었는지 확인할 수 없는 경우가 있었습니다. 따라서 Adobe은 다음과 같은 도구를 제공합니다.

손상된 인덱스 확인은 다음을 통해 수행할 수 있습니다. --index-consistency-check 작업:

java -jar oak-run*.jar index --fds-path=/path/to/datastore  /path/to/segmentstore/ --index-consistency-check

다음에서 보고서를 생성합니다. indexing-result/index-consistency-check-report.txt. 샘플 보고서는 아래를 참조하십시오.

Valid indexes :
        - /content/oak:index/enablementResourceName
        - /oak:index/cqProjectLucene
        - /oak:index/cqTagLucene
        - /oak:index/lucene
        - /oak:index/ntBaseLucene
        - /oak:index/socialLucene
    Invalid indexes :
        - /oak:index/atDamIndex
        - /oak:index/atIndex
        - /oak:index/cqPageLucene
        - /oak:index/damAssetLucene
        - /oak:index/groups
        - /oak:index/slingeventJob
        - /oak:index/users
        - /oak:index/workflowDataLucene
    Ignored indexes as these are not of type lucene:
        - /oak:index/acPrincipalName
        - /oak:index/active

이점 uc1benefits

이제 지원 센터 및 시스템 관리자가 이 도구를 사용하여 손상된 색인을 신속하게 확인한 다음 다시 색인화할 수 있습니다.

사용 사례 2 - 색인 통계 usecase2indexstatistics

쿼리 성능 Adobe과 관련된 일부 사례를 진단하기 위해 종종 기존 색인 정의, 고객 설정의 색인 관련 통계가 필요합니다. 지금까지 이 정보는 여러 자원에 분산되어 있었습니다. 보다 쉽게 문제를 해결할 수 있도록 Adobe은 다음과 같은 도구를 만들었습니다.

이제 다음 작업 인덱스 명령을 사용하여 위의 작업을 수행할 수 있습니다.

실제로 명령이 작동하는 방식에 대한 예는 아래를 참조하십시오.

java -jar oak-run*.jar index --fds-path=/path/to/datastore  /path/to/segmentstore/ --index-info --index-definitions --index-dump

보고서는에서 생성됩니다. indexing-result/index-info.txt 및 indexing-result/index-definitions.json

또한 웹 콘솔을 통해 동일한 세부 정보가 제공되며 구성 덤프 zip의 일부가 됩니다. 다음 위치에서 액세스할 수 있습니다.

https://serverhost:serverport/system/console/status-oak-index-defn

이점 uc2benefits

이 도구를 사용하면 인덱싱 또는 쿼리 문제와 관련된 모든 필수 세부 정보를 빠르게 수집할 수 있으며 이 정보를 추출하는 데 소요되는 시간을 줄일 수 있습니다.

사용 사례 3 - 리인덱싱 usecase3reindexing

에 따라 시나리오, 경우에 따라 리인덱싱을 수행해야 합니다. 현재, 리인덱싱은 reindex 플래그 지정 대상 true CRXDE 또는 Index Manager 사용자 인터페이스를 통해 색인 정의 노드 플래그가 설정되면 리인덱싱이 비동기적으로 수행됩니다.

리인덱싱과 관련하여 몇 가지 주의할 사항:

이러한 목표를 달성하기 위해 oak-run 인덱스 툴은 필요에 따라 사용할 수 있는 다양한 리인덱싱 모드를 지원합니다. oak-run index 명령은 다음과 같은 이점을 제공합니다.

색인 재지정 - DocumentNodeStore reindexdocumentnodestore

대상 DocumentNodeStore 설치 리인덱싱은 단일 oak-run 명령을 통해 수행할 수 있습니다.

java -jar oak-run*.jar index --reindex --index-paths=/oak:index/lucene --read-write --fds-path=/path/to/datastore mongodb://server:port/aem

이를 통해 다음과 같은 이점이 있습니다

색인 재지정 - SegmentNodeStore reindexsegmentnodestore

대상 SegmentNodeStore 설치 리인덱싱은 다음 방법 중 하나로 수행할 수 있습니다.

온라인 색인 재지정 - SegmentNodeStore onlinereindexsegmentnodestore

재색인화가 설정의 방식으로 수행되는 기존 방법을 따르십시오. reindex 플래그.

온라인 색인 재지정 - SegmentNodeStore - AEM 인스턴스가 실행 중입니다. onlinereindexsegmentnodestoretheaeminstanceisrunning

대상 SegmentNodeStore 설치에서는 하나의 프로세스만 읽기/쓰기 모드에서 세그먼트 파일에 액세스할 수 있습니다. 이로 인해 oak-run 인덱싱의 일부 작업에는 추가 수동 단계를 수행해야 합니다.

여기에는 다음과 같은 항목이 포함됩니다.

이 시나리오에서는 AEM 서버를 중지하거나 새 인스턴스를 프로비저닝할 필요가 없습니다. 그러나 인덱싱에는 전체 저장소 순회가 포함되므로 설치 시 I/O 로드가 증가하여 런타임 성능에 부정적인 영향을 줍니다.

온라인 색인 재지정 - SegmentNodeStore - AEM 인스턴스가 종료됨 onlinereindexsegmentnodestoreaeminstanceisdown

대상 SegmentNodeStore 설치, 리인덱싱은 단일 oak-run 명령을 통해 수행할 수 있습니다. 단, AEM 인스턴스를 종료해야 합니다.

다음 명령을 사용하여 리인덱싱을 트리거할 수 있습니다.

java -jar oak-run*.jar index --reindex --index-paths=/oak:index/lucene --read-write --fds-path=/path/to/datastore  /path/to/segmentstore/

이 접근 방식과 위에서 설명한 접근 방식의 차이점은 체크포인트 생성과 인덱스 가져오기가 자동으로 수행된다는 것입니다. 단점은 이 과정에서 AEM이 다운돼야 한다는 점이다.

대역 외 리인덱스 - SegmentNodeStore outofbandreindexsegmentnodestore

이 사용 사례에서는 복제된 설정에서 리인덱싱을 수행하여 실행 중인 AEM 인스턴스에 미치는 영향을 최소화할 수 있습니다.

이 사용 사례에서는 다음과 같은 경우에는 불가능한 다른 인스턴스에서 데이터 저장소에 액세스할 수 있다고 가정합니다. FileDataStore 는 EBS와 같은 클라우드 기반 스토리지 솔루션에 배치됩니다. 다음의 시나리오는 제외됩니다. FileDataStore 또한 복제됩니다. 인덱스 정의가 전체 텍스트 색인화를 수행하지 않으면 다음에 액세스합니다. DataStore 은 필수가 아닙니다.

사용 사례 4 - 색인 정의 업데이트 usecase4updatingindexdefinitions

현재 다음을 통해 색인 정의 변경 사항을 전달할 수 있습니다. ACS 인덱스 확인 패키지. 이렇게 하면 콘텐츠 패키지를 통해 색인 정의를 전달할 수 있으며 나중에 색인 재지정을 설정하여 수행해야 합니다. reindex 플래그 지정 대상 true.

이 기능은 리인덱싱하는 데 시간이 오래 걸리지 않는 소규모 설치에 적합합니다. 그러나 큰 저장소의 경우 리인덱싱은 훨씬 더 많은 시간 내에 수행됩니다. 이러한 경우 이제 oak-run 인덱스 도구를 사용할 수 있습니다.

Oak-run은 이제 JSON 형식으로 색인 정의를 제공하고 라이브 인스턴스에서 변경 사항이 수행되지 않는 대역 외 모드에서 색인 생성을 지원합니다.

이 사용 사례에서 고려해야 할 프로세스는 다음과 같습니다.