“FreeSWITCH 安装配置”的版本间的差异
（创建页面，内容为“=下载Sangoma板卡wanpipe驱动支持包= '''Sangoma 官方建议在Linux平台安装Sangoma语音板卡。'''<br/> Sangoma 板卡用户必须注意，请在安装...”） |
|||
| （未显示同一用户的4个中间版本） | |||
| 第1行： | 第1行： | ||
| + | 此文档解支持Sangoma+FreeSWITCH-1.4以下版本，对于FreeSWITCH-1.6以上用户，大家可以参考Sangoma官方wiki，或者参考我们的FreeSWITCH-1.6安装方式。<br> | ||
| + | 另外，根据很多用户的反应，FreeSWITCH-1.6以上版本对Centos-7以上版本支持不是太友好，建议用户使用Debian来安装。因此，读者需要提前考虑这些要素。<br> | ||
=下载Sangoma板卡wanpipe驱动支持包= | =下载Sangoma板卡wanpipe驱动支持包= | ||
'''Sangoma 官方建议在Linux平台安装Sangoma语音板卡。'''<br/> | '''Sangoma 官方建议在Linux平台安装Sangoma语音板卡。'''<br/> | ||
| 第4行： | 第6行： | ||
请访问此链接，查看不同平台'''Redhat Distributions/Ubuntu/Debian 6 Distributions的安装包'''： | 请访问此链接，查看不同平台'''Redhat Distributions/Ubuntu/Debian 6 Distributions的安装包'''： | ||
<pre> | <pre> | ||
| − | + | https://wiki.freepbx.org/display/PC/Telephony+Cards+for+FreeSWITCH | |
</pre> | </pre> | ||
安装过程中，请务必留意几个方面的问题：<br> | 安装过程中，请务必留意几个方面的问题：<br> | ||
1）确认每个支持包安装成功。<br> | 1）确认每个支持包安装成功。<br> | ||
| − | 2) | + | 2) 确认'''内核开发包和目前正在使用的内核版本完全一致'''。否则不能安装语音板卡驱动程序，建议用户最好安装光盘中的内核开发包，不要使用yum从网上安装。使用yum安装经常导致内核开发包版本和内核版本不一致的问题，切记。<br> |
3) Sangoma E1 板卡安装仅仅需要安装3个软件包：'''wanpipe 板卡驱动，libsng_isdn和FreeSWITCH软交换。'''<br/> | 3) Sangoma E1 板卡安装仅仅需要安装3个软件包：'''wanpipe 板卡驱动，libsng_isdn和FreeSWITCH软交换。'''<br/> | ||
4) Sangoma 和FreeSWITCH集成，相关的配置文件包括：<br> | 4) Sangoma 和FreeSWITCH集成，相关的配置文件包括：<br> | ||
| 第26行： | 第28行： | ||
make install // 安装编译的模块 | make install // 安装编译的模块 | ||
</pre> | </pre> | ||
| − | + | ||
执行命令 wanrouter hwprobe，检测sangoma 硬件信息(显示A101，如果是其他型号，显示相应产品信息) | 执行命令 wanrouter hwprobe，检测sangoma 硬件信息(显示A101，如果是其他型号，显示相应产品信息) | ||
<pre> | <pre> | ||
2018年8月18日 (六) 16:36的最新版本
此文档解支持Sangoma+FreeSWITCH-1.4以下版本，对于FreeSWITCH-1.6以上用户，大家可以参考Sangoma官方wiki，或者参考我们的FreeSWITCH-1.6安装方式。
另外，根据很多用户的反应，FreeSWITCH-1.6以上版本对Centos-7以上版本支持不是太友好，建议用户使用Debian来安装。因此，读者需要提前考虑这些要素。
下载Sangoma板卡wanpipe驱动支持包
Sangoma 官方建议在Linux平台安装Sangoma语音板卡。
Sangoma 板卡用户必须注意，请在安装编译驱动之前，必须确认成功安装驱动支持包；否则会出现编译失败或者报错。
请访问此链接，查看不同平台Redhat Distributions/Ubuntu/Debian 6 Distributions的安装包：
https://wiki.freepbx.org/display/PC/Telephony+Cards+for+FreeSWITCH
安装过程中，请务必留意几个方面的问题：
1）确认每个支持包安装成功。
2) 确认内核开发包和目前正在使用的内核版本完全一致。否则不能安装语音板卡驱动程序，建议用户最好安装光盘中的内核开发包，不要使用yum从网上安装。使用yum安装经常导致内核开发包版本和内核版本不一致的问题，切记。
3) Sangoma E1 板卡安装仅仅需要安装3个软件包：wanpipe 板卡驱动，libsng_isdn和FreeSWITCH软交换。
4) Sangoma 和FreeSWITCH集成，相关的配置文件包括：
4.1） Sangoma 板卡配置文件，在/etc/wanpipe 目录下，包含：
每个端口配置文件（每个端口配置文件以：wanpipeX.conf 命名），日志文件，启动顺序配置文件。
4.2）Freetdm.conf 文件，配置板卡数据，默认路径是：/usr/local/freeswitch/conf/freetdm.conf
4.3）FreeSWITCH 应用层配置文件默认路径：/usr/local/freeswtich/conf/autoload_configs/freetdm.conf.xml
安装Wanpipe/PRI协议栈/Freeswitch
Wanpipe驱动安装
执行命令 cd /usr/src，下载最新的wanpipe 版本
wget ftp://ftp.sangoma.com/linux/current_wanpipe/wanpipe-current.tgz tar xfz wanpipe-current.tgz // 减压tar 文件 cd wanpipe-<version>.tgz // 进入到这个文件夹 make freetdm // 编译freetdm make install // 安装编译的模块
执行命令 wanrouter hwprobe，检测sangoma 硬件信息(显示A101，如果是其他型号，显示相应产品信息)
------------------------------- | Wanpipe Hardware Probe Info | ------------------------------- 1 . AFT-A101-SH : SLOT=2 : BUS=4 : IRQ=217 : CPU=A : PORT=1 : HWEC=0 : V=41 Card Cnt: A101=1
libsng_isdn PRI安装
如果支持PRI， 用户必须下载Sangoma的ISDN支持包，分别支持32位，64位系统：
32-bit library: ftp://ftp.sangoma.com/linux/libsng_isdn/libsng_isdn-current.i686.tgz 64-bit library: ftp://ftp.sangoma.com/linux/libsng_isdn/libsng_isdn-current.x86_64.tgz tar xfz libsng_isdn-current.<arch>.tgz // 减压到 /usr/src 路径下 cd libsng_isdn-<version>.<arch> // 进入到 文件夹 make install // 执行编译安装命令
FreeSWITCH 安装
两种方式可安装FreeSWITCH，通过git安装，或者http下载源代码：
git clone git://git.freeswitch.org/freeswitch.git //如果通过git安装，请提前安装git工具 wget http://files.freeswitch.org/freeswitch-snapshot.tar.gz ./bootstrap.sh // 执行安装配置环境设置 #libs/freetdm/mod_freetdm // 打开modules.conf 文件，找到这一行，删除注释符#，保存文件 ./configure // 默认安装文件到 /usr/local/freeswitch make // 执行编译 make install // 安装文件
配置设置文件
配置Wanpipe and mod_freetdm
执行工具 wancfg_fs，脚本命令将自动检测设置sangoma语音板卡和pri协议配置文件。
- cd /usr/sbin/, 执行安装脚本: ./wancfg_fs
- /etc/wanpipe/wanpipe#.conf // 系统生产相应的每个端口的配置文件wanpipe1-wanpipe#
- /usr/local/freeswitch/conf/freetdm.conf // FreeTDM 配置文件
- FreeSwtich mod_freetdm 模块配置文件
/usr/local/freeswtich/conf/autoload_configs/freetdm.conf.xml
'''执行脚本安装过程中，中国用户需要选择的选项''',请小心操作： Select media type->E1 // 支持中国E1 Select linecode-> HDB3 // E1接口支持两种线路编解码格式：AMI格式和HDB3格式。默认HDB3 Select framing-> NCRC4 // 是否需要支持CRC4 校验，如果不支持选择此项。大多数中国客户使用NCRC4 Select Clock-> Normal Select Signalling type-> PRI CPE // '''运营商端上NET 网络侧，本地必须选择CPE 用户侧''' Select switchtype -> EuroISDN Select Configure port for full use->yes Select Dialplan context-> PSTN // 注意，到这一步，一个端口就算配置完成了，脚本会重复配置 第2 口，3口，如果是16E1的话，执行到16口，直到配置完所有的板卡端口。 Configuration complete-> Yes Dahdi and Wanpepe configuration complete-> 选择 2 would you like to continue->Yes would you like wanrouter to start on system boot-> yes
配置FreeSWITCH和mod_freetdm接口模块
为了使得FreeTDM正确加载，修改/usr/local/freeswitch/conf/autoload_configs/ 目录下的modules.conf.xml文件
修改下面一行
<!-- <load module="mod_freetdm"/> -->
修改后：
<load module="mod_freetdm"/>
检查Sangoma 物理接入状态，检查ftdm信令状态
1）检查物理状态，可以通过Sangoma 驱动底层工具查看物理状态，线路，远端告警信息：
http://wiki.voip88.com/index.php/Sangoma_wanpipemon_T1/E1_line_alarms_%E7%BA%BF%E8%B7%AF%E5%91%8A%E8%AD%A6%E6%8E%92%E6%9F%A5%E5%B7%A5%E5%85%B7
2) 或者通过FreeSWITCH CLI命令，执行以下命令查看端口状态和信令：
2.1 ftdm sangoma_isdn l1_stats wp1， 返回结果显示：connected， disconnected
2.2 ftdm sangoma_isdn show_spans, 如果物理连接正常，信令正常，显示UP，active。
呼入呼出拨号规则举例
拨号规则的语法：
通过指定的端口呼出: "freetdm/<span_name>/a/<destination_number>" 通过指定的呼出组呼出: "freetdm/<group_name>/a/<destination_number>"
测试之前，请使用Xlite在freeswitch注册一个分机1001，默认密码1234. 注意修改配置文件，需要重新加载模块
呼出举例：通过分机拨打9186653XXXX呼出到186653XXXX. 在freeswitch 的配置文件dialplan/default.xml添加
<extension name="outgoing">
<condition field="destination_number" expression="^9(.+)$"> // 拨9前缀呼出。
<action application="bridge" data="freetdm/wp1/a/$1"/>
</condition>
</extension>
呼入举例：E1呼入以后转到分机1001.在/dialplan/public/00_inbound_did.xml中修改成如下：
<include>
<extension name="public_did">
<condition field="destination_number" expression="^(.+)$">
<action application="set" data="domain_name=$${domain}"/>
<action application="transfer" data="1001 XML default"/> // E1 呼入以后转到分机1001
</condition>
</extension>
</include>
PRI 命令检测
Layer 1 驱动层信息
使用方法: l1_stats <span name> 举例: ftdm sangoma_isdn l1_stats wp1
Protocol Status检测
如何检测PRI 端口状态： 使用: show_spans 举例: ftdm sangoma_isdn show_spans // 显示UP/Down Active/Inactive <pre> Protocol trace信息 <pre> 如何打开 Q921 trace: 使用: trace q921 <span name> 举例: ftdm sangoma_isdn trace q921 wp1
如何打开 Q931 trace: 使用: trace q931 <span name> 举例: ftdm sangoma_isdn trace q931 wp1
如何关闭所有traces信息: 使用: trace disable <span name> 举例: ftdm sangoma_isdn trace disable wp1
无回令音或者不能透传彩令
解决办法，在呼出之前加answer 应用。
FreeSwitch ftdm 命令集
To see a list of your configured spans, at the CLI type * ftdm list // 显示端口列表 To see detailed information about a specific span * ftdm dump <span_id> To see detailed information about a specific channel on span * ftdm dump <span_id> <chan_id> To start a span (this terminates FS with sangoma_isdn when you stopped the span before) * ftdm start <span_id> // 启动一个端口 To stop a span * ftdm stop <span_id> // 停止一个端口 To get a pcap trace (I guess it doesn't work currently) * ftdm q931_pcap <span_id> on|off [pcapfilename without suffix] (this command shouldn't be defined in mod_freetdm, but in ftmod_isdn I guess) To enable/disable DTMF detection on whole span or certain channel * ftdm dtmf on|off <span_id> [<chan_id>] // 开启DTMF检测，支持Sangoma 带回声硬件DTMF检测 To enable a trace on whole span or certain channels * ftdm trace <path where to save files per channel> <span_id> [<chan_id>] To disable a trace on whole span or certain channels * ftdm notrace <span_id> [<chan_id>] To adjust gains on whole span or certain channels * ftdm gains <rxgain> <txgain> <span_id> [<chan_id>] // 调整 端口曾益 rx 代表接收 tx 代表呼出 * ftdm sangoma_isdn trace <q921|q931> <span_name> Call this for both q921 and q931 to have both decoded To disable decoding of q921 and q931 messages on a span * ftdm sangoma_isdn trace disable <span_name> To get layer 1 statistics from span (derived from wanpipe I guess) * ftdm sangoma_isdn l1_stats <span_name> To get a short status report of each span * ftdm sangoma_isdn show_spans
常见问题排查
1) Sangoma E1 语音板卡最大支持16E1 PRI免费，不支持SS7。
2）启动顺序：先启动Sangoma语音板卡，然后再启动FreeSWITCH。
3）卸载顺序：先停止FreeSWITCH，然后再停止Sangoma板卡驱动。
3）如何排查Sangoma物理连接，此链接包括了每个参数的具体含义
http://wiki.voip88.com/index.php/Sangoma_wanpipemon_T1/E1_line_alarms_%E7%BA%BF%E8%B7%AF%E5%91%8A%E8%AD%A6%E6%8E%92%E6%9F%A5%E5%B7%A5%E5%85%B7
4）为了快速解决客户问题，Sangoma 一般要求客户提供系统相关日志文件。Sangoma 支持系统打包工具，如何获得整体打包的log日志：
http://wiki.voip88.com/index.php/Sangoma_%E7%B3%BB%E7%BB%9F%E6%8E%92%E6%9F%A5%E6%97%A5%E5%BF%97%E6%89%93%E5%8C%85%E5%B7%A5%E5%85%B7
注：此日志工具仅支持Linux平台。
5）确认已经连接了运营商线路，物理连接检查Disconnected，参考：
http://wiki.sangoma.com/troubleshooter-boards-pri-Wanpipe-Driver-status-shows-Disconnected
6) 线缆线序，E1板卡使用标准的RJ48接口，线序图例，查看：
http://wiki.sangoma.com/Pinouts
7) Sangoma 板卡本身不附送120欧姆-75欧姆转接头，我们发货时会附送此转接头。
8) 如何使用FreeSWITCH的ESL，参考：
http://wiki.sangoma.com/FreeSWITCH-ESL
9) Freetdm.conf 配置举例：
http://wiki.sangoma.com/wanpipe-freeswitch-config-freetdm-isdn
10) Sangoma FreeSWITCH 修改排查文件：
http://wiki.sangoma.com/Freeswitch-Troubleshooting-Information-a101-2-4-8
