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)

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

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

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).

 

After untarring WANPIPE®, the wanpipe<version>/ directory will be created.
---

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 
  ---

1. Proceed with Defaults for the rest of the compilation.  
   ---
2. 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 

 

---