ADC Changes in Release 14.0

This chapter identifies features and functionality added to, modified for, or deprecated from 14.0 ADC 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 lists 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

ADC Feature Changes as of November 07, 2012

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

IMPORTANT:

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

New ADC Features

This section identifies new ADC features available in release 14.0.

Limitations for ADC Protocols

Limitations for certain protocols that support audio or video sub-classification are added in this release.

If Audio and Video contents are in the same flow (TCP/UDP), video is considered as the predominant component and the flow is marked as “video”. In this scenario, throttling video will block both audio and video. Throttling only audio or video is not possible.

Modified ADC Features

This section identifies ADC features modified in release 14.0. There are two kinds of modified features: enhancements and behavior changes. Enhancements are feature changes based on customer change requests. Behavior changes are feature changes that modify an existing behavior and may result from software error corrections (bug fixes).

None for this release.

ADC Configuration Management Changes as of November 07, 2012

This section provides information on ADC 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 ADC Configuration Commands

This section identifies new ADC commands available in release 14.0.

None for this release.

Modified ADC Configuration Commands

This section identifies ADC commands modified in release 14.0.

None for this release.

Deprecated ADC Configuration Commands

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

None for this release.

ADC Performance Management Changes as of November 07, 2012

This section provides information on ADC 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 ADC Bulk Statistics

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

None for this release.

Modified ADC Bulk Statistics

This section identifies ADC bulk statistics modified in release 14.0.

None for this release.

Deprecated ADC Bulk Statistics

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

None for this release.

New ADC Performance Commands

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

None for this release.

Modified ADC Performance Commands

This section identifies ADC performance commands modified in release 14.0.

None for this release.

Deprecated ADC Performance Commands

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

None for this release.

ADC Security Management Changes as of November 07, 2012

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

None for this release.

ADC Feature Changes as of September 28, 2012

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

IMPORTANT:

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

New ADC Features

This section identifies new ADC features available in release 14.0.

P2P Protocols Detection Support

This release now supports the detection of the following P2P protocols:

  • Call of Duty
  • BBC iPlayer
  • Flash
  • Goober
  • Kakao Talk
  • Mojo
  • MSRP
  • NateOn Talk
  • Naverline
  • PCAnywhere
  • Webex

For more information, refer to the Application Detection and Control Administration Guide.

Modified ADC Features

This section identifies ADC features modified in release 14.0. There are two kinds of modified features: enhancements and behavior changes. Enhancements are feature changes based on customer change requests. Behavior changes are feature changes that modify an existing behavior and may result from software error corrections (bug fixes).

None for this release.

ADC Configuration Management Changes as of September 28, 2012

This section provides information on ADC 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 ADC Configuration Commands

This section identifies new ADC commands available in release 14.0.

None for this release.

Modified ADC Configuration Commands

This section identifies ADC commands modified in release 14.0.

p2p-detection protocol

This command enables detection of peer-to-peer (P2P) protocols.

The following keywords are added to this command:

  • callofduty
  • flash
  • goober
  • iplayer
  • kakaotalk
  • mojo
  • msrp
  • nateontalk
  • naverline
  • pcanywhere
  • webex

ACS Configuration Mode 

[ no ] p2p-detection
protocol [ callofduty | iplayer | flash | goober | kakaotalk | mojo | msrp | nateontalk | naverline | pcanywhere | webex + ]

p2p protocol

This command enables detection of specific P2P protocols for charging purposes.

The following protocols are supported:

  • Call of Duty
  • BBC iPlayer
  • Flash
  • Goober
  • Kakao Talk
  • Mojo
  • MSRP
  • NateOn Talk
  • Naverline
  • PCAnywhere
  • Webex

ACS Ruledef Configuration Mode 

[ no ] p2p
protocol operator protocol

Deprecated ADC Configuration Commands

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

None for this release.

ADC Performance Management Changes as of September 28, 2012

This section provides information on ADC 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 ADC Bulk Statistics

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

The following bulk statistics are new in this release:

P2P Schema

  • p2p-protocol

Modified ADC Bulk Statistics

This section identifies ADC bulk statistics modified in release 14.0.

None for this release.

Deprecated ADC Bulk Statistics

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

None for this release.

New ADC Performance Commands

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

None for this release.

Modified ADC Performance Commands

This section identifies ADC performance commands modified in release 14.0.

clear active-charging analyzer statistics

This command supports the clearing of protocol analyzer statistics.

Exec Mode

The following applications are supported:

  • callofduty
  • flash
  • goober
  • iplayer
  • kakaotalk
  • mojo
  • msrp
  • nateontalk
  • naverline
  • pcanywhere
  • webex
clear active-charging
analyzer statistics [ name protocol_name [ | { grep grep_options  | more } ]

show active-charging analyzer statistics name p2p verbose

This command displays Active Charging protocol analyzer statistics for the P2P protocol analyzer.

Exec Mode

The following fields have been added to the output of this command to display the uplink/downlink bytes and uplink/downlink packets for the following protocols:

  • Callofduty
  • Flash
  • Goober
  • Iplayer
  • Kakaotalk
  • Kakaotalk audio
  • Kakaotalk unclassified
  • Mojo
  • Msrp
  • Nateontalk
  • Naverline
  • Pcanywhere
  • Tango audio
  • Tango video
  • Tango unclassified
  • Webex

show active-charging flows

This command displays the information for the active charging flows.

Exec Mode

The following applications support the P2P protocol type flows:

  • callofduty
  • flash
  • goober
  • iplayer
  • kakaotalk
  • mojo
  • msrp
  • nateontalk
  • naverline
  • pcanywhere
  • webex
show active-charging
flows { type flow_type } [ | { grep grep_options | more } ]

show active-charging sessions

This command displays statistics for ACS sessions.

Exec Mode

The P2P protocol type flows now support the following applications:

  • callofduty
  • flash
  • goober
  • iplayer
  • kakaotalk
  • mojo
  • msrp
  • nateontalk
  • naverline
  • pcanywhere
  • webex
show active-charging
sessions [ full [ wide ] | summary ] [ filter_keyword + ] + [ all ] [ | { grep grep_options | more } ]

show active-charging sessions summary

This command displays statistics for P2P active charging service sessions.

Exec Mode

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

  • Current CALLOFDUTY Sessions
  • Current FLASH Sessions
  • Current GOOBER Sessions
  • Current IPLAYER Sessions
  • Current KAKAOTALK Sessions
  • Current KAKAOTALK Unclassified Sessions
  • Current KAKAOTALK Audio Sessions
  • Current MOJO Sessions
  • Current NATEONTALK Sessions
  • Current NAVERLINE Sessions
  • Current PCANYWHERE Sessions
  • Current TANGO Audio Sessions
  • Current TANGO Video Sessions
  • Current TANGO Unclassified Sessions
  • Current WEBEX Sessions

show active-charging sessions summary type p2p

This command displays summary information for P2P active charging service sessions.

Exec Mode

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

  • Current CALLOFDUTY Sessions
  • Current FLASH Sessions
  • Current GOOBER Sessions
  • Current IPLAYER Sessions
  • Current KAKAOTALK Sessions
  • Current KAKAOTALK Unclassified Sessions
  • Current KAKAOTALK Audio Sessions
  • Current MOJO Sessions
  • Current NATEONTALK Sessions
  • Current NAVERLINE Sessions
  • Current PCANYWHERE Sessions
  • Current TANGO Audio Sessions
  • Current TANGO Video Sessions
  • Current TANGO Unclassified Sessions
  • Current WEBEX Sessions

Deprecated ADC Performance Commands

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

None for this release.

ADC Security Management Changes as of September 28, 2012

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

None for this release.

ADC Feature Changes as of June 29, 2012

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

IMPORTANT:

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

New ADC Features

This section identifies new ADC features available in release 14.0.

Dynamic Software Upgrade

Dynamic Software Upgrade is the new approach to upgrade the ADC library version that will enable operators to upgrade their detection capabilities with no downtime. This is done by providing updates in the form of software patches, which the operator can apply in a live setup with minimal interference.

In this approach, ADC is now delivered as a plugin within the StarOS binary. The plugin is loaded into the system at run time. Whenever there is a change in the detection logic of an existing application or a new ADC protocol/application needs to be added, a new version of the plugin is provided as a plugin module. The new plugin is loaded onto the system dynamically without disrupting other services. After the plugin has been installed and configured, the new rules will come into effect for detection.

IMPORTANT:

Dynamically loaded plugins are not incremental. A plugin includes protocol detection logic for all the protocols/applications. You can update to a higher priority plugin or rollback to a lower priority plugin.

The basic sequence for the dynamic software upgrade process is as follows:
  • Downloading the Patch kit
  • Unpacking the Patch kit
  • Configuring the Plugin
  • Updating the Plugin
  • Rolling Back to a Previous Plugin Version

For the new CLI and show commands supported for DSU, refer to the New ADC Configuration Commands and New ADC Performance Commands sections in this reference. For additional information, refer to the Application Detection and Control Administration Guide.

P2P Protocols Detection Support

This release now supports the detection of the following P2P protocols:
  • Comodounite
  • eBuddy
  • Ficall
  • Gotomeeting
  • Implus
  • Mig33
  • Netflix
  • Operamini
  • QQ Audio/Video

For more information, refer to the Application Detection and Control Administration Guide.

Modified ADC Features

This section identifies ADC features modified in release 14.0. There are two kinds of modified features: enhancements and behavior changes. Enhancements are feature changes based on customer change requests. Behavior changes are feature changes that modify an existing behavior and may result from software error corrections (bug fixes).

None for this release.

ADC Configuration Management Changes as of June 29, 2012

This section provides information on ADC 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 ADC Configuration Commands

This section identifies new ADC commands available in release 14.0.

edr-ipproto-port-map

This command enables IP protocol and server port mapping for Event Data Records (EDR).

ACS Configuration Mode 

[ default | no ] edr-ipproto-port-map

edr p2p

Corrected Content: This section includes corrections to previously published content. The description of this new command in the previously published content was insufficient.

This command configures the generation of Event Data Records (EDR) for P2P events. The Dynamic Software Upgrade plugin supports the audio-end and video-end events.

ACS Rulebase Configuration Mode 

edr p2p p2p_event_list [ charging-edr charging_edr_format_name | edr-format edr_format_name | reporting-edr reporting_edr_format_name ] +

{ default | no } edr
p2p p2p_event_list

install plugin

Unpacks the contents of a patch kit intended for a specific plugin module. This command is associated with the Dynamic Software Upgrade process.

Exec Mode 

install plugin plugin_name patch_file_name

module priority

Configures the priority in the Version Priority List (VPL) for a specified version of a plugin module. This command is associated with the Dynamic Software Upgrade process.

Plugin Configuration Mode 

module priority number version plugin_version attribute attribute_name attribute_value

no module priority number

p2p schema

This command creates and configures P2P (Peer-to-Peer) statistics schema.

Bulk Statistics Rulebase Configuration Mode 

p2p schema schema_name format format_string

no p2p schema schema_name

plugin

Sets the mode to the specified Plugin Configuration mode. In this mode, you can configure attributes and the priority level of the plugin. This command is associated with the Dynamic Software Upgrade process.

Global Configuration Mode 

plugin plugin_name

rollback module

Loads a specified plugin module from the Version Priority List (VPL) with the next highest priority number. This command is associated with the Dynamic Software Upgrade process.

Exec Mode 

rollback module plugin_name

update module

Loads a specified plugin module from the Module Priority list with the lowest priority number. This command is associated with the Dynamic Software Upgrade process.

Exec Mode 

update module plugin_name

Modified ADC Configuration Commands

This section identifies ADC commands modified in release 14.0.

attribute

This command specifies the order of fields in EDRs. The following new attributes are added to this command.

  • sn-ip-protocol-name: This attribute generates the IP protocol name for the flow.
  • sn-port-service-name: This attribute generates the registered name of the server port.

The following attribute is modified in this command.

  • sn-closure-reason: The Closure Reason ID for VoIP end call event changed from “13” to “14” in this release.

EDR Format Configuration Mode 

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 }no attribute attribute [ { ip | tcp } { bytes | pkts } { downlink | uplink } ] [ priority priority ]

p2p-detection protocol

This command enables detection of peer-to-peer (P2P) protocols.

The following keywords are added to this command:

  • comodounite
  • ebuddy
  • ficall
  • gotomeeting
  • implus
  • mig33
  • netflix
  • operamini

ACS Configuration Mode 

[ no ] p2p-detection
protocol [ comodounite | ebuddy | ficall | gotomeeting | implus | mig33 | netflix | operamini + ]

p2p protocol

This command enables detection of specific P2P protocols for charging purposes.

The following protocols are supported:

  • Comodounite
  • eBuddy
  • Ficall
  • Gotomeeting
  • Implus
  • Mig33
  • Netflix
  • Operamini
  • QQ Audio/Video

ACS Ruledef Configuration Mode 

[ no ] p2p
protocol operator protocol

rule-variable

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

The following new rule-variable option is added to this command.

  • p2p duration: Peer-to-peer protocol duration.

ADC now does not support the following rule-variable option.

  • voip-duration: Duration of voice call, in seconds. For a flow in which voice call end is detected, output will be a non-zero value. For other flows it will be zero.

EDR Format Configuration Mode 

rule-variable rule_variable priority priority [ in-quotes ]

no rule-variable rule_variable [ priority priority ]

Deprecated ADC Configuration Commands

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

edr voip-call-end

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

This command enables/disables generation of EDRs on the completion of Voice over IP (VoIP) calls. This command is no longer supported for ADC, and is replaced by edr p2p command. Refer to the New ADC Configuration Commands section.

ACS Rulebase Configuration Mode 

edr voip-call-end { charging-edr charging_edr_format_name | edr-format edr_format_name | reporting-edr reporting_edr_format_name } +

{ default | no } edr
voip-call-end

ADC Performance Management Changes as of June 29, 2012

This section provides information on ADC 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 ADC Bulk Statistics

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

IMPORTANT:

In StarOS 14.0, the P2P Schema is new. If detection of a specific P2P protocol is enabled, bulk statistics for that protocol will be automatically generated using the Dynamic Software Upgrade plugin installed on the chassis. In the case of protocols that support sub-classification (audio/video/unclassified), the bulk statistics will be generated for each of the supported sub-classifications per protocol and also the corresponding cumulative count.

The following bulk statistics are new in this release:

P2P Schema

  • p2p-duration-name
  • p2p-duration-value
  • p2p-uplnk-bytes-name
  • p2p-uplnk-bytes-value
  • p2p-dwlnk-bytes-name
  • p2p-dwlnk-bytes-value
  • p2p-uplnk-pkts-name
  • p2p-uplnk-pkts-value
  • p2p-dwlnk-pkts-name
  • p2p-dwlnk-pkts-value

Modified ADC Bulk Statistics

This section identifies ADC bulk statistics modified in release 14.0.

None for this release.

Deprecated ADC Bulk Statistics

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

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:

ECS Schema

  • 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 ADC Performance Commands

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

show module

Displays the current status of the Version Priority List (VPL) for one or all plugin modules installed on the system. This command is associated with the dynamic software upgrade process.

Exec Mode 

show module [ plugin_name ]

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

show plugin

Displays the current configuration of one or all plugin modules installed on the system. This command is associated with the dynamic software update process.

Exec Mode 

show plugin [ plugin_name ]

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

Modified ADC Performance Commands

This section identifies ADC performance commands modified in release 14.0.

clear active-charging analyzer statistics

This command supports the clearing of protocol analyzer statistics.

Exec Mode

The following applications are supported:
  • comodounite
  • ebuddy
  • ficall
  • gotomeeting
  • implus
  • mig33
  • netflix
  • operamini
clear active-charging
analyzer statistics [ name protocol_name [ | { grep grep_options  | more } ]

show active-charging analyzer statistics name p2p verbose

This command displays Active Charging protocol analyzer statistics for the P2P protocol analyzer.

Exec Mode

The following fields have been added to the output of this command to display the uplink/downlink bytes and uplink/downlink packets for the following protocols:
  • Comodounite
  • eBuddy
  • Ficall
  • Gotomeeting
  • Implus
  • Mig33
  • Netflix
  • Operamini
  • QQ Audio
  • QQ Video

show active-charging flows

This command displays the information for the active charging flows.

Exec Mode

The following applications support the P2P protocol type flows:
  • comodounite
  • ebuddy
  • ficall
  • gotomeeting
  • implus
  • mig33
  • netflix
  • operamini
show active-charging
flows { type flow_type } [ | { grep grep_options | more } ]

show active-charging rulebase statistics

This command displays statistics for ACS rulebases.

Exec Mode

The following fields have been added to the output of this command:
  • EDRs generated for audio-end Sessions
  • EDRs generated for video-end Sessions

show active-charging rulebase statistics name

This command displays statistics for ACS rulebases.

Exec Mode

The following fields have been added to the output of this command:
  • EDRs generated for audio-end Sessions
  • EDRs generated for video-end Sessions

show active-charging sessions

This command displays statistics for ACS sessions.

Exec Mode

The P2P protocol type flows now support the following applications:
  • comodounite
  • ebuddy
  • ficall
  • gotomeeting
  • implus
  • mig33
  • netflix
  • operamini
show active-charging
sessions [ full [ wide ] | summary ] [ filter_keyword + ] + [ all ] [ | { grep grep_options | more } ]

show active-charging sessions summary

This command displays statistics for P2P active charging service sessions.

Exec Mode

The following fields have been added to the output of this command:
  • Current COMODOUNITE Sessions
  • Current EBUDDY Sessions
  • Current FICALL Sessions
  • Current GOTOMEETING Sessions
  • Current IMPLUS Sessions
  • Current MIG33 Sessions
  • Current NETFLIX Sessions
  • Current OPERAMINI Sessions
  • Current QQ Audio Sessions
  • Current QQ Video Sessions

show active-charging sessions summary type p2p

This command displays summary information for P2P active charging service sessions.

Exec Mode

The following fields have been added to the output of this command:
  • Current COMODOUNITE Sessions
  • Current EBUDDY Sessions
  • Current FICALL Sessions
  • Current GOTOMEETING Sessions
  • Current IMPLUS Sessions
  • Current MIG33 Sessions
  • Current NETFLIX Sessions
  • Current OPERAMINI Sessions
  • Current QQ Audio Sessions
  • Current QQ Video Sessions

show active-charging subsystem all

This command displays active statistics for ACS sessions.

Exec Mode

The following fields have been added to the output of this command:
  • Total P2P unclassified flows
  • Current P2P unclassified flows
  • Total P2P audio flows
  • Current P2P audio flows
  • Total P2P video flows
  • Current P2P video flows

show variables

Displays the bulk statistics variable information based on schema names. A new keyword has been added to display the variables in the new P2P schema.

Bulk Statistics Configuration Mode 

show variables p2p

Deprecated ADC Performance Commands

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

None for this release.

ADC Security Management Changes as of June 29, 2012

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

None for this release.