Power Topology Profile Document Number: DCIM1002 Document Type: Specification Document Status: Published Document Language: E Date: 2009-02-12 Version: 1.0.
Power Topology 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 SEPARATE 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 Topology Profile CONTENTS Foreword ....................................................................................................................................................... 7 Introduction ................................................................................................................................................... 8 1 Scope .................................................................................................................................................
Power Topology Profile 10.12 CIM_PowerSupply .................................................................................................................... 34 10.13 CIM_RedundancySet – Power Supplies................................................................................... 34 10.14 CIM_RedundancySet – External Power Domain ...................................................................... 34 10.15 CIM_RegisteredProfile ......................................................................
Power Topology Profile Figures Figure 1 – Power Topology Profile: Class Diagram .................................................................................... 12 Figure 2 – Power Topology Profile: Profile Registration ............................................................................. 24 Figure 3 – Power Topology Profile: Initial Power Topology ........................................................................ 25 Figure 4 – Power Topology Profile: Initial Power Topology ..............
Power Topology Profile Table 34 – Class: CIM_SystemComponent – External Power Domain ...................................................... 37 Table 35 – Class: CIM_SuppliesPower ...................................................................................................... 37 6 Version 1.0.
Power Topology Profile Foreword The Power Topology Profile (DCIM1002) was prepared by the Dell CIM Review Board. Version 1.0.
Power Topology Profile Introduction This specification identifies the necessary classes, properties, methods, and values to be instantiated and manipulated to represent and manage power topology 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 Topology Profile Power Topology Profile 1 Scope The Power Topology Profile extends the management capabilities of referencing profiles by adding the capability to represent a hierarchy of power sources: power supplies and external power domains, and their redundancies. The profile provides also information on the client configuration of the power hierarchy, and profile versioning for the schema implementation version information.
Power Topology Profile 3.3 conditional indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met 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.
Power Topology Profile 5 Synopsis Profile Name: Power Topology Profile Version: 1.0.0 Organization: Dell CIM Schema Version: 2.15.0 Dell Schema Version: 1.0.0 Central Class: Dell_OEMPowerConfigurationService Scoping Class: CIM_ComputerSystem The Power Topology Profile extends the management capability of the referencing profiles by adding the capability to describe power source topology in a managed system.
Power Topology Profile Dell_OEMPowerConfigurationCapabilities 1 ElementCapabilities 1..* 1..* 1 HostedService ComputerSystem (See Referencing Profile) 1 1 Dell_OEMPowerConfigurationService OwningCollectionElement 1 1 Dell_OEMOrderedServiceAffectsElement 2..* 2..* SystemComponent ConcreteIdentity 1 1 RedundancySet 0..1 ElementConformsToProfile (See Profile Registration Profile) 0..1 1..* MemberOfCollection 1..* 1 AdminDomain * 0..1 * IsSpare (See Power Supply Profile) 0..
Power Topology Profile 6.1.2 External Power Domains A managed system, depending on the power infrastructure architecture that it is plugged in to, may have a need to model external power sources as external power domains. The power supplies of the managed system can draw power from a specific external power domain.
Power Topology Profile 7.1.1 Representing an Internal Power Domain There shall be exactly one instance of CIM_AdminDomain for each internal power domain in the system. The instance of CIM_AdminDomain shall be implemented as defined in 10.1.
Power Topology Profile redundancy of power supplies. The two CIM_RedundancySet instances shall be associated to each other through CIM_ConcreteIdentity, and shall represent together the power redundancy for the consumer components of the managed system. 7.3.1 Assigned Power Redundancy Priority The assigned power redundancies’ priorities for maintaining the underlying instrumentation shall be represented through the Dell_OrderServiceAffectsElemen.
Power Topology Profile 8 Methods This section details the requirements for supporting intrinsic operations and extrinsic methods for the CIM elements defined by this profile. 8.1 Method: Dell_OEMPowerConfigurationService.ChangeAffectedElementsAssigned Sequence ( ) The Dell_OEMPowerConfigurationService.ChangeAffectedElementsAssignedSequence ( ) method requests reassignment of priorities for the power redundancies. Dell_OEMPowerConfigurationService.
Power Topology Profile 8.2 Method: Dell_OEMPowerConfigurationService.ConfigureExternalPowerDomainDef aults( ) Dell_OEMPowerConfigurationService.ConfigureExternalPowerDomainDefaults( ) method provides an interface for a client application to specify the external power domains that are supplying power to the power supplies in a default configuration of the managed system.
Power Topology Profile 8.3 Method: Dell_OEMPowerConfigurationService.ConfigureExternalPowerDomains( ) Dell_OEMPowerConfigurationService.ConfigureExternalPowerDomains( ) method provides an interface for a client application to specify which external power domains are supplying power to certain power supplies in the managed system.
Power Topology Profile 8.4 Method: Dell_OEMPowerConfigurationService.AssignPowerRedundancyPriority ( ) Dell_OEMPowerConfigurationService.AssignPowerRedundancyPriority() method provides an interface for a client application to assign a priority to the redundancy. The priority could be assigned either to the power supply redundancy, or to the external power domain redundancy. Dell_OEMPowerConfigurationService.AssignPowerRedundancyPriority( ) return values shall be as specified in Table 8.
Power Topology Profile The default list of operations is as follows: • GetInstance • EnumerateInstances • EnumerateInstanceNames • Associators • AssociatorNames • References • ReferenceNames A compliant implementation shall support all of the operations in the default list for each class, unless the “Requirement” column states something other than Mandatory. 8.6 CIM_AdminDomain – Internal Power Domain All operations in the default list in section 8.
Power Topology Profile 8.10 CIM_HostedService Table 12 lists operations that either have special requirements beyond those from DSP0200 or shall not be supported. Table 12 – CIM_HostedService Operations Operation Requirement Messages EnumerateInstances Unspecified None EnumerateInstanceNames Unspecified None Associators Unspecified None AssociatorNames Unspecified None References Unspecified None ReferenceNames Unspecified None 8.
Power Topology Profile 8.13 CIM_OwningCollectionElement Table 15 lists operations that either have special requirements beyond those from DSP0200 or shall not be supported. Table 15 – CIM_OwningCollectionElement Operations Operation Requirement Messages EnumerateInstances Unspecified None EnumerateInstanceNames Unspecified None Associators Unspecified None AssociatorNames Unspecified None References Unspecified None ReferenceNames Unspecified None 8.
Power Topology Profile 8.18 CIM_SuppliesPower Table 17 lists operations that either have special requirements beyond those from DSP0200 or shall not be supported.
Power Topology Profile system1 : ComputerSystem ElementConformsToProfile profile1 : RegisteredProfile HostedService RegisteredName : Base Server Profile RegisteredVersion : 1.0.0 RegisteredOrganization : 2 (DMTF) ReferencedProfile pmservice1 : Dell_OEMPowerConfigurationService profile2 : RegisteredProfile ElementCapabilities RegisteredName : Power Topology Profile RegisteredVersion : 1.0.0 RegisteredOrganization : 1(Other) OtherRegisteredOrganization : “Dell Inc.
Power Topology Profile Dell_OEMPowerConfigurationService HostedService system1 : ComputerSystem Dell_OEMOrderedServiceAffectsElement AssignedSequence : 0 Dell_OEMOrderedServiceAffectsElement AssignedSequence : 0 redundancyset2 : RedundancySet OwningCollectionElement ConcreteIdentity OwningCollectionElement RedundancyStatus : 0(Unknown) TypeOfSet : 2 (N+1) SystemComponent redundancyset1 : RedundancySet RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) MemberOfCollection MemberOfCollection Syst
Power Topology Profile Dell_OEMPowerConfigurationService HostedService system1 : ComputerSystem Dell_OEMOrderedServiceAffectsElement AssignedSequence : 0 Dell_OEMOrderedServiceAffectsElement AssignedSequence : 0 redundancyset2 : RedundancySet OwningCollectionElement ConcreteIdentity OwningCollectionElement RedundancyStatus : 4 (Redundancy Lost) TypeOfSet : 2 (N+1) SystemComponent redundancyset1 : RedundancySet RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) MemberOfCollection MemberOfCollect
Power Topology Profile system1 : ComputerSystem redundancyset2 : RedundancySet OwningCollectionElement OwningCollectionElement ConcreteIdentity RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) SystemComponent redundancyset1 : RedundancySet RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) MemberOfCollection MemberOfCollection SystemDevice pwrsrcdom1 : AdminDomain ElementName : External Power Domain MemberOfCollection SystemComponent pwrsupply1 : PowerSupply pwrsrcdom2 : AdminDomain E
Power Topology Profile system1 : ComputerSystem exredundancyset1 : RedundancySet OwningCollectionElement ConcreteIdentity RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) redundancyset1 : RedundancySet OwningCollectionElement SystemComponent MemberOfCollection RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) SystemComponent pwrsrcdom1 : AdminDomain ElementName : External Grid Domain inpwrdom1 : AdminDomain MemberOfCollection ElementName : Power Domain SystemComponent pwrsupply1
Power Topology Profile system1 : ComputerSystem exredundancyset1 : RedundancySet OwningCollectionElement RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) ConcreteIdentity OwningCollectionElement redundancyset1 : RedundancySet RedundancyStatus : 2(Fully Redundant) TypeOfSet : 2 (N+1) Dell_OEMOrderedServiceAffectsElement AssignedSequence : 1 Dell_OEMOrderedServiceAffectsElement AssignedSequence : 2 capabilities1 : Dell_OEMPowerConfigurationCapabilities SupportedMethods[] : { 2(ChangeAffectedEle
Power Topology Profile 10 CIM Elements Table 18 shows the instances of CIM Elements for this profile. Instances of the CIM Elements shall be implemented as described in Table 18. Sections 7 (“Implementation Requirements”) and 8 (“Methods”) may impose additional requirements on these elements. Table 18 – CIM Elements: Power Topology Profile Element Name Requirement Description CIM_AdminDomain – Internal Power Domain Optional See section 10.1 and 7.1.
Power Topology Profile CreationClassName Mandatory Key ElementName Mandatory matches "Power Domain" 10.2 CIM_AdminDomain – External Power Domain The CIM_AdminDomain class is used to represent power domains of the managed system. Table 20 contains the requirements for properties of the instance. Table 20 – Class: CIM_AdminDomain – External Power Domain Properties Requirement Name Mandatory Notes Key CreationClassName Mandatory Key ElementName Mandatory matches "External Power Domain" 10.
Power Topology Profile 10.5 CIM_HostedService CIM_HostedService is used to associate an instance of Dell_OEMPowerConfigurationService with an instance of CIM_ComputerSystem that is the computer system hosting the service. Table 23 contains the requirements for elements of this class. Table 23 – Class: CIM_HostedService Elements Requirement Notes Antecedent Mandatory Key: This property shall reference the instance of CIM_ComputerSystem.
Power Topology Profile 10.8 Dell_OEMOrderedServiceAffectsElement Dell_OEMOrderedServiceAffectsElement is used to associate an instance of Dell_OEMPowerConfigurationService with an instance of CIM_RedundancySet representing power supply or external power domain redundancy that is managed by the service. Table 26 – Class: Dell_OEMOrderedServiceAffectsElement Elements Requirement Notes AffectedElement Mandatory Key: This property shall reference the instance of CIM_RedundancySet. Cardinality 2..
Power Topology Profile 10.11 Dell_OEMPowerConfigurationService Dell_OEMPowerConfigurationService represents the capabilities of the power management service.
Power Topology Profile Table 31 are in addition to those mandated by the Profile Registration Profile. Version 1.0.
Power Topology Profile Table 31 – Class: CIM_RegisteredProfile Properties Requirement Description RegisteredName Mandatory This property shall have a value of “Power Topology Profile”. RegisteredVersion Mandatory This property shall have a value of “1.0.0”. RegisteredOrganization Mandatory This property shall have a value of 1 (Other). OtherRegisteredOrganization Mandatory This property shall match “Dell Inc.” 10.
Power Topology Profile Table 34 – Class: CIM_SystemComponent – External Power Domain Properties GroupComponent Requirement Mandatory Notes Key: Shall reference the CIM_AdminDomain instance representing external power domain. Cardinality * indicating zero or more references PartComponent Mandatory Key: Shall reference the CIM_PowerSupply instance representing power supply consuming power from external power domain. Cardinality * indicating zero or more references 10.
Power Topology Profile ANNEX A (informative) Dell 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) 2007 Dell All rights reserved. // ================================================================== // Dell_OEMPowerConfigurationCapabilities // ================================================================== // Preliminary Approved [Experimental, Version ( "1.0.
Power Topology Profile // Copyright (c) 2007 Dell All rights reserved. // ================================================================== // Dell_OEMPowerConfigurationService // ================================================================== // Preliminary Approved [Experimental, Version ( "1.0.0" ), Description ( "This class extends CIM_Service to provide interface to manage " "the overall power topology of the system.
Power Topology Profile ValueMap {"2", "3" }, Values { "Enabled", "Disabled" }] uint16 PerformanceDegradationEnabled; [Description ( "This method is called to change the order of the " "ManagedElements in which sequence they are affected by the " "Service. An ordered array of ManagedElement instances is passed " "to this method. Each ManagedElement instance shall be already " "be associated with this Service instance via an instance of " "Dell_OEMOrderedServiceAffectsElement.
Power Topology Profile "shall be assigned a value of 0."), ValueMap { "0", "1", "2", "3", "4", "5", "6", "7..32767", "32768..65535" }, Values { "Completed with No Error", "Not Supported", "Error Occured", "Busy", "Invalid Reference", "Invalid Parameter", "Access Denied", "DMTF Reserved", "Vendor Specified" }] uint32 ChangeAffectedElementsAssignedSequence ( [IN, Description ( "An array of ManagedElements.
Power Topology Profile "CIM_ComputerSystem referenced in the OwningComputerSystem " "parameter through CIM_OwningCollectionElement association, the " "implementation shall return a value of \"Error Occured\".
Power Topology Profile uint16 RequestedChange, [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).")] CIM_ConcreteJob REF Job); [Description ( "This method is called to configure external grid redundancy in " "the case the underlying instrumentation is unable to detect the " "external grid redundancy and depends on the client input for " "its configuration.
Power Topology Profile "Vendor Specified" }] uint32 ConfigureExternalPowerDomains ( [IN, Description ( "Reference to the instance of CIM_ComputerSystem that the " "power supplies and external power domains and their " "redundancies belong to.")] CIM_ComputerSystem REF OwningComputerSystem, [IN, Description ( "An array of CIM_PowerSupply instances.
Power Topology Profile "ServiceAffectsElement represents an association between a " "Service and the ManagedElements that might be affected by its " "execution and the order in which the service might affect its " "element. Instantiating this association indicates that " "running the service may change, manage, provide functionality " "for,or pose some burden on the ManagedElement in a specific " "sequence. This burden might affect performance, throughput, " "availability, and so on.
Power Topology Profile "\n" "Note that the non-zero sequence numbers need not start with " "'1', and they need not be consecutive. All that matters is " "their relative magnitude.")] uint16 AssignedSequence; }; 46 Version 1.0.
Power Topology Profile ANNEX B (informative) Change Log Version 1.0.0 Date 2/12/2009 Version 1.0.0a Description Initial version.
Power Topology Profile ANNEX C (informative) Acknowledgments The authors wish to acknowledge the following people. Editor: • Khachatur Papanyan – Dell Inc. Contributors: 48 • Jon Hass – Dell Inc. • Khachatur Papanyan – Dell Inc. • Michael Brundridge – Dell Inc. Version 1.0.