Differences

This shows you the differences between two versions of the page.

--- vxi_installation_guide:quickstart:start [2014/02/16 19:25] – ivan
+++ vxi_installation_guide:quickstart:start [2015/02/06 21:15] – borja
@@ Line 5: / Line 5: @@
 ===== Installation =====
-[Enter content here]
+==== Install Asterisk ====
+We provide a free and compiled Asterisk installation package.
+Note:
+You can choose to install a standard Asterik package from any distribution.
+We support full integrated solutions like FreePBX, Elastix, AsteriskNow, IncrediblePBX too.
+The install package contains a minimal amount of default configuration files to get started, and provides an efficient way to get your Asterisk system up and running.
+First, unzip/untar the Asterisk package by using the command:
+<code>
+# tar xvzf asterisk_Vx.x.x_date.tar.gz
+</code>
+Next, go to the directory of the Asterisk package generated and type the following command:
+<code>
+host:~# cd asterisk_Vx.x.x_date
+host:~/asterisk_Vx.x.x_date# ./install.sh
+--- 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:~/asterisk_Vx.x.x_date#
+</code>
+==== Install Dahdi (optional) ====
+If you don't use a TDM board, please skip this section.
+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, install the packages : linux-headers-`uname -r`, make, gcc.
+Example:
+<code>
+apt-get install linux-headers-`uname -r`
+</code>
+(Packages to be able to compile : binutils, make, gcc)
+This Dahdi packages associated to the i6net Asterisk package or in the Asterisk installation directory.   \\ You can download the latest Dadhi sources files (from __[[http://www.asterisk.org/|www.asterisk.org]]__</font> ) (take care with the compatibility with the Asterisk binaries build by i6net):
+    * dahdi-linux-x.x.x.x.tar.gz
+    * dahdi-tools-x.x.x.x.tar.gz
+Install the Dahdi driver:
+<code>
+# tar xvfz dahdi-linux-x.x.x.x.tar.gz
+# cd dahdi-linux-x.x.x.x
+# make
+# make install
+</code>
+Results:
+<code>
+[…]
+###################################################
+###
+### DAHDI installed successfully.
+### If you have not done so before, install the package
+### dahdi-tools.
+###
+###################################################
+</code>
+Install the Dahdi tools:
+<code>
+# tar xvfz dahdi-tools-x.x.x.x.tar.gz
+# cd dahdi-tools-x.x.x.x
+# ./configure
+# make
+# make install
+# make config
+</code>
+Results:
+<code>
+[…]
+DAHDI has been configured.
+</code>
+If you have any Dadhi hardware it is now recommended you edit /etc/dahdi/modules in order to load support for only the Dadhi hardware installed in this system. By default, support for all Dadhi hardware is loaded at Dadhi start.
+<code>
+I think that the DAHDI hardware you have on your system is:
+pci:0000:0b:08.0 wct4xxp- d161:0220 Wildcard TE220 (4th Gen)
+</code>
+Configure the Dahdi driver:
+Configuration files are not stored in /etc/dahdi:
+<code>
+# cd /etc/dahdi
+# ls
+init.conf modules system.conf
+</code>
+Example of system.conf (dual E1 board):
+<code>
+#
+# Dahdi Configuration File
+#
+span=1,1,0,ccs,hdb3,crc4
+bchan=1-15
+dchan=16
+bchan=17-31
+span=2,1,0,ccs,hdb3,crc4
+bchan=32-46
+dchan=47
+bchan=48-62
+#span=3,1,0,ccs,hdb3,crc4
+#bchan=63-77
+#dchan=78
+#bchan=79-93
+#span=4,1,0,ccs,hdb3,crc4
+#bchan=94-108
+#dchan=109
+#bchan=110-124
+loadzone=es
+defaultzone=es
+</code>
+You can disable the unused modules by editing the /etc/dahdi/modules and removing or commenting them.
+Example of modules (dual E1/T1 board wct4xxp):
+<code>
+#
+# Dahdi modules
+#
+wct4xxp
+</code>
+Start / Stop Dahdi driver:
+The Dahdi tools install a startup script, /etc/init.d/dahdi. You may also use this script to control Dahdi from the Linux command line:
+<code>
+# /etc/init.d/dahdi start
+# /etc/init.d/dahdi restart
+# /etc/init.d/dahdi stop
+</code>
+NOTE:
+Remember that, the Dahdi module loading is disabled in the I6NET packaged Asterisk version. Disable the noload in the /etc/asterisk/modules.conf.
+==== Install VoiceXML browser ====
+Use root to install Vxi*, the VoiceXML browser for Asterik.
+Unzip and untar the VoiceXML package by using the command:
+<code>
+# tar xvzf vxml_VX.X_date.tar.gz
+</code>
+Go to the directory of the vxml package and type the following command.
+<code>
+# cd vxml_VX.X_date
+# ./install.sh
+</code>
+If detected, the package will install the FreePBX and Elastix modules.
+You will need to finish the VoiceXML FreePBX module manually.
+- Enable unsigned application to avoid the message warning (for recent FreePBX versions).
+- Install the local module form the 'Admin modules'.
 ===== Setup =====
@@ Line 14: / Line 198: @@
   * Start Dahdi (optional)
-  * Start VXI
+  * Start VoiceXML browser
   * Start Asterisk
@@ Line 20: / Line 204: @@
   * Stop Asterisk
-  * Stop VXI
+  * Stop VoiceXML browser
   * Stop Dahdi (optional)
@@ Line 37: / Line 221: @@
 </code>
-==== Start Vxi deamon ====
+==== Start VoiceXML browser deamon ====
-The VoiceXML browser software is installed in /usr/sbin and /usr/lib/openvxi. The VoiceXML browser setup script on Linux is /etc/init.d/openvxi. The openvxi script calls the /usr/sbin/safe_openvxi executable that functions as a monitor and auto-loader for your VoiceXML browser system. This safe_openvxi starts VoiceXML browser and monitors it to make sure it is still running. If the VoiceXML browser process dies, the script will attempt to restart it.
+The VoiceXML browser software is installed in /usr/sbin and /usr/lib/vxml. The VoiceXML browser setup script on Linux is /etc/vxmld.conf (older verions: /etc/init.d/openvxi). The vxml script calls the /usr/sbin/vxmld executable that is the VoiceXML browser engine. If the VoiceXML browser process dies, the Asterisk module can be configured to detect it and force the VoiceXML browser and the Asterisk to restart using the safe_asterisk script.
 <code>
-# /etc/init.d/openvxi start
+# /etc/init.d/vxml start
 </code>
-To stop the VXI* deamon:
+To stop the VoiceXML deamon:
 <code>
-# /etc/init.d/openvxi stop
+# /etc/init.d/vxml stop
 </code>
@@ Line 58: / Line 242: @@
 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.
+It is better to modify the safe_asterisk script to restart the VoiceXML browser when the safe_asterisk script restart the Asterisk.
+Edit the script and add :
+<code>
+#NOTIFY=ben@alkaloid.net         # Who to notify about crashes
+EXEC="/etc/init.d/vxml restart"  # Run this command if Asterisk crashes
+#LOGFILE=/path/to/logfile        # Where to place the normal logfile (disabled if blank)
+</code>
 Start asterisk: (just call the wrapper)