03IPPBX常用定位工具及使用.docx

1、03IPPBX常用定位工具及使用由于IP-PBX关联配置项较多，在使用中会常出现一些由于配置或者操作不当引发的问题。这里就需要使用到一些定位工具完成对问题的跟踪分析和定位。IP-PBX在安装或者配置中常见问题定位方式主要有四种。一为日志。日志是用户进行相关操作，软件自动保留的操作过程跟踪文件，其中包括独立应用软件的各个日志，如网管日志，sc日志，穿越日志等。二为console工具。Console工具可完成呼叫相关的所有信息定位，是最常用有效的问题跟踪手段。三为网络包抓取。在使用穿越业务及SIP相关时，分析网络信息包是查询异常的直接手段。四为telnet。在定位sip栈相关问题时，需要根据tel

2、net相关输出信息进行分析。 日志 Console 网络抓包 telnet日志日志主要用来记录历史时间内产生的操作信息。部分应用软件在系统内会自动保留一定时间内的日志信息，主要是方便相关人员查看定位问题信息。这里不对日志的异常信息进行讲解。只是简单的讲述日志所在的系统位置和如何查看提取这些信息。自动生成日志信息的模块主要有：rt-sc，rt-fc，rt-fax，rt-nm，rt-ts，rt-tc。1.1日志目录Art-sc目录位置：/var/rt-vasp/log/rt-sc/0000-00-00/xx.log (0000-00-00表示年月日，xx表示日志时间，如13就是下午1点)A rt-

3、fc目录位置：/var/rt-vasp/log/rt-fc/0000-00-00/xx.logCrt-fax目录位置：/var/rt-vasp/log/rt-fax/0000-00-00/xx.logDrt-nm目录位置1：/usr/tomcat6/logs/catalina.out说明：catalina.out打开方式为tail -fn 500 catalina.out，此文件只能保留一段时间内的网管日志和及时信息日志。如要查看历史日志，目录位置如下：目录位置2：/usr/tomcat6/webapps/rt-nm/WEB-INF/rt-nm.log.0000-00-00（0000-00-0

4、0表示年月日）Ert-ts日志目录位置：/usr/local/rt-trans/ts/ rt-ts.ini操作步骤：（1）通过SSH修改配置文件中LogTo的数值。LogToFile的数值大于0（数值大于0表明写日志，等于0，表明不写日志）；LogLevel的数值设置为1-5（数值越大，表明日志越详细）。另外有一个一个LogMoudle选项all设置大于0就表示所有模块启动日志了，但是all=0并不表示不启动某些xx=1的模块的日志即all=0就表示没有任何意义。（2）重启TS程序（service rt-ts restart或是在网管上模块运状态那重启）；用ls a可以查看到此目录下隐藏的日志

5、文件。（3）抓完日志信息，必须把LogTo的数值恢复成默认值，特别LogToFile一定得恢复成0。否则到时候会生成很多日志文件，占满磁盘的容量。导致设备不能正常运行。另如果LogMoudle选项all设置大于0的值，也得恢复成0。Ert-tc日志目录位置：/usr/local/rt-trans/tc/rt-tc.ini操作步骤：同等于E中的rt-ts日志。1.2查看方式根据1.1所述目录地址可以查找到某一日期某一时间段内的所有模块运行和工作信息。如出现异常，工程人员可以对照时间点从日志内抓取信息进行分析，如无法定位或现场无法解决，也可将信息copy转发给研发人员进行分析解决。上述日志文件除了

6、catalina.out外，其余均可采用编辑或者more的方式打开。例如打开rt-nm.log.2008-09-03文件，方式如下：more rt-nm.log.2008-09-03 或vi rt-nm.log.2008-09-03如copy文件，可查看1.2章描述的SSH的文件转移方式。将日志文件copy到本地。ConsoleConsole工具属于调试类软件，可以跟踪、调试、设置1000M设备绝大部分呼叫问题。这里对console的使用进行一些简单的说明。2.1使用界面Console工具为.exe文件无需安装，双击文件即可使用，图标如下：运行出现如下操作界面：操作界面分为两个大的区域，如图A

7、区域为命令行输入区域，B区域为信息分析打印区域。区域内其余选择项如Free Bat为批量命令行写入界面；Trans Tool为Trans工具，这里不在做多余说明。2.2连接登陆Console只能连接1000或1000M设备的主控板。连接方式为输入1000M的MCU IP地址即可。点击文件连接，即出现如图所示登陆输入框。输入正确的交换机IP地址，口令默认为123456，点击OK，如连接成功，信息分析区域会打印#Welcome#欢迎词，表示已经正确登入交换机内。2.3命令使用正确登入console后，即可在命令输入框内进行命令操作。Console命令比较繁多，这里只是简单的介绍几种常用的信息跟踪查

8、看命令。1 getshowgetshow是console内最常用的信息跟踪命令，如图所示，输入getshow即可查询到相关的getshow数字参数对应的信息内容。根据信息提示，数字参数后接0代表跟踪关闭，1代表跟踪开启。如我们要跟踪AT相关信息，对照显示内容，找到25对应的AT参数，在命令行输入getshow 25 1即可开启AT跟踪，关闭则输入getshow 25 0即可。下述对跟踪信息内容进行说明：getshow msg_type switchtype: MTP TUP ISUP VOC DTMF ASL TCP OSALARM SRV1-3 CAS Q931 Q921 V5XiASL C

9、CB NET OPR CLU SMX FSKHstAlarm iHOST AT TK RSD NS SIPSLH323SL SIPSTACK H323STACK SNMP AC486 PPHST FAX EXT_BOX FAX_SIG FAX_486 IASL_CTRLCALL_SECAgetshow 3 1 注：录放音相关的调试信息Bgetshow 5 1 ；getshow 36 1 注：和模拟用户的相关调试信息Cgetshow 7 1 注：查看系统资源占用率Dgetshow 16 1 注：和HOST接口的相关调试信息Egetshow 17 1 注：CC模块的调试信息Fgetshow 25

10、1；getshow 26 1 注：和模拟中继的相关调试信息Ggetshow 34 1 注：486的相关调试信息Hgetshow 29 1 注：察看SIPSL模块调试信息，和SIP相关的呼叫有问题时定位问题可打开此项Igetshow 30 1 注：察看323SL模块调试信息，和323相关的呼叫有问题时定位问题可打开此项Ggetshow 18 1 ；getshow 21 1 注：网片的连接信息其余独立信息如下：2version察看主控程序版本信息3aauversion察看单片机和扩展单元版本信息4reset switch复位MCU5setsosetso no para(4byte)根据不同的设定，

11、不同的设置采用不同的软参来控制（不可随意更改）注意：此命令请在研发人员指导下使用6getlnk取七号信令链路状态LK-1222222222222222222222222222222222222222222222222222222222222为getlnk得到的显示结果，其中每一位表示一个grp idx，0表示ss7_lnk已配置但链路未建立，1表示链路已建立，2表示相应中继还未配置链路7getpra取PRI链路状态PR-1222222222222222222222222222222222222222222222222222222222222为getpra得到的显示结果，其中每一位表示一个grp

12、_idx，0表示ISDN信令链路已配置但链路未建立，1表示所配链路已建立，2表示相应中继没有配置链路.8start tshell开启PBX串口监控端口switch: start stop （0为开启，1为关闭）9ss7trace用途：跟踪七号信令消息。 用法：ss7trace ss7_plink_no switchss7_plink_no：七号信令链路的逻辑编号switch：显示开关。（1表示显示，0表示停止显示）10hdlctrace用途：跟踪hdlc消息。 用法：hdlctrace hdlc_no switchhdlc_no：hdlc号。switch：显示开关。 11gete1state

13、用途：取中继物理状态用法：gete1state nono：中继序号说明：E1_State: 255为显示状态，0为物理状态已同步（物理传输导通），255为物理状态未同步（物理传输不通）12getportstate 用途：取不同信令的时隙状态用法：getportstate type grp_idxtype：信令类型grp_idx：中继组号例：getportstate 4 0取grp_idx为0，中继类型为4（ISUP，中继类型与数字的对应关系可通过getportstate直接回车查看）的端口状态，显示如下：700000000其中每两个数字为一个状态，各数字具体含义如下：TUP： 00 Idle

14、空闲 01 Busy 忙 02 Block 阻塞 03 Unknown 未知 04 Fault 失败 05 Maintain 维护 06 Uninstall 未安装 ISUP： 00 ISUPCSIdle, 空闲 01 ISUPCSBusy, 忙 02 ISUPCSAvailBlock, /*BLOCK_EXT*/ 03 ISUPCSUnavailBlock, /*EXT_BLOCK OR BLOCK_LOCAL*/ 04 ISUPCSCheck, 维护 05 ISUPCSUnknown, 未知 06 ISUPCSFault, 失败 07 ISUPCSUninstall 未安装 网络抓包在定位

15、有sip或者H323组网环境下的问题时，往往需要抓取相关呼叫的网络包进行分析，网络抓包工具在Internet上有很多，推荐使用WireShark软件。3.1工具准备抓包的时候一定要使用hub，不能使用switch网络交换机或者路由器，组网须如下：将抓包的PC、IP-PBX、外网线都接到hub上。3.2软件使用双击WireShark图标，出现如下界面：点击Capture-Options：选择抓包的网口：然后点击start即可抓包。抓包或者分析过程中可在Filter栏输入相关命令过滤消息，达到查看指定目录的消息。抓包完成后点击 As保存即可。常用命令如下：sip：过滤sip消息ip.addr=XX

16、X.XXX.XXX.XXX：过滤指定的IP地址sip contains XXXX：过滤指定号码的sip消息rtp：过滤rtp消息t38：过滤t38消息Telnet4.1使用工具这里不建议使用windows下的telnet命令，这是由于其命令的输出缓冲区太小，不能完整保存整个呼叫的信息。可以使用附件的putty程序。（7z格式压缩，可以用winrar解压),也可以到 下载这个小软件，很小的。 如下图：4.2连接登陆(1)、用console连接pbx地址，输入 start tshell 0 回车(start tshell 0 三者间有空格）(2)、请使用1250端口，如上图(3)、点击open，进入telnet界面，输入telnet 用户名admin，密码12345678(4)、在telnet输入sipsetdata(2,3) 回车 ,sipsetdata(3,3)回车 ,sipsetdata(16,255) 回车(5)、调整putty或者telnet软件的输出缓冲区的大小为尽量大，比如20000，如下图(6)、呼叫，呼叫完后将输出到telnet的输出复制并建立一个txt文档保存下来，如下图：(7)、抓完信息后输入sipsetdata(2,0) 回车 ,sipsetdata(3,0)回车即可。