Elastix Installation

All RPMs compiled for Elastix are dependent on the Kernel Version, the dahdi/zaptel version and the asterisk version that come with default Elastix.  If you change any of these versions you must Install Wanpipe from Source

1.  Wanpipe installation through RPMs  
   
   1. List of RPMs
   2. Choosing the correct RPM
   3. Download & Installation
   4. Configuring the Sangoma Card
   5. Operation
      
2. Wanpipe installation from Source  (when an RPM is not available)
   1. Requirements
   2. Dahdi/Zaptel Download and Compile
   3. DEPRECATED: Asterisk Download and Compile
   4. Wanpipe Driver Download and Install
   5. Configuration of Sangoma Cards
   6. Operation
      
      

WANPIPE INSTALLATION THROUGH RPMS

The following list contains the Wanpipe Driver RPMS for the stock versions of Elastix, that support ALL Sangoma PRI,BRI, Analog cards .  They are dependent on the specific Dahdi/Zaptel, Asterisk and Kernel versions:

Note: Elastix 1.0 Stable comes with Wanpipe-driver pre-installed with ISO. There is no need to install RPMS

PRI/Analog Elastix RPMS:

BRI RPMS (A500):

How to find Kernel, Asterisk, Dahdi Version in Order to Download the correct RPM

1) To find out the kernel version perform the command:
        type:  uname -r
               ex. 2.6.18-164.11.1.el5

2) To find out your asterisk version
        type:  asterisk -V
               ex.  Asterisk 1.6.0.22

3) To find out your dahdi/zaptel version
       For Dahdi
       type:  rpm -qa|grep dahdi
           DAHDI Tools Version - 2.2.0
           DAHDI Version: 2.2.0
       For Zaptel
       type:  rpm -qa|grep zaptel
           Zaptel Version: 1.4.12.9.svn.r4590-Xorcom-trunk-r7049

To download

* You must download BOTH the corresponding Utility and Module RPM for the Trixbox Version

 -> Copy the URL for each Utility and Module RPM, then run "wget URL" in the linux command line.

         ex. wget <wanpipe module URL>
               wget <wanpipe utility URL>

 For Elastix 1.1- Use --force option to install RPMS; because ISO comes with Old RPMs and wanpipe-util cannot be removed due to dependency
#>rpm -i --force wanpipe-modules-<version>.rpm
#>rpm -i --force wanpipe-util-<version>.rpm

                    
To install

-> run the "rpm -i" command with each of the downloaded Utility and Module RPM:
         ex. rpm -i <wanpipe modules rpm>  
                rpm -i <wanpipe utility rpm>

To verify that driver has been installed run the command:
        #> wanrouter hwprobe verbose

The output should show something similar to the one below (different output for different cards)
-----------------------------------------
| Wanpipe Hardware Probe Info (verbose) |
-----------------------------------------
1 . AFT-A200-SH : SLOT=4 : BUS=5 : IRQ=169 : CPU=A : PORT=PRI : HWEC=32 : V=12
+01:FXO: PCIe: PLX1
+02:FXO: PCIe: PLX1
+03:FXS: PCIe: PLX1
+04:FXS: PCIe: PLX1

If you have any issues with the above command, please contact techdesk@sangoma.com

---

Configuring the Sangoma Card

1. Run the configuration script:-> type: setup-sangoma
   
       The above script creates configuration files for:
        -> Dahdi/Zaptel
        -> Wanpipe in /etc/wanpipe
   
   *Note: BRI is now integrated into Dahdi (Wanpipe 3.5.21 and newer)
         *** If you upgrade to Wanpipe 3.5.21 and UP and want to continue to
            use the deprecated BRI smg daemon, you must now run:
             "setup-sangoma smg"
       
   
   -> Proceed to the Operation section

SOURCE INSTALLATION

 You must install the Wanpipe driver from source if your Elastix system does not have the correct RPM requirements (kernel, dahdi, asterisk versions) as listed above.  The instructions below describe how to install the Wanpipe driver from source, which entail:

-> Downloading the source for dahdi/zaptel currently installed on your system
-> compiling the source Wanpipe driver against the dahdi/zaptel sources


Requirements
Please run the follow commands to install the required packages needed for compiling wanpipe drivers from source:

• yum -y install kernel-devel-$(uname -r) libtool* gcc patch perl bison gcc-c++ ncurses-devel flex libtermcap-devel autoconf* automake*

---

Dahdi Download and Compile

1. Retrieve the version of dahdi currently installed on your system
   Type the following command on your Linux CLI:
   -
   -> rpm -qa | grep dahdi
   -
   The following is an example output of the above command (the output on your system might display varying results):
   -
   dahdi-2.3.0.1-3
   dahdi-modules-2.3.0.1-3_2.6.18_128.1.10.el5
   -
   The dahdi version is 2.3.0.1 in the above example, it is not 2.3.0.1-3 because the "-3" is an Elastix version and we are just concerned about the dahdi version.- 
   - 
2. Download the sources for the dahdi version found on your system
   -> Go to the following website and search for the source RPM of your dahdi version:
   -> http://repo.elastix.org/elastix/
   ->  Search for 'SRPMS', the location where the sources for your elastix version exist
   
   -> Our search results using the above example would find dahdi-2.3.0.1-3.src.rpm
   
   -> Download the appropriate rpm in /usr/src/
   -> Ex: wget http://repo.elastix.org/elastix/index.php?dir=2.0/updates/SRPMS/&file=dahdi-2.3.0.1-3.src.rpm  *NOTE: the dahdi version will vary
   - 
3.  Create the proper directories for the RPM to install to
   -> cd /usr/src/
   -> mkdir redhat
   -> cd redhat
   -> mkdir SOURCES
   -
   * If you try to install the source RPM without creating the above locations, the rpm will fail to install
   - 
4. Install the dahdi source RPM
   -> cd /usr/src/
   -> rpm -i <dahdi source.src.rpm>
   -
5. Build the dahdi sources
   -> cd /usr/src/redhat/SPECS
   -> rpmbuild -bb dahdi.spec
   -> The dahdi sources are now located in /usr/src/redhat/BUILD
   
   *Note: you must have rpmbuild package in order to perform this step.  To obtain it, type: yum install rpm-build
   - 
6. Compile and install the dahdi sources
   -> cd /usr/src/redhat/BUILD/<dahdi-version>
   -> make
   -> make install
   -> make config

Asterisk Download and Compile
DEPRECATED
*Note: This step is only required when using BRI Cards (A500/B700) with Wanpipe Driver 3.5.20 and below
BRI is now integrated into Dahdi in Wanpipe 3.5.21 and above (this step not required)

 1. Find the version of Asterisk Currently installed:
       #> asterisk -V

2. Go to http://downloads.asterisk.org/pub/telephony/asterisk/releases/ and search for your Asterisk version. If you have Asterisk 1.4.22 then the URL will be http://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-1.4.22.tar.gz

3. Once you have the URL run the commands:
          #> cd /usr/src/
                 and then
          #> wget X with X being the URL
    Once the download is complete run the command "
          #>tar xfz asterisk-<version>.tar.gz
                and then
          #> cd asterisk-<version>

4. Once you are in the Asterisk source run the command
          #> ./configure; make
    this will configure and build the source.

Wanpipe Driver Download and Install

1. Download the lastest Wanpipe Driver: Wanpipe Driver
2. Untar wanpipe release in arbitrary directory (/usr/src/ is recommended).
   #> tar xvfz wanpipe-<version>.tgz
   #> cd wanpipe-<version>
   
   Verify asterisk and zaptel/dahdi are shutdown by using the commands:
   #> asterisk -rx "stop now"
   #> service dahdi stop
   ------------
   
3. Install the Wanpipe Driver:
       #>./Setup install  
   Proceed with installation Select "Y" for each option.f
   
   Setup will ask you which compilation method you would like to choose to install the driver:
   - For all PRI/BRI/ANALOG cards, choose Option 2
   
                  Setup will try to auto-detect dahdi sources in /usr/src directory
                  [By default Setup will look in /usr/src]  
   
   *Note:  if you are running a production environment with BRI and Wanpipe using the deprecated
   smg daemon and wish to continue using it, you must choose Option 6/7
   ---
4. Proceed with Defaults for the rest of the compilation.   
   --
5. Last step in installation will ask you to configure the Sangoma card(s) for Dahdi/Zaptel/
   If any errors are encountered during the compilation of the utilities, click here for assistance.

Confirm Successful Wanpipe/Dahdi Installation
 #> wanrouter hwprobe
This command will load the wanpipe and Dahdi modules and will print out list of all Sangoma hardware installed on the system.

---

Configure Sangoma Cards

1. Run the configuration script:
   -> type: setup-sangoma
   
   The above script creates configuration files for:
   -> Dahdi/Zaptel
   -> Wanpipe in /etc/wanpipe
   
    *Note: BRI is now integrated into Dahdi (Wanpipe 3.5.21 and newer)
         *** If you upgrade to Wanpipe 3.5.21 and UP and want to continue to
            use the deprecated BRI smg daemon, you must now run:
             "setup-sangoma smg"
   

Operation

To Start Wanpipe, Dahdi/zaptel and Asterisk, follow the steps below:

1. start Wanpipe Ports
   -> wanrouter start
          - Check /var/log/messages for info or errors
   ---
2. Configure DAHDI/ZAPTEL module
   -> dahdi_cfg -vvv  (dahdi)
   or
   -> ztcfg -vvv  (zaptel)
   
   *Note: this step is taken care of if you have chosen to perform dahdi_cfg automatically
             during 'setup-sangoma' 
         ---
3.  start Asterisk
   -> amportal start
   -> asterisk -r
   
   
   To stop the Wanpipe driver at any time, you must stop Asterisk first:
   1-> amportal stop
   2-> wanrouter stop
   
   If using DEPRECATED BRI smg Installation you will need to add a "custom" trunk to dial out. If you go to http://wiki.sangoma.com/WoomeraFreepbx this details how to do this with Freepbx which is essentially the same as Elastix.