Free Whitepapers

General Installation

     Please follow the steps below to install your Sangoma PRI/BRI/GSM/Analog Hardware


    Requirements

    You must prepare your server with the following software requirements before continuing. 

    Simply Copy&Paste the string of command in the application table below, based on your Linux distribution

    Redhat Distributions YUM Packages (i.e. Centos, Trixbox/Elastix source (.tgz) install )
    yum -y install kernel-devel-$(uname -r) libtool* make gcc patch perl bison gcc-c++ ncurses-devel flex libtermcap-devel autoconf* automake* autoconf


    * For W400 GSM, include "yum -y install libxml2-devel cmake"  
    * For Legacy SMG(BRI), include "yum -y install lksctp-tools-devel"

    Ubuntu/Debian 6 Distributions Apt-get Packages
    apt-get -y install gcc g++ automake autoconf libtool make libncurses5-dev flex bison patch libtool autoconf 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.


    Downloading Asterisk/Dahdi/LibPRI

    1. Download the required software
      Software Source Download Source (tgz)
      Asterisk 1.8-current
      Dahdi dahdi-linux-complete-current
      Libpri
      (for PRI/BRI only)      		 1.4-current
      Software found at  http://www.asterisk.org/downloads

      Change directory to /usr/src:
      cd /usr/src

      Copy&paste each line of the following in your command line to automatically download sources (tgz)
      wget http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-complete-current.tar.gz
      wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.4-current.tar.gz
      wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-1.8-current.tar.gz

      You will now have Asterisk/Dahdi/Libpri sources downloaded in /usr/src/


    Installing Asterisk/Dahdi/Libpri


    1. Dahdi Installation

      Untar Dahdi sources previously downloaded in /usr/src/ and install

      tar xvzf dahdi-linux-complete<version>
      cd dahdi-linux-complete <version>
      make
      make install

       

    2. LibPRI Installation (required for PRI/BRI only)

      Untar libPRI sources previously downloaded in /usr/src/ and install
      tar xvfz libpri-<version>
      cd libpri-<version>
      make
      make install
    3. Asterisk Installation

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

      Untar asterisk sources previously downloaded in /usr/src/ and install

      tar xvfz asterisk-<version>.tgz
      cd asterisk-<version>
      ./configure
      make
      make install
      make samples (in case of very first install


      Once Asterisk, Dahdi, LibPRI are installed on your system, please proceed to install the Sangoma Driver (Wanpipe)


    Sangoma Driver Installation

    1. Download the latest release official Sangoma Driver (Wanpipe)
      Sangoma Driver Download Page
       
      ---
    2. Untar wanpipe release in /usr/src

      tar xvfz wanpipe-<version>.tgz
      cd wanpipe-<version>

      ---
    3. Run ./Setup dahdi  from the newly created wanpipe-<version> directory to build and install 
         
      ./Setup dahdi     

       
      ****For power users only:
            make dahdi DAHDI_DIR=<absolute path of dahdi>
            make install

       
      Proceed with installation Select "Y" for each option.

      Setup will try to auto-detect dahdi sources in /usr/src directory ?
      [By default Setup will look in /usr/src]  
       
      ---
    4. Proceed with Defaults for the rest of the compilation.   
      --
    5. Last step in installation will ask you to configure wanpipe cards for Dahdi

      -> Proceed with YES this is your initial installation
      -> Note wancfg_dahdi configurator will overwrite your
           system.conf and chan_dahdi.conf files and
           save the originals as system.conf.bak and chan_dahdi.conf.bak
    6. Confirm Successful Sangoma Driver Installation

      Type the following in your commandline:
      wanrouter hwprobe

      The above should output information describing your Hardware and ports

      If the above command fails, please consult the Sangoma Driver debugging page

     

    Configuration

    1. Configure your Asterisk System with the following:

      Note -> this step was offered at the end of the ./Setup dahdi, if you already configured the card skip this step and proceed to the next step

      wancfg_dahdi
      ---
      Creates Dahdi configuration files
      Creates wanpipe configuration files in /etc/wanpipe
      Creates dahdi config file in /etc/dahdi/system.conf  
      Creates Asterisk dahdi config file in /etc/asterisk/chan_dahdi.conf

    Operation

    1. Start the Sangoma Driver (Wanpipe Ports)
      wanrouter start
      - starts all ports
      - check /var/log/messages for any errors

      ---
    2. Configure DAHDI module

      Note: the option to have this step performed automatically was offered at the end of ./Setup dahdi.
               If you selected YES, then you can skip this step as it will perform automatically after "wanrouter start"
      dahd_cfg

      Configures DAHDI kernel modules from /etc/dahdi/system.conf ( Previously - ztcfg )         
      ---
    3. Start Asterisk
      asterisk
    4. Access the Asterisk CLI and fun some basic commands to verify your Asterisk suite is ready for production

      CLI> asterisk -rv

      Type the following CLI command to verify all your channels (dahdi channels) are loaded into asterisk:
      CLI> dahdi show channels

      If you receive an error or no output from the above command, verify chan_dahdi loaded into asterisk
      CLI> module load chan_dahdi.so

      If the above returns an error message check /var/log/asterisk messages ( or /var/log/asterisk/full) for the reason why

      Run the following command to verify if your PRI or BRI spans are UP and Active:

      CLI> pri show spans