Table Of Contents

SBC Billing Commands on Cisco IOS XR Software

activate (SBC SBE billing)

billing

ldr-check

local-address ipv4 (SBC SBE billing)

show services sbc sbe billing remote

SBC Billing Commands on Cisco IOS XR Software

---

This module describes the billing commands used to configure and monitor the Session Border Controller (SBC).

For detailed information about SBC concepts, configuration tasks, and examples, refer to Cisco IOS XR Session Border Controller Configuration Guide.

activate (SBC SBE billing)

To activate the billing instance after configuration is committed, use the activate command in SBE remote billing configuration mode.

activate

Syntax Description

This command has no arguments or keywords.

Defaults

By default, remote billing is not activated.

Command Modes

SBE remote billing configuration

Command History

Release	Modification
Release 3.7.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 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.

You can activate billing only after the RADIUS configuration has been activated.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to activate the billing instance after configuration is committed:

RP/0/0/CPU0:router# configure

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

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

RP/0/0/CPU0:router(config-sbc-sbe)# billing remote

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

billing

To configure 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 {remote}

no billing {remote}

Syntax Description

remote

Configures remote billing policies.

Defaults

No default behavior or values

Command Modes

SBE configuration

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	Support was added for the following modifications: •The local keyword was removed. •SBE local billing configuration command mode was removed. •Caching was no longer supported.

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

Use the billing command to enter SBE remote billing configuration mode.

The Remote Authentication Dial-in User Service (RADIUS) client must be configured before configuring remote billing. The remote billing configuration must be deleted before the RADIUS client configuration is deleted.

If the RADIUS server goes down, you must manually reactive it by performing the following procedure:

1. Deactivate billing as shown in the following example:

configure

 sbc mySbc

  sbe

   billing remote

    no activate

    commit

2. Deactivate RADIUS as shown in the following example:

configure

 sbc mySbc

  sbe

   radius accounting cisco

    no activate

    commit

3. Activate RADIUS as shown in the following example:

configure

 sbc mySbc

  sbe

   radius accounting cisco

    activate

    commit

4. Activate billing as shown in the following example:

configure

 sbc mySbc

  sbe

   billing remote

    activate

    commit

---

Note When you configure RADIUS, you must also configure billing. If you have not reconfigured billing and want to reconfigure RADIUS, you may be prevented from committing the new configuration. If so, perform the following workaround:

1. Shut down the SBC process by using the process shutdown command in EXEC mode, as shown in the following example:

process shutdown sbc location all

For more information about the process shutdown command, refer to Cisco IOS XR System Management Command Reference.

2. Reconfigure RADIUS.

3. Restart the SBC process by using the process restart command in EXEC mode, as shown in the following example:

process restart sbc location all

For more information about the process shutdown command, refer to Cisco IOS XR System Management Command Reference.

---

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to enter the SBE remote billing configuration mode for mySbc:

RP/0/0/CPU0:router# configure

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

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

RP/0/0/CPU0:router(config-sbc-sbe)# billing remote

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

Related Commands

Command	Description
activate (SBC SBE billing)	Activates the billing instance after configuration is committed.
ldr-check	Configures the time of day to check any call that lasts longer than 24 hours.
local-address ipv4 (SBC SBE billing)	Configures the local IPv4 address that appears in the CDR.
show services sbc sbe billing remote	Displays the local and remote billing configurations.

ldr-check

To configure the time of day to check any call that lasts longer than 24 hours, use the ldr-check command in SBE remote billing configuration mode. To return to the default, 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: 0

Command Modes

SBE remote billing configuration

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

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

Task ID

Task ID	Operations
sbc	read, write

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:

RP/0/0/CPU0:router# configure

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

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

RP/0/0/CPU0:router(config-sbc-sbe)# billing remote

RP/0/0/CPU0:router(config-sbc-sbe-rmtbill)# ldr-check 22:30

Related Commands

Command	Description
activate (SBC SBE billing)	Activates the billing instance after configuration is committed.
billing	Configures remote billing policies.
local-address ipv4 (SBC SBE billing)	Configures the local IPv4 address that appears in the CDR.
show services sbc sbe billing remote	Displays the local and remote billing configurations.

local-address ipv4 (SBC SBE billing)

To configure the local IPv4 address that appears in the CDR, use the local-address ipv4 command in SBE remote billing configuration mode. To deconfigure the local IPV4 address, use the no form of this command.

local-address ipv4 {ipv4_IP_address}

no local-address ipv4

Syntax Description

ipv4_IP_address

Local IPv4 address to be configured.

Defaults

No default behavior or values

Command Modes

SBE remote billing configuration

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

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 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 This field cannot be reconfigured when billing is active.

---

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure the local-address to 10.20.1.1 for the remote billing:

RP/0/0/CPU0:router# configure

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

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

RP/0/0/CPU0:router(config-sbc-sbe)# billing remote

RP/0/0/CPU0:router(config-sbc-sbe-rmtbill)# local-address ipv4 10.20.1.1

Related Commands

Command	Description
activate (SBC SBE billing)	Activates the billing instance after configuration is committed.
billing	Configures local and remote billing policies.
ldr-check	Configures the time of day to check any call that lasts longer than 24 hours.
show services sbc sbe billing remote	Displays the local and remote billing configurations.

show services sbc sbe billing remote

To display the remote billing configurations, use the show services sbc sbe billing remote command in EXEC mode.

show services sbc sbc-name sbe billing remote

Syntax Description

sbc-name

Name of the SBC service.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	The show services sbc sbe billing command was replaced by the show services sbc sbe billing remote command.

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

Remote billing requires the control-address configuration and RADIUS-client configuration.

Task ID

Task ID	Operations
sbc	read

Examples

The following sample output shows the remote billing configuration:

RP/0/0/CPU0:router# show services sbc mySbc sbe billing remote

Remote billing

Transport Mechanism Status:     Active

  Resending Status:  Not Resending

  Active Calls Billed: 0

  Local IP address:            10.2.0.200

  billingMethodIpAddrVPN: 0

  Deactivating Method:  Normal

Table 18 describes the significant fields shown in the display.

Table 18 show services sbc sbe billing Field Descriptions 

Field	Description
Transport Mechanism Status	An indication whether the transport mechanism of this instance is currently able to commit records. The following possible states are listed: •Active—Specifies that transport is active. •Down—Specifies that transport is not active. Billing cannot have been activated. •Failed—Specifies that the connection to the RADIUS server is lost.
Active Calls Billed	Number of calls that are currently active and are being billed.
Local IP address	Local IP address that is used within CDRs.
Deactivating Method	Approach taken to deactivate billing when calls are active.

Related Commands

Command	Description
activate (SBC SBE billing)	Activates the billing instance after configuration is committed.
billing	Configures local and remote billing policies.
ldr-check	Configures the time of day to check any call that lasts longer than 24 hours.
local-address ipv4 (SBC SBE billing)	Configures the local IPv4 address that appears in the CDR.