This command configures individual rows of peer servers within the
Diameter host table.
Product
GGSN
HA
HSGW
IPSG
PDSN
P-GW
SCM
SAEGW
S-GW
Privilege
Security Administrator, Administrator
Mode
Exec > Global Configuration > Diameter Host Select Configuration
configure > diameter-host-template
template_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-host-template)#
Syntax
Syntax Description
In StarOS 14.1 and earlier releases:
host-select row-precedence precedence table { 1 | 2 } host host_name [ realm realm_id ] [ secondary host sec_host_name realm sec_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 sec_host_name realm sec_realm_id ] [ -noconfirm ]
no host-select row-precedence precedence table { 1 | 2 | prefix-table { 1 | 2 } } [-noconfirm]
In StarOS 15.0 and later releases:
host-select row-precedence precedence table { 1 | 2 } host host_name [ realm realm_id ] [ secondary host sec_host_name realm sec_realm_id ] ] [ -noconfirm ]
host-select row-precedence precedence table { { range-table { 1 | 2 } { imsi-based { [ prefix | suffix ] imsi-value [ to imsi-value ] } | msisdn-based { [ prefix | suffix ] msisdn-value [ to msisdn-value ] } } host host_name [ realm realm_id ] [ secondary host sec_host_name realm sec_realm_id ] algorithm { active-standby | round-robin } ] } } [ -noconfirm ]
no host-select row-precedence precedence table { 1 | 2 | range-table { 1 | 2 } } [ -noconfirm ]
no
Removes the specified row from the primary or secondary table or
primary/secondary MSISDN prefix table for 14.0 and
earlier releases, or IMSI/MSISDN range table for 15.0 and later releases.
row-precedence
precedence
Specifies the row in the table as an integer from 1 through 128.
Note that the row precedence number in
IMSI/MSISDN configuration must be unique.
Important:
In StarOS release 14.0 and later,
precedence may be an integer from 1 through
256 for SCM.
table { 1 | 2 }
Specifies the Diameter host table that will be edited.
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
sec_host_name
realm
sec_realm_id
]
Important:
This command syntax is applicable to StarOS release 14.1 and
earlier.
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.
table { { range-table { 1 | 2 } { imsi-based { [
prefix | suffix ]
imsi-value
[ to
imsi-value
] } | msisdn-based { [ prefix | suffix ]
msisdn-value
[ to
msisdn-value
] } } host
host_name
[ realm
realm_id
] [ secondary host
sec_host_name
realm
sec_realm_id
] algorithm { active-standby | round-robin
} ] } }
Important:
This command syntax is applicable to StarOS release 15.0 and later.
range-table { 1 | 2 }: Specifies a primary
or secondary table containing ranges of IMSI or MSISDN prefix/suffix.
imsi-based { [ prefix | suffix ]
imsi-value
[ to
imsi-value ] }:
Specifies to use the prefix/suffix/range values of IMSI of the subscriber for
Diameter peer selection.
msisdn-based { [ prefix | suffix ]
msisdn-value
[ to
msisdn-value ] }:
Specifies to use the prefix/suffix/range values of MSISDN of the subscriber for
Diameter peer selection.
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.
algorithm { active-standby | round-robin }:
Specifies to select the algorithm to pick the primary and the secondary hosts
either in an active standby mode or in round robin fashion.
[ -noconfirm ]
Executes the command without prompting for further input from the
user.
Usage Guidelines
Use this command to add or modify individual rows in Diameter host
server tables. Each table may contain up to 256 rows.
In Releases 15.0 and later, the existing CLI
command "host-select row-precedence" in the Diameter
Host Template Configuration mode is modified to enable the selection of
Diameter peer based on the configured prefix/suffix/range values of IMSI or
MSISDN of subscriber. This configuration change allows the overlapping range of
IMSI or MSISDN values.
PCRF peer selection is based on the first
match of prefix/suffix/range on row precedence priorities. If the subscriber's
IMSI/MSISDN does not match with any configured IMSI/MSISDN range, then IMS
Authorization application selects the default peer.
Important:
The length of IMSI or MSISDN range is the same in any IMSI or
MSISDN host template configuration list.
Once a row is selected the failure handling
for the subscriber is done based on this configuration. With this feature being
turned on, the primary and the secondary hosts configured can be picked up in
an active standby mode or in round robin fashion.
Examples
The following command adds a row to a Diameter peer server table with
the following parameters:
host-select row-precedence 1 table 1 host minid realm namerica