Dell Chassis Management Controller Version 1.10 Manual

Dell Chassis Management Controller Version

1.1 for PowerEdge FX2/FX2s 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.

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

Rev. A00

Contents

1 Introduction......................................................................................................... 11

Supported RACADM Interfaces........................................................................................................... 11

RACADM Syntax Usage..................................................................................................................11

SSH or Telnet RACADM..................................................................................................................11

Remote RACADM...........................................................................................................................11

RACADM Command Options........................................................................................................12

Displayable Characters.................................................................................................................. 12

Supported RACADM Subcommands............................................................................................ 13

Other Documents You May Need.................................................................................................15

2 RACADM Subcommand Details........................................................................17

Guidelines to Quote Strings Containing Special Characters When Using RACADM

Commands...........................................................................................................................................17

"?"and "?<subcommand>" .................................................................................................................. 18

help and help <subcommand>...........................................................................................................19

chassislog.............................................................................................................................................19

chassislog export.................................................................................................................................21

chassislog clear....................................................................................................................................21

chassisaction....................................................................................................................................... 22

closessn............................................................................................................................................... 22

clrsel.....................................................................................................................................................23

config...................................................................................................................................................23

connect............................................................................................................................................... 24

deploy..................................................................................................................................................24

eventfilters...........................................................................................................................................26

fanoffset...............................................................................................................................................28

feature................................................................................................................................................. 28

featurecard.......................................................................................................................................... 29

fwupdate..............................................................................................................................................29

get........................................................................................................................................................32

getactiveerrors.....................................................................................................................................32

getassettag.......................................................................................................................................... 33

getchassisname...................................................................................................................................33

getconfig............................................................................................................................................. 34

getdcinfo............................................................................................................................................. 35

getsleduplinkstatus..............................................................................................................................36

getflexaddr...........................................................................................................................................36

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

getled...................................................................................................................................................40

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

getmodinfo..........................................................................................................................................45

getniccfg..............................................................................................................................................47

getpbinfo............................................................................................................................................. 50

getpciecfg............................................................................................................................................50

getpminfo.............................................................................................................................................51

gettracelog.......................................................................................................................................... 52

getractime........................................................................................................................................... 53

getsel....................................................................................................................................................53

getslotname.........................................................................................................................................54

getsensorinfo.......................................................................................................................................54

getssninfo............................................................................................................................................ 57

getsvctag............................................................................................................................................. 58

getsysinfo............................................................................................................................................ 58

gettracelog.......................................................................................................................................... 59

getversion............................................................................................................................................60

ifconfig................................................................................................................................................. 61

jobqueue..............................................................................................................................................62

krbkeytabupload..................................................................................................................................63

license..................................................................................................................................................63

netstat..................................................................................................................................................66

ping...................................................................................................................................................... 67

ping6....................................................................................................................................................67

racdump.............................................................................................................................................. 67

racreset................................................................................................................................................69

racresetcfg...........................................................................................................................................70

racresetpcie.........................................................................................................................................70

remoteimage.......................................................................................................................................70

serveraction..........................................................................................................................................71

set.........................................................................................................................................................73

setassettag........................................................................................................................................... 73

setchassisname....................................................................................................................................73

setflexaddr........................................................................................................................................... 74

setled....................................................................................................................................................74

setniccfg.............................................................................................................................................. 75

setractime............................................................................................................................................76

setslotname......................................................................................................................................... 78

setsysinfo............................................................................................................................................. 78

SSH or Telnet RACADM.......................................................................................................................79

sshpkauth.............................................................................................................................................79

sslkeyupload........................................................................................................................................ 81

sslcertupload....................................................................................................................................... 81

sslcertview...........................................................................................................................................82

sslcsrgen..............................................................................................................................................83

sslresetcfg............................................................................................................................................84

testemail..............................................................................................................................................84

testfeature........................................................................................................................................... 85

testtrap.................................................................................................................................................87

traceroute............................................................................................................................................87

traceroute6..........................................................................................................................................88

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

idRacInfo............................................................................................................................................. 89

idRacProductInfo (Read Only)......................................................................................................89

idRacDescriptionInfo (Read Only)................................................................................................90

idRacVersionInfo (Read Only).......................................................................................................90

idRacBuildInfo (Read Only)...........................................................................................................90

idRacName (Read Only)................................................................................................................90

cfgLanNetworking.............................................................................................................................. 90

cfgNicIPv4Enable (Read or Write).................................................................................................91

cfgNicVLanEnable (Read or Write)................................................................................................91

cfgNicVLanId (Read or Write)........................................................................................................91

cfgNicVLanPriority (Read or Write)............................................................................................... 91

cfgDNSDomainNameFromDHCP (Read/Write)...........................................................................92

cfgDNSDomainName (Read or Write)..........................................................................................92

cfgDNSRacName (Read/Write).....................................................................................................93

cfgDNSRegisterRac (Read/Write)..................................................................................................93

cfgDNSServersFromDHCP (Read/Write)......................................................................................94

cfgDNSServer1 (Read/Write).........................................................................................................94

cfgDNSServer2 (Read/Write).........................................................................................................95

cfgNicEnable (Read/Write)............................................................................................................95

cfgNicIpAddress (Read/Write).......................................................................................................95

cfgNicNetmask (Read/Write)........................................................................................................ 95

cfgNicGateway (Read/Write)........................................................................................................ 96

cfgNicUseDhcp (Read or Write)................................................................................................... 96

cfgNicMacAddress (Read Only).................................................................................................... 96

cfgUserAdmin......................................................................................................................................96

cfgUserAdminIndex (Read Only)...................................................................................................97

cfgUserAdminPrivilege (Read/Write)............................................................................................ 97

cfgUserAdminUserName (Read/Write).........................................................................................99

cfgUserAdminPassword (Write Only)........................................................................................... 99

cfgUserAdminEnable (Read/Write)...............................................................................................99

cfgEmailAlert....................................................................................................................................... 99

cfgEmailAlertIndex (Read Only)..................................................................................................100

cfgEmailAlertEnable (Read/Write).............................................................................................. 100

cfgEmailAlertAddress (Read/Write)............................................................................................ 100

cfgEmailAlertEmailName............................................................................................................ 100

cfgSessionManagement....................................................................................................................101

cfgSsnMgtRacadmTimeout (Read/Write)................................................................................... 101

cfgSsnMgtWebserverTimeout (Read/Write)............................................................................... 101

cfgSerial............................................................................................................................................. 101

cfgSerialBaudRate (Read/Write)..................................................................................................102

cfgSerialConsoleEnable (Read/Write).........................................................................................102

cfgSerialConsoleIdleTimeout (Read/Write)................................................................................102

cfgSerialConsoleNoAuth (Read/Write).......................................................................................102

cfgSerialConsoleCommand (Read/Write)..................................................................................102

cfgSerialConsoleColumns.......................................................................................................... 103

cfgSerialHistorySize (Read/Write)............................................................................................... 103

cfgSerialSshEnable (Read/Write).................................................................................................103

cfgSerialTelnetEnable (Read/Write) ...........................................................................................103

cfgOobSnmp............................................................................................................................... 103

cfgOobSnmpAgentCommunity (Read/Write)............................................................................104

cfgOobSnmpAgentEnable (Read/Write).................................................................................... 104

cfgTraps.............................................................................................................................................104

cfgTrapsIndex (Read Only)..........................................................................................................104

cfgTrapsEnable............................................................................................................................105

cfgTrapsAlertDestIpAddr.............................................................................................................105

cfgTrapsCommunityName......................................................................................................... 105

cfgRacTuning.................................................................................................................................... 105

cfgRacTuneDefCredentialWarningEnable................................................................................. 106

cfgRacTuneRemoteRacadmEnable (Read/Write)......................................................................106

cfgRacTuneChassisMgmtAtServer............................................................................................. 106

cfgRacTuneHttpPort (Read/Write)............................................................................................. 106

cfgRacTuneHttpsPort (Read/Write)............................................................................................106

cfgRacTuneIpRangeEnable (Read/Write)................................................................................... 107

cfgRacTuneIpRangeAddr (Read/Write).......................................................................................107

cfgRacTuneIpRangeMask (Read/Write)......................................................................................107

cfgRacTuneIpBlkEnable (Read/Write).........................................................................................107

cfgRacTuneIpBlkFailCount (Read/Write)....................................................................................108

cfgRacTuneIpBlkFailWindow (Read/Write)................................................................................ 108

cfgRacTuneIpBlkPenaltyTime (Read/Write)...............................................................................108

cfgRacTuneSshPort (Read/Write)...............................................................................................108

cfgRacTuneTelnetPort (Read/Write).......................................................................................... 108

cfgRacTuneDaylightOffset (Read Only)..................................................................................... 109

cfgRacTuneTimezoneOffset ......................................................................................................109

cfgRacTuneSledNetworkUplink.................................................................................................. 110

cfgRacTuneUserBlkEnable.......................................................................................................... 110

cfgRacTuneWebserverEnable (Read/Write)................................................................................ 111

cfgServerInfo...................................................................................................................................... 111

cfgServerInfoIndex (Read Only)...................................................................................................111

cfgServerSlotNumber (Read Only)...............................................................................................111

cfgServerServiceTag (Read Only)................................................................................................ 111

cfgServerName (Read/Write)....................................................................................................... 111

cfgServerFW (Read Only).............................................................................................................112

cfgServerBIOS (Read Only)..........................................................................................................112

cfgServerBmcMacAddress (Read Only)...................................................................................... 112

cfgServerNic1MacAddress (Read Only).......................................................................................112

cfgServerNic2MacAddress (Read Only)...................................................................................... 112

cfgServerNic3MacAddress (Read Only)...................................................................................... 112

cfgServerNic4MacAddress (Read Only)...................................................................................... 112

cfgServerNicEnable (Read/Write)................................................................................................112

cfgServerNodeId ......................................................................................................................... 112

cfgServerIPMIOverLanEnable (Read/Write)................................................................................ 113

cfgServerDNSRegisterIMC (Read/Write)..................................................................................... 113

cfgServerDNSIMCName (Read/Write).........................................................................................113

cfgServerRootPassword (Write Only)..........................................................................................113

cfgServerFirstBootDevice (Read/Write).......................................................................................113

cfgServerBootOnce (Read/Write)............................................................................................... 114

cfgActiveDirectory.............................................................................................................................114

cfgADRacName (Read/Write)......................................................................................................114

cfgADCertValidationEnable (Read/Write)................................................................................... 114

cfgADRacDomain (Read or Write)...............................................................................................115

cfgADRootDomain.......................................................................................................................115

cfgADEnable (Read/Write)........................................................................................................... 115

cfgADAuthTimeout (Read/Write).................................................................................................115

cfgADSCLEnable.......................................................................................................................... 115

cfgADDomainController..............................................................................................................116

cfgADDomainController1 (Read/Write)...................................................................................... 116

cfgADDomainController2 (Read/Write)......................................................................................116

cfgADDomainController3 (Read/Write)......................................................................................116

cfgADGlobalCatalog1 (Read/Write).............................................................................................116

cfgADGlobalCatalog2 (Read/Write).............................................................................................117

cfgADGlobalCatalog3 (Read/Write).............................................................................................117

cfgADType (Read/Write).............................................................................................................. 117

cfgADDcSRVLookupDomainName (Read/Write)....................................................................... 117

cfgADDcSRVLookupEnable (Read/Write)................................................................................... 118

cfgADSpecifyServerEnable.......................................................................................................... 118

cfgLDAP............................................................................................................................................. 118

cfgLdapEnable (Read/Write)........................................................................................................118

cfgLdapServer (Read/Write).........................................................................................................119

cfgLdapPort (Read/Write)............................................................................................................119

cfgLdapBasedn (Read/Write).......................................................................................................119

cfgLdapUserAttribute (Read/Write)............................................................................................. 119

cfgLdapGroupAttribute (Read/Write)......................................................................................... 120

cfgLdapGroupAttributeIsDN (Read/Write)................................................................................. 120

cfgLdapBinddn (Read/Write).......................................................................................................120

cfgLdapBindpassword (Write Only)............................................................................................120

cfgLdapSearchFilter (Read/Write)................................................................................................121

cfgLDAPCertValidationEnable (Read/Write)............................................................................... 121

cfgLDAPNetworkTimeout............................................................................................................121

cfgLDAPSearchTimeout.............................................................................................................. 121

cfgLDAPSRVLookupDomainName..............................................................................................121

cfgLDAPSRVLookupEnable......................................................................................................... 122

cfgLDAPSRVLookupServiceName (Read/Write).........................................................................122

cfgLdapRoleGroup............................................................................................................................122

cfgLdapRoleGroupDN (Read/Write)........................................................................................... 122

cfgLdapRoleGroupPrivilege (Read/Write)...................................................................................123

cfgLocation........................................................................................................................................123

cfgLocationDatacenter (Read/Write)..........................................................................................123

cfgLocationAisle (Read/Write).....................................................................................................123

cfgLocationRack (Read/Write).................................................................................................... 123

cfgLocationRackslot (Read/Write).............................................................................................. 124

cfgLocationDevicesize (Read Only)............................................................................................124

cfgStandardSchema..........................................................................................................................124

cfgSSADRoleGroupIndex (Read Only)........................................................................................124

cfgSSADRoleGroupName (Read/Write)......................................................................................124

cfgSSADRoleGroupDomain (Read/Write)...................................................................................125

cfgSSADRoleGroupPrivilege (Read/Write)..................................................................................125

cfgChassisPower...............................................................................................................................126

cfgChassisInPower (Read Only)..................................................................................................126

cfgChassisPeakPower (Read Only).............................................................................................126

cfgChassisPeakPowerTimestamp (Read Only).......................................................................... 126

cfgChassisMinPower (Read Only)...............................................................................................126

cfgChassisMinPowerTimestamp (Read Only).............................................................................127

cfgChassisPowerStatus (Read Only)........................................................................................... 127

cfgChassisRedundantState (Read Only)..................................................................................... 127

cfgChassisMaxPowerConservationMode (Read/Write)............................................................. 127

cfgChassisPowerCapUpperBound (Read Only).........................................................................128

cfgChassisPowerCapLowerBound (Read Only).........................................................................128

cfgChassisSledPowerButtonEnable............................................................................................128

cfgChassisPowerCap (Read/Write).............................................................................................128

cfgChassisPowerCapF (Read/Write)...........................................................................................128

cfgChassisPowerCapBTU (Read/Write)......................................................................................129

cfgChassisPowerCapFBTU (Read/Write)....................................................................................129

cfgChassisPowerCapPercent (Read/Write)................................................................................129

cfgChassisPowerCapFPercent (Read/Write).............................................................................. 129

cfgChassisRedundancyPolicy (Read/Write)............................................................................... 130

cfgChassisInMaxPowerCapacity (Read Only)............................................................................ 130

cfgChassisInRedundancyReserve (Read Only)...........................................................................130

cfgChassisPowerClear (Write Only)............................................................................................130

cfgChassisPowerClearTimestamp (Read Only).......................................................................... 131

cfgChassisPowerButtonEnable (Read/Write)..............................................................................131

cfgChassisPowerCapBTU (Read/Write)...................................................................................... 131

cfgKVMInfo.........................................................................................................................................131

cfgKvmEnable ............................................................................................................................. 131

cfgKvmMapping ..........................................................................................................................132

cfgAlerting......................................................................................................................................... 132

cfgAlertingEnable........................................................................................................................ 132

cfgAlertingSourceEmailName.....................................................................................................132

cfgIPv6LanNetworking......................................................................................................................132

cfgIPv6Enable (Read or Write).................................................................................................... 133

cfgIPv6AutoConfig (Read/Write).................................................................................................133

cfgIPv6Address............................................................................................................................ 133

cfgIPv6PrefixLength (Read/Write)...............................................................................................133

cfgIPv6Gateway (Read/Write).....................................................................................................134

cfgCurrentIPv6DNSServersFromDHCP6 ...................................................................................134

cfgIPv6DNSServer1 (Read/Write)................................................................................................ 134

cfgIPv6DNSServer2 (Read/Write)................................................................................................134

cfgCurrentLanNetworking (Read Only)............................................................................................135

cfgNicCurrentIpAddress..............................................................................................................135

cfgNicCurrentNetmask............................................................................................................... 135

cfgNicCurrentGateway............................................................................................................... 136

cfgNicCurrentDhcpWasUsed......................................................................................................136

cfgNicCurrentVlanEnable (Read Only)....................................................................................... 136

cfgNicCurrentVlanID (Read Only)...............................................................................................136

cfgNicCurrentVlanPriority (Read Only).......................................................................................136

cfgDNSCurrentServer1................................................................................................................136

cfgDNSCurrentServer2................................................................................................................136

cfgDNSCurrentDomainName..................................................................................................... 137

cfgNicCurrentIPv4Enabled..........................................................................................................137

cfgCurrentIPv6LanNetworking (Read Only).....................................................................................137

cfgCurrentIPv6Enabled (Read/Write)..........................................................................................137

cfgCurrentIPv6AutoConfigWasUsed.......................................................................................... 137

cfgCurrentLinkLocalAddress.......................................................................................................138

cfgCurrentIPv6Address............................................................................................................... 138

cfgCurrentIPv6Gateway .............................................................................................................138

cfgCurrentIPv6DNSServersFromDHCP6 ...................................................................................138

cfgCurrentIPv6DNSServer1.........................................................................................................138

cfgCurrentIPv6DNSServer2.........................................................................................................138

cfgNetTuning.....................................................................................................................................138

cfgNetTuningNicSpeed...............................................................................................................139

cfgNetTuningNicAutoneg (Read/Write)..................................................................................... 139

cfgNetTuningNicFullDuplex (Read/Write)..................................................................................139

cfgNetTuningNicMtu (Read/Write).............................................................................................139

cfgNetTuningNicRedunadant.....................................................................................................140

cfgRacSecurity.................................................................................................................................. 140

cfgRacSecCsrCommonName (Read/Write)...............................................................................140

cfgRacSecCsrOrganizationName (Read/Write)......................................................................... 140

cfgRacSecCsrOrganizationUnit (Read/Write).............................................................................141

cfgRacSecCsrLocalityName (Read/Write).................................................................................. 141

cfgRacSecCsrStateName (Read/Write).......................................................................................141

cfgRacSecCsrCountryCode (Read/Write)...................................................................................141

cfgRacSecCsrEmailAddr (Read/Write)........................................................................................ 141

cfgRacSecCsrKeySize (Read/Write)............................................................................................ 142

Introduction

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

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

-u <usrName> Specifies the user name that is used to

-p <password> Specifies the password used to authenticate the

-S Specifies that RACADM should check for invalid

Specifies the controller’s remote IP address.

authenticate the command transaction. If the -u option is used, the -p option must be used, and the

-i option (interactive) is not allowed.

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.

-i <indexnumber> Specifies the index number for the indexed group,

if applicable.

-g <groupname> 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.

Displayable Characters

Displayable characters include the following set:

abcdefghijklmnopqrstuvwxwz

ABCDEFGHIJKLMNOPQRSTUVWXYZ

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

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

“?” and “?<subcommand>” Yes Yes

chassisaction Yes Yes

chassislog Yes Yes

closessn Yes Yes

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

Remote RACADM

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

Subcommand CMC

getpciecfg Yes Yes

getpminfo Yes Yes

getraclog Yes Yes

getractime Yes Yes

getredundancymode No No

getsel Yes Yes

getsleduplinkstatus Yes Yes

getsensorinfo Yes Yes

getslotname Yes Yes

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

racresetcfg Yes Yes

remoteimage Yes Yes

serveraction Yes Yes

set No Yes

setassettag Yes Yes

setflexaddr Yes Yes

setled Yes Yes

setniccfg Yes Yes

setpciecfg No No

Subcommand CMC

setractime Yes Yes

setslotname Yes Yes

setsysinfo Yes Yes

sshpkauth Yes Yes

sslkeyupload No Yes

sslcertview Yes Yes

sslcsrgen Yes Yes

sslresetcfg Yes Yes

testemail Yes Yes

testfeature Yes Yes

testtrap Yes Yes

traceroute Yes Yes

traceroute6 Yes Yes

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 clrraclog -- clear the CMC log clrsel -- clear the System Event Log (SEL) 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

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

? followed by < subcommand > 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 <subcommand> commands to obtain the same information.

• racadm ?

• racadm ? <subcommand>

testtrap -- test CMC SNMP trap notifications traceroute -- determine the route of a packet traceroute6 -- determine the route of a packet

Example for RACADM ? <subcommand>

racadm ? getsysinfo

getsysinfo -- display general CMC and system information Usage: 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

Example

• racadm help

• racadm help <subcommand>

• The help command displays a complete list of subcommands.

• The racadm help <subcommand> command displays information for the

• The racadm help -g <groupname> command displays information for

• The racadm help -o <objectname> command displays information for

• The racadm help <FQDD Alias>.<Group> command displays information

• The racadm help <FQDD Alias>.<Object> command displays information

• The racadm help <FQDD Alias>.<Group>.<Object> command displays

racadm help system.power

racadm help system.power.supply

chassislog

specified subcommand only.

the specified group.

the specified object.

for the specified group.

for the specified object.

information for the specified object.

Description

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.

Synopsis

Input

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>

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

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

Example

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

Synopsis

Input

Example

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<cmcip> -u<cmc username> -p<cmc password> chassislog export -f<filename> -u<username> -p<password> l<CIFS or NFS share>

racadm chassislog export -f <filename> -u <username> -p

•

• racadm -r <cmcip> -u <cmc username> -p <cmc 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

chassislog clear

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 <cmcip> -u <cmc username> -p <cmc 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 <default root user password> chassislog clear

NOTE: The default local account credential is root (user name) and calvin (user password).

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

Input

Output None

Example Perform a reset of switch-1:

racadm chassisaction [-m <module>] <action>

• -m <module> — Module on which you want to carry out the action. Values are:

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

• <action> — 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) Non-gracefully turns off the

chassis.

– reset — Performs a hard reset of the module.

When < module > = switch, < action > must be powercycle or reset.

racadm chassisaction -m switch-1 reset

Module power operation successful.

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 > — 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 <user name> — Close all sessions for a particular user name.

– Remote RACADM: -u option or -i option

Output None

Example

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

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

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

• racadm config -g <group name> -o <object name> [-I <index>] <value>

Input

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.

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

• -f — The -f < filename > option causes config to read the contents of the

file specified by < filename > 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 < filename > 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 < groupName >, or group option, must be used with the -o option. The < groupName > specifies the group containing the object that is to be set.

• -o — The -o < objectName > < Value >, or object option, must be used with the -g option. This option specifies the object name that is written with the string < value >.

indexes a particular group supports. If -i < index > 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.

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

Synopsis

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

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

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

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

deploy

Description Deploys blade server or IOM by specifying the required properties.

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

where <prefixlen> is a number between 0 and 128.

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

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

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

• Use with -m <module> to specify for an individual server, or with -a for all servers

Legal values: device=None, PXE, HDD, CD-DVD, vFDD, vCD-DVD, SD, FDD, RFS

• -o < no|yes > — Indicates if the server should boot from the device once; must be used with -o.

Use with -m <module> to specify for an individual server, or with -a for all servers

• -a — server/switch. Applies options to all modules present in the chassis of the given module type. Specify the value as server or switch. Default value is server. Switches must support Ethernet Management.

• -u root — Indicates that the < password > is supplied for the root user on the server. root is a constant parameter, the only value that is valid with the ‑u option. Required Username when you are setting IOA values.

• -m < module > — Specifies the server you want to configure. Legal value must be one of the following values:

– server-n where n=1–4 – switch-n where n=1–2.

• -p < password > — Specifies the password for the root user on the server or switch.

Legal values: For switches, valid passwords are 6 - 32 ASCII characters in length, ranging in value 32–125 (decimal). For servers, valid passwords are 1 – 20 ASCII characters in length, ranging in value 32 – 126 (decimal).

• -s <ipaddress subnet gateway> — Sets the IP address, subnet mask, and 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).

• -v—SNMPv2 community string.

• -q— Displays or modifies the quick deploy parameters.

• -n— Specifies the number of reserved IP addresses for quick deploy. The valid values are 2 and 4.

Output None

NOTE: This input is available in IOA only.

Example

eventfilters

Description

Synopsis

• 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 <default root

user password> -s -6 ::/64 :: 10

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

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

fanoffset

• Configure the event generation interval and notifications for temperature statistics:

racadm eventfilters set -c cmc.alert.system.tmps -r 5 n snmp

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

• 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

• racadm feature -s

• racadm feature -d -c <featurename>

• racadm feature -r -c ExtendedStorage

Input

• -s — Displays the status of active features.

• -d — Deactivates the feature specified in -c option.

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 CMC cardslot. Any existing ExtendedStorage data will be lost.

• -c — <featurename> must be one of the following:

• flexaddress (with -d)

• flexaddressplus (with -d) ExtendedStorage (with -d or -

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

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

Output

racadm featurecard -s

An example of output is given here.

racadm featurecard -s

CMC: The feature card inserted is valid, serial number = CN0H871T137401112222A00 The feature card contains the following feature(s): FlexAddress: bound FlexAddressPlus: bound ExtendedStorage: bound

fwupdate

Description

Allows you to update the CMC firmware, chassis infrastructure firmware. You can:

• 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 CMC firmware resets the CMC, causing all network connections to get logged off.

NOTE: The subcommand generates an error, when used on the extension slot of a multi-slot server.

The CMC firmware performs a signature verification step to ensure the authenticity of the uploaded firmware. The firmware update process is successful only if the firmware image is authenticated by CMC to be a valid image from the service provider and has not been altered. The firmware update process is stopped if CMC cannot verify the signature of the uploaded firmware image. A warning event is then logged and an appropriate error message is displayed.

Synopsis

• Using Remote RACADM:

racadm fwupdate -p -u -d <firmware image>

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 too long.

NOTE: While performing firmware CMC firmware upgrade if the uploaded firmware image file does not contain a verification signature or it contains a verification signature, which is not valid or corrupted, the following message is displayed:

Invalid firmware: The firmware image validation was unsuccessful

NOTE: While performing CMC firmware downgrade if the computed signature of that earlier version is not recognized by the current CMC firmware, the following message is displayed:

Firmware downgrade is unsuccessful: a downgrade to this firmware version is not supported

• racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.cmc m

ERROR: Specified path is

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 < module >— Specifies the module or device to be updated. < module > is one of the

following values:

NOTE: You can also specify multiple modules: –m <module 1> –m <module 2>, and so on.

– cmc – iominf-n, where n = 1 – main-board – 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 CMC update.

NOTE: Use all to get the status of all the targets that must be updated.

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

Output

Example

Displays a message indicating the operation that is being performed.

NOTE: The following commands apply to CMC update.

• Upload a firmware image from the client and start firmware update:

racadm fwupdate -p -u -d fx2_cmc.bin

• Upload the firmware image from the TFTP server and start the firmware update:

racadm fwupdate -g -u -a 192.168.0.100 -d fx2_cmc.bin

-m cmc-active

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 root <default root password> -d fx2_cmc.bin -m

• Start IOM infrastructure firmware update.

racadm fwupdate -u -m iominf-1

• View the current firmware update status:

racadm fwupdate –s –m

• Signed CMC Firmware Image:

racadm fwupdate –g –u –a <TFTP IP> -d <Firmware Path> m

Firmware update has been initiated. This update process may take Several minutes to complete.

racadm fwupdate –s –m cmc-active

Invalid firmware: The uploaded firmware image does not contain A verification signature.

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

FW Update Method CMC

Local RACADM

Local RACADM - TFTP

Local RACADM - FTP

Remote RACADM

Remote RACADM-TFTP

Remote RACADM-FTP

Firmware RACADM-TFTP

Firmware RACADM-FTP

Yes

get

Description

Synopsis

Input –f : save event filter configurations to a file.

Example –Save event filter configurations to a file by using remote racadm.

Saves CMC Event Filter configuration to a file.

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

racadm get -f <filename>

racadm -r 10.94.161.119 -u root -p <default root user password> 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

Input

Output

racadm getactiveerrors [-s <severity> ] [-m <module>]

valid values for <severity>: critical, warning, info

valid values for <module>: server-n, where n = 1 to 4

switch-n, where n = 1 to 2

cmc-n, where n = 1

fan-n, where n = 1 to 8

ps-n, where n = 1 or 2

chassis

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

Input -m < module > — Specifies the module whose asset tag you want to view.

Example

racadm getassettag [-m <module>]

Legal value: chassis

• racadm getassettag -m chassis

• racadm getassettag

chassis 78373839–33

getchassisname

Description

Synopsis

Displays the name of the chassis.

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

racadm getchassisname

Example

racadm getchassisname

CMC-1

getconfig

Description Retrieves CMC configuration parameters individually, or all CMC

configuration groups may be retrieved and saved to a file.

Synopsis

Input

• racadm getconfig -f <filename>

• racadm getconfig -g <groupName> [-I <index>]

• racadm getconfig -u <username>

• racadm getconfig -h

• racadm getconfig -g <groupName> -o <objectName> [-i index]

• -f — The -f <filename> option directs getconfig to write the entire CMC

configuration to a configuration file. This file can be used for batch configuration operations using the config subcommand.

• -g — The -g <groupName>, 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 <index>, or index option, is valid only for indexed groups and can be used to specify a unique group. The <index>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 <index> 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 <objectname> 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 <username>, or user name option, can be used to display the configuration for the specified user. The <username> option is the login name for the user.

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

Output 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 CMC to myrac.cfg.

racadm getconfig -f myrac.cfg

• Displays a list of the available configuration groups on CMC 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

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

<IO#> <Type> <State> <Role>

switch-1 Gigabit Ethernet OK Master

<Server#> <Presence> <DC1 Type> <DC1 State> <DC2 Type> <DC2 State>

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

racadm getdcinfo

<Server#> <Presence> <DC1 Type> <DC1 State> <DC2 Type> <DC2 State>

server-4 Not Present None N/A None N/A

getdcinfo -n

<Server#> <Presence> <DC1 Model Name> <DC2 Model Name>

server-1 Present None None

server-2 Not Present None None

server-3 Not Present None None

server-4 Present None Broadcom M5708t

getsleduplinkstatus

Description

Synopsis

Examples

Displays multi-node sled network switch uplink status.

racadm getsleduplinkstatus

Sled No : 2 Port No = 3 A1 Link Status = Up A2 Link Status = Down

Port No = 4 A1 Link Status = Up A2 Link Status = Up

Sled No : 3 Port No = 5 A1 Link Status = Up A2 Link Status = Down

Port No = 4 A1 Link Status = Up A2 Link Status = Up

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.

The decoder values in the Type column indicate the protocols of the network cards:

• 0— Unsupported

• 1— ISCSI

• 2— FCoE-FIP

• 3— iSCSI/FCoE-FIP

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

Input -i < slotNum > — Specifies the slot information to be displayed. < slotNum >

Example

Display current FlexAddress settings for all the slots and fabrics.

racadm getflexaddr

<Slot#> <Status> <Server Presence>

1a Enabled Present

1b Enabled Present

1c Enabled Present

1d Enabled Not Present

2 Enabled Present

3a Disabled Present

3b Disabled Present

racadm getflexaddr [-i <slotNum>]

must be from 1 to 4.

3c Disabled Present

3d Disabled Present

4 Disabled 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 aidrac

slot1

Controller 18:A9:9B:FD:C3:FF

10 GbE KR

10 GbE KR/ 3

FCoEWWN

10 GbE KR/ 3

FCoEWWN

10 GbE KR

10 GbE KR/ 3

00:90:FA:51:31:E2

00:90:FA: 51:31:E3

10:00:00:90:FA: 51:31:E3)

00:90:FA: 51:31:E5

10:00:00:90:FA: 51:31:E5

00:90:FA: 51:31:E5

F0:1F:AF:88:21:A0(active)

F0:1F:AF:88:21:A1(active)

F0:1F:AF:88:21:A3(active)

20:01:F0:1F:AF:88:21:A3(active)

F0:1F:AF:88:22:75(active)

20:01:F0:1F:AF:88:22:75(active)

20:01:F0:1F:AF:88:22:73(active)

F0:1F:AF:88:22:75(active)

slot1

FCoEWWN

10 GbE KR

10:00:00:90:FA: 51:31:E5

00:90:FA: 51:31:E7

00:90:FA: 51:31:E9

00:90:FA: 51:31:EA

00:90:FA:51:31:EB F0:1F:AF:88:21:A4(active)

20:01:F0:1F:AF:88:22:75(active)

F0:1F:AF:88:22:77(active)

F0:1F:AF:88:22:7B(active)

F0:1F:AF:88:22:7D(active)

F0:1F:AF:88:21:A2(active)

10 GbE KR/ 3

00:90:FA: 51:31:EB

F0:1F:AF:88:21:A4(active)

FCoEWWN

10 GbE KR/ 3

FCoEWWN

10 GbE KR/ 3

FCoEWWN

10 GbE KR

10:00:00:90:FA: 51:31:EB

00:90:FA: 51:31:EC

10:00:00:90:FA:51:31:EC 20:01:F0:1F:AF:88:22:74(active)

10:00:00:90:FA: 51:31:EC

00:90:FA: 51:31:ED

10:00:00:90:FA:51:31:ED 20:01:F0:1F:AF:88:22:76(active)

00:90:FA: 51:31:EE

00:90:FA: 51:31:EF

20:01:F0:1F:AF:88:21:A4(active)

F0:1F:AF:88:22:74(active)

20:01:F0:1F:AF:88:22:74(active)

F0:1F:AF:88:22:76(active)

F0:1F:AF:88:22:78(active)

F0:1F:AF:88:22:7A(active)

10 GbE KR

NOTE: 10 GbE KR/3 — The value 3 indicates the protocol type.

00:90:FA:51:31:F0) F0:1F:AF:88:22:7C(active)

00:90:FA: 51:31:F1

F0:1F:AF:88:22:7E(active)

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

Example

racadm getioinfo

switch-1 N/A None Not

switch-2 PE 10

Gigabit KR

Present

Present OK ON Master

N/A N/A N/A

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

Input CMC only options:

racadm getled -m <module>

-m < module > — Specifies the module whose LED settings you want to

view.

< module > can be one of the following:

• server-n where n=1 or 4

• switch-n where n=1 or 2

• chassis

• CMC active

Example For CMC:

• racadm getled -m server-4 <module> <LED state> server-4 Blinking

• racadm getled -m chassis <module> <LED state> server-4 Not blinking

• racadm getled -m server-1 <module> <LED state> server-1 ON

• racadm getled -m server-1 <module> <LED state> server-1 Extension(1)

getmacaddress

Description Displays the MAC/WWN addresses for all modules or for a specified module.

The decoder values in the Type column indicate the protocols of the network cards.

• 0— Unsupported

• 1— ISCSI

• 2— FCoE-FIP

• 3— iSCSI/FCoE-FIP

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

Synopsis

Input

• racadm getmacaddress

• racadm getmacaddress -m chassis

• racadm getmacaddress -m switch-<n>

• racadm getmacaddress [-m <module>] [-t iscsi] [-x]

• racadm getmacaddress [-a]

• racadm getmacaddress -c IO-Identity

• racadm getmacaddress -c Flexaddress

• racadm getmacaddress -c Factory

• racadm getmacaddress -c all

• -m < module > — Specifies the module whose MAC address you want to

view. < module > may be one of the following:

server-n , where n=1–4

switch-n , where n=1–2

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

• -c— Displays the Ethernet, iSCSI, MAC/WWN, assignment type, and

partition status of all LOMs or mezzanine cards. Valid values for -c option are:

– IO-Identity — Displays the user-defined MAC/WWN addresses. – FlexAddress — Displays the chassis assigned WWN/MAC addresses. – Factory — Displays the MAC/WWN addresses for all LOMs or

mezzanine cards.

– all — Displays the console assigned MAC/WWN of all LOMs or

mezzanine cards.

Example

• Displays the NDC or LOM MAC address.

racadm getmacaddress

• 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

• Displays the user-defined MAC and WWN address.

– racadm getmacaddress -c io-identity

– racadm getmacaddress -c io-identity -m server -2

• Displays the console assigned MAC/WWN of all LOMs or mezzanine cards.

racadm getmacaddress -c all

• Displays the chassis assigned WWN/MAC address.

racadm getmacaddress -c flexaddress

• Displays the MAC/WWN addresses for all LOMs or mezzanine cards.

racadm getmacaddress -c factory

Displays the MAC address for chassis.

racadm getmacaddress -m chassis

<Name> <Presence> <BMC MAC

Address>

CMC Present N/A 74:86:7A:D5:33:

Displays the MAC address for switch –1

racadm getmacaddress -m switch-1

<Name> <Presence> <BMC MAC

Address>

Switch-1 Present Not Installed 00:00:00:00:00:00Not Installed

Displays the MAC address for switch –1

racadm getmacaddress -m server-1

<Name> <Presence> <BMC MAC

Address>

Server-1a Present F8:DB:88:3E:

01:80

Server-1b Present F8:DB:88:3E:

02:50

F8:DB:88:3E: 01:81

F8:DB:88:3E: 02:6F

N/A

F8:DB:88:3E: 01:84

F8:DB:88:3E: 02:72

Server-1c Present F8:DB:88:3E:

08:09

Server-1b Not Present Not Installed Not Installed Not Installed

Display extra MACs for server-1 (if available).

racadm getmacaddress -m server-1 -x

F8:DB:88:3E: 01:E9

F8:DB:88:3E: 01:EC

<Name> <Presence> <BMC MAC

Address>

server-1 Present 00:11:43:FD:B7:2A00:11:43:FD:B7:2A00:11:43:FD:B7:

00:11:43:FD:B7:2C00:11:43:FD:B7:

Displays the MAC address.

racadm getmacaddress

Name> <Type> <Presence><BMC MAC

CMC N/A Present N/A 74:86:7A:D5:33

Server-1-A Gigabit

Server-2 Not

Server-3A

Ethernet

Installed

10 GbE KR iSCSI FCoE-FIP FCoE-WWN 10 GbE KR

Present 74:86:7A:D6:CF:

Not Present

Present Present Present Present Present

Address>

Not Installed Not Installed Not Installed

74:86:7A:D6:D0: 38

:44

Not Installed

E0:DB: 55:25:65:9C E0:DB: 55:25:65:9D E0:DB: 55:25:65:9D 20:01:E0:DB: 55:25:65:9D E0:DB: 55:25:65:A0

N/A

Not Installed

E0:DB: 55:25:65:9E E0:DB: 55:25:65:9E E0:DB: 55:25:65:9F 20:01:E0:DB: 55:25:65:9F E0:DB: 55:25:65:A2

Server-4

Switch-1 Gigabit

Displays Ethernet and iSCSI MAC address of all LOMs or mezzanine cards.

racadm getmacaddress

<Name> <Presence> <BMC MAC

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

Server-1 Present 00:1E:4F:2A:AF:7B00:1E:4F:

Server-2 Present 00:22:19:D2:1E:84N/A N/A

Not Installed

Ethernet

Not Present

Present Not Installed 00:00:00:00:00

Not Installed Not Installed Not Installed

:00

Address>

2A:D3:97

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

Not Installed

Server-3 Not Present N/A N/A N/A

Server-4 Present 00:18:8B:FF:

Switch-1 Present N/A 00:00:00:00:00:00N/A

Displays the user-defined MAC and WWN address.

racadm getmacaddress -c IO-Identity

Name> <Type> <Presence> <Active WWN/

server-1-A

IDRACController

Gigabit Ethernet

45:2A

MAC>>

Present 18:A9:9B:FD:

C4:DF

Present 00:0A:00:0A:

00:00

Present 00:0A:00:0A:

00:01

Present 00:0A:00:0A:

00:02

Present 00:0A:00:0A:

00:03

00:18:8B:FF:AA:0200:18:8B:FF:AA:

N/A Factory

Unknown IO-Identity

Displays the MAC/WWN addresses for all LOMs or mezzanine cards.

racadm getmacaddress -c factory

<Name> <Type> <Presence><Active WWN/

Server-3-A IDRAC-

Controller

Gigabit Ethernet

Switch-1 10 GbE KR Present F8:B1:56:45:D

Displays the chassis assigned WWN/MAC address.

racadm getmacaddress -c flexaddress

Present 5C:F9:DD:D6:1

Present 84:8F:

MAC>>

C:CE

69:FC:E8:F0

69:FC:E8:F1

D:BD

N/A Factory

Unknown IO-Identity

N/A Factory

<Name> <Type> <Presence><Active WWN/

MAC>>

Server-4-A IDRAC-

Controller

10 GbE KR Present F8:DB:88:3D:

10 GbE KR/3 Present F8:DB:

NOTE: 10 GbE KR/3— The value 3 indicates the protocol type.

Displays the console assigned MAC/WWN of all LOMs or mezzanine cards.

racadm getmacaddress -c all

<Name> <Type> <Presence><Active WWN/

Server-1-A IDRAC-

Controller

Gigabit Ethernet

Server-3-A Gigabit

Ethernet

Present F8:DB:88:3D:

9F:A7

9F:A9

88:3D:A2:78

88:3D:A2:7B

MAC>>

Present 18:A9:9B:FD:C

4:DF

Present 00:0A:00:0A:

00:00

Present 4:8F:

69:FC:E8:F1

N/A FlexAddress

Disabled FlexAddress

Unknown FlexAddress

N/A FlexAddress

N/A Factory

Unknown IO-Identity

Unknown Factory

Server-4-A 10 GbE KR/3 Present F8:DB:

FCoE-WWN Present 20:01:F8:DB:

88:3D:A2:7A

getmodinfo

Description

Synopsis

Input

Displays configuration and status information for all modules or a specified module (server, switch, CMC, fan unit, blower, power supply unit, chassis, 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.

racadm getmodinfo [-m <module>] [-A]

• -m < module > — 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.

<module > can be one of the following values:

Unknown FlexAddress

– server-n , where n = 1 to 4 – server-nx , where n = 1 to 4; x = a to d – switch-n , where n = 1 or 2 – pcie-n , where n = 1 to 8 – CMC-n , where n = 1 – fan-n , where n = 1 to 8 – ps-n , where n = 1 to 2 – chassis – main-board – io-cable – fpc cable

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

Example

• racadm getmodinfo -m switch-1

• <module> <presence> <pwrState> <health> <svcTag> Switch-1

Present ON OK CG09074

• racadm getmodinfo

Chassis

MainBoard

Fan-1 Present ON OK N/A N/A

Fan-2 Present ON Unknown N/A N/A

Fan-3 Present ON Unknown N/A N/A

Fan-4 Present ON Unknown N/A N/A

Fan-5 Present ON OK N/A N/A

Fan-6 Present ON Unknown N/A N/A

Fan-7 Present ON Unknown N/A N/A

Fan-8 Present ON Unknown N/A N/A

Present ON OK ST0MP19 N/A

Present ON OK N/A N/A

PS-1 Present Online OK N/A N/A

PS-2 Present Online OK N/A N/A

CMC Present Primary OK N/A N/A

Switch-1 Present ON OK 0000000 N/A

Switch-2 Present ON OK N/A N/A

Server-1 Present OFF OK H23H23Z H23H23Z

Server-2 a

Server-2bPresent OFF OK JD3FRTW JD3FRTWb

Server-2 c

Server-2d Present OFF OK JD3FRTW JD3FRTWd

Present OFF OK JD3FRTW JD3FRTWa

Present OFF OK JD3FRTW JD3FRTWc

getniccfg

Description Displays the current NIC settings.

Synopsis

Input

racadm getniccfg

racadm getniccfg –m <module>

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

Example

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:

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 Displays power budget status information.

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

Synopsis

Example

racadm getpbinfo

[Power Budget Status] System Input Power = 90 W Peak System Power = 93 W Peak System Power Timestamp = 20:28:32 03/04/2014 Minimum System Power = 83 W Minimum System Power Timestamp = 20:28:02 03/04/2014 Overall Power Health = OK Redundancy = Yes System Input Power Cap = 3371 W Redundancy Policy = Redundancy Alerting Only System Input Max Power Capacity = 2382 W Input Redundancy Reserve = 0 W Max Power Conservation Mode = 11:20:08 02/27/2014 Power Available for Server Power-on = 1965 W

[Chassis Power Supply Status Table] <name> <Model> <Power State> <Input Current> <Input Volts> <Output Rated

Power

PS1 0CC6WF Online 0.3 A 208.0 V 1100 W PS2 0GYH9V Online 0.3 A 209.0 V 1100 W

racadm getpbinfo

getpciecfg

Description Displays the FQDD of the PCIe slots and their mapping information and

properties.

NOTE: To use this subcommand, you must have CMC Login User privilege.

Synopsis

Input

racadm getpciecfg [-c <FQDD>]

• -a — Use this option to display the assignment of PCIe slots .

• -c — Use this option to select a specific PCIe adapter or Virtual Adapter.

• FQDD — FQDD of the selected PCIe slot

Example

• Displays FQDDs of all the PCIe slots:

racadm getpciecfg

<PCIe Slot#> <FQDD> PCIe slot 01 PCIE.ChassisSlot.1 PCIe slot 02 PCIE.ChassisSlot.2 PCIe slot 03 PCIE.ChassisSlot.3 PCIe slot 04 PCIE.ChassisSlot.4 PCIe slot 05 PCIE.ChassisSlot.5 PCIe slot 06 PCIE.ChassisSlot.6 PCIe slot 07 PCIE.ChassisSlot.7 PCIe slot 08 PCIE.ChassisSlot.8

• Displays the assignment of PCIe slots and Vitual Adapters:

racadm getpciecfg -a <PCIe Slot#> <Name> <pwrState> <Server Slot Name> <Server Slot#> PCIe slot-1 PCIe Card 1 ON SLOT-04 4

PCIe slot-2 Not Present N/ A UNMAPPED N/A

PCIe slot-3 PCIe Card 3 OFF SLOT-03 3

PCIe slot-4 Extension PCIe Card 3 ON SLOT-03 3

PCIe slot-5 PCIe Card 5 OFF SLOT-02 2

PCIe slot-6 Not Present N/ A UNMAPPED N/A

PCIe slot-7 PCIe Card 7 ON localhost 1

PCIe slot-8 Not Present N/ A UNMAPPED N/A

• Displays the properties of a PCIe slot selected using FQDD:

racadm getpciecfg -c pcie.chassisslot.1

getpminfo

Description Displays power management status information.

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

Synopsis

Example

racadm getpminfo

[Real-Time Power Statistics] System Input Power = 89 W (303 BTU/h) Peak System Power = 93 W (317 BTU/h) Peak System Power Start Time = 20:26:06 03/04/2014 Peak System Power Timestamp = 20:28:32 03/04/2014

gettracelog

Minimum System Power = 83 W (283 BTU/h) Minimum System Power Start Time = 20:26:06 03/04/2014 Minimum System Power Timestamp = 20:28:02 03/04/2014 System Idle Power = 89 W (303 BTU/h) System Potential Power = 417 W (1422 BTU/h) System Input Current Reading = 0.6 A

[Real-Time Energy Statistics] System Energy Consumption = 62.2 kWh System Energy Consumption Start Time = 15:56:11 02/12/2014 System Energy Consumption Timestamp = 06:07:07 03/05/2014

[System Power Status] Chassis Power State = ON Overall Power Health = OK Redundancy = Yes

[System Power Policy Configuration] System Input Power Cap = 3371 W (11502 BTU/h | 100%) Redundancy Policy = Redundancy Alerting Only

[Power Budgeting] System Input Max Power Capacity = 2382 W Input Redundancy Reserve = 0 W Power Available for Server Power-on = 1965 W

Description Lists all the trace log entries in CMC.

Synopsis

Input

Output The default output display shows the record number, timestamp, source, and

Example

• racadm gettracelog -i [-A]

• racadm gettracelog [-s <start>] [-c <count>] [--more] [-

A] [-o]

• -i - Displays the number of entries in CMC 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.

description. The timestamp begins at midnight, January 1 and increases until the system boots. After the system boots, the system’s timestamp is used.

Record: 1

Date/Time: Dec 8 08:21:30

Source: ssnmgrd[175]

Description: root from 192.68.157.103: session timeout sid 0be0aef4

getractime

Description Displays the current CMC time.

Synopsis

Input

Output The current CMC time is displayed.

Example

• racadm getractime [-d]

• racadm getractime [-d] [-z] [-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.

• racadm getractime Thu Dec 8 20:15:26 2005

• racadm getractime -d

20051208201542.000000

getsel

Description Displays all sensor event log entries in the DRAC.

Synopsis

• racadm getsel -i [-A]

• racadm getsel [-s <start>] [-c <count>] [-A] [-o] [-E] [-R] [--more]

Input

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

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

getslotname

Description

Synopsis

Input

Example

racadm getsel

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

• racadm getslotname

• racadm getslotname [-i <slotNum> | -h]

• racadm getslotname -h

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

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

• Display all slots names.

racadm getslotname

<Slot #> <Slot Name> <Host name> 1 SLOT-01 2 Webserver01 WXP-8GRB221 3 Webserver3 WXP-319QWEecet5 4 SLOT-04

• Display the name of the third slot.

racadm getslotname -i 3

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

getsensorinfo

Description

Displays status of chassis sensors.

NOTE: To use this subcommand, you must have CMC Login User privilege.

Synopsis

Examples

racadm getsensorinfo

Sensor Type : Voltage

<Sensor Name> <Status> <Reading> <LC> UC

CPU1 VCORE PG OK 0 600 N/A

System Board 12V PG

System Board

3.3V PG

System Board 5V PG

CPU1 PLL PG OK 4107 600 N/A

System Board

1.5V PG

System Board

1.1V PG

CPU1 M01 VTT PG OK 0 600 N/A

CPU1 M23 VDDQ PG

OK 0 600 N/A

OK 4037 600 N/A

OK 4045 600 N/A

OK 0 600 N/A

CPU1 M23 VTT PG OK 0 600 N/A

CPU1 VSA PG OK 0 600 N/A

CPU1 M01 VDDQ PG

NDC PG OK 0 600 N/A

CPU1 VTT PG OK 0 600 N/A

MEZZB PG OK 0 600 N/A

MEZZC PG OK 0 600 N/A

PERC1 PG OK 0 600 N/A

Sensor Type : Current

OK 0 600 N/A

System Board Current

Sensor Type : Processor <

Sensor Name> <Status> <AC-OK status> <lc> <uc> CPU1 Status OK Presence Detected N/A N/A CPU2 Status N/A Absent N/A N/A

Sensor Type : Memory <Sensor Name> <Status> <State> <lc> <uc> DIMM SLOT A1 OK Presence Detected N/A N/A DIMM SLOT A2 OK Presence Detected N/A N/A DIMM SLOT A3 OK Presence Detected N/A N/A DIMM SLOT A4 OK Presence Detected N/A N/A DIMM SLOT A5 OK Absent N/A N/A DIMM SLOT A6 OK Absent N/A N/A DIMM SLOT A7 OK Absent N/A N/A DIMM SLOT A8 OK Absent N/A N/A DIMM SLOT A9 OK Absent N/A N/A DIMM SLOT A10 OK Absent N/A N/A DIMM SLOT A11 OK Absent N/A N/A DIMM SLOT A12 OK Absent N/A N/A DIMM SLOT B1 OK Absent N/A N/A DIMM SLOT B2 OK Absent N/A N/A DIMM SLOT B3 OK Absent N/A N/A DIMM SLOT B4 OK Absent N/A N/A DIMM SLOT B5 OK Absent N/A N/A DIMM SLOT B6 OK Absent N/A N/A DIMM SLOT B7 OK Absent N/A N/A DIMM SLOT B8 OK Absent N/A N/A DIMM SLOT B9 OK Absent N/A N/A DIMM SLOT B10 OK Absent N/A N/A DIMM SLOT B11 OK

OK 22 3 -7 42 47

Absent N/A N/A DIMM SLOT B12 OK Absent N/A N/A

Sensor Type : Battery <Sensor Name> <Status> <Reading> <lc> <uc> System Board CMOS Battery OK Present N/A N/A

getssninfo

Description Displays a list of users that are connected to CMC. 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 CMC administrator can close the respective sessions or all the sessions using the, closessn subcommand. For more information, see closessn.

Synopsis

Input

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" "192.68.174.19" "Telnet" "NONE"

racadm getssninfo -A -u *

"root" "192.68.174.19" "Telnet" "NONE"

"bob" "192.68.174.19" "GUI" "NONE"

racadm getssninfo [-A] [-u <username> | *]

• -A - eliminates the printing of data headers.

• -u - The -u <username> user name option limits the printed output to

only the detail session records for the given user name.

getsvctag

Description Displays the service tag of the host system.

Synopsis

Input

Output

Example

getsysinfo

Description

Synopsis

Input

racadm getsvctag

getsvctag

Y76TP0G

racadm getsvctag

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.

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

• -d - Displays CMC information.

• -c - Displays chassis information.

• -A - Does not display headers and labels.

• -4 - Displays IPv4 information.

• -6 - Displays IPv6 information.

Output

CMC Information: CMC Date/Time = Tue Jan 29 2013 23:00 CMC Location = CMC-1 Primary CMC Location = 4.40 CMC Version = 1.10 Last Firmware Update = Mon Jan 28 2013 08:41 Hardware Version = A04

CMC Network Information: NIC Enabled = 1 MAC Address = D4:AE:52:AC:CA:C6 Register DNS CMC Name = 1 DNS CMC Name = cmc-servicetag Current DNS Domain = swtest.com VLAN ID = 1 VLAN Priority = 0 VLAN Enabled = 0

CMC IPv4 Information: IPv4 Enabled = 1 Current IP Address = 192.168.164.115 Current IP Gateway = 192.168.164.1

Current IP Netmask = 255.255.255.0 DHCP Enabled = 1 Current DNS Server 1 = 192.168.165.80 Current DNS Server 2 = 0.0.0.0 DNS Servers from DHCP = 1

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

Chassis Information: System Model = PowerEdge FX2s System AssetTag = 00000 Service Tag = STPST06 Express Service Code = 62746758870 Chassis Name = CMC-STPST06 Chassis Location = [UNDEFINED] Chassis Midplane Version = 1.0 Power Status = ON System ID = 1488 PCIe Switch Board Type = Gen 3

NOTE: In the Chassis Information output, the PCIe Switch Board

information is displayed only for PowerEdge FX2s chassis model.

Type

Examples

racadm getsysinfo -d

racadm getsysinfo -c

racadm getsysinfo -A

racadm getsysinfo -4

racadm getsysinfo -6

gettracelog

Description Lists all the trace log entries in CMC.

Synopsis

Input

• racadm gettracelog -i [-A]

• racadm gettracelog [-s <start>] [-c <count>] [--more] [-

A] [-o]

• -i - Displays the number of entries in CMC 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.

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

getversion

Description

Synopsis

Input

Record: 1

Date/Time: Dec 8 08:21:30

Source: ssnmgrd[175]

Description: root from 192.68.157.103: session timeout sid 0be0aef4

Displays the current software version, model and generation information, and whether the target device can be updated.

NOTE: To use this subcommand, you must have CMC Login User privilege.

• racadm getversion

• racadm getversion [-b | -c] [-m <module>]

• racadm getversion -l [-m <module>] [-f <filter>]

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> <iDRAC Version> <Gen> <Updatable> server-4 1.55.55 PowerEdge FM120 iDRAC7 Y

<Server> <CMC Version> <Updatable> cmc-1 1.10.X32.201409150993 Y

<Chassis Infrastructure> <FW Version> <FQDD> Main Board

1.10.X01.201407023 System.Chassis. 1#Infrastructure.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 < filter > - Filters the components. Must be used with -1 and be one of

the following values:

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

• -m < module > - Specifies the module or device for which you must

retrieve the version information. < module > is one of the following:

– server-n , where n = 1 to 4. – switch-n , where n = 1 to 2. – CMC-n , where n = 1 – mainboard

Example

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

Synopsis

Example

racadm ifconfig

$ racadm ifconfig

eth0 Link encap:Ethernet HWaddr 00:1D:09:FF:DA:23

inet addr:10.35.155.136 Bcast:10.35.155.255 Mask:255.255.255.0

UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1

RX packets:2550665 errors:0 dropped:0 overruns:0 frame:0

TX packets:0 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:1000

RX bytes:272532097 (259.9 MiB) TX bytes:0 (0.0 B)

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

Input

Example

• racadm jobqueue view

• racadm jobqueue delete

• racadm jobqueue create

• —i — Specifies the JobID that is displayed or deleted.

• – –all — The JobIDs that are not applied are deleted.

• <fqdd> — 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] 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]

--------------------------------------------------------

• Delete the specified job:

racadm jobqueue delete -i RID_860202993201

• racadm jobqueue delete -i <JobID>

krbkeytabupload

Description Uploads a Kerberos keytab file.

To run this subcommand, you must have the Configure Chassis Administrator privilege.

Synopsis

Input -f — Specifies the file name of the keytab to be uploaded. If the file is not

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

Example

racadm krbkeytabupload [-f <filename>]

<filename> is the name of the file including the path.

specified, the keytab file in the current directory is selected.

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

license

Description

Synopsis

Manages the CMC licenses.

racadm license <license command type>. The command type can be:

• View the license using the following options:

– racadm license view – racadm license view [-c <component>]

• racadm license import [-u <username>] [-p <password>]

[-f <license file name>] [-l <NFS or CIFS share>] [-c <FQDD>]

• Export the license using the following options:

– racadm license export [-u <username>] [-p <password>]

[-f <license file name>] [-1 <NFS/CIFS share>] [—t <transaction ID>]

– racadm license export [-u <username>] [-p <password>]

[-f <license file name>] [-1 <NFS/CIFS share>] [—e <entitlement ID>]

– racadm license export [-u <username>] [-p <password>]

[-f <license file name>] [-1 <NFS/CIFS share>] [—c <FQDD>]

– racadm license export [-u <username>] [-p <password>]

[-f <license file name>] [-1 <NFS/CIFS share>] [—c <FQDD>] [—e <entitlement ID>] [—t <transaction ID>]

• Delete the license using the following options:

– racadm license delete [-t <transaction ID>] – racadm license delete [-e <entitlement ID>] – racadm license delete [-c <component]

• Replace the license:

racadm license replace [-u <username>] [-p <password>] [-f <license file name>] [-1 <NFS/CIFS share>] [—t <transaction ID>]

Input

NOTE: License operations the <licensefile> name should be less than 56 Characters.

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.

NOTE: During export, the license file is named <servicetag>_<entitlement ID>.xml.

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

Examples

• 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 FX2/FX2s Unique Identifier = License #1 Status = OK Transaction ID = 8 License Description = CMC Enterprise Evaluation License

License Type = EVALUATION Entitlement ID = A2Wir6lJ1MoP8iBAtqsEKDv8 Expiration = 1982-04-07T21:00:00

• 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 <default root user password> -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 permission.

Synopsis

Input

Output

racadm netstat

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 :: U 256 0 0 eth1

Kernel IP routing table Destination Gateway Genmask Flags MSS Window irtt Iface

192.168.161.0 0.0.0.0 255.255.255.0 U 0 0 0 bond0

0.0.0.0 198.168.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 IP address is reachable from CMC with the

current routing-table contents. A destination IP address 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.

Synopsis

racadm ping <ipaddress>

ping6

Description Verifies that the destination IPv6 address is reachable from an 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

Example

racadm ping6 <ipv6address>

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 postdeployment configuration verification and during debugging sessions.

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

Synopsis

Input Racdump includes the following subsystems and aggregates the following

racadm racdump

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

Output The following information is displayed when the racdumpsubcommand is

processed:

• General system/RAC information

• Coredump

• Session information

• Process information

• Firmware build information

Example

racadm racdump

=============================================================================== General System/RAC Information ===============================================================================

CMC Information: CMC Date/Time = Wed, 28 Nov 2007 11:55:49 PM CMC Version = X08 Last Firmware Update = Wed Nov 21 21:37:56 2007 Hardware Version = 2 Current IP Address = 10.35.155.160 Current IP Gateway = 10.35.155.1 Current IP Netmask = 255.255.255.0 DHCP Enabled = 1 MAC Address = 00:55:AB:39:10:0F Current DNS Server 1 = 0.0.0.0 Current DNS Server 2 = 0.0.0.0 DNS Servers from DHCP = 0 Register DNS CMC Name = 0 DNS CMC Name = cmc-servicetag Current DNS Domain =

Chassis Information: System Model = PowerEdgeM1000eControlPanel System AssetTag = 00000 Service Tag = Chassis Name = Dell Rack System Chassis Location = [UNDEFINED] Power Status = ON

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

Session Information ===============================================================================

Type User IP Address Login Date/Time SSH root 10.9.72.252 11/28/2007 23:40:53 KVM root 169.254.31.30 11/28/2007 18:44:51

=============================================================================== Sensor Information ===============================================================================

senType> <Num> <sensorName> <status> <reading> <units> <lc> uc>

< FanSpeed 1 Fan-1 OK 14495 rpm 7250 14500 FanSpeed 2 Fan-2 OK 14505 rpm 7250 14500 FanSpeed 3 Fan-3 OK 4839 rpm 2344 14500 FanSpeed 4 Fan-4 OK 14527 rpm 7250 14500 FanSpeed 5 Fan-5 OK 14505 rpm 7250 14500 FanSpeed 6 Fan-6 OK 4835 rpm 2344 14500 FanSpeed 7 Fan-7 OK 14521 rpm 7250 14500 FanSpeed 8 Fan-8 Not OK 1 rpm 7250 14500 FanSpeed 9 Fan-9 OK 4826 rpm 2344 14500

senType> <Num> <sensorName> <status> <reading> <units> <lc>

< <uc> Temp 1 Ambient_Temp OK 21 celcius N/A 40

senType> <Num> <sensorName> <status> <AC-OK status>

< PWR 1 PS-1 Online OK PWR 2 PS-2 Online OK PWR 3 PS-3 Online OK PWR 4 PS-4 Slot Empty N/A PWR 5 PS-5 Failed OK PWR 6 PS-6 Slot Empty N/A

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, CMC may require up to two minutes to return to a usable state.

Synopsis

Input (module) — server-n , where n=1–4.

Example

racadm racreset [-m <module>]

NOTE: You can specify multiple modules: -m <module 1> –m <module 2>.

• 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

Input

Example

racresetpcie

racadm racresetcfg [-m <module>] [-c <feature>]

• -m : <module> — 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–2

• -c : <feature> — Must be one of the following values:

– 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”. – NOTE: The –c option is valid with only <module=chassis>.

• 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

Description Resets the PCIe server mapping in the chassis to factory defaults.

NOTE:

• To use this subcommand for CMC, you must have the Chassis Administrator privilege.

• This command cannot run successfully, if any blade server is powered on.

Synopsis

racadm racresetpcie

remoteimage

Description Connects, disconnects, or deploys a media file on a remote server.

To use this subcommand, you must have the Administrator permission.

Synopsis

Input

Example

racadm remoteimage <options>

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

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

Input

racadm serveraction <action>

• -m <module> server-n, where n=1–4

• -a - Performs action on all servers. Not allowed with the powerstatus action.

• <action>- Specifies the action. The options for the <action> 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 resettig the iDRAC on a server.

NOTE: The reseat option is not available for individual FM120 servers.

NOTE: The action powerstatus is not allowed with an -a option.

Output Displays an error message if the requested operation fails, or a success

message if the operation is completed.

Example

• 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 turned off on that server

racadm serveraction -m server-3 powerdown

Server is already powered OFF.

• Turn off the server from CMC when Power is already turned 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

• Get Power status action on multinode server:

racadm serveraction -m server-1a powerstatus

• Get Power Status on iDRAC

racadm serveraction powerstatus

Server Power Status: ON

• Reseat action on a multinode sled

racadm serveraction -f -m sled-1 reseat

• Explanation of Support CMC needs to support graceful shutdown

The support of address individual blades is expected on the CMC

set

Description

Synopsis

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

Example –Import event filter configuration from a file.

Import saved CMC Event Filter configuration from a file.

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

racadm set -f <filename>

racadm -r 10.94.161.119 -u root -p <default root user password> 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.

NOTE: The special characters " (double quote), ` (back quote), & (ampersand), and \ (backslash) are not supported for this subcommand.

Synopsis

Input -m < module > — Specifies the module whose asset tag you want to set.

racadm setassettag -m chassis <asset tag>

Legal value: chassis

You can obtain the same output if you do not include this option, because there is only one legal value.

< assettag > 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 Sets the name of the chassis.

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

NOTE: The special characters " (double quote), ` (back quote), & (ampersand), and \ (backslash) are not supported for this subcommand.

Synopsis

racadm setchassisname <name>

NOTE: Chassis name is a maximum of 64 non-extended ASCII characters.

Example

racadm setchassisname dellchassis-1

The chassis name was set successfully.root

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 <slot#> <state>][-f <fabricName> <state>]

< slot# > = 1 to 4

< fabricName > = A1 or A2

< state > = 0 or 1

where 0 is disable and 1 is enable.

Input

Example

• -i <slot#> <state> — Enables or disables FlexAddress for the specified slot.

• -f <fabricName> <state> — 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

Input

Example

racadm setled -m <module> -l <ledState>

• -m <module> - Specifies the module whose LED you want to configure. <module> can be one of the following:

— server-n, where n=1–4

— switch-n, where n=1–2

— cmc-active

— chassis

• -l <ledstate> - Specifies whether the LED should blink. <ledstate> 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 CMC 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 Chassis Administrator permission.

NOTE: The terms NIC and Ethernet management port may be used interchangeably.

Synopsis

• racadm getniccfg

• racadm getniccfg –m <module>, 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 or 2

• racadm setniccfg -d

• racadm setniccfg -d6

• racadm setniccfg -s <IPv4Address> <netmask> <IPv4

gateway>

• racadm setniccfg -s6 <IPv6 Address> <IPv6 Prefix Length> <IPv6 Gateway>

• racadm setniccfg -o

Input

Example

setractime

• -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. < IPv4Address >, < netmask >, and < gateway > must be typed as dotseparated 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.

• -m<module> — Must be one of the following values:

– chassis: Default state if - m is not specified. – server-n: where n=1–4 – server-nx: where n=1–4; x=a-d (lower case) – switch-n: where n=1–2

• racadm setniccfg -s 192.168.0.120 255.255.255.0

192.168.0.1

• racadm setniccfg -d

• racadm setniccfg -d6

Description Sets the date and time on the CMC.

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

Synopsis

Input

• racadm setractime -d <yyyymmddhhmmss.mmmmmmsoff>

• racadm setractime -l YYYYMMDDhhmmss

• racadm setractime -z {?|timezone|timezone-prefix*}

• -d — Sets the time in the string yyyymmddhhmmss.mmmmmmsoff where:

— yyyy is the year

— mm is the month

— dd is the day

— hh is the hour

— mm is the minutes

— ss is the seconds

— mmmmmm is the number of microseconds

— s is a + (plus) sign or a - (minus) sign, which indicates the sign of the offset.

— off is the offset in minutes

NOTE: 'Off' is the offset in minutes from GMT and must be in 15-minute increments. The timezone is represented as an offset from GMT, and the clock does not automatically adjust to daylight savings time (for the '-d' option).

• -z <zone> - Sets the time zone by name or index, or lists possible time zones. For example, PST8PDT (Western United States), 294 (Seoul), 344 (Sydney). <zone> may be:

— <?> lists the major timezone names/prefixes.

— <timezone> is the case-sensitive name of your timezone or the index listed by '-z timezone-prefix*'.

— <timezone-prefix*> is a prefix of one or more timezones, followed by '*'.

NOTE: The timezone or daylight savings time is fully supported for '-l' and '-z' options. Omit the '-l' option to set the timezone only (eg. '-z US/Central').

• -l — Sets the local date and time in the string yyymmddhhmmss where:

— yyyy is the year

— mm is the month

— dd is the day

— hh is the hour

— mm is the minute

— ss is the second

— Setting the time using the -l and -z options is recommended. This command format allows the CMC to fully support local time zones, including the ability to automatically adjust the CMC time to the local Daylight Savings Time.

Example The setractime subcommand supports dates ranging from 1/1/1970

00:00:00 through 12/31/2030 23:59:59. To set the local time to October 24, 2007 at 3:02:30 PM:

racadm setractime -l 20071024150230

The time was set successfully.

setslotname

Description

Synopsis

Input

Example

Sets the name of the slot and enables the feature to display the 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 set whether the slot name or host name is displayed in the CMC Web interface or with the getslotname -i <slot Num> command. If the host name is not available, the static slot name is used.

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

NOTE:

• The OMSA server agent must be present and running on the server to use the Display Hostname feature. If the agent is not running, the setting is ignored. For more information, see the Dell OpenManage Server Administrator User's Guide at support.dell.com/manuals.

• The special characters " (double quote), ` (back quote), & (ampersand), and \ (backslash) are not supported for this subcommand.

• racadm setslotname [-i <slotNum> <slotname> | -h 0|1]

• racadm setslotname -h <enabled>

• <slotNum> — Specify the slot number in the chassis. Valid values: 1 to 4.

• <slotname> — The new name to be assigned to the slot.

• <enabled> — Sets whether the server's host name is used for display purposes. Valid values: 0 or 1.

• Set the name of slot 3 as server3:

racadm setslotname -i 3 server3

• Enable system to display host names (1=Active):

racadm setslotname -h 1

setsysinfo

Description Sets the name or location of the chassis.

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

NOTE: The special characters " (double quote), ` (back quote), &(ampersand), and \ (backslash) are not supported for this subcommand.

Synopsis

Input

racadm setsysinfo [-c chassisname|chassislocation] <string>

• < string > — Indicates a maximum of 64 non-extended ASCII chassis name or location.

• -c — Sets the chassis name or location.

Example

racadm setsysinfo -c chassisname "Dell Rack System"

The chassis name was set successfully.

SSH or Telnet RACADM

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

• racadm <subcommand>

Example

• racadm getconfig -g idracinfo

• racadm getsysinfo

sshpkauth

Description Enables you to upload and manage up to four different SSH public keys per

user. You can upload a key file or key text, view keys, or delete keys.

RSA key size should be between 768 and 4096 and the recommended DSA key size is 1024.

This command has three mutually exclusive modes—upload, view, and delete that are determined by the options.

Upload

The upload mode allows you to upload a keyfile or to copy the key text on the command line. You cannot upload and copy a key at the same time.

Remote RACADM:

racadm sshpkauth -i <2 to 16> -k <1 to 4> -f <filename>

racadm sshpkauth -i <2 to 16> -k <1 to 4> -t

<key-text>

Telnet/ssh/serial RACADM:

racadm sshpkauth -i <2 to 16> -k <1 to 4> -t

<key-text>

View

The view mode allows the user to view a key specified by the user or all keys.

racadm sshpkauth -i <2 to 16> -v -k <1 to 4>

racadm sshpkauth -i <2 to 16> -v -k all

Delete

The delete mode allows the user to delete a key specified by the user or all keys.

racadm sshpkauth -i <2 to 16> -d -k <1 to 4>

racadm sshpkauth -i <2 to 16> -d -k all

Synopsis

Input

Examples :

• Upload an invalid key to iDRAC User 2 in the first key space using a string:

$ racadm sshpkauth -i 2 -k 1 -t "This is invalid key Text"

ERROR: Key text appears to be corrupt

• Upload a valid key to iDRAC User 2 in the first key space using a file:

$ racadm sshpkauth -i 2 -k 1 -f pkkey.key

Key file successfully uploaded.

• Get all keys for User 2 on iDRAC:

$ racadm sshpkauth -v -i 2 -k all

********************* User ID 2 ******************

Key ID 1:

ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzzy +k2npnKqVEXGXIzo0sbR6JgA5YNbWs3ekoxXV fe3yJVpVc/5zrrr7XrwKbJAJTqSw8Dg3iR4n3vUaP +lPHmUv5Mn55Ea6LHUslAXFqXmOdlThd

racadm sshpkauth

NOTE:

For DSA keys greater than 2048, use the following racadm command. CMC accepts RSA keys up to key strength 4096, but the recommended key strength is 1024.

racadm -r 192.168.8.14 -u root -p <default root user password> sshpkauth -i svcacct -k 1 -p 0xfff -f dsa_2048.pub

• -i < user index > - Index for the user. <user index> must be between 2 and 16 on iDRAC.

• -k [< key index > | all] - Index to assign the PK key being uploaded. all only works with the -v or -d options. <key index> must be between 1 and 4 or all on iDRAC.

• -t < PK Key Text > - Key text for the SSH Public key.

• -f < filename > - File containing the key text to upload. The -f option is not supported on Telnet/ssh/serial RACADM.

• -v - View the key text for the index provided.

• -d - Delete the key for the index provided.

wilU2VLw/iRH1ZymUFnut8ggbPQgqV2L8bsUaMqb5PooIIvV6hy4isCNJU= 1024-bit RSA, converted from OpenSSH by xx_xx@xx.xx

Key ID 2:

Key ID 3:

Key ID 4:

sslkeyupload

Description Uploads SSL key from the client to CMC.

To use this subcommand, you must have Server Administrator permission.

Synopsis

Input

Output Returns 0 when successful and a nonzero number when unsuccessful.

Example

racadm sslkeyupload -t <type> -f <filename>

• -t — Specifies the key to upload. 1 = SSL key used to generate the server certificate

• -f — Specifies the file name of the SSL key to be uploaded.

racadm sslkeyupload -t 1 -f c:\sslkey.txt

sslcertupload

Description Uploads a custom SSL server or CA certificate for Directory Service from the

client to CMC.

To use this subcommand, you must have the Server Administrator permission.

Synopsis

Input

racadm sslcertupload -t <type> [-f <filename>]

• -t — Specifies the type of certificate to upload, either the CA certificate for Directory Service or the server certificate.

— 1 = server certificate.

— 2 = CA certificate for Directory Service

• -f — Specifies the file name of the certificate to be uploaded.

• -e — Allows for upload of multiple certificate format types. – 1 = Base64

– 2 = PKCS12

The current release does not support this option.

• -p — Pin for decrypting the PKCS12 file uploaded. If <format type> is selected as 2, it is mandatory to specify -p option.

The current release does not support this option.

Output The sslcertupload command returns 0 when successful, and returns a

nonzero number when unsuccessful.

Example

racadm sslcertupload -t 1 -f c:\cert\cert.txt

sslcertview

Description Displays the SSL server or CA certificate that exists on CMC..

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

Synopsis

Input

Output

racadm sslcertview -t 1

Serial Number 00

racadm sslcertview -t <type> [-A]

• -t — Specifies the type of certificate to view, either the CA certificate or server certificate.

—1 = server certificate

—2 = CA certificate for Directory Service.

• -A — Prevents printing of headers or labels.

Subject Information:

Country Code (CC) US

State (S) Texas

Locality (L) Round Rock

Organization (O) Dell Inc.

Organizational Unit (OU)

Common Name (CN) CMC Default certificate

Issuer Information:

Country Code (CC) US

State (S) Texas

Locality (L) Round Rock

Organization (O) Dell Inc.

Remote Access Group

Organizational Unit (OU)

Common Name (CN) CMC Default certificate

Valid From Jul 8 16:21:56 2005 GMT

Valid To Jul 7 16:21:56 2010 GMT

racadm sslcertview -t 1 -A

Texas

Round Rock

Dell Inc.

Remote Access Group

CMC default certificate

Texas

Round Rock

Dell Inc.

Remote Access Group

CMC default certificate

Jul 8 16:21:56 2005 GMT

Jul 7 16:21:56 2010 GMT

Remote Access Group

sslcsrgen

Description Generates and downloads a CSR file to the client’s local file system. The CSR

can be used for creating a custom SSL certificate that can be used for SSL transactions on CMC.

To use this subcommand, you must have the Chassis Configuration

Administrator• permission.

Synopsis

Input

• racadm sslcsrgen [-g] [-f <filename>]

• racadm sslcsrgen -s

• -g — Generates a new CSR.

• -s — Returns the status of a CSR generation process (generation in progress, active, or none).

• -f — Specifies the filename of the location, <filename>, where the CSR is downloaded.

NOTE: If the -f option is not specified, the filename defaults to sslcsr in your current directory.

Output If no options are specified, a CSR is generated and downloaded to the local

file system as sslcsr by default. The -g option cannot be used with the -s option, and the -f option can only be used with the -g option.

The sslcsrgen -s subcommand returns one of the following status codes:

• CSR was generated successfully.

• CSR does not exist.

Example

NOTE: Before a CSR can be generated, the CSR fields must be configured in the RACADM cfgRacSecurity group. For example: racadm config -g cfgRacSecurity -o

cfgRacSecCsrCommonName MyCompany

NOTE: In telnet/ssh console, you can only generate and not download the CSR file.

racadm sslcsrgen -s

racadm sslcsrgen -g -f c:\csr\csrtest.txt

sslresetcfg

Description Restores the web-server certificate to factory default and restarts web-

server. The certificate takes effect 30 seconds after the command is entered.

To use this subcommand, you must have the Chassis Configuration

Administrator privilege for CMC.

Synopsis

Example

racadm sslresetcfg

$ racadm sslresetcfg

Certificate generated successfully and webserver restarted.

testemail

Description Sends a test e-mail from CMC to a specified destination. Prior to executing

the test e-mail command, make sure that the SMTP server is configured and the specified index in the RACADM cfgEmailAlert group is enabled and configured properly.

Synopsis

Input -i — Specifies the index of the e-mail alert to test.

Output

racadm testemail -i <index>

Success: Test e-mail sent successfully

Failure: Unable to send test e-mail

Example Commands for the cfgEmailAlert group:

• Enable the alert —

racadm config -g cfgEmailAlert -o cfgEmailAlertEnable i 1

• Set the destination e-mail address —

racadm config -g cfgEmailAlert -o cfgEmailAlertAddress i 1 user1@mycompany.com

• Set the custom message that is sent to the destination e-mail address —

racadm config -g cfgEmailAlert -o cfgEmailAlertCustomMsg -i 1 "This is a test!"

• Make sure that the SMTP IP address is configured properly —

racadm config -g cfgRemoteHosts -o cfgRhostsSmtpServerIpAddr 192.168.0.152

• View the current e-mail alert settings —

racadm getconfig -g cfgEmailAlert -i <index>

where <index> is a number from 1 to 4.

testfeature

The following tables describe the testfeature subcommand options.

Option Description

-f <feature> Specifies the feature name. testfeature supports the following features:

• ad — Tests Active Directory configuration using simple authentication (user name and password).

• adkrb — Tests Active Directory configuration using the Kerberos authentication.

• ldap — Tests LDAP configuration and operation (requires user name and password).

-u < username > The user name specified in an appropriate format for the selected

authentication method. That is, Active Directory users are specified as user_name@domain_name.

-p < password > The password for the indicated user account.

-d < bitmask > A bitmask (specified as a hexadecimal value) to select various diagnostic

messaging levels. This option is optional.

NOTE: -d option is not supported with the remote racadm interface.

testfeature -f ad

Description Tests Active Directory configuration using simple authentication (user name

and password). Use the optional -d switch to obtain additional diagnostic information, as needed.

This subcommand when executed performs the following:

• Checks command syntax.

• Verifies whether the required system resources are available.

• Validates Active Directory configuration.

• Verifies the SSL certificate and if the certificate signing request (key) exists.

• Acquires LDAP and Global Catalog Service records from DNS.

• Acquires user privileges from the Active Directory server.

• Checks the time to acquire user privileges with the allotted time to login.

NOTE: In the event of an error, the command displays the test that failed, all the tests performed earlier to the test that failed, and all the error messages.

Synopsis

Example

testfeature -f adkrb

Description Tests the Active Directory configuration using the Kerberos authentication

testfeature -f ad -u <username> -p <password> [-d <diagnostic-message-level>]

• testfeature –f ad –u user@domain –p secret SUCCESSFUL: User permissions are xxxxxppp.

The last three digits are the user's permissions.

• testfeature –f adkrb –u user_name@domain_name

SUCCESSFUL: User permissions are 80000fff.

• testfeature -f ldap -u harold -p barrel SUCCESSFUL: User permissions are 0x00000fff.

(single sign-on or Smart Card login). Use the optional -d switch to obtain additional diagnostic information, as needed. This subcommand, when run, performs the following:

• Checks command syntax.

• Verifies if the required system resources are available.

• Validates Active Directory configuration.

• Verifies if the SSL certificate and certificate signing request (key) exists.

• Acquires LDAP and Global Catalog Service records from DNS.

• Verifies if the CMC can acquire CMC, LDAP and Global Catalog servers FQDN through reverse IP lookups.

• Verifies that the CMC principal name matches the principal name in the uploaded Keytab file.

• Verifies that the CMC acquires a Kerberos TGT.

• Acquires user privileges from the Active Directory server.

• Checks the time to acquire user privileges with the allotted time to login.

Synopsis

testfeature -f ldap

NOTE: In the event of an error, the command outputs all tests performed up to and including the test that failed, and all the error messages.

testfeature -f adkrb -u <username> [-d <diagnosticmessage-level>]

Description Tests LDAP configuration and operation, and reports success as each stage

of the authentication process proceeds. After successful completion, this command prints the CMC privileges assumed by the specified <username>.

If a failure occurs, the command stops with an error message that displays the required corrective action. Use the optional -d switch to obtain additional diagnostic information, as needed.

Synopsis

testfeature -f ldap -u <username> -p <password> [-d <diagnostic-message-level>]

testtrap

Description Tests the RAC’s SNMP trap alerting feature by sending a test trap from CMC to

a specified destination trap listener on the network.

To use this subcommand, you must have the Test Alerts permission.

NOTE: Before you execute the testtrap subcommand, make sure that the specified index in the RACADM cfgAlerting group is configured properly.

Synopsis

Input -i — Specifies the index of the trap configuration to be used for the test. Valid

Example

racadm testtrap -i <index>

values are from 1 to 4.

Commands for the cfgIpmiPet group:

• Enable the alert

racadm config -g cfgIpmiPet -o cfgIpmiPetAlertEnable -i 1

• Set the destination e-mail IP address

racadm config -g cfgIpmiPet -o cfgIpmiPetAlertDestIpAddr

-i 1 192.168.0.110

• View the current test trap settings

racadm getconfig -g cfgIpmiPet -i <index>

where <index> is a number from 1 to 4.

traceroute

Description Traces the network path of routers that packets take as they are forwarded

from your system to a destination IPv4 address.

To use this subcommand, you must have the Administrator permission.

Synopsis

Input

• racadm traceroute <IPv4 address>

• racadm traceroute 192.168.0.1

racadm traceroute 192.168.0.1

Output

traceroute to 192.168.0.1 (192.168.0.1), 30 hops max,

40 byte packets

1 192.168.0.1 (192.168.0.1) 0.801 ms 0.246 ms 0.253 ms

traceroute6

Description Traces the network path of routers that packets take as they are forwarded

from your system to a destination IPv6 address.

To use this subcommand, you must have the Administrator permission.

Synopsis

Output

• racadm traceroute6 <IPv6 address>

• racadm traceroute fd01::1

traceroute to fd01::1 (fd01::1) from fd01::3, 30 hops

max, 16 byte packets

1 fd01::1 (fd01::1) 14.324 ms 0.26 ms 0.244 ms

CMC Property Database Group and Object Descriptions

The CMC property database contains the configuration information for CMC. Data is organized by associated object, and objects are organized by object group. The IDs for the groups and objects that the property database supports are listed in this section for CMC.

Use the group and object IDs with the RACADM subcommands to configure CMC.

NOTE: RACADM sets the value of objects without performing any functional validation on them. For example, RACADM allows you to set the Certificate Validation object to 1 with the Active Directory object set to 0, even though Certificate Validation can happen only if Active Directory is enabled. Similarly, the cfgADSSOEnable object can be set to 0 or 1 even if the cfgADEnable object is 0, but it takes effect only if Active Directory is enabled.

All string values are limited to displayable ASCII characters, except where otherwise noted.

idRacInfo

This group contains display parameters to provide information about the specifics of CMC being queried. One instance of the group is allowed.

Use this object with the getconfig subcommand.

To use this object, you must have CMC Login User privilege.

The following sections provide information about the objects in the idRACInfo group.

idRacProductInfo (Read Only)

Description A text string that identifies the product.

Legal Values A string of up to 63 ASCII characters.

Default for iDRAC Integrated Dell Remote Access Controller.

Default for CMC Chassis Management Controller.

idRacDescriptionInfo (Read Only)

Description A text description of the RAC type.

Legal Values A string of up to 255 ASCII characters.

Default This system component provides a complete set of remote management

functions for Dell PowerEdge servers.

idRacVersionInfo (Read Only)

Description String containing the current product firmware version.

Legal Values A string of up to 63 ASCII characters.

Default The current version number.

idRacBuildInfo (Read Only)

Description String containing the current RAC firmware build version.

Legal Values A string of up to 16 ASCII characters.

Default for CMC The current CMC firmware build version.

idRacName (Read Only)

Description A user-assigned name to identify this controller.

Legal Values A string of up to 15 ASCII characters.

Default for CMC CMC

cfgLanNetworking

This group contains parameters to configure CMC NIC for IPv4.

One instance of the group is allowed. Some objects in this group may require CMC NIC to be reset, which may cause a brief loss in connectivity. Objects that change CMC NIC IP address settings close all active user sessions and require users to reconnect using the updated IP address settings.

For CMC, use this object with the config or getconfig subcommands.

To use this object property for CMC, you must have the Chassis Configuration Administrator privilege.

NOTE: For CMC, you can configure a setting that does not have a hash sign (#) prefixed in the output. To modify a configurable object, use the –o option.

The following sections provide information about the objects in the cfgLanNetworking group.

cfgNicIPv4Enable (Read or Write)

Description Enables or disables the IPv4 stack.

Legal Values

Default

• 1 (TRUE)

• 0 (FALSE)

• For iDRAC: 0

• For CMC: 1

cfgNicVLanEnable (Read or Write)

Description Enables or disables the VLAN capabilities.

All chassis management traffic, including the CMC and all iDRACs, resides on this external VLAN when enabled. No iDRAC configuration change is required to use this external management network VLAN.

Legal Values

Default 0

Example

• 1 (TRUE)

• 0 (FALSE)

• racadm config -g cfgLanNetworking -o cfgNicVLanEnable 1

• racadm config -g cfgLanNetworking -o cfgNicVLanEnable 0

cfgNicVLanId (Read or Write)

Description Specifies the VLAN ID for the network VLAN configuration in CMC. This

property is only valid if cfgNicVLanEnable is set to 1(enabled).

Legal Values 1 – 4000 and 4021 – 4094

Default 1

Example

racadm config -g cfgLanNetworking -o cfgNicVlanID 1

cfgNicVLanPriority (Read or Write)

Description Specifies the VLAN Priority for the network VLAN configuration in CMC. This

property is only valid if cfgNicVLanEnable is set to 1 (enabled).

Legal Values 0 – 7

Default 0

Example

racadm config -g cfgLanNetworking -o

cfgNicVLanPriority 7

cfgDNSDomainNameFromDHCP (Read/Write)

Description Specifies that the DNS domain name should be assigned from the network

DHCP server.

Legal Values

Default 0

This property is used only if cfgNicUseDhcp is set to 1 (true), or if both cfgCurrentIPv6Enabled and cfgIPv6AutoConfig are set to 1 (true).

The CMC can obtain its DNS domain name from either a DHCP or DHCPv6 server, if all of the following properties are set to 1 (true):

• cfgNicIPv4Enable

• cfgNicUseDhcp

• cfgCurrentIPv6Enabled

• cfgIPv6AutoConfig

• cfgDNSDomainNameFromDHCP

• cfgDNSDomainName (Read/Write)

The network administrator must make sure that these DHCP servers are configured to provide the same DNS domain name to the CMC, otherwise the domain name becomes unpredictable.

• 1 (TRUE)

• 0 (FALSE)

cfgDNSDomainName (Read or Write)

Description In the DNS domain name, parameter is only valid if

cfgDNSDomainNameFromDHCP is set to 0 (FALSE).

Legal Values A string of up to 254 ASCII characters. At least one of the characters must be

alphabetic. Characters are restricted to alphanumeric, '-', and '.'.

NOTE: Microsoft Active Directory only supports Fully Qualified Domain Names (FQDN) of 64 bytes or fewer.

Default

<blank>

cfgDNSRacName (Read/Write)

Description Displays the CMC name, which is rac-service tag by default. This parameter

is only valid if cfgDNSRegisterRac is set to 1 (TRUE).

Legal Values A string of up to 63 ASCII characters. At least one character must be

alphabetic.

NOTE: Some DNS servers only register names of 31 characters or fewer.

Default cmc-<service tag>

cfgDNSRegisterRac (Read/Write)

Description Registers the CMC name on the DNS server. When you set this parameter,

the CMC registers its DNS name for its IPv4 and IPv6 addresses with the DNS server.

Legal Values

Default 0

NOTE: For IPv6, only the DHCPv6 address or static address is registered.

• 1 (TRUE)

• 0 (FALSE)

Example:

racadm getconfig -g cfgLanNetworking

cfgNicEnable=1

cfgNicIPv4Enable=1

cfgNicIpAddress=192.168.22.101

cfgNicNetmask=255.255.255.0

cfgNicGateway=192.168.22.101

cfgNicUseDhcp=1

# cfgNicMacAddress=00:00:00:00:00:01

cfgNicVLanEnable=0

cfgNicVLanID=1

cfgNicVLanPriority=0

cfgDNSServersFromDHCP=1

cfgDNSServer1=192.168.0.5

cfgDNSServer2=192.168.0.6

cfgDNSRacName=cmc-frankly

cfgDNSDomainName=fwad.lab

cfgDNSDomainNameFromDHCP=1

cfgDNSRegisterRac=1

cfgDNSServersFromDHCP (Read/Write)

Description Specifies if the DNS server IPv4 addresses should be assigned from the

DHCP server on the network.

For CMC, this property is used only if cfgNicUseDhcp is set to 1 (true).

Legal Values

Default 0

• 1 (TRUE)

• 0 (FALSE)

cfgDNSServer1 (Read/Write)

Description Specifies the IPv4 address for DNS server 1. This property is only valid if

cfgDNSServersFromDHCP is set to 0 (FALSE).

NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses.

Legal Values String representing a valid IPv4 address. For example: 192.168.0.20.

Default 0.0.0.0

cfgDNSServer2 (Read/Write)

Description Retrieves the IPv4 address for DNS server 2. This parameter is only valid if

cfgDNSServersFromDHCP is set to 0 (FALSE).

NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses.

Legal Values String representing a valid IPv4 address. For example: 192.168.0.20.

Default 0.0.0.0

cfgNicEnable (Read/Write)

Description Enables or disables CMC network interface controller. If the NIC is disabled,

the remote network interfaces to CMC are no longer accessible and CMC are only available through the local or serial RACADM interface.

Legal Values

Default 1

• 1 (TRUE)

• 0 (FALSE)

cfgNicIpAddress (Read/Write)

Description Specifies the static IPv4 address to be assigned to the RAC or CMC.

NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE.)

Legal Values String representing a valid IPv4 address. For example: 192.168.0.20.

Default

192.168.0.120

cfgNicNetmask (Read/Write)

Description The subnet mask used for CMC IP address.

This property is only valid if cfgNicUseDhcp is set to 0 (FALSE).

NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE).

Legal Values String representing a valid subnet mask. For example: 255.255.255.0.

Default 255.255.255.0

cfgNicGateway (Read/Write)

Description CMC gateway IPv4 address.

The gateway IPv4 address used for static assignment of the RAC IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE).

NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE).

Legal Values String representing a valid gateway IPv4 address. For example: 192.168.0.1.

Default 192.168.0.1

cfgNicUseDhcp (Read or Write)

Description

Legal Values

Default 0

Specifies whether DHCP is used to assign the CMC IPv4 address. If this property is set to 1(TRUE), then CMC IPv4 address, subnet mask and gateway are assigned from the DHCP server on the network. If this property is set to 0 (FALSE), the user can configure the cfgNicIpAddress, cfgNicNetmask and cfgNicGateway properties.

• 1 (TRUE)

• 0 (FALSE)

cfgNicMacAddress (Read Only)

Description The CMC NIC MAC address in the format: dd:dd:dd:dd:dd:dd, where d is a

Legal Values String representing CMC NIC MAC address.

Default The current MAC address of CMC NIC. For example, 00:12:67:52:51:A3.

hexadecimal digit in range 0 - 9, A - F

cfgUserAdmin

This group provides configuration information about the users who are allowed to access CMC through the available remote interfaces.

Up to 16 instances of the user group are allowed. Each instance represents the configuration for an individual user.

NOTE: In the current CMC firmware version, the objects cfgUserAdminEnable and cfgUserAdminPrivilege are interrelated; changing the value of one property causes the value of the other property to change. For example, if a user does not have login privilege, the user is disabled by default. When you enable the user by changing the value of UserAdminEnable to 1, the right most digit of the change the right-most digit of the UserAdminPrivilege to 0, the value of UserAdminEnable becomes 0.

Use this object with the config or getconfig subcommands. You must supply an index group number to use these commands as follows: -i <index group>

To use this object property, you must have the User Configuration Administrator privilege.

The following sections provide information about the objects in the cfgUserAdmin group.

UserAdminPrivilege also becomes 1. On the other hand, if you

cfgUserAdminIndex (Read Only)

Description The unique index of a user.

The index number is used to specify a unique group name. Only valid for indexed groups.

Legal Values

Default < index of the instance >

The parameter is specified by a decimal integer from 1–16.

cfgUserAdminPrivilege (Read/Write)

Description This property specifies the role-based authority privileges allowed for the

user. The value is represented as a bit mask that allows for any combination of privilege values. The table below describes the user privilege bit values that can be combined to create bit masks.

Legal Values

Default 0x00000000

Example

racadm getconfig -g cfgUserAdmin -i 1

# cfgUserAdminIndex=1 cfgUserAdminEnable=1 cfgUserAdminUserName=root # cfgUserAdminPassword=******** (Write-Only) cfgUserAdminPrivilege=0x00000fff

The following table lists the bit masks for user priveleges.

0x0000000-0x0000fff, and 0x0

iDRAC Specific User Privilege Privilege Bit Mask

Configure iDRAC 0x00000002

Configure Users 0x00000004

Clear Logs 0x00000008

Execute Server Control Commands 0x00000010

Access Virtual Console 0x00000020

Access Virtual Media 0x00000040

Test Alerts 0x00000080

Execute Debug Commands 0x00000100

CMC Specific User Privilege

CMC Login User 0x0000001

Chassis Configuration Administrator 0x0000002

User Configuration Administrator 0x0000004

Clear Logs Administrator 0x0000008

Chassis Control Administrator 0x0000010

Super User 0x0000020

Server Administrator 0x0000040

Test Alert User 0x0000080

Debug Command Administrator 0x0000100

Fabric A Administrator 0x0000200

Fabric B Administrator 0x0000400

Fabric C Administrator 0x0000800

Examples

The following table provides sample privilege bit masks for users with one or more privileges.

User Privilege(s) Privilege Bit Mask

The user is not allowed to access CMC. 0x00000000

The user may only log in to CMC and view CMC and server configuration information.

The user may log in to CMC and change configuration. 0x00000001 + 0x00000002 = 0x00000003

0x00000001

The user may log in, access Virtual Media, and Virtual Console.

0x00000001 + 0x00000040 + 0x00000080 = 0x000000C1

cfgUserAdminUserName (Read/Write)

Description The name of the user for this index. The user index is created by writing a

string into this name field if the index is empty. Writing a string of double quotation marks ("") deletes the user at that index. You cannot change the name. You must delete and then recreate the name. The string cannot contain / (forward slash), \ (backward slash), . (period), @ (at symbol), “ (quotation marks), (semicolon), or ' (backward quote)

NOTE: This property value must be unique among user names.

Legal Values A string of up to 16 ASCII characters.

Default

• root (User 2)

• <blank> (All others)

cfgUserAdminPassword (Write Only)

Description The password for this user. User passwords are encrypted and cannot be

seen or displayed after the property is written.

Legal Values A string of up to 20 ASCII characters.

Default ********

cfgUserAdminEnable (Read/Write)

Description Enables or disables an individual user.

NOTE: You can enable a user for a given index, only if you set the password for the same user.

Legal Values

Default

• 1 (TRUE)

• 0 (FALSE)

cfgEmailAlert

This group contains parameters to configure e-mail alerting capabilities. Up to four instances of this group are allowed.

Use this object with the getconfig and config subcommands.

To use this object property for, you must have Chassis Configuration Administrator privileges.

The following sections provide information about the objects in the cfgEmailAlert group.

cfgEmailAlertIndex (Read Only)

Description The unique index of an alert instance.

Legal Values 1-4

Default <instance>

cfgEmailAlertEnable (Read/Write)

Description Enables or disables the alert instance.

Legal Values

Default 0

• 1 (TRUE)

• 0 (FALSE)

cfgEmailAlertAddress (Read/Write)

Description Specifies the destination email address for email alerts, for example,

user1@company.com.

Legal Values E-mail address format, with a maximum length of 64 ASCII characters.

Default <blank>

cfgEmailAlertEmailName

Description Specifies name or other identifier associated with the destination e-mail

address. The e-mail name can refer to an individual, group, location, department, and so on.

Legal Values A string of up to 32 characters

Default <blank>

Example

racadm getconfig -g cfgEmailAlert -i 2

# cfgEmailAlertIndex=1 cfgEmailAlertEnable=1 cfgEmailAlertAddress=kfulton@dell.com cfgEmailAlertName=Kevin Fulton

100

Dell Chassis Management Controller Version 1.10 Manual

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

Displayable Characters

Supported RACADM Subcommands

Other Documents You May Need

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

config

connect

deploy

eventfilters

fanoffset

feature

featurecard

fwupdate

getactiveerrors

getassettag

getchassisname

getconfig

getdcinfo

getsleduplinkstatus

getflexaddr

getioinfo

getled

getmacaddress

getmodinfo

getniccfg

getpbinfo

getpciecfg

getpminfo

gettracelog

getractime

getsel

getslotname

getsensorinfo

getssninfo

getsvctag

getsysinfo

gettracelog

getversion

ifconfig

jobqueue

krbkeytabupload

license

netstat

ping

ping6

racdump

racreset

racresetcfg

racresetpcie

remoteimage

serveraction

setassettag

setchassisname

setflexaddr

setled

setniccfg

setractime

setslotname

setsysinfo

SSH or Telnet RACADM

sshpkauth

sslkeyupload