Dell Lifecycle Controller Web Services Interface Guide for Windows A Dell Technical White Paper about the Best Practices to be followed for using the WS-Man—based Remote Services provided by iDRAC and Lifecycle Controller Dell Engineering December 2013 A Dell Best Practices
Revisions Date Description August 2013 Initial release Dell, the DELL logo, and the DELL badge are trademarks of Dell Inc. Symantec, NetBackup, and Backup Exec are trademarks of Symantec Corporation in the U.S. and other countries. Microsoft, Windows, and Windows Server are registered trademarks of Microsoft Corporation in the United States and/or other countries. Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products.
Dell Lifecycle Controller Web Services Interface Guide for Windows
Contents Revisions ............................................................................................................................................................................................. 2 Executive Summary ........................................................................................................................................................................ 14 1 Introduction ...............................................................................................
.5.1 Modify User Name (Using DMTF Model) ................................................................................................................. 40 5.5.2 Modify Password (Using DMTF Model) ..................................................................................................................... 43 5.5.3 Modify Account State (Using DMTF Model) .............................................................................................................44 5.5.
7.10.1 Install from Repository ................................................................................................................................................. 64 7.10.2 Get Repo-Based Update List....................................................................................................................................... 65 8 Power State Management ......................................................................................................................................
11 Operating System Deployment ........................................................................................................................................... 104 11.1 OS Deployment Profile Implementation Conformance ...................................................................................... 104 11.2 Checking OS Deployment Service Availability ....................................................................................................... 104 11.
12.2.4Get CSIOR Component Configuration Recovery (CCR) Attribute ..................................................................... 128 12.2.5 Get Part Firmware Update Attribute ........................................................................................................................ 129 12.3 Re-Initiate Auto-Discovery Client ............................................................................................................................ 130 12.
13.4 Create Partition ........................................................................................................................................................... 158 13.5 Create Partition using Image .................................................................................................................................... 160 13.6 Delete Partition .........................................................................................................................................
16.1 Listing the RAID Inventory-Enumeration Class .................................................................................................... 203 16.2 Getting a RAID Enumeration Instance ................................................................................................................... 205 16.3 Listing the RAID Inventory-Integer Class ............................................................................................................... 206 16.
16.18.7 Deleting a Virtual Disk-DeleteVirtualDisk() ................................................................................................... 243 16.19 Setting Controller Attributes .................................................................................................................................... 244 16.19.1 Changing the Value of a RAID Controller Enumeration Attribute ........................................................... 244 16.19.
18.2.4 Clear the Backup Schedule ..................................................................................................................................270 18.3 Importing Server Profile .............................................................................................................................................270 18.3.1 Importing Server Profile from iDRAC vFlash Card-RestoreImage() ...................................................................270 18.3.
23.4 Listing the FC Inventory-Integer Class ................................................................................................................... 309 23.5 Listing the FC Inventory-Enumeration Class ........................................................................................................ 309 23.6 Changing the FC Attributes-SetAttribute() ............................................................................................................. 310 23.
Executive Summary Dell PowerEdge servers are equipped with the integrated Dell Remote Access Controller and the Lifecycle Controller solution for remote management―iDRAC6 on 11th generation servers and iDRAC7 on 12th generation servers. These servers can be remotely managed by using the WS-Man services for configuration, update, deployment, and maintenance. This whitepaper describes the various WS-Man interfaces with examples about using different interfaces in a Windows environment.
1 Introduction This document serves as a guideline for utilizing the functionality available from embedded Lifecycle Controller Remote Enablement Web Services interfaces. The purpose of this document is to provide information and examples for utilizing the Web services for Management (WS-Man) management protocol using Windows WinRM and open source WSMANCLI command line utilities. Examples and invocation information is provided for the following functionality.
2 References Dell 12th generation PowerEdge server resources: http://www.delltechcenter.com/12thGen Dell CIM Profiles: http://www.delltechcenter.com/page/DCIM.Library.Profile Managed Object Format (MOF) files: http://www.delltechcenter.com/page/DCIM.Library.MOF WinRM Scripting API, MSDN: http://msdn.microsoft.com/en-us/library/aa384469(VS.85).aspx Openwsman CLI: http://www.openwsman.org/project/wsmancli DMTF Common Information Model (CIM) Infrastructure Specification (DSP0004): http://www.dmtf.
3 Overview The remote interface guidelines provided in this document are illustrated by command line interface (CLI) examples of the WS-Man protocol Web services APIs that expose the remote management capabilities of the Dell Lifecycle Controller. The command line examples are from the Microsoft® Windows® and Linux 4 5 environments using WinRM and WSMANCLI respectively.
EXAMPLE: winrm e cimv2/root/dcim/DCIM_OSDeploymentService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -encoding:utf-8 -a:basic 3.2 WS-Man Security and Time Parameters 3.2.
3.2.3 Improving WinRM Enumeration Performance When an enumeration command is executed, the default WinRM configuration gets only 20 instances at a time and therefore slows down the system drastically. Changing the WinRM configuration to allow a greater number, such as 50, will reduce the time taken by the enumeration operations. Execute the following command to get instances in groups of up to 50.
ddddddddhhmmss.mmmmmm Where: dddddddd is the number of days hh is the remaining number of hours mm is the remaining number of minutes ss is the remaining number of seconds mmmmmm is the remaining number of microseconds The Lifecycle controller firmware update, and set attribute related methods that require a date time parameter, use the form YYYYMMDDhhmmss (Eg. 20090930112030).
UEFI Unified Extensible Firmware Interface AMEA Advanced Management Enablement Adapter HII Human Interface Infrastructure WS-Man WS-Management is a specification of a SOAP-based protocol for the management of servers, devices, applications and more Dell Lifecycle Controller Web Services Interface Guide for Windows
4 Discovery 4.1 Discovering Web Service Capability Determine if the target system supports the WinRM interface using the ‘identify’ command. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP0217_2.0.0.pdf EXAMPLE: winrm identify -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: IdentifyResponse ProtocolVersion = http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd ProductVendor = Openwsman Project ProductVersion = 2.2.4 4.
OtherRegisteredOrganization = DCIM RegisteredName = Memory RegisteredOrganization = 1 RegisteredVersion = 1.0.0 ... DCIM_RegisteredProfile AdvertiseTypeDescriptions = WS-Identify AdvertiseTypes = 1 Caption = null Description = null ElementName = null InstanceID = DCIM:CSRegisteredProfile:1 OtherRegisteredOrganization = null RegisteredName = Base Server RegisteredOrganization = 2 RegisteredVersion = 1.0.0 . . The above example shows that the DMTF Base Server profile version 1.0.0 is implemented. 4.
-u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -encoding:utf-8 -a:basic SkipCNcheck –SkipCAcheck OUTPUT: DCIM_CSRoleLimitedToTarget DefiningRole Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_Role SelectorSet Selector: CreationClassName = DCIM_Role, Name = DCIM:Role:9, __cimnamespace = root/dcim TargetElement Address = http://schemas.xmlsoap.
ResourceURI = http://schemas.dell.
5 Managing iDRAC Local User Accounts 5.1 Description of iDRAC Attributes Versus Standard DMTF Model The iDRAC user account management data model is represented by both DMTF and Dell Profiles. Both models are currently offered. The DMTF Profiles for Simple Identity Management and Role Based Authorization represent iDRAC user accounts and privileges.
Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.1 InstanceID = iDRAC.Embedded.1#Users.1#Enable IsReadOnly = true PossibleValues = Disabled, Enabled DCIM_iDRACCardEnumeration AttributeDisplayName = User Admin Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.2 InstanceID = iDRAC.Embedded.1#Users.
5.2.2 Privilege and Capabilities (Using iDRAC Attributes) Enumerating the DCIM_iDRACCardEnumeration class, Section 19.1, and parsing the output for the attribute AttributeDisplayName = User Admin IPMI LAN(or Serial) Privilege, will display all of the 16 possible user accounts and their respective status.
GroupDisplayName = Users GroupID = Users.1 InstanceID = iDRAC.Embedded.1#Users.1#IpmiSerialPrivilege IsReadOnly = true PossibleValues = User, Operator, Administrator, NoAccess. . 5.3 Manage Account Settings (Using iDRAC Attributes) When the account setting capability allows, the user name of an account may be modified by invoking the ApplyAttributes() method on the UserName property.
HELLO OUTPUT: When this method is executed, a jobid or an error message is returned. ApplyAttributes_OUTPUT ReturnValue = 4096 Job EndpointReference Address = https://127.0.0.1:443/wsman ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: __cimnamespace = root/dcim, InstanceID = JID_001296571842 5.3.
OUTPUT: When this method is executed, a jobid or an error message is returned. ApplyAttributes_OUTPUT ReturnValue = 4096 Job EndpointReference Address = https://127.0.0.1:443/wsman ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: __cimnamespace = root/dcim, InstanceID = JID_001296571842 5.3.
iDRAC.Embedded.1 Users.4#Enable Enabled Users.4#Password PASSWORDHERE OUTPUT: When this method is executed, a jobid or an error message is returned. ApplyAttributes_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
winrm i ApplyAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_iDRACCardService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_iDRACCardService +SystemName=DCIM:ComputerSystem +Name=DCIM:iDRACCardService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file: DracCard_PrivilegeChange.xml The input file, DracCard_ PrivilegeChange.xml, is shown below: PAGE 34http://www.dmtf.org/sites/default/files/standards/documents/DSP1034_1.0.1.pdf http://www.dmtf.org/sites/default/files/standards/documents/DSP1039_1.0.0.pdf 5.4.1 Account and Capabilities (Using DMTF Model) Example-A demonstrates standard ouput. Example-B demonstrates EPR mode output. EXAMPLE-A: winrm e http://schemas.dmtf.
EnabledDefault = 2 EnabledState = 2 Name = iDRAC.Embedded.1#Users.2 OrganizationName = DCIM RequestedState = 0 SystemCreationClassName = DCIM_SPComputerSystem SystemName = systemmc TransitioningToState = 12 UserID = root UserPassword . . . EXAMPLE-B: winrm e http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_Account -u:[USER] - p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -returntype:EPR OUTPUT-B: EndpointReference Address = http://schemas.xmlsoap.
EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_Account SelectorSet Selector: __cimnamespace = root/dcim, Name = iDRAC.Embedded.1#Users.2, CreationClassName = DCIM_Account, Sys temName = systemmc, SystemCreationClassName = DCIM_SPComputerSystem . . .
ElementNameEditSupported = false InstanceID = DCIM:IPMICLPAccountManagementCapabilities:1 MaxElementNameLen = 0 OperationsSupported = 3 To determine account state setting capabilities: 1. Get the CIM_Account class instance of interest using EnumerateEPR mode. 2. Enumerate the associators of the CIM_Account instance and search for CIM_EnabledLogicalElementCapabilities class instance. 3. The presence of “RequestedStatesSupported” determines which states could be set. 4. One exception is account index 0.
4. Enumerate the associators of the CIM_Role instance and search for CIM_Privilege class instance. An alternative to the above method, you can retrieve the specific CIM_Privilege instance by enumerating the class directly with filter. This method is similar to the example used to retrieve CIM_Account. EXAMPLE: winrm e http://schemas.dmtf.
Activities = null ActivityQualifiers = null ElementName = DCIM Local Privilege 3 InstanceID = DCIM:Privilege:3 PrivilegeGranted = true QualifierFormats = null RepresentsAuthorizationRights = false . . . Privilege setting capability is defined in the class CIM_RoleBasedManagementCapabilities associated with the CIM_Privilege class instance. This class contains the list of possible values used to assign privileges. Look for the property ActivityQualifiersSupported.
QualifierFormatsSupported = null SharedPrivilegeSupported = false SupportedMethods = 6 DCIM_IPMIRoleBasedManagementCapabilities ActivitiesSupported = null ActivityQualifiersSupported = null ElementName = IPMI Role Based Management Capabilities InstanceID = DCIM:IPMIRoleBasedManagementCapabilities QualifierFormatsSupported = null SharedPrivilegeSupported = false SupportedMethods = 6 5.5 Manage Account Settings (Using DMTF Model) 5.5.
-SkipCAcheck -encoding:utf-8 -a:basic -returntype:EPR When this command is executed, a list of objects will be returned. Below is a snippet of the output. OUTPUT-A: EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_Account SelectorSet Selector: __cimnamespace = root/dcim, Name = iDRAC.Embedded.1#Users.
-a:basic -encoding:utf-8 –SkipCACheck –SkipCNCheck When this method is executed, the particular object will be returned. Below is the output. OUTPUT-B: DCIM_Account CreationClassName = DCIM_Account ElementName = DCIM Account EnabledDefault = 2 EnabledState = 3 Name = iDRAC.Embedded.1#Users.
OUTPUT-C: DCIM_Account CreationClassName = DCIM_Account ElementName = DCIM Account EnabledDefault = 2 EnabledState = 3 Name = iDRAC.Embedded.1#Users.16 OrganizationName = DCIM RequestedState = 0 SystemCreationClassName = DCIM_SPComputerSystem SystemName = systemmc TransitioningToState = 12 UserID = testuser4 UserPassword = null UserID = testuser4 UserPassword = testuser4 D) If the account specified is new or not yet enabled, it will not be accessible.
requires an instance reference. The instance reference may be retrieved by adding EnumerateEPR mode to enumerate or get of the class. Note: The profile defines this property as string array of type octet string. In this implementation, the password is a string of type clear text. The security concern is resolved by transmission of this information only through secure HTTPS communication. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP1034_1.0.1.pdf http://www.dmtf.
RequestStateChange_OUTPUT ReturnValue = 0 Response status other than zero indicates failure and error message information may be provided. 5.5.4 Modify User Privilege (Using DMTF Model) When the account setting capability allows, the user account privileges may be modified by issuing a set() operation on the ActivityQualifiers property of the CIM_Privilege class instance associated with the CIM_Account class instance. The set() operation requires an instance reference.
To determine if the new password has been successfully set, try logging in with the new password. Ensure the account is enabled.
6 Firmware Inventory 6.1 Software Inventory Profile Specification The Dell Common Information Model (CIM) class extensions for supporting remote firmware inventory are defined in the Dell OS Software Update 2 and related MOFs 3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Inventory Profile. 6.
FQDD = USC.Embedded.1:LC.Embedded.1 IdentityInfoType = OrgID:ComponentType:ComponentID IdentityInfoValue = DCIM:firmware:28897 InstallationDate = 2012-01-15T22:22:32Z InstanceID = DCIM:INSTALLED#802__USC.Embedded.1:LC.Embedded.1 IsEntity = true MajorVersion = 1 MinorVersion = 0 RevisionNumber = 0 RevisionString = null Status = Installed SubDeviceID = null SubVendorID = null Updateable = true VendorID = null VersionString = 1.0.0.4846 impactsTPMmeasurements = false . . .
7 Firmware Update 7.1 Software Update Profile Specification The Dell Common Information Model (CIM) class extensions for supporting BIOS, component firmware, and embedded software update are defined in the Dell Software Update Profile 2 and related MOF files 3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Update Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 7.
JobStatus = Downloaded JobUntilTime = TIME_NA Message = Package successfully downloaded. MessageArguments = null MessageID = RED002 Name = Rollback:DCIM:AVAILABLE:NONPCI:159:2.1.4 Job status after invoking SetupJobQueue DCIM_LifecycleJob InstanceID = JID_001276741956 JobStartTime = 00000101000000 JobStatus = Scheduled JobUntilTime = 20100730121500 Message = Task successfully scheduled MessageArguments = null MessageID = JCP001 Name = Rollback:DCIM:AVAILABLE:NONPCI:159:2.1.
7.3 BIOS Firmware “Rollback” The InstallFromSoftwareIdentity() method is used for installation of a previous version of a component firmware that is available on the Lifecycle Controller (i.e. “rollback” of component firmware). All steps to complete a rollback successfully are listed below. Invoke InstallFromSoftwareIdentity() with the following parameters and syntax: [InstanceID]: This is the instanceID of the SoftwareIdentify that is to be used to rollback the firmware to a previous version.
InstallFromSoftwareIdentity_OUTPUT Job Address = http://schemas.xmlsoap.org/ws /2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1 /cimschema/2/DCIM_SoftUpdateConcreteJob SelectorSet Selector: InstanceID = JID_001276741956, __cimnamespace = root/dcim ReturnValue = null 7.
http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
ReturnValue = null 7.5 Update from Network Source A Firmware update can be achieved by invoking the InstallFromURI() method in the class DCIM_SoftwareInstallationService. Firmware update is performed in several stages as described in the next sections. The steps are demonstrated in examples in Section 7.6 and Section 7.7. Note: When using WSMAN command to initiate update jobs, make sure to wait for two seconds before submitting a second job in order to avoiding racing conditions. 7.5.
[URI-IP-ADDRESS]: This is the IP address of the location for Dell Update Package. The Dell Update Package will need to be the Windows type update package. The file share can be HTTP, CIFS, NFS, TFTP, or FTP type as shown below: HTTP Format: http://[IP ADDRESS]/[PATH TO FILE.exe] CIFS Format: cifs://WORKGROUP_NAME\[USERNAME]:[PASSWORD]@[URI-IP-ADDRESS]/ [FILE.exe];mountpoint=[DIRECTORYNAME] TFTP or FTP Format: tftp://[IP ADDRESS]/[PATH TO FILE.exe] ftp://[IP ADDRESS]/[PATH TO FILE.
2/root/dcim/DCIM_SoftwareInstallationService"> http://[URI-IP-ADDRESS]/[PATH-TO-EXE]/[FILE.exe] http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
SelectorSet Selector: InstanceID = JID_001265810325, __cimnamespace = root/dcim ReturnValue = null Missing XML parameters may yield the following error message: InstallFromURI_OUTPUT Message = Insufficient Method Parameters MessageID = SUP001 ReturnValue = null 7.7 Update BIOS from HTTP, CIFS Share, NFS Share, TFTP, or FTP The InstallFromURI() method takes the following input and downloads the Dell Update Package to the Lifecycle Controller in the target system.
It is available firmware on a NONPCI device. This refers BIOS version 2.1.4 EXAMPLE: winrm invoke InstallFromURI cimv2/root/dcim/DCIM_SoftwareInstallationService ?CreationClassName=DCIM_SoftwareInstallationService +SystemCreationClassName=DCIM_ComputerSystem +SystemName=IDRAC:ID+Name=SoftwareUpdate -file:UpdateInputBIOS.xml -u:[UserName] -p:[Password] -r:https://[IPADDRESS]/wsman:443 -SkipCNCheck auth:basic -encoding:utf-8 The above command takes in an input file named UpdateInputBIOS.
In the above sample, the [URI-IP-ADDRESS] must be replaced with the actual value of the IP address of the server that stores update content, [PATH-TO-EXE] must be replaced with the applicable path to the executable, [FILE.exe] must be replaced with the executable name, and [INSTANCEID] should be replaced with the actual InstanceID of the device to be updated. OUTPUT: When this method is executed, a jobid or an error message is returned.
winrm invoke CreateRebootJob cimv2/root/dcim/DCIM_SoftwareInstallationService ?CreationClassName=DCIM_SoftwareInstallationService +SystemCreationClassName=DCIM_ComputerSystem +SystemName=IDRAC:ID+Name=SoftwareUpdate -file:reboot.xml -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNCheck -auth:basic -encoding:utf-8 The syntax for reboot.xml is: PAGE 617.9 Automatic Updates Automatic Updates feature allows for periodic firmware updates at regular intervals as configured by the user. 7.9.1 Enable Automatic Update This method enables/disables the “Automatic Update Feature ” attribute. Example: winrm i SetAttribute http://schemas.dmtf.
ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cim-schema/2/ DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_859945354433, cimnamespace = root/dcim ReturnValue = 4096 Verify the value of “Automatic Update Feature” attribute from DCIM_iDRACCardEnumeration. It has to be “Enabled” to set Automatic update schedule. 7.9.
7.9.
7.10 Device Update from Repository This feature allows multiple firmware updates by specifying a network repository which contains a catalog of available updates. All applicable updates contained in the repository are applied to the system. Following two methods introduced as a part of DCIM_SoftwareUpdate profile InstallFromRepository: Initiate a job for device updates and creates a comparison report. GetRepoBasedUpdateList: Get the comparison report generated with InstallFromRepository 7.10.
InstallFromRepository_OUTPUT Job EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/ 2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_776094296053, __cimnamespace = root/dcim ReturnValue = 4096 7.10.
1 Intel(R) Ethernet 10G 4P X540/I350 rNDC BC:30:5B:ED:50:38 Network_Firmware_KTT4W_WN64_14.5.5_X03.
DCIM:INSTALLED#701__NIC.Integrated.1-1-1 FRMW 8086:1528:1028:1F61 8086:1521:1028:1F62
13.1.10 13.1.10
8 Power State Management 8.1 Description of Base Server Versus Power State Management Methods The remote control of a server power state (On, Off) and methodology for cycling power is available through data models specified in both the DMTF Base Server Profile and the DMTF Power State Management Profile. The Base Server Profile offers the RequestStateChange() method on the instance of the CIM_ComputerSystem class representing the server platform.
HealthState = 25 IdentifyingDescriptions = CIM:GUID, CIM:Tag, DCIM:ServiceTag Name = srv:system OperationalStatus = 6 OtherIdentifyingInfo = 4c4c4544-0036-3510-8034-b7c04f333231, mainsystemchassis, 7654321 PrimaryStatus = 3 RequestedState = 0 8.2.2 Power State Management Method The power state of the system is also reported by the PowerState property of the DCIM_CSAssociatedPowerManagementService class. Power State Management Profile: http://www.dmtf.org/sites/default/files/standards/documents/DSP1027_2.
ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/ 2/DCIM_CSPowerManageme ntService SelectorSet Selector: SystemCreationClassName = DCIM_SPComputerSystem, CreationClassName = D CIM_CSPowerManagementService, SystemName = systemmc, Name = pwrmgtsvc:1, __cimnamespace = root/dcim UserOfService EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
winrm e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/CIM_ElementCapabilities -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT (Part A): . . . DCIM_CSElementCapabilities Capabilities Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
EXAMPLE (Part B): winrm g http://schemas.dell.
http://www.dmtf.org/sites/default/files/standards/documents/DSP1027_2.0.0.pdf EXAMPLE (iDRAC case): winrm e http://schemas.dmtf.
17.18. 19. 1 5 20. (Graceful Shutdown Supported) (Power Cycle (Off - Soft Graceful)) (Power Cycling Supported) and 21.22. 23.24. 25. 1 6 (Graceful Shutdown Supported) (Power Cycle (Off - Hard Graceful)) (Off Hard Power Cycling Supported) and 26. 27.28.
?CreationClassName=DCIM_ComputerSystem +Name=srv:system" -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNcheck SkipCAcheck -encoding:utf-8 -a:basic @{RequestedState="2"} -skiprevocationcheck OUTPUT: RequestStateChange_OUTPUT ReturnValue = 0 Return values of zero indicate success, while others indicate failure and may include a corresponding error message. 8.4.
9 Hardware Inventory The Dell Common Information Model (CIM) class extensions for supporting remote hardware inventories are defined in the various Dell profiles and related MOFs 3. The Hardware Inventory allows users to remote query the inventory of hardware. Each of the hardware inventory classes return the attribute LastSystemInventoryTime, which is when the last time ‘collect system inventory on restart’ or CSIOR was run. See Section 12.1 for more details on CSIOR.
PartNumber = 0MU791A00 PrimaryStatus = 1 RedundancyStatus = 2 SerialNumber = CN7324597O0411 TotalOutputPower = 502 Type = 0 DCIM_PowerSupplyView DetailedState = Presence Detected FQDD = PSU.Slot.2 FirmwareVersion = 00.01.31 InputVoltage = 118 InstanceID = PSU.Slot.
http://www.delltechcenter.com/page/DCIM.Library.Profile Enumerate DCIM_FanView with the following parameters and syntax: EXAMPLE: winrm e cimv2/root/dcim/DCIM_FanView -u:[USER] -p:[PASSWORD] r:https://[IPADDRESS]/wsman:443 -auth:basic -encoding:utf-8 -SkipCACheck – SkipCNCheck OUTPUT: DCIM_FanView ActiveCooling = true BaseUnits = 19 CurrentReading = 4200 FQDD = Fan.Embedded.1A InstanceID = Fan.Embedded.
PrimaryStatus = 1 RateUnits = 4 RedundancyStatus = 2 UnitModifier = 0 VariableSpeed = true . . . 9.3 Memory Inventory This section describes the implementation for the DCIM_MemoryView class. The Dell Memory Profile describes platform’s physical memory. Each DIMM’s information is represented by an instance ofDCIM_MemoryView class. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
LastSystemInventoryTime = 20100331101859 LastUpdateTime = 20100325134947 ManufactureDate = Mon Jun 29 12:00:00 2009 UTC Manufacturer = Samsung MemoryType = 24 Model = DDR3 DIMM PartNumber = M391B2873DZ1-CH9 PrimaryStatus = 1 Rank = 1 SerialNumber = 85C6DF30 Size = 1024 Speed = 1333 DCIM_MemoryView BankLabel = A CurrentOperatingSpeed = 1067 FQDD = DIMM.Socket.A3 InstanceID = DIMM.Socket.
. . 9.4 CPU Inventory This section describes the implementation for the DCIM_CPUView class. The Dell CPU Profile describes platform’s CPUs. Each CPU’s information is represented by an instance of DCIM_CPUView class. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
Cache2PrimaryStatus = 1 Cache2SRAMType = 2 Cache2Size = 2048 Cache2Type = 5 Cache2WritePolicy = 0 Cache3Associativity = 14 Cache3ErrorMethodology = 5 Cache3Level = 2 Cache3PrimaryStatus = 1 Cache3SRAMType = 2 Cache3Size = 20480 Cache3Type = 5 Cache3WritePolicy = 0 Characteristics = 4 CurrentClockSpeed = 2266 ExternalBusClockSpeed = 5860 FQDD = CPU.Socket.2 InstanceID = CPU.Socket.
Voltage = 1.20 DCIM_CPUView CPUFamily = B3 CPUStatus = 1 Cache1Associativity = 7 Cache1ErrorMethodology = 5 . . . 9.5 iDRAC Card Inventory This section describes the implementation for the DCIM_iDRACCardView class. The Dell iDrac Profile describes the platform’s iDrac remote access card. Each remote access card’s information is represented by an instance of DCIM_iDRACCARDView class. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
SOLEnabledState = 1 URLString = https://192.35.10.1:443 9.6 PCI Device Inventory This section describes the implementation for the DCIM_PCIDeviceView class. The Dell PCI Profile describes platform’s PCI devices. Each PCI device’s information is represented by an instance of DCIM_PCIDeviceView class. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
PCIVendorID = 8086 SlotLength = 0002 SlotType = 0002 DCIM_PCIDeviceView BusNumber = 0 DataBusWidth = 0002 Description = 5520/5500/X58 I/O Hub PCI Express Root Port 3 DeviceNumber = 3 FQDD = P2PBridge.Embedded.4-1 FunctionNumber = 0 InstanceID = P2PBridge.Embedded.
9.7 Video Inventory This section describes the implementation for the DCIM_VideoView class. The Dell Video Profile describes platform’s videos. Each video controller’s information is represented by an instance of DCIM_VideoView class. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
SlotLength = 0002 SlotType = 0002 9.8 VFlash SD Card Inventory Each SD card partition is represented by an instance of DCIM_VFlashView that is used to represent the physical attributes of the virtual flash media, such as total size, available size, category etc. on which the partitions will reside. See Section 13 for more information. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
9.9 NIC Inventory and Configuration The NIC Profile describes NIC controller’s representation and configuration. The profile also describes the relationship of the NIC classes to the DMTF/Dell profile version information. See Section 15 for more information, including inventories for NICString, NICInteger, and NICEnumeration. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile Enumerate NICView with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
MinBandwidth = 0 NicMode = 3 PCIDeviceID = 1639 PCISubDeviceID = 236 PCISubVendorID = 1028 PCIVendorID = 14E4 PermanentFCOEMACAddress PermanentMACAddress = 00:21:9B:92:70:57 PermanentiSCSIMACAddress = 00:21:9B:92:70:58 ProductName = Broadcom NetXtreme Gigabit Ethernet - 00:21:9B:92:70:57 ReceiveFlowControl = 0 SlotLength = 0002 SlotType = 0002 TransmitFlowControl = 0 VendorName = null WWPN = null iScsiOffloadMode = 3 DCIM_NICView AutoNegotiation = 0 BusNumber = 1 ControllerBIOSVersion = 1.
PCIDeviceID = 1639 PCISubDeviceID = 236 PCISubVendorID = 1028 PCIVendorID = 14E4 PermanentFCOEMACAddress PermanentMACAddress = 00:21:9B:92:70:59 PermanentiSCSIMACAddress = 00:21:9B:92:70:5A ProductName = Broadcom NetXtreme Gigabit Ethernet - 00:21:9B:92:70:59 ReceiveFlowControl = 0 SlotLength = 0002 SlotType = 0002 TransmitFlowControl = 0 VendorName = null WWPN = null iScsiOffloadMode = 3 . . . 9.
CacheSizeInMB = 1024 CachecadeCapability = 1 ControllerFirmwareVersion = 20.10.1-0049 Device = 0 DeviceCardDataBusWidth = 1 DeviceCardManufacturer = DELL DeviceCardSlotLength = 3 DeviceCardSlotType = PCI Express x8 DriverVersion = null EncryptionCapability = 0 EncryptionMode = 0 FQDD = RAID.Integrated.1-1 Function = 0 InstanceID = RAID.Integrated.
SlicedVDCapability = 1 9.11 BIOS Inventory and Configuration The BIOS Management Profile extends the management capabilities of referencing profiles by adding the capability to represent and configure BIOS attributes, such as a Network Controller or IDE Controller. The individual BIOS attribute’s relationship with a respective device is also described. Additionally, the profile’s registration for the schema implementation version information is described.
InstanceID = BIOS.Setup.1-1:MemVolt IsReadOnly = true PendingValue = null PossibleValues = AutoVolt, Volt15V PossibleValuesDescription = Auto, 1.5V DCIM_BIOSEnumeration AttributeDisplayName = Serial Debug Output AttributeName = SerialDbgOut CurrentValue = Disabled Dependency = null DisplayOrder = 319 FQDD = BIOS.Setup.1-1 GroupDisplayName = Memory Settings GroupID = MemSettings InstanceID = BIOS.Setup.
InstanceID = BIOS.Setup.1-1:PasswordStatus IsReadOnly = false PendingValue = null PossibleValues = Unlocked, Locked PossibleValuesDescription = Unlocked, Locked . . . 9.12 System Inventory (Including CSIOR Attribute) This section describes the implementation for the DCIM_SystemView class which is used to represent the higher level attributes of the system, such as asset tag, model, server manufacturer, etc. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.
BladeGeometry = 4 BoardPartNumber = 0N051FX02 BoardSerialNumber = CN1374092O003M CMCIP = null CPLDVersion = 0.4.7 CPURollupStatus = 1 ChassisName = Main System Chassis ChassisServiceTag = 7654321 ChassisSystemHeight = 2 ExpressServiceCode = 61387326761 FQDD = System.Embedded.1 FanRollupStatus = 3 HostName InstanceID = System.Embedded.1 LastSystemInventoryTime = 20100331101859 LastUpdateTime = 20100325134947 LicensingRollupStatus = 1 LifecycleControllerVersion = 2.0.0 Manufacturer = Dell Inc.
PopulatedDIMMSlots = 1 PopulatedPCIeSlots = 1 PowerCap = 0 PowerCapEnabledState = 3 PowerState = 2 PrimaryStatus = 3 RollupStatus = 3 ServerAllocation = null ServiceTag = S78FGH5 StorageRollupStatus = 1 SysMemErrorMethodology = 6 SysMemFailOverState = NotInUse SysMemLocation = 3 SysMemPrimaryStatus = 1 SysMemTotalSize = 2048 SystemGeneration = 12G Monolithic SystemID = 1230 SystemRevision = 0 TempRollupStatus = 1 UUID = 4c4c4544-0037-3810-8046-d3c04f474835 VoltRollupStatus = 1 smbiosGUID = 44454c4c-3700-103
10 Job Control Management 10.1 Description of Job Management The Dell Common Information Model (CIM) class extensions for supporting update and attribute configuration job control are defined in the Dell Job Control Profile 2 and related MOF files 3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Job Control Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 10.
-file:SetupJobQueue.xml -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -auth:basic -encoding:utf-8 The syntax for SetupJobQueue.xml is: PAGE 100ReturnValue = null 10.2.2 Delete Job Queue The DeleteJobQueue() method takes in a jobID and then deletes it from the job store. Note: When clearing all jobs and pending data using the keyword JID_CLEARALL, as shown in example 2 below, the remote services instrumention is restarted to clear the cache [LC 1.x ONLY]. Users should allow two minutes for this process to complete.
An XML syntax error could yield the following message: Syntax Error: input must be of the form: {KEY="VALUE"[;KEY="VALUE"]} 10.2.3 List Jobs in Job Store The instances of this class will enumerate jobs in the job store along with status information. Invoke enumerate job status with the following parameters and syntax: [JobID]: The JobID of a particular job instance to be queried To get the status of one particular job, use the following: EXAMPLE 1: winrm get http://schemas.dmtf.
Message = Detach partition successful MessageArguments = null MessageID = VF038 Name = VFlashDetach:Partition3 DCIM_LifecycleJob InstanceID = RID_001274051062 JobStartTime = 00000101000000 JobStatus = Reboot Completed JobUntilTime = 20100730121500 Message MessageArguments = null MessageID Name = Reboot3 DCIM_LifecycleJob InstanceID = JID_001274140369 JobStartTime = 00000101000000 JobStatus = Completed JobUntilTime = 20111111111111 Message = Job completed successfully MessageArguments = null MessageID = PR19
The WinRM client cannot process the request. The destination computer returned an empty response to the request.
11 Operating System Deployment The Dell Common Information Model (CIM) class extensions for supporting remote operating system (OS) deployment are defined in the Dell OS Deployment Profile 2 and the DCIM_OSDeploymentService MOF file 3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell OS Deployment Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 11.
11.3 OS Deployment Method Invocation Examples 11.3.1 Get Driver Pack Information The GetDriverPackInfo() method returns the embedded driver pack version and list of supported OSs for OS deployment that can be installed on the server using the embedded device drivers present in the Lifecycle Controller. 1. Follow the steps listed in Section 11.1 to test for profile conformance. 2. Invoke extrinsic method using the following parameters: a. object path = object path returned from Section 11.
, SuSE Enterprise Linux 11 SP2 x64 , VMware ESX 4.1 U2 , VMware ESXi 4.1 U2 HDD , VMware ESXi 5.0 HDD , Citrix Xen Server 6.0 FP1 HDD ReturnValue = 0 Version = 7.0.0.35 11.3.2 Unpack Selected Drivers and Attach to Host OS as USB Device This method is used to unpack the drivers for the selected OS to a virtual storage partition, and to then attach this partition to the host OS as an emulated USB storage device. 1. Invoke extrinsic method using the following parameters section: a.
Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem /wscim/1/cimschema/2/DCIM_OSDConcreteJob SelectorSet Selector: InstanceID = DCIM_OSDConcreteJob:1, __cimnamespace = root/dcim ReturnValue = 4096 11.3.3 Detach Emulated USB Device Containing Drivers This method is used to detach the USB device attached to the system by a previous invocation of the UnpackAndAttach() method.
Note that the values for the CIFSUSER and CIFSPASSWORD must be alphanumeric characters, and must not contain special characters. Invoke UnpackAndShare() with the following syntax: [CIFS_IPADDRESS]: This is the IP address of the file server. [DRIVESHARE]: This is the directory path to the drivers. [CIFS_USERNAME]: This is the username to the file share. [CIFS_PASSWORD]: This is the password to the file share. [OSName]: This example uses Windows Server® 2003 SP2.
__cimnamespace = root/dcim ReturnValue = 4096 A missing command line character, such as a “{“, could result in the following syntax error: Syntax Error: input must be of the form {KEY="VALUE"[;KEY="VALUE"]} 11.3.5 Check Job Status The following methodology is used to determine the status of the jobs generated by the invocation of the UnpackAndAttach() and UnpackAndShare() methods. The methodology involves enumerating the DCIM_OSDConcreteJob instances, and checking the JobStatus property value.
11.3.6 Boot to Network ISO The BootToNetworkISO() method can be used to boot the target system to a bootable ISO image located on a CIFS or NFS share. The ISO image is attached to the host system as an emulated USB CD-ROM storage device. By default the ISO will be attached for around 18 hrs after which it will be detached automatically. An optional parameter ExposeDuration can be used to specify a time less than 18 hrs if the ISO needs to be detached sooner.
SelectorSet Selector: InstanceID = DCIM_OSDConcreteJob:1, __cimnamespace = root/dcim ReturnValue = 4096 The following error message is a caused by a typo in the WinRM input. Careful attention must be paid to the input capitalization of the attributes. WSManFault Message = The WinRM client cannot process the request. The destination computer returned an empty response to the request. Error number: -2144108299 0x803380F5 The WinRM client cannot process the request.
11.3.8 Boot To PXE The BootToPXE() method is used to boot to server using the PXE mechanism, which is to reboot the host server and boot to PXE.
11.3.10 Download ISO to VFlash The DownloadISOToVFlash() method allows using remote command to download an ISO image to VFlash. The image needs to be an ISO image. Once this image is downloaded to VFlash, it can be booted via another WS-Man command. Invoke DownloadISOToVFlash() with the following parameters and syntax: [IPADDRESS-ISO]: The IP address of the server that stores ISO images. [DRIVESHARE]: This is the directory path to the ISO image. [SHARETYPE]: The type of the remote storage.
ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_OSDConcreteJob SelectorSet Selector: InstanceID = DCIM_OSDConcreteJob:1, __cimnamespace = root/dcim ReturnValue = 4096 The following error message is a direct result of a typo in the winRM input. Careful consideration must be applied to capitalization. WSManFault Message = The WinRM client cannot process the request. The destination computer returned an empty response to the request.
ResourceURI = http://schemas.dell.com/wbem/wscim /1/cimschema/2/DCIM_OSDConcreteJob SelectorSet Selector: InstanceID = DCIM_OSDConcreteJob:1, __cimnamespace = root/dcim ReturnValue = 4096 11.3.12 Delete ISO from VFlash The DeleteISOFromVFlash() method will delete the ISO image that was downloaded to the VFlash.
-u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -encoding:utf-8 a:basic OUTPUT: When this command is executed, a status or error message will be returned. If an image is not found the following message will display: DetachISOFromVFlash_OUTPUT Message = Unable to detach ISO image on VFlash MessageID = OSD44 ReturnValue = 2 11.3.14 Connect Network ISO Image This method can be used to connect to a bootable ISO image located on a CIFS or NFS share.
Password="[CIFS_or_NFS_Password]";Workgroup="WORKGROUP"; ImageName="[OS.ISO]"} OUTPUT: The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters. The MessageID and Message output parameters will further contain method invocation information if an error occurred. ConnectNetworkISOImage_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters. The MessageID and Message output parameters will further contain method invocation information if an error occurred. DisconnectNetworkISOImage_OUTPUT ReturnValue = 0 11.3.16 Skip ISO Image Boot This method can be used to skip the target system from booting to a bootable ISO image (connected using ConnectNetworkISOImage method) one time only for next immediate host reboot.
11.3.17 Get Network ISO Image Connection Information This method outputs the ISO connection status of the image that has been exposed to the host.
[SHAREPASSWORD]: Password of the share account [WORKGROUP]: Applicable workgroup [IMAGENAME]: Image name of the iso image, such as boot.iso.
cimv2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService +Name=DCIM:OSDeploymentService +SystemCreationClassName=DCIM_ComputerSystem +SystemName=DCIM:ComputerSystem -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNCheck -SkipCACheck -encoding:utf-8 a:basic OUTPUT: DisconnectRFSISOImage_OUTPUT ReturnValue = 0 11.3.
11.3.21 Boot To Hard Disk Drive (HDD) The BootToHD() method is used for one time boot to the host server’s hard disk. After this method is executed thye host is rebooted immediately and will boot to the first configured hard disk irrespective of its boot order.
-u: [USER] -p: [PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNCheck encoding:utf-8 -a:basic @{IPAddress="[NFS_IPaddress]";ShareName="[/NFS/OSISO]";ShareType="0"; Username="[NFS_Username]";Password="[NFS_Password]" ;ResetType="[RESET_TYPE]"; Workgroup="WORKGROUP";ImageName="[OS.ISO]"} OUTPUT: The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters.
12 Lifecycle Controller Management Profile The LC Management Profile describes the LC attribute configuration service and the collections and attributes instances that the service manages. The profile also describes the relationship of the LC attribute service to the DMTF/Dell profile version information and Dell Job Control profile.
+Name=DCIM:LCService -file:[DIRECTORYPATH]\SetAttribute_LC.xml r:https://[IPADDRESS]:443/wsman -u:[USER] -p:[PASSWORD] -auth:basic -encoding:utf-8 -SkipCNCheck -SkipCACheck The input file SetAttribute_LC.xml is shown below: PAGE 12612.2 Part Replacement Configuration and Management If the SetAttribute[s]() method has been invoked, the pending values must be applied by creating a configuration job. The CreateConfigJob() method in the DCIM_LCService class creates a configuration job and executes it at the specified time. 12.2.1 Create Config Job Invoke CreateConfigJob() with the following parameters and syntax: EXAMPLE: winrm i CreateConfigJob http://schemas.dmtf.
ReturnValue = 0 To get the status of the above jobID or list all jobIDs, see 12.2.2 and 12.2.3, respectively. 12.2.2 Get LC Config Job Status EXAMPLE: winrm g http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_LifecycleJob ?__cimnamespace=root/dcim +InstanceID=JID_001265982202 -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]:wsman -encoding:utf-8 -a:basic -SkipCNCheck -SkipCACheck The method either returns a list of Concrete job objects or an error message.
InstanceID = JID_001272324322 JobStartTime JobStatus = Completed JobUntilTime Message = Detach partition successful MessageArguments = null MessageID = VF038 Name = VFlashDetach:Partition1 DCIM_LifecycleJob InstanceID = JID_001273099184 JobStartTime = 20191010101010 JobStatus = COMPLETED JobUntilTime = 2009:8:11 Message = The command was successful MessageArguments = null MessageID = LC001 Name = LC Config . . . 12.2.
Note: For 11G, InstanceID=DCIM_LCEnumeration:CCR5 OUTPUT: DCIM_LCEnumeration AttributeName = Collect System Inventory on Restart CurrentValue = Disabled DefaultValue = Enabled ElementName = LC.emb.1 InstanceID = LifecycleController.Embedded.1#LCAttributes.1#CollectSystemInventoryOnRestart IsReadOnly = false PendingValue = null PossibleValues = Enabled, Disabled 12.2.5 Get Part Firmware Update Attribute Get the current Part Replacement firmware update mode as follows: EXAMPLE: winrm g http://schemas.dmtf.
InstanceID = LifecycleController.Embedded.1#LCAttributes.1#PartFirmwareUpdate IsReadOnly = false PendingValue = null PossibleValues = Disable, Allow version upgrade only, Match firmware of replaced part See Section 12.5 to get the status on whether there is a valid VFlash License on the system. 12.3 Re-Initiate Auto-Discovery Client Invoke the ReInitiateDHS() method to re-initialize and restart the Auto-Discovery client. All configuration information is replaced with the auto discovery factory defaults.
OUTPUT: The output is status 0 for successfully set or an error message. ReInitiateDHS_OUTPUT ReturnValue = 0 12.4 Clear or Set Provisioning Server The Provisioning Server name (or a group names) can be cleared by invoking the ClearProvisioningServer() method on the DCIM_LCService class.
-u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -encoding:utf-8 -a:basic file:SetProvisioningServer.xml The input file SetProvisioningServer.xml is shown below: Provisioning Server [PS_IP_ADDRESS] OUTPUT-B: This method will return status 0 or error message.
CurrentValue = Yes DefaultValue = No ElementName = LC.emb.1 InstanceID = LifecycleController.Embedded.1#LCAttributes.1#Licensed IsReadOnly = true PendingValue PossibleValues = Yes, No 12.6 Download Server Public Key This method is used to download the server public key to the Lifecycle Controller. A base64 encoded string containing the certificate authentication (CA) content is required as the input.
qvoMCKtoqLnGBByj/H2vyN7Fe/zMKXD5pO6XwYddGfA66w3HGUaR0+fIKD40NDi9 bKFEMxbRxZysUUzuKZ9c+RAlZUiLrqzemfX3fn1Yp7k05KU9vHY= -----END CERTIFICATE----- OUTPUT: When this method is executed, a jobid or an error message is returned. This jobid can then be used for subsequent processing with job control provider in Section 10. DownloadServerPublicKey_OUTPUT Job Address = http://schemas.xmlsoap.
-----BEGIN RSA PRIVATE KEY----Proc-Type: 4,ENCRYPTED DEK-Info: DES-EDE3-CBC,5FD6D6131DFA5A86 ulG9hRgOIkoJJkMBk95Zi8H5KnZkNUnPnqPHQlNco9WzKyINR1FbcIIAU9ToUJOM SnSSlA8fRBtJXZZVBA+KAt+34lvO/FEAijSOzKMW1nA+CUuzCFM7t3P+3kmD+o6a . . .
DownloadClientCerts_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001269440659, __cimnamespace = root/dcim ReturnValue = 0 12.8 Delete Auto-Discovery Client Certificates This method is used to delete the client certificates set previously by the auto discovery method.
EXAMPLE: winrm i SetPublicCertificate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemName=DCIM:ComputerSystem +Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:SetPublicCertificate.xml The input file SetPublicCertificate.xml is shown below: PAGE 13812.10 Set iDRAC Certificate and Private Key This method is used to update an iDRAC certificate and private key pairs using the contents of a PKCS#12 file. Invoke SetCertificateAndPrivateKey() with the following parameters and syntax: Type: Specifies the service the certificate is for: server = web server PKCS12: Represents the base64 encoded contents of PKCS#12 file to upload. Note this is the contents of the file and not a filename.
1234567 OUTPUT: SetCertificateAndPrivateKey_OUTPUT Message = Server certificate successfully modified, iDRAC will now reset and be unavailable for a few minutes MessageID = LC018 ReturnValue = 0 12.11 Delete Auto-Discovery Server Public Key This method is used to delete the public server key set previously by the set auto discovery method.
+SystemName=DCIM:ComputerSystem +Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:InsertCommentInLCLog.xml The input file InsertCommentInLCLog.xml is shown below: INSERT COMMENT HERE OUTPUT: InsertCommentInLCLog_OUTPUT ReturnValue = 0 12.
+Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:ExportLCLog.xml The input file ExportLCLog.xml is shown below: 123.456.7.8 sharename filename.
FileName: This is the target output file. ShareType: Type of share NFS=0, CIFS=2 Username: This is the username to the target export server. Password: This is the password to the target export server. Workgroup: This is the applicable workgroup. Example: winrm i ExportCompleteLCLog http://schemas.dmtf.
12.15 Export Hardware Inventory from Lifecycle Controller This method is used to export the hardware inventory from the Lifecycle Controller to a text file on a remote share. Invoke ExportHWInventory() with the following parameters and syntax: IPAddress: This is the IP address of the target export server. ShareName: This is the directory path to the mount point. FileName: This is the target output file. ShareType: Type of share NFS=0, CIFS=2 Username: This is the username to the target export server.
password workgroup OUTPUT: When this method is executed, a jobid or an error message is returned. ExportHWInventory_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001271167557, __cimnamespace = root/dcim ReturnValue = 0 12.
winrm i ExportFactoryConfiguration http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemName=DCIM:ComputerSystem+Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:ExportFactoryConfiguration.xml The input file ExportFactoryConfiguration.xml is shown below: PAGE 14612.17 System Decommission This method is called to delete all configurations from the Lifecycle controller before the system is retired. Invoke LCWipe() with the following parameters and syntax: EXAMPLE: winrm i LCWipe http://schemas.dmtf.
GetRemoteServicesAPIStatus_OUTPUT LCStatus = 0 Message = Lifecycle Controller Remote Services is ready. MessageID = LC061 ReturnValue = 0 ServerStatus = 2 Status = 0 12.19 Export System Configuration This method is used to export the system configuration from the Lifecycle Controller to a file on a remote share. Invoke ExportSystemConfiguration() with the following parameters and syntax: IPAddress: This is the IP address of the target export server.
When this method is executed, a jobid or an error message is returned. ExportSystemConfiguration_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001271168441, __cimnamespace = root/dcim ReturnValue = 0 12.
-r:https://[IPADDRESS]/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic @{IPAddress="SHARE_IP_ADDRESS"; ShareName="SHARE_NAME";ShareType="SHARE_TYPE"; FileName="SHARE_OUTPUT_FILE_NAME";Username="SHARE_USERNAME"; Password="SHARE_PASSWORD"} OUTPUT: When this method is executed, a jobid or an error message is returned. ImportSystemConfiguration_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
ystemCreationClassName=DCIM_ComputerSystem+CreationClassName=DCIM_LCService+Syst emName=DCIM:ComputerSystem+Name=DCIM:LCService -u:root -p:calvin r:https://10.94.161.157/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic @{IPAddress="10.94.162.74";ShareName="Share name" ;ShareType="2";Username="administrator";Password="dell_123";FileName="SystemConf ig.xml"} OUTPUT: ImportSystemConfigurationPreview_OUTPUT Job EndpointReference Address = http://schemas.xmlsoap.
PercentComplete = 100 12.22 Remote Diagnostics This feature will allow the user to remotely run hardware diagnostics through console application or remote scripts and collect results from tool execution 12.22.1 Run Diagnostics DCIM_LCService.RunePSADiagnostics: The method is used to run the diagnostics based on the runmode switch and save the report in the internal storage area. The diagnostics can be run in either express or extended mode or as a long run which encompasses all diagnostic tests.
Example: winrm i ExportePSADiagnosticsResult http://schemas.dmtf.
JobUntilTime = TIME_NA Message = Task successfully scheduled.
13 VFlash SD Card Management The Persistent Storage Profile describes the necessary properties and methods for representing and managing the partitions on the virtual flash media(SD Card on AMEA) provided by the iDRAC in Dell platforms.
DataFormat = RAW DeviceID = DCIM_OpaqueManagementData:Partition1 ElementName = VFlash Name = label1 PartitionIndex = 1 PartitionType = HDD Size = 50 SystemCreationClassName = DCIM_ComputerSystem SystemName = DCIM:ComputerSystem Note: If nothing is returned, no partitions exist. Use the CreatePartition method to create partitions. 13.
FQDD = Disk.vFlashCard.1 HealthStatus = OK InitializedState = Uninitialized InstanceID = Disk.vFlashCard.1 LastSystemInventoryTime = 20100426221347.000000+000 LastUpdateTime = 20100426221347.000000+000 Licensed = true VFlashEnabledState = true WriteProtected = false InitializedState: Field indicates status of element to be initialized InstanceID: InstanceID of desired element for initialization 13.2.2 Initialize or Format Media This method is used to initialize or format the virtual flash media device.
13.2.3 Verify Initialization or Formatting After invoking InitializeMedia(), get the instance of DCIM_VFlashView to confirm successful initialization. Get a specific DCIM_VFlashView with the following parameters and syntax: [INSTANCE_ID] = Obtained from Section 13.2.1, such as Disk.vFlashCard.1 EXAMPLE: winrm g http://schemas.dmtf.
13.3 Enable or Disable vFlash using vFlash State Change This method is used to enable or disable the virtual flash media device. When the VFlashStateChange() method is successfully executed, the change will be dictated in the VFlashEnabledState parameter as shown in Section 13.2.1 and Section 13.2.3. Invoke VFlashStateChange() with the following parameters and syntax: RequestedState: The state to set to Enable=1, Disable=2 EXAMPLE: winrm i VFlashStateChange http://schemas.dell.
1 to 16 Size: The size of the partition to be created SizeUnit: The unit of the size MB=1, GB=2 PartitionType: The partition type floppy=1, hard disk=2 OSVolumeLabel: The label seen in the OS after attaching the partition EXAMPLE: winrm i CreatePartition http://schemas.dell.
ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001270734913, __cimnamespace = root/dcim ReturnValue = 0 If this method returns the following message, the VFlash must be enabled using the VFlashStateChange() ( Section 13.3) method. CreatePartition_OUTPUT Message = VFlash not enabled MessageID = VF015 ReturnValue = 2 13.
SharePath: NFS sharepoint address ImageName: Name of the ISO or IMG image Workgroup: Name of the workgroup, if applicable. Username: The username to be used to access the file. Password: The password to be used to access the file. Port: The port number to be used. HashType: The hash type MD5=1, SHA1=2 HashValue: The hash value string based on the HashType parameter EXAMPLE: winrm i CreatePartitionUsingImage http://schemas.dell.
When this method is executed, a jobid or an error message is returned. CreatePartitionUsingImage_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001268833219, __cimnamespace = root/dcim ReturnValue = 0 Reference Section 13.
-u:[USER] -p:[PASSWORD] -auth:basic -encoding:utf-8 -SkipCNCheck -SkipCACheck file:[DIRECTORYPATH]\DeletePartition.xml The input file DeletePartition.xml is shown below: 1 OUTPUT: When this method is executed, a ReturnValue or error message is returned.
winrm i FormatPartition http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_PersistentStorageService +SystemName=DCIM:ComputerSystem +Name=DCIM:PersistentStorageService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:FormatPartition.xml The input file FormatPartition.xml is shown below: PAGE 165PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be modified. 1 to 16 AccessType: The type of access level Read-Only=1, Read-Write=3 The OUT parameter Job will refer to the instance of CIM_ConcreteJob using which the user can query the status of the modification of the partition. EXAMPLE: winrm i ModifyPartition http://schemas.dell.
PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be attached. 1 to 16 EXAMPLE: winrm i AttachPartition http://schemas.dell.
Invoke DetachPartition() with the following parameters and syntax: PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be detached 1 to 16 EXAMPLE: winrm i DetachPartition http://schemas.dell.
Message = Partition already detached MessageID = VF028 ReturnValue = 2 13.11 Export Data from Partition This method is for exporting the contents of a partition to a location specified by the user. Use the following algorithm to successfully export data from an existing partition.
-u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:ExportDataFromPartition.xml The input file ExportDataFromPartition.xml is shown below: 1 123.456.7.8 2 /temp imagename.
Selector: InstanceID = JID_001271681930, __cimnamespace = root/dcim ReturnValue = 0 170 Dell Lifecycle Controller Web Services Interface Guide for Windows
14 Boot Control Configuration Management This feature provides the ability to get and set the boot order configuration. The Boot Control Profile describes the classes, associations, properties, and methods used to manage the boot control configurations of a physical or virtual computer system. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 14.
ElementName = UefiBootSeq InstanceID = UEFI IsCurrent = 2 IsDefault = 0 IsNext = 2 DCIM_BootConfigSetting ElementName = OneTimeBootMode InstanceID = OneTime IsCurrent = 2 IsDefault = 0 IsNext = 2 DCIM_BootConfigSetting ElementName = vFlash Boot Configuration InstanceID = vFlash IsCurrent = 2 IsDefault = 0 IsNext = 2 14.
-r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_BootConfigSetting ElementName = BootSeq InstanceID = IPL IsCurrent = 1 IsDefault = 0 IsNext = 1 14.3 Listing the Boot Inventory-SourceSetting Class Each Boot Configuration Representation contains an ordered list of boot sources, which indicate the logical devices to use during the boot process. Enumerate the BootSourceSetting class with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
PendingAssignedSequence = 0 PendingEnabledStatus = 1 DCIM_BootSourceSetting BIOSBootString = Hard drive C: BootSeq BootString = Hard drive C: BootSeq CurrentAssignedSequence = 1 CurrentEnabledStatus = 1 ElementName = Hard drive C: BootSeq FailThroughSupported = 1 InstanceID = IPL:HardDisk.List.1-1:c9203080df84781e2ca3d512883dee6f PendingAssignedSequence = 1 PendingEnabledStatus = 1 . . . 14.
winrm i ChangeBootOrderByInstanceID http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BootConfigSettig ?InstanceID=[INSTANCE ID] -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:ChangeBootOrderByInstanceID.xml The input file ChangeBootOrderByInstanceID.xml is shown below: IPL:Optical.
Note 2: BIOS does not support the setting of EnabledState for BCV devices. Invoke ChangeBootSourceState() with the following parameters and syntax: [INSTANCE ID]: Obtained from the BootSourceSetting Class enumeration, this example uses the field IPL source: Reference to the InstanceID attribute from Section 14.3 EnabledState: State of boot source element Disabled=0, Enabled=1 EXAMPLE: winrm i ChangeBootSourceState http://schemas.dmtf.
15 NIC or CNA Card Management This feature provides the ability to get and set the Network Interface (NIC) Card or Converged Network Adapter (CNA) attributes that are configurable using NIC/CNA Option-ROM or NIC/CNA UEFI HII.
FQDD = NIC.Integrated.1-1-1 GroupDisplayName = iSCSI General Parameters GroupID = IscsiGenParams InstanceID = NIC.Integrated.
Name="iSCSIBootSupport">Unavailable FQDD = NIC.Integrated.1-1-1 GroupDisplayName = iSCSI General Parameters GroupID = IscsiGenParams InstanceID = NIC.Integrated.
winrm e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICString -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_NICString AttributeDisplayName = Chip Type AttributeName = ChipMdl CurrentValue = BCM5720 A0 Dependency = null FQDD = NIC.Integrated.1-1-1 GroupDisplayName = Broadcom Main Configuration Page GroupID = VndrConfigPage InstanceID = NIC.Integrated.
IsReadOnly = true MaxLength = 0 MinLength = 0 PendingValue = null ValueExpression = null DCIM_NICString AttributeDisplayName = Bus:Dev:Func AttributeName = BusDeviceFunction CurrentValue = 01:00:00 Dependency = null FQDD = NIC.Integrated.1-1-1 GroupDisplayName = Broadcom Main Configuration Page GroupID = VndrConfigPage InstanceID = NIC.Integrated.
InstanceID = NIC.Integrated.1-1-1:LinkStatus IsReadOnly = true MaxLength = 0 MinLength = 0 PendingValue = null ValueExpression = null. 15.3 Listing the CNA Inventory-Integer Class Enumerate the DCIM_NICInteger class with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
AttributeDisplayName = Link Up Delay Time AttributeName = LnkUpDelayTime CurrentValue = 0 Dependency = Unavailable FQDD = NIC.Integrated.1-1-1 GroupDisplayName = iSCSI General Parameters GroupID = IscsiGenParams InstanceID = NIC.Integrated.
DCIM_NICInteger AttributeDisplayName = TCP Port AttributeName = FirstTgtTcpPort CurrentValue = 3260 Dependency = Unavailable FQDD = NIC.Integrated.1-1-1 GroupDisplayName = iSCSI First Target Parameters GroupID = IscsiFirstTgtParams InstanceID = NIC.Integrated.1-1-1:FirstTgtTcpPort IsReadOnly = false LowerBound = 1 PendingValue = null UpperBound = 65535 15.
DeviceNumber = 0 EFIVersion = 15.0.16 FCoEOffloadMode = 3 FCoEWWNN = null FQDD = NIC.Integrated.1-1-1 FamilyVersion = 7.0.39 FunctionNumber = 0 InstanceID = NIC.Integrated.1-1-1 LastSystemInventoryTime = 20010708151620.000000+000 LastUpdateTime = 20010708151606.
TransmitFlowControl = 0 VendorName = null WWPN = null iScsiOffloadMode = 3 DCIM_NICView AutoNegotiation = 0 BusNumber = 1 ControllerBIOSVersion = 1.17 CurrentMACAddress = 14:FE:B5:FF:B3:EB DataBusWidth = 0002 DeviceNumber = 0 EFIVersion = 15.0.16 FCoEOffloadMode = 3 FCoEWWNN = null FQDD = NIC.Integrated.1-2-1 FamilyVersion = 7.0.39 FunctionNumber = 1 InstanceID = NIC.Integrated.1-2-1 LastSystemInventoryTime = 20010708151620.000000+000 LastUpdateTime = 20010708151606.
PCISubDeviceID = 1f5b PCISubVendorID = 1028 PCIVendorID = 14e4 PermanentFCOEMACAddress PermanentMACAddress = 14:FE:B5:FF:B3:EB PermanentiSCSIMACAddress ProductName = Broadcom Gigabit Ethernet BCM5720 - 14:FE:B5:FF:B3:EB ReceiveFlowControl = 0 SlotLength = 0002 SlotType = 0002 TransmitFlowControl = 0 VendorName = null WWPN = null iScsiOffloadMode = 3 15.
EnergyEfficientEthernet = 2 FCoEBootSupport = 3 FCoEMaxIOsPerSession = 0 FCoEMaxNPIVPerPort = 0 FCoEMaxNumberExchanges = 0 FCoEMaxNumberLogins = 0 FCoEMaxNumberOfFCTargets = 0 FCoEMaxNumberOutStandingCommands = 0 FCoEOffloadSupport = 3 FQDD = NIC.Integrated.1-1-1 FeatureLicensingSupport = 3 FlexAddressingSupport = 2 IPSecOffloadSupport = 3 InstanceID = NIC.Integrated.
TXBandwidthControlMaximum = 3 TXBandwidthControlMinimum = 3 TXFlowControl = 3 VEBVEPAMultiChannel = 3 VEBVEPASingleChannel = 3 VFSRIOVSupport = 3 VirtualLinkControl = 3 WOLSupport = 2 iSCSIBootSupport = 2 iSCSIOffloadSupport = 3 uEFISupport = 2 15.6 Listing the CNA Inventory- NICStatistics Class Enumerate the DCIM_NICStatistics class with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
LinkStatus = 1 OSDriverState = 1 PartitionLinkStatus = null PartitionOSDriverState = null RxBroadcast = 65177 RxBytes = null RxErrorPktAlignmentErrors = 0 RxErrorPktFCSErrors = 0 RxFalseCarrierDetection = null RxJabberPkt = null RxMutlicast = 11000 RxPauseXOFFFrames = 0 RxPauseXONFrames = 0 RxRuntPkt = null RxUnicast = 0 StartStatisticTime = 20111208013952.000000+000 StatisticTime = 20111208073904.
15.7 Applying the Pending Values for CNA-CreateTargetedConfigJob() The CreateTargetedConfigJob() method is called to apply the pending values created using the SetAttribute() and SetAttributes() methods. The system automatically reboots depending on the ScheduledStartTime selected. Use the CreateTargetedConfigJob() jobID output to get the status (see Section 10.0).
When this method is executed, a jobid or an error message is returned. The status of this jobid can be checked within the job control provider in Section 10. CreateTargetedConfigJob_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001269609760, __cimnamespace = root/dcim ReturnValue = 4096 15.
NIC.Integrated.1-1-1 OUTPUT: DeletePendingConfiguration_OUTPUT Message = The command was successful MessageID = NIC001 ReturnValue = 0 15.9 Getting the CNA Enumeration Instance Use the following example to get an instance of the DCIM_NICEnumeration class. Get a DCIM_NICEnumeration class instance from the first port and first partition with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 15.
InstanceID = NIC.Integrated.1-1-3:iScsiOffloadMode IsReadOnly = false PendingValue = null PossibleValues = Disabled, Enabled PossibleValuesDescription = Disabled, Enabled 15.10 Setting the IscsiOffloadMode Attribute The SetAttribute() method is used to set or change the value of a CNA attribute. Enable the NICMode, IscsiOffloadMode, and FcoeOffloadMode personality attributes to enable the corresponding personalities: NIC, ISCSI, and FCOE.
NIC.Integrated.1-1-1 IscsiOffloadMode Enabled OUTPUT: SetAttribute_OUTPUT Message = The command was successful MessageID = NIC001 RebootRequired = Yes ReturnValue = 0 SetResult = Set PendingValue 15.
EXAMPLE: winrm i SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_NICService +SystemName=DCIM:ComputerSystem +Name=DCIM:NICService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:SetAttribute_NIC.xml The input file SetAttribute_NIC.xml is shown below: PAGE 197AttributeValue: A new value to assign to the specified NICAttribute. If this value is valid, it is applied to the PendingValue property or the Currentvalue property of the specified NICAttribute. The range of acceptable strings is present in the MinLength and MaxLength fields. EXAMPLE: winrm i SetAttribute http://schemas.dmtf.
Invoke SetAttribute() with the following parameters(from Section 15.1) and syntax: Target: FQDD attained through DCIM_NICEnumeration AttributeName: Attained from AttributeName field AttributeValue: A new value to assign to the specified NICAttribute. If this value is valid, it will be applied to the PendingValue property or the Currentvalue property of the specified NICAttribute.
15.14 Setting CNA LAN Modes The SetAttributes() method is used to set or change the values of a group of NIC attributes. Invoke SetAttributes() with the following parameters (from Section 15.1) and syntax: Target: FQDD attained through DCIM_NICEnumeration AttributeName: Attained from AttributeName field AttributeValue: A new value to assign to the specified NICAttribute. If this value is valid, it will be applied to the PendingValue property or the Currentvalue property of the specified NICAttribute.
RebootRequired = Yes ReturnValue = 0 SetResult = Set PendingValue 15.15 Setting the iSCSI Boot Target The SetAttributes() method is used to set or change the values of the iSCSI boot target attributes. Invoke the SetAttributes() method with the following parameters (from 15.1) and syntax: Target: FQDD attained through DCIM_NICEnumeration AttributeName: Attained from AttributeName field AttributeValue: A new value to assign to the specified NICAttribute.
IscsiInitiatorSecDns 10.10.10.3 IscsiInitiatorName testname IscsiInitiatorChapId testid IscsiInitiatorChapPwd testpassword FirstTgtIpAddress 2.2.2.
EXAMPLE: winrm i SetAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_NICService +SystemName=DCIM:ComputerSystem +Name=DCIM:NICService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:SetAttribute_FCoE_BootTarget.xml The information in the input file SetAttributes_FCoE_BootTarget.
16 RAID Storage Management The remote RAID configuration allows users to remotely query and configure the Hardware RAID of the system. The RAID profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of RAID storage. The RAID storage is modeled as collections of attributes where there are collections for the storage adaptors, physical disks, logical disks, end enclosures and parent-child relationships between the collections.
-encoding:utf-8 -a:basic OUTPUT DCIM_RAIDEnumeration AttributeName = RAIDSupportedDiskProt The ‘get’ instance method in section 16.2 uses this InstanceID as input. CurrentValue = SAS, SATA FQDD = RAID.Integrated.1-1 InstanceID = RAID.Integrated.1-1:RAIDSupportedDiskProt PendingValue The ‘set attribute’ method in section 16.19.1 uses the FQDD, AttributeName, and PossibleValues. PossibleValues = SAS, SATA fields as input.
AttributeName = RAIDdefaultWritePolicy CurrentValue = WriteBack FQDD = Disk.Virtual.1:RAID.Integrated.1-1 InstanceID = Disk.Virtual.1:RAID.Integrated.1-1:RAIDdefaultWritePolicy IsReadOnly = false PendingValue PossibleValues = WriteThrough, WriteBack, WriteBackForce 16.2 Getting a RAID Enumeration Instance Use the following example to get an instance of the DCIM_RAIDEnumeration class instead of all the instances as shown in Section 16.1.
16.3 Listing the RAID Inventory-Integer Class The RAID Inventory has these attributes: DCIM_RAIDEnumeration (see Section 16.1), DCIM_RAIDInteger (this section), and DCIM_RAIDString (see Section 16.5). Enumerate the DCIM_RAIDInteger class to display all the RAID controller attributes in a system. Enumerate RAIDInteger with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
LowerBound = 0 PendingValue UpperBound = 0 DCIM_RAIDInteger AttributeName = RAIDrebuildRate The ‘get’ instance method in Section 16.4 used this InstanceID as input. CurrentValue = 30 FQDD = RAID.Integrated.1-1 InstanceID = RAID.Integrated.1-1:RAIDrebuildRate IsReadOnly = false LowerBound = 1 PendingValue UpperBound = 100 The ‘set attribute’ method in Section 16.19.3 uses the FQDD, AttributeName, and a value equal to or between the LowerBound and UpperBound fields as input.
LowerBound = 1 PendingValue UpperBound = 100 16.4 Getting a RAID Integer Instance Use the following example to get an instance of the DCIM_RAIDInteger class, instead of all instances as shown in Section 16.3. Get a RAIDInteger instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 16.3, which shows an example using RAID.Integrated.
Enumerate RAIDString with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.org/wbem/wscim/1/cim schema/2/root/dcim/DCIM_RAIDString -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNCheck -SkipCACheck -encoding:utf-8 a:basic OUTPUT: DCIM_RAIDString The ‘get’ instance method in Section 16.6 uses this InstanceID as input. AttributeName = Name CurrentValue = MyCacheCadeVD FQDD = Disk.Virtual.0:RAID.Integrated.1-1 InstanceID = Disk.Virtual.0:RAID.Integrated.
16.6 Getting a RAID String Instance Use the following example to get an instance of the DCIM_RAIDString class instead of all instances as shown in Section 16.5. Get a DCIM_RAIDString instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 16.5, which shows an example using Disk.Virtual.0:RAID.Integrated.
-SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic OUTPUT: DCIM_ControllerView Bus = 1 CacheSizeInMB = 0 CachecadeCapability = 0 ControllerFirmwareVersion = 20.10.1-0066 Device = 0 DeviceCardDataBusWidth = 1 DeviceCardManufacturer = DELL DeviceCardSlotLength = 4 DeviceCardSlotType = PCI Express x8 DriverVersion = null EncryptionCapability = 0 EncryptionMode = 0 FQDD = RAID.Slot.1-1 Function = 0 InstanceID = RAID.Slot.1-1 KeyID = null LastSystemInventoryTime = 20120116145459.
PrimaryStatus = 1 ProductName = PERC H310 Adapter RollupStatus = 1 SASAddress = 5782BCB00C577600 SecurityStatus = 0 SlicedVDCapability = 1 16.8 Getting a RAID ControllerView Instance The get() command can be invoked using a particular instanceID, attained from listing the inventory. Get a RAID ControllerView instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 16.7, in which this example would use RAID.Slot.
DriverVersion = null EncryptionCapability = 0 EncryptionMode = 0 FQDD = RAID.Slot.1-1 Function = 0 InstanceID = RAID.Slot.1-1 KeyID = null LastSystemInventoryTime = 20120116145459.000000+000 LastUpdateTime = 20120116145459.000000+000 PCIDeviceID = 73 PCISlot = 1 PCISubDeviceID = 1F4E PCISubVendorID = 1028 PCIVendorID = 1000 PatrolReadState = 1 PrimaryStatus = 1 ProductName = PERC H310 Adapter RollupStatus = 1 SASAddress = 5782BCB00C577600 SecurityStatus = 0 SlicedVDCapability = 1 16.
winrm e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_PhysicalDiskView -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic OUTPUT: DCIM_PhysicalDiskView BusProtocol = 6 Connector = 0 DriveFormFactor = 3 FQDD = Disk.Bay.0:Enclosure.Internal.0-0:RAID.Slot.1-1 FreeSizeInBytes = 8978432 HotSpareStatus = 0 InstanceID = Disk.Bay.0:Enclosure.Internal.0-0:RAID.Slot.1-1 LastSystemInventoryTime = 20120116145459.
Revision = DS62 RollupStatus = 1 SASAddress = 5000C50025D64875 SecurityState = 0 SerialNumber = 9SP297S1 SizeInBytes = 499558383616 Slot = 0 SupportedEncryptionTypes = None UsedSizeInBytes = 35827154944 DCIM_PhysicalDiskView BusProtocol = 6 Connector = 0 DriveFormFactor = 2 FQDD = Disk.Bay.1:Enclosure.Internal.0-0:RAID.Slot.1-1 FreeSizeInBytes = 8978432 HotSpareStatus = 0 InstanceID = Disk.Bay.1:Enclosure.Internal.0-0:RAID.Slot.1-1 LastSystemInventoryTime = 20120116145459.
PPID = SG0RN8291253187A001YA00 PredictiveFailureState = 0 PrimaryStatus = 1 RaidStatus = 2 Revision = SM07 RollupStatus = 1 SASAddress = 5000C500015BD39D SecurityState = 0 SerialNumber = 3PE0D45D SizeInBytes = 35836133376 Slot = 1 SupportedEncryptionTypes = None UsedSizeInBytes = 35827154944 . . . 16.10 Listing the RAID VirtualDiskView Inventory Enumerating the VirtualDiskView, results in the attributes and inventory of the available virtual disks in the system.
Cachecade = 0 DiskCachePolicy = 1024 FQDD = Disk.Virtual.0:RAID.Slot.1-1 InstanceID = Disk.Virtual.0:RAID.Slot.1-1 LastSystemInventoryTime = 20120116145459.000000+000 LastUpdateTime = 20120116145459.000000+000 LockStatus = 0 MediaType = 1 Name = Virtual Disk 00 ObjectStatus = 0 OperationName = None OperationPercentComplete = 0 PhysicalDiskIDs = Disk.Bay.0:Enclosure.Internal.0-0:RAID.Slot.1-1, Disk.Bay.1:Enclosure.Internal .0-0:RAID.Slot.1-1, Disk.Bay.2:Enclosure.Internal.0-0:RAID.Slot.
WriteCachePolicy = 1 After successful virtual disk creation: DCIM_VirtualDiskView BusProtocol = 6 Cachecade = 0 DiskCachePolicy = 1024 FQDD = Disk.Virtual.0:RAID.Slot.1-1 InstanceID = Disk.Virtual.0:RAID.Slot.1-1 LastSystemInventoryTime = 20120116145459.000000+000 LastUpdateTime = 20120116145459.000000+000 LockStatus = 0 MediaType = 1 Name = Virtual Disk 00 ObjectStatus = 3 OperationName = None OperationPercentComplete = 0 PhysicalDiskIDs = Disk.Bay.0:Enclosure.Internal.0-0:RAID.Slot.1-1, Disk.Bay.
SpanLength = 3 StartingLBAinBlocks = 0 StripeSize = 128 VirtualDiskTargetID = 0 WriteCachePolicy = 1 16.11 Listing the RAID EnclosureView Inventory Enumerating the EnclosureView, results in the attributes and inventory of the available enclosure components in the system. Enumerate EnclosureView with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
ServiceTag SlotCount = 6 TempProbeCount = 0 Version = 1.07 WiredOrder = 0 16.12 Reset Configuration-ResetConfig() The ResetConfig() method is used to delete all virtual disks and unassign all HotSpare physical disks. The deletions will not occur until a configuration job ( Section 16.15) is scheduled and the system is rebooted.
Invoke ClearForeignConfig() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) EXAMPLE: winrm i ClearForeignConfig cimv2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_RAIDService +SystemName=DCIM:ComputerSystem +Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:ClearForeignConfig.
1 = PowerCycle 2 = Graceful Reboot without forced shutdown 3 = Graceful reboot with forced shutdown Note: When a user does not want to set a reboot type when creating a target job, users should comment out the RebootJobType in the input xml. User should not enter “0” or give no parameter at all in the input xml. ScheduledStartTime & UntilTime: See Section 3.2.4 EXAMPLE: winrm i CreateTargetedConfigJob http://schemas.dmtf.
ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001271251761, __cimnamespace = root/dcim ReturnValue = 4096 16.15 Deleting the Pending Values for RAIDDeletePendingConfiguration() The DeletePendingConfiguration() method cancels the pending configuration changes made before the configuration job is created with CreateTargetedConfigJob(). This method only operates on the pending changes prior to CreateTargetedConfigJob() being called.
16.16 Managing Hot Spare 16.16.1 Determining Potential Disks-GetDHSDisks() The GetDHSDisks() method is used to determine possible choices of drives to be a dedicated HotSpare for the identified virtual disk. Invoke GetDHSDisks() with the following parameters and syntax: TARGET: This parameter is the FQDD of the target virtual disk. Its value will depend on the number of virtual disks, obtainable in Section 16.10.
16.16.2 Assigning the Hot Spare-AssignSpare() The AssignSpare() method is used to assign a physical disk as a dedicated HotSpare for a virtual disk (VD), or as a global HotSpare. Invoke AssignSpare() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_PhysicalDiskView (Section 16.9) VirtualDiskArray: Array of ElementName(s) where each identifies a different VD, currently only one VD can be passed EXAMPLE: winrm i AssignSpare http://schemas.dmtf.
AssignSpare_OUTPUT Message = Physical disk FQDD did not identify a valid physical disk for the operation MessageID = STOR009 ReturnValue = 2 16.16.3 Unassigning the Hot Spare-UnassignSpare() The UnassignSpare() method is used to unassign a physical disk. The physical disk may be used as a dedicated hot spare to a virtual disk, or as a global hot spare. After the method executes successfully the physical disk is no longer a hotspare.
16.17.1 Setting the Key-SetControllerKey() The SetControllerKey() method sets the key on controllers that support encryption of the virtual disk drives. Invoke SetControllerKey() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) Key: Maximum size 32 characters Keyid: Identifier, or description, for the key (maximum size 255 characters) EXAMPLE: winrm i SetControllerKey http://schemas.dmtf.
16.17.2 Locking the Virtual Disk-LockVirtualDisk() The LockVirtualDisk() method encrypts the virtual disk. Note that the virtual disk must first exist for this method to be successful. Invoke LockVirtualDisk() with the following parameters and syntax: TARGET: This parameter is the FQDD of the target virtual disk EXAMPLE: winrm i LockVirtualDisk http://schemas.dmtf.
Key: Key – Passcode. This parameter is required if the Mode = Local Key Encryption. The Key can be maximum 32 characters in length, and must have one character from each of the following sets. Upper Case Lower Case Number Special Character The special characters in the following set needs to be passed as mentioned below. & -> & < -> < > -> > “ -> " ‘ -> ' Keyid: Key Identifier- Describes Key.
OUTPUT: This method requires an PERC controller with Local Key encryption or DKM support to function correctly. EnableControllerEncryption_OUTPUT RebootRequired = YES ReturnValue = 0 16.17.4 Rekeying the Controller-ReKey() The ReKey() method is used to reset the key on the controller that supports encryption. This method switches the controller mode between Local Key encryption or Dell Key Manager (DKM) encryption.
ationClassN ame=DCIM_RAIDService+SystemName=DCIM:ComputerSystem+Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:ReKey.xml The information in the input file ReKey.xml is shown below: RAID.Integrated.
ationClassN ame=DCIM_RAIDService+SystemName=DCIM:ComputerSystem+Name=DCIM:RAIDService -u:[USER] –p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:RemoveControllerKey.xml The input file RemoveControllerKey.xml is shown below: RAID.Integrated.
DiskEncrypt: Types of encryption to include 0 = Include FDE capable and non encryption capable disks 1 = Include FDE disks only 2 = Include only non FDE disks PDArray: This parameter is the list of physical disk FQDDs EXAMPLE: winrm i GetRAIDLevels cimv2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem +SystemName=DCIM:ComputerSystem +CreationClassName=DCIM_RAIDService +Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8
RAID 0 = 2 RAID 1 = 4 RAID 5 = 64 RAID 6 = 128 RAID 10 = 2048 RAID 50 = 8192 RAID 60 = 16384 16.18.2 Getting the Available Disks-GetAvailableDisks() The GetAvailableDisks() method is used to determine possible choices of drives to create virtual disks. Invoke GetAvailableDisks() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) DiskType: Corresponds to MediaType attribute in PhysicalDiskView ( Section 16.
0 0 0 2 OUTPUT: GetAvailableDisks_OUTPUT PDArray = Disk.Bay.0:Enclosure.Internal.0-0:RAID.Integrated.1-1, Disk.Bay.1:Enclosure.Internal.0-0:RAID.Integrated.1-1 ReturnValue = 0 16.18.
RAID.Integrated.1-1 Disk.Bay.0:Enclosure.Internal. Disk.Bay.1:Enclosure.Internal. Disk.Bay.2:Enclosure.Internal. Disk.Bay.3:Enclosure.Internal. 0-0:RAID.Integrated.1-1 0-0:RAID.Integrated.1-1 0-0:RAID.Integrated.1-1 0-0:RAID.Integrated.
TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) PDArray: This parameter is the list of physical disk FQDDs that will be used to create a virtual Disk. VDPropNameArray: This parameter is the list of property names that will be used to create a virtual disk.
WritePolicy: Write Through = 1 Write Back = 2 Write Back Force = 4 DiskCachePolicy: Enabled = 512 Disabled = 1024 VirtualDiskName: Name of the virtual disk (1-15 character range) EXAMPLE: winrm i CreateVirtualDisk cimv2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_RAIDService +SystemName=DCIM:ComputerSystem +Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:Creat
CreateVirtualDisk_OUTPUT NewVirtualDisk Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_VirtualDiskView SelectorSet Selector: InstanceID = DISK.Virtual.267386880:RAID.Integrated.1-1, __cimnamespace = root/dcim RebootRequired = YES ReturnValue = 0 16.18.5 Creating a Sliced Virtual Disk-CreateVirtualDisk() The CreateVirtualDisk() method is used to create a sliced virtual disk.
RAID 5 = 64 RAID 6 = 128 RAID 10 = 2048 RAID 50 = 8192 RAID 60 = 16384 SpanDepth: If not specified, default is single span which is used for RAID 0, 1, 5 and 6. Raid 10, 50 and 60 require a spandepth of at least 2. SpanLength: Number of Physical Disks to be used per span. Minimum requirements for given RAID Level must be met.
StartingLBA: Starting logical block address of virtual disks in blocks. If 0xFFFFFFFFFFFFFFFF, startingLBA is calculated programmatically. The value can be in hexadecimal or decimal format.
ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_VirtualDiskView SelectorSet Selector: InstanceID = DISK.Virtual.267386880:RAID.Integrated.1-1, __cimnamespace = root/dcim RebootRequired = YES ReturnValue = 0 16.18.6 Creating a Cachecade Virtual Disk-CreateVirtualDisk() The CreateVirtualDisk() method is used to create a Cachecade virtual disk on the targeted controller. This method internally creates a RAID-0 virtual disk.The creation process is the same as explained in Section 16.18.5.
RAID.Integrated.1-1 Disk.Bay.4:Enclosure.Internal.0-0:RAID.Integrated.
winrm i DeleteVirtualDisk cimv2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_RAIDService +SystemName=DCIM:ComputerSystem +Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:DeleteVirtualDisk.xml The input file DeleteVirtualDisk.xml is shown below: DISK.
-r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic –file:SetAttribute_Enumeration_RAID_Controller.xml The input file SetAttribute_Enumeration_RAID_Controller.xml is shown below: RAID.Integrated.
-r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic –file:SetAttributes_Enumeration_RAID_Controller.xml The input file SetAttributes_Enumeration_RAID_Controller.xml is shown below: RAID.Integrated.
winrm i SetAttribute cimv2/root/dcim/DCIM_RAIDSe rvice?SystemCreationClassName=DCIM_ComputerSystem+CreationClassName=DCIM_RAIDSer vice+System Name=DCIM:ComputerSystem+Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic –file:SetAttribute_Integer_RAID_Controller.xml The input file SetAttribute_Integer_RAID_Controller.xml is shown below: PAGE 248winrm i SetAttributes cimv2/root/dcim/DCIM_RAIDSe rvice?SystemCreationClassName=DCIM_ComputerSystem+CreationClassName=DCIM_RAIDSer vice+System Name=DCIM:ComputerSystem+Name=DCIM:RAIDService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic –file:SetAttributes_Integer_RAID_Controller.xml The input file SetAttributes_Integer_RAID_Controller.xml is shown below: PAGE 249EXAMPLE: winrm invoke ConvertToRAID "cimv2/root/dcim/DCIM_RAIDService?SystemCreationClassName=DCIM_ComputerSystem+Cr eationClassN ame=DCIM_RAIDService+SystemName=DCIM:ComputerSystem+Name=DCIM:RAIDService" @{PDArray="Disk.Bay.2:Enclosure.Internal.0-0:RAID.Slot.1-1"} -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -format:pretty OUTPUT: ConvertToRAID_OUTPUT RebootRequired = 1 ReturnValue = 0 16.
RebootRequired = 1 ReturnValue = 0 250 Dell Lifecycle Controller Web Services Interface Guide for Windows
17 Managing BIOS Configuration This feature provides the ability to get and set any configurable BIOS attributes that are exposed in BIOS UEFI HII. The BIOS Management Profile extends the management capabilities of referencing profiles by adding the capability to represent and configure BIOS attributes, such as a Network Controller or IDE Controller. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 17.
DCIM_BIOSEnumeration AttributeName = ReportKbdErr CurrentValue = Report DefaultValue = null FQDD = BIOS.Setup.1-1 InstanceID = BIOS.Setup.1-1:ReportKbdErr IsReadOnly = false PendingValue = null PossibleValues = Report, NoReport DCIM_BIOSEnumeration AttributeName = BootMode CurrentValue = Bios DefaultValue = null FQDD = BIOS.Setup.1-1 InstanceID = BIOS.Setup.1-1:BootMode IsReadOnly = false PendingValue = null PossibleValues = Bios, Uefi.
17.2 Getting a BIOS Enumeration Instance Getting one particular instance of the BIOSEnumeration, instead of all instances as shown in Section 17.1, is shown below. Get a BIOSEnumeration instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 17.1, which shows an example using BIOS.Setup.1-1:NumLock as an instanceID EXAMPLE: winrm g http://schemas.dmtf.
AttributeValue: Obtained from the PossibleValues field EXAMPLE: winrm i SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BIOSService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_BIOSService +SystemName=DCIM:ComputerSystem +Name=DCIM:BIOSService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:SetAttribute_BIOS.xml The input file SetAttribute_BIOS.
AttributeValue: Obtained from the PossibleValues field EXAMPLE: winrm i SetAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BIOSService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_BIOSService +SystemName=DCIM:ComputerSystem +Name=DCIM:BIOSService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:SetAttributes_BIOS.xml The input file SetAttributes_BIOS.
OUTPUT: DCIM_BIOSInteger AttributeName = AcPwrRcvryUserDelay CurrentValue = 0 DefaultValue = null FQDD = BIOS.Setup.1-1 InstanceID = BIOS.Setup.1-1:AcPwrRcvryUserDelay IsReadOnly = true LowerBound = 30 PendingValue = null UpperBound = 240 17.6 Listing the BIOS Inventory-String Class Enumerate BIOSString with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
MaxLength = 200 MinLength = 5 PendingValue = null DCIM_BIOSString AttributeName = UserLcdStr CurrentValue = null DefaultValue = null FQDD = BIOS.Setup.1-1 InstanceID = BIOS.Setup.1-1:UserLcdStr IsReadOnly = false MaxLength = 62 MinLength = 0 PendingValue = null DCIM_BIOSString AttributeName = AssetTag CurrentValue = null DefaultValue = null FQDD = BIOS.Setup.1-1 InstanceID = BIOS.Setup.1-1:AssetTag IsReadOnly = false MaxLength = 10 MinLength = 0 PendingValue = null . . . 17.
Invoke CreateTargetedConfigJob() with the following parameters and syntax: TARGET: This Parameter is the FQDD of the BIOSAttribute instances, obtained from the InstanceID field in Section 17.1 RebootJobType: There are three options for rebooting the system. 1 = PowerCycle 2 = Graceful Reboot without forced shutdown 3 = Graceful reboot with forced shutdown Note: When a user does not want to set a reboot type when creating a target job, users should comment out the RebootJobType in the input xml.
Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001269609760, __cimnamespace = root/dcim ReturnValue = 4096 17.8 Deleting the Pending Values for BIOS & BootDeletePendingConfiguration() This method is called to cancel the pending values created by the SetAttribute() and SetAttributes() methods.
BIOS.Setup.1-1 OUTPUT: DeletePendingConfiguration_OUTPUT Message = The command was successful MessageID = BIOS001 ReturnValue = 0 ReturnValue = 4096 17.9 Managing BIOS Passwords The ChangePassword() method is used to set the BIOS passwords. The user can either set, change or delete the BIOS system or setup password. Setting the BIOS password is performed in several stages as described in the following sections. 17.9.
-r:https://[IPADDRESS]//wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:change_bios_password.xml The input file change_bios_password.xml is shown below: No BIOS password is set: The OldPassword parameter is not required. It may be set to “null” or left blank as shown below. Changing an existing BIOS password: Both the OldPassword and NewPassword parameters are required.
17.9.3 Monitor Set BIOS Password Status To monitor the job status for setting the BIOS password, get the instance of the corresponding job as described within the job control provider in Section 10. Replace [INSTANCE ID] with the actual jobid from Section 17.9.1. EXAMPLE: winrm get http://schemas.dmtf.
winrm e cimv2/root/dcim/DCIM_BIOSPassword -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_BIOSPassword AttributeDisplayName = System Password AttributeName = SysPassword Dependency = Locked DisplayOrder = 1402 FQDD = BIOS.Setup.1-1 GroupDisplayName = System Security GroupID = SysSecurity InstanceID = BIOS.Setup.
FQDD = BIOS.Setup.1-1 GroupDisplayName = System Security GroupID = SysSecurity InstanceID = BIOS.Setup.1-1:SetupPassword IsReadOnly = false IsSet = false MaxLength = 32 MinLength = 0 PasswordState = 3 PendingValue = null ValueExpression = ^[]0-9a-z "+,-.
18 Exporting and Importing Server Profile Use this feature to back up and restore host server profile. You can take a backup of current system configuration that is stored in a backup image file. Use Restore at anytime to put the system to pre-backup state. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 18.1 Exporting Server Profile To backup host system server profile, invoke the BackupImage() method in the class DCIM_LCService.
-r:https://[IPADDRESS]:443/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 a:basic @{IPAddress="[IP ADDRESS]"; ShareType="4";ScheduledStartTime="TIME_NOW"} 18.1.2 Exporting Server Profile to NFS Share-BackupImage() NFS Share: ShareType is “0”. The entire “Passphrase="passphrase";” argument is optional. EXAMPLE: winrm i BackupImage http://schemas.dmtf.
Inorrect Example: ShareName=”/folder1”;ImageName=”subfolder/image_name” Correct Example: ShareName=”/folder1/subfolder”;ImageName=”image_name” OUTPUT: BackupImage_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
Message = Collecting Lifecycle Controller Firmware images MessageID = BAR063 Name = Backup:Image PercentComplete = 50 The status may be one of the following: 18.
ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_859945354433, __cimnamespace = root/dcim ReturnValue = 4096 18.2.2 Set Backup Schedule The SetBackupSchedule() method used by the DCIM_LCService class is used to configure automatic backup schedule using WSMAN winrm i SetBackupSchedule http://schemas.dmtf.
winrm i GetBackupSchedule http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService?SystemCreationClassName=DCIM_ComputerSystem+Cr eationClassName=DCIM_LCService+SystemName=DCIM:ComputerSystem+Name=DCIM:LCServic e -u: -p: -r:https:///wsman -SkipCNCheck -SkipCACheck encoding:utf-8 -a:basic 18.2.
winrm i RestoreImage http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemName=DCIM:ComputerSystem +Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic @{IPAddress="[IP ADDRESS]";ShareType="4";ScheduledStartTime="TIME_NOW"} 18.3.2 Importing Server Profile from NFS share-RestoreImage() NFS Share: ShareType is “0”.
-r:https://[IPADDRESS]/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic @{IPAddress="[IP ADDRESS]";ShareName="/[DRIVESHARE]"; ShareType="2"; Username="[USERNAME]";Password="[PASSWORD]";ImageName="[IMAGENAME]"; Passphrase="[PASSPHRASE]";ScheduledStartTime="TIME_NOW"} Incorrect Example: ShareName=”/folder1”;ImageName=”subfolder/image_name” Correct Example: ShareName=”/folder1/subfolder”;ImageName=”image_name” OUTPUT: RestoreImage_OUTPUT Job Address = http://schemas.xmlsoap.
DCIM_LifecycleJob InstanceID = JID_001293618214 JobStartTime = 00000101000000 JobStatus = Restore In Progress JobUntilTime = TIME_NA Message = Restoring Lifecycle Controller Firmware images MessageID = BAR081 Name = Restore:Image PercentComplete = 20 The status may be one of the following: 273 Ready for Restore — Request has been received Restore In Progress — Restore process is currently in process Failed — Problem with the restore process, check message for more information Completed — Restore p
19 iDRAC Configuration This feature provides the ability to remotely list, get, and set the attributes on various monolithic and modular servers for the three Dell iDRAC classes through the command line. DCIM_iDRACCardEnumeration ( 19.1) DCIM_iDRACCardInteger ( 19.4) DCIM_iDRACCardString ( 19.6) Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 19.
GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.1#Enable IsReadOnly = false PossibleValues = Disabled, Enabled DCIM_iDRACCardEnumeration AttributeDisplayName = Virtual Media Attached AttributeName = Attached CurrentValue = Detached DefaultValue = Detached Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = VirtualMedia GroupID = VirtualMedia.1 InstanceID = iDRAC.Embedded.1#VirtualMedia.
GroupID = IPv4.1 InstanceID = iDRAC.Embedded.1#IPv4.1#Enable IsReadOnly = false PossibleValues = Disabled, Enabled DCIM_iDRACCardEnumeration AttributeDisplayName = User Admin IPMI LAN Privilege AttributeName = IpmiLanPrivilege CurrentValue = Administrator DefaultValue = NoAccess Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.3 InstanceID = iDRAC.Embedded.1#Users.
-u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_iDRACCardEnumeration AttributeDisplayName = Nic Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.1#Enable IsReadOnly = false PossibleValues = Disabled, Enabled 19.
The possible inputs for GroupID are: NIC.1 VirtualMedia.1 IPv4.1 Users.3 OUTPUT: DCIM_iDRACCardEnumeration AttributeDisplayName = Nic Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.
GroupID = VirtualMedia.1 InstanceID = iDRAC.Embedded.1#VirtualMedia.1#Attached IsReadOnly = false PossibleValues = Detached, Attached, Autoattach DCIM_iDRACCardEnumeration AttributeDisplayName = IPv4 Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = IPv4 GroupID = IPv4.1 InstanceID = iDRAC.Embedded.1#IPv4.
InstanceID = iDRAC.Embedded.1#Users.3#IpmiLanPrivilege IsReadOnly = false PossibleValues = User, Operator, Administrator, NoAccess 19.4 Applying the Attributes and Polling Job Completion 19.4.1 Changing iDRAC Values-ApplyAttributes() (Immediate) Invoke the ApplyAttributes() method on the DCIM_iDRACCardService class to set or change the value of one or many enumerate type attributes. This method takes an xml file as input. The changes to the attributes are defined in this xml file.
Enabled NIC.1#DNSDomainNameFromDHCP Enabled NIC.1#VLanEnable Disabled VirtualMedia.1#Attached Dettached IPv4.1#Enable Enabled IPv4.
SelectorSet Selector: InstanceID = JID_001293705757, __cimnamespace = root/dcim ReturnValue = 4096 19.4.2 Polling Job Completion Use the Get() command to check the progress of the ApplyAttributes() method. It polls for job completion. This method takes the InstanceID from the previous section ( 19.3.1) as input. The JobStatus value is either “Successful” or “Failed”. If the job failed, the Message value contains more detailed error information on the cause of the failure.
OUTPUT #2: DCIM_iDRACCardEnumeration AttributeDisplayName = Nic Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.
DCIM_iDRACCardEnumeration AttributeDisplayName = IPv4 Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = IPv4 GroupID = IPv4.1 InstanceID = iDRAC.Embedded.1#IPv4.
19.5 Listing the iDRAC Card Inventory-Integer Class Enumerate the DCIM_iDRACCardInteger class to list all the integer type iDRAC attributes. Enumerate the DCIM_iDRACCardInteger class with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.3 InstanceID = iDRAC.Embedded.1#Users.3#Privilege IsReadOnly = false LowerBound = 0 UpperBound = 511 19.6 Listing the iDRAC Card Inventory-Integer Class using groupID Enumerate the DCIM_iDRACCardInteger class to list all the integer type iDRAC attributes using the group IDs of these groups: NIC and Users. To retrieve the attributes of the groups, set the GroupID to one of the following: NIC or Users.
CurrentValue = 1 DefaultValue = 0 Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.1#VLanPriority IsReadOnly = false LowerBound = 0 UpperBound = 7 DCIM_iDRACCardInteger AttributeDisplayName = User Admin Privilege AttributeName = Privilege CurrentValue = 511 DefaultValue = 0 Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.3 InstanceID = iDRAC.Embedded.1#Users.
19.7 Listing the iDRAC Card Inventory-String Class Enumerate the DCIM_iDRACCardString class to list all the string type iDRAC attributes. Enumerate the iDRACCardString class with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = IPv4 GroupID = IPv4.1 InstanceID = iDRAC.Embedded.1#IPv4.1#Address IsReadOnly = false MaxLength = 16 MinLength = 1 DCIM_iDRACCardString AttributeDisplayName = User Admin User Name AttributeName = UserName CurrentValue = dell3 DefaultValue Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.3 InstanceID = iDRAC.Embedded.1#Users.
Invoke dracgetgroupid_string with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_iDRACCardstring -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -dialect:http://schemas.microsoft.com/wbem/wsman/1/WQL -filter:"select * from DCIM_iDRACCardString WHERE GroupID='NIC.1'" The possible inputs for GroupID are: NIC.1 IPv4.1 Users.
AttributeName = Address CurrentValue = 172.27.36.55 DefaultValue = 192.168.0.120 Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = IPv4 GroupID = IPv4.1 InstanceID = iDRAC.Embedded.1#IPv4.1#Address IsReadOnly = false MaxLength = 16 MinLength = 1 DCIM_iDRACCardString AttributeDisplayName = User Admin User Name AttributeName = UserName CurrentValue = dell3 DefaultValue Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.
19.9 Changing the iDRAC IP Change Notification 19.9.1 Getting the Current iDRAC IPChange State Get the IPChangeNotifyPS attribute from the DCIM_LCAttribute class to display. The CurrentValue field indicates the current status of this attribute. EXAMPLE: winrm get http://schemas.dmtf.
EXAMPLE: winrm i SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService+SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemName=DCIM:ComputerSystem +Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:setattribute.xml The input file setattribute.xml is shown below: PAGE 29420 Remote Service Status To get the remote service status, invoke the GetRemoteServicesAPIStatus() method in the class DCIM_LCService. This method is used to obtain the overall remote services API status that includes both the host system status as well as the Lifecycle Controller (Data Manager included) status. The overall rolled up status shall be reflected in the Status output parameter.
Status MessageID 0 (Ready) Lifecycle Controller Remote Services is ready to accept any web services request. 1 (Not Ready) Lifecycle Controller Remote Services is currently not ready to accept web services request. This could be because the instrumentation in iDRAC might be reloading /not_ready or server is in POST or performing scheduled provisioning requests or Lifecycle Controller Unified Server Configurator is in use.
application LCStatus 1. Ready 2. (Not Initialized) Lifecycle Controller instrumentation is not initialized. The initialization operation may take up to a minute. 3. (Reloading Data) Lifecycle Controller instrumentation is currently refreshing its cache because of a recent configuration change. The reloading operation typically takes few seconds and could take up to few minutes to complete. 4. (Disabled) Lifecycle Controller is disabled on the server.
+SystemName=Idrac +SystemCreationClassName=DCIM_ComputerSystem @{JobID="JID_CLEARALL" } -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNCheck -SkipCACheck -auth:basic encoding:utf-8 OUTPUT: DeleteJobQueue_OUTPUT Message = The specified job was deleted MessageID = SUP020 ReturnValue = 0 297 Dell Lifecycle Controller Web Services Interface Guide for Windows
21 System Information The DCIM System Info Profile describes the properties and interfaces for executing system management tasks related to the management of the host system. The profile standardizes and aggregates the description for the platform’s basic properties into a system view representation and provides static methodology for the clients to query the system views without substantial traversal of the model. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 21.
CPLDVersion = 1.0.0 CPURollupStatus = 1 ChassisName = Main System Chassis ChassisServiceTag = 7654321 ChassisSystemHeight = 5 ExpressServiceCode = 15608862073 FQDD = System.Embedded.1 FanRollupStatus = 3 HostName InstanceID = System.Embedded.1 LastSystemInventoryTime = 20120116145530.000000+000 LastUpdateTime = 20120116124210.000000+000 LicensingRollupStatus = 1 LifecycleControllerVersion = 2.0.0 Manufacturer = Dell Inc.
PowerState = 2 PrimaryStatus = 3 RollupStatus = 3 ServerAllocation = null ServiceTag = 7654321 StorageRollupStatus = 1 SysMemErrorMethodology = 6 SysMemFailOverState = NotInUse SysMemLocation = 3 SysMemPrimaryStatus = 1 SysMemTotalSize = 2048 SystemGeneration = 12G Monolithic SystemID = 1231 SystemRevision = 0 TempRollupStatus = 1 UUID = 4c4c4544-0036-3510-8034-b7c04f333231 VoltRollupStatus = 1 smbiosGUID = 44454c4c-3600-1035-8034-b7c04f333231 300 Dell Lifecycle Controller Web Services Interface Guide for
22 Sensor Information The DCIM Sensors Profile describes the properties and interfaces for executing system management tasks related to the management of sensors within a system. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 22.
OperationalStatus = 2 PossibleStates = Unknown PossibleStates = Fatal PossibleStates = Normal PossibleStates = Upper Fatal PossibleStates = Upper Critical PossibleStates = Upper Non-Critical PossibleStates = Lower Non-Critical PossibleStates = Lower Critical PrimaryStatus = 1 RateUnits = 0 RequestedState = 12 Resolution = 1 SensorType = 13 SettableThresholds SupportedThresholds SystemCreationClassName = DCIM_ComputerSystem SystemName = srv:system TransitioningToState = 12 UnitModifier = -1 UpperThresholdCri
CurrentState = Normal Description = System Power Consumption in Watts DeviceID = iDRAC.Embedded.
SystemName = srv:system TransitioningToState = 12 UnitModifier = 0 UpperThresholdCritical = 1344 UpperThresholdNonCritical = 1232 ValueFormulation = 2 304 Dell Lifecycle Controller Web Services Interface Guide for Windows
23 Managing Fiber Channel (FC) Configuration 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. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 23.
ValueExpression DCIM_FCInteger AttributeDisplayName AttributeName = LinkDownTimeout CurrentValue = 30000 Dependency FQDD = FC.Slot.3-2 InstanceID = FC.Slot.3-2:LinkDownTimeout IsReadOnly = false LowerBound = 1 PendingValue UpperBound = 255000 23.2 Listing the FC Inventory-Statistics Class If RT-CEM is disabled on the system, this method will return failure. Enumerate FCStatistics class ith the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
FCLossOfSignals = 0 FCRxKBCount = 0 FCRxSequences FCRxTotalFrames = 0 FCTxKBCount = 0 FCTSequences FCTxTotalFrames = 0 FQDD = FC.Slot.2-1 InstanceID = FC.Slot.2-1 OSDiverState = 2 PortSpeed = 2 PortStatus = 3 DCIM_FCStatistics FCInvalidCRCs = 0 FCLinkFailures = 0 FCLossOfSignals = 0 FCRxKBCount = 0 FCRxSequences FCRxTotalFrames = 0 FCTxKBCount = 0 FCTxSequences FCTxTotalFrames = 0 FQDD = FC.Slot.2-2 InstanceID = FC.Slot.
23.3 Listing the FC Inventory-String Class Enumerate FCStatistics class ith the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCString -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_FCString AttributeDisplayName AttributeName = DeviceName CurrentValue = QLogic QLE2662 16Gb FC Adapter Dependency FQDD = FC.Slot.3-1 InstanceID = FC.Slot.
23.4 Listing the FC Inventory-Integer Class Enumerate FCInteger class ith the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCInteger -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_FCInteger AttributeDisplayName AttributeName = LinkDownTimeout CurrentValue = 30000 Dependency FQDD = FC.Slot.3-2 InstanceID = FC.Slot.
-r:https://[IPADDRESS]/wsman - SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_FCEnumeration AttributeDisplayName AttributeName = PortEnable CurrentValue = Disabled Dependency FQDD = FC.Slot.4-1 InstanceID = FC.Slot.4-1:PortEnable IsReadOnly = false PendingValue PossibleValues = Disabled PossibleValues = Enabled PossibleValuesDescription . . 23.6 Changing the FC Attributes-SetAttribute() The SetAttribute() method can be used to change the FC configuration.
+Name=DCIM:FCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file:SetAttribute_FC.xml The input file SetAttribute_FC.xml is shown below: FC.Slot.
Note: When a user does not want to set a reboot type when creating a target job, users should comment out the RebootJobType in the input xml. User should not enter “0” or give no parameter at all in the input xml. EXAMPLE: winrm i CreateTargetedConfigJob http://schemas.dmtf.
23.8 Deleting the Pending Values for FC-DeletePendingConfiguration() This method is called to cancel the pending values created by the SetAttribute() and SetAttributes() methods. The DeletePendingConfiguration() method cancels the pending configuration changes made before the configuration job is created with CreateTargetedConfigJob(). This method only operates on the pending changes prior to CreateTargetedConfigJob() being called.
23.9 Listing the FC Views Enumerate FCView class ith the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_FCView -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_FCView Bus = 5 ChipType = 8324, Rev. 01 Device = 0 DeviceName = QLogic QLE2662 16Gb FC Adapter - 2001000E1E099026 EFIVersion = 5.30 FCTapeEnable = 3 FQDD = FC.Slot.
LinkDownTimeout = 30000 LinkStatus = 0 LoopResetDelay = 5 PCIDeviceID = 2031 PortDownRetryCount = 30 PortDownTimeout = 0 PortLoginRetryCount = 8 PortLoginTimeout = 3000 PortNumber = 1 PortSpeed = 2 SecondFCTargetLUN = 0 SecondFCTargetWWPN = 00:00:00:00:00:00:00:00 VendorName VirtualWWN = 20:00:00:0E:1E:09:90:26 VirtualWWPN = 20:01:00:0E:1E:09:90:26 WWN = 20:00:00:0E:1E:09:90:26 WWPN = 20:01:00:0E:1E:09:90:26 315 Dell Lifecycle Controller Web Services Interface Guide for Windows