|
|
Table Of Contents
Threshold Commands
Interface alarm thresholds provide a way to monitor the quality of the client signal. Use the following commands to configure and monitor interface alarm threshold operations.
aps trigger
To enable y-cable line card protection signal switchover when the alarm thresholds are exceeded, use the aps trigger command. To disable y-cable protection signal switchover, use the no form of this command.
aps trigger
no aps trigger
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled
Command Modes
Threshold configuration
Command History
This table includes the following release-specific history entries:
•
EY-Release
•
•
•
•
Usage Guidelines
Use this command in a y-cable protection configuration to cause a signal switchover when the active signal error rates exceed the alarm thresholds. The signal switchover occurs only if the standby signal is acceptable.
Note
Examples
The following example shows how to configure an APS switchover trigger for an alarm threshold.
Switch(config)# threshold-list sonet-alarmsSwitch(config-t-list)# threshold name sonet-sdh section cv failureSwitch(config-threshold)# value rate 6Switch(config-threshold)# aps triggerSwitch(config-threshold)# exitSwitch(config-t-list)# exitSwitch(config)# redundancySwitch(config-red)# associate group chicagoSwitch(config-red-aps)# aps working transparent 3/0/0Switch(config-red-aps)# aps protection transparent 5/0/0Switch(config-red-aps)# aps y-cableSwitch(config-red-aps)# aps revertiveSwitch(config-red-aps)# aps enableSwitch(config-red-aps)# exitSwitch(config-red)# exitSwitch(config)# interface transparent 3/0/0Switch(config-if)# encap sonet oc3Switch(config-if)# monitor enableSwitch(config-if)# threshold-group sonet-alarmsSwitch(config-if)# exitSwitch(config)# interface transparent 5/0/0Switch(config-if)# encap sonet oc3Switch(config-if)# monitor enableSwitch(config-if)# threshold-group sonet-alarmsRelated Commands
description
To configure a alarm threshold description, use the description command. To remove a threshold description, use the no form of the command.
description text
no description
Syntax Description
Defaults
None
Command Modes
Threshold configuration
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
First use the threshold-list command to enter threshold list configuration mode and create a threshold list. Then use the threshold command to specify a threshold to modify and enter threshold configuration mode. This description can be accessed and displayed by network management systems that support SNMP.
Examples
The following example shows how to create a description for a threshold in a threshold list named temp.
Switch# configure terminalSwitch(config)# threshold-list tempSwitch(config-t-list)# threshold name sonet-sdh section cv degradeSwitch(config-threshold)# description This threshold is for SONET and SDH BIP1 errorsRelated Commands
notification-throttle timer
To modify the alarm threshold notification throttle timer, use the notification-throttle timer command. To return the notification throttle timer interval to its default value, use the no form of the command.
notification-throttle timer seconds
no notification-throttle timer
Syntax Description
Defaults
5 seconds
Command Modes
Threshold list configuration
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
Use this command to control the amount of alarm threshold notification activity that is generated on the system.
Examples
The following example shows how to set an alarm threshold list notification throttle timer to 10 seconds.
Switch# configure terminalSwitch(config)# threshold-list sonet-alarmsSwitch(config-t-list)# notification-throttle timer 10Related Commands
Displays the contents of a threshold list.
Groups a set of thresholds with a name. Switches from configuration mode to threshold-list configuration mode.
show threshold-list
To display information about alarm threshold lists, use the show threshold-list command.
show threshold-list [name]
Syntax Description
Defaults
Displays information about all threshold lists in the system.
Command Modes
EXEC and privileged EXEC
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
Use this command to display the threshold values configured for all alarm threshold lists or for a specific alarm threshold list.
Examples
The following example shows how to display information for alarm threshold list named sonet-counters. (See Table 9-1 for field descriptions.)
Switch# show threshold-listThreshold List Name: sonet-countersNotification throttle timer : 5 (in secs)Threshold name : sonet-sdh section cv Severity : DegradeValue : 10e-9APS Trigger : Not setDescription : SONET BIP1 counterThreshold name : sonet-sdh section cv Severity : FailureValue : 10e-6APS Trigger : SetDescription : SONET BIP1 counter
Table 9-1 show threshold-list Field Descriptions
Threshold List Name
Shows the name of the threshold list.
Notification throttle timer
Shows, in seconds, the interval in which no more than one threshold alarm notification can be generated. If more than one notification is generated during the hold-down period, the extra notifications are delayed.
Threshold name
Shows the name of the threshold counter. See the threshold command for a list of threshold names.
Severity
Shows the threshold severity (Degrade or Failure).
Value
Shows the threshold rate value for the system to issue an alarm.
APS Trigger
Indicates whether the APS switchover trigger is set.
Description
Shows the description text for the counter.
Related Commands
threshold
To configure an alarm threshold in a threshold list, use the threshold command. To remove a threshold from a threshold list, use the no form of the command.
threshold name {cvrd | cdl hec | crc | sonet-sdh section cv | tx-crc} {degrade | failure} [index value]
no threshold name {cvrd | cdl hec | crc | sonet-sdh section cv | tx-crc} {degrade | failure} [index value]
Syntax Description
Defaults
None
Command Modes
Threshold-list configuration
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
First use the threshold-list command to enter threshold-list configuration mode and create a threshold list. Then use the threshold command to enter threshold configuration mode for the specific threshold. In threshold configuration mode, you can modify the threshold attribute values.
Interfaces have no default alarm threshold values. When monitoring is enabled, alarm thresholds are only in effect when a threshold list is associated with the interface.
By default, the threshold command uses the next available threshold index number in the threshold list MIB. The index keyword and value allow you to explicitly assign an index for the threshold. This is particularly useful as index numbers become available when thresholds are deleted.
Examples
The following example shows how to configure an alarm threshold in a threshold list and enter threshold configuration mode.
Switch# configure terminalSwitch(config)# threshold-list tempSwitch(config-t-list)# threshold name cvrd degradeSwitch(config-threshold)#Related Commands
threshold-group
To associate a threshold list to an interface, use the threshold-group command. To remove a threshold list from an interface, use the no form of this command.
threshold-group name
no threshold-group name
Syntax Description
Defaults
None
Command Modes
Interface configuration
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
Use this command to associate a threshold list to a specified interface.
Even though a threshold list might contain the thresholds for all error counters, not all of these thresholds are applicable to the interface. Thresholds are recognized by the interface based on the interface type (for example, wave) and the encapsulation type (in the case of transparent interfaces).
You can associate more than one threshold list with an interface. The lists cannot contain overlapping thresholds. The system will not allow you to associate a threshold list if it contains a counter the interface already monitors for another threshold list.
If the interface is not associated with any threshold list, the threshold counters that are monitored on that interface are set to their default values.
Note
Examples
The following example shows how to associate a threshold list to a transparent interface.
Switch# configure terminalSwitch(config)# interface transparent 2/0/0Switch(config-if)# threshold-group tempRelated Commands
threshold-list
To create a list of thresholds, or modify an existing threshold list, use the threshold-list command. To delete the threshold list, use the no form of this command.
threshold-list name
no threshold-list name
Syntax Description
name
Specifies the name of the threshold list to be created and associated with a specified interface. The list name cannot begin with the text string "default".
Defaults
None
Command Modes
Global configuration
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
Use this command to create a list, or modify an existing list, of signal degrade and signal failure alarm thresholds for monitored error counters. After entering the command, the CLI enters threshold configuration mode where you can specify the threshold list attributes or threshold counters to add or modify.
Before deleting or modifying a threshold list, remove it from all the interfaces that use it.
Examples
The following example shows how to create a threshold list called temp.
Switch# configure terminalSwitch(config)# threshold-list tempSwitch(config-t-list)#Related Commands
value
To configure the values of failure and degrade alarm threshold rates, use the value command. To remove an threshold rate, use the no form of the command.
value rate value
no value
Syntax Description
Defaults
None
Command Modes
Threshold configuration
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
Usage Guidelines
First use the threshold-list command to enter threshold-list configuration mode and create a threshold list. Then use the threshold command to specify a threshold to modify and enter threshold configuration mode.
The degrade rate value for a threshold must always be less than the failure rate value. For example, if the failure rate for a threshold is 7, or 10-7, then the degrade value must be 8 or 9.
Table 9-2 lists the errors per second for the threshold rates for each of the protocol encapsulations.
Table 9-2 Thresholds for Monitored Protocols (Errors Per Second)
3
31,753
32,000
32,000
125000
4
12,318
27,421
31,987
12500
5
1518
5654
17,296
1250
6
155
616
2394
125
7
15.5
62
248
13
8
1.55
6.2
24.8
1.3
9
0.155
0.62
2.48
0.13
3
199,102
110000
220000
1,057,731
4
19,991
11000
22000
106,202
5
2000
1100
2200
10,625
6
200
110
220
1062
7
20
11
22
106
8
2
1.1
2.2
10.6
9
0.2
0.11
0.22
1.06
1 Compatibility mode only.
Examples
The following example shows how to create thresholds within a threshold list (temp) with the SONET and SDH section code violation error threshold signal degrade rate of 9 and signal failure rate of 7.
Switch# configure terminalSwitch(config)# threshold-list tempSwitch(config-t-list)# threshold name sonet-sdh section cv degradeSwitch(config-threshold)# value rate 9Switch(config-threshold)# exitSwitch(config-t-list)# threshold name sonet-sdh section cv failureSwitch(config-threshold)# value rate 7Switch(config-threshold)# endSwitch#Related Commands
Posted: Wed Apr 26 03:10:26 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
