업그레이드 수행

노트

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

업그레이드 전 단계

업그레이드를 실행하기 전에 몇 가지 단계를 완료해야 합니다. 자세한 내용은 코드 및 사용자 지정업그레이드 전 유지 관리 작업 업그레이드를 참조하십시오. 또한 시스템이 새로운 버전의 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 파일을 다운로드하여 폴더 외부에 있는 이전 JAR를 교체하는 데 사용합니다 crx-quickstart .

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

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

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

AEM 6.3에서 업그레이드하는 경우 이 마이그레이션은 필요하지 않습니다. 6.3을 초과하는 버전의 경우 Adobe은 저장소를 AEM 6.3에 있는 새로운 버전의 Oak 세그먼트 Tar로 마이그레이션하는 데 사용할 수 있는 도구를 제공합니다. 이 도구는 빠른 시작 패키지의 일부로 제공되며 TarMK를 사용할 모든 업그레이드에 필수입니다. MongoMK를 사용하는 환경에 대한 업그레이드는 저장소 마이그레이션이 필요하지 않습니다. For more information on what the benefits of the new Segment Tar format are, see the Migrating to Oak Segment Tar FAQ.

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

노트

CRX2Oak Quickstart 확장 기능을 사용하여 TarMK 저장소 컨텐츠 마이그레이션을 수행하는 경우 마이그레이션 명령줄에 다음을 추가하여 sample content runmode를 제거할 수 있습니다.

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

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 설치 디렉토리 아래에 있는 upgrade.log 파일에서 WARN 및 ERROR 메시지 crx-quickstart/logs 가 마이그레이션 중에 발생한 치명적이지 않은 오류를 나타낼 수 있으므로 WARN 및 ERROR 메시지를 확인합니다.

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

노트

AEM 6.3 설치에 대한 새로운 기본 FileDataStore 은 아니지만 외부 데이터 저장소를 사용할 필요는 없습니다. 외부 데이터 저장소를 프로덕션 배포를 위한 최상의 방법으로 사용하는 것이 좋지만, 업그레이드해야 하는 것은 필수 조건이 아닙니다. 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 데이터 저장소 구성 파일의 경로를 나타내며 S3 데이터 저장소의 경로를 /path/to/datastore 나타냅니다.

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

--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/installcrx-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 를 폴더의 동위 항목인 새 jar로 대체하여 명령을 crx-quickstart 수정합니다. Adobe의 이전 명령을 예로 들면 다음과 같습니다.

    /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의 대상 버전에서 작동하도록 코드 베이스를 업데이트하는 단계는 업그레이드 코드 및 사용자 지정 페이지에서 확인할 수 있습니다.

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

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

이 페이지에서는