Cisco IOS XR Session Border Controller Command Reference, Release 3.4
SBC Commands on Cisco IOS XR Software

Table Of Contents

SBC Commands on Cisco IOS XR Software

account

action (CAC)

action (NA-DST)

action (RTG-SRC)

activate

active-cac-policy-set

active-call-policy-set

address ipv4

alias

attach

attach-controllers

authentication endpoint

authentication-key

billing

cache

cac-table

callee-dscp

callee-fax-qos-profile

callee-ip-precedence

callee-ip-TOS

callee-privacy

callee-video-qos-profile

callee-voice-qos-profile

caller-dscp

caller-fax-qos-profile

caller-ip-precedence

caller-ip-TOS

caller-privacy

caller-video-qos-profile

caller-voice-qos-profile

call-policy-set

category (NA-DST)

category (NA-SRC)

clear services

codecs

complete

congestion-cleared

congestion-threshold

control address aaa

control address h248

critical-alarm-threshold

dbe-location-id

deact-mode

description

disabled

dst-adjacency

dscp

dtmf-duration

dtmf-relay

early-media-deny

early-media-direction

early-media-timeout

edit

entry

fast-register disable

fast-register-interval

first-cac-scope

first-cac-table

first-call-routing-table

first-number-analysis-table

first-reg-routing-table

h248 allow-all-mg

ip precedence

ip TOS

ipv4 address

ipv4

key

ldr-check

local-address

local-id host

local-port

location-id

major-alarm-threshold

marking

match-account

match-address

match-adjacency

match-number

match-prefix

match-type

match-value

max-bandwidth

max-call-rate

max-channels

max-num-calls

max-reg-rates

max-regs-rate

max-updates

media-address

media-bypass

media-timeout

minor-alarm-threshold

nat-enable

network-id

pause

port

prefix

priority

qos fax

qos video

qos voice

radius

remote-address ipv4

resend

rtp payload-type nte

show services sbc sbe call-policy-set

show services sbc sbe call-policy-sets

show services sbc sbe call-policy-set table entries

show services sbc sbe calls

show services sbc sbe call-stats

show services sbc sbe gates

show services sbc sbe media-gateway-associations

show services sbc sbe media-gateways

show services sbc sbe qos-profiles

show services sbc sbe radius-client-stats

show services sbc sbe radius-server-stats

show services sbc sbe vrf

signaling-address ipv4

signaling-peer

signaling-peer-port

signaling-port

transcode-deny

transcoder

transport

use-any-local-port

vrf (interface)

vrf

vrf vpn-id


SBC Commands on Cisco IOS XR Software


This module describes session border controller (SBC) commands on Cisco IOS XR software.


Note The commands documented in this command reference module use complex modes and submodes. Accordingly, you must be in the correct configuration mode and submode to run each command. The "Examples" section provided for each command shows the hierarchy of modes and submodes required to run the command.


account

To define a SIP or H.323 adjacency account on an SBE, use the account command in the appropriate configuration mode. To remove this definition, use the no form of this command.

account account-name

no account account-name

Syntax Description

account-name

Specifies the SBE account name.


Defaults

No account name is associated with the adjacency.

Command Modes

Adjacency SIP configuration

Adjacency H.323 configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure the H.323 adjacency h323ToIsp42 to account isp42:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# adjacency h323 SipToIsp42
RP/0/0/CPU0:router(config-sbc-sbe-adj-h323)# account isp42

The following example shows how to configure the SIP adjacency SipToIsp42 to account isp42:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# adjacency sip SipToIsp42
RP/0/0/CPU0:router(config-sbc-sbe-adj-sip)# account isp42

action (CAC)

To configure the action to perform after this entry in an admission control table, use the action (CAC) command in CAC configuration mode.

action [cac-complete | next-table goto-table-name | cac-complete]

Syntax Description

cac-complete

When an event matches this CAC policy is complete.

goto-table-name

Specifies the table name identifying the next CAC table to process (or cac-complete, if processing should stop).


Defaults

No default behavior or values

Command Modes

CAC configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure the next table to process for the entry in the new admission control table MyCacTable:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# cac-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe)# first-cac-scope call
RP/0/0/CPU0:router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
RP/0/0/CPU0:router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable match-type src-account
RP/0/0/CPU0:router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
RP/0/0/CPU0:router(config-sbc-sbe-cacpolicy-cactable)# entry 1

Related Commands

Command
Description

action (RTG-SRC)

Configures the action to take if a routing entry is chosen.

action (NA-DST)

Configures the action to perform after an entry in an admission control table.


action (NA-DST)

To configure the action of an entry in the number analysis table with entries of the table matching a dialed number (prefix or whole number) or the source adjacency or account, use the action (NA-DST) command in the appropriate configuration mode. To deconfigure the action, use the no form of this command.

action [next-table goto-table-name | accept | reject]

no action

Syntax Description

next-table goto-table-name

Specifies the next number analysis table to process, if the event matches this entry.

accept

Configures the call to be accepted if it matches the entry in the table.

reject

Configures the call to be rejected if it matches the entry in the table.


Defaults

No default behavior or values

Command Modes

NA-DST-number-table configuration mode

NA-DST-prefix-table configuration mode

NA-SRC-adjacency-table configuration mode

NA-SRC-account-table configuration mode

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure the call to be accepted if it matches the entry in the new number analysis table MyNaTable:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# na-dst-number-table MyNaTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept

The following example shows how to configure the call to be accepted if it matches the start of the entry in the new number analysis table MyNaTable:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# na-dst-prefix-table MyNaTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept

The following example shows how to configure the call to be accepted if it matches the source adjacency entry in the new number analysis table MyNaTable:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# na-src-adjacency-table MyNaTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept

The following example shows how to configure the call to be accepted if it matches the source account entry in the new number analysis table MyNaTable:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# na-src-account-table MyNaTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept

Related Commands

Command
Description

action (RTG-SRC)

Configures the action to take if a routing entry is chosen.

action (CAC)

Configures the action to perform after an entry in an admission control table.


action (RTG-SRC)

To configure the action to take if a routing entry is chosen, use the action (RTG-SRC) command in the appropriate configuration mode. To delete the action, use the no form of this command.

action [next-table goto-table-name | complete | reject]

no action

Syntax Description

next-table goto-table-name

Specifies the next routing table to process if the event matches the entry.

complete

Completes the action. This keyword is supported for rtg-round-robin-table routing tables only.

reject

Rejects the indicated action.


Defaults

No default behavior or values

Command Modes

RTG-SRC-address-table configuration

RTG-SRC-adjacency-table configuration

RTG-SRC-account-table configuration

RTG-round-robin-table configuration

RTG-DST-address-table configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# rtg-src-address-table MyRtgTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 1471
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# rtg-src-adjacency-table MyRtgTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-adjacency 1471
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# rtg-src-account-table MyRtgTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-account 1471
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# rtg-round-robin-table MyRtgTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 1471
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject

The following example configures the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# call-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy)# rtg-dst-address-table MyRtgTable
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 1471
RP/0/0/CPU0:router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action complete

Related Commands

Command
Description

action (NA-DST)

Configures the action of an entry in the number analysis table with entries of the table matching a dialed number (prefix or whole number) or the source adjacency or account.

action (CAC)

Configures the action to perform after an entry in an admission control table.


activate

To initiate the SBC service when all SBE or DBE address configuration have been successfully committed, use the activate command in the appropriate configuration mode. To deactivate the SBE service of the SBC, use the no form of this command.

activate

no activate

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

DBE configuration

SBE configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to activate the DBE on the service mySbc:

RP/0/0/CPU0:router(config)# sbc mySbc dbe 

RP/0/0/CPU0:router (config-sbc-dbe)# activate


The following example shows how to activate the SBE on the service mySbc:

RP/0/0/CPU0:router(config)# sbc mySbc sbe 
RP/0/0/CPU0:router (config-sbc-sbe)# activate

Related Commands

Command
Description

deact-mode

Indicates how to implement the deactivation of an SBE.


active-cac-policy-set

To set the active CAC-policy-set within an SBE entity, use the active-cac-policy-set command in SBE configuration mode. To deconfigure the active policy set, leaving the SBE with no active policy set, use the no form of this command.

active-cac-policy-set policy-set-id

no active-cac-policy-set policy-set-id

Syntax Description

policy-set-id

Integer identifying the policy set that should be made active. Range is 1 to 2147483647.


Defaults

No default behavior or values

Command Modes

SBE configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to activate policy set 1 on mySbc:

RP/0/0/CPU0:router(config)# sbc mySbc sbe 
RP/0/0/CPU0:router (config-sbc-sbe)# active-cac-policy-set 1

active-call-policy-set

To set the active routing policy set within an SBE entity, use the active-call-policy-set command in SBE configuration mode. To deconfigure the active routing policy set, leaving the SBE with no active routing policy set, use the no form of this command.

active-call-policy-set policy-set-id

active-call-policy-set

Syntax Description

policy-set-id

Integer that identifies the policy set that should be made active.
Range is 1 to 2147483647.


Defaults

No default behavior or values

Command Modes

SBE configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If another policy set was previously active, it is made inactive by executing this command. The SBE is created with no active routing policy set; an active routing policy set must be explicitly configured using this 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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to activate policy set 1 on mySbc:

RP/0/0/CPU0:router(config)# sbc mySbc sbe 
RP/0/0/CPU0:router (config-sbc-sbe)# active-call-policy-set 1

address ipv4

To configure the address of the authentication server, use the address ipv4 command in server configuration mode. To remove the address configuration for the authentication server, use the no form of this command.

address ipv4 server-name

no address ipv4 server-name

Syntax Description

server-name

Specifies the DNS name or IP address of the authentication server.


Defaults

No default behavior or values

Command Modes

Server configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

To use this command, you must be in the correct configuration mode and submode. The "Examples" The "Examples" section shows the hierarchy of modes and submodes required to run the command.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure authentication servers acctsvr and acctsvr2 on mySbc for the authentication RADIUS client:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# radius authentication
RP/0/0/CPU0:router(config-sbc-sbe-auth)# server acctsvr
RP/0/0/CPU0:router(config-sbc-sbe-auth-ser)# address ipv4 10.0.0.1
RP/0/0/CPU0:router(config-sbc-sbe-auth-ser)# exit
RP/0/0/CPU0:router(config-sbc-sbe-auth)# server acctsvr2
RP/0/0/CPU0:router(config-sbc-sbe-auth-ser)# address acctsvr2

alias

To configure the endpoint alias of an H.323 adjacency, use the alias command in adjacency H.323 configuration mode. To remove this configuration, use the no form of this command.

alias alias-name

no alias

Syntax Description

alias-name

Specifies the alias of the H.323 adjacency endpoint.


Defaults

No default behavior or values

Command Modes

Adjacency H.323 configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure the H.323 adjacency h323ToIsp42 endpoint alias to foo:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# adjacency h323 h323ToIsp42
RP/0/0/CPU0:router(config-sbc-sbe-adj-h323)# alias foo

Related Commands

Command
Description

attach-controllers

Configures a DBE to attach to a controller.


attach

To attach an adjacency to an account on an SBE, use the attach command in the appropriate configuration mode. To detach the adjacency from an account on an SBE, use the no form of this command.

attach

no attach force

Syntax Description

force

Executes a forced detach.


Defaults

No default behavior or values

Command Modes

Adjacency H.323 configuration

Adjacency SIP configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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 force argument to tear all SBE calls down.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to attach the H.323 adjacency to h323ToIsp42:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# adjacency h323 h323ToIsp42
RP/0/0/CPU0:router(config-sbc-sbe-adj-h323)# attach

attach-controllers

To configure a DBE to attach to a controller, use the attach-controllers command in VDBE configuration mode. To detach from a controller, use the no form of this command.

attach-controllers

no attach-controllers force

Syntax Description

force

Executes a forced detach. In such cases, all calls through this vDBE are immediately torn down.


Defaults

No default behaviour or values

Command Modes

VBDE configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure a DBE to attach to a controller:

RP/0/0/CPU0:router(config)# sbc mySbc dbe vdbe
RP/0/0/CPU0:router(config-sbc-dbe-vdbe)# attach-controllers

authentication endpoint

To configure the H.323 adjacency to use endpoint authentication, use the authentication endpoint command in Adjacency H.323 configuration mode. To remove this configuration, use the no form of this command.

authentication endpoint

no authentication endpoint

Syntax Description

This command has no arguments or keywords.

Defaults

By default, no authentication procedures are performed.

Command Modes

Adjacency H.323 configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure the H.323 adjacency h323ToIsp42 to use endpoint authentication:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# adjacency h323 h323ToIsp42
RP/0/0/CPU0:router(config-sbc-sbe-adj-h323)# authentication endpoint

Related Commands

Command
Description

authentication-key

Configures the H.323 adjacency authentication key.


authentication-key

To configure the H.323 adjacency authentication key, use the authentication-key command in Adjacency H.323 configuration mode. To deconfigure the H.323 adjacency authentication key, use the no form of this command.

authentication-key key

no authentication-key

Syntax Description

key

Specifies the authentication key. (This is valid only when authentication is turned on.)


Defaults

No default behavior or values

Command Modes

Adjacency H.323 configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure H.323 adjacency h323ToIsp42 to use authentication key FG56KJ:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# adjacency h323 h323ToIsp42
RP/0/0/CPU0:router(config-sbc-sbe-adj-h323)# authentication-key FG56KJ

Related Commands

Command
Description

authentication endpoint

Configures an H.323 adjacency to use endpoint authentication.


billing

To configure local and remote billing policies, use the billing command in SBE configuration mode. To reset all parameters to their default values, use the no form of this command.

billing {local | remote}

no billing {local | remote}

Syntax Description

local

Configures local billing policies.

remote

Configures remote billing policies.


Defaults

No default behavior or values

Command Modes

SBE configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to enter the local billing mode for mySbc:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# billing local
RP/0/0/CPU0:router(config-sbc-sbe-lclbill)#

Related Commands

Command
Description

cache

Configures the name of the local or remote directory where to store the billing information.

critical-alarm-threshold

Configures the threshold at which a critical alarm is generated if the CDR file reaches that size.

ldr-check

Configures the time of day to run the long duration check.

local-address

Configures the local IPv4 address.

major-alarm-threshold

Configures the threshold at which a major alarm is generated if the CDR file reaches that size.

minor-alarm-threshold

Configures the threshold at which a minor alarm is generated if the CDR file reaches that size.


cache

To configure the local or remote billing directory where to store the billing records, use the cache command in the appropriate configuration mode. The billing directory is created under the default billing path. To unset the local or remote billing directory, use the no form of this command.

cache name

no cache

Syntax Description

name

Specifies the local or remote billing directory under the default billing path. See Usage Guidelines.


Defaults

The default drives for billing are:

harddisk: for local billing

disk0: for remote billing

After an SBC instance is created:

A predefined billing directory is mounted onto the Replication Data Service File System (RDSFS).

The billing directory name contains a prefix followed by _instance-name.

The billing directory prefix is sbcl for local billing and sbcr for remote billing.

For example, if an SBC instance mysbc is created, the two new RDSFS-mounted billing directories are:

harddisk:/sbcl_mysbc for local billing

disk0:/sbcr_mysbc for remote billing

Command Modes

Billing local configuration

Billing remote configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.1

The path parameter was changed to the name parameter.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to configure a cache named mybillingrecords:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# billing local
RP/0/0/CPU0:router(config-sbc-sbe-lclbill)# cache mybillingrecords

cac-table

To create or configure an admission control table, use the cac-table command in CAC-policy-set configuration mode. To delete the admission control table, use the no form of this command.

cac-table table-name

no cac-table table-name

Syntax Description

table-name

Specifies the admission control table.


Defaults

No default behavior or values

Command Modes

CAC-policy-set configuration

Command History

Release
Modification

Release 3.4.0

No modification.

Release 3.3.0

This command was introduced on the Cisco XR 12000 Series Router.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

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.

Task ID
Task ID
Operations

sbc

read, write

firewall

read, write


Examples

The following example shows how to create the admission control table MyCacTable:

RP/0/0/CPU0:router(config)# sbc mySbc sbe
RP/0/0/CPU0:router(config-sbc-sbe)# cac-policy-set 1
RP/0/0/CPU0:router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
RP/0/0/CPU0:router(config-sbc-sbe-cacpolicy-cactable)# 

Related Commands

Command
Description