ドキュメントExperience Cloud KCS

互換性のないバンドルと復元後のコンテンツの問題により、オーサーインスタンスをステージダウンする

最終更新日： 2026年8月27日

この記事では、互換性のないバンドルやサービスユーザーが不足しているため、復元後にコンテンツの開始または提供に失敗したAdobe Experience Manager ステージのオーサーインスタンスを復元する方法について説明します。

説明 description

環境

Adobe Experience Manager（AEM）

問題/症状

  • ステージオーサーインスタンスに長時間（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/< アプリケーション > /config/rewriter/versioned-clientlibs.

サービスユーザーにエラーがありません。

原因：

互換性のないバンドル （org.apache.aries.spifly.dynamic.bundle）を持つオーサーインスタンスを復元すると、Java21でサポートされず、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