03-IPPBX常用定位工具及使用

由于 IP PBX 关联配置项较多 在使用中会常出现一些由于配置或 者操作不当引发的问题 这里就需要使用到一些定位工具完成对问 题的跟踪分析和定位 IP PBX 在安装或者配置中常见问题定位方 式主要有四种 一为日志 日志是用户进行相关操作 软件自动保 留的操作过程跟踪文件 其中包括独立应用软件的各个日志 如网 管日志 sc 日志 穿越日志等 二为 console 工具 Console 工具 可完成呼叫相关的所有信息定位 是最常用有效的问题跟踪手段 三为网络包抓取 在使用穿越业务及 SIP 相关时 分析网络信息包 是查询异常的直接手段 四为 telnet 在定位 sip 栈相关问题时 需要根据 telnet 相关输出信息进行分析 日志 Console 网络抓包 telnet 日志日志 日志主要用来记录历史时间内产生的操作信息 部分应用软件在系 统内会自动保留一定时间内的日志信息 主要是方便相关人员查看 定位问题信息 这里不对日志的异常信息进行讲解 只是简单的讲述日志所在的系 统位置和如何查看提取这些信息 自动生成日志信息的模块主要有 rt sc rt fc rt fax rt nm rt ts rt tc 1 1 日志目日志目录录 A rt sc 目录位置 var rt vasp log rt sc 0000 00 00 xx log 0000 00 00 表示年月日 xx 表示日志时间 如 13 就是下午 1 点 A rt fc 目录位置 var rt vasp log rt fc 0000 00 00 xx log C rt fax 目录位置 var rt vasp log rt fax 0000 00 00 xx log D rt 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 00 表示年月日 E rt ts 日志 目录位置 usr local rt trans ts rt ts ini 操作步骤 1 通过 SSH 修改配置文件中 LogToFile 和 LogLevel 的数值 LogToFile 的数值大于 0 数值大于 0 表明写日志 等于 0 表明 不写日志 LogLevel 的数值设置为 1 5 数值越大 表明日志越 详细 另外有一个一个LogMoudle 选项 all 设置大于 0 就表示所有 模块启动日志了 但是 all 0 并不表示不启动某些 xx 1 的模块的 日志即 all 0 就表示没有任何意义 2 重启 TS 程序 service rt ts restart 或是在网管上模块运状态 那重启 用 ls a 可以查看到此目录下隐藏的日志文件 3 抓完日志信息 必须把 LogToFile 和 LogLevel 的数值恢复成 默认值 特别 LogToFile 一定得恢复成 0 否则到时候会生成很多 日志文件 占满磁盘的容量 导致设备不能正常运行 另如果 LogMoudle 选项 all 设置大于 0 的值 也得恢复成 0 E rt tc 日志 目录位置 usr local rt trans tc rt tc ini 操作步骤 同等于 E 中的 rt ts 日志 1 2 查看方式查看方式 根据 1 1 所述目录地址可以查找到某一日期某一时间段内的所有模 块运行和工作信息 如出现异常 工程人员可以对照时间点从日志 内抓取信息进行分析 如无法定位或现场无法解决 也可将信息 copy 转发给研发人员进行分析解决 上述日志文件除了 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 到本地 Console Console 工具属于调试类软件 可以跟踪 调试 设置 1000M 设 备绝大部分呼叫问题 这里对 console 的使用进行一些简单的说明 2 1 使用界面使用界面 Console 工具为 exe 文件无需安装 双击文件即可使用 图标如下 运行出现如下操作界面 操作界面分为两个大的区域 如图 A 区域为命令行输入区域 B 区 域为信息分析打印区域 区域内其余选择项如 Free Bat 为批量命 令行写入界面 Trans Tool 为 Trans 工具 这里不在做多余说明 A B 2 2 连接登陆连接登陆 Console 只能连接 1000 或 1000M 设备的主控板 连接方式为输入 1000M 的 MCU IP 地址即可 点击文件 连接 即出现如图所示 登陆输入框 输入正确的交换机 IP 地址 口令默认为 123456 点击 OK 如连 接成功 信息分析区域会打印 Welcome 欢迎词 表示已 经正确登入交换机内 2 3 命令使用命令使用 正确登入 console 后 即可在命令输入框内进行命令操作 Console 命令比较繁多 这里只是简单的介绍几种常用的信息跟踪 查看命令 1 getshow getshow 是 console 内最常用的信息跟踪命令 如图所示 输入 getshow 即可查询到相关的 getshow 数字参数对应的信息内容 根据信息提示 数字参数后接 0 代表跟踪关闭 1 代表跟踪开启 如我们要跟踪 AT 相关信息 对照显示内容 找到 25 对应的 AT 参 数 在命令行输入 getshow 25 1 即可开启 AT 跟踪 关闭则输入 getshow 25 0 即可 下述对跟踪信息内容进行说明 getshow msg type switch type MTP TUP ISUP VOC DTMF ASL TCP OSALARM SRV1 3 CAS Q931 Q921 V5XiASL CCB 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 SEC A getshow 3 1 注 录放音相关的调试信 息 B getshow 5 1 getshow 36 1 注 和模拟用户的相关调 试信息 C getshow 7 1 注 查看系统资源占用率 D getshow 16 1 注 和 HOST 接口的相关调试 信息 E getshow 17 1 注 CC 模块的调试信息 F getshow 25 1 getshow 26 1 注 和模拟中继的相关调 试信息 G getshow 34 1 注 486 的相关调试信息 H getshow 29 1 注 察看 SIPSL 模块调试信息 和 SIP 相 关的呼叫有问题时定位问题可打开此项 I getshow 30 1 注 察看 323SL 模块调试信息 和 323 相 关的呼叫有问题时定位问题可打开此项 G getshow 18 1 getshow 21 1 注 网片的连接信 息 其余独立信息如下 2 version 察看主控程序版本信息 3 aauversion 察看单片机和扩展单元版本信息 4 reset switch 复位 MCU 5 setsoftpara setsoftpara no para 4byte 根据不同的设定 不同的设置采用不同的软参来控制 不可随意更 改 注意 此命令请在研发人员指导下使用 6 getlnk 取七号信令链路状态 LK 1222222222222222222222222222222222222222222222222222 222222222 为 getlnk 得到的显示结果 其中每一位表示一个 grp idx 0 表示 ss7 lnk 已配置但链路未建立 1 表示链路已建立 2 表示相应中继还未配置链路 7 getpra 取 PRI 链路状态 PR 1222222222222222222222222222222222222222222222222222 222222222 为 getpra 得到的显示结果 其中每一位表示一个 grp idx 0 表示 ISDN 信令链路已配置但链路未建立 1 表示所配 链路已建立 2 表示相应中继没有配置链路 8 start tshell 开启 PBX 串口监控端口 switch start stop 0 为开启 1 为关闭 9 ss7trace 用途 跟踪七号信令消息 用法 ss7trace ss7 plink no switch ss7 plink no 七号信令链路的逻辑编号 switch 显示开关 1 表示显示 0 表示停止显示 10 hdlctrace 用途 跟踪 hdlc 消息 用法 hdlctrace hdlc no switch hdlc no hdlc 号 switch 显示开关 11 gete1state 用途 取中继物理状态 用法 gete1state no no 中继序号 说明 E1 State 255 为显示状态 0 为物理状态已同步 物理传 输导通 255 为物理状态未同步 物理传输不通 12 getportstate 用途 取不同信令的时隙状态 用法 getportstate type grp idx type 信令类型 grp idx 中继组号 例 getportstate 4 0 取 grp idx 为 0 中继类型为 4 ISUP 中继类 型与数字的对应关系可通过 getportstate 直接回车查看 的端口状态 显示如下 0700000000000000000000000000000007000000000000000000000000000000 其中每两个数字为一个状态 各数字具体含义如下 TUP 00 Idle 空闲 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 失败 07ISUPCSUninstall 未安装 网络抓包网络抓包 在定位有 sip 或者 H323 组网环境下的问题时 往往需要抓取相关 呼叫的网络包进行分析 网络抓包工具在 Internet 上有很多 推荐 使用 WireShark 软件 3 1 工具准备工具准备 抓包的时候一定要使用 hub 不能使用 switch 网络交换机或者路由 器 组网须如下 将抓包的 PC IP PBX 外网线都接到 hub 上 3 2 软件使用软件使用 双击 WireShark 图标 出现如下界面 点击 Capture Options 选择抓包的网口 然后点击 start 即可抓包 抓包或者分析过程中可在 Filter 栏输入相 关命令过滤消息 达到查看指定目录的消息 抓包完成后点击 File Save As 保存即可 常用命令如下 sip 过滤 sip 消息 ip addr XXX XXX XXX XXX 过滤指定的 IP 地址 sip contains XXXX 过滤指定号码的 sip 消息 rtp 过滤 rtp 消息 t38 过滤 t38 消息 Telnet 4 1 使用工具使用工具 这里不建议使用 windows 下的 telnet 命令 这是由于其命令的输出 缓冲区太小 不能完整保存整个呼叫的信息 可以使用附件的 putty 程序 7z 格式压缩 可以用 winrar 解压 也可以到 http www chiark greenend org uk sgtatham putty download html 下载这个小软件 很小的 如下图 4 2 连接登陆连接登陆 1 用 console 连接 pbx 地址 输入 start tshell 0 回车 start tshell 0 三者间有空格 2 请使用 1250 端