Wanpipe / Zaptel / Asterisk

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

Requirements

For most distributions such as : CentOS, Fedora, RedHat, SuSE, Debian .... default packages are enough.  Therefore, there is no need for downloading any extra packages.

For detailed information of package requirements click here.

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 Wanpipe Driver --> wanpipe-3.4.4.tgz
   --
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
            #>./Setup zaptel --64bit_4GB 
                (in case X86_64bit & 4GB memory or more)
    
   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 

Requirements

Wanpipe requires a list of packages on your system prior to installed. The Setup script will check for those packages prior to installation.
Confirm that you have all the packages installed:


Wanpipe Driver Minimum Requirements

C developement tools ...(gcc)
C++ developement tools
Make utility
Ncurses library
Perl developement tools
AWK
FLEX
Patch
libtermcap-devel
bison

Note: The following assumes your linux distribution uses "yum" or "apt" package managers, adjust to your distros package manager (for example Suse uses "yast").

Mandatory packages - required for wanpipe drivers/modules:

1. Kernel headers (or source) in /lib/modules/$(uname -r)/build
   use "yum install kernel-devel" or apt-get kernel-devel" to install.
2. C Development tools (gcc )
   use "yum install gcc" or "apt-get install gcc" to install.
3. Bash v2
4. AWK
5. Patch
   use "yum install patch" or "apt-get install patch" to install.
6. Perl Development tools.
   use "yum install perl" or "apt-get install perl" to install.
7. Bison
   use "yum install bison".

Optional packages - required if you want to install Wanpipe utilities:
Note: Wanpipe utilities are required to create configuration files for Sangoma cards.

1.  C++ Development tools
   use "yum install gcc-c++" or "apt-get install gcc-c++" to install.
2. ncurses & ncurses-devel library
   use "yum install ncurses" or "apt-get install ncurses" to install.
   use "yum install ncurses-devel"  or  "apt-get install ncurses-devel" to install
3. flex package
   use "yum install flex" or "apt-get install flex" to install.
4. libtermcap-devel
   use "yum install libtermcap-devel" or "apt-get install libtermcap-devel" to install.