ドキュメントExperience Cloud KCS

Adobe Experience ManagerでSAP ドキュメントホストにアクセスする際のUnknownHostException エラー

最終更新日： 2026年10月5日

Adobe Experience Manager （AEM）では、サーバーがSAP ドキュメントホストのホスト名を解決できない場合にjava.net.UnknownHostException エラーが発生します。 この問題は多くの場合、あるAEM環境が正しく機能するのに対し、別の環境が正しく機能しない場合に発生します。 この問題を解決するには、SAP ホストをホスト解決に追加します。

説明 description

環境

Adobe Experience Manager（AEM）

問題/症状

  • Adobe Experience Manager（AEM）は、外部システムと統合する際に、SAP ドキュメントホストのホスト名を解決できません。
  • エラー​ java.net.UnknownHostException: ​は、SAP ドキュメント ホストへのリクエスト中に表示されます。
  • 必要なホスト名が、/etc/hosts ファイルなどのサーバーのホスト解決構成に存在しません。
  • この問題は、あるAEM環境（実稼動環境など）が正しく機能するのに対して、別の環境（ステージングや開発など）が正しく機能しない場合に、環境固有の問題になる可能性があります。
  • SAP ドキュメント ホストを解決できないため、ドキュメントのダウンロード操作が失敗します。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. AEMがアクセスしようとしているSAP ドキュメントホスト （例：<sap-document-host>）を特定します。
  2. 影響を受けるAEM サーバー（/etc/hosts ファイルなど）のホスト解決設定を確認し、SAP ドキュメントホストにエントリが存在するかどうかを確認します。
  3. エントリが見つからない場合は、次の形式を使用してSAP ドキュメント ホストを/etc/hosts ファイルに追加します：<sap-host-ip> <sap-document-host>。 <sap-host-ip>をSAP ドキュメントホストの正しいIP アドレスに置き換え、<を対応するホスト名に置き換えます。>
  4. /etc/hosts ファイルに変更を保存します。
  5. 環境で変更を有効にするために再起動が必要な場合は、関連するサービスを再起動します。
  6. ping <sap-document-host>を実行して、AEM サーバーからのホスト名解決を検証し、ホスト名が正常に解決されることを確認します。
  7. AEMでドキュメントのダウンロード操作を再試行し、問題が解決されたことを確認します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles