FIBEAIR ® IP-10 MIB REFERENCE GUIDE Version 3.4 August 2009
Oct 24, 2014
FIBEAIR® IP-10 MIB
REFERENCE GUIDE
Version 3.4
August 2009
FibeAir® IP-10 MIB Reference Guide 2
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
CeraMapTM, PolyView
TM, EncryptAir
TM, ConfigAir
TM, CeraMon
TM, EtherAir
TM, and MicroWave Fiber
TM, are
trademarks of Ceragon Networks Ltd.
Other names mentioned in this publication are owned by their respective holders.
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 user’s 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: [email protected] 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: [email protected]
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: [email protected]
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 3
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 4
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 5
Terminology
The following terms are used in this Guide.
Term Meaning
API Application Programming Interface
IDU Indoor Unit
RFU Radio Frequency Unit
MIB 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).
NMS Network Management System
ODU Outdoor Unit
OID 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.
FibeAir® IP-10 MIB Reference Guide 6
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 Top level of the MIB.
genEquipUnit General API set of the unit.
genEquipNetwork Contains API sets that define the network connections.
genEquipFault Contains current alarm and traps configurations.
genEquipMng Contains API sets for SW management.
genEquipRFU Contains API for the RFU unit.
genEquipPM Contains PM information on various interfaces.
The top level and primary units are shown in the following figure.
The following chapters describe each of the primary MIB sections individually.
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
FibeAir® IP-10 MIB Reference Guide 7
genEquipUnit Section
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.
genEquipRealTimeandDate R/W This parameter specifies the real time and date. Format: 'YYYY-MM-DD,HH:MM:SS' (Hexadecimal).
genEquipPMGenTime R/O This value indicates the generation time of the Performance Monitor file. The value is presented in time_t format.
genEquipInvGenTime R/O 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.
genEquipOperation R/W This value enables the user to perform IDC HW reset using the SNMP protocol.
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 CLLI-like text field.
genEquipUnitMeasurementSystem R/W This value represents the measurement system used by the system.
genEquipUnitIduTemperature R/O This value indicates the IDU temperature in the selected format.
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipUnitInfo
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipUnitInfo
FibeAir® IP-10 MIB Reference Guide 8
genEquipNetwork Section
The genEquipNetwork section describes the network connection of the unit.
genEquipNetworkRemoteIp R/O This value indicates the Remote IP address.
genEquipNetworkMateIp R/O This value indicates the Mate IP address.
genEquipNetworkAgentIp R/O This value indicates the Agent (self) IP address.
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
FibeAir® IP-10 MIB Reference Guide 9
genEquipFault Section
The genEquipFault section is used for Fault management.
The genEquipFault includes the following subtrees:
genEquipCurrentAlarm Contains the current alarm table and the last change counter.
genEquipTrapCfgMgr Holds the trap management table.
genEquipCurrentAlarm
genEquipTrapCfgMgr
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipCurrentAlarm
genEquipTrapCfgMgr
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
FibeAir® IP-10 MIB Reference Guide 10
genEquipCurrentAlarm Subsection
The following figure shows the genEquipCurrentAlarm subsection.
genEquipCurrentAlarmLastChangeCounter R/O This counter is initialized with random number after reset, and incremented on each change in the CurrentAlarmTable
genEquipCurrentAlarmTable R/O 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.
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.
genEquipCurrentAlarm
genEquipTrapCfgMgr
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipCurrentAlarmTable
genEquipCurrentAlarm
genEquipTrapCfgMgr
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipCurrentAlarmTable
FibeAir® IP-10 MIB Reference Guide 11
genEquipTrapCfg Subsection
The following figure shows the genEquipTrapCfg subsection.
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.
genEquipTrapCfgMgrTable
genEquipCurrentAlarm
genEquipTrapCfgMgr
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipTrapCfgMgrTable
genEquipCurrentAlarm
genEquipTrapCfgMgr
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
FibeAir® IP-10 MIB Reference Guide 12
genEquipMng Section
The genEquipMng includes the following subtrees:
genEquipMngSw Contains the Software management related parameters and commands.
genEquipMngCfg Contains the IDU configuration management related parameters and commands.
genEquipMngSw
genEquipMngCfg
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipMngSw
genEquipMngCfg
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
FibeAir® IP-10 MIB Reference Guide 13
genEquipMngSw Subsection
The following figure shows the genEquipMngSw subsection.
genEquipMngSwServerUrl R/W This value indicates the Remote SW Update Server URL, where SW updates reside.
genEquipMngSwServeLogin R/W This value indicates the Remote server login.
genEquipMngSwServerPassword R/W This value indicates the Remote server password.
genEquipMngSwProxyUrl∗∗∗∗ R/O This value indicates the Proxy server URL.
genEquipMngSwProxyLogin∗∗∗∗ R/O This value indicates the Proxy server login.
genEquipMngSwProxyPassword∗∗∗∗ R/O This value indicates the Proxy server password.
genEquipMngSwDownloadStatus R/O This value indicates the last Download software action status.
genEquipMngSwInstallStatus R/O This value indicates the last Install software action status.
∗∗∗∗ Obsolete for MIB version 2.11 and above
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipMngSw
genEquipMngCfg
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipMngSw
genEquipMngCfg
FibeAir® IP-10 MIB Reference Guide 14
genEquipMngSwCommand R/W Command for activating the download and upgrade of the SW.
genEquipMngSwInstalledIduVersion R/O This value indicates the Package Version of the installed IDU SW.
genEquipMngSwInstalledRfuVersion R/O This value indicates the Package Version of the installed RFU SW.
genEquipMngCfg Subsection
The following figure shows the genEquipMngCfg subsection.
genEquipMngCfgBackupStatus R/O This value indicates the last configuration backup action status.
genEquipMngCfgUploadStatus R/O This value indicates the last configuration upload action status.
genEquipMngCfgDownloadStatus R/O This value indicates the last configuration download action status.
genEquipMngCfgRestoreStatus R/O This value indicates the last configuration restore action status.
genEquipMngSwCommand R/W The command to be executed to backup/restore/load/store configuration.
The possible values for the activation of the genEquipMngSwCommand are:
1 backup
2 download
3 Upload
4 Restore
5 no-operation
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipMngSw
genEquipMngCfg
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipMngSw
genEquipMngCfg
FibeAir® IP-10 MIB Reference Guide 15
The possible values for the resulting statuses of the genEquipMngSwCommand activation are:
0 Ready
1 InProgress
2 Success
3 Failure
FibeAir® IP-10 MIB Reference Guide 16
genEquipRFU Section
The genEquipRFU holds the following tables:
genEquipRfuStatusTable This table contains the RFU Signal statuses data.
The table columns:
genEquipRfuStatusId
genEquipRfuStatusIfIndex
genEquipRfuStatusRxLevel
genEquipRfuStatusTxLevel
genEquipRfuStatusRadioBER
genEquipRfuStatusTemperature
genEquipRfuStatusRunningVersion
genEquipRfuCfgTable This table contains the RFU configuration data.
The table columns:
genEquipRfuCfgId
genEquipRfuCfgIfIndex
genEquipRfuCfgMaxTxLevel
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipRfuStatusTable
genEquipRfuCfgTable
genEquipRfuUploadTable
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM
genEquipRfuStatusTable
genEquipRfuCfgTable
genEquipRfuUploadTable
FibeAir® IP-10 MIB Reference Guide 17
genEquipRfuUploadTable This table contains the RFU upload data.
The table columns:
genEquipRfuUploadId
genEquipRfuUploadIfIndex
genEquipRfuUploadSwCommand
genEquipRfuUploadSwCommandStatus
genEquipPM Section
The genEquipPM includes the following subtrees:
genEquipPmRfu Contains the performance monitoring tables for the RFU.
genEquipPmTraffic Contains the performance monitoring tables for
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM genEquipPmRfu
genEquipPmTraffic
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM genEquipPmRfu
genEquipPmTraffic
FibeAir® IP-10 MIB Reference Guide 18
the traffic in the system.
Note: All the PMs are represented in 4 tables: 15Min (15 minutes intervals for the last 24-hour 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 19
genEquipPmRfu Subsection
The following figure shows the genEquipPmRfu subsection.
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
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM genEquipPmRfu
genEquipPmTraffic
genEquipPmRfuCommon
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM genEquipPmRfu
genEquipPmTraffic
genEquipPmRfuCommon
FibeAir® IP-10 MIB Reference Guide 20
genEquipPmRfuCommonSL15minMinTsl
genEquipPmRfuCommonSL15minMaxTsl
genEquipPmRfuCommonSL15minTslExceed
genEquipPmRfuCommonSL15minIDF
FibeAir® IP-10 MIB Reference Guide 21
genEquipPmTraffic Subsection
The following figure shows the genEquipPmTraffic subsection.
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
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM genEquipPmRfu
genEquipPmTraffic
Ceragon Private
genEquipUnit
genEquipNetwork
genEquipFault
genEquipMng
genEquipRFU
genEquipPM genEquipPmRfu
genEquipPmTraffic
FibeAir® IP-10 MIB Reference Guide 22
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
Access Description
sysDescr R/O Textual description of the network element
sysObjID R/O � 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
sysUpTime R/O The time (in hundredths of a second) since the network management portion of the system was last re-initialized.
sysContact R/W The textual identification of the contact person for this network element.
sysName R/W 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 23
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 Access Description
ifIndex R/O 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.
ifDesc R/O A textual string containing information about the interface.
ifType R/O The type of interface, distinguished according to the physical/link protocol(s) immediately `below' the network layer in the protocol stack.
ifAdminStatus R/W This entry can be used to enable/disable the interface.
ifOperStatus R/O The current operational state of the interface (Up/Down).
FibeAir® IP-10 MIB Reference Guide 24
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 alarm’s “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 object’s 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 Description
genEquipCurrentAlarmCounter A running counter of “open” alarms, the counter is incremented on every new (Raised) alarm.
It is cleared after reset.
genEquipCurrentAlarmRaisedTimeT
Timestamp of this alarm. This number is the seconds from midnight 1.1.1970. The time zone used is GMT.
genEquipCurrentAlarmId Alarm Id – unique identifier of an alarm. genEquipCurrentAlarmName The name of the alarm genEquipCurrentAlarmInstance The instance of the alarm genEquipCurrentAlarmSeverity
One of: Indeterminate, Warning, Minor, Major or Critical
genEquipCurrentAlarmIfIndex
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).
genEquipCurrentAlarmModule
IDU or RFU
genEquipCurrentAlarmDesc An informative description of the alarm.
genEquipCurrentAlarmProbableCause The probable cause for the alarm. genEquipCurrentAlarmCorrectiveActions
The corrective actions for the alarm.
genEquipCurrentAlarmState
The state of the alarm (cleared or rasied).
genEquipCurrentAlarmSlotId
The slot originating the alarm. For the IP-10 is constant Zero.
FibeAir® IP-10 MIB Reference Guide 25
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 26
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 Access Description
genEquipTrapCfgMgrId.n R/O This value indicates an index of the nth manager.
genEquipTrapCfgMgrAdmin.n R/W This value indicates an administrative state of the nth manager.
genEquipTrapCfgMgrIP.n R/W The (nth) manager’s IP address.
genEquipTrapCfgMgrPort.n R/W The port number on which the manager will listen for incoming traps (default value is 162).
genEquipTrapCfgMgrName.n R/W The (nth) manager’s name.
genEquipTrapCfgMgrCommunity.n R/W The (nth) manager’s trap community.
genEquipTrapCfgSeverityFilter.n R/W 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
genEquipTrapCfgStatusChangeFilter.n R/W A filter allowing sending of only the traps that change the status of the system (i.e. only when most-severe changes).
genEquipTrapCLLI R/W 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.
FibeAir® IP-10 MIB Reference Guide 27
Trap Implementation
Proprietary traps
In IP-10, there are 3 types of proprietary traps:
TRAP TYPE SNMPv1 trap id SNMPv3 trap id
Alarm trap 1001 oid 1.3.6.1.4.1.2281.11.1
Event trap 1002 oid 1.3.6.1.4.1.2281.11.2
Heartbeat trap 1003 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 28
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 community-based authentication.
1 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 doesn’t support.