Table Of Contents
Simple Gateway Control Protocol for the Cisco AS5300 Voice/Gateway
Verifying the SGCP Configuration
Simple Gateway Control Protocol for the Cisco AS5300 Voice/Gateway
Feature Overview
The Simple Gateway Control Protocol (SGCP) version 1.0 enables intelligent, external call agents to control gateways in a Voice over IP (VoIP) environment. Gateways include trunking gateways and residential gateways. Call agents include TransPath and third-party products. This feature is intended for use in large IP networks typical of competitive local exchange carriers (CLECs) and Internet exchange carriers (IXCs).
Benefits
Deregulation in the telecommunications industry gives CLECs opportunities to provide alternative dial tone from the Incumbent Local Exchange Carriers (ILECs). One way of providing alternative dial tone is through Voice over IP (VoIP). SGCP is a protocol that enables an VoIP system to control call setup and teardown as well as CLASS features for less sophisticated gateways.
Note
When you use SGCP in a Voice over IP (VoIP) environment, you do not need to configure VoIP dial peers. The SGCP call agent provides similar functions to VoIP dial peers.
Restrictions
This version of SGCP supports only one T1 controller per Cisco AS5300.
Supported Platform
Cisco Access Server 5300
Supported MIBs and RFCs
MIBs
•
•
For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB web site on Cisco Connection Online CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
•
Configuration Tasks
This section is divided into the following configuration and verification tasks:
•
Configuring Support for SGCP
To configure SGCP on your AS5300, perform the following tasks:
Step 1
Step 2
Step 3
Step 4
Step 5
Verifying the SGCP Configuration
To verify your SGCP configuration and obtain SGCP statistics, enter the following commands beginning in the global configuration mode:
Configuration Examples
AS5300-TGW>enableAS5300-TGW#conf tAS5300-TGW(config)#sgcpAS5300-TGW(config)#controller t1 0AS5300-TGW(config-controll)#framing esfAS5300-TGW(config-controll)#clock source line primaryAS5300-TGW(config-controll)#linecode b8zsAS5300-TGW(config-controll)#ds0-group 0 timeslots 1-24 type none service sgcpAS5300-TGW(config-controll)#^zAS5300-TGW#Command Reference
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command references.
clear sgcp statistics
ds0-group
sgcp
sgcp graceful-shutdown
sgcp request retries
sgcp request timeout
show sgcp
show sgcp connection
show sgcp endpoint
show sgcp statisticsclear sgcp statistics
To clear all SGCP statistics, enter the clear sgcp statistics EXEC command.
clear sgcp statistics
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
AS5300-TGW#clear sgcp statisticsAS5300-TGW#Related Commands
ds0-group
To configure channelized T1 timeslots with channel associated signaling, which enables an AS5300 modem to answer and send an analog call, enter the ds0-group controller configuration command. To disable channel associated signaling for one or more timeslots, enter the no form of this command.
ds0-group channel-number [timeslots range]
no ds0-group channel-number [timeslots range]
Syntax Description
Defaults
No default behavior or values.
Command Modes
CONFIG
Command History
11.2
This command was originally the cas-group command.
12.0(5)T
This command was renamed.
Usage Guidelines
Channel associated signaling is also known as robbed bit signaling.
Examples
AS5300-TGW# ds0-group 5 timeslots 1-4Related Commands
sgcp
To start and allocate resources for the SCGP daemon, enter the sgcp configuration command. To terminate all calls, release all allocated resources, and kill the SGCP daemon, enter the no form of this command.
sgcp
no sgcp
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
CONFIG
Command History
Usage Guidelines
Once you start the SGCP daemon with the sgcp command, you can suspend it (for example, for maintenance) using the sgcp graceful-shutdown command. When you are ready to resume normal SGCP operations, enter the no sgcp graceful-shutdown command. Only enter the no sgcp command if you intend to kill all SGCP applications and protocols.
When the SGCP daemon is not active, all SGCP messages are ignored.
Examples
AS5300-TGW(config)#sgcpRelated Commands
Gracefully terminates all SGCP activity.
Specifies the number of times to retry sending the sgcp command.
Enable debugging on SGCP.
sgcp call-agent
To configure the call agent's (media gateway controller) address, enter the sgcp call-agent configuration command. To unconfigure the call agent's address, enter the no form of this command.
sgcp call-agent [ipaddr | hostname] [port]
no sgcp call-agent
Syntax Description
ipaddr | hostname
(Optional) Specifies the IP address or name of the call-agent.
port
(Optional) Specifies the port for the call-agent to use.
Defaults
No default behavior or values.
Command Modes
CONFIG
Command History
Usage Guidelines
Examples
AS5300-TGW(config)#sgcp call-agent 172.22.92.17Related Commands
Gracefully terminates all SGCP activity.
Specifies the number of times to retry sending the sgcp command.
Enable debugging on SGCP.
sgcp graceful-shutdown
To block new calls while maintaining existing calls, enter the sgcp graceful-shutdown configuration command. To resume SGCP operation, enter the no form of this command.
sgcp graceful-shutdown
no sgcp graceful-shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
CONFIG
Command History
Usage Guidelines
Once you issue this command, all requests for new connections (CreateConnection requests) are denied. All existing calls will be maintained until users end them, or you enter the no sgcp command. When the last active call ends, the SGCP daemon terminates and releases all resources allocated to it. The no sgcp graceful-shutdown command returns the router to normal SGCP operations.
Examples
AS5300-TGW(config)#sgcp graceful-shutdownAS5300-TGW(config)#Related Commands
sgcp request retries
To specify the number of times to retry sending the sgcp command, enter the sgcp request retries configuration command.
sgcp request retries count
Syntax Description
count
Specifies the number of times a notify message is retransmitted to the call agent before it is dropped. The valid range is 1 to 1000.
Default
3.
Command Modes
CONFIG
Command History
Usage Guidelines
This command applies to a trunking gateway.
Examples
The following example shows that the system will try to send the sgcp command 10 times before dropping the request:
AS5300-TGW(config)#sgcp request retries 10AS5300-TGW(config)#Related Commands
sgcp request timeout
To specify how long the system waits for a response to a request, enter the sgcp request timeout configuration command.
sgcp request timeout timeout
Syntax Description
timeout
Specifies the number of milliseconds to wait for a response to a request. Valid range is 1 to 100,000.
Defaults
500.
Command Modes
CONFIG
Command History
Examples
The following example shows that the system waits 40 milliseconds for a reply to a request:
AS5300-TGW(config)#sgcp request timeout 40AS5300-TGW(config)#Related Commands
show sgcp
To display SGCP statistics on this router, enter the show sgcp EXEC command.
show sgcp
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T
This command was introduced in IOS documentation and support for the sgcp graceful-shutdown, sgcp request timeout, and sgcp request retries commands was added.
Usage Guidelines
Refer to LS1010 documentation for more information on this command.
Examples
AS5300-TGW#show sgcpSGCP Admin State DOWN, Oper State DOWNSGCP call-agent: 172.22.92.17 , SGCP graceful-shutdown enabled? FALSESGCP request timeout 40, SGCP request retries 10Table 1
show sgcp Field Descriptions
Related Commands
show sgcp connection
To display all the active SGCP connections on this router, enter the show sgcp connection EXEC command.
show sgcp connection [interface number]
Syntax Description
interface
(Optional) Specifies an interface.
number
(Optional) Specifies the T1 interface (controller) number. Valid values are from 0 to 1000.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
If you do not specify an interface, this command shows all the active SGCP connections on this host. If you do specify an interface, this command shows only those active connections on the specified interface.
Examples
See the following example for a list of the active connections on this router:
AS5300-TGW#show sgcp connectionEndpoint Call ID Conn ID ds1-1/3 1234 3 ds1-1/7 1235 4 ds1-2/3 1237 9 ds1-3/8 1239 12See the following example for information on the active connections on interface 1:
AS5300-TGW#show sgcp connection interface 1 ds1-1/3 1234 3 ds1-1/7 1235 4Related Commands
show sgcp endpoint
To see which timeslots have been configured as end points for SGCP, enter the show sgcp endpoint EXEC command.
show sgcp endpoint [interface ds1 [ds0]]
Syntax Description
interface
Specifies the interface.
ds1
Specifies the DS1 timeslot. Valid range is from 0 to 1000.
ds0
(Optional) Specifies the DS0 timeslot. Valid range is from 1 to 24.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
See the following example for information on the timeslots (1-24) of group 1 configured for SGCP for port 0:
AS5300-TGW#show sgcp endp interface 0T1/0 ds0-group 1 timeslots 1-24See the following example for information on the timeslots (1-24) of group 3 configured for SGCP for port 2:
AS5300-TGW#show sgcp endp interface 2T1/2 ds0-group 3 timeslots 1-24AS5300-TGW#Related Commands
show sgcp statistics
To display global statistics for the SGCP packet count, success and failure counts, and other information, enter the show sgcp statistics EXEC command.
show sgcp statistics
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
See the following example for a display of SGCP packet statistics:
AS5300-TGW#show sgcp statisticsUDP pkts rx 0, tx 0Unrecognized rx pkts 0, SGCP message parsing errors 0Duplicate SGCP ack tx 0Failed to send SGCP messages 0CreateConn rx 0, successful 0, failed 0DeleteConn rx 0, successful 0, failed 0ModifyConn rx 0, successful 0, failed 0DeleteConn tx 0, successful 0, failed 0NotifyRequest rx 0, successful 0, failed 0Notify tx 0, successful 0, failed 0ACK tx 0, NACK tx 0ACK rx 0, NACK rx 0See the following examples for information on how you can filter the command return for specific information:
AS5300-TGW#show sgcp statist | begin FailedFailed to send SGCP messages 0CreateConn rx 0, successful 0, failed 0DeleteConn rx 0, successful 0, failed 0ModifyConn rx 0, successful 0, failed 0DeleteConn tx 0, successful 0, failed 0NotifyRequest rx 0, successful 0, failed 0Notify tx 0, successful 0, failed 0ACK tx 0, NACK tx 0ACK rx 0, NACK rx 0AS5300-TGW#show sgcp statist | exclude ACKUDP pkts rx 0, tx 0Unrecognized rx pkts 0, SGCP message parsing errors 0Duplicate SGCP ack tx 0Failed to send SGCP messages 0CreateConn rx 0, successful 0, failed 0DeleteConn rx 0, successful 0, failed 0ModifyConn rx 0, successful 0, failed 0DeleteConn tx 0, successful 0, failed 0NotifyRequest rx 0, successful 0, failed 0Notify tx 0, successful 0, failed 0AS5300-TGW#show sgcp statist | include ACKACK tx 0, NACK tx 0ACK rx 0, NACK rx 0Related Commands
Displays Simple Gateway Control Protocol information.
Display all the active connections on the host AS5300.
Displays which timeslots have been configured as end points for SGCP.
Debug Commands
This section documents new debug commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command references.
debug sgcp
debug xcctsp all
debug xcctsp error
debug xcctsp sessiondebug sgcp
To debug Simple Gateway Control Protocol, enter the debug sgcp EXEC command. To turn off debugging, enter the no debug sgcp.
debug sgcp {errors | events | packet}
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
See the following examples to enable and disable debugging at the specified level:
AS5300-TGW#debug sgcp errorsSimple Gateway Control Protocol errors debugging is onAS5300-TGW#no debug sgcp errorsSimple Gateway Control Protocol errors debugging is offAS5300-TGW#AS5300-TGW#debug sgcp eventsSimple Gateway Control Protocol events debugging is onAS5300-TGW#no debug sgcp eventsSimple Gateway Control Protocol events debugging is offAS5300-TGW#AS5300-TGW#debug sgcp packSimple Gateway Control Protocol packets debugging is onAS5300-TGW#no debug sgcp packSimple Gateway Control Protocol packets debugging is offAS5300-TGW#Related Commands
debug xcctsp all
To debug External Call Control TSP information, enter the debug xcctsp all EXEC command. To turn off debugging, enter the no form of this command.
debug xcctsp all
no debug xcctsp all
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
See the following examples to turn on and off external call control debugging:
AS5300-TGW#debug xcctsp allExternal call control all debugging is onAS5300-TGW#no debug xcct allExternal call control all debugging is offAS5300-TGW#Related Commands
Enables debugging on external call control errors.
Enables debugging on external call control sessions.
debug xcctsp error
To debug External Call Control TSP error information, enter the debug xcctsp error EXEC command. To turn off error debugging, enter the no form of this command.
debug xcctsp error
no debug xcctsp error
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
See the following examples to turn on and off error-level debugging
AS5300-TGW#debug xcctsp errorExternal call control error debugging is onAS5300-TGW#no debug xcctsp errorExternal call control error debugging is offRelated Commands
Enables debugging on all external call control levels.
Enables debugging on external call control sessions.
debug xcctsp session
To debug External Call Control TSP session information, enter the debug xcctsp session EXEC command. To turn off debugging, enter the no form of this command.
debug xcctsp session
no debug xcctsp session
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
See the following examples to turn on and off session-level debugging:
AS5300-TGW#debug xcct sessExternal call control session debugging is onAS5300-TGW#no debug xcct sessExternal call control session debugging is offAS5300-TGW#Related Commands
Enables debugging on external call control levels.
Enables debugging on external call control errors.
Guest
