Differences

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

--- vxi_installation_guide:quickstart:start [2014/02/12 23:00] – created ivan
+++ vxi_installation_guide:quickstart:start [2014/02/16 19:33] – [Install Dahdi (only for TDM boards)] ivan
@@ Line 1: / Line 1: @@
-====== QuickStart ======
+====== Quickstart ======
+[[:vxi_installation_guide:start|Home]] >
 ===== Installation =====
-[Enter content here]
+==== Install Asterisk ====
+We provide a free and compiled Asterisk installation package.  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>
+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 (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 Video Package ====
+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.
+<code>
+# tar xvzf video_VX-X_date.tar.gz
+</code>
+<code>
+# cd video_VX-X_date
+# ./install.sh
+</code>
+==== Install Vxi Package ====
+Use root to install Vxi VoiceXML browser for Asterik.
+Unzip and untar the openvxi package by using the command:
+<code>
+# tar xvzf vxml_VX.X_date.tar.gz
+</code>
+Go to the directory of the openvxi and type the following command.
+<code>
+# cd vxml_VX.X_date
+# ./install.sh
+</code>
 ===== 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:
+<code>
+# /etc/init.d/dahdi start
+</code>
+To stop the dahdi driver:
+<code>
+# /etc/init.d/dahdi stop
+</code>
+==== Start Vxi 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.
+<code>
+# /etc/init.d/openvxi start
+</code>
+To stop the VXI* deamon:
+<code>
+# /etc/init.d/openvxi stop
+</code>
+NOTE:
+This startup script runs only for Debian/Ubuntu Linux distributions, please modify or install a correct this script file to launch correctly Vxi from other Linux systems. We provide a script to start the actual, AsteriskNOW linux distribution from Digium.
+==== 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)
+<code>
+#safe_asterisk
+</code>
+Stop asterisk:
+<code>
+#killall -9 safe_asterisk && asterisk -x 'core stop gracefully'
+</code>
+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.