The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
First Published: April 10, 2015
The Cisco cBR Series Converged Broadband Router supports the Internet Protocol Detail Record (IPDR) streaming protocol feature that provides high volume data exported from the network equipment to mediation systems such as the Operations Support Systems (OSS) or Business Support Systems (BSS). IPDR provides information about IP-based service usage and other activities that are used by OSS and BSS. This protocol provides a mechanism to collect data from various network elements or equipment using a push model as opposed to the conventional Simple Network Management Protocol (SNMP) polling mechanism.
Based on the DOCSIS 3.0 specifications, the IPDR feature optimizes time and resource efficiency in the transfer of large amounts of performance metrics to the management systems. DOCSIS 3.0 introduces five management features or the FCAPS model. FCAPS represents Fault, Configuration, Accounting, Performance and Security.
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://tools.cisco.com/ITDIT/CFN/. An account on http://www.cisco.com/ is not required.
IPDR Streaming Protocol is designed to address the need for a reliable, fast, efficient, and flexible export process of high volume data records such as billing, performance and diagnostic data.
The IPDR/SP process communicates with IPDR collectors. The IPDR streaming protocol supports multiple IPDR sessions. The architecture supports primary and secondary collectors for failover purposes. At any time, data is sent to only one collector. If the exporter to primary collector connection fails due to any reason, the data is sent to the secondary collector. Depending on the network configuration, you can have only one primary collector for each session, while for different sessions, you can have different primary collectors. For example, there may be a billing collector, a diagnostic collector, and so on.
 Note |
IPDR exporter refers to the Cable Modem Termination System (CMTS) and the IPDR collector refers to the network equipment. |
IPDR is the data generated or collected for various performance related metrics such as billing information, diagnostics, network topology, signal quality monitoring, and other management data. These data are based on the FCAPS model (Fault, Configuration, Accounting, Performance and Security.)
The IPDR client application communicates with the IPDR exporter using the IPDR_GET_SESSIONS message to identify the streams provided by the exporter, and the exporter sends responses to the client using the IPDR_GET_SESSIONS_RESPONSE message. This data collection method is based on the Operations Support System Interface Specification (CM-SP-OSSIv3.0-I13-101008).
The IPDR_GET_SESSIONS_RESPONSE message includes the SessionBlock.reserved attribute to identify the IPDR session ID. This attribute helps the Cisco CMTS router define an IPDR session ID for each data collection mechanism supported for each IPDR service definition. This attribute was not used in Cisco IOS Releases earlier to Cisco IOS Release 12.2(33)SCE.
The IPDR feature defines methods for the collectors or network elements to collect data from the CMTS. Below is the list of collection methodologies:
Time Interval Session: In this method, the CMTS follows a schedule-based session to stream data at a periodic time interval. A time interval is the time gap between two adjacent sessions’ start messages. This method is managed by the CMTS in controlling the start and stop operation of a session. The time interval session terminates after the CMTS exports the records.
Note |
During the course of a one-time interval when the CMTS is streaming records, if another time interval is expected, the CMTS will ignore the new time interval and continue exporting the data until the previous time interval ends. |
Event-based Session: In this method, the CMTS can export records at any time, when the session is open. In other words, this method works on an open-ended session.
Ad-hoc Session: In this method, the CMTS creates a session, allows data streaming, and closes the session when the data export is complete or when a closing command is generated.
A new session is created by issuing the ipdr session command. After, the CMTS receives the FLOW_START message from the collector, the CMTS exporter sends a SESSION_START message to start exporting the IPDR data from the collector. After all data is transported, the exporter receives a ACK message from the collector, and then sends a SESSION_STOP message to the collector. This method is known as the Ad-hoc session.
This section describes the configuration tasks that are performed when using the IPDR streaming protocol feature on the Cisco CMTS platforms.
Note |
Use no ipdr command to remove the IPDR configuration. |
To enable the CMTS application to add a session to the IPDR exporter, use the ipdr session command in global configuration mode.
Use the no form of the command to remove the IPDR session.
Note |
|
| Command or Action | Purpose | |
|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode.
|
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
| Step 3 |
ipdr session session_id session_name session_descr Example: |
Enables the CMTS application to add a session to the IPDR exporter. |
To configure the IPDR session type, use the ipdr type command in global configuration mode. The IPDR session types that can be defined using this command are event type, time-interval type, and the ad hoc type.
Use the no form of the command to reset the session type to the default "event" type.
| Command or Action | Purpose | |
|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode.
|
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
| Step 3 |
ipdr type session_id [ad-hoc | event | time-interval value] Example: |
Enables the CMTS application to configure an IPDR session type. |
Note |
Once the IPDR session type is configured, only the templates supported by this IPDR type are allowed be associated with it. Also, the console provides information about those templates that are not supported by this IPDR session type when the type is changed. |
To configure the IPDR collector details, use the ipdr collector command in global configuration mode. The port number is used when an exporter creates an active connection.
| Command or Action | Purpose | |||
|---|---|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode.
|
||
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
||
| Step 3 |
ipdr collector Example: |
Enables the CMTS application to configure an IPDR collector and authenticate the IPDR protocol.
|
To associate the collector with a session, use the ipdr associate command in global configuration mode.
| Command or Action | Purpose | |
|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode. Enter your password if prompted. |
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
| Step 3 |
ipdr associate session_id collector_name priority Example: |
Associates the collector with a session. |
To add an IPDR template to the IPDR session, use the ipdr template command in global configuration mode. The template list can be viewed by entering a “?” at the command prompt.
Note |
|
| Command or Action | Purpose | |
|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode.
|
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
| Step 3 |
ipdr template session_id template_name Example: |
Adds an IPDR template to the IPDR session. |
IPDR exporter parameters such as keepalive timer count, the maximum number of unacknowledged records, and unacknowledged timeout interval value can be configured using the following commands.
Note |
The default value for DataAckTimeInterval is 60 seconds and the default value for DataAckSequenceInterval is 200 seconds. |
You can set the values for the IPDR parameters to customize exporter for the collectors used in the facility. However, these commands are optional, so if not configured, the default values of the commands are used when ipdr exporter start command is executed.
| Command or Action | Purpose | |
|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode. Enter your password if prompted. |
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
| Step 3 |
ipdr exporter keepalive time_interval Example: |
(Optional) Sets the keepalive timer count for the IPDR Exporter. The valid range is from 5 to 300 seconds. The default value is 300. |
| Step 4 |
ipdr exporter max-unacked records Example: |
(Optional) Sets the number of maximum unacknowledged records on the IPDR Exporter. The valid range is from 5 to 200 records. The default value is 200. |
| Step 5 |
ipdr exporter ack-timeout time_interval Example: |
(Optional) Sets the acknowledged records timeout interval on the IPDR Exporter. The valid range is from 5 to 60 seconds. The default value is 60. |
| Step 6 |
ipdr exporter start Example: |
Enables the CMTS application to start the IPDR exporter process to connect the exporter and the collector. |
The following example shows how to configure the IPDR session.
Router> enable
Router# configure terminal
Router(config)# ipdr session 1 test no_descrThe following example shows how to configure the IPDR “time-interval” session type for a time interval of 15 minutes.
Router> enable
Router# configure terminal
Router(config)# ipdr type 1 time-interval 15
The following example shows how to configure the IPDR collector.
Router> enable
Router# configure terminal
Router(config)# ipdr collector federal 209.165.200.225This example shows the nat-address keyword used to configure the NAT address for an IPDR collector:
Router(config)#ipdr collector federal 192.0.2.225 nat-address 192.0.2.51 The following example shows how to associate the collector with a session.
Router> enable
Router# configure terminal
Router(config)# ipdr associate 1 federal 1The following example shows how to add an IPDR template to the IPDR session.
Router> enable
Router# configure terminal
Router(config)# ipdr template 1 SAMIS-TYPE1The following example shows how to configure the IPDR exporter process to connect the exporter and the collector.
Router> enable
Router# configure terminal
Router(config)# ipdr exporter keepalive 300
Router(config)# ipdr exporter max-unacked 200
Router(config)# ipdr exporter ack_timeout 60
Router(config)# ipdr exporter start
This section describes the commands used for verification of the IPDR streaming protocol feature on the Cisco CMTS platforms.
The show ipdr collector command displays the collector information, message statistics, and event for all the sessions that are associated with the collector.
The following example shows the sample output for the show ipdr collector command.
Router# show ipdr collector federal
Collector Name: federal, IP: 192.0.2.0, Port: 0
2001-07-05T19:28:22 Collector in session 1 Statistics:
Transmitted 12658 Acknowledged 12658 Enqueued 12658 Lost 0
Last Event: Event Id 1 IPDR_EVENT_SERVER_CONNECTED - INCOMING
Router(config)#
The show ipdr exporter command displays information about the IPDR Exporter state as listed below.
The following example shows the sample output for the show ipdr exporter command:
Router# show ipdr exporter
IPDR exporter is started.
Current parameters:
KeepAliveInterval :300
AckTimeInterval :60
AckSequenceInterval :200
Router#
The show ipdr session command displays the session details such as the session ID, description, and the session state for all sessions as well as for a specific session.
The following example shows the sample output for the all keyword for the show ipdr session command.
Router# show ipdr session all
Session ID: 1, Name: utilsta, Descr: test, Started: False
The following example shows the sample output for the session_id keyword for the show ipdr session command.
Router# show ipdr session 1
Session ID: 1, Name: utilsta, Descr: test, Started: False
2001-07-05T19:36:28 Statistics:
Transmitted 0 Acknowledged 0 Enqueued 0 Lost 0
queuedOutstanding 0 queuedUnacknowledged 0
1 Collectors in the session:
Name: federal, IPAddr: 192.0.2.0, Port: 0, Priority: 1
The show ipdr session collector command displays the details of a collector that is associated with a specific session. Because there can be multiple collectors associated to a session, this command is used to show a specific session-collector pair.
The following example shows the sample output for the show ipdr session collector command.
Router# show ipdr session 1 collector federal
Session ID: 1, Name: utilsta, Descr: test, Started: False
Collecotr Name: federal, IP: 192.0.2.0, Port: 0
2001-07-05T19:38:02 Collector in session 1 Statistics:
Transmitted 0 Acknowledged 0 Enqueued 0 Lost 0
Last Event: Event Id 0 WRONG_EVENT_ID
The show ipdr session template command displays the list of all active templates supported by a specific session.
The following example shows the sample output for the show ipdr session template command.
Router# show ipdr session 1 template
Template ID: 2, Name: http://www.cablelabs.com/namespaces/DOCSIS/3.0/xsd/ipdr/DOCSIS-CMTS-CMSERVICE-FLOW-TYPE, Type: DOCSIS-Type, KeyNumber: 22
Session 1 has totally 1 templates.
| Description | Link |
|---|---|
|
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies. To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds. Access to most tools on the Cisco Support website requires a Cisco.com user ID and password. |
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://tools.cisco.com/ITDIT/CFN/. An account on http://www.cisco.com/ is not required.
Note |
The below table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature. |
|
Feature Name |
Releases |
Feature Information |
|---|---|---|
|
IPDR Streaming Protocol |
Cisco IOS-XE 3.15.0S |
This feature was introduced on the Cisco cBR Series Converged Broadband Router . |
Feedback