설명서Experience Cloud KCS

OS 또는 종속성 불일치로 인해 AEM Dispatcher 설치 및 업그레이드 실패

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

OS, OpenSSL 또는 아키텍처 업데이트 후 Apache가 시작되지 않거나 모듈이 로드되지 않거나 종속성 불일치가 발생하면 Adobe Experience Manager(AEM) Dispatcher 설치 또는 업그레이드가 실패합니다. 이 문제는 시스템 라이브러리와 호환되지 않는 Dispatcher 바이너리, 잘못된 모듈 선택 또는 환경 업그레이드 중 지원되지 않는 아키텍처로 인해 발생합니다. 이 문제를 해결하려면 올바른 바이너리를 선택하고 의존성을 확인한 다음 구성을 정렬합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • libssl 또는 libcrypto 종속성이 누락되어 업그레이드 후 Apache를 시작할 수 없습니다.
  • 호환되지 않는 아키텍처로 인해 Dispatcher 모듈이 로드되지 않거나 잘못 로드됩니다.
  • OpenSSL 버전(예: 1.1에서 3.0) 간에 마이그레이션할 때 환경에 오류가 표시됩니다.
  • 시스템에서 RHEL 8, RHEL 9 또는 Amazon Linux 2023과 같이 지원되는 OS 버전에 대한 불확실성 또는 불일치를 보여줍니다.

근본 원인

이 문제는 Dispatcher 모듈이 특정 CPU 아키텍처, OpenSSL 버전, Apache 빌드 및 OS 수준 라이브러리에 따라 달라지기 때문에 시스템 환경과 일치하지 않을 때 발생합니다. 환경이 업그레이드되거나 변경되면 종속성 불일치, 잘못된 이진 선택 또는 이전 버전의 ARM64와 같은 지원되지 않는 아키텍처로 인해 기존 모듈이 로드되지 않습니다.

해결 방법 resolution

다음 단계에 따라 환경을 식별하고 호환되는 Dispatcher 모듈을 설치하십시오.

  1. 시스템 명령을 사용하여 OS, Apache, CPU 아키텍처 및 OpenSSL 버전을 확인하여 운영 환경을 식별합니다.
  2. OpenSSL 버전, OS 및 아키텍처(예: ssl1.1, ssl3.0 또는 ARM64 지원 버전)를 기반으로 하는 바이너리를 선택하여 올바른 Dispatcher 패키지를 결정합니다.
  3. 서버에서 Dispatcher 패키지를 다운로드하여 추출하고 추출 후 모듈 파일을 사용할 수 있는지 확인합니다.
  4. Dispatcher 모듈 파일을 Apache modules 디렉터리에 복사하고 파일이 올바른 위치에 있는지 확인합니다.
  5. 올바른 모듈 경로를 사용하여 Dispatcher LoadModule 지시문을 추가하여 Apache 구성을 업데이트합니다.
  6. 필요한 모든 라이브러리가 있고 OpenSSL 버전과 일치하는지 확인하여 모듈 종속성을 확인합니다.
  7. Apache를 다시 시작하고 Dispatcher 모듈이 시작 오류 없이 성공적으로 로드되었는지 확인합니다.
  8. 업그레이드 후 Dispatcher 캐시를 지우면 새 에셋이 올바르게 로드되고 오래된 콘텐츠 문제가 발생하지 않습니다.
  9. 구성 검사를 실행하고, 로그를 확인하고, 테스트 요청을 보내고, 성공적인 모듈 초기화 및 캐싱 동작을 확인하여 해결의 유효성을 확인합니다.

에스컬레이션 시기

  • 종속성 및 구성 문제를 해결한 후에도 Apache 서비스를 시작할 수 없습니다.
  • Dispatcher 모듈이 로드되지만 여전히 종속성 또는 호환성 오류가 표시됩니다.
  • 대상 OS 또는 아키텍처에 필요한 Dispatcher 패키지가 없습니다.
  • 이 환경에는 ARM64용 이전 Dispatcher 버전과 같이 지원되지 않는 구성이 필요합니다.

관련 읽기

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