VMware

VMware vCenter CapacityIQ 1.5 Release Notes

VMware vCenter CapacityIQ Version 1.5 | 1 December 2010 | Build 327748

Last Document Update: 29 April 2011


These release notes describe the following topics:

What's New

CapacityIQ 1.5 includes the following new features and enhancements:

  • Storage Analytics - Adds disk space and disk I/O trending and storage analysis. The dashboard and views provide visibility into consumption of storage resources and ways to identify capacity bottlenecks. The data is optimized for vSphere and accounts for thin provisioning, I/O control, and linked clones.
  • Resource optimization - Adds storage-aware workload modeling and what if scenarios to forecast future capacity needs. CapacityIQ detects constrained and underutilized hosts and provides outlier detection and filtering capabilities for improved analytics.
  • Scheduled Reports - Adds report scheduling with email capabilities for automated delivery of capacity utilization and optimization reports.
  • Performance and scalability improvements - Improves the response time in the interface and raises the scalability limits to 6000 powered on virtual machines and 8000 registered virtual machines.
  • Virtual machine-based licensing - Supports virtual machine and CPU-based licensing. If you obtain a virtual machine-based license for CapacityIQ, install and manage the license from vCenter Server instead of the Administration Portal. You can continue to manage CPU-based licenses in the Administration Portal.

For the latest information about new features, search the CapacityIQ documentation and updated online help content in the vCenter CapacityIQ Online Library.

Top of Page

Prior Releases of VMware vCenter CapacityIQ

Features from prior releases of CapacityIQ are described in the release notes for each release. To view release notes for prior releases, click one of the following links:

Top of Page

Before You Begin

Before you install, configure, or upgrade CapacityIQ, check the requirements in the vCenter CapacityIQ Installation Guide.

Support and Scalability Guidelines

CapacityIQ 1.5 supports vCenter Server 4.0 or later versions that manage hosts running ESX Server 3.0.2 or later versions.

This release supports 1000 hosts, 6000 powered on virtual machines, and 8000 registered virtual machines. For information about vCenter Server scalability limits, see the Performance and Scalability Enhancements section of the What's New in VMware vSphere 4.1 — VMware vCenter white paper.

Licensing

CapacityIQ supports license management through vCenter Server or through the CapacityIQ Administration Portal depending on the license type and version of vCenter Server that CapacityIQ is registered to. Virtual machine-based licenses for CapacityIQ require vCenter Server 4.1 or later versions. For more information about CPU and virtual machine-based licensing, see the vCenter CapacityIQ Installation Guide.

Upgrade Guidelines

CapacityIQ supports upgrading version 1.0.x to version 1.5. If you have CapacityIQ 1.0 and vCenter Server 2.5, you must first update CapacityIQ from 1.0 to a 1.0.x version, and upgrade vCenter Server 2.5 to vCenter Server 4.0.x. You must adhere to the strict sequence of steps depending on your versions. The vCenter CapacityIQ Installation Guide and the Update release notes text box that appears during the update process in the Administration Portal describe the upgrade procedure.

New: Check the Upgrade section of Known Issues for late-breaking updates to the upgrade procedure.

CapacityIQ stops the collection of data during the upgrade process. This process can take up to two days depending on the amount of data. The progress indicator can only display a rough estimate of the completion time.

To avoid the need to start the process over, review all of the prerequisites.

  • Do not install a version of VMware Tools that is not included with CapacityIQ before the upgrade process.
  • Check that the CapacityIQ appliance has at least 3600MB of configured memory.
  • Back up the virtual appliance.
  • Avoid all operations from the user interface and command line that are not part of the upgrade process.
  • Make sure that the vCenter Server system that CapacityIQ is registered to runs during the upgrade process.
  • Close any instances of the vSphere Client that access CapacityIQ.
  • Check that Hard disk 2 has at least 20% of free space to support the upgrade.

    If you do not have enough free space, the upgrade process fails and you must start the process again. The Update release notes text box that appears during the upgrade process in the Administration Portal provides the steps to increase the disk space.

For more information about completing the upgrade process and logging back into the Administration Portal, check the vCenter CapacityIQ Installation Guide and the Update release notes text box in the interface. When you upgrade CapacityIQ, the 1.5 release removes the timeconfig command-line utility from the CapacityIQ virtual appliance. If you use the timeconfig utility before you upgrade to CapacityIQ 1.5, you can adjust time zone settings in 1.5 according to the instructions in the vCenter CapacityIQ Installation Guide.

Top of Page

Known Issues

The following known issues are grouped as follows:

Upgrade

  • New: The Update release notes text box that appears during the update process in the Administration Portal is missing a step in the procedure to increase the partition size.

    Workaround: In the upgrade procedure to increase the partition size, add the (parted) rm 1 command.

    # export http_proxy=<your_company_proxy:port>
    # yum install parted
    # service ciq stop
    # service ciqadmin stop
    # service postgresql stop
    # umount /data
    # parted /dev/sdb
    # (parted) print
    # (parted) rm 1
    # (parted) mkpart primary 512B 268435456000B
    # (parted) quit
    # resize2fs -f /dev/sdb1
    # mount /dev/sdb1 /data
    # service postgresql start
    # service ciqadmin start
    # service ciq start

  • When you update CapacityIQ, data might not appear immediately in the views.

    Workaround: Wait two to three hours for CapacityIQ to process the data for new metrics.

  • If you cancel the upgrade process when the EULA or the Update release notes text box appears, the status on the Update tab in the Administration Portal appears empty.

    Workaround: Log out of the Administration Portal and log back in to the portal to restart the upgrade process.

  • When you complete the CapacityIQ upgrade process and the Administration Portal login page appears, the page might display an incorrect message about data migration in progress.

    Workaround: Ignore the message and log in to the Administration Portal. The message might appear when you migrate a small amount of data.

  • If you apply an update using the ciq-admin command-line interface, the build number in the Administration Portal header might not match the build number on the Status tab.

    Workaround: Press F5 to refresh the Administration Portal. When the Administration Portal logs you out, you can log in to the portal.

Licensing

  • New: A virtual machine-based evaluation license for CapacityIQ that expires fails to trigger an alarm in vCenter Server.

Permissions

  • Changes to roles and permissions for a user in the vSphere Client might result in a mismatched view of objects between the vSphere Client inventory panel and the CapacityIQ inventory panel.

    Workaround: Press F5 to refresh the Capacity IQ client view.

Documentation

  • New: The registration process in the vCenter CapacityIQ Installation Guide does not include the View storage views privilege as a required privilege.

    Registering CapacityIQ with a vCenter Server system requires all of these privileges:

    • View storage views privilege
    • Manage custom attributes global privilege
    • Set custom attribute global privilege
    • Licenses global privilege
    • Register extension extension privilege
    • Unregister extension extension privilege
    • Update extension extension privilege
  • New: The prerequisites in the Deploy the Virtual Appliance and Deploy the Virtual Appliance with Thin Disks in vSphere 4.0 sections of the vCenter CapacityIQ Installation Guide require clarification of the supported ESX host versions.

    The prerequisites of the Deploy the Virtual Appliance procedure do not clarify that deploying CapacityIQ with thin disks involves either using vCenter Server 4.1 with ESX hosts version 3.5 or later or seeing the Deploy the Virtual Appliance with Thin Disks in vSphere 4.0 section of the installation guide.

    The prerequisites of the Deploy the Virtual Appliance with Thin Disks in vSphere 4.0 include an inaccurate requirement of ESX host version 4.0. You can use an ESX host version 3.5 with VMFS 3 or a later version of the datastore.

  • New: The CapacityIQ documentation does not clarify that CapacityIQ does not account for RDM disks in disk space capacity metrics and provisioned disk space metrics.

  • New: The CapacityIQ online help and online library describe conditions, such as dependencies on ESX and vCenter Server versions, that trigger dashes in views. The documentation does not clarify that the VM Disk Space Provisioned metric requires vCenter Server 4.0 Update 1 or later. The online library notes that this metric affects the Virtual Machine Capacity Usage - Trend view and the Cluster or Host Capacity Usage - Trend view.

  • The CapacityIQ online help does not clarify that outliers appear as hollow circles in the views. The vCenter CapacityIQ Online Library includes this information.

Time

  • CapacityIQ takes an hour or two to display information associated with the following events in the user interface:
    • CapacityIQ might take up to two hours after a new host is added to vCenter Server for the host to account for the addition in capacity estimates.
    • After installation, it takes 40 minutes or more for inventory information to appear in the user interface.
  • If you make changes in a cluster, such as moving a host out of the cluster and moving it back, and you create a what-if scenario, it might take two or three hours for the changes to appear in the what-if scenario.
  • If a dashboard or view is open for more than an hour, the information might become outdated.

    Workaround: Click the selected object in the inventory panel to get the latest data.

  • When you create, delete, or make other updates to inventory objects, the inventory tree does not show the changes even after five minutes.

    Workaround: Wait for an hour to see if CapacityIQ syncs the inventory again with vCenter Server. If CapacityIQ cannot receive updates from vCenter Server, CapacityIQ takes one hour to detect this problem and to initiate the synchronization process.

  • When the vCenter Server is down, the License or Status tabs in CapacityIQ might take some time to update information.

System Load

  • When CapacityIQ experiences a severe load on the system, an error message might appear about the connection with the vCenter Server system even when the connection exists.

    Workaround: Right-click the page and select Refresh. If the refresh operation does not resolve the issue, adjust the load on the system.

Metrics

  • The calculation of days remaining does not honor the Capacity Forecast Method in the Capacity and Time Remaining global settings.
  • When you select a virtual machine in the inventory panel, and you select Perspective > Remaining in the dashboard, the Total VM Disk Space Remaining metric shows negative numbers instead of zero. For general information about what negative values for remaining capacity counts represent and the resource dimensions that determine the remaining host, cluster, and virtual machine counts, see the vCenter CapacityIQ Online Library.
  • In the Virtual Machine Capacity - Summary view, the value of the Host Usage % column for disk I/O rows might be greater than the value in the Total Usage % column even though the total disk space and disk I/O are typically larger than or equal to the disk space and disk I/O of the host.

    An exception for disk I/O can occur because of the statistics that CapacityIQ collects. The total usage is based on a datastore metric that accounts only for I/O to the VMFS partitions. The host usage is based on a disk-based metric that accounts for both VMFS and non-VMFS partitions that often exist on local datastores.
  • Updated: In the Undersized Virtual Machines - List view, a virtual machine without a guest operating system might appear with 100 percent memory utilization.

    CapacityIQ calculates memory demand to include an estimated buffer for memory that is reserved by operating systems and that cannot be swapped out regardless of access frequency. If you do not install a guest operating system, CapacityIQ overestimates memory demand. The memory appears undersized in the Undersized Virtual Machines - List view because of this calculation.

    Workaround: For virtual machines without guest operating systems, ignore the undersized status generated by the memory demand calculation.

  • CapacityIQ metrics assume that orphaned virtual machines are powered off virtual machines.
  • The data in the pie chart on the Common Virtual Machine Configurations - Distribution view might not appear properly if you change the Capacity Calculation Rules setting in the Usable Capacity global settings. The default Capacity Calculation Rules setting is Use last known capacity per interval. If you change the setting to Use average capacity per interval, the pie chart might exclude some data. The information that does appear includes the counts of the unique virtual machine configurations observed within the analysis period, rather than the average or last known configurations.
  • In the Virtual Machine Capacity Usage - Trend view, the CPU Limit trending line can show a greater value than the Configured CPU trending line.

    This information might seem inaccurate, but the CPU limit can be higher than the configured CPU. CapacityIQ calculates configured CPU as vCPU count x host CPU speed per core.

  • Numbers for memory consumed are slightly higher than the numbers reported by vCenter Server. On the dashboard and on the Virtual Machine Capacity Usage - Trend view of a virtual machine, the numbers of memory consumed are slightly higher than the numbers reported by vCenter Server. This occurs because CapacityIQ adds ESX memory overhead to the consumed memory number for the virtual machine.

    This issue affects the following pages and metrics:

    • Dashboard
      • VM Memory Consumed - This number is slightly higher because CapacityIQ adds ESX memory overhead.
      • Total VM Memory Remaining - This number is slightly lower because CapacityIQ subtracts ESX memory overhead.
    • Virtual Machine Capacity Usage - Trend view
      • VM Memory Consumed - This number is slightly higher because CapacityIQ adds ESX memory overhead.

Browser Security

  • When you try to open CapacityIQ on a Windows Server operating system, you see an authorization error in the vSphere Client that blocks you from viewing the page.

    Workaround: Open Add or Remove Programs in the control panel, click Add/Remove Windows Components, and remove Internet Explorer Enhanced Security Configuration.
    This workaround is specific to Windows Server operating systems, such as Windows Server 2003, and does not apply to other Windows operating systems, such as Windows XP or Windows 7.

    If you continue to see the authorization error, update the internet security settings.

    1. In the control panel, select Internet Options.

      This opens the Internet Properties dialog box.
    2. On the Security tab, click Trusted sites, click Sites, and add the CapacityIQ URL to the trusted zone.
    3. For that zone, click Custom Level to update security settings.
    4. Under the Miscellaneous settings, select Enable for the Allow META REFRESH setting.
    5. Under the Scripting settings, select Enable for the Active scripting setting.
    6. Click OK.
    7. Restart the vSphere Client.
  • The CapacityIQ plug-in does not load properly in the vSphere Client.

    Workaround: If you have high security settings in Internet Explorer, select Tools > Internet Options, select the Security tab, and lower the security settings for untrusted servers.

User Interface

  • New: The Capacity Overview report does not show units for cpu, memory, I/O, and other resources in the Trend and Forecast graphs.
  • The dashboard and views display dashes.

    Workaround: Because dashes might stem from a number of possible causes, check the vCenter CapacityIQ Online Library for information about the conditions that trigger dashes and the affected views. Some storage metrics are unavailable because of ESX or vCenter Server version limitations. Disk I/O usage and datastore disk I/O capacity metrics are available with only ESX 4.1 hosts. Even if you have a vSphere 4.1 environment, you cannot view NFS and iSCSI datastore metrics for hosts with ESX 4.0 or earlier versions. Datastore space and host disk I/O usage metrics are available with ESX 4.0 or earlier versions. The VM Disk Space Provisioned metric requires vCenter Server 4.0 Update 1 or later.

  • When you expand a cluster with thousands of child objects in the inventory panel, you might not see the child objects immediately.

    Workaround: Because the environment requires more time to process the number of objects, wait for a few minutes and expand the node again.

  • When you register CapacityIQ to a vCenter Server system that becomes permanently inaccessible, unregistering CapacityIQ through the Administration Portal generates an error and blocks the ability to register another vCenter Server system.

    Workaround: Open the CapacityIQ virtual appliance console and type ciq-admin register --vc-server <vCenter_Server_name> --user <vCenter_Server_user_name> --password <vCenter_Server_password> --force from the command line.

    To see more options for the ciq-admin command, type ciq-admin register help.

  • When you enable Fault Tolerance (FT) on a virtual machine, the primary and secondary virtual machines appear with the same name in the navigation tree.
  • When you remove a host or virtual machine, the data that CapacityIQ collects before the removal cannot be reconciled with the data that CapacityIQ collects after you add the host or virtual machine back to the datacenter.

    Workaround: Disconnect and reconnect the virtual machine or host.

  • On the Virtual Machine Capacity - Summary view, you might see values, such as Time Remaining > 1 year, even when the Total Capacity, Deployed, and Remaining values are null.

    This occurs only within the first two hours after the addition of an object.

  • Trend views might mishandle the display of information on the view page. If you use a computer with the screen resolution set smaller than 1024 x 768, the text string that appears below the Data Window bar might be truncated.

    Workaround: Change the screen resolution to a higher resolution when working with trend views.

  • What-if analysis cannot occur on a new standalone host that the vSphere Client is still adding to the inventory.

    Workaround: Links for applying what-if scenarios to the host, either in the dashboard or in views, do not appear until an hour or two after the host is added to the vSphere Client.

  • If CapacityIQ performs a shutdown that is not initiated through the ciq-admin command-line interface, the Administration Portal might not indicate that the connection status is disconnected.

    Workaround: Restart CapacityIQ and check the status.

  • When you select objects in the inventory panel, the objects might inaccurately appear to have child objects.

    The following object types might display this issue:

    • Hosts and clusters with only folders
    • A datacenter with only folders
    • A cluster with only resource pools
    • A host with only resource pools
  • If you create an empty folder under All Datacenters, and attempt to expand All Datacenters in Capacity IQ, you see a Loading... indicator.

    Workaround: Press F5 to refresh CapacityIQ.

  • On some CapacityIQ pages, the client shows an Error loading view message. CapacityIQ uses an Internet Explorer browser control for rendering its pages. This message might appear after upgrading CapacityIQ and the Internet Explorer cache is full.

    Workaround: Clear the Internet Explorer cache. See Microsoft knowledge base article 260897 for instructions. If the problem persists after clearing the cache, contact VMware technical support.

  • The wrong start time appears in the slider if you select a different time zone for the interval range start date. If the current time is Standard Time (non-Daylight Savings Time), and you select Daylight Savings Time for the interval range start date, the slider displays the wrong start time (non-Daylight Savings Time) when CapacityIQ reloads the data. The correct requested interval range appears in the view, but not in the slider. The start time appears as one interval before the actual requested start date.

    Workaround: Set the start date to the correct date before updating the interval range for the view.

For more information about known issues with CapacityIQ, see the VMware Knowledge Base.

Top of Page

Resolved Issues

The following resolved issues are grouped as follows:

Documentation

  • The Register CapacityIQ and the Grant Access to CapacityIQ sections of the vCenter CapacityIQ Installation Guide do not provide complete information on the roles and privileges required to set up CapacityIQ.

    Before you register CapacityIQ during the installation process, prepare and assign the CIQ_ADMIN role to the user who registers CapacityIQ. Because this process involves assigning permissions at the root vCenter Server folder level and propagating them to child objects in the inventory tree, the user cannot have conflicting permissions that are set outside of this process that block access to any objects.

    To prepare and assign the CIQ_ADMIN role:

    1. In the vSphere Client, create a role, such as CIQ_ADMIN, and assign the Manage custom attributes, Set custom attribute, and Licenses global privileges, and the Register extension, Unregister extension, and Update extension extension privileges.
    2. Right-click the root vCenter Server folder in the inventory tree and select Add Permission.
    3. In the Assign Permissions dialog box, assign the CIQ_ADMIN role to the user who is registering CapacityIQ and propagate the privileges to child objects.

    When you register CapacityIQ and type the user name and password for the vCenter Server system, the credentials must give you the privileges associated with the CIQ_ADMIN role.

    Before you grant access to CapacityIQ, the virtual appliance generates a CapacityIQ global privilege in the vSphere Client during an earlier phase of the configuration process.

    To grant access to CapacityIQ:

    1. Restart the vSphere Client.
    2. Add the CapacityIQ privilege to an existing role that is already assigned to a user or create a new role with the privilege and assign the role to a user.
    3. Right-click the root vCenter Server folder in the inventory tree and select Add Permission.
    4. In the Assign Permissions dialog box, assign the necessary role to the user who is accessing CapacityIQ.

    The CapacityIQ documentation will include this information in the next release. For more information about creating roles and assigning users to roles, see the VMware vSphere documentation.

Time

  • If you select the CapacityIQ virtual appliance in the inventory and navigate to the Console tab to configure time zone settings, you must restart CapacityIQ at the end of the process. To restart CapacityIQ, log in to the Status tab of the Administration Portal and click Restart.

    The CapacityIQ documentation will include this information in the next release.

  • Rendering time for certain views might be slow.

    This might happen when you select a cluster in the inventory panel, or when the selected object contains over 500 virtual machines. In these cases, the following views can take up to a minute to render in the user interface:

    • Powered-Off Virtual Machines - List
    • Idle Virtual Machines - List
    • Oversized Virtual Machines - List

    These views are available in report form on the Reports tab. CapacityIQ can start and process these reports in the background.

Upgrade

  • If you update CapacityIQ and log in to Setup tab of the Administration Portal, the values of the registration status and vCenter Server address might fail to appear or appear as unknown.

    Workaround: Refresh the browser page to update the information.

  • If you update CapacityIQ, the Plug-in Manager in the vSphere Client does not display the latest version and build number. The Plug-in Manager continues to display the older version of CapacityIQ.

    Workaround: To display the update data, unregister CapacityIQ in the Administration Portal and reregister it to the same vCenter Server system.

System Load

  • When CapacityIQ experiences a heavy system load or high network latency, inventory objects for CapacityIQ might appear multiple times in the navigation tree.

    Workaround: Right-click the page and select Refresh.

  • When a cluster has 400 virtual machines or more, an Internet Explorer warning might appear when you expand the cluster. The warning asks you if you want to abort the running script.

    Workaround: Click No to run the script.

Metrics

  • When you select the table format for the Capacity Efficiency - Trend view, the value in the Average Powered-On Hosts column shows a powered-on host count that is based on the current snapshot rather than the correct average of powered-on hosts in a selected timeframe.

    Workaround: If the Capacity and Trend Analysis global settings page shows the Use last known capacity per interval rule in use, change the rule to Use average capacity per interval.

User Interface

  • If you select Combine Scenarios or Compare Scenarios while a what-if scenario is applied, CapacityIQ does not apply the scenario to the view.

    Workaround: Wait for the scenario application to complete before you select the options.

  • When you apply a what-if scenario with CPU and memory utilization values that include decimal points, CapacityIQ does not round the values to whole numbers.

    Workaround: Use whole numbers for CPU and memory utilization values.

Top of Page