Cisco IOS CMTS Cable Software Configuration Guide, Release 12.2SC
IPDR Streaming Protocol on the Cisco CMTS Routers
Download this chapter
IPDR Streaming Protocol on the Cisco CMTS Routers IPDR Streaming Protocol on the Cisco CMTS Routers
Download the complete book
Cisco IOS CMTS Software Configuration Guide, Release 12.2SC Full-Book PDFCisco IOS CMTS Software Configuration Guide, Release 12.2SC Full-Book PDF (PDF - 17 MB)
give_us_feedback

Table Of Contents

IPDR Streaming Protocol on the Cisco CMTS Routers

Finding Feature Information

Contents

Prerequisites for Configuring IPDR Streaming Protocol

Restrictions for Configuring IPDR Streaming Protocol

Information About PDR Streaming Protocol

How to Configure IPDR Streaming Protocol

Configuring the IPDR Session

Restrictions

Configuring the IPDR Collector

Configuring the IPDR Associate

Prerequisites

Configuring the IPDR Template

Restrictions

Configuring the IPDR Exporter

Configuration Examples for IPDR Streaming Protocol

Configuring the IPDR Session: Example

Configuring the IPDR Collector: Example

Configuring the IPDR Associate: Example

Configuring the IPDR Template: Example

Configuring the IPDR Exporter: Example

Verifying IPDR Streaming Protocol

Verifying the IPDR Collector

Verifying IPDR exporter

Verifying IPDR session

Verifying IPDR Session Collector

Verifying IPDR Session Template

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

Feature Information for IPDR Streaming Protocol


IPDR Streaming Protocol on the Cisco CMTS Routers

First Published: December 17, 2008
Last Updated: August 28, 2009

The Cisco universal broadband router supports the Internet Protocol Detail Record (IPDR) streaming protocol feature that enables efficient and reliable delivery of high volume data records from the service elements to any systems, such as mediation systems and BSS/OSS.

Finding Feature Information

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.

Use Cisco Feature Navigator to find information about platform support and Cisco IOS, Catalyst OS, and Cisco IOS XE software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Contents

•Prerequisites for Configuring IPDR Streaming Protocol

•Restrictions for Configuring IPDR Streaming Protocol

•Information About PDR Streaming Protocol

•How to Configure IPDR Streaming Protocol

•Configuration Examples for IPDR Streaming Protocol

•Verifying IPDR Streaming Protocol

•Additional References

•Command Reference

•Feature Information for IPDR Streaming Protocol

Prerequisites for Configuring IPDR Streaming Protocol

Table 1 shows the hardware compatibility prerequisites for the IPDR streaming protocol.

Table 1 Cable Hardware Compatibility Matrix for the IPDR Streaming Protocol

CMTS Platform
Processor Engine
Cable Interface Line Cards

Cisco uBR10012 Universal Broadband Router

Cisco IOS Release 12.2(33)SCB

•PRE2

•PRE4

Cisco uBR10-MC5X20S/U/H

Cisco uBR7225VXR Universal Broadband Router

Cisco IOS Release 12.2(33)SCB

•NPE-G1

•NPE-G2

•Cisco uBR-E-28U

•Cisco uBR-E-16U

•Cisco uBR-MC28U/X

•Cisco uBR-MC16U/X

Cisco uBR7246VXR Universal Broadband Routers

Cisco IOS Release 12.2(33)SCB

•NPE-G1

•NPE-G2

•Cisco uBR-MC28U/X

•Cisco uBR-MC16U/X


The software prerequisite for the IPDR streaming protocol is:

•IPSec protocol is used for security purposes.

Restrictions for Configuring IPDR Streaming Protocol

•An IPDR exporter can be connected to up to two collectors, but it will only send data to the highest priority operating collector at any given time.

•Each IPDR session can be associated to one active collector only.

Information About PDR Streaming Protocol

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 the IPDR collectors. 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 multiple primary collectors designed for different types of data. For example, there may be a billing collector, a diagnostic collector, and so on.

Note IPDR streaming protocol supports multiple IPDR sessions.

How to Configure IPDR Streaming Protocol

This section describes the configuration tasks that are performed when using the IPDR streaming protocol feature on the Cisco CMTS platforms.

•Configuring the IPDR Session

•Configuring the IPDR Collector

•Configuring the IPDR Associate

•Configuring the IPDR Template

•Configuring the IPDR Exporter

Note Use no ipdr command to remove the IPDR configuration.

Configuring the IPDR Session

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.

Restrictions

•The session ID must be unique.

SUMMARY STEPS

1. enable

2. configure terminal

3. ipdr session session_id session_name session_descr

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ipdr session session_id session_name session_descr

Example:

Router(config)# ipdr session 1 samis_sxn test

Enables the CMTS application to add a session to the IPDR exporter.

•session_id—The unique IPDR session ID.

•session_name—The session name. The name should not contain blank spaces.

•session_descr—The description of the session.

Configuring the IPDR Collector

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.

SUMMARY STEPS

1. enable

2. configure terminal

3. ipdr collector collector_name ip_addr [port]

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ipdr collector collector_name ip_addr [port]

Example:

Router(config)# ipdr collector federal 192.0.2.0


Enables the CMTS application to configure an IPDR collector and authenticate the IPDR protocol.

•collector_name—The collector name. The name should not contain blank spaces.

•ip_addr—The collector IP address.

•port—(Optional) The collector port value. The default port number will be considered if the value is not entered.

Configuring the IPDR Associate

To associate the collector with a session, use the ipdr associate command in global configuration mode.

Prerequisites

•You must deactivate the session before configuring the associate.

SUMMARY STEPS

1. enable

2. configure terminal

3. ipdr associate session_id collector_name priority

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ipdr associate session_id collector_name priority

Example:

Router(config)# ipdr associate 1 federal 1


Associates the collector with a session.

•session_id—The unique IPDR session ID.

•collector_name—The collector name. The name should not contain blank spaces.

•priority—The priority value between the session and the collector. The value range is 1 to 10. A value of 1 indicates the highest priority.

Configuring the IPDR Template

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.

Restrictions

•You can add only the system-supported templates.

SUMMARY STEPS

1. enable

2. configure terminal

3. ipdr template session_id template_name

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ipdr template session_id template_name

Example:

Router(config)# ipdr template 1 SAMIS

Adds an IPDR template to the IPDR session.

•session_id—The unique IPDR session ID.

•template_name—The template name.

Configuring the IPDR Exporter

To enable the CMTS application to start the IPDR exporter process to connect the exporter and the collector, use the ipdr exporter start command in global configuration mode.

Use the no form of the command to stop the exporter process.

SUMMARY STEPS

1. enable

2. configure terminal

3. ipdr exporter start

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ipdr exporter start

Example:

Router(config)# ipdr exporter start

Enables the CMTS application to start the IPDR exporter process to connect the exporter and the collector. This command also enables the current sessions to run in the "True" state.

Configuration Examples for IPDR Streaming Protocol

This section describes a sample configuration example for configuring IPDR Streaming Protocol.

•Configuring the IPDR Session: Example

•Configuring the IPDR Collector: Example

•Configuring the IPDR Associate: Example

•Configuring the IPDR Template: Example

•Configuring the IPDR Exporter: Example

Configuring the IPDR Session: Example

The following example shows how to configure the IPDR session. 

Router> enable

Router# configure terminal

Router(config)# ipdr session  1 test no_descr

Configuring the IPDR Collector: Example

The following example shows how to configure the IPDR collector. 

Router> enable

Router# configure terminal

Router(config)# ipdr collector federal 192.0.2.0

Configuring the IPDR Associate: Example

The following example shows how to associate the collector with a session. 

Router> enable

Router# configure terminal

Router(config)# ipdr associate 1 federal 1

Configuring the IPDR Template: Example

The following example shows how to add an IPDR template to the IPDR session. 

Router> enable

Router# configure terminal

Router(config)# ipdr template 1 SAMIS

Configuring the IPDR Exporter: Example

The 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 start

Verifying IPDR Streaming Protocol

This section describes the commands used for verification of the IPDR streaming protocol feature on the Cisco CMTS platforms.

•Verifying the IPDR Collector

•Verifying IPDR exporter

•Verifying IPDR session

•Verifying IPDR Session Collector

•Verifying IPDR Session Template

Verifying the IPDR Collector

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)#

Verifying IPDR exporter

The show ipdr exporter command displays information about the IPDR Exporter state. The information displayed indicates the Exporter states that are listed below.

•started

•not started

•not initialized

The following example shows the sample output for the show ipdr exporter command: 

Router#show ipdr exporter 

IPDR exporter is started.

Verifying IPDR session

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 option 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 option 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

Verifying IPDR Session Collector

The show ipdr session collector command displays the details of a collector that is associated with a specific session. Since 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

Verifying IPDR Session Template

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: , Type: DOCSIS-Type, KeyNumber: 22

Session 1 has totally 1 templates.

Additional References

The following sections provide references related to configuring the IPDR streaming protocol feature.

Related Documents

Related Topic
Document Title

CMTS Command Reference

Cisco IOS CMTS Cable Command Reference

http://www.cisco.com/en/US/docs/ios/cable/command/reference/cbl_book.html

Cisco uBR10012 Universal Broadband Router Documentation

Cisco uBR10012 Universal Broadband Router Hardware Installation Guide

http://www.cisco.com/en/US/docs/cable/cmts/ubr10012/installation/guide/hig.html

Cisco uBR10012 Universal Broadband Router Software Configuration Guide http://www.cisco.com/en/US/docs/cable/cmts/ubr10012/configuration/guide/scg.html

Cisco uBR10012 Universal Broadband Router Release Notes

http://www.cisco.com/en/US/products/hw/cable/ps2209/prod_release_notes_list.html

IPDR/SP 2.1

IPDR/SP Protocol Specification Version 2.1

http://www.ipdr.org


Standards

Standard
Title

DOCSIS3-OSSI

Operations Support System Interface Specification CM-SP-OSSIv3.0-D02-main-20060213_Section_6 http://www.cablemodem.com


MIBs

MIB
MIBs Link

None

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs


RFCs

RFC
Title

RFC 1014 XDR

XDR: External Data Representation Standard


Technical Assistance

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.

http://www.cisco.com/support


Command Reference

For information about commands, see the Cisco IOS CMTS Command Reference at http://www.cisco.com/en/US/docs/ios/cable/command/reference/cbl_book.html. For information about all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup or the Cisco IOS Master Command List, All Releases, at http://www.cisco.com/en/US/docs/ios/mcl/allreleasemcl/all_book.html.

Feature Information for IPDR Streaming Protocol

Table 2 lists the features in this module and provides links to specific configuration information. Only features that were introduced or modified in Cisco IOS Release 12.2(33)SCB or a later release appear in the table.

Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.

Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS, Catalyst OS, and Cisco IOS XE software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Note Table 2 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release. Unless noted otherwise, subsequent releases of that Cisco IOS software release also support that feature.

Table 2 Feature Information for IPDR Streaming Protocol

Feature Name
Releases
Feature Information

IPDR Streaming Protocol

12.2(33)SCB

The Cisco universal broadband router supports the IPDR streaming protocol feature that enables efficient and reliable delivery of high volume data records from the service elements to any systems, such as mediation systems and BSS/OSS.

The following sections provide information about this feature:

•Configuring the IPDR Session

•Configuring the IPDR Collector

•Configuring the IPDR Associate

•Configuring the IPDR Template

•Configuring the IPDR Exporter


CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Pulse, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco  IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Fast Step, Follow Me Browsing, FormShare, GainMaker, GigaDrive, HomeLink, iLYNX, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0908R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

© 2009 Cisco Systems, Inc. All rights reserved.