즉석 업그레이드 수행 performing-an-in-place-upgrade

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.
NOTE
이 페이지에서는 AEM 6.4에 대한 업그레이드 절차에 대해 설명합니다. 응용 프로그램 서버에 배포되는 설치가 있는 경우 다음을 참조하십시오 응용 프로그램 서버 설치에 대한 업그레이드 단계.

사전 업그레이드 단계 pre-upgrade-steps

업그레이드를 실행하기 전에 몇 가지 단계를 완료해야 합니다. 자세한 내용은 코드 및 사용자 지정 업그레이드업그레이드 전 유지 관리 작업 추가 정보. 또한 시스템이 새 버전의 AEM에 대한 요구 사항을 충족하는지 확인하십시오. 패턴 탐지기 를 통해 업그레이드의 복잡도를 예측할 수 있는 방법을 확인하고, 업그레이드 계획 추가 정보.

마이그레이션 사전 요구 사항 migration-prerequisites

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

  • 업그레이드된 인스턴스: 버전에서 업그레이드하는 경우 5.6 이상 ​를 눌러 업그레이드 설명서의 6.0 버전에 설명된 절차에 따라 AEM 6.0으로 즉석 업그레이드를 수행했는지 확인합니다.

AEM Quickstart jar 파일 준비 prep-quickstart-file

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

  2. 새 AEM jar 파일을 다운로드하고 이를 사용하여 crx-quickstart 폴더를 입력합니다.

  3. 다음을 실행하여 새 quickstart jar의 압축을 해제합니다.

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

컨텐츠 저장소 마이그레이션 content-repository-migration

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

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

NOTE
CRX2Oak Quickstart 확장을 사용하여 TarMK 저장소 컨텐츠 마이그레이션을 수행하는 경우, samplecontent migration 명령줄에 다음을 추가하여 실행 모드:
  • --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을 사용하는 경우 -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으로 종료됩니다. 또한, upgrade.log 파일, 다음 위치 crx-quickstart/logs AEM 설치 디렉토리에서 마이그레이션 중에 발생한 치명적이지 않은 오류를 나타낼 수 있습니다.

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

NOTE
While FileDataStore 는 외부 데이터 저장소를 사용하는 AEM 6.3 설치에 대한 새 기본값이 필요하지 않습니다. 외부 데이터 저장소를 프로덕션 배포에 가장 좋은 방법으로 사용하는 것이 좋지만 업그레이드하기 위한 전제 조건은 아닙니다. AEM 업그레이드에 이미 복잡성이 있으므로 데이터 저장소 마이그레이션을 수행하지 않고 업그레이드를 수행하는 것이 좋습니다. 원하는 경우 데이터 저장소 마이그레이션은 나중에 별도의 노력으로 실행할 수 있습니다.

마이그레이션 문제 해결 troubleshooting-migration-issues

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

외부 데이터 저장소가 지정되지 않았으므로 검사점은 복사되지 않습니다. 이렇게 하면 첫 번째 시작 시 전체 리포지토리의 재색인화가 발생합니다. —skip-checkpoints를 사용하여 마이그레이션을 강제로 수행하거나 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 파일 데이터 저장소의 경로를 나타냅니다.

업그레이드 수행 performing-the-upgrade

S3를 사용하는 경우:

  1. 그 아래의 병을 제거해라 crx-quickstart/install 를 S3 커넥터의 이전 버전과 연결했습니다.

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

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

올바른 업그레이드 시작 명령 확인 determining-the-correct-upgrade-start-command

업그레이드를 실행하려면 jar 파일을 사용하여 AEM을 시작하여 인스턴스를 가져오는 것이 중요합니다. 6.4로 업그레이드하려면 다른 컨텐츠 재구성 및 마이그레이션 옵션도 참조하십시오. 레이지 컨텐츠 마이그레이션 업그레이드 명령을 사용하여 선택할 수 있습니다.

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

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

    code language-shell
    ps -ef | grep java
    
  2. AEM 프로세스를 찾습니다. 그러면 다음과 같이 표시됩니다.

    code language-shell
    /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 폴더를 입력합니다. 이전 명령을 예로 사용하면 다음과 같은 명령을 사용할 수 있습니다.

    code language-shell
    /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
    

    이렇게 하면 업그레이드에 모든 적절한 메모리 설정, 사용자 지정 실행 모드 및 기타 환경 매개 변수가 적용됩니다. 업그레이드가 완료되면 이후 시작 시 시작 스크립트에서 인스턴스가 시작될 수 있습니다.

업그레이드된 코드베이스 배포 deploy-upgraded-codebase

즉각적인 업그레이드 프로세스가 완료되면 업데이트된 코드 베이스를 배포해야 합니다. AEM의 대상 버전에서 작동하도록 코드 베이스를 업데이트하는 단계는 업그레이드 코드 및 사용자 지정 페이지.

업그레이드 후 확인 및 문제 해결 수행 perform-post-upgrade-check-troubleshooting

자세한 내용은 업그레이드 후 확인 및 문제 해결.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56