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.

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
Alarm	Alarm name/raising event	Details string example	Clearing event	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	✓ ^¹	✓ ^¹	✓	✓ ^¹	✓	✓
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 hierarchies

Facility alarm configuration commands

config
    - system 
        - alarms
            - max-cleared maximum
            - [no] shutdown

Show commands

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

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

¹ ETR and non-ETR