즉석 업그레이드 수행

노트

이 페이지에서는 AEM 6.4에 대한 업그레이드 절차에 대해 설명합니다. 응용 프로그램 서버에 배포되는 설치가 있는 경우 Application Server 설치에 대한 업그레이드 단계를 참조하십시오.

업그레이드 전 단계

업그레이드를 실행하기 전에 몇 가지 단계를 완료해야 합니다. 자세한 내용은 코드 및 사용자 정의 업그레이드업그레이드 전 유지 관리 작업을 참조하십시오. 또한 시스템이 새로운 버전의 AEM 요구 사항을 충족하는지 확인하십시오. Pattern Detector를 사용하여 업그레이드 작업의 복잡성을 파악하는 방법을 살펴보고 자세한 내용은 업그레이드 계획의 업그레이드 범위 및 요구 사항 섹션을 참조하십시오.

마이그레이션 사전 요구 사항

  • 최소 필수 Java 버전: 마이그레이션 도구는 Java 버전 7 이상에서만 작동합니다. AEM 6.3 이상 버전의 경우 Oracle의 JRE 8 및 IBM의 JRE 7 & 8만 지원됩니다.

  • 업그레이드된 인스턴스: 5.6넘는 버전​에서 업그레이드하는 경우 6.0 버전의 업그레이드 문서에 설명된 절차에 따라 AEM 6.0으로 직접 업그레이드를 수행했는지 확인하십시오.

AEM Quickstart jar 파일준비

  1. 실행 중인 인스턴스를 중지합니다.

  2. 새 AEM jar 파일을 다운로드하여 crx-quickstart 폴더 외부에 있는 이전 JAR 파일을 교체합니다.

  3. 다음을 실행하여 새 빠른 시작 jar의 압축을 해제합니다.

    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

콘텐츠 저장소 마이그레이션

AEM 6.3에서 업그레이드하는 경우 이 마이그레이션은 필요하지 않습니다. 6.3 이전 버전의 경우, Adobe은 AEM 6.3에 있는 Oak Segment Tar의 새 버전으로 저장소를 마이그레이션하는 데 사용할 수 있는 도구를 제공합니다. 이 도구는 빠른 시작 패키지의 일부로 제공되며 TarMK를 사용할 모든 업그레이드에 대해 필수입니다. MongoMK를 사용하는 환경에 대한 업그레이드는 저장소 마이그레이션이 필요하지 않습니다. 새로운 세그먼트 타르 형식의 이점에 대한 자세한 내용은 Oak 세그먼트 Tar로 마이그레이션 FAQ을 참조하십시오.

실제 마이그레이션은 업그레이드를 단순화하고 더욱 강력하도록 하기 위해 crx2oak 도구를 실행하는 새로운 -x crx2oak 옵션과 함께 실행되는 표준 AEM quickstart jar 파일을 사용하여 수행됩니다.

노트

CRX2Oak Quickstart 확장을 사용하여 TarMK 리포지토리 컨텐츠 마이그레이션을 수행하는 경우 다음을 마이그레이션 명령줄에 추가하여 samplecontent 실행 모드를 제거할 수 있습니다.

  • --promote-runmode nosamplecontent

실행할 명령을 결정하려면 다음 명령을 사용합니다.

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

여기서 <<YOUR_PROFILE>><<ADDITIONAL_FLAGS>>은 다음 표에 나열된 프로필 및 플래그로 대체됩니다.

소스 저장소 Target 저장소 프로필 추가 플래그
crx2 또는 TarMK( FileDataStore TarMK segment-fds 아래의 문제 해결 섹션을 참조하십시오.
crx2 MongoMK mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK 또는 crx2( S3DataStore TarMK segment-custom-ds 아래의 문제 해결 섹션을 참조하십시오.
데이터 저장소가 없는 TarMK TarMK segment-no-ds
MongoMK MongoMK 마이그레이션은 필요하지 않습니다.

위치:

  • mongo-host 은 MongoDB 서버 IP입니다(예: 127.0.0.1).

  • mongo-port 는 MongoDB 서버 포트입니다(예:27017)

  • mongo-database-name 데이터베이스의 이름을 나타냅니다(예:aem-author)

다음 시나리오에 대해 추가 스위치가 필요할 수도 있습니다.

  • Java 메모리 매핑이 올바르게 처리되지 않는 Windows 시스템에서 업그레이드를 수행하는 경우 명령에 --disable-mmap 매개 변수를 추가하십시오.

  • Java 7을 사용하는 경우 -Xmx 매개 변수 바로 뒤에 -XX:MaxPermSize=2048m 매개 변수를 추가합니다.

crx2oak 도구 사용에 대한 추가 지침은 CRX2Oak 마이그레이션 도구 사용을 참조하십시오. 필요한 경우 quickstart를 압축 해제한 후 새 버전으로 직접 교체하여 crx2oak helper JAR를 수동으로 업그레이드할 수 있습니다. AEM 설치 폴더의 위치는 다음과 같습니다.<aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. 최신 버전의 CRX2Oak 마이그레이션 도구는 다음 위치의 Adobe 저장소에서 다운로드할 수 있습니다.https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

마이그레이션이 성공적으로 완료되면 종료 코드가 0인 상태로 도구가 종료됩니다. 또한 AEM 설치 디렉토리의 crx-quickstart/logs 아래에 있는 upgrade.log 파일에서 WARN 및 ERROR 메시지를 확인하십시오. 이 메시지는 마이그레이션 중에 발생한 치명적인 오류를 나타낼 수 있습니다.

crx-quickstart/install 폴더 아래의 구성 파일을 확인합니다. 마이그레이션이 필요한 경우 대상 저장소를 반영하도록 이 마이그레이션이 업데이트됩니다.

노트

FileDataStore은 AEM 6.3 설치에 대한 새로운 기본값이지만 외부 데이터 저장소를 사용할 필요는 없습니다. 외부 데이터 저장소를 사용하는 것은 프로덕션 배포를 위한 우수 사례로 권장되지만 업그레이드해야 하는 것은 아닙니다. AEM 업그레이드에 이미 복잡성이 있기 때문에 데이터 저장소 마이그레이션을 수행하지 않고 업그레이드를 수행하는 것이 좋습니다. 원할 경우 데이터 저장소 마이그레이션을 별도의 작업으로 실행할 수 있습니다.

마이그레이션 문제 해결

6.3에서 업그레이드하는 경우 이 섹션을 건너뛰십시오. 제공된 crx2oak 프로필은 대부분의 고객의 요구 사항을 충족해야 하지만 추가 매개 변수가 필요할 때가 있습니다. 마이그레이션 중에 오류가 발생하는 경우 추가 구성 옵션을 제공해야 하는 환경 측면이 있을 수 있습니다. 이러한 경우 다음 오류가 발생할 수 있습니다.

외부 데이터 저장소가 지정되지 않았으므로 체크포인트는 복사되지 않습니다. 이렇게 하면 첫 번째 시작 시 전체 리포지토리가 다시 인덱싱됩니다. —skip-checkpoint를 사용하여 강제로 마이그레이션을 수행하거나 자세한 내용은 https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration을 참조하십시오.

어떤 이유로 마이그레이션 프로세스는 데이터 저장소의 바이너리에 액세스해야 하며 이를 찾을 수 없습니다. 데이터 저장소 구성을 지정하려면 마이그레이션 명령의 <<ADDITIONAL_FLAGS>> 부분에 다음 플래그를 포함하십시오.

S3 데이터 저장소의 경우:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

여기서 /path/to/SharedS3DataStore.config은 S3 데이터 저장소 구성 파일의 경로를 나타내며 /path/to/datastore은 S3 데이터 저장소의 경로를 나타냅니다.

파일 데이터 저장소의 경우:

--src-datastore=/path/to/datastore

여기서 /path/to/datastore은 파일 데이터 저장소 경로를 나타냅니다.

업그레이드 수행 중

S3를 사용하는 경우:

  1. 이전 버전의 S3 커넥터와 연관된 crx-quickstart/install 아래에 있는 항아리를 제거합니다.

  2. https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/에서 1.8.x S3 커넥터의 최신 릴리스를 다운로드합니다.

  3. 패키지를 임시 폴더에 추출하고 jcr_root/libs/system/install의 내용을 crx-quickstart/install 폴더에 복사합니다.

올바른 업그레이드 시작 명령확인

업그레이드를 실행하려면 jar 파일을 사용하여 AEM을 시작하여 인스턴스를 불러와야 합니다. 6.4로 업그레이드하려면 업그레이드 명령으로 선택할 수 있는 레이지 컨텐트 마이그레이션의 다른 컨텐츠 조정 및 마이그레이션 옵션도 참조하십시오.

시작 스크립트에서 AEM을 시작하면 업그레이드가 시작되지 않습니다. 대부분의 고객은 시작 스크립트를 사용하여 AEM을 시작하고 메모리 설정, 보안 인증서 등과 같은 환경 구성에 대한 스위치를 포함하도록 이 시작 스크립트를 사용자 지정했습니다. 따라서 적절한 업그레이드 명령을 결정하려면 다음 절차를 수행하는 것이 좋습니다.

  1. 실행 중인 AEM 인스턴스에서 명령줄에서 다음을 실행합니다.

    ps -ef | grep java
    
  2. AEM 프로세스를 살펴보십시오. 다음과 같이 표시됩니다.

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
    
  3. 기존 jar( crx-quickstart/app/aem-quickstart*.jar)의 경로를 crx-quickstart 폴더의 동위 항목인 새 jar로 대체하여 명령을 수정합니다. 이전 명령을 예로 사용하면 다음과 같은 명령을 사용할 수 있습니다.

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    

    따라서 모든 적절한 메모리 설정, 사용자 정의 런타임 모드 및 기타 환경 매개 변수가 업그레이드를 위해 적용되도록 할 수 있습니다. 업그레이드가 완료된 후, 인스턴스는 향후 신생 업체에 대한 시작 스크립트에서 시작할 수 있습니다.

업그레이드된 코드베이스배포

업그레이드 절차가 완료되면 업데이트된 코드 베이스를 배포해야 합니다. AEM의 대상 버전에서 작동하도록 코드 베이스를 업데이트하는 단계는 업그레이드 코드 및 사용자 지정 페이지에서 확인할 수 있습니다.

업그레이드 후 확인 및 문제 해결 수행

업그레이드 확인 후 문제 해결을 참조하십시오.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free