VMware vCenter Operations Manager 5.7
VMware

VMware vCenter Operations Manager 5.7 Release Notes

vCenter Operations Manager 5.7 | Build 1073531

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

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.

Improved Self-Monitoring

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.

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.

Top of Page

Before You Begin

Review this section before you begin installing and configuring vCenter Operations Manager.

Virtual Appliance Deployment

Always use a VMware vSphere Client to connect to a VMware vCenter Server and deploy the vCenter Operations Manager virtual appliance through the vCenter Server. The vCenter Operations Manager virtual appliance should be deployed on an ESX/ESXi host version 4.0 or later that is managed by VMware vCenter Server 4.0 Update 2 or later.

Licensing vCenter Operations Manager 5.7

This paragraph contains important notes on vCenter Operations Manager 5.7 licensing.

  • Important License keys for vCenter Operations Management Suite 5.7 with vCenter Server 5.0 or 4.1
    The vCenter Operations Management Suite 5.7 supports a Single Suite license key to enable functionality across all the suite components. To use this Suite license key with Operations Manager and Infrastructure navigator (VIN), you must have at least one instance of vCenter Server 5.1.

    To use vCenter Operations Manager and vCenter Infrastructure navigator components with vCenter Server versions 5.0 or 4.1, obtain the compatible license keys for these products from the text file located under each of the Product downloads: For vCenter Server version 5.1, the single Suite license keys for vCenter Operations 5.7 Standard/Advanced/Enterprise is supported across all the components in the suite.
  • After you apply the license, you can wait for the license manager cache to update automatically, which occurs in twenty minute intervals. For immediate license refresh, click the Reload button on the Status tab of the Administration portal to refresh the vCenter Operations Manager license.
  • vCenter Operations Manager is licensed as an asset to the vCenter Server that it monitors. You must register vCenter Operations with a vCenter Server before you assign the 5.7 license. To register vCenter Operations Manager with a vCenter Server, open the vCenter Operations Manager Administration portal and follow the procedure described in the VMware vCenter Operations Manager Deployment and Configuration Guide.
  • All license management tasks are performed in the vSphere Client. You cannot assign licenses in the vCenter Operations Manager Administration portal. Follow the instructions from the VMware vCenter Operations Manager Deployment and Configuration Guide to assign a license.
  • You must reassign the 5.7 license each time you register vCenter Operations Manager with a vCenter Server. You create a new asset each time you register vCenter Operations Manager with a vCenter Server. Therefore, you must reassign the vCenter Operations Manager license each time you register with a vCenter Server, even if the vCenter Server has been registered before. For example, if you unregister the vCenter Operations Manager virtual appliance from a monitored vCenter Server and then register the appliance with the same vCenter Server, vCenter Operations Manager creates a new asset on this vCenter Server. However, the license remains associated with the vCenter Operations Manager asset that corresponds to the previous registration. Therefore, you must de-assign the license from the old asset and assign it to the latest created asset in order to access the vCenter Operations Manager user interface.
  • vCenter Operations Manager operates in Foundation mode if no license key or an incompatible license key is applied. Assign the license key for the edition you purchased.
  • Existing EMC licenses will not work after upgrading vCenter Operations Manager 5.6 to 5.7. If you upgrade vCenter Operations Manager 5.6 having EMC license key to 5.7, the existing EMC license key will become invalid and vCenter Operations Manager will run in Foundation mode. Apply the new EMC DLF license key supported by vCenter Operations Manager 5.7. If you apply the old license key, it will be accepted by vCenter Server but will not be considered by vCenter Operations Manager 5.7.

Top of Page

Product Compatibility and Requirements

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

vCenter Operations Manager 5.7 supports the following:
  • VMware vCenter Server 4.0 Update 2 and later, managing hosts running ESX/ESXi 4.0 and later.
  • vCenter Infrastructure Navigator 2.0
  • vCenter Configuration Manager 5.6
  • vCenter Operations Manager for View 1.5

Browser Support

vCenter Operations Manager 5.7 supports the following:
  • Apple Safari 6
  • Google Chrome 24 and 25
  • Internet Explorer for Windows 8.0 and 9.0
  • Note: There are some limitations with the Dashboards feature in the Custom user interface if Internet Explorer 8 is used.

  • Mozilla Firefox 18 and 19

The minimum supported browser resolution is 1024 by 768 pixels.

If you use the vSphere Client to connect to the vCenter Operations Manager monitoring interface, verify that a supported Internet Explorer version is installed where the vSphere Client runs.

vApp Requirements

The following section lists the computing requirements and assumptions for the vCenter Operations Manager vApp.

Balanced Profile
  • Maximum number of objects: 12K, 2.2 million metrics
  • Memory
    • Analytics VM: 21GB
    • UI VM: 26GB
  • vCPU
    • Analytics VM: 8 vCPU
    • UI VM: 8 vCPU
Full Profile
  • Maximum number of objects: 15K, 5 million metrics
  • Memory
    • Analytics VM: 63GB
    • UI VM: 26GB
  • vCPU
    • Analytics VM: 24 vCPU
    • UI VM: 16 vCPU

User Accounts

  • To register vCenter Operations Manager with a vCenter Server, you must provide the minimum set of user credentials for that vCenter Server. The minimum privileges required to register and unregister vCenter Operations Manager with a vCenter Server are Global: Licenses and Extension: Register extension, unregister extension, update extension.
  • The user account you use for collecting data with vCenter Operations Manager determines the scope and accuracy of the monitoring data.
    • vCenter Operations Manager does not require administrator privileges to collect data from a vCenter Server. However, the scope of data collected depends on the privileges of the user you assign as the Collection user on the vCenter Operations Manager Administration portal. The minimum privileges required to collect data are Global: Health and Storage Views: View.
    • vCenter Operations Manager calculates metric values based only on visibility the Collection user has to the inventory. If certain objects are not visible, the values for these objects are not taken into account when calculating metrics for their container objects.
  • The hosting vCenter Server credentials are needed to repair the vApp with broken connectivity using the vCenter Operations Manager Administration interface. The minimum privilege required for this credential is Read-only.
  • The default credentials for the Administrator user are admin/admin. To improve security, vCenter Operations Manager requires you to change these credentials during CLI registration or when you first access the vCenter Operations Manager Administration portal.
  • The default credentials for the root user on the vCenter Operations virtual appliance are root/vmware. You are prompted to change the admin and root account passwords when you first access the vCenter Operations Manager Administration portal.

Top of Page

Upgrading from a Previous Version

This section contains two sets of upgrade procedures:

Upgrade from any vCenter Operations Manager 5.x version

This procedure is applicable when updating to vCenter Operations Manager 5.7 vApp from the following product versions.
  • vCenter Operations Manager 5.0, 5.0.1, 5.0.2, 5.0.3, and 5.6, including any Hotfix versions.
Important For upgrade requirements, including important information about disk space requirements, refer to the VMware vCenter Operations Manager Deployment and Configuration Guide.

VMware recommends that you take virtual machine snapshots before you upgrade the vApp. After the upgrade is successful, delete the snapshots.

  1. Save the .pak file for the vCenter Operations Manager 5.7 build to your local storage.
  2. Log in to the Administration portal using the admin user credentials.
  3. On the Update tab, click Browse and select the .pak file that you saved to local disk.
  4. Click Update.
  5. Accept the EULA by selecting the check box and click OK.
  6. Accept and confirm the update.
  7. The update process will start, and the Administration portal page might refresh after some time and ask you to login again.
  8. Log in to the Administration portal, wait for the update to complete, and verify that the Upgrade tab indicates a successful upgrade.
    Note: You might need to refresh the browser to view the updated product version and build number.
  9. Log in to the vCenter Server that manages the license for vCenter Operations Manager, and apply the new vCenter Operations Manager 5.7 license key.
    Note: You must re-apply the new license key in the vCenter Server after the upgrade.
  10. If you do not, you will see reduced functionality in the vCenter Operations Manager interface.
  11. In the Administration portal, navigate to the Status tab and restart all services.
  12. Log in to the vSphere Client or the Custom UI to verify that the vCenter Operations Manager interface is displayed properly.

Upgrade from vCenter Operations 1.0.x or Capacity IQ 1.5.x

This procedure if applicable if you need to import data from vCenter Operations Manager 1.0.x or Capacity IQ 1.5.x.

Note: When you deploy the 5.7 vApp and log in to the Administration portal for initial configuration, you are given the option to import data from vCenter Operations 1.0.x or Capacity IQ 1.5.x. Proceeding with that option will cause data problems. You cannot upgrade directly from vCenter Operations 1.0.x and/or Capacity IQ 1.5.x to vCenter Operations Manager 5.7. You must follow the procedure described in this document.
  1. Deploy vCenter Operations Manager 5.0.3 vApp and choose to import data from vCenter Operations 1.0.x and/or CapacityIQ 1.5.1 in the first-time initialization wizard of the Administration interface.
  2. After the vCenter Operations Manager 5.0.3 finishes data import, allow the deployment to run for at least two hours.
  3. Perform an in-place upgrade to vCenter Operations Manager 5.7 using the .pak file and the procedure described in the previous section.

Top of Page

Resolved Issues

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

  • After upgrading from vCenter Operations Manager 5.0.x to 5.7, the Generic scoreboard widget reports an error
    The Generic scoreboard wizard reports the error "NumberFormatException..." after upgrading from VCenter Operations 5.0.x to 5.7.
  • Upgrading from 5.0.3 HotFix to version 5.7 overwrites consolidated-alert-definition.xml
    Upgrading from 5.0.3 Hot Fix to version 5.7 will overwrite any changes made to the consolidated-alert-definition.xml file located in /usr/lib/vmware-vcops/user/conf/analytics on the Analytics VM.
  • Japanese and Chinese characters are dropped in User Audit Report (PDF format)
    In the Custom UI, create a user or group with Japanese and Chinese character in the username or group name (by choosing Admin > Security > User Management). When you choose User Audit Report from the Admin menu and select PDF format, the Japanese and Chinese characters are dropped from the PDF report.
  • Limitations with Mozilla Firefox and Google Chrome browsers
    If you open vCenter Operations Manager from the vSphere Web Client using Mozilla Firefox or Google Chrome, there are some limitations, including the following:
    • Closing the vSphere Web Client invalidates the vCenter Operations Manager session.
    • The logout link from vCenter Operations Manager fails.
    • The Troubleshoot button fails after one attempt.
  • Connection to vCenter server is lost and cannot be re-established
    If connections to the vCenter server are lost due to a network outage or the vCenter server going down, these connections might not be reestablished. The lost connections can result in no metrics being collected after the network is restored or the vCenter server comes back up.
  • The Capacity Remaining chart on the Dashboard tab and the Capacity Remaining values on the Views tab under Planning might display very high values for virtual machine capacity
    For container objects where all virtual machines are powered-off during the view interval, the capacity remaining value is calculated based on disk space resources only. When the datastores connected to the host have large remaining capacity compared to the average of virtual disk space usage, the value for virtual machine count capacity and virtual machine count capacity remaining might grow very high.
  • Key metrics values are not displayed for Custom Groups
    When viewing the details for the Key Metrics of a Custom Group, Key Metrics do not display. Key Metrics are only computed when group members include Virtual Machines, Hosts, or Datastores.
  • Descendant equal to GROUP NAME creates a group that has only direct children members from GROUP NAME
    If you create a group and select Descendant of = GROUP NAME, the new group includes only direct children members. The new group does not include indirect children members. This behavior is different from Descendent of = HOST, CLUSTER, DATACENTER, VC, or WORLD NAME, which causes the new group to include all descendants of the object, including direct and indirect children members.
  • If all objects in groups are virtual machines, the Population Dashboard shows Capacity Remaining and Density
    Capacity Remaining and Density values are calculated based on the container objects (Host/Clusters) limits. If the group contains only virtual machines, those values do not have a meaning since there are no container objects. Groups containing only virtual machines as objects should not display information about Capacity Remaining and Density.
  • No data or a question mark (?) appears for custom group Compliance badge score on the View tab
    When viewing the Compliance Breakdown view for a custom group, no data or a question mark (?) appears rather than a compliance score. The compliance score that appears for the badge should be the aggregated compliance scores for the member objects.
  • Cannot configure Alerts widget to show only Compliance alerts
    In the Custom user interface, users have the ability to configure the Alerts widget to show alerts for specific Alert subtypes. Open the Alerts widget in edit mode and in the Filter by section click the Alert Type link. In the Risk section of the Pick Alert Type dialog box, there is no Compliance toggle to filter Compliance alerts.
  • When VCM is integrated, some panels are shown for objects to which they do not apply
    When VCM is integrated with vCenter Operations Manager, these panels appear for the following objects, yet they do not apply to those objects:
    • Virtual machines: Capacity, Density, Reclaimable waste
    • Datastores: Stress, Density
    • Groups: For groups that only contain virtual machines or datastores, the corresponding panels listed above appear.
  • 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.
    1. The getBusinessServiceConfigAsXml method returns an XML string containing business service configuration. The resource tag in the result does not contain identifiers. This is a limitation with no workaround. 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.
    2. 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.

Top of Page

Known Issues

This section contains known issues for this release.

Installation and Upgrade

  • vCenter Operations Manager Administration first boot wizard does not report incorrect password for root user and fails
    If you enter an incorrect password for the root user in vCenter Operations Manager Administration first boot wizard, the application fails to report that the password is incorrect. The wizard does not proceed to the next step and you cannot continue through the wizard until a valid root password is provided.
    Workaround: None.
  • Problems with the registration of vCenter Configuration Manager
    You cannot register a vCenter Configuration Manager if the server address contains Non-ASCII characters, and you use Windows authentication method.
    Workaround: None.
  • Change events and vCenter Operations Manager 5.7 and vCenter Configuration Manager (VCM) 5.5.x interoperability
    Change event collection from VCM in vCenter Operations Manager 5.7 does not work for VCM versions older than 5.6.
    Workaround: To ensure event collection continues unimpeded, upgrade to VCM 5.6 or contact Global Support Services to determine if your environment is eligible for the scripted fix provided in KB 2040281. For upgrade instructions, see the VCM 5.6 Installation Guide. The guide is available at https://www.vmware.com/support/pubs/vcm_pubs.html.
  • Java 7 errors are logged during installation and upgrade
    The following types of errors appear in the file updatecoordinator.log when you install or upgrade to vCenter Operations Manager 5.7:
    warning: /etc/init.d/jexec saved as /etc/init.d/jexec.rpmsave
    Unpacking JAR files... rt.jar...
    Error: Could not open input file: /usr/java/jre1.7.0_07/lib/rt.pack
    jsse.jar...
    Error: Could not open input file: /usr/java/jre1.7.0_07/lib/jsse.pack
    charsets.jar...
    Error: Could not open input file: /usr/java/jre1.7.0_07/lib/charsets.pack
    localedata.jar...
    Error: Could not open input file: /usr/java/jre1.7.0_07/lib/ext/localedata.pack
    Workaround: None, but the errors are harmless and can be disregarded.
  • Product version and build number do not appear in vCenter Operations Manager Administration portal
    After you upgrade from vCenter Operations Manager 5.0.x to 5.7, the product version and build number do not appear in the left corner of the vCenter Operations Manager Administration screen.
    Workaround: Refresh your browser to load the new version of JavaScript and make the vCenter Operations Manager Administration pages work correctly.
  • vCenter Configuration Manager registration allows you to select SQL Authentication or Windows Authentication, but VCM supports only Windows Authentication
    When registering vCenter Configuration Manager in the vCenter Operations Manager Administration Portal, you are allowed to select SQL Authentication. VCM supports Windows Authentication, not SQL Authentication.
    Workaround: When you register VCM, select Windows Authentication as the Authentication method.
  • World metrics are lost after upgrading to vCenter Operations Manager 5.7
    When you upgrade from vCenter Operations Manager from 5.0.x to 5.7, all of the historical data gathered for World before the upgrade is lost. After the upgrade, vCenter Operations Manager starts collecting new metrics for World and the calculated data is displayed.
    Workaround: None.
  • Badge scores and metrics for World object does not display after the upgrade. The "?" value displays
    After upgrading from vCenter Operations Manager 5.0.x to 5.7, badge scores and metrics for World object do not display in the vSphere user interface even though they are being collected normally. This issue occurs because some of the scores and derived metrics are re-calculated due to the change in the formulas.
    Workaround: If the information does not appear after a few hours after the upgrade, restart the vCenter Operations Manager vApp. This resets all the badge scores and metrics. Also, you can click the "?" to view information about the stressed hosts.
  • Groups created by different vCenter Servers, and monitored from the same instance of vCenter Operations Manager, display in the vSphere Client Inventory
    Adapter-based groups from all monitored vCenter Server instances are visible in the vCenter Operations Manager plugin inside the vSphere Client. If you click an adapter-based group created from another instance of vCenter Server, an error message or JavaScript error displays.
    Workaround: None.
  • vCenter Operations Manager is unable to retrieve health data from a host
    If you deploy vCenter Operations Manager and register using the vCenter Server Appliance, the Auto Deploy service is not running by default. If the service is not running, vCenter Operations Manager reports the error: "Unable to retrieve health data from https://<host>:6502//vmw/rdb/health-inf" causing Health for the vCenter Server to equal zero.
    Workaround: To enable Auto Deploy, start Auto Deploy in the vCenter Server Appliance:
    /etc/init.d/vmware-rbd-watchdog start

vApp Management

  • The FilterPluginConfEditor tool cannot be used in the vApp Custom UI
    You cannot use the FilterPluginConfEditor tool in a vCenter Operations Manager vApp installation.
    Workaround: Run FilterPluginConfEditor on a remote machine and copy the XML file to the vApp. To install FilterPluginConfEditor on a remote machine, install the JDK and copy the <VCENTER-OPS>\tools\FilterPluginConfEditor folder to the remote machine.

General

  • The option to "Update group members automatically" for Groups cannot be disabled
    When you define the membership options for a group, and select the action to "Update group members automatically" for "Edit group," the setting remains enabled. The option displays as deselected in the user interface, but remains enabled in the vCenter Operations Manager backend code.
  • vCenter Server Inventory in vCenter Operations Manager does not display in the vSphere Client.
    If the vCenter Server IP address changes, Inventory and details data for the vCenter Server may not display in the vSphere Client.
    Workaround: From the Environment Overview page, edit the resource and manually set the new IP address for the vCenter Server. After the IP address is set, no data is lost.
  • An unregistered vCenter Server appears in the vSphere Client UI as registered and collecting data
    If you unregister a vCenter Server from vCenter Operations Manager using the vCenter Operations Manager Administration portal, it is removed from the list of registered servers, but continues to display in the vSphere Client as registered and collecting data.
    Workaround: To remove the vCenter Server as registered in the vSphere Client, restart vcopsweb on the UI VM. To do this, restart the Apache Tomcat web server by entering the command as root: service vcopsweb restart
  • vCenter Operations Manager Administration fails to report vCenter Server registration in the Admin portal
    If you register a vCenter Server using the command line interface, the registration is successful; however, the newly registered vCenter Server fails to appear in vCenter Operations Manager Administration.
    Workaround: Restart vCenter Operations Manager Administration. To restart the Admin portal, log in to the UI VM console as root and run the following command: /etc/init.d/vcopsadmin restart
  • vCenter Operations Manger recognizes only one HA failover host in vCenter Server 5.0
    In vCenter Server release 5.0 and above, you can specify more than one dedicated HA failover host. HA capacity calculations can account for only one failover host when the admission control policy is set to "Specify failover hosts" in vCenter Server. If you specify multiple failover hosts, only one of them is considered.
    Workaround: None
  • Top-N Analysis widget does not respond to resource tag changes
    You cannot change the resource tag that you selected in the initial Top-N Analysis widget configuration. Although you can edit the widget configuration and select a different resource tag, the new configuration has no effect and the widget continues to show the previously selected resource tag.
    Workaround: None.
  • The total sum in legends for the custom groups does not match 100 percent
    On the Dashboard tab the sum of all groups' members percentages does not always match 100. This is caused due to rounding the fraction values. For example, if the calculated percentages are 10,5 and 89,5, they are displayed as 11 and 90, which equals 101 percent.
    Workaround: None.
  • Child dashboard information is lost during multilevel dashboard export and import operations
    If you export a parent dashboard and then import it, the parent dashboard appears in the user interface of the target instance but the child dashboard does not.
    Workaround: None.
  • OVF deployment by the vSphere Web Client is not supported with Internet Explorer
    If you use the vSphere Web Client (also known as the vSphere Next Generation Client) with Internet Explorer to deploy the vCenter Operations Manager OVF file, the wizard displays junk characters.
    Workaround: Use Firefox or Chrome instead of Internet Explorer, or deploy the OVF by using the vSphere Client.
  • After login, the vSphere user interface indicates that vCenter Operations Manager is being configured
    On a large deployment of vCenter Operations Manager, you might see the following message after you log in to the vSphere user interface: vCenter Operations Manager is being configured to work with your virtual environment. You might also see errors such as: 500. The call failed on the server. You might have initiated the service startup manually, or the service might have started because of operations such as vApp startup or a vCenter registration or unregistration activity from the Administration interface. These messages appear because the Analytics service is still initializing and the data is not available for the vSphere user interface to display.
    Workaround: On a large deployment, you might need to wait up to 20 minutes after a service startup for the Analytics service to finish initialization before you can use the vSphere user interface.
  • Setting the vApp time zone to Mexico/Sonora causes a 404 error in the vSphere user interface
    If you set the vApp time zone to Mexico/Sonora, the vSphere user interface displays a 404 error.
    Workaround: Set the time zone to Mountain Standard Time - Arizona. This time zone provides the same time as the Mexico/Sonora time zone and does not cause the 404 error.

Troubleshooting

  • vCenter Operations Manager 5.7 does not support vSphere 5.1 SSO authentication
    The 5.7 release of vCenter Operations Manager does not support authentication with Single Sign On (SSO) support, introduced in the vSphere 5.1 release. User accounts maintained using SSO will not function with vCenter Operations Manager.
    Workaround: Use the traditional authentication mechanism and user registration process (the same used previous vSphere versions).
  • Environment Overview page in the Custom UI loads slowly when it displays more than 100 resources per page
    If you set Resources Per Page to more than 100 on the List tab, the Environment Overview page in the Custom UI is slow to load.
    Workaround: Set Resources Per Page to 100.
  • ActiveMQ might fail to start because of data file corruption
    When you restart vCenter Operations Manager services, the ActiveMQ service might fail to start after stopping because its data file has been corrupted. When this problem occurs, you might see the following error in the /data/vcops/log/activemq.log file on the Analytics virtual machine: Failed to start ActiveMQ JMS Message Broker. Reason: java.io.FileNotFoundException: /data/activemq/data/kahadb/db.free (No such file or directory)
    Workaround:Delete all of the files in the /data/activemq/data/kahadb directory and start the vCenter Operations Manager services again. ActiveMQ should start.

User Interface

  • 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.
    Workaround: None
  • Inappropriate list of groups displayed in Edit dialog for Default Policy
    The list of groups in Associations section does not always display the complete set of groups for which the default policy is applied.
    To explicitly associate a group with Default Policy you must select Manage policy from the Actions drop-down menu of the group.
    Workaround: None.
  • Edit Custom Relationship widget page lets you select multiple metrics
    When you configure the Custom Relationship widget, you must map one metric type to each resource kind that you select, the Metric Selector with Resource Selection pane lets you select multiple metrics.
    Workaround: If you select more than one metric for a resource kind, the error message "You can select only one metric per badge" appears. Click OK in the message dialog box, select only one metric, and click OK to save your changes.
  • Planning views and reports do not show names for objects.
    In the CIQ adapter, planning views and reports do not show names for objects.
    Workaround:
    • Log in to the UI virtual machine as user root.
    • Run service vcopsweb restart.

      Allow 15 minutes for the name to appear in planning views.
  • The Change Default Policy Configuration link doesn't work in Germany, Japanese, and Simplified Chinese UIs
    In the View Information panel on the Views tab under the Planning tab in the vSphere UI, if you click Change Default Policy Configuration, the Edit Policy dialog box appears but you cannot edit the policy.
    Workaround: Click the Configuration link at the top right, select Default Policy from the list, and click the Edit Policy icon.
  • Normal state and unknown state population counts do not match
    The normal state and unknown state population count under Environment > Overview does not always match with the population count under All Metrics for the World object and groups.
    Workaround: For an accurate population count, refer to the All Metrics count.
  • Custom Groups do not filter data based on member objects
    Some badges and planning views do not apply to all objects. For example, the Stress badge is not applicable to datastores, and Capacity views are not applicable to virtual machines. The Custom Groups functionality does not limit the display of data to only those objects to which the data applies. As a result:
    • Question marks appear for the Stress badge when a custom group contains only datastores
    • Capacity views are listed, but empty for custom groups that contain only virtual machines.
    Workaround: None.
  • Virtual machines that do not have VMware Tools show ? for Disk Space
    Disk Space under the Time Remaining badge shows ? for virtual machines that do not have VMware Tools installed and running.
    Workaround: Install and start VMware Tools on the affected virtual machines.
  • vCenter Operations Manager vSphere user interface reports errors when accessing certain objects in the Inventory
    If you log in to the vSphere user interface of vCenter Operations Manager using your vCenter Server user credentials, you may see error messages while accessing certain objects. These objects belong to a vCenter Server instance that is not accessible and permission checks fail against those objects.
    Workaround: Log in to the vSphere UI as admin.
  • The Dashboard displays the World view after refreshing the page
    If you refresh the view of a selected object in the navigation tree, the Dashboard displays the World view instead of the view for the selected object.
    Workaround: Refresh the page a second time to view the selected object.
  • Capacity views might be mismatched
    When you switch between the Host and Clusters and Groups inventory views, capacity views such as Idle Machines and Stressed Hosts and Clusters might be mismatched around hourly boundaries. This problem is caused by a delay in data persistence between the different capacity views.
    Workaround: The mismatch is typically resolved within one to ten minutes, depending on the inventory size.
  • Capacity views do not show data for the Virtual Center or World object
    Capacity views do not show data for the Virtual Center or World object, but data appears for other objects. This problem is caused by an error in inventory data collection.
    Workaround: Restart vCenter Operations Manager. The data appears in about an hour.

  • Disk space waste for World is less than sum of disk space waste of all vCenter servers.
    Disk space waste for World (and other groups) is computed by aggregating virtual machine waste. For all other resources in the environment (vCenter server, cluster, datastore, and so on), it is computed by aggregating the datastore waste. Datastore waste accounts for template usage, which is not present in the virtual machine waste aggregation. This computation can cause the World disk space waste to show a smaller value.
    Workaround: None
  • The total number of alerts displayed do not match
    There is discrepancy in the number of alerts displayed and alert counts do not match based on the alert type and source of the alert. The reasons for this can be one of the following:
    • The label of administrative alerts is imprecise, and the alert type can confused with other kinds of alerts.
    • The alerts on the grid chart do not match because the data sources are derived from calculated metrics from objects based on relationships.
    • The number of alerts reported are from the last data point list and the accurate numbers that are stored inside the analytics cache are not yet written to the FSDB.
    Workaround: None.
  • Events are displayed inconsistently in the correlation graph
    Events can be displayed inconsistently for a given timeline in the correlation graph on the Events tab. The number of events shown in the graph might vary depending on which badge is selected. This variation can happen even if the event filter and chosen timeline are consistent while switching between badges. Workaround: This problem will resolve itself within five to ten minutes.
  • Changes in effective policies for groups are not immediately visible on the group members
    If you change the effective policy on a group, there might be a delay of about a minute before the system applies the policy to all members of the group.
    Workaround: To update the effective policy for a group member, click the Refresh button in the upper middle of the vCenter Operations Manager window. This should reflect the new effective policy if the system has already updated it.
  • Capacity pages don't load when clicking on some custom groups
    When creating new group types, the Group type name cannot belong to one of these reserved internal keywords:
    • VirtualMachine
    • HostSystem
    • ResourcePool
    • ClusterComputeResource
    • Datacenter
    • ComputeResource
    • Datastore
    • VMwareAdapter Instance
    • VCMAdapter Instance
    • VinAdapter Instance
    • ContainerAdapterInstance
    • World
    If you use these names and create a group with that type, capacity views will not load for those objects.
    Workaround: If you accidentally use one of these keywords, rename the group type of the group, and the capacity views will load.
  • The VM Health badge on the Relationships tab is in yellow or red, but the Applications Health badge is green while both badges have the same values The thresholds used for virtual machines are different from the thresholds used for Applications. Currently, the color scheme for Applications follows the thresholds set in section 2a: Infrastructure badge thresholds of the policy configuration dialog box. The Infrastructure badge thresholds apply to all object types except virtual machines and group objects.
    Workaround: None.
  • The Members List on the Scoreboard tab is not updated in real-time when you change the view in the Custom Overview pane, and the Status filter is active. If you go to the Scoreboard tab and use the STATUS FILTER to filter objects in a particular state (for example, Normal State), the Members List pane displays objects in that state for the selected View (for example, Health).If you select another View (for example, Efficiency), the Members List pane does not change to display the objects that have normal Efficiency.
    Workaround: Click the Refresh button in the upper section of the vCenter Operations Manager window.
  • The compliance badge is not available in capacity views and reports
    Metrics for the compliance badge (metric key = badge|compliance) are not available in capacity views and reports.
    Workaround: None
  • Compliance template and compliance mapping names that include the | character are incorrectly displayed If a VCM compliance template or compliance mapping includes the | character, the template names that appear in vCenter Operations Manager might be incorrect or unreadable.
    Workaround: In VCM, create or modify the compliance templates and mappings to ensure that they do not include the | character. The procedures for creating or editing compliance templates or mapping are provided in the VCM online help or the VCM Administration Guide.

vCenter Operations Manager in the vSphere Web Client

  • No data displays on the Workload widget for folder objects
    No data displays on the Workload widget for folder objects in the vSphere Web Client.
    Workaround: None.
  • Error message: The selected object does not exist in VCOps server: group-d1
    The error message The selected object does not exist in VCOps server: group-d1 might appear instead of the Health badge under any of the following circumstances.
    • If you select from the Inventory tree a vCenter server object that has no child objects attached.
      Workaround: None.
    • If you select from the Inventory tree an object that is not yet created in the vCenter Operations Manager database.
      Workaround: Wait for 5 to 10 minutes until the object is added to the database.
  • The Health tab is missing under the Monitor tab after forced registration with a vCenter Server and subsequent unregistration
    If an instance of vCenter Operations Manager is registered with a vCenter Server and you try to register a second instance of vCenter Operations Manager with the same vCenter Server, you can select whether to force the registration of the second instance. When you force the registration of the second instance, you override the access of the vCenter Operations Manager plug-in for the vSphere Web Client to the first instance of vCenter Operations Manager. If you override the connection to the first instance, and then unregister the second instance from the vCenter Server, the Health tab no longer appears in the vSphere Web Client.
    This is because when you unregister the second instance of vCenter Operations Manager from the vCenter Server, you delete the extension point that is used to visualize the Health tab. The first instance of vCenter Operations Manager cannot recover the extension point automatically. Though the first instance is still registered with vCenter Server, there is no extension point that the vCenter Operations Manager plug-in for the vSphere Web Client can use to display health data.
    Workaround:
    1. Navigate to the ExtensionManager of the vCenter Server and use the administrator credentials to log in.
      The URL format is https://<VC-IP-address>/mob/?moid=ExtensionManager&doPath=extensionList%5b%22com%2evmware%2evcops%22%5d%2eclient
      If vCenter Server is running on a virtual machine, log in as root user.
    2. Verify that the vCenter Operations Manager extension point is missing.
      Search the extension list for the following value: extensionList["com.vmware.vcops"]
    3. Update the registration with the vCenter Server on the first instance of vCenter Operations Manager.
      1. Navigate to the Administration portal of the first vCenter Operations Manager instance.
        The URL format is https://<ui-vm-IP-address>/admin/
      2. Click Update next to the vCenter Server on which the extension point is missing.
      3. Type the passwords for the registration and the collector user, and click Test Connection.
      4. Click Apply and Close.

Top of Page

Documentation

    The following product changes were not described in the release documentation.
  • 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:
    * --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.
  • Incorrect examples in topic Determining the Underused and Stressed Capacity Thresholds of the vSphere UI help
    Topic Determining the Underused and Stressed Capacity Thresholds contains examples that suggest that the % Stressed and % Underused metrics are time percentages while they are actually area percentages. Please ignore the examples in this topic.
  • 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