Table Of Contents
local-address ipv4 (packet-cable)
h225 timeout
To configure the H.225 timeout interval, use the h225 timeout command in the appropriate configuration mode. To return to the default value, use the no form of this command.
h225 timeout {setup | proceeding | establishment} value
no h225 timeout {setup | proceeding | establishment} value
Syntax Description
Command Default
No default behavior or values
Command Modes
Adjacency H.323 configuration (config-sbc-sbe-adj-h323)
H.323 configuration (config-sbc-sbe-h323)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the h225 timeout command configures an H.225 timeout interval in adjacency H.323 configuration mode:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency h323 h323ToIsp42Router(config-sbc-sbe-adj-h323)# h225 timeout setup 30Router(config-sbc-sbe-adj-h323)# h225 timeout proceeding 30Router(config-sbc-sbe-adj-h323)# h225 timeout establishment 30The following example shows how the h225 timeout command configures an H.225 timeout interval in H.323 configuration mode:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# h323Router(config-sbc-sbe-h323)# h225 timeout setup 30Router(config-sbc-sbe-h323)# h225 timeout proceeding 30Router(config-sbc-sbe-h323)# h225 timeout establishment 30h245-address-pass
To specify when an H.245 address is passed to the caller when the caller does not support tunneling, use the h245-address-pass command in the vDBE configuration mode. To return to the default value, use the no form of this command.
h245-address-pass {immediate | wait-connect}
no h245-address-pass {immediate | wait-connect}
Syntax Description
immediate
Pass H.245 address immediately to caller.
wait-connect
Pass H.245 address to caller until call is connected.
Defaults
Default value is immediate.
Command Modes
vDBE configuration (config-sbc-dbe-vdbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the vDBE H.248 Ia profile to interoperate with the media gateway controller (SBE):
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency h323 adj1Router(config-sbc-sbe-adj-h323)# signaling-address ipv4 10.140.90.20
Router(config-sbc-sbe-adj-h323)# signaling-port 1720
Router(config-sbc-sbe-adj-h323)# remote-address ipv4 172.16.100.107 255.255.255.255
Router(config-sbc-sbe-adj-h323)# signaling-peer 172.16.100.107
Router(config-sbc-sbe-adj-h323)# signaling-peer-port 1720
Router(config-sbc-sbe-adj-h323)# dbe-location-id 4294967295
Router(config-sbc-sbe-adj-h323)# h245-address-pass wait-connect
Router(config-sbc-sbe-adj-h323)# attach
Related Commands
h245-tunnel disable
To disable H.245 tunneling on a per-adjacency basis, use the h245-tunnel disable command in adjacency H.323 configuration mode. To enable tunneling, use the no form of this command.
h245-tunnel disable
no h245-tunnel disable
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
Adjacency H.323 configuration (config-sbc-sbe-adj-h323)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the h245-tunnel disable command disables H.245 tunneling on an H.323 adjacency named H323ToIsp42:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency h323 H323ToIsp42Router(config-sbc-sbe-adj-h323)# h245-tunnel disableh248 allow-all-mg
To configure the H.248 signaling stack to allow connections from all Media Gateways, use the h248 allow-all-mg command in the SBE configuration mode. Use the no form of this command to deconfigure the H.248 signaling stack from allowing connections from all media gateways,
h248 allow-all-mg
no h-248 allow-all-mg
Syntax Description
This command has no arguments or keywords.
Defaults
Default is the no form of this command
Command Modes
SBE configuration (config-sbc-sbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command configures the H.248 signaling stack to allow any Media Gateway to connect to the SBE:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# h248 allow-all-mgRouter(config-sbc-sbe)#h248-profile
To configure the vDBE H.248 profile name to interoperate with the media gateway controller (SBE), use the h248-profile command in the vDBE configuration mode. To return to the default value, use the no form of this command.
h248-profile {etsi-bgf | gatecontrol}
no h248-profile
Syntax Description
etsi-bgf
Configures the Ia profile for ESSI_BGF.
gatecontrol
Configures the Cisco profile for the SBC_GateControl.
Defaults
Default value is gatecontrol.
Command Modes
vDBE configuration (config-sbc-dbe-vdbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. To use this command, you must be in the correct configuration mode and submode. The "Examples" section shows the hierarchy of modes and submodes required to run the command.
Use the h248-profile command to enter vDBE H.248 profile configuration mode.
After the DBE is configured to use the H.248 profile name, the applicable profile name is advertised with the Service Change messages.
Examples
The following example shows how to configure the vDBE H.248 Ia profile to interoperate with the media gateway controller (SBE):
Router# configure terminalRouter(config-sbc)# sbc mysbc dbeRouter(config-sbc-dbe)# vdbeRouter(config-sbc-dbe-vdbe)# h248-profile etsi-bgf
Router(config-sbc-dbe-vdbe-h248-profile)#
Related Commands
h248-profile-version
To configure the vDBE H.248 profile version to interoperate with media gateway controller (SBE), use the h248-profile-version command in the vDBE H.248 profile configuration mode.To return to the default value, use the no form of this command.
h248-profile-version {profile-version}
no h248-profile-version
Syntax Description
profile-version
Version number of the H.248 profile. The values are from 1 to 3. The value of 3 stands for gatecontrol. The value of 1 stands for etsi-bgf.
Defaults
Default value is 3.
Command Modes
vDBE H.248 profile configuration (config-sbc-dbe-vdbe-h248-profile)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. To use this command, you must be in the correct configuration mode and submode. The "Examples" section shows the hierarchy of modes and submodes required to run the command.
Use the h248-profile-version command after you have defined the name of the profile using the h248-profile command.
Examples
The following example shows how to configure the vDBE H.248 profile version to interoperate with the media gateway controller (SBE):
Router# configure terminalRouter(config-sbc)# sbc mysbc dbeRouter(config-sbc-dbe)# vdbeRouter(config-sbc-dbe-vdbe)# h248-profile etsi-bgfRouter(config-sbc-dbe-vdbe-h248-profile)# h248-profile-version 1Related Commands
h248-version
To define the version of an H.248 protocol that the data border element (DBE) uses when it forms associations with an H.248 controller, use the h248-version command in VDBE configuration mode. To leave the default as version 2 of the H.248 protocol, use the no form of this command.
h248-version version-number
no h248-version version-number
Syntax Description
version-number
Specifies the version number. The DBE can accept H.248.1 version 2 or version 3. The default is H.248.1 version 2.
Defaults
H.248.1 version 2 is used.
Command Modes
VDBE configuration mode (config-sbc-dbe-vdbe)
Command History
Cisco IOS XE Release 2.1
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers for distributed SBC.
Usage Guidelines
This command configures the DBE to support H.248.1v3, thus allowing the DBE to interoperate with an SBE or media gateway controller (MGC) which requires H.248.1 version 3. The DBE can accept H.248.1 version 2 or version 3.
The DBE rejects attempts to negotiate with the MGC to a lower version once the DBE is configured to support version 3.
Examples
The following example creates a DBE service on an SBC called "mySbc" and configures the DBE to use version 3 of the H.248.1 protocol, for a distributed SBC:
Router(config)# sbc mySbc dbeRouter(config-sbc-dbe)# vdbeRouter(config-sbc-dbe-vdbe)# h248-version 3Router(config-sbc-dbe-vdbe)# endRelated Commands
h323
To enter the H.323 configuration mode, use the h323 command in SBE configuration mode.
h323
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
SBE configuration (config-sbc-sbe)
Command History
Cisco IOS XE Release 2.4
This command was not supported in Cisco IOS XE Release 2.4 on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to enter the H.323 configuration mode:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# h323Router(config-sbc-sbe-h323)#Related Commands
header
To add a header with a specified name to a SIP message profile, use the header command in SIP header-profile configuration mode. To remove the method from the profile, use the no form of this command.
header header-name
no header header-name
Syntax Description
header-name
Specifies the name of the header added to the header profile. Valid names are 1 to 32 characters in length (inclusive) and are case-sensitive.
Defaults
No default behavior or values
Command Modes
SIP header configuration (config-sbc-sbe-sip-hdr)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the header command adds the header "test" to the header profile MyProfile:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sip header-profile MyProfileRouter(config-sbc-sbe-sip-hdr)# header testRelated Commands
blacklist
Configures SIP header or method blacklist profiles on a SIP message.
description
Configures descriptive text for a SIP header.
header-name
To configure the contact header and passthrough header in non-REGISTER requests, use the header-name command in the adjacency SIP configuration mode. To deconfigure the contact header and passthrough header in non-REGISTER requests, use the no form of this command.
header-name [contact [add [tls-param]] | from{passthrough} | to{passthrough}]
no header-name [contact [add [tls-param]] | from{passthrough} | to{passthrough}]
Syntax Description
Defaults
No default behavior or values
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
This command is used in configuring Aggregate Registration.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the header-name command is used to configure the passthrough header for non-REGISTER requests:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbe-adj-sip)# header-name from passthroughRouter(config-sbe-adj-sip)# header-name to passthroughRelated Commands
request-line request-uri rewrite
Requests the SBC to rewrite the Request-URI to a different user and hostname before sending a request to a registered subscriber.
header-profile
To set a specified header profile for inbound and outbound signaling on a specified SBE SIP adjacency, use the header-profile command in adjacency sip configuration mode.
header-profile {inbound | outbound} profile-name
Syntax Description
Defaults
No default behavior or values
Command Modes
Adjacency sip configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the header-profile command sets header profiles for inbound and outbound signaling on an SBE SIP adjacency test:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip testRouter(config-sbc-sbe-adj-sip)# header-profile inbound Profile1Router(config-sbc-sbe-adj-sip)# header-profile outbound Profile2Router(config-sbc-sbe-adj-sip)#hold-media-timeout
To configure the time an SBE will wait after receiving a media timeout notification from the DBE for an on-hold call before tearing that call down, use the hold-media-timeout command in SBE configuration mode. To set the number to its default, use the no form of this command.
hold-media-timeout timeout
Syntax Description
timeout
Specifies the time in milliseconds an SBE will wait after receiving a media timeout notification from the DBE for an on-hold call before tearing that call down.
Defaults
The default value is 0 milliseconds.
Command Modes
SBE configuration (config-sbc-sbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command configures the SBE to wait two hours after receiving the last media packet on an on-hold call before cleaning up the call resources:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# hold-media-timeout 7200Router(config-sbc-sbe)#hunting-trigger
To configure failure return codes to trigger hunting, use the hunting-trigger command in one of its supported modes: SIP (global SIP scope), H.323 (global H.323 scope), adjacency SIP (destination SIP adjacency), and adjacency h323 (destination H.323 adjacency).
The no form of the command clears all error codes.
If you enter no hunting-trigger x y, then just codes x and y are removed from the configured list.
hunting-trigger {error-codes | disable} error-codes
no hunting-trigger {error-codes | disable} error-codes
Syntax Description
Defaults
No default behavior or values
Command Modes
SBE SIP configuration (sbc-sbe)
H.323 configuration (config-sbc-sbe-h323)
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Adjacency H.323 configuration (config-sbc-sbe-adj-h323)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
If you enter hunting-trigger x followed by hunting-trigger y, the value of x is replaced with y.
To set both x and y to be hunting triggers, you must enter hunting-trigger x y.
To use this command, you must be in the correct configuration mode and submode.
The Examples section shows the hierarchy of modes and submodes required to run the command.
In the adjacency SIP or H.323 adjacency modes, if you specify the special hunting-trigger value of disable, routes are never retried to this adjacency, even if the error code is on the global retry list.
Examples
SIP mode
The following example shows how to configure SIP to retry routing if it receives a 415 (media unsupported) or 480 (temporarily unavailable) error:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter (config-sbc-sbe)# sip hunting-trigger 416 480H.323 mode
The following example shows how to configure H.323 to retry routing if it receives a noBandwidth or securityDenied error:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter (config-sbc-sbe)# h323Router (config-sbc-sbe-h323)# hunting-trigger noBandwidth securityDeniedSIP adjacency mode
The following example shows how to configure SIP to retry routing to the SIP adjacency SipAdj1 if it receives a 415 (media unsupported) or 480 (temporarily unavailable) error:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipAdj1Router(config-sbc-sbe-adj-sip)# hunting-trigger 415 480inherit profile
To configure a global inherit profile for the SIP adjacency, use the inherit profile command in adjacency SIP configuration mode. To deconfigure the global inherit profile, use the no form of this command.
inherit profile {preset-access | preset-core | preset-ibcf-ext-untrusted | preset-ibcf-external | preset-ibcf-internal | preset-p-cscf-access | preset-p-cscf-core | preset-peering | preset-standard-non-ims}
no inherit profile
Syntax Description
Defaults
The default inherit profile setting is preset-core.
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
This adjacency-specific configuration overrides any global configuration of the adjacency that was configured using the sip inherit profile command.
Examples
The following example shows how the sip inherit profile command is used to configure a P-CSCF-access inherit profile on a SIP adjacency:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbe-adj-sip)# inherit profile preset-p-cscf-accessRelated Commands
invite-timeout
To configure the time that SBC waits for a final response to an outbound SIP invite request, use the invite-timeout command in IP timer configuration mode. To return to the default value, use the no form of this command.
invite-timeout {interval-value}
no invite-timeout
Syntax Description
Defaults
The default wait interval is 180 seconds. If no response is received during that time, an internal 408 request timeout response is generated and is sent to the caller.
Command Modes
SIP timer (config-sbc-sbe-sip-tmr)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.
Examples
The following example shows how to configure the SBC to time out invite transactions after 60 seconds:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sip timerRouter(config-sbc-sbe-sip-tmr)# invite-timeout 60Router(config-sbc-sbe-sip-tmr)# exitRelated Commands
udp-response-linger-period
Configures the time period that SBC retains negative UDP responses to invite requests.
ip host
To resolve host names to IP addresses in evaluation cases where a DNS server is not available, use the ip host command in Global configuration mode. To return to the default value, use the no form of this command.
ip host hostname ip_address
no ip host hostname ip_address
Syntax Description
Defaults
The default wait interval is 180 seconds. If no response is received during that time, an internal 408 request timeout response is generated and is sent to the caller.
Command Modes
Global configuration (config)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.
CautionThe ip host command provides a mechanism to resolve host names to IP addresses in evaluation cases where a DNS server is not available. Properly designed networks rely on DNS infrastructure to manage the mapping of host names to IP addresses in a scalable and consistent network-wide manner. Use of the ip host command in conjunction with a DNS server may result in an undesirable result when the local configuration conflicts with the global DNS mapping.
Examples
The following example shows how to configure the SBC to time out invite transactions after 60 seconds:
Router# configureRouter(config)# ip host host_1 172.18.51.20Related Commands
ip precedence
To configure an IP precedence with which to mark IP packets belonging to the given QoS profile, use the ip precedence command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
ip precedence value
no ip precedence
Syntax Description
Defaults
value: 0
Command Modes
Qos sig configuration (config-sbc-sbe-qos-sig)
QoS video configuration (config-sbc-sbe-qos-video)
QoS voice configuration (config-sbc-sbe-qos-voice)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the QoS profile to mark IP packets with a precedence of 1:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# qos sig residentialRouter(config-sbc-sbe-qos-sig)# ip precedence 1Router(config-sbc-sbe-qos-sig)#ip TOS
To configure an IP ToS (type of service) with which to mark IP packets belonging to the QoS profile, use the ip TOS command in the appropriate configuration mode. To return the QoS profile to setting the default IP ToS, use the no form of this command.
ip TOS value
no ip TOS
Syntax Description
Defaults
The default IP ToS is 0 (normal service).
Command Modes
Qos sig configuration (config-sbc-sbe-qos-sig)
QoS video configuration (config-sbc-sbe-qos-video)
QoS voice configuration (config-sbc-sbe-qos-voice)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure an IP TOS:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# qos sig residentialRouter(config-sbc-sbe-qos-sig)# ip tos 12Router(config-sbc-sbe-qos-sig)#ipv4
To create an IPv4 address within a DBE media address pool, use the ipv4 command in media address configuration mode. To delete an IPv4 address within a DBE media address pool, use the no form of this command.
ipv4 ipv4_address [vrf vrf-name]
no ipv4 ipv4_address [vrf vrf-name]
Syntax Description
Defaults
No default behavior or values
Command Modes
Media address (config-sbc-dbe-media-address)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure address 10.0.1.1 for use both for non-VPN media and for media to or from vpn3:
Router# configure terminalRouter(config)# sbc mySbc dbeRouter(config-sbc-dbe)# media-addressRouter(config-sbc-dbe-media-address)# media-address ipv4 10.0.1.1Router(config-sbc-dbe-media-address)# media-address ipv4 10.0.1.1 vrf vpn3ipv4 (blacklist)
To enter the mode for applying blacklisting options to a single IP address or for configuring the default event limits for the source addresses in a given VPN (where the IP address is under the VPN), use the ipv4 command in the SBE blacklist configuration mode. Use the no form of the command to remove the blacklist entry for an address.
ipv4 ip address
Syntax Description
Defaults
No default behavior or values
Command Modes
SBE blacklist configuration (config-sbc-sbe-blacklist)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to enter the mode for applying blacklisting options to a single IP address:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# blacklistRouter(config-sbc-sbe-blacklist)# ipv4 1.1.1.1Router(config-sbc-sbe-blacklist-ipv4)#Related Commands
ipv4 (SBE H.248)
To configure an SBE to use a given IPv4 H.248 control address, use the ipv4 command in H.248 control address configuration mode. To delete a given IPv4 H.248 control address, use the no form of this command.
ipv4 IP address
no ipv4 IP address
Syntax Description
Defaults
No default behavior or values
Command Modes
H.248 control address (config-sbc-sbe-ctrl-h248)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure an SBE to use a given IPv4 H.248 control address:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# control address h248 index 0Router(config-sbc-sbe-ctrl-h248)# ipv4 1.1.1.1Router(config-sbc-sbe-ctrl-h248)#Related Commands
key
To configure the authentication key of the accounting and authentication servers, use the key command in the appropriate server configuration mode. To disable any previously set authentication key, use the no form of this command.
key key
no key
Syntax Description
Defaults
No default behavior or values
Command Modes
Server accounting (config-sbc-sbe-acc-ser)
Server authentication (config-sbc-sbe-auth)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the acctsvr accounting server with the authentication key HJ5689 and acctsvr2 accounting server with the authentication key cisco on mySbc for RADIUS client instance radius1:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# radius accounting radius1Router(config-sbc-sbe-acc)# server acctsvrRouter(config-sbc-sbe-acc-ser)# key HJ5689Router(config-sbc-sbe-acc-ser)# exitRouter(config-sbc-sbe-acc)# server acctsvr2Router(config-sbc-sbe-acc-ser)# key ciscoRouter(config-sbc-sbe-acc-ser)# exitRouter(config-sbc-sbe-acc)# exitRouter(config-sbc-sbe)# exitldr-check
To configure the time of day (local time) to run the Long Duration Check (LDR), use the ldr-check command in SBE billing configuration mode. To return to 00:00, use the no form of this command.
ldr-check {HH MM}
no ldr-check
Syntax Description
HH:MM
Time in hours and minutes using a 24-hour clock. The range of the HH argument is 0 to 23. The range of the MM argument is 0 to 59.
Defaults
HH MM: 00 00
Command Modes
SBE billing configuration (config-sbc-sbe-billing)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.
Examples
The following example shows how to configure the remote long-duration-call check to occur at 10.30 p.m., to specify the time each day when SBC should check for any call whose duration is over 24 hours:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# billingRouter(config-sbc-sbe-billing)# ldr-check 22 30Related Commands
local-address ipv4 (packet-cable)
To configure the local address of the packet-cable billing instance, use the local-address ipv4 command in the packetcable-em configuration mode. To disable the local address, use the no form of this command.
local-address ipv4 A.B.C.D.
no local-address ipv4
Syntax Description
Defaults
0.0.0.0
Command Modes
Packet-cable em configuration (config-sbc-sbe-billing-packetcable-em)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
If no address is configured, the SBC uses any local address.
Examples
The following example shows how to enter the billing mode for mySbc:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# billing(config-sbc-sbe-billing)# packetcable-em 4 transport radius test(config-sbc-sbe-billing-packetcable-em)# local-address ipv4 10.10.10.10Related Commands
local-address ipv4
To configure the local IPv4 address that appears in the CDR, use the local-address ipv4 command in SBE billing configuration mode. To deconfigure the local IPV4 address, use the no form of this command.
local-address ipv4 {A.B.C.D.}
no local-address ipv4
Syntax Description
Defaults
No default behavior or values
Command Modes
SBE billing configuration
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.
Note
Examples
The following example shows how to configure the local-address to 10.20.1.1 for the billing:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# billing remoteRouter(config-sbc-sbe-billing)# local-address ipv4 10.20.1.1Related Commands
local-id host
To configure the local identify name on a SIP adjacency, use the local-id command in adjacency SIP configuration mode. To remove this configuration, use the no form of this command.
local-id host name
no local-id host
Syntax Description
name
Specifies the local identity name to present on outbound SIP messages. This may be a DNS name. This must not contain the port.
Defaults
When the name field is not set, the local signaling address is used in SIP messages.
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to set the SIP local identity of SIP adjacency SipToIsp42 to mcarthur:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbc-sbe-adj-sip)# local-id host mcarthurlocal-port
To configure a data border element (DBE) to use a specific local port when connecting to the default media gateway controller (MGC), use the local-port command in either SBC configuration mode or VDBE configuration mode. To disable this configuration, use the no form of this command.
local-port {abcd}
no local-port {abcd}
Syntax Description
Defaults
Default is to use local port 2944. Note that use-any-local-port should not be used when there is a redundant Session Border Controller (SBC). If it is, the connection to the MGC may be lost with an SBC switch over.
Command Modes
VDBE configuration (config-sbc-dbe-vdbe) for distributed SBC
Command History
Cisco IOS XE Release 2.1
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers for distributed SBC.
Usage Guidelines
The Examples section shows the hierarchy of modes and submodes required to run the command.
The local port cannot be modified after any controller has been configured on the DBE. You must delete the controller before you can modify or configure the local port.
Examples
The following example creates a DBE service on a distributed SBC called mySbc and configures the DBE to use the local port number 5090:
Router# configureRouter(config)# sbc mySbc dbeRouter(config-sbc-dbe)# vdbeRouter(config-sbc-dbe-vdbe)# local-port 5090Router(config-sbc-dbe-vdbe)# endThe following example creates a DBE service on a unified SBC called mySbc and configures the DBE to use the local port number 5090:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc)# vdbeRouter(config-sbc-vdbe)# local-port 5090Router(config-sbc-vdbe)# endRelated Commands
use-any-local-port
Configures a DBE to use any available local port when connecting to the default MGC.
location-id
To configure the location ID for a DBE service of the session border controller (SBC), use the location-id command in SBC-DBE configuration mode. To set the location ID to the default, use the no form of this command.
location-id location-id
no location-id location-id
Syntax Description
Command Default
The default location-id is -1
Command Modes
SBC-DBE configuration (config-sbc-dbe)
Command History
Cisco IOS XE Release 2.1
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
The no form of the command does not take an argument and sets the location-id to the default, which is 0xFFFFFFFF (-1).
A location ID is configured on each DBE. The SBE may associate endpoints with a particular location ID and then use the location IDs to route calls between different DBEs.
Use the dbe command to enter into SBC-DBE configuration mode prior to entering the location-id command.
Examples
The following example creates a DBE service on an SBC called mySbc, enters into SBC-DBE configuration mode, and sets the location ID for a DBE to be 1:
Router# configureRouter(config)# sbc mySbc dbeRouter(config-sbc-dbe)# location-id 1Router(config-sbc-dbe)# exitRelated Commands
dbe
Creates the DBE service on a SBC and enters into DBE-SBE configuration mode.
mandatory-transport
To set the mandatory transport for an adjacency, use the mandatory-transport command in adjacency SIP configuration mode. To enable fast-path register support, use the no form of this command.
mandatory-transport {tcp | udp}
no mandatory-transport {tcp | udp}
Syntax Description
Defaults
Adjacencies use UDP by default.
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Fast-path register is used to prevent the SBC from forwarding all SIP register messages to the softswitch, thus reducing the load on the softswitch. This is enabled by default and can be disabled using this command. When active, a SIP register message received from the same host and port as an existing registration, and with a nonzero expires interval, is immediately responded to without further parsing or other processing performed.
Examples
The following example shows how to configure TCP as the mandatory transport on the SIP adjacency SipToIsp42:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbc-sbe-adj-sip)# mandatory-transport tcpRelated Commands
preferred-transport
Configures the preferred transport protocol for SIP signaling on an adjacency.
map-status-code
To enter the map status code mapping submode, use the map-status-code command in the SIP method-profile element configuration mode.
map-status-code
Syntax Description
method name
Specifies the name of the method added to the method profile. Valid names are 1 to 32 characters in length (inclusive) and are case-sensitive.
Defaults
No default behavior or values
Command Modes
SIP method-profile element configuration (config-sbc-sbe-sip-mth-ele)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the method command adds a method test to the method profile MyProfile:
Router/Admi# configureRouter/Admi(config)# sbc testRouter/Admi(config-sbc)# sbeRouter/Admi(config-sbc-sbe)# sip method-profile mthdprof1Router/Admi(config-sbc-sbe-sip-mth)# method INVITERouter/Admi(config-sbc-sbe-sip-mth-ele)# map-status-code
marking
To configure whether the QoS profile will mark packets with a DSCP value or an IP precedence and ToS value or does no packet marking, use the marking command in the appropriate configuration mode. To remove the QoS policy, use the no form of this command.
marking type
no marking
Syntax Description
Defaults
No default behavior or values
Command Modes
Qos sig configuration (config-sbc-sbe-qos-sig)
QoS video configuration (config-sbc-sbe-qos-video)
QoS voice configuration (config-sbc-sbe-qos-voice)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the QoS profile to mark IP packets with DSCPs:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# qos sig residentialRouter(config-sbc-sbe-qos-sig)# marking dscpmatch-account
To configure the match account of an entry in the number analysis or routing table whose entries match against the source account, use the match-account command in routing table entry configuration mode. To delete the match value, use the no form of this command.
match-account key
no match-account key
Syntax Description
Defaults
No default behavior or values
Command Modes
Routing table entry (config-sbc-sbe-rtgpolicy-rtgtable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to create an entry in the new number analysis table MyNaTable and sets the source account it matches against:
Router# configureAdmin/Router(config)# sbc mySbc sbeAdmin/Router(config-sbc-sbe)# call-policy-set 1Admin/Router(config-sbc-sbe-rtgpolicy)# na-src-account-table MyNaTableAdmin/Router(config-sbc-sbe-rtgpolicy-natable)# entry 1Admin/Router(config-sbc-sbe-rtgpolicy-natable-entry)# match-account router_easternmatch-address
To configure the match value of an entry in a routing table whose entries match against the destination or source dialed number, use the match-address command in routing table entry configuration mode. To delete the match value, use the no form of this command.
match-address key
no match-address key
Syntax Description
Defaults
No default behavior or values
Command Modes
Routing table entry (config-sbc-sbe-rtgpolicy-rtgtable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to create an entry in the new routing table MyRtgTable and sets the dialed number (destination address) it matches against:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-dst-address-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 999match-adjacency
To configure the match value of an entry in a number analysis or routing table whose entries match against the source adjacency, use the match-adjacency command in routing table configuration mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-adjacency key
no match-adjacency key
Syntax Description
Defaults
No default behavior or values
Command Modes
Routing table entry (config-sbc-sbe-rtgpolicy-rtgtable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to create an entry in the new routing table MyRtgTable and sets the source adjacency it matches against:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-src-adjacency-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-adjacency ADJ1match-category
To configure the match value of an entry in a routing table matching on the category, use the match-category command in routing table configuration mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-category WORD
no match-category WORD
Syntax Description
Defaults
No default behavior or values
Command Modes
Routing table entry (config-sbc-sbe-rtgpolicy-rtgtable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
You cannot use this command if the table is part of the active policy set.
Examples
The following example configures the match-value of an entry in the new routing table MyRtgTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-category-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-category emergencyRouter(config-sbc-sbe-rtgpolicy-rtgtable)# endRelated Commands
match-cic
To match on the carrier ID code in a routing table, use the match-cic command in routing table entry mode. The no form of the command deletes the precedence of the given entry in the routing table.
match-cic word [any | none]
no match-cic word [any | none]
Syntax Description
word
Match value key; the maximum size is 30 characters.
any
Match any carrier ID (match on any carrier ID present).
none
Match null carrier ID (match if no carrier ID is present).
Command Default
The default precedence of an entry is any.
Command Modes
Routing table entry (config-sbc-sbe-rtgpolicy-rtgtable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following is an example of using the match-cic command match on any carrier ID present.
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-carrier-id-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 2Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-cic anyRelated Commands
match-domain
To create or modify the match domain of an entry in a routing table matching on the source domain, use the match-domain command in call policy routing table mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-domain key
no match-domain key
Syntax Description
Defaults
No default behavior or values
Command Modes
Call policy routing table (config-sbc-sbe-rtgpolicy-rtgtable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
You cannot create or modify the match domain of an entry in a routing table matching on the source domain if the table is part of the active policy set.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command configures the match-domain of an entry in the new routing table MyRtgTable to be cisco.com:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-src-domain-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-domain cisco.comRouter(config-sbc-sbe-rtgpolicy-rtgtable-entry)# exitRouter(config-sbc-sbe-rtgpolicy-rtgtable)# exitRouter(config-sbc-sbe-rtgpolicy)# exitRelated Commands
match-number
To configure the match value of an entry in the number analysis table whose entries match against the whole dialed number, use the match-number command in NA-DST-number-table configuration mode. To delete the match value, use the no form of this command.
match-number key
no match-number key
Syntax Description
Defaults
No default behavior or values
Command Modes
NA-DST-number-table configuration (config-sbc-sbe-rtgpolicy-natable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to create an entry in the new NA table MyNaTable and sets the dialed number it matches against:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# na-dst-number-table MyNaTableRouter(config-sbc-sbe-rtgpolicy-natable)# entry 1Router(config-sbc-sbe-rtgpolicy-natable-entry)# match-number 9XXXRelated Commands
caller-video-qos-profile
Configures the action of an entry in a number analysis table.
match-prefix
To configure the match value of an entry in the number analysis table whose entries match against the start of the dialed number, use the match-prefix command in SBE routing policy number analysis table entry configuration mode. To delete the match value, use the no form of this command.
match-prefix word
no match-prefix word
Syntax Description
word
Value of prefix string used to match the start of the dialed number. Maximum size is 32 characters.
Defaults
No default behavior or values
Command Modes
Number analysis table configuration (config-sbc-sbe-rtgpolicy-natable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. To use this command, you must be in the correct configuration mode and submode. The "Examples" section shows the hierarchy of modes and submodes required to run the command.
Use the match-prefix command to configure number analysis destination prefix tables.
Examples
The following example shows how to create an entry in the new NA table MyNaTable and sets the dialed number prefix it matches against:
Router# configureRouter(config)# sbc mySbc sbeRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# na-dst-prefix-table MyNaTableRouter(config-sbc-sbe-rtgpolicy-natable)# entry 1Router(config-sbc-sbe-rtgpolicy-natable-entry)# match-prefix *X*Related Commands
match-prefix len
To configure the match value of an entry in a routing table matching on the prefix length (netmask), use the match-prefix len command in CAC table entry configuration mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-prefix-len length
no match-prefix-len length
Syntax Description
Defaults
0
Command Modes
CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example configures the match-value of an entry in the new routing table MyRtgTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-category-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-prefix-len 24Router(config-sbc-sbe-rtgpolicy-rtgtable)# endRelated Commands
Related Commands
match-string
To configure an SDP attribute matching string, use the match-string command in sdp match table configuration mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-string word
no match-string word
Syntax Description
Defaults
No default behavior or values
Command Modes
sdp match table configuration (config-sbc-sbe-sdp-match-tbl)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example configures the match-value of an entry in the new routing table MyRtgTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sdp-match-table 1Router(config-sbc-sbe-sdp-match-tbl)# match-string X-sqnRelated Commands
match-table
To configure an SDP match table used in a policy, use the match-table command in SDP policy table configuration mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-table word
no match-table word
Syntax Description
Defaults
No default behavior or values
Command Modes
SDP policy table (config-sbc-sbe-sdp-policy-tbl)#
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example configures the match-value of an entry in the new routing table MyRtgTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sdp-policy-table policytab2Router(config-sbc-sbe-sdp-policy-tbl)# match-table matchtab2Related Commands
match-time
To configure the match time of an entry, use the match-time command in routing table entry configuration mode. To delete the match value of the given entry in the routing table, use the no form of this command.
match-time {[date yr year_low year_high mon month_low month_high day date_low date_high] [dow DoW_low DoW_high] [tod hr hour_low hour_high min minute_low minute_high]}
no match-time {[date yr year_low year_high mon month_low month_high day date_low date_high] [dow DoW_low DoW_high] [tod hr hour_low hour_high min minute_low minute_high]}
Syntax Description
Defaults
No default behavior or values
Command Modes
Routing table entry (config-sbc-sbe-rtgpolicy-rtgtable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
You are not allowed to use this command if the table is part of the active policy set.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example configures the match-value of an entry in the new routing table MyRtgTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# rtg-category-table MyRtgTableRouter(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-time y:2006-2020Router(config-sbc-sbe-rtgpolicy-rtgtable)# endRelated Commands
match-value
To configure the match-value of an entry in a Call Admission Control (CAC) Limit table, use the match-value command in CAC table entry configuration mode. To delete the match value in the given entry in the CAC Limit table, use the no form of this command.
match-value key
no match-value key
Syntax Description
key
Specifies the keyword used to match events. The format of the key is determined by the table-type. If you configure either an event-type or call-priority Limit table, then you only see the keyword options that apply for that type of Limit table.
For Limit event-type tables (table-type limit event-type), the match value keyword options are the following:
call-update—Compare the beginning of the calling number string.
endpoint-reg—Compare the name of the destination adjacency.
new-call—Compare the beginning of the dialed digit string.
For Limit call-priority tables (table-type limit call-priority), the match value keyword options are the following:
critical—Match calls with resource priority 'critical'.
flash—Match calls with resource priority 'flash'.
flash-override—Match calls with resource priority 'flash-override'.
immediate—Match calls with resource priority 'immediate'.
priority—Match calls with resource priority 'priority'.
routine—Match calls with resource priority 'routine'.
For all other Limit tables, enter a name or digit string.
WORD—Name or digit string to match. (Max Size 255).
For a description of the match values associated with each Limit table type, see Table 12-4 of the "Implementing Cisco Unified Border Element (SP Edition) Policies" chapter in the Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model.
Defaults
No default behavior or values
Command Modes
CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
The match-value command can only be used with a Limit table type.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the match-value for an entry in the CAC Limit table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-scope globalRouter(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit event-typeRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value call-updateThe following example shows how to configure a match-value string option for an entry in the CAC Limit table OneCacTable
Router(config)# sbc SBC1Router(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 5Router(config-sbc-sbe-cacpolicy)# cac-table OneCAcTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit adjacencyRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value ?WORD Name or digit string to matchRouter(config-sbc-sbe-cacpolicy-cactable-entry)# match-value SIPP1ARelated Commands
cac-table
Configures admission control tables.
table-type
Configures a CAC table type that enables the priority of the call to be used as a criterion in CAC policy.
max-bandwidth
To configure the maximum bandwidth for an entry in an admission control table, use the max-bandwidth command in CAC table configuration mode. To delete the maximum bandwidth in the given entry in the admission control table, use the no form of this command.
max-bandwidth mbw
no max-bandwidth mbw
Syntax Description
mbw
Positive integer specifying the maximum rate at which call media should be admitted (in bytes per second) at the relevant scope.
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum bandwidth for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-bandwidth 6000000Related Commands
max-call-rate
To configure the maximum call rate for an entry in an admission control table, use the max-call-rate command in CAC table configuration mode. To delete the maximum call rate in the given entry in the admission control table, use the no form of this command.
max-call-rate mcr
no max-call-rate mcr
Syntax Description
mcr
Positive integer specifying the maximum number of calls per minute to permit at the given scope.
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum call rate for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-call-rate 30Related Commands
max-channels
To configure the maximum number of channels for an entry in an admission control table, use the max-channels command in CAC table configuration mode. To delete the maximum number of channels in the given entry in the admission control table, use the no form of this command.
max-channels mc
no max-channels mc
Syntax Description
mc
Positive integer specifying the maximum number of media channels to permit at the relevant scope.
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum number of channels for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-channels 50Related Commands
max-connections
To configure the maximum number of SIP connections that will be made to each remote address, use the max-channels command in SBE configuration mode. To set this to an unlimited number of connections, use the no form of this command.
max-connections number-of-connections
no max-connections number-of-connections
Syntax Description
Defaults
No default behavior or values
Command Modes
SBE configuration (config-sbc-sbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command configures the maximum number of connections to each remote address to 1:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sip max-connections 1Related Commands
max-in-call-rate
To configure the maximum in call rate, use the max-in-call-rate command in CAC table entry configuration mode. To deconfigure the maximum in call rate, use the no form of this command.
max-in-call-rate rate
no max-in-call-rate rate
Syntax Description
Defaults
No limit.
Command Modes
CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command configures the maximum number of connections to each remote address to 1:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-in-call-rate 33Related Commands
max-num-calls
To configure the maximum number of calls of an entry in an admission control table, use the max-num-calls command in CAC table configuration mode. To delete the maximum number of calls in the given entry in the admission control table, use the no form of this command.
max-num-calls mnc
no max-num-calls mnc
Syntax Description
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum number of calls for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-num-calls 50Related Commands
max-out-call-rate
To configure the maximum out call rate, use the max-out-call-rate command in CAC table entry configuration mode. To disable the maximum out call rate, use the no form of this command.
max-out-call-rate rate
no max-out-call-rate rate
Syntax Description
Defaults
No limit.
Command Modes
CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command configures the maximum number of connections to each remote address to 1:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-out-call-rate 33Related Commands
max-regs
To configure the maximum number of subscriber registrations of an entry in an admission control table, use the max-regs command in CAC table configuration mode. To delete the maximum number of subscriber registrations in the given entry in the admission control table, use the no form of this command.
max-regs mr
no max-regs mr
Syntax Description
mrr
Positive integer specifying the maximum number of subscriber registrations to permit at the relevant scope.
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum number of subscriber registrations for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-regs 500Related Commands
max-regs-rate
To configure the maximum call number of subscriber registrations for an entry in an admission control table, use the max-regs-rate command in CAC table configuration mode. To delete the maximum number of subscriber registrations in the given entry in the admission control table, use the no form of this command.
max-regs mrr
no max-regs mrr
Syntax Description
mrr
A positive integer specifying the maximum number of subscriber registrations per minute to permit at the relevant scope. Only one parameter may be supplied for each command.
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
Only one parameter may be supplied for each command.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum registration rate for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbc sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-reg-rates 150Related Commands
max-updates
To configure the maximum call updates for an entry in an admission control table, use the max-updates command in CAC table configuration mode. To delete the maximum call updates in the given entry in the admission control table, use the no form of this command.
max-updates mu
no max-updates mu
Syntax Description
mu
Positive integer specifying the maximum number of updates to call media to permit at the relevant scope.
Defaults
No default behavior or values
Command Modes
CAC table configuration (config-sbc-sbe-cacpolicy-cactable)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum number of call updates for an entry in the new admission control table MyCacTable:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy)# cac-table MyCacTableRouter(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefixRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-updates 500Related Commands
media-address ipv4
To add an IPv4 address to the set of addresses that can be used by the data border element (DBE) as a local media address, use the media-address ipv4 command either in SBC configuration or SBC-DBE configuration mode. To remove an IPv4 address from the set of local media addresses, use the no form of this command.
media-address ipv4 {A.B.C.D} [nat-mode twice-nat | vrf vrf-name | managed-by {dbe | mgc}]
no media-address ipv4 {A.B.C.D} [nat-mode twice-nat | vrf vrf-name | managed-by {dbe | mgc}]
Syntax Description
Command Default
No default behavior or values
Command Modes
SBC configuration (config-sbc) for unified SBC
SBC-DBE configuration (config-sbc-dbe) for distributed SBC
Command History
Usage Guidelines
Use the media-address ipv4 command to configure a local media address for traffic arriving on the DBE for each IP address that you specified under the SBC virtual interface with the ip address command.
Once you have configured a local media address, the media address cannot be modified while the DBE service is active. Deactivate the DBE with the no activate command first.
The media address is a pool of IP addresses on the DBE for media relay functionality. A pool of addresses is defined for the global VPN to which the DBE is attached. All vDBEs within the DBE draw media addresses from this pool.
Examples
The following example for a unified SBC shows that IP address 10.0.1.1, configured on an SBC interface, is used for media traffic arriving on the DBE from the global VPN:
Router(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc)# media-address ipv4 10.0.1.1Router(cfg-sbc-media-address)# endThe following example for a distributed SBC shows that IPv4 address 10.0.1.1, configured on an SBC interface, is the local address used for media traffic arriving on the DBE and it is reserved for Twice-NAT pinholes:
Router(config)# sbc mySbc dbeRouter(config-sbc-dbe)# media-address ipv4 10.0.1.1 managed-by mgc nat-mode twice-natRouter(config-sbc-dbe-media-address)# endThe following example for a distributed SBC shows that IP address 10.0.1.1 (which is an address configured on an SBC interface) is used for media traffic arriving on the DBE from the global VPN:
Router(config)# sbc mySbc dbeRouter(config-sbc-dbe)# media-address ipv4 10.0.1.1Router(config-sbc-dbe-media-address)# endThe following example for a distributed SBC tries to delete the media address 1.1.1.1 before first deactivating the DBE, and receives an error message:
Router(config-sbc-dbe)# no media-address ipv4 1.1.1.1SBC: Unable to delete a media adress whilst the DBE is active.SBC: Please deactivate the DBE and try again.Related Commands
media-address pool ipv4
To create a pool of sequential IPv4 media addresses that can be used by the data border element (DBE) as local media addresses, use the media-address pool ipv4 command either in SBC configuration or SBC-DBE configuration mode. This pool of addresses is added to the set of local media addresses that can be used by DBE. To remove this pool of IPv4 addresses from the set of local media addresses, use the no form of this command.
media-address pool ipv4 {A.B.C.D} {E.F.G.H} [nat-mode twice-nat | vrf vrf-name | managed-by {dbe | mgc}]
no media-address pool ipv4 {A.B.C.D} {E.F.G.H} [nat-mode twice-nat | vrf vrf-name | managed-by {dbe | mgc}]
Syntax Description
Command Default
If a pool of IPv4 media addresses is specified, but the optional parameters are not specified, the following default values are used:
•
•
Command Modes
SBC configuration (config-sbc) for unified SBC
SBC-DBE configuration (config-sbc-dbe) for distributed SBC
Command History
Cisco IOS XE Release 2.1
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Cisco IOS XE Release 2.2
The nat-mode twice-nat keyword was introduced.
Cisco IOS XE Release 2.4
This command was modified for unified SBC.
Usage Guidelines
Depending on whether you are running unified SBC or distributed SBC, use this command in the appropriate configuration mode.
The media address pool size is limited to 1024 IPv4 addresses. If more IPv4 addresses are required, we recommend you create multiple SBC interfaces and then configure the address pools from the subnets on those interfaces.
After you have configured a local media address, the media address cannot be modified while the DBE service is active. Deactivate the DBE with the no activate command before modifying the media-address pool ipv4 specification.
A media address is one of a pool of IP addresses on the DBE that are used for media relay functionality. A pool of addresses is defined for the global VPN to which the DBE is attached. All virtual data border elements (vDBEs) within the DBE draw media addresses from this pool.
Examples
The following example for a unified SBC creates a DBE service on an SBC called "global" and configures addresses from 10.0.2.1 to 10.0.2.10 in the global VRF:
Router(config)# sbc globalRouter(config-sbc)# media-address pool ipv4 10.0.2.1 10.0.2.10 Router(cfg-sbc-media-address-pool)# exitThe following example for a distributed SBC adds IPv4 addresses from 10.0.2.1 to 10.0.2.10 to the media address pool as local addresses, reserved for Twice-NAT pinholes:
Router(config)# sbc mySbc dbe Router(config-sbc-dbe)# media-address pool ipv4 10.0.2.1 10.0.2.10 nat-mode twice-nat Router(config-sbc-dbe-media-address-pool)# exitThe following example for a distributed SBC creates a DBE service on an SBC called "mySbc," enters into SBC-DBE configuration mode, and configures addresses from 10.0.2.1 to 10.0.2.10 in the global VRF:
Router(config)# sbc mySbc dbe Router(config-sbc-dbe)# media-address pool ipv4 10.0.2.1 10.0.2.10 Router(config-sbc-dbe-media-address-pool)# exitThe following example for a distributed SBC creates a DBE service on an SBC called "mySbc," enters into SBC-DBE configuration mode, and configures addresses from 10.0.2.20 to 10.0.2.25 in vpn3:
Router(config)# sbc mySbc dbe Router(config-sbc-dbe)# media-address pool ipv4 10.0.2.20 10.0.2.25 vrf vpn3 Router(config-sbc-dbe-media-address-pool)# exitThe following example for a distributed SBC tries to delete the media address 10.0.2.1 before first deactivating the DBE and receives an error message:
Router(config-sbc-dbe)# no media-address ipv4 10.0.2.1SBC: Unable to delete a media adress whilst the DBE is active.SBC: Please deactivate the DBE and try again.Related Commands
media address preserve
To ensure that media pinholes are preserved for deleted streams so that if a stream is re-enabled, the Cisco Unified Border Element (SP Edition) will re-use the same pinhole, use the media address preserve command in CAC table entry configuration mode. To allow a media pinhole for a deleted stream to be deleted, use the no form of this command.
media address preserve
no media address preserve
Syntax Description
This command has no arguments or keywords.
Command Default
If the media address preserve command is not configured or the no media address preserve command is used, the media pinhole for a deleted stream will be deleted.
Command Modes
CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
The media address preserve command configures the Support Renegotiated Call Over NAT feature. This feature is used to avoid de-allocation of a video pinhole in a Network Address Translation (NAT) scenario where Delta Renegotiation mode is in effect and a video transmission is paused. Although the standard Secure Device Provisioning (SDP) protocol when a video transmission is paused is to set the video stream to "a=inactive" (which indicates that SBC should keep the stream allocated), there are known devices that do not set the video stream to "a=inactive" to pause it. Instead, these devices delete the video stream by setting its port to 0. To ensure that the stream remains allocated and the pinhole is preserved even when the SBC receives a port value of 0 during a media stream renegotiation, you can enable the media address preserve command on a per-call basis.
When the media address preserve command is enabled, stream statistics and SDP billing information will be output at call termination, not at Delta Renegotiation
Examples
The following example ensures that media pinholes are preserved for deleted streams so that if a stream is re-enabled, the Cisco Unified Border Element (SP Edition) will re-use the same pinhole. Note that the media address preserve command is applied on a per-call basis.
Router(config)# sbc mysbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table 1Router(config-sbc-sbe-cacpolicy)# cac-table 1Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-setRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# media address preserveRouter(config-sbc-sbe-cacpolicy-cactable-entry)# action cac completeRouter(config-sbc-sbe-cacpolicy)# completeRouter(config-sbc-sbe)# active cac-policy-set 1Related Commands
media bandwidth-fields ignore
To set the media flag to ignore the b-line and use CODEC to calculate the baseline bandwidth required for the media stream, use the media bandwidth-fields ignore command in the CAC table entry configuration mode. To return to the default state, use the no form of this command.
media bandwidth-fields ignore
no media bandwidth-fields
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to set the AMB_CAC_MEDIA_FLAG_IGN_EXPL_BW media flag to ignore the b-line and use CODEC to calculate the baseline bandwidth required for the media stream:
Router# configure terminalRouter(config)# sbc mysbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# cac-policy-set 1Router(config-sbc-sbe-cacpolicy)# first-cac-table StandardListByAccountRouter(config-sbc-sbe-cacpolicy)# cac-table StandardListByAccountRouter(config-sbc-sbe-cacpolicy-cactable)# table-type policy-setRouter(config-sbc-sbe-cacpolicy-cactable)# entry 1Router(config-sbc-sbe-cacpolicy-cactable-entry)# media bandwidth-fields ignoreRouter(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-completeRouter(config-sbc-sbe-cacpolicy-cactable-entry)# exitRouter(config-sbc-sbe-cacpolicy-cactable)# exitRouter(config-sbc-sbe-cacpolicy-cactable-entry)# completeRelated Commands
show sbc sbe cac-policy-set table entry
Displays detailed information for a given entry in a CAC policy table.
media-bypass
To configure the H.323 or SIP adjacency to allow media traffic to bypass the DBE, use the media-bypass command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
media-bypass
no media-bypass
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Adjacency H.323 configuration (config-sbc-sbe-adj-h323)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
When configured, media traffic for calls originating and terminating on this adjacency flows directly between the endpoints and does not pass through the DBE. When deconfigured, media traffic must always pass through a gateway.
Examples
The following example shows how to allow media traffic for the SIP adjacency SipToIsp42 to bypass a gateway:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbc-sbe-adj-sip)# media-bypassmedia-bypass-forbid
To configure the H.323 or SIP adjacency to forbid media traffic to bypass the DBE, use the media-bypass-forbid command in the appropriate configuration mode. To return to the default state, use the no form of this command.
media-bypass-forbid
no media-bypass-forbid
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Adjacency H.323 configuration (config-sbc-sbe-adj-h323)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to set media traffic for the SIP adjacency SipToIsp42 to bypass a gateway:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbc-sbe-adj-sip)# media-bypass-forbidmedia-gateway
To configure a media gateway, use the media-gateway command in SBE configuration mode. To remove a media gateway configuration, use the no form of this command.
media-gateway ipv4 A.B.C.D
no media-gateway ipv4 A.B.C.D
Syntax Description
Command Default
No default behavior or values
Command Modes
SBE configuration (config-sbc-sbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to access media gateway submode from where you configure a media gateway.
Router# configureRouter(config)# sbc mysbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# media-gateway ipv4 10.0.0.1Router(config-sbc-sbe-mg)#Examples
media-late-to-early-iw
To configure late-to-early media interworking (iw), use the media-late-to-early-iw command in Adjacency SIP configuration mode. To deconfigure late-to-early media interworking (iw), use the no form of this command.
media-late-to-early-iw {incoming | outgoing}
no media-late-to-early-iw {incoming | outgoing}
Syntax Description
incoming
Enable late-to-early media iw for calls from caller on this adjacency.
outgoing
Enable late-to-early media iw for calls to callee on this adjacency.
Command Default
No default behavior or values
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure late-to-early media iw for calls from caller on this adjacency.
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbe-adj-sip)# media-late-to-early-iw incomingExamples
media-timeout
To set the maximum time a DBE waits after receiving the last media packet on a call and before cleaning up the call resources, use the media-timeout command in SBC-DBE configuration mode. To reset the timeout value to the default value of 30 seconds, use the no form of this command.
media-timeout {timeout} first-packet
no media-timeout timeout
Syntax Description
Defaults
The default is 30 seconds if media-timeout is not configured.
Command Modes
SBC-DBE configuration (config-sbc-dbe)
Command History
Cisco IOS XE Release 2.1
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Cisco IOS XE Release 2.2
The first-packet keyword was added.
Usage Guidelines
This command sets the maximum time the DBE waits after receiving the last media packet on a call before the DBE determines that the call has ceased and begins to clear up the call resources and to signal the signaling border element (SBE) to do the same. This command is used when the SBE is not able to clear up the calls itself. The normal method for clearing a call is for the SBE to explicitly signal the DBE.
You can halt detection of the media timeout event with the first-packet keyword of the media-timeout command. The first-packet keyword instructs the DBE to wait until it has received the first packet since the call has been established before starting the media timeout timer to start counting the number of seconds for which it has not seen an SBC packet. By the DBE waiting, SBC packets can continue to be forwarded because there is no media timeout yet. After waiting for the first packet and counting the configured number of seconds, then the DBE generates an alert to the SBE.
Use the sbc dbe command to enter into SBC-DBE configuration mode before using the media-timeout command.
Examples
The following example configures the DBE to wait 10 seconds after receiving the last media packet and before cleaning up the call resources:Router# configure terminalRouter(config)# sbc mySbc dbeRouter(config-sbc-dbe)# media-timeout 10Related Commands
method
To add a method with a specified name to a SIP message profile, use the method command in the SIP method-profile mode. To remove the method from the profile, use the no form of this command.
method method-name
no method method-name
Syntax Description
method name
Specifies the name of the method added to the method profile. Valid names are 1 to 32 characters in length (inclusive) and are case-sensitive.
Defaults
No default behavior or values
Command Modes
SIP method-profile configuration (config-sbc-sbe-sip-mth)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the method command adds a method test to the method profile MyProfile:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sip method-profile MyProfileRouter(config-sbc-sbe-sip-mth)# method test
method-profile
To configure a method profile in the mode of an SBE entity, use the method-profile command in Adjacency SIP configuration mode. To remove the method profile, use the no form of this command.
method-profile {inbound | outbound} profile-name
no method-profile{inbound | outbound}
Syntax Description
Command Default
No default behavior or values
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the method-profile command configures a method profile with the name of test1:
Router# configureRouter(config)# sbc mysbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# method-profile test1
method packetcable-em
To enable the packet-cable billing method, use the method packetcable-em in the SBE billing configuration mode. To disable the packet-cable billing method, use the no form of this command.
method packetcable-em
no method packetcable-em
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
SBE billing configuration (config-sbc-sbe-billing)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to enable the packet-cable billing method:
Router# configureRouter# sbc mySbcRouter(config-sbc)# sbe(config-sbc-sbe)# billing(config-sbc-sbe-billing)# method packetcable-emRelated Commands
mode
To enter a submode for configuring the mode of a RADIUS Authentication server or RADIUS accounting server, use the server mode command in the server authentication mode. To exit the submode for configuring of RADIUS Authentication server mode, use the no form of this command.
mode {local |remote}
no mode {local |remote}
Syntax Description
server-name
Specifies the name of the server.
local
Specifies local authentication.
remote
Specifies remote authentication.
Command Default
No default behavior or values
Command Modes
Server authentication (config-sbc-sbe-auth-ser)
Server accounting (config-sbc-sbe-acc-ser)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure server mode:
Router# configureRouter(configure)# sbc mysbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# radius authenticationRouter(config-sbc-sbe-auth)# server pantherRouter(config-sbc-sbe-auth-ser)# mode localRouter(config-sbc-sbe-auth-ser)#na-dst-number-table
To enter the submode of configuration of a number analysis table within the context of an SBE policy set, use the na-dst-number-table command in SBE callpolicy mode. Use the no form of this command to destroy the number analysis table.
na-dst-number-table table-name
no na-dst-number-table table-name
Syntax Description
table-name
Name of the number analysis table you are creating or of an existing table you are configuring.
Command Default
No default behavior or values
Command Modes
SBE callpolicy (config-sbc-sbe-rtgpolicy)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
The entries of this table match against the whole dialed number. If necessary, a new number analysis table is created. You may not change the configuration of tables in the context of the active policy set.
A number analysis table may not be destroyed if it is in the context of the active policy set.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command creates the NA table MyNaTable with entries matching against the whole dialed number:
Router# configureRouter# sbc mySbcRouter(config-sbc)# sbe(config-sbc-sbe)# call-policy-set 1(config-sbc-sbe-rtgpolicy)# na-dst-number-table MyNaTable(config-sbc-sbe-rtgpolicy-natable)# exit(config-sbc-sbe-rtgpolicy)# exitRelated Commands
na-dst-number-attr-table
To enter the submode of configuration of a number analysis table within the context of an SBE policy set, use the na-dst-number-attr-table command in NA-DST-number-table configuration mode. Use the no form of this command to destroy the number analysis table.
na-dst-number-attr-table table-name
no na-dst-number-attr-table table-name
Syntax Description
table-name
Name of the number analysis table you are creating or of an existing table you are configuring.
Command Default
No default behavior or values
Command Modes
SBE routing policy (config-sbc-sbe-rtgpolicy)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
The entries of this table match against the carrier ID. If necessary, a new number analysis table is created.You may not change the configuration of tables in the context of the active policy set.
A number analysis table may not be destroyed if it is in the context of the active policy set.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following command enters the submode of configuration of a number analysis table na-table within the context of an SBE policy set.
Router# configureRouter# mySbc sbeRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# na-dst-number-attr-table na-tableRouter(config-sbc-sbe-rtgpolicy-natable)#Related Commands
na-dst-prefix-table
To enter the mode in which to configure a number analysis table, with numbers that match the prefix of the dialed number within an SBE policy set, use the na-dst-prefix-table command in SBE callpolicy mode. Use the no form of this command to destroy the number analysis table.
na-dst-prefix-table table-name
no na-dst-prefix-table table-name
Syntax Description
table-name
Name of the number analysis table you are creating or of an existing table you are configuring.
Command Default
No default behavior or values
Command Modes
SBE routing policy (config-sbc-sbe-rtgpolicy)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example illustrates the use of the na-dst-prefix-table command to create a number analysis table called MyNaTable.
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# na-dst-prefix-table MyNaTableRouter(config-sbc-sbe-rtgpolicy-natable)#Related Commands
na-src-account-table
To enter the mode for configuring a number analysis table within an SBE policy set, with entries that match the source account, use the na-src-account-table command in the SBE callpolicy mode. Use the no form of this command to destroy the table.
na-src-account-table table-name
no na-src-account-table table-name
Syntax Description
table-name
Name of the number analysis table within an SBE policy set, with entries matching the source account.
Command Default
No default behavior or values
Command Modes
SBE routing policy (config-sbc-sbe-rtgpolicy)
Command History
Cisco IOS XE Release 2.40.00
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following commands enter the submode for the NA table MyNaTable, or if it does not already exist, it creates it.
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# na-src-account-table MyNaTableRelated Commands
na-src-adjacency-table
To enter the submode of configuration of a number analysis table within the context of an SBE policy set, use the na-src-adjacency-table command in SBE routing policy mode. The no form of this command destroys the number analysis table.
na-src-adjacency-table table-name
no na-src-adjacency-table table-name
Syntax Description
table-name
Name of the number analysis table within an SBE policy set, with entries matching the source account.
Command Default
No default behavior or values
Command Modes
SBE routing policy (config-sbc-sbe-rtgpolicy)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
The entries of this table match against the source adjacency. If necessary, a new number analysis table is created. You may not change the configuration of tables in the context of the active policy set. A number analysis table may not be destroyed if it is in the context of the active policy set.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following commands enter the submode for the NA table MyNaTable with entries matching against the whole dialed number:
Router# configureRouter# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# call-policy-set 1Router(config-sbc-sbe-rtgpolicy)# na-src-adjacency-table MyNaTableRouter(config-sbc-sbe-rtgpolicy-natable)# exitRouter(config-sbc-sbe-rtgpolicy)# exitRelated Commands
nat
To configure a SIP adjacency to assume that all endpoints are behind a NAT device, use the nat command in the SIP adjacency mode. To deconfigure this feature on the SIP adjacency, use the no form of this command.
nat {force-on | force-off}
no nat {force-on | force-off}
Syntax Description
force-on
Sets the SIP adjacency to assume that all endpoints are behind a NAT device.
force-off
Sets the SIP adjacency to assume that the endpoints are not behind a NAT device.
Defaults
The SBC autodetects whether all the endpoints are behind a NAT device.
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how the nat force-on command is used to configure the SIP adjacency to assumes that all endpoints are behind a NAT device:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipToIsp42Router(config-sbe-adj-sip)# nat force-onnetwork-id
To configure the network ID, use the network-id command in SBE configuration mode. To deconfigure the network ID, use the no form of this command.
network-id id
no network-id
Syntax Description
Defaults
No default behavior or values
Command Modes
SBE configuration (config-sbc-sbe)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to set the network ID to 88888:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# network-id 88888option
To add an option to a profile, use the option command in SIP option mode. Use the no form of this command to remove an existing option from this profile.
option opt-name
no option opt-name
Syntax Description
Defaults
The global default is used.
Command Modes
SIP option (sip-opt)
Command History
Cisco IOS XE Release 2.4Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command:
Examples
The following example shows how to add an option to the profile.
Router# configureRouter(config)# sbc sanityRouter(config-sbc)# sbeRouter(config-sbc-sbe)# sip option-profile optpr1Router(config-sbc-sbe-sip-opt)# option opt1option-profile
To set the adjacency to use the specified profile for white/blacklisting options, use the option-profile command. Use the no form of the command to select the default global configuration.
option-profile [ua | proxy] [inbound | outbound] [ prof-name | default]
no option-profile [ua | proxy] [inbound | outbound] [ prof-name | default]
Syntax Description
Defaults
The global default is used.
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
User agent (UA) profiles are applied to Supported and Require headers. Proxy profiles are applied to Proxy-Require headers.
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to set the adjacency to use the specified profile for white/blacklisting options:
Router# configureRouter(config)# sbc sanityRouter(config-sbc)# sbeRouter(config-sbc-sbe)#Router(config)# sbc test sbe adjacency sip Adj1Router(config-sbc-sbe-adj-sip)# option-profile ua inbound OP1Router(config-sbc-sbe-adj-sip)# exitoutbound-flood-rate
To configure the maximum desired rate of outbound request signals on this adjacency (excluding ACK/PRACK requests) in signals per second, use the outbound-flood-rate command in adjacency SIP configuration mode. Use the no form of this command to disable flood protection.
outbound-flood-rate rate
no outbound-flood-rate
Syntax Description
Defaults
No flood protection.
Command Modes
Adjacency SIP configuration (config-sbc-sbe-adj-sip)
Command History
Cisco IOS XE Release 2.4
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
To use this command, you must be in the correct configuration mode and submode. The Examples section shows the hierarchy of modes and submodes required to run the command.
Examples
The following example shows how to configure the maximum desired rate of outbound request signals on this adjacency to 1,000 signals per second:
Router# configureRouter(config)# sbc mySbcRouter(config-sbc)# sbeRouter(config-sbc-sbe)# adjacency sip SipAdj1Router(config-sbc-sbe-adj-sip)# outbound-flood-rate 1000Router(config-sbc-sbe-adj-sip)#overload-time-threshold
To configure the threshold for media gateway (MG) overload control detection, use the overload-time-threshold command in SBC-DBE configuration mode. This threshold defines the maximum delay allowed by a SBC that has subscribed to overload control events for the DBE to add a new flow. If the threshold is exceeded, the DBE generates an overload event notification. To reset the threshold value to its default value of 100 milliseconds, use the no form of this command.
overload-time-threshold time
no overload-time-threshold
Syntax Description
Defaults
If a time threshold value is not configured, the default value is 100 milliseconds.
Command Modes
SBC-DBE configuration (config-sbc-dbe)
Command History
Cisco IOS XE Release 2.1
This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
If an SBC has subscribed for overload control events, the DBE outputs an overload event notification for every request to add a new flow whose execution takes longer than this threshold.
Examples
The following example configures the threshold for media gateway (MG) overload control detections with a value of 400 milliseconds:Router# configure terminalRouter(config)# sbc mySbc dbeRouter(config-sbc-dbe)# overload-time-threshold 400Related Commands
