SMG User Manual

Overview

This is the User Manual for the Sangoma Signal Media Gateway.

ALERT: Only works with 32 bit Linux at this time; GCC Rev 3.x compilers are recommended.

Contents

Provisioning Questionnaire


  1. Identify the 32 bit Linux distribution that you will use.
  2. Identify each location that will support SS7 inter-machine trunks and PRIs
  3. For each location, count the number of E1/T1 ports needed
  4. Select Sangoma AFT series cards to support decisions above
  5. Fill out the ss7box Installation Questionnaire
  6. Get CIC Mapping for each SS7 inter-machine trunk
  7. Get PRI Provisioning information for each PRI (optional)
  8. Get analog interface provisioning information (optional)

Hardware Installation


  • Select an Intel or AMD based computer with a PCI bus. Choose a model with at least 2 Ghz CPUs and 1 GB of RAM. The more CPUs you have, the better your performance and loading will be.
  • Follow instructions provided by Sangoma for installing WAN interfaces and analog POTS cards.
  • If A200 cards are used and FXS interfaces are installed, then you must connect the supplementary power cables to the rear edge of the card. This step is not included in the printed instructions that are shipped with the card.

Software Installation


  1. Asterisk for SMG Installation
  2. Basic SMG Installation
  3. Add PRI and Analog Support

Configuration


  1. Disable Hotplug services for wanpipe drivers.
  2. Configure zaptel interfaces used for PRI and analog plain-old-telephone-service (POTS) lines.
    • Asterisk PRI Configuration?
    • Asterisk A200 Analog POTS Configuration
    • TDMV_SPAN in wanpipeX.conf are in the range 1..n. Values are used only once. The range applies to both PRI and analog wanpipes. TDMV_SPAN is also the zaptel span number. The range does not apply to the SS7 IMT wanpipes.
  3. Configure SS7 IMT interfaces
  4. Configure Echo Cancellation.
  5. Specify order in which wanpipes are started in wanrouter.rc.
    • Wanpipes that have SS7 links in them must be omitted from wanrouter.rc. ss7box controls these wanpipe interfaces to adhere to the MTP2 protocol. These are the wanpipes whose numbers are specified in ss7box.conf.
    • TDMV_SPAN numbers for zaptel interfaces and the TDMV_SPAN numbers for SS7 IMTs are different instances of the same variable. This means that TDMV_SPAN = 0 in a zaptel wanpipeX.conf is different from TDMV_SPAN = 0 in an SS7 IMT wanpipeX.conf.
    • The following order for starting wanpipes is recommended:
      1. zaptel wanpipe interfaces are started in the order of their zaptel TDMV_SPAN number assignment.
      2. SS7 inter-machine trunk wanpipe interfaces that have no SS7 links in them can be started without regard to order.
  6. ss7box.conf
  7. ss7boost.conf
  8. sangoma_mgd.conf
  9. woomera.conf

Asterisk SMG Configuration

Call Redirection


Operation


SMG Start


Stopping SMG

Use the Shutdown SMG procedure. You may want to leave Asterisk running to continue serving VoIP and Zaptel interfaces; otherwise, use the Shutdown Asterisk procedure.

SMG Initial Test Calls


Checking Revisions

Asterisk, chan_woomera and sangoma_mgd

At the Asterisk CLI:
[root@b2 smg]# asterisk -c -r
Asterisk 1.2.10, Copyright (C) 1999 - 2006 Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'show license' for details.
==================================================================
Connected to Asterisk 1.2.10 currently running on b2 (pid = 3758)
b2*CLI> woomera default version
Woomera version v1.3 : SMG Version v1.3


Wanpipe Firmware

Procedure applies only to AFT series Sangoma cards.
  1. Start the wanpipe either manually or with ss7boxd if SS7 links are on the link.
  2. grep FrmVr /var/log/messages
    Oct 26 16:08:09 ss7box kernel: wanpipe3: Configuring Device :wanpipe3 FrmVr=25
    Anything less than 25 should be upgraded. Refer to the Sangoma Firmware Update Procedure.

Sangoma Driver

[root@b2 smg]# wanrouter version

WANPIPE Release: beta10-p1-2.3.4


xmtp2km

[root@b2 smg]# grep "xmtp2km Rev" /var/log/messages
Oct 11 12:28:25 b2 kernel: xmtp2km:I:public_if.c:xmtp2km_init:
kernel module loaded:xmtp2km Rev. 0.2.41


ss7box

Refer to the ss7box User Manual Operations, Checking Revision section.

  1. cd /ss7box
  2. ./ss7boxd --ver

ss7boost

Refer to the ss7boost User Manual Operations, Checking Revision section.

  1. cd /ss7box
  2. ./ss7boost --ver

SMG Software Upgrade.


Troubleshooting


Asterisk is not running

  • If you have zaptel interfaces, have you:
    1. started them?
    2. run ztcfg before running re-sync.sh
  • start Asterisk with -cvvvvvvvvvvvvvvvvvvvvvv

ss7boost is not running

  • examine /var/log/messages for "F:" messages; there might be a ss7boost.conf problem
  • SELinux prevents SCTP socket creation/binding
    Jul 19 15:41:20 ip-179-20 ss7boost[7030]: W:../common/udp_sockets.c:
    try_open_sctp_socket:bind failed:error msg and IPv4 addr follow:
    Permission denied:127.0.0.66
    Jul 19 15:41:20 ip-179-20 kernel: audit(1184852480.435:14): avc:  denied  
    { 0x400000 } for  pid=7030 comm="ss7boost" saddr=127.0.0.66 
    src=53099 scontext=root:system_r:unconfined_t tcontext=system_u:object_r:
    node_t tclass=socket

Frequently Asked Questions

  1. Question: How do I set the called number nature of address to national or international in an outbound call?
    Answer: Use the Structured Trunk Group Value feature.
  2. Question: How do I set the calling number nature of address to national or international in an outbound call?
    Answer: Assign the appropriate value to the Calling Number NADI parameter for each trunk group in the TRUNK_GROUP section of ss7boost.conf.
  3. Question: How can I set the calling number nature of address to national or international in an outbound call dynamically from the dialplan?
    Answer: Use the NADI In Prefix feature.
  4. Question: Can I get the calling and called number nature of address information from am inbound call in the dialplan?
    Answer: Use the NADI In Prefix feature.
  5. Question: How can I find the relationship between trunk group, span, and wanpipe?
    Answer: The information is available in ss7boost.conf and wanipeX.conf. This is a stub - more to come.
  6. Question: What is an SUERM?
    Answer: An SUERM is a signal unit error rate monitor indication - line errors: CRC, one's density in HDLC, signal unit too big or too small. A bi-polar violation is also a SUERM error but the Sangoma driver does not deliver this information to xmtp2km so it is not included in the counts. A SUERM occurs because the means the link is "dirty" or it means the MTP2 layer is starved for time. SUERMs can occur when starting and stopping wanpipes because those are lengthy kernel level operations, so the probability of starving MTP2 of a timely allotment of run-time increases. SUERMs during normal operations probably indicate transmission line disturbances. The SUERM is an up/down counter. One violation is an up-count. A down-count is 256 subsequent good signal units. If 64 up-counts accumulate, the link is forced to its initial level 2 state.
  7. Question: What is the ISUP suspend message?
    Answer: You might see indications in the log file that suspend ISUP messages are arriving. Ask your switch operator how/why the suspend is being used. It is often used as a pre-hang-up step and amounts to being of no use. If this is the case, ignoring the suspend is acceptable. The suspend/resume procedure was intended to be a way for a circuit to held in limbo for a short period. The purpose of this limbo state is not well-defined and certainly not consistently defined. It can irritate customers when they hang up and are prevented from making another call until the suspend timer expires and proceeds to the call ending procedure. The suspend is a mystery to be solved in each location.

Created by: mike last modification: Tuesday 21 of August, 2007 [14:15:30 UTC] by mike

The original document is available at http://www.ss7box.com/tiki-index.php?page=SMG%20User%20Manual