NetIQ AppManager

Version 8.2

Release Notes

Date Published: June 2013

 
 

 

AppManager version 8.2 includes new features and improves usability. 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 our products meet all your needs. You can post feedback in the AppManager forum on Qmunity, our community Web site that also includes product notifications, blogs, and product user groups.

For more information about this release and for the latest release notes, see the AppManager Documentation Web site. To download this product, see the AppManager Suite Product Upgrades Web site.

What's New?

The following outline the key features and functions provided by this version, as well as issues resolved in this release:

Software Enhancements

AppManager version 8.2 includes the following software enhancements:

The enhancements this version provides are available only for AppManager repositories (QDBs) that you choose to upgrade. For information about the requirements to maintain older versions of QDBs in an 8.2 environment, see System Requirements.

View Details about Specific Entities in the Managed Environment through New Default Management Groups

AppManager version 8.2 includes a new default management group, AM Logical Servers, that includes all physical computers as well as specific entities on those computers as top-level objects. These entities are known as logical servers and include the following object types:

  • The following VMware vCenter resources:
    • ESX hosts
    • Virtual machines
    • Datacenters
    • Clusters
    • Datastores
    • Datastore clusters
  • Root application objects that allow access to other objects within the application hierarchy (for example, SQL Servers or IIS servers)
  • SQL Server databases and Oracle databases
  • Applications you are monitoring with the AppManager ResponseTime for Windows (Windows-RT) module
  • Network and SNMP Toolkit devices

Including both the physical computers and logical servers as top-level objects allows you to view details about the computers as a whole or about only specific entities on those computers. The AM Logical Servers management group is divided into the following management groups:

  • All Logical Servers displays all physical computers and logical servers that Control Center manages.
  • Databases displays all SQL Server databases and Oracle databases that Control Center manages.
  • Network Devices displays all network devices that Control Center manages.
  • Virtual Infrastructure displays the following resources that Control Center manages:
    • ESX hosts
    • Virtual machines
    • Datacenters
    • Clusters
    • Datastores
    • Datastore clusters

The new management groups include only physical computers and logical servers that belong to QDBs you upgrade to version 8.2. The management groups do not include objects that belong to QDBs that you choose not to upgrade.

For more information about the new management groups, see the Control Center User Guide for AppManager, available on the AppManager Documentation Web site.

Create Rule-based Management Groups Made Up of Specific Entities on a Physical Computer

When you created rule-based management groups with previous versions of AppManager, Control Center displayed the complete discovered hierarchy of entities for each computer selected as a group member. To manage specific entities on the computer, you had to navigate the complete hierarchy to locate the specific entity you wanted to investigate. In addition, you could not isolate the entities into their own groups.

With AppManager version 8.2, you can create rule-based management groups consisting of physical computers, logical servers, or both. The ability to create rule-based management groups made up of logical servers gives you more flexibility in defining your view of the managed environment. For example, you can manage SQL Servers by location or manage a select set of SQL Server databases without having to view all of the discovered objects on the SQL Server.

For QDBs you choose not to upgrade to version 8.2, rules you create to select logical servers will not select objects from those QDBs.

For more information about creating rule-based management groups, see the Control Center User Guide for AppManager, available on the AppManager Documentation Web site.

Assign Custom Properties to Additional Object Types

Previously, you could only assign custom properties to physical computers. With AppManager version 8.2, you can assign custom properties to both physical computers and logical servers.

By assigning custom properties to logical servers, you can create rule-based management groups that allow you to dynamically manage logical servers in addition to physical computers. For more information about using custom properties with logical servers, see the Control Center User Guide for AppManager, available on the AppManager Documentation Web site.

View Charts and Data Streams for Specific Objects in Servers Views

Previously, you could only view charts and data streams at the physical computer level. With AppManager version 8.2, when you select an object in a Servers view in the Control Center console (regardless of whether the object is a physical computer or a logical server), the Charts tab displays only the charts and data streams for that specific object. For example, if you select a Virtual Center server, you will now see only the charts and data streams related to the virtual server rather than all charts and data streams for the physical host.

Operating System Support

AppManager version 8.2 includes support for the following operating system versions:

  • For the QDB and Control Center repository (CCDB): Microsoft SQL Server 2012 (32-bit or 64-bit) on computers running Microsoft Windows Server 2008 or later
  • For all components: Microsoft Windows Server 2012 (GUI mode only)
  • For the Windows agent, Control Center console, Operator Console, and Operator Web Console: Microsoft Windows 8 (32-bit or 64-bit)

Software Fixes

AppManager version 8.2 includes the following software fixes:

AppManager Modules with Embedded Configuration Wizards Cannot Launch the Wizard During Module Installation

If you install a module that has an embedded Configuration Wizard, the module now successfully launches the wizard at the end of the installation. This fix applies to the following modules (ENG326686):

  • HP Systems Insight Manager
  • IBM Systems Director
  • Microsoft Exchange
  • Response Time for Windows
  • Siemens ServerView

Chart Component Does Not Install When Accessing Operator Web Console from Remote Computer

If you access the Operator Web Console from a remote computer and click Charts to install the chart component, AppManager now successfully installs the component. (ENG327936)

Previously, AppManager displayed the following error message when you clicked Charts:

The module "AMChartHost.ocx" failed to load.

Return to Top

Changes to Expected Behavior

AppManager version 8.2 includes the following changes to expected behavior:

QDB Upgrade Cannot Continue if the SQL Server Agent Service is Down

When you upgrade a QDB to version 8.2 and the SQL Server Agent service is down, the setup program informs you that the service is down and does not allow you to continue until you start the service.

Previously, the setup program warned you that the service was down but allowed you to continue if you chose not to start it.

Upgrade Cannot Continue with Active QDB or CCDB Processes

When you upgrade a QDB or the CCDB with active processes to version 8.2, the setup program informs you of the active processes and does not allow you to continue until you stop the active processes.

Previously, the setup program warned you about the active processes but allowed you to continue the upgrade if you chose not to end them.

Data from QDBs that Are Unavailable During and Following CCDB Upgrade Remains Unavailable Until the QDBs Are Available

If a non-primary QDB is unavailable when you upgrade the CCDB to version 8.2 and remains unavailable for some time after the upgrade completes, when you open the Control Center console after the upgrade, data from the non-primary QDB is not available until the QDB is available.

Previously, the data was available even if the QDB was not.

Managing Custom Properties in Service Map Views Does Not Apply to Embedded Views or to Non-machine Objects that Belong to Non-upgraded QDBs

After you upgrade to version 8.2, you can manage custom properties for both physical computers and logical servers from within Service Map views as long as the objects are not included in embedded Servers, Service Map, or Events views. You cannot manage custom properties for embedded views within a Service Map view.

In addition, before version 8.2, if you defined a custom property for a child object of a physical computer (for example, a CPU) in a Service Map view, AppManager created the custom property against the physical computer. If you selected the child object in the Service Map view, Control Center displayed all of the custom properties defined against the physical computer for that child object on the Custom Properties tab. After you upgrade to version 8.2, if you create a custom property for a child object of a physical computer that belongs to a QDB that you choose not to upgrade, if you select that child object in a Service Map view, Control Center will only display the custom properties that apply to the physical computer itself. You will not see custom properties defined for child objects of the physical computer.

Some View-based Management Groups No Longer Include Physical Computers Where Application Resources Are Installed

After you upgrade a QDB to version 8.2, some view-based management groups (for example, SQL or IIS) no longer include the physical computer on which the SQL and IIS logical servers reside. As a result, deployment rules you previously configured to deploy to those management groups no longer work and you must configure new deployment rules.

Server Name Filter No Longer Applies to Some Servers Views for View-based Management Groups

After you upgrade a QDB to version 8.2, if you previously applied the Server Name filter to a Servers view in an application view-based management group (for example, SQL or IIS), the filter is no longer valid and the Servers view is empty because the management group no longer includes physical computers. To filter the Servers view after you upgrade, re-create the filter and set the value to the logical server name.

Return to Top

System Requirements

When you upgrade to version 8.2, you must upgrade all components included in the installation package. For QDBs, you must upgrade at least the primary QDB to version 8.2. Upgrading non-primary QDBs to version 8.2 is optional, but new features will not be available for those QDBs.

Non-primary QDBs you attach to a version 8.2 CCDB must meet the following version requirements:

  • For version 7.x QDBs: 7.0.1, 7.0.3, or AppManager 7 Platform Update with Hotfix 7011821 or later
  • For version 8.x QDBs: 8.0.2 with Hotfix 7011822 or later, 8.0.3 with Hotfix 7011823 or later, or 8.2 or higher

You can download the hotfixes from the AppManager Suite Hotfixes Web site.

Return to Top

AppManager Versions Supported for Upgrade

Component Support for In-place Operating System or SQL Server Upgrade? AppManager Versions Supported for Upgrade
QDB Windows Server 2008 R2 to Windows Server 2012


SQL Server 2008 R2 to SQL Server 2012
AppManager 7 Platform Update
8.0.x
CCDB 7.0.4
AppManager 7 Platform Update
8.0.x
Management server Windows Server 2008 R2 to Windows Server 2012 AppManager 7 Platform Update
8.0.x
Windows agent 7.0.1
7.0.2
7.0.25
8.0.x
Web management server AppManager 7 Platform Update
8.0.x
Command queue service (CQS) 7.0.4
AppManager 7 Platform Update
8.0.x
Deployment Service
Deployment Web Service
Control Center console
Operator Console AppManager 7 Platform Update
8.0.x

Return to Top

Installing This Version

This version supports new installations and upgrades from the versions listed in AppManager Versions Supported for Upgrade.

For in-place QDB upgrades from AppManager 7 Platform Update to version 8.2, the setup program updates all stored procedures that AppManager modules use to the versions that are included with the 8.2 installation package. If you have a newer version of a module at the time you perform the upgrade, the setup program does not preserve the newer version. To get the newer version, you must reinstall the module after you complete the upgrade to version 8.2.

For in-place QDB upgrades from version 8.0.x, the setup program does not update stored procedures that AppManager modules use and does not add stored procedures for modules that are included with the 8.2 installation package but do not currently exist in the QDB. To get any new modules, you must manually install them. If a new module includes updates to stored procedures, you must install the module for each QDB that is attached to Control Center. To determine whether you must install a module for each QDB or only for the primary QDB, see the management guide for the module.

To install new components:

  1. Run Setup.exe, click Start Installation, and then click Install AppManager.
  2. Follow the prompts to complete the installation. For more information, see the Installation Guide for AppManager, available on the AppManager Documentation Web site.

To upgrade components:

  1. Close all Control Center consoles.
  2. Stop the command queue service for the CCDB. The command queue service can be on the same computer as the repository or a different computer.
  3. (Conditional) If you have non-primary QDBs you do not plan to upgrade but do plan to use in the 8.2 environment, apply the required hotfixes. For more information, see System Requirements.
  4. To upgrade a local or remote QDB, complete the following steps:
    1. Ensure that the SQL Server Agent service is running on the QDB computer.
    2. Stop any processes that are active for the QDB.
    3. Run Setup.exe, click Start Installation, and then click Upgrade AppManager.
    4. Select the option to upgrade the QDB and then follow the prompts to complete the upgrade.
    5. (Conditional) To upgrade a clustered QDB, run Setup.exe from any node in the cluster or from a remote computer. Enter the SQL Virtual Server name in the SQL Server Name\Instance field and the SQL Virtual Server QDB name in the Repository field.

      You do not need to failover the cluster for the upgrade. Any changes to cluster nodes that are offline during the upgrade are automatically propagated when the nodes are online.

  5. Start the command queue service.
  6. (Conditional) If you will upgrade the CCDB immediately after you upgrade the QDB, wait a few minutes for the service to update the QDB version information in the CCDB.

  7. To upgrade a local or remote CCDB, complete the following steps:
    1. Stop any processes that are active for the CCDB.
    2. Ensure that the SQL Server Agent service is running on the CCDB computer.
    3. Run Setup.exe, click Start Installation, and then click Upgrade AppManager.
    4. Select the option to upgrade the CCDB and then follow the prompts to complete the upgrade.
    5. (Conditional) To upgrade a clustered CCDB, run Setup.exe from any node in the cluster or from a remote computer. Enter the SQL Virtual Server name in the SQL Server Name\Instance field and the SQL Virtual Server CCDB name in the Repository field.

      You do not need to failover the cluster for the upgrade. Any changes to cluster nodes that are offline during the upgrade are automatically propagated when the nodes are online.

  8. Follow the prompts to upgrade the remaining components. For more information, see the Upgrade and Migration Guide for AppManager, available on the AppManager Documentation Web site.

After you complete the setup programs for the various components, Control Center resynchronizes with the QDBs. Because the synchronization must finish before complete data is available to Control Center, NetIQ Corporation recommends that you wait for the synchronization to finish before using the upgraded environment. The wait time varies according to the size of the environment. For large environments, a good practice is to perform the upgrade at a time when you can allow several hours before using the environment. For small environments, one hour is a sufficient wait time.

Return to Top

Known Issues

NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issues are currently being researched. If you need further assistance with any issue, please contact Technical Support.

Control Center Fails to Select Windows and UNIX Computers with the Logical Servers of Matching Component Type Rule

Issue:

If you attempt to create a management group or add members to a management group using the Logical Servers of matching Component Type rule and select UNIX or NT as the component type, Control Center fails to select UNIX or Windows computers but selects all other matching UNIX or Windows components. (ENG324578)

Workaround:

To create a management group containing UNIX or Windows computers or to add those computers to a management group, use the Logical Servers with matching Type and Name rule. For Logical Server Type select UNIX:Computer or NT:Computer. For Name specify the computer name.

Control Center Might Display an Incorrect Event Status for Physical Computers in Service Map Views

For physical computers in Service Map views, Control Center might incorrectly indicate that no events are present if the computer does not belong to the parent management group for the Service Map view. For example (ENG326364):

  • You drag and drop the computer from a management group onto a Service Map view where the parent management group does not include the computer.
  • You make changes to the membership of the parent management group for the Service Map view that result in the computer no longer qualifying for membership in the management group.
  • You add an ad hoc computer list as a member of a management group, add the computer to the ad hoc list, add the computer to the Service Map view, and then remove the computer from the ad hoc list.
  • The parent management group for the Service Map view is rule-based and you modify the rule in such a way that the computer no longer qualifies for the rule.
  • Before you upgraded to version 8.2, you had a management group based on an application view and included the computer in a Service Map view within the management group. After the upgrade, the computer is no longer a member of the management group. Instead, the root application object becomes a member of the management group. Because the computer no longer exists in the parent management group, Control Center displays an incorrect event status for the computer in the Service Map view.

Control Center Does Not Retain Groupings by Server Name for Servers Views After Upgrade

Issue:

If you grouped a Servers view by Server Name before upgrading to version 8.2, Control Center does not retain the grouping after you complete the upgrade, regardless of whether Server Name was the only grouping or was a sub-grouping under other groupings. For example, if you grouped a Servers view by Agent Version, followed by Server Name, followed by Repository Version, after you upgrade Control Center groups the view by Agent Version followed by Repository Version. If you grouped a view only by Server Name, after you upgrade Control Center does not apply any grouping to the view. (ENG326728)

Workaround:

To group a Servers view by Server Name, reapply the grouping after you complete the upgrade.

Control Center Console Might Appear Unresponsive During Refresh in Large Environments

Issue:

In large environments, the Control Center console might seem unresponsive while it attempts to refresh after you perform certain actions (for example, create a management group or scroll in an Events view). (DOC327623)

Workaround:

If you receive a message that Control Center is not responding, select Wait for the program to respond. The console should respond in less than one minute.

Developer's Console Stops Unexpectedly Upon Knowledge Script Check In for Some Operating Systems with User Access Control (UAC) Enabled

Issue:

When you attempt to use the Developer's Console to check a Knowledge Script into the QDB on a computer running Microsoft Windows Server 2008 or 2012 with UAC enabled, the console stops unexpectedly. (ENG327108)

Workaround:

To use the Developer's Console to check a Knowledge Script into the QDB on a computer running Microsoft Windows Server 2008 or 2012 with UAC enabled, run the Developer's Console as an administrator.

Upgrade Might Fail for QDBs with a Large Number of Users

Issue:

For QDBs with a large number of users (more than 80), the upgrade to version 8.2 might fail with the following error (ENG328858):

Error executing SQL statement in database Database_Name: Timeout expired. The timeout period elapsed prior to completion of the operation or the server is not responding.

Workaround:

For information about a workaround for this issue, see Knowledge Base article 7012443.

Return to Top

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 Web site.

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

For interactive conversations with your peers and NetIQ experts, become an active member of Qmunity, our community Web site that offers product forums, product notifications, blogs, and product user groups.

Return to Top

Legal Notice

Return to Top