Catalyst 2950 and Catalyst 2955 Switch Command Reference, 12.1(14)EA1
Catalyst 2955 Alarm Commands
Downloads: This chapterpdf (PDF - 333.0KB) The complete bookPDF (PDF - 5.56MB) | Feedback

Catalyst 2955 Alarm Commands

Table Of Contents

Catalyst 2955 Alarm Commands

alarm facility fcs-hysteresis

alarm facility power-supply

alarm facility temperature

alarm profile (global configuration)

alarm profile (interface configuration)

fcs-threshold

power-supply dual

show alarm description port

show alarm profile

show alarm settings

show env

show facility-alarm relay

show facility-alarm status

show fcs-threshold

test relay


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

percentage

Hysteresis threshold fluctuation. The range is from 1 to 10 percent.


Defaults

The default threshold-value is 10 percent.

Command Modes

Global configuration

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 is displayed in the output of the show running-config privileged EXEC command.

Examples

The following example sets 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 5

Related Commands

Command
Description

fcs-threshold

Sets an FCS error rate for an interface.

show running-config

Displays the running configuration on the switch, including FCS hysteresis threshold if it is not set at the default. For syntax information, select Cisco IOS Configuration Fundamentals Command Reference for Release 12.1 > Cisco IOS File Management Commands > Configuration File 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

notifies

Send power supply alarm traps to a Simple Network Management Protocol (SNMP) server.

relay major

Send the alarm to the major relay circuitry.

relay minor

Send the alarm to the minor relay circuitry.

syslog

Send power supply alarm traps to a syslog server.


Defaults

A power supply alarm message is stored, but not sent to an SNMP server, relay, or syslog server.

Command Modes

Global configuration

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 command 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 sets the power-supply monitoring alarm to go to the minor relay circuitry.

Switch(config)# alarm facility power-supply relay minor 

Related Commands

Command
Description

power-supply dual

Sets the switch to operate in dual power-supply mode.

show alarm settings

Displays environmental alarm settings and options.

snmp-server enable traps

Enables the switch to send SNMP notification for various trap types to the network management system (NMS).


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

threshold

Set a lower high temperature threshold for the secondary temperature alarm in degrees C. The allowable range is 40 to 95oC.

notifies

Send primary or secondary temperature alarm traps to an SNMP server.

relay major

Send the primary or secondary temperature alarm to the major relay circuitry.

relay minor

Send the primary or secondary temperature alarm to the minor relay circuitry.

syslog

Send primary or secondary temperature alarm traps to a syslog server.


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

Release
Modification

12.1(12c)EA1

This command was first introduced.


Usage Guidelines

The primary temperature alarm is enabled automatically. 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 command 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 sets the secondary temperature with a high threshold value of 45 0C with alarms and traps sent to the minor relay circuitry, syslog, and an SNMP server.

Switch(config)# alarm facility temperature secondary 45
Switch(config)# alarm facility temperature secondary relay minor 
Switch(config)# alarm facility temperature secondary syslog
Switch(config)# alarm facility temperature secondary notifies

This example disables the secondary temperature alarm.

Switch(config)# no alarm facility temperature secondary 45

This example sets the primary temperature alarm with alarms and traps to go to syslog and the major relay circuitry.

Switch(config)# alarm facility temperature primary syslog 
Switch(config)# alarm facility temperature primary relay major

Related Commands

Command
Description

show alarm settings

Displays environmental alarm settings and options.

snmp-server enable traps

Enables the switch to send Simple Network Management Protocol (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

name

Alarm profile name


Defaults

No alarm profiles are created.

When a profile is created, none of the alarms are enabled.

Command Modes

Global configuration

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


Usage Guidelines

In alarm-profile configuration mode, these commands are available:

alarm alarm-id: enables the specified alarm.

exit: exits from alarm-profile configuration mode.

help: displays a description of the interactive help system.

no: negates or sets the default values of a command.

notifies alarm-id: enables notification for the alarm, which means sending an SNMP trap to an SNMP server.

relay-major alarm-id: enables sending the alarm to the major relay circuitry.

relay-minor alarm-id: enables sending the alarm to the minor relay circuitry.

syslog alarm-id: enables sending the alarm to a syslog file.

For alarm-id, you can enter one or more alarm IDS separated by a space.

Before you use the notifies command to send alarm traps to a Simple Network Management Protocol (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  

AlarmList ID
Alarm Description

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 creates the alarm profile fastE for a Fast Ethernet 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. In addition, these alarms will be sent to an SNMP server and written to the system log file (syslog).

Switch(config)# alarm profile fastE
Switch(config-alarm- prof)# alarm 1 2
Switch(config-alarm- prof)# relay major 2
Switch(config-alarm- prof)# relay minor 1
Switch(config-alarm- prof)# notifies 1 2
Switch(config-alarm- prof)# syslog 1 2

This example shows how to delete the alarm relay profile named my-profile.

Switch(config)# no alarm profile my-profile 

Related Commands

Command
Description

alarm profile (interface configuration)

Attaches an alarm profile to an interface.

show alarm profile

Displays all alarm profiles or a specified alarm profile and lists the interfaces to which each profile is attached.

snmp-server enable traps

Enables the switch to send Simple Network Management Protocol (SNMP) notification for various trap types to the network management system (NMS).


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

name

Alarm profile name


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

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 attaches an alarm profile named fastE to Fast Ethernet port 2.

Switch(config)# interface fastethernet 0/2
Switch(config-if)# alarm profile fastE 

This example detaches the alarm profile from Fast Ethernet port 2 and returns it to the defaultPort profile.

Switch(config)# interface fastethernet 0/2
Switch(config-if)# no alarm profile

Related Commands

Command
Description

alarm profile (global configuration)

Creates or identifies an alarm profile and enters alarm-profile configuration mode.

show alarm profile

Displays all alarm profiles or a specified alarm profile and lists the interfaces to which each profile is attached.


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

value

Value ranges from 6 to 11, representing a bit error rate from 10-6 to 10-11.


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

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 sets the FCS bit error rate for Fast Ethernet port 1 to 10-10.

Switch(config)# interface fastethernet0/1
Switch(config-if)# fcs-threshold 10

Related Commands

Command
Description

alarm facility fcs-hysteresis

Sets the FCS hysteresis threshold for the switch in a percentage of allowed fluctuation from the FCS bit error rate configured on a port.

show fcs-threshold

Displays the FCS error bit rate settings on each interface as positive exponents.


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 keywords or arguments.

Defaults

By default, the system operates in single-power mode.

Command Modes

Global configuration

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 monitor for a missing or failed primary power supply.

Examples

This example sets the switch in a dual power-supply mode.

Switch(config)# power-supply dual

Related Commands

Command
Description

alarm facility power-supply

Sets the switch to monitor for a missing or failed power supply and sets the alarm options.

show alarm settings

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

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This example shows the AlarmIDs and their respective alarm descriptions.

Switch> show alarm description port
  1        Link Fault
  2        Port Not Forwarding
  3        Port Not Operating
  4        FCS Error Rate exceeds threshold

Related Commands

Command
Description

alarm profile (global configuration)

Creates an alarm profile containing one or more alarm IDs and alarm options.

show alarm profile

Displays all alarm profiles or a specified alarm profile and lists the interfaces to which each profile is attached.


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

name

(Optional) Display only the profile with the specified name.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 are not displayed, but the lines that contain Output are displayed.

Examples

This example displays all ports that are attached to the configured profiles and defines the alarm options in the profile.

Switch> show alarm profile

alarm profile defaultPort:

Interfaces      FastEthernet0/2 FastEthernet0/3 FastEthernet0/4 FastEthern
et0/5 FastEthernet0/6 FastEthernet0/7 FastEthernet0/8 FastEthernet0/9 FastEthern
et0/10 FastEthernet0/11 FastEthernet0/12 GigabitEthernet0/1 GigabitEthernet0/2
      Alarms          3
      Syslog          3, 4
      Notifies        3
      Relay Major     1, 2
      Relay Minor     1, 4

alarm profile teresa:

      Interfaces      FastEthernet0/1
      Alarms          1, 2, 3, 4
      Syslog          2, 3, 4
      Notifies
      Relay Major     1
      Relay Minor

alarm profile test-profile:

      Interfaces
      Alarms
      Syslog
      Notifies
      Relay Major
      Relay Minor

Related Commands

Command
Description

alarm profile (global configuration)

Creates an alarm profile containing one or more alarm IDs and alarm options.

alarm profile (interface configuration)

Attaches an alarm profile to an interface.


show alarm settings

Use the show alarm settings user EXEC command to display all environmental alarm settings in the switch.

show alarm settings [ | {begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This example shows all the switch alarm settings that are on the switch:

Switch> show alarm settings
Power Supply
         Mode                    Single
         Alarm                   Disabled
         Relay                   MIN
         Notifies                Disabled
         Syslog                  Disabled
Temperature-Primary
         Alarm                   Enabled
         Thresholds              MAX: 95C                MIN:  -20C
         Relay                   MAJ
         Notifies                Enabled
         Syslog                  Enabled
Temperature-Secondary
         Alarm                   Disabled
         Threshold
         Relay
         Notifies                Disabled
         Syslog                  Disabled

Related Commands

Command
Description

alarm facility power-supply

Sets power supply alarm options.

alarm facility temperature

Sets temperature alarm options.

power-supply dual

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 This command is supported with different keywords on the Catalyst 2950 platform.


Syntax Description

all

Display power supply and temperature environmental status.

power

Display power supply environmental status.

temperature

Display temperature environmental status.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(5.2)WC(1)

This command was first 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 are not displayed, but the lines that contain Output are displayed.

Examples

This example shows the status of all power supplies on the switch.

Switch# show env power
Power supply A is present
Power supply B is present

This example shows temperature status on the switch.

Switch# show env temperature
Current temperature is 49C
Highest temperature was 53C Mar 04 1993 04:06:36

This example shows the status of all environmental facilities (power supply and temperature) on the switch.

Switch# show env all
Power supply A is present
Power supply B is present
Current temperature is 49C
Highest temperature was 53C Mar 04 1993 04:06:36

Related Commands

Command
Description

power-supply dual

Sets dual power-supply mode on the switch.


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

major

Display alarms associated with major relay.

minor

Display alarms associated with minor relay.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This example displays alarm information for the minor relays.

Switch> show facility-alarm relay minor
Source             Description                         Relay    Time
Switch             1 Temp above secondary thresh       MIN      Mar 01 1993 00:0 1:17

Related Commands

Command
Description

alarm facility power-supply

Sets power supply alarm options.

alarm facility temperature

Sets temperature alarm options.

alarm profile (global configuration)

Creates alarm profiles with alarm IDs and alarm options to be attached to interfaces.

show facility-alarm status

Display alarms generated on the switch.


show facility-alarm status

Use the show facility-alarm status user EXEC command to display all generated alarms in the switch.

show facility-alarm status [critical | info | major | minor] [ | {begin | exclude | include} expression]

Syntax Description

critical

(Optional) Display only critical facility alarms.

info

(Optional) Display all facility alarms.

major

(Optional) Display major facility alarms and higher.

minor

(Optional) Display major facility alarms and higher.

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.

Examples

This example displays alarm information for the switch.

Switch> show facility-alarm status 
Source             Severity Description                         Relay    Time
FastEthernet0/3    MINOR    2 Port Not Forwarding               NONE     Mar 01
1993 00:02:22 

Related Commands

Command
Description

alarm facility power-supply

Sets power supply alarm options.

alarm facility temperature

Sets temperature alarm options.

alarm profile (global configuration)

Creates alarm profiles with alarm IDs and alarm options to be attached to interfaces.

show facility-alarm relay

Displays alarm relays generated on the switch.


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

| begin

(Optional) Display begins with the line that matches the expression.

| exclude

(Optional) Display excludes lines that match the expression.

| include

(Optional) Display includes lines that match the specified expression.

expression

Expression in the output to use as a reference point.


Command Modes

User EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 are not displayed, but the lines that contain Output are displayed.

Examples

This example shows the output when all ports are set to the default FCS threshold.

Switch# show fcs-threshold
Port    FCS Threshold
Fa0/1           8
Fa0/2           8
Fa0/3           8
Fa0/4           8
Fa0/5           8
Fa0/6           8
Fa0/7           8
Fa0/8           8
Fa0/9           8
Fa0/10          8
Fa0/11          8
Fa0/12          8
Fa0/13          8
Fa0/14          8

Related Commands

Command
Description

fcs-threshold

Sets the FCS threshold on an interface.


test relay

Use the test relay privileged EXEC command to turn on or off the relay circuitry.

test relay {major | minor} {on| off}


Caution Using the test command alters the state (on or off) of a relay. Previous states are not saved.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(12c)EA1

This command was first introduced.


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 on

Related Commands

Command
Description

show alarm profile

Displays all alarm profiles or a specified alarm profile and lists the interfaces to which each profile is attached.

show alarm settings

Displays environmental alarm settings and options.

show facility-alarm relay

Displays alarm relays generated on the switch.