release notes for cisco insight reporter v4.0 · the above recommendation is for a good response...

Text Part Number: OL-29186-01

Corporate Headquarters

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http: / /www.Cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100

Release Notes for Cisco Insight Reporter v4.0.0

June 24, 2013

__________________________________________________ Release Notes for Cisco Insight Reporter v4.0.0

Document Details

Cisco Service Center Release Part Number Publication Date

Release 4.0.0 OL-29186-01 June 24, 2013

This Release Note pertains to the official release of Cisco Insight Reporter v4.0.0.

It includes all the defects and caveats that were identified as part of internal testing. It assumes that the

reader has a good working knowledge of the Cisco Insight Reporter software.

This document covers the following:

Target Operating Environment

Compatibility with Cisco DPI Devices

New Features and Enhancements

Closed Caveats

Open Caveats

Related Documents

Obtaining Documentation and Submitting a Service Request

Introduction


__________________________________________________



The Cisco Insight Reporter v4.0.0 is the web reporting application to monitor traffic

analyzed by the DPI capabilities of Cisco Service Control Engines (Cisco SCE).

Note Cisco Insight Reporter v4.0.0 supports Cisco SCE deployments running Cisco SCOS

Release 4.0.0 and earlier, and is backward compatible with earlier releases.

Starting from Release 4.0.0, the application supports only Cisco SCE devices and does

not support Cisco ASR1000 series routers running Application Visibility and Control

(AVC) feature.

Cisco ASR1000 customers can check on cisco.com for the availability of other reporting

solution for AVC.

Note Customers running Cisco Insight Reporter releases earlier than v4.0.0 for deployments

based on Cisco ASR1000 routers will need to remove the related network

configuration(s) before upgrading to Cisco Insight Reporter v4.0.0.

The upgrade procedure does not support the migration of Networks created for Cisco

ASR1000 devices under the Network Wizard.

Cisco Insight Reporter v4.0.0 software is primarily designed to be installed as an

independent component on a dedicated hardware, this scenario is the most suitable for

medium/large SCE deployments for which it is advisable to keep the data collection and

storage layers on separate hardware and dedicate all the server resources to the Cisco

Insight Reporter application.

For demo purpose or small Cisco SCE deployments, the application can be installed on the

same host as the Cisco Service Control Collection Manager (CM). In this scenario, the

embedded MySQL 5.1 database engine, provided with the application, needs to be used to

store traffic data and the CM must be configured to populate it.

The application can also be installed on a deployed server with the CM software and its

traffic database but, in this case, the database engine needs to be MySQL 5.1.

The software can be deployed also on virtualized systems provided that the hosted operating

system is compliant and that all the requirements on prerequisites are met.


__________________________________________________


Hardware Requirements

The Cisco Insight Reporter v4.0.0 can be installed on any physical or virtual host with the

following minimal specifications:

Table 1. Hardware Specifications

Components Specifications

CPU

Single or dual-core 2.0 GHz or greater Intel x86/64 processor

OR

32/64 bit single or dual-core 2.0 GHz or greater SPARC processor

RAM 4 GB or greater

Free Disk Space 10 GB for the OS + additional disk space in case of traffic data storage.

Recommended size: > 100 GB

Network interface Single 100BASE-T Ethernet or greater

In case of doubt, you can contact Cisco Support to get an estimation of the required CPU

power, RAM capacity, and disk storage.

Note The performance of the Cisco Insight Reporter v4.0.0 depends on the size of the SCE deployment and

the number of users simultaneously running the reports. To get an optimal performance, the hardware

may have to be scaled accordingly.

The above recommendation is for a good response time when running ONLY the Cisco Insight

Reporter v4.0.0 application. In case the same server is used to co-host other applications, the hardware

has to be upgraded with more RAM, CPU power and storage capacity.

Software Requirements You can install Cisco Insight Reporter v4.0.0 on any server running the following operating

systems:

Table 2. Supported Operating Systems

OS and architecture Version Architecture

Red Hat Enterprise Linux

or CentOS 5.x Intel 32/64 bit

Solaris 9 or 10 Intel 32/64 bit

SPARC 32/64 bit

Note The recommended operating system for best performance is Red Hat Enterprise Linux 5 64-bit.


__________________________________________________


Java Runtime Environment (JRE) Cisco Insight Reporter v4.0.0 requires JRE6. If the installer does not find JRE6 on the

system, it will automatically install it.

Supported Browsers The Cisco Insight Reporter v4.0.0 is compliant with the following browsers:

Firefox v3.0 and later

IE v6.0 and later

Google Chrome v5.0 and later

Notes As a prerequisite, the Flash Player 10.x browser plug-in should be installed on all client PCs that

will be used to display reports

Cisco Insight Reporter v4.0.0 supports both HTTP and HTTPS

Screen Resolution The application GUI supports a variety of screen resolution modes including 1280x1024,

1024x768, and 1680x1050 with consistent support of 4:3 and 16:9 aspect ratios (wide

screen). For a better user experience it is recommended to use a minimum vertical

resolution of 1024 pixels.

Note A minimal screen resolution of 1024x768 is supported with vertical and horizontal scroll bars. For

other resolutions, scrollbars may appear if the screen resolution is lower than the application

workspace or if there are too many toolbars configured on the browser.

To maximize the user experience, it is suggested to set the browser to full-screen mode (that can be

set usually by pressing the F11 function key).

Supported Databases The Cisco Insight Reporter v4.0.0 is delivered with a bundled MySQL 5.1 database that is

used for internal operations, but can also be used to store traffic data populated by the Cisco

Collection Manager software.

The application is distributed with an embedded MySQL 5.1 server (required for its internal

operations) but can also integrate an existing MySQL 5.1 instance, when installed on a pre-

configured environment running Cisco Service Control Collection Manager Software. In

that case, the database engine must be MySQL 5.1 and it will host both the Insight

Reporter’s proprietary schemas and the Cisco Service Control Collection Manager schema

containing traffic data.

Cisco Insight Reporter can also be configured to work with external traffic databases

populated by Cisco Service Control Collection Manager(s).


__________________________________________________


The supported vendors and versions for external traffic databases are:

Oracle 9.x or later

Sybase ASE 12.x or later

MySQL 5.x or later

Note For licensing issues, when working with Oracle and Sybase databases, customers are required to

provide the software JDBC connectors and copy them on a specific path of the application, as

described in the Installation Guide.


__________________________________________________



Cisco Insight Reporter is the reporting platform for both Cisco Service Control Application

solutions.

This release 4.0.0 supports the following devices and configurations:

Table 3. Supported devices and releases

DPI device SW release CM schema version

Cisco SCE

all models, but only

SCE8000 supported for

IPv6 traffic

Cisco SCOS 3.5.0 to 4.0.0 Same as Cisco SCOS release


__________________________________________________


Differences with Previous Release

The Cisco Insight Reporter v4.0.0 provides all the functional features of previous releases

as it is an incremental version.

The current release fully supports the feature set provided by Cisco SCOS Release 4.0.0 and

introduces new reports, as well as enhancements to existing reports, to leverage the new

capabilities implemented on SCE devices.

In particular, this release completes the full support for IPv6 for all traffic tables used to

generate reports.

The release is 100% compatible with existing Insight v3.x deployments and supports

software upgrade to allow customers to perform a seamless installation of the application

without the need to reconfigure all settings and existing report customizations (SCE

networks, saved/scheduled reports, dashboard, color settings, etc.).

Note Starting from this release 4.0.0, the application only supports Cisco SCE devices and

does no longer support Cisco ASR1000 series routers running Application Visibility and

Control (AVC) feature.

Customers running Cisco Insight Reporter releases earlier than v4.0.0 for deployments

based on Cisco ASR1000 routers will need to remove the related network

configuration(s) before upgrading to Cisco Insight Reporter v4.0.0.

The upgrade procedure does not support the migration of Networks created for Cisco

ASR1000 devices under the Network Wizard.


__________________________________________________

__________________________________________________ Release Notes Cisco Insight Reporter v4.0.0

The following matrix describes the main differences between the two versions:

Table 4. Comparison with Previous Releases

Major feature Insight Reporter

v3.4.0

Insight Reporter

v4.0.0

Web2.0 GUI Yes, based on Flex client

CM database positioning

(traffic database)

One or more external DBs

Can also use the internal MySQL 5.1 instance

Multi-vendor database

support

Oracle 9.x or later

Sybase ASE 12.x or later

MySQL 5.x or later

SCE report template (and

CM schema) 3.5.0 to 3.8.5 3.5.0 to 4.0.0

ASR1K IOS support

15.1(3)S (XE 3.4.0S)

15.2(1)S (XE 3.5.0S)

15.2(2)S (XE 3.6.0S)

no more supported

Multi-device configurations Yes, with report configuration

Authentication support with

external AAA servers Yes, support of RADIUS and TACACS+

Deployment architecture Can be installed on a single appliance or distributed


__________________________________________________


New Features and Enhancements

Following is the list of new features and enhancements provided with this release.

Architectural features:

Full support of IPv6 traffic for all RDRs and database tables —filters can be set to

reports to focus the traffic analysis on specific IP type (some reports were already

migrated in the Service Pack #1 delivered for release 3.4.0).

Removed the support for Cisco ASR1000 series routers and Application Visibility

and Control (AVC).

Enhancements provided in the Service Pack delivered for v3.4.0:

o Backup/Restore procedure (script)

o Enhancement to the scheduler to save on the server’s file system the output

of scheduled reports

o CM 3.8.6 database schema support

o Support of DS-lite option as IP traffic type

o Change for Active Subscribers report

o Enhancements to existing reports as described in the Release Notes of

Service Pack #1 for v3.4.0.

Rollback procedure in case of failure in upgrading.

Visualization of thresholds on bandwidth and volume charts (manual entries).

Implementation of thresholds for Global Bandwidth/Volume for a specific Network

with notification of quota breach via email or logged on file system.

Customization of thematic dashboards.

New reports and enhancements to existing reports:

Active Subscribers report enhanced to support different IP type traffic

(implementation provided in the Service Pack #1 for release 3.4.0)

New reports for OS fingerprint (OSFP) detection

Mobile AppStore report

Mobile WhatsApp app usage report (message count)

Mobile iMessage app usage report (message count)

Filter to focus on specific IP type in Total Active Subscribers report

All Bandwidth reports now provide information about the average, maximum and

minimum bandwidth values calculated for the selected time range

Enhancement to report “Bandwidth per Cable Modem group”

Filter Option for Packages in Vlink BW per Package report

Closed Caveats

__________________________________________________


Closed Caveats

The following issues have been fixed in this release:

Table 5. Fixed Issues

Defect number Summary

CSCud71693 CMTS-related reports: issue while switching the Topology

tree view mode.

CSCud74017 VLink Bw per Package report needs to have flexible time

aggregation.

CSCud76303 Top Vlink usage volume report not generated in CMTS-

aware network.

CSCue68507 DS_Lite filter option not valid for reports based on ZUR and

PUR RDRs.

CSCue86349 Duplication of Vlink Names in CMTS-aware mode.

CSCue92510 Temp tables are not removed from Mysql DB after report

execution.

CSCuf56002 New Packages defined on SCE are not displayed on Insight

Reporter.

CSCug21930 VLink Bandwidth per Service report is displaying inaccurate

data.

CSCug65314 Top Subscribers report fails when using CM 3.7.5 schema.

CSCug69171 CMTS reports: enhancements to the list of Virtual Links.

CSCug96581 Package Counters instead of IDs are used for Top

Subscribers reports.

CSCuh02366 Protocol tab is not getting loaded when HTTP signatures are

not defined.

CSCuh02940 Some reports fail when working with Oracle DB.

Closed Caveats

__________________________________________________


Open Caveats

Below is the list of open caveats for the current release:

CSCub67401—Tomcat server must be restarted if the DB server went down Symptom: When end user restarts the database server, all the connections used by Insight

Reporter are terminated. However, the application still tries to use the old connection pool

even if it is no longer available.

Conditions: Restart the local MySQL server and try to use the application.

Workaround: Open an SSH connection on the Cisco Insight Reporter server and manually

restart the Tomcat service (or reboot the server).

CSCuh57908 — Non-supported IP type filter for Malicious traffic reports Symptom: Malicious traffic analysis reports currently expose a filter for IP type (to select

IPv4, IPv6, or DS-Lite traffic). That filter is actually not applicable to those reports.

Conditions: Open a Report Wizard window and select the topic corresponding to Malicious

traffic analysis.

Workaround: Do not use the IP type filter for these reports.

CSCuh35588 —Top Subscribers report not generated when Pkg aggregation disabled in CM

Symptom: When generating the Top Subscribers report, Cisco Insight Report displays the

"No Data Found for selected range" message.

Conditions: Package aggregation is disabled for NUR RDRs on Cisco Service Control

Collection Manager. Generate the Top Subscribers report on Cisco Insight Reporter.

Workaround: Do not disable the Package aggregation on the Cisco Service Control

Collection Manager. If the Package aggregation is disabled, unselect the All Packages

option on the Insight Reporter's filter when generating the Top Subscriber reports.

CSCuh37580 — Top FTP Servers report: volume values reported as IPv4 addresses

Symptom: The Top FTP Servers report displays volumes using the quad-dotted notation

reserved to IPv4 addresses instead of decimal format.

Conditions: Open a Report Wizard window and select the topic corresponding to the Top

FTP Servers report.

Workaround: No workaround available for the interactive report. Export the report in CSV

format or use the chart tooltip to check the volume consumption of each reported FTP

server.


__________________________________________________


CSCue84277—Missing parameters in Link Aggregated Usage Volume per Service report

Symptom: The Link Aggregated Usage Volume per Service report is missing the filters for

topology and services. So it is not possible to run the report for a specific subset of Cisco

SCEs or for a specific group of services.

Conditions: Open the Report Wizard and select the Topic to generate the Link Aggregated

Usage Volume per Service report.

Workaround: None

CSCuh27521—Some fields are missing in Subscriber Flows Details report Symptom: Some fields are missing in Subscriber Flow Details report. Protocol IDs are

displayed instead of protocol names. Also the time boundary is missing; hence it is not

possible to generate the report for a specific time boundary.

Conditions: Open a Report Wizard window and select the topic corresponding to the

Subscriber Flows Details report. Then execute the report.

Workaround: None

CSCuh43799 —Top Service Servers report show service series as IPv4 addresses Symptom: The Top Service Servers report plots service series whose labels are reported as

IPv4 addresses.

Conditions: Open a Report Wizard and select the Traffic Discovery topic, then generate the

Top Service Servers report.

Workaround: Export results in CSV format.

CSCuh48483 - Subscriber Flows Details report does not refresh properly Symptom: The Subscriber Flows Details report is generated correctly the first time it is

executed, but then shows an empty page if the operator tries to refresh it or to run it to

monitor a different subscriber.

Conditions: Open the Report Wizard and select the Subscriber Flows Details report, then

try to reuse the same instance to refresh results or to switch to a different subscriber.

Workaround: Close the previously generated report before attempting to execute another

instance.


__________________________________________________


CSCuh51278—Top SIP Domains/User Agents reports do not support time aggregations

Symptom: Top SIP Domains and Top SIP User Agents reports are not generated when the

time aggregation parameter is different than NONE.

Conditions: Open the Report Wizard and select the Top SIP Domains or Top SIP User

Agents reports, then try to change the aggregation interval under the Date and Time tab.

Workaround: None.


__________________________________________________


Related Documents

This document is to be used in conjunction with the documents listed below:

Cisco Insight Reporter v4.0.0 Installation Guide

Cisco Insight Reporter v4.0.0 User Guide

Closed Caveats

__________________________________________________


Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html.

Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

This document is to be used in conjunction with the documents listed in the Xref_Color\xd2 umentation”Error! Reference source not found.” section.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned 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. (1110R)

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

© 2013 Cisco Systems, Inc. All rights reserved.