VMware vCenter Operations Manager Installable 5.7.3 Release Notes
Last Document Update: 11 JULY 2014
Check frequently for additions and updates to these release notes.
These release notes include the following topics:
- What's New
- Before You Begin
- Product Compatibility
- Installation and Upgrade Instructions
- Resolved Issues
- Known Issues
vCenter Operations Manager 5.7.3 is the latest release of VMware's integrated operations suite, converging performance, capacity, and configuration management. This new release introduces the following enhancement.
Apache Struts Update
Updated Apache Struts to remediate several vulnerabilities:
- DoS due to small buffer size (CVE-2014-0050)
- ClassLoader ParametersInterceptor manipulation (CVE-2014-0094)
- ClassLoader ParametersInterceptor manipulation (CVE-2014-0112)
VMware vCenter Operations Manager version 5.7.3 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.3 on the following operating systems:
- Windows Server 2003 64-bit SP2 or later
- Windows Server 2003 R2
- Windows Server 2008 64-bit
- Windows Server 2008 R2
- Red Hat Enterprise Linux 5 64-bit
vCenter Operations Manager 5.7.3 supports the following database servers and versions:
- Oracle 10g Release 2
- Oracle 11g Release 2
- Microsoft SQL Server 2005 SP2 or later
- Microsoft SQL Server 2008
- Microsoft SQL Server 2008 R2
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.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.3 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.
To install the standalone version of vCenter Operations Manager 5.7.3, run the 5.7.3 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.3 from the following product versions:
- vCenter Operations Manager Enterprise 5.0, 5.0.1, 5.0.2, 5.0.3, 5.6, 5.7, 5.7.1, and 5.7.2, 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.
This section contains resolved issues for the vCenter Operations Manager 5.7.3 release.
VMs show -1 for self-health/availability score
The vCenter Infrastructure Navigator (VIN) adapter no longer fails to send data to the hosts and VMs.
Fault and Compliance Badge alert cancellation
All users with access rights to cancel alerts are able to cancel alerts.
DBCLI dashboard import deadlock
Import of a dashboard using DBCLI works correctly.
Import of dashboard using heatmap configured with instanced metrics
After importing a dashboard that has a heatmap configured with instanced metrics, navigating to the dashboard home no longer displays a JSON error.
Describe process for adapters
The describe process for adapters no longer takes a long time.
Datastore Demand Workload in View Pools dashboard
Datastore | demand metrics are no longer missing from the Balanced profile.
This release contains the following known problems.
- NoClassDefFoundError in Tomcat log
Hyperic API Adapter collection does not occur when using the standalone version of vCenter Operations Manager. NoClassDefFoundError appears in the Tomcat log. This is because two JAR files are missing from the directory $ALIVE_BASE/tomcat/webapps/HttpPostAdapter/WEB-INF/lib.
Workaround: Copy the following files from $ALIVE_BASE/common/lib to $ALIVE_BASE/tomcat/webapps/HttpPostAdapter/WEB-INF/lib and restart the web service:
- Unable to uninstall non-English language versions
When attempting to uninstall a non-English language version of vCenter Operations Manager on Windows, all selections on the uninstall menu are grey and inactive.
Workaround: Launch the installer, choose English and re-install using the installation wizard. Then uninstall normally.
- Unable to install vmware-om-adapter on Windows Standalone system
When vCenter Operations Manager is upgraded, the path to the JRE is lost. During the VMware adapter upgrade, an error message appears: "Could not find a valid Java virtual machine to load. You may need to reinstall a supported Java virtual machine."
Workaround: After upgrading vCenter Operations Manager, add '
<VCOPS_BASE>/jre/bin' to the path environment variable and run the installer. For example, add C:\vmware\vcenter-operations\jre\bin to the path environment variable.
- 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.3
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.
- 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.
- Select the CPU Load Widget and click the edit widget icon.
- From the Edit screen, choose the CPU Usage from the "color by" option and choose Usage (%).
- Click the update selected configuration icon (image of a disk).
- Click OK to save the configuration.
- Custom views and reports are overwritten after upgrade
If you upgrade to vCenter Operations Manager 5.7.3, 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.3.
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.3, 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.
- 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.
Tomcat server does not start after upgrading to vCenter Operations Manager 5.7.3
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-22.214.171.124.jar file to resolve the conflict with a newly installed $ALIVE_BASE/tomcat/webapps/ROOT/WEB-INF/lib/struts2-core-126.96.36.199.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 (188.8.131.52).
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.
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.