Dokumentation

Åtgärda problem med routning av klientdomäner i AEM as a Cloud Service

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

Klientdomänroutning i Adobe Experience Manager as a Cloud Service (AEMaaCS) misslyckas när dispatchergrupper är felkonfigurerade, vilket gör att begäranden standardställs till fel servergrupp. Du kan lösa detta genom att validera inställningen av dispatcher, uppdatera alias för virtuella värddatorer, ändra namn på servergruppsfiler för att korrigera ordning, granska klientrubriker och verifiera CDN-inställningarna för korrekt domänmappning.

Beskrivning description

Miljö

Adobe Experience Manager as a Cloud Service (AEMaaCS) - Webbplatser, produktionsmiljö med Akamai CDN med domäncertifikat och flera anpassade domäner.

Problem/symtom

  • Dispatcher loggar visar varningar som: Ingen servergrupp matchar värden som är lokal värd, den senaste servergruppen publicerbar har valts.
  • Dispatcher-konfigurationen visas för att prioritera aktiverade grupper i omvänd alfabetisk ordning.
  • Symlänkar för filer i katalogerna enabled_vhosts och enabled_farms saknas.
  • Vissa nödvändiga serveralias, som localhost, 127.0.0.1, saknas i den virtuella värdkonfigurationen.

Upplösning resolution

Följ de här stegen för att lösa problemet:

  1. Verifiera Dispatcher-konfiguration:

    • Använd Dispatcher valideringsverktyg lokalt för att identifiera fel eller varningar i den aktuella konfigurationen.
    • Kontrollera att alla filer i katalogerna enabled_vhosts och enabled_farms är symboler.

  2. Uppdatera konfiguration för virtuell värd: Bekräfta att poster för virtuell värd innehåller alla nödvändiga serveralias: ServerAlias "*example.com" "*.local" "localhost" "127.0.0.1" "*.adobeaemcloud.net" "*.adobeaemcloud.com"

  3. Byt namn på aktiverade grupper: Ta bort numeriska prefix (till exempel 00_, 01_) från aktiverade gruppfilnamn, eftersom dessa kan orsaka problem med omvänd alfabetisk ordning när grupper väljs.

  4. Aktivera felsökningsloggning: Ange dispatcherloggar till felsökningsläge och hämta loggfragment som relaterar till gruppval eller felförekomster för ytterligare analys.

  5. Granska klientrubrikregler: Kontrollera klientrubrikregler (till exempel clientheaders.any och default_clientheaders.any) för hårdkodade platshållarvärden som 'localhost'. Ersätt dessa med lämpliga mappningar för inkommande begäranden.

  6. Testa ändringar lokalt: Distribuera den uppdaterade konfigurationen på en lokal Dispatcher-instans och validera funktionaliteten innan du tillämpar produktionsändringar.

  7. Distribuera uppdaterad konfiguration: Distribuera den uppdaterade Dispatcher-konfigurationen med dina pipeline-verktyg när den har validerats.

  8. Verifiera CDN-inställningar:

    • Kontrollera att CDN är korrekt konfigurerad att använda kundens domännamn.
    • Verifiera att rubriken X-Forwarded-Host har angetts korrekt och inte innehåller platshållarvärden som 'localhost'.

  9. Testa domänroutning igen: Efter distributionen bör du testa varje anpassad domän för att bekräfta att begäranden dirigeras korrekt till deras respektive servergrupper.

  10. Övervaka loggar efter distribution: Fortsätt övervaka Dispatcher-loggar efter distributionen för att identifiera eventuella avvikelser eller återkommande problem.

Relaterade avläsningar

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