DocumentazioneExperience Cloud KCS

Errori UnknownHostException durante l’accesso agli host dei documenti SAP in Adobe Experience Manager

Ultimo aggiornamento: 5 ottobre 2026

In Adobe Experience Manager (AEM), si verificano errori java.net.UnknownHostException quando il server non è in grado di risolvere il nome host di un host documenti SAP. Il problema è spesso specifico per l’ambiente, dove un ambiente AEM funziona correttamente, un altro no. Per risolvere il problema, aggiungere l’host SAP alla risoluzione host.

Descrizione description

Ambiente

Adobe Experience Manager (AEM)

Problema/Sintomi

  • Adobe Experience Manager (AEM) non è in grado di risolvere il nome host dell’host documenti SAP durante l’integrazione con sistemi esterni.
  • L’errore java.net.UnknownHostException: viene visualizzato durante le richieste all’host documenti SAP.
  • Il nome host richiesto non è presente nella configurazione di risoluzione host del server, ad esempio il file /etc/hosts.
  • Il problema può essere specifico per l’ambiente, dove un ambiente AEM (ad esempio, produzione) funziona correttamente mentre un altro ambiente (come staging o sviluppo) no.
  • Le operazioni di download dei documenti non riescono perché non è possibile risolvere l’host dei documenti SAP.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Identificare l’host documenti SAP a cui AEM sta tentando di accedere, ad esempio <sap-document-host>.
  2. Controllare la configurazione della risoluzione host sul server AEM interessato, ad esempio il file /etc/hosts, e verificare se esiste una voce per l’host documenti SAP.
  3. Se manca la voce, aggiungere l’host del documento SAP al file /etc/hosts utilizzando il seguente formato: <sap-host-ip> <sap-document-host>. Sostituire <sap-host-ip> con l’indirizzo IP corretto dell’host documenti SAP e < sap-document-host> con il nome host corrispondente.
  4. Salva le modifiche al file /etc/hosts.
  5. Riavvia tutti i servizi pertinenti se l’ambiente richiede il riavvio per rendere effettive le modifiche.
  6. Convalidare la risoluzione dei nomi host dal server AEM eseguendo ping <sap-document-host> e verificare che il nome host sia stato risolto correttamente.
  7. Ritenta l’operazione di download del documento in AEM e conferma che il problema è stato risolto.
recommendation-more-help
experience-cloud-kcs-help-kbarticles