Top Banner
FIBEAIR ® IP-10 MIB REFERENCE GUIDE Version 3.4 August 2009
28
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: MIB Ref Guide 3.4

FIBEAIR® IP-10 MIB

REFERENCE GUIDE

Version 3.4

August 2009

Page 2: MIB Ref Guide 3.4

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

Page 3: MIB Ref Guide 3.4

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

Page 4: MIB Ref Guide 3.4

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.

Page 5: MIB Ref Guide 3.4

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.

Page 6: MIB Ref Guide 3.4

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

Page 7: MIB Ref Guide 3.4

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

Page 8: MIB Ref Guide 3.4

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

Page 9: MIB Ref Guide 3.4

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

Page 10: MIB Ref Guide 3.4

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

Page 11: MIB Ref Guide 3.4

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

Page 12: MIB Ref Guide 3.4

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

Page 13: MIB Ref Guide 3.4

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

Page 14: MIB Ref Guide 3.4

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

Page 15: MIB Ref Guide 3.4

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

Page 16: MIB Ref Guide 3.4

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

Page 17: MIB Ref Guide 3.4

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

Page 18: MIB Ref Guide 3.4

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).

Page 19: MIB Ref Guide 3.4

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

Page 20: MIB Ref Guide 3.4

FibeAir® IP-10 MIB Reference Guide 20

genEquipPmRfuCommonSL15minMinTsl

genEquipPmRfuCommonSL15minMaxTsl

genEquipPmRfuCommonSL15minTslExceed

genEquipPmRfuCommonSL15minIDF

Page 21: MIB Ref Guide 3.4

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

Page 22: MIB Ref Guide 3.4

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.

Page 23: MIB Ref Guide 3.4

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).

Page 24: MIB Ref Guide 3.4

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.

Page 25: MIB Ref Guide 3.4

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.

Page 26: MIB Ref Guide 3.4

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.

Page 27: MIB Ref Guide 3.4

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.

Page 28: MIB Ref Guide 3.4

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.