IP10 MIB Reference
IP10 MIB Reference
MIB
Reference Guide
Version 2.0
January 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
CeraMapTM, PolyViewTM, EncryptAirTM, ConfigAirTM, CeraMonTM, EtherAirTM, and MicroWave FiberTM, 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.
Terminology..................................................................................................................................................... 5
gnEquipUnit Section........................................................................................................................................ 7
● RMON
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.
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 new generation of Ceragon network elements which are
based on the FibeAir® Family (FibeAir 1500P, 640P, 3200T, and others).
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.
The top level and primary units are shown in the following figure.
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault
gnEquipMng
The following chapters describe each of the primary MIB sections individually.
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault
gnEquipMng
genEquipRealTimeandDate This parameter specifies the real time and date Format 'YYYY-
MM-DD,HH:MM:SS' (Hexadecimal).
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault
gnEquipMng
gnEquipFault Section
The gnEquipFault section uses for Fault management.
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault CurrentAlarm
gnEquipMng TrapCfg
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault CurrentAlarm
gnEquipMng TrapCfg
genEquipCurrentAlarmTable This table contains the current alarms of the unit. The fields
of this table are described in the "common task" section.
gnEquipTrapCfg Subsection
The following figure shows the gnEquipTrapCfg subsection.
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault CurrentAlarm
TrapCfgMgr
genEquipTrapCfgMgrTable This table contains the configurations for the traps (manager
IP and filters).
Ceragon gnEquipUnit
Private
gnEquipNetwork
gnEquipFault
gnEquipMng gnEquipMngSw
General Data
sysObjID R/O A unique identifier that identifies the product type, current possible
values are:
1.3.6.1.4.1.2281.1.1: FA 1500 Regenerator
1.3.6.1.4.1.2281.1.2: FA 1500 Access
1.3.6.1.4.1.2281.1.3: FA 1500A
1.3.6.1.4.1.2281.1.5: FA 1500AL
1.3.6.1.4.1.2281.1.4: FA 1500P
1.3.6.1.4.1.2281.1.4.1: FA 1500P – Diversity
1.3.6.1.4.1.2281.1.4.2: FA 640
1.3.6.1.4.1.2281.1.4.3: FA 3200T using 1500P cards
1.3.6.1.4.1.2281.1.6.1: FA 3200T
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.
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.
Current Alarms
The current alarm table contains all the currently unit open alarm (i.e., raised alarms). This table
contain most of the fields that are sent in the trap when the alarm situation occurred, thus a
system that is monitors the traps, may use the current alarms table for Alarm Synchronization.
An application that pulls the alarm table should use the MIB
genEquipCurrentAlarmLastChangeCounter. Whenever application pulls the table, it should store
also the value of this MIB, and do the next poll only if this value differs from the value of this MIB
variable in the last poll.
Note that the application must use "differ" (if stored value is different then
genEquipCurrentAlarmLastChangeCounter then do poll) and not "less than", as it is not guaranteed
that the genEquipCurrentAlarmLastChangeCounter will always increase in value.
Note that if an application only needs to know the network element topmost severity (e.g. so it
color the element icon on the application map), than that info can be retrieved from the variable
genEquipMostSevereAlarm.
genEquipTrapCfgStatusChangeFilter.n R/W When enabled send traps only when the status of
the system changes (i.e. only when most-severe
changes).
Trap Format:
In IP-10 all alarms are sent in one trap which is composed of variables that are detailed in the
table below. The variables in the trap are the same as those described in the current alarm section.
The variables include:
• genEquipCurrentAlarmCounter
• genEquipCurrentAlarmRaisedTimeT
• genEquipCurrentAlarmId
• genEquipCurrentAlarmName
• genEquipCurrentAlarmInstance
• genEquipCurrentAlarmSeverity
• genEquipCurrentAlarmIfIndex
• genEquipCurrentAlarmModule
• genEquipCurrentAlarmDesc
• genEquipCurrentAlarmProbableCause
• genEquipCurrentAlarmCorrectiveActions
• genEquipCurrentAlarmState
Traps may be used for updating the alarm status in northbound management systems. That way
the variables in the trap are the same as the in the current alarm table. In addition as mentioned
above the genEquipCurrentAlarmLastChangeCounter helps to determine periodically if another pull
of the current alarm is required or if the alarm picture as the drwan by the trap is up to date.
For making the correlation between the current alarm and the traps the trap as "unique key" which
separate it from other alarms. The "unique key" of the trap is the combination of these three
variables: genEquipCurrentAlarmId, genEquipCurrentAlarmName and
genEquipCurrentAlarmInstance.
In the next release of IP-10 (2.x.x), we will change the name field to contain the "full tree path" of
the alarm. This means that this variable (genEquipCurrentAlarmName) can be treated as the
unique key without the need to use the other two variables.
nmsCurrentAlarmIfIndex R/O Interface index where the alarm occurred, alarms that
are not associated with specific interface will have the
following value:
For IDC related alarms the value is: 65001
For drawer1 related alarms the value is: 65003
For drawer2 related alarms the value is: 65004
The interface index is used to identify the interface in
the ifTable (See more info in the “Standard MIB
Information” section).
For FA 3200T systems, the value for alarms that are
associated with an a carrier and not specific interface,
it will be 65000 + the alarm origin.
nmsCurrentAlarmOrigin R/O The origin drawer of the alarm, for 1500P systems, one
of:
IDC (2)
Drawer #1 (3)
Drawer #2 (4)
Unknown (5)
nmsCurrentAlarmTrapID R/O The trap ID of the trap that was sent when the alarm
occurred, this is important for systems that implement
Alarm Synchronization, and want to recreate the trap
and send it to northbound system, when they identify
that the original trap was not received from the
nmsCurrentAlarmText R/O The alarm display text (same as the text in the sent
trap) - up to 45 characters long.