설명서Experience Cloud KCS

JEE와 OSGi의 서비스 팩 간 AEM Forms 6.5 업그레이드

마지막 업데이트: 2026년 6월 23일

Forms 구성 요소는 기본 AEM 서비스 팩과 별도로 배송되고 JEE 및 OSGi 배포는 서로 다른 설치 흐름을 사용하기 때문에 AEM Forms 고객은 AEM 6.5 서비스 팩 간을 이동할 때 올바른 업그레이드 경로에 대해 불확실성이 있습니다. Adobe은 서비스 팩당 여러 패키지(JEE 누적 설치 프로그램, OSGi 추가 기능, 핫픽스, 호환성 패키지)를 배포하므로 특정 환경에 적용되는 패키지를 쉽게 식별할 수 있습니다. 이는 소프트웨어 결함이 아니라 구성 문제입니다. 런타임 유형을 식별하고 현재 버전을 확인하고 올바른 패키지를 올바른 순서로 설치하면 깔끔한 업그레이드가 생성됩니다.

설명 description

문제: JEE 및 OSGi에 대한 올바른 AEM Forms 6.5 서비스 팩 업그레이드 경로 선택

설명

한 AEM 6.5 서비스 팩에서 다른 서비스 팩(예: SP18 - SP24, SP20 - SP23 또는 SP23 - SP24 핫픽스)으로 이동하면 적용되는 패키지와 패키지 설치 순서에 대해 질문이 발생합니다. 일반적인 질문에는 직접 업그레이드 지원 여부, 기존 핫픽스를 먼저 제거해야 하는지 여부, 설치할 Forms 추가 기능, JEE 패치 설치 프로그램 필요 여부 및 WebSphere, JBoss, Windows 또는 Linux와 같은 플랫폼 요구 사항을 처리하는 방법이 나와 있습니다.

환경:

  • AEM Forms 6.5 (온-프레미스)
  • OSGi 런타임
  • JEE 런타임(WebSphere, WebLogic, JBoss)
  • Windows 및 Linux 플랫폼

문제/증상:

  • 동일한 서비스 팩에 대한 여러 추가 기능 빌드를 포함하여 설치할 AEM Forms 서비스 팩 또는 추가 기능에 대한 불확실성
  • 직접 업그레이드 경로가 지원되는지 여부 혼동(예: SP18 → SP24 또는 SP20 → SP23)
  • 새 서비스 팩을 적용하기 전에 기존 핫픽스를 제거해야 하는지 여부에 대한 질문
  • OSGi 추가 기능 패키지와 비교하여 JEE 패치가 필요한 시기에 대한 명확하지 않은 지침

근본 원인:

AEM Forms 업그레이드는 Forms 구성 요소가 기본 AEM 서비스 팩과 별도로 제공되고 JEE 및 OSGi 배포가 서로 다른 패치 및 설치 흐름을 사용하기 때문에 플랫폼에 종속된 단계가 필요합니다. Adobe은 서비스 팩당 여러 패키지(JEE 누적 설치 관리자, OSGi 추가 기능, 핫픽스 및 호환성 패키지)를 배포하므로 특정 환경에 적용되는 패키지를 잘못 해석하기 쉽습니다. 소프트웨어 결함이 아니라 구성 불확실성이 문제입니다.

확인하는 방법

  1. 런타임 유형을 식별합니다. AEM에 로그인하고 /lc이(가) 있는지 확인합니다. /lc/login이(가) 로드되면 JEE이고, /aem/start.html만 로드되면 OSGi입니다. JEE 환경에서는 EAR/WAR 파일과 구성 관리자를 사용합니다.
  2. 현재 서비스 팩 버전을 확인합니다. /system/console/productinfo(으)로 이동하여 설치된 제품 섹션을 확인하십시오(예: Adobe Experience Manager (6.5.23.0)).
  3. 플랫폼 호환성을 확인합니다. 업그레이드하기 전에 OS, Java, 애플리케이션 서버 및 데이터베이스 버전을 지원되는 플랫폼 매트릭스와 비교하십시오.

해결 방법 resolution

  1. 시작 서비스 팩에 따라 올바른 업그레이드 경로를 선택하십시오.

    • SP18 또는 SP20에서는 SP24 또는 SP23으로 직접 업그레이드할 수 있습니다.
    • SP11에서 먼저 기본 플랫폼 구성 요소를 업그레이드한 다음 SP24로 이동합니다.
    • SP23에서 핫픽스를 사용하는 경우 정상적으로 진행하되 핫픽스는 제거하지 마십시오. 서비스 팩은 누적됩니다.

  2. OSGi — 기본 AEM 6.5 서비스 팩 설치: CRX 패키지 관리자에 aem-service-pkg-6.5.xx.x.zip을(를) 업로드하고 설치를 클릭합니다. /system/console/productinfo을(를) 방문하여 SP 버전 업데이트를 확인하고 모든 번들이 ACTIVE 또는 FRAGMENT인지 확인하십시오. 설치에 실패한 경우 종속성 오류가 있는지 error.log을(를) 확인하십시오.

  3. OSGi — 올바른 Forms 추가 기능 패키지 설치: 서비스 팩 및 플랫폼과 일치하는 추가 기능 빌드를 식별하고 설치합니다. AEM Forms 번들이 ACTIVE 상태인지 확인하려면 /system/console/bundles을(를) 확인하십시오. 설치에 실패한 경우 AEM을 다시 시작하고 다시 시도하십시오.

  4. OSGi — 관련된 경우에만 추가 핫픽스를 설치합니다. Granite 보안 핫픽스와 같은 필수 수정 사항을 적용합니다. /system/console/productinfo에서 업데이트된 구성 요소를 확인하고 소프트웨어 배포 세부 정보 페이지에서 핫픽스 필수 구성 요소를 확인하십시오.

  5. JEE — 연결된 JEE 패치 설치 관리자를 설치합니다. 대상 서비스 팩에 대해 JEE 패치 설치 관리자를 실행합니다. 구성 관리자가 업데이트된 버전을 인식하는지 확인합니다. 실패하면 구성 관리자 로그를 수집합니다.

  6. JEE — 응용 프로그램 서버를 다시 시작합니다. 기본 응용 프로그램 서버 스크립트를 사용하여 WebSphere, WebLogic 또는 JBoss를 완전히 다시 시작합니다. 응용 프로그램 서버 로그에 배포 오류가 표시되지 않는지 확인합니다. EAR을 배포하지 못하는 경우 누락된 JNDI 항목, 데이터 소스 또는 저장소 경로를 확인하십시오.

  7. 전체 업그레이드(JEE 및 OSGi)의 유효성 검사: AEM에 로그인하고 적응형 Forms, 워크플로우 및 기타 Forms 기능이 로드되는지 확인합니다. 번들 및 제품 정보 페이지를 검토하고 누락된 패키지 또는 종속성 오류에 대해 error.log을(를) 확인하십시오.

유효성 검사

  1. /system/console/productinfo(으)로 이동하여 SP 버전이 올바르게 표시되는지 확인합니다(예: Adobe Experience Manager (6.5.24.0)).
  2. /system/console/bundles을(를) 통해 모든 OSGi 번들이 ACTIVE 또는 FRAGMENT인지 확인하십시오.
  3. JEE의 경우 재시작 후 애플리케이션 서버 로그를 검토하여 오류 없이 배포된 모든 EAR을 확인합니다.
  4. 기본 Forms 워크플로우를 실행하거나 적응형 양식을 렌더링하여 런타임 안정성을 확인합니다.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles