Dell PowerEdge VRTX Owner's manual

Type
Owner's manual
Dell Chassis Management Controller Version
3.3 for PowerEdge VRTX
RACADM CLI Guide
July 2020
Rev. A00
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
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.
© 2008 - 2019 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other
trademarks may be trademarks of their respective owners.
Chapter 1: Introduction.................................................................................................................. 12
What’s new in this release.................................................................................................................................................. 12
Supported RACADM Interfaces.........................................................................................................................................12
RACADM Syntax Usage......................................................................................................................................................12
SSH or Telnet RACADM................................................................................................................................................12
Remote RACADM.......................................................................................................................................................... 13
RACADM Command Options........................................................................................................................................13
Supported RACADM Subcommands.................................................................................................................................14
Other documents you may need........................................................................................................................................16
Accessing documents from the Dell EMC support site.................................................................................................. 16
Chapter 2: RACADM Subcommand Details.......................................................................................18
Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands..............................19
Racadm help and help with subcommand........................................................................................................................20
help and help subcommand................................................................................................................................................ 21
chassislog.............................................................................................................................................................................. 21
chassislog export................................................................................................................................................................. 24
chassislog clear....................................................................................................................................................................25
chassisaction........................................................................................................................................................................25
closessn................................................................................................................................................................................ 26
clrsel...................................................................................................................................................................................... 27
cmcchangeover................................................................................................................................................................... 27
config.....................................................................................................................................................................................27
connect.................................................................................................................................................................................28
deploy....................................................................................................................................................................................29
Displayable Characters....................................................................................................................................................... 30
eventfilters........................................................................................................................................................................... 30
fanoffset............................................................................................................................................................................... 32
fcp......................................................................................................................................................................................... 32
feature...................................................................................................................................................................................33
featurecard...........................................................................................................................................................................34
fwupdate...............................................................................................................................................................................34
get......................................................................................................................................................................................... 36
getactiveerrors.....................................................................................................................................................................38
getassettag.......................................................................................................................................................................... 39
getchassisname................................................................................................................................................................... 39
getconfig.............................................................................................................................................................................. 40
getdcinfo............................................................................................................................................................................... 41
getflexaddr........................................................................................................................................................................... 42
getioinfo................................................................................................................................................................................44
getled.................................................................................................................................................................................... 44
getmacaddress.................................................................................................................................................................... 45
getmodinfo............................................................................................................................................................................51
getniccfg...............................................................................................................................................................................52
Contents
Contents 3
getpbinfo.............................................................................................................................................................................. 54
getpciecfg............................................................................................................................................................................ 54
getpminfo............................................................................................................................................................................. 56
getraclog...............................................................................................................................................................................58
getractime............................................................................................................................................................................ 58
getredundancymode........................................................................................................................................................... 59
getsel.....................................................................................................................................................................................59
getsensorinfo....................................................................................................................................................................... 60
getslotname..........................................................................................................................................................................62
getssninfo.............................................................................................................................................................................62
getsvctag..............................................................................................................................................................................63
getsysinfo............................................................................................................................................................................. 63
gettracelog...........................................................................................................................................................................65
getversion.............................................................................................................................................................................65
ifconfig.................................................................................................................................................................................. 68
jobqueue............................................................................................................................................................................... 68
krbkeytabupload.................................................................................................................................................................. 69
license....................................................................................................................................................................................70
netstat...................................................................................................................................................................................72
ping........................................................................................................................................................................................ 73
ping6......................................................................................................................................................................................73
racdump................................................................................................................................................................................ 74
racreset.................................................................................................................................................................................75
racresetcfg........................................................................................................................................................................... 76
racresetpcie..........................................................................................................................................................................76
raid......................................................................................................................................................................................... 77
blink..................................................................................................................................................................................79
createvd..........................................................................................................................................................................80
deletevd........................................................................................................................................................................... 81
discardcache................................................................................................................................................................... 81
exportlog.........................................................................................................................................................................82
forceonline...................................................................................................................................................................... 82
get controllers................................................................................................................................................................ 82
get enclosure..................................................................................................................................................................85
get emms........................................................................................................................................................................86
get fans........................................................................................................................................................................... 87
get psus.......................................................................................................................................................................... 88
get tempprobes............................................................................................................................................................. 89
hotspare..........................................................................................................................................................................90
cancelinit..........................................................................................................................................................................91
cancelrebuild................................................................................................................................................................... 91
assignva........................................................................................................................................................................... 91
unblink............................................................................................................................................................................. 92
init.................................................................................................................................................................................... 92
raid...................................................................................................................................................................................93
rebuild..............................................................................................................................................................................95
resetconfig..................................................................................................................................................................... 95
enableperc...................................................................................................................................................................... 96
disableperc......................................................................................................................................................................96
createsecuritykey.......................................................................................................................................................... 96
4
Contents
modifysecuritykey..........................................................................................................................................................97
deletesecuritykey...........................................................................................................................................................97
encryptvd........................................................................................................................................................................97
cryptographicerase........................................................................................................................................................97
unlock..............................................................................................................................................................................98
remoteimage........................................................................................................................................................................ 98
serveraction......................................................................................................................................................................... 99
set........................................................................................................................................................................................ 100
setassettag......................................................................................................................................................................... 103
setchassisname.................................................................................................................................................................. 103
set controllers.....................................................................................................................................................................103
setflexaddr.......................................................................................................................................................................... 104
setled................................................................................................................................................................................... 105
set enclosure...................................................................................................................................................................... 105
setniccfg............................................................................................................................................................................. 106
setpciecfg........................................................................................................................................................................... 106
setractime........................................................................................................................................................................... 107
setslotname........................................................................................................................................................................ 109
setsysinfo............................................................................................................................................................................109
SSH or Telnet RACADM....................................................................................................................................................110
sshpkauth.............................................................................................................................................................................110
sslcertdownload...................................................................................................................................................................111
sslcertupload........................................................................................................................................................................112
sslcertview...........................................................................................................................................................................112
sslcsrgen.............................................................................................................................................................................. 114
sslresetcfg........................................................................................................................................................................... 115
sslsshresetcfg..................................................................................................................................................................... 115
set tempprobes...................................................................................................................................................................116
testcifsshare........................................................................................................................................................................116
testemail...............................................................................................................................................................................116
testfeature........................................................................................................................................................................... 117
testtrap................................................................................................................................................................................ 119
traceroute............................................................................................................................................................................ 119
traceroute6.........................................................................................................................................................................120
Chapter 3: CMC Property Database Group and Object Descriptions..................................................121
idRacInfo............................................................................................................................................................................. 122
idRacProductInfo (Read Only)................................................................................................................................... 122
idRacVersionInfo (Read Only).................................................................................................................................... 122
idRacBuildInfo (Read Only).........................................................................................................................................122
idRacName (Read Only)..............................................................................................................................................122
cfgLanNetworking............................................................................................................................................................. 123
cfgNicIPv4Enable (Read or Write)............................................................................................................................ 123
cfgNicVLanId (Read or Write)....................................................................................................................................123
cfgDNSDomainNameFromDHCP (Read or Write)..................................................................................................123
cfgDNSDomainName (Read or Write)...................................................................................................................... 124
cfgDNSRacName (Read or Write)............................................................................................................................ 124
cfgDNSRegisterRac (Read or Write)........................................................................................................................ 124
cfgDNSServersFromDHCP (Read or Write)............................................................................................................125
cfgDNSServer1 (Read or Write)................................................................................................................................ 126
Contents
5
cfgDNSServer2 (Read/Write)................................................................................................................................... 126
cfgNicEnable (Read or Write).................................................................................................................................... 126
cfgNicIpAddress (Read or Write).............................................................................................................................. 126
cfgNicNetmask (Read or Write)................................................................................................................................ 127
cfgNicGateway (Read or Write)................................................................................................................................ 127
cfgNicMacAddress (Read Only)................................................................................................................................ 127
cfgRemoteHosts................................................................................................................................................................ 127
cfgRhostsFwUpdateTftpEnable (Read or Write)....................................................................................................128
cfgRhostsFwUpdateIpAddr (Read or Write)............................................................................................................128
cfgRhostsFwUpdatePath (Read or Write)...............................................................................................................128
cfgRhostsSmtpServerIpAddr (Read or Write).........................................................................................................128
icfgRhostsNtpEnable...................................................................................................................................................129
cfgRhostsNtpServer1.................................................................................................................................................. 129
cfgRhostsNtpServer2................................................................................................................................................. 129
cfgRhostsNtpServer3................................................................................................................................................. 129
cfgRhostsNtpMaxDist.................................................................................................................................................130
cfgRhostsSyslogPort (Read or Write)...................................................................................................................... 130
cfgRhostsSyslogEnable (Read or Write).................................................................................................................. 130
cfgRhostsSyslogServer1 (Read or Write).................................................................................................................130
cfgRhostsSyslogServer2 (Read or Write).................................................................................................................131
cfgRhostsSyslogServer3 (Read or Write).................................................................................................................131
cfgRhostsSyslogPowerLoggingEnabled.................................................................................................................... 131
cfgRhostsSyslogPowerLoggingInterval..................................................................................................................... 131
cfgUserAdmin.....................................................................................................................................................................132
cfgUserAdminIndex (Read Only)............................................................................................................................... 132
cfgUserAdminPrivilege (Read or Write)....................................................................................................................133
cfgUserAdminUserName (Read or Write)................................................................................................................134
cfgUserAdminPassword (Write Only)....................................................................................................................... 134
cfgUserAdminEnable (Read or Write).......................................................................................................................135
cfgEmailAlert...................................................................................................................................................................... 135
cfgEmailAlertIndex (Read Only).................................................................................................................................135
cfgEmailAlertEnable (Read/Write)............................................................................................................................135
cfgEmailAlertAddress (Read/Write)......................................................................................................................... 135
cfgEmailAlertEmailName............................................................................................................................................. 136
cfgSessionManagement....................................................................................................................................................136
cfgSsnMgtRacadmTimeout (Read/Write)...............................................................................................................136
cfgSsnMgtWebserverTimeout (Read/Write).......................................................................................................... 137
cfgSerial...............................................................................................................................................................................137
cfgSerialBaudRate (Read/Write)...............................................................................................................................137
cfgSerialConsoleEnable (Read/Write)...................................................................................................................... 137
cfgSerialConsoleIdleTimeout (Read/Write)..............................................................................................................137
cfgSerialConsoleNoAuth (Read/Write).................................................................................................................... 138
cfgSerialConsoleCommand (Read/Write)................................................................................................................138
cfgSerialConsoleColumns............................................................................................................................................138
cfgSerialHistorySize (Read/Write)............................................................................................................................138
cfgSerialSshEnable (Read/Write)..............................................................................................................................139
cfgSerialTelnetEnable (Read/Write) ........................................................................................................................139
cfgOobSnmp...................................................................................................................................................................... 139
cfgOobSnmpAgentCommunity (Read/Write)......................................................................................................... 140
cfgOobSnmpAgentEnable (Read/Write)................................................................................................................. 140
6
Contents
cfgOobSnmpProtocol..................................................................................................................................................140
cfgOobSnmpTrapFormat............................................................................................................................................140
cfgTraps...............................................................................................................................................................................141
cfgTrapsIndex (Read Only)......................................................................................................................................... 141
cfgTrapsEnable............................................................................................................................................................. 141
cfgTrapsAlertDestIpAddr............................................................................................................................................. 141
cfgTrapsCommunityName...........................................................................................................................................141
cfgTrapsSNMPv3UserId (Read Only).......................................................................................................................142
cfgTrapsSNMPv3UserName......................................................................................................................................142
cfgRacTuning..................................................................................................................................................................... 142
cfgRacTuneSMBVersionEnable................................................................................................................................. 142
cfgRacTuneDefCredentialWarningEnable.................................................................................................................143
cfgRacTuneRemoteRacadmEnable (Read/Write)..................................................................................................143
cfgRacTuneHttpPort (Read/Write)..........................................................................................................................143
cfgRacTuneHttpsPort (Read/Write)........................................................................................................................ 143
cfgRacTuneIpRangeEnable (Read/Write)................................................................................................................144
cfgRacTuneIpRangeAddr (Read/Write)................................................................................................................... 144
cfgRacTuneIpRangeMask (Read/Write)..................................................................................................................144
cfgRacTuneIpBlkEnable (Read/Write)......................................................................................................................144
cfgRacTuneIpBlkFailCount (Read/Write).................................................................................................................145
cfgRacTuneIpBlkFailWindow (Read/Write)............................................................................................................. 145
cfgRacTuneIpBlkPenaltyTime (Read/Write)............................................................................................................145
cfgRacTuneSshPort (Read/Write)........................................................................................................................... 145
cfgRacTuneTelnetPort (Read/Write).......................................................................................................................146
cfgRacTuneDaylightOffset (Read Only)...................................................................................................................146
cfgRacTuneTimezoneOffset (Read Only)................................................................................................................146
cfgRacTuneWebserverEnable (Read/Write)...........................................................................................................146
cfgRacTuneFipsModeEnable......................................................................................................................................147
cfgRacTuneTLSProtocolVersionEnable.................................................................................................................... 147
cfgRacTuneChassisNameInPromptEnable............................................................................................................... 147
cfgServerInfo......................................................................................................................................................................147
cfgServerInfoIndex (Read Only)................................................................................................................................ 148
cfgServerSlotNumber (Read Only)........................................................................................................................... 148
cfgServerServiceTag (Read Only).............................................................................................................................148
cfgServerName (Read/Write)................................................................................................................................... 148
cfgServerFW (Read Only).......................................................................................................................................... 148
cfgServerBIOS (Read Only)....................................................................................................................................... 149
cfgServerBmcMacAddress (Read Only).................................................................................................................. 149
cfgServerNic1MacAddress (Read Only)................................................................................................................... 149
cfgServerNic2MacAddress (Read Only).................................................................................................................. 149
cfgServerNic3MacAddress (Read Only).................................................................................................................. 149
cfgServerNic4MacAddress (Read Only).................................................................................................................. 150
cfgServerPriority (Read/Write).................................................................................................................................150
cfgServerNicEnable (Read/Write)............................................................................................................................150
cfgServerIPMIOverLanEnable (Read/Write)...........................................................................................................150
cfgServerPowerBudgetAllocation (Read Only)....................................................................................................... 150
cfgServerDNSRegisterIMC (Read/Write)................................................................................................................ 151
cfgServerDNSIMCName (Read/Write).................................................................................................................... 151
cfgServerRootPassword (Write Only).......................................................................................................................151
cfgServerFirstBootDevice (Read/Write).................................................................................................................. 151
Contents
7
cfgServerBootOnce (Read/Write)............................................................................................................................152
cfgServerPowerConsumption (Read Only)..............................................................................................................152
cfgActiveDirectory.............................................................................................................................................................153
cfgADRacName (Read/Write)...................................................................................................................................153
cfgADCertValidationEnable (Read/Write)................................................................................................................154
cfgADRacDomain (Read/Write)................................................................................................................................154
cfgADRootDomain (Read/Write).............................................................................................................................. 154
cfgADEnable (Read/Write)........................................................................................................................................ 154
cfgADAuthTimeout (Read/Write)............................................................................................................................. 154
cfgADSCLEnable..........................................................................................................................................................155
cfgADSSOEnable (Read/Write)................................................................................................................................ 155
cfgADDomainController1 (Read/Write)....................................................................................................................155
cfgADDomainController2 (Read/Write)................................................................................................................... 155
cfgADDomainController3 (Read/Write)................................................................................................................... 156
cfgADGlobalCatalog1 (Read/Write).......................................................................................................................... 156
cfgADGlobalCatalog2 (Read/Write)......................................................................................................................... 156
cfgADGlobalCatalog3 (Read/Write)......................................................................................................................... 156
cfgADType (Read/Write)........................................................................................................................................... 157
cfgADDcSRVLookupbyUserdomain (Read/Write)..................................................................................................157
cfgADDcSRVLookupDomainName (Read/Write)................................................................................................... 157
cfgADDcSRVLookupEnable (Read/Write)............................................................................................................... 157
cfgADGcRootDomain (Read/Write)......................................................................................................................... 158
cfgADGcSRVLookupEnable (Read/Write)...............................................................................................................158
cfgADSpecifyServerEnable.........................................................................................................................................158
cfgLDAP..............................................................................................................................................................................158
cfgLDAPEnable (Read/Write)................................................................................................................................... 158
cfgLDAPServer (Read/Write)................................................................................................................................... 159
cfgLDAPPort (Read/Write)....................................................................................................................................... 159
cfgLDAPBasedn (Read/Write).................................................................................................................................. 159
cfgLDAPUserAttribute (Read/Write)....................................................................................................................... 160
cfgLDAPGroupAttribute (Read/Write).....................................................................................................................160
cfgLDAPGroupAttributeIsDN (Read/Write)............................................................................................................ 160
cfgLDAPBinddn (Read/Write)...................................................................................................................................160
cfgLDAPBindpassword (Write Only)..........................................................................................................................161
cfgLDAPSearchFilter (Read/Write)...........................................................................................................................161
cfgLDAPCertValidationEnable (Read/Write)............................................................................................................161
cfgLDAPNetworkTimeout........................................................................................................................................... 161
cfgLDAPSearchTimeout.............................................................................................................................................. 161
cfgLDAPSRVLookupDomainName............................................................................................................................ 162
cfgLDAPSRVLookupEnable........................................................................................................................................162
cfgLDAPSRVLookupServiceName (Read/Write)................................................................................................... 162
cfgLDAPRoleGroup........................................................................................................................................................... 162
cfgLDAPRoleGroupDN (Read/Write).......................................................................................................................163
cfgLDAPRoleGroupPrivilege (Read/Write)..............................................................................................................163
cfgLocation.........................................................................................................................................................................163
cfgLocationDatacenter (Read/Write).......................................................................................................................163
cfgLocationAisle (Read/Write).................................................................................................................................. 164
cfgLocationRack (Read/Write)................................................................................................................................. 164
cfgLocationRackslot (Read/Write)........................................................................................................................... 164
cfgLocationDevicesize (Read Only).......................................................................................................................... 164
8
Contents
cfgStandardSchema..........................................................................................................................................................164
cfgSSADRoleGroupIndex (Read Only)......................................................................................................................165
cfgSSADRoleGroupName (Read/Write)..................................................................................................................165
cfgSSADRoleGroupDomain (Read/Write)............................................................................................................... 165
cfgSSADRoleGroupPrivilege (Read/Write)..............................................................................................................165
cfgChassisPower............................................................................................................................................................... 166
cfgChassisInPower (Read Only)................................................................................................................................ 166
cfgChassisPeakPower (Read Only)...........................................................................................................................166
cfgChassisPeakPowerTimestamp (Read Only)....................................................................................................... 167
cfgChassisMinPower (Read Only).............................................................................................................................167
cfgChassisMinPowerTimestamp (Read Only)......................................................................................................... 167
cfgChassisPowerStatus (Read Only)........................................................................................................................167
cfgChassisRedundantState (Read Only)..................................................................................................................168
cfgChassisDefaultPowerCapUpperBound (Read Only)..........................................................................................168
cfgChassisDefaultPowerCapUpperBoundBTU (Read Only)..................................................................................168
cfgChassisDefaultPowerCapLowerBound (Read Only)......................................................................................... 168
cfgChassisDefaultPowerCapLowerBoundBTU (Read Only)..................................................................................168
cfgChassisPowerCap (Read/Write)......................................................................................................................... 169
cfgChassisPowerCapF (Read/Write)....................................................................................................................... 169
cfgChassisPowerCapFBTU (Read/Write)............................................................................................................... 169
cfgChassisPowerCapPercent (Read or Write)........................................................................................................169
cfgChassisPowerCapFPercent (Read/Write)......................................................................................................... 170
cfgChassisRedundancyPolicy (Read/Write)............................................................................................................ 170
cfgChassisDynamicPSUEngagementEnable (Read/Write)................................................................................... 170
cfgChassisInMaxPowerCapacity (Read Only).......................................................................................................... 171
cfgChassisInRedundancyReserve (Read Only).........................................................................................................171
cfgChassisInPowerServerAllocation (Read Only).....................................................................................................171
cfgChassisInfrastructureInPowerAllocation (Read Only)........................................................................................ 171
cfgChassisTotalInPowerAvailable (Read Only)......................................................................................................... 171
cfgChassisStandbyInPowerCapacity (Read Only)...................................................................................................172
cfgChassisPowerClear (Write Only)..........................................................................................................................172
cfgChassisPowerClearTimestamp (Read Only)....................................................................................................... 172
cfgChassisPowerButtonEnable (Read/Write)......................................................................................................... 172
cfgSystemEnergyConsumptionClear (Write Only)..................................................................................................172
cfgChassisServerBasedPowerMgmtMode...............................................................................................................173
cfgChassisPowerCapBTU (Read/Write)..................................................................................................................173
cfgChassisACPowerRecoveryDisable....................................................................................................................... 174
cfgKVMInfo.........................................................................................................................................................................174
cfgKvmMapping (Read/Write).................................................................................................................................. 174
cfgKvmSlot<num>Enable (Read/Write)...................................................................................................................174
cfgDvdInfo.......................................................................................................................................................................... 174
cfgDvdMapping (Read/Write)................................................................................................................................... 175
cfgDvdSlot<num>Enable (Read/Write)................................................................................................................... 175
cfgLcdInfo...........................................................................................................................................................................175
cfgAlerting...........................................................................................................................................................................175
cfgAlertingEnable......................................................................................................................................................... 175
cfgAlertingSourceEmailName.....................................................................................................................................176
cfgIPv6LanNetworking......................................................................................................................................................176
cfgIPv6Enable (Read/Write)......................................................................................................................................176
cfgIPv6AutoConfig (Read/Write)..............................................................................................................................176
Contents
9
cfgIPv6Address............................................................................................................................................................ 177
cfgIPv6PrefixLength (Read/Write)........................................................................................................................... 177
cfgIPv6Gateway (Read/Write).................................................................................................................................. 177
cfgIPv6DNSServersFromDHCP6 (Read/Write)......................................................................................................177
cfgIPv6DNSServer1 (Read/Write)............................................................................................................................ 178
cfgIPv6DNSServer2 (Read/Write)............................................................................................................................178
cfgCurrentLanNetworking (Read Only)..........................................................................................................................179
cfgNicCurrentIPv4Enabled......................................................................................................................................... 179
cfgNicCurrentIpAddress............................................................................................................................................. 180
cfgNicCurrentNetmask............................................................................................................................................... 180
cfgNicCurrentGateway............................................................................................................................................... 180
cfgNicCurrentDhcpWasUsed.....................................................................................................................................180
cfgNicCurrentVlanEnable (Read Only)...................................................................................................................... 181
cfgNicCurrentVlanID (Read Only).............................................................................................................................. 181
cfgNicCurrentVlanPriority (Read Only)..................................................................................................................... 181
cfgDNSCurrentServer1................................................................................................................................................ 181
cfgDNSCurrentServer2............................................................................................................................................... 181
cfgDNSCurrentDomainName..................................................................................................................................... 182
cfgCurrentIPv6LanNetworking (Read Only)..................................................................................................................182
cfgCurrentIPv6Enabled...............................................................................................................................................182
cfgCurrentIPv6AutoConfigWasUsed........................................................................................................................ 182
cfgCurrentLinkLocalAddress...................................................................................................................................... 182
cfgCurrentIPv6Address...............................................................................................................................................183
cfgCurrentIPv6Gateway ............................................................................................................................................ 183
cfgCurrentIPv6DNSServersFromDHCP6 ................................................................................................................183
cfgCurrentIPv6DNSServer1........................................................................................................................................183
cfgCurrentIPv6DNSServer2.......................................................................................................................................183
cfgNetTuning......................................................................................................................................................................184
cfgNetTuningNicSpeed...............................................................................................................................................184
cfgNetTuningNicFullDuplex (Read/Write)............................................................................................................... 184
cfgNetTuningNicMtu (Read/Write)..........................................................................................................................184
cfgNetTuningNicAutoneg (Read/Write).................................................................................................................. 185
cfgRacSecurity...................................................................................................................................................................185
cfgRacSecCsrCommonName (Read/Write)........................................................................................................... 185
cfgRacSecCsrOrganizationName (Read/Write)..................................................................................................... 186
cfgRacSecCsrOrganizationUnit (Read/Write)........................................................................................................ 186
cfgRacSecCsrLocalityName (Read/Write)..............................................................................................................186
cfgRacSecCsrStateName (Read/Write)..................................................................................................................186
cfgRacSecCsrCountryCode (Read/Write).............................................................................................................. 186
cfgRacSecCsrEmailAddr (Read/Write).................................................................................................................... 187
cfgRacSecCsrKeySize (Read/Write)........................................................................................................................187
cfgQuickDeploy.................................................................................................................................................................. 187
cfgActionOnServerInsertion....................................................................................................................................... 187
cfgSetiDRACRootPasswordOnServerInsertion....................................................................................................... 188
cfgiDRACRootPassword.............................................................................................................................................188
cfgEnableiDRACLAN................................................................................................................................................... 188
cfgEnableiDRACIPv4................................................................................................................................................... 188
cfgEnableiDRACIPMIOverLAN...................................................................................................................................188
cfgEnableiDRACIPv4DHCP........................................................................................................................................ 189
cfgStartingiDRACIPv4Address...................................................................................................................................189
10
Contents
cfgiDRACIPv4GateWay...............................................................................................................................................189
cfgiDRACIPv4Netmask............................................................................................................................................... 189
cfgEnableiDRACIPv6...................................................................................................................................................190
cfgEnableiDRACIPv6AutoConfig............................................................................................................................... 190
cfgiDRACIPv6PrefixLength........................................................................................................................................190
cfgiDRACIPv6Gateway...............................................................................................................................................190
cfgReservedIPAddressNumbers................................................................................................................................190
cfgUseCMCDNSSettings............................................................................................................................................ 191
cfgServerDNSIMCNameEnable..................................................................................................................................191
cfgServerDNSIMCNamePrefix................................................................................................................................... 191
Contents 11
Introduction
This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups
and object definitions of CMC for PowerEdge VRTX.
Topics:
• What’s new in this release
• Supported RACADM Interfaces
• RACADM Syntax Usage
• Supported RACADM Subcommands
• Other documents you may need
• Accessing documents from the Dell EMC support site
What’s new in this release
• Added a new command, sslcertdownload, to download SSL certificates from CMC.
Supported RACADM Interfaces
The RACADM command-line utility provides a scriptable interface that allows you to remotely configure your Chassis Management
Controller (CMC). 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.
NOTE:
The RACADM command-line interface in CMC does not ignore single or double quotation. When you enter an
open quotation mark, ensure that you enter the close quotation mark too.
SSH or Telnet RACADM
racadm getconfig -g <groupname> [-o <objectname>]
[-i <indexnumber>]
racadm <subcommand>
Example
racadm getconfig -g idracinfo
racadm getsysinfo
1
12 Introduction
Remote RACADM
racadm -r <CMC IP> -u <username> -p <password> getconfig -g <groupname> [-o
<objectname>] [-i <indexnumber>]
racadm -r <CMC IP> -u <username> -p <password> <subcommand>
Example
racadm -r <CMC IP> -u myuser -p mypass getconfig -g idracinfo
racadm -r <CMC IP> -u myuser -p mypass getsysinfo
RACADM Command Options
The following table lists the options for the RACADM command.
Table 1. Racadm command options
Option Description
-r<racIpAddr>
-r racIpAddr : <port number>
Specifies the remote IP address of the controller.
Use:<port number> if the iDRAC port number is not the default
port (443).
-u <usrName> Specifies the username that is used to authenticate the command
transaction. If the -u option is used, the -p option must be used,
and the -i option (interactive) is not allowed.
NOTE: If you are using CIFS that is registered with a
domain, and are accessing the CIFS using the IP with
the CIFS local user credentials, it is mandatory to enter
the hostname or host IP with the -u option. The format
is - <hostname/username> or <host IP/username>
-p <password> Specifies the password that is used to authenticate the command
transaction. If the -p option is used, the -i option is not allowed.
NOTE: CMC does not support extended ASCII
characters, such as ß, å, é, ü, or other characters used
primarily in non-English languages. Setting values with
these characters causes unpredictable behavior.
-S Specifies that RACADM should check for invalid certificate errors.
RACADM stops the execution of the command with an error
message if it detects an invalid certificate.
-I <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.
Table 2. 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.
Introduction 13
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.
Table 3. Racadm subcommands
Subcommand CMC
Telnet/SSH/Serial Remote RACADM
"?" and "?<subcommand>" Yes Yes
chassisaction Yes Yes
chassislog No No
closessn Yes Yes
clrsel Yes Yes
cmcchangeover Yes Yes
config Yes Yes
connect Yes Yes
deploy Yes Yes
eventfilters Yes Yes
fanoffset Yes Yes
feature Yes Yes
featurecard Yes Yes
fwupdate Yes Yes
get Yes Yes
getactiveerrors No Yes
getassettag Yes Yes
getchassisname Yes Yes
getconfig Yes Yes
getdcinfo Yes Yes
getflexaddr Yes Yes
getioinfo Yes Yes
getled Yes Yes
getmacaddress Yes Yes
getmodinfo Yes Yes
getniccfg Yes Yes
getpbinfo Yes Yes
getpciecfg Yes Yes
getpminfo Yes Yes
getraclog Yes Yes
getractime Yes Yes
getredundancymode Yes Yes
14 Introduction
Table 3. Racadm subcommands (continued)
Subcommand CMC
getsel Yes Yes
getsensorinfo Yes Yes
getslotname Yes Yes
getssninfo Yes Yesz
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 Yes Yes
netstat Yes Yes
ping Yes Yes
ping6 Yes Yes
racdump Yes Yes
racreset Yes Yes
racresetpcie Yes Yes
racresetcfg Yes Yes
raid Yes Yes
remoteimage Yes Yes
serveraction Yes Yes
set Yes Yes
setassettag Yes Yes
setflexaddr Yes Yes
setled Yes Yes
setniccfg Yes Yes
setpciecfg Yes Yes
setractime Yes Yes
setslotname Yes Yes
setsysinfo Yes Yes
sshpkauth Yes Yes
sslcertview Yes Yes
sslcsrgen Yes Yes
sslresetcfg Yes Yes
testemail Yes Yes
Introduction 15
Table 3. Racadm subcommands (continued)
Subcommand CMC
testfeature Yes Yes
testtrap Yes Yes
traceroute Yes Yes
traceroute6 Yes Yes
Other documents you may need
To access the documents from the Dell Support site. Along with this Reference Guide, you can access the following guides available at
dell.com/support/manuals.
• The VRTX CMC Online Help provides information about using the Web interface. To access the Online Help, click Help on the CMC
web interface.
• The Chassis Management Controller for PowerEdge VRTX User's Guide provides information about using the VRTX–related Web
interface features.
• The Dell Chassis Management Controller (CMC) for Dell PowerEdge VRTX Version Release Notes provides last-minute updates to
the system or documentation or advanced technical reference material intended for experienced users or technicians.
• The Integrated Dell Remote Access Controller User’s Guide provides information about installation, configuration, and maintenance of
the iDRAC on managed systems.
• The Dell OpenManage Server Administrator’s User’s Guide provides information about installing and using Server Administrator.
• The Dell Update Packages User's Guide provides information about obtaining and using Dell Update Packages as part of your system
update strategy.
• The Dell Shared PowerEdge RAID Controller (PERC) 8 User's Guide provides information about deploying the Shared PERC 8 card
and managing the storage subsystem. This document is available online at dell.com/storagecontrollermanuals.
• Dell systems management application documentation provides information about installing and using the systems management
software.
The following system documents provide more information about the system in which VRTX CMC is installed:
• The safety instructions that came with your system provide important safety and regulatory information. For additional regulatory
information, see the Regulatory Compliance home page at www.dell.com/regulatory_compliance. Warranty information may be
included within this document or as a separate document.
• The Dell PowerEdge VRTX Getting Started Guide shipped with your system provides an overview of system features, setting up your
system, and technical specifications.
• The setup placemat shipped with your system provides information about the initial system setup and configuration.
• The server module's Owner's Manual provides information about the server module's features and describes how to troubleshoot the
server module and install or replace the server module's components. This document is available online at dell.com/
poweredgemanuals.
• The rack documentation included with your rack solution describes how to install your system into a rack, if required.
• For the full name of an abbreviation or acronym used in this document, see the Glossary at dell.com/support/manuals.
• Systems management software documentation describes the features, requirements, installation, and basic operation of the software.
• Documentation for any components you purchased separately provides information to configure and install these options.
• Any media that ships with your system that provides documentation and tools for configuring and managing your system, including
those pertaining to the operating system, system management software, system updates, and system components that you
purchased with your system. For more information on the system, scan the Quick Resource Locator (QRL) available on your system
and the system setup placemat that shipped with your system. Download the QRL application from your mobile platform to enable the
application on your mobile device.
Updates are sometimes included with the system to describe changes to the system, software, and/or documentation. Always read the
updates first, because they often supersede information in other documents.
Accessing documents from the Dell EMC support
site
You can access the required documents in one of the following ways:
• Using the following links:
16
Introduction
â—‹ For Dell EMC Enterprise Systems Management, Dell EMC Remote Enterprise Systems Management, and Dell EMC Virtualization
Solutions documents — https://www.dell.com/esmmanuals
○ For Dell EMC OpenManage documents — https://www.dell.com/openmanagemanuals
○ For iDRAC documents — https://www.dell.com/idracmanuals
○ For Dell EMC OpenManage Connections Enterprise Systems Management documents — https://www.dell.com/
OMConnectionsEnterpriseSystemsManagement
○ For Dell EMC Serviceability Tools documents — https://www.dell.com/serviceabilitytools
• From the Dell EMC Support site:
1. Go to https://www.dell.com/support.
2. Click Browse all products.
3. From All products page, click Software, and then click the required link from the following:
â—‹ Analytics
â—‹ Client Systems Management
â—‹ Enterprise Applications
â—‹ Enterprise Systems Management
â—‹ Mainframe
â—‹ Operating Systems
â—‹ Public Sector Solutions
â—‹ Serviceability Tools
â—‹ Support
â—‹ Utilities
â—‹ Virtualization Solutions
4. To view a document, click the required product and then click the required version.
• Using search engines:
â—‹ Type the name and version of the document in the search box.
Introduction
17
RACADM Subcommand Details
This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
Topics:
• Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands
• Racadm help and help with subcommand
• help and help subcommand
• chassislog
• chassislog export
• chassislog clear
• chassisaction
• closessn
• clrsel
• cmcchangeover
• config
• connect
• deploy
• Displayable Characters
• eventfilters
• fanoffset
• fcp
• feature
• featurecard
• fwupdate
• get
• getactiveerrors
• getassettag
• getchassisname
• getconfig
• getdcinfo
• getflexaddr
• getioinfo
• getled
• getmacaddress
• getmodinfo
• getniccfg
• getpbinfo
• getpciecfg
• getpminfo
• getraclog
• getractime
• getredundancymode
• getsel
• getsensorinfo
• getslotname
• getssninfo
• getsvctag
• getsysinfo
• gettracelog
• getversion
2
18 RACADM Subcommand Details
• ifconfig
• jobqueue
• krbkeytabupload
• license
• netstat
• ping
• ping6
• racdump
• racreset
• racresetcfg
• racresetpcie
• raid
• remoteimage
• serveraction
• set
• setassettag
• setchassisname
• set controllers
• setflexaddr
• setled
• set enclosure
• setniccfg
• setpciecfg
• setractime
• setslotname
• setsysinfo
• SSH or Telnet RACADM
• sshpkauth
• sslcertdownload
• sslcertupload
• sslcertview
• sslcsrgen
• sslresetcfg
• sslsshresetcfg
• set tempprobes
• testcifsshare
• testemail
• testfeature
• testtrap
• traceroute
• traceroute6
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)
RACADM Subcommand Details
19
• ( (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).
Racadm help and help with subcommand
Table 4. Racadm help commands
Description
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.
Synopsis
racadm ?
racadm ? <subcommand>
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
20
RACADM Subcommand Details
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191

Dell PowerEdge VRTX Owner's manual

Type
Owner's manual

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI