White Papers

ManualsBrandsDell ManualsNAS & storage serversLifecycle Controller 1.3

Document Status: Published

Dell™ Lifecycle Controller 2 Web

Services Interface Guide for Linux

Summary of content (253 pages)

PAGE 1
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Document Status: Published
PAGE 2
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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.
PAGE 3
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 CONTENTS 1 2 3 4 5 6 7 Introduction ........................................................................................................................ 10 References ........................................................................................................................ 10 Overview ......................................................................................................................
PAGE 4
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 7.2.2 Create Reboot Job ........................................................................................ 41 7.2.3 Schedule Update Jobs .................................................................................. 41 7.2.4 Monitor Update Jobs ..................................................................................... 41 7.3 BIOS Firmware “Rollback” ......................................................
PAGE 5
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 10.2.2 Delete Job Queue ......................................................................................... 76 10.2.3 List Jobs in Job Store .................................................................................... 77 11 Operating System Deployment .......................................................................................... 78 11.1 OS Deployment Profile Implementation Conformance .............
PAGE 6
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 12.9 Set Public Certificates ............................................................................................. 113 12.10 Set iDRAC Certificate and Private Key.................................................................... 114 12.11 Delete Auto-Discovery Server Public Key ............................................................... 115 12.12 Insert Comment in Lifecycle Controller Log .....................
PAGE 7
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 15.10 Setting the IscsiOffloadMode Attribute .................................................................... 155 15.11 Setting the MaxBandwidth Attribute ........................................................................ 156 15.12 Setting the VirtMacAddr Attribute ............................................................................ 157 15.13 Setting the LegacyBootProto Attribute ..........................
PAGE 8
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 16.19.1 Changing the Value of a RAID Controller Enumeration Attribute ............. 198 16.19.2 Changing Multiple Values of RAID Controller Enumeration Attributes...... 199 16.19.3 Changing the Value of a RAID Controller Integer Attribute ...................... 200 16.19.4 Changing Multiple Values of RAID Controller Integer Attributes............... 201 16.20 Convert Physical Disks to RAID-ConvertToRAID() ..................
PAGE 9
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 20 21 22 23 Version: 2.1.0 19.8 Listing the iDRAC Card Inventory-String Class using groupID ................................ 235 19.9 Changing the iDRAC IPChange Notification ........................................................... 237 19.9.1 Getting the Current iDRAC IPChange State ................................................ 237 19.9.2 Setting the iDRAC IPChange Notification-SetAttribute() ..............................
PAGE 10
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 1 Version: 2.1.0 Introduction This document serves as a guideline for utilizing the functionality available from embedded Lifecycle Controller Remote Enablement Web Services. 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.
PAGE 11
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux http://pciids.sourceforge.net/pci.ids 11 Version: 2.1.
PAGE 12
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 3 Version: 2.1.0 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 4 and WSMANCLI5 respectively.
PAGE 13
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic 3.2 WS-Man Security & Time Parameters 3.2.
PAGE 14
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 • dddddddd is the number of days • hh is the remaining number of hours • mm is the remaining number of minutes • ss is the remaining number of seconds • mmmmmm is the remaining number of microseconds The Lifecycle controller 2.0 firmware update, and set attribute related methods that require a date time parameter, use the form YYYYMMDDhhmmss (Eg. 20090930112030).
PAGE 15
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 4 4.1 Version: 2.1.0 Discovery Discovering Web Service Capability Determine if the target system supports the wsman interface using the ‘identify’ command. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP0217_2.0.0.pdf EXAMPLE: wsman identify -h $IPADDRESS -V -v -c dummy.
PAGE 16
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 DCIM:Memory:1.0.0 DCIM Memory 1 1.0.0 ...
PAGE 17
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_RegisteredProfile DCIM:CSRegisteredProfile:1 root/interop http://schemas.
PAGE 18
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 5.2.1 Account and Capabilities (using iDRAC Attributes) Enumerating the DCIM_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: wsman enumerate "http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_iDRACCardEnumeration" -h $IPADDRESS -V -v -c dummy.
PAGE 19
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 . . . 5.2.2 Privilege and Capabilities (using iDRAC Attributes) Enumerating the DCIM_iDRACCardEnumeration class, Section 19.1, and parsing the output for the attribute AttributeDisplayName = User Admin IPMI LAN(or Serial) Privilege, will display all of the 16 possible user accounts and their respective status.
PAGE 20
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 true User Operator Administrator NoAccess . . 5.
PAGE 21
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 JID_001299682234 root/dcim 4096 5.3.2 Modify Password (using iDRAC Attributes) EXAMPLE: wsman invoke -a ApplyAttributes "http://schemas.dmtf.
PAGE 22
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 4096 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
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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.
PAGE 24
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 25
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux MFA Account 13 2 3 DCIM User 13
PAGE 26
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 MFA Account 2 2 2 . . . EXAMPLE-B: wsman enumerate "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_Account" -h $IPADDRESS -V -v -c dummy.
PAGE 27
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 . . . 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 CIM_Account class. To determine account setting capabilities: 1.
PAGE 28
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 29
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 5.4.2 Privilege and Capabilities (using DMTF Model) The account privilege assigned to a user is defined in the class CIM_Privilege associated with the CIM_Account class. The class contains a list of privileges granted to the user account. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP1034_1.0.1.pdf http://www.dmtf.org/sites/default/files/standards/documents/DSP1039_1.0.0.
PAGE 30
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 7 7 7 7 7 7 7 7 7 Login to DRAC Con
PAGE 31
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 32
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 33
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE-A: wsman enumerate "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_Account ?__cimnamespace=root/dcim" -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic -M epr When this method is executed, a list of objects will be returned. Below is a snippet of the output. OUTPUT-A: http://schemas.xmlsoap.
PAGE 34
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 . . . B) Perform a ‘get’ on any instance from A) to ensure correctness of the URI. EXAMPLE-B: wsman get "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/DCIM_MFAAccount ?__cimnamespace=root/dcim,SystemCreationClassName=DCIM_SPComputerSystem,CreationClassNam e=DCIM_MFAAccount,SystemName=systemmc, Name=DCIM User 1" -h $IPADDRESS -V -v -c dummy.
PAGE 35
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 36
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 37
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 1. A fault is returned which suggests a possible error in the request payload. 2. An empty 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.
PAGE 38
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 ?__cimnamespace=root/dcim,SystemCreationClassName=DCIM_SPComputerSyste,CreationClassName= DCIM_MFAAccount,SystemName=systemmc, Name=DCIM User 16" -h $IPADDRESS -V -v -c dummy.
PAGE 39
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 SupportedMethods = 8 The privilege property 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.
PAGE 40
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 10 28897 APAC Dell Lifecycle Controller 2, 1.0.0.4846, X79 USC.Embedded.1:LC.Embedded.
PAGE 41
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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 2 and related MOF files3. The diagrams representing the classes that are implemented by the Lifecycle Controller 1.
PAGE 42
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 JID_001299159345 Downloaded Package successfully downloaded RED002 Rollback:DCIM:AVAILABLE:NONPCI:159:2.1.
PAGE 43
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 All steps to complete a rollback successfully are listed below. Invoke InstallFromSoftwareIdentity() with the following parameters and syntax: [InstanceID]: This is the instanceID of the SoftwareIdentify that is to be used to rollback the firmware to a previous version. The InstanceID can have value such as: DCIM:AVAILABLE:NONPCI:159:2.1.4  It is available firmware on a NONPCI device.  This refers BIOS version 2.1.
PAGE 44
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_SoftUpdateConcreteJob JID_001299753229 root/dcim 4096 7.
PAGE 45
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 46
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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.
PAGE 47
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 tftp://[IP ADDRESS]/[PATH TO FILE.exe] ftp://[IP ADDRESS]/[PATH TO FILE.exe] [InstanceID]: The instanceID is the SoftwareIdentify instanceID that represents the firmware that is to be updated. This instanceID can be retrieved as described in Section 6.2. For example, the instanceID can be: DCIM:INSTALLED:PCI:14E4:1639:0237:1028  It is installed firmware on a PCI device.
PAGE 48
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 In the above sample, the [URI-IP-ADDRESS] must be replaced with the actual value of the IP address of the server that stores update content, [PATH-TO-EXE] must be replaced with the applicable path to the executable, [FILE.exe] must be replaced with the executable name, and [INSTANCEID] should be replaced with the actual InstanceID of the device to be updated.
PAGE 49
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 [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, 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.
PAGE 50
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.
PAGE 51
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 3 = Graceful reboot with forced shutdown EXAMPLE: wsman invoke -a CreateRebootJob http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_SoftwareInstallationService ?CreationClassName=DCIM_SoftwareInstallationService, SystemCreationClassName=DCIM_ComputerSystem,SystemName=IDRAC:ID, Name=SoftwareUpdate -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J reboot.
PAGE 52
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 8 8.1 Version: 2.1.0 Power State Management 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.
PAGE 53
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 54
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 2 0 http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 55
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 8.3 Version: 2.1.0 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 CIM_ComputerSystem class. Base Server Profile: http://www.dmtf.org/sites/default/files/standards/documents/DSP1004_1.0.1.
PAGE 56
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.
PAGE 57
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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 CIM_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.
PAGE 58
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 16 (Power Cycle (Off - Hard Graceful)) Version: 2.1.
PAGE 59
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.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.
PAGE 60
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Enumerate DCIM_PowerSupplyView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_PowerSupplyView -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: Presence Detected PSU.Slot.1 04.09.
PAGE 61
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 3 0 0 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.
PAGE 62
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Fan.Embedded.2A Fan.Embedded.2A 20110307121906.000000+000 20110316091932.
PAGE 63
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Hynix Semiconductor 24 DDR3 DIMM HMT325R7BFR8A-H9 1 1 1DC1FA2E 2048 1333 . . . . 9.
PAGE 64
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 7 5 1 1 2 2048 5 0 14 5
PAGE 65
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 9.5 Version: 2.1.0 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.
PAGE 66
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Enumerate DCIM_PCIDeviceView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_PCIDeviceView -h $IPADDRESS -V -v -c dummy.
PAGE 67
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_VideoView -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 10 0002 G200eR2 0 Video.Embedded.
PAGE 68
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 1874 1882 vFlash SD Card Disk.vFlashCard.1 OK Initialized Disk.vFlashCard.1 20120110194751.
PAGE 69
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 78:2B:CB:54:54:13 0002 0 3 NIC.Embedded.1-1-1 13.1.4 0 NIC.Embedded.
PAGE 70
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 9.10 RAID Inventory & Configuration Version: 2.1.0 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.
PAGE 71
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 72
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 BIOS.Setup.1-1 Memory Settings MemSettings BIOS.Setup.
PAGE 73
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Main System Chassis 7654321 5 15608862073 System.Embedded.1 3 System.Embedded.1 20120106113848.
PAGE 74
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 1231 0 1 4c4c4544-0036-3510-8034-b7c04f333231 1 44454c4c-3600-1035-8034-b7c04f333231 10 Job Control Management 10.
PAGE 75
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a SetupJobQueue http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_JobService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_JobService,SystemName=Idrac,Name=JobService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetupJobQueue.xml -j utf-8 -y basic The syntax for SetupJobQueue.xml is: PAGE 76
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 10.2.2 Delete Job Queue The DeleteJobQueue() method takes in a jobID and then deletes it from the job store. Note: When clearing all jobs and pending data using the keyword JID_CLEARALL, as shown in example 2 below, the remote services instrumentation is restarted to clear the cache [LC 1.5.x ONLY]. Users should allow two minutes for this process to complete.
PAGE 77
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 {KEY="VALUE"[;KEY="VALUE"]} 10.2.3 List Jobs in Job Store The instances of this class will enumerate jobs in the job store along with status information. Invoke enumerate job status with the following parameters and syntax: [JobID]: The JobID of a particular job instance to be queried To get the status of one particular job, use the following: EXAMPLE 1: wsman get http://schemas.dmtf.
PAGE 78
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 79
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 11.1 Version: 2.1.0 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. Enumerate (namespace=’root/interop’, classname=”CIM_RegisteredProfile”) 2. Filter the returned enumeration using property filter (RegisteredName=”OS Deployment”) 3.
PAGE 80
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 81
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Invoke GetDriverPackInfo() with the following syntax: EXAMPLE: wsman invoke -a GetDriverPackInfo http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 82
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 ESX 4.0 0 6.1.0.7 11.3.2 Unpack Selected Drivers and Attach to Host OS as USB Device This method is used to unpack the drivers for the selected OS to a virtual storage partition, and to then attach this partition to the host OS as an emulated USB storage device. 1.
PAGE 83
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 OUTPUT: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 84
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 2 11.3.4 Unpack Selected Drivers and Copy to Network Share The UnpackAndShare() method is used to unpack the drivers for the selected OS and copy them to a 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.
PAGE 85
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.
PAGE 86
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux false DCIM_OSDConcreteJob:1 UnpackAndShare 1
PAGE 87
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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 CDROM storage device. The attachment will persist while the system is booted to the ISO image.
PAGE 88
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 4096 The following error message is a caused by a typo in the wsman input. Careful attention must be paid to the input capitalization of the attributes.
PAGE 89
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 The return will be 0 for success or an integer for error or job in execution. An error containing a Message and MessageID similar to the following can occur from a timing issue, such as not allowing other methods to finish processing prior to invoking this method.
PAGE 90
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 ?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: The return will be 0 for success and a list of MAC addresses or an integer for error or job in execution.
PAGE 91
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v –c dummy.
PAGE 92
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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. Invoke BootToISOFromVFlash() with the following syntax: EXAMPLE: wsman invoke -a BootToISOFromVFlash http://schemas.dmtf.
PAGE 93
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Invoke DeleteISOFromVFlash() with the following syntax: EXAMPLE: wsman invoke -a DeleteISOFromVFlash http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService,Name=DCIM:OSDeploymentService,SystemCreationC lassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v –c dummy.
PAGE 94
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 ISO Image not found on VFlash OSD41 2 11.3.14 Connect Network ISO Image This method can be used to connect and boot to 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.
PAGE 95
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 96
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.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 located on a CIFS or NFS share while the target system still connected to CIFS or NFS share. Invoke SkipISOImageBoot() via NFS share with the following syntax: EXAMPLE: wsman invoke -a SkipISOImageBoot http://schemas.dmtf.
PAGE 97
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 ?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 98
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v –c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -k IPAddress="[IPADDRESS-ISO]" -k ShareName="/[DIVESHARE]" -k ShareType="[SHARETYPE]" -k Username="[SHAREUSER]" -k Password="[SHAREPASSWORD]" -k ImageName="[IMAGENAME]" –k PORT=”[PORT]” -j utf-8 -y basic OUTPUT: The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters.
PAGE 99
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Unable to connect to ISO using RFS. OSD60 2 A return value of 0 indicates success, while the above output indicates an image was not present to disconnect. 11.3.
PAGE 100
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 0 11.3.22 Configurarable Boot to Network ISO This method was added during the LC2 Version 1.1 release.
PAGE 101
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -k ImageName="[OS.ISO]" -j utf-8 -y basic OUTPUT: The return will be 0 for success or 1 if an error occurred in starting the processing the input parameters. The MessageID and Message output parameters will further contain method invocation information if an error occurred. http://schemas.xmlsoap.
PAGE 102
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 NOTE: To query the system to determine when the last CSIOR event occurred, list system inventory and examine the LastSystemInventoryTime 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.
PAGE 103
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttributes_LC.xml -j utf-8 -y basic The input file SetAttributes_LC.xml is shown below: PAGE 104
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 105
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 LC Config NA 12.2.3 List All LC Jobs EXAMPLE: wsman enumerate http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_LifecycleJob ?__cimnamespace=root/dcim -h $IPADDRESS -V -v -c dummy.
PAGE 106
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 • Licensed • Part Firmware Update • Collect System Inventory on Restart (CSIOR) • Part Configuration Update Get the current CSIOR attribute setting as follows: EXAMPLE 1: wsman get http://schemas.dell.com/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCEnumeration ?InstanceID=LifecycleController.Embedded.1#LCAttributes.1#CollectSystemInventoryOnRestart -h $IPADDRESS -V -v -c dummy.
PAGE 107
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman get http://schemas.dell.com/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCEnumeration ?InstanceID=LifecycleController.Embedded.1#LCAttributes.1#PartFirmwareUpdate -h $IPADDRESS -V -v -c dummy.
PAGE 108
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a ReInitiateDHS http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J ReInitiateDHS.xml -j utf-8 -y basic The input file ReInitiateDHS.
PAGE 109
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 This method will return status 0 or error message. 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.
PAGE 110
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 12.5 Version: 2.1.0 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: wsman get http://schemas.dell.com/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCEnumeration ?InstanceID=LifecycleController.
PAGE 111
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J DownloadServerPublicKey.xml -j utf-8 -y basic The input file DownloadServerPublicKey.xml is shown below: PAGE 112
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a DownloadClientCerts http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J DownloadClientCerts.xml -j utf-8 -y basic The input file DownloadClientCerts.
PAGE 113
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob JID_001300790057 root/dcim 4096 12.
PAGE 114
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 The input file SetPublicCertificate.xml is shown below: directoryCA -----BEGIN CERTIFICATE----MIID9DCCA12gAwIBAgIBADANBgkqhkiG9w0BAQQFADCBszELMAkGA1UEBhMCVVMx CzAJBgNVBAgTAlRYMQ8wDQYDVQQHEwZBdXN0aW4xDTALBgNVBAoTBERlbGwxFjAU . . .
PAGE 115
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -J SetCertificateAndPrivateKey.xml -j utf-8 -y basic The input file SetCertificateAndPrivateKey.xml is shown below: server MIIPUQIBAzCCDxcGCSqGSIb3DQEHAaCCDwgEgg8EMIIPADCCBTcGCSqGSIb3DQEH BqCCBSgwggUkAgEAMIIFHQYJKoZIhvcNAQcBMBwGCiqGSIb3DQEMAQYwDgQIySf0 . . .
PAGE 116
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.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: wsman invoke -a InsertCommentInLCLog http://schemas.dmtf.
PAGE 117
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a ExportLCLog http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J ExportLCLog.xml -j utf-8 -y basic The input file ExportLCLog.
PAGE 118
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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. Workgroup: This is the applicable workgroup. EXAMPLE: wsman invoke -a ExportHWInventory http://schemas.
PAGE 119
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 4096 12.15 Export Factory Configuration This method is used to export the factory configuration from the Lifecycle Controller to a text file on a remote share. Invoke ExportFactoryConfiguration() with the following parameters and syntax: IPAddress: This is the IP address of the target export server.
PAGE 120
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 OUTPUT: When this method is executed, a jobid or an error message is returned. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 121
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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: wsman invoke -a GetRemoteServicesAPIStatus http://schemas.dmtf.
PAGE 122
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J ExportSystemConfiguration.xml -j utf-8 -y basic The input file ExportSystemConfiguration.xml is shown below: 123.456.7.8 sharename filename.
PAGE 123
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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: wsman invoke -a ImportSystemConfiguration http://schemas.dmtf.
PAGE 124
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.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.
PAGE 125
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 1 HDD 50 DCIM_ComputerSystem DCIM:ComputerSystem Note: If nothing is returned, no partitions exist. Use the CreatePartition method to create partitions. 13.
PAGE 126
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 true true false InitializedState: Field indicates status of element to be initialized InstanceID: InstanceID of desired element for initialization 13.2.2 Initialize / Format Media This method is used to initialize or format the virtual flash media device.
PAGE 127
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.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: wsman get http://schemas.dmtf.
PAGE 128
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Enable=1, Disable=2 EXAMPLE: wsman invoke -a VFlashStateChange http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_PersistentStorageServic e,SystemName=DCIM:ComputerSystem,Name=DCIM:PersistentStorageService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J VFlashStateChange.
PAGE 129
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 SystemName=DCIM:ComputerSystem,Name=DCIM:PersistentStorageService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J CreatePartition.xml -j utf-8 –y basic The input file CreatePartition.xml is shown below: PAGE 130
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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.
PAGE 131
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -u $USERNAME -p $PASSWORD -J CreatePartitionUsingImage.xml -j utf-8 -y basic The input file CreatePartitionUsingImage.xml is shown below: 1 2 label ftp://123.456.7.
PAGE 132
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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. Note: A locked(attached) partition cannot be deleted. It must be detached first.
PAGE 133
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux  Version: 2.1.
PAGE 134
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 13.8 Version: 2.1.0 Modify Partition This method is used for modifying the changeable attributes of a partition. Use the following algorithm to successfully modify an existing partition.
PAGE 135
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be attached 1 to 16 EXAMPLE: wsman invoke -a AttachPartition http://schemas.dmtf.
PAGE 136
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be detached 1 to 16 EXAMPLE: wsman invoke -a DetachPartition http://schemas.dmtf.
PAGE 137
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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.
PAGE 138
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 1 123.456.7.8 2 /temp imagename.
PAGE 139
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 14.1 Version: 2.1.0 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: wsman enumerate http://schemas.dmtf.
PAGE 140
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 2 vFlash Boot Configuration vFlash 2 0 2 14.
PAGE 141
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BootSourceSetting -h $IPADDRESS -V -v -c dummy.
PAGE 142
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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.
PAGE 143
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 [INSTANCE ID]: Obtained from the BootSourceSetting Class enumeration, this example uses the field IPL source: Reference to the InstanceID attribute from Section 14.3 EnabledState: State of boot source element Disabled=0, Enabled=1 EXAMPLE: wsman invoke -a ChangeBootSourceState http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BootConfigSetting ?InstanceID=$INSTANCEID -h $IPADDRESS -V -v -c dummy.
PAGE 144
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 2. DCIM_NICString (see Section 15.2) 3. DCIM_NICInteger (see Section 15.3) 4. DCIM_NICView (see Section 15.4) 5. DCIM_NICCapabilities(see Section 15.5) 6. DCIM_NICStatistics(see Section 15.6) Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 15.
PAGE 145
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Enabled IscsiTgtBoot Enabled NIC.Embedded.3-1 NIC.Embedded.
PAGE 146
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux NIC.Embedded.1-1:ChipMdl true 0 0 MacAddr 00:22:19:59:B2:1F NIC.Embedded.1-1 NIC.Embedded.
PAGE 147
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 . . . 15.3 Listing the CNA Inventory-Integer Class Enumerate the DCIM_NICInteger class with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_NICInteger -h $IPADDRESS -V -v -c dummy.
PAGE 148
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 FirstTgtTcpPort 3260 NIC.Embedded.1-1 NIC.Embedded.
PAGE 149
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 0 NIC.Embedded.1-1 0 NIC.Embedded.1-1 20110113164831.000000+000 20110112171136.
PAGE 150
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Broadcom NetXtreme II Gigabit Ethernet – 00:22:19:59:B2:25 2 2 15.5 Listing the CNA Inventory-NICCapabilities Class Enumerate the DCIM_NICCapabilities class with the following parameters and syntax: EXAMPLE: winrm e http://schemas.dmtf.
PAGE 151
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 152
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 153
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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 & UntilTime: See Section 3.2.4 EXAMPLE: wsman invoke -a CreateTargetedConfigJob http://schemas.dmtf.
PAGE 154
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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: wsman invoke -a DeletePendingConfiguration http://schemas.dmtf.
PAGE 155
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 LegacyBootProto iSCSI NIC.Embedded.1-1 NIC.Embedded.
PAGE 156
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_CNA_IscsiOffloadMode.xml -j utf-8 -y basic The information in the input file SetAttribute_NIC.xml is shown below: NIC.Integrated.
PAGE 157
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICService ?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_NICService,SystemNam e=DCIM:ComputerSystem,Name=DCIM:NICService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_CNA_MaxBandwidth.xml -j utf-8 -y basic The input file SetAttribute_NIC.
PAGE 158
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman invoke -a SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICService ?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_NICService,SystemNam e=DCIM:ComputerSystem,Name=DCIM:NICService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_CNA_VirtMacAddr.xml -j utf-8 -y basic The input file SetAttribute_NIC.
PAGE 159
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICService ?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_NICService,SystemNam e=DCIM:ComputerSystem,Name=DCIM:NICService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_NIC_LegacyBootProto.xml -j utf-8 -y basic The input file SetAttribute_NIC.
PAGE 160
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 CIM:ComputerSystem,Name=DCIM:NICService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $ PASSWORD -J SetAttributes_NIC_LAN_Modes.xml -j utf-8 -y basic The input file SetAttributes_NIC.xml is shown below: NIC.Embedded.
PAGE 161
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux wsman invoke -a SetAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_NICService,SystemName=DCIM:ComputerSystem, Name=DCIM:NICService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttributes_iSCSI_BootTarget.xml -j utf-8 -y basic The information in the input file SetAttribute_iSCSI_BootTarget.
PAGE 162
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 The command was successful NIC001 Yes 0 Set PendingValue 15.16 Setting the FCoE Boot Target The SetAttributes() method is used to set or change the values of the FCoE boot target attributes.
PAGE 163
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 OUTPUT: The command was successful NIC001 Yes 0 Set PendingValue 16 RAID Storage Management The remote RAID configuration allows users to remotely query and configure the Hardware RAID of the system.
PAGE 164
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Enumerate the DCIM_RAIDEnumeration class with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDEnumeration -h $IPADDRESS -V -v -c dummy.
PAGE 165
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 RAID.Integrated.1-1:RAIDBatteryLearnMode false Automatic Warn only Disabled The ‘set attributes’ method in section 16.19.
PAGE 166
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Disabled RAID.Integrated.1-1 RAID.Integrated.1-1:RAIDloadBalancedMode false Automatic Disabled
PAGE 167
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 true 0 The ‘get’ instance method in Section 16.4 used this InstanceID as input. 0 RAIDrebuildRate 11 RAID.Integrated.1-1 RAID.Integrated.
PAGE 168
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 100 16.4 Getting a RAID Integer Instance Use the following example to get an instance of the DCIM_RAIDInteger class, instead of all instances as shown in Section 16.3. Get a RAIDInteger instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 16.3, which shows an example using RAID.Integrated.
PAGE 169
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: Name MyCacheCadeVD DISK.Virtual.0:RAID.Integrated.1-1 DISK.Virtual.0: RAID.Integrated.
PAGE 170
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 OUTPUT: Name MyCacheCadeVD Disk.Virtual.0:RAID.Integrated.1-1 Disk.Virtual.0:RAID.Integrated.1-1:Name true 15 0 16.
PAGE 171
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 20120116145459.000000+000 20120116145459.
PAGE 172
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 0 0 RAID.Slot.1-1 0 RAID.Slot.1-1 20120116145459.000000+000 20120116145459.
PAGE 173
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 8978432 0 Disk.Bay.0:Enclosure.Internal.0-0:RAID.Slot.1-1 20120116145459.000000+000 20120116145459.
PAGE 174
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 6 0 1024 Disk.Virtual.0:RAID.Slot.1-1 Disk.Virtual.0:RAID.Slot.1-1 20120116145459.
PAGE 175
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 6 0 1024 Disk.Virtual.0:RAID.Slot.1-1 Disk.Virtual.0:RAID.Slot.1-1 20120116145459.000000+000 20120116145459.
PAGE 176
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 0 0 Enclosure.Internal.0-0:RAID.Integrated.1-1 0 Enclosure.Internal.0-0:RAID.Integrated.1-1 20110316150158.
PAGE 177
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 The input file ResetConfig.xml is shown below: RAID.Integrated.1-1 OUTPUT: YES 0 16.
PAGE 178
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 STOR018 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.
PAGE 179
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 180
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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.
PAGE 181
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 VirtualDiskArray: Array of ElementName(s) where each identifies a different VD, currently only one VD can be passed EXAMPLE: wsman invoke -a AssignSpare http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.
PAGE 182
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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.
PAGE 183
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a SetControllerKey http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetControllerKey.xml -j utf-8 -y basic The input file SetControllerKey.
PAGE 184
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Disk.Virtual.0:RAID.Integrated.1-1 OUTPUT: This method requires an H700 or H800 controller to properly function, as does the LockVirtualDisk() method.
PAGE 185
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman invoke -a EnableControllerEncryption http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J EnableControllerEncryption.
PAGE 186
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 below. &  & <  < >  > “  " ‘  ' 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: wsman invoke -a ReKey http://schemas.dmtf.
PAGE 187
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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: wsman invoke -a RemoveControllerKey http://schemas.dmtf.
PAGE 188
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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 EXAMPLE: wsman invoke -a GetRAIDLevels http://schemas.dmtf.
PAGE 189
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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 the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.
PAGE 190
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 0-0:RAID.Integrated.1-1 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.
PAGE 191
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 192
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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. Size: Size of the virtual disk specified in MB.
PAGE 193
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Enabled = 512 Disabled = 1024 VirtualDiskName: Name of the virtual disk (1-15 character range) EXAMPLE: wsman invoke -a CreateVirtualDisk http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.
PAGE 194
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 RebootRequired = 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.
PAGE 195
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 SpanLength: Number of Physical Disks to be used per span. Minimum requirements for given RAID Level must be met.
PAGE 196
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -u $USERNAME -p $PASSWORD -J CreateSlicedVirtualDisk.xml -j utf-8 -y basic The input file CreateSlicedVirtualDisk.xml is shown below: RAID.Integrated.1-1 Disk.Bay.0:Enclosure.Internal.0-0:RAID.Integrated.1-1 Disk.Bay.1:Enclosure.Internal.0-0:RAID.
PAGE 197
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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 is used to create a virtual Disk. VDPropNameArray: This parameter is the list of property names that is used to create a virtual disk.
PAGE 198
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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_VirtualDiskView SelectorSet Selector: InstanceID = DISK.Virtual.267386880:RAID.Integrated.1-1, __cimnamespace = root/dcim RebootRequired = YES ReturnValue = 0 16.18.
PAGE 199
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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: wsman invoke -a SetAttribute http://schemas.dmtf.
PAGE 200
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 AttributeValue: Obtained from the PossibleValues field EXAMPLE: wsman invoke -a SetAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttributes_Enumeration_RAID_Controller.
PAGE 201
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_Integer_RAID_Controller.
PAGE 202
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -u $USERNAME -p $PASSWORD -J SetAttributes_Integer_RAID_Controller.xml -j utf-8 -y basic The input file SetAttributes_Integer_RAID_Controller.xml is shown below: RAID.Integrated.
PAGE 203
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 The input file ConvertToRAID.xml is shown below: Disk.Bay.2:Enclosure.Internal.0-0:RAID.Slot.1-1 OUTPUT: ConvertToRAID_OUTPUT RebootRequired = 1 ReturnValue = 0 16.
PAGE 204
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.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 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.
PAGE 205
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 NoReport BIOS.Setup.1-1 BIOS.Setup.1-1:ReportKbdErr false Report NoReport The ‘set attribute’ method in Section 17.
PAGE 206
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 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 instanceID EXAMPLE: wsman get http://schemas.dmtf.
PAGE 207
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman invoke -a SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BIOSService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_BIOSService,SystemName=DCIM:ComputerSystem,Name=DCIM:BIOSService h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_BIOS.xml -j utf-8 -y basic The input file SetAttribute_BIOS.
PAGE 208
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux BIOS.Setup.
PAGE 209
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_BIOSString -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: UserLcdStr BIOS.Setup.1-1 BIOS.Setup.
PAGE 210
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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: wsman invoke -a CreateTargetedConfigJob http://schemas.dmtf.
PAGE 211
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 17.8 Version: 2.1.0 Deleting the Pending Values for BIOS & Boot-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().
PAGE 212
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux  Version: 2.1.0 Deleting an existing BIOS password Invoke ChangePassword() method with the following parameters: 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: wsman invoke -a ChangePassword http://schemas.dmtf.
PAGE 213
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 BIOS019 2 The command was successful BIOS001 17.9.2 Create Target Configuration Job Create a configuration job as shown in Section 17.7. 17.9.
PAGE 214
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0  Ready for execution - Job is created, but waiting for scheduled start time to pass to schedule the job  Scheduled - Job is scheduled and ready for system reboot to execute the job  Failed - Problem with setting the BIOS password, check message for more information  Completed - Setting the BIOS password completed with no issues 17.
PAGE 215
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 SysSecurity BIOS.Setup.1-1:SetupPassword false false 32 0 3 ^[]0-9a-z "+,-.
PAGE 216
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 18.1.1 Version: 2.1.0 Exporting Server Profile to iDRAC vFlash Card-BackupImage() iDRAC vFlash Card: ShareType is “4”. EXAMPLE: wsman invoke -a BackupImage http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.
PAGE 217
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 18.1.3 Version: 2.1.0 Exporting Server Profile to CIFS Share-BackupImage() CIFS Share: ShareType is “2”. The entire “Passphrase="passphrase";” argument is optional. EXAMPLE: wsman invoke -a BackupImage http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.
PAGE 218
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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.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.
PAGE 219
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 [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.
PAGE 220
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 -u $USERNAME –p $PASSWORD -j utf-8 -y basic -k IPAddress="[SHARE_IPADDRESS]" -k ShareName="/[DRIVESHARE]" -k ShareType="0" -k Username="[SHARE_USERNAME]" -k Password="[SHARE_PASSWORD]" –k Passphrase="[PASSPHRASE]" -k ImageName="[IMAGENAME]" –k ScheduledStartTime="TIME_NOW" NOTE: The ShareName field should only be the folder exposed by the system to the network.
PAGE 221
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 http://schemas.dell.
PAGE 222
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux  Ready for Restore - Request has been received  Restore In Progress - Restore process is currently in process  Failed - Problem with the restore process, check message for more information  Completed-Restore process has completed with no issues Version: 2.1.
PAGE 223
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 224
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 User Admin IPMI LAN Privilege IpmiLanPrivilege NoAccess NoAccess 0 iDRAC.Embedded.
PAGE 225
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Nic Enable Enable Enabled Enabled 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 226
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 0 0 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 227
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman invoke -a ApplyAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_iDRACCardService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_iDRACCardService,SystemName=DCIM:ComputerSystem,Name=DCIM:iDRACC ardService" -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J DRACService_SetAttribute_group_enumerate.
PAGE 228
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Users.16#IpmiLanPrivilege Administrator Users.3#IpmiSerialPrivilege Administrator … Users.
PAGE 229
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 OUTPUT: JID_001300815142 TIME_NA Completed TIME_NA NA NA iDRACConfig:iDRAC.Embedded.1 100 19.4.
PAGE 230
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux VirtualMedia VirtualMedia.1 iDRAC.Embedded.1#VirtualMedia.
PAGE 231
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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.
PAGE 232
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 0 iDRAC.Embedded.1 Users Users.1 iDRAC.Embedded.1#Users.1#Privilege true 0 511 19.
PAGE 233
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 234
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux DNSRacName idrac-59JJ6K1 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 235
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Users.3 iDRAC.Embedded.1#Users.3#UserName true 16 1 19.
PAGE 236
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 63 1 IP Address Address 10.35.0.104 192.168.0.120 0 iDRAC.Embedded.
PAGE 237
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 19.9 Version: 2.1.0 Changing the iDRAC IPChange Notification 19.9.1 Getting the Current iDRAC IPChange State Get the IPChangeNotifyPS attribute from the DCIM_LCAttribute class to display. The CurrentValue field indicates the current status of this attribute. EXAMPLE: wsman get http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCAttribute ?InstanceID=DCIM_LCEnumeration:DHS3 -h $IPADDRESS -V -v -c dummy.
PAGE 238
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 –u $USERNAME -p $PASSWORD -J SetAttribute_iDRAC_IPChange_Notification.xml -j utf-8 -y basic The input file setattribute.xml is shown below: PAGE 239
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman invoke -a GetRemoteServicesAPIStatus http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.
PAGE 240
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 2 (Out of POST) 3 (Collecting System LCStatus 20.
PAGE 241
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 The specified job was deleted SUP020 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.
PAGE 242
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Main System Chassis 7654321 5 15608862073 System.Embedded.1 3 System.Embedded.1 20120116145530.
PAGE 243
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 0 1 4c4c4544-0036-3510-8034-b7c04f333231 1 44454c4c-3600-1035-8034-b7c04f333231 243 Version: 2.1.
PAGE 244
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 22 Sensor Information The DCIM Sensors Profile describes the properties and interfaces for executing system management tasks related to the management of sensors within a system. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 22.
PAGE 245
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.
PAGE 246
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 OUTPUT: bba65194-d0f9-10f9-8126-215754cb2b78 DeviceName QLE2562 FC.Slot.4-1 FC.Slot.
PAGE 247
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCStatistics -h $IPADDRESS -V -v -c dummy.
PAGE 248
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 DeviceName QLE2562 FC.Slot.4-1 FC.Slot.
PAGE 249
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux 23.5 Version: 2.1.0 Listing the FC Inventory-Enumeration Class Enumerate FCEnumeration class ith the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCEnumeration -h $IPADDRESS -V -v -c dummy.
PAGE 250
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_FCService,SystemName=DCIM:ComputerSystem, Name=DCIM:FCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_FC.xml -j utf-8 -y basic The input file SetAttributes_FC.xml is shown below: FC.Slot.
PAGE 251
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 EXAMPLE: wsman invoke -a CreateTargetedConfigJob http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_FCService,SystemName=DCIM:ComputerSystem, Name=DCIM:FCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J apply_pending_fc.xml -j utf-8 -y basic The input file apply_pending_fc.
PAGE 252
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux Version: 2.1.0 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 instances EXAMPLE: wsman invoke -a DeletePendingConfiguration http://schemas.dmtf.
PAGE 253
Dell™ Lifecycle Controller 2 Web Services Interface Guide for Linux ISP2532 0 QLogic QLE2562 8Gb Fibre Channel Adapter 20000024FF2E36B1 2.32 3 FC.Slot.4-1 0 0 02.57.