Dialogic® Diva® System Release LIN - Quick Installation Guide
Copyright © 1993-2009 Dialogic Corporation. 227-252-05
| Abstract |
This document provides an overview of the product installation, configuration and troubleshooting procedures. Please follow this link to COPYRIGHT NOTICE AND LEGAL DISCLAIMER |
- Table of Contents
- COPYRIGHT NOTICE AND LEGAL DISCLAIMER
- Q: How to install the Dialogic® Diva® System Release LIN software
- Q: How to uninstall the Dialogic® Diva® System Release LIN software
- Q: How to activate the Dialogic® Diva® System Release LIN WEB access
- Q: How to access the Dialogic® Diva® System Release LIN WEB interface
- Q: What to do if you cannot gain access to the Dialogic® Diva® WEB configuration
- Q: How to gain secure access to the Dialogic® Diva® System Release LIN software WEB interface
- Q: How to disable the Dialogic® Diva® WEB server
- Q: How to configure the Dialogic® Diva® System Release LIN software
- Q: How to backup/restore a "Dialogic® Diva® System Release LIN software" configuration
- Q: How to start/stop the Dialogic® Diva® drivers manually
- Q: How to prevent the Dialogic® Diva® drivers from being loaded at a system start
- Q: What to do if the system start fails after the Dialogic® Diva® drivers have been installed
- Q: How to capture the relevant information about the cause of a system failure - Dialogic® Diva® Support Wizard
- Q: How to capture trace/debug information - Dialogic® Diva® Trace Wizard
- Q: Dialogic® Diva® SNMP support
- Q: How to activate the Dialogic® Diva® SIPcontrol® software, the Dialogic® Diva® softIP software, or the Dialogic® Diva® softSS7 software
- Q: How to use the Dialogic® Diva® System Release LIN software with Asterisk
- Q: Dialogic® Diva® Media Board Health Monitor
- Q: Available test tools and example applications
- Q: Available source code
A: The Diva System Release software is distributed as binary package supporting all style package managers as well and without package managers as generic Linux systems and contains all necessary components. To install the package, follow the steps below:
Login as "root", or use "su -" to receive superuser rights.
Execute with the command sh Diva4Linux_installer_9.0-1XX-XX.bin, where xx is the binary package version.
Go to the /usr/lib/opendiva/divas/src directory and execute the build script.
A: To uninstall the Diva System Release software, execute the command /usr/lib/opendiva/divas/Diva4Linux_uninstaller.sh.
 | Close all applications that access the Dialogic® Diva® device drivers before you uninstall the Diva System Release software. |
If you have difficulty finding and closing these applications, you can use the following procedure:
cd /usr/lib/opendiva/divas
sh ./cfg_util.sh 2 (As an alternative you can use the "Start driver on system boot" configuration option on the "System configuration" page of the Dialogic® Diva® WEB configuration).
Reboot your PC.
Now you can uninstall the Diva System Release software.
A: The Diva System Release software contains a WEB server that allows you to configure, monitor, and control the installed the Dialogic® Diva® Media Boards and drivers (CAPI, TTY) remotely.
The Dialogic® Diva® HTTP server (diva_httpd) is started on system boot time and during installation. By default, this WEB server is listening on port 10005. You can also run it on port 10006 with the HTTPS protocol. The access to the WEB server is protected by a password.
| The Diva System Release software does not support inetd. |
To gain access to the WEB server, you need to set a password that consists of at least 7 printable ASCII characters and that is included in the first line of the file /usr/lib/opendiva/divas/httpd/login/login. Open this file in your editor of choice and replace the default text "XX" with your password.
A: You can use an HTML browser that correctly supports tables, JavaScript, and cascading style sheets. Access has been tested with MSIE > 5.5, Firefox 2 and higher, Safari.
To connect to the WEB interface use "http://localhost:10005" or "http://127.0.0.1:10005" or "https://localhost:10006" or "https://127.0.0.1:10006", using your machine name or IP address.
| You should set a password to have access to the Dialogic® Diva® WEB server. Ensure that xinetd is running, and control the firewall settings before using it. |
It might be possible that a different port has been assigned to the WEB configuration in some scenarios. Check the actual settings on your system by executing the command grep diva /etc/services and refer to this port.
A: If you cannot login to the system, but you can see the login screen, verify whether you set the password.
Another possibility is to check your firewall settings to make sure that your system is able to receive incoming TCP connections via port 10005.
A: The Web interface supports secure connections via https. The default port is 10006.
A: To prevent the Diva WEB server from being started, follow the steps below:
Execute the command: cd /usr/lib/opendiva/divas
Execute the command: sh cfg_util.sh 4 [1]
A: You can use the Dialogic® Diva® System Release LIN WEB server that is listening to the port 10005 or use the console-mode Dialogic® Diva® Configuration Wizard /usr/lib/opendiva/divas/Config.
A: There are two ways to backup and restore your configuration: You may either use the backup and restore functionality offered by the Diva System Release LIN WEB interface or you save the configuration file /usr/lib/opendiva/divas/divas_cfg.rc to a different directory. [2].
| During uninstallation, the configuration is saved to the parent directory /usr/lib/opendiva. Upon reinstallation a previously saved configuration is restored and activated. |
To manually restore a saved configuration, follow the steps below:
Copy the backup file back to the /usr/lib/opendiva/divas directory and rename it to divas_cfg.rc
Execute the command: chown 0 /usr/lib/opendiva/divas/divas_cfg.rc
Execute the command: chgrp 0 /usr/lib/opendiva/divas/divas_cfg.rc
Execute the command: chmod 744 /usr/lib/opendiva/divas/divas_cfg.rc
A: You can use the Dialogic® Diva® System Release LIN software WEB access "System control (driver start/stop)" or use the commands /usr/lib/opendiva/divas/Start to start and /usr/lib/opendiva/divas/Stop to stop the Diva drivers.
Note that you cannot unload the Diva drivers if one of the drivers is still in use. In thas case, Stop will abort with error and inform you about the name of the driver that cannot be unloaded.
A: By default, the Diva drivers are loaded and started at system load time (run levels 2, 3, and 5). This is managed by the S03DIVAS4LINUX and S15DIVAS4LINUX_NETWORK symbolic links that are located in the distribution-dependent system directories and point to the file /usr/lib/opendiva/divas/Start.
To remove these symbolic links, you can use the "Start driver on system boot" configuration option on the "System configuration" page of the Dialogic® Diva® WEB configuration, or the corresponding option in the command line configuration tool ./Config, or you can follow the steps below:
Execute the command: cd /usr/lib/opendiva/divas
Execute the command: sh cfg_util.sh 2 [3]
A: Start your system in single-user mode (Entering single user mode is system dependent. Most systems require you to press ESC as soon as the initial boot screen appears and pass the "s" or "1" boot option to the kernel).
After the system is running in single user mode, you can follow the procedure that prevents Diva drivers from being loaded at the system start. Reboot your system and invoke the Dialogic® Diva® Support Wizard.
| It might be necessary to remount the root file system in "read/write" mode. You can do this via the command mount / -o remount,rw. |
Q: How to capture the relevant information about the cause of a system failure - Dialogic® Diva® Support Wizard
A: The Diva Support Wizard can be used in case of a driver/board/system failure to perform automatic capture of information that is necessary to handle your support request.
You can invoke the Diva Support Wizard via the Dialogic® Diva® WEB access "Support/Troubleshooting" or use the console-mode application /usr/lib/opendiva/divas/Support.
| You can use the Diva Support Wizard to capture ("space consuming" support profile) all necessary information to reproduce your environment on other hardware. This option requires about 20 MB of free disk space. Please use this option if you are unsure about the cause of the system failure (system crash, driver cannot be loaded) or if you have general problems activating the support for the Dialogic® Diva® Media Boards on your system. |
A: You can use the Diva Trace Wizard to create trace files with debug messages from Dialogic® Diva® Media Boards and drivers.
You can access the Diva Trace Wizard via the Dialogic® Diva® WEB access "Trace/Debug" or use the console-mode application /usr/lib/opendiva/divas/Trace.
The Diva Trace Wizard allows you to set up the trace level depending on the problem and on involved interface drivers in the call process.
You can use the Diva WEB access "View trace file" or the console-mode application /usr/lib/opendiva/divas/divactrl ditrace to filter, decode and view the Dialogic® Diva® trace files [4] [5].
If you use the Diva WEB access to decode and view the Diva trace files, you can get detailed analysis of the messages (D-channel, Audio signal analysis, ...) if you follow symbolic links in the trace window.
If you prefer to use console-mode application, use /usr/lib/opendiva/divas/divactrl ditrace -i XXX or /usr/lib/opendiva/divas/divactrl ditrace -i XXX -d ZZZ, where "XXX" is the name of the binary trace file [6] and "ZZZ" is the comma separated list of driver idents to filter for [7] [8], to decode and view Diva trace files.
| If you selected a trace level that deals with B-channel or AudioTap processing, you can use selective tracing, which should significantly reduce the trace file size and host CPU load. In this mode, B-channel/AudioTap traces are turned on only for calls that meet the selected call filter requirements and only for one call at a time. |
A: The divasnmpx application provides SNMP support for Dialogic® Diva® Media Boards. You can activate Diva SNMP support using the Dialogic® Diva® System Release LIN WEB configuration or using the console-mode Dialogic® Diva® Configuration Wizard.
Refer to the product reference guide for details on supported SNMP MIB's and traps.
| divasnmpx uses AgentX protocol and can be used to extend SNMP agents that support this protocol. |
| divasnmpx is able to detect changes in the operating state of the Dialogic® Diva® Media Board or to link and to report these events as appropriate SNMP traps. |
Q: How to activate the Dialogic® Diva® SIPcontrol® software, the Dialogic® Diva® softIP software, or the Dialogic® DSI SS7 for Diva® software
A: The Diva SIPcontrol software, the Diva softIP software, and the DSI SS7 software require valid software licenses. The Diva SIPcontrol software is delivered containing a free two (2) channel license. If you need more channels or want to deploy the Diva softIP or DSI SS7 software, contact your local sales representative.
A: The Dialogic® Diva® System Release is compatible with the CHAN_CAPI Asterisk interfaces. The CHAN_CAPI is a specific use case to provide CAPI-based ISDN hardware support. It establishes the connection between the PBX software and ISDN hardware, which provides a CAPI 2.0 compatible interface.
During the installation of the Diva System Release LIN software, the installation process detects automatically if Asterisk is installed and if the header files to build the CHAL_CAPI driver are available.
If Asterisk is installed, the user will be asked if the CHAN_CAPI driver should be build. After confirmation, the build process automatically detects the installed Asterisk version and creates and installs the required CHAN_CAPI driver.
If Asterisk is not installed, the documentation for using Asterisk with Diva is available in the web configuration. Asterisk may be installed or updated after the Diva System Release is installed. In this case, the build process for the Diva System Release can be started again and will create and install the CHAN_CAPI driver.
The CHAN_CAPI configuration generates a capi.conf Asterisk configuration file and modifies the modules.conf and makes the available options visible. You need to write your own extension.conf. Consult the examples in the internet for reference. For Diva-specific commands, see the README, README.media, README.Diva.fax, and README.Diva.qsig files.
The CHAN_CAPI can be configured via the Diva System Release web interface.
A: If you do not use the Dialogic® Diva® SNMP support, then you can control the operating state of the Dialogic® Diva® Media Board by means of the Diva Media Board Health Monitor that is part of the divactrl application.
To start the Diva Media Board Health Monitor in the background, execute: /usr/lib/opendiva/divas/divactrl load -c X -CardMonitor -File Y, where X is the board number to be monitored and Y is the user provided application.
If a board fails, the Diva Media Board Health Monitor will write appropriate information in the system log, execute user provided application, and exit.
You can use the shell script /usr/lib/opendiva/divas/card_monitor that is provided as part of the product to notify the system administrator via e-mail. You can modify the shell script to meet your requirements (for example, to issue SNMP traps with snmptrap utility and restart the board.)
A: The following tools are distributed as part of the Dialogic® Diva® System Release LIN software:
acopy2 - ISDN file transfer utility (client and server). Allows for transfering files and for listing directories. Uses the CAPI interface.
testfax - Fax G3 test utility (client and server). Supports ECM, Compression, polling. Uses the CAPI interface. Testfax is not available in the US version of the product.
telsampl - CTI example application that demonstrates access to Supplementary Services, Voice/Tone Processing, Echo Cancellation, and VoIP processing. Uses the CAPI interface.
tty_test - Allows for testing integrity of the ISDN links and for building the stress-tests systems. Uses the TTY interface.
A: The following source code is available under the GPL license:
XDI device driver (divas.o, responsible for hardware access)
DIDD device driver (divadidd.o, kernel mode IDI [9] )
MAINT device driver (diva_mnt, debug and trace driver)
User mode IDI device driver (diva_idi)
Diva CAPI device driver (divacapi)
CAPI device driver (kernelcapi, capi)
TTY device driver (Divatty)
divactrl board control and trace utility
divalogd board accounting/journaling utility
Dialogic® Diva® Extended Management and Trace SDK
The following source code is available under the Dialogic license:
acopy2 - ISDN file transfer utility (client and server)
testfax - Fax G3 utility (client and server)
tty_test - TTY test tool
telsampl - CTI example application
COPYRIGHT NOTICE AND LEGAL DISCLAIMER
Copyright (c) 1993-2008 Dialogic Corp. All Rights Reserved. You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation.
All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries ("Dialogic"). Reasonable effort is made to ensure the accuracy of the information contained in the document. However, Dialogic does not warrant the accuracy of this information and cannot accept responsibility for errors, inaccuracies or omissions that may be contained in this document.
INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN A SIGNED AGREEMENT BETWEEN YOU AND DIALOGIC, DIALOGIC ASSUMES NO LIABILITY WHATSOEVER, AND DIALOGIC DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY. >
Dialogic products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications.
It is possible that the use or implementation of any one of the concepts, applications, or ideas described in this document, in marketing collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties. Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic. More detailed information about such intellectual property is available from Dialogic's legal department at 9800 Cavendish Blvd., 5th Floor, Montreal, Quebec, Canada H4M 2V9. Dialogic encourages all users of its products to procure all necessary intellectual property licenses required to implement any concepts or applications and does not condone or encourage any intellectual property infringement and disclaims any responsibility related thereto. These intellectual property licenses may differ from country to country and it is the responsibility of those who develop the concepts or applications to be aware of and comply with different national license requirements.
Dialogic, Dialogic Pro, Brooktrout, Cantata, SnowShore, Eicon, Eicon Networks, Eiconcard, Diva, SIPcontrol, Diva ISDN, TruFax, Realblocs, Realcomm 100, NetAccess, Instant ISDN, TRXStream, Exnet, Exnet Connect, EXS, ExchangePlus VSE, Switchkit, N20, Powering The Service-Ready Network, Vantage, Connecting People to Information, Connecting to Growth, Making Innovation Thrive, and Shiva, among others as well as related logos, are either registered trademarks or trademarks of Dialogic. Dialogic's trademarks may be used publicly only with permission from Dialogic. Such permission may only be granted by Dialogic's legal department at 9800 Cavendish Blvd., 5th Floor, Montreal, Quebec, Canada H4M 2V9. Any authorized use of Dialogic's trademarks will be subject to full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic's trademarks requires proper acknowledgement.
The names of actual companies and products mentioned herein are the trademarks of their respective owners.
This document discusses one or more open source products, systems and/or releases. Dialogic is not responsible for your decision to use open source in connection with Dialogic products (including without limitation those referred to herein), nor is Dialogic responsible for any present or future effects such usage might have, including without limitation effects on your products, your business, or your intellectual property rights.
Dialogic Corp. License Agreement for use of software
This is an Agreement between you the Company and your Affiliates (referred to in some instances as "You" and in other instances as "Company") and all your Authorized Users and Dialogic Corp.
YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE INSTALLING OR DOWNLOADING THE SOFTWARE. IF YOU AGREE WITH THESE TERMS YOU MAY PROCEED WITH THE DOWNLAOD OR INSTALLATION OF THE SOFTWARE. IF YOU DO NOT AGREE WITH THESE TERMS, PLEASE RETURN THE PACKAGE IN "AS NEW" CONDITION (INCLUDING DOCUMENTATION AND BINDERS OR OTHER CONTAINERS) AND YOUR MONEY WILL BE REFUNDED. DOWNLOADING OR INSTALLING THE SOFTWARE CONSTITUTES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS. YOU ASSUME RESPONSIBILITY FOR THE SELECTION OF THE PROGRAM TO ACHIEVE YOUR INTENDED RESULTS, AND FOR THE INSTALLATION, USE, AND RESULTS OBTAINED FROM THE PACKAGE.
Copyright
The enclosed Software ("Program") and documents are owned by Dialogic Corp. ("Dialogic") and its suppliers and are protected by copyright laws and international treaty provisions. Therefore, You and your Authorized Users must treat the Program and documentation like any other copyrighted material except as expressly permitted in this License Agreement.
License
Under the terms and conditions of this License Agreement:
You may install and use one copy of the Program on a single-user computer, file server, or on a workstation of a local area network, and only in conjunction with a legally acquired Dialogic hardware product;
The primary Authorized User on the computer on which the "Program" is installed may make a second copy for his/her exclusive use on either a home or portable computer;
You may copy the Program into any machine readable or printed form for backup or modification purposes in support of your use of one copy of the Program;
You may make one copy of Dialogic's documentation provided that all copyright notices contained within the documentation are retained;
You may modify the Program and/or merge it into another Program for your use in one computer; (any portion of this Program will continue to be subject to the terms and conditions of this Agreement);
You may transfer the Program, documentation and the license to another eligible party within your Company if the other party agrees to accept the terms and conditions of this Agreement. If You transfer the Program and documentation, You must at the same time either transfer all copies whether in printed or machine readable form to the same party or destroy any copies not transferred; this includes all modifications and portions of the Program contained in or merged into other Programs;
You must reproduce and include the copyright notice on any copy, modification or portion of the Program merged into another Program;
You may not rent or lease the Program. You may not reverse engineer, decompile or disassemble the Program. You may not use, copy, modify or transfer the Program and documentation, or any copy, modification or merged portion, in whole or in part, except as expressly provided for in this License Agreement;
If You transfer possession of any copy, modification or merged portion of the Program or documentation to another party in any way other than as expressly permitted in this License Agreement, this license is automatically terminated;
Upgrades
If the Program is provided as an upgrade and the upgrade is an upgrade from another software product licensed to You and Your Authorized Users by Dialogic, the upgrade is governed by the License Agreement earlier provided with that software product package and the present License Agreement does not grant you additional license(s).
Terms
The license is effective until terminated. You may terminate it at any time by destroying the Program and documentation together with all copies, modifications and merged portions in any form. It will also terminate upon conditions set forth elsewhere in this Agreement or if you fail to comply with any terms or conditions of this Agreement. You agree upon such termination to destroy the Program and documentation together with all copies, modifications and merged portions in any form.
Limited Warranty
The only warranty Dialogic makes is that the medium on which the Program is recorded will be replaced without charge if Dialogic, in good faith, determines that it was defective in materials or workmanship and if returned to your supplier with a copy of your receipt within ninety (90) days from the date you received it. Dialogic offers no warranty for your reproduction of the Program. This Limited Warranty is void if failure of the Program has resulted from accident, misuse, abuse or misapplication.
Customer Remedies
Dialogic's entire liability and You and Your Authorized Users exclusive remedy shall be, at Dialogic's option, either (a) return of the price paid or (b) repair or replacement of the Program that does not meet the above Limited Warranty. Any replacement Program will be warranted for the remainder of the original Warranty period.
No Other Warranties
Dialogic disclaims all other warranties, either express or implied, including but not limited to implied warranties or merchantability and fitness for a particular purpose and the warranty against latent defects, with respect to the Program and the accompanying documentation. This limited warranty gives You specific legal rights. You may have others, which may vary from jurisdiction to jurisdiction.
No Liability for Consequential Damage
In no event shall Dialogic or its suppliers be liable for any damages whatsoever (including without limitation, damages for loss of business profits, business interruption, loss of information, or other pecuniary loss and indirect, consequential, incidental, economic or punitive damages) arising out of the use of or inability to use this Program, even if Dialogic has been advised of the possibility of such damages. As some jurisdictions do not allow the exclusion or limitation for certain damages, some of the above limitations may not apply to You or your Authorized Users.
Limit of Liability
Dialogic's entire aggregate liability under any provision of this agreement shall be limited to the amount actually paid by You for the affected Program.
Right to Audit
If this Program is licensed for use in a Company, your Company agrees to keep all usual and proper records and books of accounts and all usual proper entries relating to each reproduction and Authorized User of the Program during the term of this Agreement and for a period of three (3) years thereafter. During this period, Dialogic may cause an audit to be made of the applicable records in order to verify Your compliance with this Agreement and prompt adjustment shall be made to compensate for any errors or omissions disclosed by such audit. Any such audit shall be conducted by an independent certified public accountant selected by Dialogic and shall be conducted during the regular business hours at Your offices and in such a manner as not to interfere with Your normal business activities. Any such audit shall be paid for by Dialogic unless material discrepancies are disclosed. For such purposes, "material discrepancies" shall mean three percent (3%) or more of the Authorized Users within the Company. If material discrepancies are disclosed, Your Company agrees to pay Dialogic for the costs associated with the audit as well as the license fees for the additional Authorized Users. In no event shall audits be made more frequently than semi-annually unless the immediately preceding audit disclosed a material discrepancy.
Supplementary Software
Any Supplementary Software provided with the Dialogic Program referred to in this License Agreement is provided "as is" with no warranty of any kind.
U.S. Government Restricted Rights
The Program and documentation are provided with RESTRICTED RIGHTS. Use, duplication or disclosure by the U.S. Governments is subject to restrictions as set forth in subparagraph c) 1) ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraph c) 1) and 2) of the Commercial Computer Software-Restricted Rights at 48 CFR52.227-19, as applicable.
Contractor/ manufacturer is:
Dialogic Corp. 9800 Cavendish Blvd., Montreal, Quebec, Canada H4M 2V9
This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
For more details see the file COPYING in the source distribution of Linux.