Cisco H.323 Signaling Interface User Guide Cisco HSI Release 2.21 February 2004 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
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 ON T E N T S Preface xi Document Objectives xi Audience xi System Administrator xi System Operator xii System Technician xii Document Organization xii Document Conventions xiii Related Documentation xiv Release Notes xiv Hardware Documentation xiv Software Documentation xv Related Documentation xv Obtaining Documentation xv World Wide Web xv Documentation CD-ROM xv Ordering Documentation xvi Documentation Feedback xvi Obtaining Technical Assistance xvi Cisco.
Contents E-ISUP 1-4 New Features Introduced in HSI Release 2.21 Asymmetric Codec Treatment 1-4 Empty Capability Set 1-4 H.
Contents MML Provisionable Data 3-9 H.323 System Parameters Q.931 Parameters 3-9 RAS Parameters 3-10 H.245 Parameters 3-13 3-9 Configuring HSI Release 2.21 Features 3-16 Asymmetric Codec Treatment 3-16 Empty Capability Set 3-16 H.323 Hairpin 3-16 T.38 Fax 3-17 Configuring T.38 Fax on the Cisco PSTN Gateway 3-17 Configuring T.38 Fax on a Cisco IOS H.323 Gateway 3-17 Configuring T.
Contents Log Message Packages 4-10 Logging Levels 4-10 Setting Logging Levels 4-10 RADVision Logging 4-11 CHAPTER 5 Gapping 4-11 Setting Gapping 4-11 Retrieving Call Gapping Data 4-12 Troubleshooting Cisco HSI Alarms 5-1 Introduction 5-1 Alarms Overview 5-1 Debounce 5-1 Alarm Severity Levels 5-1 Retrieving and Reporting Alarms 5-2 Informational Event Requirements 5-2 SNMP Trap Types 5-2 Retrieving Alarm Messages 5-3 Noncontinuous Mode 5-3 Continuous Mode 5-3 Acknowledging and Clearing Alarms Alarm
Contents Description 5-8 Severity Level and Trap Type 5-8 Cause 5-8 Troubleshooting 5-8 IP_LINK_FAILURE 5-8 Description 5-8 Severity Level and Trap Type 5-8 Cause 5-8 Troubleshooting 5-9 LOW_DISK_SPACE 5-9 Description 5-9 Severity Level and Trap Type 5-9 Cause 5-9 Troubleshooting 5-9 OVERLOAD_LEVEL3 5-9 Description 5-9 Severity Level and Trap Type 5-9 Cause 5-10 Troubleshooting 5-10 VSC_FAILURE 5-10 Description 5-10 Severity Level and Trap Type 5-10 Cause 5-10 Troubleshooting 5-10 OVERLOAD_LEVEL2 5-11 Desc
Contents Description 5-12 Severity Level and Trap Type 5-12 Cause 5-12 Troubleshooting 5-12 GAPPED_CALL_NORMAL 5-13 Description 5-13 Severity Level and Trap Type 5-13 Cause 5-13 Troubleshooting 5-13 GAPPED_CALL_PRIORITY 5-13 Description 5-13 Severity Level and Trap Type 5-13 Cause 5-13 Troubleshooting 5-14 OVERLOAD_LEVEL1 5-14 Description 5-14 Severity Level and Trap Type 5-14 Cause 5-14 Troubleshooting 5-14 PROVISIONING_INACTIVITY_TIMEOUT 5-14 Description 5-14 Severity Level and Trap Type 5-14 Cause 5-15
Contents MML Commands A-2 MML Command Syntax A-2 MML Command Conventions A-2 Case Sensitivity A-3 Starting an MML Session A-3 Batch Files A-3 Creating a Batch File A-4 Starting a Batch File A-4 MML Responses A-5 Status Messages A-5 Error Messages A-5 MML Help A-6 Quitting an MML Session MML Command Reference ack-alm clr-alm A-6 A-8 A-8 clr-meas diaglog h A-6 A-9 A-10 A-10 help A-11 prov-add A-12 prov-cpy A-13 prov-dlt A-14 prov-ed A-15 prov-exp A-16 prov-rtrv A-17 prov-sta A-19 p
Contents rtrv-log A-27 rtrv-mml rtrv-ne A-28 A-28 rtrv-ne-health rtrv-overload rtrv-softw A-29 A-29 A-30 set-dest-state set-gapping set-log A-32 A-32 set-overload A-33 sta-callproc sta-softw sta-trc stp-call A-34 A-35 A-35 A-37 stp-callproc stp-softw stp-trc A-31 A-37 A-38 A-38 APPENDIX B Skeleton Configuration File APPENDIX C Example of an HSI Configuration File APPENDIX D E-ISUP Name-to-Cause Value Lookup D-1 APPENDIX E E-ISUP Cause Value-to-Name Lookup E-1 APPENDIX F H
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 • Order Cisco learning materials and merchandise • 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-5 • 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 Cisco HSI System Description 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 uses the RADVision H.323 stack. The system uses the H.225 (Q.931 and registration, admission, and status [RAS] protocol) and H.245 protocols to implement the H.323 endpoint signaling function. RADVision H.
Chapter 1 Cisco H.323 Signaling Interface Overview Operational Environment call to the PSTN. In this case, the originating and terminating HSIs establish the call normally but pass the H.245 address of the H.323 endpoints. This enables the two endpoints to use H.245 to negotiate media channels with each other directly, independent of the HSI. T38 Fax The T.38 Fax feature enables the HSI to alter a call, initially established for voice, to support a fax transmission.
Chapter 1 Cisco H.323 Signaling Interface Overview Cisco HSI System Limitations Cisco H.323 Signaling Interface User Guide 1-6 OL-2156-04 Rev.
C H A P T E R 2 Installing and Configuring Cisco HSI Software Introduction This chapter contains instructions for the system administrator on how to install and configure 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 4 Verify that you are in directory /export/home/users/mgcusr by entering the following command: # pwd 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.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Table 2-2 Cisco HSI Installation Information (continued) Required Information Notes 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 Hardware platform Sun Netra T1 Sun Netra 120 Sun Fire V120 (Default) Installation location 1. VSC = virtual switch controller 2. DNS = domain name system 3.
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 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 Enter GoldWing user name Step 7 Type the Cisco HSI user name mgcusr and press Enter (the default user name is cisco). The following text displays: Enter GoldWing group name Step 8 Type the Cisco HSI group name mgcgrp and press Enter (the default user group name is sysadmin). The following text displays: Enter GateKeeper IP Address Step 9 Type the gatekeeper IP address (see Table 2-2) and press Enter.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI The following text displays: Enter VSC1 Port Step 16 Type the VSC1 port number (see Table 2-2) and press Enter. Note The VSCI port is typically 8003, but it must match the port setting of the IPLNK object in the PGW 2200 configuration. The following text displays: Enter Installation NodeId Step 17 Type the installation node ID (see Table 2-2) and press Enter.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Using as the package base directory. ## Processing package information. ## Processing system information. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. ## Checking for setuid/setgid programs. This package contains scripts which will be executed with super-user permission during the process of installing this package.
Chapter 2 Installing and Configuring Cisco HSI Software Installing the Cisco HSI Note The package name is OTTgw000. If more than one instance of the package is installed, the package name has a suffix (for example, OTTgw000.2, OTTgw000.3, and so on). Outside of the /opt/GoldWing directory, the start/stop script CiscoGW is copied to the /etc/init.d directory, and the link /etc/rc3.d/S95CiscoGW is created to facilitate automatic startup of the Cisco HSI on system reboot.
Chapter 2 Installing and Configuring Cisco HSI Software Starting the Cisco HSI Step 1 Continuing from Step 21 of the “Installing the Cisco HSI” section on page 2-5, exit server 1. Step 2 Log in to server 2 as root and go to the # prompt. Step 3 Insert the Cisco HSI CD in the CD-ROM drive. Step 4 Follow the installation instructions found in Step 3 through Step 21 of the “Installing the Cisco HSI” section on page 2-5.
Chapter 2 Installing and Configuring Cisco HSI Software Removing the Cisco HSI • The installation of a new version results in a new version directory being created in the /opt/GoldWing parent directory. The links currentPM and currentGW are updated to point to this new version. Note To revert to a previous version of the software, manually modify the currentPM and currentGW links in the/opt/GoldWing parent directory to point to the previous version. The uninstall.
Chapter 2 Installing and Configuring Cisco HSI Software Removing the Cisco HSI ## Processing package information. ## Executing preremove script. ## Removing pathnames in class
