Power Utilization Management Profile Document Number: DCIM1004 Document Type: Specification Document Status: Published Document Language: E Date: 2008-11-10 Version: 1.0.
Power Utilization Management Profile THIS PROFILE IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL ERRORS AND TECHNICAL INACCURACIES. THE CONTENT IS PROVIDED AS IS, WITHOUT EXPRESS OR IMPLIED WARRANTIES OF ANY KIND. ABSENT A SEPERATE AGREEMENT BETWEEN YOU AND DELL™ WITH REGARD TO FEEDBACK TO DELL ON THIS PROFILE SPECIFICATION, YOU AGREE ANY FEEDBACK YOU PROVIDE TO DELL REGARDING THIS PROFILE SPECIFICATION WILL BE OWNED AND CAN BE FREELY USED BY DELL. © 2008 Dell Inc. All rights reserved.
Power Utilization Management Profile Version 1.0.
Power Utilization Management Profile CONTENTS Foreword ....................................................................................................................................................... 7 Introduction ................................................................................................................................................... 8 1 Scope ...................................................................................................................................
Power Utilization Management Profile 10 CIM Elements ...................................................................................................................................... 27 10.1 CIM_AllocationCapabilities ....................................................................................................... 28 10.2 CIM_ElementCapabilities (CIM_AllocationCapabilities) ........................................................... 29 10.
Power Utilization Management Profile Figures Figure 1 – Power Utilization Management Profile: Class Diagram ............................................................. 12 Figure 2 – Power Utilization Management Profile: Profile Registration ...................................................... 22 Figure 3 – Power Utilization Management Profile: Before RequestPowerUtilizationAlgorithm() ................ 23 Figure 4 – Power Utilization Management Profile: After RequestPowerUtilizationAlgorithm() .........
Power Utilization Management Profile Foreword The Power Utilization Management Profile (DCIM1004) was prepared by the Dell CIM Review Board. Version 1.0.
Power Utilization Management Profile Introduction This specification identifies the necessary classes, properties, methods, and values to be instantiated and manipulated to represent and manage power utilization modeled using the DMTF Common Information Model (CIM) core and extended model definitions. This document is intended for implementers who write CIM-based providers or consumers of management interfaces representing the component described herein. 8 Version 1.0.
Power Utilization Management Profile Power Utilization Management Profile 1 Scope The Power Utilization Management Profile extends the management capabilities of referencing profiles by adding the capability to represent the different power utilization levels by the managed elements. The profile also provides information on the client configuration of the power utilization and profile versioning for the schema implementation.
Power Utilization Management Profile 3.4 mandatory indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted 3.5 may indicates a course of action permissible within the limits of the document 3.6 need not indicates a course of action permissible within the limits of the document 3.7 optional indicates a course of action permissible within the limits of the document 3.
Power Utilization Management Profile Organization: DCIM CIM Schema Version: 2.18 Dell CIM Schema Version: 1.0.0 Central Class: DCIM_OEMPowerUtilizationManagementService Scoping Class: CIM_ComputerSystem The Power Utilization Management Profile extends the management capability of the referencing profiles by adding the capability to describe and manage power utilization of the managed system. The Central Instance shall be associated with the Scoping Instance through CIM_HostedService association.
Power Utilization Management Profile EnabledLogicalElementCapabilities PowerUtilizationManagementService DCIM_OEMPowerUtilizationManagementCapabilities 1 ElementCapabilities 1..* 1..* 1..* DCIM_OEMPowerUtilizationManagementService 1 HostedService 1 ServiceAffectsElement 1 1 ComputerSystem1 1 (See Referencing Profile) 1 ElementSettingData ServiceAffectsElement * SettingDefineState DCIM_OEMPowerUtilizationCustomSettingData AllocationCapbilities 0..
Power Utilization Management Profile 6.1.2 Dynamic Power Utilization Dynamic power utilization mode enables a system to utilize proactive algorithms to adjust its power consumption. Such a mode is useful to balance power consumption with the system’s performance.
Power Utilization Management Profile The power utilization mode shall be represented by the PowerUtilizationMode, PowerUtilizationAlgorithm and PendingPowerUtilizationAlgorithm properties, and shall contain current and pending power algorithms of the impacted system respectively. The power utilization mode may also be managed through granular custom settings. The instance of DCIM_OEMPowerUtilizationCustomSettingData shall represent the custom settings of the power utilization mode.
Power Utilization Management Profile 7.4.1 Maximum Power Consumption Level If the CIM_PowerAllocationSettingData instance represents the maximum power consumption level for the managed system, then the referenced CIM_SettingsDefineCapabilities association’s ValueRange property shall have 2 (Maximums) value. The Limit property of the CIM_PowerAllocationSettingData instance shall represent the maximum power consumption level for the managed system in the units defined in the AllocationUnits property.
Power Utilization Management Profile Table 3 – DCIM_OEMPowerUtilizationManagementService.RequestPowerUtilizationAlgorithmEI() Method: Parameters Qualifiers Name Type Description/Values IN, REQ RequestedAlgorithm uint16 Requested power utilization algorithm IN CustomSettings String An embedded instance of DCIM_OEMPowerUtilizationCustomSetti ngData that represents the requested custom settings OUT Job CIM_ConcreteJob REF Returned if job started 8.1.1 DCIM_OEMPowerUtilizationManagementService.
Power Utilization Management Profile Table 5 – DCIM_OEMPowerUtilizationManagementService.RequestPowerUtilizationLimits( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ RequestedAlgorithm uint16 The scoping managed system for the power redundancy configuration. IN CustomSettingNames[] string Array of custom setting names having the same name as DCIM_OEMPowerUtilizationCustomSetti ngData properties.
Power Utilization Management Profile Table 7 – DCIM_OEMPowerUtilizationManagementService.RequestPowerUtilizationLimits( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ EnforceUtilizationLimit boolean Enforces the budget limit for the managed system IN UtilizationLimit uint16 The budget limit for the managed system IN UtilizationLimitUnit string The units of budget limit. IN UtilizingElement CIM_PowerAllocatio nSettingData REF The power aspect of the managed system.
Power Utilization Management Profile 8.6 CIM_ElementCapabilities (CIM_AllocationCapabilities) Table 8 lists operations that either have special requirements beyond those from DSP0200, or shall not be supported. Table 8 – CIM_ElementCapabilities Operations Operation Requirement Messages EnumerateInstances Unspecified None EnumerateInstanceNames Unspecified None Associators Unspecified None AssociatorNames Unspecified None References Unspecified None ReferenceNames Unspecified None 8.
Power Utilization Management Profile 8.9 CIM_ElementSettingData Table 11 lists operations that either have special requirements beyond those from DSP0200, or shall not be supported. Table 11 – CIM_ElementSettingData Operations Operation Requirement Messages EnumerateInstances Unspecified None EnumerateInstanceNames Unspecified None Associators Unspecified None AssociatorNames Unspecified None References Unspecified None ReferenceNames Unspecified None 8.
Power Utilization Management Profile 8.14 CIM_ServiceAffectsElement (CIM_PowerAllocationSettingData) Table 13 lists operations that either have special requirements beyond those from DSP0200, or shall not be supported.
Power Utilization Management Profile 8.18 DCIM_OEMPowerUtilizationManagementCapabilities All operations in the default list in section 8.4 are supported as described by DSP0200 version 1.2. 8.19 DCIM_OEMPowerUtilizationManagementService All operations in the default list in section 8.1.1 are supported as described by DSP0200 version 1.2. 9 Use Cases This section contains object diagrams and use cases for the Power Supply Profile. 9.
Power Utilization Management Profile cap1 : DCIM_OEMPowerUtilizationManagementCapabilities SupportedMethods: {32769 (RequestPowerUtilizationAlgorithm) } SupportedRequestedAlgorithms: { 2 (None), 3 (Custom Settings Based), 4 (Maximum Performance), 5(Minimum Performance), 6(OS Specific), 7 (Active Power Utilization)} RequiredCustomSettings : { 2 (CPUPowerMode), 3 (MemoryPowerMode), 4 (OtherMemoryPowerMode), 5(FanPowerMode) ComputerSystem ElementCapabilities service1 : DCIM_OEMPowerUtilizationManagementServ
Power Utilization Management Profile cap1 : DCIM_OEMPowerUtilizationManagementCapabilities SupportedMethods: {32769 (RequestPowerUtilizationAlgorithm) } SupportedRequestedAlgorithms: { 2 (None), 3 (Custom Settings Based), 4 (Maximum Performance), 5(Minimum Performance), 6(OS Specific), 7 (Active Power Utilization)} RequiredCustomSettings : { 2 (CPUPowerMode), 3 (MemoryPowerMode), 4 (OtherMemoryPowerMode), 5(FanPowerMode) sys1 : ComputerSystem ElementCapabilities service1 : DCIM_OEMPowerUtilizationManagem
Power Utilization Management Profile cap1 : DCIM_OEMPowerUtilizationManagementCapabilities SupportedMethods: {32769 (RequestPowerUtilizationAlgorithm) } SupportedRequestedAlgorithms: { 2 (None), 3 (Custom Settings Based), 4 (Maximum Performance), 5(Minimum Performance), 6(OS Specific), 7 (Active Power Utilization)} RequiredCustomSettings : { 2 (CPUPowerMode), 3 (MemoryPowerMode), 4 (OtherMemoryPowerMode), 5(FanPowerMode) sys1 : ComputerSystem ElementCapabilities service1 : DCIM_OEMPowerUtilizationManagem
Power Utilization Management Profile cap1 : DCIM_OEMPowerUtilizationManagementCapabilities SupportedMethods: {32768 (RequestPowerUtilizationLimit) } SupportedUtilizationLimitUnits : { “watt” } ElementCapabilities HostedService DCIM_OEMPowerUtilizationManagementService system1 : ComputerSystem ServiceAffectsElement syspwrmax : PowerAllocationSettingData SettingDefinesState ServiceAffectsElement ResourceType : 28 (Power Supply) PowerAllocationSettingPurpose : 4 (MaxAsConfigured) Limit: 600 ElementCapab
Power Utilization Management Profile The CIM_PowerAllocationSettingData.Limit (Maximum Limit) property represents the maximum power budget setting for the managed system, if the CIM_SettingDefineCapabilities association referencing the instance has the ValueRange property set to 3 (Maximus). 8) 9) Invoke Service.
Power Utilization Management Profile Table 16 – CIM Elements: Power Utilization Management Profile Element Name Requirement Description CIM_AllocationCapabilities Conditional See section 10.1 and 7.4. CIM_ElementCapabilities (CIM_AllocationCapabilities) Conditional See section 10.2 CIM_ElementCapabilities (DCIM_OEMPowerConfigurationCapabilti es) Mandatory See section 10.3 CIM_HostedService Mandatory See section 10.4 CIM_ElementSettingData Conditional See section 10.5 and 7.
Power Utilization Management Profile 10.2 CIM_ElementCapabilities (CIM_AllocationCapabilities) CIM_ElementCapabilities associates the CIM_PowerAllocationSettingData instance that represents the power aspect of managed systems with CIM_AllocationCapabilities. Table 18 contains the requirements for elements of this class. Table 18 – CIM_ElementCapabilities Properties Requirement Notes ManagedElement Mandatory Key: This property shall be a reference to the instance of CIM_PowerAllocationSettingData.
Power Utilization Management Profile 10.5 CIM_ElementSettingData Reference CIM_ElementSettingData associates instances of DCIM_OEMPowerUtilizationCustomSettingData with the DCIM_OEMPowerUtilizationManagementService instance. Table 21 provides information about the properties of CIM_ElementSettingData. Table 21 – Class: CIM_ElementSettingData Elements Requirement Notes ManagedElement Mandatory Key This shall be a reference to the Central Instance.
Power Utilization Management Profile 10.8 CIM_PowerAllocationSettingData (CIM_AllocationCapabilities) CIM_PowerAllocationSettingData instance represents the detailed power consumption levels for managed systems. Table 24 contains the requirements for the elements of this class.
Power Utilization Management Profile 10.11 CIM_SettingsDefineCapabilities Table 27 details the requirements for instances of CIM_SettingsDefineCapabilities when it is used to associate an instance of CIM_PowerAllocationSettingData representing the detailed power consumption level of managed systems with the instance of CIM_AllocationCapabilities.
Power Utilization Management Profile 10.14 DCIM_OEMPowerUtilizationManagementCapabilities DCIM_PowerUtilizationManagementCapabilities represents the power utilization capabilities of managed systems. Table 30 contains the requirements for elements of this class. Table 30 – Class: DCIM_OEMPowerUtilizationManagementCapabilities Properties Requirement Notes InstanceID Mandatory Key RequestedStatesSupported Mandatory This property shall match empty array.
Power Utilization Management Profile ANNEX A (informative) DCIM MOF NOTE: This may not be the most up-to-date MOF. Please, for implementation purposes refer to the MOF published separately from the profiles. // Copyright (c) 2008 Dell Inc. All rights reserved. // ================================================================== // DCIM_OEMPowerUtilizationCustomSettingData // ================================================================== [Experimental, Version ( "2.18.
Power Utilization Management Profile "consumption is controlled by the OS.\n " "5 (\"System Demand Based\") - corresponds to the special " "algorithm used to control PState to maximize workload to power " "consumption ratio.\n In this setting system controls and " "adjusts power consumption of the processor based on the " "workload.
Power Utilization Management Profile [Description ( "This property represents the setting for cooling algorithm to " "maximimize power utilization. When the workload rises the " "cooling will need to be increased or the workload be executed " "slower.\n " "2 (\"Max Performance\") - corresponds to fan devices consuming " "more power because of speedups to handle heat generated from " "executing workloads faster.\n " "3 (\"Min Power\") - corresponds to slowing the workload through " "throttling so less heat i
Power Utilization Management Profile ValueMap { "..", "32768", "32769", "32770", "32771..65535" }, Values { "DMTF Reserved", "RequestPowerUtilizationLimit", "RequestPowerUtilizationAlgorithm", "RequestPowerUtilizationAlgorithmEI", "Vendor Specific" }] uint16 SupportedMethods[]; [IsPUnit, Description ( "Array of programmatic units for power utilization limit " "supported by the RequestPowerUtilizationLimit method's " "UtilizationLimit parameter.
Power Utilization Management Profile "(\"Custom Settings Based\")."), ModelCorrespondence { "DCIM_OEMPowerUtilizationManagementService.RequestPowerUtilizationAlgorithm.RequestedAlgorith m", "DCIM_OEMPowerUtilizationManagementService.RequestPowerUtilizationAlgorithmEI.RequestedAlgorit hm" }, ValueMap { "0", "2", "3", "4", "5"}, Values { "Unknown", "CPUPowerMode", "MemoryPowerMode", "OtherMemoryPowerMode", "FanPowerMode"}] string RequiredCustomSettings[]; }; // Copyright (c) 2008 Dell Inc.
Power Utilization Management Profile "value is 2 (\"None\"), then the PowerUtilizationMode shall be " "equal to 2 (\"None\").\n " "3 (\"Custom Settings Based\") shall indicate that the service " "is employing power utilzation algorithm based on a specific " "settings. This settings may be represented by the " "DCIM_OEMPowerUtilizationSettingData instance associated through " "ElementSettingData where the IsCurrent property has value 1 " "(\"Is Current\").\n " "4 (\"Maximum Performance\") shall indicate that
Power Utilization Management Profile ModelCorrespondence { "DCIM_OEMPowerUtilizationManagementService.RequestedPowerUtilizationAlgorithm" }] uint16 PowerUtilizationAlgorithm; [Description ( "This property describes the pending requested algorithm to be " "employed by the service for power utilization.
Power Utilization Management Profile "Pending\") or IsCurrent property with value 1(\"Is Current\"). " "The associated DCIM_OEMPowerUtilizationSettingData properties " "shall be set to the CustomSettings parameter embedded instance " "property values.\n " "Return code of 2 shall be returned if the RequestedAlgoritm " "parameter has a value that is not contained within the " "SupportedRequestedAlgorithms property array of the " "associated DEL_OEMPowerUtilizationManagementCapabilities " "instance.\n " "Retur
Power Utilization Management Profile [IN, Description ( "An instance of DCIM_OEMPowerUtilizationCustomSettingData " "that represents the requested custom settings and their " "values.\n " "This parameter shall not be NULL, if the RequestedAlgorithm " "parameter has value 3 (\"Custom Settings Based\").
Power Utilization Management Profile "association that has IsPending property with value 2 (\"Is " "Pending\") or IsCurrent property with value 1(\"Is Current\"). " "The associated DCIM_OEMPowerUtilizationSettingData properties " "shall be set to the values of CustomSettingValues parameter " "array's elements of the index, where the " "DCIM_OEMPowerUtilizationCustomSettingData property name matches the " "CustomSettingNames array parameter's value.\n " "Return code of 2 shall be returned if the RequestedAlg
Power Utilization Management Profile uint32 RequestPowerUtilizationAlgorithm ( [Required, IN, Description ( "Requested algorithm to be employed by the service for power utilization."), ValueMap { "2", "3", "4", "5", "6", "7", "8"}, Values { "None", "Custom Settings Based", "Maximum Performance", "Minimum Performance", "OS Specific", "Active Power Utilization"}, ModelCorrespondence { "DCIM_OEMPowerUtilizationManagementCapabilities.
Power Utilization Management Profile "This parameter shall not be NULL, if the RequestedAlgorithm " "parameter has value 3 (\"Custom Settings Based\")."), ArrayType ( "Indexed" ), ModelCorrespondence { "DCIM_OEMPowerUtilizationManagementService.RequestPowerUtilizationAlgorithm.CustomSettingNam es" } ] string CustomSettingValues, [IN ( false ), OUT, Description ( "Reference to the job spawned if the operation continues " "after the method returns. (May be null if the task is " "completed).
Power Utilization Management Profile "CIM_PowerAllocationSettingData which is not associated to the " "Service through the CIM_ServiceAffectsElement association."), ValueMap { "0", "1", "2", "3", "4", "5", "6", "7..32767", "32768..
Power Utilization Management Profile "after the method returns. (May be null if the task is " "completed).")] CIM_ConcreteJob REF Job); }; Version 1.0.
Power Utilization Management Profile ANNEX B (informative) Change Log Version 1.0.0 48 Date 2/12/2009 Description Initial version. Version 1.0.
Power Utilization Management Profile ANNEX C (informative) Acknowledgments The authors wish to acknowledge the following people. Editor: • Khachatur Papanyan – Dell Contributors: • Aaron Merkin – Dell • Javier L. Jimenez – Dell • Khachatur Papanyan – Dell • Michael Brundridge – Dell • Wayne Weilnau – Dell Version 1.0.