Complementary Software Guide

The VoiceXML Browser for Asterisk®

COMPLEMENTARY SOFTWARE GUIDE

Version: 5.2 VXI* – VoiceXML Browser

COMPLEMENTARY SOFTWARE GUIDE

Company Name: ______

Address/City/State/Zip: ______

Country: ______

About I6NET

I6NET Solutions and Technologies Limited is a pan-European company specialized in the development of new applications and advanced communication solutions. I6NET creates new business solutions and opportunities with voice interactivity, helping phone and data networks convergence. Its innovative voice browsers systems and software components enable the creation of voice & video services in VoiceXML. You can contact us by email or call us by phone and leave us a message here.

Main/Sales office quarters: C/ Magallanes 13 – 5º Izq 28015 Madrid (Spain) VAT Number ES-B83388306 - See more information: www.i6net.com

1 Purpose ...... 4 2 Complementary Software ...... 4 2.1 WavePad Editor ...... 5 2.2 FF* Video Converter ...... 5 2.3 ImageMagick ...... 6 2.4 CDR Analyser (Stats) ...... 7 2.5 Inkscape Editor ...... 10 2.6 Apple QuickTime Pro ...... 10 2.7 Helix Mobile Producer ...... 11 2.8 Xenon Offline Encoder ...... 11 2.9 MP3player (mpg123) ...... 12 2.10 Zingaya MediaServer ...... 13 2.11 Arno Firewall ...... 15

This guide is intended for application developers who create VoiceXML applications on the Asterisk® platform with the I6NET VoiceXML browser, VXI*. It presents the Complementary Software Tools, you can use for your projects.

2 Complementary Software

I6NET recommends a suite specific software tools for VXI* VoiceXML browser platforms. All these packages are specific complementary products to create or edit contents or to improve your system. Please contact our sales team and tech team for any question.

List of Tools:

• WavePad Editor • FF* Video Converter • ImageMagick • CDR Analyser (Stats) • Inkscape Editor • Apple QuickTime Pro • Helix Mobile Producer • Xenon Offline Encoder • MP3player (mpg123) • Zingaya MediaServer • Arno Firewall

NOTE: Please read the products’ license conditions. Most of them are Open Source Projects and Commercial Products from specific Vendors.

Synopsis WavePad Editor for Windows

Description WavePad audio editing software is a full featured professional sound editor for Microsoft Windows systems. It lets you make and edit voice and other audio recordings. When editing audio files you can cut, copy and paste parts of recordings and, if required, add effects like echo, amplification and noise reduction. WavePad works as a wav editor or mp3 editor but it also supports a number of other file formats including vox, gsm, real audio, au, aif, flac, ogg and more.

More information: http://nch.com.au/wavepad/index.html

2.2 FF* Video Converter

Synopsis FF* Video Converter from I6NET

Description FF* (FFasterisk) is a small tool to generate .h263 files compatible with Asterisk (with Payload RFC…). It is compatible with the Wengo SIP/video phone. The 3G (H324m) gives a more restrictive profile, yet not yet available (FFmpeg have some restrictions).

NOTE: This tools has been discontinued (use the mp4 tools developped by I6NET)

More information: http://products.i6net.com

Synopsis ImageMagick

Description ImageMagick®, is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a large variety of formats. Images can be cropped, colors can be changed, various effects can be applied, images can be rotated and combined, and text, lines, polygons, ellipses and Bézier curves can be added to images and stretched and rotated. ImageMagick is free software delivered with full source code and can be freely used, copied, modified and distributed. Its license is compatible with the GPL. It runs on all major operating systems and supports many image formats (over 95) including formats like GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX.

More information: http://www.imagemagick.org/index.php

Installation I6NET has integrated the ImageMagick tools in a PHP/Apache server to generate static texts. You’ll need to install these packages to enable the function in a web server: imagemagick Generate a gif from text. For Debian, install the packages, imagemagick and gsfonts. ffmpeg Generate a 3gp file. Use this ffmpeg package or compile if yourself (http://ffmpeg.mplayerhq.hu). mpeg4ip Hint the 3gp file. A hint track is a small track embedded alongside the audio and video tracks. The hint tells the server how to “package” media data for the network. Without a hint track, 3GP and MP4 files will not stream from the server. Use this mpeg4ip package or compile it yourself (http://mpeg4ip.sourceforge.net). gsfonts /usr/share/fonts/type1/gsfonts text2video This is the I6NET text-to-video package, php script.

Synopsis CDR Analyser for Asterisk

Description CDR Analyzer is an easy way to analyze your CDR records that are generated from Asterisk to a database. Asterisk-Stat provides different reports and graphs to allow the Asterisk-admin to quickly analyze the traffic on the Asterisk server. All of the graphics and reports are based on the CDR database.

More information: http://areski.net/asterisk-stat-v2/about.php

Main Features: • CDR report (monthly or daily) • Monthly traffic • Daily load • Compare call load with previous day’s • Contains various criteria to define the report (filter by date, etc.) • Export CDR reports to CVS or PDF

System Requirements: • Apache (package apache2 ) • Php (package php5) • Mysql (package mysql-server) • Php module for Mysql (php5-mysql) • Php module for GB (php5-gd)

NOTE: Check the php configuration file with the Debian distribution, /etc/php5/apache2/php.ini. If the auto configuration does not work properly, then add the mysql module.

© 2011 I6NET | www.i6net.com 7 / 15 Complementary Software Guide Installation I6NET provides a package to easy-install your stats module. Download the package from I6NET websites. Unzip and untar the Stats package by using the command: # tar xvzf stats_Vx.x_date.tar.gz

Go to the directory of the 'stats' and then, type the following command. # cd stats_Vx.x_date # ./install.sh

NOTE: User/password can be necessary to automatically generate the database table.

Installation from the sources: Go to: http://areski.net/asterisk-stat-v2/about.php Unzip and untar the content, copy the directory extracted to /var/www/stat for example.

Edit lib/defines.php files and set: define ("FSROOT", "./"); define ("DBNAME", "asterisk");

There is a small bug in the export_pdf.php provided in v2.1 package. To fix it, just correct that line in the export_pdf.php file: include_once(dirname(FILE) . "/lib/fpdf.php'); to include_once(dirname(FILE) . "/lib/fpdf.php");

Configuration Edit the configuration file: ./libs/defines.php

Change the session with your Mysql parameters: define ("HOST", "localhost"); define ("PORT", "5432"); define ("USER", "root"); define ("PASS", ""); define ("DBNAME", "cdr"); define ("DB_TYPE", "mysql"); // mysql or postgres

Create the Database First, execute the Mysql client at CLI: # mysql

Next, add execute to the following script: CREATE DATABASE asterisk;

USE asterisk;

CREATE TABLE `cdr` ( `calldate` datetime NOT NULL default '0000-00-00 00:00:00', `clid` varchar(80) NOT NULL default '', `src` varchar(80) NOT NULL default '', `dst` varchar(80) NOT NULL default '', `dcontext` varchar(80) NOT NULL default '', `channel` varchar(80) NOT NULL default '', `dstchannel` varchar(80) NOT NULL default '', `lastapp` varchar(80) NOT NULL default '', `lastdata` varchar(80) NOT NULL default '', `duration` int(11) NOT NULL default '0', `billsec` int(11) NOT NULL default '0', `disposition` varchar(45) NOT NULL default '', àmaflags` int(11) NOT NULL default '0', àccountcode` varchar(20) NOT NULL default '', ùserfield` varchar(255) NOT NULL default '' ); ALTER TABLE `cdr` ADD INDEX ( `calldate` ); ALTER TABLE `cdr` ADD INDEX ( `dst` ); ALTER TABLE `cdr` ADD INDEX ( àccountcode` );

Configure mySQL CDR Check if the CDR generation is configured the Asterisk configuration file, cdr.cf: ; ; Call Detail Record engine Configuration ;

[general] enable=yes ;batch=no ;size=100 ;time=300 ;scheduleronly=no ;safeshutdown=yes

And cdr_mysql.cfg, then restart Asterisk to reload the new configuration. ; CDR MySQL Configuration ; ;

[global] hostname=localhost dbname=asterisk table=cdr password= user=root ;port=3306 sock=/var/run/mysqld/mysqld.sock userfield=1

Launch your favorite HTML navigator and go to the URL: http://your-ip/stats

Synopsis The Inkscape Editor

Description Inkscape is an Open Source vector graphics editor, with capabilities similar to Illustrator, Freehand, CorelDraw, or Xara X using the W3C standard Scalable Vector Graphics (SVG) file format. Supported SVG features include shapes, paths, text, markers, clones, alpha blending, transforms, gradients, patterns, and grouping. Inkscape also supports Creative Commons meta-data, node editing, layers, complex path operations, bitmap tracing, text-on-path, flowed text, direct XML editing, and more. It imports formats such as JPEG, PNG, TIFF, and others and exports PNG as well as multiple vector-based formats.

More information: http://www.inkscape.org

2.6 Apple QuickTime Pro

Synopsis QuickTime Pro from Apple

Description QuickTime is a multimedia technology developed by Apple Computer, capable of handling various formats of digital video, sound, text, animation, music, and immersive panoramic (and sphere panoramic) images. The QuickTime technology has three major components:

• The QuickTime file format itself — openly documented and available for anyone to use royalty-free. • A media player which Apple makes available for free as a download on its website and bundles with each of its computers. • Software development kits available for the Macintosh and Windows platforms. These kits allow people to develop their own software to manipulate QuickTime and other media files. These are not free.

More information: http://www.apple.com/quicktime/

Synopsis Helix Mobile Producer from Realnetworks

Description Helix Mobile Producer — On-Demand is the content creation component of the Helix Media Delivery System. The Helix Media Delivery System is a comprehensive set of software products designed and optimized for mobile media creation, delivery, and playback. It provides the leading streaming media infrastructure for leading mobile operators around the world. Similar product can be found with the invidia reference.

Here the parameters for the profile 3G-h324m: Audio/Video Streams

• Encode: Audio and Video, VBR, 2-pass • Target Biterate: 50kbps VBR maximum biterate: 50 kbps • Audio Codec: AMR NB • Biterate: 12,2 kbps • Video Codec: H263 • Biterate: 37,8 kbps (Target Audio) Video Codec Level: 10-64kbps Max. keyframe distante: 5000 ms, Framerate: 7 fps, Encoding complexity: Medium, Video mode: Normal Motion Video

More information: http://www.realnetworks.com/industries/mobile/products/producer

2.8 Xenon Offline Encoder

Synopsis Xenon Offline Encoder from Vidiator

Description Xenon Offline Encoder is an affordable encoding tool to create 3GPP files with the highest encoding quality. It supports all the mobile 3GPP codecs such as H.264, H.263, MPEG-4, AAC, HE AAC (v.1 and v.2), and AMR as well as a proper Digital Rights Management (DRM) support for mobile service.

More information: http://www.vidiator.com/xenon/3gp_mobile_encoder_converter.aspx

NOTE: Xenon Offline Encoder is now compatible with Asterisk Video Tools.

Synopsis MP3player for Asterisk

Description Executes the mpg123 unix program to play the given location which typically would either be the filename of an MP3 sound file, or the URL of an MP3 stream. The callers can exit by dialing any digit. It use the mpg123 version 0.59r (http://www.mpg123.de/mpg123/mpg123-0.59r.tar.gz) The mpg123 program seems to work best at playing mp3s which do not have any ID3 tag details embedded in them. (Suppressing stderr output fixes the ID3 problem).

More information: http://www.voip-info.org/wiki/view/Asterisk+cmd+MP3Player

NOTE: app_mp3.c needs this patch to works with VXI*:

Add: ... #include #ifndef i6net #include #endif #ifdef HAVE_CAP ...

Complete: ... close(fds[0]); close(fds[1]);

#ifnef i6net if (pid > -1) { int status, died; ast_log(LOG_DEBUG, "Killing mpg123\n"); kill(pid, SIGKILL); died = wait(&status); } #else if (pid > -1) kill(pid, SIGKILL); #endif if (!res && owriteformat) ast_set_write_format(chan, owriteformat); ...

Synopsis Zingaya MediaServer from Innosystems

Description ZMS 2.0 is a platform which allows creating SIP-based VoIP services. Such services can work right in web- browser via Adobe Flash technology. The Asterisk and VXI* can be connected to the ZMS. System’s main feature is that end users don’t have to download any specific software. Due to Adobe’s research data more than 90% of Internet users have Adobe Flash Player installed.

More information: http://www.innosystems.ru

Installation This installation procedure is for Debian Linux. Fisrt check if the java JRE is installed, if not proceed like that: Complete the configuration file /etc/apt/sources.list to be able to install the non-free package (Java) :

... deb http://www.backports.org/debian etch-backports main contrib non-free ...

And install the Java package : # apt-get install sun-java6-jre

(Validate the license terms...)

Upload in your server the package from: zingaya.tar.bz2

Install it : # bunzip2 zingaya.tar.bz2 # tar xvf zingaya.tar # cd Zingaya # ./install.sh (Respond to the request questions about the installation configuration. Important, set the right IP) Configure the Zingaya Media Server by editing the /usr/local/zingaya/zingaya.xml :

Set the SIP port (set 5061 to reserve the 5060 to Asterisk) : 5061 false

Start/Stop the server: # cd /etc/init.d # ./zingaya stop # ./zingaya start

Connect to the administration interface: http://yourip/zms_admin/

Check the port connection: http://yourip/zms_admin/test/port_tester.php

Synopsis Armo Firewall for Debian Linux

Description Armo Firewall is a small firewall application for Debian Linux system.

More Information: http://www.debian.org

Installation For any Debian distribution suite, install the Arno Firewall (Single- and multi-homed firewall script with DSL/ADSL support).

# apt-get install arno-iptables-firewall

Defaults TCP ports to set for VXI*:

• 22: SSH remote console and file manager • 80: HTTP web server • 5038: Asterisk Manager interface • 8088:Zingaya media server (RTMPT) • 1935, 1936: Zingaya media server (RTMP) • 1720: H225 (for H323) • 12030,12230: H245 (for H323)

Default UDP ports to set for VXI*:

• 5060 : SIP Call Control protocol • 10000,11000 : RTP Real time Transport Protocol

To reconfigure the firewall: # dpkg-reconfigure arno-iptables-firewall