ドキュメントExperience Cloud KCS

OSまたは依存関係の不一致によるAEM Dispatcherのインストールとアップグレードのエラー

最終更新日： 2026年6月22日

Adobe Experience Manager（AEM） Apacheが起動しない、モジュールが読み込まれない、またはOS、OpenSSL、またはアーキテクチャのアップデート後に依存関係が一致しない場合、Dispatcherのインストールまたはアップグレードが失敗します。 この問題は、システムライブラリとの互換性のないDispatcher バイナリ、モジュールの選択が正しくないか、環境のアップグレード中にサポートされていないアーキテクチャが原因で発生します。 この問題を解決するには、正しいバイナリを選択し、依存関係を検証して、設定を調整します。

説明 description

環境

Adobe Experience Manager as a Cloud Service （AEMaaCS）

問題/症状

  • libsslまたはlibcryptoの依存関係が欠落しているため、アップグレード後にApacheを開始できません。
  • 互換性のないアーキテクチャが原因で、Dispatcher モジュールが読み込まれない、または正しく読み込まれない。
  • 環境は、1.1から3.0などのOpenSSL バージョン間で移行する際にエラーを表示します。
  • 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 モジュールディレクトリにコピーし、ファイルが正しい場所に存在することを確認します。
  5. 正しいモジュールパスでDispatcher LoadModule ディレクティブを追加して、Apache設定を更新します。
  6. 必要なすべてのライブラリが存在し、OpenSSL バージョンと一致することを確認して、モジュールの依存関係を検証します。
  7. Apacheを再起動し、起動エラーなしでDispatcher モジュールが正常に読み込まれることを確認します。
  8. アップグレード後にDispatcherのキャッシュをクリアすることで、新しいアセットが正しく読み込まれるようになり、古いコンテンツの問題を回避できます。
  9. 設定チェックの実行、ログの検証、テストリクエストの送信、モジュールの初期化とキャッシュの動作の確認により、解決を検証します。

エスカレーションするタイミング

  • 依存関係と設定の問題を解決した後でも、Apache サービスを開始できません。
  • Dispatcher モジュールが読み込まれますが、依存関係または互換性のエラーが表示されます。
  • 対象のOSまたはアーキテクチャに必要なDispatcher パッケージが存在しません。
  • この環境では、古いDispatcher バージョンのARM64など、サポートされていない構成が必要です。

関連トピックス

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