WELCOME [ Log In · Register ]        SITE [ Search · Page Index · Recent Changes ]    RSS

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

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.