Facility alarms

This chapter provides information about configuring facility alarms.

Facility alarms overview

Facility Alarms provide a useful tool for operators to easily track and display the basic status of their equipment facilities.

CLI display (show routines) allows the system operator to easily identify current facility alarm conditions and recently cleared alarms without searching event logs or monitoring various card and port show commands to determine the health of managed objects in the system such as cards and ports.

The 7210 SAS alarm model is based on RFC 3877, Alarm Management Information Base (MIB), (which evolved from the IETF DISMAN drafts).

Facility alarms vs. log events

Facility Alarms are different from log events. Events are a single point in time and are generally stateless. Facility Alarms have a state (at least two states: active and clear) and duration and can be modeled with state transition events (raised, cleared).

The Facility Alarms module processes log events to generate the raised and cleared state for the alarms. If a raising log event is suppressed under event-control, then the associated alarm will not be raised. If a clearing log event is suppressed under event-control, then it is still processed for the purpose of clearing the associated alarm. Log event filtering, throttling and discarding of events during overload do not affect Facility Alarm processing. Log events are processed by the Facility Alarm module before they are discarded in all cases.

The following figure shows the relationship of log events, alarms and the LEDs.

Figure 1. Log events, alarms and LEDs
Note:

On platforms that do not support Critical, Major, and Minor LED and Alarm output pins, an event is raised and only a log is generated.

Facility Alarms are different and have independent functionality from other uses of the term "alarm", such as:

  • configure port ethernet report-alarm

  • configure system thresholds no memory-use-alarm

  • configure system thresholds rmon no alarm

Facility alarm severities and Alarm LED behavior

The Alarm LEDs on the CPM/CCM reflects the current status of the Facility Alarms:

  • The Critical Alarm LED (if available on the 7210 SAS platform), is lit if there is 1 or more active Critical Facility Alarms.

  • Similarly with the Major and Minor alarm LEDs (if available on the 7210 SAS platform).

  • The OT Alarm LED (if available on the 7210 SAS platform), is not controlled by the Facility Alarm module.

The supported alarm severities are as follows:

  • Critical (with an associated LED

  • Major (with an associated LED

  • Minor (with an associated LED

  • Warning (no LED)

Alarms inherit their severity from the raising event.

Log events that are a raising event for a facility alarm configured with a severity of "indeterminate" or "cleared" will result in those alarms not being raised (but clearing events are processed to clear alarms regardless of the severity of the clearing event).

Changing the severity of a raising event only affects subsequent occurrences of that event and alarms. Alarms that are already raised when their raising event severity is changed maintain their original severity.

Facility alarm hierarchy

Facility Alarms for children objects is not raised for failure of a parent object. For example, when port fails (or is shut down) there is not a set of port alarms raised.

When a parent alarm is cleared, children alarms that are still in occurrence on the node appears in the active alarms list. For example, when a port fails there is a port alarm, but if the port is later shut down the port alarm is cleared (and a card alarm will be active). If the card comes back into service, and the port is still down, then a port alarm becomes active once again.

The supported Facility Alarm hierarchy is as follows (parent objects that are down cause alarms in all children to be masked):

  • CPM -> Compact Flash

  • IOM/IMM -> MDA -> Port -> Channel

A masked alarm is not the same as a cleared alarm. The cleared alarm queue does not display entries for previously raised alarms that are currently masked. If the masking event goes away, then the previously raised alarms will once again be visible in the active alarm queue.

Facility alarm list

The following tables list the supported Facility Alarms.

Table 1. 7210 SAS supported facility alarms
Alarm Alarm name/raising event Details string example Clearing event 7210 SAS platforms
7210 SAS-T 7210 SAS-Mxp 7210 SAS-R6 and 7210 SAS-R12 7210 SAS-Sx 1/10GE 7210 SAS-S 1/10GE 7210 SAS-Sx 10/100GE

7-2001-1

tmnxEqCardFailure

Class MDA Module: failed, reason: MDA 1 failed startup tests

tmnxChassisNotificationClear

7-2003-1

tmnxEqCardRemoved

Class CPM Module: removed

tmnxEqCardInserted

7-2004-1

tmnxEqWrongCard

Class IOM Module: wrong type inserted

tmnxChassisNotificationClear

7-2005-1

tmnxEnvTempTooHigh

Chassis 1: temperature too high

tmnxChassisNotificationClear

7-2006-1

tmnxEqFanFailure

Fan 1 failed

tmnxChassisNotificationClear

7-2007-1

tmnxEqPowerSupplyFailureOvt

Power supply 2 over temperature

tmnxChassisNotificationClear

7-2008-1

tmnxEqPowerSupplyFailureAc

Power supply 1 AC failure

tmnxChassisNotificationClear

7-2009-1

tmnxEqPowerSupplyFailureDc

Power supply 2 DC failure

tmnxChassisNotificationClear

7-2011-1

tmnxEqPowerSupplyRemoved

Power supply 1, power lost

tmnxEqPowerSupplyInserted

1

1

1

7-2017-1

tmnxEqSyncIfTimingHoldover

Synchronous Timing interface in holdover state

tmnxEqSyncIfTimingHoldoverClear

7-2019-1

tmnxEqSyncIfTimingRef1Alarm

with attribute tmnxSyncIfTimingNotifyAlarm == 'los(1)'

Synchronous Timing interface, alarm los on reference 1

tmnxEqSyncIfTimingRef1AlarmClear

7-2019-2

tmnxEqSyncIfTimingRef1Alarm with attribute tmnxSyncIfTimingNotifyAlarm == 'oof(2)'

Synchronous Timing interface, alarm of on reference 1

same as 7-2019-1

7-2019-3

tmnxEqSyncIfTimingRef1Alarm with attribute tmnxSyncIfTimingNotifyAlarm == 'oopir(3)'

Synchronous Timing interface, alarm oopir on reference 1

same as 7-2019-1

7-2021-x

same as 7-2019-x but for ref2

same as 7-2019-x but for ref2

same as 7-2019-x but for ref2

7-2030-x

same as 7-2019-x but for the BITS1 input

same as 7-2019-x but for the BITS1 input

same as 7-2019-x but for the BITS1 input

7-2033-1

tmnxChassisUpgradeInProgress

Class CPM Module: software upgrade in progress

tmnxChassisUpgradeComplete

7-2050-1

tmnxEqPowerSupplyFailureInput

Power supply 1 input failure

tmnxChassisNotificationClear

7-2051-1

tmnxEqPowerSupplyFailureOutput

Power supply 1 output failure

tmnxChassisNotificationClear

7-2073-x

same as 7-2019-x but for the BITS2 input

same as 7-2019-x but for the BITS2 input

same as 7-2019-x but for the BITS2 input

3-2004-1

linkDown

Interface intf-towards-node-B22 is not operational

linkUp

The linkDown Facility Alarm is supported for the following objects:

Table 2. linkDown Facility Alarm support
Object Alarm support

Ethernet Ports

Yes

Ethernet LAGs

No

Ethernet VLANs

No

Configuring logging with CLI

This section provides information to configure logging using the command line interface.

Basic facility alarm configuration

The most basic facility alarm configuration must have the following:

  • log ID or accounting policy ID

  • a log source

  • a log destination

Alarm configuration output

*7210SAS>config>system>alarms# info detail
----------------------------------------------
            no shutdown
            exit
----------------------------------------------
*7210SAS>config>system>alarms#

Common configuration tasks

The following sections are basic alarm tasks that can be performed.

Configuring the maximum number of alarms to clear

The number of alarms to clear can be configured using the command below.

Use the following syntax to configure a log file.

config>system
        alarms
            max-cleared max-alarms
Facility alarm configuration output
ALA-12>config>system# alarms
----------------------------------------------
...
max-cleared 500
exit
...
----------------------------------------------

Facility alarms command reference

Command descriptions

Configuration commands

alarms
Syntax

alarms

Context

config>system

Platforms

Supported on all 7210 SAS platforms as described in this document, including those configured in the access-uplink operating mode.

Description

Commands in this context configure facility alarm parameters.

max-cleared
Syntax

max-cleared maximum

Context

config>system>alarms

Platforms

Supported on all 7210 SAS platforms as described in this document, including those configured in the access-uplink operating mode

Description

This command configures the maximum number of cleared alarms that the system will store and display.

Default

500

Parameters
maximum

Specifies the maximum number of cleared alarms.

Values

0 to 500

shutdown
Syntax

[no] shutdown

Context

config>system>alarms

Platforms

Supported on all 7210 SAS platforms as described in this document, including those configured in the access-uplink operating mode

Description

This command enables or disables the facility alarm functionality. When enabled, the facility alarm sub-system tracks active and cleared facility alarms and controls the alarm LEDs on the CPMs and CFMs. When facility alarm functionality is enabled, the alarms are viewed using the show system alarms commands.

Note:

Shutting down the system alarms clears all existing alarms (raised and cleared). Performing no shutdown will not bring back the earlier raised alarm.

Default

no shutdown

Show commands

alarms
Syntax

alarms [cleared] [severity severity-level] [count count] [newer-than days]

Context

show>system

Platforms

Supported on all 7210 SAS platforms as described in this document, including those configured in the access-uplink operating mode

Description

This command displays facility alarms on the system.

Parameters
cleared

Displays the cleared alarm queue.

severity-level

Specifies the severity level of the alarm.

Values

critical | major | minor | warning

days

Displays alarms that are newer than the number of days specified.

Values

1 to 365

Output

The following output is an example of facility alarm information, and Output fields: alarms describes the output fields.

Sample output
*A:7210SAS# show system alarms 

===============================================================================
Alarms [Critical:1 Major:2 Minor:0 Warning:0 Total:3]
===============================================================================
Index      Date/Time               Severity     Alarm         Resource
   Details
-------------------------------------------------------------------------------
13 2014/11/13 14:34:39.20 MAJOR 7-2005-1 Chassis 1
   Chassis: Temperature too high

12 2014/11/13 14:34:13.70 MAJOR 7-3002-1 Alarm Input Module 2
   Alarm Input "Pin 2" ("2") has changed status to "alarm" 
"Alarm Input
   Triggered"

11 2014/11/13 14:32:37.00 CRITICAL 7-3001-1 Alarm Input Module 1
   Alarm Input "Pin 1" ("1") has changed status to "alarm" 
"Alarm Input
   Triggered"
===============================================================================
*A:7210SAS# 

Cleared alarms table:

A:Dut-A# show system alarms cleared

===============================================================================
Cleared Alarms [Size:500 Total:5 (not wrapped)]
===============================================================================
Index      Date/Time               Severity     Alarm         Resource
   Details
-------------------------------------------------------------------------------
5          2011/04/01 18:11:55.00  MAJOR        7-2005-1      Chassis 1
   Clear Chassis temperature too high alarm

3          2011/04/01 18:11:54.50  CRITICAL     7-2051-1      Power Supply 1
   Clear Power Supply failure

2          2011/04/01 18:11:54.40  CRITICAL     7-2050-1      Power Supply 1
   Clear Power Supply failure

4          2011/04/01 18:11:54.10  MINOR        7-2004-1      Fan 1
   Clear Fan wrong type failure

1          2011/04/01 18:11:54.00  CRITICAL     7-2007-1      Power Supply 1
   Clear Power Supply failure
===============================================================================
Table 3. Output fields: alarms
Label Description

Index

Displays the alarm index number

Date/Time

Displays the date and time string for the alarm

Severity

Displays the severity level of the alarm

Alarm

Displays the alarm identifier

Resource

Displays the facility associated with the alarm

Details

Displays the description of the alarm

1 ETR and non-ETR