Page 3 - CONTENTS; Remote Inventory Method Invocation
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 3 CONTENTS 1 Introduction ........................................................................................................................ 10 2 References .......................................................
Page 10 - Generation PowerEdge Server Resources:
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 10 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 provid...
Page 12 - Overview; and WSMANCLI; Format for WinRM CLI Examples in Document
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 12 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 Li...
Page 13 - Encryption Certificate Security; –skipCACheck; Handling invalid responses from WSMAN commands; 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 13 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:basi...
Page 14 - ddddddddhhmmss.mmmmmm; Where
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 14 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 th...
Page 15 - Return Values
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 15 • dddddddd is the number of days • hh is the remaining number of hours • mm is the remaining number of minutes • ss is the remaining number of seconds • mmmmmm is the remaining number of microseconds The Lifecycl...
Page 16 - Discovery; Discovering Web Service Capability; EXAMPLE; Discovering what Profiles are Implemented; Implemented profiles are advertised using the class; OUTPUT
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 16 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/D...
Page 17 - Discovering Implementation Namespace; CIM_ElementConformsToProfile
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 17 AdvertiseTypeDescriptions = WS-Identify AdvertiseTypes = 1 Caption = null Description = null ElementName = null InstanceID = DCIM:CSRegisteredProfile:1 OtherRegisteredOrganization = null RegisteredName = Base Ser...
Page 18 - Managing iDRAC Local User Accounts; Description of iDRAC Attributes vs Standard DMTF Model; The list of user accounts may be retrieved by enumerating the; Account and Capabilities (using iDRAC Attributes); Enumerating the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 18 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 Sele...
Page 19 - DefaultValue = Disabled; Privilege and Capabilities (using iDRAC Attributes); DCIM_iDRACCardEnumeration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 19 -r:https://[IPADDRESS]/wsman:443 -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_iDRACCardEnumeration AttributeDisplayName = User Admin Enable AttributeName = Enable CurrentValue = Disabled Defaul...
Page 20 - Manage Account Settings (using iDRAC Attributes); method on the; Modify User Name (using iDRAC Attributes)
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 20 InstanceID = iDRAC.Embedded.1#Users.1#IpmiLanPrivilege IsReadOnly = true PossibleValues = User, Operator, Administrator, NoAccess DCIM_iDRACCardEnumeration AttributeDisplayName = User Admin IPMI Serial Privilege ...
Page 21 - Modify Password (using iDRAC Attributes)
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 21 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:...
Page 22 - Modify Account State (using iDRAC Attributes); Enable
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 22 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. ...
Page 23 - Modify User Privilege (using iDRAC Attributes); Account and Capabilities (using DMTF Model)
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 23 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 proper...
Page 26 - Privilege and Capabilities (using DMTF Model)
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 26 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_EnabledLogic...
Page 28 - Manage Account Settings (using DMTF Model); UserID
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 28 3. Enumerate the associators of the CIM_RoleBasedAuthorizationService instance and search for CIM_RoleBasedManagementCapabilities class instance using EnumerateEPR mode. OUTPUT: DCIM_LocalRoleBasedManagementCapab...
Page 29 - winrm e
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 29 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 in a subsequent put or set operatio...
Page 32 - EnumerateEPR; Modify User Privilege (using DMTF Model); ActivityQualifiers
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 32 an instance reference. The instance reference may be retrieved by adding EnumerateEPR mode to enumerate or get of the class. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP1034_1.0.1.pdf...
Page 33 - Firmware Inventory; Software Inventory Profile Specification; SoftwareIdentity
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 33 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 Activit...
Page 35 - Firmware Update; Software Update Profile Specification; Profile and Associated MOFs:; ”Rollback” Firmware; Request “Rollback” Image; jobID; Monitor Update Jobs; InstallFromSoftwareIdentity
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 35 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 wi...
Page 36 - Job status after invoking; SetupJobQueue; Job status following reboot / install of operation; BIOS Firmware “Rollback”; The
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 36 DCIM_LifecycleJob InstanceID = JID_001276741956 JobStartTime = TIME_NA JobStatus = Downloaded JobUntilTime = TIME_NA Message = Package successfully downloaded. MessageArguments = null MessageID = RED002 Name = Ro...
Page 37 - NIC Firmware “Rollback”
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 37 This refers BIOS version 2.1.4 EXAMPLE : winrm i InstallFromSoftwareIdentity cimv2/root/dcim/ DCIM_SoftwareInstallationService ?CreationClassName=DCIM_SoftwareInstallationService +SystemCreationClassName=DCIM_C...
Page 39 - Update from Network Source; DCIM_SoftwareInstallationService; Request Update Download
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 39 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: Ins...
Page 40 - Delete Job; jobid
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 40 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...
Page 44 - RebootJobType
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 44 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() ( Se...
Page 45 - Power State Management; Description of Base Server vs Power State Management Methods; Base Server Profile:; Get Power State; Base Server Method; The power state of the system is reported by the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 45 Jobid = InstanceID = RID_001265648530 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 pow...
Page 46 - Power State Management Method; The power state of the system is also reported by the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 46 OtherIdentifyingInfo = 4c4c4544-0036-3510-8034-b7c04f333231, mainsystemchassis, 7654321 PrimaryStatus = 3 RequestedState = 0 8.2.2 Power State Management Method The power state of the system is also reported by t...
Page 47 - Get Power Control Capabilites
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 47 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 Cont...
Page 48 - winrm g; RequestedStatesSupported:; The power control capabilities are also reported by the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 48 . EXAMPLE (Part B): winrm g http://schemas.dell.com/wbem/wscim/1/cim- schema/2/DCIM_CSEnabledLogicalElementCapabilities ?__cimnamespace=root/dcim +InstanceID=DCIM:ComputerCap:1 -u:[USER] -p:[PASSWORD] -r:https://...
Page 49 - PowerStatesSupported Value; Power Control; method of the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 49 -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 PowerChangeCapabil...
Page 50 - DCIM_PowerManagementService
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 50 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....
Page 51 - Hardware Inventory; LastSystemInventoryTime; Power Supply Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 51 9 Hardware Inventory The Dell Common Information Model (CIM) class extensions for supporting remote hardware inventories are defined in the various Dell profiles and related MOFs 3 . The Hardware Inventory allows...
Page 52 - Fan Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 52 InputVoltage = 118 InstanceID = PSU.Slot.2 LastSystemInventoryTime = 20100331101859 LastUpdateTime = 20100401130929 Manufacturer = Dell Model = PWR SPLY,502W,RDNT PartNumber = 0MU791A00 PrimaryStatus = 1 Redundan...
Page 53 - Memory Inventory; This section describes the implementation for the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 53 LastSystemInventoryTime = 20100331101859 LastUpdateTime = 20100408115623 PrimaryStatus = 1 RateUnits = 4 RedundancyStatus = 2 UnitModifier = 0 VariableSpeed = true . . . 9.3 Memory Inventory This section describe...
Page 54 - CPU Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 54 FQDD = DIMM.Socket.A3 InstanceID = DIMM.Socket.A3 LastSystemInventoryTime = 20100331101859 LastUpdateTime = 20100325134947 ManufactureDate = Mon Jun 29 12:00:00 2009 UTC Manufacturer = Samsung MemoryType = 24 Mod...
Page 55 - iDRAC Card Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 55 Cache2Size = 2048 Cache2Type = 5 Cache2WritePolicy = 0 Cache3Associativity = 14 Cache3ErrorMethodology = 5 Cache3Level = 2 Cache3PrimaryStatus = 1 Cache3SRAMType = 2 Cache3Size = 20480 Cache3Type = 5 Cache3WriteP...
Page 56 - PCI Device Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 56 -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 InstanceID = iDRAC.Embedded.1-1#...
Page 57 - Video Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 57 PCIVendorID = 8086 SlotLength = 0002 SlotType = 0002 DCIM_PCIDeviceView BusNumber = 0 DataBusWidth = 0002 Description = 5520/5500/X58 I/O Hub PCI Express Root Port 3 DeviceNumber = 3 FQDD = P2PBridge.Embedded.4-1...
Page 58 - VFlash SD Card Inventory; Each SD card partition is represented by an instance of; NIC Inventory & Configuration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 58 FunctionNumber = 0 InstanceID = Video.Embedded.1-1 LastSystemInventoryTime = 20100331101859 LastUpdateTime = 20100325134947 Manufacturer = Matrox Graphics, Inc. PCIDeviceID = 0532 PCISubDeviceID = 0236 PCISubVend...
Page 65 - 0 Job Control Management; Description of Job Management; Setup Job Queue; Section; JobArray
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 65 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 Cont...
Page 66 - Delete Job Queue
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 66 < p:StartTimeInterval >TIME_NOW</ p:StartTimeInterval > < p:UntilTime >20100730121500</ p:UntilTime > </ p:SetupJobQueue_INPUT > Here the JobArray element shows a list of Jobids that...
Page 67 - List Jobs in Job Store; enumerate job status
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 67 -r:https://[IPADDRESS]/wsman:443 -auth:basic -encoding:utf-8 The example below uses JID_CLEARALL for the jobID , which is a predefined value that represents “deleting all jobs in the jobstore”. EXAMPLE 2 : winrm ...
Page 69 - 1 Operating System Deployment; DCIM_OSDeploymentService; OS Deployment Profile Implementation Conformance; CIM_RegisteredProfile; Checking OS Deployment Service Availability; enumerate; OS Deployment Method Invocation Examples
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 69 11 Operating System Deployment The Dell Common Information Model (CIM) class extensions for supporting remote operating system (OS) deployment are defined in the Dell OS Deployment Profile 2 and the DCIM_OSDeploy...
Page 70 - Get Driver Pack Information; Version
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 70 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...
Page 71 - Unpack Selected Drivers and Attach to Host OS as USB Device; Microsoft Windows Server 2008 with SP2
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 71 Version = 7.0.0.35 11.3.2 Unpack Selected Drivers and Attach to Host OS as USB Device This method is used to unpack the drivers for the selected OS to a virtual storage partition, and to then attach this partitio...
Page 72 - Detach Emulated USB Device Containing Drivers; MessageID; Unpack Selected Drivers and Copy to Network Share
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 72 /2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem /wscim/1/cim-schema/2/DCIM_OSDConcreteJob SelectorSet Selector: InstanceID = DCIM_OSDConcreteJob:1, __cimnamespace...
Page 73 - Check Job Status; DCIM_OSDConcreteJob instances
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 73 [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 S...
Page 74 - Boot to Network ISO; ExposeDuration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 74 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 propert...
Page 75 - Detach Network ISO USB Device
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 75 [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:OSDeployme...
Page 76 - Boot To PXE
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 76 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 DetachISOImag...
Page 77 - Get Host MAC Address Information; Download ISO to VFlash; : This is the directory path to the ISO image.
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 77 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 +Na...
Page 78 - Boot to ISO from VFlash; VFlash
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 78 EXAMPLE : winrm i DownloadISOToVFlash cimv2 /root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService +Name=DCIM:OSDeploymentService +SystemCreationClassName=DCIM_ComputerSystem +SystemName=...
Page 79 - Delete ISO from VFlash
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 79 Invoke BootToISOFromVFlash() with the following syntax: EXAMPLE : winrm i BootToISOFromVFlash cimv2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService +Name=DCIM:OSDeploymentService +S...
Page 80 - Detach ISO from VFlash; Connect Network ISO Image; DisconnectNetworkISOImage
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 80 DeleteISOFromVFlash_OUTPUT Message = ISO Image not found on VFlash MessageID = OSD41 ReturnValue = 2 11.3.13 Detach ISO from VFlash The DetachISOFromVFlash() method will detach the ISO image in the VFlash from th...
Page 81 - Disconnect Network ISO Image
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 81 [CIFS_or_NFS_Username] : This is the username to the IP address of the ISO image. [CIFS_or_NFS_Password] : This is the corresponding password to the username containing the ISO image. [OS.ISO] : This is to be rep...
Page 82 - Skip ISO Image Boot; ConnectNetworkISOImage; Failure
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 82 EXAMPLE : winrm i DisconnectNetworkISOImage http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService +Name=DCIM:OSDeploymentService +System...
Page 84 - Disconnect RFS ISO Image; Invoke; DisconnectRFSISOImage; with the following syntax:
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 84 [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 : winr...
Page 85 - Get RFS ISO Image Connection Information; GetRFSISOImageConnectionInfo
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 85 cimv2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService +Name=DCIM:OSDeploymentService +SystemCreationClassName=DCIM_ComputerSystem +SystemName=DCIM:ComputerSystem -u:[USER] -p:[PASSW...
Page 87 - 2 Lifecycle Controller Management Profile; and related MOF files
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 87 Workgroup="WORKGROUP";ImageName="[OS.ISO]"} OUTPUT: The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters. The MessageID and Message output par...
Page 88 - Part Firmware Update; Disable; = Allow firmware update only on up-revision; Match firmware of replaced part; Part Replacement
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 88 Disabled (default) = Disallow collecting inventory on restart Enabled = Allow collecting system inventory on restart The Part Firmware Update attribute flags whether the Part Replacement automatic firmware up...
Page 89 - Part Replacement Configuration and Management; Create Config Job; winrm i CreateConfigJob
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 89 -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: < p:SetAttributes_INPUT xmlns:p ="http://s...
Page 90 - Get LC Config Job Status; List All LC Jobs
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 90 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/addre...
Page 91 - Get CSIOR Component Configuration Recovery (CCR) Attribute; The Component Configuration Recovery (CCR) attributes are
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 91 winrm e http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_LifecycleJob ?__cimnamespace=root/dcim -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -encoding:utf-8 -a:basic -SkipCNCheck -SkipCACheck OUTPUT...
Page 92 - Get Part Firmware Update Attribute
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 92 OUTPUT: DCIM_LCEnumeration AttributeName = Collect System Inventory on Restart CurrentValue = Disabled DefaultValue = Enabled ElementName = LC.emb.1 InstanceID = LifecycleController.Embedded.1#LCAttributes.1#Coll...
Page 93 - PerformAutoDiscovery; Clear or Set Provisioning Server; Configuring
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 93 [ 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 i...
Page 95 - Check VFlash License Enablement; CurrentValue; Download Server Public Key; winrm i DownloadServerPublicKey
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 95 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 f...
Page 96 - Download Client Certificates; winrm i DownloadClientCerts
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 96 The input file DownloadServerPublicKey.xml is shown below: < p:DownloadServerPublicKey_INPUT xmlns:p ="http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_LCService"> < p:KeyContent...
Page 97 - Delete Auto-Discovery Client Certificates
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 97 -encoding:utf-8 -a:basic -file: DownloadClientCerts .xml The input file DownloadClientCerts.xml is shown below: < p:DownloadClientCerts_INPUT xmlns:p ="http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/ro...
Page 98 - winrm i DeleteAutoDiscoveryClientCerts; Set Public Certificates; winrm i SetPublicCertificate
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 98 EXAMPLE : winrm i DeleteAutoDiscoveryClientCerts http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemNa...
Page 99 - : Specifies the service the certificate is for:; winrm i SetCertificateAndPrivateKey
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 99 ROncFRPIp7c= -----END CERTIFICATE----- </ p:Certificate > </ p:SetPublicCertificate_INPUT > OUTPUT: SetPublicCertificate_OUTPUT ReturnValue = 0 12.10 Set iDRAC Certificate and Private Key This method ...
Page 100 - Comment; winrm i InsertCommentInLCLog
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 100 </ p:PKCS12 > < p:PKCS12pin >1234567</ p:PKCS12pin > </ p:SetCertificateAndPrivateKey_INPUT > OUTPUT: SetCertificateAndPrivateKey_OUTPUT Message = Server certificate successfully modified...
Page 101 - Export Lifecycle Controller Log; winrm i ExportLCLog
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 101 -encoding:utf-8 -a:basic -file: InsertCommentInLCLog.xml The input file InsertCommentInLCLog.xml is shown below: < p:InsertCommentInLCLog_INPUT xmlns:p ="http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2...
Page 102 - Export Hardware Inventory from Lifecycle Controller; winrm i ExportHWInventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 102 < p:ShareName >sharename</ p:ShareName > < p:FileName >filename.txt</ p:FileName > < p:ShareType >0</ p:ShareType > < p:Username >admin</ p:Username > < p:Passw...
Page 103 - Export Factory Configuration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 103 +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: <...
Page 104 - Workgroup; winrm i ExportFactoryConfiguration; System Decommission; winrm i LCWipe
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 104 Workgroup : This is the applicable workgroup. EXAMPLE : winrm i ExportFactoryConfiguration http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem...
Page 105 - Get Remote Services API Status; Export System Configuration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 105 +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...
Page 106 - Import System Configuration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 106 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 Usern...
Page 107 - : This is the username to the target export server.; Password; : This is the password to the target export server.; 3 VFlash SD Card Management; Listing virtual flash partitions
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 107 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. EXAMPL...
Page 108 - Copying/exporting the contents of the partition; Listing the SD Card Partitions; DCIM_OpaqueManagementData; Initialize the Virtual Flash Media; DCIM_PersistentStorageService
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 108 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.de...
Page 109 - Get VFlash SD Card Inventory; InstanceID; Initialize / Format Media; winrm i InitializeMedia
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 109 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 wh...
Page 110 - Verify Initialization / Formatting
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 110 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...
Page 111 - Enable/Disable VFlash using VFlash State Change; VFlashEnabledState; Create Partition
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 111 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 dict...
Page 112 - PartitionType: The partition type; The label seen in the OS after attaching the partition
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 112 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...
Page 113 - Create Partition using Image
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 113 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...
Page 115 - Delete Partition; Format Partition
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 115 13.6 Delete Partition This method 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 wi...
Page 117 - Modify Partition; Attach Partition
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 117 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. Enumerate the DCIM_PersistentStorageS...
Page 119 - Export Data from Partition
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 119 winrm i DetachPartition http://schemas.dell.com/wbem/wscim/1/cim-schema/2/ DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_PersistentStorageService +SystemName=...
Page 121 - 4 Boot Control Configuration Management; Listing the Boot Inventory-ConfigSetting Class; BootConfigSetting
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 121 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 ResourceUR...
Page 122 - Getting a Boot ConfigSetting Instance
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 122 InstanceID = BCV IsCurrent = 2 IsDefault = 0 IsNext = 2 DCIM_BootConfigSetting ElementName = UefiBootSeq InstanceID = UEFI IsCurrent = 2 IsDefault = 0 IsNext = 2 DCIM_BootConfigSetting ElementName = OneTimeBootM...
Page 123 - Listing the Boot Inventory-SourceSetting Class; BootSourceSetting
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 123 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 ...
Page 124 - source; winrm i ChangeBootOrderByInstanceID
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 124 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 CreateTargetedC...
Page 125 - EnabledState; winrm i ChangeBootSourceState; 5 NIC/CNA Card Management
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 125 [INSTANCE ID] : Obtained from the BootSourceSetting Class enumeration, this example uses the field IPL source : Reference to the InstanceID attribute from Section 14.3 EnabledState : State of boot source element...
Page 129 - Listing the CNA Inventory-Integer Class; Enumerate the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 129 . . 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...
Page 130 - Listing the CNA Inventory-NICView Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 130 GroupDisplayName = iSCSI General Parameters GroupID = IscsiGenParams InstanceID = NIC.Integrated.1-1-1:LunBusyRetryCnt IsReadOnly = false LowerBound = 0 PendingValue = null UpperBound = 60 DCIM_NICInteger Attrib...
Page 132 - Listing the CNA Inventory-NICCapabilities Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 132 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 Listin...
Page 133 - Listing the CNA Inventory- NICStatistics Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 133 RemotePHY = 3 TCPChimneySupport = 3 TXBandwidthControlMaximum = 3 TXBandwidthControlMinimum = 3 TXFlowControl = 3 VEBVEPAMultiChannel = 3 VEBVEPASingleChannel = 3 VFSRIOVSupport = 3 VirtualLinkControl = 3 WOLSup...
Page 134 - ScheduledStartTime & UntilTime; winrm i CreateTargetedConfigJob
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 134 TxBroadcast = 0 TxBytes = null TxErrorPktExcessiveCollision = null TxErrorPktLateCollision = null TxErrorPktMultipleCollision = null TxErrorPktSingleCollision = null TxMutlicast = 74 TxPauseXOFFFrames = 0 TxPaus...
Page 135 - /anonymous
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 135 < p:Target >NIC.Integrated.1-1-1</ p:Target > < p:RebootJobType >1</ p:RebootJobType > < p:ScheduledStartTime >TIME_NOW</ p:ScheduledStartTime > < p:UntilTime >202011111...
Page 136 - Getting the CNA Enumeration Instance; Attribute; IscsiOffloadMode
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 136 OUTPUT: DeletePendingConfiguration_OUTPUT Message = The command was successful MessageID = NIC001 ReturnValue = 0 15.9 Getting the CNA Enumeration Instance Use the following example to get an instance of the DCI...
Page 137 - winrm i SetAttribute
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 137 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 personal...
Page 138 - Setting the MaxBandwidth Attribute; AttributeName
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 138 15.11 Setting 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 give...
Page 139 - Setting the VirtMacAddr Attribute
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 139 MessageID = 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...
Page 140 - LegacyBootProto
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 140 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 B...
Page 141 - Setting CNA LAN Modes; winrm i SetAttributes
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 141 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() w...
Page 142 - Setting the iSCSI Boot Target
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 142 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 th...
Page 143 - Setting the FCoE Boot Target
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 143 < p:AttributeValue >testname</ p:AttributeValue > < p:AttributeName >IscsiInitiatorChapId</ p:AttributeName > < p:AttributeValue >testid</ p:AttributeValue > < p:AttributeN...
Page 144 - The information in the input file; 6 RAID Storage Management
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 144 -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: < p:...
Page 145 - DCIM_VirtualDiskView; Listing the RAID Inventory-Enumeration Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 145 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 ( Sect...
Page 146 - Getting a RAID Enumeration Instance; Use the following example to get an instance of the; Listing the RAID Inventory-Integer Class; RAIDInteger
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 146 CurrentValue = WriteBack FQDD = Disk.Virtual.1:RAID.Integrated.1-1 InstanceID = Disk.Virtual.1:RAID.Integrated.1-1:RAIDdefaultWritePolicy IsReadOnly = false PendingValue PossibleValues = WriteThrough, WriteBack,...
Page 148 - Getting a RAID Integer Instance; Listing the RAID Inventory-String Class; RAIDString
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 148 LowerBound = 1 PendingValue UpperBound = 100 16.4 Getting a RAID Integer Instance Use the following example to get an instance of the DCIM_RAIDInteger class, instead of all instances as shown in Section 16.3 . G...
Page 149 - Getting a RAID String Instance
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 149 OUTPUT: DCIM_RAIDString AttributeName = Name CurrentValue = MyCacheCadeVD FQDD = Disk.Virtual.0:RAID.Integrated.1-1 InstanceID = Disk.Virtual.0:RAID.Integrated.1-1:Name IsReadOnly = true MaxLength = 15 MinLength...
Page 150 - PendingValue; Listing the RAID Inventory-ControllerView Class; ControllerView
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 150 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: ...
Page 151 - Getting a RAID ControllerView Instance; instanceID
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 151 16.8 Getting a RAID ControllerView Instance The get() command can be invoked using a particular instanceID , attained from listing the inventory. Get a RAID ControllerView instance with the following parameters ...
Page 152 - Listing the RAID Inventory-PhysicalDiskView Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 152 16.9 Listing the RAID Inventory-PhysicalDiskView Class Enumerating the PhysicalDiskView, results in the attributes and inventory of the available physical disks in the system. Enumerate PhysicalDiskView with the...
Page 153 - Listing the RAID VirtualDiskView Inventory
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 153 FQDD = Disk.Bay.1:Enclosure.Internal.0-0:RAID.Slot.1-1 FreeSizeInBytes = 8978432 HotSpareStatus = 0 InstanceID = Disk.Bay.1:Enclosure.Internal.0-0:RAID.Slot.1-1 LastSystemInventoryTime = 20120116145459.000000+00...
Page 155 - Listing the RAID EnclosureView Inventory; All data on the existing virtual disks will be lost!; ResetConfig; TARGET
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 155 StripeSize = 128 VirtualDiskTargetID = 0 WriteCachePolicy = 1 16.11 Listing the RAID EnclosureView Inventory Enumerating the EnclosureView, results in the attributes and inventory of the available enclosure comp...
Page 156 - winrm i ResetConfig; ClearForeignConfig.xml
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 156 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 ...
Page 158 - winrm i DeletePendingConfiguration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 158 </ p:CreateTargetedConfigJob_INPUT > 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 . C...
Page 159 - HotSpare; DCIM_PhysicalDiskView
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 159 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. Inv...
Page 160 - VirtualDiskArray; only one VD can be passed
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 160 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/DCI...
Page 161 - Error! Reference source; xmlns; Managing Keys for Self Encrypting Drives; The Dell Key Manager feature is not available at this time.
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 161 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 spar...
Page 162 - winrm i SetControllerKey; winrm i LockVirtualDisk
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 162 EXAMPLE : winrm i SetControllerKey http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_RAIDService +SystemName=DCIM:...
Page 163 - Key
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 163 The input file LockVirtualDisk.xml is shown below: < p:LockVirtualDisk_INPUT xmlns:p ="http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_RAIDService"> < p:Target >Disk.Virtual...
Page 164 - section
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 164 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 +SystemN...
Page 165 - not have spaces in it.; Mode of the Controller
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 165 The special characters in the following set must be passed as mentioned below. & & < < > > “ " ‘ ' Keyid: Key Identifier- Describes Key. The Keyid can ...
Page 166 - Managing Virtual Disk; MediaType; Diskprotocol
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 166 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 t...
Page 167 - VDRAIDEnumArray
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 167 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 F...
Page 168 - GetAvailableDisks.xml
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 168 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. Invok...
Page 169 - VDPropValueArrayIn; VDPropNameArrayIn
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 169 OUTPUT: GetAvailableDisks_OUTPUT PDArray = Disk.Bay.0:Enclosure.Internal.0-0:RAID.Integrated.1-1, Disk.Bay.1:Enclosure.Internal.0-0:RAID.Integrated.1-1 ReturnValue = 0 16.18.3 Checking the Create VD Parameters V...
Page 170 - VDPropNameArray
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 170 < p:VDPropNameArrayIn > Size </ p:VDPropNameArrayIn > < p:VDPropValueArrayIn > 10000 </ p:VDPropValueArrayIn > < p:VDPropNameArrayIn >RAIDLevel</ p:VDPropNameArrayIn > < p:...
Page 174 - VDPropValueArray
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 174 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...
Page 178 - ObjectStatus; DeleteVirtualDisk.xml
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 178 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 Selec...
Page 179 - Setting Controller Attributes; Changing the Value of a RAID Controller Enumeration Attribute
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 179 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 attri...
Page 180 - Changing the Value of a RAID Controller Integer Attribute
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 180 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 rvi...
Page 181 - Changing Multiple Values of RAID Controller Integer Attributes; SetAttributes; FQDD; AttributeValue; PossibleValues
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 181 EXAMPLE : winrm i SetAttribute cimv2/root/dcim/DCIM_RAIDSe rvice?SystemCreationClassName=DCIM_ComputerSystem+CreationClassName=DCIM_RAIDService+SystemName=DCIM:ComputerSystem+Name=DCIM:RAIDService -u:[USER] -p:[...
Page 182 - ConvertToRAID; RAIDPDState; Physical Disk TARGET
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 182 < p:SetAttributes_INPUT xmlns:p ="http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_RAIDService"> < p:Target >RAID.Integrated.1-1</ p:Target > < p:AttributeName >R...
Page 183 - ConvertToNonRAID; 7 Managing BIOS Configuration; Listing the BIOS Inventory-Enumeration Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 183 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 exec...
Page 185 - Getting a BIOS Enumeration Instance; Getting one particular instance of the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 185 . 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 fol...
Page 186 - Setting Multiple BIOS BootMode Parameters; BiosMode
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 186 +SystemName=DCIM:ComputerSystem +Name=DCIM:BIOSService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic -file: SetAttribute_BIOS.xml The input file SetAttri...
Page 187 - Listing the BIOS Inventory-Integer Class; BIOSInteger; Listing the BIOS Inventory-String Class; BIOSString
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 187 < p:SetAttributes_INPUT xmlns:p ="http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_BIOSService"> < p:Target >BIOS.Setup.1-1</ p:Target > < p:AttributeName >BootMo...
Page 188 - BIOSAttribute
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 188 OUTPUT: DCIM_BIOSString AttributeName = OneTimeCustomBootStr CurrentValue = null DefaultValue = null FQDD = BIOS.Setup.1-1 InstanceID = BIOS.Setup.1-1:OneTimeCustomBootStr IsReadOnly = true MaxLength = 200 MinLe...
Page 190 - Target; Managing BIOS Passwords; Setting the BIOS Password
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 190 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. Invok...
Page 191 - - Obtained from any BIOS enumerate WSMAN command; PasswordType; - Either 1 for system or 2 for setup; OldPassword; winrm i ChangePassword
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 191 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)...
Page 192 - Ready for execution; Listing the BIOS Inventory-Password Class; BIOSPassword
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 192 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 job status for setting the BIOS password, get the instance of t...
Page 193 - 8 Exporting and Importing Server Profile
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 193 winrm e cimv2/root/dcim/DCIM_BIOSPassword -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8 -a:basic OUTPUT: DCIM_BIOSPassword AttributeDisplayName = System Password ...
Page 194 - Exporting Server Profile; Exporting Server Profile to iDRAC vFlash Card-BackupImage(); ShareType
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 194 http://www.delltechcenter.com/page/DCIM.Library.Profile 18.1 Exporting Server Profile To backup host system server profile, invoke the BackupImage() method in the class DCIM_LCService. Backup feature gathers sys...
Page 196 - Monitoring Export status; The status may be one of the following:
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 196 In-Correct Example: ShareName=”/folder1/subfolder”;ImageName=”image_name” OUTPUT : BackupImage_OUTPUT Job Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI...
Page 197 - Importing Server Profile; Importing Server Profile from iDRAC vFlash Card-RestoreImage()
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 197 18.2 Importing Server Profile To restore host system server profile, invoke the RestoreImage() method in the class DCIM_LCService . Restore process restores the system information, firmware images, hardware conf...
Page 199 - Monitoring Import Status; - Request has been received; Restore In Progress; - Restore process is currently in process; Failed
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 199 OUTPUT: RestoreImage_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 Sel...
Page 200 - Completed; 9 iDRAC Configuration; Listing the iDRAC Card Inventory-Enumeration Class; iDRACCardEnumeration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 200 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 ...
Page 201 - Getting an iDRAC Card Enumeration Instance
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 201 AttributeDisplayName = Virtual Media Attached AttributeName = Attached CurrentValue = Detached DefaultValue = Detached Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = VirtualMedia G...
Page 202 - Listing the iDRAC Card Inventory-Enumeration Class using; groupID
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 202 EXAMPLE : winrm g http://schemas.dmtf.org/wbem/wscim/1/cim- schema/2/root/dcim/DCIM_iDRACCardEnumeration ?InstanceID=[INSTANCE ID] -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman:443 -SkipCNcheck -SkipCAche...
Page 204 - Applying the Attributes and Polling Job Completion
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 204 CurrentValue = Administrator DefaultValue = NoAccess Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = Users GroupID = Users.3 InstanceID = iDRAC.Embedded.1#Users.3#IpmiLanPrivilege I...
Page 205 - Address =; Polling Job Completion; JobStatus
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 205 < p:AttributeValue >Enabled</ p:AttributeValue > < p:AttributeName >NIC.1#VLanEnable</ p:AttributeName > < p:AttributeValue >Disabled</ p:AttributeValue > < p:AttributeName...
Page 206 - Set Attribute Verification; To verify the changes made to the attributes, enumerate the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 206 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:b...
Page 207 - Listing the iDRAC Card Inventory-Integer Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 207 IsReadOnly = false PossibleValues = Detached, Attached, Autoattach DCIM_iDRACCardEnumeration AttributeDisplayName = IPv4 Enable AttributeName = Enable CurrentValue = Enabled DefaultValue = Enabled Dependency = n...
Page 208 - Listing the iDRAC Card Inventory-Integer Class using; iDRACCardInteger
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 208 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.1#VLanPriority IsReadOnly = false LowerBound = 0 UpperBound = 7 DCIM_iDRACCardInteger AttributeDisplayName = User ...
Page 209 - Listing the iDRAC Card Inventory-String Class; iDRACCardString
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 209 DCIM_iDRACCardInteger AttributeDisplayName = VLan Priority AttributeName = VLanPriority CurrentValue = 1 DefaultValue = 0 Dependency = null DisplayOrder = 0 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID...
Page 210 - Listing the iDRAC Card Inventory-String Class using; dracgetgroupid_string
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 210 FQDD = iDRAC.Embedded.1 GroupDisplayName = NIC GroupID = NIC.1 InstanceID = iDRAC.Embedded.1#NIC.1#DNSRacName IsReadOnly = false MaxLength = 63 MinLength = 1 DCIM_iDRACCardString AttributeDisplayName = IP Addres...
Page 211 - The possible inputs for GroupID are:
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 211 -filter:"select * from DCIM_iDRACCardString WHERE GroupID='NIC.1'" The possible inputs for GroupID are: NIC.1 IPv4.1 Users.3 OUTPUT: DCIM_iDRACCardString AttributeDisplayName = DNS RAC Name AttributeName...
Page 212 - Changing the iDRAC IPChange Notification; Getting the Current iDRAC IPChange State; IPChangeNotifyPS
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 212 IsReadOnly = false MaxLength = 16 MinLength = 1 19.9 Changing the iDRAC IPChange Notification 19.9.1 Getting the Current iDRAC IPChange State Get the IPChangeNotifyPS attribute from the DCIM_LCAttribute class to...
Page 213 - 0 Remote Service Status; To get the remote service status, invoke the; Getting Remote Service Status
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 213 ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemName=DCIM:ComputerSystem +Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck ...
Page 214 - Details on each output parameter is described below:; Possible values
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 214 ?SystemCreationClassName=DCIM_ComputerSystem +CreationClassName=DCIM_LCService +SystemName=DCIM:ComputerSystem +Name=DCIM:LCService -u:[USER] -p:[PASSWORD] -r:https://[IPADDRESS]/wsman -SkipCNcheck -SkipCAcheck ...
Page 215 - LCStatus; Restarting Remote Service Status; If you continue to get “Not Ready” remote service status, invoke the
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 215 5 (Lifecycle Controller Unified Server Configurator) Server is executing UEFI Lifecycle Controller Unified Server Configurator application LCStatus 0 (Ready) Lifecycle Controller instrumentation is up to date an...
Page 216 - 1 System Information; Listing the System Inventory-SystemView Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 216 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 aggrega...
Page 217 - 2 Sensor Information; Listing the Sensors Inventory-PSNumericSensor Class
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 217 LicensingRollupStatus = 1 LifecycleControllerVersion = 2.0.0 Manufacturer = Dell Inc. MaxCPUSockets = 2 MaxDIMMSlots = 24 MaxPCIeSlots = 7 MemoryOperationMode = OptimizerMode Model = PowerEdge T620 PSRollupStatu...
Page 219 - 3 Managing Fiber Channel (FC) Configuration; Listing the FC Inventory-Attribute Class; The FC Inventory contains the following attributes:
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 219 EnabledState = 2 HealthState = 5 LowerThresholdCritical LowerThresholdNonCritical OperationalStatus = 2 PossibleStates = Unknown PossibleStates = Fatal PossibleStates = Normal PossibleStates = Upper Fatal Possib...
Page 220 - Listing the FC Inventory-Statistics Class; If RT-CEM is disabled on the system, this method will return failure.
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 220 -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...
Page 221 - Listing the FC Inventory-String Class; Enumerate
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 221 FCRxSequences FCRxTotalFrames = 0 FCTxKBCount = 0 FCTxSequences FCTxTotalFrames = 0 FQDD = FC.Slot.2-1 InstanceID = FC.Slot.2-1 OSDriverState = 2 PortSpeed = 2 PortStatus = 3 DCIM_FCStatistics FCInvalidCRCs = 0 ...
Page 222 - Listing the FC Inventory-Integer Class; FCInteger; Listing the FC Inventory-Enumeration Class; FCEnumeration
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 222 ValueExpression . . 23.4 Listing the FC Inventory-Integer Class Enumerate FCInteger class ith the following parameters and syntax: EXAMPLE : winrm e http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DC...
Page 225 - ResourceURI =; Listing the FC Views; FCView
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Windows Version: 2.1.0 225 ResourceURI = http://schemas.dell.com/wbem /wscim/1/cim-schema/2/DCIM_LifecycleJob SelectorSet Selector: InstanceID = JID_001269609760, __cimnamespace = root/dcim ReturnValue = 4096 23.8 Deleting the Pending Val...