DocumentationExperience Cloud KCS

Erreurs UnknownHostException lors de l’accès aux hôtes de documents SAP dans Adobe Experience Manager

Dernière mise à jour : 5 octobre 2026

Dans Adobe Experience Manager (AEM), les erreurs java.net.UnknownHostException se produisent lorsque le serveur ne peut pas résoudre le nom d’hôte d’un document SAP. Le problème est souvent spécifique à un environnement, où un environnement AEM fonctionne correctement tandis qu’un autre ne le fait pas. Pour résoudre le problème, ajoutez la résolution hôte à hôte SAP .

Description description

Environnement

Adobe Experience Manager (AEM)

Problème/Symptômes

  • Adobe Experience Manager (AEM) ne peut pas résoudre le nom d’hôte de l’hôte de document SAP lors de l’intégration à des systèmes externes.
  • L’erreur java.net.UnknownHostException: s’affiche lors des requêtes à l’hôte de document SAP.
  • Le nom d’hôte requis n’est pas présent dans la configuration de résolution de l’hôte du serveur, comme le fichier /etc/hosts.
  • Le problème peut être spécifique à un environnement, où un environnement AEM (par exemple, de production) fonctionne correctement tandis qu’un autre environnement (tel que l’évaluation ou le développement) ne fonctionne pas.
  • Les opérations de téléchargement de documents échouent, car l’hôte de document SAP ne peut pas être résolu.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Identifiez l’hôte de document SAP auquel AEM tente d’accéder, par exemple <sap-document-host>.
  2. Vérifiez la configuration de résolution de l’hôte sur le serveur AEM affecté, tel que le fichier /etc/hosts, et vérifiez s’il existe une entrée pour l’hôte de document SAP.
  3. Si l’entrée est manquante, ajoutez l’hôte de document SAP au fichier /etc/hosts en utilisant le format suivant : <sap-host-ip> <sap-document-host>. Remplacez <sap-host-ip> par l’adresse IP correcte de l’hôte de document SAP et < hôte de document SAP> par le nom d’hôte correspondant.
  4. Enregistrez les modifications dans le fichier /etc/hosts.
  5. Redémarrez les services appropriés si votre environnement nécessite un redémarrage pour que les modifications soient prises en compte.
  6. Validez la résolution du nom d’hôte à partir du serveur AEM en exécutant ping <sap-document-host> et vérifiez que le nom d’hôte est résolu correctement.
  7. Réessayez l’opération de téléchargement de document dans AEM et confirmez que le problème est résolu.
recommendation-more-help
experience-cloud-kcs-help-kbarticles