Cisco H.323 Signaling Interface User Guide
Corporate Headquarters
Cisco H.323 Signaling Interface User Guide
N T E N T S
Introduction to MML Command Operation for HSI
Hairpin 38 Fax
RADVision Logging
Eisuppathfailure
Endpointcallcontrolinterfacefailure
MML Help
OL-4806-01 Rev. A14
Skeleton Configuration File
Xii
Audience
System Administrator
Document Objectives
Document Organization
System Operator
System Technician
This document is organized as follows Preface
Command abc
Document Conventions
Meaning Comments and Examples
Boldface
Global configuration mode
Related Documentation
Release Notes
Hardware Documentation
Obtaining Documentation
Software Documentation
Related Documentation
World Wide Web
Obtaining Technical Assistance
Ordering Documentation
Documentation Feedback
Cisco.com
Technical Assistance Center
Cisco TAC Web Site
Cisco TAC Escalation Center
Introduction
Cisco HSI Overview
IP Network
Cisco HSI System Description
PGW
OAM Subsystem
Call Control Subsystem
New Features in Cisco HSI Release
Operational Environment
Hardware Requirements
RADVision H.323
Cisco HSI Recovery
Cisco HSI does not implement security features
Cisco HSI System Limitations
Software Requirements
OL-4806-01 Rev. A14
Hardware and Software Requirements
Installing and Configuring Cisco HSI Software Introduction
Installing the Operating System
Installing the Cisco HSI
Configuring Groups and Users
Check Preinstallation Task
Before You Start
Cisco HSI Installation Information
Source /opt/GoldWing/currentPM/local/setup.gw.csh
# vi .cshrc
# chmod 777 .cshrc
Subdirectory Contents
# tar xvf GoldWing-4.1.tar
Installing Cisco HSI
This command displays the following text
# cd /export/BUILDS/4.1 # ./install.sh
Following text displays
Type the VSC1 name and press Enter Following text displays
## Executing checkinstall script. Modified Environment is
VERSION=4.1
Cisco HSI-A
Dual HSI Example Configuration Script
Starting the Cisco HSI
Example
# /etc/init.d/CiscoGW start
Configuring the Cisco HSI
Stopping the Cisco HSI
Upgrading the Cisco HSI
# /etc/init.d/CiscoGW stop
# cd /opt/GoldWing # ls -l
# ./uninstall.sh
Removing the Cisco HSI
## Removing installed package instance OTTgw000
Type y and press Enter. The following text displays
Cisco HSI Configuration
Provisioning the Cisco HSI
MML Configuration Commands
Command
Command Description
Prov-sta Prov-cpy Prov-stp
Introduction to MML Command Operation for HSI
Initiating an MML Session to Enable Dtmf on the HSI
Verifying the Configuration
Etc/init.d/CiscoGW start
Static System Data
System Configuration Data
Reverting to the Base Configuration
Parameter Type Description
Parameter, set it to Enabled
Can receive T.38 FAX data. The default value is
Default value is 0xc8
Option. The default value is
Issue the command restart-softwconfirm
Changing Static System Data
Parameter Description Default
Dynamic System Data
OVLDLEVEL1PERCENT
OVLDLEVEL3PERCENT
OVLDLEVEL1FILTER
OVLDLEVEL1THRESHLOWER
Stack Configuration
Nonprovisionable Data
MML Provisionable Data
System Parameters
Parameters
Prov-addname=q931,maxCalls=2000
Parameter Name Description Type Example Update Type
Null
RAS Parameters
Parameter Name Description Type Example
ManualRAS If this parameter is present
Prov-addname=ras,maxfail=3
AllowCallsWhenNonReg If this parameter is present, it
R0.2.4 Immediate Assigns to each version
Prov-addname=h245,masterSlave.timeout=5
String H323ESP
Update
Parameter Name Type
INTEGER0,1
Parameter Name Parameter Value Description
Codec Selection
Quick Reference for Important Parameters
14presents important static system data parameters
Parameter Name Parameter Values Description
15presents common RAS parameters
VSCBIPADDR1/2
VSCBPORTNUMBER1/2
HSI Feature Configuration
Parameter Name Parameter Value
Hairpin
Asymmetric Codec Treatment
Empty Capability Set
Configuring T.38 Fax on the Cisco Pstn Gateway
Configuring T.38 Fax on a Cisco IOS H.323 Gateway
Configuring T.38 Fax on a Cisco IOS Mgcp Gateway
38 Fax
Configuring Clear Channel on the Cisco HSI
Prov-addname=sysconfigstatic,informationmsgdisabled = True
HSI Support for Tech Prefixes
Prov-edname=ccpackage,hash=C
Clear Channel Parameters Example Value Example Configuration
Configuring G.726 on the Cisco HSI
Configuring Cisco HSI g726-cisco
Parameter Example Value Configuration Example
Configuring the Payload Type for the Mgcp
Configuring Cisco HSI g726-generic
OL-4806-01 Rev. A14
Configuring G.729 Annex and G.729 Annex B
Parameter
OL-4806-01 Rev. A14
Restarting the Cisco HSI Application
Stopping Call Processing
Starting Call Processing
Stopping the Call Processing Application
Starting the Call Processing Application
Reporting the Cisco HSI Status
Call-Related Measurements
Counter Name Measurement Type Comments
Fcinccallatttot
Fcinccallsucctot
Fcotg Callatttot
Fcotgcallsucctot
Avgroundtripdelay
Masterslaveatttot
Masterslavesucctot
Termcapxchgatttot
Retrieving Counters
Resetting Measurements
Overload
Overload Level
Retrieving Overload Data
Setting Overload Data
Following MML commands set overload data
Logging
Rotating Log Files
Convention for Naming the Log File
Log File Location
Log Messages
Logging Levels
Log Message Packages
Log messages have the following format
Setting Gapping
Setting Logging Levels
Gapping
RADVision Logging
Retrieving Call Gapping Data
Set-gappingbothcalltype=all,percent=60
Debounce
Alarms Overview
Alarm Severity Levels
Retrieving and Reporting Alarms
Snmp Trap Types
Informational Event Requirements
Severity Level Description
Retrieving Alarm Messages
Noncontinuous Mode
Continuous Mode
To display all current alarms, use the rtrv-almsMML command
Acknowledging and Clearing Alarms
Element Description
SystemId Name of your device and its identifier
YYYY-MM-DD
Alarms List
Alarm Event and Reference Severity Level
Troubleshooting
Troubleshooting
Description
Severity Level and Trap Type
Eisuppathfailure
This alarm has not been implemented
One of the two links to a single Cisco PGW 2200 has failed
Percentage of disk usage is greater than the alarm limit
Lowdiskspace
Use the clr-almcommand to attempt to clear the alarm
Vscfailure
Running configuration has been modified
Severity level is minor. The trap type is
Severity level is information. The trap type is
This is an informational event
RADVision stack reports this alarm
Endpointcallcontrolinterfacefailure
Gappedcallnormal
OVERLOADLEVEL1
Provisioningsessiontimeout
User has entered the stp-callproccommand through the MML
Detailed Logging
Etc/init.d/CiscoGW start Exit out of superuser
MML User Interface and Command Reference Introduction
Starting an MML Command Session in the Cisco HSI
MML Command Conventions
MML Commands
MML Command Syntax
Symbol Description
Starting an MML Session
Case Sensitivity
Mml
Starting a Batch File
Batch Files
Creating a Batch File
MML Responses
Status Messages
Status Message Description
Rtrv
Error Messages
Error Message Definition Description
MML Help
Quitting an MML Session
MML Command Reference
This section describes the following MML commands
Ack-almevent=alarm event
Ack-alm
Clr-alm
Clr-almcommand clears an alarm event
Clr-almevent=alarm event
Diaglog
Examples
Help
Start
End
Redisplay
Helprtrv-ctr
RTRV-CTR
Prov-addcommand adds a component to the Cisco HSI
Prov-add
Prov-cpy
Confirm
Usage Guidelines
Prov-add
Sysconfigstatic Sysconfigdynamic H323sys Ras H245 Q931
Related Commands Description
Prov-dlt
Session
Gw mml prov-edname=ras,maxfail=7
Prov-edcommand modifies a provisioned component
Prov-ed
MML batch feature to import the exported data
Installation
Prov-exp
Prov-stasrcver=active, dstver=dummy1
Prov-rtrv
Name ras
Gw mml prov-rtrvname=ras
Gw mml prov-rtrvsession
Gw mml prov-rtrvlist
Prov-sta
Prov-stasrcver=version,dstver=version
Prov-stp
Prov-stpconfirm prov-stpsession nameconfirm
Session name
Process that started the provisioning session
Gw mml prov-stpmml2confirm
Gw mml prov-stpconfirm
Gw mml prov-stpuk9confirm
Quit
Radlog
Quit
Radlogfile namestart stop
Gw mml restart-softwconfig2
Restart-softw
Gw mml restart-softwinit
Gw mml restart-softw
Rtrv-alms
Rtrv-alms rtrv-almscont
Cont
Ack-alm
Clr-meas Resets a measurement counter
Rtrv-calls
Rtrv-ctr
Syntax Description Examples
Signalling path to the PGW
Service is or out of service OOS
Rtrv-dest
Set-dest-state
Syntax Description
Rtrv-gapping
Rtrv-log
Rtrv-mml
Rtrv-ne
Rtrv-ne-health
Rtrv-ne
Status of the Cisco HSI
Rtrv-overload
Rtrv-overload
Gw mml rtrv-ne-health
Gw mml rtrv-overload
Rtrv-softw
Gw mml rtrv-softw
Rtrv-dest
Set-dest-state
OOS
Set-gapping
Set-log
Package
One of the packages in the Cisco HSI
Data to be activated
Set-overload
Level 1 level 2 level
Lower=number
Upper=number
Sta-softw
Related Commands Retrieve
Sta-callproc
Sta-callproc Starts call processing
Sta-trccommand starts the call processing tracing function
Sta-trc
Stp-call
Stp-callcallref=x stp-callall
Callref
Rtrv-calls
Stp-callproctimeout=T
Stp-callproc
Sta-trc Starts the call processing tracing function
Stp-trc
Stp-trc
OL-4806-01 Rev. A14
Skeleton Configuration File
RASmaxFailD1-200
Sysconfigstatic
Sysconfigstatic HOSTPORTNUMBER1 S
Sysconfigstatic HOSTPORTNUMBER2 S
Sysconfigstatic VSCAPORTNUMBER2
CCECChannelOutOfService
CCECCugAccessBarred
CCECNetworkAddressExtensionError S
CCECOperatorPriorityAccess
Sysconfigstatic CCECPrefix0DialledInError
Sysconfigstatic CCECPrefix1DialledInError
Sysconfigstatic CCECPrefix1NotDialled
Sysconfigstatic CCECPriorityForcedRelease
Sysconfigdynamic
AlarmDebounceTime 60000
ResponseTimeOut 200
OvldLevel2ThreshUpperCPU 100
OvldLevel3Percent 100
H245 MasterSlave.timeout 65535 MasterSlave.manualOperation
Q931 OverlappedSending
Q931 EarlyH245
Q931 H245tunneling
H245 Modesi.audio.g711Alaw64k
H245 Modesi.audio.g711Alaw56k
H245 Modesi.audio.g711Ulaw64k
H245 Modesi.audio.g711Ulaw56k
Eisup
Accgdes
Accgdtd
Accnocivc
Accnociecdi
Accwaitrlcfail
Accnumrelretries
Accwaitrelretry
CCPackage CCECServiceOrOptionNotAvail
CCPackage CCECServiceOrOptionNotImpUnspec
CCPackage CCECInvalidElemContents
CCPackage CCECRecoveryOnTimerExpiry
CCPackage CCHCExchangeRouteError
CCPackage CCHCPermanentFrameModeConnectionOutOfService C
CCPackage CCHCSwitchingEquipmentCongestion
CCPackage CCHCAccessInformationDiscarded
CCPackage CCHCServiceOrOptionNotImplemented
CCPackage CCHCInvalidInformationElementContents
CCPackage CCHCRecoveryOnTimerExpiry
CCPackage CCHCBearerCapabilityNotImplemented
Cisco H.323 Signaling Interface User Guide
Trace Trigger2.h323.CalledPartyNumber
Trace Trigger2.h323.OriginatingIPAddress
Trace Trigger2.h323.OriginatingIPMask
Trace Trigger2.h323.TerminatingIPAddress
Eisup Rudptimercheckperiodmsec
Eisup Waittimebeforefailovermillisec
H323 MaxTimers TickPeriod DefaultSDPt
Q931 ConnectTimeoutConst
NumberNoRangeConst
Q931 NonQuotedConst
Example of an HSI Configuration File
# Logging Package
Appendix C Example of an HSI Configuration File
Appendix C Example of an HSI Configuration File
Appendix C Example of an HSI Configuration File
# Call Control Package
# FCI
Accgdes =
Accgdtd =
Accnociecdi = Accnocicci = Accnocisi = Acctmr =
Appendix C Example of an HSI Configuration File
Appendix C Example of an HSI Configuration File
Appendix C Example of an HSI Configuration File
Appendix C Example of an HSI Configuration File
# Faultmanagement Package
# Gapping Package
# Trace Package
Appendix C Example of an HSI Configuration File
# Eisup Package
# Application Package
# Dynamic System Data
Alternategatekeeperip
Alternategatekeeperport = Alternategatekeeperid
Logprio = Trace
= Cchcdefault
OVLDLEVEL2FILTER = Normal
Normal OVLDLEVEL2THRESHUPPERCPU
OVLDLEVEL3FILTER = Normal
CCECNetworkAddressExtensionError
CCECBlacklistBNumberMatched
CCECBlacklistCliLengthInvalid
CCECCallingDroppedWhileOnHold
CCECPrefix0DialledInError
CCECPrefix1DialledInError
CCECProtocolErrorUnspec
CCECRemoteProcError
Appendix C Example of an HSI Configuration File
OL-4806-01 Rev. A14
Isup Name-to-Cause Value Lookup
Name Value
Appendix D E-ISUP Name-to-Cause Value Lookup
Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14
Isup Cause Value-to-Name Lookup
Value Name
Appendix E E-ISUP Cause Value-to-Name Lookup
Appendix E E-ISUP Cause Value-to-Name Lookup
OL-4806-01 Rev. A14
Name-to-Cause Value Lookup
Appendix F H.323 Name-to-Cause Value Lookup
Cause Value-to-Name Lookup
Appendix G H.323 Cause Value-to-Name Lookup
Configchange
Lowdiskspace OVERLOADLEVEL1 OVERLOADLEVEL2 OVERLOADLEVEL3
Stopcallprocessing
Vscfailure
Clr-meas command
Codec parameters Commands ack-alm clr-alm clr-meas diaglog
Configchange alarm
Data Configurable B-1 Constant B-1
Isup
Endpointcallcontrolinterfacefailur
Endpointchannelinterfacefailure
HSI
MML commands case sensitivity A-3conventions A-2
Man-machine language
Alarmdebouncetime Ciagentscanperiod
Codec Dynamic system data 245 System
Logdirectory Logfilerotateinterval Logfilerotatesize
Nonprovisionable data OverlappedSending
Related documentation
Reliable User Datagram Protocol
931 See Rudp
Pkinst file
Stp-softw command
Vscfailure alarm
Snmp
Manager MIB Subagent