Dell Chassis Management Controller Version 1 35 For Poweredge Vrtx Quick Reference Guide (CMC) 1.35 RACADM

2014-11-13

: Dell Dell-Chassis-Management-Controller-Version-1-35-For-Poweredge-Vrtx-Quick-Reference-Guide-118071 dell-chassis-management-controller-version-1-35-for-poweredge-vrtx-quick-reference-guide-118071 dell pdf

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

DownloadDell Dell-Chassis-Management-Controller-Version-1-35-For-Poweredge-Vrtx-Quick-Reference-Guide- Chassis Management Controller (CMC) Version 1.35 For PowerEdge VRTX RACADM Guide Dell-chassis-management-controller-version-1-35-for-poweredge-vrtx-quick-reference-guide
Open PDF In BrowserView PDF
Chassis Management Controller Version 1.35 for Dell
PowerEdge VRTX RACADM Command Line Reference
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.

Copyright © 2014 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.
2014 - 07
Rev. A00

Contents
1 Introduction................................................................................................................................12
Supported RACADM Interfaces..............................................................................................................................12
RACADM Syntax Usage..........................................................................................................................................12
SSH or Telnet RACADM................................................................................................................................... 12
Remote RACADM............................................................................................................................................. 12
RACADM Command Options............................................................................................................................ 13
Supported RACADM Subcommands...................................................................................................................... 13
Other Documents You May Need........................................................................................................................... 16
Accessing Documents From Dell Support Site.......................................................................................................17

2 RACADM Subcommand Details..............................................................................................18
Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands.......................... 18
"?"and "?" .......................................................................................................................................19
help and help ................................................................................................................................20
chassislog...............................................................................................................................................................20
chassislog export....................................................................................................................................................21
chassislog clear......................................................................................................................................................22
chassisaction..........................................................................................................................................................22
closessn..................................................................................................................................................................23
clrsel....................................................................................................................................................................... 24
cmcchangeover......................................................................................................................................................24
config...................................................................................................................................................................... 24
connect................................................................................................................................................................... 25
deploy..................................................................................................................................................................... 25
Displayable Characters.......................................................................................................................................... 27
eventfilters.............................................................................................................................................................. 27
fanoffset..................................................................................................................................................................29
feature.....................................................................................................................................................................29
featurecard............................................................................................................................................................. 30
fwupdate.................................................................................................................................................................30
get........................................................................................................................................................................... 32
getactiveerrors....................................................................................................................................................... 33
getassettag............................................................................................................................................................. 33
getchassisname......................................................................................................................................................34
getconfig.................................................................................................................................................................34
getdcinfo.................................................................................................................................................................35
getflexaddr..............................................................................................................................................................36
getioinfo.................................................................................................................................................................. 37

getled...................................................................................................................................................................... 37
getmacaddress....................................................................................................................................................... 38
getmodinfo.............................................................................................................................................................. 40
getniccfg.................................................................................................................................................................42
getpbinfo.................................................................................................................................................................44
getpciecfg...............................................................................................................................................................45
getpminfo................................................................................................................................................................ 47
getraclog.................................................................................................................................................................48
getractime...............................................................................................................................................................49
getredundancymode...............................................................................................................................................49
getsel...................................................................................................................................................................... 50
getsensorinfo.......................................................................................................................................................... 50
getslotname............................................................................................................................................................ 51
getssninfo............................................................................................................................................................... 52
getsvctag................................................................................................................................................................ 53
getsysinfo................................................................................................................................................................53
gettracelog..............................................................................................................................................................54
getversion............................................................................................................................................................... 55
ifconfig.................................................................................................................................................................... 56
jobqueue................................................................................................................................................................. 57
krbkeytabupload..................................................................................................................................................... 58
license.....................................................................................................................................................................59
netstat..................................................................................................................................................................... 61
ping......................................................................................................................................................................... 62
ping6....................................................................................................................................................................... 62
racdump..................................................................................................................................................................63
racreset...................................................................................................................................................................64
racresetcfg............................................................................................................................................................. 64
racresetpcie............................................................................................................................................................65
raid..........................................................................................................................................................................65
blink.................................................................................................................................................................. 67
createvd........................................................................................................................................................... 68
deletevd............................................................................................................................................................69
discardcache................................................................................................................................................... 69
exportlog.......................................................................................................................................................... 69
forceonline....................................................................................................................................................... 70
get controllers.................................................................................................................................................. 70
hotspare........................................................................................................................................................... 72
cancelinit..........................................................................................................................................................73
cancelrebuild................................................................................................................................................... 73
assignva........................................................................................................................................................... 73
unblink.............................................................................................................................................................. 74

init.....................................................................................................................................................................74
raid................................................................................................................................................................... 75
raid................................................................................................................................................................... 76
rebuild...............................................................................................................................................................79
resetconfig....................................................................................................................................................... 79
enableperc....................................................................................................................................................... 79
disableperc.......................................................................................................................................................80
remoteimage...........................................................................................................................................................80
serveraction............................................................................................................................................................81
set........................................................................................................................................................................... 82
setassettag............................................................................................................................................................. 82
setchassisname......................................................................................................................................................82
setflexaddr.............................................................................................................................................................. 83
setled...................................................................................................................................................................... 83
setniccfg................................................................................................................................................................. 84
setpciecfg............................................................................................................................................................... 85
setractime...............................................................................................................................................................86
setslotname............................................................................................................................................................ 87
setsysinfo................................................................................................................................................................87
SSH or Telnet RACADM..........................................................................................................................................88
sshpkauth................................................................................................................................................................88
sslcertupload.......................................................................................................................................................... 89
sslcertview..............................................................................................................................................................89
sslcsrgen................................................................................................................................................................ 91
sslresetcfg.............................................................................................................................................................. 92
testemail................................................................................................................................................................. 92
testfeature.............................................................................................................................................................. 93
testtrap....................................................................................................................................................................95
traceroute............................................................................................................................................................... 95
traceroute6............................................................................................................................................................. 96

3 CMC Property Database Group and Object Descriptions.................................................. 97
idRacInfo.................................................................................................................................................................97
idRacProductInfo (Read Only)..........................................................................................................................97
idRacVersionInfo (Read Only).......................................................................................................................... 97
idRacBuildInfo (Read Only).............................................................................................................................. 98
idRacName (Read Only)................................................................................................................................... 98
cfgLanNetworking.................................................................................................................................................. 98
cfgNicIPv4Enable (Read or Write)................................................................................................................... 98
cfgNicVLanId (Read or Write).......................................................................................................................... 98
cfgDNSDomainNameFromDHCP (Read/Write)................................................................................................99
cfgDNSDomainName (Read/Write)................................................................................................................. 99

cfgDNSRacName (Read/Write)........................................................................................................................99
cfgDNSRegisterRac (Read/Write)..................................................................................................................100
cfgDNSServersFromDHCP (Read/Write)....................................................................................................... 100
cfgDNSServer1 (Read/Write).........................................................................................................................100
cfgDNSServer2 (Read/Write).........................................................................................................................100
cfgNicEnable (Read/Write)............................................................................................................................ 101
cfgNicIpAddress (Read/Write).......................................................................................................................101
cfgNicNetmask (Read/Write).........................................................................................................................101
cfgNicGateway (Read/Write).........................................................................................................................101
cfgNicMacAddress (Read Only).................................................................................................................... 102
cfgRemoteHosts................................................................................................................................................... 102
cfgRhostsFwUpdateTftpEnable (Read/Write)................................................................................................ 102
cfgRhostsFwUpdateIpAddr (Read/Write)...................................................................................................... 102
cfgRhostsFwUpdatePath (Read/Write).......................................................................................................... 102
cfgRhostsSmtpServerIpAddr (Read/Write)....................................................................................................103
cfgRhostsNtpEnable.......................................................................................................................................103
cfgRhostsNtpServer1..................................................................................................................................... 103
cfgRhostsNtpServer2..................................................................................................................................... 103
cfgRhostsNtpServer3..................................................................................................................................... 103
cfgRhostsNtpMaxDist.................................................................................................................................... 104
cfgRhostsSyslogEnable (Read/Write)............................................................................................................ 104
cfgRhostsSyslogPort (Read/Write)................................................................................................................ 104
cfgRhostsSyslogServer1 (Read/Write)...........................................................................................................104
cfgRhostsSyslogServer2 (Read/Write)...........................................................................................................104
cfgRhostsSyslogServer3 (Read/Write)...........................................................................................................105
cfgRhostsSyslogPowerLoggingEnabled........................................................................................................ 105
cfgRhostsSyslogPowerLoggingInterval.........................................................................................................105
cfgUserAdmin....................................................................................................................................................... 105
cfgUserAdminIndex (Read Only).................................................................................................................... 106
cfgUserAdminPrivilege (Read/Write).............................................................................................................106
cfgUserAdminUserName (Read/Write)..........................................................................................................107
cfgUserAdminPassword (Write Only)............................................................................................................ 108
cfgUserAdminEnable (Read/Write)................................................................................................................108
cfgEmailAlert........................................................................................................................................................ 108
cfgEmailAlertIndex (Read Only)..................................................................................................................... 108
cfgEmailAlertEnable (Read/Write)................................................................................................................. 108
cfgEmailAlertAddress (Read/Write)...............................................................................................................109
cfgEmailAlertEmailName............................................................................................................................... 109
cfgSessionManagement.......................................................................................................................................109
cfgSsnMgtRacadmTimeout (Read/Write)...................................................................................................... 109
cfgSsnMgtWebserverTimeout (Read/Write)................................................................................................. 110
cfgSerial................................................................................................................................................................110

cfgSerialBaudRate (Read/Write)....................................................................................................................110
cfgSerialConsoleEnable (Read/Write)........................................................................................................... 110
cfgSerialConsoleIdleTimeout (Read/Write)................................................................................................... 110
cfgSerialConsoleNoAuth (Read/Write).......................................................................................................... 111
cfgSerialConsoleCommand (Read/Write)...................................................................................................... 111
cfgSerialConsoleColumns.............................................................................................................................. 111
cfgSerialHistorySize (Read/Write)................................................................................................................. 111
cfgSerialSshEnable (Read/Write).................................................................................................................. 111
cfgSerialTelnetEnable (Read/Write) ............................................................................................................. 112
cfgOobSnmp......................................................................................................................................................... 112
cfgOobSnmpAgentCommunity (Read/Write)................................................................................................. 112
cfgOobSnmpAgentEnable (Read/Write)........................................................................................................ 113
cfgTraps................................................................................................................................................................113
cfgTrapsIndex (Read Only).............................................................................................................................113
cfgTrapsEnable.............................................................................................................................................. 113
cfgTrapsAlertDestIpAddr............................................................................................................................... 113
cfgTrapsCommunityName..............................................................................................................................113
cfgRacTuning........................................................................................................................................................114
cfgRacTuneDefCredentialWarningEnable.....................................................................................................114
cfgRacTuneRemoteRacadmEnable (Read/Write)..........................................................................................114
cfgRacTuneHttpPort (Read/Write)................................................................................................................. 114
cfgRacTuneHttpsPort (Read/Write)............................................................................................................... 115
cfgRacTuneIpRangeEnable (Read/Write)...................................................................................................... 115
cfgRacTuneIpRangeAddr (Read/Write)......................................................................................................... 115
cfgRacTuneIpRangeMask (Read/Write)........................................................................................................ 115
cfgRacTuneIpBlkEnable (Read/Write)........................................................................................................... 116
cfgRacTuneIpBlkFailCount (Read/Write)....................................................................................................... 116
cfgRacTuneIpBlkFailWindow (Read/Write)................................................................................................... 116
cfgRacTuneIpBlkPenaltyTime (Read/Write).................................................................................................. 116
cfgRacTuneSshPort (Read/Write)..................................................................................................................116
cfgRacTuneTelnetPort (Read/Write)..............................................................................................................117
cfgRacTuneDaylightOffset (Read Only)..........................................................................................................117
cfgRacTuneTimezoneOffset (Read Only)....................................................................................................... 117
cfgRacTuneWebserverEnable (Read/Write)................................................................................................. 118
cfgServerInfo........................................................................................................................................................ 118
cfgServerInfoIndex (Read Only).....................................................................................................................118
cfgServerSlotNumber (Read Only).................................................................................................................119
cfgServerServiceTag (Read Only)..................................................................................................................119
cfgServerName (Read/Write)........................................................................................................................ 119
cfgServerFW (Read Only)...............................................................................................................................119
cfgServerBIOS (Read Only)............................................................................................................................119
cfgServerBmcMacAddress (Read Only)........................................................................................................119

cfgServerNic1MacAddress (Read Only)........................................................................................................120
cfgServerNic2MacAddress (Read Only)........................................................................................................120
cfgServerNic3MacAddress (Read Only)........................................................................................................120
cfgServerNic4MacAddress (Read Only)........................................................................................................120
cfgServerPriority (Read/Write)...................................................................................................................... 120
cfgServerNicEnable (Read/Write)................................................................................................................. 120
cfgServerIPMIOverLanEnable (Read/Write)..................................................................................................121
cfgServerPowerBudgetAllocation (Read Only)............................................................................................. 121
cfgServerDNSRegisterIMC (Read/Write)...................................................................................................... 121
cfgServerDNSIMCName (Read/Write).......................................................................................................... 121
cfgServerRootPassword (Write Only)............................................................................................................121
cfgServerFirstBootDevice (Read/Write)........................................................................................................ 121
cfgServerBootOnce (Read/Write)..................................................................................................................122
cfgServerPowerConsumption (Read Only).................................................................................................... 122
cfgActiveDirectory................................................................................................................................................123
cfgADRacName (Read/Write)........................................................................................................................ 123
cfgADCertValidationEnable (Read/Write)...................................................................................................... 124
cfgADRacDomain (Read/Write)..................................................................................................................... 124
cfgADRootDomain (Read/Write).................................................................................................................... 124
cfgADEnable (Read/Write)............................................................................................................................. 124
cfgADAuthTimeout (Read/Write)................................................................................................................... 124
cfgADSCLEnable............................................................................................................................................ 125
cfgADSSOEnable (Read/Write)...................................................................................................................... 125
cfgADDomainController1 (Read/Write)..........................................................................................................125
cfgADDomainController2 (Read/Write)..........................................................................................................125
cfgADDomainController3 (Read/Write)..........................................................................................................125
cfgADGlobalCatalog1 (Read/Write)............................................................................................................... 126
cfgADGlobalCatalog2 (Read/Write)............................................................................................................... 126
cfgADGlobalCatalog3 (Read/Write)............................................................................................................... 126
cfgADType (Read/Write)................................................................................................................................ 126
cfgADDcSRVLookupbyUserdomain (Read/Write)..........................................................................................126
cfgADDcSRVLookupDomainName (Read/Write)........................................................................................... 127
cfgADDcSRVLookupEnable (Read/Write)...................................................................................................... 127
cfgADGcRootDomain (Read/Write)................................................................................................................127
cfgADGcSRVLookupEnable (Read/Write)...................................................................................................... 127
cfgADSpecifyServerEnable............................................................................................................................127
cfgLDAP................................................................................................................................................................ 128
cfgLDAPEnable (Read/Write).........................................................................................................................128
cfgLDAPServer (Read/Write)......................................................................................................................... 128
cfgLDAPPort (Read/Write)............................................................................................................................. 128
cfgLDAPBasedn (Read/Write)........................................................................................................................129
cfgLDAPUserAttribute (Read/Write).............................................................................................................. 129

cfgLDAPGroupAttribute (Read/Write)............................................................................................................129
cfgLDAPGroupAttributeIsDN (Read/Write)....................................................................................................129
cfgLDAPBinddn (Read/Write)........................................................................................................................ 129
cfgLDAPBindpassword (Write Only)..............................................................................................................130
cfgLDAPSearchFilter (Read/Write)................................................................................................................ 130
cfgLDAPCertValidationEnable (Read/Write)..................................................................................................130
cfgLDAPNetworkTimeout...............................................................................................................................130
cfgLDAPSearchTimeout.................................................................................................................................130
cfgLDAPSRVLookupDomainName................................................................................................................. 131
cfgLDAPSRVLookupEnable............................................................................................................................ 131
cfgLDAPSRVLookupServiceName (Read/Write)........................................................................................... 131
cfgLDAPRoleGroup............................................................................................................................................... 131
cfgLDAPRoleGroupDN (Read/Write)..............................................................................................................131
cfgLDAPRoleGroupPrivilege (Read/Write).....................................................................................................132
cfgLocation........................................................................................................................................................... 132
cfgLocationDatacenter (Read/Write).............................................................................................................132
cfgLocationAisle (Read/Write).......................................................................................................................132
cfgLocationRack (Read/Write).......................................................................................................................132
cfgLocationRackslot (Read/Write)................................................................................................................. 133
cfgLocationDevicesize (Read Only)............................................................................................................... 133
cfgStandardSchema.............................................................................................................................................133
cfgSSADRoleGroupIndex (Read Only)........................................................................................................... 133
cfgSSADRoleGroupName (Read/Write).........................................................................................................133
cfgSSADRoleGroupDomain (Read/Write)...................................................................................................... 133
cfgSSADRoleGroupPrivilege (Read/Write).................................................................................................... 134
cfgChassisPower..................................................................................................................................................134
cfgChassisInPower (Read Only).....................................................................................................................135
cfgChassisPeakPower (Read Only)................................................................................................................135
cfgChassisPeakPowerTimestamp (Read Only)..............................................................................................135
cfgChassisMinPower (Read Only)................................................................................................................. 135
cfgChassisMinPowerTimestamp (Read Only)................................................................................................135
cfgChassisPowerStatus (Read Only)............................................................................................................. 135
cfgChassisRedundantState (Read Only)........................................................................................................ 136
cfgChassisDefaultPowerCapUpperBound (Read Only)................................................................................. 136
cfgChassisDefaultPowerCapUpperBoundBTU(Read Only)........................................................................... 136
cfgChassisDefaultPowerCapLowerBound (Read Only)................................................................................. 136
cfgChassisDefaultPowerCapLowerBoundBTU(Read Only)........................................................................... 136
cfgChassisPowerCap (Read/Write)............................................................................................................... 136
cfgChassisPowerCapF (Read/Write)..............................................................................................................137
cfgChassisPowerCapFBTU (Read/Write).......................................................................................................137
cfgChassisPowerCapPercent (Read/Write)...................................................................................................137
cfgChassisPowerCapFPercent (Read/Write).................................................................................................137

cfgChassisRedundancyPolicy (Read/Write).................................................................................................. 138
cfgChassisDynamicPSUEngagementEnable (Read/Write)............................................................................138
cfgChassisInMaxPowerCapacity (Read Only)............................................................................................... 138
cfgChassisInRedundancyReserve (Read Only)..............................................................................................138
cfgChassisInPowerServerAllocation (Read Only)......................................................................................... 138
cfgChassisInfrastructureInPowerAllocation (Read Only)..............................................................................138
cfgChassisTotalInPowerAvailable (Read Only)............................................................................................. 139
cfgChassisStandbyInPowerCapacity (Read Only)......................................................................................... 139
cfgChassisPowerClear (Write Only)...............................................................................................................139
cfgChassisPowerClearTimestamp (Read Only)............................................................................................. 139
cfgChassisPowerButtonEnable (Read/Write)................................................................................................139
cfgSystemEnergyConsumptionClear (Write Only)......................................................................................... 139
cfgChassisServerBasedPowerMgmtMode................................................................................................... 140
cfgChassisPowerCapBTU (Read/Write)........................................................................................................ 140
cfgKVMInfo...........................................................................................................................................................141
cfgKvmMapping Read or Write......................................................................................................................141
cfgKvmSlotEnable Read or Write........................................................................................................141
cfgDvdInfo............................................................................................................................................................ 141
cfgDvdMapping Read or Write...................................................................................................................... 141
cfgDvdSlotEnable Read or Write........................................................................................................ 141
cfgLcdInfo.............................................................................................................................................................142
cfgAlerting............................................................................................................................................................ 142
cfgAlertingEnable...........................................................................................................................................142
cfgAlertingSourceEmailName........................................................................................................................142
cfgIPv6LanNetworking......................................................................................................................................... 143
cfgIPv6Enable (Read/Write)...........................................................................................................................143
cfgIPv6AutoConfig (Read/Write).................................................................................................................... 143
cfgIPv6Address.............................................................................................................................................. 144
cfgIPv6PrefixLength (Read/Write)................................................................................................................. 144
cfgIPv6Gateway (Read/Write)........................................................................................................................144
cfgIPv6DNSServersFromDHCP6 (Read/Write)...............................................................................................144
cfgIPv6DNSServer1 (Read/Write)..................................................................................................................144
cfgIPv6DNSServer2 (Read/Write)..................................................................................................................145
cfgCurrentLanNetworking (Read Only).................................................................................................................145
cfgNicCurrentIPv4Enabled.............................................................................................................................145
cfgNicCurrentIpAddress................................................................................................................................ 146
cfgNicCurrentNetmask.................................................................................................................................. 146
cfgNicCurrentGateway.................................................................................................................................. 146
cfgNicCurrentDhcpWasUsed........................................................................................................................ 146
cfgNicCurrentVlanEnable (Read Only)........................................................................................................... 146
cfgNicCurrentVlanID (Read Only).................................................................................................................. 147
cfgNicCurrentVlanPriority (Read Only).......................................................................................................... 147

cfgDNSCurrentServer1.................................................................................................................................. 147
cfgDNSCurrentServer2.................................................................................................................................. 147
cfgDNSCurrentDomainName.........................................................................................................................147
cfgCurrentIPv6LanNetworking (Read Only)..........................................................................................................147
cfgCurrentIPv6Enabled.................................................................................................................................. 147
cfgCurrentIPv6AutoConfigWasUsed..............................................................................................................148
cfgCurrentLinkLocalAddress..........................................................................................................................148
cfgCurrentIPv6Address..................................................................................................................................148
cfgCurrentIPv6Gateway ................................................................................................................................ 148
cfgCurrentIPv6DNSServersFromDHCP6 ....................................................................................................... 148
cfgCurrentIPv6DNSServer1........................................................................................................................... 149
cfgCurrentIPv6DNSServer2........................................................................................................................... 149
cfgNetTuning........................................................................................................................................................ 149
cfgNetTuningNicSpeed..................................................................................................................................149
cfgNetTuningNicFullDuplex (Read/Write)......................................................................................................149
cfgNetTuningNicMtu (Read/Write)................................................................................................................150
cfgNetTuningNicAutoneg (Read/Write).........................................................................................................150
cfgRacSecurity..................................................................................................................................................... 150
cfgRacSecCsrCommonName (Read/Write)................................................................................................... 150
cfgRacSecCsrOrganizationName (Read/Write).............................................................................................151
cfgRacSecCsrOrganizationUnit (Read/Write)................................................................................................151
cfgRacSecCsrLocalityName (Read/Write).....................................................................................................151
cfgRacSecCsrStateName (Read/Write).........................................................................................................151
cfgRacSecCsrCountryCode (Read/Write)...................................................................................................... 151
cfgRacSecCsrEmailAddr (Read/Write).......................................................................................................... 151
cfgRacSecCsrKeySize (Read/Write).............................................................................................................. 152

Introduction

1

This document provides information about the RACADM subcommands, supported RACADM interfaces, and property
database groups and object definitions of CMC for PowerEdge VRTX.

Supported RACADM Interfaces
The RACADM command-line utility provides a scriptable interface that allows you to remotely configure your Remote
Access Controller (RAC). 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:
•

SSH or Telnet — Also referred as Firmware RACADM, is accessible by logging in to CMC using SSH or telnet. You do
not have to specify the CMC IP, user name or password to run Firmware RACADM commands.

•

Remote — Supports executing RACADM commands from a remote management station such as a laptop or desktop.
You must install the DRAC Tools utility from the OpenManage software on the remote computer to run Remote
RACADM commands. To execute Remote RACADM commands, you must formulate the command such as a an SSH/
Telnet RACADM command except that you must also use the –r –i options or the –r –u –p options. For more
information about these options, see the "RACADM Subcommand Details."

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

SSH or Telnet RACADM
racadm getconfig -g  [-o ]
[-i ]
racadm 
Example
racadm getconfig -g idracinfo
racadm getsysinfo

Remote RACADM
racadm -r  -u  -p  getconfig -g  [-o
] [-i ]
racadm -r  -u  -p  
Example
racadm -r  -u  -p  getconfig -g 
idracinfo
racadm -r  -u  -p  getsysinfo

12

RACADM Command Options
The following table lists the options for the RACADM command.
Option

Description

-r
-r racIpAddr : 

Specifies the controller’s remote IP address.
Use: if the iDRAC port number is not the
default port (443).

-u 

Specifies the user name that is used to authenticate the
command transaction. If the -u option is used, the -p
option must be used, and the -i option (interactive) is not
allowed.

-p 

Specifies the password used to authenticate the
command transaction. If the -p option is used, the -i option
is not allowed.

-S

Specifies that RACADM should check for invalid
certificate errors. RACADM stops the execution of the
command with an error message if it detects an invalid
certificate.

-i 

Specifies the index number for the indexed group, if
applicable.

-g 

Specifies the group name, if applicable.

-o objectname

Specifies the object name, if applicable.

The following table provides the supported RACADM interfaces.
Type

Local RACADM

SSH/Telnet RACADM

Remote RACADM

CMC

No

Yes

Yes

NOTE: Multiple instances of remote RACADM can be executed on a management station.

Supported RACADM Subcommands
The following table provides the list of RACADM subcommands and their corresponding interface support. For more
information about the RACADM sub-commands including syntax and valid entries, see RACADM Subcommand Details.
Subcommand

CMC
Telnet/SSH/Serial

Remote RACADM

"?" and "?"

Yes

Yes

chassisaction

Yes

Yes

chassislog

No

No

closessn

Yes

Yes

clrsel

Yes

Yes

13

Subcommand

CMC

cmcchangeover

Yes

Yes

config

Yes

Yes

connect

Yes

Yes

deploy

Yes

Yes

eventfilters

Yes

Yes

fanoffset

Yes

Yes

feature

Yes

Yes

featurecard

Yes

Yes

fwupdate

Yes

Yes

get

No

Yes

getactiveerrors

No

Yes

getassettag

Yes

Yes

getchassisname

Yes

Yes

getconfig

Yes

Yes

getdcinfo

Yes

Yes

getflexaddr

Yes

Yes

getioinfo

Yes

Yes

getled

Yes

Yes

getmacaddress

Yes

Yes

getmodinfo

Yes

Yes

getniccfg

Yes

Yes

getpbinfo

Yes

Yes

getpciecfg

Yes

Yes

getpminfo

Yes

Yes

getraclog

Yes

Yes

getractime

Yes

Yes

getredundancymode

Yes

Yes

getsel

Yes

Yes

getsensorinfo

Yes

Yes

getslotname

Yes

Yes

getssninfo

Yes

Yes

getsvctag

Yes

Yes

getsysinfo

Yes

Yes

14

Subcommand

CMC

getversion

Yes

Yes

help and help 

Yes

Yes

ifconfig

Yes

Yes

jobqueue

Yes

Yes

krbkeytabupload

No

Yes

license

No

Yes

netstat

Yes

Yes

ping

Yes

Yes

ping6

Yes

Yes

racdump

Yes

Yes

racreset

Yes

Yes

racresetpcie

Yes

Yes

racresetcfg

Yes

Yes

raid

Yes

Yes

remoteimage

Yes

Yes

serveraction

Yes

Yes

set

No

Yes

setassettag

Yes

Yes

setflexaddr

Yes

Yes

setled

Yes

Yes

setniccfg

Yes

Yes

setpciecfg

Yes

Yes

setractime

Yes

Yes

setslotname

Yes

Yes

setsysinfo

Yes

Yes

sshpkauth

Yes

Yes

sslcertview

Yes

Yes

sslcsrgen

Yes

Yes

sslresetcfg

Yes

Yes

testemail

Yes

Yes

testfeature

Yes

Yes

testtrap

Yes

Yes

traceroute

Yes

Yes

15

Subcommand
traceroute6

CMC
Yes

Yes

Other Documents You May Need
To access the documents from the Dell Support site. Along with this Reference Guide, you can access the following
guides available at dell.com/support/manuals.
•

The VRTX CMC Online Help provides information about using the Web interface. To access the Online Help, click
Help on the CMC web interface.

•

The Chassis Management Controller for PowerEdge VRTX User's Guide provides information about using the VRTX–
related Web interface features.

•

The Dell Chassis Management Controller (CMC) for Dell PowerEdge VRTX Version Release Notes provides lastminute updates to the system or documentation or advanced technical reference material intended for experienced
users or technicians.

•

The Integrated Dell Remote Access Controller 7 (iDRAC7) User’s Guide provides information about installation,
configuration, and maintenance of the iDRAC on managed systems.

•

The Dell OpenManage Server Administrator’s User’s Guide provides information about installing and using Server
Administrator.

•

The Dell Update Packages User's Guide provides information about obtaining and using Dell Update Packages as
part of your system update strategy.

•

The Dell Shared PowerEdge RAID Controller (PERC) 8 User's Guide provides information about deploying the Shared
PERC 8 card and managing the storage subsystem. This document is available online at dell.com/
storagecontrollermanuals.

•

Dell systems management application documentation provides information about installing and using the systems
management software.

The following system documents provide more information about the system in which VRTX CMC is installed:
•

The safety instructions that came with your system provide important safety and regulatory information. For
additional regulatory information, see the Regulatory Compliance home page at www.dell.com/
regulatory_compliance. Warranty information may be included within this document or as a separate document.

•

The Dell PowerEdge VRTX Getting Started Guide shipped with your system provides an overview of system features,
setting up your system, and technical specifications.

•

The setup placemat shipped with your system provides information about the initial system setup and configuration.

•

The server module's Owner's Manual provides information about the server module's features and describes how to
troubleshoot the server module and install or replace the server module's components. This document is available
online at dell.com/poweredgemanuals.

•

The rack documentation included with your rack solution describes how to install your system into a rack, if
required.

•

For the full name of an abbreviation or acronym used in this document, see the Glossary at dell.com/support/
manuals.

•

Systems management software documentation describes the features, requirements, installation, and basic
operation of the software.

•

Documentation for any components you purchased separately provides information to configure and install these
options.

•

Any media that ships with your system that provides documentation and tools for configuring and managing your
system, including those pertaining to the operating system, system management software, system updates, and
system components that you purchased with your system. For more information on the system, scan the Quick
Resource Locator (QRL) available on your system and the system setup placemat that shipped with your system.
Download the QRL application from your mobile platform to enable the application on your mobile device.

16

Updates are sometimes included with the system to describe changes to the system, software, and/or documentation.
Always read the updates first, because they often supersede information in other documents.

Accessing Documents From Dell Support Site
You can access the required documents in one of the following ways:
•

•

Using the following links:
–

For all Systems Management documents — dell.com/softwaresecuritymanuals

–

For Remote Enterprise Systems Management documents — dell.com/esmmanuals

–

For Enterprise Systems Management documents — dell.com/openmanagemanuals

–

For Client Systems Management documents — dell.com/clientsystemsmanagement

–

For Serviceability Tools documents — dell.com/serviceabilitytools

–

For OpenManage Connections Enterprise Systems Management documents — dell.com/
OMConnectionsEnterpriseSystemsManagement

–

For OpenManage Connections Client Systems Management documents — dell.com/
connectionsclientsystemsmanagement

From the Dell Support site:
a.

Go to dell.com/support/manuals.

b.

Under General support section, click Software & Security.

c.

In the Software & Security group box, click the required link from the following:

d.
•

–

Serviceability Tools

–

Enterprise System Management

–

Client System Management

–

Remote Enterprise System Management

To view a document, click the required product version.

Using search engines:
–

Type the name and version of the document in the Search box.

17

RACADM Subcommand Details

2

This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.

Guidelines to Quote Strings Containing Special Characters When
Using RACADM Commands
When using strings that contain special characters, use the following guidelines:
Strings containing the following special characters must be quoted using single quotation marks or double quotation
marks:
•

$ (dollar sign)

•

" (double quotation marks)

•

' (single quotation marks)

•

` (back quotation marks)

•

\ (backslash)

•

~ (tilde)

•

; (semicolon)

•

| (vertical bar)

•

( (left parentheses)

•

) (right parentheses)

•

& (ampersand)

•

> (greater than)

•

< (less than)

•

# (pound)

•

ASCII code 32 (space)
NOTE: The - (dash) character cannot be the first character of the string, regardless of whether the string is
quoted.

There are different escaping rules for using single quotation mark and double quotation marks.
For double quoting:
The following characters must be escaped by prepending a backslash:
•

$ (dollar sign)

•

" (double quotation marks)

•

' (single quotation marks)

•

` (back quotation marks)

•

\ (backslash)

For example, use the following for a string that contains the special characters, $, ",',`and \.

18

For single quotation marks:
•
•

No character escaping is necessary.
A single quotation mark cannot be used even with a backslash escaped.
NOTE: An empty string may be specified as either "" (using double quotation marks) or '' (using single quotation
mark).

"?"and "?"
Description

Displays all the subcommands you can use with the RACADM command and a one-line
description of each subcommand.
? followed by  displays the syntax for the specified command.
To use this subcommand, you must have the CMC Login User privilege.
You can also use the help and help  commands to obtain the same
information.

Synopsis

racadm ?
racadm ? 

Input

NA

Output

NA

Example for RACADM ?
The following output example shows only part of the actual output for the racadm ? command. Descriptions shown in
this example may vary slightly from the descriptions in your racadm session.
racadm ?
help
-- list racadm subcommand description
help  -- display usage summary for a subcommand
?
-- list racadm subcommand description
?  -- display usage summary for a subcommand
arp
-- display the networking arp table
chassisaction
-- execute chassis or switch power-up/down/cycle or
KVM powercycle
clrraclog
-- clear the CMC log
clrsel
-- clear the System Event Log (SEL)
cmcchangeover
-- Changes the redundant state of the CMC from active
to standby and vice versa
config
-- modify CMC configuration properties
...
setniccfg
-- modify network configuration properties
setractime
-- set the time on the CMC
setslotname
-- sets the name of the slot in the chassis
setsysinfo
-- set the chassis name and chassis location
sslcertview
-- display a CA/server certificate in the CMC
sslcsrgen
-- generate a certificate CSR from the CMC
testemail
-- test CMC e-mail notifications
testfeature
-- test CMC feature x
testtrap
-- test CMC SNMP trap notifications
traceroute
-- determine the route of a packet
traceroute6
-- determine the route of a packet
Example for RACADM ? 
racadm ? getsysinfo
getsysinfo -- display general CMC and system information
Usage:

19

racadm getsysinfo [-d] [-c] [-A] [-4] [-6]
----------------------------------------------------------Valid Options:
-d : show CMC information
-c : show chassis information
-A : do not show headers or labels
-4 : show CMC IPv4 information
-6 : show CMC IPv6 information

help and help 
Description
Synopsis

Input
Output
Example

Lists all the subcommands available for use with RACADM and provides a short description for
each. You may also type a subcommand after help.
•
•

racadm help
racadm help 

None
•

The help command displays a complete list of subcommands.

racadm help getsysinfo

chassislog
Description

Allows you to view, export, or clear the chassis log history.
To clear a chassis log, you must have the Clear Logs Administrator privilege.
NOTE: It is recommended that you use Firmware RACADM to run this subcommand.

Synopsis

racadm chassislog view -i 
-c  -s 
-q  -n 
-r  -e 

Input

•
•

•
•
•
•
•

20

-i — Displays the number of records present in the active log. You cannot use this
option with any other option.
-c — The log type to filter the records. Provide multiple categories using a "," as the
delimiter. The value is case-insensitive. Valid Category values:
– All
– System
– Storage
– Updates
– Audit
– Config
-q - The sequence number from which the records must be displayed.
-n - Specifies the n Number of records to be displayed.
-r - Displays events that have occurred after this time. The time format is yyyy-mm-dd
HH:MM:SS. The time stamp must be provided within double quotes.
-e - Displays events that have occurred before this time. The time format is yyyy-mmdd HH:MM:SS. The time stamp must be provided within double quotes.
-f  - Specifies the file location and name where the chassis log is exported.

•
•
•

•
•
•

-a  - Specifies the FTP Server IP address or FQDN, user name, and password.
-d  - Specifies the path to the file on the FTP server.
-l  - Specifies the location of the network share or area on file system where
chassis log is exported. Two types of network shares are supported:
— SMB mounted path: ////

— NFS mounted path: :/.
-u  — Specifies the user name for accessing the FTP Server, or Domain and
User Name for accessing network share location.
-p  — Specifies the password for accessing the FTP Server or Share
location.
-s — The severity used to filter the records. Provide multiple severities using a "," as
the delimiter. The value is case-insensitive. Valid Severity values:
–
–
–

1. Warning
2. Critical
3. Info
NOTE: To view or export the Chassis log, only the CMC Login User privilege is
required.

Example

•

Display the number of records present in the Chassis Log:
racadm chassislog view -i

•

Display the records under the storage category with severity set to warning:
racadm chassislog view -c storage -s warning

•

Display the records under storage and system categories with severities set to
warning or critical:
racadm chassislog view -c storage,system -s
warning,critical

•

Display the records having severities set to warning or critical, starting from sequence
number 4:
racadm chassislog view -s warning,critical -q 4

•

Display 5 records starting from sequence number 20:
racadm chassislog view -q 20 -n 5

•

Display all records of events that have occurred between 2011-01-02 23:33:40 and
2011-01-03 00:32:15:
racadm chassislog view -r "2011-01-02 23:33:40" -e
"2011-01-03 00:32:15"

•

Display all the available records from the active Chassis log:
racadm chassislog view -n all

•

Display the last 25 records from the Chassis log:
racadm chassislog view

chassislog export
Description

Exports the Chassis log to a remote share.
To export the chassis log, you must have the Clear Logs Administrator privilege.

Synopsis

racadm chassislog export -f -u p -l

21

racadm -r -u -p
chassislog export -f -u -p l
Input

•
•
•
•

Example

•

–f : Filename of the exported Chassis Log.
–u : Username for the remote share to where the file must be exported. Username in a
domain can be given as domain/username
–p : Password for the remote share to where the file must be exported.
–l : Network share location (see the “Example” section for NFS or CIFS share) to
where the Chassis Log must be exported.
Export the Chassis Log to a remote CIFS share
racadm chassislog export -f Mylog.xml -u admin -p mypass
-l //10.94.161.103/share
- Export the Chassis Log to a remote NFS share
racadm chassislog export -f Mylog.xml -l 10.94.161.103:/
home/lclog_user

chassislog clear
Description

Deletes the data in the chassis log.
To clear the chassis log, you must have the Clear Logs Administrator privilege.

Synopsis

racadm chassislog clear racadm -r -u p chassislog clear

Example

•

Clear the Chassis Log
racadm chassislog clear

•

Clear the Chassis Log using remote racadm
racadm -r 10.94.161.119 -u root -p calvin chassislog
clear

chassisaction
Description

Executes a power action on the chassis or a server.
To use this subcommand, you must have the Chassis
Control Administrator privilege.

Synopsis

racadm chassisaction [-m ]


Input

•

-m  — Module on which you want to carry
out the action. Values are:
–
–

•

22

chassis - this is the default value, if -m is not
specified.
switch-n, where n=1

 — Action that you want to execute on the
specified module. Values are:

–
–
–
–
–

powerdown — (Chassis only) Turns off the
chassis.
powerup — (Chassis only) Turns on the chassis.
powercycle — Power cycles the module.
nongraceshutdown — (Chassis only) Nongracefully turns off the chassis.
reset — Performs a hard reset of the module.

When  = switch,  must be powercycle
or reset.
Output

None

Example

Perform a reset of switch-1:
racadm chassisaction -m switch-1 reset
Module power operation successful.

closessn
Description

Synopsis

Input

Closes a communication session on the device. Use the
getssninfo command to view a list of sessions that
can be closed using this command.
To use this subcommand, you must have the Administrator
privilege.
•
•
•

racadm closessn –i 
racadm closessn -a
racadm closessn -u 

•

-i — The session ID of the session to be
ended, which can be retrieved using RACADM
getssninfo subcommand.
Session executing this command cannot be ended.
-a — Closes all sessions.
-u — Close all sessions for a particular
user name.

•
•

–
Output
Example

Remote RACADM: -u option or -i option

None
•
•
•

racadm closessn -i 1234
Closes the session 1234.
racadm closessn –u root
Closes all the sessions for root user.
racadm closessn –a
Closes all the sessions.

23

clrsel
Description

Deletes all existing records from the System Event Log (SEL).
To use this subcommand, you must have the Clear Logs privilege.

Synopsis

racadm clrsel

cmcchangeover
Description

Changes the state of the CMC from active to standby, or
vice versa, in a redundant CMC configuration. This
subcommand is useful for remote debugging or testing
purposes.
To use this subcommand, you must have the Administrator
privilege.
NOTE: This command is valid only in redundant CMC
environments. For more information, see the
"Understanding the Redundant CMC Environment"
section of the Dell Chassis System User Guide.

Synopsis

racadm cmcchangeover

Input

None

Output

CMC failover initiated successfully.

Example

racadm cmcchangeover

config
Description

Allows you to set CMC configuration parameters individually or to batch them as part of a
configuration file. If the data is different, that CMC object is written with the new value.

Synopsis

racadm config [-c|-p] -f 
racadm config -g  -o  [-i
] 
NOTE: The configuration file retrieved using remote racadm are not interoperable. For the
config -f  command, use the configuration file retrieved from the same interface.

Input

NOTE: The -f and -p options are not supported for the serial/Telnet/SSH console.
•
•

•
•

24

-f — The -f  option causes config to read the contents of the file specified by
 and configure CMC.
-p— This option must be used with the -f option. It directs config to delete the password entries
contained in the config file -f  after the configuration is complete.
To apply the password, you must remove the preceding Read-Only marker '#' in the config file
before executing the config -f command.
-g— The -g , or group option, must be used with the -o option. The 
specifies the group containing the object that is to be set.
-o — The -o  , or object option, must be used with the -g option. This
option specifies the object name that is written with the string .

•

•

Output

-i — The -i , or index option, is valid only for indexed groups and can be used to specify
a unique group. The  is a decimal integer from 1 through n, where n can vary from 1 to
maximum number of indexes a particular group supports. If -i  is not specified, a value
of 1 is assumed for groups, which are tables that have multiple entries. The index is specified
by the index value, not a named value.
-c — The -c, or check option, is used with the config subcommand and allows the user to parse
the .cfg file to locate syntax errors. If issues are found, the line number and a short description
about the issue is displayed. This option is a check-only.

This subcommand generates error output for any of the following reasons:
•
•

Invalid syntax, group name, object name, index, or other invalid database members.
RACADM CLI failures.

This subcommand returns an indication of the number of configuration objects that were written
out of the total objects in the .cfg file.
Examples

•

•

racadm config -g cfgLanNetworking -o cfgNicIpAddress
10.35.10.100.
Sets the cfgNicIpAddress configuration parameter (object) to the value 10.35.10.110. This IP
address object is contained in the cfgLanNetworking group.
racadm config -f myrac.cfg.
Configures or reconfigures CMC. The myrac.cfg file may be created from the getconfig
command. This file may also be edited manually as long as the parsing rules are followed.
NOTE: The myrac.cfg file does not contain passwords. To include passwords in the file, you
must enter them manually. If you want to remove password information from the myrac.cfg file
during configuration, use the -p option.

connect
Description
Synopsis

Input

Connects to the switch or server serial console.
•
•

racadm connect [-b] 
racadm connect [-b] 

-b — Connects to the switch or console using the binary mode. This is an optional argument; a
server or a switch must be present.
NOTE: If you use the -b option, reset the CMC to terminate the connect operation.
•
•

server-n, where n=1–4
switch-n, where n=1

deploy
Description

Configures the static IP address, subnet mask, gateway, and password for the root
user on iDRAC for the specified server.
To use this subcommand, you must have the Server Administrator privilege.

25

NOTE: You can also use setniccfg to configure static IP address, subnet mask,
gateway, DHCP, speed, and duplex properties.
Synopsis

•
•

•
•
Input

•
•

•

•
•
•
•
•

racadm deploy -m  -u root -p  -s
   -b  -o 
racadm deploy -m  -u root -p  -s -6
   -b  -o

where  is a number between 0 and 128.
racadm deploy -m  -u root -p  -d
[-6]
racadm deploy -a -u root -p 
-b  — Specifies the first boot device; must be used with -o.
Use with -m  to specify for an individual server, or with -a for all servers
Legal values: device=None, PXE, HDD, CD-DVD, vFDD, vCD-DVD, iSCSI, SD, FDD,
RFS
-o  — Indicates if the server should boot from the device once; must be
used with -o.
Use with -m  to specify for an individual server, or with -a for all
servers
-a — Creates and enables an iDRAC root user if it does not already exist, and is
executed on all the existing servers in the chassis
-u root — Indicates that the  is supplied for the root user on the
server. root is a constant parameter, the only value that is valid with the ‑u option.
-m  — Specifies the server you want to configure.
Legal values: server-n where n=1–4
-p  — Specifies the password for the root user on the server.
-s  — Sets the IP address, subnet mask, and
gateway for the specified server, separated by single spaces.
–
–
–

•
•
Output
Example

-d — Enables DHCP for the specified server.
The -s and -d options cannot be used together in the same command.
-6 — Enables IPv6 auto configuration (when used with -d.) Sets static IPv6
addresses (when used with -s).

None
•

•

26

ipaddress — A string representing a valid IP address. For example,
192.168.0.20.
subnet — A string representing a valid subnet mask. For example,
255.255.255.0.
gateway — A string representing a valid gateway address. For example,
192.168.0.1.

racadm deploy -m server-8 -s 192.168.0.20
255.255.255.0 192.168.0.1
The server was deployed successfully.
The deploy command generates an error when used on the extension slot of a
multi-slot server.
racadm deploy -m server-9 192.168.0.11 255.255.255.0
192.168.0.1
ERROR: Server in slot 9 is an extension of the server in slot 1.

•

rracadm deploy -m server-7 -u root -p calvin -s -6 ::/
64 :: 10

Displayable Characters
Displayable characters include the following set:
abcdefghijklmnopqrstuvwxwz
ABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/

eventfilters
Description

Gets, sets, and displays the list of event filter settings.
To use this subcommand with the get option, you must have the CMC Login User
privilege.

Synopsis

racadm eventfilters 
racadm eventfilters get -c 
racadm eventfilters set -c -n

racadm eventfilters set -c -r

NOTE: The general format of an alert descriptor:
cmc.alert.category.[subcategory].[severity]
where, category is mandatory, but subcategory and severity are optional. A severity
cannot precede a subcategory.
Valid category values are:
•
•
•
•
•

System
Config
Updates
Storage
Audit

Valid severity values are:
•
•
•

Critical
Warning
Informational

Valid examples of alert descriptors are:
•

cmc.alert.all

•

cmc.alert.audit

•

cmc.alert.audit.lic

•

cmc.alert.audit.warning

•

cmc.alert.audit.lic.critical

27

Input

•
•
•
•
•

get - Displays the list of event filter settings.
set - Configures the actions and notifications for a given event filter configuration.
-c - Alert descriptor of the specific event filter.
-n - The notification to be sent when the event occurs. Valid values are all, snmp,
ipmi, lcd, email, or none. You can append multiple notifications separated by a
comma. You cannot enter the values all or none with other notifications.
-r - Event generation interval. This is applicable only to the temperature statistics
subcategory - tmps. You can use this option as a stand-alone or with -n .
NOTE: If both event generation interval and notifications are configured and there is
an error while configuring the notifications, the event generation interval is not set.
The valid values are from 0–365. 0 disables the event generation.

Example

28

•

Display all available event filter configurations:
racadm eventfilters get -c cmc.alert.all

•

Display eventfilter configurations for a specific category. For example, audit:
racadm eventfilters get -c cmc.alert.audit

•

Display eventfilter configurations for a specific subcategory. For example, licensing
under the audit category:
racadm eventfilters get -c cmc.alert.audit.lic

•

Display eventfilter configurations for a specific severity. For example, warning under
the audit category:
racadm eventfilters get -c cmc.alert.audit.warning

•

Display eventfilter configurations for a specific severity and subcategory. For
example, a severity of warning in the subcategory licensing under audit category:
racadm eventfilters get -c cmc.alert.audit.lic.warning

•

Clear all available alert settings:
racadm eventfilters set -c cmc.alert.all -n none

•

Configure using severity as a parameter. For example, all informational events in
storage category are assigned poweroff as action, and email and snmp as
notifications:
racadm eventfilters set -c cmc.alert.storage.info -n
email,snmp

•

Configure using subcategory as a parameter. For example, all configurations under
the licensing subcategory in the audit category are assigned poweroff as action and
all notifications are enabled:
racadm eventfilters set -c cmc.alert.audit.lic -n all

•

Configure using subcategory and severity as parameters. For example, all
Information events under the licensing subcategory in the audit category are
assigned poweroff as action and all notifications are disabled:
racadm eventfilters set -c cmc.alert.audit.lic.info n none

•

Configure the event generation interval for temperature statistics:
racadm eventfilters set -c
cmc.alert.system.tmps.warning -r 10

•

Configure the event generation interval and notifications for temperature statistics:
racadm eventfilters set -c cmc.alert.system.tmps -r 5 n snmp

fanoffset
Description

Configures the internal fans to run at a higher speed than the normal speed.
To use this subcommand, you must have the Chassis Configuration Administrator
privilege.

Synopsis

racadm fanoffset [-s 
Valid category values are:
•
•
•
•

off
low
medium
high

Input

s — Sets the fan speed.

Example

•

Disable the fanoffset feature.
racadm fanoffset -s off

•

Increases fan speed by 20% of fan’s maximum speed. Minimum speed for fan is 35%
of the maximum.
racadm fanoffset -s low

•

Increases fan speed by 50% of fan’s maximum speed. Minimum speed for fan is 65%
of the maximum.
racadm fanoffset -s medium

•

Sets fans to run at 100% of fan’s maximum speed.
racadm fanoffset -s high

feature
Description

Displays all active chassis features. The information displayed includes feature name, date activated,
and the serial number of the SD card used to activate the feature.
Dell Feature Cards may contain more than one feature.
NOTE: To use this subcommand to deactivate FlexAddress or ExtendedStorage, you must have
the Chassis Configuration Administrator privilege. A user with login privileges can view status
only.
NOTE: To deactivate FlexAddress features, the chassis must be turned off.

Synopsis

Input

•
•
•

racadm feature -s
racadm feature -d -c 
racadm feature -r -c ExtendedStorage

•
•

-s — Displays the status of active features.
-d — Deactivates the feature specified in -c option.

29

NOTE: When the FlexAddress and FlexAddressPlus features are active, deactivating one of
them results in deactivation of the other feature also. However, ExtendedStorage is not affected
by the deactivation of FlexAddress or FlexAddresPlus.
•

-r — Repair damaged/unformatted ExtendedStorage media.
NOTE: The –r switch requires that the ExtendedStorage feature be deactivated.
CAUTION: Using the -r switch reformats the SD media in the active CMC cardslot. Any existing
ExtendedStorage data will be lost.

•
•
•

-c —  must be one of the following:
flexaddress (with -d)
flexaddressplus (with -d) ExtendedStorage (with -d or -r)

featurecard
Description

Verifies proper SD card installation and displays the SD
card status.
To use this subcommand, you must have the Chassis
Configuration Administrator privilege.

Synopsis

racadm featurecard -s

Input

-s — Lists active SD card features and SD card status.

Output

An example of output is given here.
racadm featurecard -s
Active CMC: The feature card inserted
is valid, serial number =
CN0H871T137401112222A00 The feature
card contains the following feature(s):
FlexAddress: bound
FlexAddressPlus: bound
ExtendedStorage: bound
Standby CMC: The feature card contains
the following feature(s):
FlexAddress: not bound
FlexAddressPlus: not bound
ExtendedStorage: bound

fwupdate
Description

Allows you to update the firmware on the active and standby CMC firmware, chassis
infrastructure firmware, and storage component firmware (RAID controller, hard disk drive, and
expander). You can:
•
•
•
•

30

Check the firmware update process status.
Update the firmware from a FTP or a TFTP server by providing an IP address and optional
path.
Update the firmware from the local file system using remote RACADM.
The subcommand updates one or more devices of a single type at a time.

To use this subcommand, you must have the Chassis Configuration Administrator privilege.
NOTE: Running the subcommand to update the active CMC firmware resets the CMC,
causing all network connections to get logged off. While updating all other modules,
including the standby CMC, the active CMC continues to function normally without resetting.
NOTE: The subcommand generates an error, when used on the extension slot of a multi-slot
server.
Synopsis

•

Using Remote RACADM:
racadm fwupdate -p -u -d 
NOTE: iDRAC7 targets are not supported from CMC. Use the CMC GUI to update iDRAC7
targets from CMC.
When using FTP, if you provide the full path to the image file on the CLI, then the CMC uses
that path to locate that file on the host. If you do not provide a full path, then the CMC
searches the home directory of the specified user for the file if the host system is running
Linux or another variant of UNIX. If the host system is running Windows, then a default folder,
such as C:\ftproot is searched.
NOTE: While performing firmware update using the racadm fwupdate command, if
the number of characters in the firmware image path is greater than 256 characters,
Remote RACADM session logs off with the error message ERROR: Specified
path is too long.

Input

NOTE: Firmware update from local RACADM (using the -p, -u, or -d options) is not supported
on Linux operating system.
•
•
•
•
•

•

•
•

-p — The -p option is used to update the firmware file from the client. The -u option must be
used with the -p option.
-f — The FTP is used to download the firmware.
-g — For CMC, the firmware is downloaded using the TFTP server.
-u — The firmware update operation is performed.
-a — Specifies the TFTP server IP address or FQDN used for the firmware image (used with g).
NOTE: CMC accepts IPv4, IPv6, or fully qualified domain names (FQDN) for both FTP and
TFTP servers.
-d — Specifies the source path where the firmware image is stored.
NOTE: The default source path is local Default: Designated TFTP default directory on
that host for the file if -g option is absent. If -g is used, it defaults to a directory
configured on the TFTP server.
-o — Turns off the servers to perform an update.
-m —
Specifies the module or device to be updated.  is one of the following values:
NOTE: You can also specify multiple modules: –m  –m , and so on.
–
–
–

cmc-active (default)
cmc-standby
iominf-n, where n = 1

–

NOTE: You can specify the cmc-active and cmc-standby modules at the same time
along with one or more server-n modules. This enables the devices to be updated
together.
main-board

31

•

– perc-fqdd, where fqdd is FQDD of the PERC
– expander-fqdd, where fqdd is FQDD of the Storage Expander
– hdd-fqdd, where fqdd is FQDD of the HDD
-s — Displays the current status of the firmware update.
NOTE: Use -m to display the status of the module update. Omit -m to display the status of
the active CMC update.
NOTE: Use all to get the status of all the targets that must be updated.

•
Output

-c — Cancels the current firmware update of a module.

Displays a message indicating the operation that is being performed.

Example

NOTE: The following commands specifically apply to an active-CMC update.
•

Upload a firmware image from the client and start firmware update:
racadm fwupdate -p -u -d firmimg.cmc

•

Upload the firmware image from the TFTP server and start the firmware update:
racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.cmc -m cmcactive
TFTP firmwareate has been initiated. This update process may
take several minutes to complete.

•

Upload the firmware image from the FTP server and start the firmware update.
racadm fwupdate -f 192.168.0.100 fred password123 -d
firmimg.cmc -m cmc-active

•

Start IOM infrastructure firmware update.
racadm fwupdate -u -m iominf-1

•

Update firmware on both the CMCs.
racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.cmc -m cmcactive -m cmc-standby

The following table describes the firmware update methods supported for each interface.
FW Update Method

CMC

Local RACADM

No

Local RACADM - TFTP

No

Local RACADM - FTP

No

Remote RACADM

Yes

Remote RACADM-TFTP

Yes

Remote RACADM-FTP

Yes

Firmware RACADM-TFTP

Yes

Firmware RACADM-FTP

Yes

get
Description

32

Saves CMC Event Filter configuration to a file.

NOTE: Currently, these commands are supported only in remote racadm.
Synopsis

racadm get -f 

Input

–f : save event filter configurations to a file.

Example

–Save event filter configurations to a file by using remote racadm.
racadm -r 10.94.161.119 -u root -p calvin get -f config.txt

getactiveerrors
Description

Displays the active errors in a chassis.
To run this subcommand, you must have the CMC Login User privilege.

Synopsis

racadm getactiveerrors [-s  ] [-m ]

Input

valid values for : critical, warning, info
valid values for : server-n, where n = 1 to 4
switch-n, where n = 1
cmc-n, where n = 1, 2
fan-n, where n = 1 to 6
ps-n, where n = 1 to 4
chassis
kvm

Output

Display entire log:
racadm getactiveerrors
- Display specific module log:
racadm getactiveerrors -m server-1
- Display entire informational log:
racadm getactiveerrors -s info

getassettag
Description

Displays the asset tag for the chassis.
To use this subcommand, you must have the CMC Login
User privilege.

Synopsis

racadm getassettag [-m ]

Input

-m  — Specifies the module whose asset tag
you want to view.
Legal value: chassis

Example

•
•

racadm getassettag -m chassis
racadm getassettag
chassis 78373839–33

33

getchassisname
Description

Displays the name of the chassis.
To use this subcommand, you must have the CMC Login User privilege.

Synopsis

racadm getchassisname

Example

racadm getchassisname
CMC-1

getconfig
Description

Retrieves iDRAC configuration parameters individually, or
all iDRAC configuration groups may be retrieved and
saved to a file.

Synopsis

racadm getconfig -f 
racadm getconfig -g  [-i
]
racadm getconfig -u 
racadm getconfig -h
racadm getconfig -g  -o

[-i index]

Input

•

•

•

•

•
•

34

-f — The -f  option directs getconfig to
write the entire iDRAC configuration to a configuration
file. This file can be used for batch configuration
operations using the config subcommand.
-g — The -g , or group option, can be
used to display the configuration for a single group.
The groupName is the name for the group used in the
racadm.cfg files. If the group is an indexed group, use
the -i option.
-h — The -h, or help option, displays a list of all
available configuration groups in alphabetical order.
This option is useful when you do not have exact
group names.
-i — The -i , or index option, is valid only for
indexed groups and can be used to specify a unique
group. The is a decimal integer from 1 through
n, where n can vary from 1 to maximum number of
indexes a particular group supports. If -i  is not
specified, a value of 1 is assumed for groups, which
are tables that have multiple entries. The index is
specified by the index value, not a named value.
-o — The -o  or object option specifies
the object name that is used in the query. This option
is optional and can be used with the -g option.
-u — The -u , or user name option, can be
used to display the configuration for the specified
user. The  option is the login name for the
user.

•

Output

-v — The -v option displays additional details with the
display of the properties and is used with the -g
option.

This subcommand generates error output upon
encountering either of the following:
•
•

Invalid syntax, group name, object name, index, or
other invalid database members
RACADM CLI transport failures

If errors are not encountered, this subcommand displays
the contents of the specified configuration.
Example

•

Displays all of the configuration properties (objects)
that are contained in the group cfgLanNetworking.
racadm getconfig -g cfgLanNetworking

•

Saves all group configuration objects from iDRAC to
myrac.cfg.
racadm getconfig -f myrac.cfg

•

Displays a list of the available configuration groups on
iDRAC in an alphabetical order.
racadm getconfig -h

•

Displays the configuration properties for the user
named root.
racadm getconfig -u root

•

Displays the user group instance at index 2 with
verbose information for the property values.
racadm getconfig -g cfgUserAdmin -i
2 -v

getdcinfo
Description

Displays general I/O module and daughter card configuration information. Only the
CMC controls daughtercards.
To use this subcommand, you must have the CMC Login User privilege.
NOTE: Fabric verification for server DCs is performed only when the chassis is
turned on. When the chassis is on stand-by power, iDRACs on the server
modules remain turned off and thus are unable to report the server's DC fabric
type. The DC fabric type may not be reported in the CMC user interface until
iDRAC on the server is turned on.

Synopsis

racadm getdcinfo

Input

-n — Displays the model names for the daughter cards in servers.

Example
The following example is for a system with multi-slot servers.
racadm getdcinfo
Group A I/O Type : Gigabit Ethernet
Group B I/O Type : PCIe
Group C I/O Type : PCIe

35









switch-1

Gigabit Ethernet

OK

Master













server-1

Present

PCIe

OK

PCIe

OK

server-2

Not Present

None

N/A

None

N/A

server-3

Present

PCIe

OK

None

N/A

server-4

Not Present

None

N/A

None

N/A

getdcinfo -n








server-1

Present

None

None

server-2

Not Present

None

None

server-3

Not Present

None

None

server-4

Present

None

Broadcom M5708t

getflexaddr
Description

Displays enabled or disabled status for the entire chassis.
If used with -i, the command displays MACs/WWN on a
per-slot–basis.
To use this subcommand, you must have CMC Login User
privilege.
NOTE: If FlexAddress is not activated on the chassis,
the command displays server-assigned MAC/WWN
addresses. If the slot is empty, the command leaves
the server-assigned MAC/WWN addresses blank. If
an external console controls the MAC/WWN
addresses, the command displays an externally
managed message.

Synopsis

racadm getflexaddr [-i ]

Input

-i  — Specifies the slot information to be
displayed.  must be from 1 to 4.

Example
Display current FlexAddress settings for all the slots and fabrics.
racadm getflexaddr

36







1

Enabled

Present

2

Enabled

Present

3

Enabled

Not Present

4

Enabled

Not Present

idrac System Disabled
Display the current FlexAddress setting for slot 1.
racadm getflexaddr -i 1
Slot-1 server presence = Present
Slot-1 flexaddress enabled = 1








slot1-A1

Gigabit Ethernet

00:1C:
23:CD:AC:D2(active)

00:1E:C9:FF:E3:21

iSCSI

00:1C:
23:CD:AC:D3(active)

00:1E:C9:FF:E3:22

getioinfo
Description

Displays general information about the I/O modules on the chassis.
To use this subcommand, you must have the CMC Login User privilege.
NOTE: The fabric type may be any supported I/O fabric type, such as Ethernet, Fiber
Channel, and Infiniband.

Synopsis

racadm getioinfo

Example
racadm getioinfo






switch-1

Dell
Gigabit
Ethernet
Ethernet
Passthroug
h

 





Present

ON

Master

OK

getled
Description

Displays the LED settings on a module: blinking, not
blinking, or unknown (for empty slots).
To use this subcommand, you must have the Login User
privilege.

Synopsis

racadm getled -m 

37

Input

CMC only options:
-m  — Specifies the module whose LED settings
you want to view.
 can be one of the following:
•
•
•
•

Example

server-n where n=1–4
switch-n where n=1
chassis
cmc-active

For CMC:
•
•
•
•

racadm getled -m server-10
  server-10 Blinking
racadm getled -m chassis
  server-10 Not blinking
racadm getled -m server-1
  server-1 ON
racadm getled -m server-9
  server-9 Extension(1)

getmacaddress
Description
Synopsis

Input

Displays the MAC/WWN addresses for all modules or for a specified module.
To use this subcommand, you must have the CMC Login User privilege.
•

racadm getmacaddress [-m ] [-t iscsi] [-x]

•

racadm getmacaddress [-a]

•

-m  — Specifies the module whose MAC address you want to view.
 may be one of the following:
server-n, where n=1–4
switch-n, where n=1

•

-t — Displays the iSCSI MAC addresses for all servers or the specified server if used with -m
option.
-x — Displays the extra MACs (Ethernet or iSCSI) for servers with additional LOM MACs and
must be used with -m option.
-a — Displays the Ethernet and iSCSI MAC/WWN addresses for all iDRAC/LOMs/mezzanine
cards. When FlexAddress is enabled for a particular slot, then the chassis-assigned
MAC/WWN address is displayed.

•
•

Example
Display iSCSI MAC addresses for all servers.
racadm getmacaddress -t iscsi
Display iSCSI MAC for server-1.
racadm getmacaddress -m server-1 -t iscsi
Display extra iSCSI MACs for server-1 (if available).
racadm getmacaddress -m server-1 -t iscsi -x

38

Display MAC for server-1.
racadm getmacaddress -m server-1










server-1

Present

00:11:43:FD:B7: 00:11:43:FD:B7: 00:11:43:FD:B7:
2A
2A
2B

server-4

Extension(1)

N/A

00:11:43:FD:B7: 00:11:43:FD:B7:
2C
2D

Display extra MACs for server-1 (if available).
racadm getmacaddress -m server-1 -x










server-1

Present

00:11:43:FD:B7: 00:11:43:FD:B7: 00:11:43:FD:B7:
2A
2A
2B
00:11:43:FD:B7: 00:11:43:FD:B7:
2C
2D

racadm getmacaddress










CMC

Present

N/A

00:1E:4F:1F:3C: N/A
58

Server-1

Present

00:1E:4F:2A:AF: 00:1E:4F:
7B
2A:D3:97

00:1E:4F:
2A:D3:99

Server-2

Present

00:22:19:D2:1E: N/A
84

N/A

Server-3

Not Present

N/A

N/A

N/A

Server-4

Present

00:18:8B:FF:
45:2A

00:18:8B:FF:AA: 00:18:8B:FF:AA:
02
04

Switch-1

Present

N/A

00:00:00:00:00: N/A
00

Display Ethernet and iSCSI MACS of all LOMs/mezzanine cards.
racadm getmacaddress -a












CMC

N/A

Present

N/A

00:1E:4F:1F: N/A
3C:58

39

Server-1-A

00:1E:4F:
2A:D3:97

00:1E:4F:
2A:D3:99

Present

00:1E:4F:
2A:D3:98

00:1E:4F:
2A:D3:9A

Gigabit
Ethernet

Present

Not
Installed

Not
Installed

iSCSI

Present

Not
Installed

Not
Installed

Server-1-C

Fibre
Channel 4

Present

Not
Installed

Not
Installed

Server-2-A

Gigabit
Ethernet

Present

00:22:19:D2: N/A
1E:84

N/A

iSCSI

Present

N/A

N/A

Gigabit
Ethernet

Present

Not
Installed

Not
Installed

iSCSI

Present

Not
Installed

Not
Installed

Server-2-C

Fibre
Channel 4

Present

Not
Installed

Not
Installed

Server-3

N/A

Not Present

N/A

N/A

N/A

Server-4-A

Gigabit
Ethernet

Present

00:18:8B:FF: 00:18:8B:FF: 00:18:8B:FF:
45:2A
AA:02
AA:04

iSCSI

Present

00:18:8B:FF: 00:18:8B:FF:
AA:03
AA:05

Gigabit
Ethernet

Not Present

Not
Installed

Not
Installed

iSCSI

Present

Not
Installed

Not
Installed

Server-4-C

Fibre
Channel 4

Present

Not
Installed

Not
Installed

Switch-1

None

Present

Server-1-B

Server-2-B

Server-4-B

Gigabit
Ethernet

Present

iSCSI

00:1E:4F:
2A:AF:7B

N/A

00:00:00:00: N/A
00:00

getmodinfo
Description

40

Displays configuration and status information for all modules or a specified module (server, switch,
CMC, fan unit, blower, power supply unit, chassis, DVD, main-board, IO cable, and FPC cable) in the
chassis.
To use this subcommand, you must have CMC Login User privilege.

NOTE: The service tag field is blank for modules that do not have service tags.
Synopsis

racadm getmodinfo [-m ] [-A]

Input

•

-m  — Specifies the module for which the configuration and status information is
required. The default command (no options) displays information about all the major components
in the chassis.
 can be one of the following values:
–
–
–
–
–
–
–
–
–
–
–
–

Example

server-n, where n = 1 to 4
switch-n, where n = 1
CMC-n, where n = 1 or 2
fan-n, where n = 1 to 6
blower-n, where n = 1 to 4
ps-n, where n = 1 to 4
chassis
dvd
main-board
io-cable
fpc-cable
storage

•

-A — Does not display the headers and labels in the output.

•
•

racadm getmodinfo -m switch-1
     Switch-1
Present ON OK CG09074
racadm getmodinfo

•

NOTE: A power state of "Primary" denotes Active CMC.
    
Chassis
Present
ON
OK
PLPC293
Main-Board

Present

ON

OK

N/A

Storage
PLPC293

Present

ON

OK

Fan-1

Present

ON

OK

N/A

Fan-2

Present

ON

OK

N/A

Fan-3

Present

ON

OK

N/A

Fan-4

Present

ON

OK

N/A

Fan-5

Present

ON

OK

N/A

Fan-6

Present

ON

OK

N/A

Blower-1

Present

ON

OK

N/A

Blower-2

Present

ON

OK

N/A

41

Blower-3

Present

ON

OK

N/A

Blower-4

Present

ON

OK

N/A

PS-1

Present

Online

N/A

N/A

PS-2

Present

Online

OK

N/A

PS-3

Not Present

N/A

N/A

N/A

PS-4

Not Present

N/A

N/A

N/A

CMC-1

Present

Standby

OK

N/A

CMC-2

Present

Primary

N/A

N/A

Switch-1

Present

ON

N/A

N/A

Server-1

Present

OFF

OKA

N/A

Server-2

Not Present

N/A

N/A

N/A

Server-3

Present

ON

N/A

N/A

Server-4

Not Present

N/A

OK

N/A

DVD

Present

ON

N/A

N/A

IO-Cable
PLPC293

Present

ON

OK

FPC-Cable
PLPC293

Present

ON

OK

getniccfg
Description

Displays the current NIC settings.

Synopsis

racadm getniccfg

Input

racadm getniccfg
racadm getniccfg –m 
where –m must be one of the following values:
•

chassis

•

: default state if -m is not specified
server-n

•

: where n = 1 to 4
switch-n
: where n = 1

Example

42

racadm getniccfg
NIC Enabled = 1

IPv4 Enabled = 1
DHCP Enabled = 1
Static IP Address = 192.168.0.120
Static Subnet Mask = 255.255.255.0
Static Gateway = 192.168.0.1
Current IP Address = 10.36.0.12
Current Subnet Mask = 255.255.254.0
Current Gateway = 10.36.0.1
IPv6 Enabled = 0
Autoconfiguration Enabled = 1
Static IPv6 Address = ::/64
Static IPv6 Gateway = ::
Link Local Address = ::
Current IPv6 Address 1 = ::
Current IPv6 Gateway = ::
Speed = Autonegotiate
Duplex = Autonegotiate
VLAN Enable = 0
VLAN ID = 1
VLAN priority = 0
racadm getniccfg -m server-1
LOM Model Name = BRCM 10GbE 2P 57810s bNDC
LOM Fabric Type = 10 GbE KR
IPv4 Enabled = 1
DHCP Enabled = 1
IP Address = 10.35.0.159
Subnet Mask = 255.255.255.0
Gateway = 10.35.0.1
IPv6 Enabled = 0
Autoconfiguration Enabled = 0
Link local Address =
IPv6 Gateway = ::
VLAN Enable = 0
VLAN ID = 1
VLAN priority = 0
racadm getniccfg -m switch-1
DHCP Enabled = 1
IP Address = 10.35.155.223
Subnet Mask = 255.255.255.0
Gateway = 0.0.0.0
Output
The getniccfg subcommand displays an appropriate error message if the operation is not successful. Otherwise, the
output is displayed in the following format:

43

IPv4 settings:
NIC Enabled

= 1

IPv4 Enabled = 1
DHCP Enabled

= 1

IP Address

= 10.35.0.64

Subnet Mask

= 255.255.255.0

Gateway

= 10.35.0.1

IPv6 settings:
IPv6 Enabled

= 0

DHCP6 Enabled

= 1

IP Address 1

= ::

Gateway

= ::

Link Local Address = ::
IP Address 2

= ::

IP Address 3

= ::

IP Address 4

= ::

IP Address 5

= ::

IP Address 6

= ::

IP Address 7

= ::

IP Address 8

= ::

IP Address 9

= ::

IP Address 10

= ::

IP Address 11

= ::

IP Address 12

= ::

IP Address 13

= ::

IP Address 14

= ::

IP Address 15

= ::

LOM Status:
NIC Selection

= Dedicated

Link Detected

= Yes

Speed

= 10Mb/s

Duplex Mode

= Half Duplex

getpbinfo
Description

44

Displays power budget status information.

To use this subcommand, you must have the CMC Login User privilege.
Synopsis

racadm getpbinfo

Example
racadm getpbinfo
[Power Budget Status]
System Input Power
Peak System Power
Peak System Power Timestamp
Minimum System Power
Minimum System Power Timestamp
Overall Power Health
Redundancy
System Input Power Cap
Redundancy Policy
Dynamic PSU Engagement Enabled
System Input Max Power Capacity
Input Redundancy Reserve
Input Power Allocated to Servers
Input Power Allocated to Chassis Infrastructure
Total Input Power Available for Allocation
Standby Input Power Capacity
Server Based Power Management Mode
Max Power Conservation Mode
Server Performance Over Power Redundancy
[Chassis Power Supply Status Table]




PS1
Present
Online
1050 W
PS2
Present
Online
1050 W
PS3
Not Present
Slot Empty
N/A
PS4
Not Present
Slot Empty
N/A
[Server

1
M620
2
3
M620
4

=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=

333 W
403 W
15:38:01 06/14/2013
269 W
19:12:27 09/22/2000
OK
Yes
5000 W
Power Supply Redundancy
No
2372 W
1182 W
327 W
427 W
344 W
0 W
No
No
No

 
1.3 A

115.5 V

1.6 A

116.0 V

N/A

N/A

N/A

N/A

Module Power Allocation Table]
 
 
SLOT-01
OFF
0 W
1


PowerEdge

SLOT-02
SLOT-03

N/A
ON

N/A
327 W

1
1

N/A
PowerEdge

SLOT-04

N/A

N/A

1

N/A

getpciecfg
Description

Displays the FQDD of the PCIe slots and Virtual Adapters, and their mapping information and
properties.
NOTE: To use this subcommand, you must have the CMC Login User privilege.

Synopsis

racadm getpciecfg [-c ][a]

Input

•

-a — Use this option to display the assignment of PCIe slots and Virtual Adapters.

45

Example

•
•
•

-c — Use this option to select a specific PCIe adapter or Virtual Adapter.
FQDD — FQDD of the selected PCIe slot or Virtual Adapter.
-r — Use this option to view the ride-through configuration settings.

•

Displays FQDDs of all the PCIe slots and PCIe Virtual Adapters:
racadm getpciecfg

•


PCIe slot 01
PCIe slot 02
PCIe slot 03
PCIe slot 04
PCIe slot 05
PCIe slot 06
PCIe slot 07
PCIe slot 08


PCIE.ChassisSlot.1
PCIE.ChassisSlot.2
PCIE.ChassisSlot.3
PCIE.ChassisSlot.4
PCIE.ChassisSlot.5
PCIE.ChassisSlot.6
PCIE.ChassisSlot.7
PCIE.ChassisSlot.8


PCIe slot 09
1-1-1
PCIe slot 09
1-1-2
PCIe slot 09
1-1-3
PCIe slot 09
1-1-4


Virtual Adapter 01


RAID.ChassisIntegrated.

Virtual Adapter 02

RAID.ChassisIntegrated.

Virtual Adapter 03

RAID.ChassisIntegrated.

Virtual Adapter 04

RAID.ChassisIntegrated.

PCIe slot
2-1-1
PCIe slot
2-1-2
PCIe slot
2-1-3
PCIe slot
2-1-4

10

Virtual Adapter 01

RAID.ChassisIntegrated.

10

Virtual Adapter 02

RAID.ChassisIntegrated.

10

Virtual Adapter 03

RAID.ChassisIntegrated.

10

Virtual Adapter 04

RAID.ChassisIntegrated.

Displays the assignment of PCIe slots and vitual adapters:
racadm getpciecfg -a
 
 
Slot#> 
1
Empty
N/A
Unmapped
A
N/A
2
QLogic Corp OFF
Unmapped
A
N/A
3
Empty
N/A
Unmapped
A
N/A
4
Empty
N/A
Unmapped
A
N/A
5
Empty
N/A
Unmapped
A
N/A
6
Empty
N/A
Unmapped
A
N/A
7
Empty
N/A
Unmapped
A
N/A
8
Empty
N/A
Unmapped
A
N/A

    
9
1
1
9
2
2
9
3
3
9
4
A
10
1
10
2
10
3
10
A

N/A

1
2
3
4

N/A

SLOT-01
Present
SLOT-02
Not Present
SLOT-03
Present
Unmapped

N/

SLOT-01
Present
SLOT-02
Not Present
SLOT-03
Present
Unmapped

N/

•

Displays the properties of a PCIe slot selected using FQDD:
racadm getpciecfg -c pcie.chassisslot.1

•

Displays the properties of a Virtual Adapter selected using FQDD:
racadm getpciecfg -c RAID.ChassisIntegrated.2-1-4

•

Displays the ride-through properties of the system
racadm getpciecfg -r
Ride-through mode is enabled
Ride-through timeout 1800 secs

getpminfo
Description

Displays power management status information.
To use this subcommand, you must have CMC Login User
privilege.

Synopsis

racadm getpminfo

Example

racadm getpminfo
[Real-Time Power Statistics]
System Input Power
W (188 BTU/hr)
Peak System Power
W (188 BTU/hr
Peak System Power Start Time
16:02:10 01/16/2008
Peak System Power Timestamp
06:32:55 01/26/2009
Minimum System Power
W (177 BTU/hr)
Minimum System Power Start Time
22:43:21 01/21/2008
Minimum System Power Timestamp
06:32:55 01/26/2009
System Idle Power
(188 BTU/hr)
System Potential Power
(188 BTU/hr)

= 600
= 600
=
=
= 400
=
=
= 68 W
= 68 W

47

System Input Current Reading
A

= 31.2

[Real-Time Energy Statistics]
System Energy
Consumption
= 6.4 kWh
System Energy Consumption Start
Time
= 16:02:10 01/16/2008
System Energy Consumption
Timestamp
= 16:02:10 01/16/2008
[System Power Status]
Chassis Power State
= ON
Overall Power Health = OK
Redundancy = No
[System Power Policy Configuration]
System Input Power
Cap
= 7928 W (7928
BTU/hr |
10%)
Surplus for Peak
Performance
= 7000 W (6130
BTU/hr)
Redundancy Policy
= None
Dynamic PSU Engagement Enabled
= No
[Power Budgeting]
System Input Max Power
Capacity
= 0 W
Input Redundancy
Reserve
= 0 W
Input Power Allocated to
Servers
= 0 W
Input Power Allocated to Chassis
Infrastructure = 51W
Total Input Power Available for
Allocation = 0 W
Standby Input Power
Capacity
= 0 W

getraclog
Description

The getraclog command displays RAC log entries.

Synopsis

racadm getraclog [-s ] [-c ]

Input

NOTE: If no options are provided, the entire log is displayed.
•
•
•

48

-c — Specifies the number of records to display.
-s — Specifies the starting record used for the display.
--more — Displays one screen at a time and prompts the user to continue.

Output

The default output display shows the record number, message ID, category, agent ID, severity, time
stamp, message arg, and message. The timestamp begins at midnight, January 1, and increases until
the system restarts. After the system restarts, the system’s timestamp is used.
SeqNumber
= 4
Message ID
= CMC8550
Category
= Audit
AgentID
= CMC
Severity
= Information
Timestamp
= 1982-03-21 05:33:35
Message Arg
1
= Healthy
Message
= Chassis health is Healthy

Example

•

Displays all the logs.
racadm getraclog

•

Displays 3 records from record number 5:
racadm getraclog -s 5 -c 3

getractime
Description
Synopsis

Input

Displays the current iDRAC time.
•
•
•

racadm getractime [-d]
racadm getractime [-d][-z]
racadm getractime [-n]

•
•
•

-d — Displays the time in the format, yyyymmddhhmmss.mmmmmms.
-z — Displays timezone. This option is specific to CMC only.
-n — Displays NTP peer information. This option is specific to CMC only.
NOTE: If no options are provided, the getractime subcommand displays the time in a common
readable format.

Output
Example

The current iDRAC time is displayed.
•
•

racadm getractime
Thu Dec 8 20:15:26 2005
racadm getractime -d
20051208201542.000000

getredundancymode
Description

Displays the redundancy status (Redundant or NonRedundant) of the CMC.
To use this subcommand, you must have CMC Login User
privilege.

Synopsis

racadm getredundancymode

Example

racadm getredundancymode
Redundant

49

getsel
Description
Synopsis

Displays all sensor event log entries in the DRAC.
•
•

racadm getsel -i [-A]
racadm getsel [-s ] [-c ] [-A] [-o] [-E] [-R] [--more]

If no arguments are specified, the entire log is displayed.
Input

•
•
•
•
•
•
•
•

-A — Specifies output with no display headers or labels.
-c — Provides the number of records to be displayed.
-o — Displays each entry in the SEL in a single line.
-s — Specifies the starting record used for the display.
-E — Displays RAW SEL data with the other data for each entry.
-R — Displays only RAW SEL data for each entry.
-i — Displays the number of entries in the SEL.
--more — Displays one screen at a time and prompts the user to continue (similar to the UNIX
more command.)
NOTE: The -A, -E, -o, and -R options are deprecated.

Output

Record: 12
Date/Time: 11/20/2011 14:19:34
Source: system
Severity: Ok
Description: C: boot completed.

Example

racadm getsel

getsensorinfo
Description

Displays status of chassis sensors.
NOTE: To use this subcommand, you must have CMC Login User privilege.

Synopsis

racadm getsensorinfo

Examples

racadm getsensorinfo
Sensor Type : FanSpeed
Sensor Units : rpm

50













UC

Fan-1

OK

0

840

600

N/A

N/A

Fan-2

OK

0

840

600

N/A

N/A

Fan-3

OK

4037

840

600

N/A

N/A

Fan-4

OK

4045

840

600

N/A

N/A

Fan-5

OK

4107

840

600

N/A

N/A

Fan-6

OK

0

840

600

N/A

N/A

Blower-1

N/A

0

3000

2250

N/A

N/A

Blower-2

N/A

0

3000

2250

N/A

N/A

Blower-3

N/A

0

3000

2250

N/A

N/A

Blower-4

N/A

2611

3000

2250

N/A

N/A

Sensor Type : Temperature
Sensor Units : Celsius














Chassis
Ambient

OK

22

3

-7

42

47

Server-4

OK

20

3

-7

42

47

Sensor Type : Power
  
PS-1
Slot Empty
N/A
PS-2
Online
OK
PS-3
Slot Empty
N/A
PS-4
Slot Empty
N/A
Sensor Type : Cable
 
IO-Cable
OK
FPC-Cable
OK
Sensor Type : Intrusion
 
Chassis Intrusion Closed

getslotname
Description

Displays the name and host name (if available) of all the four slots, or of a specified slot
(indicated by the slot number) in the chassis. Optionally, use this command to find if the slot
name or host name is displayed in the CMC Web interface, or with the getslotname [-i
 | -h] command. If the host name is not available, the static slot name is used.
To use this subcommand, you must have CMC Login User privilege.

Synopsis

•
•
•

racadm getslotname
racadm getslotname [-i  | -h]
racadm getslotname -h

Input

•

None Displays the slot name for all the four slots in the chassis.

51

-i  - specifies the slot number.
Values: 1 to 4
-h - Specifies whether to display the slot name or the host name (if available). 1 displays
host names and 0 displays slot names.

•
•
Example

•

Display all slots names.
racadm getslotname
 
1
SLOT-01
2
Webserver01
3
Webserver3
4
SLOT-04


WXP-8GRB221
WXP-319QWEecet5

•

Display the name of the third slot.
racadm getslotname -i 3

•

Verify if the option (1 is Active) for displaying host names is set.

getssninfo
Description

Displays a list of users that are connected to iDRAC. The following information is displayed:
•
•
•
•
•

Session ID
Username
IP address (if applicable)
Session type (for example, serial or Telnet)
Login date and time in MM/DD/YYYY HH:MM:SS format
NOTE: Based on the Session ID (SSNID) or the user name (User), the iDRAC administrator
can close the respective sessions or all the sessions using the, closessn subcommand.
For more information, see closessn.

Synopsis
Input

racadm getssninfo [-A] [-u  | *]
•
•

-A - eliminates the printing of data headers.
-u - The -u  user name option limits the printed output to only the detail session
records for the given user name.

Examples
racadm getssninfo
SSNID

Type

User

IP Address

Login Date/Time

6

GUI

root

192.168.0.10

04/07/2010 12:00:34

racadm getssninfo -A
"root" "143.166.174.19" "Telnet" "NONE"
racadm getssninfo -A -u *
"root" "143.166.174.19" "Telnet" "NONE"
"bob" "143.166.174.19" "GUI" "NONE"

52

getsvctag
Description

Displays the service tag of the host system.

Synopsis

racadm getsvctag

Input

getsvctag

Output


Chassis
Switch-1
Server-1
Server-2
Server-3
Server-4

Example

racadm getsvctag


PLPC033
N/A
7654321
N/A
Extension(1)
PLSMS04

getsysinfo
Description

Displays information related to CMC and chassis.
NOTE: The Hostname and OS Name fields in the getsysinfo output display accurate information
only if Dell OpenManage Server Administrator is installed on the managed system. Else, these
fields may be blank or inaccurate. An exception to this are VMware operating system names,
which are displayed even if Server Administrator is not installed on the managed system.

Synopsis

racadm getsysinfo [-d] [-c] [-A] [-4] [-6]

Input

•
•
•
•
•

Output

CMC Information:
CMC Date/Time
Primary CMC Location
Primary CMC Version
Standby CMC Version
Last Firmware Update
Hardware Version

=
=
=
=
=
=

Sat Mar 27 1982 11:36
CMC-1
1.00
N/A
Sun Mar 21 1982 05:53
X12

CMC Network Information:
NIC Enabled
MAC Address
Register DNS CMC Name
DNS CMC Name
Current DNS Domain
VLAN ID
VLAN Priority
VLAN Enabled

=
=
=
=
=
=
=
=

1
78:45:C4:F7:8B:29
1
cmc-servicetag
swtest.com
1
0
0

CMC IPv4 Information:
IPv4 Enabled

= 1

-d - Displays CMC information.
-c - Displays chassis information.
-A - Does not display headers and labels.
-4 - Displays IPv4 information.
-6 - Displays IPv6 information.

53

Examples

Current IP Address
Current IP Gateway
Current IP Netmask
DHCP Enabled
Current DNS Server 1
Current DNS Server 2
DNS Servers from DHCP

=
=
=
=
=
=
=

10.94.237.30
10.94.237.1
255.255.255.128
1
10.94.175.2
0.0.0.0
1

CMC IPv6 Information:
IPv6 Enabled
Autoconfiguration Enabled
Link Local Address
Current IPv6 Address 1
Current IPv6 Gateway
Current IPv6 DNS Server 1
Current IPv6 DNS Server 2
DNS Servers from DHCPv6

=
=
=
=
=
=
=
=

0
1
::
::
::
::
::
1

Chassis Information:
System Model
System AssetTag
Service Tag
Express Service Code
Chassis Name
Chassis Location
Chassis Midplane Version
Power Status
System ID

=
=
=
=
=
=
=
=
=

PowerEdge VRTX
00000
CMC[UNDEFINED]
1.0
ON
1487

racadm getsysinfo -d
racadm getsysinfo -c
racadm getsysinfo -A
racadm getsysinfo -4
racadm getsysinfo -6

gettracelog
Description
Synopsis

Input

Lists all the trace log entries in iDRAC and CMC.
•

racadm gettracelog -i [-A]

•

racadm gettracelog [-s ] [-c ] [--more] [-A] [-o]

•
•

-i - Displays the number of entries in iDRAC trace log.
--more - Displays one screen at a time and prompts the user to continue (similar to the UNIX
more command).
-o - Displays each entry in a single line.
-c - Specifies the number of records to display.
-s - Specifies the starting record to display.
-A - Does not display headers or labels.

•
•
•
•

NOTE: The -A and -o options are deprecated.

54

Output

The default output display shows the record number, timestamp, source, and description. The
timestamp begins at midnight, January 1 and increases until the system boots. After the system
boots, the system’s timestamp is used.

Example

Record:

1

Date/Time:

Dec

Source:

ssnmgrd[175]

8 08:21:30

Description: root from 143.166.157.103: session timeout
sid 0be0aef4

getversion
Description

Displays the current firmware version of various modules in the chassis, iDRAC version on the
attached servers, and whether the target device can be updated.
NOTE: To use this subcommand, you must have CMC Login User privilege.

Synopsis

•
•
•

Input

racadm getversion
racadm getversion [-b | -c] [-m ]
racadm getversion -l [-m ] [-f ]
NOTE: The -b, -c and -l options are not available for CMC modules.
NOTE: The -l option requires that the Lifecycle Controller service is enabled on the servers. For
version information, see the RACADM Readme available at dell.com/support/manuals.

•

(none) — Displays the version information for all targets or devices.





server-4
1.30.30 (Build 26)
PowerEdge M620
iDRAC7
Y

cmc-1


1.00.X23.201211271524


Y



Main Board
1.00.X08.201210242214
System.Chassis.1#Infrastructure.1


PERC H710PV Mini
23.8.0-0007
RAID.ChassisIntegrated.1-1


PL100 0:0
0.12
Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1










Physical Disk 0:0:0
ES65
Disk.Bay.
0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1
•
•
•
•

-b - Displays the server's current BIOS version (default is iDRAC version).
-c - Displays the server's current CPLD version.
-l - Displays the firmware versions Lifecycle Controller components.
-f  - Filters the components. Must be used with -1 and be one of the following values:

55

•

– bios: BIOS
– idrac: iDRAC
– usc: Unified Server Configurator (Lifecycle Controller)
– diag: 32-bit Diagnostics
– drivers: OS Driver Package
– nic-x: Network Interface card. See -l output for possible values of x.
– raid-x: RIAD Controller. See -l output for possible values of x.
-m  - Specifies the module or device for which you must retrieve the version
information.
 is one of the following:
–
–
–
–
–
–
–
–
–
–

Example

server-n, where n = 1 to 4. For example, cmc-2.
switch-n, where n = 1
CMC-n, where n = 1 or 2
mainboard
perc
expander
hdd
perc-fqdd, where fqdd is FQDD of the PERC.
expander-fqdd, where fqdd is FQDD of the Storage Expander.
hdd-fqdd, where fqdd is FQDD of the HDD.

•

Retrieve the version for a server 4
racadm getversion -m server-4

•

Retrieve the Lifecycle Controller component versions for servers 1 and 3:
racadm getversion -l -m server-1 -m server-3

•

Retrieve the Lifecycle Controller BIOS versions for servers 1 and 3:
racadm getversion -l -m server-1 -m server-3 -f bios

•

Retrieve the version for all modules:
racadm getversion

•

Retrieve the iDRAC version in all the servers that are attached to the chassis:
racadm getversion -f idrac

ifconfig
Description

Displays the contents of the network interface table.
To use this subcommand, you must have the Execute
Diagnostic Commands or Configure iDRAC privilege.

Synopsis

racadm ifconfig

56

Example

$ racadm ifconfig
eth0
Link encap:Ethernet
00:1D:09:FF:DA:23

HWaddr

inet addr:10.35.155.136
Bcast:10.35.155.255
Mask:255.255.255.0
MULTICAST
Metric:1

UP BROADCAST RUNNING
MTU:1500

RX packets:2550665
errors:0 dropped:0 overruns:0
frame:0
TX packets:0 errors:0
dropped:0 overruns:0
carrier:0
1000
(259.9 MiB)
(0.0 B)

collisions:0 txqueuelen:
RX bytes:272532097
TX bytes:0

jobqueue
Description

Displays the jobs in that are currently being run, delete the jobs, and create a job.
NOTE: To view the jobs, you must have CMC Login User privilege.
NOTE: To delete the jobs, you must have Chassis Configuration Administrator
privilege.

Synopsis

racadm jobqueue view
racadm jobqueue delete
racadm jobqueue create

Input

•
•
•
•
•
•

Example

•

—i — Specifies the JobID that is displayed or deleted.
– –all — The JobIDs that are not applied are deleted.
 — Specifies an FQDD for which a job has to be created.
reboot type — Specifies a reboot type. Valid options are none: No Reboot Job which
is the default.
start time — Specifies a start time for job to be scheduled in yyyymmddhhmmss
format. If you specify TIME_NOW, the job is immediately run.
Expiration time — Specifies the expiry time for the job to complete in
yyyymmddhhmmss format. If you specify TIME_NA, the wait-time is not applicable for
the job.
Display all the jobs:
-------------------------JOB
QUEUE-----------------------[Job ID=RID_853106266329]

57

Job Name=Reboot4
Status=New
Start Time=[NOW]
Expiration Time=[NOW]
--------------------------------------------------------[Job ID=RID_852218430518]
Job Name=Reboot4
Status=New
Start Time=[NOW]
Expiration Time=[NOW]
--------------------------------------------------------[Job ID=RID_852215634901]
Job Name=Reboot4
Status=New
Start Time=[NOW]
Expiration Time=[NOW]
--------------------------------------------------------[Job ID=JID_852215394003]
Job Name=ConfigRAID:GUI:RAID.ChassisIntegrated.1-1
Status=New
Start Time=[NOW]
Expiration Time=[NOW]
--------------------------------------------------------•

Delete the specified job:
racadm jobqueue delete -i RID_860202993201

•

Job being created to turn on the RAID controller installed in the chassis.
racadm jobqueue create RAID.ChassisIntegrated.1-1 -r
pwrup -s TIME_NOW -e 20120501100000

•

racadm jobqueue delete -i 

krbkeytabupload
Description

Uploads a Kerberos keytab file.
To use this subcommand, you must have the Configure
iDRAC permission.

Synopsis

racadm krbkeytabupload [-f ]
 is the name of the file
including the path.

Input

-f — Specifies the file name of the keytab to be uploaded.
If the file is not specified, the keytab file in the current
directory is selected.

Output

Returns 0 when successful, and a non–zero number, when
unsuccessful.

Example

racadm krbkeytabupload -f c:\keytab
\krbkeytab.tab

58

license
Description

Manages the CMC licenses.

Synopsis

racadm license . The command type can be:
•

View the license using the following options:

•

– racadm license view
– racadm license view [-c ]
racadm license import [-u ] [-p ] [-f
] [-l ] [-c ]
Export the license using the following options:

•

–

•

•

Input

racadm license export [-u ] [-p ] [f ] [-1 ] [—t
]
– racadm license export [-u ] [-p ] [f ] [-1 ] [—e
]
– racadm license export [-u ] [-p ] [f ] [-1 ] [—c ]
– racadm license export [-u ] [-p ] [f ] [-1 ] [—c ]
[—e ] [—t ]
Delete the license using the following options:
– racadm license delete [-t ]
– racadm license delete [-e ]
– racadm license delete [-c ] [-p ] [f ] [-1 ] [—t
]
NOTE: License operations the  name should be less than 56 Characters.
NOTE: During Remote file share, SSH/telnet supports the Import and Export options.
NOTE: Only a user with administrator-level privileges can use the import, export,
delete, and replace commands. An Administrator privilege is not necessary to use the
view command.

•
•
•
•
•

view — View license information.
import — Installs a new license.
export — Exports a license file.
delete — Deletes a license from the system.
replace — Replaces an older license with a given license file.

Use the following options along with the commands:
•
•
•

-c — Specifies the FQDD of the component or device, on which the license is present.
-l — Network share location to import or export the license file.
-f — File name of the license file.

59

NOTE: During export, the license file is named _.xml.

Examples

•
•
•
•

-u— User name of the remote share.
-p — Password for the remote share.
-e — Specifies the entitlement ID of the license file.
-t — Specifies the transaction ID of the license file.

•

View licenses:
–

View all the license information in the chassis.
racadm license view
CMC.Integrated.1
Status
= OK
Device
= CMC.Integrated.1
Device Description
= Chassis Management
Controller for PowerEdge VRTX
Unique Identifier
=
License #1
Status
= OK
Transaction ID
= 8
License Description = CMC
Enterprise Evaluation License
License Type

=

Entitlement ID

=

Expiration

=

EVALUATION
A2Wir6lJ1MoP8iBAtqsEKDv8
1982-04-07T21:00:00
–
•

•

60

Display licenses available on a specific device. For example, for RAID slot 4:
racadm license view -c RAID.slot.4

Import a license:
–

Import a license from a CIFS share to a device (for example, Integrated CMC):
racadm license import -u admin -p passwd -f License.xml
-l //192.168.2.140/licshare -c cmc.integrated.1

–

Import a license from an NFS share to a device (for example, Integrated CMC):
racadm license import -f License.xml -l 192.168.2.14:/
share -c cmc.integrated.1

–

Import a license from the local file system using Remote RACADM:
racadm license import -u admin -p passwd -r
192.168.0.120 -f C:\Mylicdir\License.xml -c
cmc.integrated.1

Export a license file:
–

Export license to an NFS share using transaction ID (for example, transaction 27).
racadm license export -f License.xml -l 192.168.2.140:/
licshare -t 27

–

Export the license to a CIFS share specifying the entitlement ID (for example,
abcdxyz):
racadm license export -u admin -p passwd -f License.xml
-l //192.168.2.140/licshare -e abcdxyz

–

Export license to a CIFS share specifying the FQDD. While using the -c option and
exporting licenses from a device, more than one license file must be exported.

Therefore, if a file name is provided, an index is appended to the end of the file name
such as LicenseFile0.xml, LicenseFile1.xml, and so on. In this case, the device is an
embedded CMC:
racadm license export -u root -p calvin -f
LicenseFile.xml -l //192.168.2.140/licshare -c
cmc.embedded.1
•

•

Delete a license:
–

Delete licenses on a particular device. For example. Embedded CMC:
racadm license delete -c cmc.embedded.1

–

Delete license using an entitlement ID. For example, xYZabcdefg
racadm license delete -e xYZabcdefg

–

Delete license using a transaction ID. For example, 2.
racadm license delete -t 2

Replace a license.
–

Replace the license on a device with a license file that is located on an NFS share,
and using a transaction ID. For example, transaction 27.
racadm license replace -f License.xml -l 192.168.2.140:/
licshare -t 27

–

Replace license on a device with a license file that is located on a CIFS share and
using a transaction ID. For example, transaction 27.
racadm license replace -u admin -p passwd -f
License.xml -l //192.168.2.140/licshare -t 27

–

Replace license on a device with a license file on the local file system.
racadm license replace -f License.xml -t 27

netstat
Description

Displays the routing table and the current connections.
To use this subcommand, you must have the Execute
Diagnostic Commands privilege.

Synopsis

racadm netstat

Input

racadm netstat

Output

Kernel IPv6 routing table
Destination
Next
Hop
Flags Metric Ref
Use Iface
::
1/128
::
U
0
30
1 lo
fe80::200:ff:fe00:d01/128
::
U
0
0
1 lo
fe80::/64
::
U
256
0
0 eth1
ff00::/8
::

61

U

256

0

0 eth1

Kernel IP routing table
Destination
Gateway
Genmask
Flags
MSS Window
irtt Iface
10.94.161.0
0.0.0.0
255.255.255.0
U
0 0
0 bond0
0.0.0.0
10.94.161.1
0.0.0.0
UG
0 0
0 bond0
Active Internet connections (w/o
servers)
Proto Recv-Q Send-Q Local
Address
Foreign
Address
State
tcp
0
0
127.0.0.1:8195
127.0.0.1:52887
ESTABLISHED
tcp
0
0
127.0.0.1:199
127.0.0.1:52174
ESTABLISHED
tcp
0
0
127.0.0.1:52175
127.0.0.1:199
ESTABLISHED
tcp
0
0
127.0.0.1:199
127.0.0.1:52175
ESTABLISHED
tcp
0
0
10.94.161.120:22
10.94.115.237:45106
ESTABLISHED
tcp
0
0
127.0.0.1:52174
127.0.0.1:199
ESTABLISHED
tcp
0
0
127.0.0.1:52887
127.0.0.1:8195
ESTABLISHED

ping
Description

Verifies that the destination IP4address is reachable from iDRAC with the current
routing-table contents. A destination IP4address is required. An ICMP echo packet is
sent to the destination IP address based on the current routing-table contents.
To use this subcommand for CMC, you must have the Administrator privilege for CMC,
and for iDRAC you must have the Execute Diagnostic Commands privilege.

Synopsis

racadm ping 

ping6
Description

62

Verifies that the destination IPv6 address is reachable
from an iDRAC or CMC, or with the current routing-table
contents. A destination IPv6 address is required. An ICMP

echo packet is sent to the destination IPv6 address on the
basis of current routing-table contents.
To use this subcommand for CMC, you must have the
Administrator privilege.
Synopsis

racadm ping6 

Example

racadm iping6 10.9.72.254
IPING6 10.9.72.254 (10.9.72.254): 56
data bytes
64 bytes from 10.9.72.254: icmp_seq=0
ttl=121 time=2.9
ms
--- 10.9.72.254 ping statistics --1 packets transmitted, 1 packets
received, 0 percent
packet loss
round-trip min/avg/max = 2.9/2.9/2.9 ms

racdump
Description

This subcommand displays the comprehensive chassis
status and configuration state information, and historic
event logs. Used for post-deployment configuration
verification and during debugging sessions.
To use this subcommand for CMC, you must have the
Administrator privilege.

Synopsis

racadm racdump

Input

Racdump includes the following subsystems and
aggregates the following RACADM commands:
•
•
•
•
•
•
•
•
•
•
•
•
•

General System/RAC information - getsysinfo
Session information - getssinfo
Sensor information - getsensorinfo
Switches information (IO Module) - getioinfo
Mezzanine card information (Daughter card) getdcinfo
All modules information - getmodinfo
Power budget information - getpbinfo
KVM information - getkvminfo
NIC information (CMC module) - getniccfg
Redundancy information - getredundancymode
Trace log information - gettracelog
RAC event log - getraclog
System event log - getsel

63

Output

The following information is displayed when the
racdumpsubcommand is processed:
•
•
•
•
•

General system/RAC information
Coredump
Session information
Process information
Firmware build information

racreset
Description

Performs a CMC or a RAC reset operation.
NOTE: To use this subcommand, you must have the Chassis Administrator
privilege.
NOTE: When you run a racreset subcommand, iDRAC may require up to two
minutes to return to a usable state.
NOTE: You must restart your system after performing a hard reset of iDRAC.

Synopsis

racadm racreset [-m ]

Input

(module) — server-n, where n=1–4.
NOTE: You can specify multiple modules: -m  –m .

Example

•

Reset CMC:
racadm racreset

•

Reset server 1.
racadm racreset -m server-1

•

Reset servers 1 and 3.
racadm racreset -m server-1 -m server-3

racresetcfg
Description

Resets CMC configuration to factory default settings.
NOTE: To use this, you must have the Chassis Administrator privilege.

Synopsis

racadm racresetcfg [-m ] [-c ]

Input

•

-m :  — Must be one of the following values:

•

– chassis — default state, if -m is not specified.
– server-n, where n=1–4
– switch-n, where n=1
-c :  — Must be one of the following values:
–

64

ad — Reset Active Directory properties to the default value. The default setting is
“disabled”.

–
–
–

pcap — Reset Power Cap properties to the default value.
flex — Reset FlexAddress properties to the default value. The default setting is “enabled”.
dpse — Reset Dynamic Power Supply Engagement to the default value. The default setting
is “disabled”.
NOTE: The –c option is valid with only .

Example

•

Perform reset of configuration data to defaults for server-1 module
racadm racresetcfg -m server-1

•

Perform reset of power cap feature.
racadm racresetcfg -c pcap

•

Perform reset of configuration data to default for switch-1 module
racadm racresetcfg -m switch-1

racresetpcie
Description

Resets the PCIe devices in the chassis to factory defaults.
NOTE: To use this subcommand for CMC, you must have the Chassis
Administrator privilege.
racadm racresetpcie

Synopsis

raid
Description

Allows you to execute commands to control RAID arrays.
To use this subcommand for CMC you must have Chassis Administartor privilege.

Synopsis

racadm raid

Example
•

Monitor Health of Storage root node
racadm raid get status
Storage Root Node Status : Ok
This command retrieves the controllers keys, (FQDDs.)

•

Monitor and Inventory all Controllers connected to the server
racadm raid get controllers
racadm raid get controllers -o
This command is an optimized version and displays the full controller objects along with their keys.
racadm raid get controllers -o -p 
This command displays the filtered property values for all returned controller objects.

•

Monitor and Inventory all batteries connected to the controller
racadm raid get batteries --refkey 

65

This command displays all battery keys connected to the controllers referred to as refkeys.
racadm raid get batteries --refkey  -o
This command is an optimized version and displays all battery objects for the controller FQDD.
racadm raid get batteries --refkey  -o -p 
This command is an optimized and filtered version.
racadm raid get batteries --refkey  -o -p 
•

Monitor and Inventory all virtual disks connected to the controller
racadm raid get vdisks --refkey 
This command displays all vdisk keys connected to the controllers being mentioned as refkeys.
racadm raid get vdisks --refkey  -o
This command is an optimized version and displays all vdisk objects for the controller FQDD.
racadm raid get  -pending
Raid.Integrated.1-1
Raid.Slot.2-1

•

Monitor and Inventory all storage enclosures connected to the connector
racadm raid get enclosures --refkey 
This command displays all enclosure keys connected to the connectors being mentioned as refkeys.
racadm raid get enclosures --refkey  -o optimized version.
This command displays all enclosure objects for the connector FQDD.
racadm raid get enclosures --refkey  -o -p 
This command is an optimized and filtered version.

•

Monitor and Inventory all Physical Disks connected to the enclosure /Backplanes
racadm raid get pdisks --refkey 
This command displays all physical disk keys connected to the enclosures being mentioned as refkeys.
racadm raid get pdiks --refkey  -o
This command is an optimized version and displays all disk objects for the enclosure FQDD.
racadm raid get pdisks --refkey  -o -p 
optimized and filtered version.

•

Monitor and Inventory all Fans connected to the enclosure
racadm raid get fans --refkey 
This command displays all fan keys connected to the enclosures referred as refkeys.
racadm raid get fans --refkey  -o optimized version.

66

This command displays all fan objects for the enclosure FQDD.
racadm raid get fans --refkey  -o -p  optimized and
filtered version.
•

Monitor and Inventory all EMMs connected to the enclosure
racadm raid get emms --refkey 
This command will return all EMM keys connected to the enclosures being mentioned as refkeys.
racadm raid get emms --refkey  -o
This command is an optimized version and displays all EMM objects for the enclosure FQDD.
racadm raid get emms --refkey  -o -p 
This command is an optimized and filtered version.

•

Monitor and Inventory all Temperature Probes connected to the enclosure
racadm raid get tempprobes --refkey 
This command displays all temperature probe keys connected to the enclosures being mentioned as refkeys.
racadm raid get tempprobes --refkey  -o
This command is an optimized version and displays all temperature probe objects for the enclosure FQDD.
racadm raid get tempprobes --refkey  -o -p 
optimized and filtered version

•

Monitor and Inventory all Power Supply Units connected to the enclosure
racadm raid get psus --refkey 
This command displays all power supply units connected to the enclosures being mentioned as refkeys.
racadm raid get psus --refkey  -o
This command is an optimized version and displays all power supply units objects for the enclosure FQDD.
racadm raid get psus --refkey  -o -p 
This command is an optimized and filtered version.

blink
Description

Starts blinking or identifies operation on the specified device.

Synopsis

racadm raid blink:
racadm raid blink:
racadm raid blink {-pdkey: -rl {r0|r1|r5|r6|r10|r50|
r60}[-wp {wt|wb}] [-rp {nra|ra|ara}]
[-ss {1k|2k|4k|8k|16k|32k|64k|128k|256k|512k|1M|2M|4M|8M|16M}]
-pdkey: [-dcp {enabled|disabled|default}]
[-name:] [-size {b|k|m|g|t}] [-cc] {-current|pending}

Input

•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•

-rl: Set the RAID Level.
r0: RAID 0 – Striping.
r1: RAID 1 – Mirroring.
r5: RAID 5 – Striping with Parity.
r6: RAID 6 – Striping with Extra Parity.
r10: RAID 10 – Spanned Striping with Mirroring.
r50: RAID 50 – Spanned Striping with Parity.
r60: RAID 60 – Spanned Striping with Extra Parity.
-wp {wt | wb}: Set the write policy to Write Through or Write Back.
-rp {nra|ra|ara}: Set the read policy to No Read Ahead, Read Ahead, or Adaptive Read Ahead.
-ss: Specify the stripe size to use.
-sc: Span count. This value must be entered while creating spanned RAID levels such as 10, 50,
and 60.
-pdkey: : The PDs to use in the VD.
-dcp: Set the Disk Cache Policy in the VD.
enabled: Enabled – Allow the disk to use it's cache.
disabled: Disabled – Disallow the disk from using its cache.
default: Default – Use the default cache policy. SAS Drives - Use Disabled by Default. SATA
Drives - Use Enabled by Default.
–name: : The name to give the VD.
–size: : The size of the VD.
–
–
–
–
–

•
Example

68

b: Specify the size in bytes.
k: Specify the size in kilobytes
m: Specify the size in megabytes.
g: Specify the size in gigabytes.
t: Specify the size in terabytes.

-cc: Create a CacheCade or Enhanced Cache VD.

racadm raid createvd:RAID.ChassisIntegrated.1-1 -rl r0 pdkey:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1

deletevd
Description

Deletes the specified virtual drive.

Synopsis

racadm raid deletevd: {-current|-pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot, it will reboot.

•

Example

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
reboots.

racadm raid deletevd:Disk.Virtual.0:RAID.ChassisIntegrated.1-1

discardcache
Description

Discards any pinned or persistent cache present on the RAID controller.

Synopsis

racadm raid discardcache: {-current | -pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot, the system is rebooted.

•

Example

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
reboots.

racadm raid discardcache:RAID.ChassisIntegrated.1-1

exportlog
Description

Export a log from the device.

Synopsis

racadm raid exportlog: -l -u p  [-f ]

Input

•
•
•
•

Example

racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l  -u -p  [-f ]

–l: The network share to write the log to.
–u: The network password for the share
–f : The file name to write the log to.

69

forceonline
Description

Forces the RAID Controller to make the specified drive online. This operation may result in obsolete
or corrupted data, and should only be attempted in cases where a rebuild operation has failed or is
not applicable.

Synopsis

racadm raid forceonline: {current|pending}

Input

•
•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot, then the system is rebooted.

•

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
reboots.

Example

racadm raid forceonline:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1

get controllers
Description

The command lists all RAID controllers detected in the system and their properties.
NOTE: To use this subcommand, you must have the CMC Login User privilege.

Synopsis
Input
Example

70

raid get controllers -o
•

-o — The -o is used to display the fault-tolerant status of a RAID controller.

Sample output of a CMC in which either fault-tolerant mode is not available or is not enabled.
RAID.ChassisIntegrated.1-1
Status
= Ok
RollupStatus
= Ok
Name
= Shared PERC8 (Embedded)
FirmwareVersion
= 23.8.3-0027
DriverVersion
= 06.802.11.00
RebuildRate
= 30 %
BgiRate
= 35 %
CheckConsistencyRate
= 40 %
ReconstructRate
= 30 %
PatrolReadRate
= 30 %
PatrolReadMode
= Manual
PatrolReadState
= Stopped
CheckConsistencyMode
= Stop On Error
LoadBalanceSetting
= Disabled
CopybackMode
= OFF
PreservedCache
= Not Present
CacheMemorySize
= 1024 MB
PersistHotspare
= Disabled
SpindownUnconfiguredDrives = Disabled
SpindownHotspare
= Disabled
Timeintervalforspindown
= 30 (Minutes)
SecurityStatus
= Unknown
EncryptionMode
= None
SasAddress
= 0x590B11C02620E600
PciDeviceId
= 0x2f
PciSubdeviceId
= 0x1f3e

PciVendorId
PciSubvendorId
PciBus
PciDevice
PciFunction
BusWidth
SlotLength
SlotType
CapableSpeeds
LearnMode
HighAvailabilityMode
PeerController

= 0x1000
= 0x1028
= 0x0
= 0x0
= 0x0
= Unknown
= Short
= Unknown
= 6.0 Gb/s, 3.0 Gb/s
= Not supported
= None
= N/A

Sample output of a CMC in which you have firmware support for the fault-tolerant mode and the
hardware, and fault-tolerant mode is active, but a license is not available.
RAID.ChassisIntegrated.1-1
Status
RollupStatus
Name
FirmwareVersion
DriverVersion
RebuildRate
BgiRate
CheckConsistencyRate
ReconstructRate
PatrolReadRate
PatrolReadMode
PatrolReadState
CheckConsistencyMode
LoadBalanceSetting
CopybackMode
PreservedCache
CacheMemorySize
PersistHotspare
SpindownUnconfiguredDrives
SpindownHotspare
Timeintervalforspindown
SecurityStatus
EncryptionMode
SasAddress
PciDeviceId
PciSubdeviceId
PciVendorId
PciSubvendorId
PciBus
PciDevice
PciFunction
BusWidth
SlotLength
SlotType
CapableSpeeds
LearnMode
HighAvailabilityMode
PeerController
2-1
RAID.ChassisIntegrated.2-1
Status
RollupStatus
Name

=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=

Ok
Ok
Shared PERC8 (Embedded)
23.8.3-0027
06.802.11.00
30 %
35 %
40 %
30 %
30 %
Manual
Stopped
Stop On Error
Disabled
OFF
Not Present
1024 MB
Disabled
Disabled
Disabled
30 (Minutes)
Unknown
None
0x590B11C02620E600
0x2f
0x1f3e
0x1000
0x1028
0x0
0x0
0x0
Unknown
Short
Unknown
6.0 Gb/s, 3.0 Gb/s
Not supported
= Fault Tolerant(Active/Passive)
= RAID.ChassisIntegrated.

= Ok
= Ok
= Shared PERC8 (Embedded)

71

FirmwareVersion
DriverVersion
RebuildRate
BgiRate
CheckConsistencyRate
ReconstructRate
PatrolReadRate
PatrolReadMode
PatrolReadState
CheckConsistencyMode
LoadBalanceSetting
CopybackMode
PreservedCache
CacheMemorySize
PersistHotspare
SpindownUnconfiguredDrives
SpindownHotspare
Timeintervalforspindown
SecurityStatus
EncryptionMode
SasAddress
PciDeviceId
PciSubdeviceId
PciVendorId
PciSubvendorId
PciBus
PciDevice
PciFunction
BusWidth
SlotLength
SlotType
CapableSpeeds
LearnMode
HighAvailabilityMode
PeerController
1-1

=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=

23.8.3-0027
06.802.11.00
30 %
35 %
40 %
30 %
30 %
Manual
Stopped
Stop On Error
Disabled
OFF
Not Present
1024 MB
Disabled
Disabled
Disabled
30 (Minutes)
Unknown
None
0x590B11C02620E600
0x2f
0x1f3e
0x1000
0x1028
0x0
0x0
0x0
Unknown
Short
Unknown
6.0 Gb/s, 3.0 Gb/s
Not supported
Fault Tolerant(Active/Passive)
= RAID.ChassisIntegrated.

hotspare
Description

Stops blinking or identifies an operation on the specified device.

Synopsis

racadm raid hotspare: -assign {yes | no} {type {ghs |
dhs}} {-vdkey:} {-current | -pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot it will reboot then.

•
•
•
•
Example

72

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
reboots.
–assign {yes | no}: Assign or Unassign the physical disk drive as a hotspare.
–type { ghs | dhs} : Assign as a global or dedicated hotspare.
–vdkey: : Required for dedicated hotspare. Assign the dedicated hotspare to the
specified VD.

racadm raid hotspare:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1 -assign no

racadm raid hotspare:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1 -assign yes -type ghs
racadm raid hotspare:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1 -assign yes -type dhs vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1

cancelinit
Description

Stops an initialization operation on the specified virtual drive.

Synopsis

racadm raid cancelinit: {-current | -pending}

Input

•

–current : Immediately performs the configuration operation.
NOTE: If this requires the system to restart, the system will be restarted.

•

Example

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
rerestartts.

racadm raid cancelinit:Disk.Virtual.0:RAID.ChassisIntegrated.1-1

cancelrebuild
Description

Stops a rebuild on a specified physical disk drive.

Synopsis

racadm raid cancelrebuild: {-current | -pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to restart, the system is restarted.

•

Example

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
rerestarts.

racadm raid cancelrebuild:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1

assignva
Description

Stops an initialization operation on the specified virtual drive.
Assigns a virtual disk to one or more virtual adapters.

Synopsis

racadm raid assignva: -vdkey: -accesspolicy {na
| rw} -assignpolicy {single | multiple}{-current | -pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot, the system will reboot then.

•
•

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
restarts.
–assignpolicy {single|multiple}: Uses the specified assign policy to determine if the Virtual Disk
can be assigned to multiple Virtual Adapters.

73

•
•
Example

NOTE: Enable cluster services on the servers when assigning Virtual Disk to multiple
Virtual Adapters.
–accesspolicy {na | rw}: Set the access policy to No Access or Read/Write.
–vdkey:: The Virtual Drive to change the access to.

racadm raid assignva:RAID.ChassisIntegrated.1-1-1 vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -accesspolicy
{ na | rw }
racadm raid assignva:RAID.ChassisIntegrated.1-1-2 vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -accesspolicy rw assignpolicy multiple

unblink
Description

Stops blinking or identifies an operation on the specified device.

Synopsis

racadm raid unblink:
racadm raid unblink:
racadm raid unblink {-pdkey: -speed {fast | full} {-current | pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot it will reboot then.

•
•
Example

74

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
reboots.
–speed{fast | full}: Perform a fast or full (slow) initialization on the virtual drive.

racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -speed
fast
racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -speed
full

raid
Description

Monitors, retrieves inventory, and configures the storage components connected to the
chassis.
NOTE: To use this subcommand, you must have the Chassis Administrator privilege.

Synopsis

racadm raid get status
racadm raid get 
racadm raid get  -o
racadm raid get  -o -p 
racadm raid get :
racadm raid set :
racadm raid set  -pdkey:
racadm raid set  -vdkey:

Input

NOTE: Maximum property names that can be specified in –p option is 10.
NOTE: Maximum FQDDs that can be specified is 3.

Example

•
•

(Object type) — controllers, vdisks, pdisks.
Set Operation

•
•
•

– resetconfig
– exportlog
– forceonline
– deletevd
– blink
– unblink
– clearconfig
– importconfig
– ccheck
– cancelcheck
– patrolread
– hotspare
– init
– assignva
– createvd
–o — Displays all the properties of the selected Key or Object.
–p — Displays the property names with filter.
FQDD — Displays all the properties of the FQDD's Key.

•
•
•

racadm raid get controllers
racadm raid get controllers -o
racadm raid get controllers -o -p name,status

75

•
•
•
•
•
•
•
•
•
•
•
•
•
•

•

•

•
•
•

•

racadm raid get vdisks -o -p layout,status
racadm raid get controllers:RAID.ChassisIntegrated.1-1
racadm raid get controllers:RAID.ChassisIntegrated.1-1 -p
status
racadm raid resetconfig:RAID.ChassisIntegrated.1-1
racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l  -u  -p  [-f ]
racadm raid forceonline:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1
racadm raid deletevd:Disk.Virtual.0:RAID.ChassisIntegrated.
1-1
racadm raid blink:Disk.Virtual.0:RAID.ChassisIntegrated.1-1
racadm raid clearconfig:RAID.ChassisIntegrated.1-1
racadm raid importconfig:RAID.ChassisIntegrated.1-1
racadm raid ccheck:Disk.Virtual.0:RAID.ChassisIntegrated.
1-1
racadm raid cancelcheck:Disk.Virtual.
0:RAID.ChassisIntegrated.1-1 {-pdkey: | {-vdkey:}
racadm raid unblink {-pdkey: | vdkey:}
racadm raid patrolread:RAID.ChassisIntegrated.1-1 [-mode
{auto | manual | disabled}] [-state {start | stop}] racadm
raid hotspare:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1 -assign {yes | no} -type
{ ghs | dhs} -vdkey:
racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.1-1
-speed { fast | full } racadm raid cancelinit:Disk.Virtual.
0:RAID.ChassisIntegrated.1-1 racadm raid assignva:
-vdkey: -accesspolicy { na | rw }
racadm raid createvd:RAID.ChassisIntegrated.1-1 -rl {r0|r1|
r5|r6|r10|r50|r60} [-wp {wt|wb}] [-rp {nra|ra|ara}] [-ss
{1k|2k|4k|8k|16k|32k|64k|128k|256k|512k|1M|2M|4M|8M|16M}] pdkey:
[-dcp {enabled|disabled|default}] [-name ] [-size
 {b|k|m|g|t}] [-cc]
racadm raid discardcache:RAID.ChassisIntegrated.1-1
racadm raid changepolicy:Disk.Virtual.
0:RAID.ChassisIntegrated.1-1 -wp {wt|wb} -rp {nra|ra|ara} dcp {enabled|disabled|default} racadm raid
rename:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -name 
racadm raid ctrlprop:RAID.ChassisIntegrated.1-1 [-rebuild
>] [-bgi ] [-reconstruct ] [checkconsistency ] [-ccmode {abortonerror | normal}]
[-copybackmode {off | on | onwithsmart}] [-lb {auto |
disabled}] [-prunconfigured {yes | no}] racadm raid
rebuild:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1 racadm raid
cancelrebuild:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1

raid
Description

76

Allows you to execute commands to control RAID arrays.

To use this subcommand for CMC you must have Chassis Administartor privilege.
Synopsis

racadm raid

Example
•

Monitor Health of Storage root node
racadm raid get status
Storage Root Node Status : Ok
This command retrieves the controllers keys, (FQDDs.)

•

Monitor and Inventory all Controllers connected to the server
racadm raid get controllers
racadm raid get controllers -o
This command is an optimized version and displays the full controller objects along with their keys.
racadm raid get controllers -o -p 
This command displays the filtered property values for all returned controller objects.

•

Monitor and Inventory all batteries connected to the controller
racadm raid get batteries --refkey 
This command displays all battery keys connected to the controllers referred to as refkeys.
racadm raid get batteries --refkey  -o
This command is an optimized version and displays all battery objects for the controller FQDD.
racadm raid get batteries --refkey  -o -p 
This command is an optimized and filtered version.
racadm raid get batteries --refkey  -o -p 

•

Monitor and Inventory all virtual disks connected to the controller
racadm raid get vdisks --refkey 
This command displays all vdisk keys connected to the controllers being mentioned as refkeys.
racadm raid get vdisks --refkey  -o
This command is an optimized version and displays all vdisk objects for the controller FQDD.
racadm raid get  -pending
Raid.Integrated.1-1
Raid.Slot.2-1

•

Monitor and Inventory all storage enclosures connected to the connector
racadm raid get enclosures --refkey 
This command displays all enclosure keys connected to the connectors being mentioned as refkeys.
racadm raid get enclosures --refkey  -o optimized version.

77

This command displays all enclosure objects for the connector FQDD.
racadm raid get enclosures --refkey  -o -p 
•

This command is an optimized and filtered version.
Monitor and Inventory all Physical Disks connected to the enclosure /Backplanes
racadm raid get pdisks --refkey 
This command displays all physical disk keys connected to the enclosures being mentioned as refkeys.
racadm raid get pdiks --refkey  -o

•

This command is an optimized version and displays all disk objects for the enclosure FQDD.
racadm raid get pdisks --refkey  -o -p 
optimized and filtered version.
Monitor and Inventory all Fans connected to the enclosure
racadm raid get fans --refkey 
This command displays all fan keys connected to the enclosures referred as refkeys.
racadm raid get fans --refkey  -o optimized version.

•

This command displays all fan objects for the enclosure FQDD.
racadm raid get fans --refkey  -o -p  optimized and
filtered version.
Monitor and Inventory all EMMs connected to the enclosure
racadm raid get emms --refkey 
This command will return all EMM keys connected to the enclosures being mentioned as refkeys.
racadm raid get emms --refkey  -o
This command is an optimized version and displays all EMM objects for the enclosure FQDD.
racadm raid get emms --refkey  -o -p 

•

This command is an optimized and filtered version.
Monitor and Inventory all Temperature Probes connected to the enclosure
racadm raid get tempprobes --refkey 
This command displays all temperature probe keys connected to the enclosures being mentioned as refkeys.
racadm raid get tempprobes --refkey  -o

•

78

This command is an optimized version and displays all temperature probe objects for the enclosure FQDD.
racadm raid get tempprobes --refkey  -o -p 
optimized and filtered version
Monitor and Inventory all Power Supply Units connected to the enclosure
racadm raid get psus --refkey 

This command displays all power supply units connected to the enclosures being mentioned as refkeys.
racadm raid get psus --refkey  -o
This command is an optimized version and displays all power supply units objects for the enclosure FQDD.
racadm raid get psus --refkey  -o -p 
This command is an optimized and filtered version.

rebuild
Description

Starts a rebuild on a specified virtual drive.

Synopsis

racadm raid rebuild: {-current | -pending}

Input

•

–current : Performs the configuration.
NOTE: If this requires the system to restart, the system is restarted.

•

Example

–pending: Save the configuration change for a later use. You can use a combination of the –
pending and –current flags on multiple commands to reduce the possible number of system
restarts.

racadm raid rebuild:Disk.Bay.0:Enclosure.Internal.
0-0:RAID.ChassisIntegrated.1-1

resetconfig
Description

Removes the current RAID Configuration (Virtual Drives and Hotspares) from the RAID controller.
This operation is not data-distructive, but is difficult to reverse.

Synopsis

racadm raid resetconfig: {-current|pending}

Input

•

–current : Performs the configuration right now.
NOTE: If this requires the system to reboot, then the system will reboot.

Example

•

–pending: Save the configuration change for a later application. You can use a combination of
the –pending and –current flags on multiple commands to reduce the possible number of system
reboots.

•

racadm raid resetconfig:RAID.ChassisIntegrated.1-1

enableperc
Description

Indicates the RAID configuration of hardware RAID connected to the server. This subcommand
enables the power to a RAID card.

79

NOTE:
•
•
•

This subcommand operates only on the second PERC adapter.
Using this subcommand will power cycle the chassis and set the fault-tolerant system
configuration to fault-tolerant mode.
While enabling the second PERC adapter, if any PERC adapter settings are changed or
firmware is updated, a message is displayed and the fault-tolerant status is degraded.
Make sure that the firmware and the settings of the SHARED PERC match to set the faulttolerant system configuration to fault-tolerant mode.

Synopsis

racadm raid enableperc:

Example

racadm raid enableperc:RAID.ChassisIntegrated.2-1

disableperc
Description

Indicates the RAID configuration of hardware RAID connected to the system. This subcommand
disables the power to a RAID card.
NOTE:
•
•

This subcommand operates only on the second PERC adapter.
Using this subcommand will power cycle the chassis and set the fault-tolerant system
configuration to Single PERC mode.

Synopsis

racadm raid disableperc:

Example

racadm raid disableperc:RAID.ChassisIntegrated.2-1

remoteimage
Description

Connects, disconnects, or deploys a media file on a remote server.
To use this subcommand, you must have the Administrator privilege.

Synopsis

racadm remoteimage 

Input

Example

•
•
•
•
•
•

-c - Connect the image.
-d - Disconnect the image.
-u - Username to access the network share.
-p - Password to access the network share.
-l - Image location on the network share; use double quotation marks with a location.
-s - Display current status; –a is assumed, if not specified.

•

racadm remoteimage -c -u "user" -p "pass" -l //shrloc/
foo.iso

•

Remote Image is now Configured
racadm remoteimage -d - disconnect

•

Disable Remote File Started. Please check status using -s option to know Remote File
Share is ENABLED or DISABLED.
racadm remoteimage -s - status
Remote File Share is Enabled

80

UserName
Password
ShareName //10.94.161.112/xxxx/dtk_3.3_73_Linux.iso

serveraction
Description

Enables you to perform power management operations on the host system.
To use this subcommand, you must have the Execute Server Control Commands permission.

Synopsis

racadm serveraction 

Input

•
•
•
•

-m  server-n, where n=1–4
-a - Performs action on all servers. Not allowed with the powerstatus action.
-f - Force the action. Required for the reseat action.
- Specifies the action. The options for the  string are:
— graceshutdown — Performs a graceful shutdown of the server. If the operating system on the
server cannot be cleanly shutdown, this operation will not be performed.
— hardreset — Performs a reset (reboot) operation on the managed system.
— powercycle — Issues a power-cycle operation on the managed system. This action is similar
to pressing the power button on the system’s front panel to turn off, and then turn on the system.
— powerdown — Turns off the managed system.
— powerup — Turns on the managed system.
— powerstatus — Displays the current power status of the server (ON or OFF).
— reseat — Performs a virtual reseat of the server. This operation simulates reseating the
server by resetting the iDRAC on a server.
NOTE: The action powerstatus is not allowed with an -a option.

Output
Example

Displays an error message if the requested operation fails, or a success message if the operation is
completed.
•

Turn off server 3 from the CMC
racadm serveraction -m server-3 powerdown

•

Server power operation successful
Turn off server 3 from iDRAC
racadm serveraction powerdown

•

Server power operation successful
Turn off server 3 from CMC when Power is already Off on that server
racadm serveraction -m server-3 powerdown

•

Server is already powered OFF.
Turn off the server from iDRAC when Power is already off on that server.
racadm serveraction powerdown

•

Server is already powered OFF
Get Power Status of server 2 on CMC
racadm serveraction -m server-2 powerstatus

81

•

ON
Get Power Status on iDRAC
racadm serveraction powerstatus

•

Server Power Status: ON
Reseat server 2 on CMC
$ racadm serveraction -m server-2 reseat -f

•

Server power operation successful
Explanation of Support
iDRAC needs to support graceful shutdown
The support of address individual blades is expected on the CMC

set
Description

Imports the saved CMC Event Filter configuration from a file.
NOTE: Currently, these commands are supported only in remote RACADM.

Synopsis

racadm set -f 

Input

•

–f: Configure event filter configurations from a configuration file.

Example

•

–Configure event filter configurations from a configuration file.
racadm -r 10.94.161.119 -u root -p calvin set -f
config.txt

setassettag
Description

Sets the N-byte ASCII asset tag for the chassis.
To use this subcommand, you must have the Administrator privilege.

Synopsis

racadm setassettag -m chassis 

Input

-m  — Specifies the module whose asset tag you want to set.
Legal value: chassis
You can obtain the same output if you do not include this option, because there is only
one legal value.
 is a maximum of 64 non-extended ASCII characters.

Example

•

racadm setassettag -m chassis 783839–33

•

racadm setassettag 783839–33
The asset tag was changed successfully.

setchassisname
Description

82

Sets the name of the chassis in the LCD.

To use this subcommand, you must have the Administrator
privilege.
Synopsis

racadm setchassisname 
NOTE: Chassisname is a maximum of 64 nonextended ASCII characters.

Example

racadm setchassisname dellchassis-1
The chassis name was set successfully.

setflexaddr
Description

Enables or disables FlexAddress on a particular slot or fabric.
To use this subcommand, you must have the Chassis Configuration Administrator
privilege.
If the fabric type is determined to be Infiniband, the operation is canceled and the
command returns an error. If the FlexAddress feature is not activated, the command
returns an error.
NOTE: The server must be turned off to change the slot state. All servers must be
turned off to change the fabric state. The MAC/WWN addresses must be managed
locally (not by an external console) to use this command.

Synopsis

racadm setflexaddr [-i  ]
[-f  ]
 = 1 to 4
 = A
 = 0 or 1
where 0 is disable and 1 is enable.

Input

Example

•
•

-i   — Enables or disables FlexAddress for the specified slot.
-f   — Enables or disables FlexAddress for the specified fabric.

•

racadm setflexaddr -i 1 0
Slot 1 FlexAddress state set successfully

•

racadm setflexaddr -f A 1
Fabric A FlexAddress state set successfully

•

racadm setflexaddr -f idrac 1

setled
Description

Sets the state (blinking or not blinking) of the LED on the specified module.
To blink or unblink the chassis, I/O modules or the CMC, you must have the Debug Administrator
privilege on CMC. To enable the servers to blink or unblink, you must have the Server
Administrator or Debug Administrator privilege on CMC.

Synopsis

racadm setled -m  -l 

83

Input

Example

•

-m  - Specifies the module whose LED you want to configure.
 can be one of the following:
— server-n, where n=1–4
— switch-n, where n=1
— cmc-active
— chassis

•

-l  - Specifies whether the LED should blink.
 can be one of the following:
– 0 — no blinking
– 1 — blinking

•

racadm setled -m server-1 -1 1
LED state was set successfully.
NOTE: The setled command generates an error when used on the extension slot of a
multi-slot server.

•

racadm setled -m server-9 -1 1
ERROR: Server in slot 9 is an extension of the server in slot 1.

setniccfg
Description

Sets the iDRAC IP address. It displays an error message if the requested operation
could not be performed, or a success message, if the operation is completed
successfully.
To use this subcommand, you must have the Configure iDRAC privilege.
NOTE: The terms NIC and Ethernet management port may be used
interchangeably.

Synopsis

Input

•

racadm setniccfg -d

•

racadm setniccfg -d6

•

racadm setniccfg -s   

•

racadm setniccfg -s6   

•

racadm setniccfg -o

•
•
•

-d — Enables DHCP for the NIC (default is “DHCP disabled”.)
-d6 — Enables AutoConfig for the NIC. It is enabled by default.
-s — Enables static IP settings. The IPv4 address, netmask, and gateway can be
specified. Otherwise, the existing static settings are used. ,
, and  must be typed as dot-separated strings.
racadm setniccfg -s 192.168.0.120 255.255.255.0 192.168.0.1
-s6 — Enables static IPv6 settings. The IPv6 address, Prefix Length, and the IPv6
gateway can be specified.
-o — Enable or disable NIC.

•
•

84

Example

•

racadm setniccfg -s 192.168.0.120 255.255.255.0
192.168.0.1

•

racadm setniccfg -d

•

racadm setniccfg -d6

setpciecfg
Description

You can configure PCIe slots and Virtual Adapters, and also set the ride-through properties.
NOTE: To use this subcommand, you must have Chassis Administrator privilege.
NOTE: The slot assignment feature is licensed.

Synopsis

racadm setpciecfg assign [-c ] [-i ]
racadm setpciecfg unassign [-c ]
racadm setpciecfg ridethru -e
racadm setpciecfg ridethru -d
racadm setpciecfg ridethru -t