컨텐츠 전송 도구 사용

컨텐츠 전송 도구 사용에 대한 중요한 고려 사항

아래 섹션을 따라 수행하여 컨텐츠 전송 도구를 실행하는 동안 중요한 고려 사항을 이해하십시오.

  • 컨텐츠 전송 도구의 최소 시스템 요구 사항은 AEM 6.3 이상 및 JAVA 8입니다. 더 낮은 AEM 버전을 사용하는 경우 컨텐츠 저장소를 AEM 6.5로 업그레이드해야 컨텐츠 전송 도구를 사용할 수 있습니다.

  • AEM을 시작하는 사용자가 java 명령을 실행할 수 있도록 AEM 환경에서 Java를 구성해야 합니다.

  • 컨텐츠 전송 도구는 다음 유형의 데이터 저장소와 함께 사용할 수 있습니다.파일 데이터 저장소, S3 데이터 저장소, 공유 S3 데이터 저장소 및 Azure Blob 저장소 데이터 저장소를 참조하십시오.

  • 샌드박스 환경​을(를) 사용하는 경우 환경이 현재 상태이고 최신 릴리스로 업그레이드되었는지 확인하십시오. 프로덕션 환경​을 사용하는 경우 자동으로 업데이트됩니다.

  • 콘텐츠 전송 도구를 사용하려면 소스 인스턴스의 관리자 사용자여야 하며 컨텐츠를 전송하는 Cloud Service 인스턴스의 로컬 AEM 관리자 그룹에 속해야 합니다. 권한이 없는 사용자는 액세스 토큰을 검색하여 컨텐츠 전송 도구를 사용할 수 없습니다.

  • 액세스 토큰은 특정 기간 후 또는 Cloud Service 환경이 업그레이드된 후 정기적으로 만료될 수 있습니다. 액세스 토큰이 만료되면 Cloud Service 인스턴스에 연결할 수 없으며 새 액세스 토큰을 검색해야 합니다. 기존 마이그레이션 세트와 연관된 상태 아이콘은 빨간색 클라우드로 변경되며 마우스로 가리키면 메시지가 표시됩니다.

  • 현재 Cloud Service 작성자 인스턴스로서 AEM의 기본 MongoDB 크기는 32GB입니다. 20GB를 초과하는 세그먼트 저장소 크기의 경우 MongoDB 크기를 늘리기 위해 지원 티켓을 제출해야 합니다.

  • 컨텐츠 전송 도구를 통해 전송된 사용자 및 그룹은 권한을 충족하기 위해 컨텐트에 필요한 사용자만 사용할 수 있습니다. 추출 프로세스는 전체 /home를 마이그레이션 세트로 복사하고 통합 프로세스는 마이그레이션된 콘텐츠 ACL에서 참조하는 모든 사용자 및 그룹을 복사합니다.

  • 추출 단계 중에 컨텐츠 전송 도구는 활성 AEM 소스 인스턴스에서 실행됩니다.

  • 컨텐트 전송 프로세스의 추출 단계를 완료하고 통합 단계​를 시작하여 컨텐츠를 Cloud Service Stage 또는 Production 인스턴스로 AEM에 수집하기 전에 지원 티켓을 로그인하여 을 실행할 의사를 Adobe에 알려야 합니다.​통합​프로세스 중에 Adobe이 중단되지 않도록 통합​합니다. 계획된 통합 날짜 1주 전에 지원 티켓을 기록해야 합니다. 지원 티켓을 제출하면 지원 팀이 다음 단계에 대한 지침을 제공할 것입니다.

    • 다음 세부 정보를 사용하여 지원 티켓을 기록합니다.
      • 통합 단계를 시작할 계획이면 정확한 날짜 및 예상 시간(시간대 포함)입니다.
      • 데이터를 인제스트할 환경 유형(스테이지 또는 프로덕션)입니다.
      • 프로그램 ID.
  • 작성자에 대한 수집 단계​는 전체 작성자 배포를 축소합니다. 즉, 전체 수집 프로세스 중에 작성자 AEM을 사용할 수 없습니다. 또한 통합 단계를 실행하는 동안 Cloud Manager 파이프라인이 실행되지 않았는지 확인하십시오.

사용 가능

컨텐트 전송 도구는 소프트웨어 배포 포털에서 zip 파일로 다운로드할 수 있습니다. 패키지 관리자를 통해 소스 AEM(Adobe Experience Manager) 인스턴스에 패키지를 설치할 수 있습니다. 최신 버전을 다운로드해야 합니다. 최신 버전에 대한 자세한 내용은 릴리스 노트를 참조하십시오.

노트

소프트웨어 배포 포털에서 컨텐츠 전송 도구를 다운로드합니다.

컨텐츠 전송 도구 실행

이 섹션을 따라 컨텐츠 전송 도구를 사용하여 컨텐츠를 AEM as a Cloud Service(작성자/게시)에 마이그레이션하는 방법을 알아보십시오.

  1. Adobe Experience Manager를 선택하고 도구 -> 작업 -> 컨텐츠 전송​으로 이동합니다.

    이미지

  2. 아래의 콘솔은 첫 번째 마이그레이션 세트를 만들 때 나타납니다. 마이그레이션 세트 만들기​를 클릭하여 새 마이그레이션 세트를 만듭니다.

    이미지

    노트

    기존 마이그레이션 세트가 있는 경우 콘솔에 현재 상태의 기존 마이그레이션 세트 목록이 표시됩니다.

  3. 아래 설명된 대로 컨텐츠 마이그레이션 세트 세부 정보 화면​의 필드를 채웁니다.

    이미지

    1. 이름: 마이그레이션 세트의 이름을 입력합니다.

      노트

      마이그레이션 세트 이름에는 특수 문자를 사용할 수 없습니다.

    2. 클라우드 서비스 구성: 대상 AEM as a Cloud Service 작성자 URL로 입력합니다.

      노트

      컨텐츠 전송 작업 중에 한 번에 최대 4개의 마이그레이션 세트를 만들고 유지 관리할 수 있습니다.
      또한 특정 환경 - 단계, 개발 또는 프로덕션​마다 개별적으로 마이그레이션을 만들어야 합니다.

    3. 액세스 토큰: 액세스 토큰을 입력합니다.

      노트

      액세스 토큰 열기 단추를 사용하여 액세스 토큰을 검색할 수 있습니다. 대상 Cloud Service 인스턴스의 AEM 관리자 그룹에 속하는지 확인해야 합니다.

    4. 매개 변수: 다음 매개 변수를 선택하여 마이그레이션 세트를 만듭니다.

      1. 버전 포함: 필요에 따라 선택합니다.

      2. 포함할 경로: 경로 브라우저를 사용하여 마이그레이션해야 하는 경로를 선택합니다. 경로 선택기는 입력 또는 선택을 통해 입력을 허용합니다.

        중요

        마이그레이션 세트를 만드는 동안 다음 경로가 제한됩니다.

        • /apps
        • /libs
        • /home
        • /etc
  4. 컨텐츠 마이그레이션 세트 세부 사항 화면에서 모든 필드를 채운 후 저장​을 클릭합니다.

  5. 마이그레이션 세트는 개요 페이지에 표시됩니다.

    이미지

    이 화면의 모든 기존 마이그레이션 세트가 현재 상태 및 상태 정보와 함께 개요 페이지에 표시됩니다. 아래에 설명된 이러한 아이콘 중 일부를 볼 수 있습니다.

    • 빨간색 클라우드​는 추출 프로세스를 완료할 수 없음을 나타냅니다.
    • 녹색 클라우드​는 추출 과정을 완료할 수 있음을 나타냅니다.
    • 노란색 아이콘​은 기존 마이그레이션 세트를 만들지 않았으며, 특정 마이그레이션은 동일한 인스턴스에 있는 다른 사용자가 작성했음을 나타냅니다.
  6. 개요 페이지에서 마이그레이션 세트를 선택하고 속성​을 클릭하여 마이그레이션 세트 속성을 보거나 편집합니다. 속성을 편집하는 동안 컨테이너 이름 또는 서비스 URL을 변경할 수 없습니다.

컨텐츠 전송의 추출 프로세스

컨텐츠 전송 도구에서 마이그레이션 세트를 추출하려면 아래 단계를 따르십시오.

  1. 개요 페이지에서 마이그레이션 세트를 선택하고 추출​을 클릭하여 추출을 시작합니다. 마이그레이션 세트 추출 대화 상자가 표시되고 추출​을 클릭하여 추출 단계를 시작합니다.

    이미지

    노트

    추출 단계 중에 스테이징 컨테이너를 덮어쓰는 옵션이 제공됩니다.

  2. 이제 EXTRACTION 필드에 압축 풀기가 진행 중임을 나타내는 RUNNING 상태가 표시됩니다.

    이미지

    추출이 완료되면 마이그레이션 세트의 상태가 완료됨​으로 업데이트되고 녹색 클라우드 아이콘이 정보​필드 아래에 표시됩니다.

    이미지

    노트

    UI에는 30초마다 개요 페이지를 다시 로드하는 자동 다시 로드 기능이 있습니다.
    추출 단계가 시작되면 60초 후 쓰기 잠금이 만들어지고 해제됩니다. 따라서 추출이 중지된 경우 다시 추출을 시작하기 전에 잠금이 해제될 때까지 잠시 기다려야 합니다.

추가 추출

컨텐츠 전송 도구에는 이전 컨텐츠 전송 활동 이후 수행된 변경 사항만 전송할 수 있는 차등 컨텐츠 추가를 지원하는 기능이 있습니다.

노트

처음 컨텐츠 전송 후 클라우드 서비스에서 라이브로 전환되기 전에 최종 차등 컨텐츠 전송에 대한 컨텐츠 고정 기간을 단축하기 위해 자주 차등 컨텐츠 추가를 수행하는 것이 좋습니다.

추출 프로세스가 완료되면 추가 추출 방법을 사용하여 델타 컨텐츠를 전송할 수 있습니다. 아래 단계를 따르십시오.

  1. 개요 페이지로 이동하고 추가 추출을 수행할 마이그레이션 세트를 선택합니다. 추출​을 클릭하여 추가 추출을 시작합니다. 마이그레이션 세트 추출 대화 상자가 표시됩니다.

    중요

    추출 중에 스테이징 컨테이너 덮어쓰기 옵션을 비활성화해야 합니다.

    이미지

컨텐츠 전송의 수집 프로세스

컨텐츠 전송 도구에서 마이그레이션 세트를 수집하려면 아래 단계를 따르십시오.

  1. 개요 페이지에서 마이그레이션 세트를 선택하고 수집​을 클릭하여 추출을 시작합니다. 마이그레이션 세트 수집 대화 상자가 표시됩니다. 통합 단계를 시작하려면 인제스트​를 클릭합니다. 데모 목적으로 컨텐츠를 작성자 인스턴스에 수집 옵션이 비활성화됩니다. 컨텐츠를 작성자와 게시에 동시에 수집할 수 있습니다.

    중요

    통합​옵션이 활성화되기 전에​클라우드 인스턴스에서 기존 컨텐츠를 지우면 기존 저장소 전체가 삭제되고 컨텐츠를 인제스트할 새 저장소가 만들어집니다. 즉, 대상 Cloud Service 인스턴스에 대한 권한을 포함한 모든 설정이 재설정됨을 의미합니다.

    이미지

  2. 인제스트가 완료되면 PUBLISH INGESTION 필드의 상태가 FINISHED​으로 업데이트됩니다.

    이미지

추가 수집

컨텐츠 전송 도구에는 이전 컨텐츠 전송 활동 이후 수행된 변경 사항만 전송할 수 있는 차등 컨텐츠 추가​를 지원하는 기능이 있습니다.

노트

처음 컨텐츠 전송 후 클라우드 서비스에서 라이브로 전환되기 전에 최종 차등 컨텐츠 전송에 대한 컨텐츠 고정 기간을 단축하기 위해 자주 차등 컨텐츠 추가를 수행하는 것이 좋습니다.

수집 프로세스가 완료되면 추가 수집 방법을 사용하여 델타 컨텐츠를 사용할 수 있습니다. 아래 단계를 따르십시오.

  1. 개요 페이지로 이동하고 추가 수집을 수행할 마이그레이션 세트를 선택합니다. 수집​을 클릭하여 추가 추출을 시작합니다. 마이그레이션 세트 수집 대화 상자가 표시됩니다.

    중요

    기존 통합 활동에서 기존 콘텐츠를 삭제하지 않으려면 통합​전에 클라우드 인스턴스에서 기존 콘텐츠를 지우십시오.​옵션을 비활성화해야 합니다.

    이미지

마이그레이션 세트에 대한 로그 보기

개요 페이지에서 기존 마이그레이션 세트에 대한 로그를 볼 수 있습니다.
아래 단계를 따르십시오.

  1. 개요 페이지로 이동하여 삭제할 마이그레이션 세트를 선택하고 작업 표시줄에서 로그 보기​를 클릭합니다.

    이미지

  2. 로그 대화 상자가 표시됩니다. 추출 로그​를 클릭하여 새 탭에서 로그를 확인합니다.

    이미지
    또는,

    개요 화면에서 마이그레이션 세트에 대한 로그를 볼 수도 있습니다. 마이그레이션 세트를 선택하고 추출 필드 아래에서 상태를 클릭합니다. 이 경우 완료됨​을 클릭하여 새 탭에서 로그를 봅니다.

    이미지

  3. 사용자 인터페이스를 사용하지 않고 로그를 추적하려면 소스 AEM 환경에 SSH를 사용하여 crx-quickstart/cloud-migration/extraction-XXXXX/output.log file를 추적할 수 있습니다.

마이그레이션 세트 삭제

개요 페이지에서 마이그레이션 세트를 삭제할 수 있습니다.
아래 단계를 따르십시오.

  1. 개요 페이지로 이동하여 삭제할 마이그레이션 세트를 선택하고 작업 표시줄에서 삭제​를 클릭합니다.

    이미지

  2. 마이그레이션 세트 삭제 대화 상자에서 삭제​를 클릭하여 삭제를 확인합니다.

    이미지

문제 해결

Blob ID가 누락됨

아래에 언급했듯이 보고된 Blob ID가 누락된 경우 기존 저장소에서 일관성 검사를 실행하고 누락된 Blob를 복원해야 합니다.
ERROR o.a.j.o.p.b.AbstractSharedCachingDataStore - Error retrieving record [ba45c53f8b687e7056c85dceebf8156a0e6abc7e]

다음 명령이 실행됩니다.

노트

--verbose 플래그는 BLOB을 참조하는 노드 경로를 보고하는 데 필요합니다.

저장소 AEM 6.5(Oak 1.8 이하)의 경우

java -jar oak-run.jar datastorecheck --consistency --store [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds] <DATASTORE_CFG> --verbose <OUT_DIR> --dump

Oak 1.10 이상이 있는 저장소의 경우

java -jar oak-run.jar datastore --check-consistency [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds|azureds] <DATASTORE_CFG> --out-dir <OUT_DIR> --work-dir <TEMP_DIR> --verbose

자세한 내용은 Oak 실행 가능 Jar를 참조하십시오.

일관성을 위해 위에 지정된 OUT_DIR​에 생성된 파일에서 경로에 바이너리가 누락되고, 백업에서 복원, 경로 삭제, 색인 재지정 등과 같은 적절한 조치를 취했는지 확인할 수 있습니다.

UI 동작

사용자는 컨텐츠 전송 도구에 대한 UI(사용자 인터페이스)에서 다음과 같은 동작 변경 사항을 볼 수 있습니다.

  • 컨텐츠 전송 도구 UI의 아이콘이 이 안내서에 표시된 스크린샷과 다르거나 소스 AEM 인스턴스의 버전에 따라 전혀 표시되지 않을 수 있습니다.

이 페이지에서는