즉석 업그레이드 수행 performing-an-in-place-upgrade
업그레이드 전 단계 pre-upgrade-steps
업그레이드를 실행하기 전에 완료해야 하는 몇 가지 단계가 있습니다. 자세한 내용은 코드 및 사용자 지정 업그레이드 및 업그레이드 전 유지 관리 작업을 참조하십시오. 또한 시스템이 AEM 6.5 LTS에 대한 요구 사항을 충족하는지 확인하고 업그레이드 계획 고려 사항 및 Analyzer를 통해 복잡성을 추정하는 방법을 확인하십시오.
마이그레이션 사전 요구 사항 migration-prerequisites
- 필요한 최소 Java 버전: 시스템에 Oracle Java™ 17/21이 설치되어 있는지 확인하십시오.
AEM Quickstart jar 파일 준비 prep-quickstart-file
-
새 AEM 6.5 LTS jar 파일 다운로드
-
실행 중인 경우 인스턴스 중지
-
새 AEM 6.5 LTS jar을 사용하여
crx-quickstart
폴더 외부의 이전 LTS Jar을 바꿉니다 -
sling.properties
파일(일반적으로crx-quickstart/conf/
에 있음)을 백업한 다음 삭제합니다. -
다음을 실행하여 새 quickstart jar 압축을 해제합니다.
code language-shell java -Xmx4096m -jar aem-quickstart.jar -unpack
-
사용자 정의 sling.properties를 적용해야 하는 경우 새 로컬 AEM 인스턴스를 생성하고 crx-quickstart/conf 디렉토리에서 sling.properties 파일을 검색합니다. 필요한 사용자 지정 변경 사항을 이 파일에 적용한 다음, 업그레이드 중인 AEM 인스턴스의 crx-quickstart/conf 디렉토리에 복사합니다. 사용자 지정 속성이 없는 경우 이 단계를 건너뛸 수 있습니다.
업그레이드 수행 performing-the-upgrade
S3을 사용하는 경우:
-
이전 버전의 S3 커넥터와 연결된
crx-quickstart/install
아래의 jar를 제거합니다. -
https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ 에서 1.60.2 S3 커넥터의 최신 릴리스를 다운로드하십시오.
-
S3 커넥터(버전 1.60.2)를 추출하고
crx-quickstart/install
아래에 있는 다음 폴더의 내용을 다음과 같이 복사합니다.crx-quickstart/install/1
아래의com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1
복사crx-quickstart/install/15
아래의com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15
복사
이제 올바른 업그레이드 시작 명령 결정 섹션의 정보를 사용하여 결정된 새 명령을 사용하여 AEM 인스턴스를 시작합니다.
올바른 업그레이드 시작 명령 확인 determining-the-correct-upgrade-start-command
업그레이드를 실행하려면 jar 파일을 사용하여 AEM을 시작하여 인스턴스를 불러오는 것이 중요합니다.
시작 스크립트에서 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
폴더의 형제 항목인 새 AEM 6.5 LTS jar로 대체하여 명령을 수정합니다. 이전 명령을 예로 들면 다음과 같습니다.code language-shell /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.jar> -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
이렇게 하면 모든 적절한 메모리 설정, 사용자 지정 실행 모드 및 기타 환경 매개 변수가 업그레이드에 적용됩니다. 업그레이드가 완료되면 이후 시작의 시작 스크립트에서 인스턴스를 시작할 수 있습니다.
업그레이드된 코드베이스 배포 deploy-upgraded-codebase
즉각적 업그레이드 프로세스가 완료되면 업데이트된 코드 베이스를 배포해야 합니다. 대상 버전의 AEM에서 작동하도록 코드 베이스를 업데이트하는 단계는 코드 및 사용자 지정 업그레이드 페이지에서 확인할 수 있습니다.
업그레이드 후 확인 및 문제 해결 수행 perform-post-upgrade-check-troubleshooting
업그레이드 확인 후 및 문제 해결을 참조하세요.