5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 1/11

Manual Installation for TDM Cards for Asterisk

Deciding on Server and Operating system?

Selecting your server

Selecting your Linux Operating system

Preparing your Operating system for software packages

Downloading Software Packages

Installing Software Packages

Sangoma Driver Installation

Configuration

Operation

Before attempting to download and compile Linux package manually,

check out our All-in-One WebGui solutions that may be a better choice for you

For the Following Hardware, click for specific installation instruction:

W400 GSM Card

Media Transcoding (D100/D150/D500)

VoiceTime USB

Deciding on Server and Operating system?

Selecting your server

Sangoma cards are compatible with most commercially available servers and motherboards on the market.

Our cards are available in both PCI and PCI express versions and are backwards compatible (i.e. 16x, 8x, 4x, 2x)

Also available are different size brackets for 1U and 2U server form factors.

* If you require the use of analog cards, please verify that your server has available molex power connection from internal power supply

(required only when using FXS modules and/or remora expansion boards)

Selecting your Linux Operating system

Sangoma cards are compatible against most official Linux distributions and kernels (i.e. CentOS, Debian, Ubuntu) 32 and 64bit.

Sangoma recommends the use of CentOS as we use this distributions in our development and QA environments.

* Virtual environments are not supported. Even if you are not usual virtual environments, verify your distribution is not based on

virtualization (i.e xen)

Below are instructions for CentOS distribution. If you would like use a different Linux Distro, please visit the appropriate resources online.

1. Download latest CentOS distribution:

32-bit: http://isoredirect.centos.org/centos/6/isos/i386/

64-bit: http://isoredirect.centos.org/centos/6/isos/x86_64/

2. After downloading the CentOS ISO, simply burn the image on CD/DVD using your choice of burning utility

3. Boot your server with the CD/DVD containing your CentOS ISO. Verify your BIOS settings allow for Boot from CD/DVD ROM drive

4. Follow the on-screen prompts to Install your new operating system. You may wish to visit some online step-by-step tutorials (google:))

5. Once completed, remove the CD/DVD from your server and reboot your server and log in to your freshly installed operating system

-> Proceed to below steps to continue with installation procees

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 2/11

Preparing your Operating system for software packages

After installing your Linux operating system, you must prepare your server with the following software requirements before continuing.

To Install required system dependencies simply copy and paste the below string directly into your Linux command line. The string will

automatically download and install missing dependencies on your server.

*You must have internet connection for this step.

For CentOS (RedHat distros)

yum -y install kernel-devel-$(uname -r) libtool* make gcc patch perl bison gcc-c++ ncurses-devel flex libtermcap-devel

autoconf* automake* autoconf libxml2-devel cmake

For Ubuntu/Debian

apt-get -y install gcc g++ automake autoconf libtool make libncurses5-dev flex bison patch libtool autoconf linux-headers-

$(uname -r) libxml2-devel cmake

Downloading Software Packages

Software Source Download Source (tgz)

Asterisk current-release

Dahdi dahdi-linux-complete-current

Libpri (for PRI/BRI only)

1.4-current

Software found at http://www.asterisk.org/downloads

Now that your Linux operating system is prepared, begin to download your required software packages

1. Download all your software in /usr/src/ directory.

Change directory to /usr/src:

cd /usr/src

2. Copy&paste each of the lines below (one by one) in your command line (in /usr/src) to automatically download each software package

(.tgz files)

wget http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-complete-current.tar.gz

wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-11-current.tar.gz

wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.4-current.tar.gz

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 3/11

* Do not download libpri (the third line) if you only require Analog card support

You have now finished downloading Asterisk, DAHDI and LibPRI software for your server

Installing Software Packages

The following instructions will guide you to uncompress the downloaded '.tgz' Asterisk/DAHDI/LibPRI files and install using make command

1. DAHDI Installation

Untar DAHDi software packagepreviously downloaded in /usr/src/ and install

tar xvzf dahdi-linux-complete<version>

cd dahdi-linux-complete <version>

make

make install

make config

* If there are any error messages while trying to the above commands, you are missing system dependencies listed in previous steps

2. LibPRI Installation (required for PRI/BRI only)

Untar libPRI sources previously downloaded in /usr/src/ and install

tar xvfz libpri-<version>

cd libpri-<version>

make

make install

* If there are any error messages while trying to the above commands, you are missing system dependencies listed in previous steps

3. Asterisk Installation

Note: if you are upgrading Asterisk make sure that old asterisk modules are removed from /usr/lib/asterisk/modules

cd /usr/lib/asterisk

mv modules modules.old

Untar asterisk sources previously downloaded in /usr/src/ and install

tar xvfz asterisk-<version>.tgz

cd asterisk-<version>

./configure

make

make install

make samples (will create new config files)

* If there are any error messages while trying to the above commands, you are missing system dependencies listed in previous steps

Now you are ready to install the Sangoma Wanpipe driver which controls & configures the Sangoma card

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 4/11

Sangoma Driver Installation

The following instructions will guide you through the Installation of the Sangoma Wanpipe driver on your server that contains all

required software pacakges already installed(i.e. Asterisk, DAHDI, Libpri).

1. Download the latest official release of the Sangoma Wanpipe Driver

Copy & Paste the line below into your Linux command line in /usr/src/ directory.

It will automatically download the driver

wget ftp://ftp.sangoma.com/linux/current_wanpipe/wanpipe-current.tgz

---

2. Uncompress the download wanpipe download (.tgz file) in /usr/src

tar xvfz wanpipe-current.tgz

cd wanpipe-<version>/

---

3. To Install Wanpipe, run ./Setup install from the newly created wanpipe-<version> directory

./Setup install

** For A116 Customers: please use ./Setup install --dahdi-chunk=40 (For more info click here)

You will notice the Wanpipe driver installation splash screen next.

Press 'y' to continue

You will be presented with a dependency check with pass/fail results. If there are any failures, you must exist and install missing

dependency manually.

Press [enter] to continue

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 5/11

Press [enter] on the following screen for default kernel source location.

If there are any error messages that result, that means you are missing your Linux kernel development packages.

This also means that during the 'Preparing your Operating system for software packages' step above has failed to download your

kernel-devel packages. If this happens you must search online for the kernel-devel packages for your kernel, then download and install

using (rpm -i...)

Press [enter] to continue

Next you will be presented with 7 different options on how to install the Wanpipe driver.

Select option 2 to install the Wanpipe driver for Asterisk

You will be asked to provide the location of your DAHDI software package.

If you have downloaded and installed DAHDI in /usr/src/, simply press the number pertaining to the location.

In the example below, Press 1.

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 6/11

In this example, the user has dahdi version 2.7.0 installed on their system

If your DAHDI installation lives in another directory, press 'm' then manually enter the full path

If you have multiple DAHDI versions on your system, select the correct one.

(to find out which version of dahdi is installed on your system simply type dahdi_cfg -vvv command in another Linux window)

The Wanpipe driver will now start to compile on your Linux operating system.

Press 'y' to proceed

Press [enter] to continue

Press [enter] to continue

The example above is for an a108 8 port E1/T1 card

continue to press [enter] as seen below

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 7/11

press [enter] to continue

You should end up with the following screen. If you see error messages, then you are missing system dependencies.

continue to press [enter] when asked.

Press 'y' to install Wanpipe start scripts

The following screen indicates that the Wanpipe driver has completed installation on your server and is now ready to start Configuring

your Sangoma hardware on your system

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 8/11

Press 'y' to configure all Sangoma hardware installed on server.

If you have installed Wanpipe to upgrade from a previous version, you must exit installation now because if you continue you will

overwrite all previous configuration

If you have not installed your Sangoma hardware yet, you can exit the installation, install hardware and continue by typing wancfg_dahdi

command to start configuration script.

*** If your Sangoma hardware was NOT detected by your system, or if the Wanpipe driver failed to install properly, the following screen

will appear.

error message

The on-screen prompts that present next will be unique to your Sangoma hardware and specific to your telco settings.

We will not show these screens here , but if you wish to see more details on what screens would show next, please visit the specific

wancfg_dahdi pages for details

After you have completed the configuration section of your Sangoma hardware, the following summary screen will be presented.

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 9/11

summary2.png

Example from configuration of 1 analog card

Select option 3 below to save and stop Asterisk & Wanpipe (if already running). Any new configuration will apply only after restarting

* If you see the following screen, simply press option 2 (YES) to proceed

Select option 1 to start Wanpipe on system boot. If your server ever reboots unintentionally, you will want the driver to automatically start

in order to have your server back in production without manual intervention

Select option 1 (YES) to have 'dahdi_cfg' run after the Wanpipe driver starts. This step configures on Wanpipe ports for dahdi

You have now fully installed and configured your Sangoma Hardware for your Asterisk server!

To verify that you have successfully installed the Sangoma Wanpipe driver by typing the following command in your Linux command line:

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 10/11

wanrouter hwprobe

You should see details of your Sangoma hardware auto-detected in your system.

If you see an error message, this means the Wanpipe driver was NOT installed correctly.

Please open /var/log/messages file for error details

Configuration

1. Configure your Asterisk System with the following:

Note -> this step was offered at the end of the ./Setup dahdi, if you already configured the card skip this step and proceed to the next

step

wancfg_dahdi

---

Creates Dahdi configuration files

Creates wanpipe configuration files in /etc/wanpipe

Creates dahdi config file in /etc/dahdi/system.conf

Creates Asterisk dahdi config file in /etc/asterisk/chan_dahdi.conf

Operation

1. Start the Sangoma Driver (Wanpipe Ports)

wanrouter start

- starts all ports

- check /var/log/messages for any errors

---

2. Configure DAHDI module

Note: the option to have this step performed automatically was offered at the end of ./Setup dahdi.

If you selected YES, then you can skip this step as it will perform automatically after "wanrouter start"

dahdi_cfg

Configures DAHDI kernel modules from /etc/dahdi/system.conf ( Previously - ztcfg )

---

3. Start Asterisk

asterisk

4. Access the Asterisk CLI and fun some basic commands to verify your Asterisk suite is ready for production

CLI> asterisk -rv

Type the following CLI command to verify all your channels (dahdi channels) are loaded into asterisk:

CLI> dahdi show channels

If you receive an error or no output from the above command, verify chan_dahdi loaded into asterisk

5/23/2014 Support Wiki - Manual Installation for TDM Cards for Asterisk

http://wiki.sangoma.com/wanpipe-linux-asterisk-dahdi 11/11

Products

Hardw are Products

Softw are Products

Media Gatew ays

Multiplexers

Solutions

Open Source

IP-PBX

IVR

Contact Centers

Carrier Solutions

Data Netw orking

Ordering

Where to Buy

Request a Quote

Become a Partner

Resources

Training

Success Stories

Whitepapers

Solution Providers

Developers Netw ork

Glossary

CLI> module load chan_dahdi.so

If the above returns an error message check /var/log/asterisk messages ( or /var/log/asterisk/full) for the reason why

Run the following command to verify if your PRI or BRI spans are UP and Active:

CLI> pri show spans