Intel NetStructure® Host Media Processing Software Release 1.
INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT.
About This Publication This section contains information about the following topics: • Purpose • Intended Audience • How to Use This Publication • Related Information Purpose This Release Update addresses issues associated with Intel® NetStructure™ Host Media Processing Software Release 1.2 for Linux.
About This Publication Related Information See the following for additional information: • For further information on issues that have an associated defect number, you may use the web-enabled Defect Query tool at: http://membersresource.intel.com/defects/ When you select this link, you will be asked to either LOGIN or JOIN. If you have any questions about this tool or wish to provide feedback regarding this tool, please use the contact page on the Telecom Support Services Web site at: http://resource.
Document Revision History This revision history summarizes the changes made in each published version of the Release Update for Intel® NetStructure™ Host Media Processing Software Release 1.2 for Linux, which is a document that is subject to updates during the lifetime of the release. Document Rev 05, published September 2006 Updated for Service Update 18. Note: This Revision History and the Release Issues sections have been modified to show issues by Change Control System defect number and by PTR number.
Document Revision History The Post-Release Developments section includes the following changes: • Added support for Transaction Record. See Section 1.6, “Transaction Record”, on page 12. The Release Issues section contains the following changes: • Added the following items to Table 1, “Issues Resolved in HMP 1.2”, on page 15: IPY00030253 (PTR 34363), IPY00009813 (PTR 34638), IPY00010596 (PTR 34758), IPY00009054 (PTR 34875).
Document Revision History • In the Release Documentation section, added information about revising Table 2 of the Release Guide to support 120 low bit rate coders (Enhanced RTP resources). • In the Demonstration Software Documentation section, added note with respect to each Demo Guide about demos not working on channel numbers above 120. Document Rev 01, published October 2004 Initial version of document. HMP Linux 1.
Post-Release Developments 1. 1 This section describes significant changes to the Intel® NetStructure™ Host Media Processing Software Release 1.2 for Linux subsequent to the general availability release date. • Service Update for Host Media Processing Software 1.2 for Linux . . . . . . . . . 8 • Service Update Software Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 • Support for SUSE Linux Enterprise Server 9.2. . . . . . . . . . . . . . . . . . . . . . . . .
1.2.1 Assumptions and Prerequisites The following are basic requirements to install and run the HMP software: • Before installing the HMP Software, make sure that the system meets the hardware and software “System Requirements” as described the HMP Software Release Guide. These requirements include the following: – A system with either Red Hat Enterprise Linux including Update 1 or Update 3 installed (You must also install the Intel-provided 2.6.8.1 kernel on top of the base Red Hat release.
3. Manually start HMP services using dlstart. HMP services will start automatically whenever you reboot your system. 1.2.3 Installing the Service Update The following procedure describes how to install the Service Update. 1. Log in to the Linux system as root. 2. Download and unarchive the Service Update software from the Web. 3. Enter the following command to start the install script: ./install.
7. At this point, you have two options: • Enter y if you already have obtained a license or want to use the verification license supplied with the software. Follow the procedure for activating a license in Section 2.4 of the Host Media Processing Software Release 1.2 for Linux Installation Guide. • Enter n if you do not want to use the verification license or have not obtained the license you want. After you have obtained a license, run config.
Update 1 libraries. Failure to use this environment variable in makefiles may cause linking failures due to potential name conflicts. 1.3 Support for SUSE Linux Enterprise Server 9.2 The Service Update also provides support for SUSE Linux Enterprise Server 9.2. At a minimum, the SUSE Linux Enterprise Server kernel .
For additional Information about Transaction Record, see Section 3.4.14, “Voice API for Host Media Processing Library Reference”, on page 34 and Section 3.4.15, “Voice API for Host Media Processing Programming Guide”, on page 41. HMP Linux 1.
Release Issues 2. 2 This chapter includes the following topics that relate to release issues: • Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 • Restrictions and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 • Compatibility Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 • Operating System Notes. . . . . . . . . . . . . . . . . . . .
Description A summary description of the issue. For non-resolved issues, a workaround is included when available. Table 1. Issues Resolved in HMP 1.2 Defect Number PTR Number SU No. Product or Component IPY00033948 -- 18 HMP dlstop does not stop all Dialogic processes if the user’s default shell is csh. IPY00033758 -- 18 HMP teeloger process is created each time ct_intel restart is executed. IPY00032236 36062 18 Kernel Kernel fails with a QVERIFY FAILED in lbrac.
Table 1. Issues Resolved in HMP 1.2 (Continued) Defect Number PTR Number SU No. Product or Component IPY00009204 33894 6 CSP/Voice During heavy load, while running CSP and voice together, the HMP system may miss an event and have a channel stay busy. IPY00009082 33762 6 Global Call Segmentation fault in gc_Start() when more than 1024 files have been opened prior to calling gc_Start(). If 1024 files are opened after gc_Start() and after opening the devices, no calls can be established.
Table 1. Issues Resolved in HMP 1.2 (Continued) Defect Number PTR Number SU No. Product or Component IPY00011249 33376 6 Install During the install, instead of entering 1 to install the HMP software, if a 1` entered. (the 1 and the key to the left of the 1 key), the install prints out some error messages and then installs only two of the packages (OOC and DMDEV). IPY00011233 33363 6 HMP Merc Stream Rcv Disconnect(): unexpected Drv. Msg C00013 prints to the screen while running tests.
Table 2. Known Issues in HMP 1.2 Defect Number IPY00028330 PTR Number Product or Component 34473 Demo Description When NetMeeting on Windows XP is used to call into IPMS demo on HMP, the call is established, but digit press is not recognized by the demo side. Workaround: None IPY00028493 34440 Demo When a voice mail message is successfully recorded and then listened to, the option to either save the message or delete it does not work. Workaround: Recompile the demo application.
• DM3Stderr and DebugAngel diagnostics tools are not supported in this release. As a way to debug DM3 firmware, all firmware prints are sent to /var/log/messages by default. They can be sent to stdout when the boot kernel is run in non-daemon mode. You must ensure that syslogger is enabled and running. To check, use “ps -ef | grep syslogger”. If it is not running, you can start it using the Linux setup utility.
• If using a non-Global Call call control stack, the application should stop RTP sessions by using ipm_Stop(). • Using the dlstop and dlstart commands to stop and then start HMP. • An application should not open more than 1024 files in a process. If an application needs to use many files for media operations, the files should be opened and closed as needed instead of keeping them open throughout the process.
Global Call applications that use the host-based H.323 protocol stack may generate the following error message in the gc_h3r.log file if the application enables the stack to send the PROCEEDING message automatically. ! 22:22:19.393 ! M_SIGNAL ! L_ERROR ! 1 ! << SIGNAL::sendProcceding: RV cmCallSendCallProceeding Failed : [-996] This error message can be ignored. The PROCEEDING message is actually sent. 2.
3. Using a text editor, open the .config file. 4. Locate the [IPVSC] section in the .config file. 5. In the [IPVSC] section, locate the line setparm 0x4005, 49512 !set the rtpPortBase on IPVSC The number 49512 is the default value for this parameter. You may change the beginning of the UDP/RTP port range by first editing this value and saving the .config file. 6. After you have saved the .config file with the new UDP/RTP port value, open the Command Prompt window. 7.
The number 6000 is the default value for this parameter. You may change the beginning of the T.38 service port range by first editing this value and saving the .config file. 6. After you have saved the .config file with the new T.38 service port value, open the Command Prompt window. 7. From the Command Prompt, change the directory to /usr/dialogic/data. 8. Execute fcdgen as follows: /usr/dialogic/bin/fcdgen -f .config -o
the 32 second timeout is reached, a CANCEL will be sent by HMP to the remote site. If there is no response by the remote site to the CANCEL, there will be an additional 32 second timeout, at the end of which, a GCEV_DISCONNECTED event will be reported. Supervised Transfer H.450.2 Supervised Transfer has not been tested with Cisco 5300 running IOS 12.3(8). 2.
Documentation Updates 3. 3 The documentation updates are divided into the following sections, which correspond to the top level categories used in the online documentation navigation page: • Release Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 • Installation Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 • Operating Software Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
In Chapter 2, “System Requirements”, the following section is added: 2.4 Running a Demo Using a Single Channel The default channel license provided with the HMP Linux 1.2 software relies on the correctness of the /etc/hosts file. Invalid entries in this file will render the HMP product non-functional with respect to the default channel license. For example: 1. 127.0.0.1 myhostname << incorrect 2. 127.0.0.1 192.168.124.124 localhost localhost << incorrect 3. 127.0.0.1 192.168.124.
4. Select Red Hat Enterprise Linux AS from the Channel Name list. 5, Select Downloads from the menu selections. 6. After reading and accepting the License Agreement, follow the instructions provided on the Web page to download the four ISO Binary Discs that comprise Update 1. Also, refer to the Red Hat Installation Manual for additional information.
• The IP Media Server (Global Call) Demo Guide (P/N 05-2065-001) has been replaced by the IP Media Server for Host Media Processing Demo Guide (P/N 05-2389-001). • The correct title for the Diagnostics Guide is Intel NetSructure Host Media Processing Diagnostics Guide. 3.2 Installation Documentation This section contains updates to the following documents: • Host Media Processing Software Release 1.2 for Linux Installation Guide 3.2.1 Host Media Processing Software Release 1.
3.3.1 Host Media Processing Software Release 1.2 for Linux License Manager Administration Guide In all instances, the correct procedure for starting the License Manager is: 1. Enter the config.sh command (located in the /usr/dialogic/bin directory) to start the configuration tool. 2. Once inside the configuration tool, press Enter to start hmpconfig and display the License Manager main menu.
3.
disable the active talker feature, which is always enabled. It only disables the notification to the application program. The active talker feature sums the 3 most active talkers in a conference, so that the conversation doesn’t get drowned out when too many people talk at once.
3.4.4 Continuous Speech Processing API for Linux and Windows Operating Systems Programming Guide There are currently no updates to this document. 3.4.5 Device Management API for Windows and Linux Operating Systems Library Reference There are currently no updates to this document. 3.4.6 Fax Software Reference for Linux and Windows There are currently no updates to this document. 3.4.7 Global Call API for Host Media Processing Library Reference There are currently no updates to this document. 3.4.
country_code The country code. Range: 0 to 255; any value x>255 is treated as x%256. extension The extension number. Range: 0 to 255; any value x>255 is treated as x%256. manufacturer_code The manufacturer code. Range: 0 to 65535; any value x>65535 is treated as x%65636. • In Section 4.
3.4.10 IP Media Library API for Host Media Processing Library Reference There are currently no updates to this document. 3.4.11 IP Media Library API for Host Media Processing Programming Guide There are currently no updates to this document. 3.4.12 Standard Runtime Library API for Linux and Windows Operating Systems Library Reference There are currently no updates to this document. 3.4.
Mode: asynchronous or synchronous Description The dx_mreciottdata( ) function records voice data from two TDM bus time slots. The data may be recorded to a combination of data files, memory or custom devices. This function is used for the transaction record feature, which allows you to record two TDM bus time slots from a single channel. Voice activity on two channels can be summed and stored in a single file, device, and/or memory.
• When recording VOX files, the data format is specified in DC_XPB rather than through the dx_setparm( ) function. • Voice data files that are specified in the DX_IOTT structure must be opened with the O_BINARY flag. • If both time slots transmit a DTMF digit at the same time, the recording will contain an unintelligible result.
Example The following example is for Linux applications. #include #include #include #include #include
/* Set up DX_XPB structure */ xpb.wFileFormat = FILE_FORMAT_VOX; xpb.wDataFormat = 0; xpb.nSamplesPerSec = 0L; xpb.wBitsPerSample = 0; /*Set up DV_TPT structure */ dx_clrtpt (&tpt,1); tpt.tp_type = IO_EOT; tpt.tp_termno = DX_MAXDTMF; tpt.tp_length = 1; tpt.tp_flags = TF_MAXDTMF; /* Set up DX_IOTT structure */ iott[0].io_fhandle = fd; iott[0].io_type = IO_DEV; iott[0].io_offset = 0; iott[0].io_length = MAXLEN; iott[0].
main() { int devh1, devh2, devh3; short fd; DV_TPT tpt; DX_IOTT iott[2]; DX_XPB xpb; SC_TSINFO tsinfo; long scts; long tslots[32]; char basebufp[MAXLEN]; /* open two voice channels */ if ((devh1 = dx_open("dxxxB1C1", NULL)) == -1) { printf("Could not open dxxxB1C1\n"); exit (1); } if ((devh2 = dx_open("dxxxB1C2", NULL)) == -1) { printf("Could not open dxxxB1C2\n"); exit (1); } if ((devh3 = dx_open("dxxxB1C3", NULL)) == -1) { printf("Could not open dxxxB1C2\n"); exit (1); } if ((fd = dx_fileopen("file.
/* Set up DX_IOTT structure */ iott[0].io_fhandle = fd; iott[0].io_type = IO_DEV; iott[0].io_offset = 0; iott[0].io_length = MAXLEN; iott[0].
3.4.15 Voice API for Host Media Processing Programming Guide In section 8.7.4 Streaming to Board Hints and Tips, the default bulk queue buffer size is incorrectly described as 32 kbytes, rather than 16 kbytes. The second, fifth and sixth bullets in that section should read as follows: • The bulk queue buffer specifies the size of the buffer used to transfer voice data between the application and HMP.
3.5 Demonstration Software Documentation This section contains updates to the following documents: • Audio Conferencing API for Host Media Processing Demo Guide • Continuous Speech Processing API for Host Media Processing Demo Guide • IP Media Server for Host Media Processing Demo Guide • Global Call API Demo Guide 3.5.1 Audio Conferencing API for Host Media Processing Demo Guide The Audio Conferencing API for HMP Demo is designed to run using a series of four or fewer contiguous channels.
3.5.2 Continuous Speech Processing API for Host Media Processing Demo Guide The Continuous Speech Processing API for HMP Demo is designed to run using a series of four or fewer contiguous channels. The highest channel number in the series must be 120 or lower. Attempts to run the demo using a channel number higher than 120 will cause the demo to fail.
• In Section 4.1, “Starting the Demo” of Chapter 4, “Running the Demo”, the information in the Linux subsection should read: The executable is located in: $(INTEL_DIALOGIC_DIR)/demos/IPMediaServer/Release/ Run the executable from this location by typing: ./IPMediaServer • In Section 5.1.
