The Config script (located in the /usr/lib/opendiva/divas directory) is a setup wizard that detects the installed Diva Media Boards and additional applications.
The setup wizard generates the divas_cfg.rc file (located in the /usr/lib/eicon/divas directory) that is used to start the Diva Media Boards, interface drivers, and additional software at system startup or to start the components manually. You can use the script /usr/lib/opendiva/divas/Start to load and /usr/lib/opendiva/divas/Stop to unload the software manually.
The setup wizard creates the necessary device nodes in the /dev directory:
/dev/capi20 is used to access the CAPI 2.0 interface
/dev/ttyds01 ... /dev/ttyds<n> is used to access the Diva TTY interface, where <n> is the sum of B-channels of the installed Diva Media Boards.
You can either use the Config script or the web-based Diva Configuration Wizard to configure the settings for your Diva Media Boards. The following description of configuration options is based on the web-based Diva Configuration Wizard. It is structured as follows:
Post installation settings: Steps to be performed immediately after the installation.
System and Diva Media Board configuration: Configuration of the major parts of the product that depend on the type of your application and the switch type that the Diva board is using. Configuration of application and switch type-dependent parameters that allow you to increase the performance of the system or access switch-specific services. Configuration of number ranges, peers, protocol-specific settings and startup options.
Control and monitoring: Control Diva Media Board configuration, status and performance data.
Maintenance: Initiate trace process, create, view, and download trace files.
The Diva System Release software installs and configures the Dialogic® Diva® WEB Configuration Wizard that allows you to access and configure the Diva System Release software via an HTTP browser.
The installation procedure sets up the port 10005 for HTTP access and 10006 for HTTPS access.
If you do not want to use the Diva WEB Configuration Wizard, you can disable it with the following command:
cd /usr/lib/opendiva/divas && sh cfg_util.sh 4.
To re-activate the Diva WEB Configuration Wizard, use the following command:
cd /usr/lib/opendiva/divas && sh cfg_util.sh 5.
To access the Diva WEB Configuration Wizard you need to edit the /usr/lib/opendiva/divas/httpd/login/login file and configure your password.
The "login" file must meet the following requirements; otherwise, the password will be ignored:
The file must be owned by root.
Permissions must be 600 or 400.
The password must be located in the first line of the file, contain printable characters only and consist of not less than 7 characters.
The system and Diva Media Board configuration is divided in two parts:
System configuration to configure the type of application, the system startup mode, and global parameters.
Board configuration to configure parameters of the installed Diva Media Boards in accordance with the information required by the service provider or the PBX to which the Diva Media Board is connected.
Online help is available for any system configuration option. To open the online help for a specific parameter, click the parameter and a window with the help text pops up.
In the system configuration, select the applications and activate the interfaces that meet your requirements. For example, if you want to set up a fax polling server that is based on the TTY interface, select TTY interface and fax/voice support for TTY.
Depending on the selected application scenario, you can set FAX CLASS 2 options like ECM, compression, etc. For further information, see the online help or Intelligent FAX CLASS 2 Processing.
The system configuration also allows you to specify startup options for your Diva Media Boards. If you plan to clone your system configuration on other computers, disable the verification of the serial numbers. If you want to view debug or trace messages that are issued during the Diva Media Board configuration, enable Debug code for microcode load. For further information on these parameters, see the online help.
To write detailed call log records to the /var/log/divalog.../var/log/divalog.N file, activate the call history. The call log records can be used for accounting and for generating different statistics.
Specify if the divasnmpx SNMP extension agent should be started during driver load.
Specify if the driver load should be forced even if the driver's kernel version does not completely match your Linux kernel version. Note that you cannot force a driver load if your Linux system uses kernel checksums.
Specify if the Diva drivers should be loaded automatically on system startup.
At the end of the system configuration, the Diva WEB Configuration Wizard will prompt you to restart the Diva drivers if necessary. To restart the Diva drivers, go to System control, where you can stop and start the drivers.
Note: Some of the changes, for example, Start driver on system boot or Debug mode for microcode load do not affect the state of the currently running drivers and change only the driver behavior at system or Diva Media Board start. The Diva WEB Configuration Wizard ignores changes of these parameters and does not prompt you to restart the Diva Media Board drivers.
Context-specific online help is available for most configuration options. To open the online help for a specific parameter, click the parameter and a window with the help text pops up.
The Board configuration allows you to configure the Diva Media Boards that are installed in your system as required by your service provider or by the PBX to which the Diva Media Boards are connected.
To start the configuration of a Diva Media Board, select its "board" icon in the Diva Media Board list. The basic configuration parameters are displayed.
Specify the D-channel protocol (switch type) as provided by your service provider.
Specify if you want to operate your board as terminal equipment (TE) or as network termination (NT). Normally, Diva Media Boards are operated as terminal equipment.
Specify whether you are using a direct dial in (DDI) interface. A direct dial in interface provides you with an ISDN line with a basic phone number that is able to accept any extension digits and to pass them to the ISDN applications. If you select Yes, also specify the direct dial in number length.
Note: This option is not available for all D-channel protocols. A better control of incoming called party numbers is available using the Call Routing Configuration.
Specify the layer 1 framing type. The National default setting automatically sets the correct layer 1 framing type for the selected switch type. Change this setting only if you are using your Diva Media Board in a non-standard environment.
Specify the voice companding type that is used to transmit analog data on your line. The National default setting automatically sets the correct voice coding for the selected switch. You need to change this setting only if the voice coding required by your PBX does not correspond to the coding of the switch.
Depending on the installed board and the selected D-channel protocol, you might need to configure various advanced parameters. To do so, set View extended configuration to Yes and modify the advanced parameters as required. For further information on advanced parameters, see the online help topic of the respective parameter.
When the board configuration is complete, the Diva WEB Configuration Wizard stores the parameters list, generates a startup shell script and tries to update the modified parameters via the management interface. If updating via the management interface is not possible, for example, the board is not running or the configuration parameter is not supported by the management interface, the Diva WEB Configuration Wizard prompts you to restart the board.
To restart the board, you can either:
Select in the Board configuration main page Start hardware from the dropdown menu next to the Diva Media Board, or
Set in System configuration page the option Start driver on system boot to Yes, which allows for starting or restarting the Diva Media Boards at once.
Note: Restarting the Diva Media Board clears the active connections of this board.
If you select the Hardware status/management icon, you will gain access to the:
Current status of the Diva Media Board, which allows you to view hardware-related settings and to control the state of the Diva Media Board.
Diva board startup log, which allows you to view the board's configuration as seen by the selected Diva Media Board.
"XLOG" trace snapshot, which allows you to receive a small snapshot of the board traces for the trace ring buffer, located in the Diva Media Board memory.
Line monitor, which allows you to view the status of active connections on the selected board and to clear these connections, if necessary.
Management interface browser, which allows you to walk through the board management interface and view or modify management interface variables or execute management interface functions.
Management interface browser, which allows you to walk through the Diva TTY driver management interface and view or modify management interface variables or execute management interface functions (Port Manager).
Management interface browser, which allows you to walk through the Dialogic® Diva® CAPI driver management interface and view or modify management interface variables or execute management interface functions.
Report based on the information from the board management interface that provides an overview over the Diva Media Board's link status, link quality and over the call-related statistics.
The Diva WEB Configuration Wizard provides access to the following maintenance functions:
System environment allows for viewing hardware-related settings of the host system.
Trace/Debug allows for creating debug and trace files of the Diva Media Board or the system.
Support/Troubleshooting allows for capturing information required for the support request in case of installation problems.
System messages allows for viewing the latest system messages (dmesg).
View trace file allows for decoding, viewing, and filtering debug and trace files.
View call history allows for viewing the latest call history file.
View statistics allows for generating and viewing statistics, based on the call history files.
The system environment browser allows for viewing information about the:
Kernel version
CPU(s)
PCI bus configuration
I/O memory configuration
I/O port configuration
DMA configuration
Interrupt configuration
APM configuration
Loaded modules
Installed devices
Memory usage
The Dialogic® Diva® Trace Wizard allows for selecting various trace profiles and thus enables you to trace everything or to suppress unnecessary information in certain scenarios. Detailed information on the various trace profiles is given in the online help. To display the online help for a profile, click its name.
The Diva Trace Wizard also allows you to set the size of the trace ring buffer - a binary file where the trace information is stored - and to start the trace process in the background.
After the trace process is started, you can leave the Diva Trace Wizard or close your HTML browser without affecting the running trace process.
While the trace process is running (and after the trace process is stopped), you can decode, filter, and view the content of the trace ring buffer file with the trace file browser (View trace file).
To stop a running trace process, enter the Diva Trace Wizard again; the Diva Trace Wizard will remember that the trace process is still running, and stop it. After stopping the trace process, you can download the compressed binary trace file.
If you should experience any problems after the installation of the Diva System Release software, for example, no Diva Media Boards can be detected, use the Dialogic® Diva® Support Wizard to capture and download in compressed form the information that is required to process your support request. Select one of the following options:
Capture the necessary information about your system (kernel version, PCI-bus configuration, system configuration files).
Capture the necessary information about your system (kernel version, PCI-bus configuration, system configuration files) and a binary image of the installed kernel and related modules. With this option, the Dialogic Customer Support can reproduce your environment if this should be necessary to process your support request. Select this option only if requested by the Dialogic Customer Support.
The system log viewer allows you to view the latest kernel messages. You can use this information to control the load and operation of Diva drivers and to check your system for unexpected errors, driver failures, or exceptions ("Oops").
The trace file browser allows for decoding, filtering, and browsing the trace file without downloading this file to your machine and without stopping the trace process.
The trace file viewer displays a list of the Dialogic® Diva® debug and trace sources information contained in the trace file and it allows you to select the sources of information that you want to view, decode, and display.
The trace viewer highlights messages in the trace information window by the following colors:
Yellow - highlights messages related to initial call establishment
Green - highlights messages related to the call establishment progress and completion
Red - highlights messages related to the call disconnect procedure
To get detailed decoded information on trace and debug messages, click the "highlighted" links in the trace information window.
The call history (call journal/log) is stored as a sequence of files named divalog,divalog.1...divalog.N, where N is the integer number in the /var/log directory. The divalog.N file contains the oldest trace information while the divalog file contains the latest (current) information about the call activities.
You can use the call history viewer to decode the divalog file (call time, duration, type, speed) and view this information without downloading the call history file to your local machine.
To download call history files, click Download. You will receive a text file that displays the various components of the call history information separated by commas. The first line of the file contains the description of the components.
The Dialogic® Diva® Statistics Viewer analyzes the call history files found in the /var/log directory and creates various statistics based on these files. The statistics show the total number of calls related to various periods of time, the ratio of incoming and outgoing calls, the ratio of call types, call duration charts, a peak board load chart, etc.
The statistic information is presented in a graphical format (jpeg) and can be used to analyze the system load and reliability.
If you want to create your own statistics, download the call history files in the call history viewer and apply your own spread-sheet application.