How to find out Your Sangoma card model number and it's firmware version

Sponsored by:

Required Level: novice, accomplished, adept, master

Prerequisites:

• Compiled and installed fresh wanpipe drivers
  

Summary :

In this article You will learn how to identify Your card's model, features and firmware version.

See also : http://wiki.sangoma.com/sangoma-hardware-matrix

Automatic identification:

To automatically detect the card (on Linux 2.6.18 an newer) and get firmware upgrade and card placement hints You have to download a script from VoiceWorks site and execute it from root account:

[root@lab8 ~]# wget http://www.voiceworks.pl/wookieboo/scripts/detect_sangoma.pl

[root@lab8 ~]# perl detect_sangoma.pl
1) A104m-X, firmware v31 (update to newer v33!), dedicated PCI-Express bus (OK)
2) A104m-X, firmware v31 (update to newer v33!), dedicated PCI-Express bus (OK)

[root@lab7 ~]# perl detect_sangoma.pl
1) A108dm-X, firmware v31 (update to newer v33!), dedicated PCI-Express bus (OK) 

[root@lab6 ~]# perl detect_sangoma.pl
1) A104-X, firmware v25 (update to newer v26!), dedicated PCI-Express bus (OK)
2) A104-X, firmware v25 (update to newer v26!), dedicated PCI-Express bus (OK)

[root@lab3 ~]# perl detect_sangoma.pl
1) A500, firmware v31(OK), shared PCI bus!!!(change the slot) 

Manual Identification :

To identify the card and it's firmware one has to analyze the output of 'wanrouter hwprobe'
command executed as root on the server:

Read More About Identifying Sangoma Card And Firmware...

Sponsored by:

W celu umożliwienia użytkownikom FreeSwitcha korzystania z kart TDM stworzony został moduł OpenZAP.

Środowisko testowe:

* Wanpipe 3.2.5 (wersja stabilna)
* Centos 5.1 - kernel 2.6.18-53.1.14
* Freeswitch svn rev - XXXX (RC4)
* Sanogma A101D

Kolejne kroki w celu instalacji karty A101D w Freeswitchu

1. Instalacja karty sangoma
2. Instalacja Freeswitcha i modulu OpenZAP
3. Konfiguracja karty
4. Konfiguracja modułu OpenZAP w Freeswitchu
5. Konfiguracja parametrów wychodzącego połączenia (BC, TON itp)
6. Konfiguracja testowego Dial Planu
7. Diagnozowanie problemów

1. Instalacja karty Sangoma

W czasie pisania tego arytkułu Freeswitch świadczył wsparcie tylko dla kart: A10X, A200 i A400.

Wymagane pakiety

yum install ncurses-devel libtermcap-devel patch perl byacc flex bison kernel-devel 

Jeśli wykonany został update kernela naleźy pamiętać o restarcie komputera. Dobrym nawykiem jest równieź sprawdzenie czy pakiety kernel i kernel-devel odnoszą sie do tej samej wersji tzn.

[root@blackbox ~]# uname -r
2.6.18-53.1.14.el5

[root@blackbox ~]# rpm -qa |grep kernel

kernel-2.6.18-53.el5
kernel-2.6.18-53.1.14.el5
kernel-headers-2.6.18-53.1.14.el5
kernel-devel-2.6.18-53.1.14.el5

Sprwdzamy zgodność dla wesji krenla którą wskazuje "uname -r"

Następnie naleźy ściągnąć sterowniki ze strony, rozpakować je i rozpocząć instlacje

cd /usr/src
wget ftp://ftp.sangoma.com/linux/current_wanpipe/wanpipe-3.2.5.tgz
tar zxvf wanpipe-3.2.5.tgz
cd wanpipe-3.2.5
./Setup install

W trakcie konfiguracji naleźy wybrać następujące opcje:

Proceed to build WANPIPE kernel modules ? [y] (y/n) y

----------------------------------------------------------

WANPIPE v3.2.5 Installation Script

Copyright (c) 1995-2008, Sangoma Technologies Inc.

----------------------------------------------------------

Please Select Compilation Mode

1. WAN Protocols Support

Protocols: Frame Relay, CHDLC, PPP, ATM, X25, ADSL, TDM API

Default for: Wan Routing, Data & Voice API devel.

2. TDM Voice (Zaptel) Support

Protocols: TDMV (Zaptel), TDM API on AFT adatpers.

Default for: Asterisk & CallWeaver

3. TDM Voice (Zaptel) + WAN Protocol Support

4. SMG (SS7) (Default for Asterisk/CallWeaver SMG/SS7 install)

5. SMG (SS7) + TDM Voice (Zaptel)

Default for: Asterisk/CallWeaver SS7 + PRI

6. TDM API

Protocols: TDM API on AFT adapters:

Default for: FreeSwitch, Yate, Sunrise

Custom voice development

7. Custom Compilation Mode

Specify protocols to be added into the WANPIPE

kernel drivers.

Please select (1,2,3,4,5,6 or 7) [Default: 1]: 6

2. Instalacja Freeswitcha i modulu OpenZAP

W tym punkcie zostaną skompilowane wszystkie elementy niezbędne dla parawdiłowego działania karty Sangoma pod kotrola oprogramowania jakim jest Freeswitch.

Jeśli powyźsze skrypty wykonały się bez błędów to naleźy dodać moduł mod_openzap do gupy modułów budowanych podczas kompilacji

vi modules.conf

i zamienić linie

#../../libs/openzap/mod_openzap

na

../../libs/openzap/mod_openzap

Ostatnim krokiem jest wywołanie komendy mak czyli:

make all install

make samples
make sounds-install
make moh-install

3. Konfiguracja karty

W celu prawidłowej konfiguracji porów w karcie naleźy wywołać polecenie:

/usr/sbin/wancfg_tdmapi

Uwaga!!! W przypadku pytania "Select signalling mode for port 1 on 10X" naleźy wybrać "CCS". Pozostałe odpowiedzi powinny być zgodne z parametrami podłączonego łącza.

4. Konfiguracja modułu OpenZAP w Freeswitchu

Poniźsza przykładowa konfiguracja jest w oparciu o kartę A101D z jednym portem E1.

mkdir /etc/openzap

cd /etc/openzap

vi openzap.conf

[span wanpipe]
name => OpenZAP
number => 1
trunk_type => E1
b-channel => 1:1-15
d-channel => 1:16
b-channel => 1:17-31

vi wanpipe.conf

[defaults]
codec_ms => 20
wink_ms => 150
flash_ms => 750

vi /usr/local/freeswitch/conf/autoload_configs/openzap.conf.xml

<configuration name="openzap.conf" description="OpenZAP Configuration">

<settings>

<param name="debug" value="0"/>

</settings>
<pri_spans>

<span id="1">

<param name="mode" value="user"/>
<param name="dialect" value="euro"/>
<param name="dialplan" value="XML"/>
<param name="context" value="default"/>

</span>

</pri_spans>

</configuration>

chmod 644 /usr/local/freeswitch/conf/autoload_configs/openzap.conf.xml

vi /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml i zamienić linie

<!-- <load module="mod_openzap"/> -->

na

<load module="mod_openzap"/>

5. Konfiguracja parametrów wychodzącego połączenia (BC, TON itp)

W tej chwili nie ma moźliwości konfiguracji parametrów dla połączeń wychodzących z poziomu plików konfigurcyjnych. W celu zmiany któregoś z poniższych parametrów naleźy wyedytować plik zap_isdn.c, doknać zmian i dokonać kompilacji całego modułu mod_openzap.

Uwaga!!! Dokonane zmiany są globalne co oznacza że będą widoczne dla wszystkich skonfigurowanych spanów.

Bearer Capability

Coding Standard = ITU-T
Information Transfer Capability = Speech
Transfer Mode = Circuit
Information Transfer Rate = 64k

Calling Number

Type of number = National number
Numbering Plan = ISDN/telephony numbering plan (E.164)
Presentation indicator = Presenation Allowed
Screening Indicator = User-provided, not screened

Called Number

Type of number = National number
Numbering Plan = ISDN/telephony numbering plan (E.164)

6. Konfiguracja testowego Dial Planu

Połączenie Telco -> Freswitch (OpenZAP)

Dialplan dla testowego połączenia przychodzącego od operatora do FS jest domyślnie gotowy. Wystaczy wybrać numer 5000 aby cieszyć sie połączeniem z przykładowym IVRem.

Uwaga!!! Jeśli nie słychać zapowiedzi naleźy sprawdzić czy w punkcie 2 zostały wykonane komendy:

make sounds-install
make moh-install

Połączenie Freeswitch (OpenZAP) -> Telco

Dialplan dla wykonywania połączeń wychodzących z FS do operatora musi zostać stworzony. Przykładowy dialplan dla połączeń wychodzących na numery 123456XX został przedstawiony poniżej.

<extension name="openzap_test">

<condition field="destination_number" expression="^(123456..)$">

<action application="answer"/>
<action application="bridge" data="OpenZAP/1//$1"/>

</condition>

</extension>

Powyźszy dialplan pozwoli na wykonanie połączenia wychodzącego - 1 span, pierwszy wolny kanał B z grupy dostępnych kanałów.

Dozwolone konfiguracje:

OpenZAP/<SPAN>/<CHANNEL>/<DESTINATION_NUMBER>

<SPAN> - numer spanu na który naleźy wysłać połączenie (brak wartości oznacza wybierz dowolny span na którym są wolne szczeliny).

<CHANNEL> - numer kanału na który naleźy wysłać połączenie lub zostawić pustą wartość jeśli ma zostać wybrany dowolny kanał z puli dostępnych (wolnych) kanałów.

<DESTINATION_NUMBER> - numer abonenta docelowego.

7. Diagnozowanie problemów

Lista komend przydatnych w diagnozowaniu stanu i problemów związanych z modułem OpenZAP.

Performance tests of 16E1s SS7 Sangoma Media Gateway

Sponsored by:

Abstract:

In this article we present performance data on 16E1 SS7 setup based on Sangoma's SMG & Asterisk as a voice application server.
CPU usage and Unix system load are analysed as a function of number of calls in the answered state both for centralized & distributed setup. Load analysis shows that in a distributed setup a Dual Core 3GHz AMD Opteron server has enough resources to handle full 16E1 load with room for additional applications like SIP termination.

Performance of 8E1s Sangoma Netborder Express Gateway

Sponsored by:

Required Level: novice, accomplished, adept, master

Abstract:

Sangoma's NetBorder Express is a complete SIP-compliant VoIP to TDM Media Gateway solution that is user friendly and works under Windows operating system . Product consist of Sangoma A10(1/2/4/8) cards (max  32xE1) and dedicated software+drivers.  In the article we present results of performance test of this product (8xE1 setup) with FreeSWITCH as a SIP terminating PBX. Tests took place in VoiceWorks laboratory. 

Goals:

Test CPU and RAM memory usage in two scenarios :

• 1 machine - FreeSWITCH and Netborder Express Gateway on the same server,
• 2 machines - Netborder on Windows machine and FreeSWITCH on Centos Linux

Purpose of this test is to measure performance of the latest Sangoma's product under Windows platform.

Lab Setup :

• Hardware
  
  
  • HP DX2400,  Intel Core 2 Quad CPU Q9300 (4x2,5 GHz), 2 GB RAM, 250 GB SATA HDD (Windows)
  • noname Intel Xeon 2x2 GHz, 2 GB RAM, 2x110 HDD (Centos Linux)
  • Sangoma A108D PCI-e cards, 8 E1 port PSTN cards with HW Echo Cancellation
  • 2 x Patton 4960 Gateways (4xE1 each)
  • Netborder Express Gateway Card

• Sofware
  
  
  • Windows XP Professional Service Pack 3
  • Netborder Express Gateway v 1.6.1
  • Sangoma Windows Driver 6.0.5.8
  • CentOS 5.2
  • FreeSWITCH version 1.0.trunk

Methodology:

Call scenarios for both setups are the same. We start with empty system and add a new call every 3 seconds untill all chanells are occupied. Then during the period of 5 minutes we drop a random call (every 375 ms) and than replace it with the a new one. Below there is the description of a single call flow:

1. G.711 SIP call is originated from FreeSWITCH to Sangoma's Netborder Express,
2. Netbord forwards the call to Patton,
3. Patton loops the call back to Netboard,
4. Netbord forwards the call back to FreeSWITCH,
5. FreeSWITCH answers the call and exectues "Echo" application.

Basically every call occupies 2 time slots.

During the tests we monitor CPU utilization (Total and for every Core), memory usage and HD activity. All the parameters on Windows machine are monitored by build in Performance Monitor. To achieve maximum performance  we are disabling all debugs on the Netboard machine.

Patton boxes are also used to check if Sangoma's new products is fully compliant with Euro-ISDN standards.  

Configuration:

 FreeSWITCH config files:

• default.xml (dialplan)
• sofia.conf.xml
• switch.conf.xml

 Netboard Express Gateway config files:

• routing-rules.xml

 

Results:

Conclusions:

Tests showed that there is a lot of spare resources for increasing capacity of the system or building complex logic when FreeSWITCH is running under Windows even on everyday desktop computer. Both setups are able to easily handle 8E1s and uses less than 1/4 of the CPU. Simple extrapolation confirms that distributed setup could handle at least 32xE1 on a single machine. CPU load is evenly distributed between cores which guarantees optimal resources usage. 

This lab setup also hits at solution for all Open-Source integrators that are faced with obstacles like Windows environment or strict ISDN compliance requirements for their installs.

Sangoma's Netborder Express comes with certification from huge number of vendors opening doors to every possible tender. When coupled with FreeSwitch, the ultimate Open-Source telephony integration tool, running along on the same Windows machine one gets an unbeatable combo in the market segment previously reserved only for selected players.

A fool-proof guide to installing Wanpipe under Asterisk-ONE

Sponsored by:

Required Level: novice, accomplished, adept, expert, master

Prerequisites:

• AsteriskNOW installed natively (no Xen nor VMware) on a server or PC
• Digital or Analog port Sangoma card

Warnings:

Be sure to read hardware quick start guide for Your card so that we know
that all power and signaling or Telco/phone cables are connected properly
and the card will not have any interrupt problems.

Beware that AsteriskNOW has been designed only for analog port cards
of Digium variety so installing Sangoma cards, especially with digital ports
makes Asterisk GUI partially useless.

Summary :

This articles demonstrates how to install Sangoma Wanpipe drivers on AsteriskNOW.

The procedure is very boring but can be automated. All that is necessary
is to download and run (as root) an automation script from VoiceWorks site:

http://www.voiceworks.pl/wookieboo/scripts/wpastnow.sh

The script does the following:

• Downloads and compiles missing software development tools :
  flex, byacc, m4.
• Detects AsteriskNOW kernel version and downloads a source of matching one
• Prepares (bootstraps) the kernel source for kernel module compilation
• Detects AsteriskNOW zaptel version and downloads a source of matching one
• Downloads the most recent public Wanpipe version and installs it
• Remove zapscan utility that overwrites Wanpipe configuration

Detailed instructions:

Use our favorite SSH client (eg Putty for Windows) to log onto Your box
using the same IP address / user / password combination You use
to log in to Asterisk GUI.

Assuming the IP is 10.0.2.135 and a unix ssh client that would looke like:

> ssh admin@10.0.2.135
admin@10.0.2.135's password:
Last login: Thu Oct 4 14:58:22 2007 from gamma.urtho.net
[admin@localhost ~]$

Now enter into privileged mode typing ‘sudo su –‘ and enter the same password as above

[admin@localhost src]$ sudo su -
Password:
[root@localhost ~]#

Be sure that internet works:

[root@localhost ]# ping -q -c1 -w1 ripe.net >/dev/null 2>&1 && echo "Ok"
Ok, internet works

Download VoiceWorks automation script :

[root@localhost ]# wget http://www.voiceworks.pl/wookieboo/scripts/wpastnow.sh

For security paranoid ppl : MD5 for the above file (version 1.02) is 7169d9e921f21584f9dcc50a2414beca

Now execute the script with:

[root@localhost ~]# bash wpastnow.sh

After a looong while You can start configuring Your Sangoma card with wancfg_zaptel utility.

[root@localhost ~]# wancfg_zaptel

Now would be the best time to check if Your Sangoma card has the latest firmware version.