The CIM SMASH/Server Management API Programming Guide provides information about developing applications using the CIM SMASH/Server Management API.

VMware® provides many different APIs and SDKs for various applications and goals. This book provides information about developing management clients that use industry-standard data models. The System Management Architecture for Server Hardware (SMASH) is an industry standard for managing server hardware. This book describes the SMASH profiles implemented by VMware and contains suggestions for using the Common Information Model (CIM) classes to accomplish common use cases.

To view the current version of this book as well as all VMware API and SDK documentation, go to http://www.vmware.com/support/pubs/sdk_pubs.html.

Revision History

This book is revised with each release of the product or when necessary. A revised version can contain minor or major changes. The Revision History table summarizes the significant changes in each version of this book.

Table 1. Revision History
Revision Description
20221203 Minor cleanup.
20201006 vSphere 7.0 Update 1 release. Removed the following from the list of supported indications:
  • VMware_ConcreteJobCreation
  • VMware_ConcreteJobModification
  • VMware_ConcreteJobDeletion
20200402 Re-released for vSphere 7.0. No revisions.
20180417 Update for vSphere 6.7.
20161115 Update for vSphere 6.5. Removes support for CIM_SoftwareInstallationService.
20150312 Re-released for vSphere 6.0. No revisions.
20130912 Minor corrections only.
20120910 Updated to include information about adding CIM Provider VIBs.

Updated to include information about adjusting resource pool allocation.

20110824 Added PCI Device use cases.

Corrected Software Update use cases to match current design.

Updated product version numbers.

Corrected CIM profile version numbers.

Removed Host Hardware RAID Controller profile support from default configuration.

Revised Perl WS-Management section to bypass deprecated StubOps module.

Removed section about Rebooting the Managed Server (deprecated feature).

Revised sections about manufacturer, model, and serial number.

20100430 Added Active Directory Authentication.

Added WS-Management code sample.

Added Software Update use cases.

Corrected Software Inventory use case.

Updated version numbers for vSphere 4.1 release.

Added Software Inventory use case.

Corrected error in RAID controller illustration.

Added information on crossing namespace boundaries.

Corrected error in WS-Man Resource URI for VMware classes.

20090521 Updated product names for vSphere 4.0 release.

Added use cases for SEL, and physical memory slots.

Added namespace, ports, and XML schema information.

20080703 VMware ESX™ Server 3.5 Update 2 and ESX Server 3i version 3.5 Update 2 release.

Replaced instance diagrams with expanded versions.

Added use case for CPU core & threading model.

Added use case for fan redundancy.

Added use cases for Host Hardware RAID Controller profile.

Added appendix about troubleshooting connections.

Replaced Profile Reference appendix with a URL.

Listed indications supported.

Added ESX Server 3.5.

20080409 ESX Server 3i version 3.5 Update 1 release.

Changed title (formerly CIM SMASH API Programming Guide)

Updated URLs.

Removed List of Tables.
Added Physical Asset profile; listed properties for all profiles.

Updated ElementName of Base Server registered profile.

Added SMI-S RAID Controller profile.

Divided chapter 2 into 2 parts, and expanded introductory material.

Corrected typographical errors.

Added some illustrations.

20071210 ESX Server 3i version 3.5 release.

Intended Audience

This book is intended for software developers who create applications that need to manage VMware vSphere® server hardware with interfaces based on CIM standards.

VMware Technical Publications Glossary

VMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation, go to http://www.vmware.com/support/pubs.

Document Feedback

VMware welcomes your suggestions for improving our documentation. Send your feedback to [email protected].

Technical Support and Education Resources

The following sections describe the technical support resources available to you. To access the current versions of other VMware books, go to http://www.vmware.com/support/pubs.

Online Support

To use online support to submit technical support requests, view your product and contract information, and register your products, go to http://communities.vmware.com/community/developer.

Support Offerings

To find out how VMware support offerings can help meet your business needs, go to http://www.vmware.com/support/services.

VMware Professional Services

VMware Education Services courses offer extensive hands-on labs, case study examples, and course materials designed to be used as on-the-job reference tools. Courses are available onsite, in the classroom, and live online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides offerings to help you assess, plan, build, and manage your virtual environment. To access information about education classes, certification programs, and consulting services, go to http://www.vmware.com/services.