Intel 05-2352-005 User Manual
Intel NetStructure® Host Media
Processing Software Release 1.2
for Linux
Release Update
September 2006
05-2352-005
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. EXCEPT AS PROVIDED IN
INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS
ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES
RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER
INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or
nuclear facility applications.
Intel may make changes to specifications and product descriptions at any time, without notice.
This Intel NetStructure
under license and may only be used or copied in accordance with the terms of the license. The information in this manual is furnished for informati onal
use only, is subject to change without notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no
responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this
document.
Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any
means without the express written consent of Intel Corporation.
Copyright © 2004-2006, Intel Corporation
Dialogic, Intel, Intel logo, and Intel NetStructure are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.
* Other names and brands may be claimed as the proper ty of others.
Publication Date: September 2006
Document Number: 05-2352-005
Intel
1515 Route 10
Parsippany, NJ 07054
For Technical Support, visit the Intel Telecom Support Resources website at:
http://developer.intel.com/design/telecom/support
For Products and Services Information, visit the Intel Telecom and Compute Products website at:
http://www.intel.com/design/network/products/telecom
For Sales Offices and other contact information, visit the Buy Telecom Products page at:
http://www.intel.com/buy/networking/telecom.htm
®
Host Media Processing Software Release 1.2 for Linux Release Update as well as the software described in it is furnished
HMP Linux 1.2 Release Update, Rev 05 — September 2006
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. In addition to summarizing issues that were
known as of this release, the Release Update will continue to be updated to serve as the
primary mechanism for communicating new issues that arise after the release date.
Intended Audience
This Release Update is intended for all users of Intel® NetStructure™ Host Media
Processing Software Release 1.2 for Linux.
How to Use This Publication
This Release Update is organized into four sections (click the section name to jump to the
corresponding section):
• Document Revision History: This section summarizes the ongoing changes and
additions that are made to this Release Update after its original release. This section
is organized by document revision and document section.
• Post-Release Developments: This section describes significant changes to the
release subsequent to the general availability release date. For example, the new
features provided in Service Updates are described here.
• Release Issues: This section lists issues that may affect the performance of the HMP
software. The lists include both known issues as well as issues that have been
resolved since the last release. Also included are restrictions and limitations that apply
to this release, as well as notes on compatibility.
• Documentation Updates: This section contains corrections and other changes that
apply to the HMP software release documentation set that could not be made to the
documents prior to the release. The updates are organized by documentation
category and by individual document.
HMP Linux 1.2 Release Update, Rev 05 — September 2006 3
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.intel.com/telecom/support/webcontact.htm
• If you are new to the Intel® telecom products or the latest technology and do not want
to search through volumes of documentation looking for information, use the Learn
About tool to get started quickly. This tool is located:
http://resource.intel.com/telecom/support/documentation/learnabout/index.htm
• For technical support resources:
http://developer.intel.com/design/telecom/support/
• For general information about Intel telecom products:
http://www.intel.com/design/network/products/telecom/index.htm
For information about the features supported in this release, see the Release Guide
that is included as part of the documentation bookshelf for this release.
HMP Linux 1.2 Release Update, Rev 05 — September 2006 4
Document Revision History
This revision history summarizes the changes made in each published version of the
Release Update for Intel
for Linux, which is a document that is subject to updates during the lifetime of the release.
®
NetStructure™ Host Media Processing Software Release 1.2
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. Issues reported prior to
March 27, 2006, will be identified by both numbers. Issues reported after March 27, 2006,
will only have a defect number.
The Release Issues section contains the following changes:
• Added the following items to Table 1, “Issues Resolved in HMP 1.2”, on page 15:
IPY00031503 (PTR 36781), IPY00032235 (PTR 36405), IPY00032236 (PTR 36062),
IPY00033758, IPY00033948.
The Documentation Updates section contains the following changes:
• In the Development Software Documentation section, updated the Audio
Conferencing API for Linux and Windows Operating Systems Library Reference and
the Audio Conferencing API for Linux Operating Systems Programming Guide to
indicate that the MSG_ACTID parameter enables/disables active talker identification
(or notification) and not the active talker feature itself. (IPY00006584 = PTR 36199).
• In the Development Software Documentation section, updated the Global Call IP for
Host Media Processing Technology Guide to correct information on the
gc_MakeCall( ) Variances for IP. (IPY00029956 = PTR 36646). Also revised the
descriptions for the IP_H221NONSTANDARD data structure fields.
Document Rev 04, published December 2005
Updated for Service Update 14.
The Release Issues section contains the following changes:
• Added the following items to Table 1, “Issues Resolved in HMP 1.2”, on page 15:
IPY00032236 (PTR 36062), IPY00032235 (PTR 36405), IPY00023802 (PTR 36484).
Document Rev 03, published June 2005
Updated for Service Update 9.
HMP Linux 1.2 Release Update, Rev 05 — September 2006 5
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).
The Documentation Updates section contains the following changes:
• In the Release Documentation section, for the Release Guide, corrected the Active
Talker information in the Features list and removed dcb_monconf() and
dcb_unmonconf() from the list of Audio Conferencing API functions not supported.
• In the Operating Software Documentation section, added information about starting
the License Manager to the Intel NetStructure
®
Host Media Processing Software
Release 1.2 for Linux License Manager Administration Guide.
• In the Development Software Documentation section, added information about the
dx_mreciottdata( ) function to the Voice API Host Media Processing Library
Reference.
• In the Development Software Documentation section, added information about
Transaction Record to the Voice API for Host Media Processing Programming Guide.
• In the Demonstration Software Documentation section, for Linux, the path names and
executables for starting all of the demos have been changed.
Document Rev 02, published January 2005
Updated for Service Update 6.
Added a new section, Post-Release Developments, that describes the new features
contained in the Service Update and provides information about installing the Service
Update software.
The Release Issues section contains the following changes:
• Added the following items to Table 1, “Issues Resolved in HMP 1.2”, on page 15:
IPY00009304 (PTR 33638), IPY00009801 (PTR 33644), IPY00009082 (PTR 33762),
IPY00009204 (PTR 33894), IPY00030251 (PTR 33919), IPY00010238 (PTR 34148).
• Removed a number of Global Call, IP, and IPML Restrictions and Limitations which
have either been resolved or documented elsewhere.
• Added new Operating System Notes section
The Documentation Updates section contains the following changes:
• In the Release Documentation section, added information about revising the footnote
in Table 1 of the Release Guide.
• In the Release Documentation section, provided new Software Requirements.
HMP Linux 1.2 Release Update, Rev 05 — September 2006 6
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.2 Release Update, Rev 05 — September 2006 7
1.Post-Release Developments
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. . . . . . . . . . . . . . . . . . . . . . . . . 12
• Support for Red Hat Enterprise Linux Update 3 . . . . . . . . . . . . . . . . . . . . . . . . 12
• Support for 120 Low Bit Rate Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
• Transaction Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1
1.1 Service Update for Host Media Processing Software
1.2 for Linux
A Service Update for Intel® NetStructure™ Host Media Processing Software Release 1.2
for Linux is now available. Service Updates provide fixes to known problems, and may also
introduce new functionality. New versions of the Service Update will be released
periodically. This Release Update will document the features in the Service Update.
Depending on whether you already have an Intel® NetStructure™ Host Media Processing
Software Release 1.2 for Linux Service Update installed on your system, the Service
Update will either give you a full install or an update install.
If you do not have Intel® NetStructure™ Host Media Processing Software Release 1.2 for
Linux installed on your system, installing the Service Update will provide a full install of
Intel® NetStructure™ Host Media Processing Software Release 1.2 for Linux.
If you already have an Intel® NetStructure™ Host Media Processing Software Release
1.2 for Linux Service Update installed on your system, installing this Service Update will
provide an update install. The update install adds the latest software to support the
features provided by the Service Update.
1.2 Service Update Software Installation
The following information supercedes that of the Intel® NetStructure™ Host Media
Processing Software Release 1.2 for Linux Installation Guide.
HMP Linux 1.2 Release Update, Rev 05 — September 2006 8
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. See the README file of this HMP release.) or SUSE Linux
Enterprise Server installed (includes kernel version 2.6.8-24).
– A minimum of 512MB of RAM if running without an X Windows System.
– A minimum of 1GB of RAM if running in an X Windows System.
– The machine must be able to resolve its name to an IP address, either using DNS
or the /etc/hosts file. If it cannot resolve its name, HMP will NOT start.
• To install the software, you must have local administrative privileges. Contact your
network administrator to set up administrative privileges as required.
• Uninstall any previous version of the HMP Software (or any Intel® Dialogic® system
release).
Note that the HMP Service Update software has three install scripts:
• One at the top level which installs both runtime components as well as header files
(run this one to be able to compile your application) (recommended)
• One in the redistributable-runtime directory, which installs runtime components (no
header files)
• One in the sdk directory, which installs header files for application development
1.2.2 Order of Procedures
This section describes the order in which the installation procedures must be performed.
If this is a new install, before you use the HMP Software, you must obtain a license file
containing HMP license data. You can obtain a license before or after you install the HMP
Software. A verification license supplied with the software will allow you to run the
verification demo (IP Media Server demo) to confirm that you have installed the HMP
Software properly. However, its features are limited and you may want to obtain another
license. For more information, refer to the Host Media Processing Software Release 1.2
for Linux License Manager Administration Guide.
The basic order of the installation process is as follows:
1. Install the HMP 1.2 Service Update software as described in Section 1.2.3, “Installing
the Service Update”, on page 10.
2. Use the License Manager application to configure the system. This consists of
activating an HMP Software license (refer to the Host Media Processing Software 1.2
for Linux Installation Guide).
HMP Linux 1.2 Release Update, Rev 05 — September 2006 9
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.sh
The following messages are displayed:
-----------------------------------------------------------------------Installing Intel(R) NetStructure(TM) Host Media Processing Software 1.2
Redistributable Runtime for Linux
Initializing install, please wait .......
========================================================================
Intel ® NetStructure ™ Host Media Processing Software 1.2
Redistributable Runtime
INSTALLATION
You will now have the opportunity to install software packages.
After the menu is displayed, enter the package number(s) of the desired
packages, separated by a space. Enter A for all packages, Q to quit.
Package dependencies will be automatically resolved during installation. For
example, selecting a single package will automatically install all packages
required for that selection.
Press ENTER to display the menu packages.
4. Press Enter.
The following menu is displayed:
Item Package Description
---- ------------------------------------------------------------------ 1 Intel(R) NetStructure(TM) Host Media Processing Software (74 MB)
2 SNMP Component Manager (48 MB)
3 Documentation (15 MB)
A Install All (96 MB)
Q Quit Installation
Enter the packages you wish installed, separated by a space, or [A,a,Q,q]:
5. Enter the numbers or letter that correspond to what you want to install. Unless space
or other considerations dictate that you limit what you install, you can just enter a to
install everything.
You will see messages about package installation order, checking for previously
installed packages, checking for sufficient disk space, and installation progress. Then
the installation menu (shown above) will reappear.
6. Enter q to quit and complete the installation process. The following message is
displayed:
Do you wish to run config.sh to configure your system [Yn] ?
HMP Linux 1.2 Release Update, Rev 05 — September 2006 10
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.sh (located in
/usr/dialogic/bin) and follow the procedure for activating a license in Section 2.4
of the Host Media Processing Software Release 1.2 for Linux Installation Guide.
Note: You must run
config.sh at least once after installing the software.
After the configuration has been completed, the following messages are displayed:
Configuration is now complete.
Before using the software, you must ensure that the Intel(R) Dialogic(R)
environment variables are set using the following action:
- Logout and login
The Intel(R) NetStructure(TM) system services will automatically
start every time the system is reboooted.
NOTE: To start and stop system services manually, use the dlstop and
dlstart scripts found in /usr/dialogic/bin.
Do you wish to run the HMP demo on your system [y/n] ?
Enter y to run the HMP Verification Demo. The system will then start the Intel Dialogic
services. After the Intel Dialogic services have been started, the HMP Verification Demo
will start automatically. After the demo has completed, the Intel Dialogic services will be
stopped and the following message should be displayed:
Installation of the Intel(R) NetStructure(TM) Host Media Processing Software 1.2
Redistributable Runtime for Linux was successful.
1.2.4 HMP Verification Demo
The HMP Verification Demo confirms the success of the HMP Software Service Update 1
installation by establishing a basic level of functionality after the installation has been
completed. The demo performs some sanity checks and then waits for a Voice Over
Internet Protocol (VoIP) call to be placed using an H.323 or SIP phone configured to use
G.711. After the connection is made, a message prompt is played to the calling party.
Note: The HMP Verification Demo can only be launched from the
/usr/dialogic/demos/verification_demo location. The demo will fail if launched from a
different directory.
Note: If you are using Microsoft* NetMeeting* with Windows* XP* to place a call, there may be
up to one minute delay from the time a call is placed until the prompt is played.
1.2.5 Environment Variables
The INTEL_DIALOGIC_LIB environment variable (for example,
-L${INTEL_DIALOGIC_LIB} -lgc) should be used for linking to Intel HMP 1.2 Service
HMP Linux 1.2 Release Update, Rev 05 — September 2006 11
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 .config file should be configured
as follows:
• CONFIG_M586 should be disabled and CONFIG_MPENTIUM4 or
CONFIG_MPENTIUMIII should be enabled, depending on your processor
• CONFIG_PREEMPT should be enabled
• CONFIG_HPET_RTC_IRQ should be disabled
Although the .config file can be manually configured, it is recommended that you use the
provided configuration script from the Web site:
http://resource.intel.com/telecom/support/hmp11/index.htm
1.4 Support for Red Hat Enterprise Linux Update 3
In addition to Red Hat Enterprise Linux Update 1, Update 3 is now also supported by the
Service Update.
Note: Update 2 is not supported by this Service Update.
1.5 Support for 120 Low Bit Rate Channels
This Service Update increases the number of low bit rate channels supported to 120. See
the revised Table 2 in Section 3.2.1, “Host Media Processing Software Release 1.2 for
Linux Installation Guide”, on page 28.
1.6 Transaction Record
Transaction Record enables the recording of a two-party conversation by allowing two
time slots from a single channel to be recorded. This feature is useful in call center
applications where it is necessary to archive a verbal transaction or record a live
conversation. Voice activity on two channels can be summed and stored in a single file or
combination of files, devices, and memory.
The voice API function dx_mreciottdata() is used to implement the transaction record
feature. It is an extension of the dx_reciottdata() function.
HMP Linux 1.2 Release Update, Rev 05 — September 2006 12
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.2 Release Update, Rev 05 — September 2006 13
2.Release Issues
This chapter includes the following topics that relate to release issues:
• Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
• Restrictions and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
• Compatibility Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
• Operating System Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.1 Issues
The following table lists issues that can affect the performance of the software supported
®
in Intel
following information is provided for each issue:
Issue Type
NetStructure™ Host Media Processing Software Release 1.2 for Linux. The
This classifies the type of release issue based on its effect on users and its
disposition:
• Known - An issue that affects the performance of the Host Media Processing
(HMP) Software. This category includes interoperability issues and compatibility
issues. Known issues are still open but may or may not be fixed in the future. See
Ta bl e 2 .
• Resolved - An issue that was resolved in a previous release of the product
(usually either fixed or documented). See Table 1.
2
Defect Number
A unique identification number that is used to track each issue reported via a formal
Change Control System. Additional information on defects may be available via the
Defect Query tool at http://membersresource.intel.com/defects/ (If you select this link,
you will be asked to login. If you do not have a member login, you may create one.)
For issues without an associated defect number, this column contains “NA” (Not
Applicable).
PTR Number
Problem Tracking Report Number from problem tracking system used prior to March
27, 2006. For customer convenience, both the PTR number and the corresponding
defect number are shown. For issues reported after March 27, 2006, this column
contains “--” and only the defect number is used to track the issue. (The Defect Query
tool also provides the ability to search by legacy PTR number.)
Product or Component
The product or component to which the problem relates, typically one of the following:
• a system-level component; for example, HMP 1.2 Linux
• a software product; for example, the Global Call Library
• a software component; for example, Continuous Speech Processing
HMP Linux 1.2 Release Update, Rev 05 — September 2006 14
Loading...