Guest

Cisco Signaling Controllers

PGW 2200 Softswitch: RAI Configuration on the HSI

Document ID: 60060



Contents

Introduction
Prerequisites
      Requirements
      Components Used
      Conventions
Configure
      HSI Configuration
      Configuration
Verify
Troubleshoot
NetPro Discussion Forums - Featured Conversations
Related Information

Introduction

This document provides an example of a Resource Availability Indicator (RAI) configuration on the Cisco H.323 Signaling Interface (HSI). This configuration is designed for the gatekeeper to detect when an EISUP link has gone down between the CiscoPGW2200 and the Cisco HSI. When an EISUP link goes down, an RAI fail message is sent to the gatekeeper, and the gatekeeper replies with a Resource Available Confirm (RAC) message.

Prerequisites

Requirements

Ensure that you meet these requirements before you attempt this configuration:

Components Used

The information in this document is based on these software versions:

  • Cisco PGW 2200 Software Releases 9.4(1)

  • Cisco HSI Software 4.1

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Conventions

Refer to the Cisco Technical Tips Conventions for more information on document conventions.

Configure

In this section, you are presented with the information to configure the features described in this document.

Note: Use the Command Lookup Tool ( registered customers only) in order to find additional information on the commands used in this document.

In order for the gatekeeper to detect that EISUP links are down, an RAI message is required from the Cisco HSI.

Note: For a redundant Cisco PGW2200 configuration, the fail RAI message should only be sent if the EISUP link to the Active MGC has failed; it should not be issued if the Standby MGC link has failed.

HSI Configuration

A configuration element called RaiSupported is used in order to enable or disable the RAI fail message feature. It is part of the SYS_CONFIG_STATIC family.

In order to switch on this feature, the element must be present and given an arbitrary (string) value, as shown here:

ON: prov-add/ed:name=SYS_CONFIG_STATIC, RaiSupported=enabled

In order to switch this feature off, the element must be given no value (“”). Alternatively, it can be deleted from the configuration. Both options are shown here:

  • OFF: prov-ed:name=SYS_CONFIG_STATIC, RaiSupported=””

  • prov-dlt:name=SYS_CONFIG_STATIC, RaiSupported

Example:

Configuration

In order to add the RAI message functionality on the Cisco HSI , you need to add RaiSupported=enabled to the SYS_CONFIG_STATIC family. The default status of RaiSupported is disabled.

This document uses this configuration:

RAI Configuration on the HSI

telnet  hsi1
SunOS 5.8

login: mgcusr
Password: ***
Sun Microsystems Inc.   SunOS 5.8       Generic February 2000
mgcusr@hsi1% mml
Connecting to port 10129 on host hsi1


Welcome to the GoldWing H323 Signalling Gateway.

gw mml> prov-sta:srcver="active",dstver="test15"
   H323 Signalling Gateway   Sat Jul 24 14:21:31 2004
M  SUCC

Successfully started provisioning session "test15" from "active".
Note: This provisioning session has not been verified.

gw mml> prov-add:name=SYS_CONFIG_STATIC, RaiSupported=enabled
   H323 Signalling Gateway   Sat Jul 24 14:21:46 2004
M  SUCC

Successfully added provisioning element(s):
MML Name :    SYS_CONFIG_STATIC.
Parameter:    RaiSupported.
Value    :    enabled.

gw mml> prov-cpy
   H323 Signalling Gateway   Sat Jul 24 14:22:10 2004
M  SUCC

Successfully activated provisioning session test15.

gw mml> quit

Exiting GoldWing MML.
mgcusr@hsi1% 

!--- Issue this command in order to restart the application 
!--- under directory/etc/init.d: 


# ./CiscoGW stop
Signalling PMmain to shut down
Signalling GWmain[27287] to shut down
Process 'PMmain' not found
Process 'GWmain' not found
...shutdown complete
# ./CiscoGW start

Application started
# 


!--- You can run on the Cisco IOSĀ® gatekeeper 
!--- the show gatekeeper gw-type-prefix command.

#show gatekeeper gw-type-prefix 

GATEWAY TYPE PREFIX TABLE
=========================
Prefix: 71*
  
  Zone cisco-1 master gateway list:
      10.48.84.180:1720 HSI01
		10.48.84.190:1720 HSI02 
		
If you see :
#show gatekeeper gw-type-prefix 
GATEWAY TYPE PREFIX TABLE
=========================

Prefix: 71*
  Zone cisco-1 master gateway list:
      10.48.84.180:1720 HSI01
		10.48.84.190:1720 HSI02 (out-of-resources)
		

!--- HSI, which plays the role of a H323 gateway, appears as 
!--- Out of Resources in the gatekeeper when HSI has sent 
!--- a RAI message to the Gatekeeper with a Resource Unavailable
!--- indication. This happens any time HSI cannot handle 
!--- calls for any reason: not all processes are started, 
!--- HSI goes to 100 percent CPU, faulty IP connectivity.

Capturing Cisco IOS debug Logs
!--- When you capture the logs that includes debugs on the Cisco IOS 
!--- gateway/gatekeeper, it is important to configure the router 
!--- such that timestamps are present on the logs and debugs. 
!--- Also, it is imperative that no logs get dropped. Logging 
!--- to the console can cause logs and/or debugs to get 
!--- discarded from the output. This configuration statements turn on
!--- log timestamps, and direct the log output to a buffer.

config terminal
   service timestamps debug datetime msec
	service timestamps log datetime msec
	no logging console
	logging buffer <Logging buffer size>
	debug
	end


!--- Turn on the Cisco IOS debug for H225 ASN
!---  on the Cisco Gatekeeper in order to check 
!--- that the feature works correctly.


Cisco_Gatekeeper#debug h225 asn1


!--- Run the Cisco IOS show debug command in order to check
!--- if the debug is activated. Before you make reproduce the problem, 
!--- make sure that you clear the log buffer.clear loggingReproduce 
!--- the problem.  You can do a commanding links IS/OOS 
!--- on the Cisco PGW2200 or command EISUP destinations 
!--- IS/OOS on the Cisco PGW2200 or physically remove or 
!--- re-plug IP links between Cisco HSI  and the Cisco PGW2200. 


H.225 ASN1 Messages debugging is on.


You can do a commanding links IS/OOS on the Cisco PGW2200 -or- 
command EISUP destinations IS/OOS on the Cisco PGW2200 -or- 
physically remove or re-plug IP links between Cisco HSI  and the Cisco PGW2200. 

!--- When the Cisco IOS debug  h225 asn1
!--- are activated on the Cisco Gatekeeper, you can run 
!--- the show log | include resourcesAvailable command to verify
!--- if the resourceAvailable message is logged on the gatekeeper 
!--- with the Cisco IOS logging buffered command.

Cisco_Gatekeeper#show log | include resourcesAvailable
Output of the Cisco Gatekeeper debug log information:

value RasMessage ::= resourcesAvailableIndicate: 
value RasMessage ::= resourcesAvailableConfirm: 


!--- If the ResourceAvailable message is available on 
!--- the Cisco Gatekeeper log, you can check 
!--- the content of this H225 debug message.


!--- The content of this debug message is:

<snip>
value RasMessage ::= resourcesAvailableIndicate: 
    {
      requestSeqNum 10103
      protocolIdentifier { 0 0 8 2250 0 4 }
      endpointIdentifier {"822C71A000000015"}
      protocols 
      {
      }
      almostOutOfResources TRUE
    }


14203224: Jul 12 10:25:54.095: RAS OUTGOING PDU ::=

value RasMessage ::= resourcesAvailableConfirm: 
    {
      requestSeqNum 10103
      protocolIdentifier { 0 0 8 2250 0 2 }
    }
<snip>

!--- Note: You do not see the logs since 
!--- logging to the console was turned off through the previous command. 
!--- But, the logs and debugs are captured in the 
!--- log buffer. In order o see them, set the terminal length 
!--- to 0 and show the log buffer. If you set the terminal 
!--- length to 0, this causes the output to scroll continuously, 
!--- for example, without the --More-- prompt.

no debug all
terminal length 0
show logging

Note: The Cisco HSI re-sends the RAI message twice, if it does not initially receive a RAC message from the gatekeeper. The interval at which the messages are sent is determined by the Cisco HSI RAS,responseTimeOut property (defaulted to 30 seconds).

Verify

There is currently no verification procedure available for this configuration.

Troubleshoot

Refer to HSI Data Collection for Technical Support Service Requests for more information in the event this configuration fails.

NetPro Discussion Forums - Featured Conversations

Networking Professionals Connection is a forum for networking professionals to share questions, suggestions, and information about networking solutions, products, and technologies. The featured links are some of the most recent conversations available in this technology.
NetPro Discussion Forums - Featured Conversations for Voice
Service Providers: Voice over IP
Voice & Video: Voice over IP
Voice & Video: IP Telephony
Voice & Video: IP Phone Services for End Users
Voice & Video: Unified Communications
Voice & Video: IP Phone Services for Developers
Voice & Video: General

Related Information



Updated: Feb 02, 2006Document ID: 60060