About Cisco UCS Manager Plug-In for VMware vSphere HTML Client

Cisco UCS Manager plug-in is a VMware vSphere HTML client plug-in, which enables the virtualization administrator to view, manage and monitor the Cisco UCS physical infrastructure. The plug-in provides a physical view of the UCS hardware inventory on the HTML client.

Revision History





October 10, 2022

Updated the following sections:

  • System Requirements

  • Added CSCwb93805 in Known Limitations

  • Added CSCwb59069 in Resolved Caveats

December 1, 2021

Updated with the information about Release 3.0(6)


June 17, 2021

Updated with the information about Release 3.0(5)


December 18, 2020

Updated with the information about Release 3.0(4)


April 22, 2020

Updated with the information about Release 3.0(3)


December 20, 2019

Updated with the information about Release 3.0(2)


September 24, 2018

Published release notes for Cisco UCS Manager Plug-in for VMware vSphere HTML Client

December 12, 2018

Updated with the Registration tool 1.2.2

System Requirements

Ensure that the system meets the following requirements:

VMware vSphere HTML Client Releases

Cisco UCS Manager plug-in is compatible with the following vSphere HTML Client releases:

VMware vSphere HTML Client Version

Cisco UCS Manager Plugin for VMware vSphere Version


3.0(1), 3.0(2), 3.0(3), 3.0(4), 3.0(5), 3.0(6)


3.0(4), 3.0(5), 3.0(6)

7.0u1, 7.0u2

3.0(5), 3.0(6)


3.0(5), 3.0(6)


VMware vSphere HTML Client Version 7.0u3 is supported partially.

Supported Cisco UCS Manager Releases

Cisco UCS Manager plug-in is compatible with the following UCS Manager releases:

  • Release 3.2 and later

Features of Cisco UCS Manager Plug-In

This section provides an overview of the significant features in this release. This section does not provide an exhaustive list of all enhancements included in this release.

Release 3.0(6)

Here are the new features in Release 3.0(6):

  • Custom fault addition for proactive HA monitoring

  • Resolved host not going into monitoring state vCenter restart

  • Included defect fixes

Release 3.0(5)

Here are the new features in Release 3.0(5):

  • Support for VMware vSphere HTML Client 7.0u1 and 7.0u2

  • FIPS Support for VMware vSphere HTML Client 7.0u2

  • Cisco UCS Manager plug-in accessibility from vCenter Menu

  • Included defect fix

Release 3.0(4)

Here are the new features in Release 3.0(4):

  • Support for VMware vSphere HTML Client 7.0

  • Included defect fix


Upgrading the vCenter server might result in loss of plug-in data. Back up the plug-in data before you upgrade. For more information on what you must do before upgrading the vCenter, see the topic Upgrading vCenter in the Cisco UCS Manager Plug-in for VMware vSphere HTML Client User Guide, Release 3.x .

Release 3.0(3)

Here are the new and changed features in Release 3.0(3):

  • Included defect fix

  • Added updates to the following feature:

    • User Privileges: Users with same vCenter role and who also registered on the UCS domain have the privilege to edit or unregister the plug-in.


Release 3.0.3 onwards, the plug-in is HTML-based only. Flex-based plug-in is not supported.

The earlier versions of the HTML plug-in (Releases 3.0.1 and 3.0.2) are available as beta releases in Cisco UCS Communities.

Release 3.0(2)


This release is available as a beta release in Cisco UCS Communities.

Here are the new and changed features in Release 3.0(2):

  • Included defect fixes

  • Added a new fault (F1706) to the Cisco UCS Provider failure conditions list

  • Added support for proactive High Availability for more than 100 hosts in vCenter

Release 3.0(1)


This release is available as a beta release in Cisco UCS Communities.

This release includes the HTML plug-in. All features that are in flex are now available in HTML.

Some of these features are:

  • Cisco UCS physical hierarchy view

  • Overall health of server and other infrastructure components

  • Maps UCS servers to ESX hosts

  • Inventory, installed firmware, faults, power, and temperature statistics for each server/ESX host

  • KVM launch for all ESX and non-ESX servers

  • Switch on and off locater LED and launch Cisco UCS Manager GUI for each server

  • Support for UCS Mini

  • Registration tool for registering the plug-in with the vCenter

  • Perform key actions on ESX, non-ESX servers, and other UCS components

  • View service profile, service profile templates, server pools, and host firmware packs for each UCS Domain

  • Server firmware management using host firmware pack

  • Support for VMware vSphere HTML client 6.7

  • Firmware Management for blades and rack servers in UCS domain. You can perform the following operations:

    • Upload firmware

    • Modify firmware package version for the host firmware packs with option to move the affected ESX host into maintenance mode before triggering the firmware upgrade

    • Acknowledge pending activities

    • Delete firmware package

    • Delete firmware upload task

  • View VIF paths for servers

  • Monitor UCS domain, chassis, fabric interconnect, fabric extender, ESX, and non-ESX servers

  • View faults with ability to filter based on the severity

  • Support for In-Band access with IPv4, and IPv6 addresses

  • Managing of UCS domains using IPv6 addresses

  • Enhancement to allow registered domains to be globally visible

  • Support for Proactive High Availability (HA)—The Cisco UCS Provider supports the Proactive HA feature which allows you to protect the hosts within a vCenter cluster from potential failures

Available Actions

Support for the following actions on both ESX and non-ESX servers in UCS domains:

  • Create hardware or template-based service profile

  • Associate and disassociate service profiles

  • Manage associated BIOS Policy and modify BIOS settings

  • Manage host firmware pack

  • Launch KVM

  • Launch UCSM GUI

Support for the following UCS domain actions:

  • Reload UCS Domain

  • Associate server pool to server pool templates

  • Associate host firmware pack to server pool templates

  • Create service profile from a server pool template

  • Associate host firmware pack to service profile

Enhancement to the Registration Tool, Release v1.2.0

  • Enhancement to support registration of HTML plug-in

Enhancement to the Registration Tool, Release v1.2.2

  • Enhancement to support PowerCLI 10 and higher versions

Installation and Upgrade Notes

Cisco UCS Manager Plug-in for vSphere HTML Client enables you to register and manage Cisco UCS domains. When you install Cisco UCS Manager plug-in, register UCS domains individually using UCS Manager user account. Depending on the UCS Manager user privileges you used while registering the UCS domain you can perform the actions. Also, each plug-in action supports the same privileges as Cisco UCS Manager.

For installation instructions, see Cisco UCS Manager Plug-in for VMware vSphere HTML Client User Guide, Release 3.x.

Supported Upgrade

Upgrading from flex to HTML version is not supported. For more information , see Cisco UCS Manager Plug-in for VMware vSphere HTML Client User Guide, Release 3.x.

Known Limitations

The following table lists the known limitations for the UCS Manager plug-in for VMware vSphere HTML Client

Defect ID



First Affected Release


Unable to do write operation with plug-in after upgrading vCenter to 7.0u3.

After upgrading vCenter to the version 7.0u3, perform the following steps:

  1. Using SSH, log into vCenter by using root credentials.

  2. Change the directory to

    cd /usr/lib/vmware-vsphere-ui/server/data

  3. To change the permissions, run the command: chown vsphere-ui:users ucs/

  4. If plugin files are present in ucs folder, then change the directory to

    cd /usr/lib/vmware-vsphere-ui/server/data/ucs

  5. Run the command: chown vsphere-ui:users *

  6. Restart the vSphere-ui services with the command: service-control --restart vsphere-ui

  7. Register the UCS domain.



An error message is displayed when you re-login to the HTML client after the plug-in is unregistered. This issue occurs due to the following:

  • When TLS1.0 is disabled on the vCenter

  • When the Cisco UCS Manager plug-in is unregistered while you are logged in to the HTML client

Restart the HTML Client services.


Open Bugs

The following table lists the open bugs in UCS Manager plug-in for VMware vSphere HTML Client:

Defect ID



First Affected Release


Reload option and header is not visible for UCS domain in 6.7 vCenter server. This issue is observed in 6.7 until 6.7 U2




Selecting any category of fault in domain summary page displays all categories of faults.

Select the desired category of the fault manually.



Go to Domains > chassis/rack-unit/FI > related object and then try to click the menu button. Menu drop-down list is not displayed.

Select any tab in the left pane and then click Menu.



Host Object Name label is missing. This issue affects UCS plug-in in the following vCenter Versions: 6.7, 6.7U1 and 6.7U2

To perform the actions, right-click the respective domain/chassis/server and perform the actions. For example, for actions related to blade server, go to Domain > Chassis > Related Object > Non-esxi Server > and right-click the blade server and perform actions.



Association state is not reflected in Chassis > More Objects page, but the association state is correct in the specific blade server page.

Reload UCS domain. (Go to FI > More Objects and right-click and select Reload UCS domain)



When you restart the vCenter services, the health state changes during the vCenter downtime are not visible in the Proactive HA tasks or events. So, the host status remains unknown.

Relogin to the HTML client, and relaunch the Cisco UCS plug-in to resume proactive HA.



The registered domain which is set to Visible to All Users disappear from the list if the domain is already registered as visible to none by other vCenter users.

To resolve this issue, register the domain again and set the parameter to visible to all.



When you change the vCenter credentials, the following conditions occur:

  • No notification sent to the HTML Client about the credential changes

  • The change in the health state before the update is not available in the Proactive HA tasks or event list

Relogin to the HTML Client and relaunch the Cisco UCS plug-in.


Resolved Bugs

Defect ID


First Affected in Release

Resolved in Release


In the Web UI, under UCS Providers, all the faults as the scroll option is not present and hosts are not appearing




Proactive support for custom monitoring




Script to automate password in vCenter HTML plugin for password rotation of vCenter




Cisco UCSM record not getting fetched in vCenter without launching the plugin after vCenter restart.




UCSM launch fails for 4.0.4e UCSM.




UCSM domain not visible in HTML plug-in 3.0(2).




When attempting to edit or unregister a specific registered UCS domain, the vCenter admin cannot modify the details because the admin is not registered.




When you disconnect a host, remove and add it to the cluster again, the Proactive HA provider disappears from the cluster configuration.




When attempting to use the registration tool for VMware (Cisco UCS Plugin Registration Tool 1.1.3), launching the tool will fail with the following message:

Object reference not set to an instance of an object.




UCS Plugin Registration Tool 1.2.2


Any Cisco UCS Domain that is re-registered cannot be unregistered or edited.

This issue is now resolved.



Cisco UCS Communities

Cisco UCS Communities is a platform to discuss, share, and learn about the Cisco Products and Technologies. For blogs, discussion forums and documents related to UCS integrations with partner ecosystem, visit Cisco UCS Integrations.

Related Cisco UCS Documentation

Documentation Roadmaps

For more information, you can access the related documents from the following links:

Other Documentation Resources

An ISO file containing all B and C-Series documents is available at the following URL:


From this page, click Unified Computing System (UCS) Documentation Roadmap Bundle.

The ISO file is updated after every major documentation release.

Follow Cisco UCS Docs on Twitter to receive document update notifications.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at:


Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental