Accounting Policy Configuration Mode Commands

The Accounting Policy Configuration Mode is used to define the accounting method, mode, and event trigger responses for the accounting policy supporting the Rf (off-line charging) interface.

IMPORTANT:

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

accounting-event-trigger

Configures the response to specific event triggers for this policy. Multiple event instances can be configured.

Platform:

ASR 5000

ASR 5500

Product:

HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
accounting-event-trigger { cgi-sai-change | ecgi-change | flow-information-change | interim-timeout | location-change | rai-change | tai-change } action { interim | stop-start }[ default | no ] accounting-event-trigger { cgi-sai-change | ecgi-change | flow-information-change | interim-timeout | location-change | rai-change | tai-change }
default

Returns the command to its default setting of interim for the action keyword (for all events).

no

Removes the specified event trigger configuration from this policy.

cgi-sai-change

Specifies that the action is initiated upon indication of a Cell Global Identification-Service Area Identification (CGI-SAI) change.

ecgi-change

Specifies that the action is initiated upon indication of an E-UTRAN Cell Global Identifier (ECGI) change.

flow-information-change

Specifies that the action is initiated upon indication of a change in the flow information.

interim-timeout

Specifies that the action is initiated upon expiration of the interim interval.

location-change

Specifies that the action is initiated upon indication of a location change.

rai-change

Specifies that the action is initiated upon indication of an Routing Area Identifier (RAI) change.

tai-change

Specifies that the action is initiated upon indication of a Tracking Area Identity (TAI) change.

action { interim | stop-start }

Default: interim

Specifies the action initiated upon the occurrence of an event.

interim: Specifies that an interim ACR (Accounting Request) is sent.

stop-start: Specifies that a Stop-Start ACR is sent.


Usage:

Use the is command to configure that action taken upon the occurrence on an accounting event trigger.


Example:
The following command configures the policy to send a Stop-Start ACR upon indication of an interim timeout:
accounting-event-trigger
interim-timeout action stop-start
accounting-keys

Aggregates the accounting information, using the configurable keys (QCI) along with default keys.

Platform:

ASR 5000

ASR 5500

Product:

HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
accounting-keys qcidefault accounting-keys
default

Aggregate the accounting information, using QoS Class Identifier (QCI) as the additional key.

qci

Aggregate the accounting information, using QCI as the additional key.


Usage:

Use this command to aggregate the accounting information, using the configurable keys (QCI) along with default keys.

In service data flow (SDF) level accounting, buckets are created and maintained using the Reporting-Level AVP value present in Gx message. The following are the accounting keys currently supported:

  • Rating-group
  • Rating-group and Service-Identifier
  • Rating-group and QCI
  • Rating-group, Service-Identifier, and QCI

Example:
The following command aggregates the accounting information, using QCI as the additional key:
accounting-keys qci
accounting-level

Configures the type of accounting performed by this profile.

Platform:

ASR 5000

ASR 5500

Product:

HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
accounting-level { flow | pdn | pdn-qci | qci | sdf | subscriber }default accounting-level
default

Returns the command to the default setting of subscriber-based accounting.

flow
Specifies that flow-based accounting is to be used for this accounting profile. Accounting Request (ACR) Start messages include an AVP with the following Evolved Packet System (EPS) information:
  • PDN identifier
  • QCI for which accounting is done
  • Charging rule name for which accounting is being done
  • AF charging identifier (included if PCRF has provided a charging identifier to correlate AF generated information)
  • Flow description for the flows
  • User Equipment information if available (ESN/MEID)
  • Address of HSGW/S-GW
  • Address of the P-GW (if available), one or more instances
pdn
Specifies that PDN-based accounting is to be used for this accounting profile. ACR Start messages include an AVP with the following EPS information:
  • Addresses allocated to the UE in this PDN
  • PDN identifier
  • User Equipment information if available (ESN/MEID)
  • Address of HSGW/S-GW
  • Address of the P-GW (if available), one or more instances
pdn-qci
Specifies that PDN-QCI accounting is to be used for this accounting profile. ACR Start messages include an AVP with the following EPS information:
  • Addresses allocated to the UE in this PDN
  • PDN identifier
  • QCI for which accounting is done
  • User Equipment information if available (ESN/MEID)
  • Address of HSGW/S-GW
  • Address of the P-GW (if available), one or more instances
qci
Specifies that QCI-based accounting is to be used for this accounting profile. ACR Start messages include an AVP with the following EPS information:
  • QCI for which accounting is done
  • User Equipment information if available (ESN/MEID)
  • Address of HSGW/S-GW
  • Address of the P-GW (if available), one or more instances
sdf

Specifies that service data flow accounting is to be used for this accounting profile. ACR Start messages include an AVP with the following EPS information:

subscriber
Specifies that subscriber-based accounting is to be used for this accounting profile. ACR Start messages include an AVP with the following EPS information:
  • User Equipment information if available (ESN/MEID)
  • Address of HSGW/S-GW
  • Address of the P-GW (if available), one or more instances

Usage:

Use this command to specify the type of accounting performed by this profile.


Example:
The following command sets the accounting type for this profile to flow-based:
accounting-level flow
accounting-mode

Configures the accounting mode for this profile.

Platform:

ASR 5000

ASR 5500

Product:

HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
accounting-mode normaldefault accounting-mode
default

Returns the accounting mode for this profile to its default setting of “normal”.

normal

Specifies that “normal” (start/interim/stop) accounting will be performed for this profile.


Usage:

Use this command to set the accounting mode for this profile.

cc

Configures a charging characteristics (CC) profile, within the accounting profile configuration, for CDR generation.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
cc profile index { buckets num | interval seconds | sdf-interval seconds | sdf-volume { downlink octets { uplink octets } | total octets | uplink octets { downlink octets } }  | serving-nodes num | tariff
time1 min
hrs [ time2 min hrs...time4 min hrs ] | volume { downlink octets { uplink octets } | total octets | uplink octets { downlink octets } } }default cc profile indexno cc profile index { buckets | interval | sdf-interval | sdf-volume | serving-nodes | tariff | volume }
default

Returns all profile features, for the specified profile index, to their default settings.

no

Returns the specified feature to its default setting.

profile index

Specifies a billing type to be applied to this profile. index must be one of the following:

1: Hot billing

2: Flat billing

4: Prepaid billing

8: Normal billing

buckets num

Default: 4

Specifies the number of container changes in the S-GW CDR due to QoS changes or tariff times. If an accounting policy is not configured, this value is 4. GTPP accounting will use the default value if the configured value is beyond 4.

In 12.1 and earlier releases, num must be an integer value from 1 through 4.

In release 12.2, num must be an integer value from 1 through 10.

In 12.3 and later releases, num must be an integer value from 1 through 20.

IMPORTANT:

Please note that the maximum value for the CC profile buckets is extended to support up to 10 for Diameter Rf accounting only. However, in the case of GTPP accounting, this CLI command allows configuring only up to 4 buckets.

interval seconds

Default: disabled

Specifies a time interval for closing the charging record if the minimum volume thresholds are satisfied. seconds must be an integer value from 60 through 40000000.

sdf-interval seconds

Default: disabled

Specifies a time interval for closing the charging record for a specific flow if the minimum volume thresholds are satisfied. seconds must be an integer value from 60 through 40000000.

sdf-volume { downlink octets { uplink octets } | total octets | uplink octets { downlink octets } }

Specifies octet volume thresholds for the generation of interim CDRs for a specific flow.

downlink octets: Sets the threshold limit for the number of downlink octets that must be reached before the charging record for a specific flow is closed. octets must be an integer value from 100000 through 4000000000.

total octets: Sets the threshold limit for the total number of octets that must be reached before the charging record for a specific flow is closed. octets must be an integer value from 100000 through 4000000000.

uplink octets: Sets the threshold limit for the number of uplink octets that must be reached before the charging record for a specific flow is closed. octets must be an integer value from 100000 through 4000000000.

serving-nodes num

Default: 4

Specifies the number of serving node changes (inter-serving node switchovers) after which the interim CDR is generated. In P-GW and S-GW, a partial record needs to be generated whenever there is a serving node address list overflow. Serving node is added to the CDR list during handover scenarios. num must be an integer value from 1 through 4. If an accounting policy is not configured, this value is 4.

tariff time1 min hrs [ time2 min hrs...time4 min hrs ]

Specifies time-of-day values used to determine when a container is closed in the charging records.

time1 min hrs: Specifies the first time-of-day value used to close the current container in the charging record. min must be an integer value from 0 through 59. hrs must be an integer value from 0 through 23.

time2 min hrs...time4 minutes hours: Specifies the second, third and fourth time-of-day values used to close containers in the charging record. min must be an integer value from 0 through 59. hrs must be an integer value from 0 through 23.

volume { downlink octets { uplink octets } | total octets | uplink octets { downlink octets } }

Specifies octet volume thresholds for the generation of interim CDRs.

downlink octets: Sets the threshold limit for the number of downlink octets that must be reached before the charging record is closed.

In 12.1 and earlier releases, the downlink octets must be an integer value from 100000 to 1345294336.

In 12.2 and later releases, the downlink octets must be an integer value from 100000 to 4000000000.

total octets: Sets the threshold limit for the total number of octets that must be reached before the charging record is closed.

In 12.1 and earlier releases, the totaloctets must be an integer value from 100000 to 400000000.

In 12.2 and later releases, the total octets must be an integer value from 100000 to 4000000000.

uplink octets: Sets the threshold limit for the number of uplink octets that must be reached before the charging record is closed.

In 12.1 and earlier releases, the uplink octets must be an integer value from 100000 to 400000000.

In 12.2 and later releases, the uplink octets must be an integer value from 100000 to 4000000000.


Usage:

Use this command to set charging characteristics that directly affect the CDR generation on the HSGW, P-GW, or S-GW.


Example:
The following command creates a hot billing profile with a total octet volume threshold set to 500000:
cc profile 1 volume
total 500000
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.

max-containers

Control the number of containers in an ACR message.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
max-containers { containers | fill-buffer }default max-containers
default

Cache containers until buffer is filled.

containers

System can send any value equal or less than the maximum number of containers selected. The number of containers that can be sent can be dynamically selected by the system, but it should not cross the limit of containers in any message.

containers must be in integer from 1 to 30.

fill-buffer

Cache containers until buffer is filled.


Usage:

Use this command to control the number of containers before an interim ACR message is triggered.


Example:
The following command sets a maximum of 20 containers in an ACR message:
max-containers  20
operator-string

Configures a text string to be included with accounting messages sent by this policy.

Platform:

ASR 5000

ASR 5500

Product:

HSGW, P-GW, S-GW, SAEGW


Privilege:

Administrator


Syntax
operator-string stringno operator-string
no

Removes the operator string from this policy.

string

Specifies a text string that is included with accounting messages originating from this policy. string must be from 1 to 63 alphanumeric characters.


Usage:

Use this command to create a text string to be included with accounting messages originating from this policy.


Example:
The following command creates the text string pgw_local to be included with accounting messages originating from this policy:
operator-string pgw_local