Versions Compared

Old Version 1

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Add_workflow_for_techpubs
AUTH2UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cd5909df, userName='null'}
AUTH1UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a00268a00a0c880e94aad0181077fa2530009, userName='null'}
JIRAIDAUTHSBX-92712125009
REV5UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a00268a00a02355cd1c2f0155cd26cd5909df, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a00268a00a02355cd1c2f0155cd26cd5909df, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cbba06418a00a02355cd1c2f0155cd26c9f0036a, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26c94702568a00a02355cd1c2f0155cd26c9f0036a, userName='null'}

 



Panel

In this section:

Table of Contents
maxLevel4
minLevel2



Panel
bgColortransparent

Related articles:


Available_since
Release12.1.2



Use the Diameter Node object to define the parameters for the SBC side of a Diameter interface.

The

Spacevars
0series4
 uses a connection over a Diameter interface for both quality of service (QoS) resource reservation requests and for transmitting lawful intercept (LI) information to mediation servers in deployments that follow the PacketCable 2.0 LI model. Within SBC configuration there is a single Diameter node object that is shared for both use cases. 

In the first use case, the Rx interface pertains to QoS resource reservation for reserving bandwidth in an IP access network. The Rx interface is used to exchange application-level session information between a Policy and Charging Rules Function (PCRF) element and the P-CSCF. The SBC, acting as a P-CSCF, creates a TCP connection with the configured PCRF. For this case, you use the Diameter Node object to configure the Diameter realm for sending external QoS requests on a per-IP-trunk-group basis.

In the second case, the SBC uses a Diameter-based interface (X2 interface) over TCP transport to send intercepted call data and associated call events from the SBC to an LI mediation server. In general, LI configuration must be completed by a user with specific LI privileges (the calea user). However because the Diameter node object is also used for a non-LI purpose, the node name (<diameterNode_name>) must be assigned, as described on this page, by a user with admin privileges. You then include the Diameter node name in the LI call data channel (CDC) configuration. However, the remaining Diameter configuration required to support PC 2.0 LI (Diameter peers and Diameter realm routes), must be completed by the calea user within CDC configuration. Refer to PacketCable 2.0 LI Configuration for information and procedures for configuring Diameter parameters for PC 2.0 LI deployments. 

Include Page
SBXDOC121:_IP_IGs_ServedBySeperateProcessorsSBXDOC121:
_IP_IGs_ServedBySeperateProcessors

Note

When configuring a Diameter node in an HA configuration, the secondaryOriginHost parameter must be configured with the Standby hostname.


Note

Do not configure PCRF on the egress leg of the trunk group for REGISTER.

Command Syntax

Code Block
titleNot applicable to SBC CNelanguagenone
% set addressContext <addressContext_name> diamNode <diameterNode_name>
	dumpPdu <disabled | enabled>
	ipInterfaceGroupName <IPIG_name> 
	ipV4Address <IPv4 address towards peer> 
	ipV6Address <IPv6 address towards peer> 
	originRealm <origin realm name> 
	peer <peer_name>
		deviceWatchdogTimer <0-100000 ms>
		deviceWatchdogTimerAnswerTimeout <1000-500000 ms>
		fqdn <1-256 characters> 
		ipAddress <IP address>
		sessionDistribution <honor-reply-order | round-robin>
		state <disabled | enabled> 
		tcpPort <#> 
	primaryOriginHost <primary host name> 
	realmRoute <realmRoute_name> 
		appId <e2 | rf | rx> 
		peer <name> 
		priority <0-100> 
		realm <name> 
		state <disabled | enabled> 
	secondaryOriginHost <secondary host name> 
	state <disabled | enabled> 
	transactionTimeout <500-6000 milliseconds>
Command Parameters


Code Blockcaption
Diameter Node Parameters
title
0Table
1
SBC CNe only
% set addressContext default diamNode <node name>
    originRealm <realm name>
    primaryOriginHost <Host name>
    secondaryOriginHost <Secondary host>
    state <disabled | enabled>
    ipInterfaceGroupName <IG Name>
    networkSegmentName <Network Segment name>
    ipNameV4 <IPv4 address>
    ipNameV6 <IPv6 address>
    peer <peer name>
        state <disabled | enabled>        
        ipAddress <IPv4 address>
        fqdn <FQDN>
        tcpPort <port>
        deviceWatchdogTimer <timer value>
        deviceWatchdogTimerAnswerTimeout <timeout value>
    realmRoute <Realm Route name>
        peer <Peer name>
        realm <Realm>
        appId rx
        state <disabled | enabled>


Command Parameters

Diameter Node Parameters (Not applicable to SBC CNe)

Parameter

Length/Range

Description

diamNode

1-23

<diameterNode_name> – Diameter node name. If you are configuring the SBC for PC 2.0 LI, use this name in the LI CDC. Refer to PacketCable 2.0 LI Configuration.

dumpPduN/A

When this flag is enabled, the

Spacevars
0product
logs the DIAMETER PDU sent and received on the Rx interface to the debug log.

  • disabled (default)
  • enabled

This flag is not applicable if you are using the Diameter node for PC 2.0 LI.

ipInterfaceGroupName

N/A

The name of the IP interface group to use.

ipV4Address

N/A

IPv4 address used to create connections towards peer.

ipV6Address

N/A

IPv6 address used to create connections towards peer.

originRealm

0-128

The origin realm for this node.

peer

0-23

Use this parameter to define the Diameter peer configuration for this node.

  • deviceWatchdogTimer – Device-Watchdog-Requests timer value, in milliseconds (range: 0-100000 / default=1000).
  • deviceWatchdogTimerAnswerTimeout – The Device Watchdog Answer timeout value, in milliseconds. SBC considers a peer down if a Device Watchdog Request is not replied to by a Device Watchdog Answer before this timer expires. (range: 1000-500000 | default = 2000)
  • fqdn – FQDN for this peer (1-256 characters).
  • ipAddress – IP Address of this peer.
  • sessionDistribution – Use this parameter to specify how to distribute Diameter sessions.

    • honor-reply-order (default) – Diameter session creation across multiple IP connections under this peer honors the order of the IP addresses that are returned in the DNS reply starting from the first one.

    • round-robin – Diameter session creation across multiple IP connections under this peer are rotated in round-robin fashion starting from the first one.

  • state – Admin state of this peer.
    • disabled (default)
    • enabled
  • tcpPort – TCP port number of this peer (default is 3868).

primaryOriginHost

0-128

The primary origin host for this node.

realmRoute

1-23

<realmRoute name> – Realm route for this node. Additional realm route arguments:

  • appId – Application ID (Diameter interface type) for this route.
    • e2
    • rf
    • rx (default is rx for the PCRF interface)
    • x2 (applies only when using Diameter to support PC 2.0 LI)
  • peer – The name of the peer this route belongs to.
  • priority – Priority of this Route. (range 0-100 / default = 0)
  • realm – Realm name of this route.
  • state– Administrative state of this peer.
    • disabled (default)
    • enabled

secondaryOriginHost

0-128

The secondary origin host for this node.

state

N/A

Use this flag to set the state of this Diameter node.

  • disabled (default)
  • enabled

transactionTimeout

500-6000

Enter desired transaction timeout in milliseconds. (default = 1000)

When transactionTimeout is configured, the SBC initiates retransmission of the diameter message after the configured value + 1.1 secs (1.1secs is hardcoded value in SBC). For example, if the configured value of transactionTimeout is 1000 (1 sec), then the SBC will initiate retransmission of the diameter message after 2.1 secs. The SBC supports only one diameter retransmission.



Diameter Node Parameters (SBC CNe only)

Parameter

Length/Range

Description

diamNode

1-23

<diameterNode_name> – Diameter node name. If you are configuring the SBC for PC 2.0 LI, use this name in the LI CDC. Refer to PacketCable 2.0 LI Configuration.

dumpPduN/A

When this flag is enabled, the

Spacevars
0product
logs the DIAMETER PDU sent and received on the Rx interface to the debug log.

  • disabled (default)
  • enabled

This flag is not applicable if you are using the Diameter node for PC 2.0 LI.

ipInterfaceGroupName

N/A

The name of the IP interface group to use.

ipNameV4

1-23

The IPv4 address variable name.

ipNameV6

1-23

The IPv6 address variable name.

networkSegmentName

N/A

Name of the Network Segment ID.

originRealm

0-128

The origin realm for this node.

peer

0-23

Use this parameter to define the Diameter peer configuration for this node.

  • deviceWatchdogTimer – Device-Watchdog-Requests timer value, in milliseconds (range: 0-100000 / default=1000).
  • deviceWatchdogTimerAnswerTimeout – The Device Watchdog Answer timeout value, in milliseconds. SBC considers a peer down if a Device Watchdog Request is not replied to by a Device Watchdog Answer before this timer expires. (range: 1000-500000 | default = 2000)
  • fqdn – FQDN for this peer (1-256 characters).
  • ipAddress – IP Address of this peer.
  • sessionDistribution – Use this parameter to specify how to distribute Diameter sessions.

    • honor-reply-order (default) – Diameter session creation across multiple IP connections under this peer honors the order of the IP addresses that are returned in the DNS reply starting from the first one.

    • round-robin – Diameter session creation across multiple IP connections under this peer are rotated in round-robin fashion starting from the first one.

  • state – Admin state of this peer.
    • disabled (default)
    • enabled
  • tcpPort – TCP port number of this peer (default is 3868).

primaryOriginHost

0-128

The primary origin host for this node.

realmRoute

1-23

<realmRoute name> – Realm route for this node. Additional realm route arguments:

  • appId – Application ID (Diameter interface type) for this route.
    • e2
    • rf
    • rx (default is rx for the PCRF interface)
    • x2 (applies only when using Diameter to support PC 2.0 LI)
  • peer – The name of the peer this route belongs to.
  • priority – Priority of this Route. (range 0-100 / default = 0)
  • realm – Realm name of this route.
  • state– Administrative state of this peer.
    • disabled (default)
    • enabled

secondaryOriginHost

0-128

The secondary origin host for this node.

state

N/A

Use this flag to set the state of this Diameter node.

  • disabled (default)
  • enabled

transactionTimeout

500-6000

When transactionTimeout is configured, the SBC intiates retransmission of the diameter message after the configured value + 1.1 secs (1.1secs is hardcoded value in SBC). For example, if the configured value of transactionTimeout is 1000 (1 sec), then the SBC will initiate retransmission of the diameter message after 2.1 secs. The SBC supports only one diameter retransmission.


Command Example (P-CSCF/PCRF Use Case)

Example Diameter Node configuration:

Code Block
languagenone
% set addressContext ADDR_CONTEXT_1 diamNode diam ipInterfaceGroupName LIG1 ipV4Address 10.54.154.89 ipV6Address fe80::210:6bff:fe03:231 originRealm pcscf-open-ims.test primaryOriginHost katie secondaryOriginHost eleanor transactionTimeout 1500

Mandatory parameters:

  1. At least one IP address is required (ipV4Address or ipV6Address)
  2. diamNode name
  3. primaryOriginHost name
  4. ipInterfaceGroupName
  5. originRealm name

Default Values:

  • state = disabled
  • transactionTimeout = 1000 ms


Example Diameter Node Configuration for SBC CNe

Code Block
set addressContext default diamNode Diam originRealm pcscf-rf-ims.test primaryOriginHost pcrf1 secondaryOriginHost pcrf2 networkSegmentName sg-default-pkt0 ipNameV4 SGPKT0 ipInterfaceGroupName LIGSG state enabled

Mandatory Parameters

  1. At least one IP address name (ipNameV4 or ipNameV6) and networkSegmentName is required.
  2. diamNode name
  3. primaryOriginHost name
  4. ipInterfaceGroupName
  5. originRealm name

Default Values:

  • state = disabled
  • transactionTimeout = 1000 ms

Requirements:

  • You cannot modify the ipNameV4/ipNameV6 unless the diamNode is in disabled state.
  • The ipAddress (networkSegmentName) assigned for the diamNode is from the new Network Segment Table NsTableType="NS_SG".
  • The  ipInterfaceGroup associated with the diamNode contains at least one ipInterface of type NS_SG on non-PFE deployments.
  • The ipAddress (networkSegmentName) assigned for the diamNode is from the new Network Segment Table NsTableType="PFE" on non-PFE deployments.
  • "The  ipInterfaceGroup associated with the diamNode contains at least one ipInterface of type PFE (for PFE deployments) or type SG (for non-PFE deployments).
  • All the fields related to ipAddress/ipMetaVar are hidden for CNF.
  • You cannot modify the network segment table if the ipName is in use by the diamNode.


Example Peer Configuration:

Code Block
languagenone
% set addressContext ADDR_CONTEXT_1 diamNode diam peer camiant.nj.sonusnet.com ipAddress 1.2.3.4 fqdn camiant.nj.sonusnet.com tcpPort 4868

Mandatory parameters:

  1. fqdn
  2. ipAddress
  3. peer name

Default values:

  • state = disabled
  • tcpPort = 3868

Example Realm Route Configuration:

Code Block
languagenone
% set addressContext ADDR_CONTEXT_1 diamNode diam realmRoute camiant.nj.sonusnet.com realm camiant.nj.sonusnet.com peer camiant.nj.sonusnet.com appId rx priority 1

Mandatory parameters:

  1. peer name
  2. realm
  3. realmRoute name

Default values:

  • appId = rx (for PCRF interface)
  • state = disabled
  • priority = 0
pagebreak