Cisco IOS Voice Commands:
K


This chapter contains commands to configure and maintain Cisco IOS voice applications. The commands are presented in alphabetical order. Some commands required for configuring voice may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands.

For detailed information on how to configure these applications and features, refer to the Cisco IOS Voice Configuration Guide.

keepalive retries

To set the number of keepalive retries from Skinny Client Control Protocol (SCCP) to Cisco Unified CallManager, use the keepalive retries command in SCCP Cisco CallManager configuration mode. To reset this number to the default value, use the no form of this command.

keepalive retries number

no keepalive retries

Syntax Description

number

Number of keepalive attempts. Range is 1 to 32. Default is 3.


Command Default

3 keepalive attempts

Command Modes

SCCP Cisco CallManager configuration

Command History

Release
Modification

12.3(8)T

This command was introduced.


Usage Guidelines

Use this command to control the number of keepalive retries before SCCP confirms that the Cisco Unified CallManager link is down. When SCCP confirms that the Cisco Unified CallManager link is down (if the number of keepalive messages sent without receiving an Ack reaches the keepalive retries value), Cisco Unified CallManager switchover is initiated.


Note The optimum setting for this command depends on the platform and your individual network characteristics. Adjust the keepalive retries to meet your needs.


Examples

The following example sets the number of times that a Cisco Unified CallManager retries before confirming that the link is down to seven:

Router(conf-sccp-ccm)# keepalive retries 7

Related Commands

Command
Description

keepalive timeout

Sets the length of time between keepalive messages from SCCP to Cisco Unified CallManager.

sccp ccm group

Creates a Cisco CallManger group and enters the SCCP Cisco CallManager configuration mode.


keepalive target

To identify Session Initiation Protocol (SIP) servers that will receive keepalive packets from the SIP gateway, use the keepalive target command in SIP user-agent configuration mode. To disable the keepalive target command behavior, use the no form of this command.

keepalive target {{ipv4:address | ipv6:address}[:port] | dns:hostname} | [tcp [tls]] | [udp] | [secondary]

no keepalive target [secondary]

Syntax Description

ipv4:address

IP address (in IP version 4 format) of the primary or secondary SIP server to monitor.

ipv6:address

IPv6 address of the primary or secondary SIP server to monitor.

:port

(Optional) SIP port number. Default SIP port number is 5060.

dns:hostname

DNS hostname of the primary or secondary SIP server to monitor.

tcp

(Optional) Sends keepalive packets over TCP.

tls

(Optional) Sends keepalive packets over Transport Layer Security (TLS).

udp

(Optional) Sends keepalive packets over User Datagram Protocol (UDP).

secondary

(Optional) Associates the IP version 4 address or the domain name system (DNS) hostname to a secondary SIP server to monitor.


Command Default

No keepalives are sent by default from SIP gateway to SIP gateway. The SIP port number is 5060 by default.

Command Modes

SIP user-agent configuration (config-sip-ua)

Command History

Release
Modification

12.4(6)T

This command was introduced.

12.4(22)T

Support for IPv6 was added.


Usage Guidelines

The primary or secondary SIP server addresses are in the following forms: dns:example.sip.com or ipv4:172.16.0.10.

Examples

The following example sets the primary SIP server address and defaults to the UDP transport:

sip-ua
 keepalive target ipv4:172.16.0.10

The following example sets the primary SIP server address and the transport to UDP:

sip-ua
 keepalive target ipv4:172.16.0.10 udp

The following example sets both the primary and secondary SIP server address and the transport to UDP:

sip-ua
 keepalive target ipv4:172.16.0.10 udp
 keepalive target ipv4:172.16.0.20 udp secondary

The following example sets both the primary and secondary SIP server addresses and defaults to the UDP transport:

sip-ua
 keepalive target ipv4:172.16.0.10
 keepalive target ipv4:172.16.0.20 secondary

The following example sets the primary SIP server address and the transport to TCP:

sip-ua
 keepalive target ipv4:172.16.0.10 tcp

The following example sets both the primary and secondary SIP server addresses and the transport to TCP:

sip-ua
 keepalive target ipv4:172.16.0.10 tcp
 keepalive target ipv4:172.16.0.20 tcp secondary

The following example sets the primary SIP server address and the transport to TCP and sets security to TLS mode:

sip-ua
 keepalive target ipv4:172.16.0.10 tcp tls

The following example sets both the primary and secondary SIP server addresses and the transport to TCP and sets security to the TLS mode:

sip-ua
 keepalive target ipv4:172.16.0.10 tcp tls
 keepalive target ipv4:172.16.0.20 tcp tls secondary

Related Commands

Command
Description

busyout monitor keepalive

Selects a voice port or ports to be busied out in cases of a keepalive failure.

keepalive trigger

Sets the trigger count to the number of Options message requests that must consecutively receive responses from the SIP servers in order to unbusy the voice ports when in the down state.

retry keepalive

Sets the retry keepalive count for retransmission.

timers keepalive

Sets the timers keepalive interval between sending Options message requests when the SIP server is active or down.


keepalive timeout

To set the length of time between keepalive messages from Skinny Client Control Protocol (SCCP) to Cisco Unified CallManager, use the keepalive timeout command in SCCP Cisco CallManager configuration mode. To reset the length of time to the default value, use the no form of this command.

keepalive timeout seconds

no keepalive timeout

Syntax Description

seconds

Time between keepalive messages. Range is 1 to 180. Default is 30.


Command Default

30 seconds

Command Modes

SCCP Cisco CallManager configuration

Command History

Release
Modification

12.3(8)T

This command was introduced.


Usage Guidelines

Whenever SCCP sends the keepalive message to the Cisco Unified CallManager, it initiates this timer. Once the timeout occurs, it sends the next keepalive message unless the number of keepalive (messages without an Ack) reaches the number set by the keepalive retries command. As of now, the SCCP protocol uses the value provided by the Cisco Unified CallManager.


Note The optimum setting for this command depends on the platform and your individual network characteristics. Adjust the keepalive timeout value to meet your needs.


Examples

The following example sets the length of time between Cisco Unified CallManager keepalive messages to 120 seconds (2 minutes):

Router(config-sccp-ccm)# keepalive timeout 120

Related Commands

Command
Description

keepalive retries

Sets the number of keepalive retries from SCCP to Cisco Unified CallManager.

sccp ccm group

Creates a Cisco CallManger group and enters SCCP Cisco CallManager configuration mode.


keepalive trigger

The trigger interval (in seconds) represent the number of Options message requests that must consecutively receive responses from the SIP servers when in the down state in order to unbusy the voice ports, use the keepalive trigger command in SIP UA configuration mode. To restore to the default value of 3 seconds, use the no form of this command.

keepalive trigger seconds

no keepalive trigger seconds

Syntax Description

seconds

Keepalive trigger value in the range from 1 to 10 seconds. The default value is 3 seconds.


Command Default

The default value for the keepalive trigger is 3 seconds.

Command Modes

SIP UA configuration

Command History

Release
Modification

12.4(6)T

This command was introduced.


Usage Guidelines

Sets the time interval (in seconds) to represent the number of Options message requests that must be consecutively receive responses from the SIP servers in order to unbusy the voice ports when in the down state. The keepalive trigger interval is measured in seconds. The default is 3 seconds.

Examples

The following example sets a time interval (in seconds) after the number of Options message requests that must consecutively receive responses from the SIP servers in order to unbusy the voice ports when in the down state. The trigger interval is set to 8 seconds in the following example:

sip-ua
 keepalive trigger 8

Related Commands

Command
Description

busyout monitor keepalive

Selects a voice port or ports to be busied out in cases of a keepalive failure.

keepalive target

Identifies a SIP server that will receive keepalive packets from the SIP gateway.

retry keepalive

Sets the retry keepalive interval for retransmission.

timers keepalive

Sets the time interval between sending Options message requests when the SIP server is active or down.