tca

Description

Use the tca command to set the parameters for threshold crossing alerts.

Use the no form of this command to return a special instance (that is, specific values for a named tunnel) to the default values.

Syntax

tca <tca-name> default {rising | falling} raise-threshold <value> clear-threshold <value> [sample-count <number of samples>]

tca <tca-name> <tunnel-name> {rising | falling} raise-threshold <value> clear-threshold <value> [sample-count <number of samples>]

tca <tca-name> {pass-through | pass-through-unshaped} {rising | falling} raise-threshold <value> clear-threshold <value> [sample-count <number of samples>]

no tca <tca-name> {default | <tunnel-name>}

no tca <tca-name> {default | <tunnel-name>} [rising | falling]

 

tca <tca-name> {default | <tunnel-name>} {enable | disable}

tca <tca-name> {pass-through | pass-through-unshaped} {enable | disable}

 

 

Arguments

tca <tca-name>	Specifies which threshold crossing alert to configure. Some apply to one or more types of traffic. Others only have default values. The options are: • file-system-utilization How much of the file system space has been used, expressed as a percentage. • lan-side-rx-throughput LAN–side Receive throughput, in kilobits per second (kbps). • latency Tunnel latency, in milliseconds (ms). • loss-post-fec Tunnel loss, as tenths of a percent, after applying Forward Error Correction (FEC). • loss-pre-fec Tunnel loss, as tenths of a percent, before applying Forward Error Correction (FEC). • oop-post-poc Tunnel out-of-order packets, as tenths of a percent, after applying Packet Order Correction (POC). • oop-pre-poc Tunnel out-of-order packets, as tenths of a percent, before applying Packet Order Correction (POC). • optimized flows Total number of optimized flows. • reduction Tunnel reduction, in percent (%). • total-flows Total number of flows. • utilization Tunnel utilization, as a percent (%). • wan-side-tx-throughput WAN–side transmit throughput, in kilobits per second (kbps).
default	Sets the tca <tca-name> argument values for any tunnels that weren’t specifically named in configuring an argument. For example, if you configured latency values for tunnel_1 but not for tunnel_2 and tunnel_3, then configuring default would only apply values to tunnel_2 and tunnel_3.
<tunnel-name>	For specifying an individual tunnel for threshold configuration.
falling	Specifies a threshold crossing alarm for when the stat value falls too low.
rising	Specifies a threshold crossing alarm for when the stat value rises too high.
raise-threshold <value>	Specifies at what value to raise an alert.
clear-threshold <value>	After an alarm has been raised, specifies at what value to clear the alert. • For a rising alarm, the clear-threshold value is equal to or less than the raise-threshold. • For a falling alarm, the clear-threshold value is equal to or more than the raise-threshold
sample-count <number of samples>	Sets the number of samples that the metric must sustain below (or above) the threshold in order to raise (or clear) the alert.
enable	Enables this threshold control alert instance.
disable	Disables this threshold control alert instance.

Defaults

None.

Command Mode

Global Configuration Mode

See Also

See “show tca”.

Usage Guidelines

n	This table lists the default state of each type of threshold crossing alert:

TCA	Type	Unit	Default [ON, OFF]	allow rising	allow falling
wan-side-throughput	system	kbps	OFF	4	4
lan-side-throughput	system	kbps	OFF	4	4
optimized-flows	system	flows	OFF	4	4
total-flows	system	flows	OFF	4	4
file-system-utilization	system	%	ON1	4
latency	tunnel	msec	ON	4
loss-pre-fec	tunnel	1/10th %	OFF	4
loss-post-fec	tunnel	1/10th %	OFF	4
oop-pre-poc	tunnel	1/10th %	OFF	4
oop-post-poc	tunnel	1/10th %	OFF	4
utilization	tunnel	%	OFF	4	4
reduction	tunnel	%	OFF		4

---

1

Cannot be disabled.

n	Use the no form of this command to return a special instance (that is, specific values for a named tunnel) back to the default values.

n	Use no tca <tca-name> default to delete the TCA instance.

Examples

To raise an alert when the percent reduction for tunnel_a falls below 60% and to clear the alarm as soon as reduction reaches 70%:

(config) # tca reduction tunnel_a falling raise-threshold 60 clear-threshold 70

Please send comments or suggestions regarding user documentation to techpubs@silver-peak.com.