> 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.
> Product
> TPO
> Privilege
> Security Administrator, Administrator
> Syntax
> ad-filter ad-click-identity bypass_string
> no 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.
> Product
> TPO
> Privilege
> Security Administrator, Administrator
> Syntax
> match-ad priority rule_priority tpo-ruledef tpo_ruledef_name
> no 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.
> 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.
> 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

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883