VMware vCenter Operations Manager Installable 5.7 Release Notes
VMware vCenter Operations Manager 5.7 | Build 1061805
Last Document Update: 30 APRIL 2013
Check frequently for additions and updates to these release notes.
These release notes include the following topics:
- What's New
- Product Compatibility
- Before You Begin
- Installation and Upgrade Instructions
- Resolved Issues
- Known Issues
vCenter Operations Manager 5.7 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.
More Flexibility with Capacity Planning
- Assess capacity risk and plan by allocation and/or actual demand: Set policies based on your varying business needs to assess capacity risk, efficiency, and forecast. For example, different buffers, over-commit ratios, alert thresholds, business hours, etc., across production and test-dev environments.
- New views for Cluster Capacity Risk: Quickly identify via color-coded Cluster capacity risk view which clusters grouped by business criteria, etc., are at capacity risk—facing a capacity shortfall now or in the near future or just not sized right. Drill down for each cluster in the Cluster Risk Detail view to analyze which resource is it constrained on and why.
- New policies for common environments and workloads: New out-of-the-box policies, such as Production and Test-Dev policies, enable quick set-up of vCenter Operations Manager capacity settings for common types of environments. Additional new out-of-the-box policies, such as Batch workload, Interactive workload, and Ignore VMs policies, help fine-tune capacity configuration settings to accurately right size and analyze different workloads based on their performance characteristics.
This release introduces new diagnostics metrics to monitor the health and availability of vCenter Operations Manager components, such as Analytics, Collector, ActiveMQ, Web server, database, and operating system.
Widgets with Improved Flexibility and Usability
- Health Tree Widget: Easy visualization for large number of objects.
- Generic Scoreboard Widget: Support for Sparkline, string metrics, and metrics filtering by resource.
- Metric Sparkline Widget: Configurable color ranges and units, support for resource type and label.
- Resource Widget: Customizable to add metrics beyond health.
- Top-N Analysis Widget: Support for analysis based on latest values.
New Custom Relationship Widget
Allows you to build a custom resource hierarchy and relationship view, just like the existing out-of-the-box vCenter Server view.
Custom UI Import and Export Changes for Dashboards and Super Metrics
- Export format changed from binary (.bin) to XML (.xml): .bin formats are still supported for backward compatibility.
- DBCLI Enhancements: Programmatically import and export Super Metrics.
- Pre-population of Dashboard objects during import.
Balanced Metrics Profile
This release introduces a new metrics profile that reports a reduced set of metrics. Increase the scalability of vCenter Operations Manager to support more resources by changing the metrics profile to the new "Balanced" profile in vCenter Operations Manager Administration.
VMware vCenter Infrastructure Navigator Filtering Capability
You can configure how resources discovered by vCenter Infrastructure Navigator are displayed in vCenter Operations Manager. This release introduces a configurable filtering capability to the vCenter Infrastructure Navigator adapter to control Application service and Application resource reporting. For each resource type, you can configure either "blackList" or "whiteList" filtering in the configuration file filterList.txt.
- blackList: The vCenter Infrastructure Navigator adapter ignores specified entries. If an Application Service name or an Application name is included in the "blackList," it is not reported by the vCenter Infrastructure Navigator adapter. This is the default setting. The vCenter Infrastructure Navigator adapter filters unknown Application service names by default.
- whiteList: The vCenter Infrastructure Navigator adapter reports only the specified entries. If there are no entries added to the whiteList mode, none of the resources of the corresponding resource type are displayed.
New Browser Support
This release adds new support for the following browsers: Apple Safari version 6, Google Chrome versions 24 and 25, and Mozilla Firefox 18 and 19.
This release includes additional security hardening and increases compliance with The Defense Information Systems Agency (DISA) and The Security Technical Implementation Guides (STIG) guidelines.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 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 19
The minimum supported browser resolution is 1024 by 768 pixels.
VMware vCenter Operations Manager version 5.7 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 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.
To install the standalone version of vCenter Operations Manager 5.7, run the 5.7 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 from the following product versions:
- vCenter Operations Manager Enterprise 5.0, 5.0.1, 5.0.2, 5.0.3, and 5.6, including any Hotfix versions.
- 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.
- Depending on the operating system, download the latest .exe or .bin file to the machine where the old product version is installed.
- Run the .exe or .bin file.
- Select the Reinstall (Upgrade) option.
- 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.
- On the Database configurations screen, do not modify any settings, and click Finish.
- On the main installation screen, click Done.
- Check the following log files under the vcenter-ops/user/log folder for upgrade issues:
- If adapters are installed on the system that you upgraded, download and install the latest adapter versions.
- Log in to vCenter Operations Manager (Custom UI) and verify that the user interface displays properly.
- VMware vCenter Operations Manager Installation and Configuration Guide for Windows and Linux
- VMware vCenter Operations Manager Getting Started Guide (Custom UI)
- VMware vCenter Operations Manager Administration Guide (Custom UI)
- VMware vCenter Operations Manager Custom UI online help
This section contains resolved issues for the vCenter Operations Manager 5.7 release.
- The result of getBusinessServiceConfigAsXml does not contain resource identifiers
This might cause problems interpreting the result of the API call since resources might not be uniquely identified.
- The getBusinessServiceConfigAsXml method returns an XML string containing business service configuration. The resource tag in the result does not contain identifiers. As a result, the XML received from getBusinessServiceConfig call posted to the configBusinessService method might not produce the same result, as configBusinessService now requires identifiers to be present.
- The background issue is that in 5.6 configBusinessService was fixed to take into account resource identifiers. This behavior is consistent with the product logic and documentation. It might brake existing client applications that used to call the API in a different way. Before the fix, the API method only used resource name for identification and could produce inaccurate results by adding all resources with a matching name into specified tiers.
This release contains the following known problems.
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% full, vCenter Operations Manager deletes some data in order to maintain at least 15% free disk space. If your data disk reaches 85 percent, 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:
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.
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.
Workaround: Do not rename the collector.
Tomcat server does not start after upgrading to vCenter Operations Manager 5.7
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-220.127.116.11.jar file to resolve the conflict with a newly installed $ALIVE_BASE/tomcat/webapps/ROOT/WEB-INF/lib/struts2-core-18.104.22.168.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.
- 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.
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 (22.214.171.124).
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).
DocumentationThe following product changes were not described in the release documentation.
VMWARE-VCOPS-EVENT-MIB.mib file changed
The VMWARE-VCOPS-EVENT_MIB.mib file contains information that the receiving party needs to interpret the SNMP traps that vCenter Operations Manager (Custom UI) sends. The Object Identifier (OID) for vCenter Operations Manager (Custom UI) is changed from 19004 to 6876 in this MIB file.
New menu next to Search on Environment Overview page
A new drop-down menu has been added next to the Search text box on the Environment Overview page in the Custom user interface. You can use this drop-down menu to select a column name and search by column, or you can select All to search all columns. For example, you can select Name to search the Name column.
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:
* --allThe --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.