Dell Chassis Management Controller Command Line Reference Guide

Chassis Management Controller Version 1.0 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.

Trademarks used in this text: PowerConnect Inc.

Intel is a registered trademark and Microsoft or registered trademarks of Microsoft Corporation in the United States and/or other countries. Enterprise Linux

™

OpenManage

Pentium

Windows

Xeon

are registered trademarks of Red Hat, Inc. in the United States and/or other countries. registered trademarks of Novell Inc. in the United States and other countries. and/or its affiliates.

Citrix

the United States and/or other countries.

™

Dell

, the Dell logo,

™

EqualLogic

Core

and

AMD Opteron

Windows Server

Xen

XenServer

Dell Boomi

™

Compellent

Celeron

are registered trademarks of Intel Corporation in the U.S. and other countries.

™

AMD Phenom

Internet Explorer

and

XenMotion

VMware

trademarks of VMware, Inc. in the United States or other countries.

vMotion

™

Dell Precision

™

KACE

™

AMD Sempron

and

MS-DOS

are either registered trademarks or trademarks of Citrix Systems, Inc. in

vCenter

IBM

™

FlexAddress

Windows Vista

™

Oracle

vCenter SRM

is a registered trademark of International Business Machines

™

OptiPlex

™

Force10

™

are trademarks of Advanced Micro Devices, Inc.

and

is a registered trademark of Oracle Corporation

™

and

Corporation.

2013 - 06

Rev. A00

™

Latitude

™

Vostro

and

Active Directory

Red Hat

vSphere

PowerEdge

™

PowerVault

™

are trademarks of Dell

™

AMD

are either trademarks

Red Hat

and

SUSE

are

and

Novell

are registered trademarks or

Contents

1 Introduction................................................................................................................................13

Supported RACADM Interfaces..............................................................................................................................13

RACADM Syntax Usage..........................................................................................................................................13

SSH or Telnet RACADM................................................................................................................................... 13

Remote RACADM............................................................................................................................................. 13

RACADM Command Options............................................................................................................................14

Supported RACADM Subcommands...................................................................................................................... 14

Other Documents You May Need........................................................................................................................... 17

Accessing Documents From Dell Support Site.......................................................................................................18

2 RACADM Subcommand Details..............................................................................................19

Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands..........................19

"?"and "?<subcommand>" .......................................................................................................................................20

help and help <subcommand>................................................................................................................................21

chassislog...............................................................................................................................................................21

chassislog export....................................................................................................................................................23

chassislog clear......................................................................................................................................................23

chassisaction..........................................................................................................................................................24

closessn..................................................................................................................................................................24

clrsel....................................................................................................................................................................... 25

cmcchangeover......................................................................................................................................................25

config...................................................................................................................................................................... 26

connect...................................................................................................................................................................27

deploy..................................................................................................................................................................... 27

Displayable Characters.......................................................................................................................................... 28

eventfilters..............................................................................................................................................................28

fanoffset..................................................................................................................................................................30

feature.....................................................................................................................................................................31

featurecard............................................................................................................................................................. 31

fwupdate.................................................................................................................................................................32

get........................................................................................................................................................................... 34

getactiveerrors....................................................................................................................................................... 34

getassettag............................................................................................................................................................. 35

getchassisname......................................................................................................................................................35

getconfig.................................................................................................................................................................36

getdcinfo.................................................................................................................................................................37

getflexaddr..............................................................................................................................................................38

getioinfo..................................................................................................................................................................39

getled...................................................................................................................................................................... 39

getmacaddress.......................................................................................................................................................40

getmodinfo..............................................................................................................................................................42

getniccfg.................................................................................................................................................................44

getpbinfo.................................................................................................................................................................46

getpciecfg...............................................................................................................................................................47

getpminfo................................................................................................................................................................49

getraclog.................................................................................................................................................................50

getractime...............................................................................................................................................................51

getredundancymode...............................................................................................................................................51

getsel...................................................................................................................................................................... 51

getsensorinfo..........................................................................................................................................................52

getslotname............................................................................................................................................................ 53

getssninfo............................................................................................................................................................... 54

getsvctag................................................................................................................................................................ 54

getsysinfo................................................................................................................................................................55

gettracelog..............................................................................................................................................................56

getversion............................................................................................................................................................... 56

ifconfig.................................................................................................................................................................... 58

jobqueue................................................................................................................................................................. 59

krbkeytabupload..................................................................................................................................................... 60

license.....................................................................................................................................................................61

netstat.....................................................................................................................................................................63

ping......................................................................................................................................................................... 64

ping6....................................................................................................................................................................... 65

racdump..................................................................................................................................................................65

racreset...................................................................................................................................................................67

racresetcfg............................................................................................................................................................. 67

racresetpcie............................................................................................................................................................68

raid..........................................................................................................................................................................68

blink.................................................................................................................................................................. 71

createvd........................................................................................................................................................... 71

deletevd............................................................................................................................................................72

discardcache................................................................................................................................................... 72

exportlog.......................................................................................................................................................... 72

forceonline....................................................................................................................................................... 73

hotspare........................................................................................................................................................... 73

cancelinit..........................................................................................................................................................74

cancelrebuild................................................................................................................................................... 74

assignva........................................................................................................................................................... 74

unblink..............................................................................................................................................................75

init.....................................................................................................................................................................75

raid................................................................................................................................................................... 76

raid................................................................................................................................................................... 78

rebuild...............................................................................................................................................................80

resetconfig....................................................................................................................................................... 80

remoteimage...........................................................................................................................................................81

serveraction............................................................................................................................................................81

set........................................................................................................................................................................... 82

setassettag............................................................................................................................................................. 83

setchassisname......................................................................................................................................................83

setflexaddr..............................................................................................................................................................83

setled...................................................................................................................................................................... 84

setniccfg................................................................................................................................................................. 85

setpciecfg............................................................................................................................................................... 85

setractime...............................................................................................................................................................86

setslotname............................................................................................................................................................ 87

setsysinfo................................................................................................................................................................88

SSH or Telnet RACADM..........................................................................................................................................88

sshpkauth................................................................................................................................................................88

sslkeyupload........................................................................................................................................................... 90

sslcertupload.......................................................................................................................................................... 90

sslcertview..............................................................................................................................................................91

sslcsrgen................................................................................................................................................................ 92

sslresetcfg.............................................................................................................................................................. 93

testemail................................................................................................................................................................. 93

testfeature.............................................................................................................................................................. 94

testtrap....................................................................................................................................................................96

traceroute............................................................................................................................................................... 97

traceroute6............................................................................................................................................................. 97

3 CMC Property Database Group and Object Descriptions..................................................99

idRacInfo.................................................................................................................................................................99

idRacProductInfo (Read Only)..........................................................................................................................99

idRacDescriptionInfo (Read Only)....................................................................................................................99

idRacVersionInfo (Read Only)........................................................................................................................ 100

idRacBuildInfo (Read Only)............................................................................................................................ 100

idRacName (Read Only)................................................................................................................................. 100

cfgLanNetworking................................................................................................................................................ 100

cfgNicIPv4Enable (Read or Write)................................................................................................................. 100

cfgNicVLanId (Read or Write)........................................................................................................................101

cfgDNSDomainNameFromDHCP (Read/Write)..............................................................................................101

cfgDNSDomainName (Read/Write)............................................................................................................... 101

cfgDNSRacName (Read/Write)......................................................................................................................102

cfgDNSRegisterRac (Read/Write)..................................................................................................................102

cfgDNSServersFromDHCP (Read/Write)....................................................................................................... 103

cfgDNSServer1 (Read/Write).........................................................................................................................103

cfgDNSServer2 (Read/Write).........................................................................................................................104

cfgNicEnable (Read/Write)............................................................................................................................ 104

cfgNicIpAddress (Read/Write).......................................................................................................................104

cfgNicNetmask (Read/Write).........................................................................................................................104

cfgNicGateway (Read/Write).........................................................................................................................105

cfgNicMacAddress (Read Only).................................................................................................................... 105

cfgRemoteHosts................................................................................................................................................... 105

cfgRhostsFwUpdateTftpEnable (Read/Write)................................................................................................ 105

cfgRhostsFwUpdateIpAddr (Read/Write)...................................................................................................... 105

cfgRhostsFwUpdatePath (Read/Write)..........................................................................................................106

cfgRhostsSmtpServerIpAddr (Read/Write)....................................................................................................106

cfgRhostsNtpEnable.......................................................................................................................................106

cfgRhostsNtpServer1..................................................................................................................................... 106

cfgRhostsNtpServer2..................................................................................................................................... 106

cfgRhostsNtpServer3..................................................................................................................................... 107

cfgRhostsNtpMaxDist.................................................................................................................................... 107

cfgRhostsSyslogEnable (Read/Write)............................................................................................................ 107

cfgRhostsSyslogPort (Read/Write)................................................................................................................ 107

cfgRhostsSyslogServer1 (Read/Write)...........................................................................................................108

cfgRhostsSyslogServer2 (Read/Write)...........................................................................................................108

cfgRhostsSyslogServer3 (Read/Write)...........................................................................................................108

cfgRhostsSyslogPowerLoggingEnabled........................................................................................................ 108

cfgRhostsSyslogPowerLoggingInterval.........................................................................................................108

cfgUserAdmin.......................................................................................................................................................109

cfgUserAdminIndex (Read Only)....................................................................................................................109

cfgUserAdminPrivilege (Read/Write).............................................................................................................109

cfgUserAdminUserName (Read/Write)..........................................................................................................111

cfgUserAdminPassword (Write Only)............................................................................................................ 111

cfgUserAdminEnable (Read/Write)................................................................................................................111

cfgEmailAlert........................................................................................................................................................ 111

cfgEmailAlertIndex (Read Only)..................................................................................................................... 112

cfgEmailAlertEnable (Read/Write)................................................................................................................. 112

cfgEmailAlertAddress (Read/Write)...............................................................................................................112

cfgEmailAlertEmailName............................................................................................................................... 112

cfgSessionManagement.......................................................................................................................................113

cfgSsnMgtRacadmTimeout (Read/Write)......................................................................................................113

cfgSsnMgtWebserverTimeout (Read/Write)................................................................................................. 113

cfgSerial................................................................................................................................................................113

cfgSerialBaudRate (Read/Write)....................................................................................................................114

cfgSerialConsoleEnable (Read/Write)........................................................................................................... 114

cfgSerialConsoleIdleTimeout (Read/Write)................................................................................................... 114

cfgSerialConsoleNoAuth (Read/Write)..........................................................................................................114

cfgSerialConsoleCommand (Read/Write)...................................................................................................... 114

cfgSerialConsoleColumns.............................................................................................................................. 115

cfgSerialHistorySize (Read/Write)................................................................................................................. 115

cfgSerialSshEnable (Read/Write).................................................................................................................. 115

cfgSerialTelnetEnable (Read/Write) ............................................................................................................. 115

cfgOobSnmp......................................................................................................................................................... 116

cfgOobSnmpAgentCommunity (Read/Write)................................................................................................. 116

cfgOobSnmpAgentEnable (Read/Write)........................................................................................................ 116

cfgTraps................................................................................................................................................................116

cfgTrapsIndex (Read Only).............................................................................................................................117

cfgTrapsEnable.............................................................................................................................................. 117

cfgTrapsAlertDestIpAddr...............................................................................................................................117

cfgTrapsCommunityName..............................................................................................................................117

cfgRacTuning........................................................................................................................................................117

cfgRacTuneDefCredentialWarningEnable.....................................................................................................118

cfgRacTuneRemoteRacadmEnable (Read/Write)..........................................................................................118

cfgRacTuneHttpPort (Read/Write).................................................................................................................118

cfgRacTuneHttpsPort (Read/Write)............................................................................................................... 118

cfgRacTuneIpRangeEnable (Read/Write)......................................................................................................119

cfgRacTuneIpRangeAddr (Read/Write)......................................................................................................... 119

cfgRacTuneIpRangeMask (Read/Write)........................................................................................................119

cfgRacTuneIpBlkEnable (Read/Write)........................................................................................................... 119

cfgRacTuneIpBlkFailCount (Read/Write)....................................................................................................... 120

cfgRacTuneIpBlkFailWindow (Read/Write)................................................................................................... 120

cfgRacTuneIpBlkPenaltyTime (Read/Write).................................................................................................. 120

cfgRacTuneSshPort (Read/Write)..................................................................................................................120

cfgRacTuneTelnetPort (Read/Write)..............................................................................................................120

cfgRacTuneDaylightOffset (Read Only)..........................................................................................................121

cfgRacTuneTimezoneOffset (Read Only)....................................................................................................... 121

cfgRacTuneWebserverEnable (Read/Write)................................................................................................. 122

cfgServerInfo........................................................................................................................................................122

cfgServerInfoIndex (Read Only).....................................................................................................................122

cfgServerSlotNumber (Read Only).................................................................................................................122

cfgServerServiceTag (Read Only)..................................................................................................................122

cfgServerName (Read/Write)........................................................................................................................ 123

cfgServerFW (Read Only)...............................................................................................................................123

cfgServerBIOS (Read Only)............................................................................................................................123

cfgServerBmcMacAddress (Read Only)........................................................................................................123

cfgServerNic1MacAddress (Read Only)........................................................................................................123

cfgServerNic2MacAddress (Read Only)........................................................................................................123

cfgServerNic3MacAddress (Read Only)........................................................................................................124

cfgServerNic4MacAddress (Read Only)........................................................................................................124

cfgServerPriority (Read/Write)...................................................................................................................... 124

cfgServerNicEnable (Read/Write)................................................................................................................. 124

cfgServerIPMIOverLanEnable (Read/Write)..................................................................................................124

cfgServerPowerBudgetAllocation (Read Only)............................................................................................. 124

cfgServerDNSRegisterIMC (Read/Write)...................................................................................................... 125

cfgServerDNSIMCName (Read/Write).......................................................................................................... 125

cfgServerRootPassword (Write Only)............................................................................................................125

cfgServerFirstBootDevice (Read/Write)........................................................................................................ 125

cfgServerBootOnce (Read/Write)..................................................................................................................126

cfgServerPowerConsumption (Read Only).................................................................................................... 126

cfgActiveDirectory................................................................................................................................................127

cfgADRacName (Read/Write)........................................................................................................................127

cfgADRootDomain..........................................................................................................................................128

cfgADEnable (Read/Write).............................................................................................................................128

cfgADSCLEnable............................................................................................................................................ 128

cfgADDomainController................................................................................................................................. 128

cfgADType (Read/Write)................................................................................................................................ 128

cfgADSpecifyServerEnable............................................................................................................................129

cfgLDAP................................................................................................................................................................129

cfgLdapEnable (Read/Write)..........................................................................................................................129

cfgLdapServer (Read/Write).......................................................................................................................... 129

cfgLdapPort (Read/Write).............................................................................................................................. 130

cfgLdapBasedn (Read/Write).........................................................................................................................130

cfgLdapUserAttribute (Read/Write)............................................................................................................... 130

cfgLdapGroupAttribute (Read/Write).............................................................................................................130

cfgLdapGroupAttributeIsDN (Read/Write).....................................................................................................130

cfgLdapBinddn (Read/Write)..........................................................................................................................131

cfgLdapBindpassword (Write Only)...............................................................................................................131

cfgLdapSearchFilter (Read/Write)................................................................................................................. 131

cfgLDAPCertValidationEnable (Read/Write)..................................................................................................131

cfgLDAPNetworkTimeout...............................................................................................................................132

cfgLDAPSearchTimeout.................................................................................................................................132

cfgLDAPSRVLookupDomainName.................................................................................................................132

cfgLDAPSRVLookupEnable............................................................................................................................ 132

cfgLDAPSRVLookupServiceName (Read/Write)........................................................................................... 132

cfgLdapRoleGroup................................................................................................................................................ 132

cfgLdapRoleGroupDN (Read/Write)...............................................................................................................133

cfgLdapRoleGroupPrivilege (Read/Write)......................................................................................................133

cfgLocation........................................................................................................................................................... 133

cfgLocationDatacenter (Read/Write).............................................................................................................133

cfgLocationAisle (Read/Write).......................................................................................................................134

cfgLocationRack (Read/Write).......................................................................................................................134

cfgLocationRackslot (Read/Write).................................................................................................................134

cfgLocationDevicesize (Read Only)............................................................................................................... 134

cfgStandardSchema.............................................................................................................................................134

cfgSSADRoleGroupIndex (Read Only)........................................................................................................... 134

cfgSSADRoleGroupName (Read/Write).........................................................................................................135

cfgSSADRoleGroupDomain (Read/Write)......................................................................................................135

cfgSSADRoleGroupPrivilege (Read/Write).................................................................................................... 135

cfgChassisPower..................................................................................................................................................136

cfgChassisExternalPowerManagementMode...............................................................................................136

cfgChassisInPower (Read Only).....................................................................................................................136

cfgChassisPeakPower (Read Only)................................................................................................................136

cfgChassisPeakPowerTimestamp (Read Only)..............................................................................................137

cfgChassisMinPower (Read Only)................................................................................................................. 137

cfgChassisMinPowerTimestamp (Read Only)................................................................................................137

cfgChassisPowerStatus (Read Only)............................................................................................................. 137

cfgChassisRedundantState (Read Only)........................................................................................................ 137

cfgChassisPowerCap (Read/Write)............................................................................................................... 138

cfgChassisPowerCapF (Read/Write)..............................................................................................................138

cfgChassisPowerCapFBTU (Read/Write).......................................................................................................138

cfgChassisPowerCapPercent (Read/Write)...................................................................................................138

cfgChassisPowerCapFPercent (Read/Write).................................................................................................139

cfgChassisRedundancyPolicy (Read/Write).................................................................................................. 139

cfgChassisDynamicPSUEngagementEnable (Read/Write)............................................................................139

cfgChassisAllow110VACOperation (Read/Write)...........................................................................................139

cfgChassisMaxPowerConservationMode (Read/Write)................................................................................140

cfgChassisPerformanceOverRedundancy (Read/Write)............................................................................... 140

cfgChassisInMaxPowerCapacity (Read Only)............................................................................................... 140

cfgChassisInRedundancyReserve (Read Only)..............................................................................................140

cfgChassisInPowerServerAllocation (Read Only)......................................................................................... 141

cfgChassisInfrastructureInPowerAllocation (Read Only)..............................................................................141

cfgChassisTotalInPowerAvailable (Read Only)............................................................................................. 141

cfgChassisStandbyInPowerCapacity (Read Only)......................................................................................... 141

cfgChassisPowerClear (Write Only)...............................................................................................................141

cfgChassisPowerClearTimestamp (Read Only)............................................................................................. 141

cfgChassisPowerButtonEnable (Read/Write)................................................................................................142

cfgChassisPowerCapBTU (Read/Write)........................................................................................................ 142

cfgThermalEnhancedCoolingMode......................................................................................................................142

cfgKVMInfo...........................................................................................................................................................142

cfgKvmMapping Read or Write......................................................................................................................142

cfgKvmSlot<num>Enable Read or Write........................................................................................................142

cfgDvdInfo............................................................................................................................................................ 143

cfgDvdMapping Read or Write...................................................................................................................... 143

cfgDvdSlot<num>Enable Read or Write........................................................................................................ 143

cfgLcdInfo.............................................................................................................................................................143

cfgAlerting............................................................................................................................................................ 143

cfgAlertingEnable...........................................................................................................................................144

cfgAlertingFilterMask.....................................................................................................................................144

cfgAlertingSourceEmailName........................................................................................................................144

cfgLcdLocale..................................................................................................................................................144

cfgLcdLocale Read or Write...........................................................................................................................145

cfgLcdOrientation Read or Write................................................................................................................... 145

cfgIPv6LanNetworking......................................................................................................................................... 145

cfgIPv6Enable (Read/Write)...........................................................................................................................145

cfgIPv6Address.............................................................................................................................................. 145

cfgIPv6Address1 (Read/Write).......................................................................................................................146

cfgIPv6Gateway (Read/Write)........................................................................................................................146

cfgIPv6PrefixLength (Read/Write)................................................................................................................. 146

cfgIPv6AutoConfig (Read/Write)....................................................................................................................146

cfgIPv6DNSServersFromDHCP6 (Read/Write)...............................................................................................147

cfgIPv6DNSServer1 (Read/Write)..................................................................................................................147

cfgIPv6DNSServer2 (Read/Write)..................................................................................................................147

cfgCurrentLanNetworking (Read Only).................................................................................................................148

cfgNicCurrentIpAddress................................................................................................................................ 148

cfgNicCurrentNetmask.................................................................................................................................. 148

cfgNicCurrentGateway.................................................................................................................................. 148

cfgNicCurrentDhcpWasUsed........................................................................................................................ 148

cfgNicCurrentVlanEnable (Read Only)...........................................................................................................149

cfgNicCurrentVlanID (Read Only).................................................................................................................. 149

cfgNicCurrentVlanPriority (Read Only).......................................................................................................... 149

cfgCurrentLinkLocalAddress..........................................................................................................................149

cfgDNSCurrentServer1.................................................................................................................................. 149

cfgDNSCurrentServer2.................................................................................................................................. 149

cfgDNSCurrentDomainName.........................................................................................................................150

cfgNicCurrentIPv4Enabled.............................................................................................................................150

cfgCurrentIPv6LanNetworking (Read Only)..........................................................................................................150

cfgCurrentIPv6Enabled.................................................................................................................................. 150

cfgCurrentIPv6AutoConfigWasUsed..............................................................................................................151

cfgCurrentLinkLocalAddress..........................................................................................................................151

cfgCurrentIPv6Address1................................................................................................................................ 151

cfgCurrentIPv6Gateway ................................................................................................................................ 151

cfgCurrentIPv6DNSServersFromDHCP6 ....................................................................................................... 151

cfgCurrentIPv6DNSServer1........................................................................................................................... 151

cfgCurrentIPv6DNSServer2........................................................................................................................... 152

cfgNetTuning........................................................................................................................................................ 152

cfgNetTuningNicSpeed..................................................................................................................................152

cfgNetTuningNicAutoneg (Read/Write).........................................................................................................152

cfgNetTuningNic100MB (Read/Write)........................................................................................................... 153

cfgNetTuningNicFullDuplex (Read/Write)......................................................................................................153

cfgNetTuningNicMtu (Read/Write)................................................................................................................153

cfgRacSecurity..................................................................................................................................................... 153

cfgRacSecCsrCommonName (Read/Write)...................................................................................................154

cfgRacSecCsrOrganizationName (Read/Write).............................................................................................154

cfgRacSecCsrOrganizationUnit (Read/Write)................................................................................................154

cfgRacSecCsrLocalityName (Read/Write).....................................................................................................154

cfgRacSecCsrStateName (Read/Write).........................................................................................................154

cfgRacSecCsrCountryCode (Read/Write)......................................................................................................154

cfgRacSecCsrEmailAddr (Read/Write).......................................................................................................... 155

cfgRacSecCsrKeySize (Read/Write).............................................................................................................. 155

Introduction

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

OpenManage Systems Management and Documentation

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 For more information about these options, see the "RACADM Subcommand Details."

DVD or at support.dell.com.

–r –i options or the –r –u –p options.

RACADM Syntax Usage

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

Dell

SSH or Telnet RACADM

racadm getconfig -g <groupname> [-o <objectname>] [-i <indexnumber>]

racadm <subcommand>

Example

racadm getconfig -g idracinfo

racadm getsysinfo

Remote RACADM

racadm -r <racIpAddr> -u <username> -p <password> getconfig -g <groupname> [-o <objectname>] [-i <indexnumber>]

racadm -r <racIpAddr> -u <username> -p <password> <subcommand>

Example

racadm -r <racIpAddr> -u <username> -p <password> getconfig -g <groupname> idracinfo

racadm -r <racIpAddr> -u <username> -p <password> getsysinfo

RACADM Command Options

The following table lists the options for the RACADM command.

Option Description

-r

-r

racIpAddr

-u

-p

-S Specifies that RACADM should check for invalid

Specifies the controller’s remote IP address. Use:

default port (443).

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.

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

certificate errors. RACADM stops the execution of the command with an error message if it detects an invalid certificate.

if the iDRAC port number is not the

-i

-g

-o

objectname

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.

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

Specifies the group name, if applicable.

Specifies the object name, if applicable.

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

Telnet/SSH/Serial Remote RACADM

"?" and "?<subcommand>" Yes Yes

chassisaction Yes Yes

CMC

Subcommand CMC

chassislog No No

closessn Yes Yes

clrsel Yes Yes

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

Subcommand CMC

getssninfo Yes Yes

getsvctag Yes Yes

getsysinfo Yes Yes

getversion Yes Yes

help and help <subcommand> 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

sslkeyupload No Yes

sslcertview Yes Yes

sslcsrgen Yes Yes

sslresetcfg Yes Yes

Subcommand CMC

testemail Yes Yes

testfeature Yes Yes

testtrap Yes Yes

traceroute Yes Yes

traceroute6 Yes Yes

Accessing Documents From Dell Support Site

To access the documents from Dell Support site:

1. Go to dell.com/support/manuals.

2. In the Tell us about your Dell system section, under No, select Choose from a list of all Dell products and click Continue.

3. In the Select your product type section, click Software and Security.

4. In the Choose your Dell Software section, click the required link from the following:

– Client System Management

– Enterprise System Management

– Remote Enterprise System Management

– Serviceability Tools

5. To view the document, click the required product version.

NOTE: You can also directly access the documents using the following links:

• For Enterprise System Management documents — dell.com/openmanagemanuals

• For Remote Enterprise System Management documents — dell.com/esmmanuals

• For Serviceability Tools documents — dell.com/serviceabilitytools

• For Client System Management documents — dell.com/OMConnectionsClient

• For OpenManage Connections Enterprise systems management documents — dell.com/ OMConnectionsEnterpriseSystemsManagement

• For OpenManage Connections Client systems management documents — dell.com/OMConnectionsClient

RACADM Subcommand Details

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 \.

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 "?<subcommand>"

Description

Synopsis

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 <subcommand> -- display usage summary for a subcommand ? -- list racadm subcommand description

subcommand> -- 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

Displays all the subcommands you can use with the RACADM command and a one-line description of each subcommand.

? followed by < To use this subcommand, you must have the CMC Login User privilege. You can also use the help and help <

information.

racadm ?

racadm ? <subcommand>

subcommand

> displays the syntax for the specified command.

subcommand

> commands to obtain the same

Example for RACADM ? <

racadm ? getsysinfo

getsysinfo -- display general CMC and system information Usage:

subcommand

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 <subcommand>

Description Lists all the subcommands available for use with RACADM and provides a short description for

each. You may also type a subcommand, group, object, or FQDD alternate name after help.

Synopsis

Input None

Output

• racadm help

• racadm help <subcommand>

• racadm help -g <groupname>

• racadm help -o <objectname>

• racadm help <FQDD Alias>.<Group>

• racadm help <FQDD Alias>.<Object>

• racadm help <FQDD Alias>.<Group>.<Object>

• The help command displays a complete list of subcommands.

• The racadm help < subcommand only.

• The racadm help -g <

• The racadm help -o <

• The racadm help < group.

• The racadm help < object.

• The racadm help < specified object.

subcommand

groupname objectname

FQDD Alias

>.<

> command displays information for the specified

> command displays information for the specified group.

> command displays information for the specified object.

Group

> command displays information for the specified

Object

> command displays information for the specified

Group

>.<

Object

> command displays information for the

Example

chassislog

Description

Synopsis

racadm help idrac.lcd

racadm help system.power

racadm help system.power.supply

Allows you to view, export, or clear the chassis log history. To clear a chassis log, you must have the Clear Logs Administrator previlege.

NOTE: It is recommended that you use Firmware RACADM to run this subcommand.

racadm chassislog view -i <nNumber of records>

-c <log type> -s <severity>

-q <sequence no.> -n <number of records>

-r <

start timestamp> -e <end timestamp>

Input

• -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 yyyymm-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 yyyymm-dd HH:MM:SS. The time stamp must be provided within double quotes.

• -f <

filename

exported.

• -a < password.

• -d <

• -l <

location

where chassis log is exported. Two types of network shares are supported: — SMB mounted path: //<

path_to_image

— NFS mounted path: <

• -u < and User Name for accessing network share location.

• -p < 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:

> - Specifies the file location and name where the chassis log is

name

> - Specifies the FTP Server IP address or FQDN, user name, and

path

> - Specifies the path to the file on the FTP server.

> - Specifies the location of the network share or area on file system

ipaddress or domain name

ipaddress

user

> — Specifies the user name for accessing the FTP Server, or Domain

password

> — Specifies the password for accessing the FTP Server or Share

>:/<

path_to_image

>/<

share_name

Example

– 1. Warning – 2. Critical – 3. Info

NOTE: To view or export the Chassis log, only CMC Login User permission is required.

• 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

chassislog export

• 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

Description

Synopsis

Input

Example

chassislog clear

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

racadm chassislog export -f<filename> -u<username> p<password> -l<CIFS or NFS share> racadm -r<idracip> -u<idrac username> -p<idrac password> chassislog export -f<filename> -u<username> -p<password> l<CIFS or NFS share>

• –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

Description

Synopsis

Example

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

racadm chassislog clear racadm -r<idracip> -u<idrac username> -p<idrac password> chassislog clear

• 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 <module>] <action>

Input

Output None

Example Perform a reset of switch-1:

• -m <

• <

When < or reset.

racadm chassisaction -m switch-1 reset

Module power operation successful.

module

carry out the action. Values are:

action

the specified module. Values are:

module

> — Module on which you want to

– chassis - this is the default value, if -m is

not specified.

– switch-n, where n=1

> — Action that you want to execute on

– powerdown — (Chassis only) Turns off

the chassis.

– powerup — (Chassis only) Turns on the

chassis. – powercycle — Power cycles the module. – nongraceshutdown — (Chassis only)

Non-gracefully turns off the chassis. – reset — Performs a hard reset of the

module.

> = switch, <

action

> must be powercycle

closessn

Description 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.

Synopsis

Input

• racadm closessn –i <session id>

• racadm closessn -a

• racadm closessn -u <username>

• -i<

session id

be ended, which can be retrieved using RACADM getssninfo subcommand.

> — The session ID of the session to

Session executing this command cannot be ended.

• -a — Closes all sessions.

• -u

Output None

Example

particular user name.

– Remote RACADM: -u option or -i option

• 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.

— Close all sessions for a

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"

Synopsis

Input None

Output

Example

racadm cmcchangeover

CMC failover initiated successfully.

racadm cmcchangeover

section of the

Dell Chassis System User Guide

config

Description Allows you to set iDRAC configuration parameters individually or to batch them as part of a

configuration file. If the data is different, that iDRAC object is written with the new value.

Synopsis

racadm config [-c|-p] -f <filename>

racadm config -g <groupName> -o <objectName> [-i <

index>] <Value>

NOTE: The configuration file retrieved using remote racadm are not interoperable. For the config -f <

file name

> command, use the configuration file retrieved from the same interface.

Input

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

Examples

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

• -f — The -f < <

filename

section Parsing Rules in the

• -p— This option must be used with the -f option. It directs config to delete the password entries contained in the config file -f <

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 < <

groupName

• -o — The -o < option specifies the object name that is written with the string <

• -i — The -i < specify a unique group. The < vary from 1 to maximum number of indexes a particular group supports. If -i < 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.

• 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.

• 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 iDRAC. 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.

filename

> and configure iDRAC. The file must contain data in the format specified in the

> specifies the group containing the object that is to be set.

> option causes config to read the contents of the file specified by

groupName

objectName

iDRAC User’s Guide

filename

>, or group option, must be used with the -o option. The

> <

Value

>, or object option, must be used with the -g option. This

available at support.dell.com/manuals.

> after the configuration is complete.

value

index

>, or index option, is valid only for indexed groups and can be used to

index

> is a decimal integer from 1 through n, where n can

index

> is not

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 Connects to the switch or server serial console.

Synopsis

Input -b — Connects to the switch or console using the binary mode. This is an optional argument; a

• racadm connect [-b] <server-n>

• racadm connect [-b] <switch-n>

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.

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

Synopsis

Input

• racadm deploy -m <module> -u root -p <password> -s

• racadm deploy -m <module> -u root -p <password> -s

• racadm deploy -m <module> -u root -p <password> -d

• racadm deploy -a -u root -p <password>

• -b <

• Use with -m <

• -o <

• -a — Creates and enables an iDRAC root user if it does not already exist, and

• -u root — Indicates that the <

• -m <

• -p <

ipv6Address> <prefixlen> <gateway> -b <device>

-6 <

-o <no|yes>

where <

prefixlen

[-6]

device

servers Legal values: device=None, PXE, HDD, CD-DVD, vFDD, vCD-DVD, iSCSI, SD,

FDD, RFS

no|yes

be used with -o. Use with -m <

servers

is executed on all the existing servers in the chassis

server. root is a constant parameter, the only value that is valid with the ‑u option.

module

Legal values: server-n where n=1–4

password

> is a number between 0 and 128.

> — Specifies the first boot device; must be used with -o.

module

> to specify for an individual server, or with -a for all

> — Indicates if the server should boot from the device once; must

module

> to specify for an individual server, or with -a for all

password

> — Specifies the server you want to configure.

> — Specifies the password for the root user on the server.

> is supplied for the root user on the

Output None

Example

• -s <

ipaddress subnet gateway

gateway for the specified server, separated by single spaces.

– 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.

• -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).

• 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

> — Sets the IP address, subnet mask, and

Displayable Characters

Displayable characters include the following set:

abcdefghijklmnopqrstuvwxwz

ABCDEFGHIJKLMNOPQRSTUVWXYZ

0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/

eventfilters

Description

Synopsis

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.

racadm eventfilters <eventfilters command type>

racadm eventfilters get -c <alert descriptor>

racadm eventfilters set -c <alert descriptor>-n <notifications>

racadm eventfilters set -c <alert descriptor>-r <recurrence>

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

Input

Example

• 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.

• 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

Synopsis

Input s — Sets the fan speed.

Example

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.

racadm fanoffset [-s <off|low|medium|high>

Valid category values are:

• off

• low

• medium

• high

• 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

+ 125 hidden pages

Dell Chassis Management Controller Command Line Reference Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Introduction

Supported RACADM Interfaces

RACADM Syntax Usage

SSH or Telnet RACADM

Remote RACADM

RACADM Command Options

Supported RACADM Subcommands

Other Documents You May Need

Accessing Documents From Dell Support Site

RACADM Subcommand Details

Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands

"?"and "?<subcommand>"

help and help <subcommand>

chassislog

chassislog export

chassislog clear

chassisaction

closessn

clrsel

cmcchangeover

config

connect

deploy

Displayable Characters

eventfilters

fanoffset