Cisco Signaling Interface H.323, HSI 4.1 User Manual

Cisco H.323 Signaling Interface User Guide

Cisco HSI Release 4.1 November 2007

Corporate Headquarters

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000

800 553-NETS (6387)

Fax: 408 526-4100

Text Part Number: OL-4806-01 Rev. A14

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL

gqgg yggy y y

STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

IMPLIED, INCLUDING, WITHOUT

Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networking Academy, Network Registrar, Pac k et , PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0705R)

Cisco H.323 Signaling Interface User Guide

Press,

Preface 13

Document Objectives 13

Audience 13

System Administrator 13

System Operator 14 System Technician 14

Document Organization 14

Document Conventions 15

Related Documentation 16

Release Notes 16

Hardware Documentation 16 Software Documentation 17 Related Documentation 17

Obtaining Documentation 17

World Wide Web 17 Documentation CD-ROM 17 Ordering Documentation 18

Documentation Feedback 18

CONTENTS

CHAPTER

OL-4806-01 Rev. A14

1 Cisco H.323 Signaling Interface Overview 1

Obtaining Technical Assistance 18

Cisco.com 18 Technical Assistance Center 19

Cisco TAC Web Site 19 Cisco TAC Escalation Center 20

Introduction 1

Cisco HSI Overview 1

PGW 2200 2 IP Network 2

Cisco HSI System Description 2

OAM Subsystem 3

Call Control Subsystem 3

RUDP 4 RADVision H.323 4

Cisco H.323 Signaling Interface User Guide

iii

Contents

E-ISUP 4

New Features in Cisco HSI Release 4.1 4

Operational Environment 4

Hardware Requirements 4 Software Requirements 5 Security 5

Cisco HSI Recovery 5

Cisco HSI System Limitations 5

CHAPTER

2 Installing and Configuring Cisco HSI Software 1

Introduction 1

Hardware and Software Requirements 1

Installing the Operating System 1

Installing the Cisco HSI 2

Before You Start 2

Configuring Groups and Users 2 Cisco HSI Installation Information 3

Installing Cisco HSI 5 Installing Multiple Cisco HSIs in a Redundant PGW 2200 Configuration 10

Dual HSI Example Configuration Script 11

Starting the Cisco HSI 11

Stopping the Cisco HSI 12

Configuring the Cisco HSI 12

Upgrading the Cisco HSI 12

Removing the Cisco HSI 13

CHAPTER

3 Provisioning the Cisco HSI 1

Introduction 1

Cisco HSI Configuration 1

MML Configuration Commands 2 Introduction to MML Command Operation for HSI 3

Initiating an MML Session to Enable DTMF on the HSI 3 Verifying the Configuration 3 Reverting to the Base Configuration 4

System Configuration Data 4

Static System Data 4 Changing Static System Data 7

Dynamic System Data 8

Cisco H.323 Signaling Interface User Guide

OL-4806-01 Rev. A14

H.323 Stack Configuration 10

Nonprovisionable Data 11

MML Provisionable Data 11

H.323 System Parameters 11 Q.931 Parameters 11

RAS Parameters 13 H.245 Parameters 15 Codec Selection 18

Quick Reference for Important Parameters 18

HSI Feature Configuration 22

Asymmetric Codec Treatment 23 Empty Capability Set 23

H.323 Hairpin 23 T.38 Fax 24

Configuring T.38 Fax on the Cisco PSTN Gateway 24

Configuring T.38 Fax on a Cisco IOS H.323 Gateway 24

Configuring T.38 Fax on a Cisco IOS MGCP Gateway 24 HSI INFORMATION Message Support 24

HSI Support for Tech Prefixes 25 Configuring Clear Channel on the Cisco HSI 25 Configuring G.726 on the Cisco HSI 27

Configuring G.729 Annex and G.729 Annex B 31

Contents

CHAPTER

OL-4806-01 Rev. A14

4 Managing the Cisco HSI 1

Introduction 1

Restarting the Cisco HSI Application 1

Stopping Call Processing 1

Starting Call Processing 2

Stopping the Call Processing Application 2

Starting the Call Processing Application 2

Reporting the Cisco HSI Status 2

Measurements 2

System-Related Measurements 2

Call-Related Measurements 3 Resetting Measurements 6 Retrieving Counters 6

Overload 6

Overload Level 1 7

Cisco H.323 Signaling Interface User Guide

Contents

Overload Level 2 7 Overload Level 3 7

Setting Overload Data 8 Retrieving Overload Data 8

Logging 9

Rotating Log Files 9

Convention for Naming the Log File 9 Log File Location 9

Log Messages 10

Log Message Packages 10

Logging Levels 10

Setting Logging Levels 11

RADVision Logging 11

Gapping 11

Setting Gapping 11 Retrieving Call Gapping Data 12

CHAPTER

5 Troubleshooting Cisco HSI Alarms 1

Introduction 1

Alarms Overview 1

Debounce 1 Alarm Severity Levels 1

Retrieving and Reporting Alarms 2

Informational Event Requirements 2

SNMP Trap Types 2

Retrieving Alarm Messages 3

Noncontinuous Mode 3

Continuous Mode 3

Acknowledging and Clearing Alarms 4

Alarms List 5

Troubleshooting 6

H323_STACK_FAILURE 6

Description 6 Severity Level and Trap Type 6 Cause 6

Troubleshooting 6

CONFIGURATION_FAILURE 6

Description 6

Severity Level and Trap Type 6

Cisco H.323 Signaling Interface User Guide

OL-4806-01 Rev. A14

Cause 7

Troubleshooting 7

EISUP_PATH_FAILURE 7

Description 7

Severity Level and Trap Type 7

Cause 7

Troubleshooting 7 GATEKEEPER_INTERFACE_FAILURE 8

GENERAL_PROCESS_FAILURE 8

Description 8

Severity Level and Trap Type 8

Cause 8

Troubleshooting 8 IP_LINK_FAILURE 8

Description 8

Severity Level and Trap Type 8

Cause 8

Troubleshooting 9 LOW_DISK_SPACE 9

Description 9

Severity Level and Trap Type 9

Cause 9

Troubleshooting 9

OVERLOAD_LEVEL3 9

Description 9

Severity Level and Trap Type 9

Cause 10

Troubleshooting 10 VSC_FAILURE 10

Description 10

Severity Level and Trap Type 10

Cause 10

Troubleshooting 10 OVERLOAD_LEVEL2 11

Description 11

Severity Level and Trap Type 11

Cause 11

Troubleshooting 11 CONFIG_CHANGE 11

Description 11

Contents

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

vii

Contents

Severity Level and Trap Type 11 Cause 11

Troubleshooting 11

ENDPOINT_CALL_CONTROL_INTERFACE_FAILURE 12

Description 12

Severity Level and Trap Type 12 Cause 12 Troubleshooting 12

ENDPOINT_CHANNEL_INTERFACE_FAILURE 12

Description 12 Severity Level and Trap Type 12

Cause 12 Troubleshooting 12

GAPPED_CALL_NORMAL 13

Description 13 Severity Level and Trap Type 13 Cause 13

Troubleshooting 13

GAPPED_CALL_PRIORITY 13

Description 13

Severity Level and Trap Type 13 Cause 13 Troubleshooting 14

OVERLOAD_LEVEL1 14

Description 14 Severity Level and Trap Type 14

Cause 14 Troubleshooting 14

PROVISIONING_INACTIVITY_TIMEOUT 14

Description 14 Severity Level and Trap Type 14 Cause 15

Troubleshooting 15

PROVISIONING_SESSION_TIMEOUT 15

Description 15 Severity Level and Trap Type 15 Cause 15

Troubleshooting 15

STOP_CALL_PROCESSING 15

Description 15

Cisco H.323 Signaling Interface User Guide

viii

OL-4806-01 Rev. A14

Severity Level and Trap Type 15

Cause 15

Troubleshooting 16

Detailed Logging 16

Contents

APPENDIX

A MML User Interface and Command Reference 1

Introduction 1

Starting an MML Command Session in the Cisco HSI 1

MML Commands 2

MML Command Syntax 2 MML Command Conventions 2

Case Sensitivity 3

Starting an MML Session 3

Batch Files 4

Creating a Batch File 4 Starting a Batch File 4

MML Responses 5

Status Messages 5 Error Messages 6

MML Help 6

Quitting an MML Session 6

MML Command Reference 7

OL-4806-01 Rev. A14

ack-alm 8

clr-alm 9

clr-meas 9

diaglog 10

h 11

help 11

prov-add 13

prov-cpy 14

prov-dlt 15

prov-ed 16

prov-exp 17

prov-rtrv 18

prov-sta 20

prov-stp 21

quit 23

Cisco H.323 Signaling Interface User Guide

Contents

radlog 23

restart-softw 24

rtrv-alms 25

rtrv-calls 26

rtrv-ctr 26

rtrv-dest 27

rtrv-gapping 28

rtrv-log 28

rtrv-mml 29

rtrv-ne 30

rtrv-ne-health 30

rtrv-overload 31

rtrv-softw 32

set-dest-state 33

set-gapping 34

set-log 35

set-overload 36

sta-callproc 37

sta-softw 37

sta-trc 38

stp-call 39

stp-callproc 40

stp-softw 40

stp-trc 41

Cisco H.323 Signaling Interface User Guide

OL-4806-01 Rev. A14

Contents

APPENDIX

NDEX

B Skeleton Configuration File 1

C Example of an HSI Configuration File 1

D E-ISUP Name-to-Cause Value Lookup 1

E E-ISUP Cause Value-to-Name Lookup 1

F H.323 Name-to-Cause Value Lookup 1

G H.323 Cause Value-to-Name Lookup 1

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

Contents

Cisco H.323 Signaling Interface User Guide

xii

OL-4806-01 Rev. A14

Preface

This preface describes the objectives, audience, organization, and conventions of the Cisco H.323 Signaling Interface User Guide, and explains how to find additional information on related products and

services. It contains the following sections:

• Document Objectives, page 13

• Audience, page 13

• Document Organization, page 14

• Document Conventions, page 15

• Related Documentation, page 16

• Obtaining Documentation, page 17

• Obtaining Technical Assistance, page 18

Document Objectives

This guide contains installation, configuration, system management, troubleshooting, and Man-Machine Language (MML) command information for the Cisco H.323 Signaling Interface (HSI).

This version of the Cisco H.323 Signaling Interface User Guide documents the Cisco H.323 Signaling Interface (HSI) software, Release 4.1. Cisco HSI, Release 4.1 is associated with the Cisco Media Gateway Controller Software, Release 9.4(1).

Audience

The intended audience is the system administrator, the system operator, and the system technician.

System Administrator

The system administrator is required to manage the host administrative functions, including:

• Configuring and maintaining system parameters

• Granting group and user IDs

• Managing all Cisco Public Switched Telephone Network (PSTN) Gateway (PGW 2200) files and

directories

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

xiii

Document Organization

The system administrator should have an in-depth knowledge of UNIX and a basic knowledge of data and telecommunications networking.

System Operator

The system operator is assumed to have knowledge of the following:

• Telecommunications protocols

• Basic computer software operations

• Computer terminology and concepts

• Hierarchical file systems

• Common UNIX shell commands

System Technician

The system technician is assumed to have knowledge of the following:

Preface

• Telecommunications protocols

• Basic computer software operations

• Computer terminology and concepts

• Hierarchical file systems

• Common UNIX shell commands

• Log files

• Configuration of telephony switching systems

• Use of electrical and electronic telephony test equipment

• Basic troubleshooting techniques

Document Organization

This document is organized as follows:

• Preface

• Chapter 1, “Cisco H.323 Signaling Interface Overview.”

• Chapter 2, “Installing and Configuring Cisco HSI Software”

• Chapter 3, “Provisioning the Cisco HSI”

• Chapter 4, “Managing the Cisco HSI”

• Chapter 5, “Troubleshooting Cisco HSI Alarms”

• Appendix A, “MML User Interface and Command Reference”

• Appendix B, “Skeleton Configuration File”

• Appendix C, “Example HSI Configuration File”

• Appendix D, “E-ISUP Name-to-Cause Value Lookup”

Cisco H.323 Signaling Interface User Guide

xiv

OL-4806-01 Rev. A14

Preface

• Appendix E, “E-ISUP Cause Value-to-Name Lookup”

• Appendix F, “H.323 Name-to-Cause Value Lookup”

• Appendix G, “H.323 Cause Value-to-Name Lookup”

Document Conventions

This manual uses the document conventions listed in this section.

Ta b l e 1 Document Conventions

Convention Meaning Comments and Examples

Boldface Commands and keywords you

Italics Variables for which you supply

Courier

Courier bold

Square brackets ([ ]) Optional elements command [abc]

enter literally as shown

values

Font used for screen displays, prompts, and

scripts.

Font used to indicate what the user enters in examples of command environments.

Document Conventions

prov-sta

command interface type

You replace the variable with the type of interface.

Are you ready to continue? [Y]

abc is optional (not required), but you can choose it.

Vertical bars ( | ) Separated alternative elements command [abc | def]

You can choose either abc or def, or neither, but not both.

Braces ({ }) Required choices command {abc | def}

You must use either abc or def, but not both.

Braces with vertical bars within square brackets ([{ | }])

A required choice within an optional element

command [abc{ def | ghi}]

You have three options:

• No entry

• abc def

• abc ghi

A string A nonquoted set of characters For example, when setting an

SNMP community string to public, do not use quotation marks around the string; otherwise, the string will include the quotation marks.

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

Related Documentation

• ITU Recommendation H.323, 2000

• ITU Recommendation H.225, 2001

• ITU Recommendation H.245, 2000

• ITU Recommendation H.246 Annex C

Obtaining Documentation

These sections explain how to obtain documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at this URL:

http://www.cisco.com

Translated documentation is available at this URL:

http://www.cisco.com/public/countries_languages.shtml

Documentation CD-ROM

Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual subscription.

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

xvii

Obtaining Technical Assistance

Ordering Documentation

You can order Cisco documentation in these ways:

• Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from

the Networking Products MarketPlace:

http://www.cisco.com/cgi-bin/order/order_root.pl

• Registered Cisco.com users can order the Documentation CD-ROM through the online Subscription

Store:

http://www.cisco.com/go/subscription

• Nonregistered Cisco.com users can order documentation through a local account representative by

calling Cisco Systems Corporate Headquarters (California, U.S.A.) at 408 in North America, by calling 800

Documentation Feedback

You can submit comments electronically on Cisco.com. In the Cisco Documentation home page, click the Fax or Email option in the “Leave Feedback” section at the bottom of the page.

You can e-mail your comments to bug-doc@cisco.com.

Preface

526-7208 or, elsewhere

553-NETS (6387).

You can submit your comments by mail by writing to the following address:

Cisco Systems Attn: Document Resource Connection 170 West Tasman Drive San Jose, CA 95134-9883

We appreciate your comments.

Obtaining Technical Assistance

Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain online documentation, troubleshooting tips, and sample configurations from online tools by using the Cisco Technical Assistance Center (TAC) Web Site. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC Web Site.

Cisco.com

Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world.

Cisco.com is a highly integrated Internet application and a powerful, easy-to-use tool that provides a broad range of features and services to help you with these tasks:

• Streamline business processes and improve productivity

• Resolve technical issues with online support

• Download and test software packages

• Order Cisco learning materials and merchandise

Cisco H.323 Signaling Interface User Guide

xviii

OL-4806-01 Rev. A14

Preface

• Register for online skill assessment, training, and certification programs

If you want to obtain customized information and service, you can self-register on Cisco.com. To access Cisco.com, go to this URL:

http://www.cisco.com

Technical Assistance Center

The Cisco Technical Assistance Center (TAC) is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two levels of support are available: the Cisco TAC Web

Site and the Cisco TAC Escalation Center.

Cisco TAC inquiries are categorized according to the urgency of the issue:

• Priority level 4 (P4)—You need information or assistance concerning Cisco product capabilities,

product installation, or basic product configuration.

• Priority level 3 (P3)—Your network performance is degraded. Network functionality is noticeably

impaired, but most business operations continue.

• Priority level 2 (P2)—Your production network is severely degraded, affecting significant aspects

of business operations. No workaround is available.

• Priority level 1 (P1)—Your production network is down, and a critical impact to business operations

will occur if service is not restored quickly. No workaround is available.

Obtaining Technical Assistance

The Cisco TAC resource that you choose is based on the priority of the problem and the conditions of service contracts, when applicable.

Cisco TAC Web Site

You can use the Cisco TAC Web Site to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to this URL:

http://www.cisco.com/tac

All customers, partners, and resellers who have a valid Cisco service contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a Cisco.com login ID and password. If you have a valid service contract but do not have a login ID or password, go to this URL to register:

http://www.cisco.com/register/

If you are a Cisco.com registered user, and you cannot resolve your technical issues by using the Cisco TAC Web Site, you can open a case online by using the TAC Case Open tool at this URL:

http://www.cisco.com/tac/caseopen

If you have Internet access, we recommend that you open P3 and P4 cases through the Cisco TAC Web

Site.

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

xix

Obtaining Technical Assistance

Cisco TAC Escalation Center

The Cisco TAC Escalation Center addresses priority level 1 or priority level 2 issues. These classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer automatically opens a case.

To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to this URL:

http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml

Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled: for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). When you call the center, please have available your service agreement number and your product serial number.

Preface

Cisco H.323 Signaling Interface User Guide

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface Overview

Introduction

This chapter provides an overview of the Cisco H.323 Signaling Interface (HSI) system and subsystems and contains the following sections:

• Cisco HSI Overview, page 1-1

• Cisco HSI System Description, page 1-2

• Operational Environment, page 1-4

• Cisco HSI Recovery, page 1-5

• Cisco HSI System Limitations, page 1-5

Cisco HSI Overview

CHAPTER

The Cisco HSI adds an H.323 interface to the Cisco Public Switched Telephone Network (PSTN) Gateway (PGW 2200). This interface allows calls to be established between the PSTN and an H.323 network (see

The Cisco HSI provides the following services:

• Translation of signaling protocols for establishing, controlling, and releasing calls

• Administration of network parameters and protocol capabilities

• System and call-related statistics

• Fault reporting

• Overload management

• Event logging

• Simple Network Management Protocol (SNMP) interface

The Cisco HSI does not operate in an active/standby configuration and, therefore, does not provide the same level of redundancy as the PGW 2200, which is configured as active/standby. We therefore recommend that you use enough HSI nodes to support the number of simultaneous calls plus one. This ensures (Trunk Group Caveats dependant) that, if one HSI fails, the calls are still adequately supported by the remaining active HSIs.

Figure 1-1).

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

1-1

Cisco HSI System Description

Figure 1-1 Cisco HSI System Overview

Chapter 1 Cisco H.323 Signaling Interface Overview

Operational

support systems

PGW 2200

System

technician

System

operator

Voice/

signaling

69717

Callers

Voice/

signaling

System

administrator

Access

network

H.323 signaling

interface

E-ISUP/

RUDP

Voice

Cisco PGW 2200

H.323

network

The PGW 2200 consists of the hardware and software that perform the signaling and call control tasks (such as digit analysis, routing, and circuit selection) and seamlessly switch calls from the PSTN through to the IP network.

IP Network

The purpose of the Cisco HSI is to enable the PGW 2200 to interoperate with the H.323 network.

Cisco HSI System Description

The Cisco HSI system has two subsystems (see Figure 1-2):

• Operations, Administration, and Maintenance (OAM) subsystem

• Call control subsystem

Cisco H.323 Signaling Interface User Guide

1-2

OL-4806-01 Rev. A14

Chapter 1 Cisco H.323 Signaling Interface Overview

Figure 1-2 Cisco HSI Subsystems

Cisco HSI System Description

MML

Batch File

Workstation

OAM Subsystem

The OAM subsystem provides the following services:

• Man-Machine Language (MML) interface that enables you to retrieve operational parameters and

Process

Manager

SNMP

Third party

SNMP

Master Agent

SNMP

Subagent

Call Control

RUDP

PGW 2200

H.323 Signaling

Interface

RADVision

H.323 Signaling

interface

OAM

modify configuration values through direct input or through batch files

MML

Process

MML Log File

Alarms Statistics MML logfile

Provisioning files

Call trace Logging

69718

• SNMP interface that allows statistics and alarm retrieval

• Management to provide automatic restart of the Cisco HSI application and control over the running

of the process

• Statistics, events, call trace, and alarm output to files

• Alarm events output to the MML interface

• Overload control

Call Control Subsystem

The call control subsystem provides the following services:

• Manages the Reliable User Data Protocol (RUDP) and H.323 stacks

• Implements Enhanced ISDN User Part (E-ISUP)

• Manages H.323 call control

• Performs the conversion of calls between H.323 and E-ISUP call control messages

• Provides call management and overload reduction actions

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

1-3

Operational Environment

RUDP

RADVision H.323

E-ISUP

Chapter 1 Cisco H.323 Signaling Interface Overview

RUDP transports the E-ISUP messages between the PGW 2200 and the Cisco HSI.

RUDP is a Cisco proprietary, connection-oriented, packet-based transport protocol.

The Cisco HSI 4.1 release uses the RADVision 4.1 H.323 stack. The HSI uses the H.225 (Q.931 and registration, admission, and status [RAS] protocol) and H.245 protocols to implement the H.323 gateway signaling function.

RADVision H.323 enables the creation of real-time voice H.323 calls over IP networks.

E-ISUP is a proprietary Cisco protocol based on ISUP. E-ISUP is used for inter-PGW 2200 call control. E-ISUP uses a subset of ISUP messages. The main differences between ISUP and E-ISUP are as follows:

• E-ISUP is for the control of packet voice connection. It does not have circuit management messages

such as circuit reset and blocking.

• E-ISUP is transported over RUDP in an IP network.

• E-ISUP enables PGW 2200s to transport Session Description Protocol (SDP) information (such as

endpoint IP address and codec specifications) for call endpoints.

The Cisco HSI provides a conversion between the E-ISUP call control protocol originating from the PGW 2200 and the H.323 call control protocol originating from the IP network (see

New Features in Cisco HSI Release 4.1

The features introduced in the Cisco HSI 4.1 release are:

• Support of H.323 Version 4

• Invocation of Empty Capabilities Set

• Notify Support

• Disk Mirroring

• Additional security features

Operational Environment

This section provides operational environment requirements for the Cisco HSI.

Figure 1-1).

Hardware Requirements

The hardware requirements for the Cisco HSI are documented in the Cisco Media Gateway Controller Hardware Installation Guide. See the section “Cisco MGC Host Platforms” in Chapter 1.

Cisco H.323 Signaling Interface User Guide

1-4

OL-4806-01 Rev. A14

Chapter 1 Cisco H.323 Signaling Interface Overview

Software Requirements

The software requirements for the Cisco HSI are documented in the Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide.

Security

The application does not directly provide security features. All security must be implemented at the UNIX level.

Cisco HSI Recovery

The Cisco HSI automatically restarts the main application process if that process terminates.

Note If the system is rebooted, the HSI is not started automatically unless the HSI was already activated prior

to the reboot.

Cisco HSI Recovery

Cisco HSI System Limitations

The Cisco HSI does not implement security features.

Note You cannot run the Cisco HSI on the same hardware platform with the Cisco PGW.

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

1-5

Cisco HSI System Limitations

Chapter 1 Cisco H.323 Signaling Interface Overview

Cisco H.323 Signaling Interface User Guide

1-6

OL-4806-01 Rev. A14

Introduction

CHAPTER

Installing and Configuring Cisco HSI Software

This chapter contains instructions for installing and configuring the Cisco H.323 Signaling Interface (HSI). This chapter contains the following sections:

• Hardware and Software Requirements, page 2-1

• Installing the Operating System, page 2-1

• Installing the Cisco HSI, page 2-2

• Starting the Cisco HSI, page 2-11

• Stopping the Cisco HSI, page 2-12

• Configuring the Cisco HSI, page 2-12

• Upgrading the Cisco HSI, page 2-12

• Removing the Cisco HSI, page 2-13

Hardware and Software Requirements

The hardware requirements for the Cisco HSI are documented in the Cisco Media Gateway Controller Hardware Installation Guide. See the section “Cisco MGC Host Platforms” in Chapter 1.

The software requirements for the Cisco HSI are documented in the Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide.

Installing the Operating System

The appropriate operating system must be installed before you install the Cisco HSI. Instructions for installing the operating system on the appropriate platform are in the Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide, located at the following URL:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/swinstl/index.htm

After completing the operating system installation, return to this document for Cisco HSI installation procedures.

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

2-1

Installing the Cisco HSI

This section provides step-by-step instructions for installing the Cisco HSI.

Before You Start

Complete the preinstallation tasks listed in Table 2-1 before installing the Cisco HSI. Use the checklist to ensure that each task is completed. Detailed instructions for completing some tasks follow the checklist.

Ta b l e 2-1 Preinstallation Tasks Checklist

Check Preinstallation Task

Ensure that the required operating system is installed on the appropriate hardware platform.

Configure group and user names, as described in the “Configuring Groups and Users” section

on page 2-2.

Gather the information listed in Tab le 2-2 and note it in the table for reference during the installation.

Have your company internal support information and Cisco support contact information readily available so you can get help with the installation if needed. If you have questions or need assistance, see the

Chapter 2 Installing and Configuring Cisco HSI Software

“Obtaining Technical Assistance” section on page 18.

Configuring Groups and Users

You must configure groups and users for the Cisco HSI on each host server. A user must be a member of the “mgcgrp” group to use certain Cisco HSI functions, such as Man-Machine Language (MML).

To configure groups and users, complete the following steps:

Step 1 Log in as root.

Step 2 At the # prompt, enter the following commands:

# mkdir -p /export/home/users/mgcusr

# mkdir /export/BUILDS

# mkdir /export/PATCHES

# cd /export/home/users

# groupadd -g 20000 mgcgrp

# useradd -u 20001 -g 20000 -d /export/home/users/mgcusr -s /bin/csh mgcusr

# chown mgcusr:mgcgrp mgcusr

# passwd mgcusr <type password twice>

(Enter and confirm password)

Step 3 Log out, then log in as user mgcusr, using the password you applied in Step 2.

Step 4 Verify that you are in directory /export/home/users/mgcusr by entering the following command:

# pwd

Cisco H.323 Signaling Interface User Guide

2-2

OL-4806-01 Rev. A14

Chapter 2 Installing and Configuring Cisco HSI Software

Step 5 Enter the following command:

# vi .cshrc

Step 6 Enter the vi insert mode by entering the following command:

i (enter insert mode)

Step 7 Enter the following text on the first line:

source /opt/GoldWing/currentPM/local/setup.gw.csh

Step 8 Save the file and quit vi by entering the following commands:

[Esc] (exit insert mode)

:wq (write file and quit)

Step 9 Enter the following command:

# chmod 777 .cshrc

Cisco HSI Installation Information

Installing the Cisco HSI

Gather the information listed in Tabl e 2-2 before you begin the Cisco HSI installation. Use the Notes column in this table to record the information. Several steps in the installation procedure require you to provide this information. Refer to this table as you proceed through the Cisco HSI installation steps.

Ta b l e 2-2 Cisco HSI Installation Information

Required Information Notes

Base directory path Note We strongly recommend that you accept the

default base directory path.

Cisco HSI user name Default: mgcusr

Cisco HSI group name Default: mgcgrp

Gatekeeper IP address

Gatekeeper port Default: 1719

Gateway prefix

Terminal alias

Gatekeeper ID Note This ID must match the entry configured in the

gatekeeper.

E-ISUP host port Note Typically 8003, but this entry must match the

peer port setting of the IPLNK object in the PGW 2200 configuration.

VSC11 name (either the DNS2 host name, if DNS is configured, or the IP address of the Cisco PGW 22003)

VSC1 port Note Typically 8003, but this entry must match the

peer port setting of the IPLNK object in the PGW 2200 configuration.

Installation node ID

OL-4806-01 Rev. A14

Cisco H.323 Signaling Interface User Guide

2-3

Installing the Cisco HSI

Chapter 2 Installing and Configuring Cisco HSI Software

Table 2-2 Cisco HSI Installation Information (continued)

Required Information Notes

Hardware platform

Installation location

1. VSC = virtual switch controller

2. DNS = domain name system

3. PGW = PSTN Gateway

The Cisco HSI application is distributed as a tar file (with filename GoldWing-xxxx.tar in which xxxx is the version ID, for example, GoldWing-4.1.tar) or as a CD-ROM.

The default installation directory is /opt/GoldWing. We recommend that you install the software at the default location. More than one version of the software can exist within subdirectories, for example /opt/GoldWing/4.1

Links point to the currently active version of the Cisco HSI application, as follows:

• currentPM points to the current version to use for all software except the call processing application.

• currentGW points to the version that may not be the latest version of the call processing application.

(GWmain)

Table 2-3 shows the subdirectories of the /opt/GoldWing/currentPM directory.

Ta b l e 2-3 CurrentPM Subdirectories

Subdirectory Contents

./bin All compiled executables.

./local All scripts.

./etc Base configuration files.

./lib Shared libraries required by executables.

./toolkit Toolkit files.

./var Volatile directory that contains file locks and so on.

./var/log Default log directory.

./var/prov Provision system writes provisioning config files here.

./var/trace Trace logs are written here.

Exported provisioning files are stored in /opt/GoldWing/export.

Cisco H.323 Signaling Interface User Guide

2-4

OL-4806-01 Rev. A14

+ 169 hidden pages

Cisco Signaling Interface H.323, HSI 4.1 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual