Installing Wanpipe for Asterisk with Dahdi Support

1. Requirements
2. Download Asterisk/Dahdi/Libpri
3. Installing Asterisk/Dahdi/Libpri
4. Driver Installation
5. Configuration/Operation
6. Dahdi Documentation (voip-info)

* The requirements below are a prerequisite

Requirements

For RedHat/Debain based distributions you need to run the command below to install all the required packages in order to compile. 

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

• apt-get -y install gcc g++ automake autoconf libtool make libncurses5-dev flex bison patch libtool linux-headers-$(uname -r)

For all other distributions please go to http://wiki.sangoma.com/Wanpipe-Requirements for a full list of requirements to install before compiling. 

Downloading Asterisk/Dahdi/LibPRI

Go to http://www.asterisk.org/downloads and download Asterisk/Dahdi/LibPRI
(Look for Asterisk downloads  on right-hand side) .
You can use wget command to download sources (tar ball) on your local directory.

For example:
#> wget http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-complete-current.tar.gz
#> wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.4-current.tar.gz
#> wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-1.6.2-current.tar.gz
 

Installing Asterisk/Dahdi/Libpri

1. Dahdi Installation
    
   Download Dahdi into arbitrary directory (/usr/src) and  untar it.
   

   #>tar xvfz dahdi-linux-<version>
   #>tar xvfz dahdi-tools-<version>

   #>ln -s dahdi-linux-<version> dahdi
   #>cd dahdi-linux-<version>
   #>make
   #>make install
   #>cd ..
   #>cd dahdi-tools-<version>
   #>./configure
   #>make
   #>make install

2. LibPRI Installation
   Download libpri into arbitrary directory (/usr/src) and untar it.
   

   #>tar xvfz libpri-<version>
   #>cd libpri-<version>
   #>make
   #>make install

3. Asterisk Installation
   
   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

   Download Asterisk into arbitrary directory  (/usr/src/) and untar it.
   Untar Asterisk and proceed with installation

   #>tar xvfz asterisk-<version>.tgz
   #>cd asterisk-<version>
   #>./configure     
   #>make
   #>make install
   #>make samples (in case of very first install)

Please note: <version> refers to the specific release of your program. For instance, dahdi-linux-2.0.0.tar.gz, once untarred will create the folder dahdi-linux-2.0.0.
  
Once Dahdi, Libpri and Asterisk are downloaded and untarred, you may proceed with WANPIPE® installation.
 
After completing the WANPIPE® TDM installation, you may proceed to configuring the full Asterisk suite.

Wanpipe TDM/Dahdi Installation (Linux)

1. Download the latest release                                 -> Wanpipe Latest Driver
      or
   Download the the latest feature frozen release  -> Wanpipe Feature Frozen Driver
   ---
   What is wanpipe? Check out our Wanpipe Driver FAQ
   ---
2. Untar wanpipe release in arbitrary directory (/usr/src/ is recommended).
   

   #>tar xvfz wanpipe-<version>.tgz
   #>cd wanpipe-<version>

   After untarring WANPIPE®, the wanpipe<version>/ directory will be created. 
   ---
3. Run ./Setup dahdi  or make dahdi from the newly created wanpipe-<version> directory
      
            #>./Setup dahdi
       or
            #> make dahdi DAHDI_DIR=<absolute path of dahdi>
            #> make install
            *** make should be used by power users who know exactly what they are doing :)
    
   Proceed with installation Select "Y" for each option.
   
   Setup will try to auto-detect dahdi sources in /usr/src directory ?
   [By default Setup will look in /usr/src]  
   
   *** Setup is great for one off install,  make is great for power users.
   ---
4. Proceed with Defaults for the rest of the compilation.   
   --
5. Last step in installation will ask you to configure wanpipe cards for Dahdi
   -> Proceed with YES this is your initial installation
   -> Note wancfg_dahdi configurator will overwrite your
        system.conf and chan_dahdi.conf files and
        save the originals as system.conf.bak and chan_dahdi.conf.bak
   
   If any errors are encountered during the compilation of the utilities, click here for assistance.

 
Confirm Successful Wanpipe/Dahdi Installation

1. Confirm successful Wanpipe/Dahdi installation run:
   

   #>wanrouter hwprobe

   
   This command will load the wanpipe and Dahdi modules and will print out list of all Sangoma hardware installed on the system. 

Configuration/Operation

1. Create Wanpipe/DAHDI Configuraiton Files -> run:
   #> wancfg_dahdi
   ---
       (Note -> this step was offered at the end of the ./Setup dahdi,
        if you already configured the card proceed to the next step)
         - 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
   ---
2. Start Wanpipe Ports
   #> wanrouter start
         - Starts all wanpipe ports
         - Check /var/log/messages for info or errors
   ---
3. Configure DAHDI module
   #> dahdi_cfg
         - configures DAHDI kernel modules from /etc/dahdi/system.conf ( Previously - ztcfg )         
   ---
4. Start Asterisk
   #> safe_asterisk