Konfigurera Dispatcher configuring-dispatcher

I följande avsnitt beskrivs hur du konfigurerar olika aspekter av Dispatcher.

Stöd för IPv4 och IPv6 support-for-ipv-and-ipv

Alla element i AEM och Dispatcher kan installeras i både IPv4- och IPv6-nätverk. Se IPV4 och IPV6.

Dispatcher-konfigurationsfiler dispatcher-configuration-files

Som standard lagras Dispatcher-konfigurationen i dispatcher.any textfil, men du kan ändra namn och plats för filen under installationen.

Konfigurationsfilen innehåller en serie egenskaper med ett eller flera värden som styr Dispatcher-beteendet:

En exempelkonfiguration är strukturerad på följande sätt:

# name of the dispatcher
/name "internet-server"

# each farm configures a set off (loadbalanced) renders
/farms
 {
  # first farm entry (label is not important, just for your convenience)
   /website
     {
     /clientheaders
       {
       # List of headers that are passed on
       }
     /virtualhosts
       {
       # List of URLs for this Web site
       }
     /sessionmanagement
       {
       # settings for user authentification
       }
     /renders
       {
       # List of AEM instances that render the documents
       }
     /filter
       {
       # List of filters
       }
     /vanity_urls
       {
       # List of vanity URLs
       }
     /cache
       {
       # Cache configuration
       /rules
         {
         # List of cachable documents
         }
       /invalidate
         {
         # List of auto-invalidated documents
         }
       }
     /statistics
       {
       /categories
         {
         # The document categories that are used for load balancing estimates
         }
       }
     /stickyConnectionsFor "/myFolder"
     /health_check
       {
       # Page gets contacted when an instance returns a 500
       }
     /retryDelay "1"
     /numberOfRetries "5"
     /unavailablePenalty "1"
     /failover "1"
     }
 }

Du kan inkludera andra filer som bidrar till konfigurationen:

Om du till exempel vill ta med filen myFarm.any i konfigurationen /farm använder du följande kod:

/farms
  {
  $include "myFarm.any"
  }

Använd asterisken (*) som jokertecken.

Om filerna farm_1.any till farm_5.any innehåller konfigurationen av grupperna ett till fem, du kan inkludera dem enligt följande:

/farms
  {
  $include "farm_*.any"
  }

Använda miljövariabler using-environment-variables

Du kan använda miljövariabler i egenskaper med strängvärden i dispatcher.any-filen i stället för att hårdkoda värdena. Om du vill ta med värdet för en miljövariabel använder du formatet ${variable_name}.

Om till exempel filen dispatcher.any finns i samma katalog som cachekatalogen, anger följande värde för docroot kan användas:

/docroot "${PWD}/cache"

Om du till exempel skapar en miljövariabel med namnet PUBLISH_IP som lagrar värdnamnet för den AEM publiceringsinstansen, följande konfiguration av /renders kan användas:

/renders {
  /0001 {
    /hostname "${PUBLISH_IP}"
    /port "8443"
  }
}

Namnge Dispatcher-instansen naming-the-dispatcher-instance-name

Använd /name för att ange ett unikt namn som identifierar Dispatcher-instansen. The /name -egenskapen är en egenskap på den översta nivån i konfigurationsstrukturen.

Definiera grupper defining-farms-farms

The /farms -egenskapen definierar en eller flera uppsättningar Dispatcher-beteenden, där varje uppsättning är kopplad till olika webbplatser eller URL-adresser. The /farms kan innehålla en eller flera grupper:

The /farms -egenskapen är en egenskap på den översta nivån i konfigurationsstrukturen. Om du vill definiera en servergrupp lägger du till en underordnad egenskap i /farms -egenskap. Använd ett egenskapsnamn som unikt identifierar servergruppen i Dispatcher-instansen.

The /farmname egenskapen är flervärdesbaserad och innehåller andra egenskaper som definierar Dispatcher-beteendet:

Värdet kan innehålla alla alfanumeriska tecken (a-z, 0-9). I följande exempel visas skelettdefinitionen för två grupper med namnet /daycom och /docsdaycom:

#name of dispatcher
/name "day sites"

#farms section defines a list of farms or sites
/farms
{
   /daycom
   {
       ...
   }
   /docdaycom
   {
      ...
   }
}

Varje gruppegenskap kan innehålla följande underordnade egenskaper:

Ange en standardsida (endast IIS) - /hemsida specify-a-default-page-iis-only-homepage

Ange vilka HTTP-huvuden som ska passera igenom specifying-the-http-headers-to-pass-through-clientheaders

The /clientheaders -egenskapen definierar en lista med HTTP-huvuden som Dispatcher skickar från klientens HTTP-begäran till återgivaren (AEM instans).

Som standard vidarebefordrar Dispatcher standard-HTTP-huvuden till AEM. I vissa fall kanske du vill vidarebefordra andra rubriker eller ta bort specifika rubriker:

Om du anpassar uppsättningen rubriker som ska skickas måste du ange en uttömmande lista över rubriker, inklusive de rubriker som normalt inkluderas som standard.

En Dispatcher-instans som hanterar sidaktiveringsbegäranden för publiceringsinstanser kräver PATH sidhuvud i /clientheaders -avsnitt. The PATH I kan du kommunicera mellan replikeringsagenten och Dispatcher.

Följande kod är en exempelkonfiguration för /clientheaders:

/clientheaders
  {
  "CSRF-Token"
  "X-Forwarded-Proto"
  "referer"
  "user-agent"
  "authorization"
  "from"
  "content-type"
  "content-length"
  "accept-charset"
  "accept-encoding"
  "accept-language"
  "accept"
  "host"
  "max-forwards"
  "proxy-authorization"
  "proxy-connection"
  "range"
  "cookie"
  "cq-action"
  "cq-handle"
  "handle"
  "action"
  "cqstats"
  "depth"
  "translate"
  "expires"
  "date"
  "dav"
  "ms-author-via"
  "if"
  "lock-token"
  "x-expected-entity-length"
  "destination"
  "PATH"
  }

Identifiera virtuella värdar identifying-virtual-hosts-virtualhosts

The /virtualhosts -egenskapen definierar en lista med alla värdnamns-/URI-kombinationer som Dispatcher accepterar för den här servergruppen. Du kan använda asterisken (*) som jokertecken. Värden för / virtualhosts -egenskapen har följande format:

[scheme]host[uri][*]

I följande exempel hanteras begäranden för .com och .ch domains of myCompany, and all domains of mySubDivision:

   /virtualhosts
    {
    "www.myCompany.com"
    "www.myCompany.ch"
    "www.mySubDivison.*"
    }

Följande konfigurationshandtag alla begäranden:

   /virtualhosts
    {
    "*"
    }

Matchar den virtuella värden resolving-the-virtual-host

När Dispatcher tar emot en HTTP- eller HTTPS-begäran, hittas det virtuella värdvärde som bäst matchar host, urioch scheme begärans rubriker. Dispatcher utvärderar värdena i virtualhosts i följande ordning:

Dispatcher hittar det mest matchande virtuella värdvärdet på följande sätt:

Därför bör du placera din virtuella standardvärd högst upp i virtualhosts i den översta servergruppen i dispatcher.any -fil.

Exempel på virtuell värdupplösning example-virtual-host-resolution

Följande exempel representerar ett fragment från en dispatcher.any en fil som definierar två Dispatcher-grupper och varje grupp definierar en virtualhosts -egenskap.

/farms
  {
  /myProducts
    {
    /virtualhosts
      {
      "www.mycompany.com/products/*"
      }
    /renders
      {
      /hostname "server1.myCompany.com"
      /port "80"
      }
    }
  /myCompany
    {
    /virtualhosts
      {
      "www.mycompany.com"
      }
    /renders
      {
      /hostname "server2.myCompany.com"
      /port "80"
      }
    }
  }

I följande tabell visas de virtuella värdarna som matchas för de angivna HTTP-begäranden:

Aktivera säkra sessioner - /sessionmanagement enabling-secure-sessions-sessionmanagement

Skapa en säker session för åtkomst till renderingsgruppen så att användarna måste logga in för att komma åt alla sidor i gruppen. När användaren har loggat in kan han/hon komma åt sidor i servergruppen. Se Skapa en stängd användargrupp om du vill ha information om hur du använder den här funktionen med CUG. Se även Skicka Säkerhetschecklista innan du publicerar.

The /sessionmanagement egenskapen är en underegenskap till /farms.

/sessionmanagement har flera underparametrar:

/directory (obligatoriskt)

Katalogen som lagrar sessionsinformationen. Om katalogen inte finns skapas den.

/sessionmanagement
  {
  /directory "/usr/local/apache/.sessions"
  }

/encode (valfritt)

Hur sessionsinformationen kodas. Använd md5 för kryptering med md5-algoritmen, eller hex för hexadecimal kodning. Om du krypterar sessionsdata kan en användare med åtkomst till filsystemet inte läsa sessionsinnehållet. Standardvärdet är md5.

/header (valfritt)

Namnet på HTTP-huvudet eller cookien som lagrar auktoriseringsinformationen. Om du lagrar informationen i http-huvudet använder du HTTP:<header-name>. Om du vill lagra informationen i en cookie använder du Cookie:<header-name>. Om du inte anger något värde HTTP:authorization används.

/timeout (valfritt)

Antalet sekunder tills sessionen tar slut efter att den har använts sist. Om inte angivet "800" används så sessionen tar lite längre tid än 13 minuter efter användarens senaste begäran.

Ett exempel på konfiguration ser ut så här:

/sessionmanagement
  {
  /directory "/usr/local/apache/.sessions"
  /encode "md5"
  /header "HTTP:authorization"
  /timeout "800"
  }

Definiera sidåtergivare defining-page-renderers-renders

Egenskapen /renders definierar den URL som Dispatcher skickar begäranden till för att återge ett dokument. Följande exempel /renders används för att identifiera en enda AEM för återgivning:

/renders
  {
    /myRenderer
      {
      # hostname or IP of the renderer
      /hostname "aem.myCompany.com"
      # port of the renderer
      /port "4503"
      # connection timeout in milliseconds, "0" (default) waits indefinitely
      /timeout "0"
      }
  }

I följande exempel/renders-avsnitt identifieras en AEM som körs på samma dator som Dispatcher:

/renders
  {
    /myRenderer
     {
     /hostname "127.0.0.1"
     /port "4503"
     }
  }

I följande exempel distribueras renderingsbegäranden lika mellan två AEM instanser:

/renders
  {
    /myFirstRenderer
      {
      /hostname "aem.myCompany.com"
      /port "4503"
      }
    /mySecondRenderer
      {
      /hostname "127.0.0.1"
      /port "4503"
      }
  }

Återgivningsalternativ renders-options

/timeout

Anger timeout för anslutningen som använder AEM i millisekunder. Standardvärdet är "0", vilket får Dispatcher att vänta oändligt.

/receiveTimeout

Anger tiden i millisekunder som ett svar får ta. Standardvärdet är "600000", vilket gör att Dispatcher väntar i 10 minuter. En inställning för "0" eliminerar tidsgränsen.

Om tidsgränsen nås när svarshuvuden tolkas returneras HTTP-statusen 504 (Felaktig gateway). Om tidsgränsen nås när svarstexten läses, returnerar Dispatcher det ofullständiga svaret till klienten. Eventuella cachelagrade filer som kan ha skrivits tas också bort.

/ipv4

Anger om Dispatcher använder getaddrinfo funktionen (för IPv6) eller gethostbyname funktion (för IPv4) för att hämta återgivningens IP-adress. Värdet 0 orsakar getaddrinfo som ska användas. Värdet för 1 orsaker gethostbyname som ska användas. Standardvärdet är 0.

The getaddrinfo funktionen returnerar en lista med IP-adresser. Dispatcher itererar listan över adresser tills en TCP/IP-anslutning upprättas. Därför är ipv4 egenskapen är viktig när återgivningsvärdnamnet är associerat med flera IP-adresser och värden som svar på getaddrinfo returnerar en lista med IP-adresser som alltid finns i samma ordning. I sådana fall bör du använda gethostbyname så att den IP-adress som Dispatcher ansluter till är slumpmässig.

Amazon Elastic Load Balancing (ELB) är en tjänst som svarar på getaddrinfo med en lista över IP-adresser som kan vara i samma ordning.

/secure

Om /secure egenskapen har värdet "1", används HTTPS för att kommunicera med AEM. Mer information finns i Konfigurera Dispatcher att använda SSL.

/always-resolve

Med Dispatcher-version 4.1.6 kan du konfigurera /always-resolve egenskap enligt följande:

Den här egenskapen kan även användas om du stöter på problem med dynamisk IP-upplösning, vilket visas i följande exempel:

/renders {
  /0001 {
     /hostname "host-name-here"
     /port "4502"
     /ipv4 "1"
     /always-resolve "1"
     }
  }

Konfigurera åtkomst till innehåll configuring-access-to-content-filter

Använd /filter för att ange de HTTP-begäranden som Dispatcher accepterar. Alla andra begäranden skickas tillbaka till webbservern med felkoden 404 (sidan hittades inte). Om nej /filter finns, alla begäranden accepteras.

Obs! Begäranden statfile avvisas alltid.

The /filter -avsnittet består av en serie regler som antingen nekar eller tillåter åtkomst till innehåll enligt mönster i begärandoradsdelen av HTTP-begäran. Använd en tillåtelselista-strategi för /filter avsnitt:

Definiera ett filter defining-a-filter

Varje objekt i /filter -avsnittet innehåller en typ och ett mönster som matchas med ett visst element på begärandaden eller hela begärandraden. Varje filter kan innehålla följande objekt:

Begärandelen av HTTP-begäranden the-request-line-part-of-http-requests

HTTP/1.1 definierar request-line enligt följande:

Method Request-URI HTTP-Version<CRLF>

The <CRLF> tecken representerar en vagnretur följt av en radmatning. Följande exempel är den frågerad som tas emot när en klient begär sidan amerikansk-engelska på WKND-webbplatsen:

GET /content/wknd/us/en.html HTTP.1.1<CRLF>

Dina mönster måste ta hänsyn till blankstegstecknen på förfrågningsraden och <CRLF> tecken.

Dubbla citattecken jämfört med enkla citattecken double-quotes-vs-single-quotes

Använd citattecken när du skapar filterregler "pattern" för enkla mönster. Om du använder Dispatcher 4.2.0 eller senare och mönstret innehåller ett reguljärt uttryck, måste du omsluta regex-mönstret '(pattern1|pattern2)' inom enkla citattecken.

Reguljära uttryck regular-expressions

I Dispatcher-versioner senare än 4.2.0 kan du inkludera utökade reguljära uttryck för POSIX i dina filtermönster.

Felsöka filter troubleshooting-filters

Om dina filter inte aktiveras på det sätt du förväntar dig ska du aktivera Spårningsloggning på Dispatcher så att du kan se vilket filter som fångar upp begäran.

Exempelfilter: Neka alla example-filter-deny-all

Följande exempelfilteravsnitt gör att Dispatcher nekar begäranden för alla filer. Neka åtkomst till alla filer och tillåt sedan åtkomst till specifika områden.

/0001  { /type "deny" /url "*"  }

Begäranden till ett explicit nekat område resulterar i att 404-felkoden (sidan hittades inte) returneras.

Exempelfilter: Neka åtkomst till specifika områden example-filter-deny-access-to-specific-areas

Med filter kan du också neka åtkomst till olika element, till exempel ASP-sidor och känsliga områden i en publiceringsinstans. Följande filter nekar åtkomst till ASP-sidor:

/0002  { /type "deny" /url "*.asp"  }

Exempelfilter: Aktivera begäranden om POST example-filter-enable-post-requests

Följande exempelfilter tillåter att formulärdata skickas med metoden POST:

/filter {
    /0001  { /glob "*" /type "deny" }
    /0002 { /type "allow" /method "POST" /url "/content/[.]*.form.html" }
}

Exempelfilter: Tillåt åtkomst till arbetsflödeskonsolen example-filter-allow-access-to-the-workflow-console

I följande exempel visas ett filter som används för att ge extern åtkomst till arbetsflödeskonsolen:

/filter {
    /0001  { /glob "*" /type "deny" }
    /0002  {  /type "allow"  /url "/libs/cq/workflow/content/console*"  }
}

Om publiceringsinstansen använder en webbprogramkontext (till exempel publicera) kan den också läggas till i filterdefinitionen.

/0003   { /type "deny"  /url "/publish/libs/cq/workflow/content/console/archive*"  }

Om du måste komma åt enstaka sidor inom det begränsade området kan du tillåta åtkomst till dem. Om du till exempel vill tillåta åtkomst till fliken Arkiv i arbetsflödeskonsolen lägger du till följande avsnitt:

/0004  { /type "allow"  /url "/libs/cq/workflow/content/console/archive*"   }

Exempelfilter: Använda reguljära uttryck example-filter-using-regular-expressions

Det här filtret aktiverar tillägg i icke-offentliga innehållskataloger med hjälp av ett reguljärt uttryck, som definieras här mellan enkla citattecken:

/005  {  /type "allow" /extension '(css|gif|ico|js|png|swf|jpe?g)' }

Exempelfilter: Filtrera extra element för en URL för en begäran example-filter-filter-additional-elements-of-a-request-url

Nedan visas ett regelexempel som blockerar innehåll som hämtas från /content sökväg och dess underträd, med filter för sökväg, väljare och tillägg:

/006 {
        /type "deny"
        /path "/content/*"
        /selectors '(feed|rss|pages|languages|blueprint|infinity|tidy|sysview|docview|query|jcr:content|_jcr_content|search|childrenlist|ext|assets|assetsearch|[0-9-]+)'
        /extension '(json|xml|html|feed))'
        }

Exempel/filteravsnitt example-filter-section

När du konfigurerar Dispatcher bör du begränsa den externa åtkomsten så mycket som möjligt. Följande exempel ger minimal åtkomst för externa besökare:

När du har skapat filter testsidåtkomst för att säkerställa att din AEM är säker.

Följande /filter i dispatcher.any -filen kan användas som bas i Dispatcher-konfigurationsfil.

Det här exemplet baseras på den standardkonfigurationsfil som medföljer Dispatcher och är avsedd som exempel för användning i en produktionsmiljö. Objekt med prefix # inaktiveras (kommenteras ut). Du bör vara försiktig om du bestämmer dig för att aktivera någon av dessa saker (genom att ta bort # på den raden). Om du gör det kan det påverka säkerheten.

Neka åtkomst till allt och tillåt sedan åtkomst till specifika (begränsade) element:

  /filter
      {
      # Deny everything first and then allow specific entries
      /0001  { /type "deny" /url "*"  }

      # Open consoles
#     /0011 { /type "allow" /url "/admin/*"  }  # allow servlet engine admin
#     /0012 { /type "allow" /url "/crx/*"    }  # allow content repository
#     /0013 { /type "allow" /url "/system/*" }  # allow OSGi console

      # Allow non-public content directories
#     /0021 { /type "allow" /url "/apps/*"   }  # allow apps access
#     /0022 { /type "allow" /url "/bin/*"    }
      /0023 { /type "allow" /url "/content*" }  # disable this rule to allow mapped content only

#     /0024 { /type "allow" /url "/libs/*"   }
#     /0025 { /type "deny"  /url "/libs/shindig/proxy*" } # if you enable /libs close access to proxy

#     /0026 { /type "allow" /url "/home/*"   }
#     /0027 { /type "allow" /url "/tmp/*"    }
#     /0028 { /type "allow" /url "/var/*"    }

      # Enable extensions in non-public content directories, using a regular expression
      /0041
        {
        /type "allow"
        /extension '(css|gif|ico|js|png|swf|jpe?g)'
        }

      # Enable features
      /0062 { /type "allow" /url "/libs/cq/personalization/*"  }  # enable personalization

      # Deny content grabbing, on all accessible pages, using regular expressions
      /0081
        {
        /type "deny"
        /selectors '((sys|doc)view|query|[0-9-]+)'
        /extension '(json|xml)'
        }
      # Deny content grabbing for /content and its subtree
      /0082
        {
        /type "deny"
        /path "/content/*"
        /selectors '(feed|rss|pages|languages|blueprint|infinity|tidy)'
        /extension '(json|xml|html)'
        }

#     /0087 { /type "allow" /method "GET" /extension 'json' "*.1.json" }  # allow one-level json requests
}

Tänk på följande om du väljer att utöka åtkomsten:

Beroende på installationen kan det finnas fler resurser under /libs, /apps eller någon annanstans, som måste göras tillgänglig. Du kan använda access.log som en metod för att avgöra resurser som används externt.

Begränsa frågesträngar restricting-query-strings

Sedan Dispatcher version 4.1.5 använder du /filter för att begränsa frågesträngar. Vi rekommenderar att du uttryckligen tillåter frågesträngar och exkluderar generiska reserveringar via allow filterelement.

En enskild post kan ha antingen glob eller en kombination av method, url, queryoch version, men inte båda. I följande exempel tillåts a=* frågesträng och nekar alla andra frågesträngar för URL:er som tolkas som /etc nod:

/filter {
 /0001 { /type "deny" /method "POST" /url "/etc/*" }
 /0002 { /type "allow" /method "GET" /url "/etc/*" /query "a=*" }
}

/filter {
>/0001 { /type "deny" /method "*" /url "/path/*" }
>/0002 { /type "allow" /method "GET" /url "/path/*" }
>/0003 { /type "deny" /method "GET" /url "/path/*" /query "*" }
>/0004 { /type "allow" /method "GET" /url "/path/*" /query "a=*" }
}

Testar Dispatcher Security testing-dispatcher-security

Dispatcher-filter ska blockera åtkomst till följande sidor och skript AEM publiceringsinstanser. Använd en webbläsare för att försöka öppna följande sidor som en besökare skulle göra och verifiera att koden 404 returneras. Justera filtren om du får andra resultat.

Du bör se normal sidåtergivning för /content/add_valid_page.html?debug=layout.

Om du vill avgöra om anonym skrivåtkomst är aktiverat skickar du följande kommando i en terminal eller kommandotolk. Du bör inte kunna skriva data till noden.

curl -X POST "https://anonymous:anonymous@hostname:port/content/usergenerated/mytestnode"

Om du vill göra Dispatcher-cachen ogiltig och försäkra dig om att du får ett code 403-svar skickar du följande kommando i en terminal eller kommandotolk:

curl -H "CQ-Handle: /content" -H "CQ-Path: /content" https://yourhostname/dispatcher/invalidate.cache

Aktivera åtkomst till Vanity-URL:er enabling-access-to-vanity-urls-vanity-urls

Konfigurera Dispatcher om du vill aktivera åtkomst till URL:er för AEM som är konfigurerade för dina sidor.

När åtkomst till tillfälliga URL:er är aktiverat anropar Dispatcher regelbundet en tjänst som körs på återgivningsinstansen för att få en lista över tillfälliga URL:er. Dispatcher lagrar den här listan i en lokal fil. När en begäran om en sida nekas på grund av ett filter i /filter -avsnittet söker Dispatcher igenom listan över användar-URL:er. Om den nekade URL:en finns med i listan tillåter Dispatcher åtkomst till den nekade URL:en.

Om du vill aktivera åtkomst till tillfälliga URL:er lägger du till en /vanity_urls till /farms -avsnittet, som i följande exempel:

 /vanity_urls {
      /url "/libs/granite/dispatcher/content/vanityUrls.html"
      /file "/tmp/vanity_urls"
      /delay 300
 }

The /vanity_urls -avsnittet innehåller följande egenskaper:

Använd följande procedur för att aktivera åtkomst till mål-URL:er.

Vidarebefordrar syndikeringsbegäranden - /spridateSyndPost forwarding-syndication-requests-propagatesyndpost

Syndikeringsbegäranden är endast avsedda för Dispatcher, så som standard skickas de inte till återgivaren (till exempel en AEM).

Om det behövs anger du /propagateSyndPost egenskap till "1" för att vidarebefordra syndikeringsbegäranden till Dispatcher. Om den är inställd måste du se till att begäranden om POST inte nekas i filteravsnittet.

Konfigurera Dispatcher-cachen - /cache configuring-the-dispatcher-cache-cache

The /cache styr hur Dispatcher cachelagrar dokument. Konfigurera flera underegenskaper för att implementera dina cachningsstrategier:

Ett exempel på cacheavsnitt kan se ut så här:

/cache
  {
  /docroot "/opt/dispatcher/cache"
  /statfile  "/tmp/dispatcher-website.stat"
  /allowAuthorized "0"

  /rules
    {
    # List of files that are cached
    }

  /invalidate
    {
    # List of files that are auto-invalidated
    }
  }

Ange cachekatalogen specifying-the-cache-directory

The /docroot identifierar katalogen där cachelagrade filer lagras.

Om du använder flera grupper måste varje grupp ha en annan dokumentrot.

Namnge statusfilen naming-the-statfile

The /statfile egenskapen identifierar filen som ska användas som statfile. Dispatcher använder den här filen för att registrera tidpunkten för den senaste innehållsuppdateringen. Statfile kan vara vilken fil som helst på webbservern.

Statusfilen har inget innehåll. När innehållet uppdateras uppdaterar Dispatcher tidsstämpeln. Standardstatusfilen heter .stat och lagras i dokumentet. Dispatcher blockerar åtkomsten till statusfilen.

Hantera gamla dokument när fel uppstår serving-stale-documents-when-errors-occur

The /serveStaleOnError anger om Dispatcher returnerar ogiltiga dokument när återgivningsservern returnerar ett fel. Som standard tas det cachelagrade innehållet bort nästa gång som det begärs när en lägesfil ändras och det cachelagrade innehållet blir ogiltigt.

If /serveStaleOnError är inställd på "1", tar inte Dispatcher bort ogiltigt innehåll från cacheminnet om inte återgivningsservern returnerar ett godkänt svar. Ett 5xx-svar från AEM eller en timeout för anslutningen gör att Dispatcher skickar det inaktuella innehållet och svarar med och HTTP-statusen 111 (förnyelsen misslyckades).

Cachelagring när autentisering används caching-when-authentication-is-used

The /allowAuthorized egenskapen styr om begäranden som innehåller någon av följande autentiseringsinformation cachelagras:

Som standard cachelagras inte begäranden som innehåller den här autentiseringsinformationen eftersom autentiseringen inte utförs när ett cachelagrat dokument returneras till klienten. Den här konfigurationen förhindrar att Dispatcher skickar cachelagrade dokument till användare som inte har nödvändiga rättigheter.

Om dina krav tillåter cachelagring av autentiserade dokument, anger du /allowAuthorized till en:

/allowAuthorized "1"

Ange vilka dokument som ska cachelagras specifying-the-documents-to-cache

The /rules anger vilka dokument som cachelagras enligt dokumentets sökväg. Oavsett /rules egenskapen, Dispatcher cachelagrar aldrig ett dokument under följande omständigheter:

Varje objekt i /rules egenskapen innehåller glob mönster och en typ:

Om du inte har dynamiska sidor (utöver de sidor som redan har undantagits av ovanstående regler) kan du konfigurera Dispatcher så att allt cachelagras. Regelavsnittet ser ut så här:

/rules
  {
    /0000  {  /glob "*"   /type "allow" }
  }

Mer information om globegenskaper finns i Designa mönster för globegenskaper.

Om det finns dynamiska avsnitt på sidan (till exempel ett nyhetsprogram) eller i en sluten användargrupp kan du definiera undantag:

/rules
  {
   /0000  { /glob "*" /type "allow" }
   /0001  { /glob "/en/news/*" /type "deny" }
   /0002  { /glob "*/private/*" /type "deny"  }
  }

Komprimering

På Apache-webbservrar kan du komprimera de cachelagrade dokumenten. Komprimering gör att Apache kan returnera dokumentet i ett komprimerat format om klienten begär det. Komprimering utförs automatiskt genom att Apache-modulen aktiveras mod_deflate, till exempel:

AddOutputFilterByType DEFLATE text/plain

Modulen installeras som standard med Apache 2.x.

Ogiltiga filer per mappnivå invalidating-files-by-folder-level

Använd /statfileslevel egenskap som gör cachelagrade filer ogiltiga enligt deras sökväg:

Endast resurser längs banan till den ogiltiga filen påverkas. Titta på följande exempel: en webbplats använder strukturen /content/myWebsite/xx/. Om du anger statfileslevel as 3, a .statfilen skapas enligt följande:

När en fil /content/myWebsite/xx blir ogiltigt, sedan var .stat från dokumentroten ned till /content/myWebsite/xxär rörd. Detta scenario gäller endast för /content/myWebsite/xx och inte till exempel /content/myWebsite/yy eller /content/anotherWebSite.

Automatisk invalidering av cachelagrade filer automatically-invalidating-cached-files

The /invalidate -egenskapen definierar de dokument som automatiskt görs ogiltiga när innehållet uppdateras.

Med automatisk ogiltigförklaring tar inte Dispatcher bort cachelagrade filer efter en innehållsuppdatering, men kontrollerar deras giltighet nästa gång de begärs. Dokument i cacheminnet som inte ogiltigförklaras automatiskt finns kvar i cacheminnet tills en innehållsuppdatering tar bort dem explicit.

Automatisk ogiltigförklaring används vanligtvis för HTML-sidor. HTML sidor innehåller ofta länkar till andra sidor, vilket gör det svårt att avgöra om en innehållsuppdatering påverkar en sida. Om du vill vara säker på att alla relevanta sidor blir ogiltiga när innehållet uppdateras, gör du alla sidor i HTML automatiskt ogiltiga. Följande konfiguration gör alla HTML sidor ogiltiga:

  /invalidate
  {
   /0000  { /glob "*" /type "deny" }
   /0001  { /glob "*.html" /type "allow" }
  }

Mer information om globegenskaper finns i Designa mönster för globegenskaper.

Den här konfigurationen orsakar följande aktivitet när /content/wknd/us/en är aktiverad:

Om du erbjuder automatiskt genererade PDF- och ZIP-filer för nedladdning kan du behöva göra dessa filer ogiltiga automatiskt. Ett konfigurationsexempel ser ut så här:

/invalidate
  {
   /0000 { /glob "*" /type "deny" }
   /0001 { /glob "*.html" /type "allow" }
   /0002 { /glob "*.zip" /type "allow" }
   /0003 { /glob "*.pdf" /type "allow" }
  }

AEM integrering med Adobe Analytics ger konfigurationsdata i en analytics.sitecatalyst.js på din webbplats. Exemplet dispatcher.any filen som medföljer Dispatcher innehåller följande ogiltighetsregel för den här filen:

{
   /glob "*/analytics.sitecatalyst.js"  /type "allow"
}

Använda anpassade ogiltighetsskript using-custom-invalidation-scripts

The /invalidateHandler Med -egenskapen kan du definiera ett skript som anropas för varje invalideringsbegäran som tas emot av Dispatcher.

Den anropas med följande argument:

Den här metoden kan användas för att täcka flera olika användningsfall. Om du till exempel gör andra programspecifika cacheminnen ogiltiga eller hanterar fall där den externa URL-adressen för en sida och dess plats i dokumentroten inte matchar innehållssökvägen.

Nedanstående exempel på skript loggar varje ogiltig begäran till en fil.

/invalidateHandler "/opt/dispatcher/scripts/invalidate.sh"

Exempel på ogiltighetshanterarskript sample-invalidation-handler-script

#!/bin/bash

printf "%-15s: %s %s" $1 $2 $3>> /opt/dispatcher/logs/invalidate.log

Begränsa de klienter som kan tömma cachen limiting-the-clients-that-can-flush-the-cache

The /allowedClients -egenskapen definierar specifika klienter som tillåts tömma cachen. Globeringsmönstren matchas mot IP.

Följande exempel:

/allowedClients
  {
   /0001 { /glob "*.*.*.*"  /type "deny" }
   /0002 { /glob "127.0.0.1" /type "allow" }
  }

Mer information om globegenskaper finns i Designa mönster för globegenskaper.

Ignorerar URL-parametrar ignoring-url-parameters

The ignoreUrlParams -avsnittet anger vilka URL-parametrar som ska ignoreras när du avgör om en sida cachelagras eller levereras från cachen:

När en parameter ignoreras för en sida cachelagras sidan första gången som sidan begärs. Efterföljande begäranden för sidan skickas till den cachelagrade sidan, oavsett värdet på parametern i begäran.

Om du vill ange vilka parametrar som ska ignoreras lägger du till regler i ignoreUrlParams egenskap:

I följande exempel ignoreras alla parametrar utom nocache parameter. Begär därför URL:er som innehåller nocache -parametern cachelagras aldrig av Dispatcher:

/ignoreUrlParams
{
    # ignore-all-url-parameters-by-dispatcher-and-requests-are-cached
    /0001 { /glob "*" /type "allow" }
    # allow-the-url-parameter-nocache-to-bypass-dispatcher-on-every-request
    /0002 { /glob "nocache" /type "deny" }
}

Med tanke på ignoreUrlParams i konfigurationsexemplet ovan gör följande HTTP-begäran att sidan cachelagras eftersom willbecached parametern ignoreras:

GET /mypage.html?willbecached=true

Med tanke på ignoreUrlParams konfigurationsexempel: följande HTTP-begäran gör att sidan not cachelagras eftersom nocache parametern ignoreras inte:

GET /mypage.html?nocache=true
GET /mypage.html?nocache=true&willbecached=true

Mer information om globegenskaper finns i Designa mönster för globegenskaper.

Cachelagra HTTP-svarshuvuden caching-http-response-headers

The /headers Med -egenskapen kan du definiera de HTTP-huvudtyper som ska cachas av Dispatcher. Vid den första begäran till en icke cachelagrad resurs lagras alla huvuden som matchar ett av de konfigurerade värdena (se konfigurationsexemplet nedan) i en separat fil bredvid cachefilen. Vid efterföljande begäranden till den cachelagrade resursen läggs de lagrade rubrikerna till i svaret.

Nedan visas ett exempel från standardkonfigurationen:

/cache {
  ...
  /headers {
    "Cache-Control"
    "Content-Disposition"
    "Content-Type"
    "Expires"
    "Last-Modified"
    "X-Content-Type-Options"
    "Last-Modified"
  }
}

FileETag none

Cachefilbehörigheter för utskickare dispatcher-cache-file-permissions

The mode anger vilken filbehörighet som ska tillämpas på nya kataloger och filer i cachen. Den här inställningen begränsas av umask för anropsprocessen. Det är ett oktalt tal som konstruerats av summan av ett eller flera av följande värden:

Standardvärdet är 0755 som gör det möjligt för ägaren att läsa, skriva eller söka och för gruppen och andra att läsa eller söka.

Begränsar .stat-filberöring throttling-stat-file-touching

Med standardinställningen /invalidate egenskapen, all aktivering gör alla .html filer (när deras sökväg matchar /invalidate ). På en webbplats med stor trafik ökar multipla aktiveringar processorbelastningen på backend-sidan. I sådana fall är det önskvärt att strypa .stat filhantering för att hålla webbplatsen responsiv. Du kan utföra den här åtgärden med /gracePeriod -egenskap.

The /gracePeriod anger hur många sekunder en inaktuell, automatiskt ogiltigförklarad resurs fortfarande kan betjänas från cachen efter den senaste aktiveringen. Egenskapen kan användas i en inställning där en grupp av aktiveringar annars skulle göra hela cachen ogiltig upprepade gånger. Det rekommenderade värdet är 2 sekunder.

Mer information finns i /invalidate och /statfilesleveltidigare.

Konfigurerar tidsbaserad cacheinvalidering - /enableTTL configuring-time-based-cache-invalidation-enablettl

Tidsbaserad cacheogiltigförklaring beror på /enableTTL och det finns regelbundna förfallorubriker från HTTP-standarden. Om du ställer in egenskapen på 1 (/enableTTL "1") utvärderas svarshuvuden från serverdelen. Om sidhuvudena innehåller en Cache-Control, max-age eller Expires datum skapas en extra, tom fil bredvid den cachelagrade filen med samma ändringsdatum som förfallodatumet. När den cachelagrade filen har begärts efter ändringstiden återbegärs den automatiskt från serverdelen.

Före Dispatcher 4.3.5 baserades logiken för TTL-ogiltigförklaring endast på det konfigurerade TTL-värdet. Med Dispatcher 4.3.5, båda de angivna TTL-värdena och Invalideringsreglerna för Dispatcher-cachen räknas med. För en cachelagrad fil:

Den nya implementeringen stöder användning där filerna har en längre TTL-värde (till exempel på CDN) men kan fortfarande ogiltigförklaras även om TTL-värdet inte har gått ut. Det prioriterar innehållets aktualitet framför cache-träffkvoten för Dispatcher.

Omvänt, om du behöver endast förfallologiken som tillämpas på en fil och ange sedan /enableTTL till 1 och exkludera den filen från standardcacheminnets invalideringsmekanism. Du kan till exempel:

  /invalidate
  {
   /0000  { /glob "*" /type "deny" }
   /0001  { /glob "*.html" /type "allow" }
   /0002  { /glob "*.example.html" /type "deny" }
  }

På så sätt säkerställer du att .stat filogiltigförklaring används inte och endast TTL-förfallodatum är aktivt för de angivna filerna.

Konfigurerar belastningsutjämning - /statistik configuring-load-balancing-statistics

The /statistics -avsnittet definierar de filkategorier för vilka Dispatcher bedömer svarstiden för varje återgivning. Dispatcher använder poängen för att avgöra vilken rendering som ska skickas.

Varje kategori som du skapar definierar ett globmönster. Dispatcher jämför URI:n för det begärda innehållet med dessa mönster för att fastställa kategorin för det begärda innehållet:

Dispatcher stöder högst åtta statistikkategorier. Om du definierar fler än åtta kategorier används bara de första 8.

Återge markering

Varje gång Dispatcher kräver en återgiven sida används följande algoritm för att välja återgivningen:

Poängen för en återgivnings kategori baseras på tidigare svarstider och tidigare misslyckade och lyckade anslutningar som Dispatcher försöker utföra. För varje försök uppdateras poängen för kategorin för den begärda URI:n.

Definiera statistikkategorier defining-statistics-categories

Definiera en kategori för varje dokumenttyp som du vill behålla statistik för för återgivningsmarkering. The /statistics -avsnittet innehåller en /categories -avsnitt. Om du vill definiera en kategori lägger du till en rad under /categories som har följande format:

/name { /glob "pattern"}

Kategorin name måste vara unik för servergruppen. The pattern beskrivs i Designa mönster för globegenskaper -avsnitt.

För att fastställa kategorin för en URI jämför Dispatcher URI:n med varje kategorimönster tills en matchning hittas. Dispatcher börjar med den första kategorin i listan och fortsätter i rätt ordning. Därför bör du placera kategorier med mer specifika mönster först.

Till exempel Dispatcher som standard dispatcher.any -filen definierar en HTML-kategori och en annan kategori. Kategorin HTML är mer specifik och visas därför först:

/statistics
  {
  /categories
    {
      /html { /glob "*.html" }
      /others  { /glob "*" }
    }
  }

I följande exempel finns även en kategori för söksidor:

/statistics
  {
  /categories
    {
      /search { /glob "*search.html" }
      /html { /glob "*.html" }
      /others  { /glob "*" }
    }
  }

Speglar serverns otillgänglighet i Dispatcher-statistik reflecting-server-unavailability-in-dispatcher-statistics

The /unavailablePenalty anger den tid (i tiondelar av en sekund) som används för återgivningsstatistiken när en anslutning till återgivningen misslyckas. Dispatcher lägger till tiden i statistikkategorin som matchar den begärda URI:n.

Straffet tillämpas till exempel när TCP/IP-anslutningen till det angivna värdnamnet/porten inte kan upprättas, antingen på grund av att AEM inte körs (och inte lyssnar) eller på grund av ett nätverksrelaterat problem.

The /unavailablePenalty egenskapen är direkt underordnad /farm -sektion (en jämställd /statistics ).

Om nej /unavailablePenalty egenskapen finns, värdet är "1" används.

/unavailablePenalty "1"

Identifiera en mapp för Sticky Connection - /stickyConnectionsFor identifying-a-sticky-connection-folder-stickyconnectionsfor

The /stickyConnectionsFor -egenskapen definierar en mapp som innehåller klisterlappande dokument. Den här egenskapen används med URL:en. Dispatcher skickar alla begäranden från en enskild användare som finns i den här mappen till samma återgivningsinstans. Anteckningar säkerställer att sessionsdata finns och är konsekventa för alla dokument. Den här funktionen använder renderid cookie.

I följande exempel definieras en fast anslutning till mappen /products:

/stickyConnectionsFor "/products"

När en sida består av innehåll från flera innehållsnoder inkluderar du /paths egenskap som listar sökvägarna till innehållet. En sida innehåller till exempel innehåll från /content/image, /content/videooch /var/files/pdfs. Med följande konfiguration aktiveras häftiga anslutningar för allt innehåll på sidan:

/stickyConnections {
  /paths {
    "/content/image"
    "/content/video"
    "/var/files/pdfs"
  }
}

httpOnly httponly

När klisterlappande anslutningar är aktiverade ställer modulen Dispatcher in renderid cookie. Den här cookien har inte httponly som bör läggas till för att öka säkerheten. Du lägger till httponly flagga genom att ange httpOnly -egenskapen i /stickyConnections nod i en dispatcher.any konfigurationsfil. Egenskapens värde (antingen 0 eller 1) definierar om renderid cookie har HttpOnly attribut tillagt. Standardvärdet är 0, vilket innebär att attributet inte läggs till.

Mer information om httponly flagga, läsa den här sidan.

secure secure

När klisterlappande anslutningar är aktiverade ställer modulen Dispatcher in renderid cookie. Den här cookien har inte secure som bör läggas till för att öka säkerheten. Du lägger till secure flagga som anger secure -egenskapen i /stickyConnections nod i en dispatcher.any konfigurationsfil. Egenskapens värde (antingen 0 eller 1) definierar om renderid cookie har secure attribut tillagt. Standardvärdet är 0, vilket innebär att attributet läggs till if den inkommande begäran är säker. Om värdet är 1, läggs flaggan secure till oavsett om den inkommande begäran är säker eller inte.

Hantera återgivningsanslutningsfel handling-render-connection-errors

Konfigurera Dispatcher-beteendet när återgivningsservern returnerar ett 500-fel eller inte är tillgänglig.

Ange en hälsokontrollsida specifying-a-health-check-page

Använd /health_check för att ange en URL som kontrolleras när en 500-statuskod inträffar. Om den här sidan även returnerar en 500-statuskod anses instansen vara otillgänglig och en konfigurerbar tidsåtgång ( /unavailablePenalty) används på återgivningen innan du försöker igen.

/health_check
  {
  # Page gets contacted when an instance returns a 500
  /url "/health_check.html"
  }

Ange fördröjning för sidåterförsök specifying-the-page-retry-delay

The /retryDelay anger tiden (i sekunder) som Dispatcher väntar mellan anslutningsförsök med servergruppsåtergivningar. För varje rund är det maximala antalet gånger Dispatcher försöker ansluta till en rendering antalet renderingar i servergruppen.

Dispatcher använder värdet "1" if /retryDelay är inte explicit definierad. Standardvärdet är lämpligt.

/retryDelay "1"

Konfigurera antalet återförsök configuring-the-number-of-retries

The /numberOfRetries egenskapen anger det maximala antalet anslutningsförsök som Dispatcher utför med återgivningarna. Om Dispatcher inte kan ansluta till en återgivning efter detta antal försök returnerar Dispatcher ett misslyckat svar.

För varje rund är det maximala antalet gånger Dispatcher försöker ansluta till en rendering antalet renderingar i servergruppen. Därför är det maximala antalet gånger Dispatcher försöker ansluta ( /numberOfRetries) x (antalet återgivningar).

Om värdet inte definieras explicit är standardvärdet 5.

/numberOfRetries "5"

Använda mekanismen för växling vid fel using-the-failover-mechanism

Om du vill skicka om begäranden till olika återgivningar när den ursprungliga begäran misslyckas, aktiverar du failover-funktionen i Dispatcher-gruppen. När failover är aktiverat har Dispatcher följande beteende:

Om du vill aktivera redundans lägger du till följande rad i servergruppen (eller webbplatsen):

/failover "1"

Ignorerar avbrottsfel - /ignoreEINTR ignoring-interruption-errors-ignoreeintr

Alla filsystemorienterade systemanrop kan avbrytas EINTR om objektet för systemanropet finns på ett fjärrsystem som nås via NFS. Huruvida dessa systemanrop kan ta slut eller avbrytas baseras på hur det underliggande filsystemet monterades på den lokala datorn.

Använd /ignoreEINTR om instansen har en sådan konfiguration och loggen innehåller följande meddelande:

Error while reading response: Interrupted system call

Internt läser Dispatcher svaret från fjärrservern (d.v.s. AEM) med en slinga som kan representeras som:

while (response not finished) {
read more data
}

Sådana meddelanden kan genereras när EINTR inträffar i read more dataoch orsakas av att en signal tas emot innan data tas emot.

Om du vill ignorera sådana avbrott kan du lägga till följande parameter i dispatcher.any (före /farms):

/ignoreEINTR "1"

Inställning /ignoreEINTR till "1" gör att Dispatcher fortsätter att försöka läsa data tills det fullständiga svaret har lästs. Standardvärdet är 0 och inaktiverar alternativet.

Designa mönster för globegenskaper designing-patterns-for-glob-properties

Flera avsnitt i Dispatcher-konfigurationsfilen kan använda glob egenskaper som urvalskriterier för klientförfrågningar. Värdena för glob egenskaper är mönster som Dispatcher jämför med en aspekt av begäran, till exempel sökvägen till den begärda resursen eller klientens IP-adress. Objekten i /filter avsnittsanvändning glob mönster för att identifiera sökvägarna för de sidor som Dispatcher agerar på eller avvisar.

The glob -värden kan innehålla jokertecken och alfanumeriska tecken för att definiera mönstret.

Loggning logging

I webbserverkonfigurationen kan du ange:

Mer information finns i webbserverns dokumentation och i filen Viktigt för Dispatcher-instansen.

Apache-roterade/Pipe-loggar

Om du använder Apache webbserver kan du använda standardfunktionerna för roterade loggar, pipade loggar eller båda. Använd till exempel pipade loggar:

DispatcherLog "| /usr/apache/bin/rotatelogs logs/dispatcher.log%Y%m%d 604800"

Den här funktionen roterar automatiskt:

Se dokumentationen för Apache-webbservern om Loggrotation och Pipe-loggar. Till exempel: Apache 2.4.

Spårningsloggning trace-logging

Bland andra förbättringar för Dispatcher finns även version 4.2.0 för Trace Logging.

Den här möjligheten är högre än felsökningsloggning som visar ytterligare information i loggarna. Loggning läggs till för:

Du kan aktivera spårningsloggning genom att ange loggnivån till 4 på webbservern.

Nedan visas ett exempel på loggar med spårning aktiverat:

[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Host] = "localhost:8443"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[User-Agent] = "curl/7.43.0"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Accept] = "*/*"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL-Client-Cert] = "(null)"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Via] = "1.1 localhost:8443 (dispatcher)"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-For] = "::1"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL] = "on"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL-Cipher] = "DHE-RSA-AES256-SHA"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL-Session-ID] = "ba931f5e4925c2dde572d766fdd436375e15a0fd24577b91f4a4d51232a934ae"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-Port] = "8443"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Server-Agent] = "Communique-Dispatcher"

Och en händelse loggas när en fil som matchar en blockeringsregel begärs:

[Thu Mar 03 14:42:45 2016] [T] [11831] 'GET /content.infinity.json HTTP/1.1' was blocked because of /0082

Bekräfta grundläggande åtgärd confirming-basic-operation

Om du vill bekräfta grundläggande åtgärder och interaktion för webbservern, Dispatcher och AEM kan du utföra följande steg:

Använda flera utskickare using-multiple-dispatchers

I komplexa inställningar kan du använda flera Dispatcher. Du kan till exempel använda:

I så fall måste du se till att varje begäran endast går igenom en Dispatcher. En Dispatcher hanterar inte begäranden som kommer från en annan Dispatcher. Kontrollera därför att båda utskickarna har direktåtkomst till den AEM webbplatsen.

Felsökning debugging

När du lägger till sidhuvudet X-Dispatcher-Info Vid en begäran besvarar Dispatcher om målet har cache-lagrats, returnerats från cache-lagrats eller inte kunnat cachelagras alls. Svarshuvudet X-Cache-Info innehåller informationen i läsbar form. Du kan använda de här svarshuvuden för att felsöka problem med svar som cachas av Dispatcher.

Den här funktionen är inte aktiverad som standard, så för svarshuvudet X-Cache-Info För att ingå måste jordbruksföretaget innehålla följande uppgifter:

/info "1"

Exempel:

/farm
{
    /mywebsite
    {
        # Include X-Cache-Info response header if X-Dispatcher-Info is in request header
        /info "1"
    }
}

Dessutom finns X-Dispatcher-Info sidhuvudet behöver inget värde, men om du använder curl För testning måste du ange ett värde som ska skickas till sidhuvudet, till exempel:

curl -v -H "X-Dispatcher-Info: true" https://localhost/content/wknd/us/en.html

Nedan finns en lista med de svarshuvuden som X-Dispatcher-Info returnerar: