Dialogic — Technical Presentation (May 2009)
53 slides from Dialogic's technical presentation, May 2009
Slide 1: Installing Dialogic Diva Software Driver as an Asterisk Channel
Installing Dialogic® Diva® Software Driver as an Asterisk Channel A Technical Overview
Slide 2: Agenda
Agenda History – What is Asterisk? – Who is Dialogic? Installation and Configuration – Installing Dialogic® Diva® Software Driver – Installing Asterisk – Configuring Diva Software Driver for Asterisk • Telling Diva Software Driver to deliver inbound calls to Asterisk – Introduction to extended Diva
Slide 3: What is Asterisk?
What is Asterisk? www.dialogic.com Slide 3 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 4: What is Asterisk?
What is Asterisk? Asterisk is a Free, Open Source, PBX based on Linux – Allows SIP and other IP calls to be switched without additional hardware Allows connectivity to analog and T1/E1 telephony lines via 1st and 3rd party hardware For basic switching and voicemail, it works with virtually no additi
Slide 5: What is Asterisk? -- continued
What is Asterisk? -- continued Answers inbound calls and plays prompts, records messages Voicemail implemented Provides framework to create customized dial plan Basic SIP registrar No (C-level) code required to implement these features www.dialogic.com Slide 5 © Copyright 2009 Dialogic Corporation.
Slide 6: Who is Dialogic?
Who is Dialogic? www.dialogic.com Slide 6 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 7: Dialogic at a Glance
Dialogic at a Glance Dialogic is the most recognized name in the converged communications enabling industry and remains the market segment leader Founded in 1984 – The company name changed from Eicon Networks Corporation to Dialogic Corporation in October 2006 after completing the acquisition of Int
Slide 8: Dialogic Products and Services Overview
Dialogic® Products and Services Overview Software (Signaling Software, Host Media Processing, IP Media Server, TDM/IP Gateway, System Release Software, SDK) Integrated Platforms (Signaling Servers, Signaling Gateways, Media Servers, Media Gateways, Integrated Media and Signaling Gateways) Boards (TD
Slide 9: Dialogic Products Value Proposition
Dialogic® Products Value Proposition DSP Offload Resource • Reduce Load on the CPU • Tone Generation and Recognition • Packetization • Conferencing • More Functionally Planned www.dialogic.com Slide 9 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 10: Dialogic Products Value Proposition -- continued
Dialogic® Products Value Proposition -- continued Carrier Grade Hardware World Wide Distribution Service and Support International Approvals www.dialogic.com Slide 10 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 11: Chan_DialogicDiva
Chan_DialogicDiva For use with Dialogic® Diva® Products Can be used with Standard (free) Asterisk – This is an open source project maintained by melware.net There are some significant deployments in EMEA using Diva/Asterisk Links – http://www.dialogic.com/s/isdn/How2UseDiva4Asterisk_with_chan_dialog
Slide 12: Chan_DialogicDiva in Diva System Release 9.0 for Linux
Chan_DialogicDiva In Dialogic® Diva® System Release 9.0 for Linux – The chan_dialogicdiva will be installed automatically by the build process Check to see if your installation includes chan_dialogicdiva www.dialogic.com Slide 12 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 13: Installation - Diva Software Driver
Installation - Dialogic® Diva® Software Driver www.dialogic.com Slide 13 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 14: Asterisk + Dialogic Diva Product Architecture Diagram
Asterisk + Dialogic® Diva® Product Architecture Diagram Dialogic® Diva® System Release Dialogic® Diva® Media Boards www.dialogic.com Slide 14 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 15: Obtaining the Diva Software Drivers
Obtaining the Dialogic® Diva® Software Drivers www.dialogic.com Slide 15 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 16: Obtaining the Drivers
Obtaining the Dialogic® Diva® Software Drivers Dialogic® Diva® System Release 9.0 for Linux download page 2 Items available for download – Diva4Linux_installer_9.0-108-38.bin • This is the Dialogic® Diva® Software Development Kit (SDK) • This may include chan_dialogicdiva-1.1.2.tar.gz – This file is
Slide 17: Preparing the System
Preparing the System www.dialogic.com Slide 17 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 18: Preparing the System
Preparing the System The Dialogic® Diva® Software Drivers are compatible with most current Linux distributions – The source is distributed and is compiled at installation time to work with your running kernel You must have kernel sources in /usr/src/linux And that kernel source in /usr/src/linux mus
Slide 19: Preparing the System -- continued: Kernel versions
Preparing the System -- continued Kernel versions – Compare version returned from: • uname –r – To the folder linked by /usr/src/linux The kernel source and running kernel MUST MATCH! www.dialogic.com Slide 19 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 20: Preparing the System -- continued: Pre-requisite packages
Preparing the System -- continued There are pre-requisite packages that must be present to complete the installation – These packages should be installed by your distribution’s package manager, if available • Otherwise, you can get them and compile them from source – Modutils (module-init-tools) – N
Slide 21: Preparing the System -- continued: Listing packages
Preparing the System -- continued Pre-requisite packages (cont) – You can use the commands • rpm –qa | grep <pkg_name> OR • dpkg –l <name*> To list installed packages in order to verify pre-requisites – Install missing packages with • yum install <pkg_name> OR • apt-get install <pkg_name> www.dialog
Slide 22: Preparing the System -- continued: Caution
Preparing the System -- continued CAUTION – Additional steps are required on systems that are built for cross-compiling Please see the file How2UseDiva4Asterisk_with_chan_dialogicdiva.txt for additional configuration steps when cross-compiling www.dialogic.com Slide 22 © Copyright 2009 Dialogic Corp
Slide 23: Running the Driver Installer
Running the Dialogic® Diva® Software Driver Installer www.dialogic.com Slide 23 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 24: Running the Installer
Dialogic® Diva® Software Driver Running the Installer Easiest step is running the installer Ensure you are root or have full “root” privileges – Insufficient access rights can cause failures SELinux or other 2nd level access can restrict rights as well www.dialogic.com Slide 24 © Copyright 2009 Dial
Slide 25: Running the Installer -- continued: Run as root
Dialogic® Diva® Software Driver Running the Installer -- continued To run as root: – Try: • su – OR • sudo –i – To get a “#” or root prompt before executing: – ./Diva4Linux_installer_9.0-108-38.bin www.dialogic.com Slide 25 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 26: Running the Installer -- continued: File permissions
Dialogic® Diva® Software Driver Running the Installer -- continued You may need to set file permissions to executable – Most distributions support • chmod 755 Diva4Linux_installer_9.0-108-38.bin OR • chmod u+x Diva4Linux_installer_9.0-108-38.bin www.dialogic.com Slide 26 © Copyright 2009 Dialogic Co
Slide 27: Running the Installer -- continued: While installing
Dialogic® Diva® Software Driver Running the Installer -- continued While the installer is running: 1. You will have to agree to the license agreement 2. It will ask you if it can uninstall previous versions 3. It will install files – There are 2 more steps – Build the drivers – Configure/Start the d
Slide 28: Running the Installer -- continued: Steps after the installer
Dialogic® Diva® Software Driver Running the Installer -- continued Steps after the installer – Build the drivers – Configure the software – Enable the Web configuration tool (optional) www.dialogic.com Slide 28 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 29: Running the Installer -- continued: Build the drivers
Dialogic® Diva® Software Driver Running the Installer -- continued Build the drivers – Change to the /usr/lib/opendiva/divas/src directory – As root, run “./Build” Build options: – -mrproper forces clean rebuild – -rpm selects build of binary rpm – -deb selects build of binary deb file – -detect-ker
Slide 30: Running the Installer -- continued: Build the drivers
Dialogic® Diva® Software Driver Running the Installer -- continued Build the drivers – This should result in many “PROCESSING:” lines Ending in… “SUCCESS. You can configure and start your Diva adapter now” TIPS: – This will succeed even if your kernel sources don’t match your running kernel. But sta
Slide 31: Configuring the Diva Software Drivers
Configuring the Dialogic® Diva® Software Drivers www.dialogic.com Slide 31 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 32: Configuring the Drivers
Configuring the Dialogic® Diva® Software Drivers Can be done via – Config script • In /usr/lib/opendiva/divas/ OR – Via Web-page based configuration Web is more familiar www.dialogic.com Slide 32 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 33: Configuring the Drivers -- continued: Using the web interface
Configuring the Dialogic® Diva® Software Drivers -- continued Using the web interface Change the login password in: – /usr/lib/opendiva/divas/httpd/login/login – Simple passwords will be ignored • Use 7 characters and a number or a symbol Finally, open your browser and point to: – http://localhost:1
Slide 34: Configuring the Drivers -- continued: Potential issues
Configuring the Dialogic® Diva® Software Drivers -- continued Using the web interface – potential issues – xinetd must be installed and running – Firewalls can also block access to web configuration www.dialogic.com Slide 34 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 35: Configuring the Drivers -- continued: System Configuration
Configuring the Dialogic® Diva® Software Drivers -- continued Under “System Configuration” – Choose “DIVA API/CAPI 2.0 interface” You may want to enable CallerID under “Board Configuration” www.dialogic.com Slide 35 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 36: Configuring the Drivers -- continued: System control
Configuring the Dialogic® Diva® Software Drivers -- continued Under “System/System control” – Start/stop the drivers • Startup logs loaded right into the web page www.dialogic.com Slide 36 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 37: Installation – Asterisk
Installation – Asterisk www.dialogic.com Slide 37 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 38: Asterisk Installation
Asterisk Installation First, get the package from http://www.asterisk.org – Most current 1.4.x release (as of May 2009) is 1.4.24.1 at: • http://www.digium.com/elqNow/elqRedir.htm?ref=http://downloa ds.digium.com/pub/asterisk/releases/asterisk-1.4.24.1.tar.gz Unzip and Untar the archive Then compile
Slide 39: Asterisk Installation -- continued
Asterisk Installation -- continued The package is not added into the “automatic” startup scripts by default – Example scripts for various distributions are provided in the “contrib” directory Start Asterisk on the command line: – asterisk –vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvc – The v’s are for verbose o
Slide 40: Asterisk Installation -- continued: Firewall and SELinux
Asterisk Installation -- continued Ensure your Operating System’s firewall is set to allow access to your SIP signaling and RTP IP/UDP ports SElinux can be used but often disabled – Especially when doing custom AGI scripting www.dialogic.com Slide 40 © Copyright 2009 Dialogic Corporation. All rights
Slide 41: Configuring the Dialogic Diva Channel Drivers
Configuring the Dialogic® Diva® Channel Drivers www.dialogic.com Slide 41 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 42: Overview of Asterisk + Dialogic Diva Product Architecture
Overview of Asterisk + Dialogic® Diva® Product Architecture Dialogic® Diva® System Release Dialogic® Diva® Media Boards www.dialogic.com Slide 42 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 43: Configuring the Channel Drivers -- continued: dialogicdiva.conf
Configuring the Dialogic® Diva® Channel Drivers -- continued Modify dialogicdiva.conf as appropriate – 2 main sections of configuration file • [general] – Driver level configurations • [ISDNx] – Adapter specific configurations www.dialogic.com Slide 43 © Copyright 2009 Dialogic Corporation. All righ
Slide 44: Configuring the Channel Drivers -- continued: general defaults and ISDNx
Configuring the Dialogic® Diva® Channel Drivers -- continued [general] defaults are usually appropriate [ISDNx] – isdnmode=msn – controller=1 – context=isdn-in • Most important: set “context=” to be the name of the context in the extensions.conf file where you want inbound calls delivered www.dialog
Slide 45: Configuring the Channel Drivers -- continued: Integrate into dialplan
Configuring the Dialogic® Diva® Channel Drivers -- continued Integrate new channels into dialplan – Now modify the dial plan • Route inbound calls to the demo context – [isdn-in] – exten => s,1,Goto(Demo, s, 1) www.dialogic.com Slide 45 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 46: Configuring the Channel Drivers -- continued: Add chan_dialogicdiva.so
Configuring the Dialogic® Diva® Channel Drivers -- continued Add chan_dialogicdiva.so to module.conf Modify dialogicdiva.conf as appropriate Integrate new channels into dialplan www.dialogic.com Slide 46 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 47: Configuring the Channel Drivers -- continued: Edit modules.conf
Configuring the Dialogic® Diva® Channel Drivers -- continued Add chan_dialogicdiva.so to module.conf – Edit /etc/asterisk/modules.conf – Add the following lines: • load => chan_dialogicdiva.so • chan_dialogicdiva.so=yes www.dialogic.com Slide 47 © Copyright 2009 Dialogic Corporation. All rights rese
Slide 48: Configuring the Channel Drivers -- continued: Start Asterisk
Configuring the Dialogic® Diva® Channel Drivers -- continued Add chan_dialogicdiva.so to module.conf – Asterisk can be started www.dialogic.com Slide 48 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 49: Introduction to Diva Software Driver Extended Features under Asterisk
Introduction to Dialogic® Diva® Software Driver Extended Features under Asterisk www.dialogic.com Slide 49 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 50: Extended Features under Asterisk
Dialogic® Diva® Software Driver Extended Features under Asterisk In addition to being a simple network interface, Diva Software Drivers can: – Offload much of the media processing from the Asterisk server • Beneficial in terms of reliability and scalability – Provide media and call control features
Slide 51: Extended Features under Asterisk: Media enhancements
Dialogic® Diva® Software Driver Extended Features under Asterisk Media enhancements include – Hardware based Fax – Hardware-based conferencing – Hardware-based echo cancelation – Fax over IP (T.38) – DTMF clamping – Audio pitch control – Audio volume control via DTMF – Noise suppression – Automatic
Slide 52: Where to go for more info
Where to go for more info The README.TXT that ships with the chan_dialogicdiva software has examples of using commands specific to the Dialogic® Diva® Software Driver www.asterisk.org www.voip-info.org www.dialogic.com Slide 52 © Copyright 2009 Dialogic Corporation. All rights reserved.
Slide 53: Trademark notice
Dialogic, Dialogic Pro, Brooktrout, Diva, Cantata, SnowShore, Eicon, Eicon Networks, NMS Communications, NMS (stylized), Eiconcard, SIPcontrol, Diva ISDN, TruFax, Exnet, EXS, SwitchKit, N20, Making Innovation Thrive, Connecting to Growth, Video is the New Voice, Fusion, Vision, PacketMedia, NaturalA