Home

Dell Lifecycle Controller 1.5 Practices Guide

1. CreateBlOSConfigJob Apply steps J L without reboot without UntilTime and without ScheduledStartTime parameter TIME_NOW ReturnValue 4096 SetAttribute Set various NIC attributes CreateNICConfigJob Apply steps N without reboot without UntilTime and without ScheduledStartTime parameter TIME_NOW ReturnValue 4096 CreateRebootJob Pass RebootJobType of 3 parameter 1 PowerCycle 2 Graceful reboot without forced shutdown 3 Graceful reboot with forced shutdown SetupJobQueue Use BIOS JID L NIC JID N and reboot RID O ReturnValue 0 47 LC Integration Best Practices Specification 4 16 Q Poll jobstatus for Completed GET the InstancelD of from M See section 2 3 fora definition of GET R Poll jobstatus for Completed GET the nstancelD of from O See section 2 3 for a definition of GET S The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile iSCSI boot using NDC Broadcom 12G only This workflow sets several NIC attributes including setup of iSCSI boot by first setting the required attributes for the operation and then changing the boot order for the NIC Additional detail is provided as setting up iSCSI boot is complex Approximate time for completion on a 12G system is 15 30 minutes de
2. LC Integration Best Practices Specification Set SUSLEEP 20 SUTIMEOUT Default total delay in seconds used by until commands before giving up Set SUTIMEOUT 900 SVERBOSE Control level of output from recite py Set SVERBOSE x where x is 0 Quiet 1 WS MAN 2 Full 33 1 6 Internal variables _BATCHFILE Name of current batch file including path with and replaced with _ _DATE Current date and time in yyyymmddhhmmss format _LOCALIP IP of the local system where script is running _LINE Current line number in a batch script 147 LC Integration Best Practices Specification 33 2 System check information 33 2 1 Check System Power State System power status is available from CMC racadm WS MAN iDRAC racadm and LC o Enumerate the CIM_ComputerSystem class to get power status from LC as described in section 8 2 of the WSIG for Windows If system is not in a state required o Error to user stating system is not in power state required 33 2 2 Check RS status Check that Status Ready as described in section 20 of the WSIG for Windows Poll every 30 seconds until Status changes as required If target system is not Ready wait for up to 5 minutes before giving up or intervening On timeout options are o Error to user stating remote services are not ready o Reset the iDRAC as described in section 8 4 of the WSIG for Windows 33 2 3 Check for pending jobs Enumerate all jobs as des
3. Success K BootTolSOFromVFlash The resulting concrete job is invoked immediately L Poll concrete job until Success NOTE OS boot is complete at this point sleep 600 seconds to allow for completion Steps M through P are providing when the BootToNetwork image is no longer desired M DetachDrivers ReturnValue 0 36 LC Integration Best Practices Specification 4 5 N DetachISOFromVFlash ReturnValue 0 O DeletelSOFromVFlash ReturnValue 0 P RequestMonoSystemStateChange Reboot to finish removal of OS ReturnValue 0 NOTE Modular systems i e M610 M710 etc use RequestModSystemStateChange Set hard drive to first in boot order This workflow will set the hard drive c to the top of the boot order If the BootMode is set to UEFI it will set it to BIOS Following completion of the reboot the hard drive will be enabled and set to boot first Approximate time for completion that one can expect to encounter on an 12G system is 15 25 minutes depending on whether an additional reboot is needed to set the BootMode parameter Applies to LC1 4 0 Prerequisites for script None Script Set_HD_Boot win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B Change BootMode to BI
4. A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE Search for RegisteredName BIOS and Boot Management and note its instancelD to use in GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM BIOSandBootManagement 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 68 LC Integration Best Practices Specification InstancelD DCIM BlIOSandBootManagement 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicenseStatus LICENSED RegisteredName BIOS and Boot Management RegisteredOrganization 1 RegisteredVersion 1 2 0 6 2 List all BIOS attributes Use the following procedure below to view all available instances of the DCIM_BIlOSEnumeration class DCIM_BlOSInteger class and DCIM_BlOSString classes in the system A
5. E GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the NICs See section 2 2 for a definition of ENUMERATE e Check the CurrentEnabledStatus to ensure it is enabled F ChangeBootSourceState Use InstancelD IPL EnabledState 1 source instancelD from D G ChangeBootOrderBylnstancelD Use InstancelD IPL source instancelD from D H CreateBlOSConfigJob Use Target BIOS FQDD I Poll jobstatus for Completed GET the nstancelD of from F See section 2 3 fora definition of GET iSCSI boot using QLogic 12G only This workflow sets several NIC attributes including setup of iSCSI boot by first setting the required attributes for the operation and then changing the boot order for the NIC Additional detail is provided as setting up iSCSI boot is complex Approximate time for completion on a 12G system is 15 30 minutes depending on the system configuration NOTE Additional details of the coding steps shown below generational differences and other iSCSI information can be found in Appendix iSCSI Boot information Applies to LC2 Prerequisites for script e QLogic NIC e Edit script to set desired parameters e FQDD must be NIC Integrated 1 1 1 or NIC Integrated 1 1 Script iscsiboot 12gNDC qlogic win The four high level steps which may require four reboots are the following If the NDC is disabled 1 job to enable it in bios and reboot Now that the card is present if iscsi
6. Check NIC is enabled 1 GetBlOSEnumerations ENUMERATE the DC M_BlOSEnumeration class to collect information about the system See section 2 2 for a definition of ENUMERATE 2 Ensure AttributeName of Slot2 is enabled If it is not enabled enable it as shown below SetBlOSAttributes AttributeName Slot2 AttributeValue Enabled AttributeName BootMode AttributeValue Bios CreateBlOSConfigJob ScheduledStartTime TIME_NOW RebootJobType 1 Poll jobstatus for Completed GET the InstancelD of from 2 57 LC Integration Best Practices Specification C CheckConnectFirstFCoETarge ENUMERATE the NIC FADD and check if ConnectFirstFCoETarget is eabled if not enable ConnectFirstFCoETarget as show below SetNICAttributes AttributeName LegacyBootProto AttributeValue FCoE AttributeName ConnectFirstFCoETarget AttributeValue Enabled Disable all sources Create BIOS job SetNICAttributes AttributeName ConnectFirstFCoETarget AttributeValue Enabled CreateNICConfigJob with RebootJobType 1 D Configure FCoE 1 Disable all sources Create BIOS job 3 Set Attributes VLAN etc as follows SetNICAttributes on NIC Mezzanine 2B 1 AttributeName FCoEOffloadMode AttributeValue Enabled AttributeName VirtFIPMacAddr AttributeValue VirtFIPMacAddr AttributeName VirtWWN AttributeValue VirtWWN AttributeName VirtWWPN AttributeValue VirtWWPN AttributeName MinBandwidth AttributeValue MinBandwidth AttributeName MaxBandwidth AttributeValu
7. The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B DeleteJobQueue Delete all jobs from the job store by setting JobID JID_CLEARALL C LC1 5 x and prior The The GetRSStatus method or the GetRemoteServicesAP Status method may be used depending on the version of the LC Management registered profile 110 LC Integration Best Practices Specification 20 5 D LC1 5 x and prior The remote service will get reset upon invoking the delete job queue command The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile to determine when the remote service is ready The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready Delete one job from job store This workflow deletes one job from the job store job queue The user must specify which job ID or reboot ID to be deleted Applies to LC1 3 0 Prerequisites for script Specify job ID to be deleted by editing script Script DeleteOneJob win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemo
8. the hard drive c If the BootMode is set to UEFI it will change it to BIOS Following completion of the reboot the hard drive will be enabled or disabled Approximate time for completion that one can expect to encounter on an 11G system is about 15 25 minutes depending on whether an additional reboot is needed to set the BootMode parameter Applies to LC1 5 0 Prerequisites for script e Set the desired boot source state to enable 1 or disable 0 Script EnableBootSource win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B Change BootMode to BIOS if current value is UEFI a SetAttribute Sets attribute to be configured ReturnValue 0 b CreateConfigJob Creates jobID and applies configuration ReturnValue 4096 C GetBootConfigSettings ENUMERATE the DCIM_BootConfigSetting class to identify the ElementName field containing BootSeq and corresponding InstancelD IPL or UEFI See section 2 2 for a definition of ENUMERATE ElementName Hard drive C BootSeq 71 LC Integration Best Practices Specification 6 9 D GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class See section 2 2 for a definition of ENUMERATE a The CurrentEnabledStatus attribute defines whether the boot source is
9. 1 CQL filter benefits The two most distinct advantages of using CQL filters when performing enumerations are e The response time of enumerations will be accelerated as only the desired data is returned not the full data set The workload on the network will be decreased as less bandwidth will be consumed per enumeration as the amount of data being returned is less This is more applicable to networks that may have many systems that performing enumerations at or about the same time 3 9 2 How to perform CQL enumerations using RECITE Section 1 2 describes how to setup and run scripts using the RECITE PYTHON environment Running CQL filters requires running the CQL command directly from the RECITE command line No scripts exist because of the infinite number of use cases 3 9 3 CQL filter example that enumerates all NIC attributes for a particular port partition 26 LC Integration Best Practices Specification The FQDD in the example below will be unique to a particular user s system The NIC FQDDs of the system can be obtained by running the GetNICViews command from the RECITE command line GetNICAttributes cql select from DCIM_NICAttribute where FQDD NIC Integrated 1 1 1 3 9 4 CQL filter example that enumerates all iDRAC attributes with a particular GroupDisplayName and AttributeName The GroupDisplayName and the AttributeName in the example below will be unique to a particular user s system GetiDRACCardAtt
10. 2 for a definition of ENUMERATE C Search for RegisteredName OS Deployment and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM OSDeployment 1 1 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM OSDeployment 1 1 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Operating System Deployment ProfileRequireLicenseStatus LICENSED RegisteredName OS Deployment RegisteredOrganization 1 RegisteredVersion 1 4 0 32 2 Unpack and attach drivers See section 4 3 Boot to networkISO and 4 4 Boot to ISO from vFlash for a comprehensive example 32 3 Connect and attach network ISO image See section 4 3 Boot to networkISO and 4 4 Boot to ISO from vFlash for a comprehensive example 32 4 Disconnect and detach network ISO image 139 LC Integration Best Practices Specification See section 4 3 Boot to networkISO and 4 4 Boot to ISO from vFlash for a comprehensive example 32 5 Get ISO image connection status See section 4 3 Boot to networkISO and 4 4 Boot to ISO from vFlash for a comprehensive example GetNetworkISOlmageConnectionInfo can be invoked from w
11. 8 2 8 3 GetRemoteServicesAPI Status B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Event Filter and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the nstancelD of DCIM EventFilter 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile Advertise TypeDescriptions WS Identify Advertise TypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM EventFilter 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicenseStatus LICENSED RegisteredName Event Filter RegisteredOrganization 1 RegisteredVersion 1 0 0 Get event filter configuration service views Enumerate the DC IM_EFConfigurationService class to view all available instances of the class Applies to LC2 Prerequisites for script none Script GetEFConfigurationServiceViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetEFConfigurationServiceViews ENUMERATE the DCIM_EFConfigurationService class to view all instances See s
12. AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM Memory 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName Memory RegisteredOrganization 1 RegisteredVersion 1 1 0 Inventory of memory in system Use the following procedure below to list the inventory of all memory DIMMs in the system Applies to LC1 5 0 Prerequisites for script none Script GetMemoryViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetMemoryViews ENUMERATE the DCIM_MemoryView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available memory DIMMs will be returned Get the first memory s information Use the following procedure to get a single memory instance The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script none e Set desired instancelD by editing script Script GetMemoryView win 112 LC Integration Best Practices Specification 22 22 1 A The Lifecycle Cont
13. Best Practices Specification 11 3 11 4 11 5 11 6 11 7 11 8 11 9 11 10 11 11 11 12 11 13 11 14 11 15 12 12 1 13 13 1 14 14 1 14 2 14 3 14 4 14 5 14 6 14 7 14 8 14 9 14 10 14 11 14 12 14 13 14 14 14 15 14 16 14 17 Get the first vFlash s attribute information ssessssssssossssssssosesssssssosssssssosoesees 83 Inventory of partitions on the virtual flash Media ccc eee eee eee e ee eeeeeeeeeeeeeeeeeees 83 Initialize Virtual flash Medias ces ciec de nckeedsenavecdycoassasde sees astansssagevanes doves ucees saneoss 83 Enable virtual flash VFlash M dia ccceeccceesccceeseeeeeseeeeeseeeesseseesaseeesaeeeeees 84 Disable virtual flash VElash media x eeni iann dew sis Wave eels Ser ewan A EEE AS E setae 84 Create new partition on virtual flash VFlash media ccc eee e eee eee ence eeeeeeeeeeeeeeees 85 Create New partition USING IMAGE Bias sass Hassan penak Teas cedeems sea weet eceadsea sg NIE EOAR 85 Delete existing partition iii siks caves sake sees obs a ERE vag cha asad chads wad Sha Sa ead UeaaT ea aka eae 86 FOrMat2existing Partition seve sks scvs ceed nnes ora cen oets elvis eres cues ots elves rA elute ETEA eleva ee aie eles eee 86 Modify CXiStINS PAnlILION sds seek Gees detews doe bots lend sews doeb a ddeblees obbieengeebues 87 Attach partition aeta Societies i eee ee baad A ee ea at 87 Detach partition sisc soc eecceees cubs ev aeswces vaebedesvavbecds web bade tvautacd
14. Disabled See section 2 2 for a definition of ENUMERATE 31 4 Check version of Lifecycle Controller LC 133 LC Integration Best Practices Specification 31 5 31 6 This workflow enumerates the DCIM_SystemView class and searches for the LifecycleControllerVersion attribute to determine the LC version on the system Applies to LC1 5 1 Prerequisites for script none Script CheckLCVersion win A GetSystemViews ENUMERATE the DCIM_SystemView class See section 2 2 for a definition of ENUMERATE B Search for the LifecycleControllerVersion attribute the corresponding value of this attribute is the version of LC Get Part Firmware Update attribute Use the following procedure to get the Part Firmware Update attribute The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance Applies to LC1 4 0 Prerequisites for script none Script GetPartFWUpdateAttribute win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCEnumerations ENUMERATE the DCIM_LCEnumeration class to new view all available instances See section 2 2 for a definition of ENUMERATE C Search for AttributeName Part Firmware Update and note its instancel
15. E RequestPowerStateChange Power on the system using PowerState 2 107 LC Integration Best Practices Specification F The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile e When the system is ready continue G GetNICCapabilities ENUMERATE the DCIM_NICCapabilities class to view all instances of the class See section 2 2 for a definition of ENUMERATE If instances are returned go to end of script as the capabilities are published H RequestPowerStateChange Power off the system using PowerState 8 e NOTE If an operating system has been installed the system will boot into it It may be desired to wait until the OS boot is complete before performing a graceful shutdown 19 Software Update Profile use cases 19 1 Discovery of Software Update profile support Use the following procedure below to confirm the existence of software update profile support Applies to LC1 5 0 Prerequisites for script none Script GetSoftwareUpdateProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProf
16. LC Integration Best Practices Specification A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashViews ENUMERATE the DCIM_VFlashView class to view the current value of InitializedState See section 2 2 for a definition of ENUMERATE C InitializeMedia Invokes the InitializeMedia method on the class DCIM_PersistentStorageService D Poll jobstatus for Completed GET the nstancelD of from C See section 2 3 fora definition of GET E GetVFlashViews ENUMERATE the DCIM_VFlashView class to confirm the new value of InitializedState See section 2 2 for a definition of ENUMERATE Enable virtual flash vFlash media This method is used to enable the virtual flash media device Applies to LC1 5 0 Prerequisites for script none Script EnableVFlash win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashViews ENUMERATE the DCIM_VFlashView class to view the current value of VFlashEnabledState property See section 2 2 for a definition of ENUMERATE C VFlashStateChange Invokes the VF
17. Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile NOTE GetRemoteServicesAPIStatus will return not ready if drivers or an ISO is already attached 66 LC Integration Best Practices Specification DetachDrivers Ensures any drivers are detached DetachISOImage Ensures all images are detached GetDriverPackInfo Displays available OS drivers This is only required for end to end OS deployment UnpackAndAttach Unpacks and attaches desired driver pack The resulting concrete job is invoked immediately This is only required for end to end OS deployment Poll concrete job until Success BootToNetworkISO The resulting concrete job may be invoked immediately depending on the reset type Poll concrete job until Success 5 Base Metrics Profile Use Cases 5 1 Discovery of Base Metrics profile support Use the following procedure below to confirm the existence of Base Metrics profile support NOTE Prior to LC2 0 0 this profile resided as a CIM profile not LC profile Applies to LC1 5 1 Prerequisites for script none Script GetBaseMetricsProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method
18. RegisteredVersion 1 1 0 Inventory of software in system Use the following procedure below to list the inventory of all software in the system Applies to LC1 4 0 Prerequisites for script none Script GetSoftwarelnventoryViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSoftwareldentities ENUMERATE the DCIM_Softwareldentity class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available software will be returned Get the installed BIOS firmware inventory Use the following procedure to get the BIOS installed software instance The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance Applies to LC1 4 0 Prerequisites for script none Script GetInstalledBlOSView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSoftwareldentities ENUMERATE the DCIM_Softwareldentity class to view all instances See section 2 2 for a definition of ENUMERATE 129 LC
19. Repeat B to confirm successful execution of the method 11 10 Delete existing partition 11 11 This method is used to delete a partition from the virtual flash media device Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashDeletePartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions See section 2 2 for a definition of ENUMERATE C DeletePartition Invokes the DeletePartition method on the class DCIM_PersistentStorageService D GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions and confirm successful operation See section 2 2 for a definition of ENUMERATE Format existing partition This method is used to format a partition on the virtual flash media device Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashFormatPartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Managemen
20. Script lO_Identity win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ENUMERATE the DCIM_N CString class to collect information about the NIC s attributes and FQDD See section 2 2 for a definition of ENUMERATE C SetAttribute Set various NIC attributes D CreateNICConfigJob Apply step C ReturnValue 4096 E Poll jobstatus for Completed GET the InstancelD of from D See section 2 3 fora definition of GET F The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready Pre LC2 NOTE The following RS Status polling is for CSIOR assuming its enabled G The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for re
21. Section 31 4 of this document describes the workflow for enumerating the DCIM_SystemView class Example data returned is shown below DCIM_SystemView AssetTag tag BlOSReleaseDate 08 20 2012 BlOSVersionString 1 3 5 BaseBoardChassisSlot NA BatteryRollupStatus 1 BladeGeometry 4 BoardPartNumber 0N051FX02 BoardSerialNumber CN13740920003M CMCIP CPLDVersion 0 4 7 CPURollupStatus 1 ChassisName Main System Chassis ChassisServiceTag S78FGH5 ChassisSystemHeight 1 ExpressServiceCode 61387326761 FQDD System Embedded 1 FanRollupStatus 3 HostName InstancelD System Embedded 1 LastSystemInventoryTime 20130206014757 000000 000 30 LC Integration Best Practices Specification LastUpdateTime 20130206004538 000000 000 LicensingRollupStatus 1 LifecycleControllerVersion 2 1 0 Manufacturer Dell Inc MaxCPUSockets 2 MaxDIMMSlots 24 MaxPCleSlots 3 MemoryOperationMode MirrorMode Model PowerEdge R620 PSRollupStatus 1 PlatformGUID 3548474f c0d3 4680 3810 00374c4c4544 PopulatedCPUSockets 1 PopulatedDIMMSlots 2 PopulatedPCleSlots 0 PowerCap 340 PowerCapEnabledState 3 PowerState 2 PrimaryStatus 3 RollupStatus 3 ServerAllocation ServiceTag S78FGH5 StorageRollupStatus 1 SysMemErrorMethodology 6 SysMemFailOverState NotInUse SysMemLocation 3 SysMemMaxCapacitySize 786432 SysMemPrimaryStatus 1 SysMemTotalSize 2048 SystemGeneration 12G Monolith
22. cteegedecedade ce cavetenes 141 LC Integration Best Practices Specification 32 8 33 33 1 33 1 1 33 1 2 33 1 3 33 1 4 33 1 5 33 1 6 33 2 33 2 1 33 2 2 33 2 3 33 2 4 33 2 5 33 3 33 3 1 33 3 2 33 3 3 33 3 4 33 3 5 33 3 6 33 4 33 4 1 33 4 2 33 4 3 33 4 4 33 4 5 33 4 6 33 4 7 33 5 Tables Table 1 Boot to hard drive HD enesios scenen ioien n EEEE EE T 141 APPENIIX errrsreriri nonini nenin EEEE EEEE ENN EEEE ENO EEE ENN EEEE EEEN 143 PYTHON Scripts README nici sevrcrssecer rest cnr eiin oder rsr enn EEE EN EEEE ESEE NE 143 PUPPOS s sss save sans aena EE ones uve EEE DEEE EEE E E EE REE 143 Requirements acienaiccescdxccisina oicsinaisioamainelsinamanenisinandis aie aiauaren AAE AAN EANES 143 Command lihe sisses naana anes Ean EAEEREN EE ANENE AAE ANEA 143 COMIMANGS sissccsnsnsesadsdeateadeneardeadaaseasdserardeadaascenssedesaavandbedeiananaageasaeeaand 144 S ttable variables i csusesisiescaasvae dee ontis On ANEA E eeu denaseuepetaevas dessus sduresade 146 Internal VANMADIES sssini scsscewsccwsanveeewsaens siusis awe ainsig sietia coms emai sinsis AEE nea ares 147 System Check information as sass scene sinnsdicvscccws seven svia diene sews ainsi since deine gaia e gine sieve crewsler 148 Check System Power States ccd cis cise ova cand davacewdvacens cavacdes cetbcaid cannceeceenoens oe 148 Check RS Status ivi sii stsisnreetbaeecnned sR A TEEN AAEE REEE ESENE 148 Check for pending JODS eisrassisesse ssostni a
23. definition of GET The instance of the available iDRAC that contains the information will be returned 30 Simple Identity Management Profile Use Cases 30 1 Discovery of Simple Identity Management profile support 130 LC Integration Best Practices Specification There is currently not a registered Simple Identity Management Profile prior to LC2 Use the following procedure below to confirm the existence of Simple Identity Management profile support Applies to LC2 Prerequisites for script none Script GetSimpleldentityMGMTProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Simple Identity Management and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM SimpleldentityManagement 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM SimpleldentityManagement 1 0 0 OtherRegis
24. for script none Script ClearProvisioningServer win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ClearProvisioningServer Invokes the ClearProvisioningServer method 31 9 Replace auto discovery public key Refer to Web Service Interface Guide section 12 6 31 10 Replace auto discovery client certificate private key and password Refer to Web Service Interface Guide section 12 7 31 11 Delete auto discovery public key Refer to Web Service Interface Guide section 12 11 136 LC Integration Best Practices Specification 31 12 Delete auto discovery client certificat private key and password Refer to Web Service Interface Guide section 12 8 31 13 Replace iDRAC web server client certificate and private key Refer to Web Service Interface Guide section 12 10 31 14 Replace iDRAC web server public certificate Refer to Web Service Interface Guide section 12 9 31 15 Insert comment into Lifecycle log Use the following procedure to insert a comment into the LC log Applies to LC1 5 0 Prerequisites for script Insert desired comment by editing script Script InsertCommentInLCLog win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands
25. hotspares before creating a single virtual disk and a dedicated hotspare Multiple EmbNIC BIOS attributes are also set to Enabled Following completion of the reboot the new virtual disk hotspare and BIOS attributes results will be verified Approximate time for completion on a 12G system is 15 minutes Applies to LC1 5 1 Prerequisites for script e Set FQDD of desired RAID controller by editing the following script e Applicable RAID controller and hard drives Script RAIDstacking_BIOS_setupjobqueue win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile 33 LC Integration Best Practices Specification B LC1 5 1 only Disable CSIOR Collect System Inventory on Restart NOTE On 11G systems CSIOR must be disabled to circumvent a sync behavior that prohibits successful RAID stacking a SetAttribute Sets attribute to be configured ReturnValue 0 b CreateConfigJob Creates jobID and applies configuration ReturnValue 4096 ENUMERATE the DCIM_ControllerView class to find RAID controller s instancelD amp FQDD they are often identical See Section 2 2 for a definition of ENUMERATE a Integrated RAID card example is RAID Integrated 1 1 b External RAID card example is RAID Slot 1 1 ResetConf
26. in that order Consider the following example Current 25 25 25 25 Target 30 30 20 20 Since 20 20 are both reducing values from 25 they should be scheduled first This makes space for increasing the other values Next values being increased can be scheduled 30 30 A more complex example FQDD 1 2 3 4 Current 5 5 50 40 Target 40 50 5 5 Deltas 35 45 45 35 Order of job FQDDs 3 4 1 2 MinBandwidth limitations are documented in the Simple NIC Profile in section 6 7 http attachments wetpaintserv us chcAMan6fnCly8Z8qYSnag350700 3 2 iDRAC cloning Blade cloning consists of a pull enumerating attributes and a push applying attributes The pull command is a basic enumeration command using the DCIM_iDRACCardAttribute class Applies to LC2 Script iDRACClonePull win A The remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAP Status method may be used depending on the version of the LC Management registered profile B ENUMERATE the DCIM_iDRACCardAttribute class same as DCIM_iDRACCardEnumeration class and store the results to be pushed See section 2 2 for a definition of ENUMERATE The blade cloning push requires an extended WSMAN timeout of 120 seconds versus the default of 60 seconds This is needed because of the numerous amounts of attributes that need to be applied Belo
27. offload on 1 3 is disabled create a job and reboot to enable it Once iSCSI is enabled configure iSCSI but it will not show up in the boot order until after reboot Once it is in the boot order move it to the top of the HD list A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPIStatus B GetBlOSEnumerations ENUMERATE the DCIM_BlOSEnumeration class to collect information about the system See section 2 2 for a definition of ENUMERATE e Ensure AttributeName of IntegratedNetwork1 is enabled 49 LC Integration Best Practices Specification e If it is not enabled enable it as shown below e SetBlOSAttributes e AttributeName IntegratedNetwork1 AttributeValue Enabled e AttributeName BootMode AttributeValue Bios e CreateBlOSConfigJob e ScheduledStartTime TIME_NOW RebootJobType 1 e Poll jobstatus for Completed GET the nstancelD of from 2 GetNICViews ENUMERATE the DCIM_NICVIEW class to collect information about the NIC FQDDs See section 2 2 for a definition of ENUMERATE e Check if specified FQDD is present in NICViews If not go to NICError GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE e Loop through all boot sources if boot source is IPL entry set EnabledState 0 unless HD ChangeBootSourceState Use Instan
28. on SD card vFlash e Passphrase required if backup image used passphrase edit script Script Restore_vFlash win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B Restorelmage Performs restore operation ReturnValue 4096 C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 fora definition of GET Import restore image from CIFS or NFS share This workflow performs a restore or import operation which restores an image from the either a CIFS or NFS share The TIME_NOW parameter is passed which invokes the operation immediately Approximate time for completion on an 12G system is 30 60 minutes depending on the system configuration and network Applies to LC1 5 0 Prerequisites for script 39 LC Integration Best Practices Specification 4 10 e Valid and enabled vFlash card with existing image e Set script variables by editing script Script Restore_CIFS_NFS win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B Restorelmage Performs restore operation ReturnValue 4
29. remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetiDRACCardAttributes ENUMERATE the DCIM_iDRACCardAttribute class to view all available attributes See section 2 2 for a definition of ENUMERATE C Confirm the IsReadOnly field is set to false D ApplyAttributes Invoke method to apply attribute s E GetiDRACCardAttributes ENUMERATE the DCIM_iDRACCardAttribute class to view all available attributes and confirm the changes were successful See section 2 2 fora definition of ENUMERATE 79 LC Integration Best Practices Specification 9 6 Schedule a set iDRAC card attribute s operation Use the following procedure to set a iDRAC attribute s using the SetAttributes and CreateTargetConfigJob methods This example sets the attribute immediately using the TIME_NOW parameter however the job can be scheduled for execution at a later time Applies to LC2 0 Prerequisites for script Set desired values by editing script Script SetiDRACCardAttribute win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetiDRACCardAttributes ENUMERATE the DCIM_iDRACCardAttribute class to view all available attributes See section 2 2 for a definition of ENU
30. the system configuration The four high level steps which may require 3 reboots are the following 1 If the NDC is disabled 1 job to enable it in bios and reboot 2 Now that the card is present if FCoE offload on 1 1 4 is disabled enable it Once FCoE is enabled configure FCoE but it will not show up in the boot order until after reboot 3 Once it is in the boot order move it to the top of the HD list Notes 1 QLogic will not show up in the boot list until it connects to an FCoE target So if you misconfigure FCoE or the network is down it does not show up 2 You cannot disable RAID and SATA HDs in the boot list Either disable the controller but then they are not available as secondary disks or move them down in the HD boot list 3 It may be a good idea to disable the whole HD list from the boot order until FCoE is on the top to prevent it booting into another 54 LC Integration Best Practices Specification HD 4 port settings are configured against partition 1 NIC Integrated 1 1 1 but the boot target will show up on partition 4 BCV BIOS Setup 1 1 HddSeq NIC Integrated 1 1 4 Applies to LC2 Prerequisites for script e QLogic NDC e Set desired script variables by editing script e FQDD must be NIC Integrated 1 1 1 for port setting and NIC Integrated 1 1 4 for boot target setting Script FCoEboot 12gNDC qlogic win A The Lifecycle Controller remote service must be in a ready state before execut
31. the DCIM_BootConfigSetting class to identify the ElementName field containing BootSeq and corresponding nstance D IPL or UEFI ElementName Hard drive C BootSeq C GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class and identify the desired one time boot source vFlash IPL or UEFI D ChangeBootOrderBylnstancelD using instancelD OneTime and Source instancelD from C E GetBootConfigSettings ENUMERATE the DCIM_BootConfigSetting class 72 LC Integration Best Practices Specification e The OneTime entry should have an sNext value of 3 which means Is Next for Single Use F GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class e Verify that an additional entry for that DCIM_BootSourceSetting appears with an InstancelD prefixed with OneTime such as InstancelD OneTime IPL HardDisk List 1 1 c9203080df84781e2ca3d512883dee 6f e After the reboot the boot list reverts to the original boot list The job will be marked Completed after the successful one time boot to the device 7 CPU Profile Use Cases 7 14 Discovery of CPU profile support Use the following procedure below to confirm the existence of CPU profile support Applies to LC1 5 0 Prerequisites for script none Script GetCPUProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServi
32. the following procedure to get a single video instance The URI for getting particular instance information is deterministic i e the nstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetVideoView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVideoView GET the DCIM_VideoView instance using the Instance D Video Embedded 1 1 See Section 2 3 for a definition of GET The instance of DCIM_VideoView that contains the information will be returned 26 License Management Profile Use Cases 26 1 Discovery of License Management profile support 119 LC Integration Best Practices Specification Use the following procedure below to confirm the existence of License Management profile support Applies to LC2 Prerequisites for script none Script GetLicenseManagementProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Lic
33. 096 C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 fora definition of GET iDRAC firmware DUP update from CIFS or TFTP share This workflow performs an update of the iDRAC firmware from a DUP by first downloading the DUP to the system then applying the update The update of the iDRAC firmware will be invoked after being scheduled using SetupJobQueue Approximate time for completion is 30 60 minutes depending on the system configuration and network Applies to LC1 3 0 Prerequisites for script e Desired DUP must be present on network share e Set script variables by editing script Script iDRAC_update win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSoftwareldentities ENUMERATE the DCIM_Softwareldentity class to list the firmwares on the system See section 2 2 for a definition of ENUMERATE C Search the results from B for LC1 5 0 LC1 5 1 ElementName iDRAC6 and note the accompanying instancelD to be used in D LC2 1 0 ElementName Integrated Dell Remote Access Controller and note the accompanying instancelD to be used in D Use the Software Inventory registered profile version to determine the applicable string to search for D InstallFromURI Invo
34. 1 Prerequisites for script e Set script variables by editing script Script ExportSystemConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ExportSystemConfiguration Invokes the export operation ReturnValue 4096 NOTE The user must set applicable IP address username password and filename of the network share C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 fora definition of GET Import System Configuration 12G only This method is used to import the system configuration from the Lifecycle Controller to a file on a remote share Applies to LC2 1 Prerequisites for script e Set script variables by editing script Script ImportSystemConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile 65 LC Integration Best Practices Specification 4 29 B ImportSystemConfiguration Invokes the import operation ReturnValue 4096 NOTE The user must set applicable IP address username password and filename of the network share C Poll jobstatus for Completed GET the nstancelD of from B See
35. 1 1 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Auto Discovery ProfileRequireLicense Part Replacement ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicense Remote Inventory Export ProfileRequireLicense Server Profile Export and Import ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED RegisteredName LC Management RegisteredOrganization 1 RegisteredVersion 1 4 0 31 2 Inventory of LC Management attributes in system Use the following procedure below to view all available LC attributes and possible values in the system Applies to LC1 5 0 Prerequisites for script none Script GetAllILCAttributes win 132 LC Integration Best Practices Specification A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCEnumerations ENUMERATE the DCIM_LCEnumeration class to view all instances See section 2 2 for a definition of ENUMERATE C GetLCStrings ENUMERATE the DCIM_LCString class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available LC Management attributes will be retur
36. 1 i i GetRSStatus i l l RELOADING READY I l i reapy i i i i jSYNCj l l TIME GetRemoteServicesAP Status Remote Services is not ready Lifecycle Controller Remote Services is ready I i Lifecycle Controller I i i NOTE Dotted lines denote the old behavior Bold red line denotes the new behavior in 12G The existing 11G workflows expect the RS status to be in RELOADING state once the job is marked COMPLETED So to maintain the compatibility with the 11G workflows the RS status is artificially held in the RELOADING state for 90 seconds even though it is actually READY This time limit was provided by the console team 18 LC Integration Best Practices Specification 1 7 4 GetRemoteServicesAPIStatus output descriptions Output parameter Possible values Description Name Status O Ready Lifecycle Controller Remote Services is ready to accept any web services request 1 Not Ready Lifecycle Controller Remote Services is currently not ready to accept web services request This could be because the instrumentation in iDRAC might be reloading not_ready or server is in POST or performing scheduled provisioning requests or Lifecycle Controller Unified Server Configurator is in MessagelD LCO60 LC061 use Message Lifecycle Controller Remote Services Message for ID LC060 is not ready Lifecycle Controller Remote Services Message for ID LC061 is ready ServerStatus Server is out of POS
37. 2BootProto to None ReturnValue 0 e CreateBlOSConfigJob Creates jobID and applies configuration immediately with reboot job type of 3 ReturnValue 4096 NOTE The following polling is for SSIB task f The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status D Sleep 500 seconds to allow PXE boot to occur Users would then select applicable PXE boot options before continuing Proceed to step E to disable PXE boot E Call subroutine sub_setEmbNICs_NIC1_NIC2_12G win to perform the following 45 LC Integration Best Practices Specification GetBlOSEnumerations Enumerate the DCIM_BlOSEnumeration to obtain the current values of EmbNic attributes DeletePendingBlOSConfiguration Ensures there is no other pending BIOS configuration SetAttribute Set parent attribute EmbNic1Nic2 to Enabled ReturnValue 0 SetAttribute Set child attributes EmbNicPort1BootProto to None and EmbNicPort2BootProto to None ReturnValue 0 CreateBlOSConfigJob Creates jobID and applies configuration immediately with reboot job type of 3 ReturnValue 4096 NOTE The following polling is for SSIB task The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status 4 15 Set NIC attributes and iSCSI boot using setupjobqueue 11G only This workflow sets several NIC attri
38. 9 4 10 iDRAC firmware DUP update from CIFS or TFTP Share sce eeeeeeec eee eeeeee eee eeeeneees 40 4 11 BIOS firmware DUP update from CIFS or TFTP Share sceece sees cece ee eeeeeeeeeenaens 41 4 12 USC firmware DUP update from CIFS or TFTP share sssessesoossssssssoosssssssoosssssseo 42 4 13 PXE Boot using embedded NICs 11G only esssssssssesssssssssssssesssssesssesesssssesesesesee 43 4 14 PXE Boot using embedded NICs 12G only ssssssssssssssssssssssssssssssssssssssssssssessees 45 4 15 Set NIC attributes and iSCSI boot using setupjobqueue 11G only sssssssssssssssssseseeee 46 4 16 iSCSI boot using NDC Broadcom 12G only ssssssssssssssessessssesesesesssseeeesssseseeeeeee 48 4 17 iSCSI boot using QLogic 12G only ssssssssssssssssesesesssseeseseseseseeseseeseessessseesseeese 49 4 18 SCS boot usme Intel 12G OMY herana aA aA EN AET A 51 4 19 LERE A A EEOAE NE A TE NE AAE NA A E NI O E NI E 53 4 20 EXpOre LC OG a raa E EEEE erase EET RAE EE Hed EEEE E E TR 54 4 21 FGoE boot using QLogic T26 ONY cerscrespe n aranna EEEa TRENAR RENAA A TRENER REEERE R ENE 54 4 22 FCoE boot usine Intel 12G ONLY seco areca sees inteiro arecasrows trotusrout NEEE EEEREN 56 4 23 FCoE boot using Broadcom 12G only acc c3 caus ies rece eecb aes wubb cnee webb vies eabd cous eetd aes et 59 4 24 lO Identity for QLogic 12G ONY J secs det ciens deste disieet estes deldlens dente deidiecd aS 61 4 25 IO Identity for Broadc
39. AIDConfigJob Apply steps D F ReturnValue 4096 I Poll jobstatus for Completed GET the InstancelD of from H See section 2 3 fora definition of GET J The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready K ENUMERATE the DCIM_VirtualDiskView class to ensure successful virtual disk creation See section 2 2 for a definition of ENUMERATE a RAIDTypes parameter will be 4 for a RAID 1 configuration b PhysicalDiskIDS parameter will list physical disks used L ENUMERATE the DCIM_PhysicalDiskView class to ensure successful hotspare assignments See section 2 2 for a definition of ENUMERATE a HotSpareStatus parameter of 2 indicates global hotspare b HotSpareStatus parameter of 1 indicates dedicated hotspare NOTE H200 controller is unique in that it always returns 2 for both dedicated and global hotspares RAID stacking with BIOS attributes using Setupjobqueue This workflow stacks multiple RAID operations together along with some BIOS attributes which requires one reboot operation using setupjobqueue The workflow deletes existing virtual disks and unassigns all
40. B Ensure CSIOR attribute is enabled e See Section 31 3 to Check and enable Collect System Inventory on Restart CSIOR C Power on or reboot system 28 LC Integration Best Practices Specification e NOTE If an operating system has been installed the system will boot into it It may be desired to wait until the OS boot is complete before performing a graceful shutdown D LC1 5 0 The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile e When the system is ready the inventory is updated 29 LC Integration Best Practices Specification 3 14 How to determine if the system is blade tower or rack Dell has been officially using M T and R letters in the Model name to distinguish between Modular Tower and Rack server respectively for the past couple of generations Getting the SystemGeneration attribute can be achieved by viewing the SystemView class Section 31 4 of this document describes the workflow for enumerating the DCIM_SystemView class Examples below e 11G Blades M610 M710 M910 e 12G Blades M420 M520 M820 e 11G Towers T310 T410 T610 e 12G Towers T320 T420 T620 e 11G Racks R310 R410 R610 e 12G Racks R320 R520 R820 3 15 Getting the SystemID Model and more
41. BIOS_update win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSoftwareldentities ENUMERATE the DCIM_Softwareldentity class to list the firmwares on the system See section 2 2 for a definition of ENUMERATE C Search the results from B for ElementName BIOS and for Status Installed then note the accompanying instancelD to be used in D D InstallFromURI Invokes firmware update operation ReturnValue 4096 E CreateRebootJob Pass parameter RebootJobType of value 3 1 PowerCycle 2 Graceful reboot without forced shutdown 3 Graceful reboot with forced shutdown F SetupJobQueue Use JID D and reboot RID E ReturnValue 0 The StartTimelnterval parameter is set to TIME_NOW meaning the operations will be invoked immediately G Poll RID jobstatus for Reboot Completed GET the nstancelD from E See section 2 3 for a definition of GET H Poll JID jobstatus for Completed GET the nstancelD from D See section 2 3 for a definition of GET 41 LC Integration Best Practices Specification 4 12 I LC1 5 0 LC1 5 1 Sleep for 5 minutes to allow reboot POST and CSIOR to complete See Appendix 33 4 3 and 33 4 7 for more information about POST and CSIOR J The Lifecycle Controller remote serv
42. CIM_LCRecordLogCapabilities class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available LCRecordLogCapabilities will be returned 99 LC Integration Best Practices Specification 15 4 system 15 5 List Lifecycle log entries Use the following procedure below to list the inventory of all LCLogEntry instances in the Applies to LC1 5 0 Prerequisites for script e Due to the large amount of data returned by this enumeration winRM settings may need to be changed as described in the section 1 2 Script GetLCLogEntries win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCLogEntries ENUMERATE the DCIM_LCLogEntry class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available LCLogEntry will be returned Set and get comment in Lifecycle log entries Use the following procedure below to Get and Set the instance of DC M_LCLogEntry with the Comment that needs to be added This is accomplished using an intrinsic set put operation on the DCIM_LCLogEntry instance at the Comment property Applies to LC1 5 0 Prerequisites for script e Due to the large amount of data returned by this e
43. CRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM PersistentStorage 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Virtual Flash Partitions ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED RegisteredName Persistent Storage RegisteredOrganization 1 RegisteredVersion 1 0 0 Inventory of virtual flash vFlash media Use the following procedure below to list the inventory of all vFlash in the system Applies to LC1 5 0 Prerequisites for script none Script GetvFlashViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile 82 LC Integration Best Practices Specification B GetvFlashViews ENUMERATE the DCIM_VFlashView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available virtual flash media will be returned Get the first vFlash s attribute information The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instanc
44. D FQDDs See section 2 2 for a definition of ENUMERATE C ClearForeignConfig Clears the configuration for a particular RAID controller using a target FQDD iw CreateRAIDConfigJob Apply step C ReturnValue 4096 gal s Poll jobstatus for Completed GET the InstancelD of from D See section 2 3 for a definition of GET j The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready 14 8 Determine available RAID configurations Use the following procedure below to list the available RAID level configurations for a given set of physical disks Applies to LC1 5 0 Prerequisites for script e Set desired RAID FQDD by editing script Script GetRAIDLevels win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile 93 LC Integration Best Practices Specification B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs S
45. D to use in step D D GetLCEnumeration GET the DCIM_LCEnumeration instance using the nstancelD from C See Section 2 3 for a definition of GET The instance containing the attribute will be returned Check vFlash license enablement Use the following procedure to get the Part Firmware Update attribute The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance 134 LC Integration Best Practices Specification 31 7 Applies to LC1 5 0 Prerequisites for script none Script CheckVFlashLicense win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCEnumerations ENUMERATE the DC M_LCEnumeration class to new view all available instances See section 2 2 for a definition of ENUMERATE C Search for AttributeName Licensed and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Check the CurrentValue parameter to determine if the system is licensed DCIM_LCEnumeration AttributeName Licensed DefaultValue No ElementName LC emb 1 InstancelD LifecycleController Embedded 1 LCAttributes 1 Licensed I
46. DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Interop Namespace AdvertiseTypes 1 1 InstancelD DCIM Fan 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName Fan RegisteredOrganization 1 RegisteredVersion 1 0 0 Inventory of fans in system Use the following procedure below to list the inventory of all fans in the system Applies to LC1 5 0 Prerequisites for script none Script GetFanViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetFanViews ENUMERATE the DCIM_FanView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available fans will be returned Get the first fan s information Use the following procedure to get a single fan instance The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetFanView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServ
47. Discovery of Simple NIC profile support ssssesssssessssssessessssseeeesssssseeeeessssseeeeess 105 inventory of NIGSIm SYSTE ees hes E EEEE E E aeons 105 Get the first NICs informatio ss sac asesscee see erai ertncabbecte rE ENTEN AE ESE EENAA aS 106 List alliNI attributes a cernens i aniei eee ae ee an Ear TaN EE Ea aas 106 Del t pending NIC Values sc cccssitsewedebddawessleduene ENa CNE EKANA E ENEE AEE EENI NES 106 Discovery of NIC capabilities a eino E aa O EEA AE EAEE ERINA E EEEIEE 107 Software Update Profile use cases s ossosssessesosesssssesosssssssesossssssseoosesessseoose 108 Discovery of Software Update profile support sssessesosssssssososssssssooossssssesoossses 108 Job Control Profile Use Cases ss isrerssrosre cave rissrrieseierii slong aint aia ceive sinniecerssrevesereaneres 109 Discovery of Job Control profile SUPPOrt sssini eti nessen eti era i ese aa a 109 listal jobs IMJ OD SCORE hsnas ann dite rats a a aes a e A a a emote 109 Get ONE JOb SINFOMMALION ss ssserss ensi eit cessant orsi aan nes EIN enS EAE EN ani ESE EEEa nS 110 Delete all jobs from job store job queue using JID_CLEARALL ceeeeeee sees 110 Delete one job from job Store sence nai ied a ae eee ee 111 Memory Profile USE Cases orori RA EEE A RENE ESA EER 111 Discovery of Memory profile support ssssssssssssssssssssssssssssssssssssssssssssssssesessees 111 Inventory of memory IN SYSCEM 3 eecciiere ced n naie aaia
48. Integration Best Practices Specification 29 5 C Choose the Software Identity instance with ElementName BIOS and Status Installed to use in C GetSoftwareldentity GET the DCIM_Softwareldentity instance from C See Section 2 3 for a definition of GET The instance of the installed BIOS that contains the information will be returned Get the available iDRAC firmware inventory Use the following procedure to get the available iDRAC software instance The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance Applies to LC1 4 0 Prerequisites for script none Script GetAvailableiDRACView win A B The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetSoftwareldentities ENUMERATE the DCIM_Softwareldentity class to view all instances See section 2 2 for a definition of ENUMERATE Prior to LC2 Choose the Software Identity instance with ElementName iDRAC6 and Status Available to use in C LC2 Choose the Software Identity instance with ElementName Integrated Dell Remote Access Controller and Status Available to use in C GetSoftwareldentity GET the DC M_Softwareldentity instance from C See Section 2 3 for a
49. LC Integration Best Practices Specification 27 3 27 4 27 5 Get the first power supply s information Use the following procedure to get a single power supply instance The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetPowerSupplyView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetPowerSupplyView GET the DCIM_PowerSupplyView instance using the InstancelD PSU Slot 1 See Section 2 3 for a definition of GET The instance of DCIM_PowerSupplyView that contains the information on the first power supply will be returned Get MAC information This workflow enumerates DCIM_SystemView and invokes GetMACInfo Applies to LC1 5 0 Prerequisites for script none Script CollectBlades win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSystemViews ENUMERATE the DCIM_SystemView class See section 2 2 fora defin
50. LC Integration Best Practices Specification LC Integration Best Practices A Dell Technical White Paper Steven Zessin Ganesh Viswanathan Zhan Liu LC Integration Best Practices Specification This document is for informational purposes only and may contain typographical errors and technical inaccuracies The content is provided as is without express or implied warranties of any kind 2012 Dell Inc All rights reserved Dell and its affiliates cannot be responsible for errors or omissions in typography or photography Dell the DELL logo and the DELL badge PowerConnect and PowerVault are trademarks of Dell Inc Microsoft and WinRM are either trademarks or registered trademarks of Microsoft Corporation in the United States and or other countries Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products Dell Inc disclaims any proprietary interest in trademarks and trade names other than its own February 2013 Rev 1 1 0 LC Integration Best Practices Specification Contents DW COMLENUES isc i sacs seccsincapncdsaca necadeedgeenaaenpinddd oad sanede aa pindds mada aed decapiodds vad eadeesapeads beds nade nsaueca s 12 1 1 How touse this GOCUMOENE siisics scxns cosecsecuiebausen cexeseaaun EEEREN RSE 12 1 2 USING the sample SCHIPES sisssscassecdonesesedndads ete dsdinnenn anaes nese as ete duce bess duseseesdaiee vied 12 1 3 Improving WINR
51. LC status is not relevant A GetRFSISOImageConnectionInfo Invoke the method successful return value is 0 32 8 Boot to hard drive HD 141 LC Integration Best Practices Specification The BootToHD method is used to boot the system to the hard drive even if the hard drive is not first in the boot order Applies to LC1 5 2 Prerequisites for script none Script BootToHD win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetRFSISOlmageConnectionInfo Invoke the method successful return value is 0 142 LC Integration Best Practices Specification 33 Appendix 33 1 PYTHON scripts README 33 1 1 Purpose The goal of recite py is to provide a simple and fast interface for the Dell Lifecycle Controller API It has an interactive mode that is useful to run one off commands against a server as well as batch mode to allow automating a sequence of operations 33 1 2 Requirements Client Windows XP or greater with Windows Remote Management winrm Linux with Web Services for Management client wsmancli Python version 2 4 to 2 6 Server Dell 11G servers iDRAC Enterprise version 1 70 racks and towers version 3 21 blades or greater Dell Lifecycle Controller version 1 5 or greater 33 1 3 Command line python recite py NAME1 VALUE1 NAME2 VALUE2 CMD1 CMD2 batch1 win batch2 win Set variable
52. M enumeration performance esssssssssesssoossssseseosssssssesossssesesooss 12 1 4 Feature discovery procedure sssesssesessseseseseseseseseseseseseseseseseseseseseseseseseseses 13 1 5 Profile revision number explanation essseesesosssesssososssesesososssesesososssesesoosssseses 14 1 6 LC and LEZ nomenclature isis cicnscnnssevsceroeensanneriens siensainns gee s 15 1 7 System status and configuration job behavior sce sce ecesc eect scene eee eeeeeeeneeneees 15 1 7 4 RS Status and JOD Status vivcciscesisscdecsmeseeeedtercndecreneneeenmi ore ereeadvecdea cepeencaeneeeteance 16 1 7 2 GetRemoteServicesAPIStatus and job Status cc ccc ecc cece cece eee e eee eeeeeeeeeeeeeeeeeeaes 17 1 7 3 11G and 12G compatibility sessionerne naa snared cebasiedet seadsaaenawasucieseaweess 18 1 7 4 GetRemoteServicesAPIStatus output descriptions ssssssssssoossssssseooossssessoossses 19 1 8 REFERENCE UNKScmissoiccosirisra srno tisnin mainin NE aaRS EAE EEE EENE 20 2 Termsand DEFINITIONS vo s cic ns diesieaie as cans sitve sieve ciems dinnsaiens n a a 21 3 Anomalous Algorithms and Descriptions cccccese ese eeeeseeceeneseeenenaseneeaeeneeeceneeeseeeeeees 22 3 1 Setting CNA bandwidth isesi eare eronneen Erren ans EE EEE ener eneendye ox 22 3 2 IDRAC COMIN Dosser n innsir nE ESAE EENET EEE EAEE NEDER D 22 3 3 Setting NIC string attributes to Bl k iscissi neni 23 3 4 Determine NIC Card sciccascaacensccrcscenscstenso
53. MERATE C Confirm the IsReadOnly field is set to false for desired instances D SetAttributes Invoke method ReturnValue 0 E CreateiDRACConfigJob Apply pending values using TIME_NOW paramter F GetiDRACCardAttributes ENUMERATE the DCIM_iDRACCardAttribute class to view all available attributes and confirm the changes were successful See section 2 2 for a definition of ENUMERATE 10 Fan Profile Use Cases 10 1 Discovery of Fan profile support Use the following procedure below to confirm the existence of fan profile support Applies to LC1 5 0 Prerequisites for script none Script GetFanProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Fan and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET 80 LC Integration Best Practices Specification 10 2 10 3 Results for the InstancelD of DCIM Fan 1 0 0 shown below If no instance is returned the profile is not supported
54. M_BootSourceSetting class to collect information about the NIC FQDDs See section 2 2 for a definition of ENUMERATE e Loop through all boot sources if boot source is IPL entry set CurrentEnabledStatus 0 unless HD Steps D F E ChangeBootSourceState Use InstancelD IPL EnabledState 0 source instancelD from C 51 LC Integration Best Practices Specification e Set CurrentEnabledStatus 1 for NIC FQDD boot source F GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the NICs See section 2 2 for a definition of ENUMERATE e Check the CurrentEnabledStatus state G Configure iSCSI e CreateBlOSConfigJob Target BIOS FQDD e SetNiCAttributes Target NIC FQDD Set the attribute LegacyBootProto to the value iSCSIPrimary e CreateNICConfigJob Target NIC FQDD e Poll jobstatus for Completed using instancelD from CreateNICConfigJob H Move iSCSI to the top of the HD Boot List by looping through boot sources e GetBootSourceSettings e ChangeBootSourceState Use InstancelD IPL EnabledState 1 source instancelD from GetBootSourceSettings I GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the NIC FQDDs See section 2 2 for a definition of ENUMERATE e Loop through boot sources to confirm the NIC FQDD and BCV are in an instancelD J Set NIC to first in boot order e GetBootSourceSettings e ChangeBootOrderBylns
55. M_SELRecordLog class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available SELRecordLog will be returned 15 7 List system event record log capabilities Use the following procedure below to list the inventory of all SELRecordLogCapabilities instances in the system Applies to LC1 5 0 Prerequisites for script none Script GetSystemEventLogCapabilities win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSystemEventLogCapabilities ENUMERATE the DCIM_SELRecordLogCapabilities class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available SELRecordLogCapabilities will be returned 15 8 List system event log entries Use the following procedure below to list the inventory of all SELLogEntry instances in the system Applies to LC1 5 0 Prerequisites for script none Script GetSystemEventLogEntries win 101 LC Integration Best Practices Specification A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered
56. OS if current value is UEFI a SetAttribute Sets attribute to be configured ReturnValue 0 b CreateBlOSConfigJob Creates jobID and applies configuration ReturnValue 4096 C GetBootConfigSettings ENUMERATE the DCIM_BootConfigSetting class to identify the ElementName field containing BootSeq and corresponding InstancelD IPL or UEFI See section 2 2 for a definition of ENUMERATE ElementName Hard drive C BootSeq D GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class See section 2 2 for a definition of ENUMERATE a The CurrentAssignedSequence attribute of each instance defines the instance s place in the zero based indexed boot sequence b The CurrentEnabledStatus attribute defines whether the boot source such as the hard drive is enabled c If the current sequence is 0 and the status is enable skip to the end E ChangeBootOrderBylnstancelD using instancelD IPL ReturnValue 0 F ChangeBootSourceState using instancelD IPL and EnabledState 1 ReturnValue 0 G Poll jobstatus for Completed GET the nstancelD of from E See section 2 3 fora definition of GET 37 LC Integration Best Practices Specification 4 6 4 7 H The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The G
57. SNAME1 to VALUE1 SNAME2 to VALUE Execute CMD1 CMD2 in order Execute batch scripts in order and exit Enter interactive mode if no scripts specified python recite py IP 10 0 0 1 10 0 0 2 10 0 0 3 Spawn three instances of recite py in separate windows each with IP specified 143 LC Integration Best Practices Specification python recite py IP username password 10 0 0 1 Set SIP SLOGIN and PASS with a single assignment python recite py IP username dell123 10 0 0 1 username dellam 10 0 0 2 Spawn two instances with specified SIP SLOGIN and PASS python recite py IP IP ini Load IPs from file one per line 10 0 0 1 or user pass 10 0 0 1 comments a line python recite py IP 10 0 0 1 GetRSStatus GetLifecycleJobs Execute GetRSStatus and GetLifecycleJobs on specified IP 33 1 4 Commands Most of the API methods exposed by the Dell Lifecycle Controller WSMAN interface are supported The script also provides a list of common internal commands to allow for minimalprogrammatic functionality These include Command Shortcut Batch Clear Context Count Find Gosub gt gt Goto gt If Log 144 LC Integration Best Practices Specification Print lt Return Set Sleep Unset Until Use the help command in interactive mode to see further details on all available commands and methods and the required syntax Apart from the syntax described in help commands can also be con
58. SVirtWWPN_value e CreateNICConfigJob for o Partition 1 o Partition 3 o Partition 4 o Then Reboot e Poll job status for completion using InstancelD form CreateNICConfigJob lO Identity for Broadcom 12G only This workflow sets IO Identity for Broadcom card only The script is an example for setting IO Identity for the following set e Partition Disabled Applies to LC2 Prerequisites for script e Broadcom card e Set desired script variables by editing script Script 1O_IdentityBroadcom win The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status 62 LC Integration Best Practices Specification B Check NIC is enabled 1 GetBlOSEnumerations ENUMERATE the DC M_BlOSEnumeration class to collect information about the system 2 Ensure the NIC is enabled If not enabled enable it as shown below e SetBlOSAttributes Target BIOS FQDD e CreateBlOSConfigJob Target BIOS FQDD e ScheduledStartTime TIME_NOW RebootJobType 1 e Poll job status for Completed C Disable the FlexAddress e SetLCAttributes AttributeName VirtualAddressManagement AttributeValue Console D Set IO Identity e SetNiCAttributes Target NIC FQDD e CreateNICConfigJob Target NIC FQDD e Poll job status for completion using instancelD form CreateNICConfigJob 63 LC Integration Best Practices Specification 4 26 lO Identity for Intel 12G
59. T 3 Collecting System Inventory Server is currently executing UEFI Collect System o Sl 4 Automated Task Execution Server is currently executing scheduled jobs using ae E e 5 Lifecycle Controller Unified Server Server is executing UEFI Lifecycle Controller Unified and enabled 1 Not Initialized Lifecycle Controller instrumentation is not initialized The initialization operation may take up to a minute 2 Reloading Data Lifecycle Controller instrumentation is currently refreshing its cache because of a recent configuration change The reloading operation typically takes few seconds and could take up to few minutes to complete 3 Disabled Lifecycle Controller is disabled on the server Lifecycle Controller can be enabled thru Remote Services or F2 iDRAC configuration 4 In Recovery Lifecycle Controller is in Recovery mode Refer to iDRAC users guide on instructions on how to repair Lifecycle Controller 5 In Use Lifecycle Controller is being currently used by another process 19 LC Integration Best Practices Specification 1 8 Reference links Web Services Interface Guide for Windows amp linux e http www delltechcenter com page Lifecycle Controller Profiles e http en community dell com techcenter systems management w wiki 1906 aspx PCI ID reference list e http pciids sourceforge net pci ids Installation and Configuration for Windows Remote Management e http msdn microsoft com en us li
60. TE the DCIM_CPUView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available CPUs will be returned 7 3 Get the first CPU s information Use the following procedure to get a single CPU instance The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetCPUView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetCPUView GET the DCIM_CPUView instance using the InstancelID CPU Socket 1 See Section 2 3 for a definition of GET The instance of DCIM_CPUView that contains the information on the first CPU will be returned 8 Event Filter Profile Use Cases 8 1 Discovery of Event Filter profile support Use the following procedure below to confirm the existence of Event Filter profile support This profile is currently not supported prior to LC2 Applies to LC2 Prerequisites for script none Script GetEventFilterProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands 74 LC Integration Best Practices Specification
61. The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B InsertCommentInLCLog Invokes the InsertCommentinLCLog method 31 16 Export and view the content of the Lifecycle log See section 3 16 of this document 31 17 Export and view the current hardware inventory This workflow exports the hardware inventory to either an NFS or CIFS share Approximate time for completion on an 11G system is 5 minutes depending on the system configuration Applies to LC1 5 0 Prerequisites for script e Set script variables by editing script 137 LC Integration Best Practices Specification Script ExportHWinventory win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ExportHWinventory Invokes the export operation ReturnValue 4096 NOTE The user must set applicable IP address username password filename and workgroup of the network share C Poll jobstatus for Completed GET the nstancelD of from D See section 2 3 fora definition of GET 31 18 Export and view the hardware inventory as shipped from the factory This workflow exports the factory configuration inventory to either an NFS or CIFS share Approximate time for complet
62. UMERATE The instance information of all available system attributes will be returned 28 5 Geta single system string attribute Use the following procedure below to get a single system attribute in the system Applies to LC2 Prerequisites for script Set desired instancelD by editing script Script GetSystemString win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetSystemString GET the instance using the desired class s InstancelD See Section 2 3 for a definition of GET The instance that contains the information on the attribute will be returned 28 6 Setting and applying system attributes The following procedure sets a system attribute and applies the new configuration 125 LC Integration Best Practices Specification Applies to LC2 Prerequisites for script Set desired values by editing script Script SetSystemAttribute win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetSystemAttributes ENUMERATE the DCIM_SystemAttribute class to view all instances of the attributes from the following classes DCIM_SystemEnumeration DCIM_Systeminteger and DCIM_SystemString See section 2 2 for a definition of ENUMERATE C Confirm correct FQDD and that the IsReadOnly field is set to false D SetSystemAt
63. VirtWWN AttributeValue SVirtWWN AttributeName VirtWWPN AttributeValue VirtWWPN AttributeName MinBandwidth AttributeValue MinBandwidth AttributeName MaxBandwidth AttributeValue MaxBandwidth 4 CreateNICConfigJob Set Port Attributes as follows ul SetNICAttributes on NIC Integrated 1 1 1 AttributeName FirstFCoEWWPNTarget AttributeValue FirstFCoEWWPNTarget AttributeName FirstFCoEBootTargetLUN AttributeValue FirstF CoEBootTargetLUN 6 CreateNICConfigJob with RebootJobType 1 GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Loop through all boot sources if boot source is IPL entry set EnabledState 0 unless HD ChangeBootSourceState Use InstancelID IPL EnabledState 0 source instancelD from D GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Enable the HD boot source ChangeBootSourceState Use InstancelID IPL EnabledState 1 source instancelD from F GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Change NIC boot source GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Che
64. a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Base Server and Physical Asset and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM BaseServerandPhysicalAsset 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM BaseServerandPhysicalAsset 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense ProfileRequireLicenseStatus RegisteredName Base Server and Physical Asset RegisteredOrganization 1 RegisteredVersion 1 0 0 24 2 Discovery of Base Server and Physical Asset profile support LC151 There is not an LC registered Base Server and Physical Asset Profile prior to LC2 0 There are however separate Base Server and Physical Asset profiles Use the following procedure below to confirm the existence of the Base Server profile and Physical Asset profile support prior to LC2 0 Applies to LC1 5 0 LC1 5 1 Prerequisites for script n
65. ailable NIC FQDDs See section 2 2 for a definition of ENUMERATE C DeletePendingNiCConfiguration Deletes the pending configuration for a particular NIC using a target FQDD such as NIC Embedded 1 1 A return message of No pending data present to delete indicates that there is no pending NIC configuration to delete for the respective FQDD Discovery of NIC capabilities Use the following procedure below to determine the capabilities of NIC cards such as QLogic Broadcom and Intel Applies to LC1 5 0 Prerequisites for script e none Script NiCcapEnable win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetNiCCapabilities ENUMERATE the DCIM_NICCapabilities class to view all instances of the class See section 2 2 for a definition of ENUMERATE If instances are returned go to end of script as the capabilities are published C GetNIiCViews ENUMERATE the DCIM_NICView class to view all available NIC instances See section 2 2 for a definition of ENUMERATE If no instances are returned go to end of script as no NICs are present D GetSystemViews ENUMERATE the DCIM_SystemView class See section 2 2 fora definition of ENUMERATE If the PowerState field is equal to 8 power on system
66. all pending data was cleared and the set values were successfully applied NIC and BIOS inventory are described in sections 33 3 3 and 33 3 5 Error to user stating failures if any pending values still persist or if set values weren t applied as required 33 4 7 CSIOR On the server side the following tasks are redone since the machine will reboot and perform CSIOR The overall timeout for SSM should include the following timeouts o POST as described in section 33 4 3 o CSIOR UEFI Initialization similar to section 33 4 1 o CSIOR Inventory o CSIOR Cleanup 33 5 iSCSI boot information In addition to the programmatic steps shown in section 4 16 additional detailed information about the script is added below 1 Check FQDD if LOM NDC or add in o On11G Embedded LOM Integrated LOM o On12G Embedded LOM Integrated NDC o Addins can be Slot Mezzanine etc 2 Check LOM NDC enablement 151 LC Integration Best Practices Specification o For LOM EmbNic1Nic2 needs to be enabled for 1 1 2 EmbNic3Nic4 needs to be enabled for 3 1 4 And so forth o For NDC IntegratedNetwork1 needs to be enabled for 1 1 1 2 IntegratedNetwork2 needs to be enabled for 2 1 2 2 And so forth o Addins Cannot be disabled on 11G On 12G individual slots can be disabled TBD if this needs to be addressed o Create a BIOS job EmbNic1Nic2 Enabled or IntegratedNetwork1 Enabled BootMode Bios For Broad
67. ands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready D Call subroutine sub_setEmbNICs_NIC1_NIC2 win to perform the following 43 LC Integration Best Practices Specification GetBlOSEnumerations Enumerate the DCIM_BlOSEnumeration to obtain the current values of EmbNic attributes DeletePendingBlOSConfiguration Ensures there is no other pending BIOS configuration SetAttribute Set parent attribute EmbNic1Nic2 to Enabled ReturnValue 0 SetAttribute Set child attributes EmbNic1 and EmbNic2 to EnabledPxe ReturnValue 0 CreateBlOSConfigJob Creates jobID and applies configuration immediately with reboot job type of 3 ReturnValue 4096 NOTE The following RS Status polling for SSIB task The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready NOTE The following RS Status polling is for PXE to be set in the boot li
68. assetedeeenoas sosaawaereassinad EANN EE EARDER ASEAS 23 3 5 List of partitionable NIC cards for LC2 vescisssvaansedeteasedsoneesansesadven duedavanaeaeavessawaanees 24 3 6 iDRAC Telnet attribute enables SerialRedirection ccccccecceececceececceaceceenceeeens 24 3 7 Never unplug hardware during updates ossessesssososssssssososssesssososssssesossssseses 25 3 8 Express versus Enterprise IDRACS iss sicss sicns ciews scene ciews cists alesis crews alewa dies senenin diets alewia crewa ale 25 3 9 CIM Query Language COL Filters sicissessscscess onsinaieis seine amin one cleats inneni sna siete aces ore 26 3 9 1 CQL filter benefitsiar ean adseadees sahara saan ater eseoumes NA EE EENS 26 3 9 2 How to perform CQL enumerations using RECITE ssssssssssssssessessssseseresssseeessesese 26 3 9 3 CQL filter example that enumerates all NIC attributes for a particular port partition 26 3 9 4 CQL filter example that enumerates all iDRAC attributes with a particular GroupDisplayName and AttribUteENamMe ccc sceceese ennei nianie e aE AE AREE 27 3 9 5 CQL filter example that enumerates all BIOS attributes where the IsReadOnly flag is set to TRUE 27 3 10 Ordering of iDRAC attributes to set or apply 11G VS 12G cece eee ee eee ee eect ee eee eee 27 3 11 How to determine if Server is 11G OF 12G sevecetsncdateasccindessaetaven see dane cevadedeeszedesess 28 3 12 Using special characters in usernameS essesossse
69. ation RegisteredName Physical Asset RegisteredOrganization 2 RegisteredVersion 1 0 0 24 3 List all CIM profiles Use the following procedure below to list all CIM profiles supported on a system Applies to LC1 3 0 Prerequisites for script none Script GetCIMRegisteredProfiles win 117 LC Integration Best Practices Specification A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetClMRegisteredProfiles ENUMERATE the DCIM_RegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE 25 Video Profile Use Cases 25 1 Discovery of Video profile support Use the following procedure below to confirm the existence of Video profile support Applies to LC1 5 0 Prerequisites for script none Script GetVideoProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE Search for RegisteredName Vi
70. atus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetControllerView GET the DCIM_ControllerView instance using the desired instancelD See Section 2 3 for a definition of GET The instance of DCIM_ControllerView that contains the information on the first RAID controller will be returned 14 4 Inventory of virtual and physical disks in system Use the following procedure below to list the inventory of all virtual disks and physical disks in the system Applies to LC1 5 0 Prerequisites for script none Script GetRAIDDiskInventory win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVirtualDiskViews ENUMERATE the DCIM_VirtualDiskView class to view all instances See section 2 2 for a definition of ENUMERATE C GetPhysicalDiskViews ENUMERATE the DCIM_PhysicalDiskView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available virtual disks and physical disks will be returned 14 5 Apply pending values for a RAID configuration View the CreateRAIDConfigJob step in the RAID stacking workflows in Section 4 for a comprehensive example 14 6 Delete pending values f
71. ave been added e Increments in the errata field indicate that one more defects have been fixed 1 7 System status and configuration job behavior The details below describe the generational evolution of how a typical configuration job relates to the state of the system 15 LC Integration Best Practices Specification 1 7 1 RS Status and job status The details below describe how the remote service RS status relates to the job status RS status is a feature that indicates whether the system is ready to invoke WSMAN commands It must be in a ready state before executing any WSMAN commands NOTE The RS Status method was introduced in LC1 5 0 Typical Life Cycle of an 11G LC1 5 0 amp LC1 5 1 Configuration Job Figure 1 READY FOR EXECUTION ii SCHEDULED toot ii Job Status RUNNING ot io i i i i ii GetRSStatus f i READY 5 o E isynci TIME NOT TO SCALE COMPLETED RELOADING READY 16 LC Integration Best Practices Specification After the job is complete in Automated Task Application previously SSM the job status is immediately updated in the job store The job is moved immediately to the Completed state once it is complete in the Automated Task Application As seen in the timeline diagram above after the job is Completed the sync happens in the configDB and then the RS status goes to Reloading state After all the required populators are refreshed successfully the RS status
72. below e SetBlOSAttributes AttributeName SnicAttributeName AttributeValue Enabled AttributeName BootMode AttributeValue Bios e CreateBlOSConfigJob e ScheduledStartTime TIME_NOW RebootJobType 1 e Poll jobstatus for Completed Check partition is enabled if not enable it as follows AttributeName NicPartitioning AttributeValue Enabled Configure FCoE 1 Disable all sources 2 Create BIOS job 3 Set the following attributes LegacyBootProto FCoE ConnectFirstFCoETarget Enabled FCoEOffloadMode Enabled FCoET gtBoot Enabled VirtWWPN your WWPN address FirstFCOEWWPNTarget your FirstFCoEWWPNTarget address FirstFCoEBootTargetLUN your FirstFCoEBootTargetLUN value GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the boot sources Loop through all boot sources until find the NIC then enable the NIC boot source 60 LC Integration Best Practices Specification 4 24 O Identity for QLogic 12G only This workflow sets IO Identity which are the following virtual Mac address virtual iSCSI Mac address virtual FIP Mac address virtual WWN and virtual WWPN This workflow is for Qlogic cards only This script has been tested on Qlogic Mezz card slot 2 with the following setting Different cards or different slots require modifications to the script e Snic NIC Mezzanine 2B 1 1 e Snic2 NIC Mezzanine 2B 1 2 e Snic3 NIC Mezzanine 2B 1 3 e Snic4 NIC Mezzanine 2B 1 4 e SnicAttributeName Slo
73. brary windows desktop aa384372 v vs 85 aspx 20 LC Integration Best Practices Specification 2 Terms and Definitions LC Lifecycle Controller ENUMERATE Refers to WS MAN ENUM ERATE operation as described in Section 8 2 of DSP0226_V1 1 and Section 9 1 of DSP0227_V1 0 GET Refers to WS MAN GET operation as defined in Section 7 3 of DSP00226_V1 1 and Section 7 1 of DSPO0227_V1 0 iDRAC monolithic servers integrated Dell Remote Access Controller management controller for blades and USC Unified Server Configurator iSCSi Internet Small Computer System Interface an Internet Protocol IP based storage networking standard for linking data storage facilities SSM System Services Manager CSIOR Collect System Inventory on Restart SSIB System Services Information Block UEFI Unified Extensible Firmware Interface BIOS Basic Input Output System NIC Network Interface Controller FQDD Fully Qualified Device Description LCL Lifecycle Log WSIG Web Services Interface Guide 21 LC Integration Best Practices Specification 3 Anomalous Algorithms and Descriptions 3 1 Setting CNA bandwidth The recommended algorithm is to schedule jobs such that MinBandwidths are first reduced and then increased Essentially delta values need to be sorted and jobs scheduled
74. butes including setup of iSCSI boot by first setting the required attributes for the operation and then changing the boot order for the NIC Approximate time for completion on an 11G system is 15 30 minutes depending on the system configuration Applies to LC1 5 0 amp LC1 5 1 Prerequisites for script Set script variables by editing script Script setNICs_iSCSI_boot win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile ENUMERATE the DCIM_NICView and DCIM_Softwareldentity classes to collect information about the system See section 2 2 for a definition of ENUMERATE Enable CSIOR Collect System Inventory on Restart if not enabled a b SetAttribute Sets attribute to be configured ReturnValue 0 CreateConfigJob Creates jobID and applies configuration ReturnValue 4096 Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 for a definition of GET 46 LC Integration Best Practices Specification D ENUMERATE the DCIM_N CEnumeration DCIM_NICString DCIM_NiCInteger and DCIM_BlOSEnumeration classes to collect information about the system See section 2 2 for a definition of ENUMERATE SetBlOSAttributes Set all the following attributes if at least one is not set to d
75. c eee e eee e eee ee cence ene eeeeeeneeeneeeeeeeneees 93 Determine available physical disks for a RAID configuration cceeeceeeceeeeeeeees 94 Check available virtual disk parameters for a given RAID level and set of physical disks 94 Createa Virtual diskoaren niese na EE eSEE EES AEN ASR EEEREN ETS e ANEN eniris ena 95 Determine available physical disks to be used as a hotspare sce eeceeecenceeeeeneees 95 Assign a physical disk aS a NOtSPAare cecceecceec cece eeeceeeceeeseeeseeeseeeseesseeseeeeeees 95 Delete asvirtual disk from the Systemi rersieiccrion enrere irea nre eid seas be E N ee se wales 95 Delete all virtual disks and unassign all hotspares sce ece eee eee eee ee eee eee eee eeeeneenas 96 Convert physicalidisks to RAID State srana rateom tic cea seseaaaw eis eas sanuiewe tas EEA 96 Convert physical disks to non RAID state ssssssssssssssosssssssoosessessesosssssssossesees 97 LC Integration Best Practices Specification 15 15 1 15 2 15 3 15 4 15 5 15 6 15 7 15 8 16 16 1 16 2 16 3 16 4 17 17 1 18 18 1 18 2 18 3 18 4 18 5 18 6 19 19 1 20 20 1 20 2 20 3 20 4 20 5 21 21 1 21 2 21 3 Record Log Profile Use Cases vencercssvvecinvs sintncenadnne ents sennen i iiin en a s 98 Discovery of Record Log profile SUPPOFt cece eee eec cece enc eeeeeeneeenseeneeeneeenseeneees 98 List Lifecycle record lOgS wiecice sv csec cece atiwedive
76. catenated on methods This allows for a cleaner syntax E g CreateRAIDConfigJob Target Sctlr RebootJobType 3 ReturnValue 4096 Sjid InstancelD Perform Until loop On success perform Find operation GetRSStatus Status Reloading Status Ready Perform Until looking for Status Reloading Perform Until looking for Status Ready GetLifecycleJobs njob njob 1 gt End Count number of jobs If only one job Goto End Script execution is terminated if A command returns an error E g Find Context etc A method returns no data E g GetPhysicalDiskViews when no disks are present A command has a syntax error 145 LC Integration Best Practices Specification In order to ignore such errors and resume execution prepend command with a For example Find InstancelD Sid GetPhysicalDiskViews 33 1 5 Settable variables The following variables are loaded from environment variables if available If not they are default initialized as specified SIP IP of the iDRAC against which WS MAN commands are to be executed Default Set SIP 10 0 0 1 Set SIP username password 10 0 0 1 SLOGIN iDRAC username with WS MAN privileges Default username Set SLOGIN username SPASS iDRAC password Default password Set SPASS dell123 STIMER If True display time taken by WS MAN command Default False Set STIMER True SUSLEEP Default sleep delay in seconds used by until commands between method invocations 146
77. celD IPL EnabledState 0 source instancelD from D GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE e Enable the HD boot source ChangeBootSourceState Use InstancelD IPL EnabledState 1 source instancelD from F GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE e Change NIC boot source GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE e Check NIC boot order ChangeBootOrderBylnstancelD Use InstancelD IPL source instancelD from l e SetNIiCAttributes Set the attribute LegacyBootProto to the value iSCSI and the other desired NIC attributes and values CreateBlOSConfigJob Use Target BIOS FQDD e ScheduledStartTime TIME_NOW RebootJobType 1 Poll jobstatus for Completed GET the InstancelD of from F See section 2 3 fora definition of GET 50 LC Integration Best Practices Specification Notes 4 18 QLogic will not show up in the boot list until it connects to an iSCSI target So if iSCSI is misconfigured or the network is down it does not show up RAID and SATA HDs cannot be disabled in the boot list Either disable the controller but then they are not available as secondary dis
78. censeStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED RegisteredName iDRAC Card RegisteredOrganization 1 RegisteredVersion 1 2 0 Get all iDRAC card attributes Use the following procedure below to list all of the attributes from all of the iDRAC Card class in the system 9 3 Applies to LC1 5 0 Prerequisites for script none Script GetAlliDRACCardAttributes win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetiDRACCardAttributes ENUMERATE the DCIM_iDRACCardAttribute class to view all attributes See section 2 2 for a definition of ENUMERATE Inventory of iDRAC cards in system Use the following procedure below to list the inventory of all iDRAC Cards in the system Applies to LC1 5 0 Prerequisites for script none Script GetiDRACCardViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetiDRACCardViews ENUMERATE the DCIM_iDRACCardView class to vi
79. cesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName CPU and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM CPU 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Interop Namespace AdvertiseTypes 1 1 InstancelD DCIM CPU 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName CPU RegisteredOrganization 1 RegisteredVersion 1 0 0 7 2 Inventory of CPUs in system Use the following procedure below to list the inventory of all CPUs in the system 73 LC Integration Best Practices Specification Applies to LC1 5 0 Prerequisites for script none Script GetCPUViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetCPUViews ENUMERA
80. ck NIC boot order ChangeBootOrderBylnstancelD Use InstancelD IPL source instancelD from 1 SetNICAttributes Set the attribute LegacyBootProto to the value FCoE and the other desired NIC attributes and values CreateBlOSConfigJob Use Target BIOS FQDD ScheduledStartTime TIME_NOW RebootJobType 1 Poll jobstatus for Completed GET the InstancelD of from F See section 2 3 for a definition of GET FCoE boot using Intel 12G only This workflow sets several NIC attributes including setup of Fiber Channel over Ethernet FCoE by first setting the attributes for the operation and then changing the boot order for 56 LC Integration Best Practices Specification the NIC Approximate time for completion on a 12G system is 20 30 minutes depending on the system configuration Applies to LC2 Prerequisites for script e Intel NIC Mezz card e Set desired script variables by editing script NOTES e Make sure Mezz NIC is enabled If not enabled enable it and find NIC FQDD reboot e Enable ConnectFirstFCoETarget Check if ConnectFirstFCoETarget is enabled if not enable it Configure FCoE reboot e Move FCoE to the top of the HD Boot List Script FCoEboot 12g IntelMezz win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status 1 System should be power off 2 Clear all unfinished jobs 3 Clear all pending data B
81. class to view the current partitions and confirm successful operation See section 2 2 for a definition of ENUMERATE Attach partition This method is used to attach a partition on the virtual flash media device Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashAttachPartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B AttachPartition Invokes the AttachPartition method on the class DCIM_PersistentStorageService C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 fora definition of GET D GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions and confirm successful operation See section 2 2 for a definition of ENUMERATE Detach partition This method is used to detach a partition on the virtual flash media device Applies to LC1 5 0 Prerequisites for script set variables by editing script 87 LC Integration Best Practices Specification Script VFlashDetachPartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending o
82. com NICs e Disable all IPL boot sources o Since target NIC is disabled it isn t in the boot list o Weare doing a BIOS job anyway so might as well remove other boot sources Wait for job completion Wait for CSIOR to complete e Since boot source changes only occur after reboot they get detected only after CSIOR and refresh 3 Check if FQDD is present in NICView enumeration o If NIC is still not present it is an invalid NIC FQDD exit 4 Look for NIC in boot sources o For Broadcom NICs Look for IPL and NIC FQDD in InstancelDs in boot source enumeration f FQDD not in boot sources e Create a BIOS job o BootMode Bios if not already done o Disable all IPL boot sources if not already done Since target NIC isn t in boot list yet we can remove other boot sources e Create aNIC job o LegacyBootProto iSCSI Adds Broadcom device into boot list in iSCSI boot mode o Set all iSCSI boot configuration attributes e Wait for both jobs to complete e Wait for CSIOR to complete o Since boot source changes only occur after reboot they get detected only after CSIOR and refresh 5 Check if NIC is primary bootable device in boot order o For Broadcom NICs Verify if NIC will boot first e Get EnabledState of IPL entry for NIC FQDD in boot sources o Needs to be enabled if not need to do a BIOS job e Get assigned sequence number o If not first need to ensure all preceding sources are disabled o If other sources will boot before NIC FQDD need t
83. cribed in section 10 2 3 of the WSIG for Windows and look for any jobs besides JID_CLEARALL in an incomplete state i e neither Completed nor Reboot Completed state If any such jobs found e Invoke JID_CLEARALL as described in section 10 2 2 of the WSIG for Windows e Poll GetRSStatus for Status Ready every 30 seconds as described in section 20 of the WSIG for Windows 33 2 4 Check for pending configuration Inventory NIC and BIOS attributes as described in sections 33 3 3 and 33 3 5 If any pending configuration found i e PendingValue for any attribute is not blank o Invoke DeletePendingConfiguration on the FQDD in question as described in sections 15 6 16 15 and 17 8 of the WSIG for Windows 33 2 5 Check CSIOR state Get CSIOR status as described in section 12 3 of the WSIG for Windows If CSIOR Disabled o Set CSIOR Enabled as described in section 12 1 of the WSIG for Windows o Reboot the host using RequestStateChange as described in section 8 4 of the WSIG for Windows for fresh inventory to be collected 33 3 Inventory information 33 3 1 System inventory Enumerate DCIM_SystemView class to identify server type and total memory 148 LC Integration Best Practices Specification 33 3 2 Software inventory Enumerate DCIM_Softwareldentity class for all firmware version levels 33 3 3 BIOS inventory Enumerate DCIM_BlOSEnumeration class for BIOS attributes of interest 33 3 4 Boot order inventory Enumerat
84. delcasdicekeeedeceicagcicekeeedideteaeiic 71 6 7 Changing boot order by instance js sc ccis ccc ec cewed ceeds ec ekcaseededces rededeadwed ndeds cededdadees 71 6 8 Enable or disable DOOt SOUPCE sismes eoni eneo vets sens nta eso E E sete cineienedd EE oaks AE weed E a 71 6 9 One time DOOE neirinne toi resne VEE ann EE TEET deus tens EENE EEE NEEE a T 72 T CPW Profile Use Cases vais dna vats morete oera ets Deea Eea vote EAE EE A ente ANAE NEER EE ees AANE oer 73 7 1 Discovery of CPU profile SUpport ssia csse eee e aei d e i ei 73 7 2 Inventory of CPUS in System wu cee decees rinne irern eain rA AE REKE SENINE ITEA eain raae riea 73 7 3 Get thefirst CPU S informa tiM eene r ARA EAN ARTA EAN ENT 74 8 Event Filt r Profile Use Cases i 0cies ask sieddeceueeds cece bbe wese s dd ane uheddauaee s dd dacutleddeceses SAARES 74 8 1 Discovery of Event Filter profile SUPPOrt ccececceccecceccencencencencenceeceaceeseneeess 74 8 2 Get event filter configuration service VIOWS cccececesccecccesccececesecesecesacesaeesaes 75 8 3 GEE event filter VIEWS asi sani sens oaks anes t enna eign eink tintin sete E ebb nines won e ea slew viet 75 8 4 Get single event filter s information esssessesossssesssoosssssseoooesssssesossssssseooseess 76 8 5 Set event filters Dy category es is es ic eecv es uvestvelueestvebuvevtvelavecdvetovecdveteeect vesuerctee sy 76 8 6 Set event filters by InstancelD sssesssesesesssesesesesesese
85. deo and note its instancelD to use in step D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM Video 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM Video 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName Video RegisteredOrganization 1 RegisteredVersion 1 0 0 118 LC Integration Best Practices Specification 25 2 25 3 Inventory of video in system Use the following procedure below to list the inventory of all video in the system Applies to LC1 5 0 Prerequisites for script none Script GetVideoViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVideoViews ENUMERATE the DCIM_VideoView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available video components will be returned Get the first video instance s information Use
86. e MaxBandwidth 4 CreateNICConfigJob 5 Set Attributes target as follows SetNICAttributes on NIC Mezzanine 2B 1 AttributeName FirstFCoEWWPNTarget AttributeValue FirstFCoEWWPNTarget AttributeName FirstFCoEBootTargetLUN AttributeValue FirstFCoEBootTargetLUN 6 CreateNICConfigJob with RebootJobType 1 GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Loop through all boot sources if boot source is IPL entry set EnabledState 0 unless HD 58 LC Integration Best Practices Specification 4 23 ChangeBootSourceState Use InstancelD IPL EnabledState 0 source instancelD from D GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Enable the HD boot source ChangeBootSourceState Use InstanceID IPL EnabledState 1 source instancelD from F GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Change NIC boot source GetBootSourceSettings ENUMERATE the DC M_BootSourceSetting class to collect information about the boot sources See section 2 2 for a definition of ENUMERATE Check NIC boot order ChangeBootOrderBylnstancelD Use InstancelD IPL source instancelD from 1 SetNICAttribute
87. e DCIM_BootSourceSetting for current boot order settings 33 3 5 NIC inventory Enumerate DCIM_NIC View class for total number of NICViews their types and FQDDs Note that each NICView represents one port or partition for a partitioned device Number of NIC controllers can be calculated by trimming out the second and third octet of the FQDD o NIC Mezzanine 2B 1 1 and NIC Mezzanine 2B 1 2 are two partitions on the same controller NIC Mezzanine 2B o NIC Slot 1 1 and NIC Slot 1 2 are two ports on the same controller NIC Slot 1 DCIM_NICEnumeration DCIM_NICString and DCIM_NICinteger classes for all NIC attributes 33 3 6 RAID inventory Enumerate DCIM_ControllerView class for total number of RAIDs 33 4 Poll LC jobs information There are various tasks that are executed in sequence when running one or more LC jobs Once the job is scheduled using ScheduledStartTime note that the machine only reboots if a RebootJobType is specified in the CreateTargetedConfigJob method invocation or a reboot job is created using CreateRebootJob and scheduled using SetupJobQueue 33 4 1 Timing considerations While polling jobs for completion the following target machine specific variables need to be considered when setting reasonable timeouts for job completion Amount of RAM in machine o Influences time taken for initial memory check o Details obtained from enumeration described in section 5 3 Number of NIC and RAID devices o Influences tim
88. e OS drivers unpacks the desired set of drivers and boots from an image on the vFlash Approximate time for completion on an 12G system is 20 40 minutes depending on the size of the driver pack to unpack Applies to LC1 3 0 Prerequisites for script e Place applicable ISO image in applicable network share e Set script variables by editing script Script BootTovFlash win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile NOTE GetRemoteServicesAPIStatus will return not ready if drivers or an ISO is already attached lt DetachDrivers Ensures any previous drivers are detached DetachISOImage Ensures all previous images are detached J Q W DetachISOFromVFlash Ensures all previous images are detached igal lt DeletelSOFromVFlash Ensures all previous images are deleted j DownloadISOToVFlash Download desired image from network to vFlash G Poll concrete job until Success H GetDriverPackInfo Displays available OS drivers This is only required for end to end OS deployment I UnpackAndAttach Unpacks and attaches desired driver pack The resulting concrete job is invoked immediately This is only required for end to end OS deployment J Poll concrete job until
89. e taken for POST controller initialization UEFI initialization controller driver load and start for CSIOR and SSM Inventory for CSIOR and SSM o Details obtained from enumerations described in sections 33 3 3 and 33 3 5 33 4 2 Machine reboot If the machine is turned off it is turned on in order to execute the jobs If a machine is turned on it is powercycled at the ScheduledStartTime depending on the RebootJobType specified Once all jobs are successfully scheduled the target machine power state can be polled as 149 LC Integration Best Practices Specification described in section 5 2 1 The total time taken for reboot depends on the RebootJobType specified o Fora machine powered down it shouldn t take more than 30 seconds to power up o For a running machine timeout depends on the RebootJobType 1 PowerCycle 30 seconds 2 Graceful Reboot without forced shutdown 5 minutes 3 Graceful reboot with forced shutdown 5 minutes 33 4 3 POST 33 4 3 1 Memory check Get the value of the BlIOSEnumeration attribute MemTest obtained during inventory as described in section 5 3 3 If MemTest Enabled on power on the BIOS memory test is executed If memory test is executed the total timeout for POST should include 10 seconds per GB of RAM to check the total RAM installed on the target system as obtained from enumeration described in section 33 3 33 4 3 2 Controller initialization Get
90. eckVDValues win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE C GetPhysicalDiskViews ENUMERATE the DCIM_PhysicalDiskView class to view all available physical disk FQDDs See section 2 2 for a definition of ENUMERATE 94 LC Integration Best Practices Specification D CheckVDValues Invoke this method to return desired data The output will contain the available sizes and default values for the given RAID level and set of physical disks 14 11 Create a virtual disk View the RAID stacking workflows in Section 4 for a comprehensive example 14 12 Determine available physical disks to be used as a hotspare The GetDHSDisks method is used to determine possible physical disks to be used as a hotspare Applies to LC1 5 0 Prerequisites for script e Set desired RAID controller FQDD physical disk FQDDs and RAID level parameters by editing script Script GetDHSDisks win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depe
91. ection 2 2 for a definition of ENUMERATE The instance information will be returned Get event filter views Enumerate the DCIM_EventFilter class to view all available instances of the class Applies to LC2 Prerequisites for script none Script GetEventFilterViews win 75 LC Integration Best Practices Specification 8 4 8 5 8 6 A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetEventFilters ENUMERATE the DCIM_EventFilter class to view all instances See section 2 2 for a definition of ENUMERATE All available instance information will be returned Get single event filter s information Use the following procedure to get a single Event Filter instance The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC2 Prerequisites for script e Set desired instancelD by editing script Script GetEventFilterView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetEventFilterView GET the DCIM_EventFilter instance See Section 2 3 fora definition of GET The desired instance information will be returned Set event filters by category This workflow is used to set the action and notifications for all the event filters
92. ee section 2 2 for a definition of ENUMERATE C GetRAIDLevels Invoke this method to return desired data The output will contain the available RAID level configurations for the given physical disk selection 14 9 Determine available physical disks for a RAID configuration Use the following procedure below to list the available physical disks for a given RAID level configurations Applies to LC1 5 0 Prerequisites for script e Set desired RAID FQDD by editing script Script GetRAIDAvailableDisks win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE C GetAvailableDisks Invoke this method which will return the desired data The output will contain the available physical disks for the given RAID level 14 10 Check available virtual disk parameters for a given RAID level and set of physical disks Use the following procedure below to list the available sizes and default values for a given RAID level configurations Applies to LC1 5 0 Prerequisites for script e Set desired RAID controller FQDD physical disk FQDDs and RAID level parameters by editing script Script Ch
93. ees Sete aetaedsveetedeivaubacdsveebe dei vestcevssessadd 99 List Lifecycle record log Capabilities ccc cceeccesceesccenceenceesceesceesceesseesseesoees 99 ist Lifecycle Oo entmesiscacims tele A ENNA ENEN E ENSA 100 Set and get comment in Lifecycle log entries cecceececcencencenceecenceeeeeeeeeenees 100 List system event record logs sicsesicssevecrdatene cevateee Melati sanatarecedaicaecadadeeeedatcagees 101 List system event record log capabilities cece ccc eeceecceeeceeecesecesecesaeesacesaes 101 LiSt Systemevent lOS ENEreS cis acawtid caves edbinate saed ae nabs ines slabs wines AA A A N ced e 101 Role Based Authorization Profile RBAP use CASES cccccceeeceeeeeeeeeseeeeeaeeeeeeeeees 102 Discovery Of RBAP profile SUDPOFt nsnsi ees sass Seed cabs Seed abd Sees taba Gueetn db dewd ate dated deed od 102 Discovery of users with assigned LAN privileges cccce cece eee eeeceeeeeseeeneeeneeeeaes 103 Discovery of users with assigned serial over LAN privileges ccceeceeeceseeeeeeeeees 103 Discovery of users with assigned CLP privileges cece sees eee e eee ee eee eeeeeeeeeeeeeee 103 Service Processor Profile Use Cases scessessensencsnceceenceneencencencencensensenseeeenees 104 Discovery of Service Processor profile SUPPOIt ccccecceecencencenceccenceeceeeeeeensens 104 Simple NIC Profile US Casas cvasscvaccsksscesetacsved A RE sawed hac TEE eed cdbee E ae 105
94. elD by editing script Script GetVFlashView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashView GET the DCIM_VFlashView instance using the Instance D Disk vFlashCard 1 See Section 2 3 for a definition of GET The instance of DCIM_VFlashView that contains the information on the first vFlash will be returned Inventory of partitions on the virtual flash media Use the following procedure below to list the inventory of all vFlash partitions in the system Applies to LC1 5 0 Prerequisites for script none Script GetVFlashPartitionViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available partitions will be returned Initialize virtual flash media This method is used to initialize or format the virtual flash media device Applies to LC1 5 0 Prerequisites for script none Script InitVFlash win 83
95. ement registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Job Control and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM JobControl 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM JobControl 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicenseStatus LICENSED RegisteredName Job Control RegisteredOrganization 1 RegisteredVersion 1 2 0 List all jobs in job store Getting all the jobs in the job store is a matter of confirming the system is in a ready state and then enumerating the DCIM_LifecycleJob class to view all available instances of the class Applies to LC1 4 0 Prerequisites for script none 109 LC Integration Best Practices Specification 20 3 20 4 Script ListAllJobs win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteS
96. enabled or disabled b If the CurrentEnabledStatus is desired value skip to the end E ChangeBootSourceState using instancelD IPL and EnabledState 1 ReturnValue 0 F Poll jobstatus for Completed GET the InstancelD of from E See section 2 3 for a definition of GET I The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready G ENUMERATE the DCIM_BootSourceSetting class See section 2 2 for a definition of ENUMERATE e The CurrentEnabledStatus of the Hard drive C should be 1 for enable or 0 for disable One time boot This workflow sets a one time boot for vFlash IPL or UEFI This example uses IPL Approximate time for completion that one can expect to encounter is about 15 25 minutes Applies to LC1 5 0 Prerequisites for script e none Script OneTimeBoot win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetBootConfigSettings ENUMERATE
97. ense Management and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM LicenseManagement 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM LicenseManagement 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Licensing Management ProfileRequireLicenseStatus LICENSED RegisteredName License Management RegisteredOrganization 1 RegisteredVersion 1 0 0 27 Power Supply Profile Use Cases 27 1 Discovery of Power Supply profile support Use the following procedure below to confirm the existence of Power Supply profile support Applies to LC1 5 0 Prerequisites for script none 120 LC Integration Best Practices Specification 27 2 Script GetPowerSupplyProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definiti
98. er the method is successfully executed the PendingValue property of RAIDPDState should reflect the pending changes After the CreateTargetedConfigJob method is successfully executed the DCIM_PhysicalDiskView RAIDStatus property of that physical disk should reflect the new state One can expect this operation to take up to 15 minutes depending on system configuration Applies to LC2 Prerequisites for script e Set desired RAID physical disk FQDD by editing script Script ConvertToNonRAID win A B C The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE GetPhysicalDiskViews ENUMERATE the DCIM_PhysicalDiskView class to view all available physical disk FQDDs See section 2 2 for a definition of ENUMERATE 97 LC Integration Best Practices Specification Note the value of the RaidStatus parameter of the desired physical disk iw ga _ 7 H ConvertToNonRAID Invoke this method CreateRAIDConfigJob Apply step D ReturnValue 4096 Poll jobstatus for Completed GET the InstancelD of from E See section 2 3 for a definition of GET The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPIStat
99. eredOrganization 1 RegisteredVersion 1 4 0 The RegisteredVersion field is in the following format 14 LC Integration Best Practices Specification major change minor change errata e Increments in the major change field indicate that the profile is not backward compatible e Increments in the minor change field indicate that one or more new methods have been added e Increments in the errata field indicate that one more defects have been fixed 1 6 LC and LC2 nomenclature This section describes the new terminology associated with the new generation of hardware and Lifecycle Controller firmware including iDRAC The new hardware platform is generically referred to as 12G and all corresponding Lifecycle Controller firmware will be LC2 with accompanying sub releases i e 1 0 0 1 1 0 etc The table below summarizes both the past and current generational nomenclature NOTE Data within table is for illustration purposes only Table 1 Generational Nomenclature Lifecycle Controller Firmware LC 1 5 0 LC 1 5 1 LC 1 5 2 LC 1 x x LC2 1 0 0 LC2 1 0 1 LC2 1 1 0 LC2 1 1 1 LC2 1 x x Changes in the Lifecycle Controller firmware versions abide by the following definition major change minor change errata e Increments in the major change field indicate that the profile is not backward compatible e Increments in the minor change field indicate that one or more new methods h
100. erver public certificate ccccecceccenceecencenceeeeeeeeceeeeneees 137 Insert Comment into Lifecycle log cece cee cce eee e eee e eee eneeeneeeneeeneeenseenseeneeeneees 137 Export and view the content of the Lifecycle log cece ece cece eee eeeeeeeeeneeeseeenees 137 Export and view the current hardware inVentoOry cceceeeceseceeeceseceneceseeeseeenees 137 Export and view the hardware inventory as shipped from the factory eceeees 138 OS Deployment Profile Use Cases irrisa ora E es vat EREE E TRTE ONA 138 Discovery of OS Deployment profile support ssssssessesosssssssssosssssssooossssssesoosssss 138 Unpack and attach drivers seissinssiicsreicriioiinstitisi s ents seine Ni NEEE ECE EENE 139 Connect and attach network ISO image sssssssesooesssssesosesssssesossseseseoosesssssesose 139 Disconnect and detach network ISO image ssssssssssssesesssssseesessssseeeeessssseeeeess 139 Get 50 image connection stats 2 3 4 ccs taee ees s rears Arrn cee EAKAS A NEIEN ESAN EAKAS ATEUA NSAN 140 One time ISO oot SKip rossins tinsa ninisi e a siina 140 Remote File Share RFS use cases sesssssssessssssessssssssessssessessseeseeeeeeeseeeeeeee 140 Connect and Attach Network ISO Image as a USB CD ROM device via RFS USB end point 140 Disconnect and detach ISO Image exposed via RFS USB end point ssscscssssssssse 141 Get RF ISO lmage Connection Statuss caveswicsevess ida veterans de
101. ervicesAPIStatus method may be used depending on the version of the LC Management registered profile B ENUMERATE the DCIM_LifecycleJob class to view all jobs See section 2 2 for a definition of ENUMERATE Get one job s information The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Job IDs are usually obtained directly from a concrete job reboot job or create target config job operations Applies to LC1 3 0 Prerequisites for script e Set desired job variable by editing script Script Get1Job win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B Use the instancelD from a concrete job reboot job or create target config job operation Note Reboot job IDs start with RID_ instead of JID_ See section 2 3 for a definition of GET The instance of DCIM_LifecycleJob that contains the information on the job will be returned Delete all jobs from job store job queue using JID_CLEARALL This workflow deletes all jobs from the job queue using by passing JID_CLEARALL as the jobID LC1 5 x and prior Running this command also restarts remote services Applies to LC1 3 0 Prerequisites for script none Script DeleteAllJobs win A
102. esired value a EmbNic1Nic2 Enabled BootMode BI0S ProcVirtualization Enabled ErrPrompt Disabled EmbNic1 Enabled pano CreateBlOSConfigJob Apply step E with reboot type 3 and ScheduledStartTime parameter of TIME_NOW which invokes the operation immediately ReturnValue 4096 Poll jobstatus for Completed GET the InstancelD of from F See section 2 3 fora definition of GET NOTE The following status polling for SSIB task The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile NOTE The following status polling is for subsequent CSIOR The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile ENUMERATE the DCIM_BootSourceSetting class to collect information about the system See section 2 2 for a definition of ENUMERATE ChangeBootSourceState Loop through boot sources and set their enabled state to zero except for NIC ReturnValue 4096 ChangeBootOrderBylnstancelD Set the boot order of the NIC to first CurrentAssignedSequence 0 ReturnValue 0 SetAttribute Set BIOS attributes EmbNic1 to EnablediScsi ReturnValue 0
103. est Practices Specification Use the following procedure below to delete pending configurations values set by the setAttribute s method Applies to LC1 5 0 Prerequisites for script none Script DeletePendingSystemInfoConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B GetSystemViews ENUMERATE the DCIM_SystemAttributes class to view all available FQDDs See section 2 2 for a definition of ENUMERATE C DeletePendingSystemConfiguration Invoke the DeletePendingSystemConfiguration method on the DCIM_SystemManagementService class to delete pending configurations on ALL system attributes A return message of No pending data present to delete indicates that there is no pending configuration to delete for the respective FQDD 29 Software Inventory Profile Use Cases 29 1 Instance diagram Figure 4 Software Inventory Instance Diagram 127 LC Integration Best Practices Specification System NIC1 Softwareldentity rs BlOS1 Softwareldentity iDRAC1 Softwareldentity RAID1 Softwareldentity watras 3 o oTM pM lt Dd NIC2 Softwareldentity BIOS2 Softwareldentity iDRAC2 Softwareldentity RAID2 Softwareldentity 29 2 Discovery o
104. etRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPI Status can just poll for ready I ENUMERATE the DCIM_BootSourceSetting class See section 2 2 for a definition of ENUMERATE a The CurrentAssignedSequence of the Hard drive C should be 0 b The CurrentEnabledStatus of the Hard drive C should be 1 Export backup image to vFlash This workflow performs a backup or export operation which saves the image to the vFlash The TIME_NOW parameter is passed which invokes the operation immediately Approximate time for completion on an 12G system is 20 50 minutes depending on the system configuration Applies to LC1 5 0 Prerequisites for script e Valid and enabled vFlash card for licensing e optional Change passphrase by editing script Script Backup_vFlash win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B Backuplmage Performs backup operation ReturnValue 4096 C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 fora definition of GET NOTE The available space on the SD card will be reduced by 384MB upon completion of successful backup Export backup image to CIFS or NFS share This workflow perfor
105. ew all instances See section 2 2 for a definition of ENUMERATE 78 LC Integration Best Practices Specification 9 4 9 5 The instance information of all available iDRAC cards will be returned Get the first iDRAC card s information Use the following procedure to get a single iDRAC instance The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetiDRACCardView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetiDRACCardView GET the DCIM_iDRACCardView instance using the InstancelD iDRAC Embedded 1 See Section 2 3 for a definition of GET The instance of DCIM_iDRACCardView that contains the information on the first iDRAC card will be returned Set apply iDRAC card attribute s immediately Use the following procedure to set a iDRAC attributes s immediately using the ApplyAttributes method It is not necessary to invoke the CreateTargetConfigJob method as with the SetAttributes method Applies to LC1 5 0 Prerequisites for script Set desired values by editing script Script ApplyiDRACCardAttributes win A The Lifecycle Controller
106. f Software Inventory profile support Use the following procedure below to confirm the existence of Software Inventory profile support Applies to LC1 4 0 Prerequisites for script none Script GetSWinventoryProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Software Inventory and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM Softwarelnventory 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace 128 LC Integration Best Practices Specification 29 3 29 4 AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM Softwarelnventory 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName Software Inventory RegisteredOrganization 1
107. ganization DCIM ProfileRequireLicense ProfileRequireLicenseStatus RegisteredName Power State Management RegisteredOrganization 1 RegisteredVersion 1 0 0 13 Profile Registration Profile Use Cases 13 1 Discovery of Profile Registration profile support Use the following procedure below to confirm the existence of profile registration profile support Applies to LC2 Prerequisites for script none Script GetProfileRegistrationProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands 89 LC Integration Best Practices Specification GetRemoteServicesAPI Status B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Profile Registration and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM ProfileRegistrationProfile shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM ProfileRegistrationProfile OtherRegisteredOrganization DCIM ProfileRequireLicense ProfileRequireLice
108. goes to Ready state The user console can see the new values only when the RS status goes to the Ready state 1 7 2 GetRemoteServicesAPIStatus and job status The introduction of the new GetRemoteServicesAPIStatus method alleviates the ambiguity of the GetRSStatus method regarding when the system is ready Figure 2 Typical Life Cycle of a 12G Configuration Job NOT TO SCALE READY FOR EXECUTION i oi SCHEDULED HG Job Status RUNNING Mg eee tee Ee cel COMPLETED i a l GetRSStatus i i 4 RELOADING READY Eo READY I i Hii Isync ITIME GetRemoteServicesAP Status ioi Remote Services is ready ioi Lifecycle Controller i i Lifecycle Controller Remote Services is not ready i i rt Note Dotted lines denote the old behavior Bold red lines denote the new behavior in 12G After the job is complete in the Automated Task Application those jobs that require a refresh jobs that have message IDs JOB_SUCCESS and JOB_COMPLETED_ERROR will be kept in RUNNING state till the new sync comes in and the Data Manager is moved to READY state Jobs that don t require a refresh will be moved to complete immediately once the job is complete in the Automated Task Application 17 LC Integration Best Practices Specification 1 7 3 11G and 12G compatibility Figure 3 Compatibility with 11G Workflows NOT TO SCALE READY FOR EXECUTION l I SCHEDULED i i ioi Job Status RUNNING i i io f i COMPLETED
109. hresholds in their SupportedThresholds property They also indicate the settable ones through their SettableThresholds property Set operations can be performed to change the settable thresholds Applies to LC1 5 0 Prerequisites for script Set thresholds by editing script Script SetSensorThresholds win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSensorViews ENUMERATE the C M_Sensor class to view all instances Check the instance of either DCIM_PSNumericSensor and DCIM_NumericSensor to see if there are any settable thresholds C SetSensorThreshold SET the DCIM_PSNumericSensor instance for temperature Set the LowerThresholdNonCritical and UpperThresholdNonCritical values 24 Base Server and Physical Asset Profile Use Cases 24 1 Discovery of Base Server and Physical Asset profile support There is not an LC registered Base Server and Physical Asset Profile prior to LC2 0 115 LC Integration Best Practices Specification Use the following procedure below to confirm the existence of the Base Server and Physical Asset profile support in LC2 0 Applies to LC2 Prerequisites for script none Script GetBaseServerAndPhysicalAssetProfile win A The Lifecycle Controller remote service must be in
110. ic systemlD 1230 SystemRevision 0 TempRollupStatus 1 UUID 4c4c4544 0037 3810 8046 d3c04f474835 VoltRollupStatus 1 smbiosGUID 44454c4c 3700 1038 8046 d3c04f474835 3 16 Http CIFS NFS tftp ftp formatting Various protocols are required for methods accessing and or writing to network shares The format for these protocols are summarized below HTTP Format http IP ADDRESS PATH TO FILE exe CIFS or NFS Format cifs WORKGROUP_NAME USERNAME PASSWORD URI IP ADDRESS FILE exe mountpoint DIRECTORYNAME TFTP or FTP Format 31 LC Integration Best Practices Specification tftp IP ADDRESS PATH TO FILE exe ftp IP ADDRESS PATH TO FILE exe 4 Workflows The Best Practice Guide provides the detailed step by step Lifecycle Controller WSMAN API interactions and algorithmic descriptions needed to implement various system management workflows 4 1 RAID stacking ResetConfig CreateVD assign HotSpares This workflow stacks multiple RAID operations together and is applied immediately using the TIME_NOW parameter which requires one reboot operation The workflow deletes existing virtual disks and unassigns all hotspares before creating a single virtual disk a dedicated hotspare and a global hotspare Following completion of the reboot the new virtual disk and hotspare results will be verified Approximate time for completion on a 12G system is 15 minutes Applies to LC1 5 1 Prerequis
111. ice must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile USC firmware DUP update from CIFS or TFTP share This workflow performs an update of the USC LC firmware from a DUP by first downloading the DUP to the system then applying the update By design the update of the USC firmware will be invoked immediately following download completion and cannot be scheduled for a later time Approximate time for completion is 30 60 minutes depending on the system configuration Applies to LC1 3 0 Prerequisites for script e Desired DUP must be present on network share e Set script variables by editing script Script USC_LC_update win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSoftwareldentities ENUMERATE the DCIM_Softwareldentity class to list the firmwares of the system See section 2 2 for a definition of ENUMERATE C Search the results from B for ElementName Dell Lifecycle Controller and note the accompanying instancelD to be used in D There may be additional characters and numbers after the substring Controller D InstallFromURI I
112. icesAPI Status method may be used depending on the version of the LC Management registered profile B GetCPUView GET the DCIM_FanView instance using the InstancelD Fan embedded 1 See Section 2 3 for a definition of GET The instance of DCIM_FanView that contains the information on the first fan will be returned 81 LC Integration Best Practices Specification 11 11 1 Persistent Storage Profile Use Cases Discovery of Persistent Storage profile support Use the following procedure below to confirm the existence of Persistent Storage profile support Applies to LC1 4 0 Prerequisites for script none Script GetPersistentStorageProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE Search for RegisteredName Persistent Storage and note its instancelD to use in step D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM PersistentStorage 1 0 0 shown below If no instance is returned the profile is not supported DCIM_L
113. ieee seca tees Pec dbea AANER ANa 112 Get the first memory s information sssssssssssessesseseseseseseseeeceseeseesereeeseseeeseee 112 LC Integration Best Practices Specification 22 22 1 23 23 1 23 2 23 3 24 24 1 24 2 24 3 25 25 1 25 2 25 3 26 26 1 27 27 1 27 2 27 3 27 4 27 5 28 28 1 28 2 28 3 28 4 28 5 28 6 28 7 28 8 29 29 1 29 2 29 3 PCI Device Profile USE Case nr cncencs cuss sinvs renoier denne enn eens E geass E E etnaeen 113 Discovery of PCI Device profile support sesssssosssesssososssesesooossssseoosssssesesooesess 113 Sensors Protile USe Cases riehe ennei ei ed san eedsenevvadeeoaaeades sarees 114 Discovery of Sensor profile support ssesssesssosossssssossosssesesoossssssesssosesesssosesess 114 Inventory OF SENSOR Im System eeno n i EE EEEE AE E Geld vioea oben eee NE 114 Sensor ChresMolds neinei deed ddaasieedu deccuvdde nce dd CAO ENANOS PEE AORN AA EROVER KA 115 Base Server and Physical Asset Profile Use Cases ccccc cece eeceeeceeeceneeeseeeseeenees 115 Discovery of Base Server and Physical Asset profile support eceeee eee ee eee eeeeee 115 Discovery of Base Server and Physical Asset profile support LC1 5 1 e cess enone 116 Listall CIM protiles x acs desseewe ceaccees Crecenns iesiti niena i dens dieneetes cease EEE e 117 Video Profile Use Cases is Succ vais seed vets mianta teu vets EEE EEEa ante teuaee ce Ea aT Ea eateumeres 118 Disco
114. ig Delete all virtual disks and unassign all HotSpare physical disks ReturnValue 0 CreateVirtualDisk RAID 1 on physical disk 0 amp 1 for example ReturnValue 0 AssignSpare Create dedicated hotspare using Create VD instancelD ReturnValue 0 CreateRAIDConfigJob Apply steps D F without reboot type without UntilTime and without ScheduledStartTime parameter TIME_NOW ReturnValue 4096 SetAttribute Set BIOS attribute EmbNiciNic2 to Enabled ReturnValue 0 CreateBlOSConfigJob Apply step H without reboot type without UntilTime and without ScheduledStartTime parameter TIME_NOW ReturnValue 4096 CreateRebootJob Pass RebootJobType of 3 parameter 1 PowerCycle 2 Graceful reboot without forced shutdown 3 Graceful reboot with forced shutdown SetupJobQueue Use RAID JID G BIOS JID J and reboot RID K ReturnValue 0 Poll jobstatus for Completed GET the nstancelD of from G or J See section 2 3 fora definition of GET The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPI Status can just poll for ready ENUMERATE the DCIM_VirtualDiskView class to ensure successfu
115. iles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Software Update and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM SoftwareUpdate 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile Advertise TypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM SoftwareUpdate 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Update ProfileRequireLicenseStatus LICENSED RegisteredName Software Update 108 LC Integration Best Practices Specification RegisteredOrganization 1 RegisteredVersion 1 0 0 20 Job Control Profile Use Cases 20 1 20 2 Discovery of Job Control profile support Use the following procedure below to confirm the existence of Job Control profile support Applies to LC1 4 0 Prerequisites for script none Script GetJobControlProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Manag
116. imum envelope size and timeout can also increase performance winrm set winrm config MaxEnvelopeSizekb 150 winrm set winrm config MaxTimeoutms 60000 Other optional WinRM configuration commands are listed below for convenience To get the current WinRM configuration settings execute the following command winrm g winrm config By default the client computer requires encrypted network traffic To allow the client computer to request unencrypted traffic execute the following command winrm s winrm config Client f AllowUnencrypted true TrustedHosts is an array that specifies the list of remote computers that are trusted Other computers in a workgroup or computers in a different domain should be added to this list Note The computers in the TrustedHosts list are not authenticated Execute the following command to allow all computers to be included in TrustedHosts winrm s winrm config Client TrustedHosts Basic authentication is a scheme in which the user name and password are sent in clear text to the server or proxy This method is the least secure method of authentication The default is True Execute the following command to set client computer to use Basic authentication winrm s winrm config Client Auth Basic true 1 4 Feature discovery procedure There are four steps recommended to determining the feature set on a given system 1 Interop namespace registered profile advertisement a winrm enume
117. ing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile 1 System should be power off 2 Clear all unfinished jobs 3 Clear all pending data B Check NDC is enabled 1 GetBlOSEnumerations ENUMERATE the DC M_BlOSEnumeration class to collect information about the system See section 2 2 for a definition of ENUMERATE 2 Ensure AttributeName of IntegratedNetwork1 is enabled If it is not enabled enable it as shown below e SetBlOSAttributes AttributeName IntegratedNetwork1 AttributeValue Enabled AttributeName BootMode AttributeValue Bios e CreateBlOSConfigJob e ScheduledStartTime TIME_NOW RebootJobType 1 e Poll jobstatus for Completed GET the nstancelD of from 2 C CheckConnectFirstFCoETarge ENUMERATE the NIC FADD and check if ConnectFirstFCoETarget is eabled if not enable ConnectFirstFCoETarget as show below e Disable all sources e Create BIOS job e SetNiCAttributes AttributeName ConnectFirstFCoETarget AttributeValue Enabled e CreateNICConfigJob with RebootJobType 1 D Configure FCoE 1 Disable all sources 2 Create BIOS job 3 Set Partition Attributes as follows SetNICAttributes on NIC Integrated 1 1 4 55 LC Integration Best Practices Specification 4 22 AttributeName FCoEOffloadMode AttributeValue Enabled AttributeName VirtFIPMacAddr AttributeValue VirtFIPMacAddr AttributeName
118. ining the level on a system is to perform an enumeration of the DCIM_iDRACCardView class Example results are shown for reference Monolithic DCIM_iDRACCardView FQDD iDRAC Embedded 1 1 FirmwareVersion 1 00 00 GUID 3132334f cOb7 3480 3510 00364c4c454 IPMIVersion 2 0 InstancelD iDRAC Embedded 1 1 IDRACinfo LANEnabledState 1 LastSystemInventoryTime 20120302092309 000000 000 LastUpdateTime 20120305233206 000000 000 Model Enterprise PermanentMACAddress 78 2b cb 54 54 11 ProductDescription This system component provides a complete set of remote management functions for Dell PowerEdge servers SOLEnabledState 1 Modular DCIM_iDRACCardView FQDD iDRAC Embedded 1 1 25 LC Integration Best Practices Specification FirmwareVersion 1 00 00 GUID 3132334f cOb7 3480 3510 00364c4c454 IPMIVersion 2 0 InstancelD iDRAC Embedded 1 1 IDRACinfo LANEnabledState 1 LastSysteminventoryTime 20120121022852 000000 000 LastUpdateTime 20120124015120 000000 000 PermanentMACAddress d0 67 e5 f4 2f 97 ProductDescription This system component provides a complete set of remote management functions for Dell PowerEdge servers SOLEnabledState 1 3 9 CIM Query Language CQL Filters The CIM Query Language CQL is a query language for the Common Information Model CIM standard from the Distributed Management Task Force DMTF It was designed to perform queries against the CIM objects in a database 3 9
119. ion on an 12G system is 5 minutes depending on the system configuration Applies to LC1 5 0 Prerequisites for script e Set script variables by editing script Script ExportFactoryConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ExportFactoryConfiguration Invokes the export operation ReturnValue 4096 NOTE The user must set applicable IP address username password filename and workgroup of the network share C Poll jobstatus for Completed GET the nstancelD of from D See section 2 3 fora definition of GET 32 OS Deployment Profile Use Cases 32 1 Discovery of OS Deployment profile support 138 LC Integration Best Practices Specification Use the following procedure below to confirm the existence of OS Deployment profile support Applies to LC1 3 0 Prerequisites for script none Script GetOSDProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2
120. ique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetSysteminfoView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSystemView GET the DCIM_SystemView instance using the Instance D System Embedded 1 See Section 2 3 for a definition of GET The instance of DCIM_SystemView that contains the information on the first system info will be returned 124 LC Integration Best Practices Specification 28 4 Inventory of all system attributes in system Use the following procedure below to list the inventory of all system attributes in the system using the DCIM_SystemAttribute class The instances from the following classes will be returned DCIM_SystemEnumeration DCIM_SystemInteger DCIM_SystemString Applies to LC2 Prerequisites for script none Script GetSystemAttributes win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetSystemAttributes ENUMERATE the DCIM_SystemAttribute class to view all instances of the attributes DCIM_SystemEnumeration DCIM_SystemInteger and DCIM_SystemString See section 2 2 for a definition of EN
121. ites for script e Set FQDD of desired RAID controller by editing the following script e Applicable RAID controller and hard drives Script RAIDstacking_TIME_NOW win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAP Status method may be used depending on the version of the LC Management registered profile B LC1 5 1 only Disable CSIOR Collect System Inventory on Restart NOTE On 11G systems CSIOR must be disabled to circumvent a sync behavior that prohibits successful RAID stacking a SetLCAttribute Sets attribute to be configured ReturnValue 0 b CreateConfigJob Creates jobID and applies configuration ReturnValue 4096 C ENUMERATE the DCIM_ControllerView class to find RAID controller s instancelD amp FQDD They are often identical See section 2 2 for a definition of ENUMERATE a Integrated RAID card example is RAID Integrated 1 1 b External RAID card example is RAID Slot 1 1 D ResetConfig Delete all virtual disks and unassign all HotSpare physical disks ReturnValue 0 E CreateVirtualDisk RAID 1 on physical disk 0 amp 1 for example ReturnValue 0 32 LC Integration Best Practices Specification 4 2 F AssignSpare Create dedicated hotspare using Create VD instancelD ReturnValue 0 G AssignSpare Create global hotspare ReturnValue 0 H CreateR
122. ithin either of the aforementioned scripts to obtain the status 32 6 One time ISO boot skip Following sequence of CIM Operations shall be used to skip ISO boot once The SkipISOlmageBoot method allows the BIOS to skip booting to the ISO once and boot normally boot to the first device in boot list Applies to LC1 5 0 Prerequisites for script none Script SkiplSOlmageBoot win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile NOTE GetRemoteServicesAPIStatus will return not ready if drivers or an ISO is already attached B SkiplSOlmageBoot Invoke the method successful return value is 0 32 7 Remote File Share RFS use cases 32 7 1 Connect and Attach Network ISO Image as a USB CD ROM device via RFS USB end point Following sequence of CIM Operations shall be used to connect and attach network ISO Image from the specified network share to the host server as a USB CD ROM device via RFS USB end point Applies to LC2 Prerequisites for script set network parameters by editing script Script ConnectRFSISOlmage win 140 LC Integration Best Practices Specification NOTE Check of Lifecycle Controller LC remote service state via GetRemoteServicesAPIStatus is not required since ISO is connected u
123. ition of ENUMERATE C GetHostMACInfo Invoke GetHostMACInfo ReturnValue 0 Get blade power 122 LC Integration Best Practices Specification This workflow enumerates DCIM_AssociatedPowerManagementService class Applies to LC1 5 0 Prerequisites for script none Script GetBladePower win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetAssociatedPowerManagementService ENUMERATE the CIM_AssociatedPowerManagementService class See section 2 2 for a definition of ENUMERATE 28 System Info Profile Use Cases 28 1 Discovery of System Info profile support Use the following procedure below to confirm the existence of System Info profile support Applies to LC1 5 0 Prerequisites for script none Script GetSystemInfoProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName System Info and note its insta
124. kes firmware update operation ReturnValue 4096 E CreateRebootJob Pass parameter RebootJobType of value 3 1 PowerCycle 2 Graceful reboot without forced shutdown 3 Graceful reboot with forced shutdown 40 LC Integration Best Practices Specification 4 11 F SetupJobQueue Use JID D and reboot RID E ReturnValue 0 The StartTimelnterval parameter is set to TIME_NOW meaning the operations will be invoked immediately G Poll RID jobstatus for Reboot Completed GET the nstancelD of from E See section 2 3 for a definition of GET H Poll JID jobstatus for Completed GET the InstancelD of from D See section 2 3 fora definition of GET I The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile BIOS firmware DUP update from CIFS or TFTP share This workflow performs an update of the BIOS firmware from a DUP by first downloading the DUP to the system then applying the update The update of the BIOS firmware will be invoked after being scheduled using SetupJobQueue Approximate time for completion is 30 60 minutes depending on the system configuration and network Applies to LC1 3 0 Prerequisites for script e Desired DUP must be present on network share e Set script variables by editing script Script
125. ks or move them down in the HD boot list It is recommended to disable the entire HD list from the boot order until iSCSI is on the top to prevent it from booting into another HD iSCSI boot using Intel 12G only This workflow sets several NIC attributes including setup of iSCSI boot by first setting the required attributes for the operation and then changing the boot order for the NIC Additional detail is provided as setting up iSCSI boot is complex Approximate time for completion on a 12G system is 15 30 minutes depending on the system configuration NOTE Additional details of the coding steps shown below generational differences and other iSCSI information can be found in Appendix iSCSI Boot information Applies to LC2 Prerequisites for script e intel NIC e Edit script to set desired parameters Script iscsiboot 12gHBA intel win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands e GetRemoteServicesAPIStatus B GetNICViews ENUMERATE the DCIM_NICVIEW class to collect information about the NIC FQDDs See section 2 2 for a definition of ENUMERATE e Check if specified NIC FQDD is present in NICViews C GetNICEnumerations ENUMERATE the DCIM_NICEnumeration class to collect information about the system See section 2 2 for a definition of ENUMERATE e Check if TcplpViaDHCP Enabled and IscsiViaDHCP Disabled D GetBootSourceSettings ENUMERATE the DCI
126. l virtual disk creation See section 2 2 for a definition of ENUMERATE a RAIDTypes parameter will be 4 for a RAID 1 configuration b PhysicalDiskIDS parameter will list physical disks used ENUMERATE the DCIM_PhysicalDiskView class to ensure successful hotspare assignments See section 2 2 for a definition of ENUMERATE 34 LC Integration Best Practices Specification 4 3 a HotSpareStatus parameter of 2 indicates global hotspare b HotSpareStatus parameter of 1 indicates dedicated hotspare NOTE H200 controller is unique in that it always returns 2 for both dedicated and global hotspares P ENUMERATE the DCIM_BIlOSEnumeration class to ensure BIOS settings were correctly set See section 2 2 for a definition of ENUMERATE Boot to network ISO This workflow boots the host system from an image on a network share The workflow first removes any existing driver packs or existing attached OS then gets available OS drivers unpacks the desired set of drivers and boots from an image on a network share Approximate time for completion on a 12G system is 20 40 minutes depending on the size of the driver pack that will be unpacked and the speed of the network to boot image Applies to LC1 3 0 Prerequisites for script e Place applicable ISO image in applicable network share e Set script variables by editing script Script BootToNetworkISO win A The Lifecycle Controller remote service must be in a ready state before e
127. lashStateChange method on the class DCIM_PersistentStorageService D Repeat B to confirm successful execution of the method Disable virtual flash vFlash media This method is used to disable the virtual flash media device Applies to LC1 5 0 Prerequisites for script none Script DisableVFlash win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashViews ENUMERATE the DCIM_VFlashView class to view the current value of VFlashEnabledState property See section 2 2 for a definition of ENUMERATE 84 LC Integration Best Practices Specification C VFlashStateChange Invokes the VFlashStateChange method on the class DCIM_PersistentStorageService D Repeat B to confirm successful execution of the method Create new partition on virtual flash vFlash media This method is used to create a new partition on the virtual flash media device Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashCreatePartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profi
128. le B GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions See section 2 2 for a definition of ENUMERATE C VFlashStateChange Enable vFlash if it is disabled D CreatePartition Invokes the CreatePartition method on the class DCIM_PersistentStorageService E Poll jobstatus for Completed GET the InstancelD of from E See section 2 3 fora definition of GET F Repeat B to confirm successful execution of the method Create new partition using image This method is used to create a new partition on the virtual flash media device using an image from a network share Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashCreatePartitionUsinglmage win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions See section 2 2 for a definition of ENUMERATE C CreatePartitionUsinglmage Invokes the CreatePartitionUsinglmage method on the class DCIM_PersistentStorageService D Poll jobstatus for Completed GET the InstancelD of from C See section 2 3 for a definition of GET 85 LC Integration Best Practices Specification E
129. ling is for PXE to be set in the boot list during CSIOR g The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready 4 14 PXE Boot using embedded NICs 12G only This workflow performs a reboot of the host OS into the PXE boot configuration by first setting the embNic1Nic2 parent attribute and EmbNicPort1BootProto to Pxe and EmbNicPort2BootProto to None child attributes Approximate time for completion on a 12G system is 10 30 minutes depending on the system configuration Applies to LC2 Prerequisites for script None Script PXEboot_NIC1_NIC2_12G win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B Enable CSIOR Collect System Inventory on Restart a SetAttribute Sets attribute to be configured ReturnValue 0 b CreateConfigJob Creates jobID and applies configuration ReturnValue 4096 C Call subroutine sub_setEmMbNICs_NIC1_NIC2_12G win to perform the following a GetBlOSEnumerations Enumerate the DCIM_BlOSEnumeration to obtain the current values of EmbNic attributes b DeletePendingBlOSConfiguration Ensures there is no other pending BIOS configuration c SetAttribute Set parent attribute EmbNic1Nic2 to Enabled ReturnValue 0 d SetAttribute Set child attributes EmbNicPort1BootProto to Pxe and EmbNicPort
130. loading then poll for ready while the GetRemoteServicesAPI Status can just poll for ready 53 LC Integration Best Practices Specification H ENUMERATE the DC IM_NICString class and ensure the attributes were applied correctly See section 2 2 for a definition of ENUMERATE 4 20 Export LC log 4 21 This workflow exports the LC log to either an NFS or CIFS share Approximate time for completion on an 12G system is 5 minutes depending on the system configuration Applies to LC1 5 0 Prerequisites for script e Set script variables by editing script Script ExportLCLog win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ExportLCLlog Invokes the export operation ReturnValue 4096 NOTE The user must set applicable IP address username password filename and workgroup of the network share C Poll jobstatus for Completed GET the InstancelD of from D See section 2 3 fora definition of GET FCoE boot using QLogic 12G only This workflow sets several NIC attributes including setup of Fiber Channel over Ethernet FCoE by first setting the attributes for the operation and then changing the boot order for the NIC Approximate time for completion on a 12G system is 20 30 minutes depending on
131. ms a backup or export operation which saves the image to a CIFS or NFS share The TIME_NOW parameter is passed which invokes the operation immediately Approximate time for completion on a 12G system is 20 50 minutes depending on the system configuration NOTE The export operation will overwrite an existing backup image on a network share if an identical name is used Applies to LC1 5 0 38 LC Integration Best Practices Specification 4 8 4 9 Prerequisites for script e Valid and enabled vFlash card for licensing e Set script variables by editing script Script Backup_CIFS_NFS win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B BackupImage Performs backup operation ReturnValue 4096 C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 fora definition of GET Import restore image from vFlash This workflow performs a restore or import operation which restores the image from the vFlash The TIME_NOW parameter is passed which invokes the operation immediately Approximate time for completion on an 12G system is 30 60 minutes depending on the system configuration Applies to LC1 5 0 Prerequisites for script e Valid and enabled vFlash card for licensing e Backup image
132. n a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName iDRAC Card and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM iDRACCard 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM iDRACCard 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Configuration 77 LC Integration Best Practices Specification 9 2 ProfileRequireLicense Remote Inventory ProfileRequireLicense Virtual Console ProfileRequireLicense Virtual Media ProfileRequireLicense Two Factor Authentication ProfileRequireLicense Directory Services ProfileRequireLicense IPv6 ProfileRequireLicense Dynamic DNS ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLi
133. n the version of the LC Management registered profile B DetachPartition Invokes the DetachPartition method on the class DCIM_PersistentStorageService C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 for a definition of GET D GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions and confirm successful operation See section 2 2 for a definition of ENUMERATE 11 15 Export data from existing partition This method is used to export data from a partition on the virtual flash media device to a network share Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashExportDataFromPartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ExportDataFromPartition Invokes the ExportDataFromPartition method on the class DCIM_PersistentStorageService C Poll jobstatus for Completed GET the nstancelD of from B See section 2 3 for a definition of GET D GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions and confirm successful operation See section 2 2 for a definition of ENUMERATE 12 Power State Management Profile Use Cases 12 1 Discovery
134. ncelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM SystemInfo 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM SystemInfo 1 0 0 123 LC Integration Best Practices Specification 28 2 28 3 OtherRegisteredOrganization DCIM ProfileRequireLicense Power Budget ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED RegisteredName System Info RegisteredOrganization 1 RegisteredVersion 1 2 0 Inventory of system info view Use the following procedure below to list the inventory of all system info in the system Applies to LC1 5 0 Prerequisites for script none Script GetSystemInfoViews win e GetSystemViews ENUMERATE the DCIM_SystemView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available system info will be returned Get the first system info view s information Use the following procedure to get a single system info instance The URI for getting particular instance information is deterministic i e the nstancelD will be un
135. nding on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE C GetDHSDisks Invoke this method to return desired data The output will contain the available physical disks for use as a hotspare 14 13 Assign a physical disk as a hotspare View the RAID stacking workflows in Section 4 for a comprehensive example 14 14 Delete a virtual disk from the system The following script can be used to delete an existing virtual disk from a system Applies to LC1 5 0 Prerequisites for script e Set desired RAID virtual disk FQDD by editing script Script DeleteVirtualDisk win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE 95 LC Integration Best Practices Specification C GetVirtualDiskViews ENUMERATE the DCIM_VirtualDiskView class to view all available virtual disk FQDDs See section 2 2 for a definition of ENUMERATE D DeleteVirtualDisk Invoke this method to delete the VD E CreateRAIDConfigJob Apply step D ReturnVal
136. ned 31 3 Check and enable or disable Collect System Inventory on Restart CSIOR This workflow first checks whether CSIOR is enabled or disabled if it is not then it is set to Enabled or Disabled While setting the attribute it checks both the pending and final values Applies to LC1 4 0 Prerequisites for script none Script EnableCSIOR win or DisableCSIOR win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCEnumerations ENUMERATE the DC M_LCEnumeration class and find the current value of CSIOR by searching for AttributeName Collect System Inventory on Restart See section 2 2 for a definition of ENUMERATE C SetLCAttribute Set the CSIOR attribute if it is Disabled or Enabled D GetLCEnumerations ENUMERATE the DCIM_LCEnumeration class to ensure the pending value of CSIOR is Enabled or Enabled See section 2 2 for a definition of ENUMERATE E CreateLCConfigJob Apply step C ReturnValue 4096 F Poll jobstatus for Completed GET the nstancelD of from E See section 2 3 fora definition of GET NOTE LC1 x polls for COMPLETED while LC2 polls for Completed G GetLCEnumerations ENUMERATE the DC M_LCEnumeration class to ensure the new value of CSIOR is Enabled or
137. ng an instancelD such as NIC Mezzanine 2B 1 See Section 2 3 for a definition of GET The instance of DCIM_NICView that contains the information on the first NIC will be returned 18 4 List all NIC attributes Use the following procedure below to view all available attributes and possible values of all NICs in the system Applies to LC1 5 0 Prerequisites for script none Script GetAlINICAttributes win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetNiCAttributes ENUMERATE the DCIM_NiCAttribute class to view all instances See section 2 2 for a definition of ENUMERATE 18 5 Delete pending NIC values Use the following procedure below to delete pending NIC configurations values set by the setAttribute s method 106 LC Integration Best Practices Specification 18 6 Applies to LC1 5 0 Prerequisites for script e Set desired NIC FQDD Script DeletePendingNICConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetNICViews ENUMERATE the DCIM_NICView class to view all av
138. nin naia i sN oy 148 Check for Pending configuratiOM sensencon anini senna aE Ra 148 Ch ck CSIOR State sis daccstcccaccsinsasecdsaunsoscsineoenesd nade ANO EEO EE ANENE ANAE DEINES 148 INVENTORY INFOMATION si s c80cscsseiacenssdiadssdaeaeavenaedeanengeeband paedaaeeaanreosasgedeaeaeoenanens 148 System INVENTONY icc dvaaiiciendaees Ena EEE EEO EEEE ove deierseu dated ets 148 Software INVENCOLY viscid cock censeets owas sevscensemhoeas stb ianseabnonay sevboesneem bonus canboaeien 149 BIOS inventory sicrie n divs siete aint send drow ble ate siete E iets eieweiens 149 Boot order INVENLOTY cise evecivecevecsvessvecswestvectwes EANAN ENNAN AENA RENNIN EER 149 NIC IAVENLONY se odes cedeencionte i nnd anes TO A EE EEA aa 149 RAID INVENCONY s cicccsciraacwnscctdoaescananesnsasaeannediosinntes ieee seasaeasesd EEEE EERE 149 Pol LC jobs INTOMMATIOMN Gc iecc5ccontves ca cducscaoedviescaaeducsedondvestaanduestcandxescnendwesccands 149 TIMING considerations asc eceseceieceseeceeccbesedecs des cdeccbeccdaccgeeceesebserdawedsecemeeaeee s 149 Machine FEDOOE a sscaasiceeacsscsasenseecen ed atedavensenaesed sdubaweneeedanens ekeveadneteveasueeueds 149 POST sissscesiereiens anne siers srealnainats siesindiestssinalsaecascemnsieda a a a ana 150 SSM assicccass sss acess sienie ening sievis arene sin ng EEEE EEEE ENEE NEEE KENE EE areas OENES aE greases 150 RSStatuis JODSEACUS s s ccs inss siesieiaieans sivas gests ccerisisle wa aniaierne dies bene dielvs a aremeleinaie go
139. nseStatus LICENSED RegisteredName Simple NIC RegisteredOrganization 1 RegisteredVersion 1 2 0 18 2 Inventory of NICs in system Use the following procedure below to list the inventory of all NICs in the system Applies to LC1 5 0 Prerequisites for script none 105 LC Integration Best Practices Specification Script GetNIiCViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetNiCViews ENUMERATE the DCIM_NICView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available NICs will be returned 18 3 Get the first NIC s information Use the following procedure to get a single NIC instance The URI for getting particular instance information is deterministic i e the InstancelD will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetNICView win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetNiCView GET the DC M_NI CView instance usi
140. nseStatus RegisteredName Profile Registration RegisteredOrganization 1 RegisteredVersion 1 0 0 14 Simple RAID Profile Use Cases 14 1 Discovery of RAID profile support Use the following procedure below to confirm the existence of RAID profile support Applies to LC1 5 0 Prerequisites for script none Script GetRAIDProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Simple RAID and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET 90 LC Integration Best Practices Specification 14 2 14 3 Results for the InstancelD of DCIM SimpleRAID 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM SimpleRAID 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Configurati
141. numeration winRM settings may need to be changed as described in the section 1 2 e Set desired instancelD by editing script Script SetLCLogEntryComment win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCLogEntries ENUMERATE the DCIM_LCLogEntry class to view all instances of the class LCLogEntry See section 2 2 for a definition of ENUMERATE C GetLCLogEntry GET the desired InstancelD of from B See section 2 3 for a definition of GET This will display the current comment D SetLCLogEntryComment Set the desired comment into the InstancelD of from C E GetLCLogEntry GET the desired InstancelD of from B to confirm new comment 100 LC Integration Best Practices Specification 15 6 List system event record logs Use the following procedure below to list the inventory of all SELRecordLog instances in the system Applies to LC1 5 0 Prerequisites for script none Script GetSystemEventLogs win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSystemEventLogs ENUMERATE the DCI
142. nvokes firmware update operation ReturnValue 4096 NOTE The USC update is applied immediately and cannot be scheduled for a later time E Poll jobstatus for Completed GET the nstancelD of from D See section 2 3 fora definition of GET F RequestiDRACStateChange Must reset idrac for changes to take effect ReturnValue 0 G LC1 5 0 LC1 5 1 Sleep for 10 minutes to allow reboot POST and CSIOR to complete See Appendix 33 4 3 and 33 4 7 for more information about POST and CSIOR H The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile 42 LC Integration Best Practices Specification 4 13 PXE Boot using embedded NICs 11G only This workflow performs a reboot of the host OS into the PXE boot configuration by first setting the embNic1Nic2 parent attributes and embNic1 and embNic2 child attributes Approximate time for completion on an 11G system is 20 40 minutes depending on the system configuration Applies to LC1 5 1 Prerequisites for script None Script PXEboot_NIC1_NIC2 win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management regi
143. o do a BIOS job f not enabled or a secondary device in boot order e Create a BIOS job o Set EnabledState for IPL entry of NIC FQDD to 1 o Set assigned sequence to 0 so that it boots first 1 1 152 LC Integration Best Practices Specification 6 7 e Create a NIC job o Set all iSCSI boot configuration attributes e Wait for both jobs to complete e Wait for CSIOR to complete o Since boot source changes only occur after reboot they get detected only after CSIOR and refresh iSCSI configuration settings o For Broadcom IscsiViaDHCP Disabled TcpViaDHCP Disabled ConnectFirstTgt Enabled IscsilnitiatorlpAddr lt IP of initiator gt IscsilnitiatorSubnet lt Subnet mask for initiator gt IscsilnitiatorGateway lt Gateway for initiator gt IscsilnitiatorName lt Initiator name gt IscsiT gtBoot Enabled FirstHddTarget Disabled FirstTgtlpAddress lt IP of target gt FirstTgtlscsiName lt Target name gt FirstTgtBootLun lt Target LUN gt System should boot into iSCSI as needed 153
144. of Power State Management profile support Use the following procedure below to confirm the existence of Power State Management profile support NOTE Prior to LC2 0 0 this profile resided as a CIM profile not LC profile Applies to LC1 5 0 Prerequisites for script none Script GetPowerStateMGMTProfile win 88 LC Integration Best Practices Specification A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B LC1 5 0 LC1 5 1 GetCIMRegisteredProfiles LC2 0 0 GetLCRegisteredProfiles ENUMERATE the applicable class to view all registered profiles See section 2 2 fora definition of ENUMERATE C Search for RegisteredName Power State Management and note its instancelD to use in step D D LC1 5 0 LC1 5 1 GetCIMRegisteredProfile LC2 0 0 GetLCRegisteredProfile GET the applicable instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM PowerStateManagement 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM PowerStateManagement 1 0 0 OtherRegisteredOr
145. og can be used to provide approximate timing on a particular system configuration as well as raw winRM or WSMAN input and output 1 2 Using the sample scripts Refer to the appendix for a full text README Getting started 1 Install Python 2 4 to 2 6 2 Download scripts folder to desired location no installation necessary Running a script cd to scripts directory python recite py opens command prompt of application set SIP 12 34 56 Enter actual IP wn aN log whateverfilename log w may use any name for filename batch bestpracticeflows script_name win launches script 5 Note A win file is simply a text file containing calls to the recite PYTHON script Other commands help lists all available commands set list current IP username password etc Notes File output will be placed in scripts directory 1 3 Improving winRM enumeration performance When an enumeration command is executed the default WinRM configuration gets only 20 instances at a time and therefore slows down the system drastically Changing the WinRM configuration to allow a greater number such as 50 will reduce the time taken by the enumeration operations Also see section 3 9 for using CQL filters on enumerations Execute the following command to get instances in groups of up to 50 winrm set winrm config MaxBatchltems 50 12 LC Integration Best Practices Specification Additionally increasing the allotted max
146. om 12G only es ec eee sedectecseee cee c sede stu cueeectucuedectuceueeetu cues 62 4 26 lO Identity for Intel 12G only s ccs oes ceccess vee se dives swede wae E SAREE SERIE SAR Ei iE Si 64 4 27 Export System Configuration 12G 0nly 2 ci2 tte tei eee eed 65 4 28 Import System Configuration 1 2G Only serssreernenisii oideeees ro EErEE nE E ENA KEENER EEN 65 4 29 Configurable Boot to network ISO cc vcciecesecd coccesacasee send cseeetacaseedecdaseeeracaseeuseaaers 66 5 Base Metrics Protile Use Cases sicciveisovesssecdieaetasdasaetaceinee pea daca ecanavean ees dietevssauaae as duaae see 67 5 1 Discovery of Base Metrics profile support s ssssssssssssosssesesooosssesseooesssssssosessssseo 67 LC Integration Best Practices Specification 6 BIOS and Boot Management Profile Use Cases cceeceec esc eeceeceeeeeeeeeeeeeeeeeeeeeeeeeneeneenaee 68 6 1 Discovery of BIOS and boot profile support cece cece eee ee eect eee ne eee eeeeneeeeeneenas 68 6 2 Listall BIOS attributes rseson e rede iia dese weees nanee se 69 6 3 Delete pending BIOS configuration sessssssssosssesssososesssessoosssesssooosesssessoessseses 69 6 4 Inventory of boot configurations in system cecceecceecceeceesceeeceeeseeeseesseeeseeeseees 70 6 5 Get the first boot configuration s information cs ceece sees eee e eee ee eee eeeeeeeeeeneees 70 6 6 Inventory of boot sources iN System sii cee ciceices cick eee di
147. on ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED RegisteredName Simple RAID RegisteredOrganization 1 RegisteredVersion 1 2 0 Inventory of RAID controllers in system Use the following procedure below to list the inventory of all RAID controllers in the system Applies to LC1 5 0 Prerequisites for script none Script GetRAIDControllerViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available RAID controllers will be returned Get the first RAID controller s information Use the following procedure to get a single RAID controller instance The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script Script GetRAIDControllerView win 91 LC Integration Best Practices Specification A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSSt
148. on of ENUMERATE C Search for RegisteredName Power Supply and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM PowerSupply 2 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM PowerSupply 2 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName Power Supply RegisteredOrganization 1 RegisteredVersion 2 1 0 Inventory of power supplies in system Use the following procedure below to list the inventory of all power supplies in the system Applies to LC1 5 0 Prerequisites for script none Script GetPowerSupplyViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetFanViews ENUMERATE the DCIM_PowerSupplyView class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available power supplies will be returned 121
149. on of GET Results for the nstancelD of DCIM Sensors 1 0 0 shown below If no instance is returned the profile is not supported NOTE 12G example output shown below DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Advertise TypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM Sensors 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Device Monitoring ProfileRequireLicenseStatus LICENSED RegisteredName Sensors RegisteredOrganization 1 RegisteredVersion 1 0 0 23 2 Inventory of sensor in system 114 LC Integration Best Practices Specification Use the following procedure below to list the inventory of all sensors in the system Applies to LC1 5 0 Prerequisites for script none Script GetSensorViews win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetSensorViews ENUMERATE the C M_Sensor class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available sensors will be returned 23 3 Sensor thresholds Only sensors of Numeric type have thresholds i e sensors of type DCIM_PSNumericSensor and DCIM_NumericSensor Sensor instances of this type will indicate the supported t
150. one 116 LC Integration Best Practices Specification Script GetBaseServerAndPhysicalAssetProfilesLC151 win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetClMRegisteredProfiles ENUMERATE the DCIM_RegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Base Server and note its instancelD to use in step E D D Search for RegisteredName Physical Asset and note its instancelD to use in step F E GetClMRegisteredProfile GET the DCIM_RegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET CIM_RegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypes 1 Caption Description ElementName InstancelD DCIM CSRegisteredProfile 1 OtherRegisteredOrganization RegisteredName Base Server RegisteredOrganization 2 RegisteredVersion 1 0 0 F GetCIMRegisteredProfile GET the DCIM_RegisteredProfile instance using the InstancelD from D See Section 2 3 for a definition of GET CIM_RegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypes 1 Caption Description ElementName InstancelD DCIM PhysicalAssetRegisteredProfile 1 OtherRegisteredOrganiz
151. only This workflow sets IO Identity for Intel cards only The script is an example for setting IO Identity for the following e Port 1 e NIC e FCoE Applies to LC2 Prerequisites for script e Intel card e Set desired script variables by editing script e Intel cards have no partitions Script 1O_IdentitylIntel win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPIStatus B Check NIC is enabled 1 GetBlOSEnumerations ENUMERATE the DC M_BlOSEnumeration class to collect information about the system 2 Ensure the NIC is enabled If not enabled enable it as shown below e SetBlOSAttributes Target BIOS FQDD e CreateBlOSConfigJob Target BIOS FQDD e ScheduledStartTime TIME_NOW RebootJobType 1 e Poll job status for Completed C Disable the FlexAddress e SetLCAttributes AttributeName VirtualAddressManagement AttributeValue Console D Set IO Identity 64 LC Integration Best Practices Specification 4 27 4 28 e SetNICAttributes Target NIC FQDD AttributeName VirtMacAddr VirtFIPMacAddr VirtWWN VirtWWPN e CreateNICConfigJob Target NIC FQDD RebootJobType 1 e Poll job status for completion using instancelD form CreateNICConfigJob Export System Configuration 12G only This method is used to export the system configuration from the Lifecycle Controller to a file on a remote share Applies to LC2
152. or a RAID configuration Use the following procedure below to delete pending RAID configurations values method Applies to LC1 5 0 Prerequisites for script e Set desired RAID FQDD by editing script Script DeletePendingRAIDConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE 92 LC Integration Best Practices Specification C DeletePendingRAIDConfiguration Deletes the pending configuration for a particular RAID controller using a target FQDD 14 7 Clear old configuration from newly added hard drive Use the following procedure below to clear old configuration from newly added hard drives Applies to LC1 5 0 Prerequisites for script e Set desired RAID FQDD by editing script Script ClearForeignConfig win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAI
153. or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ENUMERATE the applicable class to view all registered profiles See section 2 2 for a definition of ENUMERATE LC1 5 0 LC1 5 1 GetCIMRegisteredProfiles LC2 0 0 GetLCRegisteredProfiles Search for RegisteredName Role Based Authorization and note its instancelD to use in step D GET the applicable instance using the InstancelD from C See Section 2 3 for a definition of GET LC1 5 0 LC1 5 1 GetCIMRegisteredProfile LC2 0 0 GetLCRegisteredProfile 67 LC Integration Best Practices Specification 6 6 1 Results for the InstancelD of DCIM BaseMetrics 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Advertise TypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM BaseMetrics 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Power Monitoring ProfileRequireLicenseStatus LICENSED RegisteredName Base Metrics RegisteredOrganization 1 RegisteredVersion 1 0 0 BIOS and Boot Management Profile Use Cases Discovery of BIOS and boot profile support Use the following procedure below to confirm the existence of BIOS and boot profile support Applies to LC1 5 0 Prerequisites for script none Script GetBlOSandBootProfile win
154. ote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetBootConfigSetting GET the DCIM_BootConfigSetting instance using the InstancelD IPL See Section 2 3 for a definition of GET The instance of DCIM_BootConfigSetting that contains the information on the first boot configuration will be returned 70 LC Integration Best Practices Specification 6 6 Inventory of boot sources in system Use the following procedure below to view all available instances of the DCIM_BootSourceSetting class 6 7 6 8 Applies to LC1 5 0 Prerequisites for script none Script GetBootSources win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available boot sources will be returned Changing boot order by instance See Section 4 5 Set hard drive to first in boot order for a comprehensive example Enable or disable boot source This workflow can enable 1 or disable 0
155. pecification InstancelD DCIM RecordLog 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense ProfileRequireLicenseStatus RegisteredName Record Log RegisteredOrganization 1 RegisteredVersion 1 0 0 15 2 List Lifecycle record logs Use the following procedure below to list the inventory of all LCRecordLog instances in the system Applies to LC1 5 0 Prerequisites for script none Script GetLCRecordLogs win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRecordLogs ENUMERATE the DCIM_LCRecordLog class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available LCRecordLog will be returned 15 3 List Lifecycle record log capabilities Use the following procedure below to list the inventory of all LCRecordLogCapabilities instances in the system Applies to LC1 5 0 Prerequisites for script none Script GetLCRecordLogCapabilities win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRecordLogCapabilities ENUMERATE the D
156. pending on the system configuration NOTE Additional details of the coding steps shown below generational differences and other iSCSI information can be found in Appendix iSCSI Boot information Applies to LC2 Prerequisites for script e Network Daughter Card NDC Broadcom NIC e This script will only work using an NIC FQDD of NIC Integrated 1 1 or NIC Integrated 1 1 1 e Only works with first port partition of 12G NDC script limitation e System must be powered off e Edit script to set desired parameters Script iscsiboot 12gNDC win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetBlOSEnumerations ENUMERATE the DCIM_B lOSEnumeration class to collect information about the system See section 2 2 for a definition of ENUMERATE C GetNiCViews ENUMERATE the DCIM_NICVIEW class to collect information about the NIC FQDDs See section 2 2 for a definition of ENUMERATE D GetBootSourceSettings ENUMERATE the DCIM_BootSourceSetting class to collect information about the NIC FQDDs See section 2 2 for a definition of ENUMERATE e Check whether the FQDD and IPL fields are in the boot order e SetNiCAttributes Set the attribute LegacyBootProto to the value iSCSI and the other desired NIC attributes and values e CreateNICConfigJob Pass RebootJobType 1 48 LC Integration Best Practices Specification 4 17
157. ported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM RoleBasedAuthorization 1 0 0 102 LC Integration Best Practices Specification 16 2 16 3 16 4 OtherRegisteredOrganization DCIM ProfileRequireLicense ProfileRequireLicenseStatus RegisteredName Role Based Authorization RegisteredOrganization 1 RegisteredVersion 1 0 0 Discovery of users with assigned LAN privileges Enumerate the DCIM_IPMIRBAldentityMemberOfCollection class to view all IPMI LAN identities that are assigned a role Applies to LC1 5 0 Prerequisites for script none Script GetUsersAssignedLANPrivileges win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B GetUsersAssignedLANPrivileges ENUMERATE the DCIM_IPMIRBAldentityMemberOfCollection class to view all instances See section 2 2 for a definition of ENUMERATE The associations between all LAN Identities and IPMI Roles will be returned Discovery of users with assigned serial over LAN privileges Enumerate the DCIM_IPMISOLRBAIdentityMemberOfCollection class to view all serial identities that are assigned a role Applies to LC1 5 0 Prerequisites for
158. pplies to LC1 5 0 Prerequisites for script none Script GetAlIBIOSAttributes win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B ENUMERATE the following classes to view all instances See section 2 2 for a definition of ENUMERATE GetBlOSEnumerations Returns instance information from DCIM_BlOSEnumeration class GetBlOSIntegers Returns instance information from DCIM_BlOSInteger class GetBlOSStrings Returns instance information from DCIM_BlOSString class The instance information of all available BIOS attributes will be returned 6 3 Delete pending BIOS configuration Use the following procedure below to delete pending BIOS configurations values set by the setAttribute s method Applies to LC1 5 0 Prerequisites for script none Script DeletePendingBlOSConfiguration win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetBlOSEnumerations ENUMERATE the DCIM_B lOSEnumeration class to view all available BIOS FQDDs See section 2 2 for a definition of ENUMERATE 69 LC Integration Bes
159. profile B GetSystemEventLogEntries ENUMERATE the DCIM_SELLogEntry class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available SELLogEntry will be returned 16 Role Based Authorization Profile RBAP use cases 16 1 Discovery of RBAP profile support Use the following procedure below to confirm the existence of Role Based Authorization profile support NOTE Prior to LC2 0 0 this profile resided as a CIM profile not LC profile Applies to LC1 5 0 Prerequisites for script none Script GetRBAProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B LC1 5 0 LC1 5 1 GetCIMRegisteredProfiles LC2 0 0 GetLCRegisteredProfiles ENUMERATE the applicable class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Role Based Authorization and note its instancelD to use in step D D LC1 5 0 LC1 5 1 GetCIMRegisteredProfile LC2 0 0 GetLCRegisteredProfile GET the applicable instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM RoleBasedAuthorization 1 0 0 shown below If no instance is returned the profile is not sup
160. r when clearing disabling the account 3 11 How to determine if server is 11G or 12G In order to determine if a server is 11G or 12G irrespective of the license present on the server the recommendation is to look at LifecycleControllerVersion property from DCIM_SystemView If this property is not shown or the value is 1 x y then it is 11G system If the value is 2 x y then it is 12G Section 31 4 of this document describes the workflow for enumerating the DCIM_SystemView class 3 12 Using special characters in usernames For 11G systems usernames may not contain the characters lt gt For 12G systems usernames may not contain the characters When an iDRAC user has angle brackets for the username or password they must use double quotes around the brackets when trying to execute any WSMAN commands 3 13 Obtaining Updated System Inventory Use the following procedure below to refresh stale inventory or to ensure the inventory has the most up to date information Collect System Inventory on Restart CSIOR is the mechanism which checks and updates the inventory CSIOR is run when enabled during the boot process Applies to LC1 3 0 A LC1 5 0 The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile
161. rate cimv2 CIM_RegisteredProfile __cimnamespace root interop r https IPADDRESS wsman u username p password SkipCNcheck SkipCAcheck encoding utf 8 a basic format pretty b The output from above will provide the RegisteredVersion of each supported profile on the system The RegisteredVersion field can be used to determine the profile s feature set See Section 1 4 for more information 2 Capability properties on views NIC example a winrm enumerate cimv2 root dcim DCIM_NICCapabilities r https IPADDRESS wsman u username p password SkipCNcheck SkipCAcheck encoding utf 8 a basic format pretty b The output from above will provide the available properties of each view 3 Capability Attributes RAID example 13 LC Integration Best Practices Specification 4 1 5 a Enumerate the DCIM_RAIDString DCIM_RAIDEnumeration and DCIM_RAIDInteger classes DCIM_RAIDString shown below winrm enumerate cimv2 root dcim DCIM_RAIDString r https IPADDRESS wsman u username p password SkipCNcheck SkipCAcheck encoding utf 8 a basic format pretty b The output from above will provide the available attributes of each class Firmware versioning a winrm enumerate cimv2 root dcim DCIM_Softwareldentity r https IPADDRESS wsman u username p password SkipCNcheck SkipCAcheck encoding utf 8 a basic format pretty The output from above will list all available and installed firmware
162. returned the profile is not supported NOTE 12G example output shown below DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Advertise TypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM PCIDevice 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Inventory ProfileRequireLicenseStatus LICENSED RegisteredName PCI Device RegisteredOrganization 1 RegisteredVersion 1 0 0 113 LC Integration Best Practices Specification 23 Sensors Profile Use Cases 23 1 Discovery of Sensor profile support There is currently not a registered Sensor Profile prior to LC2 0 However the C M_Sensor class has been implemented which returns all the sensor views when enumerated Use the following procedure below to confirm the existence of Sensors profile support in LC2 0 Applies to LC2 Prerequisites for script none Script GetSensorProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPIStatus B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Sensors and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definiti
163. ributes cql select from DCIM _iDRACCardAttribute where GroupDisplayName GDRAC Users and AttributeName USerName 3 9 5 CQL filter example that enumerates all BIOS attributes where the IsReadOnly flag is set to TRUE The expression below return attributes that have the IsReadOnly TRUE flag set as the CurrentValue GetBIOSEnumerations cql select CurrentValue from DCIM_BIOSEnumeration where 3 10 Ordering of iDRAC attributes to set or apply 11G vs 12G Users need to correctly set the order in which iDRAC System and LC attributes are applied Incorrect ordering of attributes may result in an error if dependencies are violated The DisplayOrder field of each attribute along with the applicable references in profiles provide direction as to the appropriate ordering An example would be to create an iDRAC user account On 11G systems the iDRAC would automatically re order the the attributes before setting applying them to create and enable a user account However due to the expansion of attributes in 12G systems as well as to avoid the anticipating the user s intent re ordering of attributes was removed The correct order for setting iDRAC attributes when enabling a user account on both 11G and 12G is as follows 1 Username 27 LC Integration Best Practices Specification 2 Password 3 lt other attributes gt This ordering is applicable to both ApplyAttributes and SetAttributes iDRAC methods Use the reverse orde
164. rofile support cece eee ee scence eee enone 130 LC Management Profile Use Cases ise sivesssis sisceeaten cievindieivaoiiceneten EAEE EENES E ETA EE 131 Discovery of LC Management profile support esssessssosssssssesosssssssooossssssseoosssss 131 Inventory of LC Management attributes in system sssssssssssssssssesesssssessseseeeeoo 132 Check and enable or disable Collect System Inventory on Restart CSIOR 4 133 Check version of Lifecycle Controller LC ssssssssssseseseseseseseseseseseseseseseseseeesese 133 Get Part Firmware Update attribute esssssessosssssseosossssssesosessesssoossessssesose 134 Check vFlash license enablement esssesesssssssssesooesssssesosesssesesosesssssososessssseooes 134 Set configuration to Auto Discovery Factory Defaults sssssssssesseescsseeeseseeesesee 135 Clear provisioning Servel sse reese cas ewaes nies obec ong ernn ENET N n nEs ENEN ETS anase EEEa SaS 136 Replace auto discovery PUBLIC KEY seot ennei E EEE O EEEE ERRIA EE 136 Replace auto discovery client certificate private key and password ssssssssssseceess 136 Delete auto discovery pubDLIC key ss eicseser sccaesicadca piane TRENAR KECE REES acca eadadaeeeedsecaeees 136 Delete auto discovery client certificat private key and password cceeceeeeeeees 137 Replace iDRAC web server client certificate and private key sssssssesssssssssssseeeess 137 Replace iDRAC web s
165. roller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetMemoryView GET the DCIM_MemoryView instance using the nstancelD DIMM Socket A1 See Section 2 3 for a definition of GET The instance of DCIM_MemoryView that contains the information on the first memory DIMM will be returned PCI Device Profile Use Cases Discovery of PCI Device profile support Use the following procedure below to confirm the existence of PCI Device profile support Applies to LC1 5 0 Prerequisites for script none Script GetPCIDeviceProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE Search for RegisteredName PClI Device and note its instancelD to use in step D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM PCIDevice 1 0 0 shown below If no instance is
166. rtitionable NICs supported by LC2 Broadcom 57810 DNDC JVFVR 57810 SFP NIC N20KJ 57810 Base T NIC W1GCR 57810 Mezz 55GHP 57800 rNDC MTO9V QLogic QMD8262 DNDC D90TX QLE8262 NIC JHD51 QME8262 Mezz 9Y65N 3 6 iDRAC Telnet attribute enables SerialRedirection The following behavior describes a situation where setting certain iDRAC attribute s causes another iDRAC attribute to automatically and simultaneously change Setting any of the following Telnet attributes causes the SerialRedirection attribute to become Enabled e Port InstancelD iDRAC Embedded 1 Telnet 1 Port e Enable InstancelD iDRAC Embedded 1 Telnet 1 Enable e Timeout InstancelD iDRAC Embedded 1 Telnet 1 Timeout 24 LC Integration Best Practices Specification Recommendation Change the Telnet attributes prior to setting the SerialRedirection Enable attribute Or if using input XML have the Telnet attributes before the SerialRedirection Enable attribute 3 7 Never unplug hardware during updates Users should not unplug any hardware during critical remote enablement RE updates This may result in unexpected behaviors As an example unplugging a USB key during critical updates may cause a Red Screen of Death RSOD 3 8 Express versus Enterprise iDRACs There are four levels of iDRAC licensing as follows 1 Basic N Express Monolithic w Express for blades Modular 4 Enterprise One method of determ
167. ry of Service Processor profile support Use the following procedure below to confirm the existence of Service Processor profile support Applies to LC1 5 0 Prerequisites for script none Script GetServiceProcessorProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Service Processor and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM SystemInfo 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM ServiceProcessor 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense ProfileRequireLicenseStatus RegisteredName Service Processor RegisteredOrganization 1 104 LC Integration Best Practices Specification RegisteredVersion 1 0 0 18 Simple NIC Profile U
168. s Set the attribute LegacyBootProto to the value FCoE and the other desired NIC attributes and values CreateBlOSConfigJob Use Target BIOS FQDD ScheduledStartTime TIME_NOW RebootJobType 1 Poll jobstatus for Completed GET the InstancelD of from F See section 2 3 for a definition of GET FCoE boot using Broadcom 12G only This workflow sets several NIC attributes including setup of Fiber Channel over Ethernet FCoE by first setting the attributes for the operation and then changing the boot order for the NIC Approximate time for completion on a 12G system is 20 30 minutes depending on the system configuration Applies to LC2 Prerequisites for script e Broadcom Mezz card using slot1 e Set desired script variables by editing script 59 LC Integration Best Practices Specification D E Script FCoEboot 12g Broadcom win The four high level steps which may require 3 reboots are the follows 1 If the NIC is disabled 1 job to enable it in bios and reboot 2 If partition disabled 1 job to enable partition and reboot 3 Once both NIC card and partition are enabled set the FCoE related NIC attributes and reboot 4 After that the NIC will show up in the IPL list enable it Check the NIC is enabled 1 GetBlOSEnumerations ENUMERATE the DC M_BlOSEnumeration class to collect information about the system 2 Ensure AttributeName of SnicAttributeName is enabled If it is not enabled enable it as shown
169. s and corresponding firmware versions Examining the version of these firmwares such as Lifecycle controller and iDRAC can be used to determine the feature set Profile revision number explanation Profile revision numbers are a key metric in determining the available feature set Examples of discovering or obtaining profiles are covered extensively in this document along with example output The example shown below is for the LC Management profile Discovering a particular profile on a system is a three step process Enumerate the DCIM_LCRegisteredProfile class to view all available profiles Search the RegisteredName field for the desired profile Search for the RegisteredVersion field which is the characteristic used to identify the supported features DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM LCManagement 1 1 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Auto Discovery ProfileRequireLicense Part Replacement ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicense Remote Inventory Export ProfileRequireLicense Server Profile Export and Import ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED RegisteredName LC Management Regist
170. s veebadeieavbacesveusues 87 Export data from existing Partition ccc cccescceeccesceesceesceesceesceescessseesseeseees 88 Power State Management Profile Use Cases ccccccceccenceccenceccencensecsecsensenaenes 88 Discovery of Power State Management profile SUPPOrt cece cece eee eeeeeneeeneeeneees 88 Profile Registration Profile Use Cases 2 0214 ses ehecadeeesic ica santin a ENDENE KERERE EERENS 89 Discovery of Profile Registration profile support cece cece sec e eee eeeeeeeeeneeeneeeneees 89 Simple RAID Profile Use Cases lt 3 ics sais snes sees cinnes vig wees eens vine verte clone en bbaineis wets e add sews eee 90 Discovery of RAID protile sUpPOMt sinc fccias Heo tieds detccrews sewn tieds beeclnws foun ties Seucumes senate 90 Inventory of RAID controllers in system ssseesssssssecesesssssecoossssseceossssseecoossssse 91 Get the first RAID controller s information ssssssssssossssssssoooessssssoossssesseosseess 91 Inventory of virtual and physical disks in system ecceecceec cece ceeeeeeseeeseeeseeeeeees 92 Apply pending values for a RAID configuration ccc eee eee eee e eee eeeeeeeeeeeeeeeeeeneees 92 Delete pending values for a RAID CONFIQUrATION ccc ccc eee e eee e eee eeeeeneeeneeeneeeneees 92 Clear old configuration from newly added hard drive cece eee eee eee eee eeeeeeeeeees 93 Determine available RAID configurations cc
171. sReadOnly true PendingValue PossibleValues No PossibleValues Yes Set configuration to Auto Discovery Factory Defaults Use the following procedure to set the Auto Discovery configuration to factory defaults Applies to LC1 5 0 Prerequisites for script none Script SetAutoDiscoveryFactoryDefaults win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCEnumerations ENUMERATE the DCIM_LCEnumeration class to new view all available instances See section 2 2 for a definition of ENUMERATE C Search for AttributeName Discovery Factory Defaults and note its instancelD to use in step D 135 LC Integration Best Practices Specification D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET The instance containing the attribute will be returned If the CurrentValue parameter is on Auto Discovery Factory Defaults is already on proceed to end E RelnitiateDHS Invoke method to set Auto Discovery values F Repeat step D to confirm CurrentValue is now on 31 8 Clear provisioning server Use the following procedure to clear the provisioning server name Applies to LC1 5 0 Prerequisites
172. script none Script GetUsersAssignedSerialOverLANPrivileges win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetUsersAssignedSerialOverLANPrivileges ENUMERATE the DCIM_IPMISOLRBAIdentityMemberOfCollection class to view all instances See section 2 2 for a definition of ENUMERATE The associations between the serial Identities and IPMI SOL Role will be returned Discovery of users with assigned CLP privileges Enumerate the DCIM_CLPRBAIdentityMemberOfCollection class to view all CLP identities that are assigned a role 103 LC Integration Best Practices Specification Applies to LC1 5 0 Prerequisites for script none Script GetUsersAssignedCLPPrivileges win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetUsersAssignedCLPPrivileges ENUMERATE the DCIM_CLPRBAldentityMemberOfCollection class to view all instances See section 2 2 fora definition of ENUMERATE The associations between all CLP Identities and CLP Roles will be returned 17 Service Processor Profile Use Cases 17 1 Discove
173. se Cases 18 1 Discovery of Simple NIC profile support Use the following procedure below to confirm the existence of Simple NIC profile support Applies to LC1 5 0 Prerequisites for script none Script GetNICProfile win A oO A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE Search for RegisteredName Simple NIC and note its instancelD to use in step D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM SimpleNIC 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM SimpleNIC 1 0 0 OtherRegisteredOrganization DCIM ProfileRequireLicense Remote Firmware Configuration ProfileRequireLicense Remote Inventory ProfileRequireLicense Device Monitoring ProfileRequireLicenseStatus LICENSED ProfileRequireLicenseStatus LICENSED ProfileRequireLice
174. section 2 3 fora definition of GET Configurable Boot to network ISO The ConfigurableBootToNetworkISO method exposes an ISO Image present on a network share as a CDROM device to the host server for a specified exposure duration interval or by default for 18 hrs Upon the successful execution based on the ResetType parameter the host system shall either immediately cold boot or warm boot Upon this reset the system shall then boot to the ISO Image If ResetType specifies no immediate reboot then upon the next host system reset the system shall boot to the ISO Image Furthermore if immediate reset is not specified then the system should be rebooted before the exposure duration interval expires otherwise the system shall fail to boot to the ISO Image The workflow first removes any existing driver packs or existing attached OS then gets available OS drivers unpacks the desired set of drivers and boots from an image on a network share Approximate time for completion on a 12G system is 20 40 minutes depending on the size of the driver pack that will be unpacked and the speed of the network to boot image The workflow differs from the 4 3 Boot to Network ISO in that the reboot can be configured for the following e Warm boot e Cold boot e Noreset Applies to LC2 1 Prerequisites for script e Place applicable ISO image in applicable network share e Set script variables by editing script Script BootToNetworkISO win A The
175. sesesessseseseseseeeseeeseeseeeeee 76 9 DRAC Card Profile Use Cases ccsctecddeieceedcs enis onosi ENEE vageled du CA NEEE ESR Ea 77 9 1 Discovery of IDRAC Card profile SUPPONE maodiern Eirene ao En KATENE AEE SEENI AECE 77 9 2 G talliDRAC card attributes ecas innatis E EEEE OETA O ROEE ETE OD E 78 9 3 Inventory of iDRAC cards in SYStEM cavers cecetcascicedeesdicetcascicedecsdiceicascicekeeediceieagcics 78 9 4 Get the first iIDRAC card s information 3 04 scrcvvr sr cecesene anes ces cereents seaterssaaeees somes 79 9 5 Set apply iDRAC card attribute s immediately cece cece eee e eee eeeeeeeeeneeeneeenees 79 9 6 Schedule a set iDRAC card attribute s Operation cece cece cece eee eeeceeeeeseeeneeenees 80 10 Fan Profile Use Cases ic ais csceccuecsacentiebavberteebitecdvesteentsshetestvendeestaesndesds cnevecta eas 80 10 1 Discovery of Fait profile SUpPOFrt wis dievsehisve vas ccdesvancudiencveddrescsencsenezerdeewesedess canes 80 10 2 Inventory of Tans I System saesson aean Ea AEEA eed ed 81 10 3 Get thefirst fans informatio Moeren een nr ae once AERA AA ENE A ERE EERU E 81 11 Persistent Storage Profile Use Cases ssssssssssssssssssssssesesessssseseseseesseseseseseeee 82 11 1 Discovery of Persistent Storage profile support sssssssssessesosssssssooosssesssooosssssseo 82 11 2 Inventory of virtual flash VFlash media eesussssseeesssssssscossssssccosssssssecosssssse 82 LC Integration
176. sing RFS USB endpoint and LC status is not relevant A Confirm RFS remote file share is NOT in Detach mode iDRAC attribute AttachMode value needs to be changed to Attached B ConnectRFSISOImage Invoke the method successful return value is 0 C GetRFSISOlmageConnectionInfo Invoke the method to view connection information and confirm C was successful 32 7 2 Disconnect and detach ISO Image exposed via RFS USB end point Following sequence of CIM Operations shall be used to disconnect and detach the ISO Image that is exposed via RFS USB end point to host server Applies to LC2 Prerequisites for script none Script DisconnectRFSISOImage win NOTE Check of Lifecycle Controller LC remote service state via GetRemoteServicesAPIStatus is not required since ISO is connected using RFS USB endpoint and LC status is not relevant A DisconnectRFSISOImage Invoke the method successful return value is 0 B GetRFSISOlmageConnectionInfo Invoke the method to confirm the B was successful 32 7 3 Get RF ISO Image connection Status The GetRFSISOImageConnectionInfo method is used to provide the status of the ISO Image connection that has been exposed to the host system Applies to LC2 Prerequisites for script none Script GetRFSISOlmageConnectionInfo win NOTE Check of Lifecycle Controller LC remote service state via GetRemoteServicesAPIStatus is not required since ISO is connected using RFS USB endpoint and
177. sssososssesesososssesesoossssesesoosssseses 28 3 13 Obtaining Updated System Inventory sssosssesssssssssesesoossssesesosssscesosoosssessososssee 28 LC Integration Best Practices Specification 3 14 How to determine if the system is blade tower or rack cceecceeescceeeseeeeeeseeeees 30 3 15 Getting the SystemID Model and MOre cccscesscesccesccesccescceseeeseeeseeeseeeseeesees 30 3 16 Http CIFS NFS tftp ftp formatting sccce cece cece onies ia KIERES tccvssesicdeivestceesseuseds 31 A Workflows eee ieee ninna enen nE EER a EASi KIES EE EEN KENNT ET EUT E NTS KESE EET EOCEEN oaeete este 32 4 1 RAID stacking ResetConfig CreateVD assign HotSpares sssssssssssssesesssssereeessseo 32 4 2 RAID stacking with BIOS attributes using SetupjODQUeUE eee cece cece ence eee eeeees 33 4 3 Boot to network ISOs rerien eaea a EE ANER AEE dea aieau N AE ANEREN 35 4 4 Boot ito ISO TromeVElash Cererea tn EREE EEVEE EE EER E e 36 4 5 Set hard drive to first in bootorderisi asseris snno e aa e aa a aa 37 4 6 Export backup image tO VFLASN i 000 crsscewesenncedsdengenrs ees dedetuaneees EE EE Eon 38 4 7 Export backup image to CIFS or NFS share essesssssosssesesooosesesssooosesssesooessseses 38 4 8 Import restore image from VFLASN ceccceecceeccecceecceeseeesseeesesessesseesseeeseeseees 39 4 9 Import restore image from CIFS or NFS Share eecescesc cece se esc eee eseeeeeeeeneeeeenes 3
178. sssssesesssssssscosssssssccossssseceosssssee 125 Get a single system string attribute ssssssssssseeseseseeeseseseeeeeeeeeseseeeseeseeeeeeee 125 Setting and applying system attributes s sssssesoossssssesosesssesssosssesssesssesssssesoss 125 Apply pending system attribute values ssessssssssssssssoosssesssoosssssssosossssesssoossees 126 Delete pending system attribute values s sssossssssesossssssseoosssssssosossssessesosssse 126 Software Inventory Profile Use Cases rorerririsreriir triska rsr r ekar Errea roK r wees KEENAN KES 127 Instance diag ran sizes cassie s en nEn ET EEDE cow EERE EEA eer tages EAEE ETE EA 127 Discovery of Software Inventory profile support essesssssssssssosssesssooossssssesoosssss 128 Inventory of software in Syst mM se veneecsreeinceienaiieiie rerea sine eee arie e brane 6 129 LC Integration Best Practices Specification 29 4 29 5 30 30 1 31 31 1 31 2 31 3 31 4 31 5 31 6 31 7 31 8 31 9 31 10 31 11 31 12 31 13 31 14 31 15 31 16 31 17 31 18 32 32 1 32 2 32 3 32 4 32 5 32 6 32 7 32 7 1 32 7 2 32 7 3 Get the installed BIOS firmware iNVENtOry c ce ecceece cece cece eee eeeceeeceeeeeeeeeeaeenaes 129 Get the available iDRAC firmware inventory cece eee eec cece cece eeeeeeeeeeeceeeeeeeeeees 130 Simple Identity Management Profile Use Cases cece ece eee e eee ee eee eeeeeeeeeeneeaee 130 Discovery of Simple Identity Management p
179. st during CSIOR g The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready E Sleep 500 seconds to allow PXE boot to occur Users would then select applicable PXE boot options before continuing Proceed to step F to disable PXE boot F Call subroutine sub_setEmbNICs_NIC1_NIC2 win to perform the following a GetBlOSEnumerations Enumerate the DCIM_BlOSEnumeration to obtain the current values of EmbNic attributes DeletePendingBlOSConfiguration Ensures there is no other pending BIOS configuration SetAttribute Set parent attribute EmbNic1Nic2 to Enabled ReturnValue 0 SetAttribute Set child attributes EmbNic1 and EmbNic2 to Enabled ReturnValue 0 CreateBlOSConfigJob Creates jobID and applies configuration immediately with reboot job type of 3 ReturnValue 4096 NOTE The following RS Status polling for SSIB task The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready 44 LC Integration Best Practices Specification NOTE The following RS Status pol
180. stered profile Enable CSIOR Collect System Inventory on Restart a b SetAttribute Sets attribute to be configured ReturnValue 0 CreateConfigJob Creates jobID and applies configuration ReturnValue 4096 Call subroutine sub_setEmbNICs_NIC1_NIC2 win to perform the following a GetBlOSEnumerations Enumerate the DCIM_BlOSEnumeration to obtain the current values of EmbNic attributes DeletePendingBlOSConfiguration Ensures there is no other pending BIOS configuration SetAttribute Set parent attribute EmbNic1Nic2 to DisabledOS ReturnValue 0 SetAttribute Set child attributes EmbNic1 and EmbNic2 to Disabled ReturnValue 0 CreateBlOSConfigJob Creates jobID and applies configuration immediately with reboot job type of 3 ReturnValue 4096 NOTE The following RS Status polling for SSIB task The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAPIStatus can just poll for ready NOTE The following RS Status polling is for PXE to be set in the boot list during CSIOR g The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN comm
181. t Practices Specification 6 4 C DeletePendingBlOSConfiguration Deletes the pending BIOS configuration using a target FQDD such as BIOS Setup 1 1 A return message of No pending data present to delete indicates that there is no pending BIOS configuration to delete for the respective FQDD Inventory of boot configurations in system Use the following procedure below to view all available instances of the DCIM_BootConfigSetting class 6 5 Applies to LC1 5 0 Prerequisites for script none Script GetBootConfigurations win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetBootConfigSettings ENUMERATE the DCIM_BootConfigSetting class to view all instances See section 2 2 for a definition of ENUMERATE The instance information of all available boot configurations will be returned Get the first boot configuration s information Use the following procedure to get a single boot configuration instance The URI for getting particular instance information is deterministic i e the Instance D will be unique for each instance Applies to LC1 5 0 Prerequisites for script e Set desired instancelD by editing script default is IPL Script GetBootConfiguration win A The Lifecycle Controller rem
182. t registered profile B GetVFlashViews ENUMERATE the DCIM_VFlashView class to view the current partitions enable vFlash if disabled See section 2 2 for a definition of ENUMERATE C FormatPartition Invokes the FormatPartition method on the class DCIM_PersistentStorageService D Poll jobstatus for Completed GET the nstancelD of from C See section 2 3 for a definition of GET iga s GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData class to view the current partitions and confirm successful operation See section 2 2 for a definition of ENUMERATE 86 LC Integration Best Practices Specification 11 12 Modify existing partition 11 13 11 14 This method is used to modify a partition on the virtual flash media device Applies to LC1 5 0 Prerequisites for script set variables by editing script Script VFlashModifyPartition win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B GetVFlashViews ENUMERATE the DCIM_VFlashView class to view the current partitions See section 2 2 for a definition of ENUMERATE C ModifyPartition Invokes the ModifyPartition method on the class DCIM_PersistentStorageService D GetVFlashPartitionViews ENUMERATE the DCIM_OpaqueManagementData
183. t2 The script is an example for set IO identity for the following card setting e Partition 1 NIC e Partition 3 iSCSI e Partition 4 FCoE Applies to LC2 Prerequisites for script e QLogic card e Set desired script variables by editing script Script 1O_IdentityQlogic win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPIStatus B Check NIC is enabled 1 GetBlOSEnumerations ENUMERATE the DC M_BlOSEnumeration class to collect information about the system 2 Ensure AttributeName of SnicAttributeName is enabled If not enabled enable it as shown below e SetBlOSAttributes AttributeName SnicAttributeName AttributeValue Enabled AttributeName BootMode AttributeValue Bios e CreateBlOSConfigJob e ScheduledStartTime TIME_NOW RebootJobType 1 e Poll job status for Completed 61 LC Integration Best Practices Specification C D 4 25 Disable the FlexAddress e SetLCAttributes AttributeName VirtualAddressManagement AttributeValue Console Set IO Identity e SetNICAttributes o For partition 1 AttributeName VirtMacAddr AttributeValue VirtMacAddr_value o For partition 3 AttributeName VirtlscsiMacAddr AttributeValue VirtlscsiMacAddr_value o For partition 4 AttributeName VirtFIPMacAddr AttributeValue VirtFIPMacAddr_value AttributeName VirtWWN AttributeValue VirtWWN_value AttributeName VirtWWPN AttributeValue
184. tancelD Use InstancelD BCV and source instancelD from GetBootSourceSettings e CreateBlOSConfigJob Use Target BIOS FQDD e Poll jobstatus for Completed GET the nstancelD of from BIOS config job Notes 1 Intel will not show up in the boot list until it connects to an iSCSI target So if you misconfigure iSCSI or the network is down it does not show up 2 You cannot disable RAID and SATA HDs in the boot list Either disable the controller but then they are not available as secondary disks or move them down in the HD boot list 3 It may be a good idea to disable the whole HD list from the boot order until iSCSI is on the top to prevent it booting into another 52 LC Integration Best Practices Specification HD 4 19 IO Identity This workflow sets IO Identity NIC attributes by first setting the required attributes for the operation and then applying the changes immediately using the TIME_NOW parameter Note that these attributes are read only on some NIC cards and read write on others i e Broadcom 57712 Approximate time for completion on a 12G system is 15 30 minutes depending on the system configuration NOTE These attributes can only be set remotely not locally Also if A C power is lost these settings will also be lost Applies to LC1 5 0 Prerequisites for script e Broadcom 57712 hardware or QLogic 8262 e Set FQDD of desired NIC VirtlscsiMacAddr and VirtMacAddr by editing the following script
185. tatus perspective will suggest that all job execution tasks are done However various LC tasks such as inventory and refresh will still be in progress The timeouts for these tasks can be accounted for in the next section JobStatus can be obtained as described in section 10 2 3 of the WSIG for Windows 150 LC Integration Best Practices Specification 33 4 4 3 Inventory After all jobs are executed SSM will re inventory the system and signal the iDRAC to re sync its database The total timeout for SSM should include 1 minute to inventory each NIC FQDD on the target system after job completion The total timeout for SSM should include 30 seconds to inventory each RAID controller installed on the target system after job completion 33 4 4 4 Cleanup The total timeout for SSM should include 2 minutes to unload and cleanup the UEFI environment prior to reboot 33 4 5 RSStatus JobStatus After SSM completes the system will reboot and proceed with CSIOR as described in 33 4 7 In parallel the iDRAC will refresh its database based on updated inventory The total timeout for RSStatus JobStatus should include 5 minutes to obtain the inventory data generated and update the iDRAC database Check Status Reloading and then Status Ready as described in section 20 of the WSIG for Windows 33 4 6 Check refreshed data Once RSStatus JobStatus are Ready Completed respectively NIC and BIOS need to be re inventoried to ensure that
186. teServicesAPIStatus method may be used depending on the version of the LC Management registered profile DeleteJobQueue Delete specified job from the job store by setting JobID equal to the job ID JID_01234 or reboot ID RID_01234 wW C GetLifecycleJobs List all remaining jobs in job store lt 21 Memory Profile Use Cases 21 1 Discovery of Memory profile support Use the following procedure below to confirm the existence of memory profile support Applies to LC1 5 0 Prerequisites for script none Script GetMemoryProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName Memory and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET 111 LC Integration Best Practices Specification 21 2 21 3 Results for the InstancelD of DCIM Memory 1 0 0 shown below If no instance is returned the profile is not supported NOTE 12G example output shown below DCIM_LCRegisteredProfile
187. teredOrganization DCIM ProfileRequireLicense ProfileRequireLicenseStatus RegisteredName Simple Identity Management RegisteredOrganization 1 RegisteredVersion 1 0 0 31 LC Management Profile Use Cases 31 1 Discovery of LC Management profile support Use the following procedure below to confirm the existence of LC Management profile support Applies to LC1 5 0 Prerequisites for script none 131 LC Integration Best Practices Specification Script GetLCManagementProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPI Status method may be used depending on the version of the LC Management registered profile B GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE C Search for RegisteredName LC Management and note its instancelD to use in step D D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM _LCManagement 1 1 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify AdvertiseTypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 InstancelD DCIM LCManagement
188. that belong to a particular category subcategory and severity Applies to LC2 Prerequisites for script Set variables by editing script Script SetEventFilterByCategory win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B SetEventFilterByCategory Sets the action and notifications for the event filters Set event filters by InstancelD This workflow is used to set the action and notifications for all the event filters that belong to a particular set of InstancelDs 76 LC Integration Best Practices Specification 9 9 1 Applies to LC2 Prerequisites for script Set variables by editing script Script SetEventFilterBylnstancelDs win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status B GetEventFilters ENUMERATE the DC M_EventFilter class to view all available instances to use in C See section 2 2 for a definition of ENUMERATE C SetEventFilterBylnstancelDs Sets the action and notifications for the event filters iDRAC Card Profile Use Cases Discovery of iDRAC Card profile support Use the following procedure below to confirm the existence of iDRAC Card profile support Applies to LC1 5 0 Prerequisites for script none Script GetiDRACCardProfile win A The Lifecycle Controller remote service must be i
189. the total number of NIC and RAID controllers on the target system obtained from enumerations described in sections 33 3 5 and 33 3 6 The total timeout for POST should include 10 seconds to initialize each NIC controller installed on the target system The total timeout for POST should include 1 minute to initialize each RAID controller installed on the target system 33 4 4 SSM 33 4 4 1 UEFI initialization Before executing SSM the UEFI environment needs to load into memory This includes various BIOS NIC RAID and LC drivers that are loaded and started This also includes initialization time for various NIC device drivers which populate the HII database with their attribute configuration for consumption by LC The total timeout for SSM should include 2 minutes to load all BIOS and LC components The total timeout for SSM should include 30 seconds to load and initialize each NIC driver installed on the target system 33 4 4 2 Job execution Once SSM starts to execute a job JobStatus will transition from Scheduled to Running to Completed Completed with Errors or Failed The total timeout for SSM should include 5 10 minutes per job executed depending on the type of job Error to user if JobStatus Completed or timeout occurs If JobStatus Completed with Errors attributes that failed to set can be obtained from the LCL as described in section 12 13 of the WSIG for Windows Completion of all jobs from the JobS
190. to LC2 Prerequisites for script e Set desired RAID physical disk FQDD by editing script Script ConvertToRAID win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status 96 LC Integration Best Practices Specification B C GetControllerViews ENUMERATE the DCIM_ControllerView class to view all available RAID FQDDs See section 2 2 for a definition of ENUMERATE GetPhysicalDiskViews ENUMERATE the DCIM_PhysicalDiskView class to view all available physical disk FQDDs See section 2 2 for a definition of ENUMERATE Note the value of the RaidStatus parameter of the desired physical disk H ConvertToRAID Invoke this method CreateRAIDConfigJob Apply step D ReturnValue 4096 Poll jobstatus for Completed GET the nstancelD of from E See section 2 3 fora definition of GET The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands GetRemoteServicesAPI Status GetPhysicalDiskViews ENUMERATE the DCIM_PhysicalDiskView class to view all available physical disk FQDDs See section 2 2 for a definition of ENUMERATE Note the new value of the RaidStatus parameter of the desired physical disk 14 17 Convert physical disks to non RAID state The ConvertToNonRAID method is used to convert a set of physical disks in RAID state to a state not usable for RAID Aft
191. tribute Invoke the SetSystemAttribute method on the DCIM_SystemManagement class The method will set the PendingValue property of the system attributes to the specified value passed in from the input parameters Return value 0 NOTE Use SetSystemAttribute to set one attribute and SetSystemAttributes to set multiple attributes Both methods take the same input parameters but the types of input parameter are different SetSystemAttributes uses string input and SetSystemAttributs uses arrays of strings for input E CreateSystemConfigJob Apply the pending values pass ScheduledStartTime of TIME_NOW to invoke the reboot to apply the new attribute values immediately NOTE This method also allows the user to schedule when to apply the attribute value change If the schedule is TIME_NOW the PendingValue will be applied to the CurrentValue of the attribute immediately There is no reboot required for setting system attributes as indicated in the output parameter RebootRequired F Poll jobstatus for Completed GET the InstancelD of from E See section 2 3 fora definition of GET G Repeat C to confirm successful execution of the method by examining PendingValue property of the attributes that were set by this step 28 7 Apply pending system attribute values See the previous section Setting and Applying System Attributes for a use case for this method 28 8 Delete pending system attribute values 126 LC Integration B
192. ttributeName gt Info l Version lt p AttributeName gt lt p AttributeValue gt Integrated Dell Remote Access Controller lt p AttributeValue gt lt p AttributeValue gt 1 0 0 lt p AttributeValue gt lt p ApplyAttributes INPUT gt Setting NIC string attributes to blank An issue exists when setting NIC String parameters such as IscsilnitiatorName using the NIC menu usually entered via ctrl s from a non blank value to a blank value As a result when the NIC is used for operations that utilize this parameter such as iscsi boot the operation will be unsuccessful because it will use the old value instead of the one displayed through WSMAN The work around for this scenario is to not set any NIC String parameters to a blank value 3 4 Determine NIC card There are two different ways to determine the model type of a NIC card 23 LC Integration Best Practices Specification 1 ENUMERATE the DCIM_NICView class and note the PCID then look up in PCID table http pciids sourceforge net pci ids 2 ENUMERATE the DCIM_NICString class and search for attribute ChipMdl The CurrentValue parameter will contain the NIC card model number DCIM_NICString AttributeName ChipMdl CurrentValue BCM5716 CO DefaultValue FQDD NIC Embedded 2 1 InstanceID NIC Embedded 2 1 ChipMdl IsReadOnly true MaxLength 0 MinLength 0 PendingValue 3 5 List of partitionable NIC cards for LC2 The following is a list of pa
193. ue 4096 F Poll jobstatus for Completed GET the nstancelD of from E See section 2 3 for a definition of GET G The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile The GetRSStatus method must first poll for reloading then poll for ready while the GetRemoteServicesAP Status can just poll for ready H ENUMERATE the DCIM_VirtualDiskView class to ensure successful virtual disk deletion See section 2 2 for a definition of ENUMERATE Confirm successful execution of the method by listing the virtual disks The deleted virtual disk should not be displayed 14 15 Delete all virtual disks and unassign all hotspares View the RAID stacking workflows in Section 4 for a comprehensive example 14 16 Convert physical disks to RAID state The ConvertToRAID method is used to convert a physical disks in Non RAID state to a state usable for RAID After the method is successfully executed the PendingValue property of RAIDPDState should reflect the pending changes After the CreateTargetedConfigJob method is successfully executed the DCIM_PhysicalDiskView RAIDStatus property of that physical disk should reflect the new state One can expect this operation to take up to 15 minutes depending on system configuration Applies
194. us GetPhysicalDiskViews ENUMERATE the DCIM_PhysicalDiskView class to view all available physical disk FQDDs See section 2 2 for a definition of ENUMERATE Note the new value of the RaidStatus parameter of the desired physical disk 15 Record Log Profile Use Cases 15 1 Discovery of Record Log profile support Use the following procedure below to confirm the existence of Record Log profile support Applies to LC1 5 0 Prerequisites for script none Script GetRecordLogProfile win A The Lifecycle Controller remote service must be in a ready state before executing any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile GetLCRegisteredProfiles ENUMERATE the DCIM_LCRegisteredProfile class to view all registered profiles See section 2 2 for a definition of ENUMERATE Search for RegisteredName Record log and note its instancelD to use in step D GetLCRegisteredProfile GET the DCIM_LCRegisteredProfile instance using the InstancelD from C See Section 2 3 for a definition of GET Results for the InstancelD of DCIM RecordLog 1 0 0 shown below If no instance is returned the profile is not supported DCIM_LCRegisteredProfile AdvertiseTypeDescriptions WS Identify Advertise TypeDescriptions Interop Namespace AdvertiseTypes 1 AdvertiseTypes 1 98 LC Integration Best Practices S
195. very of Video profile support ssssssssssssssssessssssesssessssesssssssssseesssesseeseeee 118 Inventory Of vid o i SYSTEM 5 cis ice enie bee vive ved e vee ive otis vedas eni erii aeni vane see ee 119 Get the first video instance s inforMatiOn scecceccecceccencencenceccencenceeseesenees 119 License Management Profile Use Cases ccscecccccscceccencencenceceencenceneeeeeesennens 119 Discovery of License Management profile support ccc ece eee e eee eeeeeeeeeeeeeeeeenees 119 Power Supply Profile US Cases icc ccsceseeeetegeved dacs vad okdasgied E ead EE ETE sutgeee 120 Discovery of Power Supply profile SUPPOFt cece ece eee eect eee ee eee eee eee eeeeeeeneees 120 Inventory of power supplies in SYSCEM cceccescceeceesceeseeenceenseeseeesseesseesseeesees 121 Get the first power Supply s information cesceecccccccecceccencecceccenceaceaseusenees 122 Get MAC INfOFMALION seriene onsena oia e a on i e aa 122 Get blade power Soeren noioa g aaa REANA EENAA E AE OEE AEO ENEE 122 System nfo Pronte Use Cases urrena ss enaA NANA ENEAN Cine ks 123 Discovery of System Info profile support sssssssssessssossssssssooosesssssoossssssesosssses 123 Inventory Of system INFO VIEW nenrene niinn anA RA AENEA EA Naa 124 Get the first system info view s information ssssssssesesssesesesesececesesceeeeseseseeeee 124 Inventory of all system attributes in system
196. w are Windows winRM and Linux wsman examples that apply all the iDRAC attributes Replace IP_ADDRESS USER_NAME and PASS_WORD with the actual IP address username and password winRM format 22 LC Integration Best Practices Specification winrm i ApplyAttributes http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM iDRACCardService SystemCreationClassName DCIM C omputerSystem CreationClassName DCIM iDRACCardServicetSystemName DCIM C omputerSystem Name DCIM iDRACCardService u USER NAME p PASSWORD r https IP_ADDRESS wsman SkipCNcheck SkipCAcheck encoding utf 8 a basic timeout 120000 file iDRAC Embedded 1 setatts xml WSMAN format wsman invoke a ApplyAttributes h IP ADDRESS P 443 u USER NAME p PASSWORD N root dcim c gr2host cert y basic http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM iDRACCardService SystemCreationClassName DCIM _ ComputerSystem SystemName DCIM ComputerSystem CreationClassName DCI M iDRACCardService Name DCIM iDRACCardService t 120000 J iDRAC Embedded 1_setatts xml Partial Example of iDRAC Embedded 1_setatts xml 3 3 lt p ApplyAttributes INPUT xmins p http schemas dmtf org wbem wscim 1 cim schema 2 root dcim DCIM iDRACCardService gt lt p Target gt iDRAC Embedded 1 lt p Target gt lt p AttributeName gt Info 1 Product lt p AttributeName gt lt p A
197. wns 151 Check refreshed data sas csvesssesnvesvs cevesues sews onves ue seas sone EN ENEE samerneesesa see ee 151 CSIOR ici vskieuds cntearee ends cnmeennerieeseed saeeeies evel T aeeeEeR eee eaeNeD 151 iSCSI b ot INTOFMALION iis csicavaccsccmscscsrcscsecasdsvecanoenssanasceseegaanseecancehaacaeeeeeses ten 151 Generational NOMENClAtUlE sicsscenicerescsccesaneeecveceaecehucnaastesaaeneaw tans geseraanmeadswcesacies 15 10 LC Integration Best Practices Specification Figures Figure 1 Typical Life Cycle of an 11G LC1 5 0 amp LC1 5 1 Configuration Job cece ee eee 16 Figure 2 Typical Life Cycle of a 12G Configuration Job ssssessssossssesesoosssessesosesesesesossses 17 Fisure3 Compatibility with 11G WorktlowS sisciccsssescanaiscsscessuedaaies cesaaendan sendsaulevaansasidaeceneces 18 Figure 4 Software Inventory Instance Diagram 11 LC Integration Best Practices Specification 1 Contents 1 1 How to use this document This document contains the detailed steps of common workflows to perform various tasks utilizing winRM or WSMAN The PYTHON scripting language was used to provide a software development kit SDK for Lifecycle Controller LC API methods Two primary objectives are addressed first that workflows documentation provides guidance to established known working API methodologies and second that corresponding PYTHON sample scripts are separately provided After invoking these scripts the output l
198. xecuting any other WSMAN commands The GetRSStatus method or the GetRemoteServicesAPIStatus method may be used depending on the version of the LC Management registered profile NOTE GetRemoteServicesAPIStatus will return not ready if drivers or an ISO is already attached B DetachDrivers Ensures any drivers are detached C DetachlSOlmage Ensures all images are detached D GetDriverPacklInfo Displays available OS drivers This is only required for end to end OS deployment E UnpackAndAttach Unpacks and attaches desired driver pack The resulting concrete job is invoked immediately This is only required for end to end OS deployment F Poll concrete job until Success G BootToNetworkISO The resulting concrete job is invoked immediately H Poll concrete job until Success NOTE OS is still booting at this point so sleep to allow completion Steps I through J are providing when the BootToNetwork image is no longer desired I DetachDrivers ReturnValue 0 J DetachlSOlmage ReturnValue 0 35 LC Integration Best Practices Specification 4 4 K RequestMonoSystemStateChange ReturnValue 0 NOTE Modular systems i e M610 M710 etc use RequestModSystemStateChange Boot to ISO from vFlash This workflow boots the host system from an ISO image located on the vFlash The workflow first removes any existing driver packs or existing attached OS then gets availabl

Dell Lifecycle Controller 1.5 Practices Guide

Contents

Download Pdf Manuals

Related Search

Related Contents