Dell Lifecycle Controller 2 Remote Services Version 1.00.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates potential damage to hardware or loss of data if instructions are not followed. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Information in this publication is subject to change without notice. © 2012 Dell Inc. All rights reserved.
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Introduction..................................................................................................................................9 Benefits of Using iDRAC7 With Lifecycle Controller.................................................................................................9 Key Features..................................................................
Replacing a License................................................................................................................................................22 Deleting a License..................................................................................................................................................22 Exporting a License.................................................................................................................................................
References For Configuring RAID....................................................................................................................44 Converting a SATA Drive from RAID Mode to a Non-RAID State..........................................................................45 References For Converting a SATA Drive........................................................................................................45 9 Managing Network Devices.......................................................
References For Exporting Server Profile..........................................................................................................63 Importing Server Profile From iDRAC vFlash Card or a Network Share.................................................................63 Post-restore Scenario......................................................................................................................................64 System or Feature Behavior For Post-Restore Scenario....................
Simple NIC Methods........................................................................................................................................83 BIOS and Boot Management Profile......................................................................................................................84 BIOS and Boot Management Methods............................................................................................................85 Persistent Storage Profile.................................
Introduction 1 The Dell Lifecycle Controller provides advanced embedded systems management. It includes a 1 GB managed and persistent storage that embeds systems management features in addition to the iDRAC features. The Dell Lifecycle Controller Remote Services further enable remote systems management in a one-to-many method. Remote Services is available using Web Service for Management (WS-Management) protocol based Web services interface for remote server provisioning and management through the iDRAC.
• Get and set NIC/CNA and RAID configuration • Get and set BIOS configuration and BIOS passwords • Export lifecycle log • Export current and factory shipped hardware inventory log • Manage, attach, and boot to vFlash SD card partitions • Enable encryption on the controller using local key and lock the virtual disks.
Web Services for Management WS-Management is a Simple Object Access Protocol (SOAP)-based protocol designed for systems management. It is published by the Distributed Management Task Force (DMTF) and provides an interoperable protocol for devices to share and exchange data across networks. The Lifecycle Controller Remote Services WS-Management implementation complies with the DMTF WS-Management specification version 1.0.0.
• SMASH Collections Profile — Defines the collections that support Systems Management - Command Line Protocol (SM-CLP) target addressing. • Dell RAID Profile — Describes the classes, properties and methods for the representation and configuration of RAID storage. • Dell Simple NIC Profile — Describes the classes, properties and methods for the representation and configuration of the NIC and CNA network controllers.
• The Systems Management Overview Guide provides brief information about the various software available to perform systems management tasks. • The Integrated Dell Remote Access Controller 7 (iDRAC7) User’s Guide provides information about configuring and using an iDRAC7 for rack, tower, and blade servers to remotely manage and monitor your system and its shared resources through a network.
3. If you are not a U.S. customer, select your country code at the bottom of the support.dell.com page, or select All to see more choices. 4. Select the appropriate service or support link based on your need.
Using Remote Services 2 This section describes some of the prerequisites that helps you get started with the Remote Services functionality and use the new features effectively, for better results. Common Prerequisites Before Using Remote Services To successfully perform remote operations on the server, make sure that the following prerequisites are met: • Lifecycle Controller 2 version 1.00.00 is installed. • iDRAC7 firmware version 1.00.00 • Latest BIOS version is installed.
OpenWSMan Client The OpenWSMan client is the WS-Management CLI that is part of the open-source project Openwsman. To download, build, install, and use the WS-Management CLI and OpenWSMan packages from sourceforge.net, see openwsman.org for download links. NOTE: You must configure the client for the connection. For configuration details, see the Lifecycle Controller Web Services Interface Guide–Linux version.
Auto-discovery and Handshake 3 The Auto-discovery feature in iDRAC allows newly installed servers to automatically discover the remote management console that hosts the Provisioning Server. The Provisioning Server provides custom administrative user credentials to the iDRAC so that the management console can discover and manage the newly installed managed system.
The Remote Enablement page is displayed. 9. Under Enable Auto-Discovery, select Auto-Discovery. NOTE: You must disable administrator account to activate Auto-discovery feature. 10. In the Provisioning Server box, enter the provisioning server IP address or host name string.
1. Connect the system to the network. 2. Turn on the managed system. The system performs the following operations: – iDRAC starts, acquires the Provisioning Server IP addresses or host names from DHCP/DNS and announces itself to the Provisioning Server. – The Provisioning Server validates and accepts the secure handshake session from the iDRAC. – The Provisioning Server provides custom user credentials with administrator privileges to iDRAC. – iDRAC receives and completes the secure handshake.
• Whether Auto-discovery runs immediately or after the next AC power cycle. This is a required input. • Provisioning Server IP address or host name. This is optional. For example, you must reinitiate Auto-discovery to move the managed system from one data center to another. The auto-discovery settings are persisted along with the credentials used for discovery.
Managing Licenses 4 You can manage the licenses to enable or disable the various systems management features. Using Remote Services, you can: • Get a list of installed licenses • Get a list of licensable devices • Install or delete a license • Export the license Displaying Installed Licenses • Perform the Enumerate operation on the DCIM_License class to display the instance properties of all the Licenses installed on the system.
– Invoke the ImportLicense() method. Install using ImportLicenseFromNetworkShare() method: 5. – Use the network share parameters and the licensable device FQDD to prepare the input parameters. – Invoke the ImportLicenseFromNetworkShare() method. – Perform the Get operation on DCIM_LifecycleJob class using the returned job ID as the instance ID to view the status of the import license job.
• ExportLicenseByDevice() — This method exports all licenses installed on a licensable device. The licenses are an output parameter of the method and are base64 encoded. • ExportLicenseByDeviceToNetworkShare() — This method exports all the licenses installed on a licensable device to an NFS or CIFS network share. NOTE: If multiple licenses are exported from a single licensable device, the file names are suffixed with a _0.xml, _1.xml, _2.xml, and so on.
Managing Certificates 5 Use the certificate management feature to transfer custom-defined certificates to iDRAC7 and create a unique certificate based on the service tag of a system to enhance the security. While placing the order, you can request Dell to factory preset the system with the certificate of your choice using the Custom Factory Install (CFI) process available from Dell.
Custom Client Certificate Deletion Use the DeleteAutoDiscoveryClientCerts() method on the DCIM_LCService class to delete a client certificate and private key. Changing the Web Server or WS-Management Encryption Certificate and Private Key from PKCS #12 To change the certificate and key: 1. Generate a CSR and private key. The CSR needs to be signed by a CA. 2. Combine the certificate with the private key then encrypt it into a PKCS#12 file. 3.
Table 2. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) - 12.10 — Set iDRAC Certificate and Private Key Profiles DCIM_LCManagement Profile MOFs DCIM_LCService.mof Managing Directory CA Certificate Need to upload the trusted root CA certificate to authenticate Active Directory or LDAP sessions.
Deploying the Operating System 6 The operating system deployment capabilities enable deployment of an operating system remotely using WSManagement web services protocols and CIFS and NFS network file sharing protocols. Detailed interface specifications and class definition (.mof) files at the Lifecycle Controller section on the Dell Enterprise Technology Center at delltechcenter.com.
3. Depending on where the operating system image is hosted, use one of the following methods to attach the ISO to the local server and reboot to it immediately. – BootToNetworkISO() — If the operating system image (.iso format) is hosted in a network share (NFS or CIFS), use this method to attach the network ISO as virtual USB CD-ROM device to the server and immediately boot to it to start the operating system installation. – BootToISOFromVFlash() — If the operating system image (.
Step Number • Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) DCIM_LCRegisteredProfile.mof Copying OS Drivers to Network Share To copy the operating system drivers from Lifecycle Controller to a network share: 1. Invoke the GetDriverPackInfo() method to list the supported operating systems on the server and the Driver Pack version installed on Lifecycle Controller. 2.
Table 6. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) step 1 11.3.18 - Connect RFS ISO Image step 2 11.3.20 - Get RFS ISO Image Connection Information step 3 11.3.19 - Disconnect RFS ISO Image Profiles DCIM_OSDeployment Profile MOFs • • • • DCIM_OSDeploymentService.mof DCIM_OSDConcreteJob.mof DCIM_LCElementConformsToProfile.mof DCIM_LCRegisteredProfile.
Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) 11.3.15 — Disconnect Network ISO Image step 2 11.3.17 — Get Network ISO Image Connection Information step 3 11.3.15 — Disconnect Network ISO Image step 4 11.3.16 — Skip ISO Image Boot Profiles DCIM_OSDeployment Profile MOFs • • • • DCIM_OSDeploymentService.mof DCIM_OSDConcreteJob.mof DCIM_LCElementConformsToProfile.mof DCIM_LCRegisteredProfile.mof Boot to ISO Methods Comparison Table 8. .
Steps BootToNetworkISO NOTE: Subsequent host reboot does not automatically boot to the ISO Image unless the device (ISOIMG) is set as the first device in BIOS boot list. This is applicable only when the ISO is attached and the time has not expired or ISO is not detached explicitly. BootToISOFromVFlash ConnectNetworkISOIm ConnectRFSISO age NOTE: Whenever the host system reboots, BIOS will boot to this device (ISOIMG) irrespective of its boot order.
failed. If a job failure occurs, the job instance also contains an error message property that provides detailed information on the nature of the failure. Other properties contain other error identification information that can be used to localize the error message to the supported languages and get more detailed error descriptions and recommended response action descriptions.
7 Managing Jobs Remote Services provides the following functionalities to manage Lifecycle Controller jobs: • Creating Jobs — Create specific types of jobs to apply configurations. • Scheduling Jobs and Job Queues — Run multiple jobs in a single reboot of the system using the SetupJobQueue() method on the DCIM_JobService class. If you create a job using the CreateTargetedConfigJob() method without setting the start time, use the SetupJobQueue() method to set the schedule and order of execution.
User Created Jobs The following are the user created jobs: • • • CreateTargetedConfigJob — This method is used while configuring RAID, NIC, BIOS, iDRAC, and System. Use this method to commit the configuration changes and create a job to apply the configuration changes. CreateRebootJob — This method is used to create reboot jobs. InstallFromURI — This method is used to update the firmware for BIOS, RAID, NIC, iDRAC, PSU, Lifecycle Controller, OS driver packs, and Diagnostics.
1. Configuring Integrated NIC 1: Set the NIC attributes for Integrated NIC 1 and create a targeted configuration job for Integrated NIC 1 with a scheduled start time of TIME_NOW, but make sure not to schedule a reboot. 2. Configuring Integrated NIC 2: Set NIC attributes for Integrated NIC 2 and create a targeted configuration job for Integrated NIC 2 with a scheduled start time of TIME_NOW, but make sure not to schedule a reboot. 3.
Managing RAID Configuration 8 Use the RAID configuration feature to get the properties of the RAID controller, physical disks, and the enclosures attached to the system. You can configure different attributes of the physical and virtual disks using the available methods. Displaying the RAID Controllers • Perform the enumerate operation on the DCIM_ControllerView class to display the instance properties of all the RAID controllers attached to the system.
• Storage controller — PERC • Physical disks (SEDs) — 4 • Size of each physical disk — 1 TB Create the following RAID configuration: • Size of each virtual disk: 10 GB (10240 MB) • Number of virtual disks — 10 • RAID level — 5 • Dedicated hot spare — 1 • Enable encryption on the controller and create a local key To configure RAID: 1. Get the list of storage controllers attached to the system and their properties.
Parameter Value NOTE: Alternatively, set the Starting LBA to "0xFFFFFFFFFFFFFFFF", then the starting location of the slice is automatically calculated to be immediately after the end of the last slice. Stripe Size The stripe element size is the amount of disk space a stripe consumes on each physical disk in the stripe. You can set the following values in bits: NOTE: The S110 and H310 controllers support only 64KB stripe size.
RAID Setup-Post Configuration Scenario 1. Get the job status using the job ID generated earlier. 2. To check if the RAID configuration and the local key based controller encryption enablement are successful, you must verify if the system automatically boots to Lifecycle Controller and applies the RAID configuration change and the local key. 3. Get the job status using the job ID generated earlier for which this status message is returned Job completed successfully. 4.
Converting a SATA Drive from RAID Mode to a Non-RAID State To successfully perform remote operations on the server, make sure that the following prerequisites are met: • Common Prerequisites Before Using Remote Services. • PERC S110 or H310 controllers that supports non-RAID mode. • SATA or SSD Hard Drives To convert the RAID drive to a non-RAID SATA drive: 1. Get the list of storage controllers attached to the system and their properties. 2.
Managing Network Devices 9 Use the network management feature to get a detailed list of the following network devices in the system and set their attributes: • Network Interface Cards (NICs) • Converged Network Adapters (CNAs) • LAN On Motherboards (LOMs) • Network Daughter Cards (NDCs) • Mezzanine cards (for Blade servers only) For more information on the Simple NIC profile, see the Simple NIC Profile.
NOTE: The system must reboot to execute the task of setting the attribute or attributes. 8. Query the status of the job ID output using the job control profile methods. 9. Repeat step 5 to confirm successful execution of the method. Deleting the Pending Values To delete the pending values: 1. Before invoking the DeletePendingConfiguration() method in DCIM_JobService class, construct input parameters and use the correct Fully Qualified Device Descriptor (FQDD) of the Network Device.
Changing the Personality and Bandwidth of a Partition for a CNA To successfully perform remote operations on the server, make sure that the prerequisites provided in the Common Prerequisites Before Using Remote Services are met. Partition a port and assign the personality and bandwidth on a Converged Network Adapter card with a 10Gb ethernet link with multiple personality support. The following personality and bandwidth must be set up: Table 12.
10. You can query the status of the job ID output using the job control profile methods. 11. Repeat step 4 to confirm successful execution of the method. References For Changing Personality NOTE: The sections referenced in this table contain only generic examples. Table 13. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) step 1 15.1 — Listing the CNA Inventory-Enumeration Class step 2 15.14 — Setting CNA LAN Modes step 4 15.
References For Virtual Address Attributes NOTE: The sections referenced in this table contain only generic examples. Table 14. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) - 15.
• 52 To configure FCoE boot target, set appropriate values for each of the following: – MTUParams – ConnectFirstFCoETarget – FirstFCoEWWPNTarget – FirstFCoEBootTargetLUN – FirstFCoEFCFVLANID
Inventory and Logs 10 Use the inventory and log features to: • Retrieve and export current and factory-shipped inventory • Retrieve and export lifecycle log • Reset the system Retrieving Hardware Inventory Using Remote Services, you can instantly retrieve the hardware inventory of a system. The inventory has a list of all the hardware devices installed on the system.
NOTE: Lifecycle log is available even if the OS is not installed on the system and is independent of the power state of the system. Exporting Lifecycle Log Use this feature to export the Lifecycle Log information to an XML file. Store the XML file on an USB Device or network share, or both the locations. To export the lifecycle log, invoke the ExportLCLog() method on the DCIM_LCService class. For more information on the schema, see Lifecycle Log Schema.
Remote Updates 11 Use remote update and firmware inventory feature to perform operating system agnostic update and retrieve firmware inventory. Using Remote Update Remote update, also known as out-of-band update or operating system-independent platform update, allows you to update the system independent of the state of the operating system. You can initiate the firmware update regardless of the system state (power on or off state.
• Diagnostics Remote Update From URI To perform remote update using URI: 1. Use the appropriate WS-Management client to send a method invocation request to the iDRAC IP address. The WS-Management command includes the InstallFromURI() method on the DCIM_SoftwareInstallationService, and the location from where iDRAC should download the Dell Update Package (DUP). The download protocols supported are FTP, HTTP, CIFS, NFS, and TFTP.
Rolling Back to Previous Versions Use the InstallFromSoftwareIdentity() method to reinstall from previous versions of firmware that is stored in the Lifecycle Controller. Instead of downloading the DUP, the InstallFromSoftwareIdentity() creates a job and returns the job ID. NOTE: Lifecycle Controller, Diagnostics, and Driver Pack updates cannot be rolled back.
1. Enumerate the class DCIM_SoftwareIdentity to retrieve the inventory of the system. The inventories are collected as Installed and Available CIM instances. NOTE: Users that have administrator or Execute Server Command privileges can retrieve the firmware and embedded software inventory of the system. NOTE: Inventory instances are pulled up from the system in both system-off and system-on conditions. – The software currently installed on the component is listed as the Installed Software Instance.
Setting the Scheduling Reboot Behavior The CreateRebootJob() method takes one of the following reboot types as an input parameter and a reboot job ID is returned as an output parameter. The reboot Job ID is used as the last Job ID in the JobArray parameter of the SetupJobQueue() method along with other update Job IDs. • Reboot 1 - Power cycle — Performs the power cycle of the managed server that powers down the system and powers it up. This is not a graceful reboot.
Invoke the SetAttribute() method on the DCIM_LCService class to set the attributes. The SetAttribute() method takes as input parameters the property names and values. The table lists the values of the part firmware and configuration update. Options Values Part Firmware Update Allow version upgrade only If the input for the CurrentValue is Allow version upgrade only, firmware update on replaced parts is performed if the firmware version of the new part is lower than the original part.
Backup and Restore 12 Use the export and import feature to backup, export, or restore a server profile. Exporting Server Profile to iDRAC vFlash Card or Network Share To successfully perform remote operations on the server, make sure that the following prerequisites are met: • Common Prerequisites Before Using Remote Services. • iDRAC7 Enterprise license is installed.cccc • Server has a valid 7 character service tag. • The destination location has read or write access.
• If you do not use the ScheduledStartTime parameter, it returns a job ID, but is not scheduled. To schedule the job, invoke the SetupJobQueue() method on DCIM_JobService class. • You can cancel an export job before it starts using the DeleteJobQueue() method on DCIM_JobService class. After the job starts, press F2 during POST and select Cancel Lifecycle Controller. This initiates the recovery process and puts the system into a previously known state. Recovery is within 5 minutes.
References For Exporting Server Profile NOTE: The sections referenced in this table contain only generic examples. Table 15. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) step 1 18.1 — Export Server Profile step 2 18.1.1 — Export Server Profile to iDRAC vFlash Card-BackupImage() 18.1.2 — Export Server Profile to a NFS Share-BackupImage() 18.1.3 — Export Server Profile to a CIFS Share-BackupImage() step 3 18.1.
• After operating system deployment using Lifecycle controller, the OEMDRV is open for 18 hours. If you need to perform the operations such as update, configuration, or import after operating system deployment, you must remove the OEMDRV partition. To remove the partition, reset iDRAC or cancel Lifecycle Controller. • For the import WS-Management commands, if you do not use the ScheduledStartTime parameter, it returns a job ID, but is not scheduled. To schedule the job, invoke SetupJobQueue() method.
System or Feature Behavior For Post-Restore Scenario • During import, Lifecycle Controller is not available. • Import restores everything that was backed up. • Import may take up to 60 minutes depending on the server configuration. • Import does not restore diagnostics or driver pack information. • By default, import preserves the current virtual disk configuration.
Managing vFlash SD Card 13 vFlash service is a licensed feature. The vFlash SD card is a Secure Digital (SD) card that plugs into the vFlash SD card slot on the managed system. You can use a card with a maximum of 16 GB capacity. After you insert the card, you must also enable vFlash service to create and manage partitions. For more information on the vFlash SD card, see the Persistent Storage ProfilePersistent Storage Profile.
iDRAC Configurations 14 Use the feature to configure iDRAC attributes. Getting and Setting iDRAC Attributes To successfully perform remote operations on the server, make sure that the prerequisites provided in the Common Prerequisites Before Using Remote Services section are met. To get and set iDRAC attributes: NOTE: A reboot is not required after setting iDRAC configuration. 1.
Step Number • • • • Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) DCIM_iDRACCardInteger.mof DCIM_iDRACCardService.mof DCIM_iDRACCardString.mof DCIM_iDRACCardView.mof iDRAC Attributes Using Remote Services, you can set the iDRAC attributes listed in the following tables. Table 18. LAN Attributes Attribute Description Values VLAN Enabled Indicates the VLAN mode of operation and parameters. When VLAN is enabled, only matched VLAN ID traffic is accepted.
Attribute Description Value Confirm Password Re-enter the iDRAC user's password to confirm. Maximum of 20 characters Account Privilege Assigns the user's maximum privilege on the IPMI LAN channel to the user groups. Admin, Operator, User, or No Access Smart Card Authentication Smart Card authentication for iDRAC log in. If Enable, Disable, or Enable with RACADM enabled, install a Smart Card is installed to access the iDRAC. Table 20.
Attribute Description Values You can edit the name string when Register iDRAC Name is set to No. Domain Name from DHCP iDRAC acquires the domain name from the DHCP server. If set to No, you must enter the domain name manually. Yes or No Domain Name To view or edit the iDRAC domain name used Enable or Disable if it is not acquired from DHCP. You can specify a domain name when Domain Name from DHCP is set to No. Host Name String To specify or edit the host name associated with iDRAC.
Table 23. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) step 2 5.2.1 Account and Capabilities (using iDRAC Attributes) step 3 5.3.1 Modify User Name (using iDRAC Attributes) step 4 5.2.1 Account and Capabilities (using iDRAC Attributes) Profiles DCIM_iDRACCardProfile MOFs • • • • • DCIM_iDRACCardEnumeration.mof DCIM_iDRACCardInteger.mof DCIM_iDRACCardService.mof DCIM_iDRACCardString.mof DCIM_iDRACCardView.
Table 24. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) - 19.9.1 — Getting the Current iDRAC IPChange State 19.9.2 — Setting the iDRAC IPChange Notification-SetAttribute() Profiles DCIM_iDRACCardProfile MOFs • • • • • 74 DCIM_iDRACCardEnumeration.mof DCIM_iDRACCardInteger.mof DCIM_iDRACCardService.mof DCIM_iDRACCardString.mof DCIM_iDRACCardView.
Managing BIOS and Boot Configuration 15 Use the BIOS and boot configuration feature to configure BIOS properties and to perform operations such as changing the boot source and boot order. For more information, see the BIOS and Boot Management Profile. Displaying the Inventory of BIOS Attributes Perform the Enumerate operation on one of the DCIM_BIOSInteger, DCIM_BIOSEnumeration, DCIM_BIOSPassword, and DCIM_BIOSString classes to view all available instances of the BIOS attributes in a system.
5. Examine output parameters. 6. Before invoking the CreateTargetedConfigJob() method, prepare input parameters (for example, RebootJobType, ScheduledStartTime, UntilTime, Job, and so on) and use the correct BIOS FQDD. 7. Invoke the CreateTargetedConfigJob() method. NOTE: The system must reboot to execute the task of setting the attribute or attributes. 8. Query the status of the job ID output using the job control profile methods. 9. Repeat step 2 to confirm successful execution of the method.
References For Setting Modifying and Deleting BIOS Password NOTE: The sections referenced in this table contain only generic examples. Table 25. Step Number and Location Step Number Location in Lifecycle Controller Web Services Interface Guide (Windows or Linux) step 1 17.10 Listing the BIOS Inventory-Password Class step 3 and step 4 17.9.2 — Create the Targeted Configuration Job step 5 17.9.3 — Monitor Set BIOS Password Status Profiles Dell_BIOSandBootManagement Profile MOFs DCIM_BIOSService.
Other Use Case Scenarios 16 This section provides some miscellaneous use cases. Retrieving Remote Service Status To successfully perform remote operations on the server, make sure that the prerequisites provided in the Common Prerequisites Before Using Remote Services section are met. Before performing any Remote Services operation (for example, managing NICs, managing RAID configuration, inventory, and so on), make sure that Remote Services is running, is up-to-date, and can send data.
17 Remote Services Profiles This section provides high-level information on the individual profiles and their classes and methods. For more information on the profiles and the related MOFs, see delltechcenter.com/page/DCIM.Library. For examples of WinRM and WS-Management command line invocations, see: • delltechcenter.
Table 28. Lifecycle Controller Management Profile Class Name Operations Methods DCIM_LCService Get Enumerate Invoke SetAtttribute() SetAttributes() GetRemoteServicesAPIStatus() Also see Auto-discovery Methods, Lifecycle Log Methods, and Hardware Inventory Methods. DCIM_LCString Get Enumerate NA DCIM_LCEnumeration Get Enumerate NA LC Service Methods The following methods are used to set attributes related to Auto-discovery, Part Replacement and IO Identity.
Lifecycle Log Methods • The LCWipe() method is used to wipe all configurations from the Lifecycle controller before the system is retired. • The ExportLCLog() method is used to export the log from the Lifecycle Controller to a file on a remote share. • The InsertCommentInLCLog() method is used to insert additional user comments into the Lifecycle Controller log.
• The CreateTargetedConfigJob() method is used to apply the pending values created by the SetAttribute and SetAttributes methods. After the method is successfully executed, a job is created to apply the pending attribute values. NOTE: Subsequent calls to the CreateTargetedConfigJob() method after the first CreateTargetedConfigJob() method results in an error until the first job is completed. If you invoke the CreateTargetedConfigJob() method multiple times, older requests are overwritten or lost.
BIOS and Boot Management Methods The BIOS and Boot Management methods are used to apply attributes and change the boot configurations in the system. Each method has a set of input and output parameters. The methods have specific return code values. The following methods are used under BIOS and boot management: • The SetAttribute() method is used to set or change the value of a BIOS attribute. • The SetAttributes() method is used to set or change the values of a group of attributes.
• The DeletePartition() method is used to delete a vFlash SD card partition. • The FormatPartition() method is used to format the selected vFlash SD card partition. • The ModifyPartition() method is used to modify the partitions on the vFlash. This depends on the type of partition - Floppy, Hard Disk, or CD. • The AttachPartition() method is used to attach one or more partitions as a virtual USB mass storage device.
Class Name Functions Operations Methods DCIM_EnclosureFanSen sor Use this class to display the different instance IDs and related properties of the enclosure fan. Get Enumerate NA DCIM_EnclosureTemper atureSensor Use this class to display the different instance IDs and related properties of the enclosure fan. Get Enumerate NA RAID Methods The RAID methods are used to apply attributes to different RAID components. Each method has a set of input and output parameters.
• • The CreateVirtualDisk() method is used to create a virtual disk on the target controller. This method can also be used to do the following: – Create sliced virtual disk. A sliced virtual disk is created, if CreateVirtualDisk() Size input parameter value is less than total size of the set of physical disks. Additional sliced virtual disks can be created using the same set of physical disks and same RAID level that was used to create the first virtual disk.
Class Name Functions DCIM_PowerSupplyView Use this class to get the instance information of all the power supply units available in the system. Operations Methods Get Enumerate NA Get Enumerate NA System View Profile DCIM_SystemView Use this class to get the general details about the system such as System Manufacturer, Model, Service Tag, Total Memory, BIOS Version, System ID, Asset Tag, Power State, and so on.
Table 36. Power State Management Profile Class Name Operations Methods DCIM_CSPowerManagementServi ce Get Enumerate Invoke See Power State Management Profile Methods DCIM_CSPowerManagementCapa bilities Get Enumerate NA DCIM_CSAssociatedPowerManag ementService Get Enumerate NA Power State Management Profile Methods The method is used to get the status of the change in power state. • The RequestPowerStateChange() method is invoked to get the Pending Power State Change.
Class Name Operations Methods DCIM_Role Get Enumerate NA DCIM_IPMIRole Get Enumerate NA DCIM_IPMISOLRole Get Enumerate NA DCIM_CLPRole Get Enumerate NA DCIM_LocalRoleBasedAuthorizatio Get Enumerate nService NA DCIM_IPMIRoleBasedAuthorizatio nService Get Enumerate See Role Based Authorization Profile Methods DCIM_CLPRoleBasedAuthorization Get Enumerate Service See Role Based Authorization Profile Methods DCIM_LocalRoleBasedManageme ntCapabilities Get Enumerate NA DCIM_IPMIRoleBasedMa
Table 40. Service Processor Profile Class Name Operations Methods DCIM_SPComputerSystem Get Enumerate Invoke See Service Processor Profile Methods DCIM_TimeService Get Enumerate Invoke See Service Processor Profile Methods Service Processor Profile Methods The methods are used to manage service processor. • The RequestStateChange() method is used to reset the iDRACs state to the value specified in the RequestedState parameter.
• The ImportLicenseFromNetworkShare() method is use to import the License given in the location of the share. • The DeleteLicense() method is used to delete assigned licenses. • The ExportLicense() method is used to export License files from iDRAC. • The ExportLicenseByDevice() method is used to export License files from iDRAC. • The ExportLicenseToNetworkShare() method is used to export License files from iDRAC.
Class Name Operations Methods DCIM_Chassis Get Enumerate NA Base Server and Physical Asset Profile Methods The methods are used to perform basic server management tasks. • The RequestStateChange() method is used to change the state of a component to one of these values: Enabled, Disabled, Reset. System Info Profile The following table lists the classes, functions, operations, and methods under the System Info Profile. Table 45.
Class Name Operations Methods DCIM_SerialIdentity Get Enumerate NA DCIM_CLPIdentity Get Enumerate NA DCIM_LocalUserAccountManage mentService Get Enumerate NA DCIM_IPMIAccountManagementS Get Enumerate ervice NA DCIM_CLPAccountManagementSe Get Enumerate rvice NA DCIM_LocalUserAccountMangem entCapabilities Get Enumerate NA DCIM_IPMICLPAccountMangemen Get Enumerate tCapabilities NA DCIM_RegisteredProfile Get Enumerate NA DCIM_LCRegisteredProfile Get Enumerate NA Simple Identity Method
18 Troubleshooting and Frequently Asked Questions Error Messages For more information on the error message IDs and the recommended actions, see Dell Lifecycle Controller Remote Services Error Messages and Troubleshooting List on support.dell.com/manuals. To view the error message and related information, select the error message ID from the Error Message ID drop-down list. Additionally, you can download the detailed error message registry from delltechcenter.com/page/Lifecycle+Controller.
Message 2 Resolutions No Service Tag Boot the server. If the problem persists, contact technical support. SSL connection failed no service at IP/ port Check the value of psinfo in the BIOS, or vendor option on the DHCP server. SSL Connection refused Check the value of psinfo in the BIOS, or vendor option on the DHCP server. SSL connection failed (server authentication) The server certificate is invalid or not signed by the trusted server CA certificate installed on iDRAC.
For Lifecycle Controller, press during startup. In the Lifecycle Controller GUI, click Platform Update and select devices to update. For more information on Remote Services, see the Lifecycle Controller Web Services Interface Guide–Windows and Linux version. 7. What do I do when a fatal error occurs followed by a red screen? Perform a cold reboot (AC power cycle) of the system when the red screen is displayed. 8.
You can set only one attribute through the SetAttribute() method. To set two or more attributes in one method invocation, use the SetAttributes() method on the services for the component being configured. 22. Why do I see some other attributes being set when a different attribute is set? There are few attributes in BIOS and NIC that have dependencies. When you set a specific attribute, all the dependent attributes are modified based on their dependency. This is an expected behavior.
Schema 19 This section displays a typical schema for lifecycle log. Lifecycle Log Schema PAGE 102
Easy-to-use System Component Names 20 The following table lists the Fully Qualified Device Descriptor (FQDD) of the system components and the equivalent easyto-use names. FQDD of System Component Name Easy-to-use Name RAID.Integrated.1 Integrated RAID Controller RAID.Embedded.1-1 Embedded S110 RAID Controller RAID.Slot.1-1 RAID Controller in Slot 1 NIC.Mezzanine.1B-1 NIC in Mezzanine NIC.Mezzanine.1C-1 NIC.Mezzanine.1C-2 NIC.Mezzanine.3C-2 NIC.Integrated.1 NIC.Integrated.
FQDD of System Component Name Easy-to-use Name Floppy.iDRACVirtual.1-1 Virtually connected floppy drive Disk.iDRACVirtual.1-1 Virtually connected disk Floppy.vFlash. vFlash SD Card Partition 2 Disk.vFlash. vFlash SD Card Partition 3 iDRAC.Embedded.1-1 iDRAC System.Embedded.1-1 System HardDisk.List.1-1 Hard Drive C: BIOS.Embedded.1-1 System BIOS BIOS.Setup.1-1 System BIOS Setup PSU.Slot.1 Power Supply 1 Fan.Embedded.1 Fan.Embedded.2 Fan 1 Fan 2 System.Chassis.
