Dell Lifecycle Controller Remote Services (LC RS) Version 2.00.00.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Copyright © 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 Introduction........................................................................................................... 5 Benefits of using iDRAC with Lifecycle Controller...............................................................................5 Key features........................................................................................................................................... 6 What’s new in this release?....................................................................
Server license — import.................................................................................................................19 Auto discovery............................................................................................................................... 19 Deleting server-related information using Lifecycle Controller .................................................19 Managing the web server certificate..............................................................................
Introduction 1 The Dell Lifecycle Controller provides advanced embedded systems management. It includes a 1GB– managed and persistent storage that embeds systems management features in addition to the iDRAC features. The Dell Lifecycle Controller Remote Services further enables remote systems management in a one-tomany method. Remote services is accessible over the network using the secure web services interface and can be programmatically utilized by applications and scripts.
• Increased Uptime — Early notification of potential or actual failures that help prevent a server failure or reduce recovery time after a failure. • Improved Productivity and Lower Total Cost of Ownership (TCO) — Extending the reach of administrators to larger numbers of distant servers can make IT staff more productive while driving down operational costs such as travel.
• • • • • • • View the managed system using Physical Computer System View Manage the web server certificate Configure the USB management port View embedded tech support report to resolve business-critical issues Configure storage devices in real time Replace motherboard using Import Server Profile feature Support for PCIeSSD devices What’s new in this release? The highlights of this release of Lifecycle Controller-Remote Services are: • • • • • • • • • • • • Monitor the out-of-band performance Advance se
about each manageability feature or capability. These features may be free, partially licensed, or fully licensed. Also, the accessibility of a feature is defined by the credentials provided with the WS-MAN request and maps to the user-assigned privilege credentials, such as administrator- or read-only access.
User’s Guide, available at delltechcenter.com/lc. Who can use the API? Lifecycle Controller-Remote Services features are available based on the type of license (that is, Basic Management, iDRAC Express, iDRAC Express for Blades, or iDRAC Enterprise) you purchase. Only licensed features are available in the iDRAC web interface and Lifecycle Controller-Remote Services. For more information about managing licenses, see iDRAC User’s Guide.
• The Lifecycle Controller Release Notes provides last-minute updates to the system or documentation or advanced technical reference material intended for experienced users or technicians. • The iDRAC User’s Guide available at Dell TechCenter (delltechcenter.com/iDRAC) provides information about using iDRAC web interface and RACADM.
Remote Services Features 2 Using Lifecycle Controller-Remote Services, you can perform the following operations: • • • • Deploy and Configure Monitor Maintain Create and schedule jobs Deployment and configuration Using various Lifecycle Controller-Remote Services' capabilities, you can perform different configurations on a system throughout its lifecycle. You can perform operations such as BIOS, iDRAC, RAID, and NIC configurations, and operating system deployment on the system.
• Retrieve current card configuration and iDRAC inventory • Get and set any configurable iDRAC attribute • Manage iDRAC user accounts RAID configuration The RAID configuration feature is used to manage the properties and capabilities of the RAID storage. The RAID storage is modeled using a collection of attributes, where there are collections for the enclosures, storage adapters, logical disks, physical disk drives, and PCIeSSD devices.
NIC configuration Network Interface Controller (NIC) configuration feature is used to set up or modify configuration settings for supported NIC cards (for example, Intel, QLogic, and Broadcom). These configuration settings can be set or updated both locally and remotely using Lifecycle Controller-Remote Services.
• View basic server information such as Service Tag, MAC address, NIC data, firmware versions, operating system, and so on. • View log and monitoring information of a server. • Configure network parameters of a server. After viewing or editing the information, you can troubleshoot or configure using a mobile device. To use this feature, you must install the OpenManage Mobile (OMM) software application on your mobile device and enable the bezel on the server.
• Manage the status of the server’s USB port. If the status is disabled, iDRAC does not process a USB device or host connected to the managed USB port. • Configure the USB Management Port Mode to determine whether the USB port is used by iDRAC or the operating system. • View the overcurrent alert generated when a device exceeds the power requirement permitted by USB specification. Configure the overcurrent alert to generate the WS-Events.
• BIOS • System • Sensor Lifecycle log Lifecycle logs contain entries for configuration and firmware updates of BIOS, Storage Controllers, LOMs, and add-in NIC cards, if supported. The Lifecycle log can be exported to a network share or saved to a USB drive. The Lifecycle Log is accessible through the iDRAC web interface, RACADM, and WS-MAN interface.
as reboot, power cycle, or power off the system), the action is performed. You can set only one action for an event. Embedded Tech Support Report Embedded Tech Support Report is used to provide information about health report of Hardware, Operating System (OS), and software applications installed on a server. This feature includes application information collected by Dell System E-Support Tool (DSET). This report is used by administrators to resolve business-critical issues.
Firmware update You can perform firmware updates from a network source to either update or rollback component firmware. A rollback operation is used to install the previous version of a component firmware. It also provides the ability to update using a repository and schedule automatic updates. The firmware update operations or firmware rollback operations are performed in the following order: 1. Initiate and download an image. 2. Create a reboot job. 3. Schedule an update job. 4.
Server license — import Lifecycle Controller-Remote Services can import (restore) the server license of a host system. These operations are commonly used during motherboard replacement. You can import the license that is stored on a USB drive or on the network share such as CIFS or NFS. Auto discovery The Auto Discovery feature in iDRAC allows newly installed servers to automatically discover the remote management console that hosts the Provisioning Server.
• CA certificate for Directory Service • Custom Signing Certificate To use the new certificate, restart iDRAC and a new method iDRACReset are added. For more information about managing the web server certificate, see the iDRAC Card profile document available at en.community.dell.com/techcenter/systems-management/w/wiki/1906.aspx.
partition, and so on create a job and return the job ID. Polling the job status determines the completion status of the task. • User-created jobs such as CreateTargetedConfigJob, CreateRebootJob, and InstallFromURI are used to apply user configurations for RAID, NIC, BIOS, and so on. They can be scheduled to run immediately or at a scheduled time. Table 1.
Getting started with API collateral and links 3 Getting started with any feature of Lifecycle Controller begins at the Dell TechCenter Lifecycle Controller home page — delltechcenter.com/LC. The home page contains various sections that reference URLs, and these referenced URLs are direct links to the corresponding sections. You can follow these steps to get started using the Lifecycle Controller API: 1. Identify the feature or the required management operation. 2.
Profile Name Description BIOS and Boot Management The BIOS and Boot Management Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of the system BIOS setup and to manage the boot of the system. CPU The DCIM CPU Profile describes the properties and interfaces for executing system management tasks related to the management of processors within a system.
Profile Name Description The DCIM_LCService.ImportSystemConfigurationPreview() method is used to preview the results of the application of the XML template ahead of the actual application without any restart. It also gives the information about the failure. The successful invocation of this method returns a job.
Profile Name Description Power Supply The DCIM Power Supply Profile describes the properties and interfaces for executing system management tasks related to the management of power supplies within a system. Profile Registration The DCIM Profile Registration Profile defines the classes used to describe the DCIM and DMTF profile registration and the version information of the profiles advertised as implemented for a managed system and components of the system.
Profile Name Description Simple NIC The Simple NIC Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of NIC network controllers. Virtual Address Management is supported by setting attributes of VirtMacAddr, VirtIscsiMacAddr, VirtFIPMacAddr, VirtWWN, VirtWWPN, and VirtualizationMode.
intended to allow consistent management of these managed elements, independent of their manufacturer or provider. Files that contain the normative description for classes, properties, and methods are contained within the Managed Object File (MOF). NOTE: To access the MOFs, on the Dell TechCenter (delltechcenter.com/LC) page, under Reference Specifications, click MOFs.
development kit (SDK) for the Lifecycle Controller API methods. The following primary objectives are addressed through the SDK: • Work flows documented in the Best Practices Guide provide guidance to established, known, and working API methodologies. • The corresponding PYTHON sample scripts are separately provided. After invoking these scripts, the output log can be used to provide approximate timing on a particular system configuration, as well as raw WinRM or Open-WSMAN input and output.
• Hardware Inventory • Attributes • Server Configuration Profiles NOTE: To access the Lifecycle Controller XML Schema Guide, use the link en.community.dell.com/ dell-groups/dtcmedia/m/mediagallery/20074445.aspx Authorization and licensing requirements for API access There are four levels of iDRAC licensing: NOTE: Use the link en.community.dell.com/techcenter/extras/m/white_papers/20067632.aspx to download the WSMAN License and Privilege Specification white paper.
Lifecycle Controller and iDRAC white papers To access the white papers about Lifecycle Controller and iDRAC, go to delltechcenter.com/LC.
Integrating the Lifecycle Controller API 4 This section outlines the resources required to integrate the Lifecycle Controller API into an application: • API Clients – Lists the API clients that are available to support WinRM or WSMAN. The API clients enable a you to create an application in a variety of programming languages. • Best Practices Guide — Provides information about the common work flows, where in ready-to-use Python scripts are provided for all the common work flows.
Applications using Lifecycle Controller-Remote Services The following applications use Lifecycle Controller-Remote Services • Dell Compellent | Fluid Data Network Storage Solution — compellent.com • Dell Lifecycle Controller Integration v2.0 for System Center Configuration Manager — dell.com/ support/drivers/us/en/555/DriverDetails/DriverFileFormats?DriverId=Y6J43 • Virtual Integrated System (VIS) — dell.com/content/topics/topic.
Social media reference 5 To obtain the most up-to-date information, go to the Dell TechCenter and search for the required information. Product Name and Topic Link on Dell TechCenter Lifecycle Controller http://en.community.dell.com/techcenter/systems-management/w/wiki/ 1979.lifecycle-controller.aspx integrated Dell Remote Access Controller (iDRAC) http://en.community.dell.com/techcenter/systems-management/w/wiki/ 3204.dell-remote-access-controller-drac-idrac.
Terms and definitions 6 The following table lists the terms used in this document and their definitions. Term Definition LC Lifecycle Controller Enumerate Refers to WS-MAN ENUMERATE 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 DSP0227_V1.