查看“NetBorder SS7设备”的源代码

=Sangoma NSG安装前准备=
==获得运营商点码OPC/DPC点码==
用户在安装Sangoma NSG SS7 设备之前，必须和运营商确认OPC 和DPC的相关信息。确认相关信息以后，提交一个配置文件到sangoma技术支持，sangoma 技术支持会根据配置文件的要求，登录用户设备按照相应的参数进行配置。具体的链接如下：
http://wiki.sangoma.com/NSG-Questionnaire

==检查运营商物理接口==
Sangoma SS7 设备支持75欧姆的接口，官方出厂时不带75欧姆转120欧姆的BNC转接头。所以客户在安装现场确认运营商的接口是哪一种类型，提前准备。具体的线序参考如下：
http://wiki.sangoma.com/Cable-Pinouts

==Sangoma NSG SS7 支持功能==
Sangoma SS7 仅支持ISUP 中国变种，不支持TUP协议，具体支持的协议包括：
* ISUP
* SIP
* RFC 2976 SIP INFO Method
* RFC 3398 ISUP-SIP Mapping
* RFC 3515 Refer Method
* RFC 2327 Session Description Protocol
* RFC 3581 An Extension to the Session Initiation Protocol (SIP) for Symmetric Response Routing
* RFC 3892 Referred-By Mechanism
* RFC 3891 "Replaces" Header
* RFC 3551: RTP/AVP
* RFC 3515: REFER 
* RFC 2617: HTTP Digest Authentication 
* SDP Bypass
* RFC 3262: PRACK and 100rel *
* RFC 4168: SCTP as Transport for SIP*

==Sangoma NSG SS7 安装支持包==
Sangoma NSG SS7 支持两种SS7 设备部署形式：1）二进制包安装 2）ISO 光盘安装。<br/>
请总是访问Sangoma 官方技术文档来获得最新技术文档，访问地址为[http://wiki.sangoma.com/Netborder-SS7-Voip-Media-Gateway Sangoma NSG 技术文档]

=下载 NSG ISO版本或者二进制包=
用户可以从此页面下载安装以后自己需要的文件格式：
http://wiki.sangoma.com/NSG-Installation-0

=安装ISO 或者二进制包=
具体的安装步骤可以根据此链接来进行操作：http://wiki.sangoma.com/NSG-Installation-0

=登录NSG 配置界面=
如果安装成功，二进制 SS7 软件包安装以后的，NSG SS7的页面为：http://<NSG-IP>:8888

=配置E1端口，SS7信令=
通常对于中国用户来说，需要配置的参数包括：CRC4，DPC，OPC，拨号属性。关于配置的具体步骤，sangoma 技术人员会协助安装调试，这里我们仅列出一些配置后的截图，一方便用户参考.其中包括了主要的价格步骤：配置E1，配置linkset，配置CIC电路等等，以及如何排查线路状态，具体方法请参考以下链接：
http://www.voip88.com/article-1245-1.html<br/>
通过配置E1，linkset 和CIC电路，显示正常的配置状态，例如：
[[文件:E1-overview.png]]
[[文件:Network-link.png]]
TDM 物理连接，信令状态必须正常，如下截图所示：<br/>
[[文件:Tdm-status.png]]<br/>
中国用户特别注意到是SS7 设置部分，包括对应的中国选项<br/>
[[文件:Ss7-set.png]]

=下载安装FreeSWITCH=
用户可以直接下载任何FreeSWITCH的版本进行安装，这里不做介绍。用户可以安装Sangoma 和FreeSWITCH在同一台服务器，但是需要安装二进制SS7 软件包。

=注册Sangoma网关=
安装FreeSWITCH以后，用户需要配置Sangoma 网关注册信息。在FreeSWITCH 配置sangoma NSG 比较简单，在SIP-profiles 文件夹下 internal.xml 中添加一行代码：
<pre>
<gateway name="sangoma">
        <param name="username" value="sangoma"/>
        <param name="password" value="sangoma"/>
        <param name="realm" value="192.168.1.109:5062"/>  // samgoma 网关IP地址和端口
        <param name="dialplan" value="xml"/>
        <param name="context" value="from-NSG"/>
</gateway>
</pre>
网关注册以后，可以通过Sangoma SS7 管理界面看到成功注册的信息，例如：<br/>
[[文件:Sip-status.png ]]

=添加拨号规则=
1）在default.xml中设置呼入规则：
<pre>
<context name="from-NSG">
    <extension name="incoming_call">
        <condition field="destination_number" expression="1111" break="never"> // 呼入号码为1111
            <!-- extract the span name from the SIP-X headers -->
            <action application="set" data="span=${sip_h_X-freetdm-SpanName}"/>
            <!-- log that we have an incoming call from NSG and which span the call came in on -->
            <action application="log" data="INFO Incoming call from NSG on span=${span}"/>
            <action application="set" data="domain_name=$${domain}"/>
             <action application="transfer" data="1000 XML default"/>   // 分机1000 振铃
             <!-- answer the call...if this is not run, the "echo" application will run in "early media" -->
            <action application="answer" data=""/>
            <!-- use the "echo" application to confirm there is 2 way audio.  Delay audio by 1s so that echo cancelers don't cause problems -->
            <action application="echo" data="1000"/>
        </condition>
    </extension>
</context>
</pre>
2) 在public.xml 中设置呼出规则：
<pre>
<extension name="outgoing_call">
        <condition field="destination_number" expression="^1111$" break="never">
           <action application="export" data="effective_caller_id_number=9999"/> // 透传 ANI 号码
            <action application="bridge" data="sofia/external/${destination_number}@192.168.1.109:5062"/> // 呼出到sangoma SS7
        </condition>
    </extension>
</pre>

=测试呼叫=
1）从外部呼入，呼叫号码为1111，呼入到对应的路由，日志为
<pre>
2014-10-19 16:57:00.634832 [CONSOLE] switch_core.c:2219
[This app Best viewed at 160x60 or more..]
2014-10-19 16:57:00.635316 [ERR] switch_console.c:113 Keybind  is invalid, range is from 1 to 12
freeswitch@ibm> 2014-10-19 16:58:06.772239 [CONSOLE] mod_voicemail.c:4066 Event Thread Started
2014-10-19 16:58:16.752239 [NOTICE] switch_channel.c:1055 New Channel sofia/internal/200@192.168.1.109 [a5fe6ebe-57d2-11e4-9b36-73686695fec4]
2014-10-19 16:58:16.792239 [INFO] mod_dialplan_xml.c:558 Processing 200 <200>->1111 in context from-NSG
2014-10-19 16:58:16.792239 [INFO] mod_dptools.c:1628 Incoming call from NSG on span=wp1
2014-10-19 16:58:16.792239 [NOTICE] switch_ivr.c:1844 Transfer sofia/internal/200@192.168.1.109 to XML[1000@default]
2014-10-19 16:58:16.792239 [INFO] mod_dialplan_xml.c:558 Processing 200 <200>->1000 in context default
2014-10-19 16:58:16.792239 [CRIT] mod_dptools.c:1628 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
2014-10-19 16:58:16.792239 [CRIT] mod_dptools.c:1628 Open /usr/local/freeswitch/conf/vars.xml and change the default_password.
2014-10-19 16:58:16.792239 [CRIT] mod_dptools.c:1628 Once changed type 'reloadxml' at the console.
2014-10-19 16:58:16.792239 [CRIT] mod_dptools.c:1628 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
2014-10-19 16:58:26.792239 [INFO] switch_ivr_async.c:3658 Bound B-Leg: *1 execute_extension::dx XML features
2014-10-19 16:58:26.792239 [INFO] switch_ivr_async.c:3658 Bound B-Leg: *2 record_session::/usr/local/freeswitch/recordings/200.2014-10-19-16-58-26.wav
2014-10-19 16:58:26.792239 [INFO] switch_ivr_async.c:3658 Bound B-Leg: *3 execute_extension::cf XML features
2014-10-19 16:58:26.792239 [INFO] switch_ivr_async.c:3658 Bound B-Leg: *4 execute_extension::att_xfer XML features
2014-10-19 16:58:26.812247 [NOTICE] switch_channel.c:1055 New Channel sofia/internal/sip:1000@192.168.1.103:58804 [abfcb546-57d2-11e4-9b5b-73686695fec4]
2014-10-19 16:58:26.952240 [NOTICE] sofia.c:6668 Ring-Ready sofia/internal/sip:1000@192.168.1.103:58804!
2014-10-19 16:58:26.972239 [INFO] switch_ivr_originate.c:1192 Sending early media
2014-10-19 16:58:26.972239 [NOTICE] sofia_media.c:92 Pre-Answer sofia/internal/200@192.168.1.109!
2014-10-19 16:58:28.492239 [NOTICE] sofia.c:7425 Channel [sofia/internal/sip:1000@192.168.1.103:58804

</pre>
2) 从内部分机1000拨打1111，呼出日志：
<pre>
freeswitch@ibm>
freeswitch@ibm> 2014-10-19 17:11:55.492240 [NOTICE] switch_channel.c:1055 New Channel sofia/internal/1000@192.168.1.210 [8e011742-57d4-11e4-9b70-73686695fec4]
2014-10-19 17:11:55.492240 [INFO] mod_dialplan_xml.c:558 Processing 1000 <1000>->1111 in context public
2014-10-19 17:11:55.492240 [NOTICE] switch_channel.c:1055 New Channel sofia/external/1111@192.168.1.109:5062 [8e01ac0c-57d4-11e4-9b78-73686695fec4]
2014-10-19 17:11:55.832242 [INFO] sofia.c:1203 sofia/external/1111@192.168.1.109:5062 Update Callee ID to "1111" 
2014-10-19 17:11:55.832242 [NOTICE] sofia.c:6668 Ring-Ready sofia/external/1111@192.168.1.109:5062!
2014-10-19 17:11:55.852243 [NOTICE] mod_sofia.c:2077 Ring-Ready sofia/internal/1000@192.168.1.210!
2014-10-19 17:11:55.852243 [NOTICE] switch_ivr_originate.c:527 Ring Ready sofia/internal/1000@192.168.1.210!
2014-10-19 17:11:58.432241 [INFO] sofia.c:1203 sofia/external/1111@192.168.1.109:5062 Update Callee ID to "Outbound Call" 
2014-10-19 17:11:58.452241 [NOTICE] sofia.c:7425 Channel [sofia/external/1111@192.168.1.109:5062] has been answered
2014-10-19 17:11:58.452241 [NOTICE] sofia_media.c:92 Pre-Answer sofia/internal/1000@192.168.1.210!
2014-10-19 17:11:58.452241 [NOTICE] switch_ivr_originate.c:3494 Channel [sofia/internal/1000@192.168.1.210] has been answered
2014-10-19 17:12:16.572238 [NOTICE] sofia.c:952 Hangup sofia/internal/1000@192.168.1.210 [CS_EXECUTE] [NORMAL_CLEARING]
2014-10-19 17:12:16.572238 [NOTICE] switch_ivr_bridge.c:754 Hangup sofia/external/1111@192.168.1.109:5062 [CS_EXCHANGE_MEDIA] [NORMAL_CLEARING]
2014-10-19 17:12:16.592239 [NOTICE] switch_core_session.c:1633 Session 6 (sofia/external/1111@192.168.1.109:5062) Ended
2014-10-19 17:12:16.592239 [NOTICE] switch_core_session.c:1637 Close Channel sofia/external/1111@192.168.1.109:5062 [CS_DESTROY]
2014-10-19 17:12:16.592239 [NOTICE] switch_core_session.c:1633 Session 5 (sofia/internal/1000@192.168.1.210) Ended
2014-10-19 17:12:16.592239 [NOTICE] switch_core_session.c:1637 Close Channel sofia/internal/1000@192.168.1.210 [CS_DESTROY]

</pre>

=常见问题=