설명서Experience Cloud KCS

버전, OS, JBoss 및 플랫폼 호환성에 대한 AEM Forms JEE 업그레이드 지침

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

JEE의 AEM Forms을 업그레이드하는 고객은 새 서비스 팩으로 이동하거나, RHEL 버전 간에 마이그레이션하거나, 6.5.x와 6.5 LTS 중에서 선택하는 경우 계속 진행하기 전에 지원되는 플랫폼에 대한 신뢰할 수 있는 확인이 필요합니다. AEM Forms on JEE는 OS, JBoss, Java 및 데이터베이스 레이어에 걸쳐 엄격한 호환성을 적용하며 지원되는 조합은 Adobe의 platform matrix에 있지만 특정 환경에 대한 매핑이 필요합니다. 유효성 검사를 건너뛰면 지원되지 않는 바이너리를 설치하거나 업그레이드 경로로 커밋할 수 없습니다. 매트릭스에 대해 OS, JBoss 및 Java 조합을 확인하고 올바른 설치 관리자를 얻은 다음 서비스 팩 또는 LTS 업그레이드를 순차적으로 적용하면 불확실성이 해결됩니다.

설명 description

환경:

  • JEE의 Adobe Experience Manager Forms
  • Adobe Experience Manager 6.5(온-프레미스)
  • Adobe Experience Manager 6.5 LTS
  • JBoss EAP 7.4.x 및 JBoss EAP 8
  • Red Hat Enterprise Linux 및 Windows Server

문제/증상:

  • RHEL 8, RHEL 9 및 Windows Server 2022와 같은 특정 OS 플랫폼을 지원하는 AEM Forms 버전에 대해서는 불확실성이 있습니다.
  • JBoss 7.4.22(SP22 포함) 또는 Java 17 및 21(LTS 포함)과 같은 특정 AEM Forms 릴리스의 호환 가능한 JBoss EAP 또는 Java 버전에 대한 불확실성이 있습니다.
  • 이 요청은 장애/수정 문제 해결이 아닌 지원되는 플랫폼, 설치 관리자 가용성, 사전 요구 사항 및 업그레이드 시퀀싱에 대한 신뢰할 수 있는 확인을 위한 것입니다.

근본 원인:

JEE의 AEM Forms은 OS, JBoss, Java 및 데이터베이스 레이어에 엄격한 호환성을 적용하므로 서비스 팩을 업그레이드하거나 적용하기 전에 조합을 검증해야 합니다. Adobe은 platform matrix에서 지원되는 조합을 문서화하지만 환경에 대한 적절한 해석과 매핑이 필요합니다. 지원되는 조합을 확인하지 않으면 지원되지 않는 바이너리를 설치하거나 성공할 수 없는 업그레이드 경로를 계획할 위험이 있습니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오.

  1. 현재 AEM Forms JEE 버전 및 플랫폼 구성 요소를 식별합니다. OS 버전, JBoss EAP 버전, Java 버전 및 데이터베이스 유형을 수집합니다. java -version을(를) 실행하고, JBoss EAP 콘솔 버전을 확인하고, RHEL에서 cat /etc/redhat-release과(와) 같은 OS 릴리스 명령을 실행하여 이를 확인합니다.
  2. 대상이 서비스 팩 업그레이드인지 LTS 마이그레이션인지 확인합니다. 6.5 LTS를 사용하려면 Java 17 또는 21 및 JBoss EAP 8이 필요하지만 6.5.x 서비스 팩 업그레이드는 Java 8 또는 11 및 JBoss 7.4.x에서 유지됩니다. 6.5.24(SP24) 또는 6.5 LTS를 타깃팅할지 여부를 알려줍니다.
  3. 공식 지원 플랫폼 매트릭스를 사용하여 플랫폼 지원의 유효성을 검사합니다. OS(RHEL 8, RHEL 9 또는 Windows Server 2022) 및 JBoss 버전이 대상 버전에 대한 매트릭스에 표시되는지 확인합니다. 플랫폼이 목록에 없으면 업그레이드하기 전에 명시적으로 지원되는 OS 및 JBoss 버전을 선택합니다.
  4. OS 마이그레이션(RHEL 7에서 RHEL 8로 또는 RHEL 8에서 RHEL 9로)의 경우 실행 가능성을 확인합니다. RHEL 8에는 SP11 이상이 필요하며 RHEL 9는 SP23 및 SP24를 지원합니다. 대상 OS를 매트릭스에서 지원되는 버전과 일치시키십시오. 해당 버전이 대상 OS를 지원하지 않는 경우 새 서버를 사용하여 원본 위치 외 마이그레이션을 계획하십시오.
  5. SP23 전체 설치 프로그램, SP24 패치 및 Forms 추가 기능을 포함하여 Adobe Software Distribution에서 올바른 전체 설치 프로그램 및 서비스 팩을 다운로드하십시오. 파일 이름이 aemforms_server_6_5_0_jboss_all_unix.tar.gz 또는 adobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zip 같은 패턴과 일치합니다. 소프트웨어 배포에 파일이 표시되지 않으면 Admin Console에서 Adobe ID에 올바른 권한이 있는지 확인하십시오.
  6. 업그레이드 준비 CRX 디렉토리, GDS, TEMP 및 데이터베이스를 백업하고 계속하기 전에 타임스탬프가 포함된 백업이 있는지 확인합니다.
  7. 새 AEM Forms JEE 전체 설치 관리자를 설치합니다. JBoss를 시작하고 /lc이(가) 로드되는지 확인합니다. 배포가 실패하면 JBoss 로그에서 배포 오류를 확인하고 OS 라이브러리를 확인합니다.
  8. 최신 서비스 팩(SP24) 및 Forms 추가 기능을 적용합니다. Linux 또는 Windows에서 JBoss용 SP24 패치를 설치한 다음 SP24 OSGi 구성 요소(서블릿 조각, 서비스 팩 및 Forms 추가 기능)를 설치합니다. /lc/system/console/bundles을(를) 확인하여 번들 생성이 롤링 오류를 중지하는지 확인하십시오. 그렇지 않으면 서블릿 조각을 다시 설치하거나 error.log에서 누락된 종속성을 확인하십시오.
  9. JBoss 업그레이드의 경우 필요한 환경 변수를 확인합니다. JBoss EAP 7.4.x를 업그레이드할 때 DISABLE_JDK_SERIAL_FILTER = true​를 설정한 다음 JBoss가 직렬화 오류 없이 시작되는지 확인하십시오. 직렬화 오류가 지속되면 JBoss 시작 스크립트에서 변수를 올바르게 내보냈는지 확인합니다.
  10. 업그레이드된 환경의 유효성을 검사합니다. JBoss를 시작하고 /adminui에 액세스하며 PDF Generator, Workbench 연결 및 Reader 확장과 같은 키 모듈을 테스트합니다. error.log에서 새 스택 추적 또는 롤링 메시지를 확인하십시오.

관련 읽기

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