Instruction/ maintenance manual of the product IP Media Server Intel
Go to page of 56
IP Media Server f or Host Media Pr ocessing Demo Guide Ju ly 2005 05-2389-00 3.
IP Media Server for HMP D emo Guide – July 2005 INFORMA TION IN THIS DO CUMENT IS PRO VIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EX PRESS OR IMPLIED , BY EST OPPEL OR O THER WISE, T O ANY INTELLECTU AL PR OPER TY RIGHTS IS GRANTED BY THIS DOCUMENT .
IP Media Server for HMP De mo Guide – July 2005 3 Contents Revision H istory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 About This Publication . . . . . . . . . . . .
4 IP Media Server for HMP D emo Guide – July 2005 Contents Figures 1 Demo Voice M enu Flowchar t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 2 IP Media S erver Demo Ar chitecture . . . . .
IP Media Server for HMP De mo Guide – July 2005 5 Contents Ta b l e s 1 Command Line Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2 Runtime Key board Com mands . . . . . . . .
6 IP Media Server for HMP D emo Guide – July 2005 Contents.
IP Media Server for HMP Demo Gu ide — July 2005 7 Re vision Histor y This re vision history summarizes the changes made in each published vers ion of this document. Document No. Publication Date Description of Revisions 05-2389-003 July 2005 Added updated Linux information.
8 IP Media Server for HMP Demo Guide — July 2005 Revisi on History.
IP Media Server for HMP Demo Gu ide — July 2005 9 About This Pub lication This section describes the purpose of the guide, th e intended audience, and provides references to other documents that may be useful to the user .
10 IP Media Server for HMP Demo Guide — July 2005 About This Public ation How to Use This Pub lication Refer to this publication after you have installed the hardware and the system software. This publication assumes that you are familiar with the W i ndows or Linux operating system and the C++ programming language.
IP Media Server for HMP Demo Gu ide — July 2005 11 1 1 . Demo Description This chapter describes the basic features of the IP Media Serv er for HMP demo.
12 IP Media Server for HMP Demo Guide — July 2005 Demo Description.
IP Media Server for HMP Demo Gu ide — July 2005 13 2 2 . System Requirements This chapter discusses the system requirements fo r running the IP Media Server for HMP demo. It contains the following topics: • Hardware Requirements . . . . . . . . . .
14 IP Media Server for HMP Demo Guide — July 2005 System Requireme nts 2.2 Software Requirements T o run the IP Media Serv er for HMP demo as documented in this guide, you need one of the following software releases: • Intel NetStruc ture Host Media Processi ng Softw are 1.
IP Media Server for HMP Demo Gu ide — July 2005 15 3 3 . Preparing to Run the Demo This chapter discusses the prepar ations necessary to run the IP Media Server for HMP demo. It provides information about the following topics: • Editing Configuration Files .
16 IP Media Server for HMP Demo Guide — July 2005 Preparing to Run the Demo • InBand – usually used with G.711 coders • RFC2833 Capability Describes the transmit and recei ve coders. See the Global Call IP T echnology Guide for specific information about coder suppor t.
IP Media Server for HMP Demo Gu ide — July 2005 17 Preparing to Run th e Demo Sample Confi guration File ############## ########### ############## ########### ############## ########### ########### .
18 IP Media Server for HMP Demo Guide — July 2005 Preparing to Run the Demo MediaAlar mLostPacket s { Thres hold = 20 # Thre shold value Debou nceOn = 10000 # Thre shold debou nce ON Debou nceOff = .
IP Media Server for HMP Demo Gu ide — July 2005 19 4 4 . Running the Demo This chapter discusses how to run the IP Media Server for HMP dem o. It contains the fo llowing topics: • Starting the Demo . . . . . . . . . . . . . . . . . . . . . . . . .
20 IP Media Server for HMP Demo Guide — July 2005 Running the Demo Example The follo wing example sho ws 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 th e myconfig.
IP Media Server for HMP Demo Gu ide — July 2005 21 Running the Demo Main Menu [Main_Men u] 1 - V oice Mail 2 - Fax 3 - Conferencing (not supported in HMP 1.
22 IP Media Server for HMP Demo Guide — July 2005 Running the Demo Fa x Menu [F ax_Menu] 1 - Send fax (to the IP Media Server demo) 2 - Recei ve fax (sent from the IP Media Serv er demo) * - Quit Se.
IP Media Server for HMP Demo Gu ide — July 2005 23 Running the Demo Figure 1. Demo V oice Menu Flowc har t Main Menu Select one of the follo wing: 1 - V oice Mail 2 - F ax 4 - CSP * - Quit V oice Ma.
24 IP Media Server for HMP Demo Guide — July 2005 Running the Demo 4.4 Stopping the Demo The IP Media Serv er demo runs until it is term inated. Press “q” or “Q” to terminate the demo application.
IP Media Server for HMP Demo Gu ide — July 2005 25 5 5 . Demo Details This chapter discusses the IP Medi a Server for HMP demo in more detail. It contain s the following topics: • Files Used b y the Demo . . . . . . . . . . . . . . . . . . . . . .
26 IP Media Server for HMP Demo Guide — July 2005 Demo Details In W indows, the IP Media Server demo f iles listed in T able 4 are located within: $(INTEL_DI ALOGIC_DIR) DemosIPMediaServer Modules I.
IP Media Server for HMP Demo Gu ide — July 2005 27 Demo Details F axModule CFaxDe vice.h Function prototype for cf axdevice.cpp F axModule CFaxModule.cpp Implements the operations of the CF axModule class F axModule CFaxModule.h Function prototype for cf axmodule.
28 IP Media Server for HMP Demo Guide — July 2005 Demo Details 5.1.2 PDL Files In W indows, the PDL f iles listed in T a ble 5 are located within the directory: $(INTEL_DIALOGIC_DIR )DemosSharedpdl_win In Linux, the PDL files listed in T able 5 are located within the direct ory: $(INTEL_DI ALOGIC_DIR )/ demos/Shared /pdl_Linux 5.
IP Media Server for HMP Demo Gu ide — July 2005 29 Demo Details 5.2.1 Module Structure The IP Media Server for HMP demo uses a modular architecture, in which each technology (IP , voice, f ax, CSP)) is wrapped inside a modu le so that a particular technology can be easily added or remov ed.
30 IP Media Server for HMP Demo Guide — July 2005 Demo Details 5.2.2 EventRouter The EventRouter is responsible for communicating with the modu les. It does the following: • Maintains routing tab .
IP Media Server for HMP Demo Gu ide — July 2005 31 Demo Details 5.2.3 Interfaces The modular architect ure implements a unified interf ace that allo ws replacement of modules by including new header f iles and adjusting routing statem ents. A module is treated by the EventRouter as a block box.
32 IP Media Server for HMP Demo Guide — July 2005 Demo Details CEventRouter Responsible f or connecting all the modules. It does the follo wing: • Maintains routing tables • Retriev es ev ent da.
IP Media Server for HMP Demo Gu ide — July 2005 33 Demo Details Board CIPTBoard • Interacts with the Global Call library to handle IP vir tual boards Note: The public function in this class should only be accessed by classes inside the IP module.
34 IP Media Server for HMP Demo Guide — July 2005 Demo Details Device CIPDevice • Handles IP device oper ations, such as making/dropping call s, sending H.323 messages, making timeslot connections, etc. • Holds CIPStateMachine (or call control) Note: The public functions in this class should only be accessed by classes inside the IP module.
IP Media Server for HMP Demo Gu ide — July 2005 35 Demo Details T able 8. V oice Module Classes Category Class Name Interface Module CV oice Module • Interacts with CV oiceBoard and CV oiceDevice. • Expor ts V oice mod ule functions to CEventRouter .
36 IP Media Server for HMP Demo Guide — July 2005 Demo Details Device CV oiceDevice • Handles voice de vice operations, such as play ing, recording, tone detection, and tone generation • Holds CV oiceStateMachine Note: The public functions in this class should only be accessed by classes inside the Voice module.
IP Media Server for HMP Demo Gu ide — July 2005 37 Demo Details State Machine CV oiceStateMachine • Handles voice e vents and maintains voice state machine(s) Note: The public functions in this class should only be accessed by the classes inside the voice module.
38 IP Media Server for HMP Demo Guide — July 2005 Demo Details Board CF axBoa rd • Interacts with the f ax librar y to handle fax boards • The public function in this class should only be accessed by classes inside the Fax module Init( ) • Open fax board.
IP Media Server for HMP Demo Gu ide — July 2005 39 Demo Details 5.3 Threads The IP Media Serv er for HMP demo operates with two threads, as shown in Figure 4. Figure 4. IP Media Server Demo Threads The threads are created as follo ws: 1. The f irst (main) thread is created by the demo application to get the ke yboard input.
40 IP Media Server for HMP Demo Guide — July 2005 Demo Details After all the modules are started, the Ev entRouter starts to build a static routing table that maps voice de vices to IP devices.
IP Media Server for HMP Demo Gu ide — July 2005 41 Demo Details 5.5 Event Handling This section describes how the IP Media Serv er for HMP demo handles ev ents. It co ntains the following topics: • Event Mechanism • Handling Keyboard Input Events • Handling SRL Events • Handling Application Ex it Events • TSUsrEvent Structure 5.
42 IP Media Server for HMP Demo Guide — July 2005 Demo Details 5.5.5 TSUsrEvent Structure The TSUsrEvent structure is used b y the demo mo dules to return event processing results to the ev ent router .
IP Media Server for HMP Demo Gu ide — July 2005 43 Demo Details Figure 6. T ypical Scenario: Call Offered CEventRouter CIPModule CIPDevice CIPState Machine CV oiceModule GCEV_OFFERED GCEV_OFFERED GC.
44 IP Media Server for HMP Demo Guide — July 2005 Demo Details Pla y Prompts After the call is connected, th e V oice module is notified to play prompts and accept DTMF .
IP Media Server for HMP Demo Gu ide — July 2005 45 Demo Details Fax Mailbo x The user selects to send a fax to mailbox “101”. The Fax module is requested to send a fax. Figure 8. T ypical Scenario: Fax Mailbox CEventRouter CIPModule CF axModule USR_SENDF AX "101" CF axDevice CFaxState Machine USR_SENDF AX "101" .
46 IP Media Server for HMP Demo Guide — July 2005 Demo Details Establish Fax Session The Fax module requests the front end to g et ready to send a fax. If the front end is IP , it shoul d first mov e from an R TP port to a UDP port in order to send a fax.
IP Media Server for HMP Demo Gu ide — July 2005 47 Demo Details Fax Session Estab lished The Fax module gets a reply from the front end that the fax session has been established. Figure 10. T ypical Scenario: F ax Session Established CEventRouter CIPModule CF axModule CF axDevice CFaxState Machine .
48 IP Media Server for HMP Demo Guide — July 2005 Demo Details F ax Sent The fax is sent. The front end is requested to close the fax session. Figure 11. T ypical Scenario: F ax Sent CEventRouter CIPModule CIPDevice CIPState Machine 1. Call gc_stop( ) to stop T .
IP Media Server for HMP Demo Gu ide — July 2005 49 Demo Details Fax Session Closed The Fax module gets a reply from the front end that the fax session has been closed. Figure 12. T ypical Scenario: F ax Session Closed Fax Complete The V oice module gets a reply from the Fax module that a f ax has been sent.
50 IP Media Server for HMP Demo Guide — July 2005 Demo Details.
IP Media Server for HMP Demo Gu ide — July 2005 51 Glossar y Codec: see COder/DECoder COder/DECoder: A circuit used to con vert analog v oi ce data to digital and digital voice data to analog audio. Computer T elephony (CT): Adding computer intellig ence to the making, recei ving, and managing of telephone calls.
52 IP Media Server for HMP Demo Guide — July 2005 International T elecommunications Union (ITU): An organization established by the United Nations to set telecommunications stan dards, allocat e frequencies to various uses, and hold trade sho ws ev ery four years.
IP Media Server for HMP Demo Gu ide — July 2005 53 T1: A digital transm ission link with a capacity o f 1.544 Mbps used in North America. T ypically channeled into 24 digital subscriber lev el zeros (DS0s), each capable of carry ing a single voice con versatio n or data strea m.
54 IP Media Server for HMP Demo Guide — July 2005.
IP Media Server for HMP Demo Gu ide — July 2005 55 Inde x A application classes 31 application exit eve nts 41 C CallbackHdlr( ) 41 CConfig( ) 39 CEventRouter( ) 39 ChannelNumber( ) 31 CheckAndConve.
56 IP Media Server for HMP Demo Guide — July 2005 M main( ) 41 module structure 29 O OnPlayComplete( ) 36 OpenFaxFile( ) 38 P ParseConfigFile( ) 31 PDL files 28 PDLSetApplicationExitPath( ) 41 PDLsr.
An important point after buying a device Intel IP Media Server (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Intel IP Media Server yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Intel IP Media Server - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Intel IP Media Server you will learn all the available features of the product, as well as information on its operation. The information that you get Intel IP Media Server will certainly help you make a decision on the purchase.
If you already are a holder of Intel IP Media Server, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Intel IP Media Server.
However, one of the most important roles played by the user manual is to help in solving problems with Intel IP Media Server. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Intel IP Media Server along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center