Event Filter Profile Document Number: DCIM1009 Document Type: Specification Document Status: Published Document Language: E Date: 2017-07-26 Version: 4.0.0 Version 4.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. If there is no 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. Copyright © 2017 Dell Inc. or its subsidiaries. All rights reserved.
Contents 1. Scope 5 2. Normative References 5 3. Terms and Definitions 5 3.1. 3.2. 3.3. 3.4. 3.5. 3.6. 3.7. 3.8. 3.9. 3.10. 3.11. 5 5 5 5 5 6 6 6 6 6 6 4. Conditional Mandatory May Optional Referencing profile Shall FQDD Interop Namespace Implementation Namespace ENUMERATE GET Symbols and Abbreviated Terms 6 4.1. 4.2. 4.3. 4.4. 4.5. 6 6 6 6 6 CIM iDRAC CMC LIFO EF 5. Synopsis 6 6. Description 7 7. Implementation Description 8 7.1. 7.2. 7.3. Version 4.0.
7.3.3. 8. Properties 11 Methods 12 8.1. 8.2. 8.3. 12 13 14 DCIM_EFConfigurationService.SetEventFilterByCategory() DCIM_EFConfigurationService.SetEventFilterByInstanceIDs() DCIM_EFConfigurationService.SimulateTestEvent() 9. Use Cases 15 10. CIM Elements 15 11. Privilege and License Requirement 15 Version 4.0.
1. Scope The Dell Event Filter Profile provides the management capabilities to view the event filters and set actions and notifications for the events. 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. • DMTF DSP1033, Profile Registration Profile 1.0.
3.6. Shall Indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted 3.7. FQDD Fully Qualified Device Descriptor is used to identify a particular component in a system. 3.8. Interop Namespace Interop Namespace is where instrumentation instantiates classes to advertise its capabilities for client discovery. 3.9.
Implementation Namespace: root/dcim Central Class: DCIM_EFConfigurationService Scoping Class: DCIM_SPComputerSystem The Dell Event Filter Profile is an autonomous profile that provides the management capabilities to filter the events of a managed system element. DCIM_EFConfigurationService shall be the Central Class. Table 1 identifies profiles that are related to this profile. Table 1. Related Profiles Profile Name Organization Version Relationship Profile Registration DCIM 1.0 Reference 6.
DCIM_EFConfigurationService DCIM_EventFilter Implementation Namespace DCIM_LCElementConformsToProfile Interop Namespace CPUProfile : LCRegisteredProfile RegisteredOrganization : 1 (Other) RegisteredName : Event Filter RegisteredVersion : 1.0.0 OtherRegisteredOrganization : “DCIM” Figure 1. 7. Event Filter Profile Implementation Implementation Description This section describes the requirements and guidelines for implementing Dell Event FilterEvent Filter Profile. Table 2.
7.1.1. Resource URIs for WinRM® The class Resource URI shall be “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_EFConfigurationService?__cimnamespace=root/dcim” The key properties shall be the SystemCreationClassName, CreationClassName, SystemName, Name. The instance Resource URI for DCIM_EFConfigurationService instance shall be: “http://schemas.dell.
The key property shall be the InstanceID. The instance Resource URI for DCIM_EventFilter instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_EventFilter?__cimnamespace=root/dcim+InstanceID=” 7.2.2. Operations The following table details the implemented operations on DCIM_EventFilter. Table 5. DCIM_EventFilter – Operations Operation Name Requirements Required Input Get Mandatory Instance URI Enumerate Mandatory Class URI 7.2.3.
Property Name Type Requirements Additional Requirements The property array shall have the following value: 0(None), PossibleNotifications[] uint16 Mandatory PossibleNotificationDescriptions[] string 7.3. Mandatory • • • • • • 1(IPMI Alert), 2(SNMP Trap), 3(Email Alert), 4(LCD), 5(OS Log), 6 (WS-Event). The property array shall have the following value: “None”, "IPMI Alert", "SNMP Trap", "Email Alert", "LC Log", "LCD", "OS Log".
Properties Requirement Type Description RegisteredVersion Mandatory String This property shall have a value of “1.0.0”. RegisteredOrganization Mandatory Uint16 This property shall have a value of 1 (Other). OtherRegisteredOrganization Mandatory String This property shall match “DCIM” AdvertisedTypes[] Mandatory Uint16 This property array shall contain [1(Other), 1 (Other)].
Qualifiers Name Type Description/Values OUT MessageID string Error Message ID- can be used to index into Dell Message registry files OUT Message string Error Message in English corresponding to MessageID is returned if the method fails to execute OUT MessageArguments[] string Substitution variables for dynamic error messages Table 11. DCIM_EFConfigurationService.
Qualifiers Name Type Description/Values OUT Message string Error Message in English corresponding to MessageID is returned if the method fails to execute OUT MessageArguments[] string Substitution variables for dynamic error messages Table 14. DCIM_EFConfigurationService.SetEventFilterByInstanceIDs() Method: Standard Messages MessageID (OUT parameter) Message RAC038 Cannot perform the operation due to an unknown error in iDRAC.
Table 17. DCIM_EFConfigurationService.SetEventFilterByInstanceIDs() Method: Standard Messages MessageID (OUT parameter) Message RAC038 Cannot perform the operation due to an unknown error in iDRAC. RAC039 Invalid parameter value for %s EFMessageIDs RAC040 Missing parameter(s) %s EFMessageIDs 9. Use Cases See Lifecycle Controller (LC) Integration Best Practices Guide. 10. CIM Elements No additional details specified. 11.