Content Switching Policy Label: was sich gegenüber der direkten Bindung ändert
Ein CS-vServer (Content Switching) nimmt die Anfrage des Clients an und entscheidet über Policies, welcher LB-vServer sie bekommt. Das Ziel kann direkt an der Bindung stehen, in einer CS-Action oder eine Ebene tiefer in einem Content Switching Policy Label. Die ersten beiden Wege arbeiten in einer Ebene, das Label baut eine zweite. An meiner Testinstanz mit NetScaler 14.1 habe ich beide Bauweisen mit denselben Zielen nebeneinander aufgebaut und mit echten Anfragen verglichen. Das Ergebnis ist bis auf einen Fall gleich, und dieser Fall bestimmt, wie man ein Label baut.
Die Bausteine
| Begriff | Aufgabe |
|---|---|
| CS-vServer | die Adresse, die der Client anspricht; wertet die Anfrage aus und wählt ein Ziel |
| LB-vServer | verteilt die Anfragen auf die Server; hinter einem CS-vServer meist ohne eigene IP (0.0.0.0, Port 0), damit er nur über den CS-vServer erreichbar ist |
| CS-Policy | eine Bedingung, zum Beispiel Hostname oder Pfad |
| CS-Action | optional: das Ziel als eigenes Objekt |
| Policy Label | eine benannte Liste von CS-Policies mit eigener Reihenfolge, die von einer Policy am CS-vServer aufgerufen wird |
| Priorität | Reihenfolge der Prüfung, die kleinere Zahl zuerst; die erste passende Policy bestimmt das Ziel |
| Standardziel | der LB-vServer für alle Anfragen, auf die keine Policy passt |
Das Beispiel
Ein Hostname app.example.test mit zwei Bereichen: Alles unter /a geht an lb_app_a, alles unter /b an lb_app_b, der Rest dieses Hosts an lb_app_rest. Jeder andere Hostname landet beim Standardziel lb_default. Die vier LB-vServer sind in beiden Bauweisen dieselben und haben keine eigene IP:
add lb vserver lb_app_a HTTP 0.0.0.0 0
add lb vserver lb_app_b HTTP 0.0.0.0 0
add lb vserver lb_app_rest HTTP 0.0.0.0 0
add lb vserver lb_default HTTP 0.0.0.0 0
Ohne Label: alle Regeln in einer Ebene
Jede Policy trägt alle Bedingungen selbst, also auch den Hostnamen:
add cs vserver cs_flach HTTP 198.51.100.10 80
add cs policy pol_app_a -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\") && HTTP.REQ.URL.PATH.STARTSWITH(\"/a\")"
add cs policy pol_app_b -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\") && HTTP.REQ.URL.PATH.STARTSWITH(\"/b\")"
add cs policy pol_app_rest -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
bind cs vserver cs_flach -policyName pol_app_a -targetLBVserver lb_app_a -priority 100
bind cs vserver cs_flach -policyName pol_app_b -targetLBVserver lb_app_b -priority 200
bind cs vserver cs_flach -policyName pol_app_rest -targetLBVserver lb_app_rest -priority 300
bind cs vserver cs_flach -lbvserver lb_default
cs_flach
├─ 100 Host app.example.test und Pfad /a -> lb_app_a
├─ 200 Host app.example.test und Pfad /b -> lb_app_b
├─ 300 Host app.example.test -> lb_app_rest
└─ Standardziel -> lb_default
Mit Label: der Host am CS-vServer, die Pfade im Label
Die Policy am CS-vServer prüft nur noch den Hostnamen und hat kein Ziel. Sie ruft mit -invoke das Label auf, und erst dort stehen die Pfadregeln mit ihren Zielen. Die Rest-Regel ist so übernommen, wie man sie aus der flachen Fassung übertragen würde, als zweite Policy am CS-vServer:
add cs policylabel lbl_app HTTP
add cs policy pol_pfad_a -rule "HTTP.REQ.URL.PATH.STARTSWITH(\"/a\")"
add cs policy pol_pfad_b -rule "HTTP.REQ.URL.PATH.STARTSWITH(\"/b\")"
bind cs policylabel lbl_app pol_pfad_a 100 -targetVserver lb_app_a
bind cs policylabel lbl_app pol_pfad_b 200 -targetVserver lb_app_b
add cs vserver cs_label HTTP 198.51.100.11 80
add cs policy pol_host_app -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
add cs policy pol_host_rest -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
bind cs vserver cs_label -policyName pol_host_app -priority 100 -invoke policylabel lbl_app
bind cs vserver cs_label -policyName pol_host_rest -targetLBVserver lb_app_rest -priority 200
bind cs vserver cs_label -lbvserver lb_default
cs_label
├─ 100 Host app.example.test -> Label lbl_app
│ ├─ 100 Pfad /a -> lb_app_a
│ └─ 200 Pfad /b -> lb_app_b
├─ 200 Host app.example.test -> lb_app_rest
└─ Standardziel -> lb_default
Zwei Kleinigkeiten fallen beim Abtippen auf: Im Label heißt der Zielparameter -targetVserver, am CS-vServer -targetLBVserver. Und pol_host_app und pol_host_rest haben dieselbe Regel, sind aber zwei Objekte. Eine CS-Policy ohne Action lässt sich nur einmal binden; ein zweiter Versuch endet mit Multiple Bind not supported for Content Switching Advanced policies without action.
Gemessen: wohin die Anfragen gehen
Für die Messung hat jeder LB-vServer mit seinem eigenen Namen geantwortet, so zeigt die Antwort direkt, welches Ziel der CS-vServer gewählt hat. Die Anfragen kamen per curl mit gesetztem Host-Header:
| Anfrage | ohne Label | mit Label |
|---|---|---|
app.example.test/a/start | lb_app_a | lb_app_a |
app.example.test/b/start | lb_app_b | lb_app_b |
app.example.test/x | lb_app_rest | lb_default |
andere.example.test/a | lb_default | lb_default |
Drei Zeilen sind gleich. Die dritte nicht: Eine Anfrage an den richtigen Host, für die im Label keine Pfadregel passt, landet beim Standardziel und nicht bei lb_app_rest.
Warum /x beim Standardziel landet
pol_host_app auf Priorität 100 passt, der NetScaler ruft das Label auf und prüft dort /a und /b. Keine der beiden passt. Damit ist die Auswertung beendet. Die Policy auf Priorität 200 prüft der NetScaler gar nicht mehr; ihr Trefferzähler in show cs vserver cs_label blieb bei 0.
Das folgt aus der Bindung selbst. Sie hat keine -gotoPriorityExpression, und laut Herstellerdokumentation zu Policy Labels ist eine fehlende Angabe gleichbedeutend mit END: Nach dem Aufruf des Labels wird nicht weiter ausgewertet. Was das Label nicht entscheidet, entscheidet das Standardziel.
Die Lösung: die Auffangregel gehört ins Label
Die Rest-Regel wandert als letzte Policy in das Label. Ihre Bedingung ist true, sie passt also immer, und weil sie die höchste Prioritätszahl hat, kommt sie nur zum Zug, wenn /a und /b nicht gepasst haben. Die Policy auf Priorität 200 am CS-vServer entfällt:
unbind cs vserver cs_label -policyName pol_host_rest
rm cs policy pol_host_rest
add cs policy pol_label_rest -rule true
bind cs policylabel lbl_app pol_label_rest 900 -targetVserver lb_app_rest
Danach ergab die Messung lb_app_a, lb_app_b, lb_app_rest für /x und lb_default für den fremden Host, also dasselbe wie in der flachen Fassung.
Und -gotoPriorityExpression NEXT?
Naheliegend wäre, die Auswertung nach dem Label einfach weiterlaufen zu lassen:
unbind cs vserver cs_label -policyName pol_host_app
bind cs vserver cs_label -policyName pol_host_app -priority 100 -gotoPriorityExpression NEXT -invoke policylabel lbl_app
Damit landete in meiner Messung jede Anfrage an app.example.test bei lb_app_rest, auch /a und /b. Das Label setzt sein Ziel, die Auswertung läuft am CS-vServer weiter, und die später passende Policy auf Priorität 200 ersetzt das Ziel. Als Gegenprobe habe ich die Policy auf 200 entfernt und NEXT stehen lassen: Dann blieben /a und /b bei ihren Zielen aus dem Label. Für die Rest-Regel bleibt deshalb die Auffangregel im Label der Weg.
Ein Label an mehreren CS-vServern
Ein Label lässt sich von mehreren CS-vServern aus aufrufen. An meiner Testinstanz hat ein zweiter CS-vServer dasselbe lbl_app genutzt und dieselben Ziele geliefert. Er braucht dafür aber eine eigene Einstiegs-Policy, aus demselben Grund wie oben: pol_host_app hat keine Action und ist schon an cs_label gebunden.
add cs policy pol_host_app_2 -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
bind cs vserver cs_flach -policyName pol_host_app_2 -priority 50 -invoke policylabel lbl_app
Das ist der Fall, für den sich ein Label lohnt: Die Regelliste steht einmal im Label, und jeder weitere CS-vServer bekommt nur eine Zeile dazu, etwa eine interne und eine externe VIP für dieselbe Anwendung.
Welche Ziele der NetScaler annimmt
Ein CS-vServer vom Typ HTTP oder SSL nahm an meiner Testinstanz LB-vServer vom Typ HTTP und SSL als Ziel an. Einen LB-vServer vom Typ TCP wies er an jeder Stelle ab, an der das Ziel fest eingetragen wird: als Standardziel, an der Bindung, in einer CS-Action und im Label. Die Action selbst nahm er an; den Fehler meldete er beim Anlegen der Policy, die sie verwendet. Die erste Meldung kam am Standardziel und an der Bindung, die zweite bei der Policy mit Action, die dritte im Label:
ERROR: The target vserver is not compatible with the CS verver.
ERROR: The target vserver is not compatible with the CS policy expression. [HTTP.REQ & HTTP request header]
ERROR: The target vserver is not compatible with the CS policylabel.
Ein Label vom Typ HTTP ließ sich auch von einem CS-vServer vom Typ SSL aufrufen; der Typ des Labels beschreibt das Protokoll, das darin ausgewertet wird. Andere Kombinationen als HTTP, SSL und TCP habe ich nicht geprüft.
Eine Ausnahme gibt es: Ein Ziel, das eine CS-Action erst zur Laufzeit aus einem Ausdruck bildet (-targetVserverExpr), prüft der NetScaler beim Anlegen nicht. Eine Action mit dem Ausdruck "lb_tcp" nahm er ohne Meldung an. show cs action zeigt solche Actions mit ihrem Ausdruck; die dort genannten Ziele sind von Hand gegen den Typ des CS-vServers zu prüfen:
Name: act_expr
Target Vserver Expression: "lb_tcp"
Labels in einer bestehenden Konfiguration finden
show ns runningConfig | grep -i "cs policylabel"
show ns runningConfig | grep -i "^bind cs vserver.*-invoke"
Die erste Zeile zeigt die Labels und ihre Policies, die zweite die CS-vServer, die ein Label aufrufen. Ein Filter nur auf invoke policylabel trifft auch eingebaute Cache-Bindungen (bind cache global NOPOLICY … -invoke policylabel _reqBuiltinDefaults), deshalb der Anfang ^bind cs vserver.
Für die Fehlersuche sind die Trefferzähler der wichtigste Griff, und beim Label stehen sie an einer anderen Stelle. show cs vserver cs_label zeigt am Ende die Einstiegs-Policy mit ihrem Zähler (Ausgabe gekürzt):
1) Content-Switching Policy: pol_host_app Invoke: policylabel lbl_app Rule: HTTP.REQ.HOSTNAME.SERVER.EQ("app.example.test") Priority: 100 Hits: 3
1) Default Target LB: lb_default Hits: 4
show cs policylabel lbl_app zeigt die Policies im Label mit ihren Zielen und wie oft das Label aufgerufen wurde, aber keinen Zähler je Policy:
Label Name: lbl_app
Label Type: HTTP
Number of bound policies: 3
Number of times invoked: 9
1) Policy Name: pol_pfad_a
Priority: 100
Target Virtual Server: lb_app_a
2) Policy Name: pol_pfad_b
Priority: 200
Target Virtual Server: lb_app_b
3) Policy Name: pol_label_rest
Priority: 900
Target Virtual Server: lb_app_rest
Den Zähler einer Policy im Label liefert show cs policy pol_pfad_a:
Policy: pol_pfad_a Rule: HTTP.REQ.URL.PATH.STARTSWITH("/a")
Hits: 3
1) CS Policylabel: lbl_app
Priority: 100
With Target LB: lb_app_a
Hits: 3
Die Zähler laufen der Anfrage ein paar Sekunden hinterher. Direkt nach einem Test standen sie an meiner Testinstanz noch auf dem alten Wert, zehn bis zwanzig Sekunden später stimmten sie.
Direkte Bindung oder Content Switching Policy Label: der Vergleich
| ohne Label | mit Label | |
|---|---|---|
| Aufbau | eine Liste am CS-vServer | Einstiegs-Policy am CS-vServer, Liste im Label |
| Bedingungen | jede Policy trägt alle Bedingungen | gemeinsame Bedingung einmal am CS-vServer, Rest im Label |
| Zielparameter | -targetLBVserver | im Label -targetVserver |
| nichts passt im Teilbereich | die nächste Policy am CS-vServer wird geprüft | die Auswertung endet, das Standardziel greift; Auffangregel ins Label |
| mehrere CS-vServer | jede Policy je CS-vServer binden, Policies ohne Action dafür doppelt anlegen | Label einmal, je CS-vServer eine Einstiegs-Policy |
| Trefferzähler | show cs vserver | Einstieg in show cs vserver, Label-Policies in show cs policy |
| in der Konfiguration | alles unter bind cs vserver | zusätzlich bind cs policylabel |
Bei wenigen Regeln ist die flache Liste leichter zu lesen, weil alles an einer Stelle steht. Das Label spielt seine Stärke aus, wenn eine gemeinsame Bedingung viele Regeln anführt oder dieselbe Regelliste an mehreren CS-vServern gebraucht wird.
Was du dir merkst
Ein Policy Label ist eine zweite Regelliste, die eine Policy am CS-vServer aufruft. Passt darin keine Regel, endet die Auswertung und das Standardziel greift. Die Auffangregel gehört deshalb als letzte Policy ins Label.
Labels findest du mit
grep -i "^bind cs vserver.*-invoke"in der Running-Config, die Treffer je Label-Policy mitshow cs policy. Die Ziele im Label müssen zum Typ des CS-vServers passen wie überall sonst.
Quellen
- Create policy labels, NetScaler-Dokumentation 14.1:
add cs policylabel, Labeltypen, Goto-Ausdrücke (ENDbei fehlender Angabe,NEXT)

Hinterlasse einen Kommentar
An der Diskussion beteiligen?Hinterlasse uns deinen Kommentar!