Summary of the content on the page No. 1
IP Media Server for Host Media
Processing
Demo Guide
July 2005
05-2389-003
Summary of the content on the page No. 2
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,
Summary of the content on the page No. 3
Contents Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1 Demo Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2 System Requirements . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 4
Contents Figures 1 Demo Voice Menu Flowchart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 2 IP Media Server Demo Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29 3 EventRouter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 4 IP Media Server Demo Threads . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 5
Contents Tables 1 Command Line Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2 Runtime Keyboard Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 3 Files in IPMediaServer Folder Used by the IP Media Server Demo . . . . . . . . . . . . . . . . . . . . . 25 4 Files in Modules Folder Used by the IP Media Server Demo . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
Contents 6 IP Media Server for HMP Demo Guide – July 2005
Summary of the content on the page No. 7
Revision History This revision history summarizes the changes made in each published version of this document. Document No. Publication Date Description of Revisions 05-2389-003 July 2005 Added updated Linux information. 05-2389-002 April 2005 Globally changed file paths to use installation directory environment variable, and to reflect latest Windows directory hierarchy Globally removed Linux-specific information and references to pre-1.3 HMP releases Demo Description chapter: Added note abo
Summary of the content on the page No. 8
Revision History 8 IP Media Server for HMP Demo Guide — July 2005
Summary of the content on the page No. 9
About This Publication This section describes the purpose of the guide, the intended audience, and provides references to other documents that may be useful to the user. • Purpose � Intended Audience � How to Use This Publication � Related Information Purpose This guide provides information on the IP Media Server for HMP demo that is available with the ® Intel NetStructure Host Media Processing Software product. The guide describes the demo, lists its requirements, and provides details on ho
Summary of the content on the page No. 10
About This Publication How to Use This Publication Refer to this publication after you have installed the hardware and the system software. This publication assumes that you are familiar with the Windows or Linux operating system and the C++ programming language. The information in this guide is organized as follows: � Chapter 1, “Demo Description” introduces you to the demo and its features � Chapter 2, “System Requirements” outlines the hardware and software required to run the demo � Chapte
Summary of the content on the page No. 11
1Demo Description . 1 This chapter describes the basic features of the IP Media Server for HMP demo. The IP Media Server for HMP demo is an object-oriented host-based application that demonstrates using the Global Call API to build an IP media server, providing voice and fax services via IP technology. The demo source code can be used as sample code for those who want to begin developing an application from a working application. Note: The IP Media Server for HMP demo is limited to a maximum
Summary of the content on the page No. 12
Demo Description 12 IP Media Server for HMP Demo Guide — July 2005
Summary of the content on the page No. 13
2System Requirements . 2 This chapter discusses the system requirements for running the IP Media Server for HMP demo. It contains the following topics: � Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 � Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.1 Hardware Requirements To run the IP Media Server for HMP demo, you need: ® ® � Intel Pentium II
Summary of the content on the page No. 14
System Requirements 2.2 Software Requirements To run the IP Media Server for HMP demo as documented in this guide, you need one of the following software releases: � Intel NetStructure Host Media Processing Software 1.3 for Windows (or later) � Intel NetStructure Host Media Processing Software 1.5 for Linux (or later) For operating system requirements, see the release documentation (Release Guide or Release Notes) that accompanies your specific HMP release. 14 IP Media Server for HMP Demo Guid
Summary of the content on the page No. 15
3Preparing to Run the Demo . 3 This chapter discusses the preparations necessary to run the IP Media Server for HMP demo. It provides information about the following topics: � Editing Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 � Compiling and Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 3.1 Editing Configuration Files This section discusses how to configure the
Summary of the content on the page No. 16
Preparing to Run the Demo � InBand – usually used with G.711 coders � RFC2833 Capability Describes the transmit and receive coders. See the Global Call IP Technology Guide for specific information about coder support. The parameters are as follows: � TxType – the transmit voice coder Note: By default, the fax demo is turned off. This feature may be enabled when tested with T.38 capable IP endpoints. To do this, “uncomment” the line TxType = t38UDPFax in this section by removing the # from the
Summary of the content on the page No. 17
Preparing to Run the Demo Sample Configuration File ################################################################################################ # IP Protocol : # The IP Protocol used for opening the IP Line devices, values: H323, SIP, both # # DTMFmode # possible options: # OutOfBand, inband, rfc2833 # # Capability posiblities: # g711Alaw # g711Mulaw # gsm # gsmEFR # g723_5_3k # g723_6_3k # g729a # g729ab # t38UDPFax # # Note: if you wa
Summary of the content on the page No. 18
Preparing to Run the Demo MediaAlarmLostPackets { Threshold = 20 # Threshold value DebounceOn = 10000 # Threshold debounce ON DebounceOff = 10000 # Threshold debounce OFF Interval = 1000 # Threshold Time Interval (ms) PercentSuccess = 60 # Threshold Success Percent PercentFail = 40 # Threshold Fail Percent } MediaAlarmJitter { Threshold = 60 # Threshold value DebounceOn = 200
Summary of the content on the page No. 19
4Running the Demo . 4 This chapter discusses how to run the IP Media Server for HMP demo. It contains the following topics: � Starting the Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 � Demo Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 � Using the Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 20
Running the Demo Table 1. Command Line Switches (Continued) -n Sets the number of channels The lesser of Voice Devices or IP devices -q Activates Quality of Service Disabled Example The following example shows how to launch the demo from a command line with options: IPMediaServer -n64 -cmyconfig.cfg -ea This command launches the demo with 64 channels, using the myconfig.cfg configuration file and A-law encoding. 4.3 Using the Demo This section describes how to use the IP Media Server for HM
