Download full document:

videooptimization policy

The following operations can be performed on "videooptimization policy":

add | rm | set | unset | show | rename | stat

add videooptimization policy

Creates a videooptimization policy, which specifies requests that the NetScaler appliance intercepts and tries to detect media type.

Synopsys

add videooptimization policy <name> -rule <expression> -action <string> [-undefAction <string>] [-comment <string>] [-logAction <string>]

Arguments

name

Name for the videooptimization policy. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore characters.Can be modified, removed or renamed.

rule

Expression that determines which request or response match the video optimization policy. Written in default syntax.

Note:

Maximum length of a string literal in the expression is 255 characters. A longer string can be split into smaller strings of up to 255 characters each, and the smaller strings concatenated with the + operator. For example, you can create a 500-character string as follows: '"<string of 255 characters>" + "<string of 245 characters>"'

(Classic expressions are not supported in the cluster build.)

The following requirements apply only to the NetScaler 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

Name of the videooptimization action to perform if the request matches this videooptimization policy. Built-in actions should be used. These are:

  • DETECT_CLEARTEXT_PD - Cleartext PD is detected and increment related counters.

  • DETECT_CLEARTEXT_ABR - Cleartext ABR is detected and increment related counters.

  • DETECT_ENCRYPTED_ABR - Encrypted ABR is detected and increment related counters.

  • TRIGGER_ENC_ABR_DETECTION - This is possible encrypted ABR. Internal traffic heuristics algorithms will further process traffic to confirm detection.

undefAction

Action to perform if the result of policy evaluation is undefined (UNDEF). An UNDEF event indicates an internal error condition. Only the above built-in actions can be used.

comment

Any type of information about this videooptimization policy.

logAction

Name of the messagelog action to use for requests that match this policy.

Example

i) add videooptimization policy pol1 -rule "HTTP.REQ.URL.CONTAINS(\".mov\")" -action DETECT_CLEARTEXT_PD

rm videooptimization policy

Removes the specified videooptimization policy.

Synopsys

rm videooptimization policy <name>

Arguments

name

Name for the videooptimization policy. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore characters.Can be modified, removed or renamed.

Example

rm videooptimization policy pol1

set videooptimization policy

Modifies the specified parameter of the videooptimization policy.

Synopsys

set videooptimization policy <name> [-rule <expression>] [-action <string>] [-undefAction <string>] [-comment <string>] [-logAction <string>]

Arguments

name

Name for the videooptimization policy. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore characters.Can be modified, removed or renamed.

rule

Expression that determines which request or response match the video optimization policy. Written in default syntax.

Note:

Maximum length of a string literal in the expression is 255 characters. A longer string can be split into smaller strings of up to 255 characters each, and the smaller strings concatenated with the + operator. For example, you can create a 500-character string as follows: '"<string of 255 characters>" + "<string of 245 characters>"'

(Classic expressions are not supported in the cluster build.)

The following requirements apply only to the NetScaler 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

Name of the videooptimization action to perform if the request matches this videooptimization policy. Built-in actions should be used. These are:

  • DETECT_CLEARTEXT_PD - Cleartext PD is detected and increment related counters.

  • DETECT_CLEARTEXT_ABR - Cleartext ABR is detected and increment related counters.

  • DETECT_ENCRYPTED_ABR - Encrypted ABR is detected and increment related counters.

  • TRIGGER_ENC_ABR_DETECTION - This is possible encrypted ABR. Internal traffic heuristics algorithms will further process traffic to confirm detection.

undefAction

Action to perform if the result of policy evaluation is undefined (UNDEF). An UNDEF event indicates an internal error condition. Only the above built-in actions can be used.

comment

Any type of information about this videooptimization policy.

logAction

Name of the messagelog action to use for requests that match this policy.

Example

set videooptimization policy pol1 -rule "HTTP.REQ.URL.CONTAINS(\".flv\")" -action DETECT_CLEARTEXT_PD

unset videooptimization policy

Removes the settings of an existing videooptimization policy. Attributes for which a default value is available revert to their default values. See the set video opt policy command for descriptions of the parameters..Refer to the set videooptimization policy command for meanings of the arguments.

Synopsys

unset videooptimization policy <name> [-undefAction] [-comment] [-logAction]

Example

unset videooptimization policy media_pol1 -undefAction

show videooptimization policy

Displays the current settings for the specified videooptimization policy.

Synopsys

show videooptimization policy [<name>]show videooptimization policy stats - alias for 'stat videooptimization policy'

Arguments

name

Name of the video opt policy for which to display settings.Must provide policy name.

Outputs

stateflag

rule

Expression that determines which request or response match the video optimization policy. Written in default syntax.

Note:

Maximum length of a string literal in the expression is 255 characters. A longer string can be split into smaller strings of up to 255 characters each, and the smaller strings concatenated with the + operator. For example, you can create a 500-character string as follows: '"<string of 255 characters>" + "<string of 245 characters>"'

(Classic expressions are not supported in the cluster build.)

The following requirements apply only to the NetScaler 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

Name of the videooptimization action to perform if the request matches this videooptimization policy. Built-in actions should be used. These are:

  • DETECT_CLEARTEXT_PD - Cleartext PD is detected and increment related counters.

  • DETECT_CLEARTEXT_ABR - Cleartext ABR is detected and increment related counters.

  • DETECT_ENCRYPTED_ABR - Encrypted ABR is detected and increment related counters.

  • TRIGGER_ENC_ABR_DETECTION - This is possible encrypted ABR. Internal traffic heuristics algorithms will further process traffic to confirm detection.

undefAction

Action to perform if the result of policy evaluation is undefined (UNDEF). An UNDEF event indicates an internal error condition. Only the above built-in actions can be used.

hits

Number of hits.

undefHits

Number of policy UNDEF hits.

activePolicy

Indicates whether policy is bound or not.

boundTo

Location where policy is bound

priority

Specifies the priority of the policy.

gotoPriorityExpression

Expression specifying the priority of the next policy which will get evaluated if the current policy rule evaluates to TRUE.

comment

Any type of information about this videooptimization policy.

logAction

Name of the messagelog action to use for requests that match this policy.

labelType

Type of policy label invocation.

labelName

Name of the label to invoke if the current policy rule evaluates to TRUE.

vserverType

builtin

Flag to determine if videooptimization policy is built-in or not

devno

count

Example

show videooptimization policy pol1

rename videooptimization policy

Renames the specified videooptimization policy.

Synopsys

rename videooptimization policy <name>@ <newName>@

Arguments

name

Existing name of the videooptimization policy.

newName

New name for the videooptimization policy. Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) hash (#), space ( ), at (@), equals (=), colon (:), and underscore characters.

Example

rename videooptimization policy oldname newname

stat videooptimization policy

Displays statistics for all video optimization policies currently configured on the NetScaler appliance, or detailed statistics for the specified policy.

Synopsys

stat videooptimization policy [<name>] [-detail] [-fullValues] [-ntimes <positive_integer>] [-logFile <input_filename>] [-clearstats ( basic | full )]

Arguments

name

Name of the Video Optimization policy for which to show detailed statistics.

detail

Specifies detailed output (including more statistics). The output can be quite voluminous. Without this argument, the output will show only a summary.

fullValues

Specifies that numbers and strings should be displayed in their full form. Without this option, long strings are shortened and large numbers are abbreviated

ntimes

The number of times, in intervals of seven seconds, the statistics should be displayed.

Default value: 1

Minimum value: 0

logFile

The name of the log file to be used as input.

clearstats

Clear the statsistics / counters

Possible values: basic, full

Outputs

count

devno

stateflag

Outputs

Policy hits (Hits)

Number of hits on the policy

Policy undef hits (Undefhits)

Number of undef hits on the policy