Broadband Network Gateway Command Reference for Cisco ASR 9000 Series Routers

address (DIAMETER)

To configure IPv4 or IPv6 address of DIAMETER peer, use the address command in DIAMETER peer configuration mode. To remove the IPv4 or IPv6 address of DIAMETER peer, use the no form of this command.

address {ipv4 | ipv6} ipaddress

Syntax Description


`ipaddress`	Specifies the IPv4 or IPv6 address of DIAMETER peer.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure an IPv4 address for DIAMETER peer in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# address ipv4 2.2.2.2

clear diameter peer

To reset DIAMETER peer connection in BNG, use the clear diameter peer command in EXEC mode.

clear diameter peer peer-name

Syntax Description


`peer-name`	The DIAMETER peer name.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

This command resets the peer connection. The connection to the peer is re-established after the connection timeout.

Task ID


Task ID	Operation
aaa	write

Examples

This example shows how to reset DIAMETER peer connection in BNG:

RP/0/RSP0/CPU0:router# clear diameter peer peer1

Related Commands

Command	Description
clear diameter statistics	Clears DIAMETER peer statistics in BNG

clear diameter statistics

To clear DIAMETER peer statistics in BNG, use the clear diameter statistics command in EXEC mode.

clear diameter statistics [gx | gy | nas]

Syntax Description


gx	(Optional) Clears the statistics of Gx application.
gy	(Optional) Clears the statistics of Gy application.
nas	(Optional) Clears the statistics of NAS application.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

Executing the clear diameter statistics command without any arguments, clears all the DIAMETER peer statistics.

Task ID


Task ID	Operation
aaa	write

Examples

This example shows how to clear NAS statistics:

RP/0/RSP0/CPU0:router# clear diameter statistics nas

Related Commands

Command	Description
clear diameter peer	Resets DIAMETER peer connection in BNG

destination host

To configure the hostname of the DIAMETER peer in BNG, use the destination host command in DIAMETER peer configuration mode. To remove the hostname of the DIAMETER peer, use the no form of this command.

destination host host-name

Syntax Description


`host-name`	Specifies the hostname of the DIAMETER peer in Fully Qualified Domain Name(FQDN) format. This value is sent in various messages, so that intermediate proxies can route the packets properly.

Command Default

None

Command Modes

DIAMETER peer configuration.

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the hostname of the DIAMETER peer in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# destination host dcca1.cisco.com

Related Commands

Command	Description
destination realm	Configures the realm to which the DIAMETER peer belongs to.

destination realm

To configure the realm to which the DIAMETER peer belongs to, use the destination realm command in DIAMETER peer configuration mode. To remove the realm configuration, use the no form of this command.

destination relam realm-string

Syntax Description


`realm-string`	Specifies the hostname of the DIAMETER peer in Fully Qualified Domain Name(FQDN) format. This value is sent in various messages, so that intermediate proxies can route the packets properly.

Command Default

None

Command Modes

DIAMETER peer configuration.

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

The destination realm is added by the AAA clients while sending a request to AAA server, using AAA_AT_DESTINATION_REALM attribute. If this attribute is not present, then the realm information is retrieved using the User name field. If the clients do not add the attribute, then the value configured in the peer mode is used while sending messages to the destination peer.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the realm to which the DIAMETER peer belongs to:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# destination realm GX_REALM

Related Commands

Command	Description
destination host	Configures the hostname of the DIAMETER peer in BNG.

diameter attribute list

To configure attribute list parameters for DIAMETER test command in BNG, use the diameter attribute list command in Global Configuration mode. To remove this configuration, use the no form of this command.

diameter attribute list list-num [attribute {attr-id | vendor-id vendor-id} attr-format attr-value [mandatory]]

Syntax Description


`list-num`	DIAMETER attribute list number. The range is from 0 to 99.
attribute	Specifies an attribute definition.
`attr-id`	Attribute ID value. The range is from 1 to 65535.
vendor-id	Specifies the vendor ID.
`vendor-id`	Vendor ID value. The range is from 0 to 4294967295.
`attr-format`	Specifies the attribute format. The options are: address binary boolean diameter-identity enum grouped string ulong
`attr-value`	Attribute value as per the attribute format. For boolean, enum and ulong formats, the range is from 0 to 4294967295. For grouped formats, the range is from 0 to 99.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

This command is used along with the test aaa group diameter command, to define the attribute list. Based on the attribute list number, the attributes are sent as part of the test command.

Task ID


Task ID	Operation
config-services	read, write

Examples

This example shows how to configure attribute list parameters for DIAMETER test command in BNG:


RP/0/RSP0/CPU0:router(config)# diameter attribute list 1
RP/0/RSP0/CPU0:router(config-dia-attr-list)# attribute vendor-id 0 8 address 5.6.7.8 mandatory
RP/0/RSP0/CPU0:router(config-dia-attr-list)# attribute vendor-id 0 416 enum 1 mandatory
RP/0/RSP0/CPU0:router(config-dia-attr-list)#  attribute vendor-id 9 14000 string abcd:abcd:abcd

Related Commands

Command	Description
test aaa group diameter	Tests various DIAMETER application behaviors in BNG.

diameter gx

To enable Gx application in BNG under the DIAMETER process, use the diameter gx command in Global Configuration mode. To disable Gx application in BNG, use the no form of this command, followed by a DIAMETER process restart.

diameter gx

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

Note

The no form of this command does not have any impact until followed by a DIAMETER process restart.

The no diameter gx command must not be executed when there are active subscriber sessions on the router.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to enable Gx application in BNG under the DIAMETER process:


RP/0/RSP0/CPU0:router(config)# diameter gx

Related Commands

Command	Description
diameter gy	Enables Gy application in BNG under the DIAMETER process.

diameter gx retransmit

To configure the retransmit count for Gx application, use the diameter gx retransmit command inGlobal Configuration mode. To remove this configuration, use the no form of this command.

diameter gx retransmit count

Syntax Description


`count`	Specifies the value of the retransmit count, in seconds. The range is from 1 to 10; the default is 1.

Command Default

If the retransmit count is not configured, it is 1 second, by default.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to set the retransmit count value to 8 seconds, for Gx application:


RP/0/RSP0/CPU0:router(config)# diameter gx retransmit 8

Related Commands

Command	Description
diameter gy retransmit	Configures the retransmit count for Gy application.

diameter gx tx-timer

To configure the transaction timer for Gx application, use the diameter gx tx-timer command inGlobal Configuration mode. To remove this configuration, use the no form of this command.

diameter gx tx-timer timer-value

Syntax Description


`timer-value`	Specifies the value of the transaction timer in seconds. The range is from 6 to 1000; the default is 15.

Command Default

If the timer value is not configured, it is 15 seconds, by default.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to set the transaction timer value to 7 seconds for Gx application:


RP/0/RSP0/CPU0:router(config)# diameter gx tx-timer 7

Related Commands

Command	Description
diameter gy tx-timer	Configures the transaction timer for Gy application.

diameter gy

To enable Gy application in BNG under the DIAMETER process, use the diameter gy command in Global Configuration mode. To disable Gy application in BNG under the DIAMETER process, use the no form of this command, followed by a DIAMETER process restart.

diameter gy

Syntax Description

Note

The no form of this command does not have any impact until followed by a process restart of DIAMETER process.

The no diameter gy command must not be executed when there are active subscriber sessions on the router.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command is introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to enable Gy application in BNG under the DIAMETER process:


RP/0/RSP0/CPU0:router(config)# diameter gy

Related Commands

Command	Description
diameter gx	Enables Gx application in BNG under the DIAMETER process.

diameter gy retransmit

To configure the retransmit count for Gy application, use the diameter gy retransmit command inGlobal Configuration mode. To remove this configuration, use the no form of this command.

diameter gy retransmit count

Syntax Description


`count`	Specifies the value of the retransmit count, in seconds. The range is from 1 to 10; the default is 1.

Command Default

If the retransmit count is not configured, it is 1 second, by default.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to set the retransmit count to 8 seconds, for Gy application:


RP/0/RSP0/CPU0:router(config)# diameter gy retransmit 8

Related Commands

Command	Description
diameter gx retransmit	Configures the retransmit count for Gx application.

diameter gy tx-timer

To configure the transaction timer for Gy application, use the diameter gy tx-timer command inGlobal Configuration mode. To remove this configuration, enter the no form of this command.

diameter gy tx-timer timer-value

Syntax Description


`timer-value`	Specifies the value of the transaction timer in seconds. The range is from 6 to 1000; the default is 15.

Command Default

If the timer value is not configured, it is 15 seconds, by default.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to set the transaction timer value to 7 seconds for Gy application.


RP/0/RSP0/CPU0:router(config)# diameter gy tx-timer 7

Related Commands

Command	Description
diameter gx tx-timer	Configures the transaction timer for Gx application.

diameter origin host

To configure the origin host information of DIAMETER server in BNG, use the diameter origin host command in Global Configuration mode. To remove this origin host information of DIAMETER server, use the no form of this command.

diameter origin host host-name

Syntax Description


`host-name`	Specifies the DIAMETER server's origin host either as a fully qualified domain name (FQDN) or as an IPv4 or IPv6 address.

Command Default

The origin host is set as a null string.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

If you do not specify the origin host, a null string is assumed as the origin host name. Therefore, this is a mandatory configuration.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the DIAMETER origin host information in BNG:


RP/0/RSP0/CPU0:router(config)# diameter origin host BNG-1.cisco.com

Related Commands

Command	Description
diameter origin realm	Configures the origin realm information of DIAMETER server in BNG.

diameter origin realm

To configure the origin realm information of DIAMETER server in BNG, use the diameter origin realm command in Global Configuration mode. To remove this origin realm information of DIAMETER server, use the no form of this command.

diameter origin realm realm-string

Syntax Description


`realm-string`	Specifies the DIAMETER origin realm string either as a fully qualified domain name (FQDN) or as an IPv4 or IPv6 address.

Command Default

The default realm name string is a null string.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command is introduced.

Usage Guidelines

If you do not specify the origin realm, a null string is assumed as the origin realm name. Therefore, this is a mandatory configuration.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the origin realm information of DIAMETER server in BNG:


RP/0/RSP0/CPU0:router(config)# diameter origin realm cisco.com

Related Commands

Command	Description
diameter origin host	Configures the origin host information of DIAMETER server in BNG.

diameter peer

To configure a DIAMETER peer and to enter the DIAMETER peer sub-configuration mode in BNG, use the diameter peer command in Global Configuration mode. To remove the diameter peer configuration, use the no form of this command.

diameter peer peer-name

Syntax Description


`peer-name`	Specifies the name of the diameter peer.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure a DIAMETER peer in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)#

diameter tls trustpoint

To configure the trustpoint name to be used in the certificate to be used for DIAMETER TLS exchange, use the diameter tls trustpoint command in Global Configuration mode. To remove the DIAMETER trustpoint configuration, use the no form of this command.

diameter tls trustpoint label

Syntax Description


`label`	Specifies the trustpoint label name to be used for DIAMETER TLS exchange.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

If no trustpoint is provided, then the default trustpoint is used.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the trustpoint label name to be used for DIAMETER TLS exchange:


RP/0/RSP0/CPU0:router(config)# diameter tls trustpoint trustpoint1

diameter vendor supported

To specify the vendor attribute-value pairs (AVPs) that the DIAMETER node can recognize, use the diameter vendor supported command in Global Configuration mode. This information is passed to the peer in capability exchange messages. To remove this configuration, use the no form of this command.

diameter vendor supported {cisco| etsi| 3gpp | vodafone}

Syntax Description


`cisco`	Specifies that Cisco AVPs are recognized by the DIAMETER node.
`etsi`	Specifies that ETSI AVPs are recognized by the DIAMETER node.
`3gpp`	Specifies that 3GPP AVPs are recognized by the DIAMETER node.
`vodafone`	Specifies that Vodafone AVPs are recognized by the DIAMETER node.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 5.3.0	This command is introduced.

Usage Guidelines

You can have multiple vendors' AVPs supported. So, you can run this command multiple times with a different vendor ID on each instance.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to specify that the DIAMETER node recognizes Cisco AVPs:


RP/0/RSP0/CPU0:router(config)# diameter vendor supported cisco

ip vrf forwarding

To configure the VRF associated with the DIAMETER peer, to establish connections with the peers immediately after configuring them, use the ip vrf forwarding command in DIAMETER peer configuration mode. To remove the VRF associated with the peer, use the no form of this command.

ip vrf forwarding vrf_table_name

Syntax Description


`vrf_table_name`	Name of the VRF table.

Command Default

None

Command Modes

DIAMETER peer configuration.

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

If this command is not configured, then the global routing table is used for establishing the connection with the peer.

If the VRF associated with the name is not configured, then an error message mentioning so is displayed, and this command does not have any effect.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the VRF associated with the DIAMETER peer:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# ip vrf forwarding VRF1

peer-type

To configure the DIAMETER peer type in BNG, use the peer-type command in DIAMETER peer configuration mode . To remove the DIAMETER peer type configuration, use the no form of this command.

peer-type server

Syntax Description


server	Specifies that the DIAMETER peer is a server.

Command Default

None

Command Modes

DIAMETER peer configuration

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

By default, the peer-type is server.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the DIAMETER peer type in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# peer-type server

prepaid-config

To configure prepaid feature in BNG, use the prepaid-config command in dynamic template type service configuration mode. To remove this prepaid feature configuration, use the no form of this command.

prepaid-config feature-name

Syntax Description


`feature-name`	Pre-configured prepaid feature name.

Command Default

None

Command Modes

Dynamic template type service

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

You must use already defined subscriber prepaid feature to program the feature name in dynamic template.

Service accounting configuration (using accounting aaa list default type service command) is mandatory for the functioning of prepaid services.

Task ID


Task ID	Operation
config-services	read, write

Examples

This example shows how to configure prepaid feature in BNG:


RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type service service1
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# prepaid-config feature1
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# accounting aaa list default type service

server (DIAMETER)

To attach the globally configured DIAMETER server (having the same name) to the server group, use the server command in DIAMETER server group configuration mode . To detach the globally configured DIAMETER server from the server group, use the no form of this command.

server peer-name

Syntax Description


`peer-name`	Specifies the name of DIAMETER peer.

Command Default

None

Command Modes

DIAMETER server group configuration

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

If a server is not configured globally with the same peer_name , then an error message saying so is displayed.

To configure the DIAMETER server globally, use diameter peer peer_name command in global configuration mode.

Unlike for RADIUS, DIAMETER does not have private servers. DIAMETER considers a server that does not have a VRF name configured, as a global server, and it uses global routing table for that particular server.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to attach the globally configured DIAMETER server (having the same name) to the server group in BNG:


RP/0/RSP0/CPU0:router(config)# aaa group server diameter GX_SG
RP/0/RSP0/CPU0:router(config-sg-diameter)# server GX_SERVER

source-interface (DIAMETER)

To configure the source-interface to be used for the DIAMETER connection in BNG, use the source-interface command in DIAMETER peer configuration mode. To remove the source-interface used for the DIAMETER connection, use the no form of this command.

source-interface interface-type interface-instance

Syntax Description

interface-type

Interface type. For more information, use the question mark (?) online help function.

interface-instance

Physical interface or virtual interface.

Note

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

Command Default

None

Command Modes

DIAMETER peer configuration

Global Configuration mode (when used with diameter keyword)

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

The DIAMETER client uses this source address and port to initiate the TCP connection to the peer.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the source-interface (in DIAMETER peer configuration mode) to be used for the DIAMETER connection in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# source-interface bundle-ether 1.1

This example shows how to configure the source-interface (in global configuration mode) to be used for the DIAMETER connection in BNG:


RP/0/RSP0/CPU0:router(config)# diameter source-interface bundle-ether 1.1

test aaa group diameter

To test various DIAMETER application behaviors in BNG, use the test aaa group diameter command in EXEC mode.

test aaa group diameter {dcca | policy-if} list-num server-group timeout timeout-val

Syntax Description


dcca	Tests DIAMETER DCCA application messages.
policy-if	Tests DIAMETER policy interface application messages.
`list-num`	DIAMETER attribute list number.
`server-group`	Specifies the configured server group to be used for testing.
timeout	Specifies the duration that the test process need to wait for the response.
`timeout-val`	Timeout value, in seconds. The range is from 1 to 99. The value must be greater than or equal to 5.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

You must use diameter attribute list command, to define the attribute list required for this test command.

Task ID


Task ID	Operation
network	read, write

Examples

This example shows how to execute the test aaa group diameter command in BNG:


RP/0/RSP0/CPU0:router# test aaa group diameter policy-if 1 default timeout 5

Related Commands

Command	Description
diameter attribute list	Configures attribute list parameters for DIAMETER test command in BNG.

timer (DIAMETER)

To configure various DIAMETER base protocol timers, use the timer command in DIAMETER peer configuration mode or in Global Configuration mode (along with diameter keyword). To remove the DIAMETER base protocol timers, use the no form of this command.

timer {connection | transaction | watchdog} timer-value

Syntax Description


connection	Specifies the DIAMETER base protocol timer used for setting the frequency of transport connection attempts with the peer when there is no active connection to the peer. This timer is used to delay the connection establishment or re-establishment of client with the DIAMETER server.
transaction	Specifies the timer used for setting the frequency of transaction attempts. That is, the duration for which the client waits for any response message from the peer.
watchdog	Specifies the timer used to periodically send the Device-Watch-Dog to the DIAMETER server to test the link status.
`timer-value`	Specifies the value for various DIAMETER base protocol timers. The range, in seconds, for transaction timer is from 1 to 1000; the default is 5. The range, in seconds, for connection timer and watchdog timer is from 6 to 1000; the default is 30.

Command Default

None

Command Modes

DIAMETER peer configuration.

Global Configuration mode (when used with diameter keyword).

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

A connection timer value of zero (0) does not trigger any retry for the connection establishment. When theno form of connection timer command is issued, a default timer of 30 seconds is started. The connection retry does not trigger immediately.

The algorithm used for sending the watchdog messages, is based on RFC3539.

The DIAMETER base protocol timers can be configured globally and at the peer level. By default, the peers inherit the globally configured timer values. But, if the timer values are configured at peer level as well, then the peer level timer values take precedence over the globally configured timer values.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the DIAMETER base protocol watchdog timer (in DIAMETER peer configuration mode) in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# timer watchdog 300

This example shows how to configure the DIAMETER base protocol watchdog timer (in global configuration mode) in BNG:


RP/0/RSP0/CPU0:router(config)# diameter timer watchdog 300

transport (DIAMETER)

To configure the DIAMETER transport protocol to be used for establishing connection with the peer, use the transport command in DIAMETER peer configuration mode. To remove the DIAMETER transport protocol configuration, use the no form of this command.

transport tcp port port_num

Syntax Description


`port_num`	Specifies the port number that the remote peer uses for DIAMETER messages. The range is from 1 to 65535; the default is 3868.

Command Default

If the port_num is not configured, 3868 becomes the default port number.

Command Modes

DIAMETER peer configuration.

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

Currently, only tcp is supported as the DIAMETER transport protocol in BNG.

When theno form of the command is issued, all the sessions that are bound to the peer cannot use the connection anymore. In that case, the applications that initiated the pending messages, if any in the queue, are notified so that they can try alternate peers.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the DIAMETER transport protocol to be used for establishing connection with the peer:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# transport tcp port 3868

transport security-type

To configure the security protocol to be used for the DIAMETER connection in BNG, use the transport security-type command in DIAMETER peer configuration mode. To remove the DIAMETER security protocol configuration, use the no form of this command.

transport security-type tls

Syntax Description


tls	Specifies Transport Layer Security (TLS) as the security protocol to be used for the DIAMETER connection.

Command Default

None

Command Modes

DIAMETER peer configuration.

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

Currently, only tls is supported as the security protocol to be used for the DIAMETER connection in BNG.

The default security mechanism is none. When the security mechanism is changed dynamically, the connection to the peer is torn down and re-established.

If the destination host is configured under the peer, that is also verified against the server certificate.

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to configure the security protocol to be used for the DIAMETER connection in BNG:


RP/0/RSP0/CPU0:router(config)# diameter peer diam_server_1
RP/0/RSP0/CPU0:router(config-dia-peer)# transport security-type tls

show diameter

To display global DIAMETER statistics in BNG, use the show diameter command in EXEC mode.

show diameter

Syntax Description


This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
config-services	read

Examples

This is a sample output for the show diameter command:

RP/0/RSP0/CPU0:router# show diameter
Origin Host : abc@xyz.com
Origin Realm : xyz.com
Source Interface : 
TLS Trustpoint : 
Connection timer value : 30 seconds
Watchdog timer value : 30 seconds
Transaction timer value : 5 seconds
Number of Peers:2

Related Commands

Command	Description
show diameter peer	Displays DIAMETER peer information in BNG.
show diameter gx	Displays the status of DIAMETER Gx application in BNG.
show diameter gy	Displays the status of DIAMETER Gy application in BNG.
show diameter nas	Displays the DIAMETER Network Access Server (NAS) information in BNG.
show checkpoint dynamic process (DIAMETER)	Displays the checkpoint information of DIAMETER process.

show diameter gx

To display the status of DIAMETER Gx application in BNG, use the show diameter gx command in EXEC mode.

show diameter gx [checkpoint session-id | session session-id | statistics ]

Syntax Description


checkpoint `session-id`	(Optional) Displays checkpoint information of Gx application.
session `session-id`	(Optional) Displays session information of Gx application.
statistics	(Optional) Displays Gx application statistics.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read

Examples

This is a sample output for the show diameter gx statistics command:

RP/0/RSP0/CPU0:router# show diameter gx statistics

CCR Initial Messages                : 1
CCR Initial Messages Sent Failed    : 0
CCR Initial Messages Timed Out      : 0
CCR Initial Messages Retry          : 0
CCR Update Messages                 : 0
CCR Update Messages Sent Failed     : 0
CCR Update Messages Timed Out       : 0
CCR Update Messages Retry           : 0
CCR Terminate Messages              : 0
CCR Terminate Messages Sent Failed  : 0
CCR Terminate Messages Timed Out    : 0
CCR Terminate Messages Retry        : 0
CCA Initial Messages                : 1
CCA Initial Messages Error          : 0
CCA Update Messages                 : 0
CCA Update Messages Error           : 0
CCA Terminate Messages              : 0
CCA Terminate Messages Error        : 0
RAR Received Messages               : 0
RAR Received Messages Error         : 0
RAA Sent Messages                   : 0
RAA Sent Messages Error             : 0
ASR Received Messages               : 0
ASR Received Messages Error         : 0
ASA Sent Messages                   : 0
ASA Sent Messages Error             : 0
Session Termination Messages Recvd  : 0
Unknown Request Messages            : 0
Restored Sessions                   : 0
Total Opened Sessions               : 1
Total Closed Sessions               : 0
Total Active Sessions               : 1

Related Commands

Command	Description
show diameter gy	Displays the status of DIAMETER Gy application in BNG.
show diameter nas	Displays the DIAMETER Network Access Server (NAS) information in BNG.

show diameter gy

To display the status of DIAMETER Gy application in BNG, use the show diameter gy command in EXEC mode mode.

show diameter gy [checkpoint session-id | session session-id | statistics ]

Syntax Description


checkpoint `session-id`	(Optional) Displays checkpoint information of specific Gx application.
session `session-id`	(Optional) Displays specific Gy application information.
statistics	(Optional) Displays Gy application statistics.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read

Examples

This is a sample output for the show diameter gy statistics command:

RP/0/RSP0/CPU0:router# show diameter gy statistics

CCR Initial Messages                : 1
CCR Initial Messages Sent Failed    : 0
CCR Initial Messages Timed Out      : 0
CCR Initial Messages Retry          : 0
CCR Update Messages                 : 4
CCR Update Messages Sent Failed     : 0
CCR Update Messages Timed Out       : 0
CCR Update Messages Retry           : 0
CCR Terminate Messages              : 1
CCR Terminate Messages Sent Failed  : 0
CCR Terminate Messages Timed Out    : 0
CCR Terminate Messsages Retry       : 0
CCA Initial Messages                : 1
CCA Initial Messages Error          : 0
CCA Update Messages                 : 4
CCA Update Messages Error           : 0
CCA Terminate Messages              : 1
CCA Terminate Messages Error        : 0
RAR Received Messages               : 0
RAR Received Messages Error         : 0
RAA Sent Messages                   : 0
RAA Sent Messages Error             : 0
ASR Received Messages               : 0
ASR Received Messages Error         : 0
ASA Sent Messages                   : 0
ASA Sent Messages Error             : 0
Unknown Request Messages            : 0
Restored Sessions                   : 0
Total Opened Sessions               : 2
Total Closed Sessions               : 1
Total Active Sessions               : 1

Related Commands

Command	Description
show diameter gx	Displays the status of DIAMETER Gx application in BNG.
show diameter nas	Displays the DIAMETER Network Access Server (NAS) information in BNG.

show diameter nas

To display the DIAMETER Network Access Server (NAS) information in BNG, use the show diameter nas command in EXEC mode.

show diameter nas [checkpoint session-id | session session-id | summary]

Syntax Description


checkpoint `session-id`	(Optional) Displays checkpoint information of specific NAS session.
session `session-id`	(Optional) Displays specific NAS session information.
summary	(Optional) Displays summary of NAS sessions.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read

Examples

This is a sample output for the show diameter nas session command:

RP/0/RSP0/CPU0:router# show diameter nas session 00070a6f


Nas Session status for [00070a6f]
        Session Status            :  Active
        Diameter Session ID       : 1.1.1.1;4;461423;1187179

        Authentication Status     : NA
        Authorization Status      : SUCCESS
        Accounting Status (Start) : NA
        Accounting Status (Stop)  : NA
        Disconnect status         : NA

  Peer Information :
        Server group     :  NASREQ_SG
        Server Used      :  NASREQ_SERVER

This is a sample output for the show diameter nas summary command:

RP/0/RSP0/CPU0:router# show diameter nas summary

NAS Statistics :

    NAS Initiated msgs :

        Authentication       ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0

        Authorization        ::

          In                   :          1   Out                  :          1
          Requests received    :          1   Requests send        :          1
          Response received    :          1   Result forwaded      :          1
          Transaction Succeeded:          1   Transactions Failed  :          0

        Accounting (Start)   ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0

        Accounting (Stop)    ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0

        Accounting (Interim) ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0

        Disconnect           ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0


    Server Initiated msgs :

        Coa  (RAR)           ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0

        POD  (ASR)           ::

          In                   :          0   Out                  :          0
          Requests received    :          0   Requests send        :          0
          Response received    :          0   Result forwaded      :          0
          Transaction Succeeded:          0   Transactions Failed  :          0
Diameter NAS summary

Related Commands

Command	Description
show diameter gx	Displays the status of DIAMETER Gx application in BNG.
show diameter gy	Displays the status of DIAMETER Gy application in BNG.

show diameter peer

To display the DIAMETER peer information in BNG, use the show diameter peer command in EXEC mode mode.

show diameter peer peer-name

Syntax Description


peer `peer-name`	Specifies the name of the DIAMETER peer.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read

Examples

This is a sample output for the show diameter peer command:

RP/0/RSP0/CPU0:router# show diamter peer peer1
Origin Host : test
Origin Realm : testrealm
Source Interface : 
TLS Trustpoint : 
Connection timer value : 30 seconds
Watchdog timer value : 30 seconds
Transaction timer value : 30 seconds
Peer name : peer1
        type : SERVER
        Address/port : 01010101/3868
        Transport protocol : TCP
        Peer security protocol :   NONE
        connection timer : 30 seconds
        watchdog timer value : 30 seconds
        transaction timer value : 30 seconds
        VRF name : default
        Source-interface : 
        Destination realm : 
        Destination host name : 
        Peer connection status : Closed

      Peer Statistics
------------------------------
          IN     /    OUT     
------------------------------
ASR  0             0         
ASA  0             0         
ACR  0             0     
ACA  0             0         
CER  0             0         
CEA  0             0         
DWR  0             0         
DWA  0             0         
DPR  0             0         
DPA  0             0         
RAR  0             0         
RAA  0             0         
STR  0             0         
STA  0             0        
CCR  0             0         
CCA  0             0       
Malformed Rcvd   :  0         
Prot. Errs Sent  :  0                 Prot. Errs Rcvd  :  0         
Trans. Errs Sent :  0                 Trans. Errs Rcvd :  0         
Perm. Errs Sent  :  0                 Perm. Errs Rcvd  :  0

Related Commands

Command	Description
show diameter gx	Displays the status of DIAMETER Gx application in BNG.
show diameter gy	Displays the status of DIAMETER Gy application in BNG.
show diameter nas	Displays the DIAMETER Network Access Server (NAS) information in BNG.

show checkpoint dynamic process (DIAMETER)

To display the checkpoint information of DIAMETER process, use the show checkpoint diameter process command in the EXEC mode mode.

show checkpoint dynamic process process-name

Syntax Description


`process-name`	Name of the process (in this case, diameter ) for which the checkpoint information must be displayed.

Command Default

None

Command Modes

EXEC

Command History


Release	Modification
Release 5.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read

Examples

This is a sample output of the show checkpoint dynamic process diameter command:


RP/0/RSP0/CPU0:router# show checkpoint dynamic process diameter

     Name           Version         ID    Seg #Objects   Length  InfoLen  Flags
---------------------------------------------------------------------------------
0x00000003     0,    0,    0 0x40001c00      M        0      292        4   I M 
0x00000004     0,    0,    0 0x40001d00      M        1      264        4   I M 
0x00000002     0,    0,    0 0x40001e00      M        1       24        4   I M 
0x00000001     0,    0,    0 0x40001f00      M        1       24        4   I M 

Segment 0: Number of pages allocated: 4
Segment 0: Number of pages free: 3

Segment 1: Number of pages allocated: 9
Segment 1: Number of pages free: 3

-----------------------------------------------------------------------------------

Related Commands

Command	Description
show diameter peer	Displays DIAMETER peer information in BNG.
show diameter gx	Displays the status of DIAMETER Gx application in BNG.
show diameter gy	Displays the status of DIAMETER Gy application in BNG.
show diameter nas	Displays the DIAMETER Network Access Server (NAS) information in BNG.

Bias-Free Language

Results

Chapter: DIAMETER Commands

DIAMETER Commands

address (DIAMETER)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

clear diameter peer

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

clear diameter statistics

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

destination host

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

destination realm

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

diameter attribute list

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

diameter gx

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

diameter gx retransmit

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

diameter gx tx-timer

Syntax Description

Command Default

Command Modes