NetIQ Advanced Analytics 1.2 Hotfix 4 Release Notes

Date Published: April 2016

This hotfix for NetIQ Advanced Analytics resolves specific previous issues. This document outlines why you should install this hotfix.

Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs. You can post feedback in the AppManager forum on NetIQ Communities, our online community that also includes product information, blogs, and links to helpful resources.

1.0 What’s New?

This hotfix resolves the following issues:

  • Boundary overrides do not work as expected for percentage metrics. This hotfix resolves an issue where implementing boundary overrides for percentage metrics when the metric might realistically exceed 100% could result in Advanced Analytics learning an incorrect normal range for the metric. For example, a normal value for CPU utilization on a VMWare computer might be 120%. If you implemented an upper boundary override of 100% (since that would be the expected upper boundary for most percentage metrics), Advanced Analytics replaced the value of 120% with a value of 100% and generated an event for any values that exceeded 100%, even though values that exceeded 100% were normal for the metric. With this hotfix, during the learning period, Advanced Analytics uses only observed values when establishing the normal range for a metric and does not take boundary overrides into account. During real-time monitoring (after the learning period has ended), Advanced Analytics considers both observed values and boundary overrides when determining whether to adjust the learned boundaries. When an upper boundary override exists, Advanced Analytics uses it only if it is greater than the observed maximum value. When a lower boundary override exists, Advanced Analytics uses it only if it is less than the observed minimum value. (ENG337009)

  • Notifications continue after removing email from rule. This hotfix resolves an issue where Advanced Analytics continued sending email notifications when it generated events even though you removed an email address from the monitoring rule that generated the event. With this hotfix, Advanced Analytics correctly applies modifications you make to the list of notification recipients. (ENG341326)

    NOTE:To completely resolve this issue, after you install this hotfix, you must stop the existing AdvancedAnalytics_EventListener Knowledge Script job and start a new job using the updated EventListener script.

2.0 System Requirements

For information about system requirements, see the Advanced Analytics User Guide, available on the AppManager Documentation page.

3.0 Contents of the Download Package

The download package contains the following files:

  • advancedanalytics_1.2.0.4_releasenotes.html, these Release Notes.

  • AdvancedAnalytics_1.2.0.4.exe, a compressed file that contains the following files for installing the hotfix:

    • AASetup.exe, the hotfix setup program.

    • Setup Files, a folder that contains executables to update the following components:

      • Advanced Analytics Service

      • Advanced Analytics for AppManager module

4.0 Installing This Hotfix

Use AASetup.exe to update the applicable Advanced Analytics components to this hotfix version. When you run the setup program, it detects the components available for update on the computer and runs the appropriate executables to update them.

To install this hotfix:

  1. Run AdvancedAnalytics_1.2.0.4.exe to extract the files necessary to install the hotfix.

  2. On the following computers, run AASetup.exe as an administrator and provide the required information:

    • Advanced Analytics Service

    • Advanced Analytics for AppManager

  3. On the QDB computer, run AASetup.exe as an administrator and complete the following steps:

    1. When prompted, select Install Knowledge Scripts.

    2. Specify the SQL Server name of the server hosting the QDB, as well as the case-sensitive QDB name.

    IMPORTANT:If you use AppManager Control Center 7.x, run AASetup.exe for each QDB attached to Control Center. If you use Control Center 8.x or later, run AASetup.exe only for the primary QDB, and Control Center automatically replicates the updates to non-primary QDBs.

5.0 Modified Files

This hotfix modifies the following files:

  • On the Advanced Analytics Service computer:

    • IQPHX.dll (Build Number #Build_Version#)

    • phxanalyzer.dll (Build Number #Build_Version#)

    • phxexecutioncontext.dll (Build Number #Build_Version#)

    • phxmaincontrol.dll (Build Number #Build_Version#)

  • On the Advanced Analytics for AppManager computer, AdvancedAnalytics_EventListener.qml (Build Number #Build_Version#)

6.0 Previous Releases

This hotfix also includes fixes from the following previous hotfixes:

6.1 Advanced Analytics 1.2 Hotfix 3, February 2016

This hotfix resolved the following issues:

  • Boundary overrides do not work as expected for percentage metrics. This hotfix resolves an issue where Advanced Analytics ignored boundary overrides for percentage metrics when the metric exceeded 100% and instead expanded the maximum value of the learned normal range so that the metric fell within the normal range. With this hotfix, the following changes prevent Advanced Analytics from ignoring boundary overrides (ENG337009):

    • During the learning period, if an override exists for a time series, Advanced Analytics replaces values that are greater than the upper boundary override with the upper boundary override value and replaces values that are less than the lower boundary override with the lower boundary override value.

    • After the learning period is complete, when Advanced Analytics receives a new data point that is greater than the upper boundary override or less than the lower boundary override, it generates an event.

  • Management Groups filter empty for Control Center repository using port other than default. This hotfix resolves an issue where the Management Groups filter for creating rules did not retrieve the list of available servers based on AppManager management group membership if the Control Center repository (CCDB) was using a port other than 1433, the default port. With this hotfix, the Management Groups filter is able to retrieve the list of available servers regardless of which port the CCDB uses. (ENG340528)

  • Event message did not contain details. This hotfix resolves an issue where Advanced Analytics generated an event with the title “Time Series Discovery Execution Failure” in the Control Center console when connectivity issues between Advanced Analytics and a SQL Server hosting an AppManager repository (QDB) caused discovery to fail, but the event details were blank. With this hotfix, the event includes details that describe the connectivity issue. (ENG340661)

6.2 Advanced Analytics 1.2 Hotfix 2, October 2015

This hotfix provided the following enhancement:

  • Uninterrupted monitoring after migrating AppManager agents to new AppManager repositories. This hotfix allows Advanced Analytics to continue monitoring activities without interruption after you migrate AppManager agents from older versions of AppManager repositories (QDBs) to an AppManager 9.x QDB and add the new QDB to Advanced Analytics.

    After you migrate the agents and add the new QDB to Advanced Analytics, you can link data that Advanced Analytics previously learned from the old QDBs to the new QDB. Linking the previously-learned data allows for continuous monitoring while Advanced Analytics learns patterns from the new QDB.

    For more information about implementing this new feature, see “Configuring Continuous Monitoring After Migrating AppManager Agents to New QDBs” in the Advanced Analytics User Guide, available on the AppManager Documentation page.

    For more information about migrating agents to a version 9.x QDB, see the Upgrade and Migration Guide for AppManager, available on the AppManager Documentation page.

6.3 Advanced Analytics 1.2 Hotfix 1, May 2015

This hotfix provided the following enhancements:

  • Filter information available for rules. After you save a rule that you created based on Control Center management groups, when you hover the mouse over the rule on the Manage Rules tab, Advanced Analytics displays the management group name in addition to the names of the servers the rule monitors. (ENG337117)

  • Console displays number of records retrieved for filters. When you create a rule and select a server filtering method (All, Logical Servers, or Management Groups), Advanced Analytics displays the number of rows the filter retrieved at the bottom of the grid on the Filter window. (ENG337118)

  • Real-time monitoring continues when AppManager recreates jobs. When AppManager recreates Knowledge Script jobs, Advanced Analytics uses previously learned knowledge from compatible time series to continue real-time monitoring instead of suspending monitoring while it learns about the newly-created time series. When Advanced Analytics acquires knowledge about the newly-created time series, it switches to using the new knowledge for real-time monitoring. For example, if you unregister an AppManager repository (QDB) from Control Center repository (CCDB) A and then register the QDB with CCDB B, AppManager stops all jobs that are based on the monitoring policies of CCDB A. If CCDB B has the same monitoring policies, AppManager restarts the monitoring policy jobs. Instead of suspending monitoring while it learns about the time series for the restarted jobs, Advanced Analytics continues real-time monitoring using previously learned knowledge from compatible time series.

  • Increased time between discoveries. Advanced Analytics now runs the discovery process to detect time series changes from monitored QDBs once per day instead of every two hours.

This hotfix resolved the following issues:

  • StatusEvents job raises invalid event for EventListener job. This hotfix resolves an issue where the StatusEvents Knowledge Script job reported that the EventListener Knowledge Script job was not running even though it was running. With this hotfix, the StatusEvents job reports the correct status for the EventListener job. (ENG336611)

  • Console stops unexpectedly when modifying time series overrides. This hotfix resolves an issue where modifying or removing overrides for time series boundaries might have caused the Advanced Analytics Console to stop unexpectedly. With this hotfix, you can successfully modify or remove the overrides. (ENG336796)

  • Management groups in folders do not display in the console. This hotfix resolves an issue where management groups that were within folders in the Enterprise Layout view of the Control Center console were not available for selection in the Advanced Analytics Console when you tried to create a rule based on Control Center management groups. With this hotfix, management groups within folders are available for selection. (ENG336991)

  • Legends not available for selection when creating rules. This hotfix resolves an issue where if you selected servers to monitor based on Control Center management groups and then selected to monitor all servers within a management group, the Advanced Analytics Console could not retrieve the legends that were available for monitoring. With this hotfix, the console retrieves the legends. (ENG337116)

7.0 Contact Information

Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you.

For detailed contact information, see the Support Contact Information website.

For general corporate and product information, see the NetIQ Corporate website.

For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.