Beruflich Dokumente
Kultur Dokumente
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
TABLE OF CONTENTS
CHAPTER 1: INTRODUCTION .........................................................................................4
About Ceragon MIB................................................................................................................... 4 About this Guide........................................................................................................................ 4 Terminology ............................................................................................................................... 5
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
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.
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
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.
genEquipUnit genEquipUnit genEquipNetwork genEquipNetwork genEquipFault genEquipFault genEquipMng genEquipMng genEquipRFU genEquipRFU genEquipPM genEquipPM
The following chapters describe each of the primary MIB sections individually.
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
genEquipNetwork Section
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.
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
genEquipCurrentAlarm
Contains the current alarm table and the last change counter. Holds the trap management table.
genEquipTrapCfgMgr
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.
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
For additional info on the Trap Management Table data please refer to Section Trap Sending Configuration of this document.
11
genEquipMng Section
Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipUnit genEquipRFU genEquipNetwork genEquipPM genEquipFault genEquipMng genEquipRFU genEquipPM genEquipMngSw genEquipMngCfg genEquipMngSw genEquipMngCfg
Ceragon Private
genEquipMngSw
Contains the Software management related parameters and commands. Contains the IDU configuration management related parameters and commands.
genEquipMngCfg
12
genEquipMngSw Subsection
The following figure shows the genEquipMngSw subsection.
Ceragon Private
Ceragon Private
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
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.
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
14
The possible values for the resulting statuses of the genEquipMngSwCommand activation are: 0 1 2 3 Ready InProgress Success Failure
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
16
genEquipRfuUploadSwCommand genEquipRfuUploadSwCommandStatus
genEquipPM Section
Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM Ceragon Private genEquipUnit genEquipNetwork genEquipFault genEquipMng genEquipRFU genEquipPM genEquipPmRfu genEquipPmTraffic genEquipPmRfu genEquipPmTraffic
genEquipPmRfu
Contains the performance monitoring tables for the RFU. Contains the performance monitoring tables for 17
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).
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
19
20
genEquipPmTraffic Subsection
The following figure shows the genEquipPmTraffic subsection.
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
21
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
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.
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.
25
genEquipTrapCfgStatusChangeFilter.n
R/W
genEquipTrapCLLI
R/W
26
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.
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
enterpriseId
Warm Start
enterpriseId
LinkDown
generated upon setting the Admin param to disable or in cases of erroneous behaviour. Varbinds include:
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
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.
28