설명서AEM 6.5 LTS사용 안내서

Oak 업그레이드를 사용하여 AEM 6.5에서 AEM 6.5로 LTS 컨텐츠 마이그레이션 aem-65-to-aem-65lts-content-migration-using-oak-upgrade

Last update: Fri Jan 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager 6.5 LTS
  • 주제:

작성 대상:

  • 관리자

이 문서에서는 컨텐츠 리포지토리 마이그레이션에 중점을 두고 Adobe Experience Manager을 6.5​에서 6.5 LTS(으)로 업그레이드하는 방법에 대해 설명합니다. Oak 업그레이드 도구를 사용하여 저장소 간에 정밀하고 정확하게 컨텐츠를 전송하는 방법에 대해 설명합니다.

사전 요구 사항 prerequisites

마이그레이션을 시작하기 전에 다음 요구 사항이 충족되는지 확인하십시오.

  1. Java 호환성: AEM 6.5 LTS가 Java™ 17에서 실행되도록 설치 및 구성되어야 합니다. 설정되면 AEM 인스턴스를 시작하고 모든 번들이 활성 상태이며 문제 없이 실행되는지 확인합니다
  2. 시스템 리소스: 마이그레이션 프로세스 중에 두 저장소를 모두 처리할 수 있는 적절한 디스크 공간 및 메모리를 확보하십시오
  3. Oak 업그레이드 도구: oak-upgrade공식 Maven 저장소에서 ​ jar를 다운로드합니다. 버전이 AEM 6.5 LTS에서 사용되는 Oak-core 버전과 일치하는지 확인합니다. Oak 업그레이드 도구는 Oracle® Java™ 11 이상에서 실행됩니다

마이그레이션 프로세스 step-by-step-migration-process

AEM 6.5 및 AEM 6.5 LTS 중지 stopping-aem65-and-aem65lts

마이그레이션을 시작하기 전에 AEM 6.5 및 AEM 6.5 LTS 인스턴스를 중지합니다. 이렇게 하면 저장소가 안정적인 상태에 있고 마이그레이션 중에 추가 쓰기가 발생하지 않습니다.

AEM 6.5 인스턴스 백업 backing-up-the-aem65-instance

아직 백업하지 않은 경우 AEM 6.5 인스턴스의 전체 백업을 수행합니다.

컨텐츠 마이그레이션에 Oak 업그레이드 도구 사용 using-the-oak-upgrade-tool-for-content-migration

Oak 업그레이드 도구는 다음과 같이 명령줄을 통해 실행됩니다.

java -jar oak-upgrade-*.jar [options] /path/to/source/repository /path/to/destination/repository

다음은 필수 명령 및 옵션입니다.

키 옵션

  • --include-paths: 마이그레이션에 포함할 하위 트리를 지정하십시오. 명령 사용법은 다음 예를 참조하십시오.

    code language-none 
    java -jar oak-upgrade-*.jar --include-paths=/content/site /old/repository /new/repository

  • --exclude-paths: 마이그레이션에서 특정 경로를 제외합니다. 이 옵션을 사용하는 동안 주의하십시오. 대상 시스템에 경로가 있으면 제거됩니다. 명령 사용법은 다음 예를 참조하십시오.

    code language-none 
    java -jar oak-upgrade-*.jar --exclude-paths=/content/old_site /old/repository /new/repository

  • --copy-binaries: 기본적으로 Oak-upgrade는 바이너리에 대한 참조만 마이그레이션하여 실제 파일을 원래 blob/데이터 저장소에 남깁니다. 따라서 새 저장소는 여전히 바이너리 소스 저장소에 의존합니다. 저장소 콘텐츠와 함께 바이너리를 마이그레이션하려면 아래와 같이 --copy-binaries 매개 변수를 사용하여 모든 바이너리 데이터를 새 저장소에 복사합니다.

    code language-none 
    java -jar oak-upgrade-*.jar \
--copy-binaries \
--src-datastore=/old/repository/datastore \
--datastore=/new/repository/datastore \
/old/repository \
/new/repository

체크포인트 마이그레이션 migratiing-checkpoints

이전 SegmentMK 저장소(Oak 1.6 이전)를 새 SegmentMK(Oak 버전이 1.6보다 크거나 같음)로 마이그레이션할 때 체크포인트도 마이그레이션됩니다. 이 프로세스는 새 저장소에서 Oak을 처음 실행할 때 리인덱싱을 방지합니다. 하지만 다음과 같은 경우에는 체크포인트가 마이그레이션되지 않습니다.

  1. 사용자 지정 포함, 제외 또는 병합 경로가 지정되거나
  2. 시스템은 참조를 통해 바이너리를 복사합니다. 소스 데이터 저장소가 지정되지 않았고 두 개의 다른 체크포인트가 동일한 경로 아래에 다른 바이너리를 포함합니다.

두 번째 경우, Oak 업그레이드는 다음 경고를 발생시키고 중단됩니다.

Checkpoints are not copied, because no external datastore has been specified. This results in the full repository reindexing on the first start. Use --skip-checkpoints to force the migration or see https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration for more info.

이 문제를 해결하는 가장 쉬운 방법은 명령줄 옵션(예: --src-datastore 또는 --src-s3datastore)에서 소스 데이터 저장소를 지정하는 것입니다.

경고는 무시할 수도 있지만, 이 경우 저장소는 처음 시작할 때 완전히 다시 인덱싱됩니다. 특히 대규모 인스턴스의 경우 긴 프로세스일 수 있습니다. 리인덱싱 프로세스가 완료될 때까지 저장소를 사용할 수 없습니다. --skip-checkpoints 옵션을 사용하여 경고를 표시하지 않습니다.

오프라인 리인덱싱를 사용하여 AEM을 시작하기 전에 저장소를 오프라인 리인덱싱하여 처음 시작할 때 전체 리인덱싱을 방지할 수도 있습니다.

Oak 업그레이드 도구 및 고급 사용에 대한 자세한 내용은 공식 설명서를 참조하세요.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2