华为存储设备MIB接口说明书.docx
《华为存储设备MIB接口说明书.docx》由会员分享，可在线阅读，更多相关《华为存储设备MIB接口说明书.docx（114页珍藏版）》请在冰豆网上搜索。
华为存储设备MIB接口说明书
华为存储MIB接口说明
文档版本
01
发布日期
2016-03-30
华为技术有限公司
版权所有?
华为技术有限公司2015。
保留一切权利。
非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标，由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。
除非合同另有约定，华为公司对本文档内容不做任何明示或默示的声明或保证。
由于产品版本升级或其他原因，本文档内容会不定期进行更新。
除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
华为技术有限公司
地址：
深圳市龙岗区坂田华为总部办公楼邮编：
518129
网址：
1
概述
本文档介绍了存储设备实现的各种MIB，包括各个MIB的功能、表间关系、单节点详细描述、MIBTable详细描述、告警节点详细描述。
读者对象
本文档主要适用于以下人员：
●应用开发人员
内容简介
本文档包含1篇总体介绍和多个具体MIB参考文档，内容如下。
章节
内容
1MIB简介
主要介绍网络管理、基于SNMP的网络管理体系结构组成、SNMP协议、以及MIB的基本概念和操作。
2MIB参考
以MIB名称命名
2MIB介绍
2.1网络管理概述
随着网络的规模越来越庞大，网络中的设备种类繁多，如何对越来越复杂的网络进行有效的管理，从而提供高质量的网络服务已成为网络管理所面临的最大挑战。
网络管理已成为整个网络解决方案中重要的一部分。
网络管理通常包含4个要素：
●被管理节点：
需要进行管理的设备。
●代理（Agent）：
跟踪被管理设备状态的软件或硬件。
●网络管理工作站（Manager）：
与在不同的被管理节点中的代理通信，并且显示这些代理状态的设备。
●网络管理协议：
网络管理工作站和代理用来交换信息的协议。
目前TCP/IP网络中应用最为广泛的网络管理协议是简单网络管理协议SNMP（SimpleNetworkManagementProtocol）。
2.2基于SNMP的网络管理
基于SNMP的网络管理体系结构中包含4个主要组成部分：
●网络管理站NMS（NetworkManagementStation）
NMS通常是一个独立的设备，运行网络管理应用程序。
网络管理应用程序至少能够提供一个人机交互界面，网络管理员通过它完成绝大多数网络管理工作。
●SNMP代理器（Agent）
Agent是驻留在被管理设备的一个软件模块，主要负责接收和处理来自NMS的请求报文，并形成响应报文，返回给NMS；在一些紧急情况下，它会主动发送trap报文，通知NMS。
●SNMP协议
SNMP协议属于TCP/IP网络的应用层协议，用于在NMS和被管理设备间交互管理信息。
●管理信息库MIB（ManagementInformationBase）
MIB是一个被管理对象的集合，是NMS同Agent进行沟通的桥梁，可以使网管软件和设备进行标准对接。
每一个Agent都维护这样一个MIB库，NMS可以对MIB库中对象的值进行读取或设置。
几个主要组成部分的相互关系，它们之间的通信方式描述如下：
●NMS通过SNMP协议与设备的Agent通信，完成对MIB的读取和修改操作，从而实现对网络设备的监控与管理。
●SNMP是NMS与Agent之间通信的载体，通过其协议数据单元PDU（ProtocolDataUnit）完成信息交换。
SNMP并不负责数据的实际传输，数据交换的任务是通过UDP等传输层协议来完成的。
●Agent是设备上的代理进程，主要工作包括与NMS通信，对设备中的MIB库进行维护，以管理和监控设备中的各个模块。
●MIB保存设备中各个模块的信息。
通过对MIB信息的读写操作来完成对设备的监控和维护。
2.3SNMP介绍
2.3.1SNMP版本
SNMP协议的版本包括：
SNMPv1、SNMPv2c、SNMPv3。
SNMPv1和SNMPv2c都是使用基于共同体名的认证。
NMS通过共同体名列表控制对设备的访问权限，而代理（Agent）并不核实发送者是否使用了授权的共同体名，同时，SNMP消息未采用加密传输，因此在认证和私有性方面缺乏安全保障。
SNMPv2c在SNMPv1的基础上进行了增强，增强的功能包括：
支持更多的操作、支持更多的数据类型、提供更丰富的错误处理码和多种传输协议的支持。
SNMPv3定义了包含SNMPv1、SNMPv2所有功能在内的体系框架和包含验证服务和加密服务在内的全新安全机制。
SNMPv3的安全性主要体现在数据安全和访问控制上。
SNMPv3提供消息级的数据安全，它包括以下三种情况：
●数据完整性：
数据不会在未被授权方式下修改，数据顺序的改动也不会超出许可范围。
●数据来源验证：
确认所收到的数据来自哪个用户。
SNMPv3定义的安全性是基于用户的，它验证的是生成消息的用户，而不是具体生成消息的应用程序。
●数据核实性检查：
当NMS或Agent接收到消息时，对消息的生成时间进行检查，如果消息时间与系统当前时间的差超出了指定的时间范围，该消息就不被接受。
这可以防止消息在网络传输过程中被恶意更改，或收到并处理恶意发送的消息。
SNMPv3的访问控制是基于协议操作的安全性检查，控制对被管理对象的访问。
2.3.2SNMP报文处理过程
Agent通过UDP端口161接收来自NMS的Request报文。
Agent接收到报文后，其基本处理过程如下：
1.解码：
依据基本编码规则，生成用内部数据结构表示的报文。
如果此过程出现错误导致解码失败，则丢弃该报文，不做进一步处理。
2.比较SNMP版本号：
将报文中的版本号取出，与本Agent支持的SNMP版本号比较。
如果不一致，则丢弃该报文，不做进一步处理。
3.团体名验证：
将报文中的团体名取出，此团体名由发出请求的网管站填写。
如与Agent所在设备认可的团体名不符，则丢弃该报文，不做进一步处理，同时产生一个Trap报文。
SNMPv1提供较弱的安全措施，在版本3中这一功能被加强。
4.提取PDU：
从通过验证的对象中提出协议数据单元PDU。
如果失败，丢弃报文，不做进一步处理。
5.处理PDU：
根据不同的PDU，SNMP协议实体进行不同的处理。
得到管理变量在MIB树中对应的节点，从相应的模块中得到管理变量的值，形成Response报文，编码发回网管站。
6.网管站得到响应报文后，经过同样的处理，最终显示结果。
2.4MIB介绍
MIB是一个被管理对象的集合，它定义被管理对象的一系列属性，包括：
●对象的名字
●对象的访问权限
●对象的数据类型
管理信息结构SMI（StructureofManagementInformation）规定了被管理的对象应该如何定义和组织，它定义了一系列MIB可以使用的数据类型，比如：
Counter、Gauge等。
MIB指明了网络元素所维护的变量，即能够被NMS查询和设置的信息，给出了一个网络中所有可能的被管理对象的集合的数据结构。
2.5MIBBrowser介绍
被加载MIB文件中需要import的MIB文件应该被首先加载。
下面以MG-SOFTMIBBrowserProfessionalSNMPv3Edition加载MIB为例进行介绍。
2.5.1MIB文件编译及加载
步骤1运行MG-SOFTMIBBrowser，在MIBBrowser窗口中单击“RunMG-SOFTMIBCompiler”按钮。
图1MIBBrowser窗口
步骤2在MIBCompiler窗口中单击“CompileMIBfile”按钮。
步骤3选择需要编译的MIB文件。
步骤4编译MIB文件。
选中要编译的MIB文件后，单击“打开”按钮，开始编译MIB文件，编译成功后显示信息如图4所示。
图4MIB文件编译成功信息
步骤5保存编译成功的MIB文件，MIB文件会保存到默认路径。
步骤6在MIB/MIBModules一栏中选择欲加载的MIB文件ISM-HUAWEI-MIB，点击向上的红色箭头即可加载MIB文件到MIBBrowser里。
2.5.2SNMP协议参数设置
Timeout：
表示请求报文超时时间，设置范围为1～30s，建议设置为15s。
Retransmits：
表示请求报文超时后的重发次数，设置范围为0～10，建议设置为2，具体视网络环境情况而定。
Nonrepeaters：
表示下发绑定的参数中前Nonrepeaters个变量只执行一次GetNext操作。
如果该值大于绑定参数总数则以绑定参数总数为准，如果该值小于0则按0值处理，建议将该参数设置为0，参数设置视具体用法而定。
Maxrepetitions：
表示对绑定参数中除前Nonrepeaters个参数外的所有参数执行GetNext操作的最大重复次数，设置范围为1～50，建议设置为10，太大会出现tooBig错误。
注意：
对于SNMPv1协议，没有参数Nonrepeaters和Maxrepetitions。
3RFCMIB支持
3.1RFC1213mib-2system模块
sysDescr详细描述
节点
数据类型
含义
实现规格
状态
sysDescr
OID:
1.3.6.
系统描述
read-only
current
sysObjectID详细描述
节点
数据类型
含义
实现规格
状态
sysObjectID
OID:
1.3.6.
Identifier
系统OID描述
read-only
current
sysUpTime详细描述
节点
数据类型
含义
实现规格
状态
sysUpTime
OID:
1.3.6.
系统SNMP服务的运行时间，一般可认为是系统的运行时间。
单位:
百分之一秒。
read-only
current
sysName详细描述
节点
数据类型
含义
实现规格
状态
sysName
OID:
1.3.6.
STRING
系统名称
read-only
current
sysLocation详细描述
节点
数据类型
含义
实现规格
状态
sysLocation
OID:
1.3.6.
STRING
系统位置
read-only
current
4华为节点下MIB参考（标准企业节点：
2011）
4.1华为节点告警模块
hwIsmActiveAlarmInfoTable详细描述
该表保存活跃告警，供网管查询。
该表的索引是1:
hwIsmActiveAlarmInfoNodeCode,2:
hwIsmActiveAlarmInfoSerialNo。
该表的OID为。
节点
数据类型
含义
实现规格
状态
hwIsmActiveAlarmInfoNodeCode
OID:
告警节点编号
read-only
current
hwIsmActiveAlarmInfoLocationInfo
OID:
告警的定位信息，格式为：
Name1=Value1,…,NameN=ValueN
read-only
current
hwIsmActiveAlarmInfoRestoreAdvice
OID:
告警修复建议
read-only
current
hwIsmActiveAlarmInfoTitle
OID:
告警信息标题
read-only
current
hwIsmActiveAlarmInfoType
OID:
告警类型：
2-设备告警
read-only
current
hwIsmActiveAlarmInfoLevel
OID:
网管软件告警等级：
1-严重告警
2-重要告警
3-次要告警
4-警告告警
read-only
current
hwIsmActiveAlarmInfoAlarmID
OID:
网管软件告警ID
read-only
current
hwIsmActiveAlarmInfoOccurTime
OID:
告警产生时间
read-only
current
hwIsmActiveAlarmInfoSerialNo
OID:
告警流水号
read-only
current
hwIsmActiveAlarmInfoAddtionInfo
OID:
STRING
告警原因描述
read-only
current
hwIsmActiveAlarmInfoCategory
OID:
告警类别：
1－故障告警
2－恢复告警
3－事件告警
read-only
current
hwIsmActiveAlarmInfoLocalAlarmID
OID:
原始告警ID
read-only
current
hwIsmTrapTargetAddrTable详细描述
该表包含告警上报的转发地址信息，包括IP地址，端口号，上报的版本号等。
该表的索引是hwIsmTrapTargetAddrIndex。
该表的OID为。
节点
数据类型
含义
实现规格
状态
hwIsmTrapTargetAddrIPAddr
OID:
转发的目标地址，只支持IPv4格式地址。
read-create
current
hwIsmTrapTargetAddrPort
OID:
转发的目标地址的端口，取值为：
1~65535。
read-create
current
hwIsmTrapTargetAddrRowStatus
OID:
行状态，取值为：
1：
修改Trap转发目标地址
4：
添加Trap转发目标地址
6：
删除Trap转发目标地址
删除IPv4地址时，需要填入正确的hwIsmTrapTargetAddrIPAddr和正确的hwIsmTrapTargetAddrPort。
由于兼容性原因，删除IPv6地址时，需要将字段hwIsmTrapTargetAddrIPAddr设置为，将字段hwIsmTrapTargetAddrPort设置为0，同时下发正确的hwIsmTrapTargetAddrIndex。
read-create
current
hwIsmTrapTargetAddrIndex
OID:
STRING
Trap转发目标地址索引，取值为：
0~3。
read-create
current
hwIsmTrapTargetAddrTrapVer
OID:
转发的目标地址版本，取值为：
1：
SNMPv1
2：
SNMPv2c
3：
SNMPv3
在配置Trap转发目标地址时，若此字段未填写，则默认为SNMPv2c。
read-create
current
hwIsmTrapTargetAddrIPAddrNew
OID:
STRING
Trap转发的目标新地址，支持IPv4或IPv6格式地址。
在配置Trap转发目标地址时，若hwIsmTrapTargetAddrIPAddr和hwIsmTrapTargetAddrIPAddrNew字段均有填写，则默认只取hwIsmTrapTargetAddrIPAddrNew字段的值。
read-create
current
hwIsmTrapTargetAddrTrapType
OID:
转发的目标地址类型，取值为：
1：
Parsed向Trap目标地址发送解析过的告警（TrapOID:
）。
2：
Original向Trap目标地址发送未解析过的原始告警（TrapOID:
）。
3：
All向Trap目标地址发送Parsed和Original类型的告警。
在配置Trap转发目标地址时，若此字段未填写，则默认为Parsed。
read-create
current
hwIsmClearedAlarmConfirm详细描述
节点
数据类型
含义
实现规格
状态
hwIsmClearedAlarmConfirm
OID:
活动告警确认
Set：
填写活动告警流水号，如果存在，则清除告警，并上报恢复告警，否则返回错误。
Get：
返回固定值：
0，值无意义。
read-write
current
hwIsmAlarmReporting详细描述
该节点用于上报解析过的告警。
该节点的OID为。
绑定变量
数据类型
含义
实现规格
状态
hwIsmReportingAlarmNodeCode
OID:
STRING
告警节点编号
accessible-for-notify
current
hwIsmReportingAlarmLocationInfo
OID:
STRING
告警的定位信息，格式为：
Name1=Value1,…,NameN=ValueN
accessible-for-notify
current
hwIsmReportingAlarmRestoreAdvice
OID:
STRING
告警修复建议
accessible-for-notify
current
hwIsmReportingAlarmFaultTitle
OID:
STRING
告警信息标题
accessible-for-notify
current
hwIsmReportingAlarmFaultType
OID:
告警类型：
2-设备告警
accessible-for-notify
current
hwIsmReportingAlarmFaultLevel
OID:
网管软件告警等级：
1-紧急告警
2-重要告警
3-次要告警
4-警告告警
accessible-for-notify
current
hwIsmReportingAlarmAlarmID
OID:
网管软件告警ID
accessible-for-notify
current
hwIsmReportingAlarmFaultTime
OID:
STRING
告警产生时间
accessible-for-notify
current
hwIsmReportingAlarmSerialNo
OID:
告警流水号
accessible-for-notify
current
hwIsmReportingAlarmAdditionInfo
OID:
STRING
告警原因描述
accessible-for-notify
current
hwIsmReportingAlarmFaultCategory
OID:
告警类别：
1－故障告警
2－恢复告警
3－事件告警
accessible-for-notify
current
hwIsmReportingAlarmLocationAlarmID
OID:
原始告警ID
accessible-for-notify
current
4.2华为节点TOPO模块
hwIsmAccessNodeTable详细描述
该表查询设备基本信息
该表的索引是：
hwIsmNENodeCode
该表的OID为。
节点
数据类型
含义
实现规格
状态
hwIsmNENodeCode
OID:
STRING
网元节点编号
read-only
current
hwIsmNENodeType
OID:
网元节点类型
read-only
current
hwIsmNENodeWorkingMode
OID:
网元工作模式,未使用
read-only
current
hwIsmNENodeIPAddress
OID:
网元节点IP地址,未使用
read-only
current
hwIsmNENodeContextName
OID:
STRING
上下文名称
read-only
current
hwIsmNENodeContextEngineID
OID:
STRING
上下文引擎标识ID,未使用
read-only
current
hwIsmNENodeClusterName
OID:
STRING
网元集群名称,未使用
read-only
current
hwIsmNENodeRunningStatus
OID:
网元运行状态
1：
SNMPAgent与设备通信正常
2：
SNMPAgent与设备通信失败
未使用
read-only
current
5存储节点下MIB参考（标准企业节点：
34774）
5.1common模块
deviceId详细描述
节点
数据类型
含义
实现规格
状态
deviceID
OID:
1.3.6.
设备序列号，设备的唯一标识
read-only
current
deviceType详细描述
节点
数据类型
含义
实现规格
状态
deviceType
OID:
1.3.6.
设备的型号，存储设备不同型号产品，取值详见PRODUCT_MODE_E枚举值定义。
read-only
current
status详细描述
节点
数据类型
含义
实现规格
状态
status
OID:
1.3.6.
当前系统的运行状态。
取值详见RUNNING_STATUS_E枚举值定义
read-only
current
usedCapacity详细描述
节点
数据类型
含义
实现规格
状态
usedCapacity
OID:
1.3.6.
存储设备已使用容量，单位是兆字节（MB）。
read-only
current
totalCapacity详细描述
节点
数据类型
含义
实现规格
状态
totalCapacity
OID:
1.3.6.
存储设备的总容量。
单位是兆字节（MB）。
read-only
current
version详细描述
节点
数据类型
含义
实现规格
状态
Version
OID:
1.3.6.
设备版本
read-only
升级会员 