cs-policy
The following operations can be performed on "cs-policy":
rm cs policy
Removes a content switching policy. You can delete a user-defined content switching policy that is not bound to a content switching virtual server. If the policy is bound to a virtual server, you must first unbind the policy, and then remove it.
Synopsis
rm cs policy <policyName>
Arguments
policyName Name of the content switching policy to be removed.
rename cs policy
Rename a content switching policy.
Synopsis
rename cs policy <policyName>@ <newName>@
Arguments
policyName The name of the content switching policy.
newName The new name of the content switching policy.
Example
rename cs policy oldname newname
unset cs policy
Unset logaction for existing content swtching policy..Refer to the set cs policy command for meanings of the arguments.
Synopsis
unset cs policy <policyName> -logAction
Example
unset cs policy pol9 -logAction
set cs policy
Changes an existing content switching policy.
Arguments
policyName Name of the content switching policy.
rule The condition for applying this policy.
action The content switching action name.
logAction The log action associated with the content switching policy
add cs policy
Creates a new content switching policy. You use this policy to manage content switching on a virtual server.
Arguments
policyName Name for the content switching policy. Must begin with an ASCII alphanumeric or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at sign (@), equal sign (=), and hyphen (-) characters. Cannot be changed after a policy is created. The following requirement applies only to the Citrix ADC CLI: If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, "my policy" or 'my policy').
rule Expression, or name of a named expression, against which traffic is evaluated. The following requirements apply only to the Citrix ADC CLI:
-
If the expression includes one or more spaces, enclose the entire expression in double quotation marks.
-
If the expression itself includes double quotation marks, escape the quotations by using the character.
-
Alternatively, you can use single quotation marks to enclose the rule, in which case you do not have to escape the double quotation marks.
action Content switching action that names the target load balancing virtual server to which the traffic is switched.
logAction The log action associated with the content switching policy
Example
To match the requests that have URL ".html", you would enter the following command: add cs policy <policyName> -rule http.req.url.eq(".html") -action <actionName> To match with all URLs that start with "/sports.html", you would enter the following command: add cs policy <policyName> -rule http.req.url.startswith("/sports.html") -action <actionName> To match requests with the URL "/sports/tennis/index.html", you would enter the following command: add cs policy <policyName> -rule http.req.url.eq("/sports/tennis/index.html") -action <actionName> To match requests that have URLs with the extension "jsp", you would enter the following command: add cs policy <policyName> -rule http.req.url.suffix.eq("jsp") -action <actionName> To match requests with URLs that start with "/sports.html" and the file extension "jsp", you would enter the following command: add cs policy <policyName> -rule "http.req.url.startswith(\"/sports/\") && http.req.url.suffix.eq(\"jsp\")" -action <actionName> To match requests with URLs that contain "sports", you would enter the following commands: add pol expression sports_url http.req.url.contains("sports") add cs policy <policyName> -rule sports_url -action <actionName> To match requests with URL queries that contain "gold" or cookie headers that contain "gold", you would enter the following commands: add pol expression gold_query "http.req.url.query.contains(\"gold\")" add pol expression gold_cookie "http.req.header(\"cookie\").contains(\"gold\")" add cs policy <policyName> -rule "(gold_query ||gold_cookie)" -action <actionName> To match requests with the domain name www.domainxyz.com, you enter the following command: add cs policy <policyName> -rule "http.req.hostname.eq(\"www.domainxyz.com\")" -action <actionName> To match requests with the domain name www.domainxyz.com and URLs with the extension "jsp", you would enter the following command: add cs policy <policyName> -rule "http.req.hostname.eq(\"www.domainxyz.com\") && http.req.url.suffix.eq(\"jsp\")" -action <actionName> To match requests with the domain name www.domainxyz.com and URLs that contain "sports", you would enter the following commands: add pol expression sports_url http.req.url.contains("sports") add cs policy <policyName> -rule "sports_url && http.req.hostname.eq(\"www.domainxyz.com\")" -action <actionName> To match a policy with a rule and provide action: add cs policy <policyname> -rule "http.req.method.eq(GET)" -action <actionName>
show cs policy
Displays all existing content switching policies, or just the specified policy.
Arguments
policyName Name of the content switching policy to display. If this parameter is omitted, details of all the policies are displayed.
Output
rule The condition for applying this policy.
action The CS action name.
vstype Virtual server type.
hits Total number of hits.
bindHits Total number of bind hits.
labelName Name of the label invoked.
labelType The invocation type.
target Target flag
priority priority of bound policy
flag stateflag activePolicy Indicates whether policy is bound or not.
logAction The log action associated with the content switching policy
gslbBindings boundTo Location where policy is bound
gotoPriorityExpression Expression specifying the priority of the next policy which will get evaluated if the current policy rule evaluates to TRUE.
devno count