Technical White Paper

ManualsBrandsDell ManualsSoftwareLifecycle Controller 2 Version 1.3.0

A Dell Best Practices

Dell 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

December 2013

Summary of content (240 pages)

PAGE 1
Dell 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 December 2013 A Dell Best Practices
PAGE 2
Revisions Date Description December 2013 1.0 Release: Initial release Dell, the DELL logo, and the DELL badge are trademarks of Dell Inc. Symantec, NetBackup, and Backup Exec are trademarks of Symantec Corporation in the U.S. and other countries. Microsoft, Windows, and Windows Server are registered trademarks of Microsoft Corporation in the United States and/or other countries.
PAGE 3
the marks and/or names or their products and are the property of their respective owners. Dell disclaims proprietary interest in the marks and names of others. 3 Lifecycle Controller Integration – Web Services Interface Guide for Windows | Revision 1.0.
PAGE 4
Contents Revisions ............................................................................................................................................................................................ 2 Executive Summary ....................................................................................................................................................................... 14 1 Introduction .................................................................................................
PAGE 5
.5.1 Modify User Name (using DMTF Model) ................................................................................................................... 35 5.5.2 Modify Password (using DMTF Model) ...................................................................................................................... 38 5.5.3 Modify Account State (using DMTF Model) .............................................................................................................. 38 5.5.
PAGE 6
7.10.1 Install From Repository ................................................................................................................................................ 55 7.10.2 Get Repo-Based Update List....................................................................................................................................... 56 8 Power State Management .......................................................................................................................................
PAGE 7
11 Operating System Deployment ............................................................................................................................................. 81 11.1 OS Deployment Profile Implementation Conformance ........................................................................................ 81 11.2 Checking OS Deployment Service Availability ......................................................................................................... 81 11.
PAGE 8
12.2.4Get CSIOR Component Configuration Recovery (CCR) Attribute ..................................................................... 104 12.2.5 Get Part Firmware Update Attribute ........................................................................................................................ 105 12.3 Re-Initiate Auto-Discovery Client ............................................................................................................................ 105 12.
PAGE 9
13.4 Create Partition ........................................................................................................................................................... 128 13.5 Create Partition using Image .................................................................................................................................... 130 13.6 Delete Partition .........................................................................................................................................
PAGE 10
16.1 Listing the RAID Inventory-Enumeration Class ..................................................................................................... 160 16.2 Getting a RAID Enumeration Instance .................................................................................................................... 161 16.3 Listing the RAID Inventory-Integer Class ................................................................................................................ 162 16.
PAGE 11
16.18.7 Deleting a Virtual Disk-DeleteVirtualDisk() .................................................................................................... 190 16.19 Setting Controller Attributes ..................................................................................................................................... 191 16.19.1 Changing the Value of a RAID Controller Enumeration Attribute ............................................................ 191 16.19.
PAGE 12
18.2.4 Clear the Backup Schedule .................................................................................................................................. 210 18.3 Importing Server Profile ............................................................................................................................................. 211 18.3.1 Importing Server Profile from iDRAC vFlash Card-RestoreImage() ................................................................... 211 18.3.
PAGE 13
23.4 Listing the FC Inventory-Integer Class .................................................................................................................... 235 23.5 Listing the FC Inventory-Enumeration Class ........................................................................................................ 236 23.6 Changing the FC Attributes-SetAttribute() ............................................................................................................ 236 23.
PAGE 14
Executive Summary Dell PowerEdge servers are equipped with the integrated Dell Remote Access Controller and the Lifecycle Controller solution for remote management – iDRAC6 on 11th Generation servers and iDRAC7 on 12th Generation servers. These servers can be remotely managed by using the WS-Man services for configuration, update, deployment, and maintenance. This whitepaper provides information about the various WSMan interfaces with examples on how to use the interfaces in a Linux environment.
PAGE 15
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 16
2 References Dell 12th Generation PowerEdge Server Resources: http://www.delltechcenter.com/12thGen Dell CIM Profiles: http://www.delltechcenter.com/page/DCIM.Library.Profile Managed Object Format (MOF) files: http://www.delltechcenter.com/page/DCIM.Library.MOF WinRM Scripting API, MSDN: http://msdn.microsoft.com/en-us/library/aa384469(VS.85).aspx Openwsman CLI: http://www.openwsman.org/project/wsmancli DMTF Common Information Model (CIM) Infrastructure Specification (DSP0004): http://www.dmtf.
PAGE 17
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 4 5 environments using WinRM and WSMANCLI respectively. The Lifecycle Controller remote management capabilities are organized by management domain and documented in Dell CIM Profile 2 specifications .
PAGE 18
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 and Time Parameters 3.2.
PAGE 19
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). You are expected to enter the date and time in this format for all Lifecycle Controller 2.0 updates and set attribute tasks. TIME_NOW is a special value that represents “running the tasks immediately”. 3.2.
PAGE 20
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 21
DCIM Memory 1 1.0.0 ...
PAGE 22
http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 23
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 24
User Admin Enable Enable Enabled Enabled Account Enabled as displayed 0 in CurrentValue attribute for iDRAC.Embedded.1 Users.2 Users Users.2 iDRAC.
PAGE 25
Administrator NoAccess 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.
PAGE 26
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_ iDRACCardService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_iDRACCardService,SystemName=DCIM:ComputerSystem,Name=D CIM:iDRACC ardService" -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 27
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=D CIM:iDRACC ardService" -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 28
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 29
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 30
DCIM_MFAAccount MFA Account 2 2 2
PAGE 31
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 32
3. The presence of “RequestedStatesSupported” determines which states could be set. 4. One exception is account index 0. The first account is static and cannot be set.
PAGE 33
DCIM:Privilege:1 true false 7 7 7 7 7
PAGE 34
. . . Privilege setting capability is defined in the class CIM_RoleBasedManagementCapabilities associated with the CIM_Privilege class instance. This class contains the list of possible values used to assign privileges. Look for the property ActivityQualifiersSupported. To determine privilege setting capabilities: 1. Acquire the class instance of CIM_Privilege of interest. 2.
PAGE 35
5.5 Manage Account Settings (using DMTF Model) 5.5.1 Modify User Name (using DMTF Model) When the account setting capability allows, the user name of an account may be modified by running a set operation on the UserID property of the CIM_Account class instance. The set operation requires an instance reference. The instance reference may be retrieved by adding EnumerateEPR mode to enumerate or get of the class. Profiles: http://www.dmtf.org/sites/default/files/standards/documents/DSP1034_1.0.1.
PAGE 36
DCIM_MFAAccount DCIM User 2 . . . B) Perform a ‘get’ on any instance from A) to ensure correctness of the URI. EXAMPLE-B: wsman get "http://schemas.dmtf.
PAGE 37
systemmc 12 C) If B) is successful, set the new values for the specified instance. EXAMPLE-C: wsman put "http://schemas.dmtf.
PAGE 38
DCIM_SPComputerSystem systemmc 12 testuser4 testuserpss4 D) If the account specified is new or not yet enabled, it will not be accessible.
PAGE 39
http://www.dmtf.org/sites/default/files/standards/documents/DSP1039_1.0.0.pdf Replace “DCIM User 16” with the applicable user name and “2” with the desired request state. Invoke RequestStateChange() with the following parameters and syntax: EXAMPLE: wsman invoke -a RequestStateChange "http://schemas.dmtf.
PAGE 40
QualifierFormatsSupported = 9, 9, 9, 9, 9, 9, 9, 9, 9 SharedPrivilegeSupported = false 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. Get an instance of the CIM_Privilege class of interest.
PAGE 41
6 Firmware Inventory 6.1 Software Inventory Profile Specification The Dell Common Information Model (CIM) class extensions for supporting remote firmware 2 3 inventory are defined in the Dell OS Software Update and related MOFs . The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Inventory Profile. 6.
PAGE 42
0 Installed true 1.0.0.
PAGE 43
7 Firmware Update 7.1 Software Update Profile Specification The Dell Common Information Model (CIM) class extensions for supporting BIOS, component 2 firmware, and embedded software update are defined in the Dell Software Update Profile and 3 related MOF files . The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell Software Update Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 7.
PAGE 44
00000101000000 Scheduled 20100730121500 Task successfully scheduled JCP001 Rollback:DCIM:AVAILABLE:NONPCI:159:2.1.
PAGE 45
le/anonymous http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_SoftwareIdentity [InstanceID] OUTPUT: When this method is executed, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.
PAGE 46
?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 RollInputNIC.xml -j utf-8 -y basic The rollback input file, RollInputNIC.xml, is shown below: PAGE 47
Note: When running a WS-Man command to initiate update jobs, make sure to wait for two seconds before submitting a second job in order to avoid 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. The second stage is to monitor the download.
PAGE 48
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 49
replaced with the actual InstanceID of the device to be updated. OUTPUT: When this method is run, a jobid or a message is displayed indicating an error. This jobid can then be used for subsequent processing with job control provider in Section 10. InstallFromURI_OUTPUT Job Address = http://schemas.xmlsoap.org/ws ReferenceParameters ResourceURI = http://schemas.dell.
PAGE 50
[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:AVAILABLE:NONPCI:159:2.1.4 It is available firmware on a NONPCI device. This refers BIOS version 2.1.4 EXAMPLE: wsman invoke -a InstallFromURI http://schemas.dmtf.
PAGE 51
Job Address = http://schemas.xmlsoap.org/ws ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cim-schema /2/DCIM_SoftUpdateConcreteJob SelectorSet Selector: InstanceID = JID_001276741475, __cimnamespace = root/dcim ReturnValue = null 7.8 CreateRebootJob() The CreateRebootJob() method creates a reboot job that can be scheduled to reboot immediately or at a later time. When the reboot job is scheduled and then ran, using SetupJobQueue() (Section 10.2.
PAGE 52
http://schemas.dell.com/wbem/wscim/1/cimschema/ 2/DCIM_SoftUpdateConcreteJob RID_001299756950 root/dcim 4096 The jobid in the above output is the instanceID: Jobid = InstanceID = RID_001265648530 7.
PAGE 53
?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: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous http://schemas.dell.
PAGE 54
15:00 mon,Tue,wed 2 5 7.9.4 Get the Update Schedule GetUpdateSchedule() lists the parameter set by SetUpdateSchedule() Example: wsman invoke -a GetUpdateSchedule http://schemas.dmtf.
PAGE 55
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.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_SoftwareInstallationService?SystemCreationClassName=DCI M_SoftwareInstallationService,SystemName=IDRAC:ID,CreationClassName=DCIM_Softwa reInstallationService,Name=SoftwareUpdate -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic 7.
PAGE 56
assName=DCIM_SoftwareInstallationService,SystemName=IDRAC:ID,Creatio nClassName=DCIM_SoftwareInstallationService,Name=SoftwareUpdate -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J InstallFromRepository.xml -j utf-8 -y basic Syntax for InstallFromRepository.xml PAGE 57
GetRepoBasedUpdateList_OUTPUT PackageList =
PAGE 58
13.1.10 13.1.10
PAGE 59
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 60
mainsystemchassis 7654321 3 0 8.2.2 Power State Management Method The power state of the system is also reported by the PowerState property of the DCIM_CSAssociatedPowerManagementService class. Power State Management Profile: http://www.dmtf.org/sites/default/files/standards/documents/DSP1027_2.0.0.
PAGE 61
http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 62
3 11 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.
PAGE 63
(Graceful8Shutdown Supported) Power ManagementCapabilities DCIM:pwrmgtcap1 3 4
PAGE 64
2) Enumerate the DCIM_ComputerSystem class and search for the Host instance 3) Use the EPR on steps 1) and 2) to invoke RequestPowerStateChange() Power State Management Profile: http://www.dmtf.org/sites/default/files/standards/documents/DSP1027_2.0.0.pd f EXAMPLE: wsman invoke -a RequestPowerStateChange "http://schemas.dell.
PAGE 65
9 Hardware Inventory The Dell Common Information Model (CIM) class extensions for supporting remote hardware 3 inventories are defined in the various Dell profiles and related MOFs . 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 66
20110119144252.000000+000 3 0 0 0 9.2 Fan Inventory This section describes the requirements and guidelines for implementing Dell Fan Profile.
PAGE 67
20110316091932.000000+000 1 0 2 0 true . . 9.3 Memory Inventory This section describes the implementation for the DCIM_MemoryView class. The Dell Memory Profile describes physical memory of each platform.
PAGE 68
This section describes the implementation for the DCIM_CPUView class. The Dell CPU Profile describes CPUs of each platform. Each CPU’s information is represented by an instance of DCIM_CPUView class. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile Enumerate DCIM_CPUView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_CPUView -h $IPADDRESS -V -v -c dummy.
PAGE 69
1 1.2 9.5 iDRAC Card Inventory This section describes the implementation for the DCIM_iDRACCardView class. The Dell iDrac Profile describes the iDrac remote access card of each platform. 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 70
wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_PCIDeviceView -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 1 0002 PERC H310 Adapter 0 RAID.Slot.1-1 0 RAID.Slot.
PAGE 71
20111214060202.000000+000 Matrox Graphics, Inc. 0534 04CF 1028 102B 0002 0002 9.
PAGE 72
Enumerate NICView with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_NICView -h $IPADDRESS -V -v -c dummy.
PAGE 73
9.10 RAID Inventory and Configuration The RAID profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of RAID storage. The RAID storage is modeled as collections of attributes where there are collections for the storage adaptors, physical disk drives, logical disks, end enclosures and parent-child relationships between the collections.
PAGE 74
9.11 BIOS Inventory and Configuration The BIOS Management Profile extends the management capabilities of referencing profiles by adding the capability to represent and configure BIOS attributes, such as a Network Controller or IDE Controller. The relationship between an individual BIOS attribute and a respective device is also described. Additionally, the registration of a profile for the schema implementation version information is described.
PAGE 75
EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_SystemView -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: 12/05/2011 0.3.
PAGE 76
NotInUse 3 1 2048 12G Monolithic 1231 0 1 4c4c4544-0036-3510-8034-b7c04f333231 1 44454c4c-3600-1035-8034-
PAGE 77
10 Job Control Management 10.1 Description of Job Management The Dell Common Information Model (CIM) class extensions for supporting update and attribute 2 3 configuration job control are defined in the Dell Job Control Profile and related MOF files . The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can also be found in Dell Job Control Profile. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 10.
PAGE 78
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 79
EXAMPLE 2: wsman invoke -a DeleteJobQueue 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 -k JobID="JID_CLEARALL" -j utf-8 -y basic OUTPUT: Return 0 for success or non-zero for error with messageID and message description.
PAGE 80
JID_001299159055 Completed Initialize media successful VF048 VFlashInitialize:Media RID_001299247671 00000101000000 Reboot Completed
PAGE 81
11 Operating System Deployment The Dell Common Information Model (CIM) class extensions for supporting remote operating system 2 (OS) deployment are defined in the Dell OS Deployment Profile and the 3 DCIM_OSDeploymentService MOF file . The diagrams representing the classes that are implemented by the Lifecycle Controller firmware can be found in Dell OS Deployment Profile as well. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 11.
PAGE 82
12 DCIM_ComputerSystem DCIM:ComputerSystem
PAGE 83
Windows Server(R) 2003 R2 with SP2 Windows(R) Small Business Server 2003 R2 with SP2 Windows Server(R) 2003, x64 Windows Server(R) 2008 Windows Server(R) 2008, x64 Windows(R) Small Business Server 2008 Windows(R) Essential Business Server 2008 Windows Server(R) 2008, x64 R2 Red
PAGE 84
a. Job = object path to CIM_ConcreteJob (reports the status of unpack and attach) b. Enumerating this instance of CIM_ConcreteJob will display the status of the current operation. Invoke UnpackAndAttach() with the following syntax: EXAMPLE: wsman invoke -a UnpackAndAttach http://schemas.dmtf.
PAGE 85
-j utf-8 -y basic OUTPUT: Returns 0 for success or an integer for error or job in execution. A message indicating an error, contains a MessageID and Message similar to the following is displayed if the system is waiting to complete an earlier invoked method: Unable to retrieve Lifecycle Controller handle OSD7 2 11.3.
PAGE 86
http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 87
DCIM_OSDConcreteJob:1 UnpackAndShare 1 Failed Installation not supported for th
PAGE 88
[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_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 89
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 90
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_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 91
wsman invoke -a DownloadISOToVFlash 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 92
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.
PAGE 93
OUTPUT: After running this command, a status or a message will be displayed indicating an error. If an image is not found the following message will be displayed: 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.
PAGE 94
[CIFS_or_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 ConnectNetworkISOImage http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_OSDeploymentService ?CreationClassName=DCIM_OSDeploymentService,Name=DCIM:OSDeploymentService,Sys temCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V –v -c dummy.
PAGE 95
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: 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. 0 11.3.
PAGE 96
Invoke GetNetworkISOImageConnectionInfo() with the following syntax: EXAMPLE: wsman invoke -a GetNetworkISOImageConnectionInfo http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_OSDeploymentS ervice ?CreationClassName=DCIM_OSDeploymentService, Name=DCIM:OSDeploymentService, SystemCreationClassName=DCIM_ComputerSystem, SystemName=DCIM:ComputerSystem -h $IPADDRESS -V -v -c dummy.
PAGE 97
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: http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous< /wsa:Address> http://schemas.dell.
PAGE 98
11.3.20 Get RFS ISO Image Connection Information The GetRFSISOImageConnectionInfo() method is used to provide the status of the ISO Image connection that has been made available to the host system. Invoke GetRFSISOImageConnectionInfo() with the following syntax: EXAMPLE: wsman invoke -a GetRFSISOImageConnectionInfo http://schemas.dmtf.
PAGE 99
11.3.22 Configurable Boot to Network ISO This method was added during the LC2 Version 1.1 release. The ConfigurableBootToNetworkISO() works similar to BootToNetworkISO() except that the immediate boot to the ISO is not automatic and controlled by an input parameter called ResetType which will enable you to do a warm reset or cold reset or no immediate reset.
PAGE 100
PAGE 101
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 102
Part Firmware Update Allow version upgrade only This method is used to set the values of multiple attributes. Invoke SetAttributes() with the following parameters and syntax: EXAMPLE 2: wsman invoke -a SetAttributes http://schemas.dmtf.
PAGE 103
schema/2/root/dcim/DCIM_LCService"> 00000000002200.000000:000 false 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/anon ymous http://schemas.dell.
PAGE 104
OUTPUT: DCIM_LifecycleJob InstanceID = JID_001272324322 JobStartTime JobStatus = Completed JobUntilTime Message = Detach partition successful MessageArguments = null MessageID = VF038 Name = VFlashDetach:Partition1 DCIM_LifecycleJob InstanceID = JID_001273099184 JobStartTime = 20191010101010 JobStatus = COMPLETED JobUntilTime = 2009:8:11 Message = The command was successful MessageArguments = null MessageID = LC001 Name = LC Config . . . 12.2.
PAGE 105
LC.emb.1 LifecycleController.Embedded.1#LCAttributes.1#CollectSys temInventoryOnRestart false Enabled Disabled 12.2.
PAGE 106
[PS_IP_ADDRESS]: Substitution will need to be replaced with the actual IP address(s) or DNS name(s) of the Provisioning Server(s). PerformAutoDiscovery: 1 = off (disables auto discovery) 2 = Now (enables and initiates auto discovery immediately ) 3 = NextBoot (delay reconfiguration & auto discovery until next power cycle) EXAMPLE: wsman invoke -a ReInitiateDHS http://schemas.dmtf.
PAGE 107
OUTPUT-A: This method will return status 0 or a message is displayed indicating an error. 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 108
-h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic NOTE: For 11G, InstanceID=DCIM_LCEnumeration:CCR1 OUTPUT: This ‘get’ command will return the instance of the DCIM_LCEnumeration attribute class. The CurrentValue property will contain “True” (yes) or “False” (no) indicating whether or not the features dependent on the presence of the VFlash SD card are enabled.
PAGE 109
OUTPUT: When this method is ran, a jobid or a message is displayed indicating an error is displayed. This jobid can then be used for subsequent processing with job control provider in Section 10. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 110
-----BEGIN CERTIFICATE----MIIE2zCCA8OgAwIBAgIBADANBgkqhkiG9w0BAQQFADCBqTELMAkGA1UEBhMCVVMx CzAJBgNVBAgTAlRYMRQwEgYDVQQHEwtNYWluIFN0cmVldDEVMBMGA1UEChMMSm9l . . . 8o5kZK8xCaSQ9UQKdH5z6sUasj8DYk6pXndgWIV5Wc9JfsN3+dratX3lrpoPJPhk N1hTdXHYiDjLwSg79yIkIJP1qZ5gdaeJ1jUYJBehRDQ+X7HxWN2VNk+ZlNvYyZc= -----END CERTIFICATE---- OUTPUT: When this method is ran, a jobid or an error message is returned.
PAGE 111
This method is used to update a public SSL Certificate on the iDRAC. Invoke SetPublicCertificate() with the following parameters and syntax: Type: Specifies certificate service directoryCA = certificate for Active Directory or LDAP server EXAMPLE: wsman invoke -a SetPublicCertificate http://schemas.dmtf.
PAGE 112
EXAMPLE: wsman invoke -a SetCertificateAndPrivateKey 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 SetCertificateAndPrivateKey.xml -j utf-8 -y basic The input file SetCertificateAndPrivateKey.xml is shown below: PAGE 113
12.12 Insert Comment in Lifecycle Controller Log This method is used to insert your additional 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 114
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: 123.
PAGE 115
Workgroup: This is the applicable workgroup. Example: wsman invoke -a ExportCompleteLCLog http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService?SystemCreationClassName=DCIM_Compu terSystem,CreationClassName=DCIM_LCService,SystemName =DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J ExportCompleteLCLog.xml -j utf-8 -y basic Format for ExportCompleteLCLog.xml PAGE 116
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.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 117
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. 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.
PAGE 118
4096 12.17 System Decommission This method is called to delete all configurations from the Lifecycle controller before the system is retired. Invoke LCWipe() with the following parameters and syntax: EXAMPLE: wsman invoke -a LCWipe http://schemas.dmtf.
PAGE 119
0 2 0 12.19 Export System Configuration This method is used to export the system configuration from the Lifecycle Controller to a file on a remote share. Invoke ExportSystemConfiguration() with the following parameters and syntax: IPAddress: This is the IP address of the target export server. ShareName: This is the directory path to the mount point.
PAGE 120
http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 121
OUTPUT: After running this method, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 122
E OUTPUT: ImportSystemConfigurationPreview_OUTPUT Job EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
PAGE 123
Service -u:%Username% -p:%Password% -r:https://%IPAddress%/wsman -SkipCNCheck -SkipCACheck -encoding:utf-8 -a:basic @{RunMode="1";RebootJobType="2";ScheduledStartTime="TIME_NOW"} OUTPUT: RunePSADiagnostics_OUTPUT Job EndpointReference Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.
PAGE 124
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 125
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 126
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 127
$IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: After running this method, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 128
InitializedState: Field indicates status of element to be initialized InstanceID: InstanceID of desired element for initialization 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.
PAGE 129
Size: The size of the partition to be created. SizeUnit: The unit of the size MB=1, GB=2 PartitionType: The partition type floppy=1, hard disk drive=2 OSVolumeLabel: The label seen in the OS after attaching the partition. EXAMPLE: wsman invoke -a CreatePartition http://schemas.dmtf.
PAGE 130
MessageID = VF015 ReturnValue = 2 13.5 Create Partition using Image This method creates a partition on the storage device using the image provided by the user. The partition size will be the same as the size of the image. The maximum size of the image is 4GB. The image can be located on an NFS or a CIFS share or on a TFTP server. After running this method successfully , an instance of DCIM_OpaqueManagementData representing the desired partition will be created (Section 13.
PAGE 131
2/root/dcim/DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_PersistentStorageService, SystemName=DCIM:ComputerSystem,Name=DCIM:PersistentStorageService -h $IPADDRESS -V -v -c dummy.cert -P 443 The input file CreatePartitionUsingImage.xml is shown below: PAGE 132
EXAMPLE: wsman invoke -a DeletePartition http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_Persisten tStorageServic e,SystemName=DCIM:ComputerSystem,Name=DCIM:PersistentStorageService" -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J DeletePartition.xml -j utf-8 –y basic The input file DeletePartition.xml is shown below: PAGE 133
query the status of the formatting of the partition. EXAMPLE: wsman invoke -a FormatPartition http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_PersistentStorageService, SystemName=DCIM:ComputerSystem,Name=DCIM:PersistentStorageService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J FormatPartition.xml -j utf-8 –y basic The input file FormatPartition.
PAGE 134
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.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_PersistentStorageService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_PersistentStorageService, SystemName=DCIM:ComputerSystem,Name=DCIM:PersistentStorageService -h $IPADDRESS -V -v -c dummy.
PAGE 135
The input file AttachPartition.xml is shown below: 12 OUTPUT: After running this method, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.
PAGE 136
schema/2/DCIM_PersistentStorageService"> 12 OUTPUT: After running this method, a jobid or a message is displayed indicating an error. http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anon ymous http://schemas.dell.
PAGE 137
Workgroup: Name of the workgroup, if applicable Username: The username to be used to access the file Password: The password to be used to access the file Port: The port number to be used HashType: The hash type MD5=1, SHA1=2 HashValue: The hash value string based on the HashType parameter EXAMPLE: wsman invoke -a ExportDataFromPartition " http://schemas.dell.
PAGE 138
JID_001300797630 root/dcim 4096
PAGE 139
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 140
vFlash Boot Configuration vFlash 2 0 2 14.2 Getting a Boot ConfigSetting Instance Getting the boot configuration current, default, and next attributes of one particular boot configuration instance is an alternative to enumerating all available instances as shown in Section 14.1.
PAGE 141
Embedded SATA Port A Optical: SATA Optical Drive BootSeq 0 1 Embedded SATA Port A Optical: SATA Optical Drive BootSeq 1 IPL:Optical.SATAEmbedded.
PAGE 142
The input file ChangeBootOrderByInstanceID.xml is shown below: IPL:Optical.SATAEmbedded.A1:eb8aeb15796fb85f8e1447f0cfb8a68e UEFI:Disk.iDRACVirtual.1-2:1723 UEFI:Disk.iDRACVirtual.1-2:1723 UEFI:Disk.iDRACVirtual.1-3:1998 UEFI:Disk.iDRACVirtual.
PAGE 143
The input file ChangeBootSourceState.xml is shown below: 0 IPL:Optical.SATAEmbedded.A1:eb8aeb15796fb85f8e1447f0cfb8a68e The source input is obtained from the BootSourceSetting inventory in Section 14.
PAGE 144
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 145
NIC.Embedded.1-1 NIC.Embedded.1-1:ChapAuthEnable false Disabled Enabled IscsiTgtBoot Enabled NIC.Embedded.
PAGE 146
NIC.Embedded.1-1 NIC.Embedded.1-1:MacAddr true 0 0 VirtIscsiMacAddr 00:22:19:59:B2:20 NIC.Embedded.1-1 NIC.Embedded.
PAGE 147
LunBusyRetryCnt 0 NIC.Embedded.1-1 NIC.Embedded.
PAGE 148
20110112171136.
PAGE 149
3 3 2 3 0 0 0 0 0 0
PAGE 150
NIC.Embedded.1-1-1 NIC.Embedded.
PAGE 151
Note: When a you do not want to set a reboot type while creating a target job, you should comment out the RebootJobType in the input xml. You 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 152
EXAMPLE: wsman invoke -a DeletePendingConfiguration 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 DeletePendingConfiguration_NIC.xml -j utf-8 -y basic The input file DeletePendingConfiguration_CNA.xml is shown below: PAGE 153
NONE PXE NONE 15.10 Setting the IscsiOffloadMode Attribute The SetAttribute() method is used to set or change the value of a CNA attribute. Enable the NICMode, IscsiOffloadMode, and FcoeOffloadMode personality attributes to enable the corresponding personalities: NIC, ISCSI, and FCOE.
PAGE 154
Set PendingValue 15.11 Setting the MaxBandwidth Attribute The SetAttribute() method is used to set or change the value of a CNA attribute. The MinBandwidth and MaxBandwidth attributes control the bandwidth allocations for a given CNA partition. The values are displayed in percentage. For Broadcom CNA cards, the MinBandwidth attribute values for a given port must always add up to either 0 or 100.
PAGE 155
0 Set PendingValue 15.12 Setting the VirtMacAddr Attribute The SetAttribute() method is used to set or change the value of a CNA attribute. The I/O identity string attributes: (VirtMacAddr, VirtIscsiMacAddr, VirtFIPMacAddr, VirtWWN, and VirtWWPN) display a unique behavior. After setting them to a non-default value, the attribute values are retained until there is AC power supply.
PAGE 156
The SetAttribute() method is used to set or change the value of a NIC attribute. WARNING: The local BIOS setting always overwrites the LegacyBootProto option. This option is only applied in the BIOS setup. By setting this attribute remotely, it appears that the value is set, but it really did not because the local BIOS setting overrides it. Running a ‘get’ on the attribute remotely displays a different current value. Invoke SetAttribute() with the following parameters(from Section 15.
PAGE 157
AttributeName: Attained from AttributeName field AttributeValue: A new value assigned to the specified NICAttribute. If this value is valid, it will be applied to the PendingValue property or the Currentvalue property of the specified NICAttribute. Possible selections are attained from PossibleValues field. EXAMPLE: wsman invoke -a SetAttributes http://schemas.dmtf.
PAGE 158
Possible values: Disabled, Enabled EXAMPLE: 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 159
Invoke the SetAttributes() method with the following parameters (from 15.1) and syntax: Target: FQDD attained through DCIM_NICEnumeration AttributeName: Attained from AttributeName field AttributeValue: A new value to assign to the specified NICAttribute. If this value is valid, it is applied to the PendingValue property or the Currentvalue property of the specified NICAttribute.
PAGE 160
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 161
The ‘get’ instance method in SAS section 16.2 uses this SATA InstanceID as input. RAIDloadBalancedMode Disabled RAID.Integrated.1-1 RAID.Integrated.
PAGE 162
EXAMPLE: wsman get http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDEnumeration ?InstanceID=[INSTANCEID] -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: RAIDloadBalancedMode Disabled RAID.Integrated.1-1 RAID.Integrated.
PAGE 163
The ‘get’ instance method in RAIDrebuildRate Section 16.4 used this 11 InstanceID as input. RAID.Integrated.1-1 RAID.Integrated.1-1:RAIDrebuildRate false 1 100 The ‘set attribute’ method in Section 16.19.
PAGE 164
-j utf-8 -y basic OUTPUT: RAIDrebuildRate 11 RAID.Integrated.1-1 RAID.Integrated.1-1:RAIDrebuildRate false 1 100 16.
PAGE 165
16.6 Getting a RAID String Instance Use the following example to get an instance of the DCIM_RAIDString class instead of all instances as shown in Section 16.5. Get a DCIM_RAIDString instance with the following parameters and syntax: [INSTANCEID]: This is obtained from the enumeration in Section 16.5, which shows an example using Disk.Virtual.0:RAID.Integrated.1-1:Name as an instanceID EXAMPLE: wsman get http://schemas.dmtf.
PAGE 166
0 RAID.Slot.1-1 0 RAID.Slot.1-1 20120116145459.000000+000 20120116145459.
PAGE 167
20120116145459.
PAGE 168
2 DS62 1 5000C50025D64875 0 9SP297S1 499558383616 0 None 35827154944 . . 16.
PAGE 169
0 128 0 1 After successful virtual disk creation: 6 0 1024 Disk.Virtual.0:RAID.Slot.1-1 Disk.Virtual.0:RAID.Slot.
PAGE 170
OUTPUT: 0 0 Enclosure.Internal.0-0:RAID.Integrated.1-1 0 Enclosure.Internal.0-0:RAID.Integrated.1-1 20110316150158.000000+000 20110316141312.
PAGE 171
16.13 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.7) EXAMPLE: wsman invoke -a ClearForeignConfig http://schemas.dmtf.
PAGE 172
RebootJobType: There are three options for rebooting the system. 1 = PowerCycle 2 = Graceful Reboot without forced shutdown 3 = Graceful reboot with forced shutdown Note: When a user does not want to set a reboot type when creating a target job, 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 173
16.15 Deleting the Pending Values for RAIDDeletePendingConfiguration() The DeletePendingConfiguration() method cancels the pending configuration changes made before the configuration job is created with CreateTargetedConfigJob(). This method only operates on the pending changes prior to CreateTargetedConfigJob() being called. After the configuration job is created, the pending changes can only be canceled by calling DeleteJobQueue() in the Job Control profile.
PAGE 174
CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J GetDHSDisks.xml -j utf-8 -y basic The input file GetDHSDisks.xml is shown below: DISK.Virtual.1:RAID.Integrated.
PAGE 175
Nonconformance to the following restrictions may result in the error message below. Virtual disk (VD) referenced (dedicated hot spare) is RAID-0, which cannot have hot spares Physical disk (PD) is too small for the virtual disk referenced (dedicated hot spare) Physical disk is wrong type for the virtual disk (i.e.
PAGE 176
16.17.1 Setting the Key-SetControllerKey() The SetControllerKey() method sets the key on controllers that support encryption of the virtual disks. Invoke SetControllerKey() with the following parameters and syntax: TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) Key: Maximum size 32 characters Keyid: Identifier, or description, for the key (maximum size 255 characters) EXAMPLE: wsman invoke -a SetControllerKey http://schemas.dmtf.
PAGE 177
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 LockVirtualDisk.xml -j utf-8 -y basic The input file LockVirtualDisk.xml is shown below: Disk.Virtual.0:RAID.Integrated.
PAGE 178
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.xml -j utf-8 -y basic The information in the input file EnableControllerEncryption.
PAGE 179
Mode: Mode of the Controller 1 - Local Key Encryption 2 – Dell Key Manager EXAMPLE: wsman invoke -a ReKey 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 ReKey.xml -j utf-8 -y basic The information in the input file ReKey.
PAGE 180
OUTPUT: This method requires an H700 or H800 controller to function correctly. If the EnableControllerEncryption() method does not set the key, the following message is displayed: RemoveControllerKey_OUTPUT Message = Controller Key is not present MessageID = STOR021 ReturnValue = 2 16.18 Managing Virtual Disk 16.18.1 Getting the Available RAID levels-GetRAIDLevels() The GetRAIDLevels() method is used to determine possible choices RAID levels to create virtual disks.
PAGE 181
0 Disk.Bay.0:Enclosure.Internal.0-0:RAID.Integrated.1-1 Disk.Bay.1:Enclosure.Internal.0-0:RAID.Integrated.
PAGE 182
2 = Include only non FDE disks EXAMPLE: wsman invoke -a GetAvailableDisks 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 GetAvailableDisks.xml -j utf-8 -y basic The input file GetAvailableDisks.xml is shown below: PAGE 183
CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem, Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J CheckVDValues.xml -j utf-8 -y basic The input file CheckVDValues.xml is shown below: RAID.Integrated.1-1 Disk.Bay.0:Enclosure.Internal. 0-0:RAID.Integrated.1-1 Disk.Bay.1:Enclosure.
PAGE 184
TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7) PDArray: This parameter is the list of physical disk drives FQDDs that will be used to create a virtual Disk. VDPropNameArray: This parameter is the list of property names that will be used to create a virtual disk.
PAGE 185
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 186
2 100 virtualdiskname 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_O UTPUT NewVirtualDisk Address = http://schemas.xmlsoap.
PAGE 187
Size: Size of the virtual disk specified in MB. If not specified, default will use full size of physical disk drives selected. RAIDLevel: RAID 0 = 2 RAID 1 = 4 RAID 5 = 64 RAID 6 = 128 RAID 10 = 2048 RAID 50 = 8192 RAID 60 = 16384 SpanDepth: If not specified, default is single span which is used for RAID 0, 1, 5 and 6. Raid 10, 50 and 60 require a spandepth of at least 2. SpanLength: Number of Physical Disk Drives to be used per span. Minimum requirements for given RAID Level must be met.
PAGE 188
Write Back Force = 4 DiskCachePolicy: Enabled = 512 Disabled = 1024 VirtualDiskName: Name of the virtual disk (1-15 character range) StartingLBA: Starting logical block address of virtual disks in blocks. If 0xFFFFFFFFFFFFFFFF, starting LBA is calculated programmatically. The value can be in hexadecimal or decimal format. 0xFFFFFFFFFFFFFFFF 18446744073709551615 EXAMPLE: wsman invoke -a CreateVirtualDisk http://schemas.dmtf.
PAGE 189
CreateVirtualDisk_OUT PUT NewVirtualDisk Address = http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous ReferenceParameters ResourceURI = http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_VirtualDiskView SelectorSet Selector: InstanceID = DISK.Virtual.267386880:RAID.Integrated.1-1, __cimnamespace = root/dcim RebootRequired = YES ReturnValue = 0 16.18.
PAGE 190
VirtualDiskName MyCacheCadeVD Cachecade 1 OUTPUT: The instanceID output identifies this virtual disk in the inventory before and after the CreateTargetedConfigJob() method creates it. Note: However, that the instanceID will change slightly after successful creation.
PAGE 191
16.19 Setting Controller Attributes 16.19.1 Changing the Value of a RAID Controller Enumeration Attribute The SetAttribute() method is used to set or change the value of a RAID controller or a virtual disk attribute. The example below shows setting a RAID controller enumeration attribute. To set a virtual disk attribute, use the FQDD of the virtual disk attribute for the Target, and the AttributeName and AttributeValue.
PAGE 192
Invoke SetAttributes() with the following parameters (from Section 16.1) and syntax: TARGET: Obtained from the FQDD field AttributeName: Obtained from the AttributeName field AttributeValue: Obtained from the PossibleValues field EXAMPLE: 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.
PAGE 193
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.xml -j utf-8 -y basic The input file SetAttribute_Integer_RAID_Controller.xml is shown below: PAGE 194
RAIDreconstructRate 60 RAIDbgiRate 60 OUTPUT: The method was successful. STOR001 Yes 0 Set Pending Value 16.
PAGE 195
16.21 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 196
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 197
The ‘set attribute’ method in Section Uefi 17.3 will use the AttributeName and PossibleValues fields as input. BIOS.Setup.1-1 BIOS.Setup.
PAGE 198
17.3 Changing the BIOS BootMode-SetAttribute() The SetAttribute() method can be used to apply changes to setting the BootMode configuration to a given instance. Invoke SetAttribute() with the following parameters (from Section 17.1) and syntax: TARGET: Obtained from the InstanceID field AttributeName: Obtained from the AttributeName field AttributeValue: Obtained from the PossibleValues field EXAMPLE: wsman invoke -a SetAttribute http://schemas.dmtf.
PAGE 199
AttributeValue: Obtained from the PossibleValues field EXAMPLE: wsman invoke -a SetAttributes http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_BIOSService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_BIOSService,SystemName=DCIM:ComputerSystem, Name=DCIM:BIOSService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttributes_BIOS.xml -j utf-8 -y basic The input file SetAttributes_BIOS.
PAGE 200
Enumerate BIOSString with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/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 201
the RebootJobType in the input xml. You should not enter “0” or give no parameter at all in the input XML. EXAMPLE: wsman invoke -a CreateTargetedConfigJob 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 CreateTargetedConfigJob_BIOS.
PAGE 202
Target: This parameter is the FQDD of the BIOSAttribute instances (from Section 17.1) EXAMPLE: wsman invoke -a DeletePendingConfiguration 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 DeletePendingConfiguration_BIOS.
PAGE 203
?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 change_bios_password.xml -j utf-8 -y basic The input file change_bios_password.xml is shown below: No BIOS password is set: The OldPassword parameter is not required. It may be set to “null” or left blank as shown below.
PAGE 204
-u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: JID_001300720080 00000101000000 Completed 20111111111111 Job completed successfully PR19 ConfigBIOS:BIOS.Setup.
PAGE 205
Setup Password SetupPassword 1403 BIOS.Setup.1-1 System Security SysSecurity BIOS.Setup.
PAGE 206
18 Exporting and Importing Server Profile Use this feature to back up and restore host server profile. You can take a backup of current system configuration that is stored in a backup image file. Use Restore at anytime to put the system to pre-backup state. Profile and Associated MOFs: http://www.delltechcenter.com/page/DCIM.Library.Profile 18.1 Exporting Server Profile To backup host system server profile, invoke the BackupImage() method in the class DCIM_LCService.
PAGE 207
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 208
2/DCIM_LifecycleJob 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 209
18.2.1 Enable the Automatic Backup Enable the Automatic Backup feature by setting the attribute and configuring a job to update the attribute setting. wsman invoke -a SetAttribute http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem,CreationClassName=DCIM_LCService ,SystemName =DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J SetAttribute_LC.
PAGE 210
e> 18.2.2 Set Backup Schedule The SetBackupSchedule() method used by the DCIM_LCService class is used to configure automatic backup schedule using WS-Man. wsman invoke -a SetBackupSchedule http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService?SystemCreationClassName=DCIM_Compu terSystem,CreationClassName=DCIM_LCService,SystemName =DCIM:ComputerSystem,Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -J autobackup.
PAGE 211
wsman invoke -a ClearBackupSchedule http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService?SystemCreationClassName=DCIM_Compu terSystem,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 18.3 Importing Server Profile To restore host system server profile, invoke the RestoreImage() method in the class DCIM_LCService.
PAGE 212
ShareType is “0”. EXAMPLE: wsman invoke -a RestoreImage http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_LCService ?SystemCreationClassName=DCIM_ComputerSystem, CreationClassName=DCIM_LCService,SystemName=DCIM:ComputerSystem, Name=DCIM:LCService -h $IPADDRESS -V -v -c dummy.
PAGE 213
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.3.4 Monitoring Import Status Restore process may take up to 60 minutes depending on host system configuration. To monitor the backup status, get the instance of the corresponding job. Replace [INSTANCE ID] with the actual jobid from Section 18.2.1, 18.2.2, or 18.2.3. EXAMPLE: wsman get http://schemas.dmtf.
PAGE 214
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 215
false Detached Attached Autoattach IPv4 Enable Enable Enabled Enabled 0
PAGE 216
?InstanceID=[INSTANCEID] -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf -8 -y basic OUTPUT: Nic Enable Enable Enabled Enabled 0 iDRAC.Embedded.1 NIC NIC.
PAGE 217
NIC.1 iDRAC.Embedded.1#NIC.
PAGE 218
NIC.1#Speed 100 NIC.1#Autoneg Enabled NIC.1#Duplex Full NIC.1#DNSRegister Enabled NIC.1#DNSDomainNameFromDHCP Enabled NIC.
PAGE 219
4096 19.4.2 Polling Job Completion Run the Get() command to check the progress of the ApplyAttributes() method. It polls for job completion. This method takes the InstanceID from the earlier section ( 19.3.1) as input. The JobStatus value is either “Successful” or “Failed”. If the job failed, the Message value contains more detailed error information on the cause of the failure.
PAGE 220
Autoattach Detached 0 iDRAC.Embedded.1 VirtualMedia VirtualMedia.1 iDRAC.Embedded.1#VirtualMedia.
PAGE 221
wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/ 2/root/dcim/DCIM_iDRACCardInteger -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: VLan Priority VLanPriority 0 0 0 iDRAC.Embedded.
PAGE 222
2/root/dcim/DCIM_iDRACCardInteger -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic --dialect="http://schemas.microsoft.com/wbem/wsman/1/WQL" --filter="select * from DCIM_iDRACCardInteger where GroupID='NIC.1'" The possible inputs for GroupID are: NIC.1 Users.
PAGE 223
2/root/dcim/DCIM_iDRACCardString -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j utf-8 -y basic OUTPUT: DNS RAC Name DNSRacName idrac-59JJ6K1 0 iDRAC.Embedded.1 NIC NIC.
PAGE 224
19.8 Listing the iDRAC Card Inventory-String Class using groupID Enumerate the DCIM_iDRACCardString class to list all the string type iDRAC attributes using the group IDs of these groups: NIC, IPv4, and Users. To retrieve the attributes of the groups, set the GroupID to one of the following: NIC, IPv4, or Users. Invoke dracgetgroupid_string with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.
PAGE 225
1 User Admin User Name UserName 0 iDRAC.Embedded.1 Users Users.3 iDRAC.Embedded.1#Users.
PAGE 226
19.9.2 Setting the iDRAC IPChange Notification-SetAttribute() The SetAttribute() method is used to set the attribute IPChangeNotifyPS to “ON” or “OFF”. When set to “ON”, a user notification is sent when the IP address is changed. While set to “OFF”, a user notification is not sent. Invoke SetAttribute() with the following syntax: EXAMPLE: wsman invoke -a SetAttribute http://schemas.dmtf.
PAGE 227
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 228
use. MessageID Message ServerStatus LCStatus LC060 LC061 Lifecycle Controller Remote Services is not ready. Lifecycle Controller Remote Services is ready. 0 (Powered off) 1 (In POST) 2 (Out of POST) 3 (Collecting System Inventory) 4 (Automated Task Execution) 5 (Lifecycle Controller Unified Server Configurator) 0 (Ready) 1 (Not Initialized) 2 (Reloading Data) 3 (Disabled) 4 (In Recovery) 5 (In Use) 20.
PAGE 229
-u $USERNAME -p $PASSWORD -j utf-8 -y basic -k JobID="JID_CLEARALL" OUTPUT: The specified job was deleted SUP020 0
PAGE 230
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 231
24 7 OptimizerMode PowerEdge T620 1 3132334f-c0b7-3480-3510-00364c4c4544 1 1 1 336 3
PAGE 232
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 233
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 234
PortNumber 1 FC.Slot.4-1 FC.Slot.4-1:PortNumber true 0 2 23.
PAGE 235
Enumerate FCStatistics class with the following parameters and syntax: EXAMPLE: wsman enumerate http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_FCString -h $IPADDRESS -V -v -c dummy.
PAGE 236
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 237
AttributeValue: Obtained from the PossibleValues field EXAMPLE: wsman invoke -a SetAttributes 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 SetAttribute_FC.xml -j utf-8 -y basic The input file SetAttribute_FC.xml is shown below: PAGE 238
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.xml is shown below: FC.Slot.
PAGE 239
CreationClassName=DCIM_FCService,SystemName=DCIM:ComputerSystem, Name=DCIM:FCService -h $IPADDRESS -V -v -c dummy.cert -P 443 -u $USERNAME -p $PASSWORD -j Delete_Pending_fc.xml -j utf-8 -y basic The input file Delete_Pending_fc.xml is shown below: FC.Slot.
PAGE 240
1 2 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 . .