Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision Next revisionBoth sides next revision | ||
vxi_installation_guide:quickstart:start [2014/02/12 23:00] – created ivan | vxi_installation_guide:quickstart:start [2014/02/16 19:29] – [Install Video (only for Video IVR)] ivan | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
+ | |||
+ | [[: | ||
===== Installation ===== | ===== Installation ===== | ||
- | [Enter content here] | + | ==== Install Asterisk ==== |
+ | We provide a free and compiled Asterisk installation package. | ||
+ | |||
+ | First, unzip/untar the Asterisk package by using the command: | ||
+ | |||
+ | < | ||
+ | # tar xvzf asterisk_Vx.x.x_date.tar.gz | ||
+ | </ | ||
+ | |||
+ | Next, go to the directory of the Asterisk package generated and type the following command: | ||
+ | |||
+ | < | ||
+ | host:~# cd asterisk_Vx.x.x_date | ||
+ | host: | ||
+ | --- Asterisk IP/PABX Vx-x-x Installation --- | ||
+ | Creating directories... | ||
+ | Installing asterisk binary... | ||
+ | Installing configuration files... | ||
+ | Installing sounds... | ||
+ | Installing modules... | ||
+ | --- Asterisk IP/PABX Vx-x-x installation has finished --- | ||
+ | host: | ||
+ | </ | ||
+ | |||
+ | NOTE: | ||
+ | |||
+ | If your Asterisk is already installed or you are installing from sources please check your are using: | ||
+ | |||
+ | * Asterisk 1.2 Vxi 1.4 packages (discontinued) | ||
+ | * Asterisk 1.4 Vxi 3.X, 4.X, 5.X, 6.X packages | ||
+ | * Asterisk 1.6 Vxi 3.X, 4.X, 5.X, 6.X, 7.X, 8.X packages | ||
+ | * Asterisk 1.8 Vxi 6.X, 7.X, 8.X packages (stable) | ||
+ | |||
+ | ==== Install Dahdi (only for TDM boards) ==== | ||
+ | |||
+ | The last Asterisk releases now support Dadhi driver. | ||
+ | |||
+ | If your system use a TDM card, you must install first Dadhi drivers to manage T1/E1 interface. The Dadhi drivers and tools should be compiled in the server. You need to install a building environment (compiler, binutils and kernel headers). For the Debian distribution, | ||
+ | |||
+ | Example: | ||
+ | |||
+ | < | ||
+ | apt-get install linux-headers-`uname -r` | ||
+ | </ | ||
+ | |||
+ | (Packages to be able to compile : binutils, make, gcc) | ||
+ | |||
+ | This Dahdi packages associated to the i6net Asterisk package or in the Asterisk installation directory. | ||
+ | |||
+ | * dahdi-linux-x.x.x.x.tar.gz | ||
+ | * dahdi-tools-x.x.x.x.tar.gz | ||
+ | |||
+ | Install the Dahdi driver: | ||
+ | |||
+ | < | ||
+ | # tar xvfz dahdi-linux-x.x.x.x.tar.gz | ||
+ | # cd dahdi-linux-x.x.x.x | ||
+ | # make | ||
+ | # make install | ||
+ | </ | ||
+ | |||
+ | Results: | ||
+ | |||
+ | < | ||
+ | […] | ||
+ | |||
+ | ################################################### | ||
+ | ### | ||
+ | ### DAHDI installed successfully. | ||
+ | ### If you have not done so before, install the package | ||
+ | ### dahdi-tools. | ||
+ | ### | ||
+ | ################################################### | ||
+ | </ | ||
+ | |||
+ | Install the Dahdi tools: | ||
+ | |||
+ | < | ||
+ | # tar xvfz dahdi-tools-x.x.x.x.tar.gz | ||
+ | # cd dahdi-tools-x.x.x.x | ||
+ | # ./configure | ||
+ | # make | ||
+ | # make install | ||
+ | # make config | ||
+ | </ | ||
+ | |||
+ | Results: | ||
+ | |||
+ | < | ||
+ | […] | ||
+ | DAHDI has been configured. | ||
+ | </ | ||
+ | |||
+ | If you have any Dadhi hardware it is now recommended you edit / | ||
+ | |||
+ | < | ||
+ | I think that the DAHDI hardware you have on your system is: | ||
+ | pci: | ||
+ | </ | ||
+ | |||
+ | Configure the Dahdi driver: | ||
+ | |||
+ | Configuration files are not stored in /etc/dahdi: | ||
+ | |||
+ | < | ||
+ | # cd /etc/dahdi | ||
+ | # ls | ||
+ | init.conf modules system.conf | ||
+ | </ | ||
+ | |||
+ | Example of system.conf (dual E1 board): | ||
+ | |||
+ | < | ||
+ | # | ||
+ | # Dahdi Configuration File | ||
+ | # | ||
+ | |||
+ | span=1, | ||
+ | bchan=1-15 | ||
+ | dchan=16 | ||
+ | bchan=17-31 | ||
+ | |||
+ | span=2, | ||
+ | bchan=32-46 | ||
+ | dchan=47 | ||
+ | bchan=48-62 | ||
+ | |||
+ | # | ||
+ | # | ||
+ | #dchan=78 | ||
+ | # | ||
+ | |||
+ | # | ||
+ | # | ||
+ | #dchan=109 | ||
+ | # | ||
+ | |||
+ | loadzone=es | ||
+ | defaultzone=es | ||
+ | </ | ||
+ | |||
+ | You can disable the unused modules by editing the / | ||
+ | |||
+ | Example of modules (dual E1/T1 board wct4xxp): | ||
+ | |||
+ | < | ||
+ | # | ||
+ | # Dahdi modules | ||
+ | # | ||
+ | wct4xxp | ||
+ | </ | ||
+ | |||
+ | Start / Stop Dahdi driver: | ||
+ | |||
+ | The Dahdi tools install a startup script, / | ||
+ | |||
+ | < | ||
+ | # / | ||
+ | # / | ||
+ | # / | ||
+ | </ | ||
+ | |||
+ | NOTE: | ||
+ | |||
+ | Remember that, the Dahdi module loading is disabled in the I6NET packaged Asterisk version. Disable the noload in the / | ||
+ | |||
+ | ==== Install Video (only for Video IVR) ==== | ||
+ | |||
+ | To use any video 3G-324m features, your system must have a TDM card. You don't need install this package, if you are going to use your system only for voice services. | ||
+ | |||
+ | < | ||
+ | # tar xvzf video_VX-X_date.tar.gz | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | # cd video_VX-X_date | ||
+ | # ./ | ||
+ | </ | ||
+ | |||
+ | ==== Install Vxi (Mandatory) ==== | ||
+ | |||
+ | Use root to install Vxi VoiceXML browser for Asterik. | ||
+ | |||
+ | Unzip and untar the openvxi package by using the command: | ||
+ | |||
+ | < | ||
+ | # tar xvzf vxml_VX.X_date.tar.gz | ||
+ | </ | ||
+ | |||
+ | Go to the directory of the openvxi and type the following command. | ||
+ | |||
+ | < | ||
+ | # cd vxml_VX.X_date | ||
+ | # ./ | ||
+ | </ | ||
+ | |||
+ | NOTE: | ||
+ | |||
+ | Vxi is now using new libraries and compiler version, before installing the VoiceXML browser please check your Operating Systems has the a GCC3 o GCC4 libraries environment : | ||
+ | |||
+ | < | ||
+ | Vxi 1.4 is build with GCC3.3 / libstdc++5 | ||
+ | Vxi 1.5, 2.X, 3.X, 4.X, 5.X, 6.X are build with GCC4 / libstdc++6 | ||
+ | </ | ||
===== Setup ===== | ===== Setup ===== | ||
- | [Enter content here] | + | Be careful, respect the order for starting and stopping the full VoiceXML modules : |
+ | |||
+ | To start the platform orderly: | ||
+ | |||
+ | * Start Dahdi (optional) | ||
+ | * Start VXI | ||
+ | * Start Asterisk | ||
+ | |||
+ | To stop it, orderly : | ||
+ | |||
+ | * Stop Asterisk | ||
+ | * Stop VXI | ||
+ | * Stop Dahdi (optional) | ||
+ | |||
+ | ==== Start Dahdi deamon ==== | ||
+ | |||
+ | To start the dahdi driver: | ||
+ | |||
+ | < | ||
+ | # / | ||
+ | </ | ||
+ | |||
+ | To stop the dahdi driver: | ||
+ | |||
+ | < | ||
+ | # / | ||
+ | </ | ||
+ | |||
+ | ==== Start Vxi deamon ==== | ||
+ | |||
+ | The VoiceXML browser software is installed in /usr/sbin and / | ||
+ | |||
+ | < | ||
+ | # / | ||
+ | </ | ||
+ | |||
+ | To stop the VXI* deamon: | ||
+ | |||
+ | < | ||
+ | # / | ||
+ | </ | ||
+ | |||
+ | NOTE: | ||
+ | |||
+ | This startup script runs only for Debian/ | ||
+ | |||
+ | ==== Start Asterisk deamon ==== | ||
+ | |||
+ | For production setups, we use safe_asterisk wrapper to catch any asterisks error, avoiding to restart asterisk manualy. This script will start a new asterisk instance when asterisk process is missing. So if you really want to stop asterisk, you must stop safe_asterisk script first. | ||
+ | |||
+ | Start asterisk: (just call the wrapper) | ||
+ | |||
+ | < | ||
+ | # | ||
+ | </ | ||
+ | |||
+ | Stop asterisk: | ||
+ | < | ||
+ | #killall -9 safe_asterisk && asterisk -x 'core stop gracefully' | ||
+ | </ | ||
+ | |||
+ | NOTE: | ||
+ | |||
+ | On production server there can be a CRON command line restarting asterisk automatically each morning, using safe_asterisk is mandatory. Check with “#crontab -l”, if there is any asterisk killall commands related with asterisk. | ||
+ | |||
+ | |||