Cisco Signaling Interface H.323 User manual

Corporate Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]
Cisco H.323 Signaling Interface User
Guide
Cisco HSI Release 4.1
November 2007
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
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 IMPLIED, INCLUDING, WITHOUT
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.
Cisco H.323 Signaling Interface User Guide
Copyright © 2007 Cisco Systems, Inc. All rights reserved.
gqgg yggy y y
Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press,
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, Pack e t , 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)

iii
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
CONTENTS
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
Obtaining Technical Assistance 18
Cisco.com 18
Technical Assistance Center 19
Cisco TAC Web Site 19
Cisco TAC Escalation Center 20
CHAPTER 1Cisco H.323 Signaling Interface Overview 1
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

Contents
iv
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
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 2Installing 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 3Provisioning 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

Contents
v
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
CHAPTER 4Managing 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

Contents
vi
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
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 5Troubleshooting 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

Contents
vii
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
viii
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
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

Contents
ix
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
Severity Level and Trap Type 15
Cause 15
Troubleshooting 16
Detailed Logging 16
APPENDIX AMML 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
ack-alm 8
clr-alm 9
clr-meas 9
diaglog 10
h11
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

Contents
x
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
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