Diameter Host Select Configuration Mode Commands

Diameter Host Select Configuration Mode is accessed from the Global Configuration Mode. This mode allows an operator to configure Diameter host tables of peer servers that can be shared by different services.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

end

Exits the current configuration mode and returns to the Exec mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax 
end

Usage:

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax 
exit

Usage:

Use this command to return to the parent configuration mode.

host-select row-precedence

This command configures individual rows of peer servers within the Diameter host table.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, HA, HSGW, IPSG, PDSN, P-GW, SCM, SAEGW, S-GW


Privilege:

Security Administrator, Administrator


Syntax 
host-select row-precedence precedence table { 1 | 2 | prefix-table { 1 | 2 } } host host_name [ realm realm_id ] [ secondary
host host_name realm realm_id ] ] [-noconfirm] host-select row-precedence precedence table prefix-table { 1 | 2 } msisdn-prefix-from msisdn_prefix_from msisdn-prefix-to msisdn_prefix_to host host_name [ realm realm_id ] [ secondary
host host_name realm realm_id ] [-noconfirm]no host-select row-precedence precedence table { 1 | 2 | prefix-table { 1 | 2 } } [-noconfirm]
no

Removes the specified row from the primary or secondary table or primary/secondary MSISDN prefix table.

row-precedence precedence

Specifies the row in the table as an integer from 1 through 128.

IMPORTANT:

In StarOS release 14.0 and later, precedence may be an integer from 1 through 256 for SCM.

table { 1 | 2 | prefix-table { 1 | 2 } }
Specifies the Diameter host table that will be edited.
  • 1: Specifies the primary table
  • 2: Specifies the secondary table
  • prefix-table { 1 | 2 }: Specifies a primary or secondary table containing ranges of MSISDN prefixes.
msisdn-prefix-from msisdn_prefix_from msisdn-prefix-to msisdn_prefix_to

Specifies the starting and ending Mobile Station International Subscriber Directory Number (MSISDN) prefixes for a row in the prefix-table.

host host_name

Identifies the primary Diameter peer server to be added to this row by its host name.

host_name can be entered as an IP address or a DNS hostname (1 through 128 alphanumeric characters).

secondary host host_name

Identifies the secondary Diameter peer server to be added to this row by its host name.

host_name can be entered as an IP address or a DNS hostname (1 through 128 alphanumeric characters).

[ realm realm_id ]

Specifies an optional realm ID as an alphanumeric string of 1 through 128 characters.

[-noconfirm]

Executes the command without prompting for further input from the user.


Usage:

Use this command to add or modify individual rows in Diameter host server tables. Each table may contain up to 256 rows.


Example:
The following command adds a row to a Diameter peer server table with the following parameters:
  • row (precedence) = 1
  • table = 1 (primary)
  • Diameter peer server hostname = minid
  • realm = namerica
host-select row-precedence
1 table 1 host minid realm namerica
host-select table

This command configures a table of peer servers associated with the Diameter host template.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, HA, HSGW, IPSG, PDSN, P-GW, SCM, SAEGW, S-GW


Privilege:

Security Administrator, Administrator


Syntax 
host-select table { 1 | 2 | prefix-table { 1 | 2 } } algorithm { ip-address-modulus [ prefer-ipv4 | prefer-ipv6 ] | msisdn-modulus | round-robin }no host-select table
no

Removes the table associated with the Diameter host template.

table { 1 | 2 | prefix-table { 1 | 2 } }
Specifies the Diameter host table that will be edited.
  • 1: Specifies the primary table
  • 2: Specifies the secondary table
  • prefix-table { 1 | 2 }: Specifies a primary or secondary table containing ranges of MSISDN prefixes.
algorithm { ip-address-modulus [ prefer-ipv4 | prefer-ipv6 ] | msisdn-modulus | round-robin }
Specifies the algorithm to be used when selecting a row in this table.
  • ip-address-modulus: Use an IP address (in binary) to select a row. prefer-ipv4: If both IPv4 and IPv6 addresses are available, use the IPv4 address. prefer-ipv6: If both IPv4 and IPv6 addresses are available, use the IPv6 address.
  • msisdn-modulus: Use an MSISDN (without leading “+”) to select a row.
  • round-robin: Select a row in round-robin manner for each new session.

IMPORTANT:

The Round Robin algorithm is effective only over a large number of selections, and not at a granular level.


Usage:

Use this command to add or modify a Diameter host server table associated with a Diameter host template.


Example:
The following command adds a primary table that uses the ip-address-modulus algorithm for selecting a row:
host-select table 1
algorithm ip-address-modulus