Dell Poweredge C4130 IDRAC 8/7 V2.30.30.30 RACADM CLI Guide User Manual I DRAC Idrac7 8 Lifecycle Controller Reference Guide4 En Us

poweredge-c4130 - iDRAC 8/7 v2.30.30.30 RACADM CLI Guide idrac7-8-lifecycle-controller-v2.30.30.30_reference-guide4_en-us

User Manual: Dell poweredge-c4130 - iDRAC 8/7 v2.30.30.30 RACADM CLI Guide

Open the PDF directly: View PDF .
Page Count: 422

Download
Open PDF In Browser	View PDF

iDRAC 8/7 v2.30.30.30 RACADM CLI Guide

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.

© 2016 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. Dell and the Dell
logo are trademarks of Dell Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of
their respective companies.
2016 - 03
Rev. A00

Contents
1 Introduction....................................................................................................................10
What’s New in This Release.............................................................................................................................................. 10
Supported RACADM Interfaces......................................................................................................................................... 11
RACADM Syntax Usage.....................................................................................................................................................11
SSH, Telnet, or Remote RACADM................................................................................................................................11
Remote RACADM....................................................................................................................................................... 12
Accessing Indexed-Based Device Groups and Objects................................................................................................12
RACADM Command Options...................................................................................................................................... 12
Using The Autocomplete Feature................................................................................................................................ 13
Supported RACADM Subcommands.................................................................................................................................14
Other Documents You May Need......................................................................................................................................16
Accessing documents from Dell support site..................................................................................................................... 17
Contacting Dell..................................................................................................................................................................17

2 RACADM Subcommand Details......................................................................................18
Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands........................................ 18
help and help subcommand...............................................................................................................................................19
arp.................................................................................................................................................................................... 19
autoupdatescheduler.........................................................................................................................................................19
cd.....................................................................................................................................................................................22
cd..................................................................................................................................................................................... 22
clearasrscreen.................................................................................................................................................................. 22
clearpending.....................................................................................................................................................................23
closessn............................................................................................................................................................................23
clrsel.................................................................................................................................................................................23
config............................................................................................................................................................................... 24
coredump......................................................................................................................................................................... 25
coredumpdelete............................................................................................................................................................... 25
diagnostics....................................................................................................................................................................... 26
eventfilters....................................................................................................................................................................... 27
fcstatistics........................................................................................................................................................................28
frontpanelerror................................................................................................................................................................. 28
fwupdate..........................................................................................................................................................................29
get................................................................................................................................................................................... 30
getconfig.......................................................................................................................................................................... 32
gethostnetworkinterfaces................................................................................................................................................ 34
getled............................................................................................................................................................................... 34
getniccfg.......................................................................................................................................................................... 35
getraclog.......................................................................................................................................................................... 36
getractime........................................................................................................................................................................ 37
getsel................................................................................................................................................................................37

3

getsensorinfo................................................................................................................................................................... 38
getssninfo......................................................................................................................................................................... 41
getsvctag......................................................................................................................................................................... 42
getsysinfo.........................................................................................................................................................................42
gettracelog....................................................................................................................................................................... 44
getversion........................................................................................................................................................................ 44
hwinventory..................................................................................................................................................................... 45
ifconfig............................................................................................................................................................................. 49
inlettemphistory............................................................................................................................................................... 50
jobqueue........................................................................................................................................................................... 51
krbkeytabupload............................................................................................................................................................... 52
lclog..................................................................................................................................................................................52
license.............................................................................................................................................................................. 55
netstat..............................................................................................................................................................................57
nicstatistics...................................................................................................................................................................... 57
ping.................................................................................................................................................................................. 58
ping6................................................................................................................................................................................ 58
RACADM Proxy................................................................................................................................................................59
racdump...........................................................................................................................................................................60
racreset............................................................................................................................................................................ 62
racresetcfg....................................................................................................................................................................... 63
remoteimage.................................................................................................................................................................... 63
rollback.............................................................................................................................................................................64
sensorsettings..................................................................................................................................................................65
serveraction..................................................................................................................................................................... 65
set....................................................................................................................................................................................66
setled................................................................................................................................................................................67
setniccfg.......................................................................................................................................................................... 68
sshpkauth.........................................................................................................................................................................68
sslcertdownload............................................................................................................................................................... 69
sslcertupload.................................................................................................................................................................... 70
sslcertview....................................................................................................................................................................... 70
sslcertdelete..................................................................................................................................................................... 72
sslcsrgen.......................................................................................................................................................................... 72
sslkeyupload..................................................................................................................................................................... 73
sslresetcfg........................................................................................................................................................................ 73
storage............................................................................................................................................................................. 74
swinventory......................................................................................................................................................................89
systemconfig....................................................................................................................................................................89
systemerase......................................................................................................................................................................91
systemperfstatistics......................................................................................................................................................... 92
techsupreport...................................................................................................................................................................92
testemail...........................................................................................................................................................................94
testtrap............................................................................................................................................................................ 94
testalert........................................................................................................................................................................... 95

4

traceroute........................................................................................................................................................................ 95
traceroute6...................................................................................................................................................................... 95
update..............................................................................................................................................................................96
usercertupload................................................................................................................................................................. 98
usercertview.................................................................................................................................................................... 98
vflashsd............................................................................................................................................................................99
vflashpartition.................................................................................................................................................................. 99
vmdisconnect................................................................................................................................................................. 100

3 iDRAC Property Database Group and Object Descriptions........................................... 102
Displayable Characters....................................................................................................................................................102
idRacInfo........................................................................................................................................................................ 104
cfgStaticLanNetworking................................................................................................................................................. 105
cfgRemoteHosts............................................................................................................................................................. 107
cfgUserAdmin.................................................................................................................................................................109
cfgEmailAlert................................................................................................................................................................... 113
cfgSessionManagement.................................................................................................................................................. 114
cfgSerial.......................................................................................................................................................................... 116
cfgOobSnmp................................................................................................................................................................... 118
cfgRacTuning...................................................................................................................................................................119
ifcRacManagedNodeOs.................................................................................................................................................. 123
cfgRacVirtual.................................................................................................................................................................. 124
cfgServerInfo..................................................................................................................................................................125
cfgActiveDirectory.......................................................................................................................................................... 127
cfgLDAP......................................................................................................................................................................... 130
cfgLdapRoleGroup.......................................................................................................................................................... 133
cfgStandardSchema....................................................................................................................................................... 134
cfgThermal..................................................................................................................................................................... 135
cfgIpmiSol.......................................................................................................................................................................135
cfgIpmiLan...................................................................................................................................................................... 136
cfgIpmiPetIpv6................................................................................................................................................................137
cfgIpmiPef...................................................................................................................................................................... 138
cfgIpmiPet...................................................................................................................................................................... 139
cfgUserDomain............................................................................................................................................................... 140
cfgServerPower..............................................................................................................................................................140
cfgServerPowerSupply................................................................................................................................................... 148
cfgIPv6LanNetworking................................................................................................................................................... 150
cfgIpv6StaticLanNetworking.......................................................................................................................................... 154
cfgIPv6URL.................................................................................................................................................................... 156
cfgIpmiSerial................................................................................................................................................................... 156
cfgSmartCard................................................................................................................................................................. 158
cfgNetTuning.................................................................................................................................................................. 159
cfgSensorRedundancy....................................................................................................................................................160
cfgVFlashSD................................................................................................................................................................... 162
cfgVFlashPartition.......................................................................................................................................................... 163
cfgLogging......................................................................................................................................................................165
5

cfgRacSecurity............................................................................................................................................................... 165

4 Database Objects With Get and Set Commands.......................................................... 168
System.Backplane...........................................................................................................................................................170
System.ChassisControl.................................................................................................................................................... 171
System.ChassisControl.ChassisManagementMonitoring (Read or Write)...................................................................171
System.ChassisInfo..........................................................................................................................................................171
System.QuickSync.......................................................................................................................................................... 172
System.LCD.................................................................................................................................................................... 173
System.LCD.vConsoleIndication (Read or Write)....................................................................................................... 174
System.LCD.QualifierTemp (Read or Write)...............................................................................................................174
System.LCD.QualifierWatt (Read or Write)............................................................................................................... 175
System.Location............................................................................................................................................................. 175
System.Power................................................................................................................................................................. 177
System.Power.Supply..................................................................................................................................................... 189
System.ServerOS............................................................................................................................................................ 191
System.ThermalSettings................................................................................................................................................. 193
System.ThermalSettings.ThirdPartyPCIFanResponse (Read or Write)...................................................................... 196
System.ThermalConfig....................................................................................................................................................196
LifecycleController.LCAttributes...................................................................................................................................... 197
iDRAC.ActiveDirectory................................................................................................................................................... 200
iDRAC.ADGroup............................................................................................................................................................. 205
iDRAC.AutoOSLock........................................................................................................................................................206
iDRAC.EmailAlert............................................................................................................................................................ 207
iDRAC.Info..................................................................................................................................................................... 208
iDRAC.IOIDOpt...............................................................................................................................................................209
iDRAC.IPBlocking.............................................................................................................................................................211
iDRAC.IPMILan............................................................................................................................................................... 212
iDRAC.IPMISerial.............................................................................................................................................................214
iDRAC.IPMISOL.............................................................................................................................................................. 217
iDRAC.IPv4..................................................................................................................................................................... 218
iDRAC.IPv4Static............................................................................................................................................................ 221
iDRAC.IPv6.................................................................................................................................................................... 223
iDRAC.IPv6Static........................................................................................................................................................... 229
iDRAC.IPv6URL............................................................................................................................................................. 230
iDRAC.LDAP................................................................................................................................................................... 231
iDRAC.LDAPRoleGroup.................................................................................................................................................. 234
iDRAC.LocalSecurity...................................................................................................................................................... 235
iDRAC.Logging............................................................................................................................................................... 235
iDRAC.NIC......................................................................................................................................................................236
iDRAC.NIC.VLanPort (Read or Write)....................................................................................................................... 242
iDRAC.NICStatic............................................................................................................................................................ 242
iDRAC.NTPConfigGroup................................................................................................................................................ 243
iDRAC.OS-BMC............................................................................................................................................................. 244
iDRAC.Racadm...............................................................................................................................................................246
iDRAC.Redfish................................................................................................................................................................246
6

iDRAC.Redfish.Enable (Read or Write)..................................................................................................................... 247
iDRAC.Redfisheventing.................................................................................................................................................. 247
iDRAC.Redfisheventing.DeliveryRetryAttempts (Read or Write)...............................................................................247
iDRAC.Redfisheventing.DeliveryRetryIntervalInSeconds (Read or Write)................................................................. 247
iDRAC.Redfisheventing.IgnoreCertificateErrors (Read Only).................................................................................... 247
iDRAC.RemoteHosts...................................................................................................................................................... 248
iDRAC.RFS.....................................................................................................................................................................248
iDRAC.RSM....................................................................................................................................................................249
iDRAC.Security...............................................................................................................................................................249
iDRAC.Serial....................................................................................................................................................................251
iDRAC.SerialRedirection................................................................................................................................................. 253
iDRAC.serverboot.......................................................................................................................................................... 254
iDRAC.ServiceModule.................................................................................................................................................... 255
iDRAC.ServiceModule.iDRACHardReset (Read or Write)......................................................................................... 255
iDRAC.SmartCard...........................................................................................................................................................257
iDRAC.SNMP................................................................................................................................................................. 258
iDRAC.SNMP.Alert......................................................................................................................................................... 260
iDRAC.SSH..................................................................................................................................................................... 261
iDRAC.SysLog................................................................................................................................................................ 262
iDRAC.Telnet.................................................................................................................................................................. 264
iDRAC.Time.................................................................................................................................................................... 265
iDRAC.Tuning................................................................................................................................................................. 265
iDRAC.Update................................................................................................................................................................ 266
iDRAC.USB.....................................................................................................................................................................267
iDRAC.UserDomain.........................................................................................................................................................267
iDRAC.Users...................................................................................................................................................................268
iDRAC.vflashpartition...................................................................................................................................................... 271
iDRAC.vflashsd............................................................................................................................................................... 273
iDRAC.VirtualConsole..................................................................................................................................................... 275
iDRAC.VirtualMedia........................................................................................................................................................ 278
iDRAC.VNCServer.......................................................................................................................................................... 279
iDRAC.VNCServer.SSLEncryptionBitLength (Read or Write)................................................................................... 280
iDRAC.WebServer.......................................................................................................................................................... 280
iDRAC.WebServer.SSLEncryptionBitLength (Read or Write) ................................................................................... 282
BIOS.BiosBootSettings...................................................................................................................................................282
BIOS.EmbServerMgmt...................................................................................................................................................284
BIOS.IntegratedDevices................................................................................................................................................. 285
BIOS.IntegratedDevices.GlobalSlotDriverDisable.......................................................................................................287
BIOS.IntegratedDevices.IONonPostedPrefetch........................................................................................................290
BIOS.IntegratedDevices.IONonPostedPrefetch.........................................................................................................291
BIOS.MemSettings.........................................................................................................................................................292
BIOS.MiscSettings......................................................................................................................................................... 297
BIOS.NetworkSettings................................................................................................................................................... 299
BIOS.OneTimeBoot........................................................................................................................................................300
BIOS.ProcSettings.......................................................................................................................................................... 301

7

BIOS.Procsettings.Proc2Cores................................................................................................................................ 306
BIOS.Procsettings.Proc3Cores................................................................................................................................ 308
BIOS.Procsettings.Proc4Cores................................................................................................................................. 310
BIOS.ProxyAttributes...................................................................................................................................................... 316
BIOS.PxeDev1Settings.................................................................................................................................................... 317
BIOS.SataSettings.......................................................................................................................................................... 318
BIOS.SerialCommSettings..............................................................................................................................................330
BIOS.SlotDisablement.................................................................................................................................................... 332
BIOS.SysInformation...................................................................................................................................................... 335
BIOS.SysProfileSettings..................................................................................................................................................337
BIOS.SysProfileSettings.PowerSaver (Read or Write)...............................................................................................341
BIOS.SysProfileSettings.WriteDataCrc..................................................................................................................... 343
BIOS.SysSecurity........................................................................................................................................................... 343
BIOS.SysSecurity.TpmFirmware............................................................................................................................... 350
BIOS.SysSecurity.TpmPpiBypassClear......................................................................................................................350
BIOS.SysSecurity.TpmPpiBypassProvision................................................................................................................350
BIOS.UefiBootSettings....................................................................................................................................................351
FC.FCDevice.................................................................................................................................................................. 352
FC.FCTarget...................................................................................................................................................................353
FC.HBAConfig................................................................................................................................................................354
FC.PortConfig................................................................................................................................................................ 357
NIC.ConfigureFormn...................................................................................................................................................... 359
NIC.DCBSettings........................................................................................................................................................... 363
NIC.DeviceLevelConfig...................................................................................................................................................364
NIC.FCOECapabilities.................................................................................................................................................... 365
NIC.FCoEConfiguration..................................................................................................................................................368
NIC.FCoEGenParams..................................................................................................................................................... 370
NIC.FrmwImgMenu........................................................................................................................................................ 372
NIC.GlobalBandwidthAllocation...................................................................................................................................... 373
NIC.IscsiFirstTgtParams..................................................................................................................................................374
NIC.IscsiGenParams....................................................................................................................................................... 376
NIC.IscsiInitiatorParams..................................................................................................................................................380
NIC.IscsiSecondaryDeviceParams.................................................................................................................................. 383
NIC.IscsiSecondTgtParams............................................................................................................................................ 384
NIC.NICConfig............................................................................................................................................................... 386
NIC.NICPartitioningConfig............................................................................................................................................. 389
NIC.VndrConfigGroup..................................................................................................................................................... 391
Storage.Controller...........................................................................................................................................................401
Storage.Controller.PatrolReadUnconfiguredArea (Read or Write).............................................................................403
Storage.Controller.RequestedControllerMode (Read or Write)................................................................................. 404
Storage.enclosure.......................................................................................................................................................... 406
Storage.PhysicalDisk...................................................................................................................................................... 407
Storage.VirtualDisk......................................................................................................................................................... 408

A Deprecated and New Subcommands........................................................................... 410
B Legacy and New Groups and Objects........................................................................... 411

8

cfgSSADRoleGroupPrivilege (Read or Write)................................................................................................................. 422

9

1
Introduction
This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database
groups and object definitions for the following:
•

iDRAC for Blade Servers

•

iDRAC on Rack and Tower Servers

Most of the commands mentioned in this document are applicable for multi-generation servers. That is, the commands are applicable
for iDRAC6, iDRAC7, and iDRAC8. For more information on the commands applicable for a particular iDRAC version, see the iDRAC
RACADM Support Matrix available at dell.com/esmmanuals.
NOTE:
•

From iDRAC version 2.00.00.00, the guide provides information specific to iDRAC. For information specific to Chassis
Management Controller (CMC) M1000e, refer to Chassis Management Controller M1000e Version 5.0 RACADM
Command Line Reference Guide available at dell.com/support/manuals.

•

The appendix section in the guide provides:
– List of deprecated subcommands.
– List of legacy groups and objects with the equivalent new groups and objects.

What’s New in This Release
•

Added iDRAC.NIC.VLanEnable attribute to enable or disable the VLAN capabilities of the iDRAC server.

•

Added iDRAC.NIC.VLanPort attribute to enable or disable the VLAN switch of the iDRAC.

•

Added BIOS.IntegratedDevices.GlobalSlotDriverDisable attribute to control the pre-boot driver on any slot.

•

Added BIOS.IntegratedDevices.IONonPostedPrefetch attribute to enable or disable the PCI I/O non-posted prefetch mode to control the PCIe throughput.

•

Added BIOS.Procsettings.Proc2Cores, BIOS.Procsettings.Proc3Cores, and
BIOS.Procsettings.Proc4Cores attributes to control the number of enabled cores in each processor.

•

Added BIOS.SysProfileSettings.WriteDataCrc attribute to detect the DDR4 data bus issues and to resolve them
during the write operation.

•

Added BIOS.SysSecurity.TpmFirmware attribute to display the firmware version of the Trusted Platform Module (TPM).

•

Added BIOS.SysSecurity.TpmPpiBypassClear attribute to clear the Physical Presence Interface (PPI) Advanced
Configuration and Power Interface (ACPI). It also enables the operating system to by-pass the PPI-related prompts.

•

Added BIOS.SysSecurity.TpmPpiBypassProvision attribute to enable or disable the Physical Presence Interface
(PPI) Advanced Configuration and Power Interface (ACPI). It also enables the operating system to bypass the PPI-related
prompts.

•

Added –reboot option to the update command to perform a graceful system reboot after the firmware update.

•

Added support for enhanced and flexible backplane zoning or split modes.

•

Added iDRAC.ServiceModule.iDRACHardReset attribute to reset an unresponsive iDRAC through the operating system.

•

Added iDRAC.Redfish.Enable attribute to enable or disable Redfish service on iDRAC.

10

•

Added iDRAC.Redfisheventing.DeliveryRetryAttempts attribute to specify the number of retry attempts that are
made for Redfish event delivery.

•

Added iDRAC.Redfisheventing.DeliveryRetryIntervalInSeconds attribute to specify the retry intervals made
for Redfish event delivery in seconds.

•

Added iDRAC.Redfisheventing.IgnoreCertificateErrors attribute to enable or disable Ignorance of Certificate
Errors notifications.

•

Added support for Redfish 1.0, a RESTful Application Programming Interface (API), which is standardized by the Distributed
Management Task Force (DMTF). It provides a scalable and secured systems management interface. To get the IPv6 and VLAN
information, install iDRAC Service Module (iSM).

•

Added support for HTML5 virtual console and virtual media.

•

Renamed the Technical Support Report feature to SupportAssist Collection.

Supported RACADM Interfaces
The RACADM command-line utility provides a scriptable interface that allows you to locally configure or remotely configure your
iDRAC. The utility runs on the management station and the managed system. It is available on the Dell OpenManage Systems
Management and Documentation DVD or at support.dell.com.
The RACADM utility supports the following interfaces:
•

Local — Supports running RACADM commands from the managed server’s operating system. To run local RACADM commands,
install the OpenManage software on the managed server. Only one instance of Local RACADM can be executed on a system at a
time. If you try to open another instance, an error message is displayed and the second instance of Local RACADM closes
immediately. To download the local RACADM tool from support.dell.com, select Drivers and Downloads, select a server, and
then select Systems Management → Dell Toolkit.
NOTE: Local racadm and local racadm proxy runs with root user privilege.

•

SSH or Telnet — Also known as Firmware RACADM. Firmware RACADM is accessible by logging in to iDRAC using SSH or
Telnet. Similar to Remote RACADM, at the RACADM prompt, directly run the commands without the RACADM prefix.

•

Remote — Supports running RACADM commands from a remote management station such as a laptop or desktop. To run
Remote RACADM commands, install the DRAC Tools utility from the OpenManage software on the remote computer. To run
Remote RACADM commands:
– Formulate the command as a SSH or Telnet RACADM command.
For more information about the options, see RACADM Subcommand Details. To download the local RACADM tool from
dell.com/support, click Servers, Storage & Networking in the General Support section. Click PowerEdge, click the required
PowerEdge system, and then click Drivers & downloads.

RACADM Syntax Usage
The following section describes the syntax usage for SSH or Telnet, and Remote RACADM.

SSH, Telnet, or Remote RACADM
racadm -r  -u username -p password 
racadm -r  -u username -p password getconfig -g  -o