Wanpipe / Zaptel / Asterisk

1. Requirements
2. Installing Asterisk/Zaptel/Libpri
3. Driver Installation
4. Configuration/Operation

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. 

Installing Asterisk / Zaptel / Libpri

Note: Asterisk/Zaptel/Libpri Source can be downloaded from http://www.asterisk.org/downloads (Look for Asterisk downloads  on right-hand side)

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

   #>tar xvfz zaptel-<version>
   #>ln -s zaptel-<version> zaptel
   #>cd zaptel-<version>
   #>./configure
   #>make
   #>make install
   

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

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

4. 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 arbirary 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, zaptel-1.4.8.tar.gz, once untarred will create the folder zaptel-1.4.8/
  
Once Zaptel, 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/Zaptel Installation (Linux)

1. Download the latest release                                 -> Wanpipe Latest Driver
      or
   Download the the latest feature frozen release  -> Wanpipe Feature Frozen Driver
   ---
   --
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 install from the newly created wanpipe-<version> directory
      
            #>./Setup zaptel
       or
            #> make zaptel ZAPDIR=<absolute path of zaptel dir>
            #> make install
            *** make should be used by power users who know exactly what they are doing :)
   
   Proceed with installation Select "Y" for each option.
   Under compilation mode:  Select "TDM Only drivers" (Option #2).
   
   Setup will auto-detect zaptel sources in /usr/src directory?
   [By default Setup will look in /usr/src]
    
   Zaptel 1.4 -> wanpipe drivers use zaptel supported hwdchan so no patching is needed.
                               Zaptel does not need to be recompiled
    
   Zpatel 1.2-> Setup will ask you if you would like to add support for Sangoma HW HDLC DCHAN PRI to Zaptel.
                                "Enable TDMV DCHAN Native HDLC Support & Patch Zaptel ? (y/n)"
                                 Select "Y" to Enable HW HDLC on DCHAN PRI in Zaptel.
                         Setup will ask you if you would like to recompile/reinstall Zaptel.
                                "Recompile/reinstall zaptel (recommended) ? (y/n) "
                                 Select "Y" to recompile/reistall Zaptel 
     ---
4. Proceed with Defaults for the rest of the compilation.  
   ---
5. Last step in installation will ask you to configure wanpipe cards for Zaptel
   ---
   -> Proceed with YES this is your initial installation
   -> Note wancfg_zaptel configurator will overrite your zaptel.conf and zapate.conf files and
        save the originals as zaptel.conf.bak and zapata.conf.bak
   -> The configuration process continues on Configuration Section
   
   If any errors are encountered during the compilation of the utilities, click here for assistance.

 
Confirm Successful Wanpipe/Zaptel Installation

1. Confirm successful Wanpipe/zaptel installation run:
   

   #>wanrouter hwprobe

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

Configuration/Operation

1. Create Wanpipe/zaptel Configuraiton Files -> run:
   #> wancfg_zaptel  
       (Note -> this step was offered at the end of the ./Setup zaptel,
        if you already configured the card proceed to the next step)
         - Creates wanpipe configuration files in /etc/wanpipe
         - Creates zaptel config file in /etc/zapte.conf 
         - Creates Asterisk zaptel config file in /etc/asterisk/zapata.conf
   ---
2. Start Wanpipe Ports
   #> wanrouter start
         - Starts all wanpipe ports
         - Check /var/log/messages for info or errors
   ---
3. Configure zaptel module
   #> ztcfg
         - configures Zaptel kernel modules from /etc/zaptel.conf        
   ---
4. Start Asterisk
   #> safe_asterisk