Important: Commands used in the configuration examples in this section provide base functionality to the extent that the most common or likely commands and/or keyword options are presented. In many cases, other optional commands and/or keyword options are available. Refer to the Command
Line Interface Reference for complete information regarding all commands.
•
|
[ 600-00-7526 ] Enhanced Charging Bundle 1 1k Sessions: To enable and configure ECS functionality.
|
•
|
[ 600-00-7574 ] Enhanced Charging Bundle 2 1k Sessions: To enable and configure Diameter and DCCA functionality with ECS.
|
For information on installing licenses, see the Managing License Keys section of the
Software Management Operations chapter in the
Administration and Configuration Guide.
Important: Commands used in the configuration examples in this section provide base functionality to the extent that the most common or likely commands and/or keyword options are presented. In many cases, other optional commands and/or keyword options are available. Refer to the Command
Line Interface Reference for complete information regarding all commands.
action priority <action_priority> { [ dynamic-only | static-and-dynamic | timedef
<timedef_name> ] { group-of-ruledefs
<ruledefs_group_name> | ruledef
<ruledef_name> } charging-action
<charging_action_name> [ monitoring-key
<monitoring_key> ] [ description
<description> ] }
route priority <route_priority> ruledef
<ruledef_name> analyzer
<analyzer> [ description
<description> ]
Important: If you have configured RADIUS Prepaid Billing, configuring charging records is optional.
attribute <attribute> { [ format { MM/DD/YY-HH:MM:SS | MM/DD/YYYY-HH:MM:SS | YYYY/MM/DD-HH:MM:SS | YYYYMMDDHHMMSS | seconds } ] [ localtime ] | [ { ip | tcp } { bytes | pkts } { downlink | uplink } ] priority
<priority> }
Important: For information on EDR format configuration and rule variables, refer to the
EDR Format Configuration Mode Commands chapter of the Command
Line Interface Reference.
Important: If you have configured RADIUS Prepaid Billing, configuring charging records is optional.
attribute <attribute> { [ format { MM/DD/YY-HH:MM:SS | MM/DD/YYYY-HH:MM:SS | YYYY/MM/DD-HH:MM:SS | YYYYMMDDHHMMSS | seconds } ] [ localtime ] | [ { bytes | pkts } { downlink | uplink } ] ] priority
<priority> }
Important: For information on UDR format configuration and rule variables, refer to the
UDR Format Configuration Mode Commands chapter of the Command
Line Interface Reference.
•
|
You must specify the sftp keyword to enable the new account to SFTP into the context to retrieve record files.
|
Important: Commands used in the configuration examples in this section provide base functionality to the extent that the most common or likely commands and/or keyword options are presented. In many cases, other optional commands and/or keyword options are available. Refer to the Command
Line Interface Reference for complete information regarding all commands.
Important: This information is only applicable to GGSN networks.
apn <apn_name> [ -noconfirm ]
•
|
Both the medium and high options causes reorganization of the entire memory structure whenever any change is made (for example, adding another action CLI command).
|
•
|
high option causes allocation of a significant amount of memory for the most efficient organization.
|
Important: To configure and enable Diameter and DCCA functionality with ECS on your system, you must obtain and install the [600-00-7574] Enhanced Charging Bundle 2 1k Sessions license.
Important: Before configuring Diameter or RADIUS CCA, you must configure AAA parameters as described in the
AAA Interface Administration and Reference.
Important: Commands used in the configuration examples in this section provide base functionality to the extent that the most common or likely commands and/or keyword options are presented. In many cases, other optional commands and/or keyword options are available. Refer to the Command
Line Interface Reference for complete information regarding all commands.
•
|
<ecs_service_name> must be the name of the Enhanced Charging Service in which you want to configure Prepaid Credit Control Application.
|
•
|
<charging_action_name> must be the name of the charging action for which you want to configure Prepaid Credit Control Application.
|
•
|
Optional: To configure the redirection of URL for packets that match a ruledef and action on quota request timer, in the Charging Action Configuration mode, enter the following command. This command also specifies the redirect-URL action on packet and flow for Session Control functionality.
|
flow action redirect-url <redirect_url> [ clear-quota-retry-timer ]
•
|
Optional: To configure credit control quota related parameters, use the following configuration:
|
cca quota { holding-time <holding_time> content-id
<content_id> | retry-time
<retry_time> [ max-retries
<max_retries> ] }
<rulebase_name> must be the name of the rulebase in which you want to configure Prepaid Credit Control configurables.
•
|
Optional: To define credit control rules for quota state and URL redirect match rules with RADIUS AVP, use the following configuration:
|
<ruledef_name> must be the name of the ruledef that you want to use for Prepaid Credit Control Application rules.
cca redirect-indicator configuration is a RADIUS-specific configuration.
•
|
Optional: This is a Diameter-specific configuration. To configure the failure handling options for credit control session, in the Credit Control Configuration Mode, use the following configuration:
|
failure-handling { ccfh-session-timeout <session_timeout> | { initial-request | terminate-request | update-request } { continue [ go-offline-after-tx-expiry | retry-after-tx-expiry ] | retry-and-terminate [ retry-after-tx-expiry ] | terminate }
•
|
Optional: To configure the triggering option for credit reauthorization when the named values in the subscriber session changes, in the Credit Control Configuration Mode, enter the following command:
|
•
|
Optional: This is a Diameter-specific configuration. If the configuration is for 3GPP network, to configure the virtual or real APN name to be sent in Credit Control Application (CCA) message, in the Credit Control Configuration Mode, enter the following command:
|
Important: To configure and enable Diameter and DCCA functionality with ECS on your system, you must obtain and in stall the [ 600-00-7574 ]
Enhanced Charging Bundle 2 1k Sessions license.
Important: It is assumed that you have already fully configured the AAA parameters as described in the
AAA Interface Administration and Reference, and Credit Control Application as described in
Configuring Prepaid Credit Control Application (CCA) section for Diameter mode.
diameter peer-select peer <peer_name> [ realm <
realm_name> ] [ secondary-peer
<sec_peer_name> [ realm
<realm_name> ] ] [ imsi-based { [ prefix | suffix ]
<imsi/prefix/suffix_start_value> } [ to
<imsi/prefix/suffix_end_value> ] ]
•
|
Diameter peer configuration set with the diameter peer-select command can be overridden by the dcca peer-select peer command in the APN Configuration mode for 3GPP service networks, and in Subscriber Configuration mode in other service networks.
|
•
|
Optional: To configure the maximum time, in seconds, to wait for a response from Diameter peer, in the Credit Control Configuration Mode, enter the following command:
|
•
|
Optional: To configure Diameter Credit Control Session Failover, in the Credit Control Configuration Mode, enter the following command:
|
•
|
Optional: If you want to configure the service for IMS authorization in 3GPP service network, you can configure dynamic rule matching with Gx interface and dynamic rule matching order in rulebase, use the following configuration:
|
action priority <action_priority> { [ dynamic-only | static-and-dynamic | timedef
<timedef_name> ] { group-of-ruledefs
<ruledefs_group_name> | ruledef
<ruledef_name> } charging-action
<charging_action_name> [ monitoring-key
<monitoring_key> ] [ description
<description> ] }
•
|
Optional: To configure Diameter group AVP Requested-Service-Unit for Gy interface support to include a sub-AVP in CCRs using volume, time, and unit specific charging, in the Rulebase Configuration Mode, enter the following command:
|
cca diameter requested-service-unit sub-avp { time cc-time <duration> | units cc-service-specific-units <charging_unit> | volume { cc-input-octets <bytes> | cc-output-octets <bytes> | cc-total-octets <bytes> } + }
Important: The
dcca peer-select configuration completely overrides all instances of
diameter peer-select configured within the Credit Control Configuration Mode for an Enhanced Charging service.
dcca peer-select peer <host_name> [ [ realm
<realm_name> ] [ secondary-peer
<host_name> [ realm
<realm_name> ] ] ]
Important: This information is only applicable to GGSN networks.
Important: The
dcca peer-select configuration completely overrides all instances of
diameter peer-select configured within the Credit Control Configuration Mode for an Enhanced Charging Service.
dcca peer-select peer <host_name> [ [ realm
<realm_name> ] [ secondary-peer
<host_name> [ realm
<realm_name> ] ] ]
Important: The RADIUS Prepaid feature of ECS has no connection to the system-level Prepaid Billing Support or the 3GPP2 Prepaid features that are enabled under different licenses.
Important: It is assumed that you have already fully configured the AAA parameters as described in the
AAA Interface Administration and Reference, and Credit Control Application as described in
Configuring Prepaid Credit Control Application (CCA) section for RADIUS mode.
•
|
<rulebase_name> must be the name of the rulebase in which you want to configure Prepaid Credit Control configurables.
|
•
|
<vpn_context> must be the charging context in which the RADIUS parameters are configured:
|
•
|
Optional: To specify the accounting interval duration for RADIUS prepaid accounting, in the Rulebase Configuration Mode, enter the following command:
|
•
|
Optional: To specify the user password for RADIUS prepaid services, in the Rulebase Configuration Mode, enter the following command:
|
peer <peer> realm <
realm> address <
ip_address>
Important: Commands used in the configuration examples in this section provide base functionality to the extent that the most common or likely commands and/or keyword options are presented. In many cases, other optional commands and/or keyword options are available. Refer to the Command
Line Interface Reference for complete information regarding all commands.
•
|
<ecs_service_name> must be the enhanced charging service’s name; no CSS service needs to be configured.
|
Important: This information is only applicable to GGSN networks.
Important: This section assumes that a GGSN service is already fully configured. The GGSN service must be configured in the source context.
Important: If the RADIUS accounting is configured you do not need to configure GTPP accounting.
•
|
The gtpp single-source command must be entered before any other configuration commands. If you add it to an existing configuration, make sure that it is the first command implemented after cards and ports are configured. This ensures that this command is implemented before any AAA Manager or Session Manager processes are started.
|
cdr [ [ push-interval <interval> ] [ push-trigger space-usage-percent
<trigger_percentage> ] [ remove-file-after-transfer ] [ transfer-mode { pull | push primary { encrypted-url
<encrypted_url> | url
<url> } [ secondary { encrypted-secondary-url
<encrypted_secondry_url> | url
<secondary_url> } ] } ] [ via local-context ] + | use-harddisk ]
file [ charging-service-name { include | omit } ] [ compression { gzip | none } ] [ current-prefix <string> ] [ delete-timeout
<seconds> ] [ directory
<directory_name> ] [ edr-format-name ] [ exclude-checksum-record ] [ field-separator { hyphen | omit | underscore } ] [ file-sequence-number rulebase-seq-num ] [ headers ] [ name
<file_name> ] [ reset-indicator ] [ rotation [ num-records
<number> | time
<seconds> | volume
<bytes> ] ] [ sequence-number { omit | padded | padded-six-length | unpadded } ] [ storage-limit
<limit> ] [ time-stamp { expanded-format | rotated-format | unix-format } ] [ trailing-text
<string> ] [ trap-on-file-delete ] [ xor-final-record ] +
file [ charging-service-name { include | omit } ] [ compression { gzip | none } ] [ current-prefix <string> ] [ delete-timeout
<seconds> ] [ directory
<directory_name> ] [ exclude-checksum-record ] [ field-separator { hyphen | omit | underscore } ] [ file-sequence-number rulebase-seq-num ] [ headers ] [ name
<file_name> ] [ reset-indicator ] [ rotation [ num-records
<number> | time
<seconds> | volume
<bytes> ] ] [ sequence-number { omit | padded | padded-six-length | unpadded } ] [ storage-limit
<limit> ] [ time-stamp { expanded-format | rotated-format | unix-format } ] [ trailing-text
<string> ] [ trap-on-file-delete ] [ udr-seq-num ] [ xor-final-record ] +
•
|
The cdr command keywords can be configured either in the EDR or the UDR Configuration Mode. Configuring in one mode prevents the configurations from being applied in the other mode.
|
•
|
The use-harddisk keyword is only available on the ASR 5000.
|
•
|
The cdr-push command is available in the Exec Mode.
|
•
|
<file_name> must be absolute path of the local file to push.
|
The following commands use SFTP to log on to a context named ECP as a user named
ecpadmin, through an interface configured in the ECS context that has the IP address
192.168.1.10 and retrieve all EDR or UDR files from the default locations:
•
|
fair-usage command enables the Fair Usage feature.
|
•
|
fair-usage threshold-percent <usage_threshold> command configures when to enable resource monitoring. As long as the amount of available memory is greater than the configured threshold, any memory requests are granted.
|
<usage_threshold> is a percent value, and must be an integer from 1 through 100.
•
|
fair-usage deact-margin <deactivate_margin> command configures when to disable resource monitoring. It is the window size between restricting/not restricting memory utilization.
|
<deactivate_margin> is a percentage value, and must be an integer from 1 through 100. By default, it is set to 10 percent.
•
|
fair-usage adjust-factor <adjust_factor> is a hidden CLI command available to operators. This command configures the accuracy of memory reporting. When Session Manager reports its memory consumption, this percentage is added to the value being reported. With this, the reported memory will change as the sessions obtain/release memory.
|
<adjust_factor> is a percentage value, and must be an integer from 1 through 100. By default, it is set to 10 percent.
•
|
fair-usage inline-memory-share <max_mem_for_in-line> is a hidden CLI command available to operators for fine tuning the the performance of this feature. This command configures the amount of memory possibly allocated to in-line services on a Session Manager instance. This limit is per Session Manager.
|
<max_mem_for_in-line> is a percentage value, and must be an integer from 1 through 100. By default, it is set to 60 percent.
•
|
fair-usage session-waiver-percent <session_waiver> command configured in the rulebase configures a waiver for subscribers using the rulebase to use more than the average amount of memory limit configured in the fair-usage threshold-percent <usage_threshold> command.
|
<session_waiver> is a percentage value, and must be an integer from 0 through 1000. By default, it is set to 20 percent.
action priority <action_priority> { [ dynamic-only | static-and-dynamic | timedef
<timedef_name> ] { group-of-ruledefs
<ruledefs_group_name> | ruledef
<ruledef_name> } charging-action
<charging_action_name> [ monitoring-key
<monitoring_key> ] [ description
<description> ] }
timedef <timedef_name> [ -noconfirm ]
action priority <action_priority> timedef <
timedef_name> { group-of-ruledefs <
group_name> | ruledef <
ruledef_name> } charging-action <
charging_action_name> [ description <
description> ]
Important: This feature is license dependent. Please contact your sales representative for more information.
insert <xheader_field_name> { string-constant
<xheader_field_value> | variable { bearer { 3gpp { apn | charging-characteristics | charging-id | imei | imsi | rat-type | sgsn-address } | acr | customer-id | ggsn-address | mdn | radius-calling-station-id | session-id | sn-rulebase | subscriber-ip-address | username } [ encrypt ] | http { host | url } }
•
|
The encrypt option specifies encryption of x-header field configuration. This option must be configured in the case the X-Header Encryption feature will be configured.
|
Important: This feature is license dependent. Please contact your sales representative for more information.
certificate name <certificate_name> pem { { data
<pem_certificate_data> private-key pem [ encrypted ] data
<pem_pvt_key> } | { url
<url> private-key pem { [ encrypted ] data
<pem_pvt_key> | url
<url> } }