# ACS TPO Policy Configuration Mode Commands

The ACS TPO Policy Configuration Mode is used to configure Traffic Performance Optimization (TPO) policies.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
ad-filter

This command allows you to configure the bypass string for the Advertisement Filter feature.
Platform:

ASR 5000

ASR 5500
Product:

TPO
Privilege:

Security Administrator, Administrator
Syntax

    ad-filter ad-click-identity bypass_stringno ad-filter ad-click-identity

no

Removes the bypass string if previously configured.
bypass_string

Specifies the bypass string.

bypass_string must be an alphabetic string of 1 through 14 characters.

IMPORTANT:

The bypass string must consist of any of the following characters: “abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ”. Numeric and special characters are not accepted.
Usage:

Use this command to configure the bypass string for the Advertisement Blocking with On-click feature. To enable retrieving a blocked advertisement requested by the subscriber, in the HTTP request the bypass string is added to the advertisement’s URL, which TPO interprets and forwards to the Web Server allowing the advertisement to be retrieved.
Example:
The following command configures the bypass string as allow:

    ad-filter ad-click-identity allow

end

Exits the current configuration mode and returns to the Exec mode.
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    end

Usage:

Use this command to return to the Exec mode.
exit

Exits the current mode and returns to the parent configuration mode.
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    exit

Usage:

Use this command to return to the parent configuration mode.
match-ad

This command allows you to define rules to match advertisements.
Platform:

ASR 5000

ASR 5500
Product:

TPO
Privilege:

Security Administrator, Administrator
Syntax

    match-ad priority rule_priority tpo-ruledef tpo_ruledef_nameno match-ad priority rule_priority

no

If previously configured, removes the specified TPO match-advertisement rule from the current TPO policy.
priority rule_priority

Specifies the priority of the TPO match-advertisement rule in the current TPO policy.

rule_priority must be an integer from1 through 65535, and must be unique in the current TPO policy.
tpo-ruledef tpo_ruledef_name

Specifies the TPO rule to add/remove from the current TPO policy.

tpo_ruledef_name must be the name of a TPO ruledef, and must be an alphanumeric string of 1 through 63 characters.
Usage:

Use this command to define the rules to block advertisements.
Example:
The following command creates a match-advertisement rule to use the TPO ruledef named tporule1 with the priority 1:

    match-ad priority 1
    tpo-ruledef tporule1

match-rule no-ruledef-match

This command allows you to specify the action to be taken when the traffic does not match any TPO ruledef.
Platform:

ASR 5000

ASR 5500
Product:

TPO
Privilege:

Security Administrator, Administrator
Syntax

    match-rule no-ruledef-match
    tpo { none | profile tpo_profile_name }default match-rule
    no-ruledef-match

default

Configures this command with its default setting.

Default: none. No TPO profile is selected.
none

Specifies that no TPO profile be used.
profile tpo_profile_name

Specifies the TPO profile to use when there is no rule match.

tpo_profile_name must be the name of a TPO profile, and must be an alphanumeric string of 1 through 63 characters.
Usage:

Use this command to specify the action to be taken when the traffic does not match any TPO ruledef in the TPO policy.
Example:
The following command specifies to use a TPO profile named tpo_profile2 when the traffic does not match any TPO ruledefs in the TPO policy:

    match-rule no-ruledef-match
    tpo profile tpo_profile2

match-rule priority

This command allows you to specify the TPO profile to use when the traffic matches a particular TPO ruledef/TPO group-of-ruledefs.
Platform:

ASR 5000

ASR 5500
Product:

TPO
Privilege:

Security Administrator, Administrator
Syntax

    match-rule priority rule_priority { tpo-group-of-ruledefs tpo_group_of_ruledefs_name | tpo-ruledef tpo_ruledef_name } tpo { none | profile tpo_profile_name } [ description description ]no match-rule priority rule_priority

no

Removes the specified match rule configuration.
match-rule priority rule_priority

Specifies priority of the rule within the TPO policy.

rule_priority must be an integer from1 through 65535, and must be unique in the current TPO policy.
tpo-group-of-ruledefs tpo_group_of_ruledefs_name

IMPORTANT:

The tpo-group-of-ruledefs option is available only in 12.2 and later releases.

Specifies the TPO group-of-ruledefs.

tpo_group_of_ruledefs_name must be the name of the TPO group-of-ruledefs, and must be an alphanumeric string of 1 through 63 characters.

If any of the ruledefs within a group-of-ruledefs match, that group-of-ruledefs is considered a match.
tpo-ruledef tpo_ruledef_name

Specifies the TPO rule.

tpo_ruledef_name must be the name of a TPO ruledef, and must be an alphanumeric string of 1 through 63 characters.
tpo { none | profile tpo_profile_name }

Specifies the TPO profile to be used.

- none: Specifies that no TPO profile be used.
- profile tpo_profile_name: Specifies the TPO profile to be used. tpo_profile_name must be the name of a TPO profile, and must be an alphanumeric string of 1 through 63 characters.

description description

Adds the specified description to this rule priority configuration.

description must be an alphanumeric string of 1 through 127 characters.
Usage:

IMPORTANT:

A maximum of 2048 optimization rules can be configured in the system.

Use this command to specify the TPO profile to use when the traffic matches a particular TPO ruledef/TPO group-of-ruledefs in the TPO policy.

This CLI command can be entered multiple times to specify multiple rules and TPO profiles. The rules are examined in order of priority, until a match is found and the corresponding TPO profile is applied. Lower numbered priorities are examined first.
Example:
The following command creates a rule match configuration to use the TPO profile named tpoprofile1 when the traffic matches the TPO ruledef named tporule1 with priority 1:

    match-rule priority
    1 tpo-ruledef tporule1 tpo profile tpoprofile1