Simple NIC Profile Document Number: DCIM1032 Document Type: Specification Document Status: Published Document Language: E Date: 2010-08-10 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. © 2010 Dell Inc. All rights reserved.
CONTENTS 1 2 Scope .............................................................................................................................................. 5 Normative References...................................................................................................................... 5 2.1 Approved References ............................................................................................................ 5 2.2 Other References...................................................
Figures Figure 1 – Simple NIC Profile: Class Diagram .......................................................................................... 8 Tables Table 1 – Related Profiles........................................................................................................................ 8 Table 2 – CIM Elements: Simple NIC Profile ............................................................................................ 9 Table 3 – DCIM_NICView - Operations....................................
Simple NIC Profile 1 Scope The Simple NIC Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of NIC network controllers. The NIC controllers are modeled as views and attributes where there is a view for each individual controller and multiple attributes that allow configuration of the NIC. 2 Normative References The following referenced documents are indispensable for the application of this document.
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.
Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of DSP0227_V1.0 4 Symbols and Abbreviated Terms 4.1 CIM Common Information Model 4.2 iDRAC integrated Dell Remote Access Controller – management controller for blades and monolithic servers 4.3 CMC Chassis Management Controller – management controller for the modular chassis 4.
Table 1 – Related Profiles 6 Profile Name Organization Version Relationship Profile Registration Profile DMTF 1.0 Mandatory Description The Simple NIC Profile describes NIC controller’s representation and configuration. The profile also describes the relationship of the Simple NIC classes to the DMTF/Dell profile version information. Figure 1 represents the class schema for the Simple NIC Profile. For simplicity, the prefix CIM_ has been removed from the names of the classes.
7 Implementation Requirements Requirements and guidelines for propagating and formulating certain properties of the classes are discussed in this section. Methods are listed in section 8. Table 2 shows the instances of CIM Elements for this profile. Instances of the CIM Elements shall be implemented as described in Table 2. Sections 7 (“Implementation Requirements” and “Methods”) may impose additional requirements on these elements.
The key property shall be the InstanceID. The instance WBEM URI for DCIM_NICView instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_NICView?__cimnamespace=+InstanceID=” 7.1.2 Operations The following table details the implemented operations on DCIM_NICView. Table 3 – DCIM_NICView - Operations Operation Name Get Enumerate 7.1.
SlotType Mandatory string LastSystemInventoryTime Mandatory string Mandatory LastUpdateTime string 7.2 Slot type of the PCI. This property provides the last time \"System \"Inventory Collection On Reboot(CSIOR)\" was performed. The value is represented as yyyymmddHHMMSS. This property provides the last time the data was updated. The value is represented as yyyymmddHHMMSS DCIM_NICEnumeration This section describes the implementation for the DCIM_NICEnumeration class.
Table 6 – Class: DCIM_NICEnumeration Properties Notes Additional Requirements InstanceID Mandatory The property value shall be formed as follows: “:”. AttributeName Mandatory The property value shall be from the “AttributeName” column in Table 7 – CurrentValue Mandatory The property value shall be one of the values in the “PossibleValues” column at the corresponding row in Table 7 – .
Table 7 – DCIM_NICEnumeration Attributes AttributeName Description PossibleValues TcpIpViaDHCP Acquiring TCP/IP configuration via DHCP for iSCSI. “Disabled”, “Enabled” IscsiViaDHCP Acquire iSCSI parameters via DHCP. “Disabled”, “Enabled” ChapAuthEnable Enable/Disable CHAP authentication for iSCSI. “Disabled”, “Enabled” Enable/Disable booting to iSCSI target after logon. “Disabled”, “Enabled”, “One Time Disabled” TcpTimestmp Enable/Disable TCP timestamp for iSCSI.
7.3.2 Operations The following table details the implemented operations on DCIM_NICString. Table 8 – DCIM_NICString - Operations Operation Name Get Enumerate DCIM_NICService.SetAttributte() DCIM_NICService.SetAttributes() 7.3.3 Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI See section 8.1 See section 8.2 Properties The following table details the implemented properties for DCIM_NICString instance representing a NIC controller string attribute.
The AttributeValue string shall have equal or higher number of characters than the MinLength property value from the corresponding row. The AttributeValue shall conform to the ValueExpression form from the corresponding row. Table 10 – DCIM_NICString Attributes AttributeName Description Chip Type/ Revision.
This class shall be instantiated in the Implementation Namespace. 7.4.1 WBEM URIs for WinRM® The class WBEM URI shall be “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_NICInteger?__cimnamespace=” The key property shall be the InstanceID. The instance WBEM URI for DCIM_NICInteger instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_NICInteger?__cimnamespace=+InstanceID= ” 7.4.
Table 12 – Class: DCIM_NICInteger Properties Notes Additional Requirements InstanceID Mandatory The property value shall be formed as follows: “:”. AttributeName Mandatory The property value shall be from the “AttributeName” column in Table 13 CurrentValue Mandatory The property value shall match the format described in “Value Expression” column at the corresponding row in Table 13.
Table 13 – DCIM_NICInteger Attributes AttributeName Description IsReadOnly LowerBound UpperBound BlnkLeds Blink LEDs for a duration up to 15 seconds. FALSE 0 15 LnkUpDelayTime Configure link up delay time in seconds (0..255) for iSCSI. FALSE 0 255 LunBusyRetryCnt Configure number of retries in 2 second intervals when LUN is busy (0..60) for iSCSI. FALSE 0 60 FirstTgtTcpPort Configure target TCP port number (1..65535) for iSCSI first target.
7.5.3 Properties The following table details the implemented properties for DCIM_NICService instance representing a system in a system. The “Requirements” column shall denote the implementation requirement for the corresponding property. If the column “Property Name” matches the property name, the property either shall have the value denoted in the corresponding column “Additional Requirement”, or shall be implemented according to the requirements in the corresponding column “Additional Requirement”.
name, the property either shall have the value denoted in the corresponding column “Additional Requirements”, or shall be implemented according to the requirements in the corresponding column “Additional Requirements”. Table 17 – Class: CIM_RegisteredProfile Properties Requirement Description RegisteredName Mandatory This property shall have a value of “Simple NIC”. RegisteredVersion Mandatory This property shall have a value of “1.0.0”.
Qualifiers Name Type Description/Values OUT SetResult String Returns: "Set CurrentValue property" when the attributes current value is set. “Set PendingValue” when the attributes pending value is set. OUT RebootRequired String Returns: “Yes” if reboot is required, “No” if reboot is not required. OUT MessageID String Error MessageID OUT Message String Error Message OUT MessageArguments[] String Error MessageArguments 8.2 DCIM_NICService.
Qualifiers Name Type Description/Values OUT SetResult[] String Returns: "Set CurrentValue property" when the attributes current value is set. “Set PendingValue property” when the attributes pending value is set. OUT RebootRequired[] String Returns: “Yes” if reboot is required, “No” if reboot is not required. OUT MessageID[] String Error MessageID OUT Message[] String Error Message OUT MessageArguments[] String Error MessageArguments 8.3 DCIM_NICService.
Table 23 – CreateTargetedConfigJob( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ Target String FQDD of the NIC IN RebootJobType Uint16 Shall contain the requested reboot type: 1 - PowerCycle 2 - Graceful Reboot without forced shutdown 3 - Graceful Reboot with forced shutdown. IN ScheduledStartTime String Start time for the job execution in format: yyyymmddhhmmss. The string "TIME_NOW" means immediate.
Qualifiers Name Type Description/Values OUT MessageArguments[] String Error MessageArguments 9 Use Cases This section contains use cases for the Dell NIC Profile. For the general instance and class URI structure, see Section Error! Reference source not found. and Section Error! Reference source not found., respectively. Note that URIs in this section are in form of WBEM URIs for WinRM®. 9.
9.2 Inventory of NICs in system ENUMERATE the DCIM_NICView class to view all available instances of the class Class URI: http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_NICView?__cimnamespace=root/dcim The instance information of all available NICs will be returned 9.3 Get the first NIC’s information The URI for getting particular instance information is deterministic (i.e the InstanceID will be unique for each instance) For the first NIC in the system, the instance URI will be: http://schemas.
9.6 Apply SetAttribute(s) pending values for a particular NIC A) B) To invoke the CreateTargetedConfigJob( ) method, construct input parameters per Table 23 and use the particular NIC’s FQDD INVOKE CreateTargetedConfigJob( ) method Class URI: http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_NICService?__cimnamespace=root/dcim C) 9.
ANNEX A (informative) Related MOF Files Dell Tech Center MOF Library: http://www.delltechcenter.com/page/DCIM.Library.MOF Related Managed Object Format (MOF) files: DCIM_NICService DCIM_NICView DCIM_NICEnumeration DCIM_NICInteger DCIM_NICString DCIM_LCElementConformsToProfile DCIM_LCRegisteredProfile Version 1.0.