Reference Guide

ManualsBrandsDell ManualsConverged InfrastructureSystems Management Solution Resources

A Dell Best Practices Guide

Lifecycle Controller Web Services Interface

Guide for Linux

A Dell Technical White Paper about the Best Practices to be followed for using the

WS-Man based remote services provided by iDRAC and Lifecycle Controller

Dell Engineering

September 2017

Summary of content (255 pages)

PAGE 1
Lifecycle Controller Web Services Interface Guide for Linux A Dell Technical White Paper about the Best Practices to be followed for using the WS-Man based remote services provided by iDRAC and Lifecycle Controller Dell Engineering September 2017 A Dell Best Practices Guide
PAGE 2
Revisions Date Description December 2013 1.0 Release: Initial release November 2016 Updates for iDRAC8 2.40.40.40 (13th Generation PowerEdge Servers) September 2017 Updates for iDRAC9 3.00.00.00 (14th Generation PowerEdge Servers) The information in this publication is provided “as is.” Dell Inc. makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose.
PAGE 3
Contents 1 Introduction ..................................................................................................................................................... 13 2 References ...................................................................................................................................................... 14 3 Overview ........................................................................................................................................................
PAGE 4
7 Firmware Update ............................................................................................................................................ 40 7.1 Software Update Profile Specification ............................................................................................ 40 7.2 ”Rollback” Firmware ....................................................................................................................... 40 7.2.2 Create Reboot Job ...................................
PAGE 5
9 10 11 5 Hardware Inventory......................................................................................................................................... 61 9.1 Power Supply Inventory .................................................................................................................. 61 9.2 Fan Inventory .................................................................................................................................. 62 9.3 Memory Inventory ................
PAGE 6
12 6 11.3.10 Download ISO to VFlash ............................................................................................. 85 11.3.11 Boot to ISO from VFlash ............................................................................................. 87 11.3.12 Delete ISO from VFlash .............................................................................................. 87 11.3.13 Detach ISO from VFlash .................................................................................
PAGE 7
13 14 15 7 12.21 XML Template Preview ................................................................................................................ 113 12.22 Remote Diagnostics ..................................................................................................................... 114 12.22.1 Run Diagnostics ........................................................................................................ 115 12.22.2 Export Diagnostics Results ................................
PAGE 8
16 15.13 Setting the LegacyBootProto Attribute ......................................................................................... 144 15.14 Setting CNA LAN Modes .............................................................................................................. 145 15.15 Setting the iSCSI Boot Target ...................................................................................................... 146 15.16 Setting the FCoE Boot Target ..........................................
PAGE 9
16.22 17 16.21.7 Deleting a Virtual Disk-DeleteVirtualDisk() ............................................................... 177 16.21.8 Rename Virtual Disk – RenameVD() ........................................................................ 178 16.21.9 Cancel background initialization -CancelBackgroundInitialization() ......................... 178 16.21.10 Rebuild physical disk -RebuildPhysicalDisk() ........................................................... 179 16.21.
PAGE 10
18.3 19 20 21 10 18.2.2 Set Backup Schedule ................................................................................................ 199 18.2.3 Get the Backup Schedule ......................................................................................... 200 18.2.4 Clear the Backup Schedule ...................................................................................... 200 Importing Server Profile ..................................................................................
PAGE 11
24 25 23.8 Deleting the Pending Values for FCDeletePendingConfiguration() ............................................. 228 23.9 Listing the FC Views ..................................................................................................................... 229 GroupManager Configuration ....................................................................................................................... 231 24.1 Enabling GroupManger Feature ................................................
PAGE 12
Executive Summary Dell PowerEdge servers are equipped with the integrated Dell Remote Access Controller and the Lifecycle Controller solution for remote management – iDRAC6 on 11th Generation servers,iDRAC7 on 12th Generation servers, iDRAC8 on 13th Generation servers and iDRAC9 on 14th Generation servers. These servers can be remotely managed by using the WS-Man services for configuration, update, deployment, and maintenance.
PAGE 13
1 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) protocol using Windows WinRM and open source WSMANCLI command line utilities.
PAGE 14
2 References Lifecycle Controller Wiki www.delltechcenter.com/LC Dell 12th Generation PowerEdge Server Resources: http://www.delltechcenter.com/12thGen Dell CIM Profiles: http://www.delltechcenter.com/page/DCIM.Library.Profile Managed Object Format (MOF) files:| http://www.delltechcenter.com/page/DCIM.Library.MOF WinRM Scripting API, MSDN: http://msdn.microsoft.com/en-us/library/aa384469(VS.85).aspx Openwsman CLI: http://www.openwsman.
PAGE 15
3 Overview The remote interface guidelines provided in this document are illustrated by command line examples of the WS-Man protocol Web services APIs that expose the remote management capabilities of the Dell Lifecycle Controller. The command line examples are from the Microsoft Windows and Linux environments using WinRM4 and WSMANCLI5 respectively. The Lifecycle Controller remote management capabilities are organized by management domain and documented in Dell CIM Profile specifications2.
PAGE 16
3.2 WS-Man Security and Time Parameters 3.2.1 Encryption Certificate Security For the WS-Man examples provided in this document, the strict checks of certificates such as matching of CNs (Common Names) and verification with the actual CA (Certificate Authority) of the certificate of the WS-Management protocol HTTPS encryption certificate is assumed to be already configured and enabled. To disable the strict certificate checking, run the following command line options to all WS-Man examples: –v and –V.
PAGE 17
3.2.5 Return Values Many of the methods in this document have the following possible return values. They are summarized here for convenience. 0 = Success 1 = Not Supported 2 = Failed 4096 = Job Created 3.2.6 Specifying Integer values in WSMAN commands When specifying Integer values using WSMAN, refrain from using empty string as input as it internally gets converted to 0. EXAMPLE: ShareType is an Integer property used with WSMAN APIs such as ExportSystemConfiguration.
PAGE 18
4 Discovery 4.1 Discovering Web Service Capability Determine if the target System supports the Ws-Man 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.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic -u:[USER] -p:[PASSWORD] OUTPUT: http://schemas.dmtf.org/wbem/wsman/1/wsman.
PAGE 19
DCIM:CSRegisteredProfile:1 Base Server 2 1.0.0 DCIM_RegisteredProfile The example above shows that the DMTF Base Server profile version 1.0.0 is implemented. 4.
PAGE 20
The example shows that implementation namespace is “root/dcim”.
PAGE 21
5 Managing iDRAC Local User Accounts 5.1 Description of iDRAC Attributes Versus Standard DMTF Model The iDRAC user account management data model is represented by both DMTF and Dell Profiles. Both models are currently offered. The DMTF Profiles for Simple Identity Management and Role Based Authorization represent iDRAC user accounts and privileges.
PAGE 22
0 iDRAC.Embedded.1 Users Users.2 iDRAC.Embedded.1#Users.2#Enable false Disabled Enabled 5.2.
PAGE 23
5.3 Manage Account Settings (using iDRAC Attributes) When the account setting capability allows, the username of an account may be modified by invoking the ApplyAttributes() method on the UserName property. Confirmation of successful username or password verification can be obtained by enumerating the DCIM_iDRACCardString class( Section 19.6). 5.3.1 Modify User Name (using iDRAC Attributes) EXAMPLE: wsman invoke -a ApplyAttributes http://schemas.dmtf.
PAGE 24
5.3.2 Modify Password (using iDRAC Attributes) EXAMPLE: wsman invoke -a ApplyAttributes "http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_iDRACCardServ ice?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_iDRACCardService,SystemName=DCIM:ComputerSystem, Name=DCIM:iDRACCardService" -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic -J DracCard_Password.xml The input file, DracCard_Password.
PAGE 25
EXAMPLE: wsman invoke -a ApplyAttributes "http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_iDRACCardServ ice?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_iDRACCardService,SystemName=DCIM:ComputerSystem, Name=DCIM:iDRACCardService" -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic -J DracCard_AccountChange.xml The input file, DracCard_ AccountChange.xml, is shown below: PAGE 26
5.3.4 Modify User Privilege (using iDRAC Attributes) When the account setting capability allows, the user privileges may be enabled or disabled by invoking the method ApplyAttributes() method on the Enable property. Confirmation of the change can be obtained by enumerating the DCIM_iDRACCardString class( Section 19.6). EXAMPLE: wsman invoke -a ApplyAttributes "http://schemas.dmtf.
PAGE 27
5.4.1 Account and Capabilities (using DMTF Model) Example-A demonstrates standard ouput. Example-B demonstrates EPR mode output. EXAMPLE-A: wsman enumerate "http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/CIM_Account" -h $IPADDRESS -V –v -c dummy.
PAGE 28
DCIM_MFAAccount MFA Account 2 2 2
PAGE 29
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. Get the CIM_Account class instance of interest using EnumerateEPR mode. 2.
PAGE 30
DCIM:Account:Capabilities:1 0 2 3 5.4.2 Privilege and Capabilities (using DMTF Model) The account privilege assigned to you is defined in the class CIM_Privilege associated with the CIM_Account class.
PAGE 31
7 Login to DRAC Configure DRAC Configure Users Clear Logs Execute Server Control Commands Access Console Redirection Access Virtual Media
PAGE 32
Media, Test Alerts, Execute Di agnostic Commands Caption = null Description = null ElementName = Local Role Based Management Capabilities InstanceID =DCIM:LocalRoleBasedManagementCapabilities QualifierFormatsSupported = 9, 9, 9, 9, 9, 9, 9, 9, 9 SharedPrivilegeSupported = false SupportedMethods = 8 DCIM_CLPRoleBasedManagementCapabilities ActivitiesSupported = null ActivityQualifiersSupported = null Caption = null Description = null ElementName = CLP Role Based Management Capabilities InstanceID =DCIM:CLPRol
PAGE 33
When this command is executed, a list of objects will be returned. Below is a snippet of the output. OUTPUT-A: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymou s http://schemas.dell.
PAGE 34
2 3 DCIM User 1 D
PAGE 35
DCIM_MFAAccount MFA Account 16 2 2
PAGE 36
NOTE: The profile defines this property as a string array of type octet string. In this implementation, the password is a string of type clear text. The security concern is resolved by transmission of this information only through secure HTTPS communication. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP1034_1.0.1.pdf http://www.dmtf.org/sites/default/files/standards/documents/DSP1039_1.0.0.pdf See Section 5.5.1 for an implementation example. 5.5.
PAGE 37
Here is an example list of available privileges from an instance of the class.
PAGE 38
6 Firmware Inventory 6.1 Software Inventory Profile Specification The Dell Common Information Model (CIM) class extensions for supporting remote firmware inventory are defined in the Dell OS Software Update2 and related MOFs3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Inventory Profile. 6.
PAGE 39
false The key properties in the above output include the following: InstanceID: Normally identifies the firmware on a particular type of device. The substring right after DCIM: is the status of a payload or firmware on the System. This can be installed or available. ComponentID: Uniquely identifies a unique type of device such as BIOS, NIC, Storage and Lifecycle controller firmware.
PAGE 40
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 Profile2 and related MOF files3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Update Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 7.
PAGE 41
20100730121500 Task successfully scheduled JCP001 Rollback:DCIM:AVAILABLE:NONPCI:159:2.1.
PAGE 42
OUTPUT: When this method is executed, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/an onymous http://schemas.dell.
PAGE 43
The rollback input file, RollInputNIC.xml, is shown below: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 44
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. The second stage is to monitor the download. The download status may be monitored by enumerating or getting the instance of the corresponding job. 7.5.3 Reboot to Perform Update Once downloaded, the request needs to be scheduled.
PAGE 45
 SVID (Subvendor ID) = 1028 This refers to a Broadcom NetXtreme II BCM5709 network adaptor7. EXAMPLE: wsman invoke -a InstallFromURI http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_SoftwareInstal lationService?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 UpdateInputNIC.
PAGE 46
Insufficient Method Parameters SUP001 2 7.7 Update BIOS from HTTP, CIFS Share, NFS share, TFTP, or FTP The InstallFromURI() method takes the following input and downloads the Dell Update Package to the Lifecycle Controller in the target System. The method returns a jobid for an instance of DCIM_SoftwareUpdateJob that can be scheduled to run or queried for status at a later time.
PAGE 47
http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_ SoftwareIdentity [INSTANCEID] 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.
PAGE 48
The syntax for reboot.xml is: 2 OUTPUT: This method will return a reboot jobid that can be set to reboot the System immediately or at a later time. http://schemas.xmlsoap.
PAGE 49
OUTPUT: No 0 < n1:SetResult>Set PendingValue 7.9.2 Create a Config Job CreateConfigJob sets the pending value set by SetAttribute() method. EXAMPLE: wsman invoke -a CreateConfigJob http://schemas.dmtf.
PAGE 50
-u $USERNAME -p $PASSWORD -J SetSchedule.xml -j utf-8 -y basic The input file SetSchedule.xml is shown below: PAGE 51
16:00 7.9.5 Clear the Update Schedule Clears the schedule for the automatic updates, that has been set by the SetUpdateSchedule() method. EXAMPLE: wsman invoke -a ClearUpdateSchedule http://schemas.dmtf.
PAGE 52
Syntax for InstallFromRepository.xml PAGE 53
BC:30:5B:ED:50:38 Network_Firmware_KTT4W_WN64_14.5.5_X03.EXE Network_Firmware_KTT4W_WN64_14.5.5_X03.EXE 14.5.
PAGE 54
PAGE 55
8 Power State Management 8.1 Description of Base Server versus Power State Management Methods The remote control of a server power state (On, Off) and methodology for cycling power is available through data models specified in both the DMTF Base Server Profile and the DMTF Power State Management Profile. The Base Server Profile offers the RequestStateChange() method on the instance of the CIM_ComputerSystem class representing the server platform.
PAGE 56
8.2.2 Power State Management Method The power state of the System is also reported by the PowerState property of the DCIM_CSAssociatedPowerManagementService class. Power State Management Profile: http://www.dmtf.org/sites/default/files/standards/documents/DSP1027_2.0.0.pdf EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/DCIM_CSAssoci atedPowerManagementService -h $IPADDRESS -V -v -c dummy.
PAGE 57
root/dcim http://schemas.xmlsoap.org/ws/2004/08/addressing/role/an onymous http://schemas.dell.
PAGE 58
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 59
2 5 8 11 12 8.4 Power Control 8.4.1 Base Server Method Changing the power state, such as cycling the power, is performed by invoking the RequestStateChange() method of the CIM_ComputerSystem class instance.
PAGE 60
-u $USERNAME -p $PASSWORD -j utf-8 -y basic 60 Lifecycle Controller Web Services Interface Guide for Linux
PAGE 61
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 you to remote query the inventory of hardware. Each of the hardware inventory classes return the attribute LastSystemInventoryTime, which is when the last time ‘collect System inventory on restart’ or CSIOR was run. For more information about CSIOR, see Section 12.1.
PAGE 62
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 the fans of each platform including the fan speed sensor information. Each platform fan is represented by an instance of DCIM_FanView class.
PAGE 63
9.3 Memory Inventory This section describes the implementation for the DCIM_MemoryView class. The Dell Memory Profile describes physical memory of each platform. Each DIMM’s information is represented by an instance ofDCIM_MemoryView class. Profile and Associated MOFs http://www.delltechcenter.com/page/DCIM.Library.Profile Enumerate DCIM_MemoryView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.
PAGE 64
OUTPUT: B3 1 7 5 0 1 2 256 4 0 7
PAGE 65
Enumerate DCIM_iDRACCardView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCI M_iDRACCardView -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: iDRAC.Embedded.1-1 1.00.00 3132334f-c0b7-3480-3510-00364c4c454 2.0 iDRAC.Embedded.
PAGE 66
20120106113848.000000+000 20120106113829.000000+000 LSI Logic / Symbios Logic 0073 1F4E 1028 1000 0002 0002 9.
PAGE 67
Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile Enumerate the DCIM_VFlashView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCI M_VFlashView -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 1874 1882 vFlash SD Card Disk.
PAGE 68
NIC.Embedded.1-1-1 13.1.4 0 NIC.Embedded.1-1-1 20120106113848.000000+000 20111215170314.
PAGE 69
OUTPUT: 1 0 0 20.10.
PAGE 70
OUTPUT: System Memory Testing MemTest Disabled 306 BIOS.Setup.1-1 Memory Settings MemSettings BIOS.Setup.
PAGE 71
System.Embedded.1 20120106113848.000000+000 20111214060202.000000+000 1 2.0.0 Dell Inc.
PAGE 72
9.17 PCIe SSD Backplane Inventory New in 13G 9.18 Host Network Interface Inventory New in 13G 9.
PAGE 73
10 Job Control Management 10.1 Description of Job Management The Dell Common Information Model (CIM) class extensions for supporting update and attribute configuration job control are defined in the Dell Job Control Profile 2 and related MOF files3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can also be found in Dell Job Control Profile. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 10.
PAGE 74
Here the JobArray element shows a list of Jobids that are to be scheduled to run. TIME_NOW is a special value that represents “running the tasks immediately”. The UntilTime value specifies the “maintenance windows”. Once a task is not run after passing UntilTime, it should not be run again. Upon successfully invocation of the SetupJobQueue() method, the aforementioned times will be listed when enumerated in Section 10.2.3.
PAGE 75
OUTPUT: Return 0 for success or non-zero for error with messageID and message description. The specified job was deleted SUP020 0 An XML syntax error could display the following message: Syntax Error: input must be of the form {KEY="VALUE"[;KEY="VALUE"]} 10.2.
PAGE 76
Reboot1 JID_001299499853 00000101000000 Completed 20111111111111 Job completed successfully PR19 ConfigBIOS:BIOS.Setup.
PAGE 77
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 Profile2 and the DCIM_OSDeploymentService MOF file3. The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell OS Deployment Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 11.
PAGE 78
DCIM_ComputerSystem DCIM:ComputerSystem 12 11.3 OS Deployment Method Invocation Examples 11.3.
PAGE 79
SUSE Linux Enterprise Server 10 SP2 64-bit SUSE Linux Enterprise Server 11 64-bit ESX 3.5 U4 ESX 4.0 0 6.1.0.7 11.3.
PAGE 80
11.3.3 Detach Emulated USB Device Containing Drivers This method is used to detach the USB device at tached to the System by a prior invocation of the UnpackAndAttach() method. Invoke DetachDrivers() with the following syntax: EXAMPLE: wsman invoke -a DetachDrivers http://schemas.dmtf.
PAGE 81
OUTPUT: Returns 0 for success or 1 if an error occurred in starting the processing of input parameters. The MessageID and Message output parameters will further contain method invocation information if an error occurred. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/an onymous http://schemas.dell.
PAGE 82
DCIM_OSDConcreteJob:1 UnpackAndShare 1 Failed
PAGE 83
[NFS_Password]: This is the corresponding password to the username containing the ISO image. [OS.ISO]: This is to be replaced by the actual name of the ISO image. EXAMPLE: wsman invoke -a BootToNetworkISO http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentSe rvice?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService,SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 84
11.3.7 Detach Network ISO USB Device This method is used to detach the emulated USB device that had been attached by calling the earlier BootToNetworkISO() method. Invoke DetachISOImage() with the following syntax: EXAMPLE: wsman invoke -a DetachDrivers http://schemas.dmtf.
PAGE 85
11.3.9 Get Host MAC Address Information Invoke GethostMACInfo() with the following syntax: EXAMPLE: wsman invoke -a GetHostMACInfo http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentSe rvice?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService,SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 86
-k Password="[SHAREPASSWORD]" -k ImageName="[IMAGENAME]" –k PORT=”[PORT]” -j utf-8 -y basic OUTPUT: Returns 0 for success or 1 if an error occurred in starting the processing of input parameters. The MessageID and Message output parameters will further contain method invocation information if an error occurred. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/an onymous http://schemas.dell.
PAGE 87
11.3.11 Boot to ISO from VFlash This method will display the ISO Image available on VFlash as a CD-ROM device to the host server and boots to it. Invoke BootToISOFromVFlash() with the following syntax: EXAMPLE: wsman invoke -a BootToISOFromVFlash http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentSe rvice?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService,SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v –c dummy.
PAGE 88
ISO Image not found on VFlash OSD41 2 11.3.13 Detach ISO from VFlash The DetachISOFromVFlash() method will detach the ISO image in the VFlash from the System. Invoke DetachISOFromVFlash() with the following syntax: EXAMPLE: wsman invoke -a DetachISOFromVFlash http://schemas.dmtf.
PAGE 89
-k -k -k –k IPAddress="[CIFS_or_NFS_IPaddress]" -k ShareName="/[CIFS_or_NFS]" ShareType="[2_or_0]" -k Username="[CIFS_or_NFS_Username]" Password="[CIFS_or_NFS_Password]" -k Workgroup="WORKGROUP" ImageName="[OS.ISO]" -j utf-8 -y basic OUTPUT: Returns 0 for success or 1 if an error occurred in starting the processing of input parameters. The MessageID and Message output parameters will further contain method invocation information if an error occurred.
PAGE 90
11.3.16 Skip ISO Image Boot This method can be used to skip the target System from booting to a bootable ISO image (connected using ConnectNetworkISOImage method) one time only for next immediate host reboot. After that host server will continue to boot to the ISO image. Invoke SkipISOImageBoot() using an NFS share with the following syntax: EXAMPLE: wsman invoke -a SkipISOImageBoot http://schemas.dmtf.
PAGE 91
11.3.18 Connect RFS ISO Image The ConnectRFSISOImage() method is used to connect the ISO image that is mounted through Remote File Share (RFS) and is made available to the host System as a USB-based CD-ROM device. The successful execution of this method shall connect to the ISO located on NFS/CIFS share to the host server and expose it as a virtual CD-ROM device using RFS USB endpoint. The successful execution of the method shall not change the boot order of that device.
PAGE 92
Concrete jobs return 4096 upon successful invocation. Poll for the concrete job “JobStatus = Success”. 11.3.19 Disconnect RFS ISO Image The DisconnectRFSISOImage() method is used to disconnect and detach the ISO Image that is mounted through Remote File Share (RFS) and is made available to the host System as a USB-based CD-ROM device. Invoke DisconnectRFSISOImage() with the following syntax: EXAMPLE: wsman invoke -a DisconnectRFSISOImage http://schemas.dmtf.
PAGE 93
Invoke BootToHD() with the following syntax: EXAMPLE: wsman invoke -a BootToHD http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentSe rvice?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: 0 11.3.
PAGE 94
http://schemas.dell.
PAGE 95
12 Lifecycle Controller Management Profile The LC Management Profile describes the LC attribute configuration service and the collections and attributes instances that the service manages. The profile also describes the relationship of the LC attribute service to the DMTF/Dell profile version information and Dell Job Control profile.
PAGE 96
wsman invoke -a SetAttributes 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 SetAttributes_LC.xml -j utf-8 -y basic The input file SetAttributes_LC.xml is shown below: PAGE 97
OUTPUT: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/an onymous http://schemas.dell.
PAGE 98
JobStatus = Completed JobUntilTime Message = Detach partition successful MessageArguments = null MessageID = VF038 Name = VFlashDetach:Partition1 DCIM_LifecycleJob InstanceID = JID_001273099184 JobStartTime = 20191010101010 JobStatus = COMPLETED JobUntilTime = 2009:8:11 Message = The command was successful MessageArguments = null MessageID = LC001 Name = LC Config . . . 12.2.
PAGE 99
12.2.5 Get Part Firmware Update Attribute Get the current Part Replacement firmware update mode as follows: EXAMPLE: wsman get http://schemas.dell.com/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCEn umeration?InstanceID=LifecycleController.Embedded.1#LCAttributes.1#PartFirmwar eUpdate -h $IPADDRESS -V -v -c dummy.
PAGE 100
-u $USERNAME -p $PASSWORD -J ReInitiateDHS.xml -j utf-8 -y basic The input file ReInitiateDHS.xml containing the parameters for the ReInitiateDHS method is shown below: PAGE 101
The input file SetProvisioningServer.xml is shown below: Provisioning Server [PS_IP_ADDRESS] OUTPUT-B: This method will return status 0 or a message is displayed indicating an error.
PAGE 102
EXAMPLE: wsman invoke -a DownloadServerPublicKey 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 DownloadServerPublicKey.xml -j utf-8 -y basic The input file DownloadServerPublicKey.xml is shown below: PAGE 103
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.xml is shown below: PAGE 104
12.8 Delete Auto-Discovery Client Certificates This method is used to delete the client certificates set earlier by the auto discovery method. Invoke DeleteAutoDiscoveryClientCerts() with the following parameters and syntax: EXAMPLE: wsman invoke -a DeleteAutoDiscoveryClientCerts http://schemas.dmtf.
PAGE 105
OUTPUT: 0 12.10 Set iDRAC Certificate and Private Key This method is used to update an iDRAC certificate and private key pairs using the contents of a PKCS#12 file. Invoke SetCertificateAndPrivateKey() with the following parameters and syntax: Type : Specifies the service the certificate is for: server = web server PKCS12: Represents the base64 encoded contents of PKCS#12 file to upload.
PAGE 106
EXAMPLE: wsman invoke -a DeleteAutoDiscoveryServerPublicKey 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 utf-8 -y basic OUTPUT: 0 12.
PAGE 107
Workgroup: This is the applicable workgroup. 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.xml is shown below: PAGE 108
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 ExportCompleteLCLog http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCService? SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_LCService, SystemName=DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v –c dummy.cert -P 443 -u $USERNAME -p $PASSWORD –J ExportCompleteLCLog.
PAGE 109
Workgroup: This is the applicable workgroup. EXAMPLE: wsman invoke -a ExportHWInventory 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 ExportHWInventory.xml -j utf-8 -y basic The input file ExportHWInventory.xml is shown below:
PAGE 110
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 ExportFactoryConfiguration http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService? SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_LCService, SystemName=DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.
PAGE 111
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 utf-8 -y basic OUTPUT: 0 12.
PAGE 112
EXAMPLE: wsman invoke -a ExportSystemConfiguration 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 ExportSystemConfiguration.xml -j utf-8 -y basic The input file ExportSystemConfiguration.xml is shown below:
PAGE 113
EXAMPLE: wsman invoke -a ImportSystemConfiguration 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 ImportSystemConfiguration.xml -j utf-8 -y basic The input file ImportSystemConfiguration.xml is shown below:
PAGE 114
EXAMPLE: wsman invoke -a ImportSystemConfigurationPreview http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCService? SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_LCService, SystemName=DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert P 443 -u $USERNAME -p $PASSWORD -J ImportSystemConfigurationPreview .xml -j utf-8 -y basic Format for ImportSystemConfigurationPreview.xml PAGE 115
12.22.1 Run Diagnostics DCIM_LCService.RunePSADiagnostics: The method is used to run the diagnostics on basis of the runmode switch and save the report in the internal storage area. The diagnostics can be run in either express or extended mode or as a long run which encompasses all diagnostic tests. EXAMPLE: WSMAN i RunePSADiagnostics http://schemas.dmtf.org/wbem/wscim/1/cim http://schemas.dmtf.
PAGE 116
12.22.3 Verify the Diagnostics Job Status EXAMPLE WSMAN e http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LifeCyclejob -u:%Username% -p:%Password% r:https://%IPAddress%/wsman -SkipCNcheck -SkipCAcheck -encoding:utf-8a:basic OUTPUT: DCIM_LifeCyclejob ElapsedTimeSinceCompletion = null InstanceID = JID_660055291735 JobStartTime = TIME_NOW JobStatus = Scheduled JobUntilTime = TIME_NA Message = Task successfully scheduled.
PAGE 117
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 118
13.2 Initialize the Virtual Flash Media Enumerate the DCIM_PersistentStorageService class Invoke the InitializeMedia method on the instance above The OUT parameter Job will refer to the instance of CIM_ConcreteJob using which you can query the status of the initialization of the media. 13.2.
PAGE 119
OUTPUT: After running this method, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymou s http://schemas.dell.
PAGE 120
13.3 Enable or Disable VFlash using VFlash State Change This method is used to enable or disable the virtual flash media device. After running the VFlashStateChange() method successfully, the change will be dictated in the VFlashEnabledState parameter as shown in Section 13.2.1 and Section 13.2.3. Invoke VFlashStateChange() with the following parameters and syntax: RequestedState: The state to set to. Enable=1, Disable=2 EXAMPLE: wsman invoke -a VFlashStateChange http://schemas.dmtf.
PAGE 121
The input file CreatePartition.xml is shown below: 1 50 1 2 label1 OUTPUT: After running this method, a jobid or a message is displayed indicating an error.
PAGE 122
URI: The URI location of firmware to update a component. Supported protocols are FTP and HTTP. IPAddress: IP address of TFTP or NFS share ShareType: Type of share. NFS=0, TFTP=1, CIFS=2, FTP=3, HTTP=4 SharePath: NFS sharepoint address ImageName: Name of the ISO or IMG image. Workgroup: Name of the workgroup, if applicable. Username: The username to be used to access the file. Password: The password to be used to access the file. Port: The port number to be used. HashType: The hash type.
PAGE 123
JID_001300793471 root/dcim 4096 13.6 Delete Partition This method is for deleting a partition on a storage device.
PAGE 124
  Enumerate the DCIM_PersistentStorageService class Invoke the FormatPartition() method on the instance above with the following parameters: PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be formatted. 1 to 16 FormatType: The new format type of the partition. EXT2=1, EXT3=2, FAT16=3, FAT32=4 The OUT parameter Job will refer to the instance of CIM_ConcreteJob using which you can query the status of the formatting of the partition.
PAGE 125
PartitionIndex: The PartitionIndex property of the DCIM_OpaqueManagementData instance that represents the partition to be modified. 1 to 16 AccessType: The type of access level. Read-Only=1, Read-Write=3 The OUT parameter Job will refer to the instance of CIM_ConcreteJob using which you can query the status of the modification of the partition. EXAMPLE: wsman invoke -a ModifyPartition http://schemas.dmtf.
PAGE 126
OUTPUT: After running this method, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/an onymous http://schemas.dell.
PAGE 127
JID_001300787520< /wsman:Selector> root/dcim 4096 If the partition is already detached, the following message may be displayed: Partition already detached VF028 2
PAGE 128
The input file ExportDataFromPartition.xml is shown below: 1 123.456.7.8 2 /temp imagename.
PAGE 129
14 Boot Control Configuration Management This feature provides the ability to get and set the boot order configuration. The Boot Control Profile describes the classes, associations, properties, and methods used to manage the boot control configurations of a physical or virtual computer System. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 14.
PAGE 130
14.2 Getting a Boot ConfigSetting Instance Getting the boot configuration current, default, and next attributes of one particular boot configuration instance is an alternative to enumerating all available instances as shown in Section 14.1. Get a BootConfigSetting instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 14.1, in which this example uses an IPL as an instanceID. EXAMPLE: wsman get http://schemas.dmtf.
PAGE 131
Embedded SATA Port A Optical: TSSTcorpDVD-ROM TS-L333A UefiBootSeq Embedded SATA Port A Optical: TSSTcorpDVD-ROM TS-L333A UefiBootSeq 0 1 Embedded SATA Port A Optical: TSSTcorpDVD-ROM TS-L333A UefiBootSeq 1 UEFI:Optical.SATAEmbedded.
PAGE 132
BOOT001 0 14.5 Enable or Disable the Boot SourceChangeBootSourceState() The ChangeBootSourceState() method is called to change the enabled status of BootSourceSetting instances to Disable or Enable. The input parameter, source, is an array of InstanceID of BootSourceSetting instances. Enumerating the BootSourceSetting Class in Section 14.
PAGE 133
15 NIC or CNA Card Management This feature provides the ability to get and set the Network Interface (NIC) Card or Converged Network Adapter (CNA) attributes that are configurable using NIC/CNA Option-ROM or NIC/CNA UEFI HII.
PAGE 134
IscsiTgtBoot Enabled NIC.Embedded.3-1 NIC.Embedded.
PAGE 135
0 0 VirtIscsiMacAddr 00:22:19:59:B2:20 NIC.Embedded.1-1 NIC.Embedded.
PAGE 136
NIC.Embedded.1-1:LunBusyRetryCnt false 0 60 FirstTgtTcpPort 3260 NIC.Embedded.1-1 NIC.Embedded.
PAGE 137
14E4 00:22:19:59:B2:1F 00:22:19:59:B2:20 Broadcom NetXtreme II Gigabit Ethernet 00:22:19:59:B2:1F 2 2 2 00:22:19:59:B2:25 2
PAGE 138
0 0 0 0 0 3 NIC.Embedded.
PAGE 139
NIC.Embedded.1-1-1 NIC.Embedded.
PAGE 140
EXAMPLE: wsman invoke -a CreateTargetedConfigJob 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 CreateTargetedConfigJob_NIC.xml -j utf-8 -y basic The input file CreateTargetedConfigJob_CNA.xml is shown below:
PAGE 141
The input file DeletePendingConfiguration_CNA.xml is shown below: NIC.Integrated.1-1-1 OUTPUT: The command was successful NIC001 0 15.
PAGE 142
For the Qlogic CNA cards, partition three can be set to either NICMode or IscsiOffloadMode. Partition four can be set to either NICMode or FcoeOffloadMode. Invoke the SetAttribute() method with the following parameters (from Section 15.1) and syntax: Target: FQDD attained through DCIM_NICEnumeration AttributeName: Attained from AttributeName field AttributeValue: A new value to assign to the specified NICAttribute.
PAGE 143
AttributeValue: A new value assigned to the specified NICAttribute. If this value is valid, it is applied to the PendingValue property or the Currentvalue property of the specified NICAttribute. Range of selection is attained from the LowerBound and UpperBound fields: LowerBound = 0 UpperBound = 100 EXAMPLE: wsman invoke -a SetAttribute http://schemas.dmtf.
PAGE 144
-u $USERNAME -p $PASSWORD -J SetAttribute_CNA_VirtMacAddr.xml -j utf-8 -y basic The input file SetAttribute_NIC.xml is shown below: NIC.Integrated.
PAGE 145
PXE OUTPUT: The command was successful NIC001 Yes 0 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.
PAGE 146
Set PendingValue 15.15 Setting the iSCSI Boot Target The SetAttributes() method is used to set or change the values of the iSCSI boot target attributes. Invoke the SetAttributes() method with the following parameters (from 15.1) and syntax: Target: FQDD attained through DCIM_NICEnumeration AttributeName: Attained from AttributeName field AttributeValue: A new value to assigned the specified NICAttribute.
PAGE 147
FirstTgtChapPwd testpassword2 OUTPUT: The command was successful NIC001 Yes 0 Set PendingValue 15.
PAGE 148
Set PendingValue 148 Lifecycle Controller Web Services Interface Guide for Linux
PAGE 149
16 RAID Storage Management The remote RAID configuration allows you to remotely query and configure the Hardware RAID of the System. The RAID profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of RAID storage. The RAID storage is modeled as collections of attributes where there are collections for the storage adaptors, physical disk drives, logical disks, end enclosures and parent-child relationships between the collections.
PAGE 150
Automatic Disabled RAIDBatteryLearnMode Warn only RAID.Integrated.1-1 RAID.Integrated.1-1:RAIDBatteryLearnMode false The ‘set attributes’ method in section 16.19.
PAGE 151
Disabled
PAGE 152
false The ‘set attribute’ method in Section 16.19.3 1 uses the FQDD, AttributeName, and a value equal to or between the LowerBound and 100 UpperBound fields as input. RAIDreconstructRate 33 RAID.Integrated.1-1 RAID.Integrated.
PAGE 153
EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimhttp://schemas.dmtf.org/wbem/wscim/1/c im-schema/2/root/dcim/DCIM_RAIDStringschema/2/root/dcim/DCIM_RAIDString -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 154
16.7 Listing the RAID Inventory-ControllerView Class The DCIM_ControllerView class groups together a set of Controller properties. Enumerate ControllerView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCI M_ControllerView -h $IPADDRESS -V -v -c dummy.
PAGE 155
16.8 Getting a RAID ControllerView Instance The get() command can be invoked using a particular instanceID, attained from listing the inventory. Get a RAID ControllerView instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 16.7, in which this example uses RAID.Slot.1-1 as an instanceID EXAMPLE: wsman get http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_Cont rollerView?InstanceID=[INSTANCEID] -h $IPADDRESS -V -v -c dummy.
PAGE 156
16.9 Listing the RAID Inventory-PhysicalDiskView Class Enumerating the PhysicalDiskView, results in the attributes and inventory of the available physical disk drives in the System. Enumerate PhysicalDiskView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCI M_PhysicalDiskView -h $IPADDRESS -V -v -c dummy.
PAGE 157
16.10 Listing the RAID VirtualDiskView Inventory Enumerating the VirtualDiskView, results in the attributes and inventory of the available virtual disks in the System. Enumerate VirtualDiskView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCI M_VirtualDiskView -h $IPADDRESS -V -v -c dummy.
PAGE 158
Disk.Virtual.0:RAID.Slot.1-1 20120116145459.000000+000 20120116145459.000000+000 0 1 Virtual Disk 00 0 None 0 Disk.Bay.0:Enclosure.Internal.0-0:RAID.Slot.
PAGE 159
20110316141312.000000+000 0 0 BACKPLANE 0:0 0 8 0 1.07 0 16.
PAGE 160
OUTPUT: YES 0 16.16 Clearing the Foreign ConfigurationClearForeignConfig() The ClearForeignConfig() method is used to prepare any foreign physical disk drives for inclusion in the local configuration. Invoke ClearForeignConfig() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.
PAGE 161
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, you should comment out the RebootJobType in the input xml. You should not enter “0” or give no parameter at all in the input XML. ScheduledStartTime & UntilTime: See Section 3.2.4 EXAMPLE: wsman invoke -a CreateTargetedConfigJob http://schemas.dmtf.
PAGE 162
16.18 Deleting the Pending Values for RAIDDeletePendingConfiguration() The DeletePendingConfiguration() method cancels the pending configuration changes made before the configuration job is created with CreateTargetedConfigJob(). This method only operates on the pending changes prior to CreateTargetedConfigJob() being called. After the configuration job is created, the pending changes can only be canceled by calling DeleteJobQueue() in the Job Control profile.
PAGE 163
The input file GetDHSDisks.xml is shown below: DISK.Virtual.1:RAID.Integrated.1-1 OUTPUT: GetDHSDisks_OUTPUT ReturnValue = 0 The following message may be fixed by deleting the job queue as referenced in Section 10.2.2.
PAGE 164
  Physical disk is wrong type for the virtual disk (i.e. SATA PD to be used as hot spare for SAS VD) Similar conditions when no VD referenced, which is the global hot-spare attempted assignment ERROR MESSAGE: Physical disk FQDD did not identify a valid physical disk for the operation STOR009 2 16.19.
PAGE 165
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.xml is shown below:
PAGE 166
STOR022 2 16.20.3 Locking the Controller with a Key-EnableControllerEncryption() The EnableControllerEncryption() method is used to set either Local Key encryption or Dell Key Manager (DKM) encryption on controllers that support encryption of the drives. Invoke EnableControllerEncryption() method with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView class.
PAGE 167
OUTPUT: This method requires a PERC controller with Local Key encryption or DKM support to function correctly. YES 0 16.20.4 Rekeying the Controller-ReKey() The ReKey() method is used to reset the key on the controller that supports encryption. This method switches the controller mode between Local Key encryption or Dell Key Manager (DKM) encryption.
PAGE 168
1 OUTPUT: Controller is not security capable STOR022 2 16.20.5 Removing the Key-RemoveControllerKey() The RemoveControllerKey() method is used to erase the key on the controller along with the attached encrypted drives.
PAGE 169
Include SSD only=2 Diskprotocol: Types of protocol to include Include all protocols=0 Include SATA=1 Include SAStypes=2 DiskEncrypt: Types of encryption to include 0 = Include FDE capable and non encryption capable disks 1 = Include FDE disks only 2 = Include only non FDE disks PDArray: This parameter is the list of physical disk FQDDs EXAMPLE: wsman invoke -a GetRAIDLevels http://schemas.dmtf.
PAGE 170
RAID 10 = 2048 RAID 50 = 8192 RAID 60 = 16384 16.21.2 Getting the Available Disks-GetAvailableDisks() The GetAvailableDisks() method is used to determine possible selection of drives to create virtual disks. Invoke GetAvailableDisks() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) DiskType: Corresponds to MediaType attribute in PhysicalDiskView ( Section 16.
PAGE 171
16.21.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 valuesto run the method successfully. Invoke CheckVDValues() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) PDArray: This parameter is the list of physical disk FQDDs (Section 16.
PAGE 172
If the arrangement of physical disk drives prohibits a valid virtual disk arrangement from being created, such as having too few hard disk drives, the following error may result: Virtual Disk provided is not valid for the operation STOR017 2 16.21.
PAGE 173
64KB = 128 128KB = 256 256KB = 512 512KB = 1024 1MB = 2048 ReadPolicy: No Read Ahead = 16 Read Ahead = 32 Adaptive Read Ahead = 64 WritePolicy: Write Through = 1 Write Back = 2 Write Back Force = 4 DiskCachePolicy: Enabled = 512 Disabled = 1024 VirtualDiskName: Name of the virtual disk (1-15 character range) EXAMPLE: wsman invoke -a CreateVirtualDisk http://schemas.dmtf.
PAGE 174
OUTPUT: The instanceID output will identify this virtual disk in inventory before and after its creation by the CreateTargetedConfigJob. Note: However, that the instanceID will change slightly after successful creation. CreateVirtualDisk_OUTPUT NewVirtualDisk Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimhttp://schemas.dell.
PAGE 175
SpanDepth: If not specified, default is single span which is used for RAID 0, 1, 5 and 6. Raid 10, 50 and 60 require a spandepth of at least 2. SpanLength: Number of Physical Disk Drives to be used per span. Minimum requirements for given RAID Level must be met.
PAGE 176
RAIDLevel SpanDepth SpanLength Size VirtualDiskName StartingLBA 4 1 2 100 virtualdiskname
PAGE 177
,SystemName=DCIM:ComputerSystem,Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J CreateVDCacheCade.xml -j utf-8 -y basic The input file CreateVDCacheCade.xml is shown below: RAID.Integrated.1-1 Disk.Bay.4:Enclosure.Internal.0-0:RAID.Integrated.
PAGE 178
The input file DeleteVirtualDisk.xml is shown below: PAGE 179
EXAMPLE: wsman invoke -a CancelBackgroundInitialization "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_RAIDService? SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_RAIDService ,SystemName=DCIM:ComputerSystem,Name=DCIM:RAIDService" -h $IPADDRESS-V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -k Target="Disk.Virtual.0:RAID.Integrated.1-1" -j utf-8 -y basic 16.21.
PAGE 180
16.21.12 Online capacity expansion -OnlineCapacityExpansion() This method allows to increase the storage capacity of selected RAID levels while the System remains online. The operation can perform in two ways: 1. Increase the virtual disk capacity up to maximum if there is free space in physical disks. 2. Increase the virtual disk capacity by adding new physical disks. This configuration supported by both staged and real time.
PAGE 181
1. By adding new physical disks (change R0 to R1 by adding new drive, if the source raid level has only one disk) 2. Without adding physical disks (change R0 to R1 without adding new drive, if the source raid level already has minimum required disks of 2). Notes:   No RLM is supported on spanned VDs – thus no RLM s possible on RAID10, RAID50 and RAID60 VDs. No RLM is supported if other operations like BGI, rebuild, copyback, ccheck, patrolread etc is running on a VD.
PAGE 182
–k AssetName=”Proposed enclosure asset name -j utf-8 -y basic 16.21.15 Set enclosure asset tag -SetAssetTag() The method is used to set the external enclosure asset tag. This configuation is supported by both staged and real time. Upon success of the method, the property “AssetTag” under DCIM_EnclosureView class will be changed with the proposed value. Invoke SetAssetTag() method with the following input parameters: TARGET: FQDD of the enclosure. AssetTag: New asset tag to be entered.
PAGE 183
OUTPUT: The method was successful STOR001 Yes 0 Set Pending Value 16.22.2 Changing Multiple Values of RAID Controller Enumeration Attributes The SetAttributes() method is used to set or change multiple values of RAID controller or virtual disk attributes.
PAGE 184
16.22.3 Changing the Value of a RAID Controller Integer Attribute The SetAttribute() method is used to set or change the value of a RAID controller integer attribute. The example below shows setting an controller attribute. Invoke the SetAttribute() method with the following parameters (from Section 16.
PAGE 185
The input file SetAttributes_Integer_RAID_Controller.xml is shown below: RAID.Integrated.
PAGE 186
16.24 Convert Physical Disk Drives to Non RAIDConvertToNonRAID() The ConvertToNonRAID() method is used to convert a physical disk drives in RAID state of “Ready” to a Non-RAID state. After the method is successfully ran, the PendingValue property of RAIDPDState should reflect the pending changes. After the CreateTargetedConfigJob method is successfully ran, the RAIDStatus property, which is enumerated in the DCIM_PhysicalDiskView from Section 16.9, of that physical disk drive should reflect the new state.
PAGE 187
17 Managing BIOS Configuration This feature provides the ability to get and set any configurable BIOS attributes that are available in BIOS UEFI HII. The BIOS Management Profile extends the management capabilities of referencing profiles by adding the capability to represent and configure BIOS attributes, such as a Network Controller or IDE Controller. Profile and Associated MOFs http://www.delltechcenter.com/page/DCIM.Library.Profile 17.
PAGE 188
BIOS UEFI The ‘set attributes’ method in BootSeqRetry Section 17.4 will use the Disabled AttributeName and PossibleValues fields as input. BIOS.Setup.1-1 BIOS.Setup.
PAGE 189
EXAMPLE: 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:B IOSService -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.xml is shown below:
PAGE 190
OUTPUT: The command was successful BIOS001 Yes 0 Set PendingValue 17.5 Listing the BIOS Inventory-Integer Class Enumerate BIOSInteger with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.
PAGE 191
AssetTag BIOS.Setup.1-1 BIOS.Setup.1-1:AssetTag false 10 0 17.
PAGE 192
OUTPUT: After running this method, a jobid or a message is displayed indicating an error. The status of this jobid can be checked within the job control provider in Section 10. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymou s http://schemas.dell.
PAGE 193
0 17.9 17.9 Managing BIOS Passwords The ChangePassword() method is used to set the BIOS passwords. You can either set, change or delete the BIOS System or setup password. Setting the BIOS password is performed in several stages as described in the following sections. 17.9.1 Setting the BIOS Password The following example sets the BIOS System password to “NEW_PASSWORD”.
PAGE 194
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 195
OUTPUT: System Password SysPassword Locked ]> 1402 BIOS.Setup.1-1 System Security SysSecurity BIOS.Setup.
PAGE 196
18 Exporting and Importing Server Profile Use this feature to back up and restore host server profile. You can take a backup of current System configuration that is stored in a backup image file. Use Restore at anytime to put the System to prebackup state. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 18.1 Exporting Server Profile To backup host System server profile, invoke the BackupImage() method in the class DCIM_LCService.
PAGE 197
18.1.2 Exporting Server Profile to NFS Share-BackupImage() NFS Share: ShareType is “0”. 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 198
JID_001300820180 root/dcim 4096 The response contains a reference to the job class that will provide the status of the operation. The return value is 4096 which indicates that the method operation is not yet complete. 18.1.
PAGE 199
temCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_LCService,Syst emName=DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v –c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_LC.xml -j utf-8 -y basic The syntax for SetAttribute.xml
PAGE 200
OUTPUT: The autobackup.xml file contains the parameters to be passed to the SetBackupSchedule() method in XML format. A sample autobackup.xml file is given here. 4 IMAGENAME.
PAGE 201
[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 uses a passphrase. The following examples restore the server profile and execute it immediately, using the TIME_NOW parameter. 18.3.1 Importing Server Profile from iDRAC vFlash Card-RestoreImage() iDRAC vFlash Card: ShareType is “4”. wsman invoke -a RestoreImage http://schemas.dmtf.
PAGE 202
-j -k -k -k –k utf-8 -y basic IPAddress="[SHARE_IPADDRESS]" -k ShareName="/[DRIVESHARE]" ShareType="2" -k Username="[SHARE_USERNAME]" Password="[SHARE_PASSWORD]" –k Passphrase="[PASSPHRASE]" ImageName="[IMAGENAME]" –k ScheduledStartTime="TIME_NOW" NOTE: The ShareName field should only be the folder available by the System to the network. Any sub folder information should be attached to the ImageName field. Otherwise, there can be connection issues when trying to locate or create the backup file.
PAGE 203
30 The status may be one of the following:     203 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 Lifecycle Controller Web Services Interface Guide for Linux
PAGE 204
19 iDRAC Configuration This feature provides the ability to remotely list, get, and set the attributes on various monolithic and modular servers for the three Dell iDRAC classes through the command line.  DCIM_iDRACCardEnumeration ( 19.1)  DCIM_iDRACCardInteger ( 19.4)  DCIM_iDRACCardString ( 19.6) Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 19.
PAGE 205
IPv4 Enable Enable Enabled Enabled 0 iDRAC.Embedded.1 IPv4 IPv4.1 iDRAC.Embedded.1#IPv4.
PAGE 206
Enabled Enabled 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.1#Enable false Disabled Enabled 19.
PAGE 207
VLan ID VLanID 1 1 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 208
NIC.1#VLanEnable Disabled VirtualMedia.1#Attached Dettached IPv4.1#Enable Enabled IPv4.1#DHCPEnable Enabled IPv4.
PAGE 209
Run the Get() command on DCIM_LifecycleJob with the following parameters and syntax: EXAMPLE: wsman get http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_Life cycleJob?InstanceID=$INSTANCEID -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD –j utf-8 –y basic The input parameter is the InstanceID from the output of the ApplyAttributes() method.
PAGE 210
false Detached Attached Autoattach IPv4 Enable Enable Enabled Enabled 0
PAGE 211
OUTPUT: VLan Priority VLanPriority 0 0 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 212
OUTPUT: VLan Priority VLanPriority 0 0 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 213
NIC NIC.1 iDRAC.Embedded.1#NIC.1#DNSRacName false 63 1 IP Address Address 10.35.0.104 192.168.0.
PAGE 214
The possible inputs for GroupID are: NIC.1 IPv4.1 Users.3 OUTPUT: DNS RAC Name DNSRacName idrac-59JJ6K1 0 iDRAC.Embedded.1 NIC NIC.1 iDRAC.Embedded.1#NIC.
PAGE 215
19.9 Changing the iDRAC IP Change Notification 19.9.1 Getting the Current iDRAC IPChange State Get the IPChangeNotifyPS attribute from the DCIM_LCAttribute class to display. The CurrentValue field indicates the current status of this attribute. EXAMPLE: wsman get http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCAt tribute ?InstanceID=DCIM_LCEnumeration:DHS3 -h $IPADDRESS -V -v -c dummy.
PAGE 216
No 0 Set CurrentValue To verify the changes after running the set attribute, list the LC attributes as shown in Section 19.8.1.
PAGE 217
20 Remote Service Status To get the remote service status, invoke the GetRemoteServicesAPIStatus() method in the class DCIM_LCService. This method is used to obtain the overall remote services API status that includes both the host System status as well as the Lifecycle Controller (Data Manager included) status. The overall rolled up status shall be reflected in the Status output parameter.
PAGE 218
Output parameter Name Possible values Description 2 (Out of POST) Server is out of POST 3 (Collecting System Inventory) Server is currently executing UEFI Collect System Inventory On Restart application 4 (Automated Task Execution) Server is currently executing scheduled jobs using UEFI Automated Task application 5 (Lifecycle Controller Unified Server Configurator) Server is executing UEFI Lifecycle Controller Unified Server Configurator application 0 (Ready) Lifecycle Controller instrumentation
PAGE 219
21 System Information The DCIM System Info Profile describes the properties and interfaces for executing System management tasks related to the management of the host System. The profile standardizes and aggregates the description for the platform’s basic properties into a System view representation and provides static methodology for the clients to query the System views without substantial traversal of the model. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 21.
PAGE 220
1 3132334f-c0b7-3480-3510-00364c4c4544 1 1 1 336 3 2 3 3 7654
PAGE 221
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.1 Listing the Sensors Inventory-PSNumericSensor Class Enumerate the DCIM_PSNumericSensor class with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.
PAGE 222
2 222 Lifecycle Controller Web Services Interface Guide for Linux
PAGE 223
23 Managing Fiber Channel (FC) Configuration The Fiber Channel Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of fiber channel host bus adapters (FC HBA). The FC HBAs are modeled as views and attributes where there is a view for each individual controller and multiple attributes that allow FC HBA configuration. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 23.
PAGE 224
1 FC.Slot.4-1 FC.Slot.4-1:PortNumber true 0 2 23.2 Listing the FC Inventory-Statistics Class If RT-CEM is disabled on the System, this method will return failure.
PAGE 225
23.3 Listing the FC Inventory-String Class Enumerate FCStatistics class with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCI M_FCString -h $IPADDRESS -V -v -c dummy.
PAGE 226
FC.Slot.4-1 FC.Slot.4-1:PortNumber true 0 2 23.5 Listing the FC Inventory-Enumeration Class Enumerate FCEnumeration class with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.
PAGE 227
EXAMPLE: wsman invoke -a SetAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCService? SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_FCService,S ystemName=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 SetAttribute_FC.xml is shown below: PAGE 228
The input file apply_pending_fc.xml is shown below: FC.Slot.2-2 2 TIME_NOW 20151111111111 OUTPUT: After running this method, a job ID or message is displayed indicating an error.
PAGE 229
The input file Delete_Pending_fc.xml is shown below: PAGE 230
0 00:00:00:00:00:00:00:00 20:00:00:24:FF:2E:36:B1 20:00:00:24:FF:2E:36:B1 20:00:00:24:FF:2E:36:A0 21:00:00:24:FF:2E:36:A0 .
PAGE 231
24 GroupManager Configuration The DCIM iDRAC Card Profile describes the group manager configuration. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 24.1 Enabling GroupManger Feature The iDRACCardService.ApplyAttribute() method can be used to change the GroupManager.1#Status attribute EXAMPLE: wsman invoke -a ApplyAttribute "http://schemas.dmtf.
PAGE 232
iDRAC.Embedded.1 Group Manager GroupManager.1 iDRAC.Embedded.1#GroupManager.1#GroupName true 32 0 EXAMPLE: wsman get http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_iDR ACCardEnumeration?InstanceID= iDRAC.Embedded.
PAGE 233
96FB7C5AD83223B549A9A32EE168ED69 1 OUTPUT: The server SVR12345 has successfully joined the local iDRAC group testgroup SVR12345 testgroup GMGR0006 0 24.
PAGE 234
-u $USERNAME -p $PASSWORD -J delete_group.xml -j utf-8 -y basic The input file delete_group.xml is shown below: testgroup OUTPUT: A new group job GMGR027001 is successfully created for DeleteGroup. The job progress can be viewed in the Group Manager job view.
PAGE 235
25 System Configure Lock down mode If System configure lock down mode enabled then the System configuration features are blocked, except for the power related operation. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 25.1 Enabling the System Configure Lock down mode The iDRACCardService.ApplyAttribute() method can be used to change the Lockdown.1#SystemLockdown attribute. Lockdown.
PAGE 236
26 ConnectionView The DCIM Switch Connection Profile describes the View connection details of iDRAC dedicated port and shared LOM and configuration. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 26.1 Enabling the Connection View feature SwitchConnectionView.1#Enable is the enumeration attribute and it is available in DCIM_IDRACCardEnumeration , it can be enabled or Disabled. EXAMPLE: wsman invoke -a ApplyAttribute "http://schemas.dmtf.
PAGE 237
0 d0:67:e5:a3:6b:01 1/0/19 26.3 Refresh the connection view instance DCIM_SwitchConnectionView instance are auto refreshed by 5 min if the user want to refresh it immediately ServerPortConnectionRefresh() available in DCIM_SwitchConnectionService .
PAGE 238
27 Secureboot Configuration The DCIM BIOS and Boot Management Profile describes the secure boot configuration. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 27.1 Enabling Secure Boot configuration To enable or disable the secure boot, management applications can use the DCIM_BIOSService.SetAttribute() method from Dell_BIOSandBOOT management profile to set the BIOS.Setup.1-1:SecureBoot attribute and create a job using DCIM_BIOSService.
PAGE 239
time_now 27.2 View Secure boot Certificate Management application can enumerate the DCIM_BIOSCertView class to see all the stored Secure Boot Certificate information. EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/dc im_bioscertview -h $IPADDRESS -V -v -c dummy.
PAGE 240
1 = Off , 2 = On ProxyType : It specifies the proxy type of the proxy server 0 = HTTP , 1 = SOCKS ProxyServer : It specify the IP address of the proxy server. ProxyUname: It specify the username of the proxy server. ProxyPasswd: It specify the password of the proxy server. ProxyPort: It specify the port of the proxy server. EXAMPLE: ShareType = 0 wsman invoke -a ImportBootCertificate "http://schemas.dmtf.
PAGE 241
NFS=0, CIFS=2, HTTP=5 , HTTPS=6 ShareName: Name of the CIFS share or full path to the NFS share. This may be treated as the path of the directory containing the file. Username: The username to be used to access the file. Password: The password to be used to access the file. Workgroup : Name of the workgroup for CIFS Share authentication. FileName: file name of the certificate to be import from the network share. CertificateType: Type of the certificate. 1=PK, 2 = KeK , 3 = DB, 4 = DBX.
PAGE 242
ShareIP OUTPUT: The SecureBoot Certificate Export operation is successfully completed SWC9011 0 27.5 Delete Secure boot Certificate The Dell BIOS and Boot Management Profile describes the secure boot configuration.
PAGE 243
Invoke ResetBootCertificate() with the following parameters and syntax: CertificateType: It Specifies the Certificate Type. 0 – ALL, 1 = PK, 2 = KeK, 3=DB, 4 = DBX. EXAMPLE: wsman invoke -a ResetBootCertificate "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_BiosCertServ ice?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_BiosCer tService,SystemName=DCIM:ComputerSystem,Name=DCIM:BiosCertService" -h $IPADDRESS -V -v -c dummy.
PAGE 244
28 Support for HTTP and HTTPS Network Shares in 14G WSMAN file transfer mechanism had introduced in 14th Generation of iDRAC for transferring a file from management application local folder to iDRAC local storage and vice-versa. To perform this operation WSMAN introduces the following extrinsic methods /APIs.    28.1.1 ImportData() ExportData() ClearTransferSession() ImportData(): This method is used to import to idrac local, based on the input parameter type.
PAGE 245
PAGE 246
FileSize: Size of the exported file SessionID: A unique session ID is generated and it will be used in the sub-sequent packets. This ensures that blocks are pertaining to the same file. TxfrDescriptor: Transfer descriptor value 1 – Start of Transmit 2 – Normal Transmission 3 – End of Packet RetFileOffset: Current position (offset) of the exported file. RetTxDataSize: Transmitted data size of the export file. PayLoadEncoding: Payload encoding format.
PAGE 247
3 – Hardware inventory file 4 – Factory configuration file 5 – SupportAssist collection file 6 – Crash video logs 7 – Diagnostics 8– LC full logs EXAMPLE: wsman invoke -a ClearTransferSession "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_iDRACCardSer vice?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_iDRACC ardService,SystemName=DCIM:ComputerSystem,Name=DCIM:iDRACCardService" -h $IPADDRESS -V -v -c dummy.
PAGE 248
29 Support for HTTP and HTTPS Network Shares in 14G The support for HTTP and HTTPS Network Shares got added in 14th Generation of iDRAC for most of the WSMan APIs that deal with network shares. The following are the list of methods which are now supporting this new addition, 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. DCIM_LCService.ExportLCLog() DCIM_LCService.ExportCompleteLCLog() DCIM_LCService.ExportHWInventory() DCIM_LCService.ExportFactoryConfiguration() DCIM_LCService.
PAGE 249
3 – For SetUpdateSchedule(), this parameter is available by the name ProxyUserName 4 – For SetUpdateSchedule(), this parameter is available by the name ProxyPassword Please check the respective sections of the APIs for the actual command examples which may be modified in accordance to the given new parameters above.
PAGE 250
30 Support Assist 30.1 SupportAssistRegister User needs to register server with Dell to avail SupportAssist features. User needs to provide FirstName, LastName, Phone Number, Alternate Number, Email address, Company name, Service Address. User needs to accept EULA before executing the SupportAssist registration menthod.
PAGE 251
SelectorSet Selector: InstanceID = JID_904041728335, __cimnamespace = root/dcim ReturnValue = 4096 30.2 SupportAssistAcceptEULA User needs to accept End User License Agreement (EULA) before registering for SupportAssist. User can accept EULA by executing the below command. wsman invoke –a SupportAssistAcceptEULA http://schemas.dell.
PAGE 252
30.4 SupportAssistSetAutoCollectSchedule Once user has registered the server with SupportAssist, this method can be used to update the SuppportAssist auto collections schedule. By default, monthly schedule is created for the 1st Sunday (between 12 a.m. – 5 p.m.) for auto collections post successful registration. User can specify the schedule to be weekly, montly or quarterly for auto collections. Command:wsman invoke -a SupportAssistSetAutoCollectSchedule http://schemas.dell.
PAGE 253
Recurrence = 3 ReturnValue = 0 Time = 03:00 AM WeekOfMonth = * 30.6 SupportAssistClearAutoCollectSchedule Once user has registered the server with SupportAssist, this method can be used to clear the SuppportAssist auto collections schedule. By default, monthly schedule is created for the 1st Sunday (between 12 a.m. – 5 p.m.) for auto collections post successful registration. Command: wsman invoke -a SupportAssistGetAutoCollectSchedule http://schemas.dell.
PAGE 254
0 Share UserName Share Password 0 OUTPUT: SupportAssistCollection_OUTPUT Job EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anony mous ReferenceParameters ResourceURI = http://schemas.dell.
PAGE 255
30.9 SupportAssistUploadLastCollection Wsman invoke -a SupportAssistUploadLastCollection http://schemas.dell.com/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_LCService? SystemCreationClassName=DCIM_ComputerSyste,+CreationClassName=DCIM_LCService, SystemName=DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: SupportAssistUploadLastCollection_OUTPUT Job EndpointReference Address = http://schemas.xmlsoap.