즉석 업그레이드 수행 performing-an-in-place-upgrade
업그레이드 전 단계 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
-
실행 중인 경우 인스턴스를 중지합니다.
-
새 AEM jar 파일을 다운로드하여
crx-quickstart폴더 외부의 이전 파일을 바꾸는 데 사용합니다. -
다음을 실행하여 새 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를 사용하는 환경의 업그레이드에는 저장소 마이그레이션이 필요하지 않습니다. 새 세그먼트 Tar 형식의 이점에 대한 자세한 내용은 Oak 세그먼트 Tar로 마이그레이션 FAQ를 참조하십시오.
실제 마이그레이션은 crx2oak 도구를 실행하여 업그레이드를 단순화하고 보다 강력하게 만드는 새 -x crx2oak 옵션과 함께 실행되는 표준 AEM quickstart jar 파일을 사용하여 수행됩니다.
--promote-runmode nosamplecontent
실행할 명령을 확인하려면 다음 명령을 사용합니다.
java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>
여기서 <<YOUR_PROFILE>> 및 <<ADDITIONAL_FLAGS>>은(는) 다음 표에 나열된 프로필 및 플래그로 대체됩니다.
위치:
-
mongo-host은(는) MongoDB 서버 IP입니다(예: 127.0.0.1). -
mongo-port은(는) MongoDB 서버 포트입니다(예: 27017). -
mongo-database-name은(는) 데이터베이스 이름을 나타냅니다(예: aem-author).
다음 시나리오에 대한 추가 스위치가 필요할 수도 있습니다.
- Java 메모리 매핑이 올바르게 처리되지 않는 Windows 시스템에서 업그레이드를 수행하는 경우
--disable-mmap매개 변수를 명령에 추가하십시오.
crx2oak 도구 사용에 대한 자세한 지침은 CRX2Oak 마이그레이션 도구 사용을 참조하십시오. crx2oak helper JAR은 필요한 경우 빠른 시작을 언포장한 후 수동으로 최신 버전으로 교체하여 수동으로 업그레이드할 수 있습니다. AEM 설치 폴더의 위치는 <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar입니다. 최신 버전의 CRX2Oak 마이그레이션 도구는 Adobe 리포지토리(https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/)에서 다운로드할 수 있습니다.
마이그레이션이 성공적으로 완료되면 종료 코드가 0인 상태로 도구가 종료됩니다. 또한 AEM 설치 디렉터리의 crx-quickstart/logs 아래에 있는 upgrade.log 파일에 WARN 및 ERROR 메시지가 있는지 확인합니다. 이는 마이그레이션 중에 발생한 치명적이지 않은 오류를 나타낼 수 있습니다.
crx-quickstart/install 폴더 아래의 구성 파일을 확인하십시오. 마이그레이션이 필요한 경우 대상 저장소를 반영하도록 업데이트됩니다.
데이터 저장소의 메모:
FileDataStore은(는) AEM 6.3 설치의 새로운 기본값이지만 외부 데이터 저장소를 사용할 필요는 없습니다. 프로덕션 배포에 외부 데이터 저장소를 사용하는 것이 모범 사례로 권장되지만 업그레이드하기 위한 필수 조건은 아닙니다. AEM Adobe 업그레이드에 이미 존재하는 복잡성으로 인해 데이터 저장소 마이그레이션을 수행하지 않고 업그레이드를 수행하는 것이 좋습니다. 원하는 경우 나중에 별도의 작업으로 데이터 저장소 마이그레이션을 실행할 수 있습니다.
마이그레이션 문제 해결 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을 사용하는 경우:
-
이전 버전의 S3 커넥터와 연결된
crx-quickstart/install아래의 jar를 제거합니다. -
https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/에서 1.10.x S3 커넥터의 최신 릴리스를 다운로드하십시오.
-
패키지를 임시 폴더로 추출하고
jcr_root/libs/system/install의 내용을crx-quickstart/install폴더에 복사합니다.
올바른 업그레이드 시작 명령 확인 determining-the-correct-upgrade-start-command
업그레이드를 실행하려면 jar 파일을 사용하여 AEM을 시작하여 인스턴스를 불러오는 것이 중요합니다. 6.5로 업그레이드하려면 업그레이드 명령으로 선택할 수 있는 지연 콘텐츠 마이그레이션에서 다른 콘텐츠 재구성 및 마이그레이션 옵션을 참조하십시오.
시작 스크립트에서 AEM을 시작하면 업그레이드가 시작되지 않습니다. 대부분의 고객은 시작 스크립트를 사용하여 AEM을 시작하고 메모리 설정, 보안 인증서 등과 같은 환경 구성을 위한 스위치를 포함하도록 이 시작 스크립트를 사용자 정의했습니다. 이러한 이유로 Adobe은 다음 절차에 따라 적절한 업그레이드 명령을 결정할 것을 권장합니다.
-
실행 중인 AEM 인스턴스에서 명령줄에서 다음을 실행합니다.
code language-shell ps -ef | grep java -
AEM 프로세스를 찾습니다. 다음과 같이 표시됩니다.
code language-shell /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties -
기존 jar(이 경우
crx-quickstart/app/aem-quickstart*.jar)에 대한 경로를crx-quickstart폴더의 형제 jar인 새 jar로 바꾸어 명령을 수정합니다. 이전 명령을 예로 들면 다음과 같습니다.code language-shell /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties이렇게 하면 모든 적절한 메모리 설정, 사용자 지정 실행 모드 및 기타 환경 매개 변수가 업그레이드에 적용됩니다. 업그레이드가 완료되면 이후 시작의 시작 스크립트에서 인스턴스를 시작할 수 있습니다.
업그레이드된 코드베이스 배포 deploy-upgraded-codebase
즉각적 업그레이드 프로세스가 완료되면 업데이트된 코드 베이스를 배포해야 합니다. 대상 버전의 AEM에서 작동하도록 코드 베이스를 업데이트하는 단계는 코드 및 사용자 지정 업그레이드 페이지에서 찾을 수 있습니다.
Post 업그레이드 검사 및 문제 해결 수행 perform-post-upgrade-check-troubleshooting
Post 업그레이드 확인 및 문제 해결을 참조하세요.