VMware vCenter Operations Manager Installable 5.7.1
VMware

VMware vCenter Operations Manager Installable 5.7.1 Release Notes

VMware vCenter Operations Manager 5.7.1 | Build 1166199

Last Document Update: 30 JULY 2013

Check frequently for additions and updates to these release notes.

These release notes include the following topics:

What's New

vCenter Operations Manager 5.7.1 is the latest release of VMware's integrated operations suite, converging performance, capacity, and configuration management. This new release introduces the following features and enhancements.

Performance Report Pack

This release introduces new performance report pack. By default, reports now include operations status report for line of business virtual machines, alert and performance trend, cluster utilization trend, average and peak virtual machine storage latency. With these reports you can get a consolidated operational status for a group of virtual machines and identify the clusters, datastores, or virtual machines have had performance problems. You can assess any impact to performance in terms of performance or health degradation, as well as determine which datastores had performance problems for the given time and identify the impacted virtual machines from a given datastore. For more information about the new performance reports, see the topic "Reporting Tools in vCenter Operations Manager" in the VMware vCenter Operations Manager Online Help.

Launch in Context

vCenter Operations Manager is enhanced to offer in-context application launch capability. Using this feature, you can configure a button or menu item to launch an external application using a URL in a specific context defined by the active UI element and selected object. For example, you can add an "Open in" drop-down menu that launches the vCenter Web user interface, navigating to the details of a selected virtual machine. In the same menu, there might be other items that launch into Hyperic or Log Insight for the same virtual machine.

vCenter Log Insight Integration

This release introduces integration with vCenter Log Insight (GA available in Q3 2013) and vCenter Operations Manager. Log Insight can be configured to send alerts to vCenter Operations Manager about vCenter Server objects. In the vSphere UI, vCenter Operations displays links to launch Log Insight in-context from the alerts details page and from the objects details page.

vSphere Dashboards in the Custom UI

The vSphere group in the Dashboards menu contains several default dashboards for managing virtual objects in a vSphere environment. These default dashboards are available to all members of the Administrators, Operators, and Users user groups. This release introduces the following default vSphere dashboards:
  • Troubleshooting Dashboard
  • VM Utilization Dashboard
  • VM Performance Dashboard
  • Host Utilization Dashboard
  • Cluster Utilization Dashboard
  • Datastore Performance Dashboard
  • Datastore Space Dashboard
  • Heatmaps Dashboard
  • Alerts Dashboard
  • Host Memory Dashboard
For more information about the default dashboards, See "vSphere Dashboards" in the VMware vCenter Operations Manager Getting Started Guide.

Balanced Metrics Profile

This release introduces infrastructure improvements to the Balanced profile, which reports a reduced set of metrics. Additional improvements to the Balanced profile feature enables the ability to deliver scalable reporting without compromising vCenter Operations Manager functionality. The Balance profile is the default setting for fresh installations. For upgrades, the previously selected profile is not changed. vCenter Operations Manager displays only the monitored metrics for the selected profile.

Security Hardening

This release includes additional security hardening and increases compliance with The Defense Information Systems Agency (DISA) and The Security Technical Implementation Guides (STIG) guidelines. This release also includes the following security enhancements:

  • Upgrading the Java Runtime Environment (JRE) to 1.7.0 update 17 to address security fixes.
  • Disabling the Network Files System (NFS) service and the rpcbind utility to increase vApp security.
  • Upgrading the VMware vFabric vPostgres database from 9.0.x to 9.0.13 to address a security vulnerability.

Top of Page

Product Compatibility

Refer to the VMware Compatibility Guide for more information about VMware certified compatibility for vCenter Operations Manager: http://www.vmware.com/resources/guides.html.

The VMware vCenter Operations Manager Installation and Configuration Guide for Windows and Linux lists compatible versions of vSphere and other components that vCenter Operations Manager supports.

vCenter Operations Manager 5.7.1 supports the following browsers:
  • Apple Safari 6
  • Google Chrome 24 and 25
  • Internet Explorer for Windows 8.0 and 9.0
    Note: The Compatibility View mode must be disabled.
  • Mozilla Firefox 18 and higher
  • The minimum supported browser resolution is 1024 by 768 pixels.

Before You Begin

VMware vCenter Operations Manager version 5.7.1 is available as a standalone executable or as a vApp that you deploy with the vSphere Client.

You can install and upgrade the standalone version of vCenter Operations Manager 5.7.1 on the following operating systems:

  • Windows Server 2003 64-bit SP2 or later
  • Windows Server 2008 64-bit
  • Red Hat Enterprise Linux 5 64-bit

For system requirements, installation instructions, and configuration options for the standalone version, see the VMware vCenter Operations Manager Installation and Configuration Guide for Windows and Linux.

For information about vApp deployments, see the VMware vCenter Operations Manager Deployment and Configuration Guide.

Top of Page

Installation and Upgrade Instructions

To install the standalone version of vCenter Operations Manager 5.7.1, run the 5.7.1 installation files for your operating system. For more information, see the VMware vCenter Operations Manager Enterprise Installation and Configuration Guide for Windows and Linux.

This procedure is applicable when updating to vCenter Operations Manager 5.7.1 from the following product versions:
  • vCenter Operations Manager Enterprise 5.0, 5.0.1, 5.0.2, 5.0.3, 5.6, and 5.7, including any Hotfix versions.
You cannot directly upgrade to vCenter Operations Manager 5.7.1 from the following product versions. You must upgrade from 1.x to 5.0.x before you can upgrade to version 5.7.1.
  • vCenter Operations Manager Enterprise 1.0, 1.0.1, 1.0.2, including any Hotfix versions.
    Note: The database upgrade may fail if you have insufficient privileges. The minimum permissions and privileges required to upgrade the database are: CREATE TABLE, CREATE TRIGGER, CREATE SEQUENCE, CREATE SESSION, and CREATE PROCEDURE.
  1. Depending on the operating system, download the latest .exe or .bin file to the machine where the old product version is installed.
  2. Run the .exe or .bin file.
  3. Select the Reinstall (Upgrade) option.
  4. Select the installation mode.
    • To preserve your settings from the original installation, do not change the default setting.
    • To modify installation options, select Basic or Custom.
  5. On the Database configurations screen, do not modify any settings, and click Finish.
  6. On the main installation screen, click Done.
  7. Check the following log files under the vcenter-ops/user/log folder for upgrade issues:
    • collector.log
    • analytics.log
    • activemq.log
    • controller.log
    • wizard.log
  8. If adapters are installed on the system that you upgraded, download and install the latest adapter versions.
  9. Log in to vCenter Operations Manager (Custom UI) and verify that the user interface displays properly.

Documentation

The vCenter Operations Manager Custom UI 5.7.1 documentation set contains the following documents:

Top of Page

Resolved Issues

This section contains resolved issues for the vCenter Operations Manager 5.7.1 release.

  • vCenter Infrastructure Navigator adapter discovers too many resources
    The vCenter Infrastructure Navigator adapter was configured to discover and calculate resources related to obscure open TCP ports. This configuration increased the load on analytics processing as well as on the storage sub-system that stores this data.

    This release includes a fix to prevent the vCenter Infrastructure Navigator adapter from collecting unnecessary resources. It will continue to discover the important and named services that vCenter Infrastructure Navigator provides.
  • vCenter Operations Manager performs Dynamic Threshold calculations on resources created by vCenter Infrastructure Navigator adapters
    The vCenter Infrastructure Navigator adapter was configured to collect nightly Dynamic Threshold calculations on all vCenter Infrastructure Navigator adapter resources. This increased the time to complete the calculations. This collection is unnecessary because metrics are not published and only represent relationships.

    This release includes a fix to disable the nightly Dynamic Threshold calculations on vCenter Infrastructure Navigator adapter resources.
  • Auto Zoom To Fixed Node Size option has no effect in Advanced Health Tree widget
    Although the Auto Zoom To Fixed Node Size option is available in the Advanced Health Tree widget, this option is not supported by the Advanced Health Tree widget and has no effect.
  • Changing the Collector's name stops metric collection
    If you change the vCenter Operations Manager collector's name in Advanced configuration > Collector configuration, the collector stops metric collection and the synchronization status is empty. This problem also occurs if you rename remote collectors. View the Synchronization status in Support > Info > Collector's Info.

Known Issues

This release contains the following known problems.

General

  • vCenter Server health badge and metric profile change
    Changing the metric profile (from Balanced Profile to Full Profile or from Full Profile to Balanced) can affect the active fault score of a vCenter Server object. The fault badge score will be reset to zero (0) from a previous score although the fault alert is still active. This can directly affect the health badge of the vCenter Server object. This is specific only to the vCenter Server objects. Fault badges of other objects are not affected by profile changes.
    Workaround: To change Fault and health badge scores to their previous state, restart the collector.
  • The export to csv file fails if there is no file name specified
    If you configure the Conf.properties file to export data to csv file, and you provide the path of the file, the Repository Adapter does not create the file under the path specified in the conf.properties file.
    Workaround: Include a file name with the file path.
  • Some Custom UI widgets lose configuration settings after upgrading from 5.0 hotfix to 5.7.1
    The Size By, and Color By settings selections highlights for Heat Maps are lost after upgrading, but the Heat Map displays data for the selected options only. The selection highlighting for Metric Weather Map, and Top-N Analysis widgets is lost after upgrading, but the filtering criteria displays the selected metric.
    Workaround: Before you upgrade from 5.0, remove the widget configurations for the Heat Maps, Metric Weather Map, and Top-N Analysis widgets.

  • The feature to edit the eventlist.txt file settings is not supported in 5.x releases
    In vCenter Operations Enterprise 1.0.2, you can edit the eventlist.txt file to specify that certain events can generate alerts. This feature is documented in the vCenter Operations Administration Guide (Custom UI); however, it is not supported in vCenter Operations Manager 5.x.
    Workaround: None.
  • The CPU Load heat map is using the wrong metric to display the color
    The CPU usage heat map displays the wrong color under Heatmaps dashboard > CPU Load widget > Hosts by CPU Usage. You can edit the widget to display the correct color.
    Workaround: Complete the following steps to configure the correct color display for the CPU Load Widget.
    1. Select the CPU Load Widget and click the edit widget icon.
    2. From the Edit screen, choose the CPU Usage from the "color by" option and choose Usage (%).
    3. Click the update selected configuration icon (image of a disk).
    4. Click OK to save the configuration.
  • Custom views and reports are overwritten after upgrade
    If you upgrade to vCenter Operations Manager 5.7.1, and your custom views or reports are overwritten, it is because you are using the same view or report key as our out-of-the-box view and report key for 5.7.1.
    Workaround: To recover your version of a custom view or report, find the corresponding XML that contains your view or report definition. Change the view or report key and run the "update" command.
  • After upgrading, no metrics display in the EMC Storage Dashboard
    If you upgrade from vCenter Operations Manager 5.6.1 to 5.7.x , and have EMC VNX adapters, no metrics display in the EMC Storage Dashboard if you are using Firefox.
    Workaround: Use Chrome or Internet Explorer instead of Firefox.
  • After upgrading to 5.7.1, the Support Dashboard reports the error: 'Not all key information was found....'
    When you select Admin > Support > Info > System Tools and click the "Go to Support Dashboard" button, the following error message displays: "Not all key information was found..." This error can occur if you use remote collectors or change the name of a local collector.
    Workaround: After the upgrade, edit the widget so that all of the collectors are selected.
  • The 7-day alert, estimating storage space to fill up, might be too late
    In large setups, the rate of data accumulation is very high. If the /data disk is more than 85 percent full, vCenter Operations Manager deletes some data in order to maintain at least 15 percent free disk space.

    If your data accumulation rate is such that the disk might fill up in 7 days, vCenter Operations Manager sends you a 7-day alert message, which alerts you to add additional disk space. If you want to avoid losing data, you may want to set the alert message to a longer alert period.
    Note: The alert message is hard-coded to report "7 days." You may not actually have seven days and additional storage capacity is required as soon as possible.
    Workaround: In $ALIVE_BASE/user/conf/analytics/advanced.properties, set noOfDaysForDiskSpaceAverage=15 to receive an alert 15 days before storage space is estimated to be exhausted.
  • Adapter instance test fails if you click the Test button too soon after installing the adapter
    During adapter installation, you click the Describe icon to begin the describe process. The Collector restarts approximately two minutes after the describe process is finished (the "Describe done" status appears in the user interface). If you configure an adapter instance and click the Test button before the Collector has a chance to restart, the test fails.
    Workaround: Because the duration of the describe process can vary, wait at least 10 minutes before you click the Test button after you install an adapter.
  • After upgrading an adapter, the collector.log reports an exception error
    After upgrading an adapter on vCenter Operations Manager installations on Widows and Linux operating systems, the collector.log reports the errors:
    "java.lang.NoSuchMethodError: org.apache.http.conn.scheme.Scheme"
    "java.lang.NoClassDefFoundError: com/vmware/vim/vmomi/client/http/impl/HttpConfigurationCompiler."
    These errors are caused by old jar files that should have been deleted during the adapter upgrade.
    Workaround: Before upgrading the adapter, stop vCenter Operations Manager services, install the adapter, then start the vCenter Operations Manager services. If the duplicate jar files are not deleted, and the collector.log continues to report the errors, repeat the workaround.
  • Tomcat server does not start after upgrading to vCenter Operations Manager 5.7.1
    The Tomcat server fails to start and generates an exception similar to "SEVERE: Exception starting filter struts Unable to load configuration. - [unknown location]" This problem occurs when InstallAnywhere could not remove the old .jar files and there is a conflict between the old and new .jar files.
    Workaround: Find the conflicting struts .jar files in $ALIVE_BASE/tomcat/webapps/ROOT/WEB-INF/lib/, remove or rename the old .jar files, and restart the Tomcat server. For example, rename or remove old $ALIVE_BASE/tomcat/webapps/ROOT/WEB-INF/lib/struts2-core-2.2.1.1.jar file to resolve the conflict with a newly installed $ALIVE_BASE/tomcat/webapps/ROOT/WEB-INF/lib/struts2-core-2.3.4.1.jar file.
  • vCenter Operations Manager (Custom UI) might stop responding after an upgrade
    The vCenter Operations Manager Custom UI might stop responding about a day after an upgrade. Existing user sessions remain open, but you cannot create new login sessions. Views stop responding and data collection stops. This problem occurs because the upgrade process does not check the database deployment and table space configuration. If a third party made custom table space modifications between updates (for example, to improve performance), the upgrade can place the indexes into the wrong table space and the data table space can exceed its allocated space requirement. This problem can also occur if the default table space becomes full and no modifications are applied between updates.
    Workaround: Use one of the following workarounds, depending on the cause of the problem:
    • After the upgrade, migrate the indexes to the appropriate table space.
    • After the upgrade, revert the database to the default configuration on a larger table space.
  • Disk Space metrics collection fails after upgrading vCenter Operations Manager
    Disk Space metric collection from vCenter Storage Monitoring Service might fail after upgrading from vCenter Operations Manager version 1.0.x to version 5.6. This failure can lead to missing disk space metrics and scores for the Risk and Efficiency badges.
    Workaround: Find and remove the file vijava2120100715.jar under $ALIVE_BASE/user/plugins/inbound/vmwarevi_adapter3/lib/ and restart the collector or vCenter Operations Manager services.
  • vCenter Operations Manager (Custom UI) displays characters of high ASCII as question marks when connected to an Oracle database with the default character setting
    For example, if dashboards or resource tags that have high ASCII characters in their names, those letters appear as question marks (?).
    Workaround: Configure the Oracle database to use a Unicode character set such as UTF-8 to make characters display correctly.
  • Exception occurs when you perform a search on the Environment Overview page
    The message "Error 'Could not execute query' in the UI, and Exception in the web.log" occurs when you perform a search on the Environment Overview page in the Custom user interface. This problem is caused by a known issue in Oracle 10g.
    Workaround: For pre-11gR2 databases, set cursor sharing to 'EXACT' (the default setting). For 11gR2 and later databases, no changes are required and the problem is resolved in 11gR2 Fixpack 2 (11.2.0.2).
  • Installing vCenter Operations Manager Standalone with MS SQL in console mode on Linux fails to test the database connection
    Testing the database configuration will fail due to .RSA and .SF file inconsistencies when the configuration wizard is run from InstallAnywhere, but this failure doesn't impede the overall installation process.
    Workaround: This failure can be ignored. The installation is successful afterwards. If the user wants to test the database connection which failed during setup, the configuration wizard can be run from the bash shell using the "$HOME/Configure_VMware_vCenter_Operations -i console" command.
  • Cyclic redundancy check (CRC) errors manifest as missing data
    CRC errors appear as missing data for a given resource.
    Workaround: Check the vcenter-ops/data/vcops/log/analytics.log file to see if CRC-related errors are logged, for example:

    com.integrien.alive.FSDB.FSDBException: CRC Failure in file for Resource 6773, filename = /data/vcops/data/6/6773/2011_10_6773.dat
    2011-11-11 03:04:31,552 ERROR [Calc DT worker thread 3]
    com.integrien.analytics.datareceiver.MetricDataRetriever.getDataPointBundle - CRC Failure in file for Resource 6773, filename = /data/vcops/data/6/6773/2011_10_6773.dat

    If the log file contains CRC-related errors, set the FSDBCheckAndRepair property to 2 in the vcenter-ops/user/conf/analytics/advanced.properties file. Errors are corrected within seven days.

  • You must update the statistics of data tables periodically so that the Oracle SQL native query analyzer can operate and fetch data efficiently
    The vCenter Operations Manager Custom UI does not provide a user interface to configure database updates.
    Workaround: See Automated gathering of statistics for Oracle database tables and their indexes (KB 2016451).

Documentation

The following product changes were not described in the release documentation.
  • All and group options for dashboard commands
    For the dashboard import, dashboard delete, and dashboard reorder commands, you can use one of the following options instead of specifying a user name:
    * --all
    * --group:<group_name[,<group_name>]

    The --all option applies the command to all user accounts. The --group:<group_names[,<group_name>] option applies the command to all user accounts that belong to the specified user groups. For example, the command dashboard import group:Administrators,Operators "templates\MyDashboard.bin" imports the dashboard MyDashboard.bin to all user accounts that belong to the Administrators and Operators user groups.

    The dashboard import command also has a --set <rank> option that enables you to set the dashboard order. For example, the command dashboard import MyUser2 "dashboards/MyDashboard.bin" --set 1 imports the dashboard MyDashboard.bin and makes it the first dashboard in the dashboard list for the user MyUser2.
  • Missing information on consolidated alerts in the Custom UI documentation
    See Aggregating and Filtering Alerts in vCenter Operations Manager 5.6 (Custom UI) (KB 2039020) for details.

Top of Page