在Adobe Experience Manager中访问SAP文档主机时出现UnknownHostException错误

在Adobe Experience Manager (AEM)中,当服务器无法解析SAP文档主机的主机名时,会出现java.net.UnknownHostException错误。 问题通常特定于环境,其中一个AEM环境可正常运行,而另一个环境则无法正常运行。 要解决此问题,请将SAP主机添加到主机解决方案中。

描述 description

环境

Adobe Experience Manager (AEM)

问题/症状

  • 与外部系统集成时,Adobe Experience Manager (AEM)无法解析SAP文档主机的主机名。
  • 在向SAP文档主机发出请求期间出现错误​java.net.UnknownHostException:。
  • 服务器主机解析配置(如/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地址,将< sap-document-host>替换为相应的主机名。
  4. 将更改保存到/etc/hosts文件。
  5. 如果您的环境需要重新启动才能使更改生效,请重新启动任何相关的服务。
  6. 通过运行ping <sap-document-host>验证AEM服务器的主机名解析,并验证主机名解析成功。
  7. 请在AEM中重试文档下载操作,并确认问题已得到解决。
recommendation-more-help
experience-cloud-kcs-help-kbarticles