ECS Changes in Release 14.0

This chapter identifies features and functionality added to, modified for, or deprecated from 14.0 Enhanced Charging Service (ECS) software releases.

Topics covered in this chapter are:

IMPORTANT:

Enhancements to Diameter, GTPP, and RADIUS in release 14.0 are located in the Accounting Management Changes chapter.

Enhancements to SNMP MIB in release 14.0 are located in the SNMP MIB Changes chapter.

Enhancements to Web Element Manager (WEM) in release 14.0 are located in the Web Element Manager Changes chapter.

Omissions and Corrections

The following list of items link to changes found in a previous code drop that were omitted from the Release Change Reference, or to technical corrections made to previously published content.

Omissions from/Corrections to June 29, 2012 Content

ECS Feature Changes as of May 31, 2013

This section provides information on ECS feature changes in release 14.0.

IMPORTANT:

For more information regarding features in this section, refer to the ECS Administration Guide for this release.

New ECS Features

This section identifies new ECS features available in release 14.0.

None for this release.

Modified ECS Features

This section identifies ECS features modified in release 14.0.

Support for HTTP Cookie Header in Rule Matching

This release introduces the functionality for ECS to match strings based on the configured rule in the cookie header field of a HTTP packet. The HTTP parser can parse up to a maximum of 4096 bytes in the cookie header and use the operators ‘contains’, ‘starts-with’, ‘ends-with’, and their derivaties for pattern matching.

Previous Behavior: ECS did not have the functionality to parse HTTP cookie headers to match rules on cookie contents.

New Behavior: With this release the HTTP parser can parse HTTP cookie headers and match rules based on the cookie contents.

Optimization of IP Subnet, IP Host-Pool and Port-Map-based Rulelines

ECS uses multiple optimizers to optimize rule lines for fast lookup during rule matching. With this release, the following rule lines are optimized for a better rule matching performance:

  • IPv4 address-based rule-lines with a 32 or non 32 subnet mask.
  • IPv6 address based rule-lines with a 128 or non 128 subnet mask.

ECS Command Changes as of May 31, 2013

This section provides information on ECS command changes in release 14.0.

IMPORTANT:

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Commands

This section identifies new ECS commands available in release 14.0.

http cookie

This command allows you to define rule expressions to match strings in the HTTP cookie header.

active-charging service
<service_name> 
   ruledef <ruledef_name>
      [ no ] http
cookie [ case-sensitive ] operator <cookie_string>
      end

Note: The cookie match ruleline can be combined with other rulelines having different match criteria. Multiple line cookie header strings can be combined together using a comma (,) separator.

rtsp initial-bytes-limit

This command allows to set the maximum number of uplink and downlink bytes, added together to accumulate, while rule matching and charging is being delayed for RTSP flows on P-GW and GGSN.

active-charging service
service_name 
   rulebase rulebase_name
      rtsp
initial-bytes-limit rtsp_bytes
      default
rtsp initial-bytes-limit <command_syntax>
      end

flow rtsp-all-pkts

This command allows you to delay charge packets in an RTSP flow on P-GW and GGSN.

active-charging service
service_name 
   rulebase rulebase_name
      [ no | default ] flow
rtsp-all-pkts charge-to-application
      end

Modified ECS Commands

This section identifies ECS commands modified in release 14.0.

rule-variable

This command allows you to specify fields and their order in EDRs.

active-charging service
<service_name> 
   edr-format <format_name>
      rule-variable
http cookie
      end

bandwidth-policy

This command allows you to create/configure/delete bandwidth policies.

With this release, a maximum of 128 bandwidth policies can be configured.

active-charging service <service_name>
   bandwidth-policy
<bandwidth_policy_name> 
      end

Deprecated ECS Commands

This section identifies deprecated ECS commands that are no longer supported in release 14.0.

None for this release.

ECS Performance Indicator Changes as of May 31, 2013

This section provides information on ECS performance indicator changes in release 14.0.

None for this release.

ECS Feature Changes as of February 20, 2013

This section provides information on ECS feature changes in release 14.0.

None for this release.

ECS Configuration Management Changes as of February 20, 2013

This section provides information on ECS configuration command changes in release 14.0.

IMPORTANT:

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Configuration Commands

This section identifies new ECS commands available in release14.0.

flow rtsp-all-pkts

This command allows you to delay charge packets in an RTSP flow.

ACS Rulebase Configuration

[ no | default ] flow
rtsp-all-pkts charge-to-application

rtsp initial-bytes-limit

This command allows to set the maximum number of uplink and downlink bytes, added together to accumulate, while rule matching and charging is being delayed for RTSP flows.

ACS Rulebase Configuration

rtsp initial-bytes-limit rtsp_bytesdefault rtsp initial-bytes-limit

Modified ECS Configuration Commands

This section identifies ECS commands modified in release 14.0.

None for this release.

Deprecated ECS Configuration Commands

This section identifies deprecated ECS commands that are no longer supported in release 14.0.

None for this release.

ECS Performance Management Changes as of February 20, 2013

This section provides information on ECS performance management changes in release 14.0.

IMPORTANT:

For more information regarding bulk statistics in this section, refer to the Statistics and Counters Reference for this release.

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Bulk Statistics

This section identifies new ECS bulk statistics available in release 14.0.

None for this release.

Modified ECS Bulk Statistics

This section identifies ECS bulk statistics modified in release 14.0.

None for this release.

Deprecated ECS Bulk Statistics

This section identifies deprecated ECS bulk statistics that are no longer supported in release 14.0.

None for this release.

New ECS Performance Commands

This section identifies new ECS performance commands available in release 14.0.

None for this release.

Modified ECS Performance Commands

This section identifies ECS performance commands modified in release 14.0.

show active-charging rulebase statistics

This command displays information related to the ECS rulebase.

Exec Mode

The following field has been added to the output of this command:
  • RTSP Initial Bytes Limit reached count

Deprecated ECS Performance Commands

This section identifies deprecated ECS performance commands that are no longer supported in release 14.0.

None for this release.

ECS Security Management Changes as of February 20, 2013

This section provides information on ECS security management changes in release 14.0.

None for this release.

ECS Feature Changes as of January 31, 2013

This section provides information on ECS feature changes in release 14.0.

New ECS Features

This section identifies new ECS features available in release 14.0.

RTSP, RTCP, and RTP Correlation

This release introduces the RTSP correlation feature that enables RTP and RTCP packets to be analyzed with the RTP analyzer by mapping the child RTP and RTCP traffic with the parent RTSP flow (correlated flow). The correlated RTP and RTCP packets can be matched with a single ruledef by specifying a URI string in regular expression or URI matching operands (contains, starts-with, equals).

Modified ECS Features

This section identifies ECS features modified in release 14.0.

None for this release.

ECS Configuration Management Changes as of January 31, 2013

This section provides information on ECS configuration command changes in release 14.0.

IMPORTANT:

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Configuration Commands

This section identifies new ECS commands available in release 14.0.

rtsp-stream any-match

As part of the RTSP correlation feature, this command allows you to define rule expressions to match all user traffic of type RTSP, RTCP, and RTP to achieve an unified charging for RTSP correlated flows.

ACS Ruledef Configuration Mode

[ no ] rtsp-stream
any-match operator condition

rtsp-stream first-setup-url

As part of the RTSP correlation feature, this command allows you to define rule expressions to match user traffic of type RTSP, RTCP, and RTP on the first setup URL of the parent RTSP flow to achieve an unified charging for RTSP correlated flows.

ACS Ruledef Configuration Mode

[ no ] rtsp-stream
first-setup-url [ case-sensitive ] operator url

Modified ECS Configuration Commands

This section identifies ECS commands modified in release 14.0.

flow action

This command allows you to specify the action to take on packets that matches rule definitions. With this release, the following keyword is added to the command:

  • discard-on-failure: When configured, this keyword will discard packets on readdressing failures due to duplicate key.

ACS Charging Action Configuration Mode

flow action readdress [ [ server ipv4_address [ discard-on-failure ] [ dns-proxy-bypass ] ] [ port port_number [ discard-on-failure ] [ dns-proxy-bypass ] ] ]

Deprecated ECS Configuration Commands

This section identifies deprecated ECS commands that are no longer supported in release 14.0.

None for this release.

ECS Performance Management Changes as of January 31, 2013

This section provides information on ECS performance management changes in release 14.0.

IMPORTANT:

For more information regarding bulk statistics in this section, refer to the Statistics and Counters Reference for this release.

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Bulk Statistics

This section identifies new ECS bulk statistics available in release 14.0.

None for this release.

Modified ECS Bulk Statistics

This section identifies ECS bulk statistics modified in release 14.0.

None for this release.

Deprecated ECS Bulk Statistics

This section identifies deprecated ECS bulk statistics that are no longer supported in release 14.0.

None for this release.

New ECS Performance Commands

This section identifies new ECS performance commands available in release 14.0.

None for this release.

Modified ECS Performance Commands

This section identifies ECS performance commands modified in release 14.0.

show active-charging regex status

This command displays information related to the regex engines.

Exec Mode

As part of the RTSP correlation feature, the following field has been added to the output of this command:
  • RSUL: This field displays the status of the rtsp-stream first-setup-url.

show active-charging regex statistics ruledef

This command displays the regex ruledef related statistics.

Exec Mode

As part of the RTSP correlation feature, the following field has been added to the output of this command:
  • RTSP-STREAM URL

show active charging service statistics

This command displays service and configuration counters for the active charging service.

Exec Mode

The following fields have been added to the output of this command:

  • Readdressing Failure Statistics(Packets)
  • Non SYN flow: Total number of readdressing packets with a non SYN flow failure.
  • Duplicate Key: Total number of readdressing packets with a duplicate key failure.
  • Dropped Pkts: Total number of packets discarded on readdressing failure.

show active-charging sessions full all

This command displays all available information for the active-charging sessions.

Exec Mode

The following fields have been added to the output of this command:

  • Total Readdressing Failure Packets: Total number of packets with readdressing failures.
  • Non SYN flow: Total number of readdressing packets with a non SYN flow failure.
  • Duplicate Key: Total number of readdressing packets with a duplicate key failure.
  • Dropped Pkts: Total number of packets discarded on readdressing failure.

show active-charging charging-action statistics

This command displays statistics of configured policies in a service.

Exec Mode

The following fields have been added to the output of this command:

  • Readdressing Failure Statistics(Packets)
  • Non SYN flow: Total number of readdressing packets with a non SYN flow failure.
  • Duplicate Key: Total number of readdressing packets with a duplicate key failure.
  • Dropped Pkts: Total number of packets discarded on readdressing failure.

show active-charging charging-action name

This command displays detailed information for specific charging action.

Exec Mode

The following fields have been added to the output of this command:

  • Discard on Readdressing Failure: Displays if the discard-on-failure keyword is enabled or disabled in the charging-action readdress.

show active-charging subsystem

This command displays information about the active charging service subsystem.

Exec Mode

The following fields have been added to the output of this command:

  • Readdressing Failure Statistics (Packets)
  • Non SYN flow: Total number of readdressing packets with a non SYN flow failure.
  • Duplicate Key: Total number of readdressing packets with a duplicate key failure.
  • Dropped Pkts: Total number of packets discarded on readdressing failure.

Deprecated ECS Performance Commands

This section identifies deprecated ECS performance commands that are no longer supported in release 14.0.

None for this release.

ECS Security Management Changes as of January 31, 2013

This section provides information on ECS security management changes in release 14.0.

None for this release.

ECS Feature Changes as of November 07, 2012

This section provides information on ECS feature changes in release 14.0.

None for this release.

ECS Configuration Management Changes as of November 07, 2012

This section provides information on ECS configuration management changes in release 14.0.

None for this release.

ECS Performance Management Changes as of November 07, 2012

This section provides information on ECS performance management changes in release 14.0.

IMPORTANT:

For more information regarding in this section, refer to the Statistics and Counters Reference for this release.

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Bulk Statistics

This section identifies new ECS bulk statistics available in release 14.0.

None for this release.

Modified ECS Bulk Statistics

This section identifies ECS bulk statistics modified in release 14.0.

The data type for the following bulk statistics changed from Int32 to Int64:

ECS Schema

  • ecs-ruleshit
  • ecs-ppruleshit
  • ecs-ttlflowconn
  • ecs-ttlflowdisc

Deprecated ECS Bulk Statistics

This section identifies deprecated ECS bulk statistics that are no longer supported in release 14.0.

None for this release.

New ECS Performance Commands

This section identifies new ECS performance commands available in release 14.0.

None for this release.

Modified ECS Performance Commands

This section identifies ECS performance commands modified in release 14.0.

show active-charging sessions full

Previous Behavior:In earlier 14.0 releases, the Client-IP field displayed the IPv4 address, or the prefix of the IPv6 address for EHRPD calls, and the full IPv6 address for all other calls.

New Behavior:Now, the Client-IP field displays the IPv4 address, or the prefix of the IPv6 address for all call types.

show active-charging sessions full

Displays statistics for Active Charging Service (ACS) sessions.

Exec Mode

show active-charging
sessions [ full ] [ all ]
The following fields have been modified in the output of this command:
  • Client-IP
    In earlier 14.0 releases, this field displayed the IPv4 address, or the prefix of the IPv6 address for eHRPD calls, and the full IPv6 address for all other calls. Now, this field displays the IPv4 address, or the prefix of the IPv6 address for all call types.

Deprecated ECS Performance Commands

This section identifies deprecated ECS performance commands that are no longer supported in release 14.0.

None for this release.

ECS Security Management Changes as of November 07, 2012

This section provides information on ECS security management changes in release 14.0.

None for this release.

ECS Feature Changes as of September 28, 2012

This section provides information on ECS feature changes in release 14.0.

IMPORTANT:

For more information regarding features in this section, refer to the ECS Administration Guide for this release.

New ECS Features

This section identifies new ECS features available in release 14.0.

x-Header Enrichment Anti Spoofing

This release introduces the anti spoofing feature for the ECS x-Header enrichment. The Anti Spoofing feature enables deletion and modification of the existing x-header fields to protect the operators and subscribers from spoofing, and provides a fraud detection mechanism when an external portal is used for a subscriber or content authorization. By default, anti spoofing is disabled and can be enabled at a field level in the CLI.

Refer to the insert command in the Modified ECS Configuration Commands section of this reference for CLI changes specific to this feature. Also refer to the show active-charging charging-action statistics name and show active-charging rulebase statistics name commands in the Modified ECS Performance Commands section of this reference for information on new output fields specific to this feature.

Rulebase List

This release introduces the rulebase list feature that enables multiple rulebases to be added to a rulebase list. The rulebase list is sent to the Online Charging System (OCS) over the Gy interface. When a subscriber call is connected, the OCS chooses the rulebase to be used for the subscriber session from the list. If the OCS is not reachable, the default configured rulebase will be used.

Refer to the rulebase-list and active-charging rulebase-list commands in the New ECS Configuration Commands section of this reference for CLI additions specific to this feature.

Modified ECS Features

This section identifies ECS features modified in release 14.0 and contains two types of modifications: enhancements and behavior changes. Feature enhancements are modifications based on customer change requests. Feature behavior changes are modifications based on software error corrections (bug fixes) that result in a change in the behavior of the feature.

None for this release.

ECS Configuration Management Changes as of September 28, 2012

This section provides information on ECS configuration command changes in release 14.0.

IMPORTANT:

For more information regarding commands in this section, refer to the GPRS / UMTS Command Line Interface Reference for this release.

New ECS Configuration Commands

This section identifies new ECS commands available in release 14.0.

charging-action-override

This command allows you to enable/disable overriding charging parameters of static rule with those of an ip-any rule or a specified dynamic rule. From later 12.3 release, this command replaces the policy-control charging-action-override command in the ACS Configuration Mode.

ACS Rulebase Configuration Mode

charging-action-override
custom1 [ use-rule dynamic_rule_name
 ] 
{ default | no } charging-action-override

rulebase-list

As part of the rulebase list feature, this command allows you to create and delete rulebase lists. The rulebase list to be used for a subscriber can be configured using the active-charging rulebase-list command in the APN Configuration Mode.

ACS Configuration Mode

rulebase-list rulebase_list_name
rulebase_name [ rulebase_name +  ]
no rulebase-list rulebase_list_name

Refer to the Rulebase List feature in the New ECS Features section of this reference for a feature overview. Also see the active-charging rulebase-list command in the New ECS Configuration Commands section of this reference.

active-charging rulebase-list

As part of the Rulebase List feature, this command allows you to specify the name of the Active Charging Service (ACS) rulebase list to be used for subscribers who use this APN. The rulebase list is created and configured using the rulebase-list command in the ACS Configuration Mode.

APN Configuration Mode

active-charging rulebase-list rulebase_list_name
no active-charging
rulebase-list 

Refer to the Rulebase List feature in the New ECS Features section of this reference for a feature overview. Also see the rulebase-list command in the New ECS Configuration Commands section of this reference.

Modified ECS Configuration Commands

This section identifies ECS commands modified in release 14.0.

insert

This command allows you to configure the x-header fields to be inserted in HTTP/WSP GET and POST request packets. With this release, the following keyword is added as part of the x-Header Enrichment Anti Spoofing feature:
  • delete-existing: This keyword can be used to enable detection of spoofing in x-header fields. The x-header field configured with this keyword will be removed from the HTTP header if it already exists, and only the gateway inserted field will remain. By default, anti spoofing is disabled, and if required, should be enabled at a field level.

ACS x-Header Format Configuration Mode

insert xheader_field_name { string-constant xheader_field_value | variable { bearer { 3gpp {apn | charging-characteristics | charging-id | imei | imsi | qos | rat-type | s-mcc-mnc | sgsn-address } | acr | customer-id | ggsn-address | mdn | msisdn-no-cc | radius-calling-station-id | session-id | sn-rulebase | subscriber-ip-address | username } [ encrypt ] | http { host | url } } [  delete-existing ] } 

Refer to the x-Header Enrichment Anti Spoofing feature in the New ECS Features section of this reference for a feature overview. Also refer to the show active-charging charging-action statistics name and show active-charging rulebase statistics name commands in the Modified ECS Performance Commands section of this reference for information on new output fields specific to this feature.

Deprecated ECS Configuration Commands

This section identifies deprecated ECS commands that are no longer supported in release 14.0.

policy-control charging-action-override

This command allows you to enable/disable overriding charging parameters of static rule with those of an ip-any rule or a specified dynamic rule. From later 12.3 release, this command has been replaced by the charging-action-override command in the ACS Rulebase Configuration Mode.

ACS Configuration Mode

policy-control charging-action-override
custom1 [ use-rule dynamic_rule_name
 ]
{ default | no } policy-control
charging-action-override

ECS Performance Management Changes as of September 28, 2012

This section provides information on ECS performance management changes in release 14.0.

IMPORTANT:

For more information regarding bulk statistics in this section, refer to the Statistics and Counters Reference for this release.

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Bulk Statistics

This section identifies new ECS bulk statistics available in release 14.0.

None for this release.

Modified ECS Bulk Statistics

This section identifies ECS bulk statistics modified in release 14.0.

None for this release.

Deprecated ECS Bulk Statistics

This section identifies deprecated ECS bulk statistics that are no longer supported in release 14.0.

None for this release.

New ECS Performance Commands

This section identifies new ECS performance commands available in release 14.0.

None for this release.

Modified ECS Performance Commands

This section identifies ECS performance commands modified in release 14.0.

show active-charging dns-learnt-ip-addresses statistics

This command displays the DNS learnt IP address statistics for the DNS Snooping feature.

Exec Mode

The following fields have been added to the output of this command:
  • Total learnt ipv4 entries: This field displays the summary of the total number of new IPv4 addresses received (learnt).
  • Total learnt ipv6 entries: This field displays the summary of the total number of new IPv6 addresses received (learnt).

show active-charging analyzer statistics

This command displays the statistical information for protocol analyzers.

Exec Mode

As part of the TCP analyzer statistics, the following fields have been added to the output of this command:
  • Uplink ACK Zero len: This field displays the total number of TCP zero length ACK packets uploaded.
  • Downlink ACK Zero len: This field displays the total number of TCP zero length ACK packets received.

show active-charging charging-action statistics name

This command displays information for charging actions configured in the Active Charging Service (ACS).

Exec Mode

As part of the x-Header Enrichment Anti Spoofing feature, the following fields have been added to the output of this command:
  • XHeader Bytes Removed: This field displays the total number of x-header bytes removed as a result of the anti spoofing feature configuration.
  • XHeader Pkts Removed: This field displays the total number of x-header packets removed as a result of the anti spoofing feature configuration.

Refer to the x-Header Enrichment Anti Spoofing feature in the New ECS Features section of this reference for a feature overview. Also refer to the insert command in the Modified ECS Configuration Commands section of this reference for this reference for CLI changes specific to this feature.

show active-charging rulebase statistics name

This command displays information for ACS rulebases.

Exec Mode

As part of the x-Header Enrichment Anti Spoofing feature, the following fields have been added to the output of this command:
  • Header Enrichment stats:
    • HTTP header buffering limit reached: This field displays the total number of times the HTTP header buffering fails due to the maximum buffering limit reached.

Refer to the x-Header Enrichment Anti Spoofing feature in the New ECS Features section of this reference for a feature overview. Also refer to the insert command in the Modified ECS Configuration Commands section of this reference for this reference for CLI changes specific to this feature.

Deprecated ECS Performance Commands

This section identifies deprecated ECS performance commands available in release 14.0.

None for this release.

ECS Security Management Changes as of September 28, 2012

This section provides information on ECS security management changes in release 14.0.

None for this release.

ECS Feature Changes as of August 17, 2012

This section provides information on ECS feature changes in release 14.0.

IMPORTANT:

For more information regarding features in this section, refer to the ECS Administration Guide for this release.

New ECS Features

This section identifies new ECS features available in release 14.0.

None for this release.

Modified ECS Features

This section identifies ECS features modified in release 14.0 and contains two types of modifications: enhancements and behavior changes. Feature enhancements are modifications based on customer change requests. Feature behavior changes are modifications based on software error corrections (bug fixes) that result in a change in the behavior of the feature.

Tethering Detection Feature Support on P-GW

IMPORTANT:

The Tethering Detection feature has limitations that restrict its optimal use and is not supported in this release. It is available only for lab / testing purposes.

IMPORTANT:

The Tethering Detection feature is license dependent.

In earlier 12.3 and 14.0 releases, the Tethering Detection feature was supported only on the GGSN and HA.

Now, the Tethering Detection feature is also supported on the P-GW.

For more information on the Tethering Detection feature, refer to the Enhanced Charging Service Administration Guide.

Rulebase Change Results in Dedicated Bearer Cleanup – Behavior Change

Previous Behavior: In earlier releases, after a call comes up successfully with the configured rulebase with both default and dedicated bearers, if the rulebase is changed via CoA, the dedicated bearer remains up with no rules installed on it as the existing rules are cleared. The same bearer can get updated with rules when previously installed rules or new rules eligible to get bound are installed from the Gx interface.

New Behavior: Now, if the rulebase is changed via CoA, the new rulebase gets applied to the default bearer but the dedicated bearer gets cleared as the rules are removed, and is created if any rules are installed from the Gx interface.

ECS Configuration Management Changes as of August 17, 2012

This section provides information on ECS configuration command changes in release 14.0.

None for this release.

ECS Performance Management Changes as of August 17, 2012

This section provides information on ECS performance management changes in release 14.0.

None for this release.

ECS Security Management Changes as of August 17, 2012

This section provides information on ECS security management changes in release 14.0.

None for this release.

ECS Feature Changes as of July 31, 2012

This section provides information on ECS feature changes in release 14.0.

None for this release.

ECS Configuration Management Changes as of July 31, 2012

This section provides information on ECS configuration command changes in release 14.0.

IMPORTANT:

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Configuration Commands

This section identifies new ECS commands available in release 14.0.

add-group-of-ruledef

This command allows you to add or remove group-of-ruledefs from the current qos-group-of-ruledefs. This command introduced in support of the Service-Group QOS feature is available in the new ACS QoS-Group-of-Ruledefs Configuration Mode.

ACS QoS-Group-of-Ruledefs Configuration Mode

[ no ] add-group-of-ruledef group_of_ruledef_name

Modified ECS Configuration Commands

This section identifies ECS commands modified in release 14.0.

None for this release.

Deprecated ECS Configuration Commands

This section identifies deprecated ECS commands that are no longer supported in release 14.0.

None for this release.

ECS Performance Management Changes as of July 31, 2012

This section provides information on ECS performance management changes in release 14.0.

None for this release.

ECS Security Management Changes as of July 31, 2012

This section provides information on ECS security management changes in release 14.0.

None for this release.

ECS Feature Changes as of June 29, 2012

This section provides information on ECS feature changes in release 14.0.

IMPORTANT:

For more information regarding features in this section, refer to the ECS Administration Guide for this release.

New ECS Features

This section identifies new ECS features available in release 14.0.

Regular Expression Support for Ruledef Matching

In StarOS 14.0 releases, ECS supports the use of regular expressions in the following string-based rules:

  • http host
  • http uri
  • http url
  • rtsp uri
  • wsp url
  • www url

For more information on regular expression support for ruledef matching, refer to the Enhanced Charging Service Administration Guide, and the ACS Ruledef Configuration Mode Commands chapter in the Command Line Interface Reference.

Service-Group QOS Support

The Service-Group QoS feature enables the ASR chassis to enforce Fair-Usage-Policy (FUP) per subscriber. This enables changing some charging-action parameters and all QoS-group-of-ruledefs parameters over the Gx interface per individual subscriber session.

For more information on regular expression support for ruledef matching, refer to the Enhanced Charging Service Administration Guide.

Modified ECS Features

This section identifies ECS features modified in release 14.0 and contains two types of modifications: enhancements and behavior changes. Feature enhancements are modifications based on customer change requests. Feature behavior changes are modifications based on software error corrections (bug fixes) that result in a change in the behavior of the feature.

Header Enrichment Encryption Licensing – Behavior Change

Previous Behavior: The Header Enrichment and Encryption feature (RSA and RC4MD5) was not protected by the relevant license. It was available via ASR5K-00-CS01HDRE but should have been protected by either ASR5K-00-CS01H-K9 or ASR5K-00-CS01E-K9.

New Behavior: The Header Enrichment and Encryption feature will now be available only with the correct licenses. The xheader-encryption CLI command in the ACS Rulebase Configuration Mode and the encryption rc4md5 CLI command in the ACS Charging Action Configuration Mode are now protected.

Header Insertion Feature Limitations – Behavior Change

In the 14.0 release, the following limitations no longer apply to the Header Insertion feature:

  • Header insertion does not occur for retransmitted packets.
  • Header insertion occurs for both HTTP GET and POST requests. However, for POST requests, the resulting packet size will likely be larger than for GET requests due to the message body contained in the request. If the previous limitation applies, then POST request will suffer a bigger limit due to this.
  • The packet size is assumed to be less than “Internal MED MTU size, the size of header fields inserted”. If the total length of packet exceeds the internal MTU size, header insertion will not occur after the addition of fields.

The following limitation has changed:

  • Header insertion for TCP OOO and IP fragmented packets:
    • TCP OOO Packets: Header insertion will occur on OOO request packets only if in the rulebase the tcp packets-out-of-order transmit after-reordering CLI command is configured, and reordering packet is received before OOO timeout.
    • IP Fragmented Packets: In case of IP fragmented packets, header insertion will occur only when all fragments are received before reassembly timeout.

For more information on X-Header Insertion and Encryption features, collectively known as Header Enrichment, and prevailing limitations refer to the Enhanced Charging Services Administration Guide.

LF as Valid Terminator for HTTP Header Fields – Behavior Change

In accordance with RFC 1945, Hypertext Transfer Protocol — HTTP/1.0, which defines CRLF as the end-of-line marker for all protocol elements except the Entity-Body, the ECS HTTP analyzer supported CRLF as terminator for HTTP header fields. However, the RFC describing “Tolerant Applications” recommends that applications be tolerant of deviations, and treat LF as a valid line terminator. The ECS HTTP analyzer now supports LF also as a valid terminator for HTTP header fields.

Previous Behavior: In earlier releases, the ECS HTTP analyzer supported only CRLF as valid terminator for HTTP header fields.

New Behavior: The ECS HTTP analyzer now supports both CRLF and LF as valid terminators for HTTP header fields.

Session Teardown Packet Rule Matching – Behavior Change

Previous Behavior: In earlier releases, zero-length TCP connection teardown packets were matching with the application-level charging rule.

New Behavior: Zero-length TCP connection teardown packets will not match to “<application> any-match = TRUE” (for example, HTTP application) or control-level charging rules.

Deployments using such application-level rules will observe the new behavior. Session teardown packets will be charged as per the action specified in “<application> any-match = TRUE (for example, http any-match = TRUE) OR “control-level rules” (for example, tcp any-match = TRUE) whichever is present in the configuration.

ECS Configuration Management Changes as of June 29, 2012

This section provides information on ECS configuration command changes in release 14.0.

IMPORTANT:

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Configuration Commands

This section identifies new ECS commands available in release 14.0.

qos-group-of-ruledefs

In support of the Service-Group QOS feature, this command allows you to create/configure/delete a qos-group-of-ruledefs.

ACS Configuration Mode

qos-group-of-ruledefs qos_group_of_ruledefs_name [ -noconfirm ] [ description description ]
no qos-group-of-ruledefs qos_group_of_ruledefs_name

add-ruledef

This command allows you to add or remove ruledefs from a qos-group-of-ruledefs. This command introduced in support of the Service-Group QOS feature is available in the new ACS QoS-Group-of-Ruledefs Configuration Mode.

ACS QoS-Group-of-Ruledefs Configuration Mode

[ no ] add-ruledef ruledef_name

Modified ECS Configuration Commands

This section identifies ECS commands modified in release 14.0.

http host

This command allows you to define rule expressions to match a specified value in the HTTP Host request-header field. In support of the Regular Expression (regex) feature, this command now supports the regex operator.

ACS Ruledef Configuration Mode

[ no ] http
host [ case-sensitive ] { !contains | !ends-with | !starts-with | = | contains | ends-with | regex | starts-with host_name }

http uri

This command allows you to define rule expressions to match HTTP URI. In support of the Regular Expression (regex) feature, this command now supports the regex operator.

ACS Ruledef Configuration Mode

[ no ] http
uri [ case-sensitive ] { != | !contains | !ends-with | !starts-with | = | contains | ends-with | regex | starts-with uri }

http url

This command allows you to define rule expressions to match HTTP URL. In support of the Regular Expression (regex) feature, this command now supports the regex operator.

ACS Ruledef Configuration Mode

[ no ] http
url [ case-sensitive ] { != | !contains | !ends-with | !starts-with | = | contains | ends-with | regex | starts-with url }

rtsp uri

This command allows you to define rule expressions to match URI in RTSP request message. In support of the Regular Expression (regex) feature, this command now supports the regex operator.

ACS Ruledef Configuration Mode

[ no ] rtsp
uri [ case-sensitive ] { != | !contains | !ends-with | !starts-with | = | contains | ends-with | regex | starts-with uri }

wsp url

This command allows you to define rule expressions to match WSP URL. In support of the Regular Expression (regex) feature, this command now supports the regex operator.

ACS Ruledef Configuration Mode

[ no ] wsp
url [ case-sensitive ] { != | !contains | !ends-with | !starts-with | = | contains | ends-with | regex | starts-with url }

www url

This command allows you to define rule expressions to match URL for any Web protocol analyzer—HTTP, WAP1.X, WAP2.0. In support of the Regular Expression (regex) feature, this command now supports the regex operator.

ACS Ruledef Configuration Mode

[ no ] www
url [ case-sensitive ] { != | !contains | !ends-with | !starts-with | = | contains | ends-with | regex | starts-with url }

Deprecated ECS Configuration Commands

This section identifies deprecated ECS commands that are no longer supported in release 14.0.

charging-rule-optimization

Omitted Content: This change occurred in the June 29, 2012 code drop but was omitted from this document until now.

In 14.0 and later releases, this command is deprecated. Rule optimization is now always enabled with the optimization level set to high as the standard behavior.

ACS Rulebase Configuration Mode

charging-rule-optimization { high | low | medium }
default charging-rule-optimization

ECS Performance Management Changes as of June 29, 2012

This section provides information on ECS performance management changes in release 14.0.

IMPORTANT:

For more information regarding bulk statistics in this section, refer to the Statistics and Counters Reference for this release.

For more information regarding commands in this section, refer to the Command Line Interface Reference for this release.

New ECS Bulk Statistics

This section identifies new ECS bulk statistics available in release 14.0.

None for this release.

Modified ECS Bulk Statistics

This section identifies ECS bulk statistics modified in release 14.0.

None for this release.

Deprecated ECS Bulk Statistics

This section identifies deprecated ECS bulk statistics that are no longer supported in release 14.0.

Omitted Content: This change occurred in the June 29, 2012 code drop but was omitted from this document until now.

ECS Schema

IMPORTANT:

P2P-related bulk statistics that were supported in the ECS schema in StarOS 12.3 and earlier releases are now deprecated, and supported by the new P2P schema in StarOS 14.0. Refer to the New ADC Bulk Statistics section for more information.

The following categories of bulk statistics that were supported in 12.3 and earlier releases are now deprecated:

  • p2p-<protocol_name>-voice-duration
  • p2p-<protocol_name>-uplnk-bytes
  • p2p-<protocol_name>-dwlnk-bytes
  • p2p-<protocol_name>-uplnk-pkts
  • p2p-<protocol_name>-dwlnk-pkts
  • p2p-<protocol_name>-audio-uplnk-bytes
  • p2p-<protocol_name>-audio-dwlnk-bytes
  • p2p-<protocol_name>-audio-uplnk-pkts
  • p2p-<protocol_name>-audio-dwlnk-pkts
  • p2p-<protocol_name>-unclassified-uplnk-bytes
  • p2p-<protocol_name>-unclassified-dwlnk-bytes
  • p2p-<protocol_name>-unclassified-uplnk-pkts
  • p2p-<protocol_name>-unclassified-dwlnk-pkts
  • p2p-<protocol_name>-video-uplnk-bytes
  • p2p-<protocol_name>-video-dwlnk-bytes
  • p2p-<protocol_name>-video-uplnk-pkts
  • p2p-<protocol_name>-video-dwlnk-pkts

New ECS Performance Commands

This section identifies new ECS performance commands available in release 14.0.

clear active-charging regex statistics

This command introduced in support of the Regular Expression (regex) feature, allows you to clear regex-related statistics.

Also, see the show active-charging regex section.

Exec Mode

clear active-charging
regex statistics ruledef { all | instance instance_number }

show active-charging qos-group-of-ruledefs

In support of the Service-Group QOS feature, this command allows you to view information for all or a specific ACS QoS-group-of-ruledefs.

Exec Mode

show active-charging
qos-group-of-ruledefs { all | name qos_group_of_ruledefs_name } [ | { grep grep_options | more } ]

For descriptions of the fields contained in the output of this command, refer to the Statistics and Counters Reference for this release

show active-charging regex

This command introduced in support of the Regular Expression (regex) feature, allows you to view regex-related statistics and information.

Also, see the clear active-charging regex statistics section.

Exec Mode

show active-charging
regex { statistics { memory | ruledef } { all | instance instance_number | summary } | status { all | instance instance_number } } [ | { grep grep_options | more } ]

For descriptions of the fields contained in the output of this command, refer to the Statistics and Counters Reference for this release.

show active-charging subscribers

In support of the Service-Group QOS feature, this command allows you to view subscriber statistics and information on dynamic updates to charging parameters per call ID.

Exec Mode

show active-charging
subscribers callid call_id charging-updates [ statistics ] [ charging-action [ name charging_action_name ] | qos-group [ name qos_group_of_ruledefs_name ] | session ] [ | { grep grep_options | more } ]

For descriptions of the fields contained in the output of this command, refer to the Statistics and Counters Reference for this release.

Modified ECS Performance Commands

This section identifies ECS performance commands modified in release 14.0.

show active-charging charging-action statistics name

This command displays information for charging actions configured in the active-charging service.

Exec Mode

The following field has been added to the output of this command:
  • XHeader Information:
    • IP Frags consumed by XHeader: In support of the x-header Insertion feature, this field displays the number of IP fragments consumed by header enrichment.

Deprecated ECS Performance Commands

This section identifies deprecated ECS performance commands that are no longer supported in release 14.0.

None for this release.

ECS Security Management Changes as of June 29, 2012

This section provides information on ECS security management changes in release 14.0.

None for this release.