Sunteți pe pagina 1din 11

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
Hardware Products
Sof tware Products
Media Gateways
Multiplexers
Solutions
Open Source
IP-PBX
IVR
Contact Centers
Carrier Solutions
Data Networking
Ordering
Where to Buy
Request a Quote
Become a Partner
Resources
Training
Success Stories
Whitepapers
Solution Providers
Developers Network
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

S-ar putea să vă placă și