Free Whitepapers

Wanpipe on Trixbox 1.2.3 and Trixbox 2.x.x


    The Wanpipe TrixBox RPM page has moved to HERE

     
      
      
     
     
    Old Docs not to be used. Please follow the link above!

     

    Wanpipe Trixbox RPMs are built for original kernel and Zaptel modules that comes with  Default Trixbox.

    Wanpipe modules are dependent on kernel modules and Zaptel modules!
    If you recompiled a newer kernel or Zaptel, you will need to compile Wanpipe drivers manually! 

     

    1. Installing Wanpipe RPMs On Trixbox
    2. Updating Wanpipe Driver 
    3. Installing wanpipe driver and zaptel from the source (in some cases)
    4. Trixbox ISO (with sangoma drivers already loaded) 

       

     

    Installing Wanpipe RPMs on Trixbox

    For manual RPM installation: 

    I. Installation 

    To install wanpipe on Trixbox you need to perform the following steps:

    1. Download Wanpipe RPMS

    • Check your TrixBox Kernel Image (SMP or Non SMP)

      #> uname -a
      eg: Linux tesla 2.6.18-8.el5 #1 SMP Thu Mar 15 19:57:35 EDT 2007 i686 i686 i386 GNU/Linux
       
      Check if image that you are running is SMP or Non SMP as the uname -a command indicates above.
       

    2. Install the Wanpipe rpms:

    • #>rpm -i wanpipe-modules-<version>.rpm
    • #>rpm -i wanpipe-util-<version>.rpm
       

    II. Configuration

    1. For all Sangoma AFT cards run:

      #>setup-sangoma

      The setup-sangoma script will automatically configure all AFT cards on your system.
      Please follow setup-sangoma prompts and configure your cards based on Telco Line information.
      (Eg: T1/E1, Clock MASTER/NORMAL)


    III. Operation

    1. To manually start wanpipe devices, zaptel and asterisk run:
      #> wanrouter start
      #> ztcfg                  
      #> asterisk
       
    2. To manually stop wanpipe you must stop asterisk first
      #> asterisk (stop now)
      #> wanrouter stop

     

     

     

    2. Upgrade of the driver

     
    1. Remove the previous driver: 

          #>uname -r                        
                     --- find out the kernel version of your Trixbox(e.g  2.6.9-34.0.2.ELsmp)

          #>wanrouter version     
                     --- find out the current wanpipe driver version(e.g  wanpipe-2.3.4-7)

           #>rpm -qa | grep wanpipe

          #>rpm -e wanpipe-modules-2.6.9-34.0.2.ELsmp-2.3.4-7          
                     --- remove the old wanpipe kernel driver modules

          #>rpm -e wanpipe-util-2.3.4-7"                                                
                     --- remove the old wanpipe utility


    2. Download the new rpm from Sangoma FTP site:
        ftp://ftp.sangoma.com/linux/RPMS/


    3. Install the new driver by running the following commands:

  • #>rpm -i wanpipe-modules-<version>.rpm
  • #>rpm -i wanpipe-util-<version>.rpm

      

    • 3. Installation of Wanpipe driver from source code

    1. #>amportal stop
       
    2. #>service zaptel stop
       
    3. #>wanrouter stop
       
    4. Find wanpipe RPM and remove wanpipe RPMS
       
    5. #>rpm -qa | grep wanpipe

           #>rpm -e wanpipe-modules-<version>

    5.    #>rpm -e wanpipe-util-<version>

    6.    #>yum install kernel-devel
                       or
            #>yum install kernel-smp-devel (for smp kernel)

    7.    #>yum install byacc

    8  #>vi /lib/modules/$(uname -r)/build/include/linux/spinlock.h
    look for this line: 

    #define DEFINE_RWLOCK(x) rw_lock_t x = RW__LOCK_UNLOCK

    (it is around line 407)
    and change it to: 

    #define DEFINE_RWLOCK(x) rwlock_t x = RW__LOCK_UNLOCK

    10. Download zaptel into arbitrary directory (/usr/src) and  untar it.

    #>tar xvfz zaptel(version)
              Make a symbolic link /usr/src/zaptel to the actual zaptel directory.
              #>ln -s zaptel(version) zaptel
              #>make
              #>make install

     11. Install Wanpipe driver from source       

    Wanpipe TDM Installation

    1. Download the appropriate WANPIPE® Release based on the Sangoma Hardware. Refer to Wanpipe Drivers section.
    2. Untar wanpipe release in arbitrary directory (/usr/src/) and hwec-utils is you have a hardware echo canceller.
      #>tar xvfz wanpipe(version)
      After untarring WANPIPE®, the wanpipe/ directory will be created.
    3. Run ./Setup install

      Proceed with installation Select "Y" for each option.

      Under compilation mode:  Select "TDM Only drivers" (Option #2).

      Setup will ask you for location of zaptel sources?
      [By default Setup will look in /usr/src/zaptel]

      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

      Proceed to compile wanpipe drivers.
    4. Proceed with Defaults for the rest of the compilation.
              If any errors are encountered during the compilation of the utilities, click here for assistance.

    12.  At the end of driver installatio, wancfg_zaptel utility will automatically generate configuration files for you 




    Appendix

    For other additional information, view the Wanpipe-Asterisk Appendix

    Sample Configuration files:
    1 Incoming T1 ISDN PRI line and 1 T1 connecting to a channel bank with 24 fxs channels

    Your zaptel.conf

     

     #incoming PRI
    span = 1,1,0,esf,b8zs
    bchan = 1-23
    dchan = 24

    #outgoing T1 to channel bank
    span = 2,0,0,esf,b8zs
    fxoks = 25-47

     

    Your zapata-auto.conf

     

    #incoming pri
    signalling = pri_cpe
    context=from-zaptel
    group=0
    channels=>1-23

    #outgoing T1 to channel bank
    signalling = fxo_ks
    context=from-internal
    group=1
    channels=> 25-48

     

    2 Incoming E1 EuroISDN lines from a Telco

    Your zaptel.conf

     

     #first incoming PRI
    span = 1,1,0,ccs,hdb3,crc4
    bchan = 1-23
    dchan = 24

    #second incoming PRI
    span = 2,2,0,ccs,hdb3,crc4
    bchan = 1-15,17-31
    dchan = 16

     

    Your zapata-auto.conf

    signalling = pri_cpe
    group = 0
    context = from-zaptel
    channels=> 1-15,17-31

    signalling = pri_cpe
    group = 0
    context = from-zaptel
    channels=> 32-46,48-72



    Trixbox ISO with Sangoma Wanpipe Drivers Installed

    1. Trixbox  ISO 2.0 with Stable Wanpipe Voice Drivers    ..............  wanpipe-2.3.4-4.iso
    2. Trixbox ISO 2.2  with Stable Wanpipe Voice Drivers    ..............  wanpipe-2.3.4-9.iso