Keygoe 系统维护手册 · 2020-02-23 · 本文档力求准确说明Keygoe 系统以及其对应的产品，但由于产品的更新和修订，东进公司不保证您所购买的产品和本文档内容完全一致，并对此所导致的

Keygoe 系统维护手册

V3.1.0

修订记录

版本号修订日期修订内容 V3.1.0 2013-05-15 创建文档。

版权声明

本文档的版权归深圳市东进通讯技术股份有限公司所有，受中华人民共和国法

律的保护。东进公司有权在未经申明的情况下对文档的内容做必要的改动，且

不另行通知，更改的内容将会补充到本文档中。

本文档力求准确说明 Keygoe 系统以及其对应的产品，但由于产品的更新和修

订，东进公司不保证您所购买的产品和本文档内容完全一致，并对此所导致的

错误及产生的后果不承担任何法律责任。

除特别声明外，此文档所用的公司名称、个人姓名及数据均属为说明的目的而

拟定。

本文档所含的任何构思、设计、工艺及其他技术信息均属本公司所有，受中华

人民共和国法律的保护。未经本公司书面同意，任何单位和个人不得擅自摘抄、

全部或部分复制本书内容，或者以其他任何方式使第三方知悉。

注册商标说明

东进、DONJIN 是深圳市东进通讯技术股份有限公司的注册商标。 Microsoft、Windows、Windows Server 是微软的注册商标。

技术支持与服务

如果您在使用本公司产品时遇到困难，请先仔细阅读相关文档，其中对于普遍

遇到的问题提供了可以采取的步骤。

当没有找到问题的答案时，请与东进公司进行联系。

深圳东进通讯技术股份有限公司总部邮编：518040

电话：0755-83636988 83435288

传真：0755-83631239 83846752

网址：0www.donjin.com

地址：深圳市福田区车公庙泰然工贸园苍松大厦南座 21 层

http://www.donjin.com/

1

目录

1H第 1章概述 .................................................................................................................................... 43H1-1 2H1.1 手册介绍 ........................................................................................................................... 44H1-1 3H1.2 故障处理原则 ................................................................................................................... 45H1-1 4H1.3 使用约定 ........................................................................................................................... 46H1-1

5H第 2章软件安装故障 .................................................................................................................... 47H2-1 6H2.1 Keygoe模块无法正常启动 ................................................................................................ 48H2-1

7H2.1.1 场景描述................................................................................................................. 49H2-1 8H2.1.2 可能原因................................................................................................................. 50H2-1 9H2.1.3 处理过程................................................................................................................. 51H2-1 10H2.1.4 解决步骤................................................................................................................. 52H2-2

11H2.2 应用程序打不开Keygoe设备 ........................................................................................... 53H2-2 12H2.2.1 场景描述................................................................................................................. 54H2-2 13H2.2.2 可能原因................................................................................................................. 55H2-2 14H2.2.3 处理过程................................................................................................................. 56H2-3

15H第 3章系统配置故障 .................................................................................................................... 57H3-1 16H3.1 VoIP通话无声音................................................................................................................. 58H3-1


21H3.2 配置SS7 模块失败 ............................................................................................................ 63H3-3 22H3.2.1 场景描述................................................................................................................. 64H3-3 23H3.2.2 可能原因................................................................................................................. 65H3-4 24H3.2.3 处理过程................................................................................................................. 66H3-4 25H3.2.4 解决步骤................................................................................................................. 67H3-5

26H3.3 应用程序找不到设备........................................................................................................ 68H3-5 27H3.3.1 场景描述................................................................................................................. 69H3-5 28H3.3.2 可能原因................................................................................................................. 70H3-6 29H3.3.3 处理过程................................................................................................................. 71H3-6 30H3.3.4 解决步骤................................................................................................................. 72H3-6

31H第 4章业务相关故障 .................................................................................................................... 73H4-1 32H4.1 ISUP信令发送后续地址失败 ............................................................................................ 74H4-1


37H4.2 会议成员听语音不清晰.................................................................................................... 79H4-2 38H4.2.1 场景描述................................................................................................................. 80H4-2

2

39H4.2.2 可能原因................................................................................................................. 81H4-3 40H4.2.3 处理过程................................................................................................................. 82H4-3 41H4.2.4 解决步骤................................................................................................................. 83H4-4

第 1 章概述

1-1

第1章概述

1.1 手册介绍

本手册主要介绍了在使用 Keygoe 系统时，典型的常见故障及相应的解决方法。

主要由以下章节组成：

第 1 章概述：介绍本手册的信息概要。

第 2 章软件安装故障：介绍在软件安装过程中常见问题以及解决方法。

第 3 章系统配置故障：介绍在系统配置过程中常见问题以及解决方法。

第 4 章业务相关故障：介绍在业务中常见问题以及解决方法。

1.2 故障处理原则

如果按照本手册介绍操作后，故障仍未清除，请做好相关记录，并及时联系东

进公司的技术支持。

1.3 使用约定

为便于用户阅读，并使手册的讲解语言更加简洁，在本手册中还使用了一些特

定的符号及常用术语。

本书还采用各种醒目标志来表示在操作过程中应该特别注意的地方，这些标志

的意义如下所述。

注意：提醒操作中应注意的事项，不当的操作可能会导致数据丢失或者设备损

坏。

警告：该标志后的注释需给予格外关注，不当的操作可能会对人体造成伤害。

说明、提示：对操作内容的描述进行必要的补充和说明。

1

第 2 章软件安装故障

2-1

第2章软件安装故障

2.1 Keygoe 模块无法正常启动

2.1.1 场景描述

1. 环境

一台 Keygoe 设备

Windows 系统 Server 2003

用 Keygoe 做一个呼叫系统，主要功能呼入呼出

2. 故障描述

Keygoe 系统添加的模块无法正常启动，一直显示黄色。

3. 导致影响

应用程序不能正常启动，Keygoe 系统无法正常使用。

2.1.2 可能原因

主机以前卸载 Keygoe 系统后没有重启操作系统。

卸载 Keygoe 程序时，应删除当前系统新增模块的对应服务，但这些服务在系

统重启动前处于锁定状态，只有重启系统后才能真正删除。

如果卸载 Keygoe 程序后，不重启操作系统就直接安装新的 Keygoe 程序，添加

新的模块，会同上一次配置的模块产生冲突，从而发生异常。

2.1.3 处理过程

卸载 Keygoe 安装包，重启电脑后重新安装 Keygoe 安装包

2


2-2

2.1.4 解决步骤

具体解决步骤如下。

步骤 1：进入东进公司官方网站 42H42Hwww.donjin.com，下载Keygoe安装包。

步骤 2：打开控制面板，在“添加/删除程序”中找到 Keygoe 开发包，卸载当

前 Keygoe 系统。

步骤 3：重启电脑。

步骤 4：重新安装 Keygoe 系统。

步骤 5：重新配置 Keygoe 系统。

—结束

2.2 应用程序打不开 Keygoe 设备

2.2.1 场景描述

1. 环境

一台 Keygoe 3003 或 Keygoe 3005

Windows XP 系统

用 Keygoe 系统做呼叫系统，主要功能为呼入呼出

2. 故障描述

应用程序打不开设备，设备处于 waitopen 状态

3. 导致影响

应用程序不能正常使用，无法使用 Keygoe 系统。

2.2.2 可能原因

流程模块的机箱号配置错误。


2-3

2.2.3 处理过程

步骤 1：找到机箱号打开配置管理界面。方法为右击 Keygoe 主节点，选择“增

加单元>DSP 模块>搜索”，查看搜索的插框号。如“插框 8”表示机箱号为“8”，插框号与机箱号相同。

步骤 2：打开配置管理界面，点击“流程”节点下的“模块参数配置”界面。

在弹出的“单元配置”中， “CTBus 资源配置项”下依次选择“[0]>机箱 ID”，

把机箱 ID 改为实际的机箱号，如下图所示。

步骤 3：点击“设置”，完成配置。

—结束

第 3 章系统配置故障

3-1

第3章系统配置故障

3.1 VoIP 通话无声音

3.1.1 场景描述

1. 环境

一台带主控板的 Keygoe1001 交换机（或不带主控板的 Keygoe 交换机，通过

路由器出外网）

Windows 操作系统

2. 故障描述

VoIP 呼叫建立后，听不到双方声音。

3. 导致影响

所有 VoIP 通话都没有声音。

3.1.2 可能原因

原因 1：端口映射设置问题

原因 2：RTP 设置问题

3.1.3 处理过程

1. 检查配置界面 VoIP 节点

双击“RTP 协议设置”，在弹出的参数设置界面中，检查 “NAT 检测/穿透”

是否设置为“打开”。

3


3-2

其中，注意以下两个参数设置是否正确：

网关 LAN 地址：内网网关地址

网关 WAN 地址：外网的 IP 地址

2. 查看端口映射

在 C:\DJKeygoe\Tools\portmap 目录下，用 portmap 做端口映射。

3.1.4 解决步骤

步骤 1：如果有两块网卡，要选择外网的网卡做网络共享：

打开网络连接，选择外网网卡，右击外网的“网络连接”，选择“属性>高级”,在 Internet 连接共享下的两个选项都打钩，然后确认设置。

步骤 2：选择“开始>运行”, 输入“cmd”，按回车，输入如下命令：

（1）“cd C:\DJKeygoe\Tools\portmap”，按回车键

（2）“portmap eth0(网卡名) 1（DSP 的 ID 号） 192.168.1.16（DSP 的 IP 地址）”，

按回车键

步骤 3：如果是路由器，把内网的 DSP 的 IP 映射到外网 IP，具体请参见路由


3-3

器的说明。

—结束

3.2 配置 SS7 模块失败

3.2.1 场景描述

1. 环境


Windows XP 系统

用 Keygoe 做一个呼叫系统，主要功能为呼入呼出

2. 故障描述

无法配置七号链路：在配置界面选择 “SS7 模块>MTP3 配置参数>参数配置>链路参数>选择多个资源”，点击“确定”。

设置完相应的 DPC 和 OPC 等参数后，点击“设置”按钮，系统弹出“设置参数

失败”对话框。


3-4

3. 导致影响

无法搭建环境，程序业务无法正常使用。

3.2.2 可能原因

原因 1：DSP 模块只允许一个配置界面与之连接，其它的配置界面只能看到

DSP 模块的状态而无法进行配置，所以需查看是否有其他界面连接了 DSP。

原因 2：SS7 模块没有关联流程模块，或者 DSP 模块没有关联 SS7 模块。

3.2.3 处理过程

1、在主界面，选择“DSP>状态信息>socket link status”。双击“socket link status”，系统弹出“查看资源”对话框，选择 “多个资源”，点击“确定”。

查看除了本机与 DSP 建立连接，是否有其他主机与 DSP 连接。

2、在主界面根节点处单击右键，选择“查看关联”。


3-5

弹出的对话框中，查看 DSP 是否与流程模块、SS7 模块、与媒体模块关联。再

检查 SS7 模块与流程模块是否关联。

3.2.4 解决步骤

情况一：如果有其他主机与 DSP 连接，找到该主机，使其退出连接。

情况二：如果是没有关联，在配置界面上停止所有的模块，停止模块后点击右

键，查看关联关系，再进行关联。

在退出连接或关联好模块后，即可正常配置 SS7 模块。

3.3 应用程序找不到设备

3.3.1 场景描述

1. 环境


Windows XP 系统


2. 故障描述

应用程序连接上流程模块后，看不到任何设备

3. 导致影响

程序无法打开设备，无法正常运行应用程序进行相关业务。


3-6

3.3.2 可能原因

原因 1：流程模块没有与任何 DSP 关联

原因 2：关联的 DSP 没有启动

原因 3：关联的 DSP 没有授权资源

3.3.3 处理过程

针对原因 1：关联流程模块与 DSP。

针对原因 2：启动 DSP。

针对原因 3：查看 DSP 是否有授权，如果没有授权需要进行授权。

3.3.4 解决步骤

步骤 1：在配置界面上，停止所有模块后, 右键点击根节点选择“查看关联”，

对没有关联的模块进行关联。

步骤 2：在配置界面启动 DSP。

步骤 3：在配置界面，点击 DSP 节点，选择“固件信息”>“授权信息”。双击

“授权信息”后，系统弹出参数配置页面，最后一项为“授权有效天数”，如下

图所示。


3-7

如果授权有效天数到期，需重新申请授权。申请授权后，加载授权（在 DSP处点击右键选择“装载证书”，选择好文件后，点击“确定”）。

—结束

第 4 章业务相关故障

4-1

第4章业务相关故障

4.1 ISUP 信令发送后续地址失败

4.1.1 场景描述

1. 环境


Window XP 系统


2. 故障描述

七号 ISUP 信令发送后续地址呼叫失败。

3. 导致影响

客户程序无法实现相关业务功能。

4.1.2 可能原因

发送后续地址方式不正确。

4.1.3 处理过程

如果要修改发送一个信令参数（如发送一个后续地址），通过 XMS_ctsSetParam和 XMS_ctsSendSignalMsg 来实现。

具体请参考《Keygoe 系统编程接口参考》和《Keygoe 系统七号信令高级编程

接口参考》。

4


4-2

4.1.4 解决步骤

在调用 XMS_ctsMakeCallout 函数后，再发送一个后续地址

步骤 1：定义参数：

ISUP_spSubsequentNumber SP_ssn={0};

SP_ssn.m_u8OddEvenIndicator=0;

strcpy(SP_ssn.m_s8AddressSignal,"012345678900");

步骤 2：调用 XMS_ctsSetParam，设置参数。

if (XMS_ctsSetParam(g_acsHandle, pDevice, ISUP_SP_SubsequentNumber,

sizeof(SP_ssn), &SP_ssn)<0)

{

return false;

}

步骤 3：调用 XMS_ctsSendSignalMsg 发送信令。

if(XMS_ctsSendSignalMsg(g_acsHandle, pDevice, ISUP_SM_SAM)<0)

{

return false;

}

4.2 会议成员听语音不清晰

4.2.1 场景描述

1. 环境


Windows XP 系统

会议通话，会议成员中有 VoIP 座席


4-3

2. 故障描述

当对会议系统放音音量比较小时，会议成员听到的声音断断续续。

3. 导致影响

影响客户使用会议系统。

4.2.2 可能原因

VAD 开启。

当开启 VAD 时，声音很小时，系统会认为是静音而被过滤掉。

4.2.3 处理过程

把语音和 VoIP 的 VAD 都给关闭，具体方法：

在主界面上，点击 DSP，选择“状态信息”>“INPUT 通道状态”，双击“INPUT通道状态”，选择“多个资源”，并点击“确定”。

在这个界面上可以看到 Voice 的 VAD 是否关闭。


4-4

同样在 DSP 的“状态信息>RTP 通道状态”中，可查看 VoIP 的 VAD 是否关闭。

4.2.4 解决步骤

步骤 1：VoIP 关闭 VAD 与语音关闭 VAD 的方式很像，只需把设备改为 VoIP设备，参数类型改为 VoIP 设备类型 VOIP_PARAM_VOICE。

步骤 2：定义结构体设置参数：

CmdParamData_Voice_t param_voice;

memset(&param_voice, 0, sizeof(CmdParamData_Voice_t));

param_voice.m_u8InputCtrlValid = 1;

param_voice.m_VocInputControl.m_u16FixGain = 1024;

param_voice.m_VocInputControl.m_u8VadEnable = 0;

u16ParamType = VOIP_PARAM_VOICE;

u16ParamSize = sizeof(CmdParamData_Voice_t)

步骤 3：调用 XMS_ctsSetParam 对 VoIP 设备进行设置。


4-5

XMS_ctsSetParam( g_acsHandle, &pOneVoip->deviceID, u16ParamType,

u16ParamSize, &param_voice)

—结束

Documents

Keygoe 系统维护手册 · 2020-02-23 · 本文档力求准确说明Keygoe 系统以及其对应的产品，但由于产品的更新和修 订，东进公司不保证您所购买的产品和本文档内容完全一致，并对此所导致的

Keygoe 系统维护手册 · 2020-02-23 · 本文档力求准确说明Keygoe 系统以及其对应的产品，但由于产品的更新和修订，东进公司不保证您所购买的产品和本文档内容完全一致，并对此所导致的