视频联网网关(NCG)V5.11.100FAQ手册

文档编号视频联网网关(NCG)5.11.100FAQ密级级别：内部公开保密信息，未经授权禁止扩散第i保密信息，未经授权禁止扩散第i页2020-06-16目录组件介绍 1参考资料 1组件组成 1版本说明 1运行环境 3端口列表 3架构和流程 6系统架构 6内部结构 8联网配置流程 9联网网关配置功能流程 9外域添加功能流程 9主要业务流程 10资源共享功能流程 10云台控制流程 11录像查询流程 12级联-国标/DB33-UDP取流功能流程 13级联-国标/DB33-hik_tcp私有协议取流功能流程 14级联-国标-tcp协议取流功能流程 15国标代理场景下关键流程补充说明 16问题排查方法 23维护步骤 23日志查看方法 24日志使用方法 27如何排查和定位问题 31如何确认网络情况 31如何更新替换组件版本 31如何获取组件的版本信息 34如何收集异常时的关键信息 34常见问题 35安装部署 35程序启动失败 35配置问题 364.2.1 开启国标集群代理 36资源目录相关问题 38资源任务可视化 41标准资源校验 42取流问题 43预览取流失败 43预览黑屏 45预览卡顿 46预览几十秒后断流 46INVITE、ACK、BYE信令没有响应或发送 46INVITE、200OK报文携带收流、发送地址不正确 47云台问题 47录像查询问题 47国标代理场景下的问题 48典型场景/方案问题 50日志排查 50日志模块说明 507.附录 51关键bug修订记录 51错误码说明 52联网信令服务cascade错误码 52WEB服务错误码 59联网媒体服务media错误码 60常用工具使用 63抓包工具Wireshark 63码流查看分析工具 64Windows调试工具Windbg 65历史版本信息 65内部架构 658.修订记录 66密级级别：内部公开第PAGE第10页2020-06-16组件介绍参考资料名称用途NCG组件（5.11.100）安装部署手册包含组件的安装、卸载、升级、配置等相关的说明NCG组件（5.11.100）用户使用手册包含组件前端的操作步骤、流程等说明NCG组件（5.11.100）功能规格清单包含组件的功能、性能、安全等规格说明NCG（5.11.100）端口清单包含组件所使用的端口、及功能、协议说明组件组成NCG专注于平台域间视频联网，基于标准协议与外域平台互联互通，支持视频通用标准协议（2811,/2816DB/01网B协议接口等。主要业务功能包括：域间注册与心跳、资源同步、实时预览、录像回放与控制、录像下载、语音广播、设备控制等NCG由cascade(国标联网信令服务)、ncg-db33(DB33联网信令服务)、media(联网媒体服务)、web(cascadencg-db335.6.0cascade(联5.70saDB33(ncg-db33)。cascadencg-db33态。本文中没有特别提出的情况下，cascadeNCGPGsql、ActiveMq、TomcatPGsqlcascade、web数据管理，ActiveMqcascadeTomcatweb版本说明NCG5.11.100版本更新信息：5.11.1005.10.100ARARPTZ询，调用)GPS支持巡检成功点位导入共享功能支持手动共享下级域资源到本级平台支持信令链路负载监控csvcn支持国标集群代理5.10.1005.9.1001.取流流程优化新增异常资源删除可视化任务16新增启动增加待删外域的检测与处理GB35114A支持驱动管理支持高倍速抽帧支持国标信令流量监控5.9.1005.8.1001.支持资源目录可视化操作支持国标协议集群代理CSVNCG支持第三方联网协议JT809/1078媒体链路可视化视频回放专项优化5.8.1005.7.1001.支持业务树的推送、解析支持推送语音通道支持删除自己建立的行政区划组织支持检索本级的资源ldap5.7.1005.6.1001.新增平滑升级功能新增国际化需求(多语言、多时区、exe新增公安获取扩展能力集功能LDAP新增获取视频本域标识的接口新增关键内部错误码优化新增内码级联功能修改录像查询返回的录像文件大小可能变成负数的问题修改录像查询返回的录像类型和下级不匹配问题修改上报可视域信息为空的问题运行环境硬件环境：推荐配置视频联网网关服务CPUIntelXeonE3-1225v33.2GHz4核8线程内存8GBDDR3硬盘500GB网卡Intel1000MNIC*2（安装最新网卡驱动）显卡Intel(R)HDGraphicsP4600/P4700软件环境：软件环境支持操作系统环境CentOS7.2x86_64CentOS7.4x86_64CentOS7.6x86_64Java运行环境OracleJava8/11运行环境应用服务器环境Tomcat8.0/8.5数据库环境PostgreSQL9.6浏览器环境Chrome40IE9-11端口列表端口参数查看及配置方法：运行管理中心->系统维护->参数配置->视频联网网关->填写需要修改的端口->下发。->选中端口->下发。5.11.100：端口号使用场景映射改传输方式7100国标协议通信端口是是UDP/TCP7110DB33是是UDP711835114是是UDP/TCP7093私有协议通信端口否是TCP915535114子服务restful口否是TCP/HTTP7097私有协议通信端口否是TCP7099restful否是TCP/HTTP8198restful否是TCP/HTTP7010NCG否是TCP/HTTP7087rtsp是是TCP7304集群管理端口否是TCP/UDP6009websocket是是TCP26100-26899视频流传输端口段是是UDP/TCP8080WEB否是TCP9181否是TCP/HTTP8860/8862/8866/8868取流时所用端口否是UDP7116SIP是是UDP/TCP9072SIP口否是TCP/HTTP7119否是UDP/TCP5.10.100：端口号使用场景是否需要映射是否可修改传输方式7100国标协议通信端口是是UDP/TCP7110DB33是是UDP711835114是是UDP/TCP7093私有协议通信端口否是TCP915535114子服务restful端口否是TCP/HTTP7097私有协议通信端口否是TCP7099restful否是TCP/HTTP8198restful否是TCP/HTTP7010NCG否是TCP/HTTP7087rtsp是是TCP7304集群管理端口否是TCP/UDP6009websocket是是TCP26100-26899视频流传输端口段是是UDP/TCP8080WEB否是TCP9181否是TCP/HTTP8860/8862/8866/8868媒体网关通过组播方式(被动)取流时所用端口否是UDP5.9.100：端口号使用场景是否需要映射是否可修改传输方式7100国标协议通信端口是是UDP/TCP7110DB33是是UDP7097私有协议通信端口否是TCP7099国标子服务restful否是TCP/HTTP8198地标子服务restful否是TCP/HTTP7010NCG否是TCP/HTTP7087rtsp是是TCP7304集群管理端口否是TCP/UDP6009websocket是是TCP26100-26899视频流传输端口段是是UDP/TCP8080WEB否是TCP5.8.100：端口号使用场景是否需要映射是否可修改传输方式7100国标协议通信端口是是UDP/TCP7110DB33是是UDP7097私有协议通信端口否是TCP7099国标子服务restful否是TCP/HTTP8198地标子服务restful否是TCP/HTTP7010NCG否是TCP/HTTP7087rtsp是是TCP7304集群管理端口否是TCP/UDP6009websocket是是TCP26100-26899视频流传输端口段是是UDP/TCP8080WEB否是TCP5.7.100：端口号使用场景是否需要映射是否可修改传输方式7100国标协议通信端口是是UDP/TCP7110DB33是是UDP7097私有协议通信端口否是TCP7099国标子服务restful否是TCP/HTTP8198地标子服务restful否是TCP/HTTP7010NCG否是TCP/HTTP7087rtsp是是TCP7304集群管理端口否是TCP/UDP6009websocket是是TCP26100-26899视频流传输端口段是是UDP/TCP8080WEB否是TCP5.6.100：端口号使用场景是否需要映射是否可修改传输方式7100/7110标准协议通信端口是是UDP/TCP7097私有协议通信端口是是TCP7099/7010restful否是TCP/HTTP7087rtsp是是TCP7304集群管理端口否是TCP/UDP6009websocket是是TCP26100-26899视频流传输端口段是是UDP/TCP8080WEB否是TCP架构和流程系统架构频监控平台的互联互通、资源共享。视频联网网关在跨域视频监控联网中的位置如图2.1.1所示。图中有四个不同域，实现不同域之间的两个域之间是平级关系，互相注册，经过对方鉴权认证后，才能进行域间通信。区域视频监控系区域视频监控系1区域视频监控系2用户终端用户终端监控资源监控资源传输网络传输网络监控中心报警数据报警数据监控中心联网网关联网网关联网网关联网网关区域视频监控系m区域视频监控系n用户终端报警数据报警数据用户终端传输网络传输网络监控中心监控资源监控资源监控中心跨域视频监控联网结构图内部结构联网网关的设计是基于模块化/插件化的设计思想，子模块尽可能遵循强内聚、松耦合和信息隐藏的asae，负责以国标信令规范本级域和外域平台的信令交互，协议管理，对外提供接口；一个进程是地标信令网关3，负责以地标信令规范本级域和外域平台的信令交互，协议管理，对外提供接口；一个进程是联网管理服务(Web)tomcatmedia)，负责媒体流转发。但当需要进行转码时，会里就不重复贴出了。历史版本（5.6.0）如见附录7.3.1所示。通用视频联网服务组GB/T28181通用视频联网服务组GB/T28181联网服务1GB/T28181联网服务n通用视频联网服务组DB33/T629联网服务1DB33/T629联网服务n客户端应用资源 控制客户端应用资源 控制视频流事件API接口联网网关服务寻址联网管理服务数据库服务WEB配置操作管理设备控制设备状态同步通知媒体服务1多线路管理外域管理资源管理转码管理理理度管理媒体服务n联网协议接入层本地联网驱动守护服务SIP信令代理服务资源 控制视频流下级域平台行业组件核心服务视频网管事件服务上级域平台网驱动n网驱动1联网配置流程联网网关配置功能流程WEBCASCADEDBWEBCASCADEDB启动获取网关初始化信息初始化写入插件配置修改200OK 配置修改Webcascade200OK，然后将变更信息写入数据库及cascade.xmlcascadecascade.xml外域添加功能流程WEB

PGsql

cascade

协议插件插入数据库向信令网关发送请求RESTful+CASCADE_INFO4.200ok获取状态进行展示获取状态进行展示

调用对应协议插件添加上下级回调更新域状态

添加上级域时主动向上注册，添加下级域时等待下级注册WEBCASCADEWEBpgsql主要业务流程资源共享功能流程资源共享功能按共享目标分有两种流程，共享给本级、共享给上级。目前下级资源共享给本级已由程序自动完成，无需配置或手动操作。下级资源推送给本级功能流程：cascade.cascadeldap，同时发送资源变更通知(mq).ldap下级 上级下级cascade下级cascadeAP发送资源变更通知mqLDAPAP发送资源变更通知mqLDAPpgsql其他组件200OK 入库录入LD资源自动推送到本级流程图WEBcascadecascade异步共享，cascadeWEBweb到上级，这种情况适用于共享资源数量较多时。上级上级下级上级联网服务cascadeWEBDB共享操作推送 循环处理获取共享关系推送取消共享方式1简单取消共享 推送DEL 循环处理共享给上级操作2.4.2共享资源到上级流程图云台控制流程cascadecascadeNCG客户端 上级cascade 下级cascade 下级DAC客户端上级cascade下级cascade下级DACncgwebncgweb云台控制命令 云台控制命令控制结果

控制结果

云台控制命令控制结果 录像查询流程

RESTful客户端联网共享ncgweb上级cascade下级cascade联网共享2.4.4所示，录像的存放位置等信息由联网共享管理，上级文件转发回上级客户端。客户端联网共享ncgweb上级cascade下级cascade联网共享录像查询寻址录像查询 录像查询指令录像文件列表

录像查询指令录像文件列表 录像文件列表 录像查询流程级联-国标/DB33-UDPDas-media/MGCncgmediaCASCADENCGNCGncgmedia WEB CASCADE联网共享客户端国标/DB33-UDPRESTful接口获取取流URL(短连接URL)客户端调用StreamClient取流接口，通过获取到的URL向NCGmediamedia通过短连接URLURLmedia向WEBcascademediacascademediacascadecascadecascadeURLURL)cascademediamediaURL级联-国标/DB33-hik_tcp客户端联网共享NCGncgmedia WEBCASCADENCGCASCADE WEB Das-media/MGC国标/DB33-hik_tcpRESTful接口获取取流URL(短连接URL)客户端调用StreamClient取流接口，通过获取到的URL向NCGmediamedia通过短连接URLURLmedia向WEBcascademediacascadecascadecascade获取取流URLmediamediaURLmediamediaWEBcascademediacascadecascadeURLcascademediamediaURL去联网共享获取长连接URLmediaURL级联-国标-tcp被动模式：客户端联网共享ncgmediaNCGWEB CASCADENCGCASCADEncgmedia联网共享Das-media/MGC主动模式：客户端联网共享ncgmediaNCGWEB CASCADENCGCASCADEncgmedia联网共享Das-media/MGCRESTful接口获取取流URL(短连接URL)客户端调用StreamClient取流接口，通过获取到的URL向NCGmediamedia通过短连接URLURLmedia向WEBcascademediacascademediacascadecascadecascadeURLURL)cascademediamediaURL去联网共享获取长连接URL下级media通过长连接URLmedia主动向上级mediaTCPmediamediaTCP国标代理场景下关键流程补充说明目前只有取流(预览或回放)才能做到完全的负载均衡，也即每个取流过程都会被负载到不同的信令网cascade性，存在挂载关系，不能分开发送，所以目前只能做到非完全负载均衡；也即当A信令网关cascadeAA代理后，集群代理会绑定一个信令网关进行后续此下级所有资源通知的接收，直到此信令网关异常崩溃；异常崩溃后将转移到其他的信令网关；外域对本级的取流(完全负载均衡)sdsd外域取流负载均衡外域(下级或上级)国标集群代理INVITE(cassipagent)轮训机制选择信令网关cascadeINVITE信令网关(cascade) 1XX-6XX 1XX-6XX ACKACKCANCEL/BYE/INFOCANCEL/BYE/INFO2XX-6XX2XX-6XXoptBYE(被动结 束)/MESSAGE(文件 结束)2XX-6XXBYE(被动结(文件结束)2XX-6XX名称: 外域取流负载均衡作者: hongguohai版本: 1.0Created:2019/3/70:00:00更新日期:2019/11/1518:05:41本级对外域的取流(完全负载均衡)sdsd本域取流负载均衡媒体网关MEDIA获取信令网关HTTPNCGWEB后台国标集群代理(cassipagent)信令网关 域(下级或上级)(cascade)轮训机制获取信令网关cascade信令网关200INVITE名称: 本域取流负载均衡作者: hongguohai版本: 1.0Created:2019/3/60:00:00更新日期: 2019/3/620:54:13INVITE1XX-6XX1XX-6XXACK/INFO/BYE/CANCELACK/INFO/BYE/CANCEL2XX-6XX2XX-6XXoptBYE(被动结束)/MESSAGE(文件结束标志)BYE/MESSAGE 2XX-6XX2XX-6XX本级对下级抓包示例说明完整流程200OK:下级-》集群代理200OK:集群代理-》本级ACK:本级-》集群代理ACK:集群代理-》下级BYE:本级-》集群代理BYE:集群代理-》下级BYE200OK:下级-》集群代理BYE200OK:集群代理-》本级上级对本级抓包示例说明Record-RouteRoute2.8contact头域；默认端口说明NCG国7100NCG国7100NCGNCG7100外域(1...m)上级/下级SIP信令标集群代理(cassipagent)7116711990727100Cascade(1...n)ncgwebSIPTCP和UDP信令负载日志查看问题排查方法维护步骤.1运管查看告警步骤.2运管进入NCGNCGweb.43.1.4NCG3.1.4NCG日志查看方法运行管理中心查看：webNCG3.2.1所示。其中选择查询的时间段为必选项，其下方可以IP3.2.1运管中心查看操作日志若操作日志无法定位问题，可以进一步查看系统日志，运行管理中心中查看系统日志的方法如图3.2.2所示，依照图中的带圈数字顺序进行查看。3.2.2运管中心查看日志步骤服务器查看：远程连接服务器，找到文件夹：\web\components\ncg.1\logs，然后查看对应模块的日志。日志文件夹结构：cascadencg.cascade.debug.logdebugncg.cascade.debug.monitor.log：国标子服务监控日志ncg.cascade.dts.loghtracencg.cascade.error.log：.logdebuglocalNotifydebug（消息队列交互）ncg.cascade.stream_client.debug.logdebugmediancg.media.debug.logdebugncg.media.debug.monitor.log：媒体网关监控日志ncg.media.dts.loghtracencg.media.error.logerrorncg.media.HPSC.log：HPSC.loginfoNodeProxyinfo（联网共享交互）ncg-db33ncg.ncg-db33.debug.log：.logdebuglocalNotifydebug（消息队列交互）ncg.ncg-db33.stream_client.debug.logdebug\web\components\tomcat85win64.1\logs\ncgwebncg.ncgweb.business.log：联网管理服务操作日志ncg.ncgweb.debug.logdebugncg.ncgweb.dts.log：联网管理服务调用链追踪日志ncg.ncgweb.error.logerror（SPRING）日志使用方法.1所示。3.3.1错误码查看方法cascade关键业务关键错误码说明搜索关键字启动(正常流程)cascadebeginstartcascadeserver启动0x02200409从配置文件读取配置参数错误getconfigParamfromfilefail0x02200412加载协议插件失败或初始化失败CProtocolPluginMgrinitfail0x02200414类初始化失败StartAgentSdkinitfail程)向上级注册registerto收到下级注册DownCascadeRegister0x02200439对应的级联域不存在notfindcascade0x02200440对应的下级不在线downcascadeserverisoffline0x02200472级联服务器用户编码为空Ccindexcodeisempty0x02200473级联服务器域编码为空Ccindexcodeisempty0x02200516未发现指定下级信令网关getdowncascadebyindexcodefail0x02200517未找到指定上级信令网关getupcascadebyindexcodefail资源相关(正常流程)restfuldoRestfulResShare收到并保存下级推送的点位recvdowncamerainfo收到上级资源检索请求get28181catalog向上级推送资源SENDNOTIFYcamerais资源相关0x02200438该监控点不存在notfindcameraGetCameraInfofailed0x02200444该设备不存在notfinddevice0x02200445本级或下级发现监控点编码冲突thesamecameraindexexist0x0220046e监控点编码为空cameraindexcodeisempty0x02200474根据共享的监控点编码未查询到具体监控点信息notfindshareNode取流（正常流程）restfulrecvncg.mediastartStreamreqsiprecvupinvitereq取流(错误)0x02200702预览取流失败StartPreviewStreamOperfailed0x02200703回放取流失败StartPlaybackStreamOperfailed0x02200704下载取流失败StartDownLoadStreamOperfailed0x02200709取流并发上限或繁忙restfulreqreachmaxnum0x022004520filenumiszero0x0220045430squeryrecordFiletimeout0x02200458urlgetpreviewurlfailedrestfulRestfulPtzCtrlrestfulRestfulPresetrestfulRestfulPtzParksipProcPtzControlReqsipProcPtzPresetReqsipProcPtzHomePositionReq云台相关(错误)0x02200449云台服务器返回云台控制失败操作0x0220044c云台预置位查询失败0x0220044d10s返回0x0220044e当前的级联协议不支持这个云/预置位命令meida关键业务错误码说明搜索关键字媒体网关启动成功mediaMediaServer_StartServer,StartServer[ncg://:7010]success取流成功取流开始日志RTSPProtocolWrapperClientetFd=xxx视频头PlatDeviceProtocolWrapperPluginDataCB,recvheadercallback流成功RTSPProtocolWrapperStartStreamsuccess转封装成功回调TransformFilterOnSysTransDatacallback,recvheader取流成功并发送码流playok,LogID:xxx服务启动失败0x02230802xmlxml是否异常loadxxx.xmlfail0x02230801dllHPR_LoadDSoFail取流失败或者断流0x02230822SocketBindfail0x02230824SocketHPR_AcceptFail0x02230825SocketSendDatafail0x02230827socketsocketmayclose0x02230849断流异常CheckStreamInterrupt0x02230959rtspCheckHeartBeatTimeout,rtspHeartBeatTimeout,thesessionwillstop0x0223085B协议处理链相关模块，url失败cUriParserParseUrlfail0x022308CB协议栈未收到媒体头Waitforstreamtimeout0x022316F5DESCRIBE的时候，其实就是取流超时CStreamClientSessionStreamClient_StartStreamFail,StreamClient_StartStreamFailweb关键业务关键错误码说明搜索关键字本级域资源同步执行资源同步executeldapSyn自动共享执行自动共享executecascadeAutoShare资源共享、检索0x02200250资源正在共享Sharingtheresources0x02200251先删除组织，才能删除资源Deletechildorganizationfirst0x02200252先取消共享，才能删除Cancelsharingfirst0x0220018c父组织不存在Parentunitisnotexist0x02200190Maincenteroflocalcascade子服务地址加载加载子服务地址executeserverAddressLoad本域网关信息加载加载本域网关信息executeserverNetConfig外域)0x02200101参数错误Paramserror0x02200172数据已经存在Thedataalreadyexists0x02200262Codeandexternaldomain0x02200174添加更新删除失败Notalladded/updated/deleted数据库、文件操作0x02200170数据库操作异常SQLoperationerror0x02200148CSVcsvfileformaterror0x02200122读取读取properties文件失败propertiesparseerror调用接口（cascade，核心0x02200120调用核心服务接口失败FailedtocallBICinterface0x02200114信令网关连接出错Cascadeconnectionerror0x02200161restCallresttemplateerror如何排查和定位问题对较复杂，遇到问题时，可以按如下步骤逐步排查定位:排查基本配置类、网络类、通识类等问题UDPIDDB33使用预置位功能等。clientncg日志看到VNSCNCG如何确认网络情况NCG确认上下级域IP是否能连接，可直接通过界面状态查看。NCG添加的上下级域，都会进行域连接状态监测(pingweb确认媒体网关mediaIPIPCMDpinga的PD命令too.e工具。如何更新替换组件版本装，具体步骤如下：在运管中心-系统维护-软件安装界面，选择已安装的联网网关，点击卸载:在运管中心-系统维护-软件包管理中添加新的NCG添加完成后会有软件包信息提示:安装完成后右窗口栏会有完成提示：如何获取组件的版本信息如何收集异常时的关键信息关键信息收集步骤如下：收集版本信息3.4cascade.dll收集异常时间点的日志。dump收集对应报文信息wireshark常见问题安装部署4.1.1分析启动失败具体原因。其中程序启动失败原因和对应的错误码：原因错误码体现读取核心配置失败0x02200558端口冲突，程序启动失败0x02200544数据库连接失败，程序启动失败0x0220050c其他启动失败可能原因：可能原因解决方法dlldll对应cascade.exe，观察是否报系统类错误。配置问题常见现象解决方法上下级域配置上级域或者下级域显示不在线sockettool配置鉴权信息要一致。地址、端口）是否填写正确。通过抓包，查看注册（Register）流程是否正常。线，过一段时间显示不在线交互？有第三方厂商时，确认上下级间心跳周期是否一致。外网域配置外域来取流或被取流失败4.2.1开启国标集群代理目前只有NCG5.9.1005.11.1001SIPNCGwebNCGweb联网网关/网关配置/网关配置/编辑网域/”在外域配置页面选择关联代理服务资源目录相关问题本级域资源与平台不同步（ncg）ncgncgldap主机，到安装目录/opt/hikvision/web/components/tomcat85linux64.1/logs/ncgweb下找到ncg.ncgweb.debug.logLdap[com.hikvision.ncgweb.service.UnitResourceInit:444]convertlocalResourceInfoerror:java.lang.IllegalArgumentExceptionIllegalArgumentexternalIndexCodeLdap2019-06-20T22:53:08.392+08:00ERRORncg.ncgweb[ActiveMQSessionTask-4][c.h.ncgweb.service.impl.LdapResourceByConsumerImpl:347]convertlocalResourceInfoerror:java.sql.SQLIntegrityConstraintViolationException:ERROR:duplicatekeyvalueviolatesuniqueconstraint"localunit_unique_indexcode"Detail:Key(indexcode)=(32058400002000000000)alreadyexists.存在上述问题，联系平台视频服务外码异常的原因，资源外码为空的情况通常可以在平台添加区域时勾选国标来解决。共享操作提示SQLcode0x02200170messageSQL存在共享脏数据，一般由外域编码配置引起。解决方案：然后，重新向上级共享资源。组织树展示不全通过运管中心状态监控界面，查找ActiveMQMQActiveMQ通过运管中心日志分析界面，查找下级NCG0x02200563原因: 下级推送给上级资源信息，返回失败。措施：检查上级域运行情况或级联网络情况。其他目录同步相关问题解决办法：其他常见现象解决方法上级平台里面看不到下级资源检查上级联网网关，“资源检索”里面，是否已经接收到下级资源；如果接收到了下级资源，在“资源共享”里，将下级资源共享给本级平台；上级联网网关里看不到下级资源确认，查看是否有资源推送消息。如果下级平台是第三方平台，在“资源检索”里面，对该下级域，进行资源检索操作，并抓包确认，是否有资源检索、检索响应消息。11-13131，civilcode经推送。dSN果前、后两次相同，后面一次目录查询会没响应。数据冗余享，取消共享成功后，再删除该上级域配置。删除某个下级域配置之前，先将共享给本级域和所有上级域的该下里，将该下级的组织、监控点全部清除。添加上、下级时，避免添加域编号相同的上级或者下级。资源任务可视化NCGV5.9.100。标准资源校验平台，可能是下级的资源不标准导致。NCGV5.9.100新增标准资源校验功能，对下级推送的资源编码进行标准化校验。校验规则如下：域编码20位330000xxxxxxxxxxxxxx，杭州市域编330102xxxxxxxxxxxxxx）组织4、6、8、20位编码要求纯数字和域编码有关联(前几位要和域编码所在行政区划编码一致，如允许杭州市(330100xxxxxxxxxxxxxx)(330000xxxxxxxxxxxxxx)这级组织和杭州市下的其他组织(330102xxxxxxxxxxxxxx))4、6位时，需要满足行政区划规范字典点位20位编码需要纯数字位要符合监控点类型(131、132)2、4、6、8、20位(33，33)父组织编码和域编码有关联(父组织编码前几位要和域编码所在行政区划编码一致)2、4、6位时，需要满足行政区划规范字典如资源编码不满足以上要求，则会在NCG页面上创建“非标资源”的目录，存放不标准的资源。不标准资源将不会同步到平台中。某派出所，上级NCG组织只能在上级进行删除)享，调整后再进行推送。取流问题预览取流失败解决办法：通过播放软件报错提示信息，找到对应的错误原因。常见错误如下：对应监控点已不能预览。联网媒体服务异常。监控点不存在，已被删除或编码改变。监控点未共享，需重新共享。下级域连接异常。通过日志埋点跟踪功能，获取取流失败流程，进行问题分析排查。通过抓包进行取流报文分析，找到具体原因。下图为国标协议取流信令抓包分析。预览黑屏解决办法：使用联网网关测试客户端进行测试，查看是否取流正常。客户端预览长时间黑屏，不提示错误。此种情况一般是有码流发送到客户端，但客户端解码不了。一种方式，可通过客户端录像功能，将码流录制下来，用播放器看能否正常播放；另外，通过抓包，将客户端收到的码流抓下来，保存成文件，看能否播放，可以查看是否有丢包乱序。播放时，先用公司播放器进行播放，再用开源播放器码组研发处理。客户端预览开始黑屏，然后提示失败。此种情况，一般是信令成功，但流没有发送到客户端，流超时失败。可通进一步通过抓包、日志确认哪一个环节出现了问题。如果码流到了上级联网网关，但没有转发给客户端，一般是由于下级回复的200ok和上级实际收到的码流的来源地址、端口不一致造成的。可以由网闸来支持修改200okmedia（CheckRTPSrc0），不检验来源地址和端口。RTPRTPSequence到客户端或者再上一级。预览卡顿解决办法：通过客户端录像功能，将码流录制下来，用播放器看是否存在卡顿现象，排查是否客户端收到的码流是否有问题。通过抓包，将客户端收到的码流抓下来，看是否有丢包乱序，保存成文件是否正常播放；在上级联网网关抓包，看上级联网网关收到的码流是否有丢包乱序，保存成文件是否正常播放；在下级联网网关抓包，看发出去的码流看是否有丢包乱序，保存成文件是否正常播放。器可以正常播放但公司播放器播放异常，将抓包或者码流发给解码组研发处理。预览几十秒后断流解决办法：如果上级不支持流保活，几十秒后会断流。需要上级支持，或者到上级域配置界面，把流保活关掉。如果都支持，检查网络，上下级网关之间，上级网关和客户端之间需要取流端口（网关端口是5100-5700）SocketToolINVITE、ACK、BYE解决办法：INVITE、200OK、ACK报文sipcontactip确。INVITE、200OK解决办法：webipIP云台问题解决办法：先查看本级平台是否能正常控制，如果可以请进行抓包下图为国标级联协议的PTZ录像查询问题解决办法：根据应用报错信息，在运管界面进行错误码查询，找到具体错误原因。查看客户端输入查询时间及客户端所在电脑时间是否正确，抓包确认传到的下级的查询时间是否正常。通过客户端日志或者抓包，查看下级返回的错误码，根据错误码对照表，进行错误排查。如果本级平台能够查询，上级查询不了，本级查询一次，在上级在查询一次，看联网共享日志，对应两次的查询信息，是否有不一致的地方。SN下图为国标级联协议录像查询抓包分析。国标代理场景下的问题开启或关闭代理后一般问题有哪些？本级被代理的Cascade开启代理后未配置代理的网域cascade端口或域编码cascadeIDcascade每次重启后ID集群代理在启动成功后，会向各个cascade广播自己，每个cascade收到广播后，会找集群代理重新注册；ncg.agent.logcascade的个数；其中total“addworknode信令网关IP@端口,id=ID,total=当前活动节点总数”感知到？本级信令节点挂了之后多久能恢复工作？集群代理和本级信令网关间，采用TCP长连接，因此如果本级信令网关出现重启，会1秒内立刻感知到信令网关异常，并进行剔除；在连接断开后，代理中会出现如下日志：“TCPPear信令网关IP@端口disconnect”“delworknode信令网关IP@端口,total=当前活动节点总数,id=ID”日志会记录如下：“addworknode信令网关IP@端口,id=ID,total=当前活动节点总数”目前集群代理和信令网关之间没有心跳机制！信令网关中；ncgweb行有始有终的挂载落地；除了资源联网，另外还有个设备(云台)控制的操作也是非负载均衡的；因为设备控制包括开始控制和结束cascade否则可能会导致被AB去；因此为了规避这种不频繁的业务的需求，常离线后重新进行选择。抓包流程是否比以前复杂了？网关的情况下，动作的执行是均衡的，因此排查问题时定位到信令网关比较困难；进入到此信令网关查看异常日志。典型场景/方案问题日志排查日志模块说明服务日志路径(cascade)ncglogs/cascade日志名称为ncg.cascade.{日志级别}.logncg.cascade.debug.logmedia)ncglogs/media日志名称为ncg.media.{日志级别}.log，ncg.media.debug.logWebtomcatlogs/ncgweb日志名称为ncg.ncgweb.{日志级别}.logncg.ncgweb.debug.logcascade日志路径GB/T28181-2016ncglogs/cascade日志名称为ncg.cascade_gb(2016)Plug.logDB33ncglogs/cascade日志名称为ncg.cascade_db33plug.log附录关键bug版本号标题严重级别验证日期5.4.0、5.6.0ISC平台ncg高2018-12-065.6.0致平台获取到数据高2018-12-245.6.0共享给上级高2018-11-055.6.0ncg中2019-01-045.6.0回放内置vod（vod，urlHPSclient）中2019-01-045.6.01000中2019-01-045.7.0DB33享成功高2018-12-205.7.0预览、回放均取流失败高2018-12-245.7.0页面无法进入高2018-11-155.7.0在上级ncgweb，ldap中2018-11-155.7.0中级44mediadump中2019-01-045.7.0cascade2G中2019-01-045.7.0级取流成功中2018-11-275.7.02服务中2018-12-275.7.00x0220061a（restful）中2019-01-045.7.0event为off中2019-01-045.7.0web0x02200147中2018-11-21错误码说明cascade错误码描述建议0x02200400hpr1.检测库文件(hpr.dll/hpr.so)是否存在,如不存在请补充;2.重启信令网关服务查看错误是否还存在;3HPR0x02200401创建定时器失败1.重启信令网关服务查看错误是否还存在;2.系统资源是否已达到上限0x022004021.检测库文件(letterLib.dll/letterLib.so)是否存在,如不存在请补充;2.重启信令网关服;3.检查库版本是否太老0x02200403创建线程失败1.尝试重启信令网关服务;2.检查系统有足够的0x022004091.查看日志,检查配置文件是否正确0x02200411streamclient1.streamclient;2.尝试重启信令网关服务0x02200412加载协议插件失败1.检查安装文件夹中是否有插件;2.检查插件配置文件内容是否正确0x02200413身份认证库初始化失败120x02200414类初始化失败1.重启信令网关服务;2.收集日志，找研发人员解决0x02200415factory1.检查系统空闲内存是否充足;2.尝试重启信令网关0x0220041b文件操作失败1.尝试重新操作,检查现象是否消除;2.在运管(日志分析->联网网关->联网信令服务)查看错是磁盘空间不够,请清理空间0x0220041eMQ1.MQ2.重启信令网关服务0x0220041fhkpxml1.查看日志，确认报文是否符合规范;2.抓包确认报文是否正常0x02200421hkpxml1.查看日志，确认报文是否符合规范0x02200422hkpxml1.查看日志，确认报文是否符合规范0x02200423hkp1.查看日志,确认对方是否未注册或已保活失败0x022004241.查看日志确认具体原因0x02200425hkpsocket（7100）1.查看日志，确认端口是否被占用;2.重启信令网关服务0x02200426hkp务器1.在网页上检查该外域是否存在0x02200427hkp1.查看日志，确认是否报文过大导致0x02200428IdURL1.mediaSessionID不为空0x02200429报文为空1.查看日志，确认具体业务0x0220042a找不到会话信息1查看日志0x02200438该监控点不存在已共享;2.如未共享请重新配置共享后尝试操作;3.如不存在请到对应下级域检查该监控点是否已共享给上级;4.如已共享，请重启服务后再尝试0x022004391.在运管(日志分析->联网网关->联网信令服获取在网页上检查该外域是否存在;2.如不存在,则表明外域已经被删除,无需关心此错误;3.如存在此外域,尝试重新服务,查看问题已解决0x0220043ddhkp1.查看日志，检查是否对应的级联下级已删除0x02200440对应的下级不在线1.WEB线;2.如已离线请检查对应下级域是否运行正常;3.如果正常请检查上下级域配置、网络是否正常;4.如果正常请尝试重启服务,查看问题是否已解决0x02200444该设备不存在1.是否在存在0x02200445该下级监控点已存在1.应监控点编码0x02200446IO1.IO设备是否在存在0x022004491.检查在下级域该监控点是否支持云台操作0x0220044ahkpdb31查看日志0x0220044c云台预置位查询失败1.检查下级域该监控点是否支持预置位操作;2.检查下级平台日志,确认具体原因0x0220044d云台控制超时超过10s1.检查下级域或设备接入框架是否正常运行0x0220044e当前的级联协议不支持这个云台控制/预置位命令1.检查协议规格是否支持这个控制命令0x02200451录像查询失败1.通过监控点获取下级域信息,检查下级域发联网共享服务是否运行正常,如不正常请按联网共享的异常说明操作;2.检查这些查询条件在下级域是否可以查到录像,如可以查到,请在下级重0x0220045201.检查这些查询条件在对应下级域是否可以查;2.如不能,说明该无条件对应的录像;3.询录像0x02200453录像分页查询开始序号大于文件总数1.检查客户端录像查询条件0x0220045430s1.检查在对应下级域查询录像是否超时;2.如3.如不是,请重启信令服务后重新尝试0x02200455url对应文件列表不存在1查看日志0x02200456url对应文件列表查询失1查看日志0x02200457url该文件在对应文件列1查看日志0x02200458url1.请检查联网共享服务是否运行正常;2.重启联cascadevnsc0x022004591.在运管(日志分析->联网网关->联网信令服务)查看错误码所在日志，获取监控点信息，在页面确认该监控点是否有对应的设备信息;如果有请尝试重新操作;如没有请尝试重启如没有请0x0220045eMEDIA1.在运管状态界面检查媒体网关服务是否正常media3.如正常请稍后重试0x02200463MEDIA1查看日志0x02200464MEDIAmedia0x02200466超过处理上限1查看日志0x02200467设置强制关键帧失败1查看日志0x02200468上墙请求本级点位1查看日志0x02200469语音广播失败1查看日志0x0220046e监控点编码为空1.检查下级上送报文是否符合规范0x0220046fxml1查看日志0x022004720x02200473级联服务器域编码为空0x02200474监控点共享给上级节点信息未找到0x02200475上级没有该项功能权限1查看日志0x02200476xml1查看日志0x02200477xml1查看日志0x02200478解析目录编码错误1查看日志0x02200479mq重启信令网关服务0x0220047amedia1查看日志0x0220047bmedia0x0220047cmedia0x0220047dSessionId1查看日志0x0220047emedia0x0220047fmedia1查看日志0x022004800x02200481sip1查看日志0x02200482sipNULL1查看日志0x02200483sipNULL1查看日志0x02200484sipINVITE1查看日志0x022004851查看日志0x02200486message1查看日志0x02200487message1查看日志0x02200488第三方模块报错1查看日志0x02200489内部模块初始化报错1查看日志0x0220048a内部模块处理超时1查看日志0x0220048b内部模块处理错误1查看日志0x0220048csdk1查看日志0x0220048dSIP重启信令网关服务0x0220048e参数数据数据为空1查看日志0x0220048fSDK1查看日志0x02200490未知的命令类型1查看日志0x02200491sdk1查看日志0x02200492参数异常1查看日志0x02200493类初始化失败1查看日志0x02200494map1查看日志0x02200495数据库读取数据失败1查看日志0x02200496数据库更新失败1查看日志0x02200497数据库插入失败1查看日志0x02200498数据库更新不支持1查看日志0x02200499session1查看日志0x0220049ahpr1查看日志0x0220049bHTTP10s回1查看日志0x0220049ccsv1查看日志0x02200500权限不足访问被拒绝1查看日志0x02200501未找到指定的卡口1查看日志0x02200502call_id1查看日志0x02200503call_id1查看日志0x02200504SDK1查看日志0x02200505未找到指定的监控点1查看日志0x02200506cascade1查看日志0x02200507未找到指定的目录1查看日志0x02200508未找到指定的目录点1查看日志0x02200509context1查看日志0x0220050acontext1查看日志0x0220050bcontext1查看日志0x0220050c数据库连接失败1IP、端口、用户名、2是否正在运行0x0220050d数据库创建失败1查看日志0x0220050e数据库打开失败1查看日志0x0220050fSQL1查看日志0x02200510SQL1查看日志0x02200511SQL1查看日志0x02200512SQL1查看日志0x02200513SQL1查看日志0x02200514数据库获取数据失败1查看日志0x02200515未发现指定设备1查看日志0x02200516cascade1查看日志0x02200517cascade1查看日志0x02200518文件打开失败1查看日志0x02200519监控点数量超过上限1查看日志0x0220051aHIK_REQ1查看日志0x0220051bHPR_LIB1查看日志0x0220051cHTTP1查看日志0x0220051dHTTPping0x0220051e编码内容为空1查看日志0x0220051fIO1查看日志0x02200525JSON1查看日志0x02200526mediacontext1查看日志0x02200527audio_url1查看日志0x02200528media_info1查看日志0x02200529media1查看日志0x0220052a媒体请求发送失败0x0220052b媒体响应结果为失败0x0220052cURL1查看日志0x0220052d内存申请失败1查看日志0x0220052e模块销毁失败1查看日志0x0220052f模块初始化失败1查看日志0x02200530MQMQ0x02200531没有可用的媒体服务器12检查媒体网关服务是否正在运行0x02200532参数异常1查看日志0x02200533插件初始化失败1检查安装目录下是否有插件的文件夹2vc20080x02200534未找到指定插件10x02200535插件发送命令请求失败1查看日志0x02200536空指针异常1查看日志0x02200537协议解析失败1查看日志0x02200538未找到指定录像文件1查看日志0x02200539录像文件搜索失败1查看日志0x0220053a资源暂时不可用1查看日志0x0220053b重启服务失败1查看日志0x0220053c运行时异常1查看日志0x0220053drestful1查看日志0x0220053esession1查看日志0x0220053fsession1查看日志0x02200540CMS1查看日志0x02200541socket1查看日志0x02200542socket1查看日志0x02200543socket1查看日志0x02200544socket1查看日志0x02200545socket1查看日志0x022005461查看日志0x02200547socket1查看日志0x02200548streamclient10x02200549系统调用失败1查看日志0x0220054a目标已存在1查看日志0x0220054b未找到指定目标1查看日志0x0220054c线程创建失败1查看日志0x0220054d定时器创建失败1查看日志0x0220054etoken检查注册表是否正确0x0220054ftoken检查注册表是否正确0x02200550trace_content1查看日志0x02200551未知的数据类型1查看日志0x02200552URL1查看日志0x02200553URL1查看日志0x02200554XML1查看日志0x02200555Propertiesconf0x02200556检查注册表是否正确0x02200557检查注册表是否正确0x02200558读取配置文件失败检查配置文件是否正确0x02200559保存配置文件失败1查看日志0x0220055ahttp重启信令网关服务0x0220055bclient1查看日志0x0220055chttp0x0220055daes1查看日志0x0220055eCallId1查看日志0x0220055f更新数据库失败SQL0x02200560数据库模块初始化失败重启信令网关服务0x02200561数据库查询时当前行数超过总行数1查看日志0x02200562程序崩溃了dmp0x02200563发送通知消息失败1查看日志0x02200564UTF81查看日志0x02200565UTF81查看日志0x02200566向上级注册返回失败鉴权等是否正确0x02200567向上级心跳返回失败1查看日志0x02200568下级未注册1查看日志0x02200569对象池创建失败1查看日志0x0220056a数据库备份失败0x0220056b报警复位失败1查看日志0x0220056c队列创建失败1查看日志0x0220056d捕捉到异常1查看日志0x0220056ecsv检查对应服务是否正确0x0220056factiveMq1查看日志0x02200570xml1查看日志0x02200571xml1查看日志0x02200572增加或修改资源失败1查看日志0x02200573URL1查看日志0x02200574执行脚本失败1查看日志0x02200575录像文件片段开始和结束时间一致0x02200576HTTP1查看日志0x02200577HTTP失败1查看日志0x02200578取流路数超过限制1查看日志0x02200579转码路数超过限制1查看日志0x0220057a发送云台控制命令失败1查看日志0x0220057b插入取流请求队列失败1查看日志0x0220057cactivemq重启信令网关服务器0x0220057dweb1查看日志0x0220057e1查看日志0x0220057f1查看日志0x02200580调用埋点库返回失败1查看日志0x02200581下级域离线ncg（IP）是ncgip、port、级ncg0x02200582上级域离线ncg（IP）是ncgip、port、级ncg0x02200583配置文件不存在confconfiginstallationproperties0x02200584配置文件中有值为空propertiesinstallationpropertiesWEB错误码描述建议0x02200000操作成功无0x02200100未知错误1.查看错误日志0x02200101数据不存在1.检查输入参数0x02200102参数错误1.检查输入参数0x02200103数据已存在1.检查输入参数0x02200104非法请求(tokenerror)1.token0x02200105核心服务接口调用失败1.检查核心服务接口地址是否正确0x02200106核心服务地址为空1.configproperties0x02200107更新或删除失败1.查看错误日志0x02200108添加/更新/删除部分失败1.查看错误日志0x02200109cascade1.cascade0x0220010Acascade1.检查服务器中信令网关客户端端口是否被监听0x0220010Bcascadencg/bin/cascade置文件是否有误0x0220010Ccascade1.cascade0x0220010Dxml1.xml0x0220010Esql1.查看错误日志0x0220010F请求方法不支持1.0x02200110excel1.查看错误日志0x02200111下载文件出错1.2查看错误日志0x02200112propertiesproperties0x02200113通知错误1.查看错误日志0x02200114操作文件错误1.查看错误日志0x02200115xml1.查看错误日志0x02200116密码解密失败1.查看错误日志0x02200117认证库初始化失败1.查看错误日志0x02200118null1.configproperties0x02200119rest1.查看错误日志0x0220011Arest1.查看错误日志media错误码描述建议0x02230800hpr1.hpr0x02230801dll0x02230802xml常0x02230803xml1.xml0x02230804申请内存失败过高0x02230805创建线程失败1.进程占用内存是否太大，或创建线程太多0x02230806socket1.进程是否有句柄未释放0x02230807iocp1.进程占用内存是否太大0x02230808socket1.需要检查媒体网关日志0x02230809身份认证库初始化失败1.身份认证库是否太老，或缺少依赖库0x0223080A转封装库创建会话失败1.转封装库是否太老，或缺少依赖库0x0223080B转封装库设置数据失败1.需要检查媒体网关日志0x0223080C1.需要检查媒体网关日志0x0223080D1.可能视频头是非海康头0x0223080Exml1.可能文件路径不存在0x0223080FDrvNetLib库0x02230810LDM超时0x02230811无效参数1.需要检查媒体网关日志才能知道什么参数无效0x02230812Agent1.Agent0x02230813dll1.dependsdll个函数0x022308141.Localnotify赖库0x02230815连接通知服务器失败1.检查通知服务器进程是否存在0x02230816通知服务器重连失败1.检查通知服务器进程是否存在0x02230817Hservice1.Hservice0x022308181.Hservice0x022308191.Localnotify少依赖库0x0223081AFini1.需要检查媒体网关日志0x0223081BJson1.Json0x0223081D1.检查运行管理安装配置0x0223081E1