Home

Dell Lifecycle Controller 1.2 for Windows Web Services Interface Guide

Contents

1. 5 Lifecycle Controller Server is executing UEFI Lifecycle Controller Unified Unified Server Configurator Server Configurator application LCStatus 0 Ready Lifecycle Controller instrumentation is up to date and enabled 1 Not Initialized Lifecycle Controller instrumentation is not initialized The initialization operation may take up to a minute 2 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 3 Disabled Lifecycle Controller is disabled on the server Lifecycle Controller can be enabled thru Remote Services or F2 iDRAC configuration 4 In Recovery Lifecycle Controller is in Recovery mode Refer to iDRAC users guide on instructions on how to repair Lifecycle Controller 5 In Use Lifecycle Controller is being currently used by another process 20 2 Restarting Remote Service Status If you continue to get Not Ready remote service status invoke the DeleteJobQueue method with JID_CLEARALL job id to restart the remote service LC1 5 x ONLY EXAMPLE winrm invoke DeleteJobQueue cimv2 root dcim DCIM_JobService CreationClassName DCIM_JobService Name JobService SystemName ldrac SystemCreationClassName DCIM_ComputerSystem JobID JID_CLEARALL u USER p PASSWORD r https IPADDRESS wsman
2. 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 a basic file GetRAIDLevels xml The input file GetRAIDLevels xml is shown below lt p GetRAIDLevels_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p DiskType gt 0 lt p DiskType gt lt p Diskprotocol gt 0 lt p Diskprotocol gt lt p DiskEncrypt gt 0 lt p DiskEncrypt gt lt p PDArray gt Disk Bay 0 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p PDArray gt Disk Bay 1 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p GetRAIDLevels_INPUT gt OUTPUT GetRAIDLevels_OUTPUT ReturnValue 0 VDRAIDEnumArray 2 4 The VDRAIDEnumArray numbers correspond to the following RAID levels RAIDLevel RAID 0 2 RAID 1 4 RAID 5 64 RAID 6 128 167 Version 2 1 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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
3. Passphrase PASSPHRASE ScheduledStartTime TIME_NOW NOTE The ShareName field should only be the folder exposed by the system to the network Any sub folder information should be attached to the ImageName field Otherwise there can be connection issues when trying to locate create the backup file Correct Example ShareName folder1 lmageName subfolder image_name In Correct Example ShareName folder1 subfolder lmageName image_name 198 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OUTPUT Restorelmage_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001293618214 __cimnamespace root dcim ReturnValue 4096 The response contains a reference to the job class that will provide the status of the operation The return value is 4096 which indicates that the method operation is not yet complete 18 2 4 Monitoring Import Status Restore process may take up to 60 minutes depending on host system configuration To monitor the backup status get the instance of the corresponding job Replace INSTANCE ID with the actual jobid from Section 18 2 1 18 2 2 or 18 2 3 EXAMPLE winrm get http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LifecycleJob InstancelD INSTA
4. r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_FCStatistics FCInvalidCRCs 0 FCLinkFailures 0 FCLossOfSignals 0 FCRxKBCount 0 220 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows FCRxSequences FCRxTotalFrames 0 FCTxKBCount 0 FCTxSequences FCTxTotalFrames 0 FQDD FC Slot 2 1 InstancelD FC Slot 2 1 OSDriverState 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 InstancelD FC Slot 2 2 OSDriverState 2 PortSpeed 2 PortStatus 3 23 3 Listing the FC Inventory String Class Enumerate FCStatistics class ith the following parameters and syntax EXAMPLE Version 2 1 0 winrm e http schemas dmtf org wbem wscim 1 cim schema 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 InstancelD FC Slot 3 1 DeviceName IsReadOnly true MaxLength 32 MinLength 0 PendingValue 221 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 ValueExpression 23 4 Listing the FC Inventory
5. schemas dmtf org wbem wscim 1 cim schema 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 DeletePendingConfiguration_CNA xml The input file DeletePendingConfiguration_CNA xml is shown below lt p DeletePendingConfiguration_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Integrated 1 1 1 lt p Target gt lt p DeletePendingConfiguration_INPUT gt 135 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OUTPUT DeletePendingConfiguration_OUTPUT Message The command was successful MessagelD 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_N CEnumeration 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 1 in which this example would use NIC Integrated 1 1 1 as an InstancelD EXAMPLE winrm g http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICEnumeration InstancelD INSTANCEID r https IPADDRESS 443 wsman u USER p PASSWORD auth basic
6. 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 All data on the existing virtual disks will be lost Invoke ResetConfig with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section 16 7 EXAMPLE 155 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm i ResetConfig http schemas dmtf org wbem wscim 1 cim schema 2 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 ResetConfig xml The input file ResetConfig xml is shown below lt p ResetConfig_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p ResetConfig_INPUT gt OUTPUT ResetConfig_OUTPUT ReturnValue 0 16 13 Clearing the Foreign Configuration ClearForeignConfig The ClearForeignConfig method is used to prepare any foreign physical disks for inclusion in the local configuration Invoke ClearFore
7. 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 1038 8046 d3c04f474835 64 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 and related MOF files 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 2 Remote Job Control Examples 10 2 1 Setup Job Queue The SetupJobQueue method takes in an array of jobids and schedules them to run immediately or at a later time The jobids are acquired via enumerating DCIM_LifecycleJob as described in Section 10 2 3 When there is a Reboot Job in a job array that contains multiple jobs the system will reboot the UEFI Unified Extensible Firmware Interface at the scheduled time Invo
8. 5 2 2 Privilege and Capabilities using iDRAC Attributes c eee eeeeeeeeeeeees 19 5 3 Manage Account Settings using iIDRAC Attributes ccceceeeeeeeeeeeeeeeeeeeeeeeeeees 20 5 3 1 Modify User Name using iDRAC Attributes 2 0 0 0 eee ceeeeeeeeeeeeeeeeentneeeeeeees 20 5 3 2 Modify Password using iDRAC Attributes cecceeeeeeeeeeeeeeeeeeneeeeeeees 21 5 3 3 Modify Account State using iDRAC Attributes eee ceeeeeeeeeeeeeeeetteeeeeeees 22 5 3 4 Modify User Privilege using iDRAC Attributes eee ccceeeeeeeeeeeeeeestteeeeeeees 23 5 4 Account Inventory using DMTF Model ccccceceeeeeeeeeeeeeeeeeeeeeeeeaeeeeeeeeeeteneenaaees 23 5 4 1 Account and Capabilities using DMTF Model cc ceeeeeeeeeeeeeeeteeeeeeeees 23 5 4 2 Privilege and Capabilities using DMTF Model c ceeeeeeeeeeeeeeeteeeeeeeees 26 5 5 Manage Account Settings using DMTF Modell ccccceeeeeeeeeeeneeeeeeeeeeeteeeeaaees 28 5 5 1 Modify User Name using DMTF Model ccceeeceeeeeeeeeeeeeeeeeeeeesneeeeeeeees 28 5 5 2 Modify Password using DMTF Model ccccceeeeeeeeeeneeeeeeeeeeeeeeesneeeeeeees 31 5 5 3 Modify Account State using DMTF Model ceeeeeeeeeeneeeeeeeeeeeeeeenneeeeeeees 31 5 5 4 Modify User Privilege using DMTF Model eeeeeeeeeeeeeeeeeeeeeeeeeeneeeeeeees 32 Ge Firmware INVent ry rs cone denne tact e dang a ai aaa e ia a ei
9. Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 MessagelD and Message output parameters will further contain method invocation information if an error occurred ConfigurableBootToNetworkISO_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD DCIM_OSDConcreteJob 1 __cimnamespace root dcim ReturnValue 4096 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 The Dell Common Information Model CIM class extensions for supporting Lifecycle Controller feature management are defined in the Dell LC Management and related MOF files The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell LC Management Profile Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile 12 1 Collect System
10. Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name IpVer gt IPv6 lt ROIf gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 GroupDisplayName iSCSI General Parameters GroupID IscsiGenParams InstancelD NIC Integrated 1 1 1 TcplpViaDHCP IsReadOnly false PendingValue null PossibleValues Disabled Enabled PossibleValuesDescription Disabled Enabled DCIM_NICEnumeration AttributeDisplayName IP Autoconfiguration AttributeName IpAutoConfig CurrentValue Enabled Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name IpVer gt IPv4 lt ROIf gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 GroupDisplayName iSCSI General Parameters GroupID IscsiGenParams InstancelD NIC Integrated 1 1 1 lpAutoConfig IsReadOnly true PendingValue null 126 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows PossibleValues Disabled Enabled PossibleValuesDescription Disabled Enabled DCIM_NICEnumeration AttributeDisplayName iSCSI Parameters via DHCP AttributeName IscsiViaDHCP CurrentValue Enabled Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 GroupDisplayName iSCSI General Parameters GrouplD IscsiGenParams
11. PendingValue null ValueExpression null DCIM_NICString AttributeDisplayName PCI Device ID AttributeName PCIDevicelD CurrentValue 165F Dependency null FQDD NIC Integrated 1 1 1 GroupDisplayName Broadcom Main Configuration Page GroupID VndrConfigPage InstancelD NIC Integrated 1 1 1 PCIDevicelD 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 InstancelD NIC Integrated 1 1 1 BusDeviceFunction IsReadOnly true MaxLength 0 MinLength 0 PendingValue null ValueExpression null DCIM_NICString AttributeDisplayName Link Status AttributeName LinkStatus CurrentValue UP Dependency null FQDD NIC Integrated 1 1 1 GroupDisplayName Broadcom Main Configuration Page GroupID VndrConfigPage InstancelD NIC Integrated 1 1 1 LinkStatus IsReadOnly true MaxLength 0 MinLength 0 PendingValue null ValueExpression null 128 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 org wbem wscim 1 cim schema 2 root dcim DCIM_N
12. encoding utf 8 a basic OUTPUT GetRemoteServicesAP Status_OUTPUT LCStatus 0 Message Lifecycle Controller Remote Services is ready MessagelD LC061 ReturnValue 0 ServerStatus 2 Status 0 Details on each output parameter is described below Output Possible values Description parameter Name Status 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 MessagelD LC060 LC061 Message Lifecycle Controller Message for ID LC060 Remote Services is not ready Lifecycle Controller Message for ID LC061 Remote Services is ready ServerStatus 0 Powered off Server is powered off 1 In POST Server is performing normal POST operation 2 Out of POST Server is out of POST 3 Collecting System Inventory Server is currently executing UEFI Collect System Inventory On Restart application 4 Automated Task Execution Server is currently executing scheduled jobs using UEFI Automated Task application 214 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0
13. 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 0 NFS 1 TFTP 2 CIFS SHAREUSER User account for the ISO share location SHAREPASSWORD Password of the share account WORKGROUP Applicable workgroup IMAGENAME Image name of the iso image such as boot iso Port Port number for connecting to the share such as 2049 77 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i DownloadISOToVFlash 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 encoding utf 8 a basic IPAddress IPADDESS ISO ShareName DRIVESHARE ShareType SHARETYPE Username SHAREUSER Password SHAREPASSWORD Workgroup WORKGROUP ImageName IMAGENAME Port PORT OUTPUT The return will be 0 for success or 1 if an error occurred in starting the processing the input p
14. schema 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 ShareName DRIVESHARE ShareType 2 lmageName IMAGENAME Username USERNAME Password PASSWORD Passphrase PASSPHRASE ScheduledStartTime TIME_NOW NOTE The ShareName field should only be the folder exposed by the system to the network Any sub folder information should be attached to the ImageName field Otherwise there can be connection issues when trying to locate create the backup file Correct Example ShareName folder1 lmageName subfolder image_name 195 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 In Correct Example ShareName folder1 subfolder lmageName image_name OUTPUT Backuplmage_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 InstancelD JID_001293618214 __ cimnamespace root dcim ReturnValue 4096 The response contains a reference to the job class that will provide the status of the operation The return value is 4096 which indicates that the method operation is not
15. 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 1 Enclosure Internal 0 0 RAID Slot 1 1 Disk Bay 2 Enclosure Internal 0 0 RAID Slot 1 1 PrimaryStatus 1 RAIDStatus 2 RAIDTypes 2 ReadCachePolicy 16 RemainingRedundancy 0 RollupStatus 1 SizelnBytes 107481464832 SpanDepth 1 SpanLength 3 StartingLBAinBlocks 0 154 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 StripeSize 128 VirtualDiskTargetID 0 WriteCachePolicy 1 16 11 Listing the RAID EnclosureView Inventory Enumerating the Enclosure View 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 org wbem wscim 1 cim schema 2 root dcim DCIM_EnclosureView u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_EnclosureView AssetTag Connector 0 EMMCount 0 FQDD Enclosure Internal 0 0 RAID Integrated 1 1 FanCount 0 InstancelD Enclosure Internal 0 0 RAID Integrated 1 1 LastSystemInventoryTime 20100413194610 LastUpdateTime 20100413193143 PSUCount 0 PrimaryStatus 0 ProductName BACKPLANE 0 0 RollupStatus 0 ServiceTag SlotCount 6 TempProbeCount
16. 134 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p Target gt NIC Integrated 1 1 1 lt p Target gt lt p RebootJobType gt 1 lt p RebootJobType gt lt p ScheduledStartTime gt TIME_NOW lt p ScheduledStartTime gt lt p UntilTime gt 20201111111111 lt p UntilTime gt lt p CreateTargetedConfigJob_INPUT gt OUTPUT 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001269609760 __cimnamespace root dcim ReturnValue 4096 15 8 Deleting the Pending Values for CNA DeletePendingConfiguration The DeletePendingConfiguration method cancels the pending configuration changes made before the configuration job is created using the CreateTargetedConfigJob method This method only operates on the pending changes before running the CreateTargetedConfigJob method After the configuration job is created to cancel the pending changes call the DeleteJobQueue method in the Job Control profile Invoke the DeletePendingConfiguration method with the following parameters and syntax EXAMPLE winrm i DeletePendingConfiguration http
17. 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 org wbem wscim 1 cim schema 2 root dcim DCIM_NICStatistics u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_NICStatistics DiscardedPkts 0 FCCRCErrorCount null FCOELinkFailures null FCOEPktRxCount null FCOEPktTxCount null FCOERxPktDroppedCount null FQDD NIC Integrated 1 1 1 InstancelD NIC Integrated 1 1 1 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 000000 000 133 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 TxBroadcast 0 TxBytes null TxErrorPktExcessiveCollision null TxErrorPktLateCollision null TxErrorPktMultipleCollision null TxErrorPktSingleCollision null TxMutlicast 74 TxPauseXOFFFrames 0 TxPauseXONFrames 0 TxUnicast 193 15 7 Applying the Pending Values for CNA CreateTargetedConfigJob The CreateTargetedConfigJob method is called
18. 8 Power State Management 8 1 Description of Base Server vs 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 The Power State Management Profile offers the RequestPowerStateChange method available on the instance of the PowerStateManagmentService associated with the instance of CIM_ComputerSystem representing the server platform Base Server Profile http www dmif org sites default files standards documents DSP1004 1 0 1 pdf Power State Management Profile http www dmif org sites default files standards documents DSP1027_2 0 0 pdf 8 2 Get Power State 8 2 1 Base Server Method The power state of the system is reported by the EnabledState property of the DCIM_ComputerSystem class EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 DCIM_ComputerSystem u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_ComputerSystem CreationClassName DCIM_ComputerSystem Dedicated 0 ElementName EnabledState 2 HealthState 25 IdentifyingDescriptions CIM GUID CIM Tag DCIM ServiceTag Name srv system OperationalS
19. BIOS Setup 1 1 BootMode IsReadOnly false PendingValue null PossibleValues Bios Uefi DCIM_BIOSEnumeration AttributeName BootSeqRetry CurrentValue Disabled DefaultValue null FQDD BIOS Setup 1 1 InstancelD BIOS Setup 1 1 BootSeqRetry IsReadOnly false PendingValue null PossibleValues Disabled Enabled 184 The get instance method in Section 17 2 will use this InstancelD as input The set attribute method in Section 17 3 will use the AttributeName and PossibleValues fields as input The set attributes method in Section 17 4 will use the AttributeName and PossibleValues fields as input Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 instancelD EXAMPLE winrm g http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSEnumeration InstancelD INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_BlOSEnumeration AttributeName NumLock CurrentValue On DefaultValue null F
20. Dell 12 Generation PowerEdge Server Resources http www delltechcenter com 12thGen Dell CIM Profiles http www delltechcenter com page DCIM Library Profile 3 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 5 Openwsman CLI http www openwsman org project wsmancli DMTF Common Information Model CIM Infrastructure Specification DSP0004 http www dmif org standards published_documents DSP0004 2 5 0 pdf 10 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 7 List of PCI IDs http pciids sourceforge net pci ids Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 3 Overview The remote interface guidelines provided in this document are illustrated by command line 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 environments using WinRM and WSMANCLI respectively The Lifecycle Controller remote management capabilities are organized by management domain and documented in Dell CIM Profile specifications The remote enablement feature for Lifecycle Controller 2 0 provides the following capabilities e Remotely get inventory of the BIOS component firmware and embedde
21. 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 ExportLCLog http schemas dmtf org wbem wscim 1 cim schema 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 ExportLCLog xml The input file ExportLCLog xml is shown below lt p ExportLCLog_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p IPAddress gt 123 456 7 8 lt p IPAddress gt 101 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p ShareName gt sharename lt p ShareName gt lt p FileName gt filename txt lt p FileName gt lt p ShareT ype gt 0 lt p ShareType gt lt p Username gt admin lt p Username gt lt p Password gt password lt p Password gt lt p Workgroup gt workgroup lt p Workgroup gt lt p ExportLCLog_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned ExportLCLog_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http
22. Name SysProfile gt PerfOptimized lt Suplf gt lt ValLev gt lt Dep gt DisplayOrder 1322 FQDD BIOS Setup 1 1 GroupDisplayName System Profile Settings GroupID SysProfileSettings InstancelD BIOS Setup 1 1 MemVolt IsReadOnly true PendingValue null PossibleValues AutoVolt Volt15V PossibleValuesDescription Auto 1 5V DCIM_BlOSEnumeration AttributeDisplayName Serial Debug Output AttributeName SerialDbgOut CurrentValue Disabled Dependency null 62 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 DisplayOrder 319 FQDD BIOS Setup 1 1 GroupDisplayName Memory Settings GroupID MemSettings InstancelD BIOS Setup 1 1 SerialDbgOut IsReadOnly false PendingValue null PossibleValues Enabled Disabled PossibleValuesDescription Enabled Disabled DCIM_BlOSEnumeration AttributeDisplayName Password Status AttributeName PasswordStatus CurrentValue Unlocked Dependency null DisplayOrder 1405 FQDD BIOS Setup 1 1 GroupDisplayName System Security GroupID SysSecurity InstancelD 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
23. RequestedStatesSupported 2 3 5 4 2 Privilege and Capabilities using DMTF Model The account privilege assigned to a user is defined in the class C M_Privilege associated with the CIM_Account class The class contains a list of privileges granted to the user account Profiles http www dmif org sites default files standards documents DSP1034 1 0 1 pdf http www dmif org sites default files standards documents DSP1039 1 0 0 pdf To get the instance of CIM_Privilege for an account Get the CIM_Account class instance of interest using EnumerateEPR mode Enumerate the associators of the CIM_Account instance and search for CIM_Identity class instance using EnumerateEPR mode Enumerate the associators of the CIM_Identity instance and search for CIM_Role class instance using EnumerateEPR mode 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 26 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm e http schemas dmtf org wbem wscim 1 cim schema 2 DCIM_LocalRolePrivilege u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_LocalRolePrivilege Activities nul
24. The second stage is to monitor the download The download status may be monitored by enumerating or getting the instance of the corresponding job 7 5 3 Reboot to Perform Update Once downloaded the request needs to be scheduled The third stage is to schedule the update To schedule the update use the SetupJobQueue method of the class DCIM_JobService in Section 10 2 1 7 5 4 Wait for Job Completion The fourth stage is to wait for the job to be completed which may take several minutes The job status can be monitored as shown in Section 10 2 3 39 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 7 5 5 Delete Job The fifth and final stage is to delete the completed job from the job store Deleting the job queue is shown in Section 10 2 2 7 6 Update NICs 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 The method returns a jobid for an instance of DCIM_SoftwareUpdateJob that can be scheduled to execute or queried for status at a later time The following is the example of the method for updating a NIC firmware Invoke InstallFromURI with the following parameters and syntax 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
25. 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271168441 __ cimnamespace root dcim ReturnValue 0 12 19 Import System Configuration This method is used to import the system configuration from the Lifecycle Controller from a file on a remote share Invoke ImportSystemConfiguration 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 106 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 EXAMPLE winrm i ImportSystemConfiguration http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClass Name DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic IPAddress SHARE_IP_ADDRESS ShareName SHARE_NAME ShareType SHARE_TYPE FileName S
26. encoding utf 8 SkipCNCheck SkipCACheck OUTPUT DCIM_NICEnumeration AttributeDisplayName iSCSI Offload Mode AttributeName iScsiOffloadMode CurrentValue Disabled Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name NicMode 133Partition 0723 135 gt Enabled lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 3 GroupDisplayName PARTITION 3 CONFIGURATION GroupID ConfigureForm3 InstancelD 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 136 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 For Broadcom CNA cards the partitions on each port can be set to any personality NICMode can always be enabled or disabled for any of the given partitions For the IscsiOffloadMode and FcoeOffloadMode personalities up to two personalities can be enabled on each port For the Qlogic CNA cards partition three can be set to either NiICMode or IscsiOffloadMode Partition four can be set to either NICMode or FcoeOffloadMode Invoke the SetAttribute method with the following parameters from Section
27. p AttributeValue gt lt p AttributeName gt IscsilnitiatorChapld lt p AttributeName gt lt p AttributeValue gt testid lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorChapPwd lt p AttributeName gt lt p AttributeValue gt testpassword lt p AttributeValue gt lt p AttributeName gt FirstT gtlpAddress lt p AttributeName gt lt p AttributeValue gt 2 2 2 2 lt p AttributeValue gt lt p AttributeName gt FirstT gtIlscsiName lt p AttributeName gt lt p AttributeValue gt tgtiscsitest lt p AttributeValue gt lt p AttributeName gt FirstT gtChapld lt p AttributeName gt lt p AttributeValue gt firsttestID lt p AttributeValue gt lt p AttributeName gt FirstT gtChapPwd lt p AttributeName gt lt p AttributeValue gt testpassword2 lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD NIC001 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 15 16 Setting the FCoE Boot Target Version 2 1 0 The SetAttributes method is used to set or change the values of the FCoE 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 If this value is valid it is applied to the PendingValue property or the Currentvalue
28. 0 or give no parameter at all in the input xml EXAMPLE winrm i CreateTargetedConfigJob http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_BlOSService SystemName DCIM ComputerSystem Name DCIM BlOSService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file CreateTargetedConfigJob_BIOS xml The input file CreateTargetedConfigJob_BIOS xml is shown below lt p CreateTargetedConfigJob_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService gt lt p Target gt BlOS Setup 1 1 lt p Target gt lt p RebootJobType gt 2 lt p RebootJobType gt lt p ScheduledStartTime gt TIME_NOW lt p ScheduledStartTime gt lt p UntilTime gt 20111111111111 lt p UntilTime gt lt p CreateTargetedConfigJob_INPUT gt OUTPUT 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001269609760 __cimnamespace root dcim ReturnValue 4096 17 8 Deleting the Pending Values for BIOS amp Boot
29. 0 0 CPURollupStatus 1 ChassisName Main System Chassis ChassisServiceTag 7654321 ChassisSystemHeight 5 ExpressServiceCode 15608862073 FQDD System Embedded 1 FanRollupStatus 3 HostName InstancelD System Embedded 1 LastSystemInventoryTime 20120116145530 000000 000 LastUpdateTime 20120116124210 000000 000 216 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 LicensingRollupStatus 1 LifecycleControllerVersion 2 0 0 Manufacturer Dell Inc MaxCPUSockets 2 MaxDIMMSlots 24 MaxPCleSlots 7 MemoryOperationMode OptimizerMode Model PowerEdge T620 PSRollupStatus 1 PlatformGUID 3132334f cOb7 3480 3510 00364c4c4544 PopulatedCPUSockets 1 PopulatedDIMMSlots 1 PopulatedPCleSlots 1 PowerCap 336 PowerCapEnabledState 3 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 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
30. 1 cim schema 2 DCIM_Account __cimnamespace root dcim CreationClassName DCIM_Account Name iDRAC Embedded 1 Users 16 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc r https IPADDRESS u USER p PASSWORD a basic encoding utf 8 UserlD testuser4 UserPassword testuser4 SkipCACheck SkipCNCheck skiprevocationcheck When this command is executed the UserID will be displayed in the output The UserPassword will be displayed as null when the account is disabled After the account is enabled it will be displayed as blank The value of UserPassword will never be displayed OUTPUT C DCIM_Account CreationClassName DCIM_Account ElementName DCIM Account EnabledDefault 2 EnabledState 3 Name iDRAC Embedded 1 Users 16 OrganizationName DCIM 30 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 RequestedState 0 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc TransitioningToState 12 UserlD testuser4 UserPassword null UserlD testuser4 UserPassword testuser4 D If the account specified is new or not yet enabled it will not be accessible Login as root in the UI and verify the user name is set correctly and enable it E Logout of the Ul Logging in with new user name and password and be successful Possible responses 1 A fault is returned which suggests a possible error in the request payload 2
31. 16 7 PDArray This parameter is the list of physical disk FQDDs that is used to create a virtual Disk VDPropNameArray This parameter is the list of property names that is used to create a virtual disk The parameter list has the following names VirtualDiskName CacheCade VDPropValueArray This parameter is the list of property values that is used to create a virtual Disk The property values are for the property names listed under VDPropNameArray VirtualDiskName Name of the virtual disk 1 15 character range Cachcade The valid input value is 1 required 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 CreateVDCacheCade xml The input file CreateVDCacheCade xml is shown below lt p CreateVirtualDisk_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p PDArray gt Disk Bay 4 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p VDPropNameArray gt VirtualDiskName lt p VDPropNameArray gt lt p VDPropValueArray gt MyCacheCadeVD lt p VDPropValueArray gt lt p VDPropNameArray gt Cachecade lt p VDPropNameArray gt lt p VDPropValueArray gt 1 lt p
32. 2 1 0 lt p CreateTargetedConfigJob_INPUT gt OUTPUT 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271251761 __ cimnamespace root dcim ReturnValue 4096 16 15 Deleting the Pending Values for RAID DeletePendingConfiguration 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 After the configuration job is created the pending changes can only be canceled by calling DeleteJobQueue in the Job Control profile Invoke DeletePendingConfiguration with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section 16 7 EXAMPLE winrm i DeletePendingConfiguration http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_RAIDService SystemName DCIM ComputerSystem Name DCIM RAIDService u USER p PASSWORD r https I
33. 443 SkipCNCheck SkipCACheck auth basic encoding utf 8 OUTPUT DeleteJobQueue_OUTPUT Message The specified job was deleted MessagelD SUP020 ReturnValue 0 215 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 1 Listing the System Inventory SystemView Class The system view returns various information about the system including the currently installed Lifecycle Controller version as shown below Enumerate the DCIM_SystemView class with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_SystemView u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_SystemView AssetTag BlOSReleaseDate 01 09 2012 BlOSVersionString 0 3 37 BaseBoardChassisSlot NA BatteryRollupStatus 1 BladeGeometry 4 BoardPartNumber OMX4YFX04 BoardSerialNumber CN13740184000Q CMCIP null CPLDVersion 1
34. 46 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_ComputerSystem SelectorSet Selector Name srv system CreationClassName DCIM_ComputerSystem __cimnames pace root dcim 8 3 Get Power Control Capabilites 8 3 1 Base Server Method The power control capabilities are reported by the RequestedStatesSupported property of the CIM_EnabledLogicalElementCapabilities class associated with the main system C M_ComputerSystem class Base Server Profile http www dmtf org sites default files standards documents DSP1004_1 0 1 pdf In Part A enumerate the C M_ElementCapabilities class and search for the DCIM_CSElementCapabilities reference Use the resulting InstancelD in Part B to obtain the RequestedStatesSupported property EXAMPLE Part A winrm e http schemas dmtf org wbem wscim 1 cim schema 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 com wbem wscim 1 cim schema 2 DCIM_CSEnabledLogicalElementCapabilities SelectorSet Selector InstancelD DCIM ComputerCap 1 __cimnamespace root dcim Characteristics null ManagedElement Addr
35. Anempty response which suggests an error occurred while processing the request 3 An instance of the class is returned where the property value is unchanged 4 An instance of the class is returned where the property value is modified The set is successful 5 The property value may be blank as intended by the implementation for security To determine success try logging in with the new password Ensure the account is enabled 5 5 2 Modify Password using DMTF Model When the account setting capability allows the user password of an account may be modified by issuing a set operation on the UserPassword property of the C M_Account class instance The set operation 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 dmif org sites default files standards documents DSP1034 1 0 1 pdf http www dmif org sites default files standards documents DSP1039 1 0 0 pdf See Section 5 5 1 for an implementation example 5 5 3 Modify Account State using DMTF Model When the account setting capability allows the user account may be enabled or disabled by invoking the RequestStateChange method
36. AttributeValue gt 60 lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttributes_OUTPUT Message The method was successful MessagelD STOROO1 RebootRequired Yes ReturnValue 0 SetResult Set Pending Value 16 20 Convert Physical Disks to RAID ConvertToRAID The ConvertToRAID method is used to convert physical disks in Non RAID state to a state usable for RAID After the method is successfully executed the PendingValue property of RA IDPDState should reflect the pending changes After the CreateTargetedConfigJob method is successfully executed the RAIDStatus property which is enumerated in the DCIM_PhysicalDiskView from Section 16 9 of that physical disk should reflect the new state Invoke ConvertToRAID with the following parameters and syntax Physical Disk TARGET Obtained from the FQDD field Section 16 9 An example of Disk Bay 2 Enclosure Internal 0 0 RAID Slot 1 1 is shown below EXAMPLE winrm invoke ConvertToRAID cimv2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_ComputerSystem CreationClassN 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 182 Dell Lifecycle Controller 2 Web Services Interfac
37. Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i DeleteAutoDiscoveryClientCerts http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USERNAME p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic SkipCACheck SkipCNCheck skiprevocationcheck OUTPUT DeleteAutoDiscoveryClientCerts_OUTPUT ReturnValue 0 12 9 Set Public Certificates This method is used to update a public SSL Certificate on the iDRAC Invoke SetPublicCertificate with the following parameters and syntax Type Specifies certificate service directoryCA certificate for Active Directory or LDAP server EXAMPLE winrm i SetPublicCertificate http schemas dmtf org wbem wscim 1 cim schema 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 lt p SetPublicCertificate_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p Type gt directoryCA lt p Type gt lt p Certificate gt sens
38. 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 B Perform a get on any instance from A to ensure correctness of the URI EXAMPLE B winrm g http schemas dell com wbem wscim 1 cim schema 2 DCIM_Account __cimnamespace root dcim CreationClassName DCIM_Account Name iDRAC Embedded 1 Users 16 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc 29 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 r https IPADDRESS u USER p PASSWORD 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 16 OrganizationName DCIM RequestedState 0 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc TransitioningToState 12 UserID null UserPassword null C If B is successful set the new values for the specified instance EXAMPLE C winrm set http schemas dell com wbem wscim
39. InstancelD NIC Integrated 1 1 1 IlscsiViaDHCP IsReadOnly false PendingValue null PossibleValues Disabled Enabled PossibleValuesDescription Disabled Enabled DCIM_NICEnumeration AttributeDisplayName CHAP Authentication AttributeName ChapAuthEnable CurrentValue Disabled Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 GroupDisplayName iSCSI General Parameters GroupID IscsiGenParams InstancelD NIC Integrated 1 1 1 ChapAuthEnable IsReadOnly false PendingValue null PossibleValues Disabled Enabled PossibleValuesDescription Disabled Enabled 15 2 Listing the NIC CNA Inventory String Class Enumerate DCIM_NICString class with the following parameters and syntax EXAMPLE Version 2 1 0 winrm e http schemas dmtf org wbem wscim 1 cim schema 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 AO Dependency null FQDD NIC Integrated 1 1 1 127 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 GroupDisplayName Broadcom Main Configuration Page GroupID VndrConfigPage InstancelD NIC Integrated 1 1 1 ChipMdl IsReadOnly true MaxLength 0 MinLength 0
40. InstancelD is as follows InstancelD JID_001293705757 OUTPUT DCIM_LifecycleJob InstancelD JID_001293705757 JobStartTime TIME_NA JobStatus Completed JobUntilTime TIME_NA Message NA MessagelD NA Name iDRACConfig iDRAC Embedded 1 PercentComplete 100 19 4 3 Set Attribute Verification To verify the changes made to the attributes enumerate the DCIM_iDRACCardEnumeration class For more information see Section 19 1 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 InstancelD iDRAC Embedded 1 NIC 1 Enable IsReadOnly false PossibleValues Disabled Enabled DCIM_iDRACCardEnumeration AttributeDisplayName Virtual Media Attached AttributeName Attached CurrentValue Attached DefaultValue Detached Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName VirtualMedia GrouplD VirtualMedia 1 InstancelD iDRAC Embedded 1 VirtualMedia 1 Attached 206 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows 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 GroupDisplay
41. Integer Class Enumerate FC nteger class ith the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FClInteger 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 InstancelD FC Slot 3 2 LinkDownTimeout IsReadOnly false LowerBound 1 PendingValue UpperBound 255000 23 5 Listing the FC Inventory Enumeration Class Enumerate FCEnumeration class ith the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCEnumeration u USER p PASSWORD 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 InstancelD FC Slot 4 1 PortEnable IsReadOnly false PendingValue 222 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 PossibleValues Disabled PossibleValues Enabled PossibleValuesDescription 23 6 Changing the FC Attributes SetAttribute The SetAttribute method can be used to change the FC configuration Invoke SetAttribute with the following parameters and syntax TARGET Obtained from the InstancelD
42. Interface Guide for Windows Version 2 1 0 Size RAIDLevel SpanDepth SpanLength StripeSize ReadPolicy WritePolicy DiskCachePolicy VirtualDiskName Initialize VDPropValueArray This parameter is the list of property values that is used to create a virtual Disk The property values are for the property names listed under VDPropNameArray Size Size of the virtual disk specified in MB If not specified default will use full size of physical disks selected RAIDLevel RAID 0 2 RAID 1 4 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 StripeSize 8KB 16 16KB 32 32KB 64 64KB 128 128KB 256 174 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 256KB 512 512KB 1024 1MB 2048 ReadPolicy No Read Ahead 16 Read Ahead 32 Adaptive Read Ahead 64 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 StartingLBA Starting logical block address of virtual disks in blocks If OXFFFFFFFFFFFFFFFF startingLBA is calculated programmatically The value
43. 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 85C6DE0A Size 1024 Speed 1333 9 4 CPU Inventory Version 2 1 0 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 Profile Enumerate DCIM_CPUView with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_CPUView u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 SkipCACheck SkipCNCheck OUTPUT DCIM_CPUView CPUFamily B3 CPUStatus 1 Cache1Associativity 7 Cache1ErrorMethodology 5 CacheiLevel 0 Cache1PrimaryStatus 1 Cache1SRAMType 2 Cache1Size 256 Cache1Type 4 Cache1WritePolicy 0 Cache2Associativity 7 Cache2ErrorMethodology 5 Cache2Level 1 Cache2PrimaryStatus 1 Cache2SRAMType 2 54 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Cache2Size 2048 Cache2Type 5 Cache2WritePolicy 0 Cache3Associativity 14 Cache3ErrorMethodology 5 Cache3Level 2 Cache3PrimaryStatus 1 Cache3SRAMType 2 Cache3Size 2
44. PClVendorID 102B 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 Profile Enumerate the DCIM_VFlashView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_VFlashView u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_VFlashView AvailableSize 970 Capacity 976 ComponentName vFlash SD Card FQDD Disk vFlashCard 1 HealthStatus OK InitializedState Initialized InstancelD Disk vFlashCard 1 LastSystemInventoryTime 20100408123517 LastUpdateTime 201004081 23517 Licensed true VFlashEnabledState true WriteProtected false 9 9 NIC Inventory amp Configuration 58 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 N iCStr
45. PrimaryStatus 1 RaidStatus 2 Revision DS62 RollupStatus 1 SASAddress 5000C50025D64875 SecurityState 0 SerialNumber 9SP297S1 SizelnBytes 499558383616 Slot 0 SupportedEncryptionTypes None UsedSizelnBytes 35827154944 DCIM_PhysicalDiskView BusProtocol 6 Connector 0 DriveFormFactor 2 152 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 FQDD Disk Bay 1 Enclosure Internal 0 0 RAID Slot 1 1 FreeSizelnBytes 8978432 HotSpareStatus 0 InstancelD Disk Bay 1 Enclosure Internal 0 0 RAID Slot 1 1 LastSystemInventoryTime 20120116145459 000000 000 LastUpdateTime 20120116145459 000000 000 Manufacturer SEAGATE ManufacturingDay 5 ManufacturingWeek 28 ManufacturingYear 2008 MaxCapableSpeed 2 MediaType 0 Model ST936751SS OperationName None OperationPercentComplete 0 PPID SGORN8291253187A001 YA00 PredictiveFailureState 0 PrimaryStatus 1 RaidStatus 2 Revision SM07 RollupStatus 1 SASAddress 5000C500015BD39D SecurityState 0 SerialNumber 3PEOD45D SizelnBytes 35836133376 Slot 1 SupportedEncryptionTypes None UsedSizelnBytes 35827154944 16 10 Listing the RAID VirtualDiskView Inventory Enumerating the Virtua DiskView results in the attributes and inventory of the available virtual disks in the system Enumerate VirtualDiskView with the following parameters and syntax EXAMPLE winrm e http sch
46. Reset Supported and 8 Graceful Shutdown Supported 15 Power Cycle Off Soft Graceful 4 Power Cycling Supported and 8 Graceful Shutdown Supported 16 Power Cycle Off Hard Graceful 6 Off Hard Power Cycling Supported and 8 Graceful Shutdown Supported DCIM_CSPowerManagementCapabilities Caption null Description null ElementName Power Management Capabilities InstancelD DCIM pwrmgtcap1 OtherPowerCapabilitiesDescriptions null OtherPowerChangeCapabilities null PowerCapabilities null PowerChangeCapabilities 3 4 8 PowerStatesSupported 2 5 8 11 12 8 4 Power Control 8 4 1 Base Server Method Changing the power state such as cycling the power is performed by invoking the RequestStateChange method of the CIM_ComputerSystem class instance For iDRAC there is one 49 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 instance for the main system and another for iDRAC Use the main system instance The method requires you to specify the RequestedState argument Refer to Section 8 3 to get the possible values for this argument Base Server Profile http www dmif org sites default files standards documents DSP1004 1 0 1 pdf EXAMPLE winrm invoke RequestStateChange http schemas dell com wbem wscim 1 cim schema 2 DCIM_ComputerSystem CreationClassName DCIM_ComputerSystem Namessrv system u USER p PASSWORD r https IPADDR
47. WinRM CLI Examples in Document sssssseeeseessssrrrrrrnrreserrrrerrnrreserrnne 12 3 2 WS Man Security amp Time Parameters cccccceceeeeeeesececeeeeeeeeeeeeenaeeeeeeeeeeeeenesaaaes 13 3 2 1 Encryption Certificate S CUrity cece ccceceeeeeeeeeeeeeeeeeeeeeeeeeteetensaaaeeeeeees 13 3 2 2 Handling invalid responses from WSMAN CommanndSs ccccceeeeeetteeeeeees 13 3 2 3 Improving WinRM Enumeration Performance cceeeeeeeeeeeeeeeeeeneeeeeeeees 14 3 2 4 Specifying StartTime Until Time and TIME_NOW Parameters 14 3 2 5 Return Values eo55 fk ae he id ee ees anda cal edaer ahah as dene aah 15 3 2 6 Glossae ene eect sere cel eee ene el a A ESE 15 4 DISCOVER neae atic cube A Coen eats ne RAN 16 4 1 Discovering Web Service Capability cc ccccceeeeeeeeeeenneeeeeeeeeeeeeeeaeeeeeeeeeeteeeenaaees 16 4 2 Discovering what Profiles are Implemented ceeeeeeeeeeee etre ee eeeeenneeeeeeeeeeeeeeenaaees 16 4 3 Discovering Implementation Namespace cece eeeeeeteee eset eeeeeeeeeaeeeeeeeeeeeeeenaaees 17 5 Managing iDRAC Local User Accounis2 cacc Again is ee ede 18 5 1 Description of iDRAC Attributes vs Standard DMTF Model cccceceeeeeeeeeeeeeeeeeees 18 5 2 Account Inventory using iIDRAC AttribUtes eee ceeeeee eter eeeeeeeeeeeeeeeeeeeeeeeeaaees 18 5 2 1 Account and Capabilities using iIDRAC Attributes cc ceeeeeeeetteeeeeees 18
48. 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 1 Listing the BIOS Inventory Enumeration Class The BIOS Inventory contains the following attributes DC M_B OSEnumeration 17 1 DCIM_BIOSInteger 17 5 DCIM_BlOSString 17 6 and DCIM_BIlOSPassword 17 10 183 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Enumerating the B OSEnumeration Class will display all BIOS attributes in a computer system Enumerate B OSEnumeration with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSEnumeration u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_BlIOSEnumeration AttributeName NumLock CurrentValue On DefaultValue null FQDD BIOS Setup 1 1 InstancelD BIOS Setup 1 1 NumLock IsReadOnly false PendingValue null PossibleValues On Off DCIM_BlOSEnumeration AttributeName ReportKbdErr CurrentValue Report DefaultValue null FQDD BIOS Setup 1 1 InstancelD 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 InstancelD
49. can be in hexadecimal or decimal format OxFFFFFFFFFFFFFFFE 18446744073709551615 EXAMPLE winrm i CreateVirtualDisk cimv2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_RAIDService 175 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 SystemName DCIM ComputerSystem Name DCIM RAIDService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file CreateSlicedVirtualDisk xml The input file CreateSlicedVirtualDisk xml is shown below lt p CreateVirtualDisk_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p PDArray gt Disk Bay 0 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p PDArray gt Disk Bay 1 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p VDPropNameArray gt RAIDLevel lt p VDPropNameArray gt lt p VDPropNameArray gt SpanDepth lt p VDPropNameArray gt lt p VDPropNameArray gt SpanLength lt p VDPropNameArray gt lt p VDPropNameArray gt Size lt p VDPropNameArray gt lt p VDPropNameArray gt VirtualDiskName lt p VDPropNameArray gt lt p VDPropNameArray gt StartingLBA lt p VDPropNameArray gt lt p VDPropValueArray gt 4 lt p VDPropValueArray gt lt p VDPropValueArray gt 1 lt p VDPropValueArray gt lt p VDPropValueArray gt
50. device The successful execution of this method shall connect to the ISO located on NFS CIFS share to the host server and expose it as a virtual CDROM device using RFS USB endpoint The successful execution of the method shall not change the boot order of that device In order to boot to the CD ROM the CD ROM shall be configured in the boot order in a separate step using BIOS and Boot Management Profile and the host server shall boot to the CD ROM Unlike the ConnectNetworklSOlmage method the Lifecycle Controller is not locked and may perform other management tasks Invoke ConnectRFSISOlmage with the following 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 0 NFS 2 CIFS 83 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 SHAREUSER User account for the ISO share location SHAREPASSWORD Password of the share account WORKGROUP Applicable workgroup IMAGENAME Image name of the iso image such as boot iso EXAMPLE winrm i ConnectRFSISOImage cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM O0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 encoding utf 8 a basic lPAddress IPADDESS ISO Share
51. field AttributeName Obtained from the AttributeName field AttributeValue Obtained from the PossibleValues field EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_FCService SystemName DCIM ComputerSystem 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 lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCService gt lt p Target gt FC Slot 2 2 lt p Target gt lt p AttributeName gt PortSpeed lt p AttributeName gt lt p AttributeValue gt 4G lt p AttributeValue gt lt p SetAttribute_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD FC001 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 23 7 Applying the Pending Values for FC CreateTargetedConfigJob This method is called to apply the pending values created by the SetAttribute and SetAttributes methods The system will automatically reboot depending on the ScheduledStartTime selected Using 223 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 the CreateTargetedConfigJob job D output with the job control section can be used to obtain it
52. further contain method invocation information if an error occurred UnpackAndShare_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD DCIM_OSDConcreteJob 1 __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 73 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 When the jobs are complete the JobStatus property value will be Successful if the job completed successfully or Failed if an error occurred while executing the request If the job failed the Message property on the returned DCIM_OSDConcreteJob instance will contain more detailed error information on the cause of the failure For the Lifecycle Controller version of the OS Deployment Profile there is only one instance of a job generated by various method invocations and it will persis
53. gt lt w Selector Name InstancelD gt INSTANCEID lt w Selector gt lt w SelectorSet gt lt a ReferenceParameters gt lt p Target gt lt p InstallFromURI_INPUT gt 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 InstancelD of the device to be updated 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 InstallFromURI_OUTPUT Job Address http schemas xmlsoap org ws ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_SoftUpdateConcreteJob SelectorSet Selector InstancelD JID_001276741475 __cimnamespace root dcim ReturnValue null 43 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 7 8 CreateRebootJob The CreateRebootJob method creates a reboot job that can be scheduled to reboot immediately or at a later time When the reboot job is scheduled and then executed via SetupJobQueue Section 10 2 1 the reboot will take several minutes depending on the system setup including whether collecting system inventory CSIOR is enabled I
54. gt NIC 1 DNSDomainNameFromDHCP lt p AttributeName gt 204 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt NIC 1 VLanEnable lt p AttributeName gt lt p AttributeValue gt Disabled lt p AttributeValue gt lt p AttributeName gt VirtualMedia 1 Attached lt p AttributeName gt lt p AttributeValue gt Dettached lt p AttributeValue gt lt p AttributeName gt Pv4 1 Enable lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt IPv4 1 DHCPEnable lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt IPv4 1 DNSFromDHCP lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt Users 3 Enable lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt Users 16 Enable lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt Users 3 IlpmiLanPrivilege lt p AttributeName gt lt p AttributeValue gt Administrator lt p AttributeValue gt lt p AttributeName gt Users 16 lpmiLanPrivilege lt p AttributeName gt lt p AttributeValue gt Administrator lt p AttributeValue gt lt p AttributeName gt Users 3 IlpmiSerialPrivilege lt p Attribut
55. http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p OldKey gt Abcd 123 lt p OldKey gt lt p NewKey gt Efgh 123 lt p NewKey gt lt p Keyid gt NewLKMid lt p Keyid gt lt p Mode gt 1 lt p Mode gt lt p ReKey_INPUT gt OUTPUT This method requires a PERC controller with Local Key encryption or DKM support to function correctly If the EnableControllerEncryption method does not set the key the following message is displayed ReKey_OUTPUT Message Controller Key is not present MessagelD STORO21 ReturnValue 2 165 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 16 17 5 Removing the Key RemoveControllerKey The RemoveControllerKey method is used to erase the key on the controller along with the attached encrypted drives Invoke the RemoveControllerKey method with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView class See section 16 1 EXAMPLE winrm i RemoveControllerKey cimv2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_ComputerSystem CreationClassN 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 lt p RemoveContr
56. i ExportFactoryConfiguration http schemas dmtf org wbem wscim 1 cim schema 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 lt p ExportFactoryConfiguration_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p IPAddress gt 123 456 7 8 lt p IPAddress gt lt p ShareName gt sharename lt p ShareName gt lt p FileName gt filename txt lt p FileName gt lt p ShareType gt 0 lt p ShareType gt lt p Username gt admin lt p Username gt lt p Password gt password lt p Password gt lt p Workgroup gt workgroup lt p Workgroup gt lt p ExportFactoryConfiguration_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned ExportFactoryConfiguration OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271168441 __ cimnamespace root dcim ReturnValue 0 12 16 System Decommission This method is called to delete all configurations from the Lifecyc
57. instance of PMC class as in the case of iDRAC the first step may be skipped and the PMC class may be enumerated directly Power State Management Profile http www dmtf org sites default files standards documents DSP1027_2 0 0 pdf EXAMPLE iDRAC case winrm e http schemas dmtf org wbem wscim 1 cim schema 2 CIM_PowerManagementCapabilities __cimnamespace root dcim u USER p PASSWORD 48 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT When the PowerStatesSupported property contains the value in the PowerStatesSupported Value column the PowerChangeCapabilities property shall contain the value specified in the PowerChangeCapabilities Value column PowerStatesSupported Value PowerChangeCapabilites Value 2 Power On 3 Sleep Light 4 Sleep Deep 5 Power Cycle Off Soft 6 Power Off Hard 7 Hibernate 8 Power Off Soft 9 Power Cycle Off Hard 10 Master Bus Reset 3 Power State Settable 4 Power Cycling Supported 6 Off Hard Power Cycling Supported 7 HW Reset Supported 11 Diagnostic Interrupt NMI 7 HW Reset Supported 12 Power Off Soft Graceful 8 Graceful Shutdown Supported 13 Power Off Hard Graceful 8 Graceful Shutdown Supported 14 Master Bus Reset Graceful 7 HW
58. 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 org wbem wscim 1 cim schema 2 root dcim DCIM_LifecycleJob InstancelD INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACHeck a basic encoding utf 8 OUTPUT DCIM_LifecycleJob InstancelD JID_00129609760 JobStartTime 00000101000000 JobStatus Scheduled JobUntilTime TIME_NA Message Task successfully scheduled MessagelD JCP001 Name ConfigBIOS BIOS Setup 1 1 PercentComplete NA The status may be one of the following e Ready for execution Job is created but waiting for scheduled start time to pass to schedule the job e Scheduled Job is scheduled and ready for system reboot to execute the job e Failed Problem with setting the BIOS password check message for more information Completed Setting the BIOS password completed with no issues 17 10 Listing the BIOS Inventory Password Class Enumerate B OSPassword with the following parameters and syntax EXAMPLE 192 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows winrm e cimv2 root dcim DCIM_BlOSPassword u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_BIOSPas
59. representing the desired partition will be created Section 13 1 and a reference to this instance is captured in the output parameter Job Invoke CreatePartition with the following parameters and syntax PartitionIndex The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be formatted 1 to 16 Size The size of the partition to be created SizeUnit The unit of the size 111 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_PersistentStorageService SystemName DCIM ComputerSystem Name DCIM PersistentStorageService r https IPADDRESS 443 wsman u USER p PASSWORD auth basic encoding utf 8 SkipCNCheck SkipCACheck file DIRECTORYPATH CreatePartition xml The input file CreatePartition xml is shown below lt p CreatePartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 1 lt p PartitionIndex gt lt p Size gt 50 lt p Size gt lt p SizeUnit gt 1 lt p SizeUnit gt lt p PartitionT ype gt 2 lt p PartitionT ype gt lt p OSV
60. schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271166022 __ cimnamespace root dcim ReturnValue 0 12 14 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 This is the password to the target export server Workgroup This is the applicable workgroup EXAMPLE winrm i ExportHWInventory http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem 102 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Name DCIM LCService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file ExportHWinventory xml The input file ExportHWInventory xml is shown below lt p ExportHWInventory_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p IPAddress gt 1
61. schemas dell com wbem wscim 1 cim schema 2 DCIM_ComputerSystem SelectorSet Selector CreationClassName DCIM_ComputerSystem Name srv system __cimnamespace root dcim 17 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 10 __cimnamespace root dcim TargetElement Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_ComputerSystem SelectorSet Selector CreationClassName DCIM_ComputerSystem Name srv system __cimnamespace root dcim 5 Managing iDRAC Local User Accounts 5 1 Description of iDRAC Attributes vs 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 The DMTF data model is complex and typically requires multiple transactions to accomplish simple operations such as specifying a username and password or giving a user account admin privileges For this reason LC also off
62. 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 Invoke the ReKey method with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView class See section 16 1 OldKey Old controller key NewKey New controller key The Key can be maximum 32 characters long and must have one character from each of the following Upper Case Lower Case Number Special Character 164 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 The special characters in the following set must be passed as mentioned below amp gt amp amp lt gt amp lt gt gt amp gt gt amp quot lt gt amp apos Keyid Key Identifier Describes Key The Keyid can be maximum 32 characters long and shoutd not have spaces in it Mode Mode of the Controller 1 Local Key Encryption 2 Dell Key Manager EXAMPLE winrm i ReKey cimv2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_ComputerSystem CreationClassN 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 lt p ReKey_INPUT xmlns p
63. the Provisioning Server name s EXAMPLE A winrm i ClearProvisioningServer cimv2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService 93 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 SystemName DCIM ComputerSystem Name DCIM LCService u USERNAME p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic OUTPUT A This method will return status 0 or error message ClearProvisioningServer_OUTPUT ReturnValue 0 Setting the Provisioning Server name or IP address for the provisioning service The Provisioning Server name and or IP Addresses can be set by invoking the SetAttribute method of the DCIM_LCService class PS_IP_ADDRESS Substitution will need to be replaced with the actual IP address s or DNS name s of the Provisioning Server s EXAMPLE B winrm i SetAttribute cimv2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic file SetProvisioningServer xml The input file SetProvisioningServer xml is shown below lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p AttributeName gt Provisioning Server lt p AttributeName gt lt p AttributeValue gt PS_IP_
64. the associators of the CIM_AccountManagementService instance and search for CIM_AccountManagementCapabilities class instance 4 One exception is account index 0 The first account is static and could not be set OUTPUT C DCIM_LocalUserAccountManagementCapabilities ElementName Local User Account Management Capabilities ElementNameEditSupported false InstancelD DCIM LocalUserAccountManagementCapabilities 1 MaxElementNameLen 0 OperationsSupported 3 SupportedAuthenticationMethod 0 1 2 DCIM_IPMICLPAccountManagementCapabilities ElementName IPMI CLP Account Management Capabilities ElementNameEditSupported false InstancelD DCIM IPMICLPAccountManagementCapabilities 1 MaxElementNameLen 0 OperationsSupported 3 25 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 The first account is static and could not be set OQUTPUT D DCIM_EnabledLogicalElementCapabilities ElementName Account Capabilities ElementNameEditSupported false InstancelD DCIM_EnabledLogicalElementCapabilities 1 MaxElementNameLen 0
65. the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section 16 7 DiskType Corresponds to MediaType attribute in PhysicalDisk View Section 16 9 Include all types 0 Include Magnetic Only 1 Include SSD only 2 Diskprotocol Types of protocol to include Include all protocols 0 Include SATA 1 Include SAStypes 2 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 EXAMPLE winrm i GetAvailableDisks 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 a basic file GetAvailableDisks xml The input file GetAvailableDisks xml is shown below lt p GetAvailableDisks_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p DiskType gt 0 lt p DiskType gt lt p Diskprotocol gt 0 lt p Diskprotocol gt lt p DiskEncrypt gt 0 lt p DiskEncrypt gt lt p Raidlevel gt 2 lt p Raidlevel gt lt p GetAvailableDisks_INPUT gt 168 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OUTPUT GetAvailableDisks_OUTPUT PDArray Disk
66. uses Microsoft Windows Server 2008 with SP2 for OSName OUTPUT UnpackAndAttach_OUTPUT Job Address http schemas xmlsoap org ws 71 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD 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 Invoke DetachDrivers with the following syntax EXAMPLE winrm i DetachDrivers cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 encoding utf 8 a basic OUTPUT The return will be 0 for success or an integer for error or job in execution An error message containing a Message D and Message similar to the following can occur if the system is waiting to finish a previously invoked method DetachDrivers_OUTPUT Message Unable to retrieve Lifecycle Controller handle MessagelD OSD7 ReturnValue 2 11 3 4 Unpack Selected Drivers and Copy to Network Share The UnpackAndShare
67. xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_SoftwarelnstallationService gt lt p URI gt http URI IP ADDRESS PATH TO EXE FILE exe lt p URI gt lt p Target xmlns a http schemas xmlsoap org ws 2004 08 addressing xmlns w http schemas dmtf org wbem wsman 1 wsman xsd gt lt a Address gt http schemas xmlsoap org ws 2004 08 addressing role anonymous lt a Address gt lt a ReferenceParameters gt lt w ResourceURI gt http schemas dell com wbem wscim 1 cim schema 2 DCIM_Softwareldentity lt w ResourceURI gt lt w SelectorSet gt lt w Selector Name InstancelD gt INSTANCEID lt w Selector gt lt w SelectorSet gt lt a ReferenceParameters gt lt p Target gt lt p InstallFromURI_INPUT gt 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 InstancelD of the device to be updated 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 InstallFromURI_OUTPUT Job Address http schemas xmlsoap org ws ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_SoftUpda
68. 0 The set attributes method in section 16 19 4 uses the FQDD AttributeName and a value equal to DCIM_RAIDInteger or between the LowerBound and AttributeName RAIDreconstructRate UpperBound fields as input CurrentValue 30 FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDreconstructRate IsReadOnly false 147 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 LowerBound 1 PendingValue UpperBound 100 16 4 Getting a RAID Integer Instance Use the following example to get an instance of the DC M_RAIDiInteger 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 1 1 RAIDrebuildRate as an instancelD EXAMPLE winrm g cimv2 root dcim DCIM_RAIDInteger Ins tancelD INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_RAIDInteger AttributeName RAIDrebuildRate CurrentValue 30 FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDrebuildRate IsReadOnly false LowerBound 1 PendingValue UpperBound 100 16 5 Listing the RAID Inventory String Class The RAID Inventory has these attributes DCIM_RAIDEnumeration see Section 16 1 DCIM_RAIDInteger see Section 16 3 an
69. 0 3 Enumerate the associators of the CIM_RoleBasedAuthorizationService instance and search for CIM_RoleBasedManagementCapabilities class instance using EnumerateEPR mode OUTPUT DCIM_LocalRoleBasedManagementCapabilities ActivitiesSupported 7 7 7 7 7 7 7 7 7 ActivityQualifiersSupported Login to DRAC Configure DRAC Configure Users Clear Logs Execute Server Control Commands Access Console Redirection Access Virtual Media Test Alerts Execute Di agnostic Commands ElementName Local Role Based Management Capabilities InstancelD DCIM LocalRoleBasedManagementCapabilities QualifierFormatsSupported 9 9 9 9 9 9 9 9 9 SharedPrivilegeSupported false SupportedMethods 8 DCIM_CLPRoleBasedManagementCapabilities ActivitiesSupported null ActivityQualifiersSupported null ElementName CLP Role Based Management Capabilities InstancelD DCIM CLPRoleBasedManagementCapabilities QualifierFormatsSupported null SharedPrivilegeSupported false SupportedMethods 6 DCIM_IPMIRoleBasedManagementCapabilities ActivitiesSupported null ActivityQualifiersSupported null ElementName IPMI Role Based Management Capabilities InstancelD DCIM IPMIRoleBasedManagementCapabilities QualifierFormatsSupported null SharedPrivilegeSupported false SupportedMethods 6 5 5 Manage Account Settings using DMTF Model 5 5 1 Modify User Name using DMTF Model When the account setting capability allows the user name of an accou
70. 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector __cimnamespace root dcim InstancelD JID_001296571842 5 3 2 Modify Password using iDRAC Attributes EXAMPLE winrm i ApplyAttributes http schemas dmtf org wbem wscim 1 cim schema 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_Password xml The input file DracCard_Password xml is shown below lt p ApplyAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardService gt lt p Target gt iDRAC Embedded 1 lt p Target gt lt p AttributeName gt Users 4 Enable lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt Users 4 Password lt p AttributeName gt lt p AttributeValue gt PWORDHERE lt p AttributeValue gt lt p ApplyAttributes_INPUT gt OUTPUT When this method is executed a job
71. 0 21 9B 92 70 59 DataBusWidth 000 2 DeviceNumber 0 EFIVersion null FCoEOffloadMode 3 FCOEWWNN null FQDD NIC Embedded 2 1 FamilyVersion null FunctionNumber 1 InstancelD NIC Embedded 2 1 LastSystemInventoryTime 20100413135024 LastUpdateTime 20100413134727 LinkDuplex 0 LinkSpeed 0 MaxBandwidth 0 MediaType 4 MinBandwidth 0 NicMode 3 PCIDevicelD 1639 PCISubDevicelD 236 PCISubVendorlID 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 10 RAID Inventory amp Configuration 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 Additionally there is a configuration service that 60 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 contains all the methods used to configure the RAID storage See Section 16 for more information including inventories for PhysicalDiskView Virtu
72. 0000 000 LastUpdateTime 20120116145459 000000 000 PCIDevicelD 73 PCISlot 1 PCISubDevicelD 1F4E PCISubVendorID 1028 PCIVendorID 1000 PatrolReadState 1 PrimaryStatus 1 ProductName PERC H310 Adapter RollupStatus 1 SASAddress 5782BCB00C577600 SecurityStatus 0 SlicedVDCapability 1 151 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 16 9 Listing the RAID Inventory PhysicalDiskView Class Enumerating the PhysicalDisk View results in the attributes and inventory of the available physical disks in the system Enumerate PhysicalDiskView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 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 FreeSizelnBytes 8978432 HotSpareStatus 0 InstancelD Disk Bay 0 Enclosure Internal 0 0 RAID Slot 1 1 LastSystemInventoryTime 20120116145459 000000 000 LastUpdateTime 20120116145459 000000 000 Manufacturer SEAGATE ManufacturingDay 7 ManufacturingWeek 50 ManufacturingYear 2010 MaxCapableSpeed 3 MediaType 0 Model ST9500430SS OperationName None OperationPercentComplete 0 PPID THOR734K212330CG0027A00 PredictiveFailureState 0
73. 0480 Cache3Type 5 Cache3WritePolicy 0 Characteristics 4 CurrentClockSpeed 2266 ExternalBusClockSpeed 5860 FQDD CPU Socket 2 InstancelD CPU Socket 2 LastSystemInventoryTime 20100331101859 LastUpdateTime 201003251 34947 Manufacturer Intel MaxClockSpeed 3600 Model Intel R Xeon R CPU E5520 2 27GHz NumberOfEnabledCores 4 NumberOfEnabledThreads 8 NumberOfProcessorCores 4 PrimaryStatus 1 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 Profile Enumerate DCIM_iDRACCardView with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_iDRACCARDView u USER p PASSWORD r https IPADDRESS wsman 443 auth basic 55 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 encoding utf 8 SkipCACheck SkipCNCheck OUTPUT DCIM_iDRACCardView FQDD iDRAC Embedded 1 FirmwareVersion 1 00 00 GUID 314b544f c0b5 5180 5210 00484c4c454 IPMIVersion 2 0 InstancelD iDRAC Embedded 1 1 IDRACinfo LANEnabledState 1 LastSystemInven
74. 09 1322 2 Initializes Format Media sic oo atcce tects ec cceatecedden ses Seeaece ep teansunaicesghencdennmoadae 109 13 2 3 Verify Initialization Formatting c cccecceceeeeeeeeeeeeeeeeeeeeeeeeeeeceeeeeeeeeeeteeee 110 13 3 Enable Disable VFlash using VFlash State Change c ccccceeeeeeesetteeeeeeeeeeeeee 111 13 4 Create Partition srca e EE EAE EEE EEEE EEA AE EEE tone 111 13 5 Create Partition using Mage a ia6 sed oes abana ed ae eee ea aieGale 113 18 0 Delete Pamtitio M escheat eranen as aneniadis pends ee e bane tangas erent perdu AE aa a aE E 115 13 7 Format Partiti m sre r ern eae erada Saane PREAL aE ase 115 13 8 Modity Patito Msenga a oleae eee dea 117 13 9 Attach Partition eRe ea eee Rrra Pea res Perit PERS Cer Ere cere erry Pea entra tree ea Pree ey esa free 117 13 10 DetacmPartitioM ne etek ens cat tated coerce alloca Bee cata ah te cit ear aah eee coe 118 T3 T1 Export Data from Partition sta iieiea a r a hh ahetan ss 119 14 Boot Control Configuration Management ccccceeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeteenenaeeeeeeees 121 14 1 Listing the Boot Inventory ConfigSetting Class cceceeeeeeeeeee eee eeeeeneeeeeeeeeeteeee 121 14 2 Getting a Boot ConfigSetting Instance cece eee eeeeeneee teeter eeeeeenaeeeeeeeeeeneeee 122 14 3 Listing the Boot Inventory SourceSetting Class 0 ceeeeeeeeeeeeee eee eeeeeetteeeeeeeeeeeteee 123 14 4 Changing the Boot Order by InstancelD ChangeBootOr
75. 145459 000000 000 LastUpdateTime 20120116145459 000000 000 PCIDevicelD 73 PCISlot 1 PCISubDevicelD 1F4E PCISubVendorlID 1028 PClVendorID 1000 PatrolReadState 1 PrimaryStatus 1 ProductName PERC H310 Adapter RollupStatus 1 SASAddress 5782BCB00C577600 SecurityStatus 0 SlicedVDCapability 1 150 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 16 8 Getting a RAID ControllerView Instance The get command can be invoked using a particular instance D 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 1 1 as an instancelD EXAMPLE winrm g http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_ControllerView InstancelD INSTANCEID r https IPADDRESS 443 wsman u USER p PASSWORD auth basic encoding utf 8 SkipCNCheck SkipCACheck OUTPUT DCIM_ControllerView Bus 1 CacheSizelnMB 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 InstancelD RAID Slot 1 1 KeylD null LastSystemInventoryTime 20120116145459 00
76. 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 is applied to the PendingValue property or the Currentvalue property of the specified NiCAttribute Possible choices are attained from PossibleValues field such as Possible values Disabled Enabled EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 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 information in the input file SetAttribute_NIC xml is shown below lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Integrated 1 1 1 lt p Target gt lt p AttributeName gt IscsiOffloadMode lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD NICOO1 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 137 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 15 11 Sett
77. 2 1 0 AdvertiseTypeDescriptions WS Identify AdvertiseTypes 1 Caption null Description null ElementName null InstancelD 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 3 Discovering Implementation Namespace The implementation CIM namespace may be discovered from the interop root interop CIM namespace using the class CIM_ElementConformsToProfile that associates an instance of CIM_RegisteredProfile class with an instance of C M_ComputerSystem class Profiles n a EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 dialect association associations filter object DCIM_ComputerSystem CreationClassName DCIM_ComputerSystem Namessrv system __cimna mespace root dcim 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 org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http
78. 2 Web Services Interface Guide for Windows Version 2 1 0 PS_IP_ADDRESS Substitution will need to be replaced with the actual IP address s or DNS name s of the Provisioning Server s PerformAutoDiscovery 1 off disables auto discovery 2 Now enables and initiates auto discovery immediately 3 NextBoot delay reconfiguration amp auto discovery until next power cycle EXAMPLE winrm i RelnitiateDHS cimv2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USERNAME p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic file RelnitiateDHS xml The input file RelnitiateDHS xml containing the parameters for the Re nitiateDHS method is shown below lt p RelnitiateDHS_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p ProvisioningServer gt PS_IP_ADDRESS lt p ProvisioningServer gt lt p ResetToFactoryDefaults gt TRUE lt p ResetToFactoryDefaults gt lt p PerformAutoDiscovery gt 3 lt p PerformAutoDiscovery gt lt p RelnitiateDHS_INPUT gt OUTPUT The output is status 0 for successfully set or an error message RelnitiateDHS_ 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 Configuring
79. 2 lt p VDPropValueArray gt lt p VDPropValueArray gt 100 lt p VDPropValueArray gt lt p VDPropValueArray gt virtualdiskname lt p VDPropValueArray gt lt p VDPropValueArray gt OxFFFFFFFFFFFFFFFF lt p VDPropValueArray gt lt p CreateVirtualDisk_INPUT gt OUTPUT The instancelD output identifies this virtual disk in the inventory before and after the CreateTargetedConfigJob method creates it However the instance D changes after successful creation CreateVirtualDisk_OUTPUT NewVirtualDisk Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_VirtualDiskView SelectorSet Selector InstancelD 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 O virtual disk The creation process is the same as explained in Section 16 18 5 In this scenario CreateVirtualDisk method only takes VDPropNameArray VDPropValueArray pairs mentioned below 176 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Invoke CreateVirtualDisk with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section
80. 23 456 7 8 lt p IPAddress gt lt p ShareName gt sharename lt p ShareName gt lt p FileName gt filename txt lt p FileName gt lt p ShareType gt 0 lt p ShareType gt lt p Username gt admin lt p Username gt lt p Password gt password lt p Password gt lt p Workgroup gt workgroup lt p Workgroup gt lt p ExportHWInventory_INPUT gt 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271167557 __cimnamespace root dcim ReturnValue 0 12 15 Export Factory Configuration This method is used to export the factory configuration from the Lifecycle Controller to a text file ona remote share Invoke ExportFactoryConfiguration 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 This is the password to the target export server 103 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Workgroup This is the applicable workgroup EXAMPLE winrm
81. 33 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm e cimv2 root dcim DCIM_Softwareldentity u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 When this method is executed a list of software identity objects will be returned including installed and available firmware Below is a snippet of the output OUTPUT DCIM_Softwareldentity BuildNumber 4846 Classifications 10 ComponentID 28897 ComponentType APAC DevicelD null ElementName Dell Lifecycle Controller 2 1 0 0 4846 X79 FQDD USC Embedded 1 LC Embedded 1 IdentityInfoType OrgID ComponentType ComponentID IdentityInfoValue DCIM firmware 28897 InstallationDate 2012 01 15T22 22 32Z InstancelD DCIM INSTALLED 802__USC Embedded 1 LC Embedded 1 IsEntity true MajorVersion 1 MinorVersion 0 RevisionNumber 0 RevisionString null Status Installed SubDevicelD null SubVendorlD null Updateable true VendorlD null VersionString 1 0 0 4846 impactsTPMmeasurements false The key properties in the above output include the following InstancelD Normally identifies the firmware on a particular type of device The substring right after DCIM is the status of a payload or firmware on the system This can be installed or available ComponentID Uniquely identifies a unique type of device such as BIOS NIC Storage and Lifecycle controller firmware 34 Dell Lifecyc
82. 63 16 17 4 Rekeying the Controller ReKey 0 0 0 cccceeeeceeeeeeeeeeeeeeeeeeeeeetiieeeeeeeeeeteeee 164 16 17 5 Removing the Key RemoveControllerKey ccccceeeceeeetteeeeeeeeeeeteee 166 16 18 Managing Virtual Disk vigcctcccescetsieea shoots heetbeaverdlohe saphe ketch ee ace 166 16 18 1 Getting the Available RAID levels GetRAIDLevels cceeeeeeeeees 166 16 18 2 Getting the Available Disks GetAvailableDiskS cceeeeeeeeeeeeeeeeee 168 16 18 38 Checking the Create VD Parameters Validity CheckVDValues 169 16 18 4 Creating a Single Virtual Disk CreateVirtualDisk ceeeeeeeeeeeeeeee 170 16 18 5 Creating a Sliced Virtual Disk CreateVirtualDisk cccceeeeeeeeeeeeeeees 173 16 18 6 Creating a Cachecade Virtual Disk CreateVirtualDisk ceeeeee 176 16 18 7 Deleting a Virtual Disk DeleteVirtualDisk ccceeeeeeeeeeteeeeeeeeeeeteees 178 16 19 Setting Controller Attributes cccccecceeeeeeeeseeceeeeeeeeeeneeseeeeeeeeeeeeseeeseneeeeeeeeeeeenees 179 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 16 19 1 Changing the Value of a RAID Controller Enumeration Attribute 179 16 19 2 Changing Multiple Values of RAID Controller Enumeration Attributes 179 16 19 38 Changing the Value of a RAID Controller Integer Attribute 0 180 16 19 4 Changing Multiple Values of RAID Controll
83. ADDRESS lt p AttributeValue gt lt p SetAttribute_INPUT gt OUTPUT B This method will return status 0 or error message SetAttribute_OUTPUT RebootRequired No ReturnValue 0 SetResult Set CurrentValue 94 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 12 5 Check VFlash License Enablement The following command can be used to check VFlash License enablement Features such as Part Replacement downloading ISO image to VFlash or booting from VFlash are licensed features and require Dell VFlash SD Card to be inserted in order to function EXAMPLE winrm g cimv2 root dcim DCIM_LCEnumeration InstancelD LifecycleController Embedded 1 LCAttributes 1 Licensed u USER p PASSWORD r _https IPADDRESS wsman 443 encoding utf 8 a basic NOTE For 11G InstancelD DCIM_LCEnumeration CCR1 OUTPUT This get command will return the instance of the DCIM_LCEnumeration attribute class The CurrentValue property will contain True yes or False no indicating whether features dependent on the presence of the VFlash SD card are enabled DCIM_LCEnumeration AttributeName Licensed CurrentValue Yes DefaultValue No ElementName LC emb 1 InstancelD 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 C
84. AttributeValue gt lt p AttributeName gt Collect System Inventory on Restart lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT RebootRequired No ReturnValue 0 SetResult Set PendingValue 12 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 org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService file DIRECTORYPATH CreateConfigJob xml r https IPADDRESS 443 wsman u USER p PASSWORD auth basic encoding utf 8 SkipCNCheck SkipCACheck The input file CreateConfigJob xml is shown below lt p CreateConfigJob_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p ScheduledStartTime gt 00000000002200 000000 000 lt p ScheduledStartTime gt lt p RebootlfRequired gt false lt p RebootlfRequired gt lt p CreateConfigJob_INPUT gt 89 Dell Lifecycle Contro
85. 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 3 Checking the Create VD Parameters Validity CheckVDValues The CheckVDValues method is used to determine possible sizes of virtual disk as well default settings given a RAID level and set of disks The VDPropArray is filled in with Size and other values for a successful execution of the method Invoke CheckVDValues with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section 16 7 PDArray This parameter is the list of physical disk FQDDs Section 16 9 VDPropNameArraylIn This parameter is the list of property names with values in the VDPropValueArray n parameter Size RAIDLevel SpanDepth VDPropValueArrayln This parameter is the list of property values that correspond to the VDPropNameArrayln parameter EXAMPLE winrm i CheckVDValues 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 a basic file CheckVDValues xml The input file CheckVDValues xml is shown below lt p CheckVDValues_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target g
86. CCardString class Section 19 6 EXAMPLE winrm i ApplyAttributes http schemas dmtf org wbem wscim 1 cim schema 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 lt p ApplyAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardService gt lt p Target gt iDRAC Embedded 1 lt p Target gt lt p AttributeName gt Users 4 IlpmiLanPrivilege lt p AttributeName gt lt p AttributeValue gt Operator lt p AttributeValue gt lt p ApplyAttributes_INPUT gt 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 com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001296745342 __ cimnamespace root dcim ReturnValue 4096 5 4 Account Inventory using DMTF Model The list of user accounts may be retrieved by enumerating the C M_Account class The class provides the user account name and EnabledState properties The user account password i
87. DRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT GetRemoteServicesAPIStatus_OUTPUT LCStatus 0 Message Lifecycle Controller Remote Services is ready MessagelD LC061 ReturnValue 0 ServerStatus 2 Status 0 12 18 Export System Configuration This method is used to export the system configuration from the Lifecycle Controller to a file ona remote share Invoke ExportSystemConfiguration with the following parameters and syntax 105 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 This is the password to the target export server EXAMPLE winrm i ExportSystemConfiguration http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClass Name DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD 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
88. 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 189 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 the pending changes prior to CreateTargetedConfigJob being called After the configuration job is created the pending changes can only be canceled by calling DeleteJobQueue in the Job Control profile Invoke CreateTargetedConfigJob with the following parameters and syntax Target This parameter is the FQDD of the B OSAttribute instances from Section 17 1 EXAMPLE winrm i DeletePendingConfiguration http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_BlOSService SystemName DCIM ComputerSystem Name DCIM BlOSService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file DeletePendingConfiguration_BIOS xml The input file DeletePendingConfiguration_BIOS xml is shown below lt p DeletePendingConfiguration_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService gt lt p Target gt BlOS Setup 1 1 lt p Target gt lt p DeletePendingConf
89. Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Steven Zessin December 18 2012 Version 2 1 0 Document Status Published Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 This document is for informational purposes only and may contain typographical errors and technical inaccuracies The content is provided as is without express or implied warranties of any kind 2012 Dell Inc All rights reserved Dell and its affiliates cannot be responsible for errors or omissions in typography or photography Dell the Dell logo and PowerEdge are trademarks of Dell Inc Intel and Xeon are registered trademarks of Intel Corporation in the U S and other countries Microsoft Windows and Windows Server are either trademarks or 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 disclaims proprietary interest in the marks and names of others December 2012 Rev 2 1 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 CONTENTS Wes SIEMTICOGIICTIOR en a e lama Serspea gaat aan beds gale aon banda gevadene aeaa 10 2 ASTOPANCOS oie ce seeecsi castes ae E EAE E E E EE E E EEA RA E senate aaa 10 ERD VINA EN E PRERE Atlee a EE E EEE D E E E E aes 12 3 1 Format for
90. ESS 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 2 Power State Management Method Changing the power state is performed by invoking the RequestPowerStateChange method of the DCIM_PowerManagementService PMS class instance It is a three step process shown below 1 Enumerate the DCIM_PowerManagementService with EPR 2 Enumerate the DC M_ComputerSystem class and search for the Host instance 3 Use the EPR on steps 1 and 2 to invoke RequestPowerStateChange Power State Management Profile http www dmif org sites default files standards documents DSP1027_2 0 0 pdf EXAMPLE winrm invoke RequestPowerStateChange http schemas dell com wbem wscim 1 cim schema 2 DCIM_CSPowerManagementService __cimnamespace root dcim SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc CreationClassName DCIM_CSPowerManagementServi ce Name pwrmegtsvc 1 u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 auth basic PowerState 5 50 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 9 Hardware Inventory The Dell Common Information Model CIM class extensions for supporting remote hardware inventories are
91. Getting an iIDRAC Card Enumeration Instance ccccccccccccccccccceeeeeeeeeeeeeeeeeeeeees 201 19 3 Listing the iDRAC Card Inventory Enumeration Class using grouplD 68 202 19 4 Applying the Attributes and Polling Job Completion cccccccccccccceeceeeeeeeeeeeeeees 204 19 4 1 Changing iDRAC Values ApplyAttributes Immediate cceeee 204 19 4 2 Polling Job Completion sss sic 2 2ecces sate eekae dk aes ieee teeiss seciediete ees beciniacdbeateeteton 205 19 4 3 Set Attribute Verification eee eeecceceee eee eeeeeeeeaaeeeeeeeeeeeeesenaaaeeeeeeeeeneneae 206 19 5 Listing the iDRAC Card Inventory Integer Class ceeceeeeeeeeeee eee eeeeeneeeeeeeeeeeeeeee 207 19 6 Listing the iDRAC Card Inventory Integer Class using QroupID cceceeeeeteees 208 19 7 Listing the iDRAC Card Inventory String Class ceeeeeeeeeeeeee eter eee eeeeeneeeeeeeeeeteeee 209 8 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 19 8 Listing the iDRAC Card Inventory String Class using QroupID cccsseeeeeeeees 210 19 9 Changing the iDRAC IPChange Notification cc eeceeeeeeee tere ee eeeenneeeeeeeeeeteeee 212 19 9 1 Getting the Current iDRAC IPChange State ccccceceeeeeeeenteeeeeeeeeteeee 212 19 9 2 Setting the iDRAC IPChange Notification SetAttribute cece 212 20 Remote Service Status assez eG seth en equ seve occas dea sue eh cec
92. HARE_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 com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271168441 __cimnamespace root dcim ReturnValue 0 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 The partition management of the virtual flash media includes Listing virtual flash partitions Creating new partitions Deleting existing partitions Formatting a partition Exposing the partition in the host OS 107 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Detaching an attached partition Uploading an image to a partition Booting to a partition Modifying a partition Copying exporting the contents of the partition Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile 13 1 Listing the SD Card Partitions Each partition on the virtual flash media shall be represented by an instance of DCIM_OpaqueManagementData If nothing is returned no partit
93. HQINco9WzKyINR1FbclIAUITOUJOM SnSSLA8fRBtJXZZVBA KAt 34lvO FEAijSOZKMW 1nA CUuzCFM7t3P 3kmD 06a DfcwLivaburBpaOmj5HIBVGLzcWEz5iTuzc1 AiU09dacT8 UyrO8KAVp5zu0b8bP BGUQbDNBUqKsCPTKnNSNaDb jOsQYB66B 9yZtaLPfdWkvob930UUwj CxTlxLGge sense END RSA PRIVATE KEY lt p KeyContent gt lt p Password gt PASSWORD HERE lt p Password gt lt p CAContent gt BEGIN CERTIFICATE MIIE2ZCCA80gAwIBAgIBADANBgkqhkiG9wOBAQQFADCBqTELMAkGA1UEBhMCVVMx CZAJBgNVBAgTALRYMRQWEgYDVQQHEWtNYWIlulFNOcmVIdDEVMBMGA1UEChMMSm9l 805kZK8xCaSQ9UQKdH5z6sUasj8DYk6pXndgWIV5Wc9JfsN3 dratX3lrpoPJPhk N1hTdXHYiDjLwSg79ylkIJP1qZ5gdaeJ1jUYJBehRDQ X7HxWN2VNk ZINVYyZc sense END CERTIFICATE lt p CAContent gt lt p DownloadClientCerts_INPUT gt 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 DownloadClientCerts_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD 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 Invoke DeleteAutoDiscoveryClientCerts with the following parameters and syntax 97
94. 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 exe InstancelD The instancelD is the Softwareldentify instancelD that represents the firmware that is to be updated This instancelD can be retrieved as described in Section 6 2 For example the instancelD can be DCIM INSTALLED PCI 14E4 1639 0237 1028 e Itis installed firmware on a PCI device e VID Vendor ID 14E4 e DID Device ID 1636 e SSID Subsystem ID 0237 e SVID Subvendor ID 1028 e This refers to a Broadcom NetXtreme II BCM5709 network adaptor2 40 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm invoke InstallFromURI cimv2 root dcim DCIM_SoftwarelnstallationService CreationClassName DCIM_SoftwarelnstallationService SystemCreationClassName DCIM_ComputerSystem SystemName IDRAC ID Name SoftwareUpdate file UpdateInputNIC 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 UpdatelnputNic xml to supply input parameters required for the InstallFromURI method The syntax for UpdatelnputNIC xml is lt p InstallFromURI_INPUT
95. ID VirtualMedia 1 InstancelD 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 InstancelD iDRAC Embedded 1 IPv4 1 Enable IsReadOnly false PossibleValues Disabled Enabled DCIM_iDRACCardEnumeration AttributeDisplayName User Admin IPMI LAN Privilege AttributeName IpmiLanPrivilege 203 Version 2 1 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 CurrentValue Administrator DefaultValue NoAccess Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 3 InstancelD iDRAC Embedded 1 Users 3 lpmiLanPrivilege 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 This method returns a JobID that is used as input in the next section Section 19 3 2 Invoke ApplyAt
96. Inventory on Restart CSIOR By default collect system inventory on restart is disabled To enable this feature utilize the SetAttribute method in the following example NOTE To query the system to determine when the last CSIOR event occurred list system inventory and examine the LastSystemI nventoryTime attribute The Collect System Inventory on Restart attribute flags whether the system should do an automatic inventory or not To get the current status of this attribute see Section 12 3 The values can be 87 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 e Disabled default Disallow collecting inventory on restart e Enabled Allow collecting system inventory on restart The Part Firmware Update attribute flags whether the Part Replacement automatic firmware update performed The values can be e Disable default firmware update is not allowed e Allow version upgrade only Allow firmware update only on up revision e Match firmware of replaced part Always update firmware The example below configures the Part Replacement feature to allow upgrade only and for the automatic synchronization to be on Invoke SetAttribute with the following parameters and syntax EXAMPLE 1 winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerS
97. JobStatus Completed JobUntilTime 20111111111111 Message Job completed successfully MessageArguments null MessagelD PR19 Name ConfigRAID RAID Integrated 1 1 An error message similar to the following can occur if an invalid JobID is entered 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 The destination computer returned an empty response to the request 68 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 and the DCIM_OSDeploymentService MOF file 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 1 OS Deployment Profile Implementation Conformance Use the following algorithm to test the instrumentation for OS Deployment Profile version conformance and to discover the implementation namespace 1 2 5 11 2 Enumerate namespace root interop classname CIM_RegisteredProfile Filter the returned enumeration using property f
98. Key c cece rete eeeeeenee teeter eee eeenaaeeeeeeeeeeteeee 99 12 11 Delete Auto Discovery Server Public Key cccceeeesssecceeeeeeeeeeeseneaeeeeeeeeeeeeneae 100 12 12 Insert Comment in Lifecycle Controller LOQ cceceeeeeeeecceeeeeeeeeeeeessaeeeeeeeeeeeeneae 100 12 13 Export Lifecycle Controller Log ccccccccceeeeesesecceeeeeeeeeeeeeseaeeeeeeeeeeetegenaaeaeeeeeeeeennea 101 12 14 Export Hardware Inventory from Lifecycle Controller c ccceeeeeceeeeeeeeeeeeeeeeeee 102 12 15 Export Factory Configuration lt ccsciaui onset ceed ae nacapeete sleet eee 103 12 16 System DECOMIMISSION es cing ceased lek Lecce ety een deed cag caeeec eens tei daaeaveeseanges gccharedans nenene 104 12 17 Get Remote Services API Status ceeeeeccccccee cere eeeeeeeeeeeeee eee eeeesenaaeaeeeeeeeeeenae 105 12 18 Export System GCOnlQuranoncs s icecsu sae ini tareha div hte etd a ivat ete orde tener e 105 12 19 Import System Contiguration ssscsss casecde ea tnal calieticarndsciets thewied delat 106 13 VFlash SD Card Management ccccceeeeecesceceeeeeeeeeeeeeaaeeeeeeeeeeteaaaaaaaeeeeeeeeseesesaaaaeeeeeees 107 13 1 Listing the SD Card Partitions cheese esis ere tee tekdenst Aten denlacee sa ede dein beotas 108 13 2 Initialize the Virtual Flash M6Ga icc isscocnateciemeneetirn cenethetbese mane eta dead 108 13 2 1 Get VFlash SD Card Inventory ccccccceeeeeeeseeeeceeee eter eeeeennaeeeeeeeeeeeeeneas 1
99. LCService gt lt p AttributeName gt IPChangeNotifyPS lt p AttributeName gt lt p AttributeValue gt on lt p AttributeValue gt lt p SetAttribute_INPUT gt OUTPUT SetAttribute_OUTPUT ReturnValue 0 To verify the changes after setattribute was executed list the LC attributes as shown in Section 19 8 1 20 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 NOTE The LCStatus output parameter value includes the status reported by the DMStatus output parameter in the GetRSStatus method Thus GetRSStatus method invocation is redundant Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile 20 1 Getting Remote Service Status EXAMPLE winrm i GetRemoteServicesAPIStatus http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService 213 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck
100. LE winrm i UnassignSpare cimv2 root dcim DCIM_RAIDS ervice SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_RAIDService SystemName DCIM ComputerSystem Name DCIM RAIDService u USER p PASSWORD r https IPADRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file UnassignSpare xml The input file UnassignSpare xml is shown below lt p UnassignSpare_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt Disk Bay 3 Enclosure Internal 0 0 RAID Integrated 1 1 lt p Target gt lt p UnassignSpare_INPUT gt OUTPUT UnassignSpare_OUTPUT RebootRequired YES ReturnValue 0 16 17 Managing Keys for Self Encrypting Drives NOTE The Dell Key Manager feature is not available at this time 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 161 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i SetControllerKey http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_Computer
101. NCE ID u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACHeck a basic encoding utf 8 OUTPUT DCIM_LifecycleJob InstancelD JID_001293618214 JobStartTime 00000101000000 JobStatus Restore In Progress JobUntilTime TIME_NA Message Restoring Lifecycle Controller Firmware images MessagelD BARO81 Name Restore Image PercentComplete 20 The status may be one of the following e Ready for Restore Request has been received e Restore In Progress Restore process is currently in process e Failed Problem with the restore process check message for more information 199 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 e Completed Restore process has completed with no issues 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 e DCIM_iDRACCardEnumeration 19 1 e DCIM_iDRACCardinteger 19 4 e DCIM_iDRACCardString 19 6 Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile 19 1 Listing the iDRAC Card Inventory Enumeration Class Enumerate the iDRACCardEnumeration class to list all the enumerate integer and string type iDRAC attributes Enumerate the iDDRACCardEnumeration class with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org w
102. NFS share 119 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 ShareType Type of share NFS 0 TFTP 1 CIFS 2 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 ExportDataFromPartition http schemas dell com wbem wscim 1 cim schema 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 ExportDataFromPartition xml The input file ExportDataFromPartition xml is shown below lt p ExportDataFromPartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 1 lt p PartitionIndex gt lt p IPAddress gt 123 456 7 8 lt p I PAddress gt lt p ShareType gt 2 lt p ShareType gt lt p SharePath gt temp lt p SharePath gt lt p lmageName gt imagename iso lt p lmageName gt lt p Workgroup gt workgroup lt p Workgroup gt lt p Username gt Administrator l
103. Name DRIVESHARE ShareType SHARETYPE Username SHAREUSER Password SHAREPASSWORD Workgroup WORKGROUP ImageName IMAGENAME OUTPUT ConnectRFSISOlmage_OUTPUT Job 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_OSDConcreteJob SelectorSet InstancelD DCIM_OSDConcreteJob 1 __cimnamespace root dcim ReturnValue 4096 Concrete jobs return 4096 upon successful invocation Poll for the concrete job JobStatus Success 11 3 19 Disconnect RFS ISO Image The DisconnectRFSISOImage method is used to disconnect and detach the ISO Image that is mounted through Remote File Share RFS and is exposed to the host system as a USB based CD ROM device Invoke DisconnectRFSISOImage with the following syntax EXAMPLE winrm i DisconnectRFSISOImage 84 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService 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 20 Get RFS ISO Image Connection Information The GetRFSISOImageCon
104. Name IPv4 GroupID IPv4 1 InstancelD 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 InstancelD iDRAC Embedded 1 Users 3 lpmiLanPrivilege IsReadOnly false PossibleValues User Operator Administrator NoAccess 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 Version 2 1 0 winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardInteger u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_iDRACCardInteger AttributeDisplayName VLan Priority AttributeName VLanPriority CurrentValue 0 DefaultValue 0 Dependency null DisplayOrder 0 207 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 FQDD iDRAC Embedded 1 GroupDisplayName NIC GroupID NIC 1 InstancelD iDRAC Embedded 1 NIC 1 VLanPriority IsReadOnly false LowerBound 0 UpperBound 7 DCIM_iDRACCardInteger AttributeDisp
105. Name 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 lt p DeleteVirtualDisk_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt DISK Virtual 0 RAID Integrated 1 1 lt p Target gt lt p DeleteVirtualDisk_INPUT gt OUTPUT DeleteVirtualDisk_OUTPUT RebootRequired YES ReturnValue 0 178 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 16 19 Setting Controller Attributes 16 19 1 Changing the Value of a RAID Controller Enumeration Attribute The SetAttribute method is used to set or change the value of a RAID controller or a virtual disk attribute The example below shows setting a RAID controller enumeration attribute To set a virtual disk attribute use the FQDD of the virtual disk attribute for the Target and the AttributeName and AttributeValue Invoke SetAttribute with the following parameters from Section 16 1 and syntax TARGET Obtained from the FQDD field AttributeName Obtained from the AttributeName field AttributeValue Obtained from the PossibleValues field EXAMPLE winrm i SetAttribute cimv2 root dcim DCIM_RAIDSe rvice SystemCreationClassName DCIM_ComputerSys
106. Name gt lt p AttributeValue gt 10Mbps Half lt p AttributeValue gt lt p AttributeName gt WakeOnLan lt p AttributeName gt lt p AttributeValue gt Disabled lt p AttributeValue gt lt p AttributeName gt VLanMode lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt IscsiTgtBoot lt p AttributeName gt lt p AttributeValue gt One Time Disabled lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttributes_OUTPUT Message The command was successful MessagelD NIC001 141 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 If this value is valid it is applied to the PendingValue property or the Currentvalue property of the specified NiCAttribute Possible choices are attained from PossibleValues field such as Possible values Disabled Enabled EXAMPLE winrm i SetAttributes http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService SystemCreationClassN
107. PADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file DeletePendingConfiguraton xml The input file DeletePendingConfiguration xml is shown below lt p DeletePendingConfiguration_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p DeletePendingConfiguration_INPUT gt OUTPUT DeletePendingConfiguration_OUTPUT ReturnValue 0 158 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 EXAMPLE winrm i GetDHSDisks 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 a basic file GetDHSDisks xml The input file GetDHSDisks xml is shown below lt p GetDHSDisks_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDS
108. PossibleValues Disabled Enabled DCIM_iDRACCardEnumeration AttributeDisplayName User Admin Enable AttributeName Enable CurrentValue Enabled Account Enabled as displayed DefaultValue Enabled in CurrentValue attribute for Dependency null Users 2 DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 2 InstancelD iDRAC Embedded 1 Users 2 Enable IsReadOnly false PossibleValues Disabled Enabled Account Disabled as displayed in CurrentValue attribute for 5 2 2 Privilege and Capabilities using iDRAC Attributes Enumerating the DC M_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 EXAMPLE DCIM_iDRACCardEnumeration AttributeDisplayName User Admin IPMI LAN Privilege AttributeName IpmiLanPrivilege CurrentValue NoAccess DefaultValue NoAccess Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 1 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 InstancelD iDRAC Embedded 1 Users 1 lpmiLanPrivilege IsReadOnly true PossibleValues User Operator Administrator NoAccess DCIM_iDRACCardEnumeration AttributeDisplayName User Admin IPMI Serial Privilege AttributeName IpmiSerialPrivilege CurrentValue NoAccess Def
109. Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile 22 1 Listing the Sensors Inventory PSNumericSensor Class Enumerate the DC M_PSNumericSensor class with the following parameters and syntax EXAMPLE 217 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows winrm e cimv2 root dcim DCIM_PSNumericSensor u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_PSNumericSensor BaseUnits 6 CreationClassName DCIM_PSNumericSensor CurrentReading 11 CurrentState Normal Description Power Supply Power Consumption DevicelD iDRAC Embedded 1 PS1Current1 ElementName PS1 Current 1 EnabledDefault 2 EnabledState 2 HealthState 5 LowerThresholdCritical LowerThresholdNonCritical 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 UpperThresholdCritical UpperThresholdNonCritical ValueFormulation 2 DCIM_PSNumericSensor BaseUnits 7 CreationClassName DCIM_P
110. QDD BIOS Setup 1 1 InstancelD BIOS Setup 1 1 NumLock IsReadOnly false PendingValue null PossibleValues On Off 17 3 Changing the BIOS BootMode SetAttribute The SetAtiribute method can be used to apply changes to setting the BootMode configuration to a given instance Invoke SetAttribute with the following parameters from Section 17 1 and syntax TARGET Obtained from the nstancelD field AttributeName Obtained from the AttributeName field AttributeValue Obtained from the PossibleValues field EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_BlOSService 185 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 SystemName DCIM ComputerSystem Name DCIM BlOSService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file SetAttribute_BlOS xml The input file SetAttribute_BlOS xml is shown below lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService gt lt p Target gt BlOS Setup 1 1 lt p Target gt lt p AttributeName gt BootMode lt p AttributeName gt lt p AttributeValue gt Bios lt p AttributeValue gt lt p SetAttribute_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD BIOSO01 Reboo
111. SNumericSensor CurrentReading 126 CurrentState Normal Description System Power Consumption in Watts DevicelD iDRAC Embedded 1 SystemBoardPwrConsumption ElementName System Board Pwr Consumption EnabledDefault 2 218 Version 2 1 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EnabledState 2 HealthState 5 LowerThresholdCritical LowerThresholdNonCritical 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 1 SupportedThresholds 1 SupportedThresholds 3 SystemCreationClassName DCIM_ComputerSystem SystemName srv system TransitioningToState 12 UnitModifier 0 UpperThresholdCritical 1344 UpperThresholdNonCritical 1232 ValueFormulation 2 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 MOF
112. SS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file DetachPartition xml The input file DetachPartition xml is shown below lt p DetachPartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 12 lt p PartitionIndex gt lt p DetachPartition_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned DetachPartition_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001270737364 __cimnamespace root dcim ReturnValue 0 If the partition is already detached the following message may be displayed DetachPartition_OUTPUT Message Partition already detached MessagelD 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 e Enumerate the DCIM_PersistentStorageService class e Invoke the ExportDataFromPartition method on the instance above with the following parameters PartitionIndex The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be formatted 1 to 16 IPAddress IP address of TFTP or
113. SWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT Shown below are return messages of failure and success 2 and 0 respectively The MessagelD and Message output parameters will further contain method invocation information if an error occurred Failure SkipISOlmageBoot_OUTPUT Message ISO image is not attached MessagelD OSD32 ReturnValue 2 82 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Success SkipISOlmageBoot_OUTPUT ReturnValue 0 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 Invoke GetNetworkISOlmageConnectionInfo with the following syntax EXAMPLE winrm i GetNetworkISOlmageConnectionInfo cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT GetNetworklSOImageConnectionInfo_OUTPUT Message ISO image is not attached MessagelD OSD32 ReturnValue 2 11 3 18 Connect RFS ISO Image The ConnectRFSISOIlmage method is used to connect the ISO image that is mounted through Remote File Share RFS and is exposed to the host system as a USB based CD ROM
114. Services Interface Guide for Windows Version 2 1 0 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 2 Discovering what Profiles are Implemented Implemented profiles are advertised using the class CIM_RegisteredProfile Enumerate this class in the root interop CIM namespace Profiles http www dmtf org sites default files standards documents DSP1033_1 0 0 pdf EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 CIM_RegisteredProfile __cimnamespace root interop u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Interop Namespace AdvertiseTypes 1 1 InstancelD DCIM Memory 1 0 0 OtherRegisteredOrganization DCIM RegisteredName Memory RegisteredOrganization 1 RegisteredVersion 1 0 0 DCIM_RegisteredProfile Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version
115. Softwareldentity method 7 2 2 Create Reboot Job The second stage is to create a reboot job as shown in Section 7 8 7 2 3 Schedule Update Jobs The third stage is to invoke the SetupJobQueue method as shown in Section 10 2 1 Use the jobID JID from InstallFromSoftwareldentity and rebootID RID from the reboot job The reboot may take several minutes as the UEFI performs the desired operation 7 2 4 Monitor Update Jobs The output of getting the job status during various steps Section 10 2 3 is shown below Initial job status after invoking InstallFromSoftwareldentity 35 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 DCIM_LifecycleJob InstancelD JID_001276741956 JobStartTime TIME_NA JobStatus Downloaded JobUntilTime TIME_NA Message Package successfully downloaded MessageArguments null MessagelD REDOO2 Name Rollback DCIM AVAILABLE NONPCI 159 2 1 4 Job status after invoking SetupJobQueue DCIM_LifecycleJob InstancelD JID_001276741956 JobStartTime 00000101000000 JobStatus Scheduled JobUntilTime 20100730121500 Message Task successfully scheduled MessageArguments null MessagelD JCP001 Name Rollback DCIM AVAILABLE NONPCI 159 2 1 4 Job status following reboot install of operation DCIM_LifecycleJob InstancelD JID_001276741956 JobStartTime 00000101000000 JobStatus Completed JobUntilTime 20100730121500 Message Job finished successfu
116. System 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 SetControllerKey xml The input file SetControllerKey xml is shown below lt p SetControllerKey_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p Key gt abc123 lt p Key gt lt p Keyid gt keyid lt p Keyid gt lt p SetControllerKey_INPUT gt OUTPUT This method requires an H700 or H800 controller to properly function Running this method on older controllers may yield this message SetControllerKey_OUTPUT Message Controller is not security capable MessagelD STORO22 ReturnValue 2 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 org wbem wscim 1 cim schema 2 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 S
117. T Message The command was successful MessagelD NICOO1 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 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 Additionally there is a configuration service that contains all the methods used to configure the RAID storage Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile The RAID Inventory contains the following attributes DCIM_RAIDEnumeration 16 1 DCIM_RAIDInteger 16 3 DCIM_RAIDString 16 5 DCIM_ControllerView 16 7 DCIM_PhysicalDiskView 16 9 144 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 DCIM_VirtualDiskView 16 10 DCIM_EnclosureView 16 11 16 1 Listing the RAID Inventory Enumeration Class The RAID Inventory has these attributes DCIM_RAIDEnumeration this section DCIM_RAIDInteger Section 16 3 and DCIM_RAIDString see Section 16 5 Enumerate the DCIM_RA DEnumeration class to display all the RAID controllers and virtual disk a
118. ToPXE cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 encoding utf 8 a basic The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters The MessagelD and Message output parameters will further contain method invocation information if an error occurred OUTPUT BootToPXE_OUTPUT ReturnValue 0 76 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 11 3 9 Get Host MAC Address Information Invoke GethostMACInfo with the following syntax EXAMPLE winrm i GetHostMACInfo cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck encoding utf 8 a basic OUTPUT The return will be 0 for success and a list of MAC addresses or an integer for error or job in execution The MessagelD and Message output parameters will further contain method invocation information if an error occurred GetHostMACInfo_OUTPUT MACList 00219b927057 00219b927059 00219b92705b 00219b92705d ReturnValue 0 11 3 10 Download ISO to VFlash The DownloadISOToVFlash
119. UserLcdStr CurrentValue null DefaultValue null FQDD BIOS Setup 1 1 InstancelD 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 InstancelD BIOS Setup 1 1 AssetTag IsReadOnly false MaxLength 10 MinLength 0 PendingValue null 17 7 Applying the Pending Values for BIOS amp Boot CreateTargetedConfigJob This method is called to apply the pending values created by the SetAttribute SetAttributes ChangeBootOrderByinstancelD and ChangeBootSourceState methods The system will automatically reboot depending on the ScheduledStartTime selected Using the CreateTargetedConfigJob job D output with the job control section can be used to obtain its status Invoke CreateTargetedConfigJob with the following parameters and syntax TARGET This Parameter is the FQDD of the B OSAttribute instances obtained from the InstancelD field in Section 17 1 RebootJobType There are three options for rebooting the system 1 PowerCycle 188 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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
120. VDPropValueArray gt lt p CreateVirtualDisk_INPUT gt OUTPUT The instancelD output identifies this virtual disk in the inventory before and after the CreateTargetedConfigJob method creates it Note however that the instancelD will change slightly after successful creation CreateVirtualDisk_OUTPUT 177 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 NewVirtualDisk Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_VirtualDiskView SelectorSet Selector InstancelD DISK Virtual 267386880 RAID Integrated 1 1 __cimnamespace root dcim RebootRequired YES ReturnValue 0 16 18 7 Deleting a Virtual Disk DeleteVirtualDisk The DeleteVirtualDisk method is used to delete a single virtual disk from the targeted controller The successful execution of this method results in the marking of this virtual disk for deletion The ObjectStatus property in the virtual disk view will have the value of 2 which indicates pending delete The virtual disk will not be deleted until a configuration job is scheduled and the system is rebooted Section 16 15 Invoke DeleteVirtualDisk with the following parameters and syntax TARGET This parameter is the FQDD of the virtual device Section 16 10 EXAMPLE winrm i DeleteVirtualDisk cimv2 root dcim DCIM_RAIDService SystemCreationClass
121. _PersistentStorageService gt lt p PartitionIndex gt 13 lt p PartitionIndex gt lt p FormatType gt 4 lt p FormatType gt lt p FormatPartition_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned FormatPartition OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001270738393 __cimnamespace root dcim ReturnValue 0 116 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 13 8 Modify Partition This method is used for modifying the changeable attributes of a partition Use the following algorithm to successfully modify an existing partition e Enumerate the DCIM_PersistentStorageService class e Invoke ModifyPartition method on the instance above with the following parameters PartitionIndex 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 e 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 com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService SystemCreationClassN
122. alDiskView and EnclosureView Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile Enumerate ControllerView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_ControllerView u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_ControllerView Bus 3 CacheSizelnMB 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 InstancelD RAID Integrated 1 1 LastSystemInventoryTime 20100331101859 LastUpdateTime 20100330124133 PCIDevicelD 73 PCISlot 1 PCISubDevicelD 1F51 PCISubVendorlID 1028 PCIVendorID 1000 PatrolReadState 1 PrimaryStatus 0 ProductName PERC H310 Mini RollupStatus 0 SASAddress 50026B902A8B6E00 SecurityStatus 0 SlicedVDCapability 1 61 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 9 11 BIOS Inventory amp 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 Th
123. ame 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 SetAttributes_iSCSI_BootTarget xml The information in the input file SetAttribute_iSCS _BootTarget xml is shown below lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Integrated 1 1 1 lt p Target gt lt p AttributeName gt BootToTarget lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorlpAddr lt p AttributeName gt lt p AttributeValue gt 10 10 10 10 lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorSubnet lt p AttributeName gt lt p AttributeValue gt 255 255 255 0 lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorGateway lt p AttributeName gt lt p AttributeValue gt 10 10 10 1 lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorPrimDns lt p AttributeName gt lt p AttributeValue gt 10 10 10 2 lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorSecDns lt p AttributeName gt lt p AttributeValue gt 10 10 10 3 lt p AttributeValue gt lt p AttributeName gt IscsilnitiatorName lt p AttributeName gt 142 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows lt p AttributeValue gt testname lt
124. ame 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 ModifyPartition xml The input file ModifyPartition xml is shown below lt p ModifyPartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 6 lt p PartitionIndex gt lt p AccessType gt 3 lt p AccessT ype gt lt p ModifyPartition_INPUT gt OUTPUT ModifyPartition_OUTPUT ReturnValue 0 13 9 Attach Partition This method is for defining the set of partitions to be exposed as Floppy CD HDD endpoints to the managed system and BIOS 117 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Invoke AttachPartition with the following parameters and syntax 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 com wbem wscim 1 cim schema 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
125. arameters The MessagelD and Message output parameters will further contain method invocation information if an error occurred DownloadISOToVFlash_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD 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 Error number 2144108299 0x803380F5 The WinRM client cannot process the request The destination computer returned an empty response to the request 11 3 11 Boot to ISO from VFlash This method will expose the ISO Image present on VFlash as a CDROM device to the host server and boots to it 78 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Invoke BootToISOFromVFlash with the following syntax EXAMPLE winrm i BootTolSOFromVFlash 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 S
126. assed as mentioned below amp gt amp amp lt gt amp lt gt gt amp gt gt amp quot lt gt amp apos Keyid Key Identifier Describes Key The Keyid can be maximum 32 characters in length and must not have spaces in it Mode Mode of the Controller 1 Local Key Encryption 2 Dell Key Manager 163 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i EnableControllerEncryption http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService SystemCreationCl assName 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 EnableControllerEncryption xml The information in the input file EnableControllerEncryption xml is shown below lt p EnableControllerEncryption_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p Mode gt 1 lt p Mode gt lt p Key gt Abcd 123 lt p Key gt lt p Keyid gt LKM lt p Keyid gt lt p EnableControllerEncryption_INPUT gt 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
127. assword to the username containing the ISO image OS ISO This is to be replaced by the actual name of the ISO image EXAMPLE winrm i ConnectNetworklSOlmage http schemas dmtf org wbem wscim 1 cim schema 2 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 IPAddress CIFS_or_NFS_IPaddress ShareName CIFS_or_NFS ShareType 2_or_0 Username CIFS_or_NFS_Username 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 MessagelD 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 com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD DCIM_OSDConcreteJob 1 __cimnamespace root dcim ReturnValue 4096 11 3 15 Disconnect Network ISO Image This method can be used to disconnect the target system from a bootable ISO image located on a CIFS or NFS share Invoke DisconnectN
128. at represents the partition to be formatted 1 to 16 PartitionType The format types that these partitions need to be formatted as floppy 1 hard disk 2 CD ROM 3 OSVolumeLabel The label seen in the OS after attaching the partition URI The URI location of firmware to update a component Supported protocols are FTP and HTTP IPAddress IP address of TFTP or NFS share ShareType Type of share NFS 0 TFTP 1 CIFS 2 FTP 3 HTTP 4 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 113 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm i CreatePartitionUsinglmage http schemas dell com wbem wscim 1 cim schema 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 CreatePartitionUsingImage xml The input file CreatePartitionUsinglmage xml is shown below lt p CreatePartitionUsingImage_INPUT xmlns p http schemas dell com w
129. ated This instancelD can be retrieved as described in Section 6 2 For example the instancelD can be DCIM AVAILABLE NONPCI 159 2 1 4 e Itis available firmware on a NONPCI device e This refers BIOS version 2 1 4 EXAMPLE 42 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm invoke InstallFromURI cimv2 root dcim DCIM_SoftwarelnstallationService CreationClassName DCIM_SoftwarelnstallationService SystemCreationClassName DCIM_ComputerSystem SystemName IDRAC ID Name SoftwareUpdate file UpdatelnputBlOS 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 UpdatelnputBlOS xml to supply input parameters required for the InstallFromURI method The syntax for UpdatelnputBlOS xml is lt p InstallFromURI_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_SoftwarelnstallationService gt lt p URI gt http URI IP ADDRESS PATH TO EXE FILE exe lt p URI gt lt p Target xmlns a http schemas xmlsoap org ws 2004 08 addressing xmlns w http schemas dmtf org wbem wsman 1 wsman xsd gt lt a Address gt http schemas xmlsoap org ws 2004 08 addressing role anonymous lt a Address gt lt a ReferenceParameters gt lt w ResourceURI gt http schemas dell com wbem wscim 1 cim schema 2 DCIM_Softwareldentity lt w ResourceURI gt lt w SelectorSet
130. atus 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 org wbem wscim 1 cim schema 2 root dcim DCIM_LifecycleJob InstancelD JobID r https IPADDRESS wsman 443 u USERNAME p PASSWORD a basic encoding utf 8 To get the status of all jobs use the following EXAMPLE 2 67 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm e cimv2 root dcim DCIM_LifecycleJob u USERNAME p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 OUTPUT 1 amp 2 The method either returns a list of Concrete job objects or an error message Once job instancelD are returned via these status queries they can be used for job scheduling and setup Several examples of job objects are shown below DCIM_LifecycleJob InstancelD JID_001275884806 JobStartTime JobStatus Completed JobUntilTime Message Detach partition successful MessageArguments null MessagelD VF038 Name VFlashDetach Partition3 DCIM_LifecycleJob InstancelD RID_001274051062 JobStartTime 00000101000000 JobStatus Reboot Completed JobUntilTime 20100730121500 Message MessageArguments null MessagelD Name Reboot3 DCIM_LifecycleJob InstancelD JID_001274140369 JobStartTime 00000101000000
131. aultValue NoAccess Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 1 InstancelD iDRAC Embedded 1 Users 1 lpmiSerialPrivilege 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 Confirmation of successful user name or password verification can be obtained by enumerating the DCIM_iDRACCardString class Section 19 6 5 3 1 Modify User Name using iDRAC Attributes EXAMPLE winrm i ApplyAttributes http schemas dmtf org wbem wscim 1 cim schema 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_UserName xml The input file DracCard_UserName xml is shown below lt p ApplyAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardService gt lt p Target gt iDRAC Embedded 1 lt p Target gt lt p AttributeName gt Users 4 UserName lt p AttributeName gt lt p AttributeValue gt HELLO lt p AttributeValue gt lt p ApplyAttributes_INPUT gt OUTPUT 2
132. bem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 1 lt p PartitionIndex gt lt p PartitionType gt 2 lt p PartitionType gt lt p OSVolumeLabel gt label lt p OSVolumeLabel gt lt p URI gt ftp 123 456 7 89 dir filename exe lt p URI gt lt p IPAddress gt 123 456 7 8 lt p IPAddress gt lt p ShareType gt 3 lt p ShareType gt lt p SharePath gt lt p SharePath gt lt p lmageName gt imagename iso lt p lmageName gt lt p Workgroup gt workgroup lt p Workgroup gt lt p Username gt Administrator lt p Username gt lt p Password gt password lt p Password gt lt p Port gt lt p Port gt lt p HashType gt 1 lt p HashType gt lt p HashValue gt 123 lt p HashValue gt lt p CreatePartitionUsingImage_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned CreatePartitionUsinglmage_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001268833219 __cimnamespace root dcim ReturnValue 0 Reference Section 13 2 to fix an uninitialized media device error CreatePartitionUsinglmage_OUTPUT Message SD card not initialized MessagelD VF017 ReturnValue 2 114 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 13 6 Delete Partition This method
133. bem wscim 1 cim schema 2 root dcim DCIM_iDRACCardEnumeration 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 InstancelD iDRAC Embedded 1 NIC 1 Enable IsReadOnly false PossibleValues Disabled Enabled DCIM_iDRACCardEnumeration 200 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 AttributeDisplayName Virtual Media Attached AttributeName Attached CurrentValue Detached DefaultValue Detached Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName VirtualMedia GrouplD VirtualMedia 1 InstancelD 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 InstancelD iDRAC Embedded 1 IPv4 1 Enable IsReadOnly false PossibleValues Disabled Enabled DCIM_iDRACCardEnumeration AttributeDisplayName User Admin IPMI LAN Privilege AttributeName IpmiLanPrivilege Cu
134. blicKey_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001269440883 __cimnamespace root dcim ReturnValue 0 12 7 Download Client Certificates This method is used to download the client private certificate password and root certificate to Lifecycle Controller A base64 encoded string containing the certificate authentication CA private key content is required as input Invoke DownloadClientCerts with the following parameters and syntax EXAMPLE winrm i DownloadClientCerts http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService CreationClassName DCIM_LCService Name DCIM LCService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck 96 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 encoding utf 8 a basic file DownloadClientCerts xml The input file DownloadClientCerts xml is shown below lt p DownloadClientCerts_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p KeyContent gt BEGIN RSA PRIVATE KEY Proc Type 4 ENCRYPTED DEK Info DES EDE3 CBC 5FD6D6131DFA5A86 ulG9hRgOlkoJJKMBk95Zi8H5KnZkKNUnPngP
135. buteDisplayName IP Address 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 InstancelD 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 InstancelD iDRAC Embedded 1 Users 3 UserName IsReadOnly false MaxLength 16 MinLength 1 19 8 Listing the iDRAC Card Inventory String Class using groupID Enumerate the DCIM_iDRACCardString class to list all the string type iDRAC attributes using the group IDs of these groups NIC IPv4 and Users To retrieve the attributes of the groups set the GroupID to one of the following NIC IPv4 or Users Invoke dracgetgroupid_string with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 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 210 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 filter select from DCIM_iDRACCardString WHERE GroupID NIC 1 The possible input
136. buteValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD BIOSO01 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 17 5 Listing the BIOS Inventory Integer Class Enumerate B OS nteger with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSInteger u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_BlOSInteger AttributeName AcPwrRcvryUserDelay CurrentValue 0 DefaultValue null FQDD BIOS Setup 1 1 InstancelD BIOS Setup 1 1 AcPwrRcvryUserDelay IsReadOnly true LowerBound 30 PendingValue null UpperBound 240 17 6 Listing the BIOS Inventory String Class Enumerate B OSString with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSString u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic 187 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OUTPUT DCIM_BIOSString AttributeName OneTimeCustomBootStr CurrentValue null DefaultValue null FQDD BIOS Setup 1 1 InstancelD BIOS Setup 1 1 OneTimeCustomBootStr IsReadOnly true MaxLength 200 MinLength 5 PendingValue null DCIM_BIOSString AttributeName
137. ce u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file Delete_Pending_fc xml The input file Delete_Pending_fc xml is shown below lt p DeletePendingConfiguration_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCService gt lt p Target gt FC Slot 2 2 lt p Target gt lt p DeletePendingConfiguration_INPUT gt OUTPUT DeletePendingConfiguration_OUTPUT Message The command was successful MessagelD FC001 ReturnValue 0 ReturnValue 4096 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 225 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows 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 EFlVersion 5 30 FCTapeEnable 3 FQDD FC Slot 3 1 FabricLoginRetryCount 0 FabricLoginTimeout 0 FamilyVersion 02 00 84 FirstFCTargetLUN 0 FirstFCTargetWWPN 00 00 00 00 00 00 00 00 FramePayloadSize 2048 Function 0 HardZoneAddress 0 HardZoneEnable 3 InstancelD FC Slot 3 1 LinkDownTimeout 30000 LinkStatus 0 LoopResetDelay 5 PCIDevicelD 2031 PortDownRetryCount 30 PortDo
138. ch ree nit oir betas berate cele heheiedes 39 75 Delete Jobaria cede sel a hve adele ele Galstad eet E 40 7 6 Update NICs from HTTP CIFS Share NFS share TFTP or FTP oaasis 40 7 7 Update BIOS from HTTP CIFS Share NFS share TFTP or FTP 42 18 GCreateRebogtJob erenn oia a ed a edd ante 44 8 Power State Management i icces seen ae ee eee 45 8 1 Description of Base Server vs Power State Management Method6 ce 45 8 2 Get Power State acetesetincete e E E E AEA 45 8 2 1 Base Server Method snsssesneneesooeennrnnnreorrrerrrrnnrssorrttnrrnnrrsererennrnnnreeerenne 45 8 2 2 Power State Management Method cccceeeeeeeeeeeeeeeeeneeeeeeeeeeeeeeenaeeeeeeees 46 8 3 Get Power Control Capabilites eececccccceeeeeeeeeeneneeeeeeeeeeeeeeaaaaaaaeeeeeeeeeeenesaaaaes 47 8 3 1 Base Server MEO sce screscbearheendeece seedeachennigern set penchant Haste et teecbnatzeutaceeeeeend 47 8 3 2 Power State Management Method cccccccceeeeeeeeeeeeeeeeeeeeeeeeeessssaeeeeeeees 48 8 4 Power Control eeng a ceca telat ena oe apace 49 8 4 1 Base Server Method ce eeeecceccceee eee eeeeeeeaaeeeeeeeeeeeaaaaaaaeeeeeeeeeesessaaeeeeeees 49 8 4 2 Power State Management Method ccccceeeeeeeeeeeeeeeeeneeeeeeeeeeeeesennaeeeeeeees 50 9 Hardware nynt y ena a aoa tadedd aie eat e Eaei 51 9 1 Power Supply Inventory ssssssseeeesooeeennrrnersetetrnrrnntrsetrtentrnnttestrrtnrnnntesrerrnnennnreeee
139. change_bios_password xml The input file change_bios_password xml is shown below e No BIOS password is set The OldPassword parameter is not required It may be set to null or left blank as shown below e Changing an existing BIOS password Both the OldPassword and NewPassword parameters are required NOTE Entering only the NewPassword parameter indicates a pass in the setting and creating a new job however the job fails e Deleting an existing BIOS password The OldPassword parameter is required The NewPassword parameter may be set to null set to blank or omitted completely lt p ChangePassword_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService gt lt p Target gt BlOS Setup 1 1 lt p Target gt lt p PasswordT ype gt 1 lt p PasswordType gt lt p OldPassword gt lt p OldPassword gt lt p NewPassword gt NEW_PASSWORD lt p NewPassword gt lt p ChangePassword_INPUT gt OUTPUT Either of the following may result ChangePassword_OUTPUT Message BIOS does not support Change Password feature MessagelD BIOSO19 ReturnValue 2 ChangePassword_OUTPUT Message The command was successful MessagelD BIOSO01 191 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 17 9 2 Create Target Configuration Job Create a configuration job as shown in Section 17 7 17 9 3 Monitor Set BIOS Password Status To monitor the
140. chema 2 root dcim DCIM_BootConfigSetting InstancelD INSTANCEID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_BootConfigSetting DCIM_BootConfigSetting ElementName BootSeq InstancelD IPL IsCurrent 1 122 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 org wbem wscim 1 cim schema 2 root dcim DCIM_BootSourceSetting u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_BootSourceSetting BlOSBootString Embedded SATA Port A Optical SATA Optical Drive BootSeq BootString Embedded SATA Port A Optical SATA Optical Drive BootSeq CurrentAssignedSequence 0 CurrentEnabledStatus 1 ElementName Embedded SATA Port A Optical SATA Optical Drive BootSeq FailThroughSupported 1 InstancelD IPL Optical SATAEmbedded A 1 eb8aeb15796fb85f8e1447f0cfb8a68e PendingAssignedSequence 0 PendingEnabledStatus 1 The ChangeBootOrderBylnstancelD method in Section 14 4 will use the DCIM_BootSourceSetting BlOSBo
141. cim DCIM_LCAttribute InstancelD DCIM_LCEnumeration DHS3 u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_LCEnumeration AttributeName IPChangeNotifyPS Caption null CurrentValue Off DefaultValue Off Description null ElementName LC emb 1 InstancelD DCIM_LCEnumeration DHS3 IsOrderedList null IsReadOnly true PendingValue null PossibleValues On Off PossibleValuesDescription null 19 9 2 Setting the iDRAC IPChange Notification SetAttribute The SetAttribute method is used to set the attribute PChangeNotifyPS to ON or OFF When set to ON a user notification is sent when the IP address is changed While set to OFF a user notification is not sent Invoke SetAttribute with the following syntax EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService 212 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_
142. ckInfo 3 Invoke method returns the following output parameters a Version String version b SupportedOperatingSystems String array of OS names 4 If the Job output parameter from Step 2 contains a non null value then both Version and OSList contain null values The next call to GetDriverPackInfo after the Job is completed will return non null values for output parameters Version and OSList Invoke GetDriverPackInfo with the following syntax EXAMPLE winrm i GetDriverPackInfo cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic OUTPUT GetDriverPackInfo_OUTPUT OSList Microsoft Windows Server 2008 with SP2 Microsoft Windows Server 2008 x64 with SP2 Microsoft Windows Server 2008 R2 with SP1 Microsoft Windows Small Business Server 2011 Red Hat Enterprise Linux 5 SP7 x86 Red Hat Enterprise Linux 5 SP7 x64 Red Hat Enterprise Linux 6 SP1 x64 SUSE Enterprise Linux 10 SP4 x64 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 70 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Version 7 0 0 35 11 3 2 Unpack Selected Drivers and Attach to H
143. ckeenadentasaeaneaten ddaases sedecthentdetsevn eal 213 20 1 Getting Remote Service Status 0 cece cece cece eeeeeeeeeeeeeeeeeeeeaaaaaeeeeeeeeeeeeenaaaaes 213 20 2 Restarting Remote Service Status cccccccceeeeeeeeeeeeeeeeeeeeeeeeesseeaaeeeeeeeeeeeeeenaaaaes 215 21 System Information ses eae Pf Se ee I ae A ee Oe Se aaa ee ee des OA ak 216 21 1 Listing the System Inventory SystemView ClaSS c cccceeeeeeeeeeeeeteeeeeeeeeeeeeeenaaees 216 22 ISENSON Informatio steric reich Beir ot enero tah alice ahaa A E a ii E S 217 22 1 Listing the Sensors Inventory PSNumericSensor Class eceeeeeeeeeeeeeeeeeeeeeeees 217 23 Managing Fiber Channel FC Configuration cccccccceeeeeeeeeeeeeneeeeeeeeeeeeeceneeeeeeeeeeteee 219 23 1 Listing the FC Inventory Attribute Class ccc ceeeneeeeeeeeeeeeeeeeneeeeeeeeeeteeeenaaees 219 23 2 Listing the FC Inventory Statistics Class 0 0 cccceeecesecceeeeeeeeeeeeeeaeeeeeeeeeeeeeeenaaeaes 220 23 3 Listing the FC Inventory String Class cccccccceeeeeeseseceeeeeeeeeeeseeeaeeeeeeeeeeeeeeeeaeaes 221 23 4 Listing the FC Inventory Integer Class cccccceeeeceeeeeeneeeeeeeeeeeeeeeeaeeeeeeeeeeteeeeaaees 222 23 5 Listing the FC Inventory Enumeration Class ccccceeeeeeeeeeeeeeeeeeaeeeeeeeeeeeeeeenaaees 222 23 6 Changing the FC Attributes SetAttribute 2 0 0 0 eeeeeccccceeeeeeeeeeeeceeeeeeeeeeeeeeesenaeaes 223 23 7 Applying the Pending Values for FC Cr
144. d DCIM_RAIDString this section Enumerate the DC M_RAIDString class to display all the RAID controller string attributes in a system Enumerate RAI DString 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 148 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OUTPUT DCIM_RAIDString AttributeName Name CurrentValue MyCacheCadeVD FQDD Disk Virtual 0 RAID Integrated 1 1 InstancelD Disk Virtual 0 RAID Integrated 1 1 Name IsReadOnly true MaxLength 15 The get instance method in MinLength 0 Section 16 6 uses this PendingValue InstancelD as input DCIM_RAIDString AttributeName Name CurrentValue raid 1 vd FQDD Disk Virtual 1 RAID Integrated 1 1 InstancelD Disk Virtual 1 RAID Integrated 1 1 Name IsReadOnly true MaxLength 15 MinLength 0 PendingValue 16 6 Getting a RAID String Instance Use the following example to get an instance of the DC M_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 1 1 Name as an instancelD EXAMPLE w
145. d software including version information of both the installed as well as available cached versions e Remote update of BIOS component firmware Diagnostic content DRAC content driver pack power supplies from remotely located Dell Update Packages or cached images located in the Lifecycle Controller e Remotely schedule and track the status of update tasks jobs e Remotely manage the Part Replacement feature by allowing retrieving and setting auto update and auto system inventory sync e Enable re initiation of Lifecycle Controller Auto Discovery feature e Enhancement of Operation System Deployment capabilities by supporting the downloading of an ISO image to a Dell VFlash SD Card and booting to the ISO image on the VFlash SD Card e NIC configuration enables the ability to get and set NIC attributes that are configurable using NIC Option ROM or NIC UEFI HII e Remote RAID configuration allows users to remotely query and configure the Hardware Raid of the system e Multiple HW Inventory views allows users to remote query the inventory of Hardware 3 1 Format for WinRM CLI Examples in Document The examples of WinRM and WSMANCLI command line invocations in this document are formatted for readability and often span multiple lines in the document In actual use scripted or hand typed invocations are contained on one line The examples also use substitute values for the target iDRAC IP address username with ExecuteServerCommand privilege
146. defined in the various Dell profiles and related MOFs 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 It is an important attribute as it shows how recently the inventory was updated 9 1 Power Supply Inventory This section describes the implementation for the DCIM_PowerSupplyView class The Dell Power Supply Profile describes platform s power supply information Each platform power supply is represented by an instance of DCIM_PowerSupplyView class Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile Enumerate DCIM_PowerSupplyView with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_PowerSupplyView u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 SkipCACheck SkipCNCheck OUTPUT DCIM_PowerSupplyView DetailedState Presence Detected FQDD PSU Slot 1 FirmwareVersion 00 01 31 InputVoltage 120 InstancelD PSU Slot 1 LastSystemInventoryTime 20100331101859 LastUpdateTime 20100401130928 Manufacturer Dell Model PWR SPLY 502W RDNT PartNumber 0MU791A00 PrimaryStatus 1 RedundancyStatus 2 SerialNumber CN732459700411 TotalOutputPower 502 Type 0 DCIM_PowerSupplyView De
147. derBylnstancelD 123 14 5 Enable or Disable the Boot Source ChangeBootSourceState ccccccccecseeeeees 124 15 gt NIC CNA Card Management isiaic ofctot coc sancdetige tite lcnnduleteh nse nheade gi calonnele Geet Maa tae 125 15 1 Listing the NIC CNA Inventory Enumeration Class cceeeeeeeeeeeeeeeteeeeeeeeeeteeee 126 15 2 Listing the NIC CNA Inventory String Class cccccceeeeeceeeeeeeeeeeeeeeeenneeeeeeeeeeteeee 127 15 3 Listing the CNA Inventory Integer Class cc cccceeeeeeeeeeeeeneeeeeeeeeeteeeenaeeeeeeeeeeneeee 129 15 4 Listing the CNA Inventory NICView ClaSS 0 ccceeeeeeeeetieeeeeeeeeeeeeennaeeeeeeeeeeteeee 130 15 5 Listing the CNA Inventory NICCapabilities Class ecceeeeeeeeeeeeeeeeeeeeteeeeeeeeeeteeee 132 15 6 Listing the CNA Inventory NICStatistics Class 00 0 eeeeeeeeseeeeeeeeneeeeeeenneeeeeeenaes 133 15 7 Applying the Pending Values for CNA CreateTargetedConfiguOb cceeeee 134 15 8 Deleting the Pending Values for CNA DeletePendingConfiguration 135 15 9 Getting the CNA Enumeration Instance c cccceeeeeeeeeeeeneeeeeeeeeeeeeeeneeeeeeeeeeeteeee 136 6 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 15 10 Setting the scsiOffloadMode Attribute cccceeeeeeee eee eeeeeneeeeeeeeeeteeeeeeeeeeeeeeeneeee 136 15 11 Setting the MaxBandwidth Attribute 2 0 0 0 eee eee eee eeeeeene etter ee
148. dingValue null UpperBound 60 DCIM_NICInteger AttributeDisplayName TCP Port AttributeName FirstTgtTcpPort CurrentValue 3260 Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 GroupDisplayName iSCSI First Target Parameters GroupID IscsiFirstTgtParams InstancelD NIC Integrated 1 1 1 FirstTgtTcpPort IsReadOnly false LowerBound 1 PendingValue null UpperBound 65535 15 4 Listing the CNA Inventory NICView Class Enumerate the DCIM_NICView class with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICView u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT FOR FIRST and SECOND PORT NICView will return all ports and partitions DCIM_NICView AutoNegotiation 0 BusNumber 1 ControllerBlOSVersion 1 17 CurrentMACAddress 14 FE B5 FF B3 EA DataBusWidth 0002 DeviceNumber 0 EFlVersion 15 0 16 FCoEOffloadMode 3 FCOEWWNN null FQDD NIC Integrated 1 1 1 FamilyVersion 7 0 39 FunctionNumber 0 130 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows InstancelD NIC Integrated 1 1 1 LastSystemInventoryTime 20010708151620 000000 000 LastUpdateTime 20010708151606 000000 000 LinkDuplex 0 LinkSpeed 0 MaxBandwidth 0 Med
149. e BEGIN CERTIFICATE MIID9DCCA12gAwIBAgIBADANBgkqhkiG9wOBAQQFADCBszELMAkGA1 UEBhMCVVMx CZAJBgNVBAgTALRYMQ8wDQYDVQQHEWZBdXNOaW4xDTALBgNVBAoTBERIbGwxFjAU H ea71Ltbr Au2QFhqcHkeUEbQ4qXSXTmDEgeKAlmKjoCAaWHcDqEwvUcxGl4ekG LaUEGQhQIcLe 03RDp05j YPolv N100GMflhWg lJ3EoV1 Zba2tXnCp8XvCukJC 98 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 ROncFRPIp7c sense END CERTIFICATE lt p Certificate gt lt p SetPublicCertificate_INPUT gt OUTPUT SetPublicCertificate_OUTPUT ReturnValue 0 12 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 PKCS12pin Password to decode the PKCS12 EXAMPLE winrm i SetCertificateAndPrivateKey http schemas dmtf org wbem wscim 1 cim schema 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 SetCertificateAndPrivateKey xml The input file SetCer
150. e Controller 2 Web Services Interface Guide for Windows Version 2 1 0 CurrentValue WriteBack FQDD Disk Virtual 1 RAID Integrated 1 1 InstancelD 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 DC M_RA DEnumeration class instead of all the instances as shown in Section 16 1 Get a RAIDEnumeration instance with the following parameters and syntax INSTANCEID This is obtained from the enumeration in Section 16 1 which shows an example using RAID Integrated 1 1 RAIDloadBalancedMode as an instancelD EXAMPLE winrm g cimv2 root dcim DCIM_RAIDEnumeration Ins tancelD INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_RAIDEnumeration AttributeName RAIDloadBalancedMode CurrentValue Automatic FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDloadBalancedMode IsReadOnly false PendingValue PossibleValues Automatic Disabled 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 DC M_RAIDInteger class to display all the RAID controller attributes in a system En
151. e Guide for Windows Version 2 1 0 16 21 Convert Physical Disks to Non RAID ConvertToNonRAID The ConvertToNonRAID method is used to convert a physical disks in RAID state of Ready to a Non RAID state After the method is successfully executed the PendingValue property of RAIDPDState should reflect the pending changes After the CreateTargetedConfigJob method is successfully executed the RA IDStatus property which is enumerated in the DCIM_PhysicalDiskView from Section 16 9 of that physical disk should reflect the new state Invoke ConvertToNonRAID with the following parameters and syntax Physical Disk TARGET Obtained from the FQDD field Section 16 9 An example of Disk Bay 2 Enclosure Internal 0 0 RAID Slot 1 1 is shown below EXAMPLE winrm invoke ConvertToNonRAID cimv2 root dcim DCIM_RAIDService SystemCreationClassName DCIM_ComputerSystem CreationClassN 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 ConvertToNonRAID_OUTPUT RebootRequired 1 ReturnValue 0 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
152. e following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section 16 7 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 User should not enter 0 or give no parameter at all in the input xml ScheduledStartTime amp UntilTime See Section 3 2 4 EXAMPLE winrm i CreateTargetedConfigJob http schemas dmtf org wbem wscim 1 cim schema 2 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 CreateTargetedConfigJob_RAID xml The input file CreateTargetedConfigJob_RAID xml is shown below lt p CreateTargetedConfigJob_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p RebootJobType gt 3 lt p RebootJobType gt lt p ScheduledStartTime gt TIME_NOW lt p ScheduledStartTime gt lt p UntilTime gt 20111111111111 lt p UntilTime gt 157 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version
153. e 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 See Section 17 for more information including inventories for BlOSString and BlOSInteger Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile Enumerate B OSEnumeration with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSEnumeration u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_BlOSEnumeration AttributeDisplayName Memory Operating Voltage AttributeName MemVolt CurrentValue AutoVolt Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Op NOT Name SysProfile gt Custom lt ROIf gt lt AttrLev gt lt ValLev Val AutoVolt Op OR gt lt Forcelf Name SysProfile gt PerfPerWattOptimizedDapc lt Forcelf gt lt Forcelf Name SysProfile gt PerfPerWattOptimizedOs lt Forcelf gt lt Forcelf Name SysProfile gt PerfOptimized lt Forcelf gt lt Suplf Name SysProfile gt DenseCfgOptimized lt Suplf gt lt ValLev gt lt ValLev Val Volt15V Op OR gt lt Forcelf Name SysProfile gt DenseCfgOptimized lt Forcelf gt lt Suplf Name SysProfile gt PerfPerWattOptimizedDapc lt Suplf gt lt Suplf Name SysProfile gt PerfPerWattOptimizedOs lt Suplf gt lt Suplf
154. e 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 The destination computer returned an empty response to the request 11 3 7 Detach Network ISO USB Device 75 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 This method is used to detach the emulated USB device that had been attached by previously calling the BootToNetworkISO method Invoke DetachISOImage with the following syntax EXAMPLE winrm i DetachlSOlmage cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 encoding utf 8 a basic OUTPUT The method will return 0 for success or an integer for error or job in execution An error such as the following can occur if an ISO image is not attached DetachlSOImage_OUTPUT Message ISO image is not attached MessagelD OSD32 ReturnValue 2 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 Invoke to boot target system to PXE with the following syntax EXAMPLE winrm i Boot
155. e teeeenaeeeeeeeeeeteeee 138 15 12 Setting the VirtMacAdadr Attribute 2 cece cece eee eeeeeeeeeeeeeeeeeeeeteseaaeaaeeeeeeeeenaae 139 15 13 Setting the LegacyBootProto Attribute cccccceeeeeeeeeeeceeeeeeeeeeeeetesaeaeeeeeeeetenees 140 15 14 Setting CNA LAN Modes ccccccccccccccccceeeeeeeceeeeeeeeeceeeececeeeeeeeeecesesseeeseseeeseeseeeess 141 15 15 Setting tie iSCSI Boot Target icicle ee ee nenet 142 15 16 Setting the FCoE Boot Target sic cesosctne ieee dene 143 16 RAID Storage Management cccccceeeeeeecccceeeeeeeeeeeeeeaaeaeeeeeeeeeeaaaaaaaeeeeeeeeetesesaaaeeeeeees 144 16 1 Listing the RAID Inventory Enumeration Class 0 cceeeeeeeeeeeeeeeeeeeeeeeenneeeeeeeeeeteeee 145 16 2 Getting a RAID Enumeration Instance ccccccceeeeeeeeeeeceeeeeeeeeeetenenaeaeeeeeeeeeeneae 146 16 3 Listing the RAID Inventory Integer Class c ccccceeeeeeeeeeeteeeeeeeeeeeeeeenaeeeeeeeeeeneeee 146 16 4 Getting a RAID Integer Instance 00 cece etree ete tencee eee ee eee eteennaaeeeeeeeeeeneeee 148 16 5 Listing the RAID Inventory String Class ccccccceeeeeeeeeeeeeneeeeeeeeeeeeeeetaeeeeeeeeeeneeee 148 16 6 Getting a RAID String Instance actkecrca cee ene inthe nies eee eek 149 16 7 Listing the RAID Inventory ControllerView Class cccceeeeeeeeeeeeeeeeneteeeeeeeeeeteeee 150 16 8 Getting a RAID ControllerView Instance ceeeeeeeeneeeeeeenneeeeeeeneeeeeeesneeeeeneaes 151 16 9 Listing
156. eName field AttributeValue Obtained from the PossibleValues field EXAMPLE winrm i SetAttributes cimv2 root dcim DCIM_RAIDSe rvice SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_RAIDService System Name DCIM ComputerSystem Name DCIM RAIDService u USER p PASSWORD 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 lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p AttributeName gt RAIDloadBalancedMode lt p AttributeName gt lt p AttributeValue gt Disabled lt p AttributeValue gt lt p AttributeName gt RAIDBatteryLearnMode lt p AttributeName gt lt p AttributeValue gt Warn only lt p AttributeValue gt lt p AttributeName gt RAIDccMode lt p AttributeName gt lt p AttributeValue gt Normal lt p AttributeValue gt lt p AttributeName gt RAIDprMode lt p AttributeName gt lt p AttributeValue gt Disabled lt p AttributeValue gt lt p AttributeName gt RAIDcopybackMode lt p AttributeName gt lt p AttributeValue gt SMART lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttributes_OUTPUT Message The method was successful MessagelD STOROO1 RebootRequired Yes ReturnValue 0 SetResult Set Pendi
157. eName gt lt p AttributeValue gt Administrator lt p AttributeValue gt lt p AttributeName gt Users 16 lpmiSerialPrivilege lt p AttributeName gt lt p AttributeValue gt Administrator lt p AttributeValue gt lt p ApplyAttributes_INPUT gt OUTPUT ApplyAttributes_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD 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 InstancelD 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 Run the Get command on DCIM_LifecycleJob with the following parameters and syntax EXAMPLE 205 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm g http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LifecycleJob InstanceID INSTANCE_ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic The input parameter is the InstancelD from the output of the ApplyAttributes method An example
158. e_NIC xml The input file SetAttribute_NIC xml is shown below lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Integrated 1 1 2 lt p Target gt lt p AttributeName gt MaxBandwidth lt p AttributeName gt lt p AttributeValue gt 75 lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful 138 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 MessagelD NIC001 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 15 12 Setting the VirtMacAddr Attribute The SetAttribute method is used to set or change the value of a CNA attribute The I O identity string attributes VirtMacAddr VirtlscsiMacAddr VirtFIPMacAddr VirtWWN and VirtWWPN display a unique behavior After setting them to a non default value the attribute values are retained until there is AC power supply If the AC power supply is disconnected the attributes revert to their default values Invoke the SetAttribute method with the following parameters and syntax Target FQDD attained through DCIM_NICString AttributeName Attained from AttributeName field AttributeValue 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 o
159. eateTargetedConfigJob ccccceceeeeees 223 23 8 Deleting the Pending Values for FC DeletePendingConfiguration 00 225 2029 Listing the FO WG WS asec seco caciestetertscieacumersa tn tineia ms Eai A Eaka art 225 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 e Inventory for BIOS component firmware and embedded software e Update of BIOS component firmware and embedded software e Job Control of update tasks e Enhancement of Operating System Deployment using VFlash SD Card e Enhancement of Discovery and Handshake from LifeCycle Controller 1 x e Raid configuration management e iDRAC Inventory and configuration features e NIC configuration management e Boot configuration management e BIOS configuration management The target audience for this document is application and script writers that want to utilize the remote management capabilities using WS Man protocol available from Dell Lifecycle Controller 2 References
160. eb Services Interface Guide for Windows Version 2 1 0 When this method is executed a jobid or an error message is returned InitializeMedia_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem SelectorSet Selector InstancelD JID_001268732835 __cimnamespace root dcim ReturnValue 0 13 2 3 Verify Initialization 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 org wbem wscim 1 cim schema 2 root dcim DCIM_VFlashView InstancelD INSTANCE_ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_VFlashView AvailableSize 972 Capacity 972 ComponentName vFlash SD Card FQDD Disk vFlashCard 1 HealthStatus OK See Section 13 2 1 for InitializedState Initialized the populated InstancelD Disk vFlashCard 1 uninitialized fields LastSystemInventoryTime 20100426221347 000000 000 LastUpdateTime 20100426221 347 000000 000 Licensed true VFlashEnabledState true WriteProtected false InitializedState Field indicates status of element to be initialized InstancelD nstance D of desired e
161. eeeeeeeeeeaaees 77 11 3 10 Download ISO to VFlash acces ec Mecene eae se ecae No tects cncceetdensmeieanes 77 1138 11 _ Bo tto ISO from ViEIAS Mesto cael oocsenceneel A EE 78 11 3 12 Delete ISO from VFIlaSh seeneeonennnneenesoeeenerrnnrrsoerrenernnnrsorrrenernnnresrernnne 79 11 3 13 Detach ISO from VF laisse scices caseiccsite cies cateiveaaddencensateteesadeauetsatereesttaxtentes 80 11 3 14 Connect Network ISO Image ccccceeeeeeeeeeeeeeeeeeeeeeeeneaaaeeeeeeeeeeeeenaaaaes 80 11 3 15 Disconnect Network ISO IMage cccccceeeeescceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeesaaaaes 81 11 3 16 Skip ISO Image Boot viseexece tl Ae kee hee ee Soneleende aden leaped hare 82 11 3 17 Get Network ISO Image Connection Information c ecceeeeeeeeeeeeeteees 83 11 3 18 Connect RFS ISO Image osc ccccciccis secs caticdeaecesscdsdenscceseceesenauctencsaweeedeuauezenanes 83 11 3 19 Disconnect RESASOsIMaGe sats coke ete cats eatas conc eal toca eee satea Ny 84 11 3 20 Get RFS ISO Image Connection Information eeeeeeeeeeeeeeeeeeeeees 85 11 3 21 Boot To Hard Drive HD secsciceiicseteccss scent canted eben attested ale 85 11 3 22 Configurarable Boot to Network ISO cccceeeeeeeeeeeeeeeeeenneeeeeeeeeeeeeeeaaees 86 12 Lifecycle Controller Management Profile cc ccc ceeeeeececeeeceeeeeeeeeeeeenaeeeeeeeeeeeeeessnaaaeeeeeees 87 12 1 Collect System Inventory on Restart CSIOR ccceecieeeeeeeeeeee eee eeeeee
162. ema 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 ShareName DRIVESHARE ShareType 2 Username USERNAME Password PASSWORD lmageName IMAGENAME Passphrase PASSPHRASE ScheduledStartTime TIME_NOW NOTE The ShareName field should only be the folder exposed by the system to the network Any sub folder information should be attached to the ImageName field Otherwise there can be connection issues when trying to locate create the backup file Correct Example ShareName folder1 lmageName subfolder image_name In Correct Example ShareName folder1 subfolder lmageName image_name 18 2 3 Importing Server Profile from CIFS share Restorelmage CIFS Share ShareType is 2 winrm i Restorelmage http schemas dmtf org wbem wscim 1 cim schema 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 ShareName DRIVESHARE ShareType 2 Username USERNAME Password PASSWORD lmageName IMAGENAME
163. emas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_VirtualDiskView u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_VirtualDiskView BusProtocol 6 Cachecade 0 DiskCachePolicy 1024 FQDD Disk Virtual 0 RAID Slot 1 1 InstancelD Disk Virtual 0 RAID Slot 1 1 153 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 1 1 PrimaryStatus 1 oe 7 Virtual disks will denote 3 ReadCachePolicy 16 pending prior to being RemainingRedundancy 0 created and 0 after RollupStatus 1 creation SizelnBytes 107481464832 SpanDepth 1 SpanLength 3 StartingLBAinBlocks 0 StripeSize 128 VirtualDiskTargetID 0 WriteCachePolicy 1 After successful virtual disk creation DCIM_VirtualDiskView BusProtocol 6 Cachecade 0 DiskCachePolicy 1024 FQDD Disk Virtual 0 RAID Slot 1 1 InstancelD Disk Virtual 0 RAID Slot 1 1 LastSystemInventoryTime 20120116145459 000000 000 LastUpdateTime 20120116145459 000000 000 LockStatus
164. er Integer Attributes 181 16 20 Convert Physical Disks to RAID ConvertTORAID sceceeeeeeeeeeeeeeteeeeeeeeeeteeee 182 16 21 Convert Physical Disks to Non RAID ConvertTONOnRAID eseeeeeeeeeeeeeeeteee 183 17 Managing BIOS Comiguration insists esto edad tice 183 17 1 Listing the BIOS Inventory Enumeration Class 0 cceceeeeeeeeeeeeeeeeeneeeeeeeeeeeteeee 183 17 2 Getting a BIOS Enumeration Instance ccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeaeaeeeeeeeennneae 185 17 3 Changing the BIOS BootMode SetAttribute cece cette eeeeeteeeeeeeeeeeeenneae 185 17 4 Setting Multiple BIOS BootMode ParameterS ccccccceeeeeeeeeeeeeeeeeeentieeeeeeeeeeeeeee 186 17 5 Listing the BIOS Inventory Integer Class c cccceeeeeeeeeeeeeeeeeeeeeeteeeetneeeeeeeeeeneeee 187 17 6 Listing the BIOS Inventory String Class cc cceeeeeee eee ee cee ee eter eet eeeenaeeeeeeeeetnteee 187 17 7 Applying the Pending Values for BIOS amp Boot CreateT argetedConfigJob 188 17 8 Deleting the Pending Values for BIOS amp Boot DeletePendingConfiguration 189 17 9 Managing BIOS Passwords ccc fed 24 2 0 ae nddeande oe cecdeertcantasdt car duce cdenetasequrtosecensweseege 190 17 9 1 Setting the BIOS Password sctecice ees watonaelereptedecesl nes aiemesl ceeseendeene 190 17 9 2 Create Target Configuration JOD ecciecieccsenattepeeceesQlenat cape seeen tetera cence 192 17 9 3 Monitor Se
165. ername to the IP address of the ISO image NFS_Password This is the corresponding password to the username containing the ISO image 74 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OS ISO This is to be replaced by the actual name of the ISO image EXAMPLE winrm i BootToNetworkISO 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 encoding utf 8 a basic IPAddress NFS_ IPaddress ShareName NFS OSISO ShareType 0 Username NFS_Username Password NFS_Password Workgroup WORKGROUP ImageName 0S ISO OUTPUT The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters The MessagelD and Message output parameters will further contain method invocation information if an error occurred BootToNetworkISO_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD 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 th
166. ers a Dell data model for managing iDRAC user accounts that is based on an attribute model The DCIM iDRAC Card Profile specifies the attributes for each user account name password and privilege The iDRAC has 15 local user account that can be managed 5 2 Account Inventory using iDRAC Attributes The list of user accounts may be retrieved by enumerating the DCIM_iDRACCard classes The class provides the user account name and enabled state properties Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile 5 2 1 Account and Capabilities using iDRAC Attributes Enumerating the DC M_iDRACCardEnumeration class Section 19 1 and parsing the output for the attribute AttributeDisplayName User Admin Enable will display all of the 16 possible user accounts and their respective status EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardEnumeration u USER p PASSWORD 18 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 r https IPADDRESS wsman 443 SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_iDRACCardEnumeration AttributeDisplayName User Admin Enable AttributeName Enable CurrentValue Disabled DefaultValue Disabled Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 1 InstancelD iDRAC Embedded 1 Users 1 Enable IsReadOnly true
167. erty ActivityQualifiers is an array of type string To set more than one privilege you need to provide the same key name more than once The tool does not allow duplicate keys to be entered through the command line Instead you need to perform two operations 1 Get an instance of the CIM_Privilege class of interest 2 Using the class instance replace the property ActivityQualifiers with the new values 3 Use the new instance XML as input to the set operation 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 and related MOFs2 The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Inventory Profile 6 2 Remote Inventory Method Invocation Get Software Inventory The Softwareldentity class contains information for the BIOS and component firmware installed on the target system as well as available firmware images cached in the Lifecycle Controller The enumeration of the Softwareldentity class returns a list of Softwareldentity objects with properties such as firmware type and version Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile EXAMPLE
168. ervice gt lt p Target gt DISK Virtual 1 RAID Integrated 1 1 lt p Target gt lt p GetDHSDisks_INPUT gt OUTPUT GetDHSDisks_OUTPUT ReturnValue 0 The following message may be fixed by deleting the job queue as referenced in Section 10 2 2 GetDHSDisks_OUTPUT Message Configuration already committed cannot set configuration MessagelD STORO23 ReturnValue 2 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 159 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 org wbem wscim 1 cim schema 2 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 AssignSpare xml The input file AssignSpare xml is shown below lt p AssignSpare_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt
169. ess http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_ComputerSystem SelectorSet Selector Name srv system CreationClassName DCIM_ComputerSystem __cimnamespace root dcim 47 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE Part B winrm g http schemas dell com wbem wscim 1 cim schema 2 DCIM_CSEnabledLogicalElementCapabilities __cimnamespace root dcim InstancelD DCIM ComputerCap 1 u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT Part B RequestedStatesSupported 2 Enabled 3 Disabled 11 Reset DCIM_CSEnabledLogicalElementCapabilities Caption null Description null ElementName Computer System Capabilities ElementNameEditSupported false ElementNameMask null InstancelD DCIM ComputerCap 1 MaxElementNameLen null RequestedStatesSupported 2 3 11 StateAwareness null 8 3 2 Power State Management Method The power control capabilities are also reported by the PowerStatesSupported property of the CIM_PowerManagementCapabilities PMC class associated with the C M_PowerManagementService PMS class Getting the instance of PMC is a two step process First enumerate the instance of PMS with EPR Second enumerate the associated PMC class When there is only one
170. etworkISOlmage with the following syntax 81 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i DisconnectNetworklSOImage http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters The MessagelD and Message output parameters will further contain method invocation information if an error occurred DisconnectNetworkISOlmage_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 ConnectNetworklSOlmage method one time only for next immediate host reboot After that host server will continue to boot to the ISO image Invoke Skipl SOImageBoot via NFS share with the following syntax EXAMPLE winrm i SkiplSOlmageBoot http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PAS
171. f acceptable strings is present in the MinLength and MaxLength fields EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 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 lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Integrated 1 1 2 lt p Target gt lt p AttributeName gt VirtMacAddr lt p AttributeName gt lt p AttributeValue gt 11 22 33 44 55 66 lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD NIC001 139 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 15 13 Setting the LegacyBootProto Attribute The SetAttribute method is used to set or change the value of a NIC attribute WARNING The local BIOS setting always overwrites the LegacyBootProto option This option is only applied in the BIOS setup By setting this attribute remotely it appears that the value is set but it really did not because the local BIOS setting o
172. g syntax EXAMPLE winrm i DetachISOFromVFlash cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem 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 MessagelD 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 The ISO image is attached to the host system as an emulated USB CD ROM storage device Whenever the host system reboots it will boot to this ISO Image every single time until DisconnectNetwork ISOIlmage is called The ISO will be reattached upon iDRAC reset Invoke ConnectNetworkISOlmage via CIFS NFS share with the following syntax CIFS_or_NFS_IPADDRESS This is the IP address of the location of the ISO image CIFS_or_NFS OSISO This is the sharename directory path to the ISO image 2_or_0 2 CIFS O NFS 80 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 CIFS_or_NFS_Username This is the username to the IP address of the ISO image CIFS_or_NFS_Password This is the corresponding p
173. g utf 8 a basic returntype EPR OUTPUT B 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 24 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Selector __cimnamespace root dcim Name iDRAC Embedded 1 Users 1 CreationClassName DCIM_Account Sys temName systemmc SystemCreationClassName DCIM_SPComputerSystem 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 Account setting capability is defined in the class CIM_AccountManagementCapabilities associated with the CIM_Account class instance The ability to enable and disable an account is defined in the capability class CIM_EnabledLogicalElementCapabilities associated with the C M_Account class To determine account 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_AccountManagementService class instance using EnumerateEPR mode 3 Enumerate
174. ge file located on either iDRAC vFlash SD card or network share IP ADDRESS This is the IP address of the file server DRIVESHARE This is the directory path for the image USERNAME This is the username to the file share PASSWORD This is the password to the file share IMAGENAME This is the desired name of the image PASSPHRASE This can be used to password protect NFS and CIFS images For NFS and CIFS shares the entire Passphrase PASSPHRASE argument is only required when the backup image used a passphrase The following examples restore the server profile and execute it immediately using the TIME_NOW parameter 18 2 1 Importing Server Profile from iDRAC vFlash Card Restorelmage iDRAC vFlash Card ShareType is 4 winrm i Restorelmage http schemas dmtf org wbem wscim 1 cim schema 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 2 2 Importing Server Profile from NFS share Restorelmage NFS Share ShareType is 0 EXAMPLE 197 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm i Restorelmage http schemas dmtf org wbem wscim 1 cim sch
175. he CIM_Account class instance The set operation requires an instance reference The instance reference may be retrieved by adding EnumerateEPR mode to enumerate or get of the class The profile defines this property as string array containing all the privileges to be granted for the account Setting the list of privileges is a complete over write of the previous setting This restriction is a limitation where the protocol does not define how to set a particular index in the list The new list will replace the previous list in its entirety Profiles http www dmif org sites default files standards documents DSP1034 1 0 1 pdf http www dmif org sites default files standards documents DSP1039 1 0 0 pdf 32 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Here is an example list of available privileges from an instance of the class CIM_RoleBasedManagementCapabilities DCIM_LocalRoleBasedManagementCapabilities ActivitiesSupported 7 7 7 7 7 7 7 7 7 ActivityQualifiersSupported Login to DRAC Configure DRAC Configure Users Clear Logs Execute Server Control Commands Access Console Redirection Access Virtual Media Test Alerts Execute Di agnostic Commands ElementName Local Role Based Management Capabilities InstancelD DCIM LocalRoleBasedManagementCapabilities QualifierFormatsSupported 9 9 9 9 9 9 9 9 9 SharedPrivilegeSupported false SupportedMethods 8 The privilege prop
176. he several methods that attach a virtual USB device to the target system accept a StartTime and Until parameter The parameter data type is CIM date time If the StartTime parameter is null the action will not be started If the Until parameter is null the default value will be 17 hours The date time data type is defined in the CIM Infrastructure Specification as ddddddddhhmmss mmmmmm Where Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 e dddddddd is the number of days hh is the remaining number of hours e mm is the remaining number of minutes e 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 200909301 12030 The user is expected to enter the date and time in this format for all Lifecycle Controller updates and set attribute tasks TIME_NOW is a special value that represents running the tasks immediately 3 2 5 Return Values Many of the methods in this document have the following possible return values They are summarized here for convenience 0 Success 1 Not Supported 2 Failed 4096 Job Created 3 2 6 Glossary PL WSMAN WS Management is a specification of a SOAP based protocol for the management of servers devices applications and more Dell Lifecycle Controller 2 Web
177. iCinteger u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_NICInteger AttributeDisplayName Blink LEDs AttributeName BlnkLeds CurrentValue 0 Dependency null FQDD NIC Integrated 1 1 1 GroupDisplayName Broadcom Main Configuration Page GroupID VndrConfigPage InstancelD NIC Integrated 1 1 1 BlnkLeds IsReadOnly false LowerBound 0 PendingValue null UpperBound 15 DCIM_NICInteger AttributeDisplayName Link Up Delay Time AttributeName LnkUpDelayTime CurrentValue 0 Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 GroupDisplayName iSCSI General Parameters GroupID IscsiGenParams InstancelD NIC Integrated 1 1 1 LnkUpDelayTime IsReadOnly false LowerBound 0 PendingValue null UpperBound 255 DCIM_NICInteger AttributeDisplayName LUN Busy Retry Count AttributeName LunBusyRetryCnt CurrentValue 0 Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name iSCSIBootSupport gt Unavailable lt ROIf gt lt AttrLev gt lt Dep gt FQDD NIC Integrated 1 1 1 129 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 GroupDisplayName iSCSI General Parameters GroupID IscsiGenParams InstancelD NIC Integrated 1 1 1 LunBusyRetryCnt IsReadOnly false LowerBound 0 Pen
178. iaType 4 MinBandwidth 0 NicMode 3 PCIDevicelD 165f PCISubDevicelD 1f5b PCISubVendorID 1028 PCIVendorID 14e4 PermanentFCOEMACAddress PermanentMACAddress 14 FE B5 FF B3 EA PermanentiSCSIMACAddress ProductName Broadcom Gigabit Ethernet BCM5720 14 FE B5 FF B3 EA ReceiveFlowControl 0 SlotLength 0002 SlotType 0002 TransmitFlowControl 0 VendorName null WWPN null iScsiOffloadMode 3 DCIM_NICView AutoNegotiation 0 BusNumber 1 ControllerBlOSVersion 1 17 CurrentMACAddress 14 FE B5 FF B3 EB DataBusWidth 0002 DeviceNumber 0 EFlVersion 15 0 16 FCoEOffloadMode 3 FCOoEWWNN null FQDD NIC Integrated 1 2 1 FamilyVersion 7 0 39 FunctionNumber 1 InstancelD NIC Integrated 1 2 1 LastSystemInventoryTime 20010708151620 000000 000 LastUpdateTime 20010708151606 000000 000 LinkDuplex 0 LinkSpeed 0 MaxBandwidth 0 MediaType 4 MinBandwidth 0 NicMode 3 PCIDevicelD 165f PCISubDevicelD 1f5b PCISubVendorlID 1028 PCIVendorID 14e4 PermanentFCOEMACAddress PermanentMACAddress 14 FE B5 FF B3 EB PermanentiSCSIMACAddress 131 Version 2 1 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 5 Listing the CNA Invento
179. ical disks selected RAIDLevel RAID 0 2 RAID 1 4 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 StripeSize 8KB 16 16KB 32 32KB 64 64KB 128 128KB 256 256KB 512 512KB 1024 1MB 2048 171 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows ReadPolicy No Read Ahead 16 Read Ahead 32 Adaptive Read Ahead 64 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 CreateVirtualDisk xml The input file CreateVirtualDisk xml is shown below lt p CreateVirtualDisk_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p PDArray gt Disk Bay 0 Enclo
180. id 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 cim schema 2 DCIM_LifecycleJob SelectorSet Selector __cimnamespace root dcim InstancelD JID_001296571842 21 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 5 3 3 Modify Account State using iDRAC Attributes When the account setting capability allows the user account may be enabled or disabled by invoking the method ApplyAttributes method on the Enable property Confirmation of the change can be obtained by enumerating the DCIM_iDRACCardString class Section 19 6 EXAMPLE winrm i ApplyAttributes http schemas dmtf org wbem wscim 1 cim schema 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_AccountChange xml The input file DracCard_ AccountChange xml is shown below lt p ApplyAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardService gt lt p Target gt iDRAC Embedded 1 lt p Target gt lt p AttributeName gt Users 4 Enable lt p AttributeName gt lt p Att
181. idth 0002 Description 5520 5500 X58 I O Hub PCI Express Root Port 3 DeviceNumber 3 FQDD P2PBridge Embedded 4 1 FunctionNumber 0 InstancelD P2PBridge Embedded 4 1 LastSystemInventoryTime 20100331101859 LastUpdateTime 20100325134947 Manufacturer Intel Corporation PCIDevicelD 340A PCISubDevicelD 0000 PCISubVendorID 0000 PClVendorID 8086 SlotLength 0002 SlotType 0002 DCIM_PCIDeviceView 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 Profile Enumerate DCIM_VideoView with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_VideoView u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 SkipCACheck SkipCNCheck OUTPUT DCIM_VideoView BusNumber 6 DataBusWidth 0002 Description PowerEdge R610 MGA G200eW WPCM450 DeviceNumber 3 FQDD Video Embedded 1 1 57 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 FunctionNumber 0 InstancelD Video Embedded 1 1 LastSystemInventoryTime 20100331101859 LastUpdateTime 201003251 34947 Manufacturer Matrox Graphics Inc PCIDevicelD 0532 PCISubDevicelD 0236 PCISubVendorID 1028
182. ignConfig 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 xml The input file ClearForeignConfig xml is shown below lt p ClearForeignConfig_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p ClearForeignConfig_INPUT gt OUTPUT ClearForeignConfig_OUTPUT ReturnValue 0 156 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 If no foreign physical disks are available the following message may result ClearForeignConfig_OUTPUT Message General failure MessagelD STOROO6 ReturnValue 2 16 14 Applying the Pending Values for RAID CreateTargetedConfigJob The CreateTargetedConfigJob method is called to apply the pending values created by RAID methods The system will automatically reboot depending on the ScheduledStartTime selected The CreateTargetedConfigJob job D output with the job control section can be used to obtain its status Invoke CreateTargetedConfigJob with th
183. iguration_INPUT gt OUTPUT DeletePendingConfiguration_OUTPUT Message The command was successful MessagelD BIOSO01 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 1 Setting the BIOS Password The following example sets the BIOS system password to NEW_PASSWORD Three instances of XML are shown below to demonstrate the following scenarios e No BIOS password is set e Changing an existing BIOS password e Deleting an existing BIOS password Invoke ChangePassword method with the following parameters 190 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Target Obtained from any BIOS enumerate WSMAN command PasswordType Either 1 for system or 2 for setup OldPassword Reference following XML case A B or C NewPassword Reference following XML case A B or C EXAMPLE winrm i ChangePassword http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_BlOSService SystemName DCIM ComputerSystem Name DCIM BlOSService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file
184. ilter RegisteredName 0S Deployment Result shall contain one instance of CIM_RegisteredProfile containing property RegisteredVersion 1 1 0 Associators objectpath instance returned from step 3 AssociationClass CIM_ElementConformsToProfile Result shall contain one instance of DCIM_OSDeploymentService Checking OS Deployment Service Availability Invoke enumerate with the following syntax EXAMPLE winrm e cimv2 root dcim DCIM_OSDeploymentService u USER p PASSWORD r https IPADDRESS wsman 443 encoding utf 8 a basic OUTPUT DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService ElementName Operating System Deployment Service Name DCIM OSDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem 11 3 OS Deployment Method Invocation Examples 69 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 1 profile conformance b Method name GetDriverPa
185. ime TIME_NOW 18 1 2 Exporting Server Profile to NFS Share Backuplmage 194 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 NFS Share ShareType is 0 The entire Passphrase passphrase argument is optional EXAMPLE winrm i BackupImage http schemas dmtf org wbem wscim 1 cim schema 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 ShareName DRIVESHARE ShareType 0 lmageName IMAGENAME Username USERNAME Password PASSWORD Passphrase PASSPHRASE ScheduledStartTime TIME_NOW NOTE The ShareName field should only be the folder exposed by the system to the network Any sub folder information should be attached to the ImageName field Otherwise there can be connection issues when trying to locate create the backup file Correct Example ShareName folder1 lmageName subfolder image_name In Correct Example ShareName folder1 subfolder lmageName image_name 18 1 3 Exporting Server Profile to CIFS Share BackupImage CIFS Share ShareType is 2 The entire Passphrase passphrase argument is optional EXAMPLE winrm i BackupImage http schemas dmtf org wbem wscim 1 cim
186. ing NICInteger and NICEnumeration Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile Enumerate N CView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICView u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_NICView AutoNegotiation 0 BusNumber 1 ControllerBlOSVersion 1 3 CurrentMACAddress 00 21 9B 92 70 57 DataBusWidth 0002 DeviceNumber 0 EFIVersion null FCoEOffloadMode 3 FCOoEWWNN null FQDD NIC Embedded 1 1 FamilyVersion null FunctionNumber 0 InstancelD NIC Embedded 1 1 LastSystemInventoryTime 20100413135024 LastUpdateTime 20100413134727 LinkDuplex 0 LinkSpeed 0 MaxBandwidth 0 MediaType 4 MinBandwidth 0 NicMode 3 PCIDevicelD 1639 PCISubDevicelD 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 59 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 VendorName null WWPN null iScsiOffloadMode 3 DCIM_NICView AutoNegotiation 0 BusNumber 1 ControllerBlOSVersion 1 3 CurrentMACAddress 0
187. ing error message DeletePartition OUTPUT Message Invalid partition index MessagelD VF018 ReturnValue 2 13 7 Format Partition This method is for formatting a partition of the type specified by the user 115 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Use the following algorithm to successfully format an existing partition e Enumerate the DCIM_PersistentStorageService class e Invoke the FormatPartition method on the instance above with the following parameters PartitionIndex The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be formatted 1 to 16 FormatType The new format type of the partition EXT2 1 EXT3 2 FAT16 3 FAT32 4 e The OUT parameter Job will refer to the instance of CIM_ConcreteJob using which the user can query the status of the formatting of the partition EXAMPLE winrm i FormatPartition http schemas dell com wbem wscim 1 cim schema 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 lt p FormatPartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM
188. ing the MaxBandwidth Attribute The SetAttribute method is used to set or change the value of a CNA attribute The MinBandwidth and MaxBandwidth attributes control the bandwidth allocations for a given CNA partition The values are displayed in percentage For Broadcom CNA cards the MinBandwidth attribute values for a given port must always add up to either 0 or 100 MaxBandwidth is a value of 100 or less for any given partition For the Qlogic CNA cards the MinBandwidth attribute values for a given port must add up to 100 or less MaxBandwidth again is a value of 100 or less for any given partition Invoke SetAttribute with the following parameters from Section 15 1 and syntax Target FQDD attained through DCIM_NIiCInteger AttributeName Attained from AttributeName field AttributeValue 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 Range of choices is attained from the LowerBound and UpperBound fields 0 UpperBound 100 LowerBound EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 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 SetAttribut
189. inrm g cimv2 root dcim DCIM_RAIDString Ins tancelD INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_RAIDString AttributeName Name CurrentValue MyCacheCadeVD FQDD Disk Virtual 0 RAID Integrated 1 1 InstancelD Disk Virtual 0 RAID Integrated 1 1 Name IsReadOnly true MaxLength 15 MinLength 0 149 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 PendingValue 16 7 Listing the RAID Inventory ControllerView Class The DCIM_ControllerView class groups together a set of Controller properties Enumerate ControllerView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_ControllerView u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_ControllerView Bus 1 CacheSizelnMB 0 CachecadeCapability 0 ControllerFirmwareVersion 20 10 1 0066 Device 0 DeviceCardDataBusWidth 1 DeviceCardManufacturer DELL DeviceCardSlotLength 4 DeviceCardSlotType PCI Express x8 DriverVersion null The get instance method in EncryptionCapability 0 Section Error Reference source EncryptionMode 0 not found will use this FQDD RAID Slot 1 1 InstancelD as input Function 0 InstancelD RAID Slot 1 1 KeylD null LastSystemInventoryTime 20120116
190. ions exist Use the CreatePartition method to create partitions Enumerate the DCIM_OpaqueManagementData with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_OpaqueManagementData u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_OpaqueManagementData AccessType Read Only AttachedState Detach CreationClassName DCIM_OpaqueManagementData DataFormat RAW DevicelD 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 2 Initialize the Virtual Flash Media e Enumerate the DCIM_PersistentStorageService class e Invoke the InitializeMedia method on the instance above e The OUT parameter Job will refer to the instance of CiIM_ConcreteJob using which the user can query the status of the initialization of the media 108 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 13 2 1 Get VFlash SD Card Inventory DCIM_VFlashView is a subclass of CIM_View 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 wil
191. is for deleting a partition on a storage device When this method is successfully executed the instance of DCIM_OpaqueManagementData representing the desired partition along with the association instance of DCIM_ServiceAffectsElement will be deleted The AvailableSize property of the associated storage media will increase by the size of the deleted partition Invoke DeletePartition with the following parameters and syntax PartitionIndex The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be removed 1 to 16 EXAMPLE winrm i DeletePartition http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_PersistentStorageService SystemName DCIM ComputerSystem Name DCIM PersistentStorageService r https IPADDRESS 443 wsman u USER p PASSWORD auth basic encoding utf 8 SkipCNCheck SkipCACheck file DIRECTORYPATH DeletePartition xml The input file DeletePartition xml is shown below lt p DeletePartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 1 lt p PartitionIndex gt lt p DeletePartition_INPUT gt OUTPUT When this method is executed a ReturnValue or error message is returned DeletePartition OUTPUT ReturnValue 0 An index that does not exist in the XML file may yield the follow
192. isk CreateVirtualDisk The CreateVirtualDisk method is used to create a single virtual disk on the targeted controller The successful execution of this method results in a pending but not yet created virtual disk The ObjectStatus property in the virtual disk view Section 16 10 will have the value 3 which represents pending The virtual disk will not be created until a configuration job Section 16 15 has been scheduled and the system is rebooted Upon creation of the virtual disk the FQDD of the formerly pending virtual disk will change Invoke CreateVirtualDisk with the following parameters and syntax 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 The parameter list contains the following names Size RAIDLevel SpanDepth SpanLength StripeSize ReadPolicy WritePolicy DiskCachePolicy VirtualDiskName Initialize VDPropValueArray This parameter is the list of property values that will be used to create a virtual Disk The property values are for the property names listed under VDPropNameArray 170 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Size Size of the virtual disk specified in MB If not specified default will use full size of phys
193. ke SetupJobQueue with the following parameters and syntax JobArray The jobids are listed in the JobArray element Multiple jobs are listed in the order of job execution sequence If a system is to reboot at the scheduled start time a reboot job will need to be added to the list This reboot job has a prefix of R D_ for its jobid Note scheduling a job that is already scheduled will result in an error message If there is no reboot job in the job array the system will schedule the jobs for execution at the specified start time The jobs will not be executed until the system is rebooted by something other than Lifecycle Controller At the specified UntilTime any jobs that have not been executed are failed with an error indicating that the job was not executed in the specified maintenance window For some component updates such as Diagnostics USC and iDRAC firmware a system reboot is not needed EXAMPLE winrm invoke SetupJobQueue cimv2 root dcim DCIM_JobService CreationClassName DCIM_JobService Name JobService SystemName ldrac SystemCreationClassName DCIM_ComputerSystem file SetupJobQueue xml u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 The syntax for SetupJobQueue xml is lt p SetupJobQueue_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_JobService gt lt p JobArray gt JID_001249463339 lt p JobArray gt lt p JobArray gt RID_001265817718 lt
194. kipCAcheck encoding utf 8 a basic file LockVirtualDisk xml 162 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 The input file LockVirtualDisk xml is shown below lt p LockVirtualDisk_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt Disk Virtual 0 RAID Integrated 1 1 lt p Target gt lt p LockVirtualDisk_INPUT gt OUTPUT This method requires an H700 or H800 controller to properly function as does the LockVirtualDisk method If the key is not set by LockVirtualDisk the following message may be displayed LockVirtualDisk_OUTPUT Message Controller Key is not present MessagelD STORO21 ReturnValue 2 16 17 3 Locking the Controller with a Key EnableControllerEncryption The EnableControllerEncryption method is used to set either Local Key encryption or Dell Key Manager DKM encryption on controllers that support encryption of the drives Invoke EnableControllerEncryption method with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView class See Section 16 1 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 p
195. kipCNCheck encoding utf 8 a basic OUTPUT When this command is executed a status or error message will be returned BootTolSOFromVFlash_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_OSDConcreteJob SelectorSet Selector InstancelD DCIM_OSDConcreteJob 1 __cimnamespace root dcim ReturnValue 4096 11 3 12 Delete ISO from VFlash The DeletelSOFromVFlash method will delete the ISO image that was downloaded to the VFlash Invoke DeletelSOFromVFlash with the following syntax EXAMPLE winrm i DeletelSOFromVFlash cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USERNAME 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 79 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 DeletelSOFromVFlash_OUTPUT Message ISO Image not found on VFlash MessagelD OSD41 ReturnValue 2 11 3 13 Detach ISO from VFlash The DetachISOFromVF lash method will detach the ISO image in the VFlash from the system Invoke DetachISOFromVFlash with the followin
196. l ActivityQualifiers null ElementName DCIM Local Privilege 1 InstancelD DCIM Privilege 1 PrivilegeGranted true QualifierFormats null RepresentsAuthorizationRights false DCIM_LocalRolePrivilege Activities 7 7 7 7 7 7 7 7 7 ActivityQualifiers Login to DRAC Configure DRAC Configure Users Clear Logs Test Alerts Execute Server Control Commands Access Console Redirection Access Virtual Media Execute Diagnostic Commands ElementName DCIM Local Privilege 2 InstancelD DCIM Privilege 2 PrivilegeGranted true QualifierFormats 9 9 9 9 9 9 9 9 9 RepresentsAuthorizationRights true DCIM_LocalRolePrivilege Activities null ActivityQualifiers null ElementName DCIM Local Privilege 3 InstancelD 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 To determine privilege setting capabilities 1 Acquire the class instance of CIM_Privilege of interest 2 Enumerate the associators of the CIM_Privilege instance and search for CIM_RoleBasedAuthorizationService class instance using EnumerateEPR mode 27 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1
197. l reside Enumerate the DCIM_VFlashView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_VFlashView u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_VFlashView AvailableSize 972 Capacity 972 ComponentName vFlash SD Card FQDD Disk vFlashCard 1 HealthStatus OK InitializedState Uninitialized mec Schon T222 Tpi InstancelD Disk vFlashCard 1 the populated LastSystemInventoryTime 20100426221347 000000 000 initialized fields LastUpdateTime 20100426221347 000000 000 Licensed true VFlashEnabledState true WriteProtected false InitializedState Field indicates status of element to be initialized InstancelD nstance D of desired element for initialization 13 2 2 Initialize Format Media This method is used to initialize or format the virtual flash media device Invoke InitializeMedia with the following parameters and syntax EXAMPLE winrm i InitializeMedia http schemas dell com wbem wscim 1 cim schema 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 OUTPUT 109 Dell Lifecycle Controller 2 W
198. layName User Admin Privilege AttributeName Privilege CurrentValue 511 DefaultValue 0 Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 3 InstancelD iDRAC Embedded 1 Users 3 Privilege IsReadOnly false LowerBound 0 UpperBound 511 19 6 Listing the iDRAC Card Inventory Integer Class using group D 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 All the iDRAC attributes of type integer that are part of a given Group NIC and Users are retrieved In order to do this GroupID needs to be set to one of the following NIC or Users Enumerate the iDRACCardinteger class with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardInteger 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_iDRACCardInteger WHERE GroupID NIC 1 The possible inputs for GroupID are NIC 1 Users 3 OUTPUT 208 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 DCIM_iDRACCardInteger AttributeDisplayName VLan Priority AttributeName VLanPriorit
199. le Controller 2 Web Services Interface Guide for Windows Version 2 1 0 InstallationDate The date when the payload was installed to the system If the system time was not set when the firmware installation took place the install date will be 1970 01 01 Factory installed firmware will have the 1970 01 01 date VersionString Shows the version of the firmware represented 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 and related MOF files 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 2 Rollback Firmware The InstallFromSoftwareldentity 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 The general Rollback firmware steps are performed in several stages as described in the next sections Meanwhile the steps are demonstrated in examples in Section 7 3 and Section 7 4 7 2 1 Request Rollback Image The first stage is a request to initiate and download the rollback image from the Lifecycle Controller by invoking the InstallFrom
200. le controller before the system is retired Invoke LCWipe with the following parameters and syntax EXAMPLE winrm i LCWipe http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService 104 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT LCWipe_OUTPUT ReturnValue 0 12 17 Get Remote Services API Status The GetRemoteServicesAPI Status method is used to obtain the overall remote services API status that includes both the host system status as well as the remote services Data Manager status The overall rolled up status shall be reflected in the Status output parameter NOTE The LCStatus output parameter value includes the status reported by the DMStatus output parameter in the GetRSStatus method Thus GetRSStatus method invocation is redundant Invoke GetRemoteServicesAPIStatus with the following parameters and syntax EXAMPLE winrm i GetRemoteServicesAPIStatus http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPAD
201. leen eaten 33 6 1 Software Inventory Profile Specification ssneseeessseeennrrneeeseererrrrnrrsserrrnnrrnnneserrenee 33 6 2 Remote Inventory Method Invocation Get Software INVeNtOry ccs 33 7 Firmware CAN Cg oe ask ae Sad eg cee ee ade Acces dada Mae tee deena iat ed dere Meg 35 7 1 Software Update Profile Specification cccccccecceeeeeeececceceeeeeeeeeeeeeeaeaeeeeeeeeeeenesaaaes 35 L 2 ROMBACK FINMWAlE isna a Fens Viavees veaes a e aaa E E a aS 35 7 2 1 Request Rollback Image ennenen 35 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 7 2 2 Create Reboot oDs acca anise waa ea aad cue Sena saan ee 35 7 2 3 Schedule Update Jobs x55 avis patdecdiaeeereheidel doc eeapuustdondaa teen eideceNigas 35 72 4 Monitor Update J hs aii acusictapncoonnidteen acral ted eee easier 35 io BIOS Firmware Rollback aA E A NS 36 7 4 NIC Firmware Rolla ck ccccccccccccccccceeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeenegs 37 7 5 Update from Network SOUrGS vs fcs225 edie etreee eae areal ee nt ee 39 7 5 1 Request Update Downloads iiccccsscccceiicteaydentide eked deat deeeteietaee 39 7 5 2 Monitor Download Status siz cs 2 Geo eecc sees caclae decease edb uo eens ee cacases seeks tence 39 7 5 3 Reboot to Perform WPGale sce ia tietes oy ctetant eetest oe card ends ote aat on oe a eats 39 7 5 4 Waitfor Job Completion c ccsctcesn 5 SSenlictarct
202. lement for initialization 110 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 13 3 Enable 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 com wbem wscim 1 cim schema 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 VFlashStateChange xml The input file VFlashStateChange xml is shown below lt p VFlashStateChange_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p RequestedState gt 1 lt p RequestedState gt lt p VFlashStateChange_INPUT gt OUTPUT VFlashStateChange_OUTPUT ReturnValue 0 13 4 Create Partition This method is used for creating a new partition on a storage device When this method is successfully executed an instance of DCIM_OpaqueManagementDaita
203. ll com wbem wscim 1 cim schema 2 DCIM_LifecycleJob 2 cimnamespace root dcim u USER p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic SkipCNCheck SkipCACheck OUTPUT DCIM_LifecycleJob InstancelD JID_001272324322 JobStartTime JobStatus Completed JobUntilTime Message Detach partition successful MessageArguments null MessagelD VF038 Name VFlashDetach Partition1 DCIM_LifecycleJob InstancelD JID_001273099184 JobStartTime 20191010101010 JobStatus COMPLETED JobUntilTime 2009 8 11 Message The command was successful MessageArguments null MessagelD LC001 Name LC Config 12 2 4 Get CSIOR Component Configuration Recovery CCR Attribute The Component Configuration Recovery CCR attributes are e Licensed e Part Firmware Update e Collect System Inventory on Restart CSIOR e Part Configuration Update Get the current CS OR attribute setting as follows EXAMPLE 1 winrm g cimv2 root dcim DCIM_LCEnumeration InstancelD LifecycleController Embedded 1 LCAttributes 1 CollectSystemInventoryOnRestart u USERNAME p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic NOTE For 11G InstancelD DCIM_LCEnumeration CCR5 91 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OUTPUT DCIM_LCEnumeration AttributeName Collect System Inventory on Restart CurrentValue Disabled DefaultValue Enabled ElementName LC emb 1 Insta
204. ller 2 Web Services Interface Guide for Windows Version 2 1 0 The above command will schedule the job at 10pm To poll for job completion enumerate the DCIM_LifecycleJob job instance OUTPUT CreateConfigJob_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001265982202 __cimnamespace root dcim 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 InstancelD 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 Check for the JobStatus property equal to Completed shown below to know the set has been completed OUTPUT DCIM_LifecycleJob InstancelD JID_001265982202 JobStartTime 20191010101010 JobStatus COMPLETED JobUntilTime 2009 8 11 Message The command was successful MessageArguments null MessagelD LC001 Name LC Config 12 2 3 List All LC Jobs EXAMPLE 90 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm e http schemas de
205. lly MessageArguments null MessagelD USC1 Name Rollback DCIM AVAILABLE NONPCI 159 2 1 4 7 3 BIOS Firmware Rollback The InstallFromSoftwareldentity 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 InstallFromSoftwareldentity with the following parameters and syntax InstancelD This is the instancelD of the Softwareldentify that is to be used to rollback the firmware to a previous version The InstancelD can have value such as DCIM AVAILABLE NONPCI 159 2 1 4 e Itis available firmware on a NONPCI device 36 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 e This refers BIOS version 2 1 4 EXAMPLE winrm i InstallFromSoftwareldentity cimv2 root dcim DCIM_SoftwarelnstallationService CreationClassName DCIM_SoftwarelnstallationService SystemCreationClassName DCIM_ComputerSystem SystemName IDRAC ID Name SoftwareUpdate file RollInputBlOS xml u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 The rollback input file RolllnputBIOS xml is shown below lt p InstallFromSoftwareldentity_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_SoftwarelnstallationService gt lt p Target xmlns a http schemas xm
206. lsoap org ws 2004 08 addressing xmlns w http schemas dmtf org wbem wsman 1 wsman xsd gt lt a Address gt http schemas xmlsoap org ws 2004 08 addressing role anonymous lt a Address gt lt a ReferenceParameters gt lt w ResourceURI gt http schemas dell com wbem wscim 1 cim schema 2 DCIM_Softwareldentity lt w ResourceURI gt lt w SelectorSet gt lt w Selector Name InstancelD gt InstancelD lt w Selector gt lt w SelectorSet gt lt a ReferenceParameters gt lt p Target gt lt p InstallFromSoftwareldentity_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned InstallFromSoftwareldentity_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_SoftUpdateConcreteJob SelectorSet Selector InstancelD JID_001276741956 __cimnamespace root dcim ReturnValue null 7 4 NIC Firmware Rollback The InstallFromSoftwareldentity 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 37 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Invoke InstallFromSoftwareldentity with the following parameters and syntax InstancelD This is the instancelD of the Softwareldentify that is to be used to rollback
207. method is used to unpack the drivers for the selected OS and copy them toa specified network share CIFS and NFS network share technologies are supported 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 72 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 NFS_Password This is the corresponding password to the username containing the ISO EXAMPLE winrm i UnpackAndShare cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM OSDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS 443 wsman encoding utf 8 a basic IPAddress CIFS_IPADDRESS ShareName DRIVERSHARE ShareType 2 Username CIFS_USERN AME Password CIFS_PASSWORD OSName Microsoft Windows Server 2008 with SP2 OUTPUT The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters The MessagelD and Message output parameters will
208. model server manufacturer etc Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile Enumerate SystemView with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_SystemView u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_SystemView AssetTag Testtg BlOSReleaseDate 09 12 2011 BlOSVersionString 0 3 22 BaseBoardChassisSlot NA BatteryRollupStatus 1 63 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 BladeGeometry 4 BoardPartNumber 0N051FX02 BoardSerialNumber CN13740920003M 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 InstancelD System Embedded 1 LastSystemInventoryTime 20100331101859 LastUpdateTime 20100325134947 LicensingRollupStatus 1 LifecycleControllerVersion 2 0 0 Manufacturer Dell Inc MaxCPUSockets 2 MaxDIMMSlots 24 MaxPCleSlots 3 MemoryOperationMode OptimizerMode Model PowerEdge R620 PSRollupStatus 1 PlatformGUID 3548474f c0d3 4680 3810 00374c4c4544 PopulatedCPUSockets 1 PopulatedDIMMSlots 1 PopulatedPCleSlots 1 PowerCap 0 PowerCapEnabledState 3 PowerState
209. ncelD 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 org wbem wscim 1 cim schema 2 root dcim DCIM_LCEnumeration InstancelD LifecycleController Embedded 1 LCAttributes 1 PartFirmwareUpdate u USERNAME p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic NOTE For 11G InstancelD DCIM_LCEnumeration CCR4 OUTPUT DCIM_LCEnumeration AttributeName Part Firmware Update CurrentValue Allow version upgrade only DefaultValue Disable ElementName LC emb 1 InstancelD 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 RelnitiateDHS method to re initialize and restart the Auto Discovery client All configuration information is replaced with the auto discovery factory defaults Auto discovery can be disabled enabled and initiated immediately or delayed until next power cycle Invoke RelnitiateDHS with the following parameters and syntax 92 Dell Lifecycle Controller
210. nectionInfo method is used to provide the status of the ISO Image connection that has been exposed to the host system Invoke GetRFSISOlmageConnectionInfo with the following syntax EXAMPLE winrm i GetRFSISOImageConnectionInfo cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT GetRFSISOImageConnectionInfo_OUTPUT Message Unable to connect to ISO using RFS MessagelD OSD60 ReturnValue 2 A return value of 0 indicates success while the above output indicates an image was not present to retrieve the connection information from 11 3 21 Boot To Hard Drive HD 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 Invoke BootToHD with the following syntax 85 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i BootToHD cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD
211. nene 51 9 2 Fan MVeMON cacnicke a ete nws cea earh nea caws Aehae ah Ae MAGA HeA eT ee 52 9 3 Memory Inventory yactle Geese deldae a eae dh eceter pened ldarade paced daa dageaeeskdakezeteane 53 9 4 VGPU INVeEntO iin nn Catena cited a r cities era e e a ae Meares 54 9 5 DRAG Gard Inventory cee a ead a ee E eed ee 55 9 6 PCI Device Inventory cect Mice k cet Wace kde Mage het denne nce Nyda nh eecedear sees seeaess 56 97 Video lnNVentory ais peek cheered ee hae tenet agate gece WER ntl natal nae lca 57 9 8 VFlash SD Card Inventory sseessooeeeennneerseorrenrrnnrtserrrrnrrnntrserrrttrnnnrsererrenrnnnreereennne 58 9 9 NIC Inventory amp Configuration sssssnsseeesseseenrrrnrrsstrrrrrrnerssertrrrrnnnnssertnnernnnneseeennne 58 9 10 RAID Inventory amp Configuration sssseseesssesesnnrnnttsseertnrrnntrssrrtnnrrnnresernrernnnreseennne 60 9 11 BIOS Inventory amp Configuration sssssseeessseseenerrreesserrnrrnntrssrrrtrrnnnnsserrrnnrnnnneseeen nee 62 9 12 System Inventory including CSIOR attribute sseennnenneeeseeeenrrrnrresserrrerrnnressrrnne 63 10 Job Control Management lt scdetxiek depo Raich caia nh dee aceh aia Gack cae 65 10 1 Description of Job Management ccccceeeeecececee eee eeeeeeeceaeeeeeeeeeeteeaaaeeeeeeeeeenenas 65 10 2 Remote Job Control Examples sscve sscotracssciseettdelveraceinaddideietn dwadnee nica need tyeie 65 10 2 1 Setup JOD QUCUG esp icicpiet eed abetehe cera ads heat eae
212. ng Value 16 19 3 Changing the Value of a RAID Controller Integer Attribute The SetAttribute method is used to set or change the value of a RAID controller integer attribute The example below shows setting an controller attribute Invoke the SetAttribute method with the following parameters from Section 16 1 and syntax TARGET Obtained from the FQDD field AttributeName Obtained from the AttributeName field AttributeValue Obtained from the PossibleValues field 180 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm i SetAttribute cimv2 root dcim DCIM_RAIDSe rvice SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_RAIDService 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 lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p AttributeName gt RAIDccRate lt p AttributeName gt lt p AttributeValue gt 60 lt p AttributeValue gt lt p SetAttribute_INPUT gt OUTPUT SetAttribute_OUTPUT Message The method was successful MessagelD STOROO1 RebootRequired Yes ReturnValue 0 SetResult Set Pending Val
213. nnneeeeeeeeeeteeee 87 12 2 Part Replacement Configuration and Management c cccceeeeeeeeeeenneeeeeeeeeeeeeee 89 12 2 1 Create Config JOD 3 cnactider nd acai ad dege se eda hens teense ceca eee deutnes eceeerddans ee seecets 89 12 2 2 Get LC Config Job Status iz tncteiet cet ted eet eee adeno apaeaa tea le eae dae 90 122 3 LIST All WC MODS hir e O ohiuawydat tie Sealant aetna 90 12 2 4 Get CSIOR Component Configuration Recovery CCR Attribute 91 12 2 5 Get Part Firmware Update Attribute 0 0 0 0 0 eeeccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeenaaeaes 92 12 3 Re initiate Auto Discovery Client e ciies osthctivcentw tired tiehe soahedsPsdek wc bi seatetave dette ceeSaned se 92 12 4 Clear or Set Provisioning Server c ccc ccceecceeeeesececeeeeeeeeeeeeeceeaeeeeeeeeeeeeseseaeaeeeeeeeeneneas 93 12 5 Check VFlash License Enablement 0 cccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeneaaaaeeeeeeeeeenas 95 12 6 Download Server Public Key 2 024 003 haere oats elder ance 95 12 7 Download Client Certificates 22 5 deciac isd trateretamattadeleareeermaddad elven oMwadeneelve nice dnagsadetyeitee 96 12 8 Delete Auto Discovery Client Certificates cc ccccceeeeeieeeeeeeeeeeeeeeeeeeetieeeeeeeeeeneeee 97 5 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 12 9 Set Public Certificates 1 6 222s Gi denied aad nea ee Ghie GH ae nunie nm ea emuee 98 12 10 Set iDRAC Certificate and Private
214. nstallFromSoftwareldentity_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned InstallFromSoftwareldentity_OUTPUT Job 38 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_SoftUpdateConcreteJob SelectorSet Selector InstancelD JID_001265811668 __cimnamespace root dcim ReturnValue null Entering an invalid instancelD may yield the following error message InstallFromSoftwareldentity_OUTPUT Message Invalid InstancelD MessagelD SUP024 ReturnValue null 7 5 Update from Network Source A Firmware update can be achieved by invoking the InstallFromURI method in the class DCIM_SoftwarelnstallationService 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 1 Request Update Download The first stage is a request to initiate and download the update image from a source defined by the user by invoking the InstallFromURI method 7 5 2 Monitor Download Status Downloading the update package may take several minutes
215. nstancelD Fan Embedded 2A 52 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 LastSystemInventoryTime 20100331101859 LastUpdateTime 201004081 15623 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 of DCIM_MemoryView class Profile and Associated MOFs http www delltechcenter com page DCIM Library Profile Enumerate DCIM_MemoryView with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_MemoryView u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 SkipCACheck SkipCNCheck OUTPUT DCIM_MemoryView BankLabel B CurrentOperatingSpeed 1067 FQDD DIMM Socket B1 InstancelD DIMM Socket B1 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 53 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows FQDD DIMM Socket A3 InstancelD DIMM Socket A3
216. nt may be modified by issuing a set operation on the UserID property of the C M_Account class instance The set operation requires an instance reference The instance reference may be retrieved by adding EnumerateEPR mode to enumerate or get of the class Profiles http www dmif org sites default files standards documents DSP1034 1 0 1 pdf http www dmif org sites default files standards documents DSP1039 1 0 0 pdf 28 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 The steps below demonstrate how to set the user name and password for local accounts A Enumerate CIM_Account with EPR to identify all possible instance information to be used ina subsequent put or set operations EXAMPLE A winrm e http schemas dmtf org wbem wscim 1 cim schema 2 CIM_Account _cimnamespace root dcim u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNcheck 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 1 CreationClassName DCIM_Account Sys temName systemmc SystemCreationClassName DCIM_SPComputerSystem
217. nvoke CreateRebootJob with the following parameters and syntax RebootJobType There are three options for rebooting the system 1 PowerCycle 2 Graceful Reboot without forced shutdown 3 Graceful reboot with forced shutdown EXAMPLE winrm invoke CreateRebootJob cimv2 root dcim DCIM_SoftwarelnstallationService CreationClassName DCIM_SoftwarelnstallationService 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 lt p CreateRebootJob_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_SoftwarelnstallationService gt lt p RebootJobType gt 2 lt p RebootJobType gt lt p CreateRebootJob_INPUT gt OUTPUT This method will return a reboot jobid that can be set to reboot the system immediately or at a later time CreateRebootJob_OUTPUT RebootJobID Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_SoftUpdateConcreteJob SelectorSet Selector InstancelD RID_001265648530 __cimnamespace root dcim ReturnValue null The jobid in the above output is the instancelD 44 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 Jobid InstancelD RID_001265648530
218. od in the class DCIM_LCService Backup feature gathers system information firmware images hardware configuration Lifecycle Controller iDRAC firmware and configuration and stores the information in a file You can save the file on either iDRAC vFlash SD card or network share IP ADDRESS This is the IP address of the file server DRIVESHARE This is the directory path for the image USERNAME This is the username to the file share PASSWORD This is the password to the file share IMAGENAME This is the desired name of the image PASSPHRASE This can be used to password protect NFS and CIFS images For NFS and CIFS shares the entire Passphrase PASSPHRASE argument is optional Note To restore this backup file the same passphrase must passed as an argument for the operation to be successful The following examples back up the server profile and execute it immediately using the TIME_NOW parameter 18 1 1 Exporting Server Profile to iDRAC vFlash Card BackupImage iDRAC vFlash Card ShareType is 4 EXAMPLE winrm i BackupImage http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPADDRESS 443 wsman SkipCNCheck SkipCACheck encoding utf 8 a basic IPAddress IP ADDRESS ShareType 4 ScheduledStartT
219. of the C M_Account class instance The invoke operation requires 31 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 an instance reference The instance reference may be retrieved by adding EnumerateEPR mode to enumerate or get of the class Profiles http www dmif org sites default files standards documents DSP1034 1 0 1 pdf http www dmif org sites default files standards documents DSP1039 1 0 0 pdf Replace DCIM User 16 with the applicable user name and 2 with the desired request state Invoke RequestStateChange with the following parameters and syntax EXAMPLE winrm invoke RequestStateChange http schemas dmtf org wbem wscim 1 cim schema 2 DCIM_Account 2 cimnamespace root dcim CreationClassName DCIM_Account Name iDRAC Embedded 1 Users 16 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNcheck SkipCAcheck encoding utf 8 a basic RequestedState 2 skiprevocationcheck OUTPUT 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 t
220. ollerKey_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p RemoveControllerKey_INPUT gt OUTPUT This method requires an H700 or H800 controller to function correctly If the EnableControllerEncryption method does not set the key the following message is displayed RemoveControllerKey_OUTPUT Message Controller Key is not present MessagelD STORO21 ReturnValue 2 16 18 Managing Virtual Disk 16 18 1 Getting the Available RAID levels GetRAIDLevels The GetRAIDLevels method is used to determine possible choices RAID levels to create virtual disks If the list of physical disks is not provided this method will operate on all connected disks Invoke GetRAIDLevels 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 PhysicalDisk View Section 16 9 Include all types 0 Include Magnetic Only 1 Include SSD only 2 Diskprotocol Types of protocol to include 166 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Include all protocols 0 Include SATA 1 Include SAStypes 2 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
221. olumeLabel gt label1 lt p O0SVolumeLabel gt lt p CreatePartition_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned CreatePartition OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD 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 MessagelD VFO15 ReturnValue 2 112 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 13 5 Create Partition using Image This method creates a partition on the storage device using the image provided by the user The partition size will be the same as the size of the image The maximum size of the image is 4GB The image can be located on a NFS CIFS share or on a TFTP server When this method is successfully executed an instance of DCIM_OpaqueManagementData representing the desired partition will be created Section 13 1 and a reference to this instance is captured in the output parameter Job Invoke CreatePartitionUsinglmage with the following parameters and syntax PartitionIndex The PartitionIndex property of the DCIM_OpaqueManagementDaita instance th
222. on computer 10 35 0 232 443 has the following errors The SSL certificate could not be checked for revocation The server used to check for revocation might be unreachable Refer to the WinRM documentation and related documentation for directions on setting up encryption certificates for WinRM and executing WinRM invocations using full security capabilities Refer to the Lifecycle Controller User Guide for directions on configuring different encryption certificates for the iDRAC Web server Dell recommends that the full security and encryption capabilities of the WS Management protocol is used for production level utilization of the Lifecycle Controller Web services interfaces 3 2 2 Handling invalid responses from WSMAN commands e Check the network connection to make sure that the system is connected e Check the WSMAN syntax to ensure there are no typos in the command line e Check if there are other WSMAN commands sending from other systems e Wait for a few seconds and re try the WSMAN command Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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
223. ontroller A base64 encoded string containing the certificate authentication CA content is required as the input Invoke DownloadServerPublicKey with the following parameters and syntax EXAMPLE winrm i DownloadServerPublicKey http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService CreationClassName DCIM_LCService Name DCIM LCService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic file DownloadServerPublicKey xml 95 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 The input file DownloadServerPublicKey xml is shown below lt p DownloadServerPublickey_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p KeyContent gt sense BEGIN CERTIFICATE MIIEQ CCA6ugAwIBAgIBADANBgkqhkiG9w0BAQQFADCBzTELMAkGA1UEBhMCVVMx CZAJBgNVBAgTALRYMRQWEgYDVQQHEWtNYWlulFNOcmVIdDEVMBMGA1UEChMMSm9l qvoMCKtoqLnGBByj H2vyN7Fe ZMKXD5pO6XwY ddGfA66w3HGUaRO fIKD40NDi9 bKFEMxbRxZysUUzuUKZ9c RAIZUiLrqzemfX3fn1 Yp7kO5KU9VHY soo END CERTIFICATE lt p KeyContent gt lt p DownloadServerPublicKey_INPUT gt 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 DownloadServerPu
224. ost 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 object path object path returned from Section 11 1 profile conformance b Method name UnpackAndAttach c OSName Has to be a valid value from the list returned by GetDriverPackInfo d ExposureStartTime for this release the value is NULL e ExposureDuration a string formatted as an interval in CIM_DateTime format This parameter denotes the interval of time after which the partition containing OS drivers with label OEMDRV is to be detached from the Host OS 2 Invoke method shall return the following output parameters a Job object path to CIM_ConcreteJob reports the status of unpack and attach b Enumerating this instance of CIM_ConcreteJob will show the status of the current operation Invoke UnpackAndAttach with the following syntax EXAMPLE winrm i UnpackAndAttach cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem u USER p PASSWORD r https IPADDRESS wsman 443 encoding utf 8 a basic OSName OSName ExposeDuration 00000000002200 000000 000 Above example
225. otString Hard drive C BootSeq BootString Hard drive C BootSeq CurrentAssignedSequence 1 CurrentEnabledStatus 1 ElementName Hard drive C BootSeq FailThroughSupported 1 InstancelD IPL HardDisk List 1 1 c9203080df84781e2ca3d512883dee6f PendingAssignedSequence 1 PendingEnabledStatus 1 InstancelD field as input 14 4 Changing the Boot Order by InstancelD ChangeBootOrderBylnstancelD The ChangeBootOrderBylnstancelD method is called to change the boot order of boot sources within a configuration The method s input parameter source is an ordered array of InstancelDs of BootSourceSetting instances 123 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 The CurrentAssignedSequence attribute of each instance from Section 14 3 defines the instance s place in the zero based indexed boot sequence Note In order for the changes to be applied the CreateTargetedConfigJob method in Section 17 7 must be executed Invoke ChangeBootOrderBylnstancelD with the following parameters and syntax INSTANCE ID Obtained from the BootSourceSetting Class enumeration this example uses the field PL source Reference to the nstancelD attribute from Section 14 3 EXAMPLE winrm i ChangeBootOrderBylnstancelD http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BootConfigSetting InstancelD INSTANCE ID u USER p PASSWORD The source input is obtained from
226. p JobArray gt 65 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p StartTimelnterval gt TIME_NOW lt p StartTimelnterval gt lt p UntilTime gt 20100730121500 lt p UntilTime gt lt p SetupJobQueue_INPUT gt Here the JobArray element shows a list of Jobids that are to be scheduled to run TIME_NOW is a special value that represents running the tasks immediately The UntilTime value specifies the maintenance windows Once a task is not run after passing UntilTime it should not be run again Upon successfully invocation of the SetupJobQueue method the aforementioned times will be listed when enumerated in Section 10 2 3 OUTPUT Returns 0 for success or non zero for error with messagelD and message description SetupJobQueue_OUTPUT ReturnValue null Entering an invalid jobid or XML syntax error can yield one of the following error messages SetupJobQueue_OUTPUT Message Job Cannot be Scheduled MessagelD SUP016 ReturnValue null SetupJobQueue_OUTPUT Message Duplicated Invalid JOBID Entries MessagelD SUPO23 ReturnValue null 10 2 2 Delete Job Queue The DeleteJobQueue method takes in a job D 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 thi
227. p Target gt Disk Bay 3 Enclosure Internal 0 0 RAID Integrated 1 1 lt p Target gt lt p VirtualDiskArray gt Disk Virtual 0 RAID Integrated 1 1 lt p VirtualDiskArray gt lt p AssignSpare_INPUT gt OUTPUT AssignSpare_OUTPUT RebootRequired YES ReturnValue 0 Nonconformance to the following restrictions may result in the error message below e Virtual disk VD referenced dedicated hot spare is RAID 0 which cannot have hot spares e Physical disk PD is too small for the virtual disk referenced dedicated hot spare e Physical disk is wrong type for the virtual disk i e SATA PD to be used as hot spare for SAS VD e Similar conditions when no VD referenced which is the global hot spare attempted assignment ERROR MESSAGE AssignSpare_OUTPUT Message Physical disk FQDD did not identify a valid physical disk for the operation MessagelD STOROO9 ReturnValue 2 160 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 Invoke UnassignSpare with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_PhysicalDiskView Error Reference source not found EXAMP
228. password and other site specific information Actual use of these examples would require using values for IP Address username and password etc that are valid These values are represented in the examples as follows Target iDRAC IP address IPADDRESS iDRAC Username USER iDRAC Password PASSWORD Additional substitute values are used in some of the examples and are described in the specific example Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 The following example is typical of the formatting used in this document 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 amp Time Parameters 3 2 1 Encryption Certificate Security For the WinRM examples provided in this document the strict checks of certificates such as matching of CNs Common Names and verification with the actual CA Certificate Authority of the certificate of the WS Management protocol HTTPS encryption certificate is assumed to be already configured and enabled To disable the strict certificate checking add the following command line options to all WinRM examples skipCACheck and skipCNCHeck Additionally the following error may result if the end point does not support this feature Use the switch skiprevocationcheck to bypass this error WSManFault Message The server certificate on the destinati
229. property of the specified NiCAttribute Possible choices are attained from PossibleValues field such as Possible values Disabled Enabled EXAMPLE winrm i SetAttributes http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_NICService SystemName DCIM ComputerSystem Name DCIM NICService u USER p PASSWORD 143 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 xml is shown below lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Integrated 1 1 1 lt p Target gt lt p AttributeName gt ConnectFirstFCoETarget lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt FirstFCoEWWPNTarget lt p AttributeName gt lt p AttributeValue gt 20 00 00 10 18 88 C0 03 lt p AttributeValue gt lt p AttributeName gt FirstF CoEBootTargetLUN lt p AttributeName gt lt p AttributeValue gt 33 lt p AttributeValue gt lt p AttributeName gt FirstF COEFCFVLANID lt p AttributeName gt lt p AttributeValue gt 34 lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPU
230. r 2 Web Services Interface Guide for Windows Version 2 1 0 RebootRequired Yes ReturnValue 0 SetResult Set PendingValue 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 N iCAttribute If this value is valid it will be applied to the PendingValue property or the Currentvalue property of the specified NiCAttribute Possible choices are attained from PossibleValues field EXAMPLE winrm i SetAttributes http schemas dmtf org wbem wscim 1 cim schema 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 SetAttributes_NIC xml The input file SetAttributes_NIC xml is shown below lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Embedded 1 1 lt p Target gt lt p AttributeName gt LegacyBootProto lt p AttributeName gt lt p AttributeValue gt PXE lt p AttributeValue gt lt p AttributeName gt LnkSpeed lt p Attribute
231. r https IPADDRESS wsman 443 encoding utf 8 a basic OUTPUT BootToHD_OUTPUT ReturnValue 0 11 3 22 Configurarable Boot to Network ISO This method was added during the LC2 Version 1 1 release The ConfigurableBootToNetworkISO works similar to BootToNetworkISO except that the immediate boot to the ISO is not automatic and controlled by an input parameter called ResetType which will enable you to do a warm reset or cold reset or no immediate reset Invoke ConfigurableBootToNetworklSO via NFS share with the following syntax NFS_IPADDRESS This is the IP address of the location of the ISO image NFS OSISO This is the directory path to the ISO image NFS_Username This is the username to the IP address of the ISO image NFS_Password This is the corresponding password to the username containing the ISO image OS ISO This is to be replaced by the actual name of the ISO image RESET_TYPE O No reset 1 warm reset 2 cold reset EXAMPLE winrm i ConfigurableBootToNetworkISO cimv2 root dcim DCIM_OSDeploymentService CreationClassName DCIM_OSDeploymentService Name DCIM 0SDeploymentService SystemCreationClassName DCIM_ComputerSystem SystemName DCIM ComputerSystem 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 86
232. red YES ReturnValue 0 16 18 5 Creating a Sliced Virtual Disk CreateVirtualDisk The CreateVirtualDisk method is used to create a sliced virtual disk A sliced virtual disk is created if CreateVirtualDisk Size input parameter value is less than total size of the physical disks Additional sliced virtual disk can be created using the same set of physical disks and same RAID level that was used to create the first sliced virtual disk If the physical disks have sliced virtual disks then use the CheckVDValues method on that set of physical disks to find the exact value for StartingLBA Use this value as the StartingLBA parameter value of the CreateVirtualDisk method The ObjectStatus property in the virtual disk view see Section 16 10 has the value 3 which represents a pending change The virtual disk is not created until a configuration job see Section 16 14 is scheduled and the system is rebooted After the virtual disk creation the FQDD of the pending virtual disk changes Invoke the CreateVirtualDisk method with the following parameters and syntax TARGET This parameter is the FQDD of the DCIM_ControllerView Section 16 7 PDArray This parameter is the list of physical disk FQDDs that is used to create a virtual Disk VDPropNameArray This parameter is the list of property names that is used to create a virtual disk The parameter list has the following names 173 Dell Lifecycle Controller 2 Web Services
233. ributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt Users 4 Password lt p AttributeName gt lt p AttributeValue gt PASSWORDHERE lt p AttributeValue gt lt p ApplyAttributes_INPUT gt 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 com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001296744532 __ cimnamespace root dcim ReturnValue 4096 The following error may result if the password has not initially been set to a value The password may be set an initail value at the same time as the account is enabled by adding the Users 4 Password attribute name and corresponding attribute value as shown above ApplyAttributes_OUTPUT Message The User Password is not configured so cannot Enable the User or set values for IPMILan IPMISerial or User Admin Privilege MessageArguments NULL MessagelD RACO23 ReturnValue 2 22 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 5 3 4 Modify User Privilege using iDRAC Attributes When the account setting capability allows the user privileges may be enabled or disabled by invoking the method ApplyAttributes method on the Enable property Confirmation of the change can be obtained by enumerating the DC M_iDRA
234. rned 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 224 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001269609760 __cimnamespace root dcim ReturnValue 4096 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 After the configuration job is created the pending changes can only be canceled by calling DeleteJobQueue in the Job Control profile Invoke CreateTargetedConfigJob with the following parameters and syntax Target This parameter is the FQDD of the instances EXAMPLE winrm i DeletePendingConfiguration http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_FCService SystemName DCIM ComputerSystem Name DCIM FCServi
235. rrentValue Administrator DefaultValue NoAccess Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName Users GroupID Users 3 InstancelD iDRAC Embedded 1 Users 3 lpmiLanPrivilege IsReadOnly false PossibleValues User Operator Administrator NoAccess 19 2 Getting an iDRAC Card Enumeration Instance Use the following example to get an instance of the DC M_iDRACCardEnumeration class instead of all the instances as shown in Section 19 1 Get an iDRACCardEnumeration instance with the following parameters and syntax INSTANCEID This is obtained from the enumeration in Section 19 1 which shows an example using iDRAC Embedded 1 NIC 1 Enable as an instancelD 201 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE winrm g http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardEnumeration InstancelD INSTANCE ID 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 InstancelD iDRAC Embedded 1 NIC 1 Enable IsReadOnly false PossibleValues Disabled Enabled 19 3 Listing the iDRAC Card Inventory Enumeration Class using groupID En
236. ry NICCapabilities Class Enumerate the DCIM_NICCapabilities class with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICCapabilities u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_NICCapabilities BPESupport 3 CongestionNotification 3 DCBExchangeProtocol 3 ETS 3 EVBModesSupport 3 EnergyEfficientEthernet 2 FCoEBootSupport 3 FCoEMaxlOsPerSession 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 InstancelD NIC Integrated 1 1 1 MACSecSupport 3 NWManagementPassThrough 2 NicPartitioningSupport 3 OSBMCManagementPassThrough 2 OnChipThermalSensor 2 OpenFlowSupport 3 PXEBootSupport 2 PartitionWOLSupport 3 PriorityFlowControl 3 RDMASupport 3 RXFlowControl 3 132 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 RemotePHY 3 TCPChimneySupport 3 TXBandwidthControlMaximum 3 TXBandwidthControlMinimum 3 TXFlowControl 3 VEBVEPAMultiChannel 3 VEBVEPASingleChannel 3 VFSRIOVSupport 3 VirtualLinkControl 3 WOLSupport 2 iSCSIBootSupport 2 iSCSIOffloadSupport 3 uEFISupport
237. s http www delltechcenter com page DCIM Library Profile 23 1 Listing the FC Inventory Attribute Class The FC Inventory contains the following attributes DCIM_FClAttribute 23 1 DCIM_FCStatistics 23 2 DCIM_FCString 23 3 DCIM_FCinteger 23 4 and DCIM_FCEnumeration 23 5 Enumerate FCAttribute class ith the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCAttribute 219 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 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 InstancelD FC Slot 3 1 DeviceName IsReadOnly true MaxLength 32 MinLength 0 PendingValue ValueExpression DCIM_FCinteger AttributeDisplayName AttributeName LinkDownTimeout CurrentValue 30000 Dependency FQDD FC Slot 3 2 InstancelD 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 org wbem wscim 1 cim schema 2 root dcim DCIM_FCStatistics u USER p PASSWORD
238. s status Invoke CreateTargetedConfigJob with the following parameters and syntax TARGET This Parameter is the FQDD of the instances obtained from the nstancelD field 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 User should not enter 0 or give no parameter at all in the input xml EXAMPLE winrm i CreateTargetedConfigJob http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_FCService SystemName DCIM ComputerSystem Name DCIM FCService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file apply_pending_fc xml The input file apply_pending_fc xml is shown below lt p CreateTargetedConfigJob_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_FCService gt lt p Target gt FC Slot 2 2 lt p Target gt lt p RebootJobType gt 2 lt p RebootJobType gt lt p ScheduledStartTime gt TIME_NOW lt p ScheduledStartTime gt lt p UntilTime gt 20151111111111 lt p UntilTime gt lt p CreateTargetedConfigJob_INPUT gt OUTPUT When this method is executed a jobid or an error message is retu
239. s also included but it is a write only property Profiles http www dmif org sites default files standards documents DSP1034 1 0 1 pdf http www dmif 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 23 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 EXAMPLE A 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 OUTPUT A DCIM_Account CreationClassName DCIM_Account ElementName DCIM Account EnabledDefault 2 EnabledState 3 Name iDRAC Embedded 1 Users 1 OrganizationName DCIM RequestedState 0 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc TransitioningToState 12 UserID null UserPassword null DCIM_Account CreationClassName DCIM_Account ElementName DCIM Account EnabledDefault 2 EnabledState 2 Name iDRAC Embedded 1 Users 2 OrganizationName DCIM RequestedState 0 SystemCreationClassName DCIM_SPComputerSystem SystemName systemmc TransitioningToState 12 UserlD 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 encodin
240. s for GrouplD are NIC 1 IPv4 1 Users 3 OUTPUT DCIM_iDRACCardString AttributeDisplayName DNS RAC Name AttributeName DNSRacName CurrentValue IDRAC DefaultValue Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName NIC GroupID NIC 1 InstancelD iDRAC Embedded 1 NIC 1 DNSRacName IsReadOnly false MaxLength 63 MinLength 1 DCIM_iDRACCardString AttributeDisplayName IP Address 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 InstancelD 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 InstancelD iDRAC Embedded 1 Users 3 UserName 211 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 IsReadOnly false MaxLength 16 MinLength 1 19 9 Changing the iDRAC IPChange Notification 19 9 1 Getting the Current iDRAC IPChange State Get the PChangeNotifyPS attribute from the DCIM_LCAttribute class to display The CurrentValue field indicates the current status of this attribute EXAMPLE winrm get http schemas dmtf org wbem wscim 1 cim schema 2 root d
241. s process to complete Invoke DeleteJobQueue with the following parameters and syntax JobID The jobID of a particular job instance to be deleted from a jobqueue EXAMPLE 1 winrm invoke DeleteJobQueue cimv2 root dcim DCIM_JobService CreationClassName DCIM_JobService Name JobService SystemName ldrac SystemCreationClassName DCIM_ComputerSystem JobID jobID u USER p PASSWORD 66 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 r https IPADDRESS wsman 443 auth basic encoding utf 8 The example below uses JID_CLEARALL for the job ID which is a predefined value that represents deleting all jobs in the jobstore EXAMPLE 2 winrm invoke DeleteJobQueue cimv2 root dcim DCIM_JobService CreationClassName DCIM_JobService Name JobService SystemName ldrac SystemCreationClassName DCIM_ComputerSystem JobID JID_CLEARALL u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 SkipCACheck SkipCNCheck OUTPUT Return 0 for success or non zero for error with messagelD and message description DeleteJobQueue_OUTPUT Message The specified job was deleted MessagelD SUP020 ReturnValue null 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 st
242. schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BootConfigSetting u USER p PASSWORD r https IPADDRESS wsman SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_BootConfigSetting ElementName BootSeq This InstancelD can be used as input for a InstancelD IPL get operation as shown in Section 14 2 IsCurrent 1 IsDefault 0 IsNext 1 DCIM_BootConfigSetting ElementName HddSeq 121 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 InstancelD BCV IsCurrent 2 IsDefault 0 IsNext 2 DCIM_BootConfigSetting ElementName UefiBootSeq InstancelD UEFI IsCurrent 2 IsDefault 0 IsNext 2 DCIM_BootConfigSetting ElementName OneTimeBootMode InstancelD OneTime IsCurrent 2 IsDefault 0 IsNext 2 DCIM_BootConfigSetting ElementName vFlash Boot Configuration InstancelD vFlash IsCurrent 2 IsDefault 0 IsNext 2 14 2 Getting a Boot ConfigSetting Instance Getting the boot configuration current default and next attributes of one particular boot configuration instance is an alternative to enumerating all available instances as shown in Section 14 1 Get a BootConfigSetting instance with the following parameters and syntax INSTANCEID This is obtained from the enumeration in Section 14 1 in which this example would use IPL as an instancelD EXAMPLE winrm g http schemas dmtf org wbem wscim 1 cim s
243. sure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p PDArray gt Disk Bay 1 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p VDPropNameArray gt RAIDLevel lt p VDPropNameArray gt lt p VDPropNameArray gt SpanDepth lt p VDPropNameArray gt 172 Version 2 1 0 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p VDPropNameArray gt SpanLensth lt p VDPropNameArray gt lt p VDPropNameArray gt Size lt p VDPropNameArray gt lt p VDPropNameArray gt VirtualDiskName lt p VDPropNameArray gt lt p VDPropValueArray gt 4 lt p VDPropValueArray gt lt p VDPropValueArray gt 1 lt p VDPropValueArray gt lt p VDPropValueArray gt 2 lt p VDPropValueArray gt lt p VDPropValueArray gt 100 lt p VDPropValueArray gt lt p VDPropValueArray gt virtualdiskname lt p VDPropValueArray gt lt p CreateVirtualDisk_INPUT gt OUTPUT The instancelD output will identify this virtual disk in inventory before and after its creation by the CreateTargetedConfigJob Note however that the instancelD will change slightly after successful creation CreateVirtualDisk_OUTPUT NewVirtualDisk Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_VirtualDiskView SelectorSet Selector InstancelD DISK Virtual 267386880 RAID Integrated 1 1 __cimnamespace root dcim RebootRequi
244. sword AttributeDisplayName System Password AttributeName SysPassword Dependency lt Dep gt lt AttrLev Op OR gt lt ROIf Name PasswordStatus gt Locked lt ROIf gt lt AttrLev gt lt Dep gt DisplayOrder 1402 FQDD BIOS Setup 1 1 GroupDisplayName System Security GroupID SysSecurity InstancelD BIOS Setup 1 1 SysPassword IsReadOnly false IsSet false MaxLength 32 MinLength 0 PasswordState 3 PendingValue null ValueExpression 0 9a z 0 323 DCIM_BIOSPassword AttributeDisplayName Setup Password AttributeName SetupPassword Dependency null DisplayOrder 1403 FQDD BIOS Setup 1 1 GroupDisplayName System Security GroupID SysSecurity InstancelD BIOS Setup 1 1 SetupPassword IsReadOnly false IsSet false MaxLength 32 MinLength 0 PasswordState 3 PendingValue null ValueExpression 0 9a z 0 323 18 Exporting and Importing Server Profile Version 2 1 0 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 193 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 http www delltechcenter com page DCIM Library Profile 18 1 Exporting Server Profile To backup host system server profile invoke the BackupImage meth
245. t lt p PDArray gt Disk Bay 0 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p PDArray gt Disk Bay 1 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p PDArray gt Disk Bay 2 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt lt p PDArray gt Disk Bay 3 Enclosure Internal 0 0 RAID Integrated 1 1 lt p PDArray gt 169 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p VDPropNameArrayIn gt Size lt p VDPropNameArrayIn gt lt p VDPropValueArrayIn gt 10000 lt p VDPropValueArrayln gt lt p VDPropNameArrayIn gt RAIDLevel lt p VDPropNameArrayln gt lt p VDPropValueArrayIn gt 2048 lt p VDPropValueArraylIn gt lt p VDPropNameArrayIn gt SpanDepth lt p VDPropNameArrayIn gt lt p VDPropValueArrayIn gt 1 lt p VDPropValueArraylIn gt lt p CheckVDValues_INPUT gt OUTPUT CheckVDValues_OUTPUT RebootRequired YES ReturnValue 0 VDPropNameArray SizelnBytes RAIDLevel SpanDepth SpanLength StripeSize ReadPolicy WritePolicy DiskCachePolicy Name VDPropValueArray 10485760000 2048 2 2 128 16 2 1024 Unknown If the arrangement of physical disks prohibits a valid virtual disk arrangement from being created such as having too few hard disks the following error may result CheckVDValues_OUTPUT Message Virtual Disk provided is not valid for the operation MessagelD STORO17 ReturnValue 2 16 18 4 Creating a Single Virtual D
246. t p Username gt lt p Password gt password lt p Password gt lt p Port gt lt p Port gt lt p HashType gt 1 lt p HashType gt lt p HashValue gt 123 lt p HashValue gt lt p ExportDataFromPartition_INPUT gt OUTPUT 120 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 When this method is executed a jobid or an error message is returned ExportDataFromPartition_OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001271681930 __cimnamespace root dcim ReturnValue 0 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 1 Listing the Boot Inventory ConfigSetting Class The boot configuration settings are a collection of settings that are applied to the boot configurable system during the boot process The current default and next status fields of each element are available Enumerate BootConfigSetting with the following parameters and syntax EXAMPLE winrm e http
247. t BIOS Password Status cccccccccceeeceeeeeeeeeeeeeentnieeeeeeeeeteeee 192 17 10 Listing the BIOS Inventory Password ClaSS cccccceeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeteeee 192 18 Exporting and Importing Server Profile ccccccceeeeeeesseeceeeeeeeeeeeeneecaaeeeeeeeeeeeesesaaaeeeeeees 193 18 1 Exporting Server Profile ts Se sauce pdeiactancceleianecet asscncalehagedile tases teenie dette ae 194 18 1 1 Exporting Server Profile to iDRAC vFlash Card Backuplmage 265 194 18 1 2 Exporting Server Profile to NFS Share BackupIMage ceeeeeeeeeeeees 194 18 1 3 Exporting Server Profile to CIFS Share Backuplmage ccceeeeeeeeees 195 18 1 4 Monitoring Export Slat S aii techs 0se exrcedcve recta cede elert tenet tice bhtbe neers 196 18 2 Importing Server Provile ze c cece cesetecteubecved cacetecae tehaleetetags vcceeds tated eda eines 197 18 2 1 Importing Server Profile from iDRAC vFlash Card Restorelmage 197 18 2 2 Importing Server Profile from NFS share RestorelMage ccceeeeeeee 197 18 2 3 Importing Server Profile from CIFS share RestorelMage cccceeeeee 198 18 2 4 Monitoring Import Status ice nccieteecenitieeiieeidnciieabeii enka 199 19 DRAG Configuration 5 iid ceccantte Recs teen Nig ka teers cee tay decaua te cguver siaener Megs Nese dae ed 200 19 1 Listing the iDRAC Card Inventory Enumeration Class 0 cccceeeceeeeeeeeeeeeeeeeeeee 200 19 2
248. t until the next method that generates a job is invoked The job must complete before another method that generates a job can be called successfully This is unchanged from the Lifecycle Controller 1 2 for OS Deployment Invoke enumerate DCIM_OSDConcreteJob instance with the following syntax EXAMPLE winrm e cimv2 root DCIM DCIM_OSDConcreteJob u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck encoding utf 8 a basic OUTPUT The enumeration will return the instances of OSDConcreteJob as shown DCIM_OSDConcreteJob DeleteOnCompletion false InstancelD DCIM_OSDConcreteJob 1 JobName UnpackAndShare JobStatus Failed Message Installation not supported for the selected operating system MessagelD OSD10 Name UnpackAndShare 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 Invoke BootToNetworkISQ via NFS share with the following syntax NFS_IPADDRESS This is the IP address of the location of the ISO image NFS OSISO This is the directory path to the ISO image NFS_Username This is the us
249. tRequired Yes ReturnValue 0 SetResult Set PendingValue 17 4 Setting Multiple BIOS BootMode Parameters Users can find and set multiple BIOS attributes associated with a specific device using the SetAttributes method This example illustrates how to set the BiosMode and BootSeqRetry parameters Invoke SetAttributes with the following parameters from Section 17 1 and syntax TARGET Obtained from the nstancelD field AttributeName Obtained from the AttributeName field AttributeValue Obtained from the PossibleValues field EXAMPLE winrm i SetAttributes http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_BlOSService SystemName DCIM ComputerSystem Name DCIM BlOSService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file SetAttributes_BIOS xml The input file SetAttributes_BlOS xml is shown below 186 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BlOSService gt lt p Target gt BlOS Setup 1 1 lt p Target gt lt p AttributeName gt BootMode lt p AttributeName gt lt p AttributeValue gt Bios lt p AttributeValue gt lt p AttributeName gt BootSeqRetry lt p AttributeName gt lt p AttributeValue gt Disabled lt p Attri
250. tailedState Presence Detected FQDD PSU Slot 2 FirmwareVersion 00 01 31 51 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 InputVoltage 118 InstancelD PSU Slot 2 LastSystemInventoryTime 20100331101859 LastUpdateTime 20100401130929 Manufacturer Dell Model PWR SPLY 502W RDNT PartNumber 0MU791A00 PrimaryStatus 1 RedundancyStatus 2 SerialNumber CN732459700446 TotalOutputPower 502 Type 0 9 2 Fan Inventory This section describes the requirements and guidelines for implementing Dell Fan Profile The Dell Fan Profile describes platform s fans including the fan speed sensor information Each platform fan is represented by an instance of DCIM_FanvView class Profile and Associated MOFs 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 InstancelD Fan Embedded 1A LastSystemInventoryTime 20100331101859 LastUpdateTime 201004081 15623 PrimaryStatus 1 RateUnits 4 RedundancyStatus 2 UnitModifier 0 VariableSpeed true DCIM_FanView ActiveCooling true BaseUnits 19 CurrentReading 4440 FQDD Fan Embedded 2A I
251. tas phe aes 65 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 10 2 2 Delete Job Queue eeeeeteecee eee e eee eeeeeeeee eee eettaaaaaaeeeeeeeeetaaaaaaaeeeeeeeeeseeesaaaaes 66 10 2 3 List Jobs in Job Store 42 obi pened tier ohat ddan ain gsdtdandieaceietaeudnatoiiaee 67 11 Operating System Deployment sai ce cim cette aeinnsbiene nie hatientediarecne eae entend 69 11 1 OS Deployment Profile Implementation Conformance cccceeeeeeeeeetteeeeeeeeeeeeeee 69 11 2 Checking OS Deployment Service Availability cccceeeeeeee eee eeeteeenneeeeeeeeeetenee 69 11 3 OS Deployment Method Invocation Examples cccccecceeeeeeeeeeeeeeeecenneeeeeeeeeteeee 69 11 3 1 Get Driver Pack Information ic 0c cise nee artes heared ade eae 70 11 3 2 Unpack Selected Drivers and Attach to Host OS as USB Device 71 11 3 3 Detach Emulated USB Device Containing DriverS cc seeeeeeeeeeeeeeeeteees 72 11 3 4 Unpack Selected Drivers and Copy to Network Share cccceeeeceeeeeees 72 11 3 5 Check Job Status 2 enie aE EA a aateetete nesta 73 11 3 6 Boot to Network ISO 3 se cateh cai dan Hdd doses wa anne aaa nets 74 11 3 7 Detach Network ISO USB DeViICC cc eeeeeecceee cette eeeeeeeeeeeeeeeeeeeeteneeaaaaes 75 11 326 BOOP TO PXE prenete sneu alc eu sid tiara etna pe a E tata 76 11 3 9 Get Host MAC Address Information cceceeeeeeeeeeeee eee eeeeenneeeee
252. tatus 6 45 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 OtherldentifyingInfo 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 dmif org sites default files standards documents DSP1027_2 0 0 pdf EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 DCIM_CSAssociatedPowerManagementService u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT PowerState 2 On System is fully on 13 Off System is powered off DCIM_CSAssociatedPowerManagementService PowerOnTime null PowerState 2 RequestedPowerState 0 ServiceProvided 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_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
253. teConcreteJob SelectorSet Selector InstancelD JID_001265810325 __cimnamespace root dcim 41 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 ReturnValue null Missing XML parameters may yield the following error message InstallFromURI_OUTPUT Message Insufficient Method Parameters MessagelD SUPO01 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 The method returns a jobid for an instance of DCIM_SoftwareUpdateJob that can be scheduled to execute or queried for status at a later time The following is the example of the method for updating a BIOS firmware Invoke InstallFromURI with the following parameters and syntax 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 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 exe InstancelD The instancelD is the Softwareldentify instancelD that represents the firmware that is to be upd
254. tem CreationClassName DCIM_RAIDService System Name DCIM ComputerSystem Name DCIM RAIDService u USER p PASSWORD 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 lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p AttributeName gt RAIDBatteryLearnMode lt p AttributeName gt lt p AttributeValue gt Disabled lt p AttributeValue gt lt p SetAttribute_INPUT gt OUTPUT SetAttribute_OUTPUT Message The method was successful MessagelD STOROO1 RebootRequired Yes ReturnValue 0 SetResult Set Pending Value 16 19 2 Changing Multiple Values of RAID Controller Enumeration Attributes The SetAttributes method is used to set or change multiple values of RAID controller or virtual disk attributes The following example shows setting multiple virtual disk attributes To set multiple controller attributes use the FQDD of the controller for the Target and the AttributeName and AttributeValue Invoke SetAttributes with the following parameters from Section 16 1 and syntax 179 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 TARGET Obtained from the FQDD field AttributeName Obtained from the Attribut
255. the firmware to a previous version The InstancelD can have value such as DCIM PREVIOUS PCI 14E4 1639 0237 1028 e It refers to a previous firmware on a PCI device e VID Vendor ID 14E4 e DID Device ID 1639 e SSID Subsystem ID 0237 e SVID Subvendor ID 1028 e This refers to a Broadcom NetXtreme II BCM5709 network adaptor2 EXAMPLE winrm i InstallFromSoftwareldentity cimv2 root dcim DCIM_SoftwarelnstallationService CreationClassName DCIM_SoftwarelnstallationService SystemCreationClassName DCIM_ComputerSystem SystemName IDRAC ID Name SoftwareUpdate file RollInputNIC xml u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 The rollback input file RolllnputNIC xml is shown below lt p InstallFromSoftwareldentity_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_SoftwarelnstallationService gt lt p Target xmlns a http schemas xmlsoap org ws 2004 08 addressing xmlns w http schemas dmtf org wbem wsman 1 wsman xsd gt lt a Address gt http schemas xmlsoap org ws 2004 08 addressing role anonymous lt a Address gt lt a ReferenceParameters gt lt w ResourceURI gt http schemas dell com wbem wscim 1 cim schema 2 DCIM_Softwareldentity lt w ResourceURI gt lt w SelectorSet gt lt w Selector Name InstancelD gt InstancelD lt w Selector gt lt w SelectorSet gt lt a ReferenceParameters gt lt p Target gt lt p I
256. the BootSourceSetting inventory in r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file ChangeBootOrderByInstancelD xml Section 14 3 The input file ChangeBootOrderBylnstancelD xml is shown below lt p ChangeBootOrderBylnstancelD_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BootConfigSetting gt lt p source gt IPL Optical SATAEmbedded A 1 eb8aeb15796fb85f8e1447f0cfb8a68e lt p source gt lt p source gt UEFI Disk iDRACVirtual 1 2 1723 lt p source gt lt p source gt UEFI Disk iDRACVirtual 1 2 1723 lt p source gt lt p source gt UEFI Disk iDRACVirtual 1 3 1998 lt p source gt lt p source gt UEFI Disk iDRACVirtual 1 4 1821 lt p source gt lt p ChangeBootOrderBylInstancelD_INPUT gt OUTPUT ChangeBootOrderBylnstancelD_OUTPUT Message The command was successful MessagelD BOOTO01 ReturnValue 0 14 5 Enable or Disable the Boot Source ChangeBootSourceState The ChangeBootSourceState method is called to change the enabled status of BootSourceSetting instances to Disable or Enable The input parameter source is an array of InstancelD of BootSourceSetting instances Enumerating the BootSourceSetting Class in Section 14 3 displays the CurrentEnabledStatus field which provides the applicable status Note 1 In order for the changes to be applied the CreateTargetedConfigJob method in Section 17 7 must be executed Note 2 BIOS does not support
257. the RAID Inventory PhysicalDiskView Class c cccceeeeeeeeeeteeeeeeeeeeeeeee 152 16 10 Listing the RAID VirtualDiskView INVentOry 0 0 2 eee eeeeeeeeeeeneeeeeeeeeeeeeeeneeeeeeeaes 153 16 11 Listing the RAID EnclosureView Inventory 0 0 0 0 eeeeeeeeeeeeeeeenneeeeeeesaeeeeeeenaneeeeeeaes 155 16 12 Reset Configuration ResetConfig ceeeeeeecccceeeeeeeeeeeeeeeeeeeeeeeeeeeneneaeeeeeeeeeeeenees 155 16 13 Clearing the Foreign Configuration ClearForeignConfig sssssssreeeessssrrrerrereessee 156 16 14 Applying the Pending Values for RAID CreateTargetedConfigJob cccee 157 16 15 Deleting the Pending Values for RAID DeletePendingConfiguration 2 668 158 16 16 Managing Hot Spare lt 2c fea ed eet ee ede ease ice ee cee fe oe 159 16 16 1 Determining Potential Disks GetDHSDisks 0 0 0 0 eeeeeeteeeeeeeeeeeeee 159 16 16 2 Assigning the Hot Spare AssignSpare cccceeeeeeeeeeeeeeeeeteeeeeeeeeeeeeeee 159 16 16 38 Unassigning the Hot Spare UnassignSpare ccccceeceeeeeseeeeeeeeeeeeee 161 16 17 Managing Keys for Self Encrypting Drives cccccceeeeteeeeeeeeeeeeeeeeeeeeeneeeeeeeeeeteeee 161 16 17 1 Setting the Key SetControllerKey 0 0 0 ccceecceeeeeneeeeeeeeeeeeeeeetneeeeeeeeeeteeee 161 16 17 2 Locking the Virtual Disk LockVirtualDisk ccceeeeeeeeeeeeteeeeeeeeeeeeeeee 162 16 17 3 Locking the Controller with a Key EnableControllerEncryption 1
258. the setting of EnabledState for BCV devices Invoke ChangeBootSourceState with the following parameters and syntax 124 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 INSTANCE ID Obtained from the BootSourceSetting Class enumeration this example uses the field IPL source Reference to the InstancelD attribute from Section 14 3 EnabledState State of boot source element Disabled 0 Enabled 1 EXAMPLE winrm i ChangeBootSourceState http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BootConfigSetting InstancelD INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic file ChangeBootSourceState xml The input file ChangeBootSourceState xml is shown below lt p ChangeBootSourceState_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_BootConfigSetting gt lt p EnabledState gt 0 lt p EnabledState gt lt p source gt IPL Optical SATAEmbedded A 1 eb8aeb15796fb85f8e1447f0cfb8a68e lt p source gt lt p ChangeBootSourceState_INPUT gt OUTPUT ChangeBootSourceState_OUTPUT Message The command was successful MessagelD BOOTOO01 ReturnValue 0 15 NIC 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 The a
259. tificateAndPrivateKey xml is shown below lt p SetCertificateAndPrivateKey_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p Type gt server lt p Type gt lt p PKCS12 gt MIIPUQIBAzCCDxcGCSqGSIb3DQEHAaCCDwgEgg8EMIIPADCCBTcGCSqGSIb3DQEH BqCCBSgwggUkAgEAMIIFHQYJKoZIlhvcNAQcBMBwGCiqGSIb3DQEMAQYwDgQlySf0 CSqGSIb3DQEJFTEWBBQQycEruoYBo9ayA3csqSZ06x70NTAXMCEWCQY FKw4DAhoF AAQU yOo0D76JK1t4yzDgnOE562Cv9AQECM9NIXYFEgiLAgIIAA 99 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p PKCS12 gt lt p PKCS12pin gt 1234567 lt p PKCS12pin gt lt p SetCertificateAndPrivateKey_INPUT gt OUTPUT SetCertificateAndPrivateKey_OUTPUT Message Server certificate successfully modified iDRAC will now reset and be unavailable for a few minutes MessagelD 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 Invoke DeleteAutoDiscoveryServerPublicKey with the following parameters and syntax EXAMPLE winrm i DeleteAutoDiscoveryServerPublicKey cimv2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService u USER p PASSWORD r https IPADDRESS wsman encoding utf 8 a basic SkipCACheck SkipCNCheck OUTPUT DeleteAu
260. to apply the pending values created using the SetAttribute and SetAttributes methods The system automatically reboots depending on the ScheduledStartTime selected Use the CreateTargetedConfigJob job D output to get the status see Section 10 0 Invoke CreateTargetedConfigJob with the following parameters and syntax Target This parameter is the FQDD which is found by enumerating the CNA attributes in Section 15 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 while creating a target job users should comment out the RebootJobType in the input xml User should not enter 0 or give no parameter in the input xml ScheduledStartTime amp UntilTime See Section 3 2 4 EXAMPLE winrm i CreateTargetedConfigJob http schemas dmtf org wbem wscim 1 cim schema 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 CreateTargetedConfigJob_CNA xml The input file CreateTargetedConfigJob_CNA xml is shown below lt p CreateTargetedConfigJob_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt
261. to get instances in groups of up to 50 winrm set winrm config MaxBatchltems 50 Additionally increasing the allotted maximum envelope size and timeout can also increase performance winrm set winrm config MaxEnvelopeSizekb 150 winrm set winrm config MaxTimeoutms 60000 Other optional WinRM configuration commands are listed below for convenience To get the current WinRM configuration settings execute the following command winrm g winrm config By default the client computer requires encrypted network traffic To allow the client computer to request unencrypted traffic execute the following command winrm s winrm config Client f AllowUnencrypted true TrustedHosts is an array that specifies the list of remote computers that are trusted Other computers in a workgroup or computers in a different domain should be added to this list Note The computers in the TrustedHosts list are not authenticated Execute the following command to allow all computers to be included in TrustedHosts winrm s winrm config Client TrustedHosts Basic authentication is a scheme in which the user name and password are sent in clear text to the server or proxy This method is the least secure method of authentication The default is True Execute the following command to set client computer to use Basic authentication winrm s winrm config Client Auth Basic true 3 2 4 Specifying StartTime Until Time and TIME_NOW Parameters T
262. toDiscoveryServerPublickKey_OUTPUT ReturnValue 0 12 12 Insert Comment in Lifecycle Controller Log This method is used to insert additional user comments into the Lifecycle Controller log Invoke InsertCommentInLCLog with the following parameters and syntax Comment Replace INSERT COMMENT HERE with desired comment in this location EXAMPLE winrm i InsertCommentinLCLog http schemas dmtf org wbem wscim 1 cim schema 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 100 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 encoding utf 8 a basic file InsertCommentInLCLog xml The input file InsertCommentinLCLog xml is shown below lt p InsertCommentInLCLog_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p Comment gt INSERT COMMENT HERE lt p Comment gt lt p InsertCommentinLCLog_INPUT gt OUTPUT InsertCommentInLCLog_OUTPUT ReturnValue 0 12 13 Export Lifecycle Controller Log This method is used to export the log from the Lifecycle Controller after processing jobs Invoke ExportLCLog 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
263. toryTime 20100331101859 LastUpdateTime 19700101000000 Model Enterprise PermanentMACAddress 0 21 9b 92 70 5f ProductDescription This system component provides a complete set of remote management functions for Dell PowerEdge server 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 Profile Enumerate DCIM_PCIDeviceView with the following parameters and syntax EXAMPLE winrm e cimv2 root dcim DCIM_PCIDeviceView u USER p PASSWORD r https IPADDRESS wsman 443 auth basic encoding utf 8 SkipCACheck SkipCNCheck OUTPUT DCIM_PCIDeviceView BusNumber 0 DataBusWidth 0002 Description 828011 ICH9 Family USB UHCI Controller 4 DeviceNumber 26 FQDD USBUHCI Embedded 4 1 FunctionNumber 0 InstancelD USBUHCI Embedded 4 1 LastSystemInventoryTime 20100331101859 LastUpdateTime 20100325134947 Manufacturer Intel Corporation PCIDevicelD 2937 PCISubDevicelD 0236 PCISubVendorID 1028 56 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 PClVendorID 8086 SlotLength 0002 SlotType 0002 DCIM_PCIDeviceView BusNumber 0 DataBusW
264. tributes method with the following parameters and syntax EXAMPLE winrm i ApplyAttributes http schemas dmtf org wbem wscim 1 cim schema 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 DRACService_SetAttribute_group_enumerate xml The input file DRACService_SetAttribute_group_enumerate xml is shown below lt p ApplyAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardService gt lt p Target gt iDRAC Embedded 1 lt p Target gt lt p AttributeName gt NIC 1 Enable lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt NIC 1 Selection lt p AttributeName gt lt p AttributeValue gt Dedicated lt p AttributeValue gt lt p AttributeName gt NIC 1 Speed lt p AttributeName gt lt p AttributeValue gt 100 lt p AttributeValue gt lt p AttributeName gt NIC 1 Autoneg lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName gt NIC 1 Duplex lt p AttributeName gt lt p AttributeValue gt Full lt p AttributeValue gt lt p AttributeName gt NIC 1 DNSRegister lt p AttributeName gt lt p AttributeValue gt Enabled lt p AttributeValue gt lt p AttributeName
265. ttributes in a system Enumerate the DC M_RA DEnumeration class with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDEnumeration u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_RAIDEnumeration AttributeName RAIDSupportedDiskProt CurrentValue SAS SATA FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDSupportedDiskProt IsReadOnly true PendingValue The get instance method in PossibleValues SAS SATA section 16 2 uses this InstancelD as input DCIM_RAIDEnumeration AttributeName RAIDloadBalancedMode CurrentValue Automatic FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDloadBalancedMode IsReadOnly false PendingValue PossibleValues Automatic Disabled The set attribute method in section 16 19 1 uses the FQDD DCIM_RAIDEnumeration AttributeName and PossibleValues AttributeName RAIDBatteryLearnMode CurrentValue Automatic FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDBatteryLearnMode IsReadOnly false PendingValue PossibleValues Automatic Warn only Disabled fields as input The set attributes method in section 145 16 19 2 uses the FQDD DCIM_RAIDEnumeration AttributeName RAIDdefaultWritePolicy AttributeName and PossibleValues fields as input Dell Lifecycl
266. ttributes include functionalities for the following e Partition and personality CNA only e iSCSI boot and PXE boot that are part of the NIC CNA firmware The ability to configure CNAs has been added to the NIC profile that extends the management capabilities of the referencing profiles The NICs CNAs are modeled as views with collections of attributes where there is a view for each partition on the controller The NIC CNA Inventory has these classes and views 1 DCIM_NICEnumeration see Section 15 1 2 DCIM_NICString see Section 15 2 125 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 DCIM_NICInteger see Section 15 3 DCIM_NICView see Section 15 4 DCIM_NICCapabilities see Section 15 5 an wo KR WwW DCIM_NICStatistics see Section 15 6 Profile and Associated MOFS http www delltechcenter com page DCIM Library Profile 15 1 Listing the NIC CNA Inventory Enumeration Class Enumerate the N iCEnumeration class with the following parameters and syntax EXAMPLE CNA winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICEnumeration u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT CNA For SAMPLE PORT 1 PARTITION 1 all attributes on all partitions are enumerated DCIM_NICEnumeration AttributeDisplayName TCP IP Parameters via DHCP AttributeName TcpIlpViaDHCP CurrentValue Enabled
267. ue 16 19 4 Changing Multiple Values of RAID Controller Integer Attributes The SetAttributes method is used to set or change multiple values of RAID controller attributes The following example shows setting multiple RAID controller integer attributes Invoke SetAttributes with the following parameters from Section 16 1 and syntax TARGET Obtained from the FQDD field AttributeName Obtained from the AttributeName field AttributeValue Obtained from the PossibleValues field EXAMPLE winrm i SetAttributes cimv2 root dcim DCIM_RAIDSe rvice SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_RAIDService 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 181 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_RAIDService gt lt p Target gt RAID Integrated 1 1 lt p Target gt lt p AttributeName gt RAIDccRate lt p AttributeName gt lt p AttributeValue gt 60 lt p AttributeValue gt lt p AttributeName gt RAIDreconstructRate lt p AttributeName gt lt p AttributeValue gt 60 lt p AttributeValue gt lt p AttributeName gt RAIDbgiRate lt p AttributeName gt lt p
268. umerate RA DInteger with the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim 146 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 schema 2 root dcim DCIM_RAIDInteger u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACheck encoding utf 8 a basic OUTPUT DCIM_RAIDInteger AttributeName RAIDmaxPDsInSpan CurrentValue 32 FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAlIDmaxPDsInSpan IsReadOnly true LowerBound 0 PendingValue UpperBound 0 DCIM_RAIDInteger AttributeName RAIDmaxSpansInVD CurrentValue 8 FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAlDmaxSpansInVD IsReadOnly true LowerBound 0 PendingValue UpperBound 0 The get instance method in Section 16 4 used this DCIM_RAIDInteger InstancelD as input AttributeName RAIDrebuildRate CurrentValue 30 FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDrebuildRate IsReadOnly false LowerBound 1 PendingValue The set attribute method in Section 16 19 3 uses the FQDD PPPE EES AttributeName and a value equal to DCIM_RAIDInteger or between the LowerBound and AttributeName RAIDccRate UpperBound fields as input CurrentValue 30 FQDD RAID Integrated 1 1 InstancelD RAID Integrated 1 1 RAIDccRate IsReadOnly false LowerBound 1 PendingValue UpperBound 10
269. umerate the DCIM_iDRACCardEnumeration class to list all the enumerate type iDRAC attributes using the group IDs of these groups NIC VirtualMedia IPv4 and Users To retrieve the attributes of the groups set the GroupID to one of the following NIC VirtualMedia IPv4 or Users Enumerate the iDRACCardEnumeration class using the following parameters and syntax EXAMPLE winrm e http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardEnumeration 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_iDRACCardEnumeration WHERE GroupID NIC 1 The possible inputs for GroupID are NIC 1 202 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows 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 InstancelD iDRAC Embedded 1 NIC 1 Enable IsReadOnly false PossibleValues Disabled Enabled DCIM_iDRACCardEnumeration AttributeDisplayName Virtual Media Attached AttributeName Attached CurrentValue Attached DefaultValue Detached Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName VirtualMedia Group
270. utf 8 a basic file AttachPartition xml The input file AttachPartition xml is shown below lt p AttachPartition_INPUT xmlns p http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService gt lt p PartitionIndex gt 12 lt p PartitionIndex gt lt p AttachPartition_INPUT gt OUTPUT When this method is executed a jobid or an error message is returned AttachPartition OUTPUT Job Address http schemas xmlsoap org ws 2004 08 addressing role anonymous ReferenceParameters ResourceURI http schemas dell com wbem wscim 1 cim schema 2 DCIM_LifecycleJob SelectorSet Selector InstancelD JID_001270737179 __cimnamespace root dcim ReturnValue 0 13 10 Detach Partition This method is for defining the set of partitions to be removed as USB endpoints from the managed system Invoke DetachPartition with the following parameters and syntax PartitionIndex The Partitionindex property of the DCIM_OpaqueManagementData instance that represents the partition to be detached 1to 16 EXAMPLE 118 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 winrm i DetachPartition http schemas dell com wbem wscim 1 cim schema 2 DCIM_PersistentStorageService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_PersistentStorageService SystemName DCIM ComputerSystem Name DCIM PersistentStorageService u USER p PASSWORD r https IPADDRE
271. verrides it Running a get on the attribute remotely displays a different current value 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 N iCAttribute If this value is valid it will be applied to the PendingValue property or the Currentvalue property of the specified NiCAttribute Possible choices are attained from PossibleValues field such as Possible values PXE iSCSI NONE EXAMPLE winrm i SetAttribute http schemas dmtf org wbem wscim 1 cim schema 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 lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_NICService gt lt p Target gt NIC Embedded 1 1 lt p Target gt lt p AttributeName gt LegacyBootProto lt p AttributeName gt lt p AttributeValue gt PXE lt p AttributeValue gt lt p SetAttributes_INPUT gt OUTPUT SetAttribute_OUTPUT Message The command was successful MessagelD NIC001 140 Dell Lifecycle Controlle
272. wnTimeout 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 226 Version 2 1 0
273. y CurrentValue 1 DefaultValue 0 Dependency null DisplayOrder 0 FQDD iDRAC Embedded 1 GroupDisplayName NIC GroupID NIC 1 InstancelD 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 InstancelD iDRAC Embedded 1 Users 3 Privilege IsReadOnly false LowerBound 0 UpperBound 511 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 org wbem wscim 1 cim schema 2 root dcim DCIM_iDRACCardString u USER p PASSWORD r https IPADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic OUTPUT DCIM_iDRACCardString AttributeDisplayName DNS RAC Name AttributeName DNSRacName CurrentValue idrac DefaultValue Dependency null DisplayOrder 0 209 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 FQDD iDRAC Embedded 1 GroupDisplayName NIC GroupID NIC 1 InstancelD iDRAC Embedded 1 NIC 1 DNSRacName IsReadOnly false MaxLength 63 MinLength 1 DCIM_iDRACCardString Attri
274. yet complete 18 1 4 Monitoring Export status Backup process may take up to 30 minutes depending on host system configuration To monitor the backup status get the instance of the corresponding job Replace INSTANCE ID with the actual jobid from Section 18 1 1 18 1 2 or 18 1 3 EXAMPLE winrm get http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LifecycleJob InstancelID INSTANCE ID u USER p PASSWORD r https IPADDRESS wsman 443 SkipCNCheck SkipCACHeck a basic encoding utf 8 OUTPUT DCIM_LifecycleJob InstancelD JID_001293618214 JobStartTime 00000101000000 JobStatus Backup In Progress JobUntilTime TIME_NA Message Collecting Lifecycle Controller Firmware images MessagelD BAR063 Name Backup Image PercentComplete 50 The status may be one of the following e Ready for Backup Request is received e Backup In Progress Backup process is currently in process e Failed Problem with the backup process check message for more information e Completed Backup process is complete with no issues 196 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 18 2 Importing Server Profile To restore host system server profile invoke the Restorelmage method in the class DCIM_LCService Restore process restores the system information firmware images hardware configuration Lifecycle Controller iDRAC firmware and configuration from the backup ima
275. ystem 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 lt p SetAttribute_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p AttributeName gt Part Firmware Update lt p AttributeName gt lt p AttributeValue gt Allow version upgrade only lt p AttributeValue gt lt p SetAttribute_INPUT gt This method is used to set the values of multiple attributes Invoke SetAttributes with the following parameters and syntax EXAMPLE 2 winrm i SetAttributes http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService SystemCreationClassName DCIM_ComputerSystem CreationClassName DCIM_LCService SystemName DCIM ComputerSystem Name DCIM LCService file DIRECTORYPATH SetAttributes_LC xml 88 Dell Lifecycle Controller 2 Web Services Interface Guide for Windows Version 2 1 0 r https IPADDRESS 443 wsman u USER p PASSWORD auth basic encoding utf 8 SkipCNCheck SkipCACheck The input file SetAttributes_LC xml is shown below lt p SetAttributes_INPUT xmlns p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM_LCService gt lt p AttributeName gt Part Firmware Update lt p AttributeName gt lt p AttributeValue gt Allow version upgrade only lt p

Download Pdf Manuals

Related Search

Related Contents

  Pentair PLDE36 User's Manual  HP PHOTOSMART 5600 User's Manual  2 - Konica Minolta  MANUAL 2275015 HK G36C Elite 05APR13.indd  ODL BRSLWE Installation Guide  NOTICE - Pontiac  Beckett Water Gardening FFPK309 User's Manual  Handleiding    

Copyright © All rights reserved. Failed to retrieve file