Table Of Contents
alarm profile (global configuration)
alarm profile (interface configuration)
Catalyst 2955 Alarm Commands
This appendix describes the commands used to monitor switch conditions on the Catalyst 2955 switch. These commands are not supported on the Catalyst 2950 switch.
Note
For more information about how to use the commands, refer to the "Configuring Catalyst 2955 Switch Alarms" chapter in the software configuration guide for this release.
alarm facility fcs-hysteresis
Use the alarm facility fcs-hysteresis global configuration command to set the frame check sequence (FCS) error hysteresis threshold as a percentage of fluctuation from the FCS bit error rate. Use the no form of this command to set the FCS error hysteresis threshold to its default value.
alarm facility fcs-hysteresis percentage
no alarm facility fcs-hysteresis percentage
Syntax Description
Defaults
The default threshold-value is 10 percent.
Command Modes
Global configuration
Command History
Usage Guidelines
Set a hysteresis threshold to prevent an alarm from triggering when the FCS bit error rate fluctuates near the configured bit error rate.
You set the FCS hysteresis threshold for all ports on the switch; you set the FCS error rate on a per-port basis by using the fcs-threshold interface configuration command.
If the threshold is not the default, it appears in the output of the show running-config privileged EXEC command.
Examples
This example shows how to set the FCS error hysteresis to 5 percent. The alarm is not triggered unless the bit error rate is more than 5 percent from the configured FCS bit error rate.
Switch(config)# alarm facility fcs-hysteresis 5Related Commands
alarm facility power-supply
Use the alarm facility power-supply global configuration command to set the alarm options for a missing or failing power supply when the system is operating in dual power-supply mode. Use the no form of the command to disable the specified setting.
alarm facility power-supply {notifies | relay {major | minor} | syslog}
no alarm facility power-supply {notifies | relay {major | minor} | syslog}
Syntax Description
Defaults
A power supply alarm message is stored but not sent to an SNMP server, to a relay, or to a syslog server.
Command Modes
Global configuration
Command History
Usage Guidelines
Power supply alarms are generated only when the system is in dual power-supply mode. When a second power supply is connected, you must use the power-supply dual global configuration command to set dual power-mode operation.
Before you use the notifies keyword to sent alarm traps to an SNMP host, you need to set up an SNMP server by using the snmp-server enable traps global configuration command.
Examples
This example shows how to set the power-supply monitoring alarm to go to the minor relay circuitry:
Switch(config)# alarm facility power-supply relay minorRelated Commands
alarm facility temperature
Use the alarm facility temperature global configuration command to configure a primary temperature monitoring alarm or to configure a secondary temperature alarm threshold with a lower maximum temperature threshold. Use the no form of this command to delete the temperature monitoring alarm configuration or to disable the secondary temperature alarm.
alarm facility temperature {primary {notifies | relay {major | minor} | syslog} | secondary {threshold | notifies | relay {major | minor}| syslog}}
no alarm facility temperature {primary {notifies | relay {major | minor} | syslog} | secondary {threshold | notifies | relay {major | minor}| syslog}}
Syntax Description
Defaults
The primary temperature alarm is enabled for a -20 to 95oC range and cannot be deleted. It is associated with a major relay. The secondary temperature alarm is disabled by default.
Command Modes
Global configuration
Command History
Usage Guidelines
The primary temperature alarm is automatically enabled. It cannot be disabled, but you can configure alarm options.
You can use the secondary temperature alarm to trigger a high temperature alarm at lower than the maximum primary temperature threshold (95oC). You can configure the temperature threshold and alarm options.
Before you use the notifies keyword to sent alarm traps to an SNMP host, you need to set up an SNMP server by using the snmp-server enable traps global configuration command.
Examples
This example shows how to set the secondary temperature with a high threshold value of 45 0C with alarms and how to send traps to the minor relay circuitry, to the syslog, and to an SNMP server:
Switch(config)# alarm facility temperature secondary 45Switch(config)# alarm facility temperature secondary relay minorSwitch(config)# alarm facility temperature secondary syslogSwitch(config)# alarm facility temperature secondary notifiesThis example shows how to disable the secondary temperature alarm:
Switch(config)# no alarm facility temperature secondary 45This example shows how to set the primary temperature alarm with alarms and traps to go to the syslog and to the major relay circuitry:
Switch(config)# alarm facility temperature primary syslogSwitch(config)# alarm facility temperature primary relay majorRelated Commands
Displays environmental alarm settings and options.
Enables the switch to send SNMP notification for various trap types to the network management system (NMS).
alarm profile (global configuration)
Use the alarm profile global configuration command to create an alarm profile and to enter alarm profile configuration mode. Use the no form of this command to delete an alarm profile.
alarm profile name
no alarm profile name
Syntax Description
Defaults
No alarm profiles are created.
When a profile is created, none of the alarms are enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
In alarm-profile configuration mode, these commands are available:
•
•
•
•
•
•
•
•
For alarm-id, you can enter one or more alarm IDs separated by a space.
Before you use the notifies keyword to send alarm traps to a SNMP host, you need to set up an SNMP server by using the snmp-server enable traps global configuration command.
Table A-1 lists the alarm IDs and their corresponding alarm descriptions.
Table A-1 AlarmList ID Numbers and Alarm Descriptions
1
Link Fault
2
Port not Forwarding
3
Port not Operating
4
FCS Error Rate exceeds threshold
After you have created an alarm profile, you can attach the profile to an interface by using the alarm-profile interface configuration command.
By default, the defaultPort profile is applied to all interfaces. This profile enables only the Port Not Operating (3) alarm. You can modify this profile by using the alarm profile defaultPort global configuration command to enter alarm profile configuration mode for this profile.
Examples
This example shows how to create the alarm profile fastE for a port with the link-down (alarm 1) and port not forwarding (alarm 2) alarms enabled. The link-down alarm is connected to the minor relay circuitry, and the port not forwarding alarm is connected to the major relay circuitry. These alarms are sent to an SNMP server and written to the system log file (syslog).
Switch(config)# alarm profile fastESwitch(config-alarm-prof)# alarm 1 2Switch(config-alarm-prof)# relay major 2Switch(config-alarm-prof)# relay minor 1Switch(config-alarm-prof)# notifies 1 2Switch(config-alarm-prof)# syslog 1 2This example shows how to delete the alarm relay profile named my-profile:
Switch(config)# no alarm profile my-profileRelated Commands
alarm profile (interface configuration)
Use the alarm profile interface configuration command to attach an alarm profile to a port. Use the no form of this command to detach the profile from the port.
alarm profile name
no alarm profile
Syntax Description
Defaults
The alarm profile defaultPort is applied to all interfaces. In this profile, only the Port is not Operating alarm is enabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
Use the alarm profile global configuration command to create the alarm profile, enabling one or more alarms and specifying the alarm options.
You can attach only one alarm profile to an interface.
When you attach an alarm profile to an interface, it overwrites any previous alarm profile that was attached to the interface (including the defaultPort profile).
Examples
This example shows how to attach an alarm profile named fastE to a port:
Switch(config)# interface fastethernet0/2Switch(config-if)# alarm profile fastEThis example shows how to detach the alarm profile from a port and return it to the defaultPort profile:
Switch(config)# interface fastethernet0/2Switch(config-if)# no alarm profileRelated Commands
fcs-threshold
Use the fcs-threshold interface configuration command to set the frame check sequence (FCS) bit error rate. Use the no form of the command to return to the default setting.
fcs-threshold value
no fcs-threshold value
Syntax Description
Defaults
The default for this bit error rate is 8, which is the bit error rate for Ethernet standard 10-8.
Command Modes
Global configuration
Command History
Usage Guidelines
The Ethernet standard calls for a maximum bit error rate of 10-8. In the Catalyst 2955 switch, the bit error rate configurable range is from 10-6 to 10-11. The bit error rate input to the switch is a positive exponent. To configure an bit error rate of 10-9, enter the value 9 for the exponent.
You can set an FCS error hysteresis threshold on the switch to prevent the toggle of the alarm when the actual bit error rate fluctuates near the configured bit error rate by using the alarm facility fcs hysteresis global configuration command.
Examples
This example shows how to set the FCS bit error rate for a port to 10-10:
Switch(config)# interface fastethernet0/1Switch(config-if)# fcs-threshold 10Related Commands
power-supply dual
Use the power-supply dual global configuration command to set the dual power-supply mode of operation. Use the no form of this command to return to the default single power-supply mode.
power-supply dual
no power-supply dual
Syntax Description
This command has no arguments or keywords.
Defaults
By default, the system operates in single-power mode.
Command Modes
Global configuration
Command History
Usage Guidelines
The Catalyst 2955 switch has two DC power inputs. When the switch is connected to a second DC input and put in dual power-supply mode, the second power supply provides power to the switch if the primary supply fails.
When the switch is in dual power-supply mode, you can use the alarm-facility power supply global configuration command to set alarm options and to monitor for a missing or failed primary power supply.
Examples
This example shows how to set the switch in a dual power-supply mode:
Switch(config)# power-supply dualRelated Commands
Sets the switch to monitor for a missing or failed power supply and sets the alarm options.
Displays environmental alarm settings and options.
show alarm description port
Use the show alarm description port user EXEC command to display the alarm numbers with the text description.
show alarm description port [ | {begin | exclude | include} expression]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show alarm description port command. It shows the alarmIDs and their respective alarm descriptions.
Switch> show alarm description port1 Link Fault2 Port Not Forwarding3 Port Not Operating4 FCS Error Rate exceeds thresholdRelated Commands
show alarm profile
Use the show alarm profile user EXEC command to display all alarm profiles configured in the system or the specified profile and the interfaces to which each profile is attached.
show alarm profile [name] [ | {begin | exclude | include} expression]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
If no profile name is entered, the display includes profile information for all existing alarm profiles.
The defaultPort profile is applied by default to all interfaces. This profile enables only the Port Not Operating (3) alarm. You can use the alarm profile defaultPort global configuration command and modify this profile to enable other alarms.
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show alarm profile command. It displays all ports that are attached to the configured profiles and defines the alarm options in the profile.
Switch> show alarm profilealarm profile defaultPort:Interfaces FastEthernet0/2 FastEthernet0/3 FastEthernet0/4 FastEthernet0/5 FastEthernet0/6 FastEthernet0/7 FastEthernet0/8 FastEthernet0/9 FastEthernet0/10 FastEthernet0/11 FastEthernet0/12 GigabitEthernet0/1 GigabitEthernet0/2Alarms 3Syslog 3, 4Notifies 3Relay Major 1, 2Relay Minor 1, 4alarm profile teresa:Interfaces FastEthernet0/1Alarms 1, 2, 3, 4Syslog 2, 3, 4NotifiesRelay Major 1Relay Minoralarm profile test-profile:InterfacesAlarmsSyslogNotifiesRelay MajorRelay MinorRelated Commands
Creates an alarm profile containing one or more alarm IDs and alarm options.
Attaches an alarm profile to an interface.
show alarm settings
Use the show alarm settings user EXEC command to display all environmental alarm settings on the switch.
show alarm settings [ | {begin | exclude | include} expression]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show alarm settings command. It shows all the switch alarm settings that are on the switch:
Switch> show alarm settingsPower SupplyMode SingleAlarm DisabledRelay MINNotifies DisabledSyslog DisabledTemperature-PrimaryAlarm EnabledThresholds MAX: 95C MIN: -20CRelay MAJNotifies EnabledSyslog EnabledTemperature-SecondaryAlarm DisabledThresholdRelayNotifies DisabledSyslog DisabledRelated Commands
Sets power supply alarm options.
Sets temperature alarm options.
Sets dual power-supply mode.
show env
Use the show env privileged EXEC command to display the status of environmental facilities on the Catalyst 2955 switch.
show env {all | power | temperature}[ | {begin | exclude | include} expression]
Note
Syntax Description
Command Modes
Privileged EXEC
Command History
12.0(5.2)WC(1)
This command was introduced.
12.1(12c)EA1
The power and temperature keywords were added.
Usage Guidelines
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show env power command. It shows the status of all power supplies on the switch.
Switch# show env powerPower supply A is presentPower supply B is presentThis is an example of output from the show env temperature command. It shows temperature status on the switch.
Switch# show env temperatureCurrent temperature is 49CHighest temperature was 53C Mar 04 1993 04:06:36This is an example of output from the show env all command. It shows the status of all environmental facilities (power supply and temperature) on the switch.
Switch# show env allPower supply A is presentPower supply B is presentCurrent temperature is 49CHighest temperature was 53C Mar 04 1993 04:06:36Related Commands
show facility-alarm relay
Use the show facility-alarm relay user EXEC command to display facility alarms associated with the indicated relay circuitry.
show facility-alarm relay {major | minor} [ | {begin | exclude | include} expression]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show facility-alarm relay minor command. It displays alarm information for the minor relays.
Switch> show facility-alarm relay minorSource Description Relay TimeSwitch 1 Temp above secondary thresh MIN Mar 01 1993 00:0 1:17Related Commands
show facility-alarm status
Use the show facility-alarm status user EXEC command to display all generated alarms for the switch.
show facility-alarm status [critical | info | major | minor] [ | {begin | exclude | include} expression]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show facility-alarm status command. It displays alarm information for the switch.
Switch> show facility-alarm statusSource Severity Description Relay TimeFastEthernet0/3 MINOR 2 Port Not Forwarding NONE Mar 011993 00:02:22Related Commands
show fcs-threshold
Use the show fcs-threshold user EXEC command to display the frame check sequence (FCS) bit error rate settings on the switch interfaces.
show fcs-threshold [ | {begin | exclude | include} expression]
Syntax Description
Command Modes
User EXEC
Command History
Usage Guidelines
The Ethernet standard calls for a maximum bit error rate of 10-8. In the Catalyst 2955 switch, the bit error rate configurable range is from 10-6 to 10-11. The bit error rate input to the switch is a positive exponent. The output displays the positive exponent; an output of 9 indicates that the bit error rate is 10-9.
Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output do not appear, but the lines that contain Output appear.
Examples
This is an example of output from the show fcs-threshold command. It shows the output when all ports are set to the default FCS threshold.
Switch# show fcs-thresholdPort FCS ThresholdFa0/1 8Fa0/2 8Fa0/3 8Fa0/4 8Fa0/5 8Fa0/6 8Fa0/7 8Fa0/8 8Fa0/9 8<output truncated>Related Commands
test relay
Use the test relay privileged EXEC command to turn on or off the relay circuitry.
test relay {major | minor} {on| off}
Caution
Command Modes
Privileged EXEC
Command History
Usage Guidelines
You can use the test relay privileged EXEC command to check relay circuitry connections to the alert devices. The command provides a way to test alarm scanners without having to create an alarm condition.
Examples
This example shows how to turn on the major relay circuitry:
Switch# test relay major onRelated Commands
