설명서Experience Cloud KCS

복원 후 호환되지 않는 번들 및 콘텐츠 문제로 인해 작성자 인스턴스 중단

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

이 문서에서는 호환되지 않는 번들 및 서비스 사용자 누락으로 인해 복원 후 콘텐츠를 시작하거나 제공하지 못하는 Adobe Experience Manager 스테이지 작성자 인스턴스를 복구하는 방법을 설명합니다.

설명 description

환경

AEM (Adobe Experience Manager)

문제/증상

  • 스테이지 작성자 인스턴스에 오랜 기간(8시간 이상) 동안 액세스할 수 없습니다.
  • 작성자 인스턴스를 탐색하면 오류나 빈 페이지가 발생합니다.
  • /libs/granite/core/content/login.html의 로그인 페이지에 액세스할 수 없습니다.
  • 오류 로그에 호환되지 않는 번들과 서비스 사용자 누락과 관련된 문제가 표시됩니다.
  • org.apache.aries.spifly.dynamic.bundle 및 linkcheckerTransformer과(와) 관련된 오류가 있습니다.
  • 여러 백업에서 복원하고 AEM을 다시 시작해도 문제가 해결되지 않습니다.

로그에서 다음 오류가 관찰될 수 있습니다.

번들 org.apache.aries.spifly.dynamic.bundle을 로드하는 동안 오류가 발생했습니다. Java 21과 호환되지 않습니다.

다음 위치의 linkcheckerTransformer 구성에 오류가 있습니다.
/apps/< application> /config/rewriter/versioned-clientlibs.

서비스 사용자에게 오류가 없습니다.

원인

Java21에서 호환되지 않는 번들(org.apache.aries.spifly.dynamic.bundle)을 사용하여 작성자 인스턴스를 복원하는 작업이 지원되지 않으며, linkchecker transformer이(가) 잘못 구성되었으며, 서비스 사용자가 누락되어 시작 및 콘텐츠 액세스가 실패했습니다.

해결 방법 resolution

문제를 해결하려면 다음 단계를 수행합니다.

  1. 작성자 인스턴스의 가장 최근의 유효한 백업을 식별하고 이 백업을 사용하여 작성자 인스턴스를 복원합니다.
  2. 복원 후 오류 로그에서 호환되지 않는 번들(예: org.apache.aries.spifly.dynamic.bundle)을 확인하십시오.
  3. OSGi 콘솔 또는 파일 시스템에서 호환되지 않는 번들을 제거하고 AEM 인스턴스를 다시 시작하십시오.
  4. linkcheckerTransformer과(와) 관련된 오류가 발생하면 /apps/<application>/config/rewriter/versioned-clientlibs에서 구성을 업데이트하십시오.
  5. 필요에 따라 linkchecker 구성을 제거하거나 수정하고 AEM을 다시 시작하여 변경 내용을 적용합니다.
  6. 누락된 서비스 사용자 오류에 대한 오류 로그를 검토하십시오. 필요한 서비스 사용자가 모두 있고 올바르게 구성되어 있는지 확인하십시오.
  7. 특정 콘텐츠 경로가 누락된 경우(예: /content/<content-root>/us/en) 필요한 경로에 대해 게시자 인스턴스에서 패키지를 만듭니다.
  8. 작성자 인스턴스에 패키지를 설치합니다.
  9. 이제 콘텐츠를 사용할 수 있는지 확인합니다. 로그인 페이지 및 작성 UI에 액세스할 수 있는지 확인합니다.
  10. 필요한 모든 컨텐츠 및 구성이 있는지 확인합니다.
recommendation-more-help
experience-cloud-kcs-help-kbarticles