Fiber Channel Profile 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 25 Document Number: DCIM1056 Document Type: Specification Document Status: Published Document Language: E Date: 2012-12-30 26 Version: 1.0.
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 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.
67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 CONTENTS 1 2 3 4 5 6 Scope .................................................................................................................................................... 5 Normative References ........................................................................................................................... 5 Terms and Definitions ............................................................................
96 Figures 97 98 Figure 1 – Fiber Channel Profile: Class Diagram ....................................................................................... 11 99 Tables 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 Table 1 – Related Profiles ...........................................................................................................................
Fiber Channel Profile 141 142 1 143 144 145 146 The Fiber Channel Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of fiber channel host bus adapters (FC HBA). The FC HBAs are modeled as views and attributes where there is a view for each individual controller and multiple attributes that allow FC HBA configuration. 147 2 148 Refer to the following documents for more information.
o 178 DCIM_LCRegisteredProfile.mof 179 6 Version 1.0.
180 3 Terms and Definitions 181 For the purposes of this document, the following terms and definitions apply. 182 183 3.1 184 185 3.2 186 187 188 3.3 189 190 191 3.4 192 193 3.5 194 195 3.6 196 197 3.7 198 199 200 3.8 201 202 203 3.9 204 205 206 3.10 207 208 209 3.11 210 211 3.12 can - Used for statements of possibility and capability, whether material, physical, or causal. cannot - Used for statements of possibility and capability, whether material, physical, or causal.
212 213 3.13 214 215 Interop Namespace: root/interop is where instrumentation instantiates classes to advertise its capabilities for client discovery. 216 217 3.14 218 219 Implementation Namespace: root/dcim is where instrumentation instantiates classes relevant to executing core management tasks. 220 3.15 ENUMERATE - Refers to WS-MAN ENUMERATE operation as described in Section 8.2 of 221 222 Interop Namespace: root/interop Implementation Namespace: root/dcim DSP0226_V1.1 and Section 9.
226 4 227 228 4.1 229 230 231 4.2 232 233 4.3 234 235 236 4.4 237 238 4.5 239 240 4.6 241 242 4.7 243 244 4.8 245 246 4.9 247 248 4.
251 5 Synopsis 252 Profile Name: Fiber Channel 253 Version: 1.0.0 254 Organization: Dell Inc. 255 CIM Schema Version: 2.26 Experimental 256 Central Class: DCIM_FCService 257 Scoping Class: CIM_ComputerSystem 258 259 260 261 The Fiber Channel Profile extends the management capability of the referencing profiles by adding the capability to describe fibre channel (FC) controllers in a simple way.
DCIM_LCRegisteredProfile RegisteredProfile = “Fiber Channel” OtherRegisteredOrganization = “DCIM” Interop Namespace Implementation Namespace DCIM_LCElementConformsToProfile DCIM_FCService DCIM_FCView DCIM_FCCapabilities DCIM_FCStatistics CIM_BIOSAttribute DCIM_FCAttribute DCIM_FCEnumeration DCIM_FCInteger DCIM_FCString 284 Figure 1 – Fiber Channel Profile: Class Diagram 285 286 6.
296 Table 2 - FC HBA FQDD examples FQDD Friendly Name FC.Slot.3-2 FC HBA in Slot 3 Port 2 FC.Mezzanine.1B-1 FC HBA in Mezzanine 1 Port 1 297 298 6.2 299 300 301 Virtual address attributes include the following attributes: Virtual World Wide Node Name (VirtualWWN) Virtual World Wide Port Name (VirtualWWPN) 302 303 The default values of these virtual attributes is equal to the permanent addresses programmed onto the controller. 304 305 To set these attributes, see Section 8.1 and 8.
Table 3 – CIM Elements: Fiber Channel Profile 325 Element Name Requirement Description DCIM_FCService Mandatory The class maybe implemented in the Implementation Namespace: root/dcim. See sections 7.8 DCIM_FCView Mandatory The class shall be implemented in the Implementation Namespace: root/dcim. See section 7.1 DCIM_FCCapabilities Mandatory DCIM_FCStatistics Classes 1 The class shall be implemented in the Implementation Namespace: root/dcim. See section 7.
337 7.1.2 Operations 338 The following table lists the implemented operations on DCIM_FCView. Table 4 – DCIM_FCView - Operations 339 Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 340 7.1.3 Class Properties 341 342 343 344 The following table details the implemented properties for DCIM_FCView instance representing a FC HBA in a system.
Property Name HardZoneAddress Requirement Mandatory Type Requirement and description Uint32 This property represents the Hard Zone Address. HardZoneEnable Mandatory Uint8 This property represents the Hard Zone Enable. 0 - Unknown 2 – Enabled 3 – Disabled LinkDownTimeout Optional Uint32 This property represents the Link Down Timeout in miliseconds. LinkStatus Mandatory Uint8 This property represents the Link Status.
Property Name Requirement WWN Type Requirement and description String This property represents the World Wide Name. String This property represents the World Wide Port Name. Mandatory WWPN Mandatory FC HBA Capabilities – DCIM_FCCapabilities 346 7.2 347 This section describes the implementation for the DCIM_FCCapabilities class. 348 This class shall be instantiated in the Implementation Namespace: root/dcim. 349 7.2.1 350 351 The class Resource URI shall be “http://schemas.dell.
Property Name Requirement Type Requirement and description FCMaxNumberExchanges Mandatory uint16 This property represents the maximum number of exchanges FCMaxNPIVPerPort Mandatory uint16 This property represents the maximum NPIV per port FCMaxNumberOfFCTargets Mandatory uint16 This property represents the maximum number of FC Targets supported FCMaxNumberOutStandingCommands Mandatory uint16 This property represents the maximum number of outstanding commands across all connections FlexAddress
376 7.3.2 Operations 377 The following table lists the implemented operations on DCIM_FCStatistics. 378 Table 8 – DCIM_FCStatistics - Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 379 7.3.3 Properties 380 381 382 383 The following table details the implemented properties for DCIM_FCStatistics instance representing FC port statistics in a system.
Property Name Requirement Type Requirement and description OSDriverState Mandatory uint8 This property represents OS driver state 0 – Unknown 1 – Other 2 – Not Applicable 3 – Operational 4 – Non-operational 385 Version 1.0.
386 7.4 DCIM_FCEnumeration 387 This section describes the implementation for the DCIM_FCEnumeration class. 388 Each DCIM_FCEnumeration instance is logically associated to a DCIM_FCView instance. 389 This class shall be instantiated in the Implementation Namespace:root/dcim. 390 7.4.1 391 392 The class Resource URI shall be “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_FCEnumeration?__cimnamespace=root/dcim” 393 The key property shall be the InstanceID.
Table 11 – Class: DCIM_FCEnumeration 406 Properties Type Notes Additional Requirements InstanceID String Mandatory The property value shall be formed as follows: “:”. AttributeName String Mandatory The property value shall be from the “AttributeName” column in Tables in section 7.7. AttributeDisplayName String Mandatory The property value shall be NULL.
Table 12 – DCIM_FCString - Operations 422 Operation Name Get Enumerate DCIM_FCService.SetAttributte() DCIM_FCService.SetAttributes() Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI See section 8.1 See section 8.2 423 424 7.5.3 425 426 427 428 The following table details the implemented properties for DCIM_FCString instance representing a FC HBA string attribute.
Table 13 – Class: DCIM_FCString 429 Properties Type Notes Additional Requirements InstanceID String Mandatory The property value shall be formed as follows: “:”. AttributeName String Mandatory The property value shall be from the “AttributeName” column in Tables in section 7.7. AttributeDisplayName String Mandatory The property value shall be NULL.
440 441 442 The instance Resource URI for DCIM_FCInteger instance shall be: http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_FCInteger?__cimnamespace=root/dcim+InstanceID= : 443 where is the FQDD property value, and is the AttributeName property value. 444 7.6.2 445 The following table lists the implemented operations on DCIM_FCInteger. Operations Table 14 – DCIM_FCInteger - Operations 446 Operation Name Get Enumerate DCIM_FCService.
Table 15 – Class: DCIM_FCInteger 453 Properties Type Requirement Additional Requirements InstanceID String Mandatory The property value shall be formed as follows: “:”. AttributeName String Mandatory The property value shall be from the “AttributeName” column in Tables in section 7.7. AttributeDisplayName String Mandatory The property value shall be NULL.
AttributeName PortSpeed 465 466 467 Attribute Description IsReadOnly Port Speed FALSE PossibleValues Description ”Auto”, “1G”, “2G”, “4G”, “8G”, “16G” Link Speed The following table describes the values for the DCIM_FCInteger of this group. Each of the column headings correspond to a property name on the DCIM_FCInteger class. Each of the rows contain the values for the properties listed in the column headings.
Table 19 – DCIM_FCEnumeration Fiber Channel Target Configuration 487 AttributeName Attribute Description BootScanSelection 1 Boot Scan Selection IsReadOnly PossibleValues “Disabled”,” FirstLUN” “SpecifiedLUN” FALSE Description 1 Boot scan Selection The “FirstLUN” value in the PossibleValues array property shall be present only on the Qlogic TM 488 NOTE: 489 490 491 The following table describes the values for the DCIM_FCInteger of this group.
AttributeName FCTape 1 1 HardZone FramePayloadSize 1 1 Attribute Description IsReadOnly PossibleValues Description FC Tape Enable FALSE “Disabled”, “Enabled” FC Tape Enable Hard Zone Enable FALSE “Disabled”, “Enabled” Hard Zone Enable Frame Payload Size FALSE “Auto”, “512”, “1024”, “2048”, “2112” Frame Payload Size 508 NOTE: 509 510 511 The following table describes the values for the DCIM_FCInteger of this group.
AttributeName Attribute Description IsReadOnly Min Length Max Length PCIDeviceID PCI Device ID TRUE 4 4 BusDeviceFunction Bus:Device:Function TRUE 8 8 FamilyVersion Firmware Family Version TRUE 5 8 EFIVersion EFI TRUE 5 8 1 524 NOTE: 525 526 NOTE: The MaxLength property for the ChipMdl is specific to the FC card vendor. For example, for Emulex TM TM cards, the value is 6; for Qlogic 8Gb cards, the value is 15; and for Qlogic 16Gb cards, the value is 13. 527 7.
550 Table 26 – Class: DCIM_FCService 551 Properties and Methods Requirement Description SystemCreationClassName Mandatory The property value shall be “DCIM_ComputerSystem”. CreationClassName Mandatory The property value shall be “DCIM_FCService”. ElementName Mandatory The property value shall be “FC Service” SystemName Mandatory The property value shall be “DCIM:ComputerSystem”. Name Mandatory The property value shall be “DCIM:FCService” 552 7.
RegisteredVersion Mandatory String This property shall have a value of “1.0.0”. RegisteredOrganization Mandatory String This property shall have a value of 1 (Other). OtherRegisteredOrganization Mandatory Uint16 This property shall match “DCIM” AdvertisedTypes[] Mandatory Uint16 AdvertiseTypeDescriptions[] Mandatory String ProfileRequireLicense[] Mandatory String This property array shall contain [1(Other), 1 (Other)].
Table 29 – DCIM_FCService.SetAttribute( ) Method: Return Code Values 587 Value Description 0 Completed with no error 2 Failed Table 30 – DCIM_FCService.SetAttribute( ) Method: Parameters 588 Qualifiers Name Type Description/Values IN, REQ Target String FQDD of the FC IN, REQ AttributeName String Shall contain the AttributeName property value for the attribute to be modified. IN, REQ AttributeValue[] String Shall contain the desired attribute value.
MessageID (OUT parameter) Message MessageArguments[] FC011 Configuration job already created, pending data cannot be deleted FC012 No pending data present to delete FC013 Invalid AttributeName AttributeName FC014 Invalid AttributeValue for AttributeName AttributeName FC015 AttributeValue cannot be changed for read only AttributeName AttributeName FC016 AttributeValue cannot be changed for disabled AttributeName AttributeNa
Qualifiers Name Type Description/Values IN, REQ AttributeValue[] String Shall contain the desired attribute values. If the value is valid, the CurrentValue or PendingValue property of the specified attribute will be modified. OUT SetResult[] String Returns: "Set CurrentValue property" when the attributes current value is set. “Set PendingValue property” when the attributes pending value is set.
MessageID (OUT parameter) Message MessageArguments[] FC015 AttributeValue cannot be changed for read only AttributeName AttributeName FC016 AttributeValue cannot be changed for disabled AttributeName AttributeName FC017 Cannot perform the operation due to an unknown error in iDRAC Set operation failed as the attribute is read only. FC018 An instance of Export or Import System Configuration is already running. LC062 605 8.3 DCIM_FCService.
Table 36 – DCIM_FCService.CreateTargetedConfigJob( ) Method: Parameters 629 630 631 632 Qualifiers Name Type Description/Values IN, REQ Target String FQDD of the FC 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.
MessageID (OUT parameter) Message MessageArguments[] cannot create Configuration job.
Table 40 – DCIM_FCService.
649 10 CIM Elements 650 No additional details specified. 651 11 Privilege and License Requirement 652 653 654 The following table describes the privilege and license requirements for the listed operations. For the detailed explanation of the privileges and licenses, refer to the Dell WSMAN Licenses and Privileges specification.
ANNEX A (informative) 657 658 659 660 Change Log 661 Version Date 1.0.0 Description Initial version. 1.0.0 8/30/2012 Adding DCIM_FCCapabilities and DCIM_FCStatistics. 1.0.0 9/26/2012 Remove from DCIM_FCView: PortEnable, PortStatus, OSDriverState, FirstFCTargetConnect, SecondFCTargetConnect 662 663 40 Version 1.0.