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.
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.
C O N T E N T S 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.
Contents E-ISUP 4 New Features in Cisco HSI Release 4.
Contents 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.
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 Log File Location 9 Log Messages 10 Log Message Packages 10 Logging Levels 10 Setting Logging Levels 11 RADVision Logging 11 CHAPTER 5 Gapping 11 Setting Gapping 11 Retrieving Call Gapping Data 12 Troubleshooting Cisco HSI Alarms 1 Introduction 9 1 Alarms Overview 1 Debounce 1 Alarm Severity Levels 1 Retrieving and Reporting Alarms 2 I
Contents 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 Trouble
Contents Severity Level and Trap Type 11 Cause 11 Troubleshooting 11 ENDPOINT_CALL_CONTROL_INTERFACE_FAILURE 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
Contents Severity Level and Trap Type Cause 15 Troubleshooting 16 Detailed Logging APPENDIX A 15 16 MML User Interface and Command Reference Introduction 1 1 Starting an MML Command Session in the Cisco HSI MML Commands 2 MML Command Syntax 2 MML Command Conventions Case Sensitivity 3 Starting an MML Session 1 2 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 MML Command Reference ack-alm clr
Contents radlog 23 restart-softw rtrv-alms 25 rtrv-calls 26 rtrv-ctr 24 26 rtrv-dest 27 rtrv-gapping rtrv-log 28 rtrv-mml rtrv-ne 28 29 30 rtrv-ne-health 30 rtrv-overload rtrv-softw 31 32 set-dest-state set-gapping set-log 34 35 set-overload 36 sta-callproc sta-softw sta-trc stp-call 37 37 38 39 stp-callproc stp-softw stp-trc 33 40 40 41 Cisco H.323 Signaling Interface User Guide x OL-4806-01 Rev.
Contents APPENDIX B Skeleton Configuration File APPENDIX C Example of an HSI Configuration File APPENDIX D E-ISUP Name-to-Cause Value Lookup 1 APPENDIX E E-ISUP Cause Value-to-Name Lookup 1 APPENDIX F H.323 Name-to-Cause Value Lookup 1 APPENDIX G H.323 Cause Value-to-Name Lookup 1 1 1 INDEX Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev.
Contents Cisco H.323 Signaling Interface User Guide xii OL-4806-01 Rev.
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.
Preface Document Organization The system administrator should have an in-depth knowledge of UNIX and a basic knowledge of data and telecommunications networking.
Preface Document Conventions • 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.
Preface Related Documentation Table 1 Document Conventions (continued) Convention Meaning Comments and Examples System prompt Denotes interactive sessions; indicates that the user enters commands at the prompt The system prompt indicates the current command mode. For example, the prompt Router (config)# indicates global configuration mode. Exclamation point (!) at the beginning of a line A comment line Comments are sometimes displayed. Note Means reader take note.
Preface Obtaining Documentation Software Documentation • Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide • Cisco Media Gateway Controller Software Release 9 Provisioning Guide • Cisco Media Gateway Controller Software Release 9 MML Command Reference Guide • Cisco Media Gateway Controller Software Release 9 Messages Reference Guide • Cisco Media Gateway Controller Software Release 9 Billing Interface Guide • Cisco Media Gateway Controller Software Release 9
Preface 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.
Preface Obtaining Technical Assistance • 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.
Preface 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.
C H A P T E R 1 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 The Cisco HSI adds an H.
Chapter 1 Cisco H.323 Signaling Interface Overview Cisco HSI System Description Figure 1-1 Cisco HSI System Overview Operational support systems H.323 signaling interface System administrator E-ISUP/ RUDP H.
Chapter 1 Cisco H.323 Signaling Interface Overview Cisco HSI System Description Figure 1-2 Cisco HSI Subsystems MML Batch File Process Manager MML Process MML Log File SNMP Master Agent SNMP Subagent H.323 Signaling Interface Alarms Statistics MML logfile OAM Call Control Third party RUDP RADVision PGW 2200 H.
Chapter 1 Cisco H.323 Signaling Interface Overview Operational Environment RUDP 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. RADVision H.323 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.
Chapter 1 Cisco H.323 Signaling Interface Overview Cisco HSI Recovery 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.
Chapter 1 Cisco H.323 Signaling Interface Overview Cisco HSI System Limitations Cisco H.323 Signaling Interface User Guide 1-6 OL-4806-01 Rev.
C H A P T E R 2 Installing and Configuring Cisco HSI Software Introduction This chapter contains instructions for installing and configuring the Cisco H.323 Signaling Interface (HSI).
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI 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.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI 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 .
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI 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.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Installing Cisco HSI This section provides step-by-step instructions for installing a single Cisco HSI for use with a simplex PGW 2200 configuration (a configuration with one Cisco PGW 2200 host).
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Step 5 At the # prompt, enter the following commands: # cd /export/BUILDS/4.1 # ./install.sh The following text displays: Processing package instance from GoldWing H323 Adjunct Processor V0.1.6 (sparc) 4.1 Copyright (c) 2001 Cisco Systems, Ltd.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Step 14 Type the gatekeeper ID (see Table 2-2) and press Enter. Note The gatekeeper ID must match the entry configured in the gatekeeper. The following text displays: Enter E-ISUP Host Port Step 15 Type the E-ISUP host port (see Table 2-2) and press Enter. Note The E-ISUP host port is typically 8003, but it must match the peer port setting of the IPLNK object in the PGW 2200 configuration.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Step 20 Type the installation location (see Table 2-2) and press Enter. Note The installation location field is a text field typically used by network designers for identification purposes. Entering a value in this field does not affect functionality. The following is an example of the screen that displays: ## Executing checkinstall script. Modified Environment is: ------------------------BASEDIR=/opt/GoldWing/4.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI [ verifying class
