PDF(803.2 KB) View with Adobe Reader on a variety of devices
Updated:September 24, 2015
Release Notes for Cisco Insight Reporter, Release 5.2.0
Published: September 30, 2015
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The following information is for FCC compliance of Class A devices: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio-frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case users will be required to correct the interference at their own expense.
The following information is for FCC compliance of Class B devices: The equipment described in this manual generates and may radiate radio-frequency energy. If it is not installed in accordance with Cisco’s installation instructions, it may cause interference with radio and television reception. This equipment has been tested and found to comply with the limits for a Class B digital device in accordance with the specifications in part 15 of the FCC rules. These specifications are designed to provide reasonable protection against such interference in a residential installation. However, there is no guarantee that interference will not occur in a particular installation.
Modifying the equipment without Cisco’s written authorization may result in the equipment no longer complying with FCC requirements for Class A or Class B digital devices. In that event, your right to use the equipment may be limited by FCC regulations, and you may be required to correct any interference to radio or television communications at your own expense.
You can determine whether your equipment is causing interference by turning it off. If the interference stops, it was probably caused by the Cisco equipment or one of its peripheral devices. If the equipment causes interference to radio or television reception, try to correct the interference by using one or more of the following measures:
Turn the television or radio antenna until the interference stops.
Move the equipment to one side or the other of the television or radio.
Move the equipment farther away from the television or radio.
Plug the equipment into an outlet that is on a different circuit from the television or radio. (That is, make certain the equipment and the television or radio are on circuits controlled by different circuit breakers or fuses.)
Modifications to this product not authorized by Cisco Systems, Inc. could void the FCC approval and negate your authority to operate the product.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILTY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco Ironport, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flip Video, Flip Video (Design), Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, 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, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, 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.
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.
Cisco Insight Reporter release 5.2.0 is the web reporting application to monitor traffic analyzed by the DPI capabilities of Cisco Service Control Engines (SCE).
Cisco Insight Reporter release 5.2.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 SCE deployments, the application can be installed on the same host as the Cisco Collection Manager (CM). In this scenario, the embedded MySQL Enterprise 5.6 database engine, provided with the application, will also be used to store traffic data. In this scenario, the Cisco Collection Manager application needs to be configured to point to the embedded MySQL server.
Cisco Insight Reporter software can be deployed also on virtualized systems provided that the hosting Operating System is supported and that all the requirements related to prerequisites are met.
10 GB for the OS + additional disk space in case of traffic data storage. Recommended size: > 100 GB
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.
The performance of Cisco Insight Reporter depends on the size of the Cisco SCE deployment and the number of users simultaneously running reports. To get an optimal performance, the hardware may have to be scaled accordingly.
The minimum hardware requirements are related to the scenario for which the physical server, or virtual machine, are dedicated to Cisco Insight Reporter software only.
In case the hosting environment is shared with other applications, the allocated resources need to be increased accordingly (CPU, RAM, storage).
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 (to avoid the appearance of scroll bars).
A minimal screen resolution of 1024x768 is supported with vertical and horizontal scroll bars. For other resolutions, scroll bars 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).
Cisco Insight Reporter release 5.2.0 is delivered with a bundled MySQL Enterprise database server release 5.6 that is used for internal operations, but it can also be used to store traffic data populated by one or more Cisco Collection Managers.
When installing Cisco Insight Reporter on the same host as Cisco Collection Manager, both the traffic data and the application internal tables need to be located on the same database engine, thus it is required to use the database server shipped with the application.
Traffic data can also be stored on an external database server; in that case Cisco Insight Reporter supports the same database technologies as Cisco Collection Manager software:
-MySQL 5.x or greater
-Oracle 9.x or greater
-Sybase ASE 12.x or greater
Cisco Customers are in charge of providing the license of external database servers. They are also required to manually copy the software drivers on Cisco Insight Reporter to enable the connectivity between this latter and the external databases.
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.
Compatibility with Cisco SCE Devices
Cisco Insight Reporter is the web reporting application for the Cisco Service Control Engine solution.
This release 5.2.0 supports the following devices and configurations:
Table 3.Supported devices and releases
CM schema version
3.6.5 to 5.2.0
same as SCOS release
Differences with previous release
Cisco Insight Reporter release 5.2.0 is backward compatible with previous software versions and SCE models.
The release supports software upgrades 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.)
The following matrix describes the main differences between the two versions:
Table 4.Comparison with former release
Insight Reporter v5.1
Insight Reporter v5.2
Yes, based on Flex client
(for internal operations, but can also be used to store RDR information)
MySQL Enterprise 5.6
External database support
(to store RDR information)
MySQL, Oracle and Sybase
SCE report template support (SCA BB)
3.6.5 to 5.1.0
3.6.5 to 5.2.0
Yes, with report configuration
Authentication support with external AAA servers
Yes, support of RADIUS and TACACS+
Can be installed on a single appliance or distributed
Backward Compatibility and Limitations
This release is backward compatible with earlier releases with the exception of the following aspects:
-The former SCE models Cisco SCE 1000 series and Cisco SCE 2000 series are no longer supported, starting from release 5.1.0. Reports for those SCE models can still be generated, but the devices shall be running a compatible SCOS and they will be listed as “Generic SCEs” on the Insight Reporter application.
-The report template provided with current release provides reports for SCE deployments running SCOS 3.6.5 to 5.2.0.
-As for earlier 4.x and 5.x releases, also this 5.2.0 release is dedicated to the Cisco Service Control Engine solution and does no more provide reports for network devices based on Cisco Application Visibility and Control (AVC) solution.
-The new Custom Reports feature, introduced in release 5.1.0, currently supports only MySQL database technology and the report templates for SCOS 5.1.0 and later. Custom Reports cannot yet be defined for deployments based on Oracle or Sybase databases, or for SCE devices running a SCOS version earlier than 5.1.0.
New Features and Enhancements
The following list of new features and enhancements have been provided in this release:
-Patch consolidation (see list of closed caveats)
-New reports for HTTPs protocol usage
-Report compliancy when working with anonymized subscriber information in RDRs
The following issues have been fixed since the delivery of previous software release:
Package Active Subscribers per Service missing filter for IP Type
Total Active Subscriber Report is summed for TAS count
Daily Peak Bandwidth reports not showing the real peaks
Enable Advanced Reports setting can only be changed by SuperUser account
Tunneled IPV6 reports should be removed as they are not supported
No clear button for Package selection grid in Parameters tab
If number of Packages is higher than 1000, report fails on Oracle DB
Multiple entries of same device in PDF generated from Report Gallery
'List of subscribers suspected of Tethering' lists all packages in Query
Incorrect data points plotted when weekly time aggregation is selected
Date format conflict in PDF report generated from Cisco Insight Reporter
Custom reports based on Package series may fail when executed
Cannot modify saved report
Tomcat server must be restarted if the DB server went down
Missing or inconsistent chart types option for specific reports
Improper UI Alerts for Custom Report Import operation in case of failure
'IP Type' attribute coming twice on Parameters panel of Custom Studio
'Get Master Values' operation does not retrieve correctly Package names
Add option to remove N/A contribution from Top Subscribers report
Windows with scheduled/saved reports do not refresh automatically
Enhancements to Reports API
The following is the list of open caveats reported for current release:
CSCus30509 – Issues in upgrade from release 3.2.0 to 5.1.0
After upgrading from release 3.2.0 to release 5.1.0, some errors can be generated on the console and/or the User Interface, when running reports.
On an existing Insight Reporter 3.2.0 release, execute the following steps:
1. Download and extract the installer for release 5.1.0.
2. Run the install.sh script and enter the existing OS account used for installing release 3.2.0.
3. The upgrade scenario will be executed.
4. After the upgrade has completed, launch the application and try to run reports.
Uninstall release 3.2.0 using the uninstall.sh script.
Install release 5.1.0 on a clean environment.
CSCtq46342 – Cumulative Distribution of Subscriber SMTP Sessions cannot be generated
The Cumulative Distribution of Subscriber SMTP Sessions report cannot be generated if the applied SCE configuration does not contain a Subscriber Service Counter associated to service 'SMTP'.
Verify there is no Subscriber Service Counter associated to service 'SMTP' on the SCA BB Console.
On Insight Reporter, open the Report Wizard, select the Malicious -> Spam -> Distribution and execute the report.
On the SCA BB Console, define a Subscriber Service Counter for service 'SMTP'. Then apply the pqb configuration to all SCE devices of the network.
CSCug91168 – Possible issues with visualization of stacked area charts
Several issues with Stacked Area charts:
-Issue #1:PDF exports for Area Graph may have disorganized information on the X axis. when we use none aggregation and there is big difference in between the data points.
-Issue #2: PDF export for Area Graph may differ when working with area chart and decimal values .
-Issue #3: stacked area charts could be plotted erroneously. This is applicable to all Services with the following condition. When there are two or more services and one service has higher value, whereas another service has lower value (e.g. Volume metric)
For example Http(red color) has 700 volume and Other TCP (blue color) has 50.Then the report shows graph in blue color(TCP) upto 700
Generate a report showing service series with the PDF layout. Select a time interval for which one service has higher value and another has lower value.
If this issue occurs, you can try generating the report with a different chart type (e.g. line chart, if applicable).
When editing an existing report in the list of Favorites, the override option actually creates a copy of the report, instead of modifying the existing instance.
Try to edit an existing report in the list of My Favorites.
Change some parameters and then click the Save button.
The application will ask if you want to Override the existing instance.
There is no workaround: the user needs to delete the previous favorite report and create a new one with the desired parameters, then save it.
CSCup84787 – Default my.cnf has no optimized parameters for InnoDB engine (MySQL DB)
Insight Reporter v5.0 installs MySQL5.6 and creates a default my.cnf file inside /usr directory. But that file does not contain optimized values for InnoDB engine. It sets the default values that do not give optimum performance.
Check the my.cnf file located in the /usr directory after installing Insight Reporter 5.0.0.
The my.cnf file contains the default settings that are not optimized for good performance of the InnoDB engine.
Manualy update the my.cnf file located inside /usr directory
It is recommended to set up to max 70% physical memory to innodb_buffer_pool_size
innodb_flush_neighbors = 0
innodb_io_capacity = 2000
innodb_io_capacity_max = 6000
innodb_buffer_pool_instances = 8
thread_cache = 64
max_connections = 500
CSCus78166 – Throwing warning/Error message while installing Insight
Upgrade failure from lower version of Insight Reporter to latest build when we have a DB schema name as "Insight" and Insight user name combined with special character like "4.2.0_insight".
Insight customer using Insight user name as " insight_4.2.0" in version 4.2.0 , schema name as Insight and they want to upgrade to 5.1.0 latest build in this case upgrade getting failure
CSCuo08578 – Warning: Using a password on the command line interface can be insecure
While installing the embedded MySQL Server v5.6 shipped with the Insight Reporter application, a warning message is prompted several times on the command line interface, stating: "Warning: Using a password on the command line interface can be insecure”.
Execute the installation script of the application from the command line interface.
This issue occurs starting from Insight Reporter releases 4.2.0 and 5.0.0 (that are shipped with a new embedded MySQL Enterprise v5.6).
The warning is a MySQL-generated message and can be ignored, as it does not affect the installation process..