P00109 - HP Record Log Profile

ManualsBrandsHP ManualsSoftwareVMware Virtualcenter Management Server License Software

HP WBEM TC

Document Number: P00109

Date: 12/19/08

Version: 1.1.0

HP Record Log Profile

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. HP shall not be liable for technical or editorial errors or

omissions contained herein.

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR

12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for

Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license.

Summary of content (33 pages)

PAGE 1
HP WBEM TC Document Number: P00109 Date: 12/19/08 Version: 1.1.0 HP Record Log Profile © Copyright 2008 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.
PAGE 2
HP Record Log Profile Contents Foreword ....................................................................................................................................................... 4 Introduction.................................................................................................................................................... 5 1 Scope ..................................................................................................................................................
PAGE 3
HP Record Log Profile Figures Figure 1 – Record Log Profile: Class Diagram ............................................................................................. 9 Figure 2 – Record Log Profile: Indication Class Diagram ............................................................................. 9 Figure 3 – Record Log Profile: Object Diagram .......................................................................................... 18 Figure 4 – Record Log Profile: Indication Object Diagram .......
PAGE 4
HP Record Log Profile Foreword The HP Record Log Profile P00109 was prepared by the HP WBEM TC. 4 Version 1.1.
PAGE 5
HP Record Log Profile Introduction The information in this specification should be sufficient for a provider or consumer of this data to identify unambiguously the classes, properties, methods, and values that shall be instantiated and manipulated to represent Logs and their included Records in HP systems. The target audience for this specification is implementers who are writing CIM based providers or consumers of management interfaces representing the component described in this document. Version 1.1.
PAGE 6
HP Record Log Profile 1 Scope The HP Record Log profile extends the management capability of referencing profiles by adding the capability to represent the Record Log in HP specific ways. 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.
PAGE 7
HP Record Log Profile 3.4 mandatory used to indicate requirements strictly to be followed in order to conform to the document and from which no deviation is permitted 3.5 may used to indicate a course of action permissible within the limits of the document 3.6 need not used to indicate a course of action permissible within the limits of the document 3.7 optional used to indicate a course of action permissible within the limits of the document 3.
PAGE 8
HP Record Log Profile 5 Synopsis Profile Name: HP Record Log Profile Version: 1.1.0 Organization: HP WBEM TC CIM Schema Version: 2.13 Central Class: HP_CommonRecordLog Scoping Class: Same as parent profile Extends: DMTF DSP1010, Record Log Profile 1.0 The HP Record Log Profile extends DMTF DSP1010 to add Record Log characteristics that are specific to HP systems. Table 1 – Related Profiles 8 Profile Name Organization Version Relationship P00100 – HP Profile Registration Profile HP WBEM TC 1.
PAGE 9
HP Record Log Profile 6 Description HP_RegisteredProfile (see HP Profile Registration Profile) HP_ElementConformsToProfile (see HP Profile Registration profile) ManagedSystemElement (see HP Base Server Profile) 1..* Log RecordForLog RecordLog LogEntry (see DMTF Record Log Profile) (see DMTF Record Log Profile) 0..1 1..* HP_UseOfLog HP_LogManagesRecord HP_CommonRecordLog HP_CommonLogEntry 1..
PAGE 10
HP Record Log Profile Also described in this document is the HP_CommonRecordLogIndication for alerting a management client when log entries have been added/deleted/updated. This profile describes the initial set of log objects for the WBEM Providers for HP Server and Storage implementations.
PAGE 11
HP Record Log Profile 7 Implementation Requirements TimeOfLastChange property must be updated whenever records are added, deleted or modified in the RecordLog. If the log supports the UpdateTimestamp property (i.e., the log entries keep both the creation and update time stamps), modified records must update the UpdateTimestamp if they are modified such that the MOWI analyzer must re-consider the records in its analysis.
PAGE 12
HP Record Log Profile The other option to using the Variable Arrays would be to subclass off HP_CommonLogEntry, if the error specific information is decided to be of enough general interest to warrant a subclass. Providers for components that do not have unique serial numbers must provide both the SerialNumber and ProductID if they expect to uniquely identify the component. This applies to both the system reporting the indication and the hardware associated with the indication. 7.
PAGE 13
HP Record Log Profile 7.2.3 HP_CommonLogEntry.DeviceManufacturer (Conditional) This property shall be conditionally supported when the device manufacturer is known and there is a device reporting the log entry event. 7.2.4 HP_CommonLogEntry.DeviceModel (Conditional) This property shall be conditionally supported when the device model is known and there is a device reporting the log entry event. 7.2.5 HP_CommonLogEntry.
PAGE 14
HP Record Log Profile 7.2.15 HP_CommonLogEntry.RawData This property shall be supported by providing raw binary data of the log entry suitable for programmatic consumption. 7.2.16 HP_CommonLogEntry.RecordDataType This property shall be supported by providing the format of the data returned in the RecordData property. 7.2.17 HP_CommonLogEntry.ServerHardwareArchitecture (Conditional) This property shall be conditionally supported when the log entry is a server log entry. 7.2.18 HP_CommonLogEntry.
PAGE 15
HP Record Log Profile 7.2.28 HP_CommonLogEntry. RecommendedActions[ ] (Optional) RecommendedActions are the actions to be taken to resolve the cause of the event. 7.2.29 HP_CommonLogEntry. ProbableCauseDescriptions[ ] (Optional) ProbableCauseDescriptions are the probable causes of the situation, which resulted in this event. 7.
PAGE 16
HP Record Log Profile 8 8.1 Methods Method: HP_CommonRecordLog.ClearLog() Implementations shall adhere to the requirements defined in DSP1010 for the method CIM_RecordLog.ClearLog() as inherited by HP_CommonRecordLog. 8.2 Method: HP_CommonRecordLog.RequestStateChange() Implementations shall adhere to the requirements defined in DSP1010 for the method CIM_RecordLog.RequestStateChange() as inherited by HP_CommonRecordLog.
PAGE 17
HP Record Log Profile Table 3 – HP_CommonLogEntry.Repair() Method Return Values Value 8.5 Description 0 Request was successfully executed 1 Method is not supported in the implementation 2 Error occurred 3 Timeout 4 Failed Profile Conventions for Operations Support for operations for each profile class (including associations) is specified in the following subclauses. Each sub-clause includes either a statement “All operations are supported as described by DSP200 v1.
PAGE 18
HP Record Log Profile 9 9.1 Use Cases Object Diagrams CIM_ElementConformsToProfile system1: HP_ComputerSystem profile1:CIM_RegisteredProfile rec2: HP_CommonLogEntry RegisteredName: Base System HP_UseOfLog HP_LogManagesRecord CIM_ReferencedProfile profile2:CIM_RegisteredProfile InstanceID: HPQ: log1.rec2 CreationTimeStamp: 2006.05.31 04:56 RecordFormat: *string DeviceID*uint8 Record* RecordData: *10.0.
PAGE 19
HP Record Log Profile 9.2 Identify the Logs by Name Select the HP_CommonRecordLog instances which Name property corresponds to the given name. 9.3 Actions based on HP_CommonRecordLog.LogPercentFull Management application can check the LogPercentFull and determine when to clear the log. If 85% of the log is full and no new events were received within next two minutes, then the management application clears the log. When the log is over 95% full, then the management application clears the log. 9.
PAGE 20
HP Record Log Profile 9.9 Actions based on HP_CommonLogEntry.Actionable In modular systems, management application can provide an option for repairing an event or not based on the Actionable property value. 9.10 HP_CommonLogEntry.ReportingEntity In a modular system, System Firmware on a particular partition could log an event related to some component in that partition. This property will reflect the details about the System Firmware, which is the actual entity that logged this event. 9.
PAGE 21
HP Record Log Profile CIMOM matches indication information with filters and subscription If there is a match CIMOM sets properties to values defined by SET command in filter CIMOM forwards indication to handler Client receives indication via handler Client processes indication Client can call getInstance() using the information in the RecordLogInstanceID to find the RecordLog that had the entry instance or instances matching the query criteria.
PAGE 22
HP Record Log Profile System1: HP_ComputerSystem * * HP_UseOfLog HP_UseOfLog * * Log1: HP_CommonRecordLog Log2 : HP_CommonRecordLog Name: “HP Hardware Log” Name: “Copy HP Hardware Log” 1 HP_LogManagesRecord 1 HP_LogManagesRecord * * Rec1 :HP_CommonLogRecord CreationTimeStamp:2006.05.31 14:34 Rec2 : HP_CommonLogRecord CreationTimeStamp:2006.05.31 04:56 Figure 5 – Copy of SEL instance diagram 22 Version 1.1.
PAGE 23
HP Record Log Profile 10 CIM Elements Table 4 – CIM Elements – HP Record Log Profile Element Name Requirement Description Classes HP_LogManagesRecord Mandatory See section 10.1 HP_CommonRecordLog Mandatory See section 0 HP_CommonLogEntry Mandatory See section 10.2 HP_RegisteredProfile Mandatory See section 10.5 HP_UseOfLog Mandatory See section 0 Indications HP_CommonRecordLogIndication 10.1 Optional See sections 7.3 and 10.
PAGE 24
HP Record Log Profile Table 6 – Class – HP_CommonLogEntry Properties Requirement Notes Caption Mandatory See section 7.2.1 Description Mandatory See section 7.2.2 DeviceManufacturer Conditional See section 7.2.3 DeviceModel Conditional See section 7.2.4 DeviceProductID Conditional See section 7.2.5 DeviceSerialNumber Conditional See section 7.2.6 DeviceType Conditional See section 7.2.7 DeviceVersion Conditional See section 7.2.8 LoggerType Mandatory See section 7.2.
PAGE 25
HP Record Log Profile Table 7 – Class – HP_CommonRecordLog Properties Requirement Notes TimeOfLastChange Mandatory See section 7.1.1 Caption Mandatory See section 7.1.2 Description Mandatory See section 7.1.3 LogPercentFull Optional See section 7.1.34 LastLogClearedTime Optional See section 7.1.35 LogBackUpDays Optional See section 7.1.36 10.4 HP_UseOfLog HP_UseOfLog extends the class CIM_UseOfLog for use only with HP_CommonRecordLog and HP_ComputerSystem.
PAGE 26
HP Record Log Profile 11 Durable Names and Correlatable IDs Table 10 – Durable Names generated by this Profile Class Durable Name(s) Source ID Information HP_CommonRecordLog SystemSerialNumber/ SystemProductID Serial number (and also the SystemProductID if serial number is not unique) for the system. This is a separate serial number than the one associated with any specific component in the system, such as CPUs, cells, chassis.
PAGE 27
HP Record Log Profile Table 11 – Correlatable IDs generated by this Profile Class Correlatable ID(s) Source ID Information CIM_RecordFor Log InstanceID Identifier of the instance of the Record. CIM_Indication IndicationIdentifier Unique identification of this instance of an indication on the system.
PAGE 28
HP Record Log Profile Class Correlatable ID(s) Source ID Information failure, would include in this array the IndicationIdentifier for the original indication for the failure. HP_CommonRe cordLogIndicatio n RecordLogInstanceID Identifier of the instance of the entry in the RecordLog. This can be used to identify the RecordLog with the new entries. HP_CommonRe cordLogIndicatio n LogRecordInstanceIDs[] Array of identifiers of of the instances of LogRecords.
PAGE 29
HP Record Log Profile Class Version 1.1.0 Correlatable ID(s) Source ID Information indication.
PAGE 30
HP Record Log Profile ANNEX A (normative) Change Log 30 Version Date Description 0.1 5/15/06 Initial Draft 0.2 6/1/06 Changes suggested by Barb Craig. Added use cases; Durable and Correlatable id’s. 0.3 6/2/06 Added Severity property for CommonLogEntry; minor formatting changes. 0.4 6/9/06 Updated object diagram profile instances. 0.5 6/21/06 Removed the HP_EnabledLogicalElementCapabilities and HP_ElementCapabilities classes (no new information in the HP profile vs.
PAGE 31
HP Record Log Profile ANNEX B (informative) Acknowledgments Version 1.1.
PAGE 32
HP Record Log Profile ANNEX C (informative) Included WBEM TC CR Numbers CR Number 32 Date Title Version 1.1.
PAGE 33
HP Record Log Profile Bibliography This section contains a list of the external references and dependencies for this specification. Version 1.1.