SMASH Collections Profile Document Number: DCIM1017 Document Type: Specification Document Status: Published Document Language: E Date: 2008-11-10 Version: 1.0.
SMASH Collections 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.
SMASH Collections Profile CONTENTS Foreword ....................................................................................................................................................... 5 Introduction ................................................................................................................................................... 6 1 Scope ..............................................................................................................................................
SMASH Collections Profile 10.1 CIM_ConcreteCollection ........................................................................................................... 27 10.2 CIM_MemberOfCollection ........................................................................................................ 27 10.3 CIM_OwningCollectionElement ................................................................................................ 27 10.4 CIM_RegisteredProfile ...................................................
SMASH Collections Profile Foreword The SMASH Collections Profile (DCIM1017) was prepared by Dell CIM Review Board. Version 1.0.
SMASH Collections Profile Introduction This specification identifies the necessary classes, properties, methods, and values to be instantiated and manipulated to represent and manage SMASH collections 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. 6 Version 1.0.
SMASH Collections Profile SMASH Collections Profile 1 Scope The SMASH Collections Profile extends the management capability of referencing profiles by adding the ability to create collections of managed elements. 2 Normative References The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. 2.
SMASH Collections Profile DMTF DSP1010, Record Log Profile DMTF DSP1039, Role Based Authorization Profile DMTF DSP1009, Sensors Profile DMTF DSP1027, Server Power State Management Profile DMTF DSP1021, Shared Device Management Profile DMTF DSP1017, SSH Service Profile DMTF DSP1026, System Memory Profile DMTF DSP1016, Telnet Service Profile DMTF DSP1024, Text Console Redirection Profile 2.
SMASH Collections Profile 3.7 optional indicates a course of action permissible within the limits of the document 3.8 referencing profile indicates a profile that owns the definition of this class and can include a reference to this profile in its "Referenced Profiles" table 3.9 shall indicates requirements to be followed strictly to conform to the document and from which no deviation is permitted 3.
SMASH Collections Profile 3.19 Settings Collection CIM_ConcreteCollection instance for instances of the CIM_SettingData class 4 Symbols and Abbreviated Terms The following abbreviations are used in this document. 4.1 SMASH Systems Management Architecture for Server Hardware 4.2 SM CLP Server Management Command Line Protocol 4.3 SM ME Server Management Managed Element 5 Synopsis Profile Name: SMASH Collections Profile Version: 1.0.0a Organization: DMTF CIM Schema Version: 2.
SMASH Collections Profile Table 1 – Referenced Profiles Profile Name Organization Version Relationship Behavior Base Server Profile DMTF 1.0 Optional See section 7.2. Boot Control Profile DMTF 1.0 Optional See section 7.3. Chassis Manager Profile DMTF 1.0 Optional See section 7.4. CLP Service Profile DMTF 1.0 Optional See section 7.5. CPU Profile DMTF 1.0 Optional See section 7.6. Device Tray Profile DMTF 1.0 Optional See section 7.7. DHCP Client Profile DMTF 1.
SMASH Collections Profile Figure 1 represents the class schema for the SMASH Collections Profile. For simplicity, the prefix CIM_ has been removed from the class names. ComputerSystem (See Referencing Profile) 1 1 OwningCollectionElement ElementConformsToProfile (See Profile Registration Profile) 7 ConcreteCollection 0..7 ElementConformsToProfile (See Profile Registration Profile) 1 MemberOfCollection * ManagedElement (See Referencing Profile) 1 0..
SMASH Collections Profile 7.1.3 Consoles Collection An instance of CIM_ConcreteCollection shall aggregate instances of CIM_TextRedirectionSAP. This collection is the Consoles Collection. 7.1.3.1 CIM_ConcreteCollection.ElementName When an instance of CIM_ConcreteCollection is the Consoles Collection, the value of the ElementName property shall be "Consoles". 7.1.4 Logs Collection An instance of CIM_ConcreteCollection shall aggregate instances of CIM_RecordLog. This collection is the Logs Collection.
SMASH Collections Profile 7.2.1 Capabilities Collection Exactly one instance of CIM_MemberOfCollection shall reference the Capabilities Collection and the instance of CIM_EnabledLogicalElementCapabilities for each instance of CIM_EnabledLogicalElementCapabilities that is instrumented for the Base Server Profile. 7.3 Boot Control Profile The Boot Control Profile may be implemented so that the Scoping Instance of the Boot Control Profile is the Scoping Instance of this profile.
SMASH Collections Profile 7.6.1 Capabilities Collection Exactly one instance of CIM_MemberOfCollection shall reference the Capabilities Collection and the instance of CIM_EnabledLogicalElementCapabilities for each instance of CIM_EnabledLogicalElementCapabilities that is instrumented for the CPU Profile. 7.7 Device Tray Profile When the Scoping Instance of the Device Tray Profile is the Scoping Instance of this profile, the requirements defined in this section apply. 7.7.
SMASH Collections Profile 7.10 Fan Profile When the Scoping Instance of the Fan Profile is the Scoping Instance of this profile, the requirements defined in this section apply. 7.10.1 Capabilities Collection Exactly one instance of CIM_MemberOfCollection shall reference the Capabilities Collection and the instance of CIM_EnabledLogicalElementCapabilities for each instance of CIM_EnabledLogicalElementCapabilities instrumented for the Fan Profile. 7.
SMASH Collections Profile 7.14 Physical Asset Profile When the Scoping Instance of the Physical Asset Profile is the Scoping Instance of this profile, the requirements defined in this section apply. 7.14.1 Capacities Collection Exactly one instance of CIM_MemberOfCollection shall reference the Capacities Collection and the instance of CIM_ConfigurationCapacity for each instance of CIM_ConfigurationCapacity that is instrumented for the Physical Asset Profile. 7.14.
SMASH Collections Profile 7.18.1 Sensors Collection Exactly one instance of CIM_MemberOfCollection shall reference the Central Instance of the Sensors Profile and the Sensors Collection. 7.18.2 Capabilities Collection Exactly one instance of CIM_MemberOfCollection shall reference the Capabilities Collection and the instance of CIM_EnabledLogicalElementCapabilities for each instance of CIM_EnabledLogicalElementCapabilities that is instrumented for the Sensors Profile. 7.
SMASH Collections Profile 7.22 System Memory Profile When the Scoping Instance of the System Memory Profile is the Scoping Instance of this profile, the requirements defined in this section apply. 7.22.1 Capabilities Collection Exactly one instance of CIM_MemberOfCollection shall reference the Capabilities Collection and the instance of CIM_EnabledLogicalElementCapabilities for each instance of CIM_EnabledLogicalElementCapabilities that is instrumented for the System Memory Profile. 7.
SMASH Collections Profile The default list of operations is as follows: • GetInstance • ModifyInstance • 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.2 CIM_ConcreteCollection All operations in the default list in section 8.1 are supported as described by DSP0200 v1.2. 8.
SMASH Collections Profile 9 Use Cases This section contains object diagrams and use cases for the SMASH Collections Profile. 9.1 Object Diagrams The object diagram in Figure 2 shows how instances of CIM_RegisteredProfile identify the version of the SMASH Collections Profile that the instances of CIM_ConcreteCollection and their associated instances conform to. An instance of CIM_RegisteredProfile exists for each profile instrumented in the system.
SMASH Collections Profile The object diagram in Figure 3 shows a system that supports the profile, and therefore elements are contained in the Profiles Collections. As shown in the figure, since ComputerSystem is associated with AdminDomain through the CIM_SystemComponent association the Profiles Collection, profiles1, is associated to ComputerSystem.
SMASH Collections Profile The object diagram in Figure 4 shows a system that supports the profile, and therefore elements are contained in the Settings and Capabilities Collections.
SMASH Collections Profile The object diagram in Figure 5 represents a system that supports the Record Log Profile, and therefore the Logs Collection contains an instance of CIM_RecordLog. ComputerSystem OwningCollectionElement consoles1 : ConcreteCollection HostedAccessPoint MemberOfCollection textredirectsap1 : TextRedirectionSAP textredirectsap2 : TextRedirectionSAP Figure 5 – Logs Collection 24 Version 1.0.
SMASH Collections Profile The object diagram in Figure 6 illustrates one possible arrangement of instances for an implementation that supports the Text Console Redirection Profile, and therefore has elements contained in the Consoles Collection. ComputerSystem OwningCollectionElement logs1 : ConcreteCollection UseOfLog MemberOfCollection log1 : RecordLog Figure 6 – Consoles Collection 9.
SMASH Collections Profile 9.5 Find All of the Settings for a System A client can find all of the settings (CIM_SettingData instances) for the system as follows: Find the instance of CIM_ConcreteCollection that is associated with the CIM_ComputerSystem instance through an instance of CIM_OwningCollectionElement where the ElementName property of the CIM_ConcreteCollection instance has a value of "Settings". 9.
SMASH Collections Profile 10.1 CIM_ConcreteCollection CIM_ConcreteCollection instances are used to aggregate instances of CIM_ManagedElement. Table 5 provides information about the properties of CIM_ConcreteCollection. Table 5 – Class: CIM_ConcreteCollection Properties Requirement Notes InstanceID Mandatory None ElementName Mandatory See section 7.1. 10.
SMASH Collections Profile 28 Version 1.0.
SMASH Collections Profile ANNEX A (Informative) Change Log Version Version 1.0.
SMASH Collections Profile ANNEX B (informative) Acknowledgments The authors wish to acknowledge the following people. Editor: • Khachatur Papanyan – Dell Contributors: 30 • Jon Hass – Dell • Khachatur Papanyan – Dell Version 1.0.
