HP WBEM TC Document Number: P00127 Date: 1/14/2011 Version: 2.0.0 HP Software Inventory and Update Profile © Copyright 2006, 2010 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty.
CONTENTS Introduction ............................................................................................................................................. 3 1 Scope .............................................................................................................................................. 4 2 Normative References ..................................................................................................................... 4 2.1 Approved References ..........................
Introduction The information in this specification extends the functionality detailed in the following DMTF profiles: Software Inventory Profile (http://www.dmtf.org/standards/published_documents/DSP1023.pdf) Software Update Profile (http://www.dmtf.org/standards/published_documents/DSP1025.pdf) While these changes will initially be specific to HP, we would like to include some, if not all of them in the DMTF profiles in order to create a common standard.
HP Software Inventory and Update Profile 1 Scope The HP Extensions to Profiles 1023 and 1025 describes the changes and extensions to the CIM schema elements described in DMTF Profiles 1023 (Software Inventory Profile) and 1025 (Software Update Profile.) 2 Normative References The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies.
3 Profile 1023 - Software Inventory Profile Changes 3.1 Installed Software vs. Available Software The 1023 profile, Section 7.1, says that an implementation will model Installed Software, Available Software or both. HP shall support Installed Software as indicated in the profile to report on software and firmware installed on a managed element. HP shall model Available Software to report software and firmware available to install as part of an optional software repository provider.
if s1 > s2 result = 1 break else if n1 is not a number result = -1 break else result = 1 break else if n1 < n2 result = -1 break if n1 > n2 result = 1 if result = 0 and str1’s token array length < str2’s token array length result = -1 return result Notes: Possible return values: -1 str1 > str2 0 both strings are equal 1 str2 > str12 the parseint function returns the integer version of a string. If a string cannot be parsed into an integer, then it returns a value indicating that the string is not a number.
Classification Values Notes Software Bundle Support Pack BIOS/FCode System ROM Driver Graphics Driver Lights-Out Management Driver Network Driver Storage Controller Driver Storage Fiber Channel Driver System Management Firmware Blade Infrastructure Onboard Administrator Firmware Systems Management Baseboard Management Controller Firmware Lights-Out Management (iLO/Management Processor, Service Processor) Firmware Storage Controller Firmware System ROM Firmware Storage Device
3.6 Bundles Bundle SoftwareIdentities will have the Classifications[] = “Software Bundle” as defined in the CIM_SoftwareIdentity MOF.
3.8 HP 1023 Profile Use Cases 3.8.1 Bundle with InstallState set to Partial The following figure shows swbun partially installed on system1. swbun has two components, swid1 and swid2, as shown by the OrderedComponent association back to swbun. The InstallState is set to Partial to indicate a partial install of the bundle. Swid1 is installed, as shown by the InstalledSoftwareIdentity association back to system1.
Figure 2 – Collection of Bundle and Components 3.8.3 SoftwareFamily and SoftwarePath The following figure shows swid1 installed on system1. System2 hosts a Software Repository Service that contains swid2. A client application retrieving swid1 and swid2 would know that they are different versions of the same software, since both the SoftwarePath and SoftwareFamily match. 10 HP Software Inventory and Update Profile Version 2.0.
system1: ComputerSystem System2: ComputerSystem InstalledSoftwareIdentity HostedCollection swid1: SoftwareIdentity MajorVersion : 1 MinorVersion : 0 RevisionNumber : 10 BuildNumber : 20 VersionString : “1.0.10.20” IdentityInfoTypes[] :{ “HPQ:SoftwarePath”, “HPQ:SoftwareFamily”} IdentityInfoValues[] :{“C:\Program Files\hpwbem”, “HPQ:hpwmiver.
Figure 4 – Available, Installed and Not Installed SoftwareIdentities A given 1023 provider can determine and report not only what is installed on a system, but what is available to install. Example: A provider running on a managed system can be configured (this configuration is providerspecific) to point to a file share of all possible installable components.
Note that in this example the client application did not need to know about the repository of all available software. In this way, so long as the provider understood how to acquire applicable available software, the client application can install install SW/FW that’s packaged in any format. 4 1025 - Software Update Profile Changes 4.1 Determining Package Type in InstallFromURI() and InstallFromByteStream() The calls to InstallFromSoftwareIdentity() and CheckSoftwareIdentity contain a SoftwareIdentity.
5 Software Repository Service A software repository service will use sections of both the 1023 profile and the 1025 profile as indicated in the following sections. Figure 5 – SoftwareRepositoryService Class Diagram 5.1 Available Software (1023) Section 6 of the 1023 profile specifies that Available Software pertains to software available to install on managed elements in its scope.
5.2.1 HP_SoftwareRepositoryService.GetSoftwareIdentityByteStream() HP_SoftwareInstallationService.GetSoftwareIdentityByByteStream() will retrieve a bytestream of an available SoftwareIdentity from the repository. Table 4 – CIM_SoftwareRepositoryService.GetSoftwareIdentityByteStream() Method Return Values Value Description 7 Method is not supported in the implementation Table 5 – CIM_SoftwareRepositoryService.
5.2.2.2 URI The URI parameter is used to specify the URI information of the software corresponding to the SoftwareIdentity IN parameter. This shall be Null if the method returns value 2(Error Occurred.) 5.2.3 HP_SoftwareRepositoryService.GetDependenciesForSoftwareIdentity() HP_SoftwareInstallationService.GetDependenciesForSoftwareIdentity() will return an array of dependencies that must be present for the specified SoftwareIdentity to properly install. Note that this is a single level of dependencies.
5.3 Software Repository Service Use Cases 5.3.1 Hierarchical Collections Figure 6 – SoftwareRepositoryService – Hierarchical Collections Version 2.0.
5.3.2 Retrieving the Component Bytes from a Software Repository Service A client application would first get search the repository for the desired SoftwareIdentity from the Software Repository Service. If the desired SoftwareIdentity was discovered, the client application would get the reference to the SoftwareIdentity from the Software Repository Service. Then the application would use SoftwareRepositoryService.GetSoftwareIdentityByteStream(), passing in the desired reference. 5.3.
ANNEX 1 (Informative) Change Log Version Date Author Description 1.0.0a 3/2/2007 Kevin Brusky Barb Criag Peter Mellquist Initial Document 1.0.0b 3/15/2007 Kevin Brusky Changes after initial review by Barbara, Peter and Aaraj 1.0.0c 3/19/2007 Kevin Brusky Minor updates from Barbara: Add Missing Dependencies error code to Check/Install methods Returned UnspecifiedError if the InstallFromSoftwareIdentity doesn’t support uninstall Specified all new values instead of leaving them at XX.
ANNEX 1 (informative) Acknowledgments The authors wish to acknowledge the following people. Editor: • Kevin Brusky Contributors: 20 • Kevin BruskyBarbara Craig • Peter Mellquist • John Planow • Christina Shaw • Aaraj Thyagaraj HP Software Inventory and Update Profile Version 2.0.