IP SLAs Configuration Guide, Cisco IOS Release 12.4T
Configuring Gatekeeper Registration Delay Operations for VoIP
Download this chapter
Configuring Gatekeeper Registration Delay Operations for VoIPConfiguring Gatekeeper Registration Delay Operations for VoIP
Download the complete book
IP SLAs Configuration Guide, Cisco IOS Release 12.4TIP SLAs Configuration Guide, Cisco IOS Release 12.4T (PDF - 2 MB)
 Feedback

Contents

Configuring VoIP Gatekeeper Registration Delay Operations

Last Updated: March 22, 2011

This document describes how to configure an Cisco IOS IP Service Level Agreements (SLAs) Voice over IP (VoIP) gatekeeper registration delay operation to determine the average, median, or aggregated response time (delay) of registration attempts from a VoIP gateway to a VoIP gatekeeper device.

To measure VoIP gatekeeper registration response time, the gatekeeper registration delay operation functions by sending a lightweight Registration Request (RRQ) from an H.323 gateway (GW) to an H.323 gatekeeper (GK), and recording the amount of time taken to receive the Registration Confirmation (RCF) back from the gatekeeper.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Restrictions for IP SLAs VoIP Gatekeeper Registration Delay Operations

You cannot configure the IP SLAs VoIP gatekeeper registration delay operation if the gatekeeper has already been registered with the gateway.

Information About IP SLAs VoIP Gatekeeper Registration Delay Operations

H.323 Gatekeepers and Gateways

H.232 is the ITU-T protocol standard used for managing and facilitating packetized voice and video over local-area networks (LANs, particularly intranets) and over the Internet. H.323 consists of several component standards; see the “Glossary” section of this chapter for details on these standardized protocols.

H.323 is considered an “umbrella protocol” because it defines all aspects of call transmission, from call establishment to capabilities exchange to network resource availability. H.323 defines Registration, Admission, and Status (RAS) protocols for call routing, H.225 protocols for call setup, and H.245 protocols for capabilities exchange. The IP SLAs VoIP Gatekeeper Registration Delay Monitoring feature focuses on the function of the call control H.323 stack.

For an in-depth discussion of H.323, including gatekeeper and gateway functionality, see the “H.323 Applications” chapter of the Cisco IOS Voice, Video, and Fax Configuration Guide.

Gateway-to-Gatekeeper Registration Delay Time Monitoring

The IP SLAs VoIP gatekeeper registration delay operation provides statistical data on the amount of time taken to register a gateway to a gatekeeper. IP SLAs was designed to gather information over time, at intervals you specify, so that statistics can be provided on key metrics often used in Service Level Agreements (SLAs). Aggregated totals, median, or average data can be viewed using the Cisco IOS command-line interface (CLI) on the device running IP SLAs, or retrieved from the device by external applications using SNMP.

Cisco IOS IP SLAs also provides notification options based on performance thresholds and reaction triggering. These notification options allow for proactive monitoring in an environment where IT departments can be alerted to potential network problems, rather than having to manually examine data.

This operation will measure time from when the RRQ message is sent and when RCF message is received. A timeout may be required if a response is not received in a certain timeframe.

How to Configure IP SLAs VoIP Gatekeeper Registration Delay Operations

Configuring the VoIP H.323 Gateway

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    gateway

4.    exit

5.    interface interface-id

6.    ip address ip-address subnet-mask

7.    h323-gateway voip interface

8.    h323-gateway voip id gatekeeper-id {ipaddr ip-address [port-number] | multicast}

9.    h323-gateway voip h323-id interface-id

10.    exit


DETAILED STEPS
 Command or ActionPurpose
Step 1 enable


Example: 
Router> enable
 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2 configure terminal


Example: 
Router# configure terminal
 

Enters global configuration mode.

 
Step 3 gateway


Example: 
Router(config)# gateway
 

Enables the H.323 VoIP gateway and enters gateway configuration mode.

 
Step 4 exit


Example: 
Router(config-gateway)# exit
 

Exits gateway configuration mode and returns to global configuration mode.

 
Step 5 interface interface-id


Example: 
Router(config)# interface Ethernet1/1
 

Specifies an interface and enters interface configuration mode.

 
Step 6 ip address ip-address subnet-mask


Example: 
Router(config-if)# ip address 172.29.129.123 255.255.255.0
 

Configures the IP address of the interface.

 
Step 7 h323-gateway voip interface


Example: 
Router(config-if)# h323-gateway voip interface
 

Configures the interface as an H.323 gateway interface.

 
Step 8 h323-gateway voip id gatekeeper-id {ipaddr ip-address [port-number] | multicast}


Example: 
[priority number]


Example: 
Router(config-if)# h323-gateway voip id zone1 ipaddr 172.29.129.124 1719


Example: 
Router(config-if)# h323-gateway voip id saagk ipaddr 172.29.129.28 1719
 

Defines the name and location of the gatekeeper for a specific gateway.

  • Repeat this step for each ID (see example).
 
Step 9 h323-gateway voip h323-id interface-id


Example: 
Router(config-if)# h323-gateway voip h323-id GWZ
 

Configures the H.323 name of the gateway that identifies this gateway to its associated gatekeeper.

 
Step 10 exit


Example: 
Router(config-if)# exit
 

(Optional) Exits interface configuration mode and returns to privileged EXEC mode.

 

Example

The following example shows sample output from the show gateway command if the gateway (named GW3) is registered to a gatekeeper (named slagk): 

Router# show gateway
H.323 ITU-T Version: 4.0   H323 Stack Version: 0.1 
 H.323 service is up
 Gateway  GW3 is registered to Gatekeeper slagk
Alias list (CLI configured) 
 E164-ID 2073418
 E164-ID 5251212
 H323-ID GW3
Alias list (last RCF) 
 E164-ID 2073418
 E164-ID 5251212
 H323-ID GW3
    H323 resource thresholding is Disabled

The following example shows sample output for the show gateway command if the gateway is not registered to a gatekeeper: 

Router# show gateway
 Gateway gw3 is not registered to any gatekeeper
Alias list (CLI configured) 
 E164-ID 2073418
 E164-ID 5251212
 H323-ID gw3/ww
Alias list (last RCF) 
    H323 resource thresholding is Disabled

Use theshow gatekeeper endpoint command to verify the endpoint’s registration status to the gatekeeper. The following example shows the common output of this command if an endpoint is registered: 

Router# show gatekeeper endpoint
            GATEKEEPER ENDPOINT REGISTRATION
            ================================
CallSignalAddr   Port   RASSignalAddr   Port   Zone Name   Type   Flags 
--------------   -----  -------------   ----   ---------   ----   ----- 
172.16.13.35     1720   172.16.13.35    50890  gk          VOIP-GW 
    E164-ID: 2073418
    E164-ID: 5251212
    H323-ID: gw3
   Total number of active registrations = 1

The following example shows the common output of the show gatekeeper endpoint command if an endpoint is not registered: 

Router# show gatekeeper endpoint
            GATEKEEPER ENDPOINT REGISTRATION
            ================================
CallSignalAddr   Port   RASSignalAddr   Port   Zone Name   Type   Flags 
--------------   -----  -------------   ----   ---------   ----   ----- 
   Total number of active registrations = 0

The following configuration example shows a properly configured gateway: 

gateway
interface Ethernet1/1
 ip address 172.29.129.123 255.255.255.0
 h323-gateway voip interface
 h323-gateway voip id zone1 ipaddr 172.29.129.124 1719
 h323-gateway voip id saagk ipaddr 172.29.129.28 1719
 h323-gateway voip h323-id GWZ

Troubleshooting Tips

To troubleshoot registration issues, see the Troubleshooting Gatekeeper Registration Issues technical assistance document.

Configuring and Scheduling a VoIP Gatekeeper Registration Delay Operation

Before You Begin
SUMMARY STEPS

1.    enable

2.    configure terminal

3.    ip sla operation-number

4.    voip delay gatekeeper-registration

5.    history buckets-kept size

6.    history distributions-of-statistics-kept size

7.    history enhanced [interval seconds] [buckets number-of-buckets]

8.    history filter {none | all | overThreshold | failures}

9.    frequency seconds

10.    history hours-of-statistics-kept hours

11.    history lives-kept lives

12.    owner owner-id

13.    history statistics-distribution-interval milliseconds

14.    tag text

15.    threshold milliseconds

16.    timeout milliseconds

17.    verify-data

18.    exit

19.    ip sla schedule operation-number [life {forever| seconds}] [start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss] [ageout seconds] [recurring]

20.    exit

21.    show ip sla configuration [operation-number]


DETAILED STEPS
 Command or ActionPurpose
Step 1 enable


Example: 
Router> enable
 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2 configure terminal


Example: 
Router# configure terminal
 

Enters global configuration mode.

 
Step 3 ip sla operation-number


Example: 
Router(config)# ip sla 10
 

Begins configuration for an IP SLAs operation and enters IP SLA configuration mode.

 
Step 4 voip delay gatekeeper-registration


Example: 
Router(config-ip-sla)# voip delay gatekeeper-registration
 

Configures the IP SLAs operation as a VoIP gatekeeper registration delay operation and enters IP SLA VoIP configuration mode.

  • If the gatekeeper has not been registered with the gateway prior to entering this command, the following error message will be displayed:

No gatekeeper has been registered!

 
Step 5 history buckets-kept size


Example: 
Router(config-ip-sla-voip)# history buckets-kept 25
 

(Optional) Sets the number of history buckets that are kept during the lifetime of an IP SLAs operation.

 
Step 6 history distributions-of-statistics-kept size


Example: 
Router(config-ip-sla-voip)# history distributions-of-statistics-kept 5
 

(Optional) Sets the number of statistics distributions kept per hop during an IP SLAs operation.

 
Step 7 history enhanced [interval seconds] [buckets number-of-buckets]


Example: 
Router(config-ip-sla-voip)# history enhanced interval 900 buckets 100
 

(Optional) Enables enhanced history gathering for an IP SLAs operation.

 
Step 8 history filter {none | all | overThreshold | failures}


Example: 
Router(config-ip-sla-voip)# history filter failures
 

(Optional) Defines the type of information kept in the history table for an IP SLAs operation.

 
Step 9 frequency seconds


Example: 
Router(config-ip-sla-voip)# frequency 30
 

(Optional) Sets the rate at which a specified IP SLAs operation repeats.

 
Step 10 history hours-of-statistics-kept hours


Example: 
Router(config-ip-sla-voip)# history hours-of-statistics-kept 4
 

(Optional) Sets the number of hours for which statistics are maintained for an IP SLAs operation.

 
Step 11 history lives-kept lives


Example: 
Router(config-ip-sla-voip)# history lives-kept 5
 

(Optional) Sets the number of lives maintained in the history table for an IP SLAs operation.

 
Step 12 owner owner-id


Example: 
Router(config-ip-sla-voip)# owner admin
 

(Optional) Configures the Simple Network Management Protocol (SNMP) owner of an IP SLAs operation.

 
Step 13 history statistics-distribution-interval milliseconds


Example: 
Router(config-ip-sla-voip)# history statistics-distribution-interval 10
 

(Optional) Sets the time interval for each statistics distribution kept for an IP SLAs operation.

 
Step 14 tag text


Example: 
Router(config-ip-sla-voip)# tag TelnetPollServer1
 

(Optional) Creates a user-specified identifier for an IP SLAs operation.

 
Step 15 threshold milliseconds


Example: 
Router(config-ip-sla-voip)# threshold 10000
 

(Optional) Sets the upper threshold value for calculating network monitoring statistics created by an IP SLAs operation.

 
Step 16 timeout milliseconds


Example: 
Router(config-ip-sla-voip)# timeout 10000
 

(Optional) Sets the amount of time an IP SLAs operation waits for a response from its request packet.

 
Step 17 verify-data


Example: 
Router(config-ip-sla-voip)# verify-data
 

(Optional) Causes an IP SLAs operation to check each reply packet for data corruption.

 
Step 18 exit


Example: 
Router(config-ip-sla-voip)# exit
 

Exits VoIP configuration submode and returns to global configuration mode.

 
Step 19 ip sla schedule operation-number [life {forever| seconds}] [start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss] [ageout seconds] [recurring]


Example: 


         

Example:
          
Router(config)# ip sla schedule 5 start-time now life forever


         		 
          

Configures the scheduling parameters for an individual IP SLAs operation.


         


      
Step 20
          
            exit
          
        
 

Example:
          
Router(config)# exit


         		 
          

(Optional) Exits global configuration mode and returns to privileged EXEC mode.


         


      
Step 21
          
            show
            ip
            sla
            configuration
           [operation-number]
 

Example:
          
Router# show ip sla configuration 10


         		 
          

(Optional) Displays configuration values including all defaults for all IP SLAs operations or a specified operation.


         


    




Troubleshooting Tips


 
	 
     
		
  •  If the IP SLAs operation is not running and generating statistics, add the 
		  verify-data command to the configuration of the operation (while configuring in IP SLA configuration mode) to enable data verification. When enabled, each operation response is checked for corruption. Use the 
		  verify-data command with caution during normal operations because it generates unnecessary overhead. 
		
    • 
 
		
  •  Use the 
		  debugipsla 
			 trace and 
		  debug 
			 ip 
			 sla 
			 error commands to help troubleshoot issues with an IP SLAs operation. 
		
    • 
 
	 

 
  


















































What to Do Next


 
	 
 To add proactive threshold conditions and reactive triggering for generating traps, or for starting another operation, to an IP SLAs operation, see the "Configuring Proactive Threshold Monitoring" section. 
	 

 
	 
 To view and interpret the results of an IP SLAs operation use the 
		show 
		  ip 
		  sla 
		  statistics command. Checking the output for fields that correspond to criteria in your service level agreement will help you determine whether the service metrics are acceptable. 
	 

 
  






















































Configuration Examples for IP SLAs VoIP Gatekeeper Registration Delay Operations


Example  Configuring the IP SLAs VoIP gatekeeper registration delay operation



    

      

In the following example, a VoIP gatekeeper registration delay operation is configured and scheduled to start immediately. This example assumes the gateway to gatekeeper relationship has already been configured.


      
Router# configure terminal
Router(config)# ip sla 1
Router(config-ip-sla)# voip delay gatekeeper-registration
Router(config-ip-sla-voip)# exit
Router(config)# ip sla schedule 1 start-time now life forever



    


  












Additional References


 
	 
 
	 

 
	 
Related Documents
 
		 
		

 
			  
			  
			  
				
 
				   
					 
 Related Topic
					 

 
				  		
 
				   
					 
 Document Title
					 

 
				  		
 
				

 
			 
 
			  
				
 
				   
					 
 Cisco IOS commands
					 

 
				  		
 
				   
					 
 
						Cisco IOS Master Commands List, All Releases 
					 

 
				  		
 
				

 
				
 
				   
					 
 Cisco IOS IP SLAs commands
					 

 
				  		
 
				   
					 
 
						Cisco IOS IP SLAs Command Reference 
					 

 
				  		
 
				

 
				
 
				   
					 
 Gateway and gatekeeper configuration using Cisco IOS Release 12.3 and later releases
					 

 
				  		
 
				   
					 
 
						Cisco IOS Voice Configuration Library
					 

 
				  		
 
				

 
				
 
				   
					 
 Troubleshooting gatekeeper configurations
					 

 
				  		
 
				   
					 
 
						 Troubleshooting Gatekeeper Registration Issues 
					 

 
				  		
 
				

 
			 
 
		  



 
	 

 
	 
Standards
 
		 
		

 
			  
			  
			  
				
 
				   
					 
 Standard
					 

 
				  		
 
				   
					 
 Title
					 

 
				  		
 
				

 
			 
 
			  
				
 
				   
					 
 No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
					 

 
				  		
 
				   
					 
 --
					 

 
				  		
 
				

 
			 
 
		  



 
	 

 
	 
MIBs
 
		 
		

 
			  
			  
			  
				
 
				   
					 
 MIB
					 

 
				  		
 
				   
					 
 MIBs Link
					 

 
				  		
 
				

 
			 
 
			  
				
 
				   
					 
 CISCO-RTTMON-MIB
					 

 
				  		
 
				   
					 
 To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
					 

 
					 
 
						http://www.cisco.com/go/mibs 
					 

 
				  		
 
				

 
			 
 
		  



 
	 

 
	 
RFCs
 
		 
		

 
			  
			  
			  
				
 
				   
					 
 RFC
					 

 
				  		
 
				   
					 
 Title
					 

 
				  		
 
				

 
			 
 
			  
				
 
				   
					 
 No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
					 

 
				  		
 
				   
					 
 
						-- 
					 

 
				  		
 
				

 
			 
 
		  



 
	 

 
	 
Technical Assistance
 
		 
		

 
			  
			  
			  
				
 
				   
					 
 Description
					 

 
				  		
 
				   
					 
 Link
					 

 
				  		
 
				

 
			 
 
			  
				
 
				   
					 
 The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. 
					 

 
				  		
 
				   
					 
 
						http://www.cisco.com/cisco/web/support/index.html 
					 

 
				  		
 
				

 
			 
 
		  



 
	 

 
  










Feature Information for the IP SLAs VoIP Gatekeeper Registration Delay Operation


 
	 

		
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
		

 
		
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to 
		  http://www.cisco.com/go/cfn. An account on Cisco.com is not required. 
		

 
	 


	 
 
		

Table 1 Feature Information for IP SLAs VoIP Gatekeeper Registration Delay Operations  
		   
		   
		   
		   
			 
 
				 
				  
 Feature Name
				  

 
						
 
				 
				  
 Releases
				  

 
						
 
				 
				  
 Feature Information
				  

 
						
 
			 

 
		  
 
		   
			 
 
				 
				  
 IP SLAs VoIP Gatekeeper Delay Monitoring
				  

 
						
 
				 
				  
 12.3(14)T
				  

 
						
 
				 
				  
 The Cisco IOS IP SLAs Voice over IP (VoIP) gatekeeper registration delay operation allows you to measure the average, median, or aggregated network response time of registration attempts from a VoIP gateway to a VoIP gatekeeper device.
				  

 
						
 
			 

 
		  
 
		



 
	 

 
  










Glossary



    

      
        Gatekeepers
      --Network devices that help to facilitate and control H.323-based voice and video communications across networks. Gatekeepers are responsible for providing address translation between LAN aliases and IP addresses, call control and routing services to H.323 endpoints, system management, and security policies. These services provided by the gatekeeper in communicating between H.323 endpoints are defined in RAS.


    

      
        Gateways
      --Network devices that provide translation between circuit-switched networks (particularly, H.320 ISDN) and packet-based networks (for example, H.323 LANs), allowing endpoints in networks with different transmission formats, codecs, and protocols to communicate.


    

      
        H.225.0
      --Protocol standard that defines the establishment and disconnection of H.323 calls. 


    

      
        H.225.0
        RAS
      --H.225.0 Registration/Admission/Status. Standard that facilitates communication between H.323 gateways (endpoints) and H.323 gatekeepers.


    

      
        H.235
      --Protocol standard that defines security solutions for H.323 protocols (Q.931, H.245, RAS, Streams). H.235 was formerly called H.SECURE.


    

      
        H.245
      --Protocol standard that defines connection management and negotiation capabilities between H.323 devices on the network once the call is established by Q.931.


    

      
        H.323
      --An ITU protocol standard for the transmission of real-time audio (Voice/VoIP), video (for example, videoconferencing), and data information over packet switching-based networks. Such networks include IP-based (including the Internet) networks, Internet packet exchange-based local-area networks (LANs), enterprise networks and metropolitan and wide-area networks (WANs). H.323 can also be applied to multipoint multimedia communications. H.323 defines a distributed architecture for IP telephony applications, including multimedia, video conferencing, video over the Internet, and VoIP.


    

      
        Q.931
      --Protocol standard that defines the establishment and disconnection of H.323 calls.


    

      
        RTP/RTCP
      --Real-time Protocol/Real-Time Control Protocol serves as the standardized means for transmitting and receiving audio and video streams across the network once the call is established.


    

      
        VoIP
      --Voice or Video over Internet Protocol. Sometimes used to refer to all IP telephony applications.


  










 


 
	 
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at 
		www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R) 
	 

 
	 
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.