《机顶盒软件升级和性能监测接口技术要求》由会员分享,可在线阅读,更多相关《机顶盒软件升级和性能监测接口技术要求(20页珍藏版)》请在金锄头文库上搜索。
1、监测接口技术要求 机顶盒软件升级和性能 中国电信集团公司 2008 年 10 月 中国电信集团公司 2008 年 10 月 1机顶盒软件升级和性能监测接口技术要求 一、 概述 本章根据中国电信 IPTV 系列规范 2.0 中关于机顶盒软件升级和性能监测的接口技术要求,对该接口过程和协议做出规定,并作为机顶盒软件升级和性能监测功能、接口测试的指导和依据。 二、 软件升级接口 (一)机顶盒软件升级接口时序 图 1 机顶盒软件升级下载流程图 机顶盒软件升级包括如下过程: 1.机顶盒向认证平台发起认证请求; 22.认证平台通过认证流程返回认证响应,并通过CTCStartUpdate()触发机顶盒升级流
2、程; 3.机顶盒根据自身健康状况,如剩余存储大小、机顶盒运行状态等,进行判断。 ; 4.如果机顶盒当前状况允许进行升级,则向升级策略服务器发起升级请求,在 URL 中带有相关参数;如果机顶盒当前状况不允许进行升级,则跳过升级步骤,直接访问 EPG 服务器; 5.升级策略服务器响应机顶盒的升级请求,进行调度,并通过 Http 响应返回机顶盒升级检查结果。 6.如果 HTTP 返回 200 OK,则表示无新版本需要升级;如果 HTTP 返回 302 Redirect,则将机顶盒重定向到升级服务器进行升级; 7.升级服务器根据来自机顶盒的请求触发机顶盒升级。 8.机顶盒根据与升级服务器协商的策略完成
3、升级文件下载 9.机顶盒根据下载情况将下载结果写入日志文件(注:该步骤可选) 。 10.机顶盒进行软件版本更新,并根据需求自行判定是否对机顶盒进行重启。 说明: 1机顶盒在下载文件结束后,需要进行本地升级,具体升级由机顶盒提示用户后自行完成。 2机顶盒软件升级流程触发后,采用阻塞的方式进行,3即只有升级流程完成后(无论是否需要进行软件升级)才能跳转至 EPG 服务器。 3机顶盒在升级过程中向服务器发送的任意一次请求失败,则直接跳过升级过程。 4步骤 6 升级策略管理服务器的重定向地址由厂商根据具体升级策略提供; 5步骤 7、8 的具体升级流程由厂商自行定义; (二)接口协议内容 1.机顶盒升级
4、请求 承载协议:HTTP GET 接口方向:C S 调用接口: Http:/ IptvUpgradeDomain/IptvUpgradeURL 接口功能:发出一个标准的HTTP GET升级请求消息 备注说明:采用URL传递参数 4表 1 升级请求参数 名称名称 说明说明 数据类型数据类型 长度(字节)长度(字节) 是否必选是否必选 STBID 机顶盒 ID string 32 M UserID 用户 ID String 36 M UserToken IPTV 用户业务编号 String 36 M SoftwareVersion 软件版本号 string 32 M HardwareVersion
5、 硬件版本号 string 32 M ConfigFileVersion配置文件版本号 string 32 M Type 机顶盒型号 String 10 M IP 机顶盒实际 IP String 42 M CheckSum 校验码, 为整个URL(不包括校验码 E)中 每 个 字 符 的ASCII 值之和加一 Int 4 M 机顶盒升级响应 承载协议:HTTP 响应 接口方向:S C 接口功能:通过重定向方式返回升级服务器地址,具体参数由厂商自定义;如果没有升级则返回200 OK 备注说明:在响应中直接使用HTTP重定向传递升级服务器地址。 5表 2 机顶盒升级响应参数 名称名称 说明说明 数
6、据类型数据类型 长度(字节)长度(字节) 是否必选是否必选 UpgradeURL 机顶盒升级地址 string 256 M 三、 性能监测接口 机顶盒业务性能监测接口完成从机顶盒侧传递业务性能监测相关参数给管理平台。 为完成此功能,要求机顶盒内嵌进行业务性能参数采集的客户端软件,并根据以下接口时序,按照格式要求上传质量参数文件。 根据性能监测需求不同,本接口分成主动上报监测和被动上报监测接口。本技术要求只规定主动上报监测的要求。 主动上报监测主要由机顶盒根据配置要求,定时向管理服务器上报质量参数,便于服务器对机顶盒质量进行后续分析和故障定位。 (一)主动上报监测接口时序 图 2 主动上报监测接
7、口 机顶盒开机后,主动上报监测接口包括如下过程: 机顶盒 终端管理系统 开机 a).监测配置 b). 上报监测参数文件 6a).机顶盒进行监测配置,配置文件上传方式、上传地址、上传帐号、上传密码、周期等。如机顶盒已配置,该步骤在二次开机后可不进行。 b).机顶盒根据配置文件,执行监测参数采集和统计工作并上报监测参数文件。 (二)主动上报监测接口协议内容 主动上报监测接口协议可以采用 HTTP 或 FTP 方式。 1状态性能参数文件 状态性能参数文件的文件名命名规则如下: “用户帐号”_“IP 地址”_“统计周期起始时间”_“周期时长”.csv ?“用户帐号” :即用户的宽带接入帐号; ?“IP
8、 地址” 采用 xxx-xxx-xxx-xxx 表示,用“-”分开每个地址段,每个地址段不满 3 位前面用 0 填写; ?“统计周期起始时间”采用 yymmddhhmm 表示,即 2 位年、2 位月、2 位日、2 位小时、2 位分的数字表示; ?“周期时长” :以 s 为单位,采用 mmmm 表示,即 4 位的数字表示。周期时长为日志文件实际记录的周期时长。 举例:宽带接入帐号为 ad51898507,机顶盒获取的 IP地址为 10.8.6.22,统计周期开始时间为 2007 年 8 月 11 日19:12,统计时长为 40 分钟(2400s)的性能参数文件,其文件名应为: 51898507_
9、010-008-006-022_0708111912_2400.csv 状态性能参数文件记录要求:对采用文件形式记录状态7性能参数,要求采用以下记录规则: 下表为各类事件所需的字段: 字段选择 事件字段 事 件 标 记 出 现 次 数 产 生 时 间 组播 / 单播 / EPG位置信息 失败原因代码 Startpoint(可选) ? Endpoint(可选) ? AuthNumbers ? ? AuthFailNumbers ? ? AuthFailInfo ? ? ? ? MultiReqNumbers ? ? MultiFailNumbers ? ? MultiFailInfo ? ? ?
10、 ? VodReqNumbers ? ? VodFailNumbers ? ? VodFailInfo ? ? ? ? HTTPReqNumbers ? ? HTTPFailNumbers ? ? HTTPFailInfo ? ? ? ? MutiAbendNumbers ? ? VODAbendNumbers ? ? PlayErrorNumbers ? ? PlayErrorInfo ? ? ? ? MultiPacketsLostR1Nmb ? ? MultiPacketsLostR2Nmb ? ? MultiPacketsLostR3Nmb ? ? MultiPacketsLostR4
11、Nmb ? ? MultiPacketsLostR5Nmb ? ? VODPacketsLostR1Nmb ? ? VODPacketsLostR2Nmb ? ? VODPacketsLostR3Nmb ? ? VODPacketsLostR4Nmb ? ? VODPacketsLostR5Nmb ? ? MultiBitRateR1Nmb ? ? MultiBitRateR2Nmb ? ? MultiBitRateR3Nmb ? ? MultiBitRateR4Nmb ? ? MultiBitRateR5Nmb ? ? VODBitRateR1Nmb ? ? VODBitRateR2Nmb
12、? ? VODBitRateR3Nmb ? ? 8VODBitRateR4Nmb ? ? VODBitRateR5Nmb ? ? FramesLostR1Nmb ? ? FramesLostR2Nmb ? ? FramesLostR3Nmb ? ? FramesLostR4Nmb ? ? FramesLostR5Nmb ? ? 对通过 CSV 文件记录上表中的参数,采用“,” (半角)间隔。参数格式要求如下: 1)事件标记:采用事件字段表示 2)出现次数:直接用数字表示 3)产生时间: 采用 yymmddhhmm 格式,即 2 位年、2 位月、2 位日、2 位小时、2 位分的数字表示。 4)组
13、播/单播/EPG 位置信息:用字符串表示 组播信息:igmp:/aaa.bbb.ccc.ddd:xx 单播信息:RTSP:/./xx.mpg EPG:http:/aaa.bbb.ccc.ddd:xxxx/iptvepg 5)失败原因代码::参见 中国电信IPTV 机顶盒技术规范 V2.0附录 B 机顶盒异常出错判断。如超出此范围,暂时由机顶盒厂商自定义。 51898507_010-008-006-022_0708111912_2400.csv 文件格式举例:举例仅表示格式参考 Startpoint,200708111912 Endpoint,200708111952 AuthNumbers,6
14、 AuthFailNumbers,0 AuthFailInfo,20070811191200,http:/218.80.221.9114:8080/iptvepg,504 MultiReqNumbers,3 MultiFailNumbers,1 MultiFailInfo,20070811191200,igmp:/233.80.221.114:5140,505 VodReqNumbers,0 VodFailNumbers,1 VodFailInfo,20070811191200,rtsp:/233.80.221.115:554/iptvvod/xx.mpg,506 HTTPReqNumbers
15、,0 HTTPFailNumbers,0 HTTPFailInfo,20070811191200,http:/233.80.221.116:8080/iptvvas/xx.html,507 MutiAbendNumbers,0 VODAbendNumbers,0 PlayErrorNumbers,1 PlayErrorInfo,20070811191200,no data inport,508 MultiPacketsLostR1Nmb,0 MultiPacketsLostR2Nmb,1 MultiPacketsLostR3Nmb,0 MultiPacketsLostR4Nmb,0 Multi
16、PacketsLostR5Nmb,0 VODPacketsLostR1Nmb,0 VODPacketsLostR2Nmb,0 10VODPacketsLostR3Nmb,0 VODPacketsLostR4Nmb,1 VODPacketsLostR5Nmb,2 MultiBitRateR1Nmb,1 MultiBitRateR2Nmb,1 MultiBitRateR3Nmb,0 MultiBitRateR4Nmb,0 MultiBitRateR5Nmb,0 VODBitRateR1Nmb,0 VODBitRateR2Nmb,1 VODBitRateR3Nmb,2 VODBitRateR4Nmb,3 VODBitRateR5Nmb,4 FramesL