설명서AEM 6.5 LTS사용 안내서

인플레이스 업그레이드 수행 performing-an-in-place-upgrade

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager 6.5 LTS
  • 주제:

작성 대상:

  • 관리자
NOTE
이 페이지에서는 AEM 6.5 LTS의 즉각적 업그레이드 절차에 대해 간략히 설명합니다. 응용 프로그램 서버에 배포된 설치가 있는 경우 응용 프로그램 서버 설치에 대한 업그레이드 단계를 참조하십시오.

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

업그레이드를 실행하기 전에 완료해야 하는 몇 가지 단계가 있습니다. 자세한 내용은 코드 및 사용자 지정 업그레이드 및 업그레이드 전 유지 관리 작업을 참조하십시오. 또한 시스템이 AEM 6.5 LTS에 대한 요구 사항을 충족하는지 확인하고 업그레이드 계획 고려 사항 및 Analyzer를 통해 복잡성을 추정하는 방법을 확인하십시오.

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

  • 필요한 최소 Java 버전: 시스템에 Oracle Java™ 17/21이 설치되어 있는지 확인하십시오.

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

  1. 새 AEM 6.5 LTS jar 파일 다운로드

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

  3. 실행 중인 경우 인스턴스 중지

  4. 새 AEM 6.5 LTS jar을 사용하여 crx-quickstart 폴더 외부의 이전 LTS Jar을 바꿉니다

  5. sling.properties 파일(일반적으로 crx-quickstart/conf/에 있음)을 백업한 다음 삭제합니다.

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

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

  7. 사용자 정의 sling.properties를 적용해야 하는 경우 새 로컬 AEM 인스턴스를 생성하고 crx-quickstart/conf 디렉토리에서 sling.properties 파일을 검색합니다. 필요한 사용자 지정 변경 사항을 이 파일에 적용한 다음, 업그레이드 중인 AEM 인스턴스의 crx-quickstart/conf 디렉토리에 복사합니다. 사용자 지정 속성이 없는 경우 이 단계를 건너뛸 수 있습니다.

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

S3을 사용하는 경우:

  1. 이전 버전의 S3 커넥터와 연결된 crx-quickstart/install 아래의 jar를 제거합니다.

  2. https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ 에서 1.60.2 S3 커넥터의 최신 릴리스를 다운로드하십시오.

  3. S3 커넥터(버전 1.60.2)를 추출하고 crx-quickstart/install 아래에 있는 다음 폴더의 내용을 다음과 같이 복사합니다.

    1. com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 아래의 crx-quickstart/install/1 복사
    2. com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15 아래의 crx-quickstart/install/15 복사

이제 올바른 업그레이드 시작 명령 결정 섹션의 정보를 사용하여 결정된 새 명령을 사용하여 AEM 인스턴스를 시작합니다.

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

NOTE
Java 17/21에서 일부 Java 8/11 인수에 대한 지원이 제거되었습니다. Oracle Java™ 17 문서, Oracle Java™ 21 문서 및 AEM 6.5 LTS에 대한 Java&trade 인수 고려 사항을 참조하십시오.

업그레이드를 실행하려면 jar 파일을 사용하여 AEM을 시작하여 인스턴스를 불러오는 것이 중요합니다.

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

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

    code language-shell 
    ps -ef | grep java

  2. 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

  3. 기존 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

업그레이드 확인 후 및 문제 해결을 참조하세요.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2