Documentazione

Risoluzione dei problemi di routing del dominio client in AEM as a Cloud Service

Last update: Sat Sep 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Il routing del dominio client in Adobe Experience Manager as a Cloud Service (AEMaaCS) non riesce quando le farm del dispatcher non sono configurate correttamente, rendendo le richieste predefinite nella farm errata. Per risolvere questo problema, convalida la configurazione di Dispatcher, aggiorna gli alias degli host virtuali, rinomina i file della farm per correggere l’ordine, rivedi le intestazioni client e verifica le impostazioni CDN per la mappatura corretta del dominio.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS): siti, ambiente di produzione che utilizza la rete CDN di Akamai con certificati di dominio e più domini personalizzati.

Problema/Sintomi

  • Nei registri di Dispatcher vengono visualizzati avvisi, ad esempio: Nessuna farm corrisponde all'host 'localhost', ultima farm selezionata 'publishfarm'.
  • La configurazione del dispatcher sembra assegnare la priorità alle farm abilitate in ordine alfabetico inverso.
  • Mancano i collegamenti simbolici per i file nelle directory enabled_vhosts e enabled_farms.
  • Alcuni alias server richiesti, ad esempio localhost, 127.0.0.1, sono assenti dalla configurazione host virtuale.

Risoluzione resolution

Per risolvere il problema, eseguire la procedura seguente:

  1. Convalida configurazione Dispatcher:

    • Utilizzare lo strumento di convalida di Dispatcher localmente per identificare eventuali errori o avvisi nella configurazione corrente.
    • Assicurarsi che tutti i file nelle directory enabled_vhosts e enabled_farms siano symlink.

  2. Aggiorna configurazione host virtuale: Verificare che le voci host virtuali includano tutti gli alias server necessari: ServerAlias "*example.com" "*.local" "localhost" "127.0.0.1" "*.adobeaemcloud.net" "*.adobeaemcloud.com"

  3. Rinomina farm abilitate: Rimuovere i prefissi numerici (ad esempio, 00_, 01_) dai nomi di file della farm abilitati, in quanto potrebbero verificarsi problemi di ordinamento alfabetico inverso durante la selezione della farm.

  4. Abilita registrazione debug: Imposta i registri del dispatcher in modalità di debug e acquisisci snippet di registro relativi alla selezione della farm o a occorrenze di errori per ulteriori analisi.

  5. Rivedi regole intestazione client: Controlla le regole intestazione client (ad esempio, clientheaders.any e default_clientheaders.any) per i valori segnaposto hardcoded come 'localhost'. Sostituiscili con mappature appropriate per le richieste in arrivo.

  6. Verifica modifiche in locale: Distribuisci la configurazione aggiornata in un'istanza Dispatcher locale e convalida la funzionalità prima di applicare le modifiche alla produzione.

  7. Distribuisci configurazione aggiornata: Una volta convalidata, distribuisci la configurazione Dispatcher aggiornata utilizzando gli strumenti della pipeline.

  8. Verifica impostazioni CDN:

    • Verifica che la rete CDN sia configurata correttamente per l’utilizzo dei nomi di dominio del cliente.
    • Verificare che l'intestazione X-Forwarded-Host sia impostata correttamente e non contenga valori segnaposto come 'localhost'.

  9. Ripeti test routing dominio: Dopo la distribuzione, eseguire il test di ogni dominio personalizzato per verificare che le richieste vengano indirizzate correttamente alle rispettive farm.

  10. Monitora registri post-distribuzione: Continua a monitorare i registri di Dispatcher dopo la distribuzione per identificare eventuali anomalie o problemi ricorrenti.

Letture correlate

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f