Contact Product Manager, with details of the application.

Transcription

1 Eaton Corporation Telecommunications Power Solutions Application Note AN0100 SC200 SNMP Traps Last updated 14 June 2011 Applicable products Audience Related documents For more information SC200 system controllers Eaton DC Product Channel Partners and Integrators SC200 System Controller Operation Handbook Application Note AN0066: Demonstrate SNMPc with SC200, SM45 and SM65 Application Note AN0119: Demonstrate HP OpenView with SC200 Application Note AN0115: Using SC200 with Spectrum NMS Contact Product Manager, with details of the application. Summary This application note provides detail on the SC200 alarm and trap operation. It is intended to assist Network Management System (NMS) operators to configure their system to operate with the SC200. SC200 alarm operation The SC200 generates alarms based on the following alarm origins: System Alarms The SC200 V3.10 supports 58 different system alarms. These are pre-defined alarms related to internal systems statuses, inputs and so on. New alarms are added at each new software release, according to customer demand. These are listed in the MIB: low-float(0), low-load(1), high-float(2), high-load(3), rectifier-fail(4), multiple-rectifier-fail(5), rectifier-comms-lost(6), multiple-rectifier-comms- Lost(7), partial-ac-fail(8), ac-fail(9), system-overload(10), lvd2-fail(20), lvd2-manual(21), battery-temperature-low(22), battery-temperature-high(23), sensor-fail(24), equalize(25), fast-charge(26), battery-test(27), auxiliary-sensor-fail(28), in-discharge(29), battery-current-limit(30), rectifier-no-load(31), ac-frequency(40), generator-enable(41), cabinet-fan-fail(42), unmapped-iob-found(43), unknown-hardware(44), missing-hardware(45), standby-mode(46), lvd1-characterization-error(47), lvd2-characterization-error(48), string-fail(49), generator-fail(50), lvd-disconnected(51), Page 1 of 6 Eaton, Powerware, Intergy, SiteSure, CellSure, DCTools and PowerManager are trade names, trademarks, and/or service marks of Eaton Corporation or its subsidiaries and affiliates. Other marks are the property of their respective owners. Eaton Corporation All rights reserved.

2 load-fuse-fail(11), battery-fuse-fail(12), battery-test-fail(13), mov-fail(14), acd-fan-fail(15), lvd1-disconnected(16), lvd1-fail(17), lvd1-manual(18), lvd2-disconnected(19), rectifier-current-limit(32), rectifier-over-temperature(33), ac-phase1-fail(34), ac-phase1-voltage(35), ac-phase2-fail(36), ac-phase2-voltage(37), ac-phase3-fail(38), ac-phase3-voltage(39), lvd-fail(52), lvd-manual(53), lvd-characterization-error(54), configuration-error(55), wrong-battery-polarity(56), characterizing-battery(57), do-manual(58) A description of each alarm is available from: The SC200 System Controller Operation Handbook SNMP MIB DCTools hover-help (hold the cursor on an item to see its description) Web hover-help (hold the cursor on an item to see its description). Analog Input High Alarms These are user defined alarms. They are produced when analog input goes above a configured threshold. Users can configure an Analog Input High alarm for any analog input that is enabled. Analog Input Low Alarms These are user defined alarms. They are produced when an analog input goes below a configured threshold. Users can configure an Analog Input Low alarm for any analog input that is enabled. Digital Input Alarms These are user defined alarms. They are produced when a digital input becomes The user can configure a Digital Input alarm for any enabled digital input. Smart Alarms (SC200 version 3 and later) Smart Alarms are user defined alarms. They are configured as a logical combination of other alarms, system values or timers. Page 2 of 6

3 Alarm Severity Any alarm can be configured to any of these severity settings: Severity Definition Normal use Disabled Warning Alarm is disabled. No notifications, log entry, or LED operation. A system event has occurred that is not an alarm. Turn off alarms that are not required. Notify and / or log a planned system process, such as Battery Test in Progress Minor A low priority alarm An alarm that does not require an urgent response, such as Low Float Major A high priority alarm An alarm that may require an urgent response, such as Low Load Critical A very high priority alarm An alarm that requires an immediate response. The SC200 alarms are configured with default alarm settings, including severity. However, these may be easily reconfigured. If required, a user can change settings to match the severity settings in their NMS. SC200 Trap Settings Below is a view from the SC200 web, showing the SNMP settings: Below is a description of each setting. Item name Definition (from MIB) Additional Notes SNMP Access Determines how SNMP access is allowed. Disabled no SNMP access All Any SNMP version Read Only SNMP set is not possible. V3 SNMP V3 is supported, but V1 is disabled. Read Community Community that can get items. Default Public Write Community Community that can set items. Default Private System Object ID Trap Version Used to form the return value for the SNMP MIB-2 sysobjectid. These numbers start with a specific enterprise ID (i.e for Eaton) and are preceded by to form an object ID for the system type. Indicates whether SNMP V1, V2c, or V3 trap will be sent. This is the last part of the sys-oid. It can be reconfigured to identify the power system type to a network manager. Default Trap Format Select Eaton for multiple trap numbers, or X.733 for a Refer to Trap Format below. Page 3 of 6

4 Item name Definition (from MIB) Additional Notes single trap number as per ITU X.733. Trap Repeat Trap Repeat Rate If enabled, alarm activation traps will be repeated according to Trap Repeat Rate. How often to send a trap to trap receivers if Enable Trap Repeat is Enabled or the trap receiver's Trap Receiver Mode is Acknowledged-Summary-Trap. Name Name used to identify this receiver. This is not used anywhere else Level When to send a trap to this receiver. The level setting is alarm severity. E.g. If this is set to Critical Alarms Only, then a trap will be sent to this IP address only when a critical alarm is activated. IP Address Port Trap Community Mode IP address to send SNMP notifications of events to. UDP port to send SNMP notifications of events to. Community to use for traps send to this address. Set to Normal traps to send normal traps to a Network Management System on alarm activation and deactivation. Set to Acknowledged Summary Traps to send summary traps to PowerManagerII. These traps are repeated until PowerManagerII receives the trap, connects to the Supervisory Module, and downloads alarms and data. Leave at Normal Traps for use with an NMS. Trap Format Traps can be sent in two formats, depending on the Trap Format setting. We recommend x.733 format for new applications, but Eaton format may be more appropriate for some network managers. X.733 trap format This conforms to ITU standard X.733. A single trap number (700) is used for all alarms. The source and severity of the alarm are indicated by variables within the traps: Variable Definition Additional Notes trap-alarm-number Alarm number as per the list above. trap-alarm-origin The type of alarm system-alarm(0), ai-high(1), ai-low(2), di(3), trap-alarm-name The alarm name trap-alarm-keep-severity Alarm severity critical(1), major(2), minor(3), warning(4), cleared(5) system-location site-name site-address trap-additional-text Page 4 of 6

5 Eaton trap format Different trap numbers are used for each alarm severity and source. See below for more details: Trap Trap name Definition from MIB Additional Notes 100 major-alarm-active A major alarm is 101 major-ai-high-active An analog input high major alarm is 102 major-ai-low-active An analog input low major alarm is 103 major-di-active A digital input major alarm is 200 minor-alarm-active A minor alarm is 201 minor-ai-high-active An analog input high minor alarm is 202 minor-ai-low-active An analog input low minor alarm is 203 minor-di-active A digital input minor alarm is 300 warning-alarm-active A warning is 301 warning-ai-high-active An analog input high warning is 302 warning-ai-low-active An analog input too low warning alarm is 303 warning-di-active A digital input warning is 400 alarm-inactive An alarm has become in This trap is sent if any system alarm that has been active (and is configured to have traps sent) becomes in 100, 200, 300 or ai-high-inactive An analog input high alarm has become in This trap is sent if any Analog Input High alarm that has been active (and is configured to have traps sent) becomes in 101, 201, 301, ai-low-inactive An analog input low alarm has become in This trap is sent if any Analog Input Low alarm that has been active (and is configured to have traps sent) becomes in 102, 202, 302, di-inactive A digital input alarm has become in This trap is sent if any Digital Input alarm that has been active (and is configured to have traps sent) becomes in 103, 203, 303, alarm-status-change The status of one or more alarms has changed. This trap is used only with PowerManagerII. If it receives this trap, it then polls the SC200 for its alarm status. 600 critical-alarm-active A critical alarm is Page 5 of 6

6 Trap Trap name Definition from MIB Additional Notes 101 critical -AI-High-Active An analog input high critical alarm is 102 critical -AI-Low-Active An analog input low critical alarm is 103 critical -DI-Active A digital input critical alarm is Additional Information To disable trap sending for specified alarms Connect to the SC200 using web or DCTools. Go to the alarm table. For any alarm that is not to cause a trap to be sent, untick Send Trap as per the following diagram. To set an NMS to detect when an alarm has become inactive Note: this assumes that Trap Format is set to x.733. See the description for Trap Format above, including the alarm variables. 1. When a trap is received with severity not equal to inactive, the NMS should record the following variables against this alarm: trap-alarm-number trap-alarm-origin trap-alarm-name trap-alarm-keep-severity The NMS should add this alarm to its active alarm list. 2. When any trap is received with severity equal to cleared, then these variables should be checked against all active alarms: trap-alarm-number trap-alarm-origin trap-alarm-name The active alarm that matches has become inactive and should be removed from the active alarm list. Notes: 1. Active alarms can also be checked by SNMP Get commands to each of the alarm tables. 2. For Eaton format traps, it will be necessary to match up the Alarm Inactive trap numbers with the corresponding Alarm Active trap numbers. Then the first variable (alarm index) needs to be matched up with the alarm index for the Alarm Active traps. Page 6 of 6