Sie sind auf Seite 1von 28

FIBEAIR IP-10 MIB REFERENCE GUIDE

Version 3.4 August 2009

Notice
This document contains information that is proprietary to Ceragon Networks Ltd. No part of this publication may be reproduced, modified, or distributed without prior written authorization of Ceragon Networks Ltd. This document is provided as is, without warranty of any kind.

Registered TradeMarks
Ceragon Networks is a registered trademark of Ceragon Networks Ltd. FibeAir is a registered trademark of Ceragon Networks Ltd. CeraView is a registered trademark of Ceragon Networks Ltd. Other names mentioned in this publication are owned by their respective holders.

TradeMarks
CeraMap , PolyView , EncryptAir , ConfigAir , CeraMon , EtherAir , and MicroWave Fiber , are trademarks of Ceragon Networks Ltd. Other names mentioned in this publication are owned by their respective holders.
TM TM TM TM TM TM TM

Statement of Conditions
The information contained in this document is subject to change without notice. Ceragon Networks Ltd. shall not be liable for errors contained herein or for incidental or consequential damage in connection with the furnishing, performance, or use of this document or equipment supplied with it.

Information to User
Any changes or modifications of equipment not expressly approved by the manufacturer could void the users authority to operate the equipment and the warranty for such equipment. Copyright 2009 by Ceragon Networks Ltd. All rights reserved.

Corporate Headquarters: Ceragon Networks Ltd. 24 Raoul Wallenberg St. Tel Aviv 69719, Israel Tel: 972-3-645-5733 Fax: 972-3-645-5499 Email: info@ceragon.com North American Headquarters: Ceragon Networks Inc. 10 Forest Avenue, Paramus, NJ 07652, USA Tel: 1-201-845-6955 Toll Free: 1-877-FIBEAIR Fax: 1-201-845-5665 Email: infous@ceragon.com

www.ceragon.com

European Headquarters: Ceragon Networks (UK) Ltd. 4 Oak Tree Park, Burnt Meadow Road North Moons Moat, Redditch, Worcestershire B98 9NZ, UK Tel: 44-(0)-1527-591900 Fax: 44-(0)-1527-591903 Email: infoeuro@ceragon.com APAC Headquarters Ceragon Networks (HK) Ltd. Singapore RO Level 34 Centennial Tower 3 Temasek Avenue Singapore 039190 Tel - + 65 6549 7886 Fax: +65 6549 7011

FibeAir IP-10 MIB Reference Guide

TABLE OF CONTENTS
CHAPTER 1: INTRODUCTION .........................................................................................4
About Ceragon MIB................................................................................................................... 4 About this Guide........................................................................................................................ 4 Terminology ............................................................................................................................... 5

CHAPTER 2: PRIVATE MIB STRUCTURE ............................................................................................ 6 MIB Top Level .............................................................................................................................. 6


genEquipUnit Section............................................................................................................................ 7 genEquipNetwork Section ..................................................................................................................... 8 genEquipFault Section .......................................................................................................................... 9 genEquipMng Section ......................................................................................................................... 12 genEquipRFU Section......................................................................................................................... 16 genEquipPM Section........................................................................................................................... 17

CHAPTER 3: COMMON TASKS............................................................................................................ 22 General Data .............................................................................................................................. 22


Standard MIB Information ................................................................................................................... 22

Current Alarms ........................................................................................................................... 24 Trap Processing ......................................................................................................................... 25


Trap Sending Configuration ................................................................................................................ 26 Trap Implementation ........................................................................................................................... 27

FibeAir IP-10 MIB Reference Guide

CHAPTER 1: INTRODUCTION
About Ceragon MIB
The Ceragon Networks MIB (Management Information Base) is a set of properties within the device to be managed. Every managed device keeps a database of values for each of the definitions written in the MIB that can be used by management applications to control FibeAir functions via either the SNMP-V1 or the SNMP-V3 protocols. The MIB is divided into public and private groups. The private group is owned by Ceragon Networks and supplements the public group. The Ceragon MIB supports the following public MIB standards: RFC-1213 (MIB II) RMON

About this Guide


This guide describes the Private Ceragon MIB for FibeAir IP-10 and the parts of the standard MIBs that Ceragon supports. The guide is divided into the following chapters:

Introduction: Provides a general background of the Ceragon MIB, and lists the terms used in this guide. Private MIB Structure: A brief explanation of the structure of the Private Ceragon MIB. Common Tasks: In this chapter, there is task-oriented detailed explanation, for example, customer that would like to access the unit Current Alarm table, should look in the Current Alarm section of this chapter. Notes: The Ceragon MIB is documented. This document does not replace the Ceragon MIB file, but complements it. Application developers should also get and inspect the latest version of Ceragon MIB file to have a complete and updated understanding on the issues that they want to access in the network element. This document only refers to the IP-10 series of Ceragon network.

FibeAir IP-10 MIB Reference Guide

Terminology
The following terms are used in this Guide. Term API IDU RFU MIB Application Programming Interface Indoor Unit Radio Frequency Unit A management information base (MIB) is a formal description of a set of network objects that can be managed using the Simple Network Management Protocol (SNMP). Network Management System Outdoor Unit MIB Object ID, a sequence of integers that uniquely identifies a managed object by defining a path to that object through a tree-like structure. Meaning

NMS ODU OID

FibeAir IP-10 MIB Reference Guide

CHAPTER 2: PRIVATE MIB STRUCTURE


MIB Top Level
The Private Ceragon MIB consists of a top level and six primary MIB sections, as follows:

Ceragon Private
genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM

Top level of the MIB. General API set of the unit. Contains API sets that define the network connections. Contains current alarm and traps configurations. Contains API sets for SW management. Contains API for the RFU unit. Contains PM information on various interfaces.

The top level and primary units are shown in the following figure.

Ceragon Private Ceragon Private

genEquipUnit genEquipUnit genEquipNetwork genEquipNetwork genEquipFault genEquipFault genEquipMng genEquipMng genEquipRFU genEquipRFU genEquipPM genEquipPM

The following chapters describe each of the primary MIB sections individually.

FibeAir IP-10 MIB Reference Guide

genEquipUnit Section
Ceragon Private Ceragon Private genEquipUnit genEquipNetwork genEquipUnit genEquipFault genEquipNetwork genEquipMng genEquipFault genEquipRFU genEquipMng genEquipPM genEquipRFU genEquipPM The genEquipUnitInfo section includes general system parameters. genEquipLastCfgTimeStamp R/O This parameter represents the configuration change counter. On every conf. change this counter is increased by 1. This parameter specifies the real time and date. Format: 'YYYY-MM-DD,HH:MM:SS' (Hexadecimal). This value indicates the generation time of the Performance Monitor file. The value is presented in time_t format. This value indicates the generation time of the inventory information file. The inventory file holds the configuration information of the unit. The value is presented in time_t format. This value enables the user to perform IDC HW reset using the SNMP protocol. genEquipUnitInfo genEquipUnitInfo

genEquipRealTimeandDate

R/W

genEquipPMGenTime

R/O

genEquipInvGenTime

R/O

genEquipOperation

R/W

genEquipMIBVersion

R/O

This value indicates the version of the MIB file loaded on the board.

genEquipUnitCLLI

R/W

This value represent a general purpose CLLIlike text field. This value represents the measurement system used by the system.

genEquipUnitMeasurementSystem

R/W

genEquipUnitIduTemperature

R/O

This value indicates the IDU temperature in the selected format.

FibeAir IP-10 MIB Reference Guide

genEquipNetwork Section

Ceragon Private Ceragon Private

genEquipUnit genEquipUnit genEquipNetwork genEquipNetwork genEquipFault genEquipFault genEquipMng genEquipMng genEquipRFU genEquipRFU genEquipPM genEquipPM

The genEquipNetwork section describes the network connection of the unit. genEquipNetworkRemoteIp genEquipNetworkMateIp genEquipNetworkAgentIp R/O R/O R/O This value indicates the Remote IP address. This value indicates the Mate IP address. This value indicates the Agent (self) IP address.

FibeAir IP-10 MIB Reference Guide

genEquipFault Section
The genEquipFault section is used for Fault management.

Ceragon Private

genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipUnit genEquipRFU genEquipNetwork genEquipPM genEquipFault genEquipMng genEquipRFU genEquipPM genEquipCurrentAlarm genEquipTrapCfgMgr genEquipCurrentAlarm genEquipTrapCfgMgr

Ceragon Private

The genEquipFault includes the following subtrees:

genEquipCurrentAlarm

Contains the current alarm table and the last change counter. Holds the trap management table.

genEquipTrapCfgMgr

FibeAir IP-10 MIB Reference Guide

genEquipCurrentAlarm Subsection
The following figure shows the genEquipCurrentAlarm subsection.

Ceragon Private

genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipUnit genEquipRFU genEquipNetwork genEquipPM genEquipFault genEquipMng genEquipRFU genEquipPM genEquipCurrentAlarm genEquipTrapCfgMgr genEquipCurrentAlarmTable genEquipCurrentAlarm genEquipTrapCfgMgr genEquipCurrentAlarmTable

Ceragon Private

genEquipCurrentAlarmLastChangeCounter

R/O

This counter is initialized with random number after reset, and incremented on each change in the CurrentAlarmTable This table presents all the currently open alarms. The table is described later in the document. Please note: on a RAISE condition, an alarm is added to the table and a RAISED trap is sent (if not filtered); On a CLEAR condition, the entry for that alarm is removed from the table and the CLEAR trap is sent.

genEquipCurrentAlarmTable

R/O

genEquipMostSevereAlarm

R/O

This value indicates the severity of the most severe alarm in the system.

For additional info on the Current Alarms Table data please refer to Section Current Alarms of this document.

FibeAir IP-10 MIB Reference Guide

10

genEquipTrapCfg Subsection
The following figure shows the genEquipTrapCfg subsection.

Ceragon Private

genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipUnit genEquipRFU genEquipNetwork genEquipPM genEquipFault genEquipMng genEquipRFU genEquipPM genEquipCurrentAlarm genEquipTrapCfgMgr genEquipTrapCfgMgrTable genEquipCurrentAlarm genEquipTrapCfgMgr genEquipTrapCfgMgrTable

Ceragon Private

genEquipTrapCfgMgrTable

This table contains the configuration parameters for the traps.

For additional info on the Trap Management Table data please refer to Section Trap Sending Configuration of this document.

FibeAir IP-10 MIB Reference Guide

11

genEquipMng Section
Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipUnit genEquipRFU genEquipNetwork genEquipPM genEquipFault genEquipMng genEquipRFU genEquipPM genEquipMngSw genEquipMngCfg genEquipMngSw genEquipMngCfg

Ceragon Private

The genEquipMng includes the following subtrees:

genEquipMngSw

Contains the Software management related parameters and commands. Contains the IDU configuration management related parameters and commands.

genEquipMngCfg

FibeAir IP-10 MIB Reference Guide

12

genEquipMngSw Subsection
The following figure shows the genEquipMngSw subsection.

Ceragon Private

genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipMngSw genEquipMngCfg

Ceragon Private

genEquipRFU genEquipUnit genEquipPM genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM

genEquipMngSw genEquipMngCfg

genEquipMngSwServerUrl

R/W

This value indicates the Remote SW Update Server URL, where SW updates reside. This value indicates the Remote server login. This value indicates the Remote server password. This value indicates the Proxy server URL. This value indicates the Proxy server login. This value indicates the Proxy server password. This value indicates the last Download software action status. This value indicates the last Install software action status.

genEquipMngSwServeLogin

R/W

genEquipMngSwServerPassword

R/W

genEquipMngSwProxyUrl genEquipMngSwProxyLogin

R/O R/O

genEquipMngSwProxyPassword

R/O

genEquipMngSwDownloadStatus

R/O

genEquipMngSwInstallStatus

R/O

Obsolete for MIB version 2.11 and above

FibeAir IP-10 MIB Reference Guide

13

genEquipMngSwCommand

R/W

Command for activating the download and upgrade of the SW. This value indicates the Package Version of the installed IDU SW. This value indicates the Package Version of the installed RFU SW.

genEquipMngSwInstalledIduVersion

R/O

genEquipMngSwInstalledRfuVersion

R/O

genEquipMngCfg Subsection
The following figure shows the genEquipMngCfg subsection.

Ceragon Private Ceragon Private

genEquipUnit genEquipUnit genEquipNetwork genEquipNetwork genEquipFault genEquipFault genEquipMng genEquipMng genEquipRFU genEquipRFU genEquipPM genEquipPM genEquipMngSw genEquipMngSw genEquipMngCfg genEquipMngCfg

genEquipMngCfgBackupStatus

R/O

This value indicates the last configuration backup action status. This value indicates the last configuration upload action status. This value indicates the last configuration download action status. This value indicates the last configuration restore action status. The command to be executed to backup/restore/load/store configuration.

genEquipMngCfgUploadStatus

R/O

genEquipMngCfgDownloadStatus

R/O

genEquipMngCfgRestoreStatus

R/O

genEquipMngSwCommand

R/W

The possible values for the activation of the genEquipMngSwCommand are: 1 2 3 4 5 backup download Upload Restore no-operation

FibeAir IP-10 MIB Reference Guide

14

The possible values for the resulting statuses of the genEquipMngSwCommand activation are: 0 1 2 3 Ready InProgress Success Failure

FibeAir IP-10 MIB Reference Guide

15

genEquipRFU Section
Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM genEquipRfuStatusTable genEquipRfuCfgTable genEquipRfuUploadTable The genEquipRFU holds the following tables: genEquipRfuStatusTable The table columns:
genEquipRfuStatusId genEquipRfuStatusIfIndex genEquipRfuStatusRxLevel genEquipRfuStatusTxLevel genEquipRfuStatusRadioBER genEquipRfuStatusTemperature genEquipRfuStatusRunningVersion

genEquipRfuStatusTable genEquipRfuCfgTable genEquipRfuUploadTable

This table contains the RFU Signal statuses data.

genEquipRfuCfgTable The table columns:


genEquipRfuCfgId genEquipRfuCfgIfIndex genEquipRfuCfgMaxTxLevel

This table contains the RFU configuration data.

FibeAir IP-10 MIB Reference Guide

16

genEquipRfuUploadTable The table columns:


genEquipRfuUploadId genEquipRfuUploadIfIndex

This table contains the RFU upload data.

genEquipRfuUploadSwCommand genEquipRfuUploadSwCommandStatus

genEquipPM Section
Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM genEquipPmRfu genEquipPmTraffic genEquipPmRfu genEquipPmTraffic

The genEquipPM includes the following subtrees:

genEquipPmRfu

Contains the performance monitoring tables for the RFU. Contains the performance monitoring tables for 17

genEquipPmTraffic FibeAir IP-10 MIB Reference Guide

the traffic in the system.

Note: All the PMs are represented in 4 tables: 15Min (15 minutes intervals for the last 24hour period), 15MinCurr(current (last) 15-minute interval), 24hr (up to 31 intervals of 24 hours each), and 24hrCurr (current (last) 24-hour interval).

FibeAir IP-10 MIB Reference Guide

18

genEquipPmRfu Subsection
The following figure shows the genEquipPmRfu subsection. Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM genEquipPmRfu genEquipPmTraffic genEquipPmRfuCommon genEquipPmRfu genEquipPmTraffic genEquipPmRfuCommon

This section holds the genEquipPmRfuCommon subsection, which in turn holds the 4 tables for the genEquipPmRfuCommonSL PM types. genEquipPmRfuCommonSL15minTable genEquipPmRfuCommonSL15minCurrTable genEquipPmRfuCommonSL24HrTable genEquipPmRfuCommonSL24HrCurrTable The table columns (presented for the 15min table, but are the same for all 4 tables):
genEquipPmRfuCommonSL15minId genEquipPmRfuCommonSL15minIfIndex genEquipPmRfuCommonSL15minTimeAndDate genEquipPmRfuCommonSL15minMinRsl genEquipPmRfuCommonSL15minMaxRsl genEquipPmRfuCommonSL15minRslExceed1 genEquipPmRfuCommonSL15minRslExceed2

FibeAir IP-10 MIB Reference Guide

19

genEquipPmRfuCommonSL15minMinTsl genEquipPmRfuCommonSL15minMaxTsl genEquipPmRfuCommonSL15minTslExceed genEquipPmRfuCommonSL15minIDF

FibeAir IP-10 MIB Reference Guide

20

genEquipPmTraffic Subsection
The following figure shows the genEquipPmTraffic subsection.

Ceragon Private Ceragon Private

genEquipUnit genEquipNetwork genEquipUnit genEquipFault genEquipNetwork genEquipMng genEquipFault genEquipRFU genEquipMng genEquipPM genEquipRFU genEquipPM genEquipPmRfu genEquipPmTraffic genEquipPmRfu genEquipPmTraffic

This subsection contains the Radio Aggregate PM table(s). genEquipPmTrafficRadioAgg15minTable genEquipPmTrafficRadioAgg15minCurrTable genEquipPmTrafficRadioAgg24HrTable genEquipPmTrafficRadioAgg24HrCurrTable The table columns (presented for the 15min table, but are the same for all 4 tables):
genEquipPmTrafficRadioAgg15minId genEquipPmTrafficRadioAgg15minIfIndex genEquipPmTrafficRadioAgg15minTimeAndDate genEquipPmTrafficRadioAgg15minES genEquipPmTrafficRadioAgg15minSES genEquipPmTrafficRadioAgg15minUAS genEquipPmTrafficRadioAgg15minBBE genEquipPmTrafficRadioAgg15minIDF

FibeAir IP-10 MIB Reference Guide

21

CHAPTER 3: COMMON TASKS


This chapter provides more thorough information on several common integration tasks that are done by Ceragon customers. The detailed tasks include: General Data Current Alarms Trap Processing

General Data Standard MIB Information


Some general info about the network element can be retrieved from the supported standard MIB (RFC1213-MIB): MIB Name sysDescr sysObjID sysUpTime sysContact sysName Access R/O R/O R/O R/W R/W Description Textual description of the network element A unique identifier that identifies the product type. The value for the IP-10 series object id is 1.3.6.1.4.1.2281.1.7.1: IP-10 The time (in hundredths of a second) since the network management portion of the system was last re-initialized. The textual identification of the contact person for this network element. An administratively-assigned name for the network element. By convention, this is the node's fully-qualified domain name. sysLocation R/W The physical location of this node network element.

FibeAir IP-10 MIB Reference Guide

22

Another imported supported standard MIB (RFC1213-MIB) is the ifTable MIB, this table defines the interfaces of the network element, important columns of the table are: MIB Name ifIndex Access R/O Description A unique value for each interface. This value is used in many places in Ceragon MIB, to associate data with the interface, one example is in the current alarm table, the value gnAgnCurrentAlarmIfIndex contains the ifIndex of the interface where the alarm occurred. A textual string containing information about the interface. The type of interface, distinguished according to the physical/link protocol(s) immediately `below' the network layer in the protocol stack. This entry can be used to enable/disable the interface. The current operational state of the interface (Up/Down).

ifDesc ifType

R/O R/O

ifAdminStatus ifOperStatus

R/W R/O

FibeAir IP-10 MIB Reference Guide

23

Current Alarms
The current alarm table contains all the alarms that are currently raised on the unit. This table presents the data about the alarms, in a slightly more detailed way than the information arriving in the traps from the agent on that alarms raise or clear. Thus, a monitoring system can use the Alarms Table as a way of synchronization. An application polling the alarm table should use the genEquipCurrentAlarmLastChangeCounter object (oid 1.3.6.1.4.1.2281.10.3.1.1) in the following manner: upon a polling action, this oid value be retrieved and stored; the polling of the table should only be made if this objects value differs between the polls. Note: the application must check for difference (if the retrieved value of the genEquipCurrentAlarmLastChangeCounter differs from the previous - then poll the table), as opposed to "less than", as it is not guaranteed that the genEquipCurrentAlarmLastChangeCounter will always increase in value, being started with a random value. Note: if an application only needs to know the network element topmost severity (e.g. so it can color the element icon on the application map), then that info can be retrieved from the variable genEquipMostSevereAlarm. The Ceragon Current Alarm table is a R/O table that contains the following entries: MIB Name genEquipCurrentAlarmCounter Description A running counter of open alarms, the counter is incremented on every new (Raised) alarm. It is cleared after reset. Timestamp of this alarm. This number is the seconds from midnight 1.1.1970. The time zone used is GMT. Alarm Id unique identifier of an alarm. The name of the alarm The instance of the alarm One of: Indeterminate, Warning, Minor, Major or Critical Interface index on which the alarm has occurred. Alarms that are not associated with a specific interface will have the value 65001 (IDC related alarms). The interface index is used to identify the interface as in the ifTable (See more info in the Standard MIB Information section). IDU or RFU An informative description of the alarm. The probable cause for the alarm. The corrective actions for the alarm. The state of the alarm (cleared or rasied). The slot originating the alarm. For the IP-10 is constant Zero.

genEquipCurrentAlarmRaisedTimeT genEquipCurrentAlarmId genEquipCurrentAlarmName genEquipCurrentAlarmInstance genEquipCurrentAlarmSeverity genEquipCurrentAlarmIfIndex

genEquipCurrentAlarmModule genEquipCurrentAlarmDesc genEquipCurrentAlarmProbableCause genEquipCurrentAlarmCorrectiveActions genEquipCurrentAlarmState genEquipCurrentAlarmSlotId

FibeAir IP-10 MIB Reference Guide

24

Trap Processing
General Description
When an alarm situation occurs in the unit, it sends a message to the managing station. This message is called a trap. The unit can be configured to send traps to up to four managers. It is possible to have different configuration for each of the managers, with different Ip, port and severity filters. The unit can be configured to send traps for just alarms, or just events or both. Note: Alarms have duration, and vary in severity (Indeterminate to Critical). Events do not have duration. The traps are sent in the same SNP protocol version, as the selected working version. Specifically, setting version = SNMPv3 will lead to the traps being sent in v3, with the SNMP security parameters as set for the agent.

FibeAir IP-10 MIB Reference Guide

25

Trap Sending Configuration


Using the genEquipTrapCfgMgrTable, it is possible to configure up to four manages, to which traps will be sent. It is also possible to define trap filters for each of the managers. Note that the trap community (the community that is sent with the trap) is common to all the managers (it is not possible to configure different trap community per manager). The entries of the genEquipTrapCfgMgrTable are (n represents the manager indices 1..4): MIB Name genEquipTrapCfgMgrId.n genEquipTrapCfgMgrAdmin.n genEquipTrapCfgMgrIP.n genEquipTrapCfgMgrPort.n Access R/O R/W R/W R/W Description This value indicates an index of the nth manager. This value indicates an administrative state of the nth manager. The (nth) managers IP address. The port number on which the manager will listen for incoming traps (default value is 162). The (nth) managers name. The (nth) managers trap community. A Bit-mask value filter allowing masking of traps according to their severity using the following logic: There is a bit for each severity. If the relevant bit is on (1), then the Agent will send traps with this severity; won't send otherwise. The list of bits from LSB to MSB: Bit 1 (LSB) - indeterminate Bit 2 - critical Bit 3 - major Bit 4 - minor Bit 5 - warning Bit 6 - cleared A filter allowing sending of only the traps that change the status of the system (i.e. only when most-severe changes). Common Language Location Identifier (maximum length 100 characters). This string is sent in a field in all the traps. genEquipTrapCfgOptionHeartbeatPeriod R/W The time interval in minutes between heartbeat traps. Value of 0 disables this feature.

genEquipTrapCfgMgrName.n genEquipTrapCfgMgrCommunity.n genEquipTrapCfgSeverityFilter.n

R/W R/W R/W

genEquipTrapCfgStatusChangeFilter.n

R/W

genEquipTrapCLLI

R/W

FibeAir IP-10 MIB Reference Guide

26

Trap Implementation Proprietary traps


In IP-10, there are 3 types of proprietary traps: TRAP TYPE Alarm trap Event trap Heartbeat trap SNMPv1 trap id 1001 1002 1003 SNMPv3 trap id oid 1.3.6.1.4.1.2281.11.1 oid 1.3.6.1.4.1.2281.11.2 oid 1.3.6.1.4.1.2281.11.3

Alarms (for any alarm id) are sent as a single trap type, which is composed of variables that are detailed in the table below. The variables in the trap carry most of the fields from the CurrentAlarm table and described in that section. The traps structure is the same for both SNMPv1 and SNMPv3 traps. The general (alarm) trap variables are: genEquipCurrentAlarmCounter genEquipCurrentAlarmRaisedTimeT genEquipCurrentAlarmId genEquipCurrentAlarmSlotId genEquipCurrentAlarmInstance genEquipCurrentAlarmSeverity genEquipCurrentAlarmIfIndex genEquipCurrentAlarmModule genEquipCurrentAlarmDesc genEquipMostSevereAlarm genEquipAgentIp genEquipCurrentAlarmState genEquipTrapCfgMgrCLLI

The event type traps have the exact same variable binds, except the genEquipCurrentAlarmState value that one is not relevant for events. The heartbeat type traps only carry the genEquipTrapCfgMgrCLLI variable. Traps may be used for updating the alarm status in northbound management systems. As noted above, the variables in the trap are the same as the in the current alarm table. In addition, the genEquipCurrentAlarmLastChangeCounter helps to determine periodically if another polling of the CurrentAlarms table is required or if the situation as presentedby using the incoming traps is accurate and up to date. The combination of genEquipCurrentAlarmId, genEquipCurrentAlarmInstance, genEquipCurrentAlarmIfIndex and genEquipCurrentAlarmSlotId values (all Integer values), serves as the unique key for making the correlation between the CurrentAlarm table values and the traps.

In order to be able to have backward compatibility with the old MIB and be able to receive traps from earlier IP-10 release (6.0) products, the old trap definition has been kept (trap id 1); However, from the current release on, the traps have structure as defined here.

FibeAir IP-10 MIB Reference Guide

27

Standard Traps
Standard generic traps are: coldStart, warmStart, linkDown, linkUp, authenticationFailure, egpNeighborLoss. In the current release, 5 of the 6 existing types are supported. EGP is not implemented and thus the 6th type is irrelevant. Cold Start

generated upon a HW reset of the system. Varbinds include:

enterpriseId

Warm Start

generated upon a SW reset of the system. Varbinds include:

enterpriseId

LinkDown

generated upon setting the Admin param to disable or in cases of erroneous behaviour. Varbinds include:

ifIndex ifAdminStatus ifOperStatus1 enterpriseId

LinkUp

generated upon setting the Admin param to enable or in cases of exiting erroneous situation in cases of enabled Admin. Varbinds include:
ifIndex ifAdminStatus ifOperStatus

AuthenticationFailure generated by the master agent in cases of wrong communitybased authentication.

Please note the definitions of ifOperStatus (and ifAdminStatus) in the standard traps are slightly different than how DMAE defines and uses them. Particularly, the MIB status parameters have additional states which DMAE doesnt support.

FibeAir IP-10 MIB Reference Guide

28

Das könnte Ihnen auch gefallen