Table Of Contents

Cisco IOS Voice Commands:
K

keepalive retries

keepalive target

keepalive timeout

keepalive trigger

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 UA configuration mode. To disable the keepalive target command behavior, use the no form of this command.

keepalive target {ipv4: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.
: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 TLS.
udp	(Optional) Sends keepalive packets over User Datagram Protocol (UDP).
secondary	(Optional) Associates the IP version 4 address or the 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 UA configuration

Command History

Release	Modification
12.4(6)T	This command was introduced.

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 interval 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 interval 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.