Worldwide [change] |Account |Register |About Cisco
Guest

Hierarchical Navigation

Cisco IOS Software Releases 12.3 Mainline

Gateway Codec Order Preservation and Shutdown Control

Downloads

Table Of Contents

Gateway Codec Order Preservation and Shutdown Control

Contents

Information About Gateway Codec Order Preservation

Information About Gateway Shutdown Control

Shutdown Behavior in H.323 Networks

Shutdown Behavior in SIP Networks

How to Shutdown or Enable VoIP Services on a Cisco Gateway

Shutting Down and Enabling VoIP Service on Cisco Gateways

Shutting Down and Enabling VoIP Submodes on Cisco Gateways

Verifying Gateway Status

Verifying H.323 Gateway Status

Verifying SIP Gateway Status

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

call service stop

show sip service

shutdown (gateway)


Gateway Codec Order Preservation and Shutdown Control

The Gateway Codec Order Preservation and Shutdown Control feature enables Cisco gateways to pass codec preferences from the originating leg to the terminating leg of a VoIP call. This feature also enables users to gracefully shutdown VoIP services on Cisco H.323 and Session Initiation Protocol (SIP) gateways.

Feature Specifications for the Gateway Codec Order Preservation and Shutdown Control Feature

Feature History
 
Release
Modification

12.3(1)

This feature was introduced.

Supported Platforms

Cisco 2600 series, Cisco 3600 series, Cisco 3700 series, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, Cisco AS5850


Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

•Information About Gateway Codec Order Preservation

•Information About Gateway Shutdown Control

•How to Shutdown or Enable VoIP Services on a Cisco Gateway

•Additional References

•Command Reference

Information About Gateway Codec Order Preservation

Codec order preservation enables a Cisco gateway to pass codec preferences to the terminating leg of a VoIP call. This feature was developed primarily for Cisco Multiservice IP-to-IP Gateways (IPIPGW), which are configured to use a transparent codec. The transparent codec enables an IPIPGW to pass codecs from the originating endpoint to the terminating endpoint, however, previous versions of the IPIPGW did not preserve the preferential order of the codecs.

With codec order preservation, the IPIPGW passes codecs transparently from the originating device, listed in order of preference, to the terminating device. It also enables Cisco gateways to pass user-configured codecs in their preferred order when the endpoints exchange capabilities, enabling endpoints to use the codec that best suits both devices.

Codec order preservation is enabled by default in Cisco gateways running Cisco IOS Release 12.3(1) and later releases. No further configuration is needed.

Information About Gateway Shutdown Control

Shutdown control enables administrators to shut down VoIP service on live Cisco H.323 and SIP gateways. You can shut down a gateway in one of two ways:

•Graceful shutdown—New calls are refused, and all in-progress calls are allowed to complete before the gateway unregisters with gatekeepers.

•Forced shutdown—New calls are refused, all in-progress calls are immediately terminated, and the gateway unregisters with gatekeepers.

Shutdown control introduces two new voice service commands. The shutdown command shuts down all VoIP services on the gateway. The call service stop command shuts down only a submode of VoIP calls. For example, you can use the call service stop command to shut down only H.323 calls, leaving SIP call processing unaffected on the gateway. The default shutdown behavior for both commands is graceful, meaning the gateway will allow all calls to clear normally before shutting down. Both commands can be used with the forced keyword, which causes the gateway to terminate all calls at once.

A gateway's shutdown status is stored in nonvolatile RAM (NVRAM), so a gateway remains out of service following a reload or power off. The gateway resumes processing new calls only when you enter the appropriate no shutdown or no call service stop command.

Note The use of call service stop overrides the functionality of the shutdown command for the affected submode. For example, if no call service stop is entered under the H323 submode, the shutdown command only affects the processing of SIP calls.

Shutdown Behavior in H.323 Networks

When you initiate a shutdown, be it graceful or forced, the gateway sends a Resource Availability Indicator (RAI) message to the gatekeeper with the AlmostOutOfResources field flagged. This message prevents the gatekeeper from routing new calls to the gateway. If the gateway is configured to report call capacities, the gateway reports zero capacity in the RAI message.

You can use maintain-registration keyword with the call service stop command to force the gateway to remain registered with the gatekeeper.

Note The maintain-registration keyword is available only on H.323 gateways.

Shutdown Behavior in SIP Networks

The shutdown of call processing on a SIP gateway causes the SIP subsystem to reject all new incoming or outgoing call attempts. Unlike H.323 gateways, a SIP gateway has no means of notifying location servers that it is shutting down. The SIP subsystem continues to run on the gateway, rejecting any new call attempts received during the shutdown period.

How to Shutdown or Enable VoIP Services on a Cisco Gateway

This section contains the following procedures:

•Shutting Down and Enabling VoIP Service on Cisco Gateways (optional)

•Shutting Down and Enabling VoIP Submodes on Cisco Gateways (optional)

•Verifying Gateway Status

Shutting Down and Enabling VoIP Service on Cisco Gateways

To shut down or enable all VoIP services on a Cisco gateway, use the following commands:

SUMMARY STEPS

1. enable

2. configure terminal

3. voice service voip

4. [no] shutdown

DETAILED STEPS

 
Command or Action
Purpose

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 

voice service voip

Example:

Router# voice service voip

Enters Voice Service VoIP configuration mode.

Step 4 

[no] shutdown [forced]

Example:

Router# shutdown forced

Shuts down or enables VoIP call services.

Shutting Down and Enabling VoIP Submodes on Cisco Gateways

SUMMARY STEPS

1. enable

2. configure terminal

3. voice service voip

4. h323 | sip

5. [no] call service stop

DETAILED STEPS

 
Command or Action
Purpose

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 

voice service voip

Example:

Router# voice service voip

Enters Voice Service VoIP configuration mode.

Step 4 

h323

or

sip

Example:

Router# h323

Selects the appropriate call processing submode.

Step 5 

[no] call service stop [forced] [maintain-registration]

Example:

Router# call service stop maintain-registration

Shuts down or enables VoIP call services for the selected submode.

Verifying Gateway Status

The following sections show how to verify whether a Cisco gateway is enabled or shut down:

•Verifying H.323 Gateway Status

•Verifying SIP Gateway Status

Verifying H.323 Gateway Status

The following example displays output for the show gateway command after the gateway has been shut down: 

Router# show gateway 

H.323 ITU-T Version: 4.0   H323 Stack Version: 0.1 

 H.323 service is shutdown 

 Gateway  Router is not registered to any gatekeeper


The following example displays output for the show gateway command after a graceful shutdown with calls in progress: 

Router# show gateway 

H.323 ITU-T Version: 4.0   H323 Stack Version: 0.1 

 H.323 service is shutting down 

 Gateway  Router is registered to Gatekeeper GK1


The following example displays output for the show gateway command when H.323 call service has been shut down with the call service stop maintain-registration command: 

Router# show gateway 

H.323 ITU-T Version: 4.0   H323 Stack Version: 0.1 

 H.323 service is shutdown 

 Gateway  Router is registered to Gatekeeper GK1

Verifying SIP Gateway Status

The Codec Order Preservation and Shutdown Feature adds a new command, show sip service, that enables you to verify the status of a SIP gateway. The following example displays output for the show sip service command when SIP call service is enabled: 

Router# show sip service

SIP Service is up


The following example displays output for the show sip service command when SIP call service is shut down with the shutdown command: 

Router# show sip service

SIP service is shut globally

under 'voice service voip'


The following example displays output for the show sip service command when SIP call service is shut down with the call service stop command: 

Router# show sip service

SIP service is shut

under 'voice service voip', 'sip' submode

The following example displays output for the show sip service command when SIP call service is shut down with the shutdown forced command: 

Router# show sip service

SIP service is forced shut globally

under 'voice service voip'


The following example displays output for the show sip service command when SIP call service is shut down with the call service stop forced command: 

Router# show sip service

SIP service is forced shut

under 'voice service voip', 'sip' submode

Additional References

For additional information related to Codec Order Preservation and Shutdown Control, refer to the following references:

Related Documents

Related Topic
Document Title

Cisco Multiservice IP-to-IP Gateways

Cisco Multiservice IP-to-IP Gateway Application Guide

Cisco IOS voice configuration library

Cisco IOS Voice Configuration Library, Release 12.3


Standards

Standards
Title

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

 

MIBs

MIBs
MIBs Link

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

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

RFCs
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

Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/public/support/tac/home.shtml


Command Reference

This section documents new commands. All other commands used with this feature are documented in the Cisco IOS Release 12.3 voice command reference publications.

•call service stop

•show sip service

•shutdown (gateway)

call service stop

To shut down VoIP call service under the H.323 or SIP submode on a gateway, use the call service stop command in voice service configuration mode. To enable VoIP call service, use the no form of this command.

call service stop [forced] [maintain-registration]

no call service stop

Syntax Description

forced

(Optional) Forces the gateway to immediately terminate all in-progress calls.

maintain-registration

(Optional) Forces the gateway to remain registered with the gatekeeper.


Usage Guidelines

The call service stop command affects call processing only for the given submode. This command overrides the functionality of the shutdown command for the affected submode.

Defaults

Call service is enabled

Command Modes

Voice service configuration

Command History

Release
Modification

12.3(1)

This command was introduced.


Examples

The following example shows SIP call service being shutdown on a Cisco gateway: 

enable

 configure terminal

 voice service voip

 sip

 call service stop


The following example shows H.323 call service being enabled on a Cisco gateway: 

enable

 configure terminal

 voice service voip

 h323

 no call service stop

Related Commands

Command
Description

shutdown (gateway)

Shuts down call processing on the gateway.


show sip service

To display the status of SIP call service on a SIP gateway, use the show sip service command in voice configuration mode.

show sip service

Syntax Description

This command has no arguments or keywords

Defaults

No default behaviors or values

Command Modes

Voice service configuration

Command History

Release
Modification

12.3(1)

This command was introduced.


Examples

The following example displays output for the show sip service command when SIP call service is enabled: 

Router# show sip service

SIP Service is up

The following example displays output for the show sip service command when SIP call service is shut down with the shutdown command: 

Router# show sip service

SIP service is shut globally

under 'voice service voip'

The following example displays output for the show sip service command when SIP call service is shut down with the call service stop command: 

Router# show sip service

SIP service is shut

under 'voice service voip', 'sip' submode

The following example displays output for the show sip service command when SIP call service is shut down with the shutdown forced command: 

Router# show sip service

SIP service is forced shut globally

under 'voice service voip'

The following example displays output for the show sip service command when SIP call service is shut down with the call service stop forced command: 

Router# show sip service

SIP service is forced shut

under 'voice service voip', 'sip' submode

shutdown (gateway)

To shut down all VoIP call service on a gateway, use the shutdown command in voice service configuration mode. To enable VoIP call service, use the no form of this command.

shutdown [forced]

no shutdown

Syntax Description

forced

(Optional) Forces the gateway to immediately terminate all in-progress calls.


Usage Guidelines

The shutdown command affects call processing on the gateway, except for submodes where [no] call service stop has been entered.

Defaults

Call service is enabled

Command Modes

Voice service configuration

Command History

Release
Modification

12.3(1)

This command was introduced.


Examples

The following example shows VoIP call service being shut down on a Cisco gateway: 

voice service voip

shutdown

The following example shows VoIP call service being enabled on a Cisco gateway: 

voice service voip

no shutdown

Related Commands

Command
Description

call service stop

Shuts down call processing for a given submode.