This command configures the Diameter credit control primary and secondary hosts for DCCA.
Privilege
Security Administrator, Administrator
Mode
Exec > ACS Configuration > Credit Control Configuration
active-charging service service_name > credit-control
Entering the above command sequence results in the following prompt:
[local]host_name(config-dcca)#
Syntax
In 8.x and earlier releases:
diameter peer-select peer peer_name [ realm realm_name ] [ secondary-peer secondary_peer_name [ realm realm_name ] ] [ imsi-based start-value imsi_start_value end-value imsi_end_value ]
no diameter peer-select [ imsi-based start-value imsi_start_value end-value imsi_end_value ]
In 9.0 and later releases, for UMTS deployments:
diameter peer-select peer peer_name [ realm realm_name ] [ secondary-peer secondary_peer_name [ realm realm_name ] ] [ imsi-based { { prefix | suffix } imsi/prefix/suffix_start_value } [ to imsi/prefix/suffix_end_value ] ] [ msisdn-based { { prefix | suffix } msisdn-based/prefix/suffix_start_value } [ to msisdn-based/prefix/suffix_end_value ] ]
no diameter peer-select [ imsi-based { { prefix | suffix } imsi/prefix/suffix_start_value } [ to imsi/prefix/suffix_end_value ] ] | [ msisdn-based { { prefix | suffix } msisdn-based/prefix/suffix_start_value } [ to msisdn-based/prefix/suffix_end_value ] ]
no
Removes previously configured Diameter credit control peer selection setting.
peer
peer_name
Specifies the primary host name. as an alphanumeric string of 1 through 63 characters that can contain punctuation characters.
imsi-based start-value imsi_start_value end-value imsi_end_value
Important
|
This section applies only to 8.3 and earlier releases.
|
Specifies peer selection based on International Mobile Subscriber Identification (IMSI) range.
start-value imsi_start_value specifies the start of range in integer value of IMSI, and end-value
imsi_end_value specifies the end of range in integer value of IMSI.
imsi-based { { prefix | suffix } imsi/prefix/suffix_start_value } [ to imsi/prefix/suffix_end_value ]
Important
|
This section applies only to 9.0 and later releases for UMTS deployments.
|
Selects peer based on IMSI prefix or suffix or IMSI range.
prefix : Specifies the prefix range
suffix : Specifies the suffix range
imsi/prefix/suffix_start_value : Specifies the IMSI/prefix/suffix start value. prefix/suffix must be an IMSI prefix/suffix, and must be an integer from 1 through 15 characters.
imsi/prefix/suffix_end_value : Specifies the IMSI/prefix/suffix end value. prefix/suffix must be an IMSI prefix/suffix, and must be an integer from 1 through 15 characters that must be greater than the start value.
Important
|
If prefix/suffix is used, the lengths of both start and end prefix/suffix must be equal. If the prefix or suffix keyword is not specified, it will be considered as suffix.
|
msisdn-based { { prefix | suffix } msisdn/prefix/suffix_start_value } [ to msisdn/prefix/suffix_end_value ]
Specifies peer selection based on MSISDN prefix or suffix or MSISDN range.
prefix : Specifies the prefix range
suffix : Specifies the suffix range
msisdn/prefix/suffix_start_value : Specifies the MSISDN/prefix/suffix start value. prefix/suffix must be an MSISDN prefix/suffix, and must be an integer from 1 through 15 characters.
msisdn/prefix/suffix_end_value : Specifies the MSISDN/prefix/suffix end value. prefix/suffix must be an MSISDN prefix/suffix, and must be an integer from 1 through 15 characters that must be greater than the start
value.
realm realm_name
The realm_name must be an alphanumeric string of 1 through 127 characters, and can contain punctuation characters. The realm may typically
be a company or service name.
secondary-peer secondary_peer_name
Specifies a name for the secondary host to be used for failover processing. When the route-table does not find an AVAILABLE
route, the secondary host performs a failover processing if the diameter session failover command is set.
secondary_peer_name must be an alphanumeric string of 1 through 63 characters, and can contain punctuation characters.
Usage Guidelines
Use this command to configure Diameter credit control host selection.
If the diameter peer-select command is not configured, and if multiple peers are configured in the endpoint, the available peers configured in the endpoint
are automatically chosen in a load-balanced round-robin manner.
9.0 and later releases support peer selection using prefix or suffix of IMSI or IMSI range. Subscribers are now assigned to
a primary OCS instance based on the value of the IMSI prefix or suffix of a length of 1 to 15 digits. If the prefix or suffix
keyword is not specified, it will be considered as suffix. Up to 64 peer selects can be configured. At a time either prefix
or suffix mode can be used in one DCCA config. If prefix or suffix mode is used, the lengths of all prefix/suffix must be
equal.
In 12.2 and later releases, Diameter peer selection can also be performed based on the configurable prefix or suffix of MSISDN or MSISDN range.
Each primary OCS may have a designated secondary OCS in case of failure of the primary. It will be the responsibility of the
GGSN to use the appropriate secondary OCS in case of primary failure. The secondary OCS for each primary OCS will be one of
the existing set of OCSs.
Note
|
Load-balancing is not supported if the diameter peer-select command is configured under the credit control group.
If the directly connected hosts/peers are configured under the credit control application, thenround-robin selection is not
available even if the equal weighted peers are configured under the diameter end-point. In this scenario, the primary host/peer
configured under the credit control group have precedence and selected always.
|
Example
The following command configures a Diameter credit control peer named test and the realm companyx : diameter peer-select peer test realm companyx
The following command configures IMSI-based Diameter credit control peer selection in the IMSI range of 1234567890 to 1234567899 : diameter peer-select peer star imsi-based start-value 1234567890 end-value 1234567899
The following command configures IMSI-based DCCA peer selection with IMSI suffix of 100 through 200 : diameter peer-select peer test_peer realm test_realm secondary-peer test_sec_realm realm test_realm2 imsi-based suffix 100 to 200