Intel Dialogic System Release 5.1 Feature Pack 1 and 2 for Linux Operating Systems on Intel Architecture Release Notes

Intel Dialogic System Release 5.1 Feature Pack 1 and 2 for Linux Operating Systems on Intel Architecture Release Notes Copyright 2004-2007 Intel Corporation 05-2071-025

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, or life sustaining applications. Intel may make changes to specifications and product descriptions at any time, without notice. This document as well as the software described in it is furnished 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 informational 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 express written consent of Intel Corporation. Copyright 2004-2007 Intel Corporation. Celeron, Dialogic, Intel, Intel Centrino, Intel logo, Intel NetMerge, Intel NetStructure, Intel Xeon, Intel XScale, IPLink, and Pentium 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 property of others. Publication Date: January, 2007 Document Number: 05-2071-025 Intel Converged Communications, Inc. 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 Products website at: http://www.intel.com/design/network/products/telecom For Sales Offices and other contact information, visit the Where to Buy Intel Telecom Products page at: http://www.intel.com/buy/wtb/wtb1028.htm 2

Table of Contents Table of Contents Table of Contents...3 Document Revision History...6 About This Information...11 Purpose...11 Intended Audience...11 How to Use This Information...11 Related Information...12 Release Overview...13 Feature Pack 2 Highlights...13 Feature Pack 1 Highlights...13 Product Naming Changes...13 System Requirements...15 Hardware Requirements...15 Software Requirements...15 Requirements for Global Call Protocols Package with Service Update...16 SMP...16 Third-Party Files Provided with the System Release...16 Installation and Configuration...18 Installing Hardware...18 Configuring Hardware...18 Installing Feature Pack 2...18 Doing a Clean Install of System Release 5.1 Feature Pack 2 for Linux...18 Upgrading from Feature Pack 1 or from a Previous Feature Pack 2 Service Update...21 Upgrading from System Release 5.1...22 Uninstalling Feature Pack 2...23 New Features in Feature Pack 2...25 Notification of Layer 1 Alarm Events on SS7 Boards...25 Feature Description...25 Supported Boards...25 GCAMS Support...25 Example...27 Feature Limitations, Caveats and Restrictions...28 Documentation...28 Global Call Support for Time Slots on SS7 Boards Running in DTI Mode...28 Feature Description...28 Supported Boards...28 Configuration...28 Feature Limitations, Caveats and Restrictions...32 Documentation...32 Setting Data Transfer Buffer Size below 1K for Springware Boards...33 Feature Description...33 Modifying the voice.prm File...33 Setting the Data Transfer Buffer Size with dx_setchxfercnt( )...34 Using MIME Bodies in SIP Messages (SIP-T)...34 SIP MIME Overview...34 Enabling and Configuring the SIP MIME Feature...35 Getting MIME Information...36 Sending MIME Information...40 MIME Error Conditions...43 SIP Outbound Proxy Support...43 Call Control Library Initialization...43 Setting a SIP Outbound Proxy...43 Support for D/4PCIU4S Board...44 3

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Streaming to Board...44 Streaming to Board Functions...44 Implementing Streaming to Board...45 Streaming to Board Hints and Tips...45 Circular Logging Capability for gc_h3r.log...46 Fax with Voice Support for Intel NetStructure DM/V960A-4T1 Boards...46 Fax Support for Intel NetStructure DM/V960A-4T1 Boards...47 ETSI Compliant FSK for Intel NetStructure DM/V1200A-4E1 Boards...47 Firmware Assert Notification for JCT Boards...48 Support for CT Bus Clocking and Distributed Event Services APIs...48 New Features...48 Other Software Changes...49 Release Documentation...49 Restrictions and Limitations...49 Programming Requirements and Guidelines...49 Send and Receive FSK Data on Springware Boards...52 DPNSS Support on D/300JCT and D/600JCT Boards...52 New Features in Feature Pack 1...53 Features by Product...53 New Intel NetStructure DM/IP Board Features...53 New Intel Dialogic D/4PCIU and D/4PCIUF Products...53 Development Software...54 New Global Call API Library Features...54 New IP Media Library API Features...54 New or Enhanced Demonstration Programs...55 New Protocol Stacks...55 Supported Hardware...57 Boards Scheduled To Be Retired...57 Retired Boards...58 Post-Release Developments...59 End of Support for cpci Boards...59 End Support Product Change Notification...59 Resolved Issues...60 Restrictions and Limitations...70 Development Software...70 Host-Based H.323 Protocol Stack...70 D/160SC-LS...70 D/600JCT-2E1 and D/600SC-2E1...70 Global Call...70 Intel NetStructure DM/IP Products...71 Compatibility Issues When Using Embedded Stack Applications on Host-Based Stack...72 DM/IP Media Load Restrictions...73 Interoperability Issues...74 IP Demos...74 IP Media API...74 RFC 2833 Support...75 Intel NetStructure DM/V Products...75 ISDN...75 JCT Series Boards...76 PCI Board Identification...76 R4 Libraries...76 SNMP...76 Springware Boards...76 Springware Fax...76 Starting Dialogic System Services...77 System Tuning for Heavy Record/Play Loads...77 UDD...78 Voice...78 Known Issues...79 4

Table of Contents Release Documentation...82 Documentation Highlights...82 System Release Documentation...82 Development Software Documentation...83 Operating Software Documentation...83 Documentation Updates...85 System Release Software Documentation...85 System Release 5.1 for Linux Release Guide...85 System Release 5.1 for Linux Software Installation Guide...85 Development Software Documentation...86 Compatibility Guide for Dialogic R4 API on DM3 Products...87 Continuous Speech Processing API Library Reference...87 Continuous Speech Processing API Programming Guide...87 Digital Network Interface Software Reference...87 Global Call API for Linux and Windows Library Reference...90 Global Call API for Linux Programming Guide...91 Global Call E-1/T-1 CAS/R2 Technology User s Guide for Linux and Windows...91 Global Call IP over Embedded Stack Technology User's Guide...92 Global Call IP over Host-based Stack Technology User's Guide...106 Global Call ISDN Technology User s Guide for Linux and Windows...110 Global Call SS7 Technology User's Guide for Linux Operating Systems...111 IP Media Library API Library Reference...112 IP Media Library API Programming Guide...113 ISDN Software Reference...113 MSI/SC Software Reference for Linux and Windows...114 PBX Integration Board User's Guide...115 Voice Software Reference: Features Guide for Linux...115 Voice Software Reference: Programmer s Guide for Linux...116 Voice Software Reference: Standard Runtime Library...127 Operating Software Documentation...127 DM3 Configuration File Reference...127 5

Document Revision History Document Revision History Unlike other documents associated with the System Release 5.1 Feature Pack 1 and 2 for Linux, the Release Notes is a document that is subject to updates during the lifetime of the release. Therefore, this section provides an overview of changes that have been made since the previous version. Version Date Description of Changes 25 1/18/07 Updated for Feature Pack 2 Service Update 76. In the Resolved Issues section, added the following defects/ptrs: IPY00007470 (PTR 32437), IPY00028657 (PTR 36577), IPY00033561. In the Documentation Updates section, added IPY00006024 (PTR 29612) under PBX Integration Board User's Guide. 24 12/21/06 Updated for Feature Pack 2 Service Update 75. In the Resolved Issues section, added the following defects/ptrs: IPY00010760 (PTR 36647), IPY00010929 (PTR 36497), IPY00011037 (PTR 36677), IPY00034406, IPY00034559, IPY00034627, IPY00034841, IPY00035831. 23 9/20/06 Updated for Feature Pack 2 Service Update 74. In the Resolved Issues section, added the following defects/ptrs: IPY00006790 (PTR 35137), IPY00034404. 22 9/1/06 Updated for Feature Pack 2 Service Update 73. In the Resolved Issues section, added the following defect/ptr: IPY00034546. 21 8/23/06 Updated for Feature Pack 2 Service Update 72. In the New Features in Feature Pack 2 section: Added Notification of Layer 1 Alarm Events on SS7 Boards. Added Global Call Support for Time Slots on SS7 Boards Running in DTI Mode. In the Resolved Issues section, added the following defects/ptrs: IPY00031588 (36770), IPY00033499, IPY00034105 In the Documentation Updates section: Added updates under Global Call SS7 Technology User's Guide for Linux Operating Systems for Notification of Layer 1 Alarm Events on SS7 Boards and Notification of Layer 1 Alarm Events on SS7 Boards. Added updates under Global Call API for Linux and Windows Library Reference for Notification of Layer 1 Alarm Events on SS7 Boards. Added IPY00006258 (PTR# 36353) under PBX Integration Board User's Guide. 20 7/6/06 Updated for Feature Pack 2 Service Update 71. In the Resolved Issues section, added the following defects/ptrs: IPY00006562 (PTR 35636), IPY00006633 (PTR 36697), IPY00006846 (PTR 36711), IPY00028207 (PTR 36310), IPY00028530 (PTR 36371), IPY00030882 (PTR 36057), IPY00031529 (PTR 36814), IPY00031535 (PTR 36852), IPY00031536 (PTR 36637), IPY00031780 (PTR 6576), IPY00032240 (PTR 36740), IPY00032244 (PTR 36750), IPY00032247 (PTR 36698), IPY00032266 (PTR 36735), IPY00032794, IPY00032796, IPY00032803, IPY00033185. Revised information about IPY00028341 (PTR 35790) - resolved in Service Update 71, not Service Update 52. In the Documentation Updates section, added IPY00006588 (PTR# 36210) under DM3 Configuration File Reference. 19 2/28/06 Updated for Feature Pack 2 Service Update 67. In the Resolved Issues section, added the following PTRs: 35658, 36528. Also added 35570 (fixed in Service Update 61). 6

Document Revision History Version Date Description of Changes In the Documentation Updates section, added PTR# 36726 under Global Call E-1/T-1 CAS/R2 Technology User s Guide for Linux and Windows. 18 2/16/06 Updated for Feature Pack 2 Service Update 63. In the New Features in Feature Pack 2 section, added Setting Data Transfer Buffer Size below 1K for Springware Boards. In the Post-Release Developments section, updated the section about end of support for the board-based embedded H.323 IP stack on the DM/IP board family to indicate that use of the embedded H.323 stack will not operate correctly on new Service Updates after Service Update 63. In the Resolved Issues section, added the following PTRs: 35512, 35746, 36134, 36319, 36329, 36587, 36640 In the Documentation Updates section, under Voice Software Reference: Programmer s Guide for Linux, revised the description of the dx_setchxfercnt( ) function because of a new feature in the Service Update. 17 12/9/05 Updated for Feature Pack 2 Service Update 61. In the New Features in Feature Pack 2 section, added Using MIME Bodies in SIP Messages (SIP-T). In the Resolved Issues section, added the following PTRs: 36196, 36321, 36385, 36413 16 11/14/05 Updated for Feature Pack 2 Service Update 60. Added update about end of support for cpci boards in the Post-Release Developments section and Documentation Updates section for the Release Guide. In the Resolved Issues section, added the following PTRs: 33750, 34095, 34284, 34814, 35133, 35440, 35596, 35693, 35696, 35797, 35832, 35886, 35921, 35937, 35944, 36020, 36063, 36085, 36159, 36204, 36213, 36248, 36266 15 10/21/05 Added PTR# 34673 in the Documentation Updates section under Voice Software Reference: Features Guide for Linux. 14 9/2/05 Updated for Feature Pack 2 Service Update 52: In the Resolved Issues section, added the following PTRs: 32712, 34476, 34800, 35011, 35104, 35154, 35232, 35251, 35270, 35566, 35670, 35671, 35775, 35790, 35799, 35826 13 8/12/05 Updated for Feature Pack 2 Service Update 50: In the System Requirements and Installation and Configuration sections, removed restriction that Springware PDK users must use kernel version 2.4.18-5. (This restriction is no longer applicable in Feature Pack 2 because the Linux driver issue caused by SMP has been resolved.) In the System Requirements section, under Requirements for Global Call Protocols Package with Service Update, changed references to Global Call Protocols Version 4.3 to say 4.3 or later. In the New Features in Feature Pack 2 section, added SIP Outbound Proxy Support. In the Resolved Issues section, added the following PTRs: 32759, 34320, 35292, 35456, 35558 In the Documentation Updates section, added PTR# 32531 and PTR# 25692 under Software Installation Guide. In the Documentation Updates section, added PTR# 34244 under Continuous Speech Processing API Library Reference and Continuous Speech Processing API Programming Guide. In the Documentation Updates section, added PTR# 33798 under Digital Network Interface Software Reference. In the Documentation Updates section, added PTR# 33852 under Global Call API for Linux and Windows Library Reference. In the Documentation Updates section, added a correction for the GCLIB_MAKECALL_BLK data structure reference page under Global Call API for Linux 7

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Version Date Description of Changes and Windows Library Reference. In the Documentation Updates section, added PTR# 35021 under Global Call API for Linux and Windows Library Reference and Global Call API for Linux Programming Guide. In the Documentation Updates section, added PTR# 33495 under Global Call IP over Host-based Stack Technology User's Guide, IP Media Library API Library Reference and IP Media Library API Programming Guide. 12 5/23/05 Updated for Feature Pack 2 Service Update 45: In the System Requirements section, provided additional information about the Requirements for Global Call Protocols Package with Service Update. Added the D/4PCIUF board in the New Features in Feature Pack 1 section (PTR# 35122). (This board is supported in Feature Pack 1 and Feature Pack 2.) In the Resolved Issues section, added the following PTRs: 33541, 34160, 34269, 34405, 34947, 34999, 35007, 35132 Added PTR# 29448 in the Documentation Updates section under Global Call E-1/T-1 CAS/R2 Technology User's Guide. 11 5/16/05 Added update about end support for board-based embedded H.323 IP stack feature in the Post Release Developments section and Documentation Updates section for the Release Guide. Added PTR# 32413, PTR# 32705, and PTR# 33498 in the Documentation Updates section under IP Media Library API Library Reference. Added PTR# 33077 in the Documentation Updates section under Global Call ISDN Technology User's Guide. Added PTR# 35050 in the Documentation Updates section under Global Call E-1/T-1 CAS/R2 Technology User's Guide. Added PTR# 34951 in the Documentation Updates section under Voice Software Reference: Programmer's Guide for Linux. Added PTR# 32632 in the Known Problems section under "Global Call IP Call Control". 10 4/8/05 Added PTR# 29455 in the Documentation Updates section under Global Call IP over Hostbased Stack Technology User's Guide. 9 4/1/05 Updated for Feature Pack 2 Service Update 42: In the System Requirements section, added information about support for Intel Hyper- Threading Technology and Linux Symmetric Multi-Processor (SMP) machines. In the New Features in Feature Pack 2 section, added Support for D/4PCIU4S Board. In the Resolved Issues section, added the following PTR: 34121 In the Documentation Updates section for the Global Call API Library Reference, Global Call E-1/T-1 CAS/R2 Technology User s Guide, and Global Call ISDN Technology User s Guide, indicated that GCAMS functions are supported on DM3 boards with Feature Pack 2. 8 3/8/05 Updated for Feature Pack 2 Service Update 41: In the Resolved Issues section, added the following PTRs: 29895, 33434 7 2/18/05 Updated for Feature Pack 2 Service Update 39: In the System Requirements section, added Requirements for Global Call Protocols Package with Service Update. In the New Features in Feature Pack 2 section, added Streaming to Board and Circular Logging Capability for gc_h3r.log. In the Resolved Issues section, added the following PTRs: 34035, 34047, 34236, 34241, 34345, 34393, 34629 In the Release Documentation section, added CT Bus Clocking API for Linux Software Reference and Distributed Event Services API for Linux Software Reference. In the Documentation Updates section, under Voice Software Reference: Programmer s Guide for Linux, added information about the new streaming to board functions, data 8

Document Revision History Version Date Description of Changes structure, and events. 6 12/31/04 Updated for Feature Pack 2 Service Update 34: In the Release Overview section, added Feature Pack 2 Highlights. Updated the Installation and Configuration section to give information about installing Feature Pack 2. Added New Features in Feature Pack 2 section. In the Resolved Issues section, added the following PTRs: 29866, 30296, 30437, 30875, 31404, 31425, 31954, 32019, 32089, 32143, 32156, 32408, 32465, 32476, 32478, 32540, 32589, 32608, 32614, 32719, 32720, 32723, 32809, 32931, 32979, 33011, 33071, 33444, 33470, 33501, 33511, 33581, 33690, 33752, 33822, 33884, 34053, 34146, 50070, 50091 5 6/7/04 Added PTR# 32281 in the Known Issues table under "Host Library". Added PTR# 17965 in the Documentation Updates section under PBX Integration Board User's Guide. Added PTR# 30759/30761 in the Documentation Updates section under Global Call IP over Host-based Stack Technology User's Guide. Added PTR# 31494 in the Documentation Updates section under Compatibility Guide for the Dialogic R4 API on DM3 Products. Added PTR# 27088 and PTR# 31455 in the Documentation Updates section under System Release 5.1 for Linux Release Guide. For PTR# 31455, removed the line "Learn Mode API and Tone Set File download support" from the New Features section under "New Intel Dialogic D/4PCIU Product". Added PTR# 31812/32282 in the Documentation Updates section under DM3 Configuration File Reference. Added PTR# 24644 in the Documentation Updates section under ISDN Software Reference. Added PTR# 32857 in the Documentation Updates section under Compatibility Guide for the Dialogic R4 API on DM3 Products. 4 3/25/04 Added PTR# 29852 in the Documentation Updates section under PBX Integration Board User's Guide. Added PTR# 31851 in the Restrictions & Limitations section under "Intel NetStructure DM/IP Products". Added PTR# 31734 in the Restrictions & Limitations section under "Host-Based H.323 Protocol Stack". Added PTR# 31211/31213 in the Documentation Updates section under Global Call IP over Embedded Stack Technology User s Guide and Global Call IP over Host-based Stack Technology User s Guide. Added PTR# 31348 in the Documentation Updates section under Software Installation Guide. Added PTR# 25745 in the Documentation Updates section under ISDN Software Reference. Added doc correction in the Documentation Updates section under ISDN Software Reference. Added PTR# 26083 in the Restrictions & Limitations section under "Springware Boards". Added PTR# 26891 in the Documentation Updates section under Voice Software Reference: Standard Runtime Library. Added PTR# 28854 in the Documentation Updates section under Global Call ISDN Technology User's Guide. Added PTR# 28589/27774 in the Documentation Updates section under Compatibility Guide. 9

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Version Date Description of Changes Added PTR# 32418 in the Documentation Updates section under Global Call ISDN Technology User's Guide. 3 10/17/03 Documented PTR# 31134 in the Restrictions & Limitations section under "Intel NetStructure DM/V Products". Added PTR# 31145 in the Documentation Updates section for the Compatibility Guide for the Dialogic R4 API on DM3 Products and Global Call API for Linux Programming Guide. Added PTR# 31245 in the Known Problems section. Documented PTR# 26398 and PTR# 28562 in the Restrictions & Limitations section under "Intel NetStructure DM/IP Products". Documented PTR# 30091 in the Restrictions & Limitations section under "JCT Series Boards". Added PTR# 30887 in the Documentation Updates section for the Global Call API for Linux and Windows Library Reference. Documented PTR# 30950 in the Restrictions & Limitations section under "D/600JCT-2E1 and D/600SC-2E1". Documented PTR# 31043 in the Documentation Updates section under DM3 Configuration File Reference. 2 7/14/03 Added PTR# 30662 to the Known Issues section. "While running CSP, after a ec_stream is issued, the application fails to get the TEC_STREAM event and even after calling ec_stopch( ), the channel fails to terminate the ec_stream and the TEC_STREAM is not seen. Subsequent CSP calls to this channel results in an error indicating that the channel is busy and fails to recover from this error. The channel is essentially stuck. A dx_close should be able to recover this channel from this state." 1 7/2/03 Initial Version of document. 10

About This Information About This Information This section contains information about the following topics: Purpose Intended Audience How to Use This Information Related Information Purpose These release notes provide information about the products and features contained Intel Dialogic System Release Version 5.1 Feature Pack 1 and 2 for Linux Operating Systems on Intel Architecture as well as any issues surrounding the use of those products and features. Intended Audience These release notes are intended for the following types of customers: Distributors System Integrators Toolkit Developers Independent Software Vendors (ISVs) Value Added Resellers (VARs) Original Equipment Manufacturers (OEMs) How to Use This Information These release notes are designed so that information can be found quickly. The following sections are included: Release Overview - provides a high-level overview of the products and features that are newly supported in Feature Pack 1 and 2. System Requirements - describes what hardware and software products are needed in order to use this release. Installation and Configuration - describes how to install and configure your system to use this release. New Features in Feature Pack 2 - describes the new features in Feature Pack 2. New Features in Feature Pack 1 - describes the new features in Feature Pack 1. Post-Release Developments - describes changes to the system release subsequent to the general availability release date. Resolved Issues - lists problems that have been resolved in this release. Restrictions and Limitations - discusses restrictions and/or limitations of the products provided in this release. Known Issues - lists the issues that could not be fixed prior to shipment. Release Documentation - provides information about the documentation for this release. Documentation Updates - describes changes to the supporting documentation listed in the original system release. 11

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Related Information For information about the content of System Release 5.1 for Linux, see the System Release 5.1 for Linux Release Guide, which contains information about new software features, supported hardware, and documentation for that release. 12

Release Overview Release Overview This section provides a high-level overview of the products and features that are newly supported in System Release 5.1 Feature Pack 1 and 2 for Linux. This release enables customers to build and deploy higher-density, more cost-effective solutions. In addition to the new features, many known problems have been resolved. Feature Pack 2 Highlights Feature Pack 2 for System Release 5.1 for Linux is now available. Feature Pack 2 will have Service Updates, which will be released periodically. Service Updates provide fixes to known problems, and may also introduce new functionality. The following new features are supported: Setting Data Transfer Buffer Size below 1K for Springware Boards Using MIME Bodies in SIP Messages (SIP-T) SIP Outbound Proxy Support Support for D/4PCIU4S Board Streaming to Board Circular Logging Capability for gc_h3r.log Fax with Voice Support for Intel NetStructure DM/V960A-4T1 Boards Fax Support for Intel NetStructure DM/V960A-4T1 Boards ETSI Compliant FSK for Intel NetStructure DM/V1200A-4E1 Boards Firmware Assert Notification for JCT Boards Support for CT Bus Clocking and Distributed Event Services APIs Send and Receive FSK Data on Springware Boards DPNSS Support on D/300JCT and D/600JCT Boards For further information about these features, see the New Features in Feature Pack 2 section later in this document. Feature Pack 2 can be installed on a clean system (i.e., without an earlier version of System Release 5.1 for Linux) or it can be installed over System Release 5.1 for Linux (with or without Feature Pack 1). For installation instructions, see the Installation and Configuration section later in this document. Feature Pack 1 Highlights System Release 5.1 Feature Pack 1 for Linux supports the following new features: New Intel NetStructure DM/IP Series Features New Universal PCI Supported Hardware for the D/4PCI New Global Call API Library Features New IP Media Library Features New Protocol Stacks Product Naming Changes As you use the documentation supporting this release, you will note certain discrepancies regarding the product and feature names. Many of the products supported by this release were re-branded as Intel products after System Release 5.1 for Linux became generally available. Many documents that have been revised since that release reflect the new brand and product names, while documents that are specific to System Release 5.1 and this feature pack release may still contain the older branding and naming conventions. The following table indicates old and new names for many of the affected products in an effort to reduce the confusion caused by the 13

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes branding transition. Old Product Name New Product Brand and Name BoardWatch SNMP software DM3 Fax Intel NetStructure DM/F boards DM3 IPLink Intel NetStructure DM/IP boards DM3 MediaSpan Intel NetStructure DM/V-A, DM/V, DM/N, and DM/T boards DM3 VFN Intel NetStructure DM/VF boards Septel Intel NetStructure SS7 boards Springware Intel Dialogic boards NOTE: The term "Septel" has been removed from the documentation where possible. However, for technical reasons (mostly relating to backward compatibility), the term continues to be used in the software. 14

System Requirements System Requirements The basic requirements to install and run this feature pack are described in the following categories: Hardware Requirements Software Requirements Requirements for Global Call Protocols Package with Service Update NOTE: Please refer to the Red Hat* website (http://www.redhat.com) for additional information about system requirements. Hardware Requirements The minimum hardware configuration for this feature pack is: 500 MHz Intel Pentium processor 128 MB RAM for a system that contains less than three Intel NetStructure boards 512 MB RAM for a system that contains three or more Intel NetStructure boards 500 MB free space on hard disk CD-ROM drive VGA display NOTE: For system requirements regarding the use of Intel NetStructure SS7 boards, please refer to the website located at: http://www.intel.com/network/csp/products/7162web.htm The recommended hardware configuration for this release is: 850 MHz or faster Intel Pentium processor 512 MB RAM 600 MB free space on hard disk CD-ROM drive VGA display SCSI Disk Drive NOTE: As described in the Restrictions and Limitations section, applications running Global Call on host-based H.323 and SIP stacks for 120+ channels should have at least 512MB of RAM. This system release supports Intel Hyper-Threading Technology (HT Technology) and Linux Symmetric Multi- Processor (SMP) machines. Multi-Threaded Applications running on HT Technology enabled platforms and other SMP machines will interoperate safely with this system release. Software Requirements This feature pack supports both Red Hat Linux 7.2 and 7.3. Below are the special kernel versions and LiS versions that support each Red Hat Linux version. For your convenience, two kernel versions and a version of LiS have been provided on the CD along with the system release. Refer to Third-Party Files Provided with the System Release (below) for details. Red Hat Linux 7.2 Red Hat Linux 7.3 kernel version 2.4.20-18.7 2.4.20-18.7 compiler version gcc version 2.96 20000731 (Red Hat Linux 7.1 2.96-98) glibc version 2.2.4 2.2.5-27 LiS version 2.15.2 2.15.2 gcc version 2.96 20000731 (Red Hat Linux 7.3 2.96-110) 15

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Requirements for Global Call Protocols Package with Service Update The Feature Pack 2 Service Update now contains.prm files for use with the Global Call Protocols Package. These.prm files supersede some of the.prm files that were provided with Global Call Protocols Version 4.2 and earlier, which are now outdated. Global Call Protocols Version 4.2 (or earlier) will continue to work on the latest Service Update builds as it has been working with earlier builds. However, it is recommended that you use Global Call Protocols Version 4.3 (or later) with the Service Update. With Global Call Protocols Version 4.3 and later, the.prm files are no longer included in the Global Call Protocols Package, and the latest versions of.prm files will always be available via the Service Update. (If you continue to use Global Call Protocols Version 4.2 or earlier, the outdated.prm files in the Global Call Protocols Package will overwrite the.prm files in the Service Update.) NOTE:.prm files are used with Springware boards only, not with DM3 boards. You must upgrade to Global Call Protocols Version 4.3 (or later) if you are using Springware boards with any of the following.prm files: au_300.prm be_300.prm cl_300.prm cn_300.prm fi_300.prm hu_300.prm id_300.prm it_300.prm nl_300.prm uk_300.prm us_240.prm To upgrade from an earlier version of Global Call Protocols (e.g., Version 4.2), you must uninstall it, reinstall the Feature Pack 2 Service Update, and then install Global Call Protocols Version 4.3 (or later). SMP This feature pack is SMP safe. Third-Party Files Provided with the System Release Intel may include certain third party software (e.g., drivers, utilities, operating system components, etc.) in a separate directory or directories in the Intel software provided on the Intel CD ROMs. Any and all third party software that is included is subject to the terms and conditions of any third party licenses which may be supplied with such third party software or herein or in the Release Notes, and installation, use and/or further distribution will be subject to such third party licenses. Some third party software and some of the Intel software components may be subject to open source license provisions, including the GPL and installation, use and/or further distribution of such third party software and Intel software components are subject to the respective open source license under which it is provided. The GPL license is included in the same directory on the CD ROMs as the software to which the GPL license applies. Intel expressly disclaims liability of any kind with respect to installation, use or distribution of third party software. In particular, certain Linux software subject to the GPL may not be the most recent version thereof and may contain bugs or errors which were corrected in later versions and also may not include functionality and features which were added in later versions. Intel advises that such Linux software be upgraded to the most recent version and has indicated such upgrade requirements throughout this document and/or in the Release Notes. The following third-party files have been provided along with the system release. They are provided for your convenience and are not supported in any way by Intel. They are located on the CD as follows: 2.4.18-5 2.4.18-5/kernel-2.4.18-5.i686.rpm 2.4.18-5/kernel-smp-2.4.18-5.i686.rpm 16

System Requirements 2.4.18-5/kernel-source-2.4.18-5.i386.rpm 2.4.18-5/GPL 2.4.20-18 2.4.20-18/kernel-2.4.20-18.7.i686.rpm 2.4.20-18/kernel-smp-2.4.20-18.7.i686.rpm 2.4.20-18/kernel-source-2.4.20-18.7.i386.rpm 2.4.20-18/modutils-2.4.18-3.7x.i386.rpm 2.4.20-18/GPL LiS LiS/COPYING LiS/LiS-2.15.2.tgz NOTE: Kernel binary RPMs are for use with Intel Pentium III, Pentium 4, and Celeron processors. Customers using Intel Pentium II and other processors should get kernel binary RPMs from the Red Hat website or build from source. You can use the command uname -p to find out which processor the system is using. The system will return 686 if it is using an Intel Pentium III, Pentium 4, or Celeron processor and 586 if it is using an Intel Pentium II or other processor. 17

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Installation and Configuration This section provides information about the following topics: Installing Hardware Configuring Hardware Installing Feature Pack 2 Uninstalling Feature Pack 2 Installing Hardware Install the boards in the chassis according to the instructions on the Quick Install card included with each board. Configuring Hardware First install the software according to the instructions below. Then configure the boards you will be using in your system according to the instructions in the System Release 5.1 for Linux Software Installation Guide. Installing Feature Pack 2 NOTE: This information contained in this section supersedes the information found in the System Release 5.1 for Linux Installation Guide. This section provides information about the following installation scenarios: Doing a Clean Install of System Release 5.1 Feature Pack 2 for Linux (i.e., without an earlier version of System Release 5.1 for Linux already installed) Upgrading from Feature Pack 1 or from a Previous Feature Pack 2 Service Update Upgrading from System Release 5.1 for Linux (without Feature Pack 1) Doing a Clean Install of System Release 5.1 Feature Pack 2 for Linux 1. Install Red Hat Linux version 7.2 or 7.3. If SNMP support is desired, do not use the ucd-snmp RPM files contained in the Red Hat distribution. 2. Log into the system as root. 3. Upgrade the following RPMs to the versions listed below by using rpm Uvh <rpmname>. The packages must be upgraded in the order shown. SMP users should install SMP versions whenever available. For your convenience, two kernel versions and a version of LiS have been provided along with the system release. Refer to Third-Party Files Provided with the System Release (above) for details. For Red Hat 7.2 Users modutils- 2.4.18-3.7x.i386.rpm kernel- 2.4.20-18.7.i686.rpm kernel-smp-2.4.20-18.7.i686.rpm kernel-source- 2.4.20-18.7.i386.rpm For Red Hat 7.3 Users kernel- 2.4.20-18.7.i686.rpm kernel-smp-2.4.20-18.7.i686.rpm kernel-source- 2.4.20-18.7.i386.rpm NOTE: Kernel binary RPMs are for use with Intel Pentium III, Pentium 4, and Celeron processors. Customers using Intel Pentium II and other processors should get kernel binary RPMs from the Red Hat website or build from source. You can use the command uname -p to find out which processor the system is using. The system will return 686 if it is using an Intel Pentium III, Pentium 4, or Celeron processor and 586 if it is using an Intel Pentium II or other processor. 4. Edit Boot loader (only for Linux Loader [LILO] users): edit /etc/lilo.conf by replacing all occurrences of the previous kernel version number to 2.4.20-18.7. For example: image=/boot/vmlinuz-2.4.9-13 ==> image=/boot/vmlinuz-2.4.20-18.7 18

5. Before rebooting, LILO users must run /sbin/lilo and make sure it executes correctly. 6. After you have upgraded the kernel, reboot in the new kernel. 7. Copy the LiS-2.15.2.tgz file included on the CD or obtained from the LiS website (http://www.gcom.com/home/linux/lis/download.html) into the /usr/src directory. 8. Install LiS 2.15.2 as follows: cd /usr/src tar xvzf LiS-2.15.2.tgz cd LiS-2.15 Installation and Configuration Edit the LiS Configure File CONDITIONAL: Only users of the 2.4.20-18.7 kernel should edit the LiS Configure file as shown in the Note 1 below. make Press <Enter> to use the default response to all configuration questions. make install NOTE 1: Edit the LiS Configure File: There are known issues with LiS-2.15.2 and the 2.4.20-18.7 kernel on systems where the kgcc, gcc3, or egcs compilers have been installed. One of the problems seen is that streams.o panics and results in a link_path_walk oops message. The workaround for this problem is using gcc instead of kgcc, gcc3, or egcs. Following outlines the steps to compile LiS with gcc: 1) Edit the /usr/src/lis-2.15/configure file 2) Add the two bold lines to force gcc to be used: if [ "$TARGET" = "l" -a -x /usr/bin/kgcc ]; then CC_NAME=kgcc CC_OPTIMIZE=-O3 elif [ -x /usr/bin/gcc3 ]; then CC_NAME=gcc3 CC_OPTIMIZE=-O3 elif [ -x /usr/bin/egcs ]; then CC_NAME=egcs CC_OPTIMIZE=-O3 else CC_NAME=gcc CC_OPTIMIZE=-O2 fi #ADDED TO SUPPORT 2.4.20-18.7 KERNEL ######################## CC_NAME=gcc # added to support 2.4.20-18.7 kernel CC_OPTIMIZE=-O2 # added to support 2.4.20-18.7 kernel ########################################################## NOTE: More detailed instructions can be found at: http://www.gcom.com/home/linux/lis/install.html (Installation) http://www.gcom.com/home/linux/lis/removal.html (uninstall) 9. If SNMP support is desired, obtain the Net-SNMP RPMs listed in the table below and install as follows: rpm -Uvh --nodeps ucd-snmp-4.2.5-7.73.0.i386.rpm (Must upgrade this first and use --nodeps) rpm -Uvh ucd-snmp-devel-4.2.5-7.73.0.i386.rpm (Only if older version 4.2.4-3 is on the system) rpm -Uvh ucd-snmp-utils-4.2.5-7.73.0.i386.rpm (Do this after base package, ucd-snmp, is updated) NOTE: The RPMs shown in the above steps are for Red Hat 7.3. Red Hat 7.2 users must use the 7.2 RPMs listed in the table below. Also, although the ucd-snmp-devel package is not required to use our SNMP support, it is included in the steps above for completeness. 19

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes For Red Hat 7.2 Users http://sourceforge.net/project/showfiles.php?group_id=12 694 ucd-snmp-4.2.12.i386.rpm ucd-snmp-utils-4.2.12.i386.rpm For Red Hat 7.3 Users ftp://updates.redhat.com/7.3/en/os/i386 ucd-snmp-4.2.5-7.73.0.i386.rpm ucd-snmp-utils-4.2.5-7.73.0.i386.rpm 10. Install System Release 5.1 Feature Pack 2 for Linux using install.sh. When you install this Intel Dialogic system release, you will be asked to select the packages to install. The selections are: SpringWare Software (for boards now known as Intel Dialogic [model number] boards) SpringWare Antares Software (for boards now known as Intel Dialogic [model number] boards) DM3 MediaSpan Software (for boards now known as Intel NetStructure DM/V-A, DM/V, DM/N, and DM/T [model number] boards) DM3 IPLink Software (for boards now known as Intel NetStructure DM/IP [model number] boards) DM3 FAX Software (for boards now known as Intel NetStructure DM/F [model number] boards) DM3 High Density Station Interface Software (for a platform now known as the Intel NetStructure High Density Station Interface platform) Global Call SS7 Support Software (for software required to support SS7 SIU and Intel NetStructure SS7 boards under Global Call) BoardWatch SNMP Software Documentation The install script may actually install several packages to support the menu selection made, because most of the menu selections require some common support packages to be installed. For example, when you select DM3 MediaSpan Software, the following packages are installed: DLGCcom, DLGCooc, DLGCdev, DLGCdmdev, DLGCgc, DLGCcsp, and DLGCqspan. You don t have to be concerned with these individual package names; the install script installs all required packages, in the proper sequence, automatically. Messages will be displayed to indicate all packages being installed and whether they were installed because of selection or dependency. If you re interested in what the individual packages are, they re explained in the following tables: Menu Item and Software Packages Installed Menu Selection SpringWare Software SpringWare Antares Software DM3 MediaSpan Software DM3 IPLink Software DM3 FAX Software DM3 High Density Station Interface Software Global Call SS7 Support Software BoardWatch SNMP Software Documentation Install All Packages Installed DLGCcom, DLGCooc, DLGCdev, DLGCgc, DLGCcsp, DLGCparms, DLGCpri DLGCcom, DLGCooc, DLGCdev, DLGCant DLGCcom, DLGCooc, DLGCdev, DLGCdmdev, DLGCgc, DLGCcsp, DLGCqspan DLGCcom, DLGCooc, DLGCdev, DLGCdmdev, DLGCgc, DLGCiplnk, DLGCipdemos DLGCcom, DLGCooc, DLGCdev, DLGCdmdev, DLGCgc, DLGCdmfax DLGCcom, DLGCooc, DLGCdev, DLGCdmdev, DLGCgc, DLGCdmfax, DLGChdsi DLGCcom, DLGCgch3r, DLGCgcss7, Septel4gcss7 DLGCcom, DLGCooc, DLGCsnmp DLGCdocs DLGCcom, DLGCooc, DLGCdev, DLGCant, DLGCdmdev, DLGCgc, DLGCgch3r, DLGCcsp, DLGCqspan, DLGCiplnk, DLGCparms, DLGCdmfax, DLGChdsi, DLGCpri, DLGCgcss7, DLGCsnmp, DLGCdocs, Septel4gcss7, DLGCipdemos 20

Installation and Configuration Software Package Descriptions Package Name DLGCant DLGCcom DLGCcsp DLGCdev DLGCdmdev DLGCdmfax DLGCdocs DLGCgc DLGCgch3r DLGCgcss7 DLGChdsi DLGCipdemos DLGCiplnk DLGCooc DLGCparms DLGCpri DLGCqspan DLGCsnmp Package Description Springware Antares Development Package Common components for DM3 and Springware Continuous Speech Processing Demo Springware Base Development Package DM3 Base Development Package DM3 Fax Support Intel Dialogic Documentation Package Global Call Development Package includes Global Call API Library and associated software, Global Call ANAPI and ICAPI Call Control Libraries, and Global Call Protocol Development Kit Run-Time Call Control Library (PDKRT). Global Call ISDN support package is installed as part of DLGCdev. NOTE: Global Call Protocols are installed from a separately ordered CD. Global Call IP call control library files that enable voice and fax over IP calls, using H323 and/or SIP Global Call SS7 call control library DM3 High Density Station Interface Support IP demos DM3 IPLink Support Orbacus Support Package NOTE: This is a CORBA support package that is required and runs in the background. Country Specific Parameters for Springware boards ISDN PRI Protocols Package for Springware boards DM3 MediaSpan Support Boardwatch SNMP Components Septel4gcss7 Portions of Septel Software Development Kit required to support SS7 SIU and Intel NetStructure SS7 boards under Global Call 11. After you install the packages that you want, enter Q to quit install.sh. 12. Configure the boards using config.sh. Refer to the System Release 5.1 for Linux Software Installation Guide for details. 13. Reboot. Upgrading from Feature Pack 1 or from a Previous Feature Pack 2 Service Update If you already have Feature Pack 1 or a previous version of Feature Pack 2 installed, use the following procedure. 1. Stop all applications. 2. Stop all services by running /usr/dialogic/bin/dlstop 3. Unload the drivers by running /usr/dialogic/bin/drvunload 4. Back up any configuration files that were modified to a directory outside of the /usr/dialogic hierarchy. These files will contain machine-specific configurations based upon your installed hardware, protocols, etc. 5. Install System Release 5.1 Feature Pack 2 using install.sh. At a minimum, select the same packages that you currently have installed. (To check which packages are installed, enter rpm -qa DLGC\* before you start installing Feature Pack 2.) 21

System Release 5.1 for Linux Feature Pack 1 and 2 Release Notes Packages that were previously installed will be upgraded. You can also choose to install a package that wasn t installed previously. 6. After you install the packages that you want, enter Q to quit install.sh. 7. Configure the boards using config.sh. Refer to the System Release 5.1 for Linux Software Installation Guide for details. 8. Reboot. Upgrading from System Release 5.1 If you only have System Release 5.1 for Linux installed (without Feature Pack 1), you have to update the prerequisite software on your system before installing Feature Pack 2. The procedure below describes how to update the prerequisite software on your system and how to install Feature Pack 2. For further information on specific packages and versions, consult the Software Requirements section above. For your convenience, two kernel versions and a version of LiS have been provided along with the system release. Refer to Third-Party Files Provided with the System Release (above) for details. For further information on upgrading the kernel (beyond what is given in the procedure), refer to: http://www.redhat.com/docs/manuals/linux/rhl-7.3-manual/custom-guide/s1-kernel-preparing.html. 1. Stop all applications. 2. Stop all services by running /usr/dialogic/bin/dlstop 3. Unload the drivers by running /usr/dialogic/bin/drvunload 4. Remove the current LiS installation as follows: cd /usr/src/lis-2.13/ make very-clean cd /usr/src/ rm -rf LiS* NOTE: For further information about uninstalling LiS, refer to http://www.gcom.com/home/linux/lis/removal.html 5. Acquire additional RPMs from the CD or from Red Hat: updated version of modutils for Red Hat 7.2 or 7.3 updated version of tux for Red Hat 7.2 or 7.3 (needed for SMP kernel versions only) 6. Install RPMs: rpm -Uvh modutils*.rpm (if necessary) NOTE: Select kernel with correct architecture and processor. rpm -Uvh kernel-<smp>2.4.20-18.7.i<arch>.rpm rpm -Uvh kernel-source-2.4.20-18.7.i386.rpm NOTE: For further information on upgrading the kernel information (beyond what is given in the procedure), refer to http://www.redhat.com/docs/manuals/linux/rhl-7.3-manual/customguide/s1-kernel-preparing.html. 7. Edit Boot loader (only for Linux Loader [LILO] users): edit /etc/lilo.conf by replacing all occurrences of the previous kernel version number to 2.4.20-18.7. For example: image=/boot/vmlinuz-2.4.9-13 ==> image=/boot/vmlinuz-2.4.20-18.7 8. Before rebooting, LILO users must run /sbin/lilo and make sure it executes correctly. 9. Reboot into the new kernel. NOTE: Errors generated during startup of the Dialogic service may be safely ignored. 10. Install LiS-2.15: cd /usr/src tar xvzf LiS-2.15.2.tgz cd LiS-2.15 Edit the LiS Configure File CONDITIONAL: Only users of the 2.4.20-18.7 kernel should edit the LiS Configure file as shown in the Note 1 below. make Press <Enter> to use the default response to all configuration questions. 22

Installation and Configuration make install NOTE 1: Edit the LiS Configure File: There are known issues with LiS-2.15.2 and the 2.4.20-18.7 kernel on systems where the kgcc, gcc3, or egcs compilers have been installed. One of the problems seen is that streams.o panics and results in a link_path_walk oops message. The workaround for this problem is using gcc instead of kgcc, gcc3, or egcs. Following outlines the steps to compile LiS with gcc: 1) Edit the /usr/src/lis-2.15/configure file 2) Add the two bold lines to force gcc to be used: if [ "$TARGET" = "l" -a -x /usr/bin/kgcc ]; then CC_NAME=kgcc CC_OPTIMIZE=-O3 elif [ -x /usr/bin/gcc3 ]; then CC_NAME=gcc3 CC_OPTIMIZE=-O3 elif [ -x /usr/bin/egcs ]; then CC_NAME=egcs CC_OPTIMIZE=-O3 else CC_NAME=gcc CC_OPTIMIZE=-O2 fi #ADDED TO SUPPORT 2.4.20-18.7 KERNEL ######################## CC_NAME=gcc # added to support 2.4.20-18.7 kernel CC_OPTIMIZE=-O2 # added to support 2.4.20-18.7 kernel ########################################################## NOTE: More detailed instructions can be found at: http://www.gcom.com/home/linux/lis/install.html (Installation) http://www.gcom.com/home/linux/lis/removal.html (uninstall) 11. Back up any configuration files that were modified since the initial installation of System Release 5.1 to a directory outside of the /usr/dialogic hierarchy. These files will contain machine-specific configurations based upon your installed hardware, protocols, etc. 12. Install System Release 5.1 Feature Pack 2 using install.sh. At a minimum, select the same packages as were installed in System Release 5.1. (To check which packages were installed, enter rpm -qa DLGC\* before you start installing Feature Pack 1.) 13. Configure the boards using config.sh. Refer to the System Release 5.1 for Linux Software Installation Guide for details. 14. Reboot. Uninstalling Feature Pack 2 Once Feature Pack 2 is installed, there is no way to revert back to the original base system release or any previously installed Feature Pack or Service Update release. This is not a limitation of the Feature Pack install, but currently an inherent property of RPM. As such, it is only possible to uninstall all of the Intel Dialogic software (base system release + FP1 + FP2). To uninstall the Intel Dialogic software, perform the following steps: 1. Stop all user applications that use Intel Dialogic hardware or software. 2. Stop all services by running /usr/dialogic/bin/dlstop. 3. Unload the Intel Dialogic driver modules by running /usr/dialogic/bin/drvunload. 4. Uninstall the software by running the /usr/dialogic/bin/dlguninstall.sh script. This will prompt you to back up any locally-modified configuration files before removing all RPM s, the /usr/dialogic directory, and temporary files. Note that the script deletes itself upon successful completion. 23