Intel 05-2450-001 User Manual

Intel NetStructure® Host Media Processing Software Release 1.5 for Linux
Software Installation Guide
August 2005
05-2450-001
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 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 the express written consent of Intel Corporation.
Copyright © 2005, 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 proper ty of others.
Publication Date: August 2005
Document Number: 05-2450-001
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 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.5 for Linux Software Installation Guide as well as the software described in it is

Contents

Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1 Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.1 Major Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 HMP Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2 Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1 Assumptions and Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2 Order of Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3 Installing the HMP Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 Configuring the System (Activating a License) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.5 Running the Verification Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.6 Performing a Silent Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3 Uninstalling the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.1 Checking the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.2 Understanding the Install Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.3 Contacting Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
HMP Release 1.5 for Linux Software Installation Guide – August 2005 3

Revision History

This revision history summarizes the changes made in each published version of this document.
Document No. Publication Date Description of Revisions
05-2450-001 August 2005 Minor editorial changes.
Configuring the System (Activating a License) : Step added to mention prompt to run
verification demo.
05-2450-001-01 June 2005 Initial version of document. Much of the information contained in this document was
previously published in the Intel NetStructure
Release 1.2 for Linux Installation Guide, document number 05-2354-001.
®
Host Media Processing Software
HMP Release 1.5 for Linux Software Installation Guide — August 2005 4

About This Publication

This preface provides the following information about this document:
Purpose
Intended Audience
How to Use This Publication
Related Information

Purpose

This publication describes how to install Intel NetStructure® Host Media Processing Software Release 1.5 for Linux. Information about running a demo to confirm proper installation, troubleshooting the installation, and uninstalling the software is also included.

Intended Audience

This publication is intended for:
System Integrators
Toolkit Developers
Independent Software Vendors (ISVs)
Original Equipment Manufacturers (OEMs)

How to Use This Publication

Following are some guidelines for using this publication:
To get an overall understanding of the install process, refer to Chapter 1, “Installation
Overview”.
The complete installation procedure, including prerequisites, system configuration procedures,
and instructions for running the verification demo, is provided in Chapter 2, “Installing the
Software”.
If you need to uninstall the HMP Software, refer to Chapter 3, “Uninstalling the Software”.
If you have problems while installing the HMP Software, refer to Chapter 4,
“Troubleshooting”.
For a definition of some key terms, refer to the Glossary.
To navigate through all the information, use the Contents, Index, and internal links.
HMP Release 1.5 for Linux Software Installation Guide — August 2005 5
About This Publication

Related Information

The following documents and web sites provide more information:
Intel NetStructure Host Media Processing Release 1.5 for Linux License Manager
Administration Guide - This publication describes how to perform the various tasks related to obtaining, activating, and otherwise working with HMP Software license files and also how to manually stop and start HMP services.
Intel NetStructure Host Media Processing Release 1.5 for Linux Release Guide - This
document provides information about the release such as product features, system requirements, and user documentation.
Intel NetStructure Host Media Processing Release 1.5 for Linux Release Update - This
document addresses release issues such as known problems and documentation updates.
For technical support, go to http://developer.intel.com/design/telecom/support/.
For information about Intel NetStructure Host Media Processing products, go to
http://www.intel.com/design/network/products/telecom/software/index.htm#hmp
For information about Intel
http://www.intel.com/design/network/products/telecom/index.htm.
®
telecom products, go to
6 HMP Release 1.5 for Linux Software Installation Guide — August 2005

1.Installation Overview

This chapter provides the following information about installing Intel NetStructure® Host Media Processing Software Release 1.5 for Linux.
Major Installation Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
HMP Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.1 Major Installation Steps

Following are the major installation steps:
1. Before installing the HMP Software, make sure that the system meets the hardware and software “System Requirements” as described the HMP Software Release Guide.
2. To install the software, you must have local administrative privileges. Contact your network administrator to set up administrative privileges as required.
3. Uninstall any existing Intel
4. Obtain an HMP Software license. You can do this before or after you install the HMP Software. A verification license supplied with the software will allow you to run the verification demo to confirm that you have installed the HMP Software properly. However, its features are limited and you may want to obtain another license. Refer to Section 1.2, “HMP
Licenses”, on page 7 for more information. Complete information and procedures for
obtaining and working with licenses is provided in the Intel NetStructure Host Media Processing Release 1.5 for Linux Administration Guide.
5. Install the HMP Release 1.5 software. Refer to Section 2.3, “Installing the HMP Software”, on page 10.
6. Activate an HMP Software license. This is considered a configuration activity and can be done immediately after installing the software or later if you manually run
Section 2.4, “Configuring the System (Activating a License)”, on page 11.
7. Start the HMP services. If necessary, use the
Note: The system does not need to be rebooted after installing and configuring the software.
However, you must log out and log back in so the environment changes take effect.
8. Optionally run the verification demo to verify proper installation of the HMP Software. Refer to Section 2.5, “Running the Verification Demo”, on page 15.
®
Dialogic® system release.
1
config.sh. Refer to
dlstart script found in /usr/dialogic/bin.

1.2 HMP Licenses

Before you use the HMP Software, you must obtain a license file containing HMP license data. An HMP license is a file containing authorizations for a combination of call control and media processing channels. You can obtain a license file either before or after you install the HMP Software, but you need to obtain a license file before you can proceed with using the HMP Software.
HMP Release 1.5 for Linux Software Installation Guide — August 2005 7
Installation Overview
Once you have installed the HMP Software and downloaded a license file1 to your computer, you must activate the license on the target system using the License Manager. The License Manager offers both a menu interface and a command line interface (CLI). The Intel NetStructure Host Media Processing Release 1.5 for Linux Licensing Manager Administration Guide describes how to obtain and use license files, and the various tasks you can perform with the License Manager.
You can try out the HMP Software with a verification, evaluation, or trial license before you purchase a permanent, production license from Intel. If a license file is lost or damaged, you can obtain an emergency replacement for it. Table 1 shows the types of licenses available for use with HMP Software.
Table 1. License Types
License Type Features Expires?
Ver if icat ion
(free)
Evaluation
(free)
Tr ia l
(free)
Purchased any supported
Emergency Replacement
1. For more information about MAC addresses, refer to the Intel NetStructure Host Media Processing Release 1.5 for Linux License Manager Administration Guide.
2. A license is supplied with the HMP Software that allows you to run a verification demo. This demo verifies that you have set up HMP properly. For more information, refer to Section 2.5, “Running the Verification Demo”, on page 15.
3. An evaluation license is available from www.intel.com/go/mediaprocessing.
4. For a list of authorized distributors, go to: http://www.intel.com/buy/index.
1 channel for RTP G.711, Voice, and Multimedia
4 channels for all components
any supported channel component combination
channel component combination
replaces a “Purchased” license
no included with HMP
expires in 45 days
expires in 45 days
no Intel authorized
expires in 14 days
Where to get
license?
Software
available from Web site
Intel authorized distributor or account manager
distributor or account manager
Intel authorized distributor or account manager
2
3
4
MAC address
required?
no - use with any MAC address
no - use with any MAC address
yes - supply MAC address when ordering
yes - supply MAC address when ordering
yes - supply MAC address when ordering
1
For more information, refer to the Intel NetStructure Host Media Processing Release 1.5 for Linux Licensing Manager Administration Guide.
1. A verification license is installed with the HMP Software, activated and ready to use, but this license is only intended to be used for verifying that the HMP Software installation was successful (see
Section 2.5, “Running the Verification Demo”, on page 15).
8 HMP Release 1.5 for Linux Software Installation Guide — August 2005

2.Installing the Software

This chapter provides procedures for installing and licensing Intel NetStructure® Host Media Processing Software Release 1.5 for Linux. This information is contained in the following sections:
Assumptions and Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Order of Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installing the HMP Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Configuring the System (Activating a License). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Running the Verification Demo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Performing a Silent Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2.1 Assumptions and Prerequisites

The following are basic requirements to install and run the HMP software:
The appropriate version of Red Hat or SuSe Linux must be installed and the system must meet
all the hardware and software “System Requirements” as described in the Intel NetStructure Host Media Processing Release 1.5 for Linux Release Guide.
To install the software, you must have local administrative privileges. Contact your network
administrator to set up administrative privileges as required.
If you have HMP Release 1.2 or any Intel
uninstall it. However, if you have an earlier version of HMP 1.5, you do not have to uninstall it. It will be upgraded when you install the new version.
®
Dialogic® release on your system, you must
2
Note that the HMP software has three install scripts:
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
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)
The name of the install script in each level is
install.sh.

2.2 Order of Procedures

This section describes the order in which the installation procedures must be performed.
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
HMP Release 1.5 for Linux Software Installation Guide — August 2005 9
Loading...
+ 19 hidden pages