Record Log Profile Document Number: DCIM1006 Document Type: Specification Document Status: Published Document Language: E Date: 2012-03-08 Version: 1.0.
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 – 2012 Dell Inc. All rights reserved.
CONTENTS 1 2 3 4 5 6 7 8 9 10 11 Scope .................................................................................................................................................... 5 Normative References........................................................................................................................... 5 Terms and Definitions ...........................................................................................................................
Figures Figure 1 – Record Log Profile Class Diagram .............................................................................................. 8 Figure 2 – Record Log Profile Implementation (Lifecycle Log) .................................................................... 9 Figure 3 – Record Log Profile Implementation (System Event Log) .......................................................... 10 Tables Table 1 – Related Profiles ......................................................................
Record Log Profile 1 2 1 3 4 5 6 The DCIM Record Log Profile provides the management capabilities to represent logs of a managed system element. This profile provides information on managing Lifecycle and System Event logs. The log is modeled as referencing the managed system elements that populate the log, and the profile registration for the schema implementation version information. 7 2 8 Refer to the following documents for more information.
3.1 34 35 36 Conditional – Indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met. 37 38 39 Mandatory – Indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted. 3.2 3.3 40 41 May – Indicates a course of action permissible within the limits of the document. 42 43 Optional – Indicates a course of action permissible within the limits of the document. 3.4 3.
57 4 58 59 CIM – Common Information Model Symbols and Abbreviated Terms 4.1 4.2 60 61 62 iDRAC - Integrated Dell Remote Access Controller – management controller for blades and monolithic servers 63 64 CMC – Chassis Manager Controller – management controller for the modular chassis 4.3 4.4 65 66 LIFO – Last In, First Out 67 68 LCL – Lifecycle Log 69 70 SEL – System Event Log 71 5 72 Profile Name: Record Log 73 Version: 1.0.0 74 Organization: DCIM 75 CIM Schema Version: 2.
6 6 87 88 89 The Record Log Profile describes the properties and methods of logs generated by the managed system. This profile describes the association between the managed system element and the generated logs as well as how individual log entries are contained within a record log. 90 Figure 1 represents the class diagram for Record Log Profile.
4 95 96 97 98 99 Figure 2 represents the Lifecycle Log (LCL) representation. The DCIM_LCRecordLog class represents the container for the Lifecycle log entries. The individual log entries, which are represented by the DCIM_LCLogEntry instances, are aggregated under the DCIM_LCRecordLog instance through the DCIM_LCLogManagesRecord association. The managed system element that is associated with the log, uses the log, or populates the log is referenced through the DCIM_LCUseOfLog association.
8 109 110 111 112 113 Figure 3 represents the System Event Log (SEL) representation. The DCIM_SELRecordLog class represents the container for the System Event log entries. The individual log entries, which are represented by the DCIM_SELLogEntry instances, are aggregated under the DCIM_SELRecordLog instance through the DCIM_SELLogManagesRecord association. The managed system element that is associated with the log, uses the log, or populates the log is referenced through the DCIM_SELUseOfLog association.
122 7 123 This section describes the requirements and guidelines for implementing Record Log Profile. Implementation Description 124 Table 2 – Class Requirements: Record Log Profile Element Name Requirement Description DCIM_LCRecordLog Mandatory The class shall be implemented in the Implementation Namespace. See section 7.1 DCIM_LCRecordLogCapabilities Mandatory The class shall be implemented in the Implementation Namespace. See section7.
Element Name Requirement Description DCIM_LCElementConformsToPro file Mandatory The class shall be implemented in both the Interop and Implementation Namespaces. See section DCIM_LCRegisteredProfile Mandatory The class shall be implemented in the Interop Namespace. See section Indications None defined in this profile 125 126 7.1 127 128 129 This section describes the implementation for the DCIM_LCRecordLog class that represents the Lifecycle log.
151 Table 4 – DCIM_LCRecordLog - Properties Property Name Type Requirements InstanceID String Mandatory MaxNumberOfRecords Uint64 Mandatory LogState Uint16 Mandatory OverwritePolicy Uint16 Mandatory RequestedState Uint16 Mandatory EnabledState Uint16 Mandatory OperationalStatus[] Uint16 Mandatory HealthState Uint16 Mandatory ElementName String Mandatory CurrentNumberOfRecords Uint64 Mandatory Additional Requirements The property value shall be “DCIM:LifeCycleLog”.
167 168 7.2.3 Class Properties 169 170 171 172 The following table lists the implemented properties for DCIM_LCRecordLogCapabilities instance representing the capabilities of the LCRecordLog. The “Requirements” column shall denote whether the property is implemented (for requirement definitions, see section 3). The “Additional Requirements” column shall denote either possible values for the property, or requirements on the value formulation.
188 189 7.3.3 Class Properties 190 191 192 193 The following table lists the implemented properties for DCIM_LCLogEntry instance representing a system in a system. The “Requirements” column shall denote whether the property is implemented (for requirement definitions, see section 3). The “Additional Requirements” column shall denote either possible values for the property, or requirements on the value formulation.
Property Name Type Requirements AgentID String Mandatory FQDD String Mandatory Comment String Mandatory Additional Requirements The property value shall represent the ID of the source agent responsible for creation of the log entry event. The property value shall represent the FQDD of the device that the logged event relates to. The property value shall represent the user specified comment for the logged event. This property represents only a comment field to an existing log entry.
214 Table 9 – DCIM_SELRecordLog – Operations Operation Name Get Enumerate Invoke Requirements Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI (see section 8.1) 215 7.4.3 Class Properties 216 217 218 219 The following table lists the implemented properties for DCIM_SELRecordLog instance representing a system in a system. The “Requirements” column shall denote whether the property is implemented (for requirement definitions, see section 3).
230 231 232 233 The instance Resource URI for DCIM_SELRecordLog instance shall be: “http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_ SELRecordLogCapabilities?__cimnamespace=root/dcim+InstanceID=DCIM:SystemEventLogCapabilities ” 234 7.5.2 Operations 235 The following table lists the operations implemented on DCIM_SELRecordLogCapabilities.
256 7.6.2 Operations 257 The following table details the implemented operations on DCIM_SELLogEntry. 258 Table 13 – DCIM_SELLogEntry - Operations Operation Name Get Enumerate Set Requirements Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI 259 260 7.6.3 Class Properties 261 262 263 264 The following table lists the implemented properties for DCIM_SELLogEntry instance representing a system in a system.
278 The key property shall be the InstanceID property. 279 7.7.2 Operations 280 The following table lists the operations implemented on CIM_RegisteredProfile . 281 Table 15 – CIM_RegisteredProfile - Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 282 283 7.7.
304 Table 17 – CIM_RegisteredProfile - Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 305 306 7.8.3 DCIM_RegisteredProfile Properties 307 308 309 310 The following table lists the implemented properties for CIM_RegisteredProfile instance representing the Record Log Profile implementation. The “Requirements” column shall denote whether the property is implemented (for requirement definitions, see section 3).
Operation Name Enumerate Requirements Mandatory Required Input Class URI 328 329 7.9.3 Properties 330 331 332 333 The following table lists the implemented properties for DCIM_LCRegisteredProfile instance representing the Record Log Profile implementation. The “Requirements” column shall denote whether the property is implemented (for requirement definitions, see section 3).
345 8.2 DCIM_LCRecordLog.GetConfigResults() 346 347 The GetConfigResults() method provides the ability to get the configuration results that are associated with a particular logged entry. 348 349 350 The GetConfigResults() method’s return code values shall be as specified in Table 23 where the method execution behavior matches the return code description. The GetConfigResults() method’s parameters are specified in Table 24. 351 Table 23 – CIM_MetricService.
364 Table 26 – Privilege and License Requirements Class and Method DCIM_LCRecordLog Operation ENUMERATE, GET ENUMERATE, GET ENUMERATE, GET User Privilege Required License Required Login None. Login None. Login None. SET ENUMERATE, GET ENUMERATE, GET ENUMERATE, GET ENUMERATE, GET Login, Configure None. Login None. Login None. Login None. Login None. Login, Logs None. Login None. Login None. Login None. Login None. Login None. Login None. Login None.