DokumentationExperience Cloud KCS

UnknownHostException-Fehler beim Zugriff auf SAP-Dokumenthosts in Adobe Experience Manager

Letzte Aktualisierung: 5. Oktober 2026

In Adobe Experience Manager (AEM) treten java.net.UnknownHostException-Fehler auf, wenn der Server den Host-Namen eines SAP-Dokument-Hosts nicht auflösen kann. Das Problem ist häufig umgebungsspezifisch, da eine AEM-Umgebung ordnungsgemäß funktioniert und eine andere nicht. Um das Problem zu beheben, fügen Sie den SAP-Host zur Host-Auflösung hinzu.

Beschreibung description

Umgebung

Adobe Experience Manager (AEM)

Problem/Symptome

  • Adobe Experience Manager (AEM) kann den Hostnamen des SAP-Dokumenthosts bei der Integration in externe Systeme nicht auflösen.
  • Der Fehler java.net.UnknownHostException: tritt bei Anfragen an den SAP-Dokument-Host auf.
  • Der erforderliche Hostname ist in der Server-Host-Auflösungskonfiguration nicht vorhanden, z. B. die /etc/hosts.
  • Das Problem kann umgebungsspezifisch sein, d. h. eine AEM-Umgebung (z. B. die Produktion) funktioniert ordnungsgemäß, eine andere Umgebung (z. B. Staging oder Entwicklung) jedoch nicht.
  • Fehler beim Herunterladen von Dokumenten, da der SAP-Dokumenthost nicht aufgelöst werden kann.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Identifizieren Sie den SAP-Dokument-Host, auf den AEM zuzugreifen versucht, z. B. <sap-document-host>.
  2. Überprüfen Sie die Host-Auflösungskonfiguration auf dem betroffenen AEM-Server, z. B. die /etc/hosts, und überprüfen Sie, ob ein Eintrag für den SAP-Dokument-Host vorhanden ist.
  3. Wenn der Eintrag fehlt, fügen Sie den SAP-Dokument-Host zur /etc/hosts-Datei im folgenden Format hinzu: <sap-host-ip> <sap-document-host>. Ersetzen Sie <sap-host-ip> durch die richtige IP-Adresse des SAP-Dokumenthosts und < SAP-Document-Host> durch den entsprechenden Hostnamen.
  4. Speichern Sie die Änderungen in der Datei /etc/hosts.
  5. Starten Sie alle relevanten Services neu, wenn Ihre Umgebung neu gestartet werden muss, damit die Änderungen wirksam werden.
  6. Überprüfen Sie die Host-Namensauflösung vom AEM-Server, indem Sie ping <sap-document-host> ausführen, und stellen Sie sicher, dass der Host-Name erfolgreich aufgelöst wird.
  7. Wiederholen Sie den Vorgang zum Herunterladen des Dokuments in AEM und bestätigen Sie, dass das Problem behoben ist.
recommendation-more-help
experience-cloud-kcs-help-kbarticles