监控系统SNMPMTU探头和MTUC服务器接口规范v20

1、WLAN监控系统SNMP（MTU和MTUC）接口规范V2.0文件名称：WLAN监控系统SNMP接口规范文件编号：编写人：编写日期：2012年4月审核日期：版本标识：V2.0杭州金硕信息技术有限公司目录1总述11.1范围12接口规范12.1接口概述12.2监控状态业务接口格式12.3测试状态业务接口格式22.4维护状态功能接口格式23接口定义23.1接口定义说明23.2SNMP报文格式33.3管理信息库的设计53.4监控状态业务接口定义5扫描场强检测53.5测试状态业务接口定义7测试7测试10测试12测试15测试173.6维护状态功能接口定义20开机注册20复位重启21校时22心跳23参数配置2

2、5配置参数查询26软件升级28停止任务311 总述1.1 范围本接口仅用于WLAN监控系统SNMP管理（MTU（探头）和MTUC（服务器）间的）通信。各测试模块工作流程简图如下：2 接口规范2.1 接口概述本接口设计为以下三种接口格式：1) 监控状态业务接口：用于监控的接口；2) 测试状态业务接口：用于测试任务的接口；3) 维护状态功能接口：用于维护工作的接口。2.2 监控状态业务接口格式1) 数据监控完成（OID节点）格式：l 扫描完成OID节点：i 22) 取监控信息指令（OID节点）格式：l 获取测试结果：snmpget -v 2c -cl 目标IP：l 任务指令OID节点：l 打开关闭

3、OID节点： i实例：snmpset -v 2c -c.. i 13) 结果内容格式：（OID节点见下文）l AP扫描信息头：设备编号和任务执行时间l AP信息个数: 本次扫描到的AP信息个数l AP信息内容(N字节)：返回的结果内容，每个参数间采用空格分隔，以回车符结尾格式：设备编号时间AP信息个数AP1信道 AP1名称 AP1-MAC地址 加密方式 AP1 场强 回车符1 ChinaNet 00:1d:e5:8d:3e:80 NONE 86 11b/g 。2.3 测试状态业务接口格式测试状态接口格式内容：1) 任务指令（OID节点）格式：与监控

4、状态接口格式相同2) 结果内容格式：l 固定信息头：设备编号和任务执行时间l 测试返回内容(N字节)：返回的结果内容，每个参数间采用空格分隔，以回车符结尾格式：设备编号 时间 测试任务 测试结果内容 回车符2.4 维护状态功能接口格式（略）具体见下文3 接口定义3.1 接口定义说明WLAN监控系统的网络接口采用SNMP协议作为传输方式，MTUC是控制端(管理端，即客户端)，MTU是代理端（代理服务器，即服务器端）；MTU和MTUC间的交互过程如下图所示。管理进程在端口162上监听Trap消息并通过161端口发送Get-Request、Get-Next-Request和Set-Request命令

5、消息，而代理进程监听161端口获取管理进程的操作命令消息并通过162端口发送Get-Response和Trap消息。3.2 SNMP报文格式下图是封装成UDP数据报的5种操作的SNMP报文格式。可见一个SNMP报文共有三个部分组成，即公共SNMP首部、get/set首部trap首部、变量绑定。1) 公共SNMP首部，共三个字段a) 版本写入版本字段的是版本号减1，对于SNMP（即SNMPV1）则应写入0。b) 共同体（community）共同体就是一个字符串，作为管理进程和代理进程之间的明文口令，常用的是6个字符“public”。c) PDU类型根据PDU的类型，填入04中的一个数字，其对应关

6、系如表1所示意图。表1 PDU类型PDU类型名称0get-request1get-next-request2get-response3set-request4trap2) get/set首部a) 请求标识符(request ID)这是由管理进程设置的一个整数值。代理进程在发送get-response报文时也要返回此请求标识符。管理进程可同时向许多代理发出get报文，这些报文都使用UDP传送，先发送的有可能后到达。设置了请求标识符可使管理进程能够识别返回的响应报文对于哪一个请求报文b) 差错状态（error status）由代理进程回答时填入05中的一个数字，见表2的描述表2差错状态描述差错状态

7、名字说明0noError一切正常1tooBig代理无法将回答装入到一个SNMP报文之中2noSuchName操作指明了一个不存在的变量3badValue一个set操作指明了一个无效值或无效语法4readOnly管理进程试图修改一个只读变量5genErr某些其他的差错c) 差错索引(error index)当出现noSuchName、badValue或readOnly的差错时，由代理进程在回答时设置的一个整数，它指明有差错的变量在变量列表中的偏移。3) trap首部a) 企业（enterprise）填入trap报文的网络设备的对象标识符。此对象标识符肯定是在对象标识符树上的enterprise结

8、点.4.1下面的一棵子树上。b) trap类型此字段正式的名称是generic-trap，共分为表3中的7种。表3 Trap 类型描述trap类型名字说明0coldStart代理进行了初始化1warmStart代理进行了重新初始化2linkDown一个接口从工作状态变为故障状态3linkUp一个接口从故障状态变为工作状态4authenticationFailure从SNMP管理进程接收到具有一个无效共同体的报文5egpNeighborLoss一个EGP相邻路由器变为故障状态6enterpriseSpecific代理自定义的事件，需要用后面的“特定代码”来指明当使用上述类型2、3、

9、5时，在报文后面变量部分的第一个变量应标识响应的接口。c) 特定代码(specific-code)指明代理自定义的时间（若trap类型为6），否则为0。d) 时间戳(timestamp)指明自代理进程初始化到trap报告的事件发生所经历的时间，单位为10ms。例如时间戳为1908表明在代理初始化后1908ms发生了该时间。4) 变量绑定(variable-bindings)指明一个或多个变量的名和对应的值。在get或get-next报文中，变量的值应忽略。3.3 管理信息库的设计SNMP的管理信息库（OID）是一种树形结构，它规定了网络代理端（MTU）所保存的数据项目、数据类型以及在每个数据项

10、目中所允许的操作等信息。通过对这些数据项目的存取访问来实现对被管理设备的管理（故障管理、计费管理、性能管理、配置和名称管理以及安全管理）。标准OID的基本OID（Object Identifier，对象识别树）开头为 .2.1 ，而 Private OID的基本OID开头为。下图是WLAN监控系统的功能接口的树形结构图，各功能的具体参数分别在3.4和3.5中详细定义（为了减少内存的使用，MTU内只包含自定义的OID，NET-SNMP中标准的OID可以不加载进去）。3.4 监控状态业务接口定义3.4.1 AP扫描场强检测1) 功能说明周期性地上报WLAN场强信息。2) 工作流程说明

11、AP扫描检测测试原理和工作流程图如上所示3) OID节点说明（1）OID节点汇总OID节点节点说明AP扫描任务类型：1-立即任务2-循环任务AP扫描任务测试次数（循环任务使用参数）AP扫描任务测试间隔（循环任务使用参数）AP扫描任务执行开关AP扫描任务执行状态：0-无任务 1-正在执行 2-执行完成AP扫描任务执行完成时间AP扫描任务测试结果（请求）AP扫描任务执行开始时间（2）各流程具体节点说明n 任务执行完成确认：MTU à MTUC参数OID节点长度(字节)参数说明任务执行状态12 任务执行完成确认ACKn 任务测试结果请求：MTUC à MTU参数OID节点长度(字

12、节)参数说明任务结果请求1请求测试结果上报n 任务测试结果上报：MTU à MTUC参数OID节点长度(字节)参数说明测试开始时间..14格式：YYYYMMDDHHMISS测试完成时间..114格式：YYYYMMDDHHMISSAP测试结果..11具体参考下表54) 测试用例（1）扫描任务完成：public 0 i 2 这条trap的含义是告知0服务器一个扫描结果完成，希望服务器主动来取。（2）获取测试结果（3）返回消息public 2

13、50 ..string ..1string string 1112W0061 ChinaNet 00:1d:e5:8d:3e:80 NONE 86 11b/g (4) 返回结果数据说明返回结果数据格式如下表所示，参数之间以空格分隔，以回车符结尾：参数长度(单位：字节)参数说明AP1-Channel11AP1-SsidNChinaNetAP1-Bssid1200:1d:e5:8d:3e:80AP1-SecurityNWPA1PSKWPA2PSK/TKIPAESAP1-Signal(%)186AP1-W

14、-Mode12备注：11b/g/nAP2-Channel111AP2-SsidNChinaUnicomAP2-Bssid1200:18:25:10:b4:20AP2-SecurityNNONEAP2- Signal(%)181AP2-W-Mode12备注：11b/g/nAP3-3.5 测试状态业务接口定义3.5.1 PPPOE测试1) 功能说明测试WLAN拨号上网功能。2) 工作流程说明PPPOE测试原理和工作流程图如下所示3) OID节点说明（1)具体OID节点汇总：OID节点节点说明PPPOE 任务类型 1-立即任务 2-循环任务PPPOE 任务测试次数 （循环任务使用参数）PPPOE 任

15、务测试间隔 （循环任务使用参数）PPPOE 拨号用户名PPPOE 拨号用户名登录密码PPPOE 任务编号PPPOE 任务执行开关PPPOE 任务登录的AP名..PPPOE 任务确认PPPOE 任务执行状态： 0-无任务 1-正在执行 2-执行完成PPPOE 任务执行完成时间PPPOE 任务测试结果PPPOE 任务完成返回TAKS_IDPPPOE 任务执行开始时间（2)各流程具体节点说明：n 任务下发：MTUC à MTU参数OID节点长度(字节)参数说明任务类型11-立即任务 2-循环任务测试次数13单位：次测试间隔110单位：分钟拨号用

16、户名hzjs登陆密码110543216PPPOE任务编号110120任务登录的AP名110ChinaNetn 任务下发请求确认：MTU à MTUC参数OID节点长度(字节)参数说明任务确认..10未确认 1确认n 任务执行完成确认ACK：MTUàMTUC参数OID节点长度(字节)参数说明任务完成12 任务执行完成确认ACKn 任务测试结果请求：MTUC à MTU参数OID节点长度(字节)参数说明测试结果请求1请求任务结果上报n 任务测试结果上报：MTU à MTUC参数OID节点长度(字节)参数说明任务编

17、号110855测试开始时间14格式：YYYYMMDDHHMISS测试完成时间14格式：YYYYMMDDHHMISS拨号测试结果 SuccessDiscovery failPAPauthority failGet IP fail4) 测试举例(1) 立即任务snmpset -v 2c -c public 50 .. i 855 .. i 1 .. string hzjs .. string 54

18、3216 .. string ChinaNet .. i 1任务的含义是：向目标下发一个PPPOE测试任务，任务编号855，立即执行（1），拨号用户名hzjs，用户名登陆密码543216，任务登录的AP名ChinaNet，任务执行开关打开。(2) 获取测试结果(3) 返回结果public 50 i 855string 38 string string PAP authority fail 3.5.2 PING测试1) 功能说明通过PING命令测试网络时延、丢包和误码率。2) 工作流程

19、说明Ping测试工作原理和流程如上图所示。3) OID节点说明（1） OID节点汇总OID节点节点说明PING 任务类型 1-立即任务 2-循环任务PING 任务测试次数 （循环任务使用参数）-保留..3PING 任务测试间隔 （循环任务使用参数）..PING 任务IP地址或者URL..3PING 任务持续时间..3PING 任务编号..3PING 任务执行开关..PING 任

20、务确认..PING 任务执行状态 0-无任务 1-正在执行 2-执行完成..PING 任务执行完成时间..PING 任务测试结果..PING 任务返回TAKS_ID..PING 任务执行开始时间（2）各流程具体节点说明：n 下发任务请求：MTUCà MTU参数OID节点长度(单位：字节)参数说明任务编号..3110Ping

21、目标地址..NIP地址或URL测试频率110单位：次数/秒测试次数13单位：次测试间隔..3110单位：秒n 任务确认：MTU à MTUC参数OID节点长度(字节)参数说明任务确认..10未确认 1确认n 任务完成确认：MTU à MTUC参数OID节点长度(字节)参数说明PPPOE 任务完成返回TAKS_ID..任务执行完成确认ACK执行状态..312- 任务执行完成n

22、 任务结果请求：MTUCà MTUn 返回测试结果：MTU à MTUC参数OID节点长度(字节)参数说明任务编号..3110Ping目标地址..NIP地址或者URL测试开始时间..14格式：YYYYMMDDHHMISS测试完成时间..14格式：YYYYMMDDHHMISS测试结果..N返回结果如下表返回结果格式：参数长度(字节)参数说明发送的数据包数110收

23、到的数据包数110最大时延110单位：毫秒最小时延110单位：毫秒平均时延110单位：毫秒丢包率15格式：xx.yy%4) 测试用例(1)循环任务snmpset -v 2c -c public 50 .. i 2 .. i 2 .. i 888 .. string 43 .. i 1(2)获取测试结果 i 0

24、..3 i 880(3)返回测试结果public 50 ..3 i 880 .. string ...... string 100 97 120 8 64 3.00%3.5.3 FTP测试1) 功能说明通过ftp下载和上传，测试网络速率。2) 工作流程说明FTP测试原理和工作流程图如下所示3) OID节点定义：（1）OID节点汇总OID节

25、点节点说明FTP 任务类型 1-立即任务 2-循环任务FTP 任务测试次数 （循环任务使用参数-保留）FTP 任务测试间隔 （循环任务使用参数）..FTP 任务服务器ip地址..FTP 任务服务器端口FTP 任务登录用户名FTP 任务用户登录密码FTP 任务编号FTP 任务执行开关FTP 任务上传文件名FTP 任务下载文件名..FTP 任务确认：1-确认 0-未确认FTP 任务执行状态0-无任务 1-正在执行 2-执行完成FTP 任务执行完成时间FTP 任务

26、测试结果（请求）FTP 任务返回TAKS_IDFTP 任务执行开始时间（2）各流程具体节点说明n 任务下发请求：MTUCà MTU参数OID节点长度参数说明任务编号110任务类型11-立即任务2-循环任务测试次数13单位：次测试间隔110单位：秒FTP服务器地址..715格式：FTP服务器端口号..05FTP帐号名称NFTP帐号密码NFTP任务上传文件名NFTP任务下载文件名Nn 任务请求确认： MTU àMTUC参数OID节点长度(字节)参数说明任务确认.4.1.21

27、.9.01FTP 任务确认n 任务完成确认： MTU à MTU C参数OID节点长度(字节)参数说明设备编号8格式：0801A168任务编号110任务完成12-执行完成FTP任务返回TAKS_ID1任务完成确认ACKn 请求结果：MTUC àMTU参数OID节点长度(字节)参数说明请求结果1任务完成请求结果上报n 返回结果：MTU à MTUC参数OID节点长度(单位：字节)参数说明任务编号110955测试开始时间14YYYYMMDDHHMISS测试完成时间110YYYYMMDDHHMISS上传速率110单位：byte/s下载速率110单位：byt

28、e/s任务测试结果0 成功1 上传失败2 下载失败3 上传和下载都失败4) 测试用例：（1）下发循环任务snmpset -v 2c -c public 50 .. i 2 .. i 955 .. string 5 .. string hzjs .. string 123 .. str

29、ing /etc_ro/wlan/ftptest .. string ftptest .. i 1 .. i 1（2）获请求测试结果（3）返回上报结果public 50 .. i 955 string FTP download rate:failureFTP upload rate:failure3.5.4 HTTP测试1) 功能说明测试WLAN上网打开网页时延2) 工作流程说明HTTP测试原

30、理和工作流程图如上所示3) OID节点定义：（1）OID节点汇总OID节点节点说明HTTP 任务类型 1-立即任务 2-循环任务..5HTTP 任务测试次数 （循环任务使用参数-保留）..5HTTP 任务测试间隔 （循环任务使用参数）..HTTP 任务访问网页的IP地址或者URL..HTTP 任务持续时间 -保留，暂时无用..5HTTP 任务编号..5HTTP 任务执行开关1.

31、..2.5.0HTTP 任务确认：1-确认 0-未确认..HTTP 任务执行状态：0-无任务 1-正在执行 2-执行完成..HTTP 任务执行完成时间HTTP 任务时延..HTTP 任务测试结果（请求）..HTTP 任务返回TAKS_ID..HTTP 任务执行开始时间（2）各流程具体节点说明n 任务下发请求：MTUCà MTU

32、参数OID节点长度参数说明任务编号..5110任务类型11-立即任务2-循环任务测试次数..513单位：次测试间隔..5110单位：秒任务访问网页的IP地址或者URL..715n 任务请求确认： MTU àMTUC参数OID节点长度(字节)参数说明任务编号..5110任务请求确认..511-确认n 任务完成确认： MTU à MTUC参数OID节点长度(字节)参数说明任务

33、编号..5110900任务执行状态..12-执行完成FTP任务返回TAKS_ID..1任务完成确认ACKn 请求结果：MTUC à MTU参数OID节点长度(字节)参数说明请求结果..1任务执行完成请求结果n 返回结果：MTU à MTUC参数OID节点长度(字节)参数说明任务编号..5110测试开始时间..14YYYYMMDDH

34、HMISS测试完成时间..14YYYYMMDDHHMISS任务时延1单位：毫秒任务测试结果..N以上各结果的合并4) 测试用例（1）下发循环任务snmpset -v 2c -c public 50 .. i 2 .. i 900 .. string .. i 2 ..5.

35、2.4.0 i 1（2）请求测试结果（3）返回结果上报：public 50.. i 900......i 12 3.5.5 PORTAL测试1) 功能说明测试电信WLAN上网打开PORTAL网页时延2) 工作流程说明PORTAL测试原理和工作流程图如下所示：3) OID节点定义：（1）OID节点汇总OID节点节点说明PORTAL 任务类型 1-立即任务 2-循环任务PORTAL 任务测试次数

36、（循环任务使用参数-保留）..6PORTAL 任务测试间隔 （循环任务使用参数）..PORTAL 任务访问网页的IP地址或者URL..PORTAL 任务持续时间 -保留，暂时无用..6PORTAL 任务编号..6PORTAL 任务执行开关PORTAL 任务登录用户名PORTAL 任务用户登录密码..PORTAL 任务确认：0-未确认 1-确认.4.1

37、..1.0PORTAL任务执行状态：0-无任务 1-正在执行 2-执行完成..PORTAL 任务执行完成时间..PORTAL 任务时延..PORTAL 任务测试结果（请求）..PORTAL 任务返回TAKS_ID..PORTAL 任务执行开始时间（2）各流程具体节点说明n 任务下发请求：MTUCà MTU参数OID节点长度(字节)参数说明任

38、务编号..6110920任务类型..611-立即任务2-循环任务测试次数..613单位：次测试间隔..6110单位：秒任务访问网页的IP地址或者URL..715任务登录用户名NAbcdef用户登录密码NXyz123n 任务请求确认： MTU àMTUC参数OID节点长度(字节)参数说明任务编号..6110920任务确认..11-确认n

39、任务完成确认： MTU à MTUC参数OID节点长度(字节)参数说明任务编号..6110920任务完成状态..12-执行完成FTP任务返回TAKS_ID..1任务完成确认ACKn 请求结果：MTUC à MTU参数OID节点长度(字节)参数说明结果请求..1任务执行完成请求结果n 返回结果：MTU à MTUC参数OID节点长度(字节)参数说明任务编号..6110

40、920测试开始时间..14YYYYMMDDHHMISS测试完成时间..14YYYYMMDDHHMISS任务测试结果..N认证成功用户名密码错误超时其它4) 测试用例（1）下发循环任务snmpset -v 2c -c public 50 .. i 2 .. i 920 .. string .

41、. i 2 .. i 1（2）请求测试结果（3）返回测试结果..6i 920 ...... string user and password is error3.6 维护状态功能接口定义3.6.1 开机注册1) 功能说明MTU开机登录主要用于开机时间校对并进行时间同步，另外MTUC可以通过MTU开机登录了解MTU最后启动时间等信息。该消息在MTU启动

42、时主动通过Trap消息向MTUC发送。2) 参数说明n 请求消息参数：MTU à MTUC参数长度(单位：字节)参数说明设备编号8格式：1112W006MTU软件版本N发送时间1420080124112233，当MTU取不到时间时，填写全03) OID节点说明OID节点节点说明..硬件设备编号..软件版本号..系统发送时间4) 举例public localhost ..string 1112W00.4

43、..1.2.0string 3.6.2 复位重启1) 功能说明该命令用于控制MTU重新启动2) 参数说明n 请求消息参数：MTUC à MTU无参数n 请求确认消息参数：不返回确认消息n 请求执行结果消息参数：不返回执行结果消息3) OID节点OID节点节点说明复位重启：0-复位重启，其他为14) 测试用例snmpset -v 2c -c public localhost ..2.1.0 i0 复位重启3.6.3 校时1) 功能说明MTU控制器检测到MTU当前时间为空(刚开机后)或时间漂移比较大时，将对MTU进行校时。2) 参数说明n

44、 请求消息参数：MTUC à MTU参数长度(单位：字节)参数说明当前时间1420080124112233n 请求确认消息参数：不返回确认消息n 请求执行结果消息参数：不返回执行结果消息3) OID节点OID节点节点说明..3.1.0校时4) 测试用例snmpset -v 2c -c public localhost ..3.1.03.6.4 心跳1) 功能说明规范定义MTU心跳在WLAN存在并可用时周期为1分钟。在周期时间内，如果MTU未发送过其他任何消息，则发送心跳消息，否则不发送心跳消息。该消息由MTU通过Trap

45、消息周期性的向MTUC发送。2) 参数说明n 请求消息参数：MTU à MTUC参数长度(单位：字节)参数说明设备编号8格式：0801A168MTU软件版本N发送时间1420080124112233，当MTU取不到时间时，填写全0n 请求确认消息参数：不返回确认消息n 请求执行结果消息参数：不返回执行结果消息3) OID节点定义OID节点节点说明..硬件设备编号..软件版本号..系统发送时间..5.3.0系统发送心跳

46、周期4) 测试用例public localhost ..5.3.0 i 60 ..string 1112W0083.6.5 参数配置1) 功能说明修改MTU中的配置参数。2) 参数说明n 请求消息参数(操作码类型=0)：MTUC à MTU参数长度(单位：字节)参数说明允许登录的AP名称N为0字节时不作修改，保留原值服务器IP地址N格式：为0字节时不作修改，保留原值服务器端口05为0字节时不作修改，保留原值WLAN登录帐号N为0字节时不作修改，保留原值WLAN登录密码NWLAN登录帐号不为0字节时有效AP扫

47、描检测周期110单位：秒3) OID节点定义OID节点节点说明..允许登录的AP名称..服务器IP地址..服务器端口..WLAN登录帐号..WLAN登录密码..备用..备用..备用..备

48、用..AP扫描周期(单位：秒)4) 测试用例snmpset -v 2c -c public localhost .. string ChinaNet .. .. string hzjs .. string 543216 .. i 603.6.6 配置参数查询1) 功能说明查询MTU设备中的当前配置参数值2) 参数说明n 请求消息参数：MTUC à MTU参数长度(单位：字节)参数说明设备编号8格式：0801A168允许登录的AP名称N服务器IP地址N格式：服务器端口05WLAN登录帐号NWLAN登录密码NAP扫描检测