Quick Reference Guide

ManualsBrandsDell ManualsSoftwareDell Chassis Management Controller Version 3.2

RACADM Command Line

Reference Guide for

iDRAC6 1.7, iDRAC6 3.2, and

CMC 3.2

Summary of content (296 pages)

PAGE 1
RACADM Command Line Reference Guide for iDRAC6 1.7, iDRAC6 3.2, and CMC 3.
PAGE 2
Notes and Cautions NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates potential damage to hardware or loss of data if instructions are not followed. _____________________ Information in this publication is subject to change without notice. © 2011 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
PAGE 3
Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . What’s New in This Release. . . . . . . . . . . . . . . 25 . . . . . . . . . . . . . . . . . . 25 . . . . . . . . . . . . . . . . . . . . . . . 25 Sub-Commands . Groups . . . . . . . . . . . . . 25 . . . . . . . . . . . . . . . . . 26 . . . . . . . . . . . . . . . . . . 26 Supported RACADM Interfaces RACADM Syntax Usage Local RACADM . SSH/Telnet RACADM . Remote RACADM . . . . . . . . . . . . . . . . 27 . . . . . . . .
PAGE 4
clearasrscreen . . . . . . . . . . . . . . . . . . . . . . 43 closessn . . . . . . . . . . . . . . . . . . . . . . . . . 43 clrraclog . . . . . . . . . . . . . . . . . . . . . . . . . 45 . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 clrsel . . . . . . . . . . . . . . . . . . . . . 46 . . . . . . . . . . . . . . . . . . . . . . . . . . 46 cmcchangeover config . connect . . . . . . . . . . . . . . . . . . . . . . . . . . coredump . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 5
getled. . . . . . . . . . . . . . . . . . . . . . . . . . . 77 . . . . . . . . . . . . . . . . . . . . . 78 . . . . . . . . . . . . . . . . . . . . . . . 83 getniccfg . . . . . . . . . . . . . . . . . . . . . . . . . 85 getpbinfo . . . . . . . . . . . . . . . . . . . . . . . . . 87 getpminfo . . . . . . . . . . . . . . . . . . . . . . . . 89 getraclog . . . . . . . . . . . . . . . . . . . . . . . . . 90 getractime . . . . . . . . . . . . . . . . . . . . . . . . 91 getmacaddress.
PAGE 6
localConRedirDisable . . . . . . . . . . . . . . . . . 110 . . . . . . . . . . . . . . . . . . . . . . . . . 111 ping . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 ping6 . . . . . . . . . . . . . . . . . . . . . . . . . . 112 netstat racdump . . . . . . . . . . . . . . . . . . . . . . . . 113 racreset . . . . . . . . . . . . . . . . . . . . . . . . . 116 racresetcfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 serveraction . .
PAGE 7
sslcsrgen . . . . . . . . . . . . . . . . . . . . . . . 137 . . . . . . . . . . . . . . . . . . . . . . . 138 . . . . . . . . . . . . . . . . . . . . . . . . 139 sslkeyupload . sslresetcfg . testemail . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . 141 . . . . . . . . . . . . . . . . . . . . . . . . . 144 testkmsconnectivity . testfeature testtrap . traceroute 145 . . . . . . . . . . . . . . . . . . . . . . . usercertupload . . . . . . . . . . . .
PAGE 8
idRacVersionInfo (Read Only). idRacBuildInfo (Read Only) . 159 . . . . . . . . . . . 159 . . . . . . . . . . . . . 159 . . . . . . . . . . . . . . 159 . . . . . . . . . . . . . . . . . . 160 idRacName (Read Only) idRacType (Read Only) cfgLanNetworking . . . . . . . . . . . . . . . . . . . . 160 . . . . . . . . . . 161 cfgNicIPv4Enable (Read/Write). cfgNicSelection (Read/Write) . . . . . . . . . 162 . . . . . . . . . . . 163 cfgNicVLanEnable (Read/Write) cfgNicVLanId (Read/Write) .
PAGE 9
cfgRhostsNtpServer2 . . . . . . . . . . . . . . . . 171 cfgRhostsNtpServer3 . . . . . . . . . . . . . . . . 171 cfgRhostsNtpMaxDist . . . . . . . . . . . . . . . 172 cfgRhostsSyslogEnable (Read/Write) cfgRhostsSyslogPort (Read/Write) . . . . . . . . 172 . . . . . . . . 172 cfgRhostsSyslogServer1 (Read/Write) . . . . . . . 173 cfgRhostsSyslogServer2 (Read/Write) . . . . . . . 173 cfgRhostsSyslogServer3 (Read/Write) . . . . . . . 173 cfgRhostsSyslogPowerLoggingEnabled . . . . . .
PAGE 10
cfgSsnMgtWebserverTimeout (Read/Write) . . . . . . . . . . . . . . . . . . . cfgSsnMgtSshIdleTimeout (Read/Write) . . . . . 184 . . . . . . . . . . 185 . . . . . . . . . . . . . . . . . . . . . . . . 185 cfgSsnMgtTelnetIdleTimeout (Read/Write) . . . . . . . . . cfgSerial cfgSerialBaudRate (Read/Write) . . . . . . . . . cfgSerialConsoleEnable (Read/Write) . . . . . . cfgSerialConsoleQuitKey (Read/Write) . . . . . . cfgSerialConsoleIdleTimeout (Read/Write).
PAGE 11
cfgRacTuneHttpsPort (Read/Write) . . . . . . . . cfgRacTuneIpRangeEnable (Read/Write) 195 . . . . . 195 cfgRacTuneIpRangeAddr (Read/Write) . . . . . . 195 cfgRacTuneIpRangeMask (Read/Write) . . . . . . 196 . . . . . . . 196 cfgRacTuneIpBlkEnable (Read/Write) cfgRacTuneIpBlkFailCount (Read/Write) . . . . . . cfgRacTuneIpBlkFailWindow (Read/Write) cfgRacTuneIpBlkPenaltyTime (Read/Write) . . . . . . . . . 196 . . . . 197 . . . . . . . . . . . 197 cfgRacTuneSshPort (Read/Write) . . . . .
PAGE 12
cfgVirMediaKeyEnable (Read/Write) . . . . . . . 204 cfgSDWriteProtect (Read only) . . . . . . . . . . 205 cfgLCDriveEnable (Read/Write). . . . . . . . . . 205 . . . . . . . . . . . . . . . . . . . . . 206 cfgServerInfo . cfgServerInfoIndex (Read only) . . . . . . . . . . . . . . . . . 206 cfgServerServiceTag (Read only) . . . . . . . . . 207 . . . . . . . . . . 207 . . . . . . . . . . . . 207 cfgServerName (Read/Write) . cfgServerFW (Read only) . cfgServerBIOS (Read only) . . . . . .
PAGE 13
cfgADSCLEnable . . . . . . . . . . . . . . . . . . cfgADSSOEnable (Read/Write) . cfgADDomainController 215 . . . . . . . . . . 215 . . . . . . . . . . . . . . 215 cfgADDomainController1 (Read/Write). . . . . . . 215 cfgADDomainController2 (Read/Write). . . . . . . 216 cfgADDomainController3 (Read/Write). . . . . . . 216 . . . . . . . . . 216 . . . . . . . . . . . . . . 216 cfgADAuthTimeout (Read/Write) . cfgADType (Read/Write) cfgADSpecifyServerEnable cfgADGlobalCatalog . . . . . . .
PAGE 14
cfgLDAPCertValidationEnable (Read/Write) . . . . . . . . . . . . . . . . . . . 224 . . . . . . . . . . . . 224 . . . . . . . . . . . . . 224 cfgLDAPNetworkTimeout . cfgLDAPSearchTimeout cfgLDAPSRVLookupEnable . . . . . . . . . . . . . . . . . . . . 225 cfgLDAPSRVLookupServiceName . . . . . . . . 225 . . . . . . . . . . . . . . . . . . . 225 cfgLdapRoleGroup . . . . . . 226 . . . . . . . 226 . . . . . . . . . . . 227 . . . . . . . . . . . . . . . . . .
PAGE 15
cfgChassisPowerCapPercent (Read/Write) . . . . . . . . . . . . . . . . . . . . cfgChassisPowerCapFPercent (Read/Write) . . . . . . . . . . cfgChassisRedundancyPolicy (Read/Write) . . . . . . . . . 232 . . . . . . . . . . 232 . . . . . . . . . . . 232 cfgChassisDynamicPSUEngagementEnable (Read/Write) . . . . . . . . . . . . . . . . . cfgChassisAllow110VACOperation (Read/Write) . . . . . . . . . . . . . . . 232 . . . . . . . . 233 cfgChassisMaxPowerConservationMode (Read/Write) . . . . . . . . .
PAGE 16
cfgIpmiSolMinPrivilege (Read/Write) . . . . . . 236 . . . . . . . . . 237 . . . . . . . . . . . . 237 . . . . . . . . . . . . . . . . . . . . . . . 237 cfgIpmiSolAccumulateInterval (Read/Write) . . . . . . . . . . cfgIpmiSolSendThreshold (Read/Write) . . . . . . . cfgIpmiLan cfgIpmiLanEnable (Read/Write) . . . . . . . . . cfgIpmiLanPrivLimit (Read/Write) . . . . . . . . cfgIpmiLanAlertEnable (Read/Write) . 238 . . . . . . . 238 . . . . . . . . . . . 238 . . . . . . . . . . . . . . . . .
PAGE 17
cfgServerPowerStatus (Read Only) . . . . . . . . cfgServerPowerAllocation (Read Only) cfgServerActualPowerConsumption (Read Only) . . . . . . . . . . . . . . 242 . . . . . . 243 . . . . . . . 243 cfgServerPowerCapEnable (Read Only) . . . . . . 243 cfgServerMinPowerCapacity (Read Only) . . . . . . . . . . . . . . . . . . . . . 244 cfgServerMaxPowerCapacity (Read Only) . . . . . . . . . . . . . . . . . . . . . 244 cfgServerPeakPowerConsumption (Read Only) . . . . . . . . . . . . . . . . . .
PAGE 18
cfgServerPowerLastDayMinPower (Read Only) . . . . . . . . . . . . . cfgServerPowerLastDayMinTime (Read Only) . . . . . . . . . . . . . . . . . . . 248 . . . . . . . . 249 cfgServerPowerLastDayMaxPower (Read Only) . . . . . . . . . . . . . cfgServerPowerLastDayMaxTime (Read Only) . . . . . . . . . . . . . . . . . . . 249 . . . . . . . . 250 cfgServerPowerLastWeekMinPower (Read Only) . . . . . . . . . . . . . . cfgServerPowerLastWeekMinTime (Read Only) . . . . . . . . . . . . . . . . . . . 250 .
PAGE 19
cfgKVMAccessToCMCEnable . . . . . . . . . . . 256 . . . . . . . . . . . . . 257 . . . . . . . . . . . . . . . . . . . . . . . 257 cfgKVMFrontPanelEnable cfgAlerting . cfgAlertingEnable. . . . . . . . . . . . . . . . . . cfgAlertingFilterMask . . . . . . . . . . . . . . . cfgAlertingSourceEmailName cfgServerPowerSupply 257 257 . . . . . . . . . . . 258 . . . . . . . . . . . . . . . . . 258 cfgServerPowerSupplyIndex . . . . . . . . . . . .
PAGE 20
cfgIPv6Address7 (Read Only) . . . . . . . . . . . 264 cfgIPv6Address8 (Read Only) . . . . . . . . . . . 264 cfgIPv6Address9 (Read Only) . . . . . . . . . . . 264 cfgIPv6Address10 (Read Only) . . . . . . . . . . 264 cfgIPv6Address11 (Read Only) . . . . . . . . . . 265 cfgIPv6Address12 (Read Only) . . . . . . . . . . 265 cfgIPv6Address13 (Read Only) . . . . . . . . . . 265 cfgIPv6Address14 (Read Only) . . . . . . . . . . 265 cfgIPv6Address15 (Read Only) . . . . . . . . . .
PAGE 21
cfgIPv6URLstring (Read Only) cfgIpmiSerial. . . . . . . . . . . . 271 . . . . . . . . . . . . . . . . . . . . . . 271 . . . . . . . 271 . . . . . . . . . . 272 . . . . . . . . . . . . 272 . . . . . . . . . . . . . 272 cfgIpmiSerialBaudRate (Read/Write) cfgIpmiSerialConnectionMode (Read/Write) . . . . . . . . . . cfgIpmiSerialChanPrivLimit (Read/Write) . . . . . . . . cfgIpmiSerialFlowControl (Read/Write) . . . . . . . cfgIpmiSerialHandshakeControl (Read/Write) . . . . . . . . . . . . . . . .
PAGE 22
cfgSensorRedundancyCapabilities (Read Only) . . . . . . . . . . . . . . . . . . . . 278 . . . . . . . . . . 279 . . . . . . . . . . . . . . . . . . . . . . 279 cfgSensorRedundancyStatus (Read Only) . . . . . . . . . . cfgVFlashSD . . . . . . . . 279 . . . . . . . . . . 279 cfgVFlashSDEnable (Read/Write). cfgVFlashSDSize (Read Only) . cfgVFlashSDLicensed (Read Only) . . . . . . . . cfgVFlashSDAvailableSize (Read Only) . cfgVFlashSDHealth (Read Only) 280 . . . . . . . . .
PAGE 23
cfgKMSProfileDeviceGroup(Read/Write) cfgRacSecurity. . . . . . 285 . . . . . . . . . . . . . . . . . . . . . 285 cfgRacSecCsrCommonName (Read/Write) . . . . . . . . . . . . . . . . . . . . cfgRacSecCsrOrganizationName (Read/Write) . . . . . . . . . . . . . . . . . . . . 286 . . . . . . . . . . 286 . . . . . . . . . . . . 286 cfgRacSecCsrOrganizationUnit (Read/Write) . . . . . . . . . . cfgRacSecCsrLocalityName (Read/Write) . . . . . . . .
PAGE 24
4 Deprecated Commands, Groups, and Objects . . . . . . . . . . . . . . . . . Index 24 . . . . . 293 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 25
1 Introduction This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions for the following: • iDRAC6 Enterprise on Blade Servers • iDRAC6 Enterprise or Express on Rack and Tower Servers • Dell Chassis Management Controller (CMC) What’s New in This Release Sub-Commands • sslresetcfg • setled • getuscversion Groups • cfgLogging • cfgRacTunePluginType under cfgRacTuning (for Monolithic) Supported RACADM In
PAGE 26
The RACADM utility supports the following interfaces: • Local — Supports executing RACADM commands from the managed server’s operating system. You must install the OpenManage software on the managed server to run local racadm commands. Only one instance of local RACADM can be executed on a system at a time. If the user tries to open another instance, an error message is displayed and the second instance of local RACADM closes immediately. • SSH or Telnet — Also referred as Firmware racadm.
PAGE 27
SSH/Telnet RACADM racadm getconfig -g [-o ] [-i ] racadm Example racadm getconfig -g idracinfo racadm getsysinfo Remote RACADM racadm -r -u -p getconfig -g [-o ] [-i ] racadm -r -u -p Example racadm -r -u -p getconfig -g idracinfo racadm -r -u -p getsysinfo RACADM Command Options Table 1-1 lists the options for the RACADM command. Table 1-1.
PAGE 28
Table 1-1. RACADM Command Options (continued) Option Description -S Specifies that RACADM should check for invalid certificate errors. RACADM stops the execution of the command with an error message if it detects an invalid certificate. -i Specifies the index number for the indexed group, if applicable. -g Specifies the group name if applicable. -o Specifies the object name if applicable.
PAGE 29
Supported RACADM Subcommands Table 1-3 provides the list of RACADM subcommands and their corresponding interface support. For detailed information of the RACADM subcommands including syntax and valid entries, see "RACADM Subcommand Details" on page 37. Table 1-3.
PAGE 30
Table 1-3.
PAGE 31
Table 1-3.
PAGE 32
Table 1-3.
PAGE 33
Table 1-3.
PAGE 34
• The CMC online Help provides information about using the CMC Web interface. • The Chassis Management Controller (CMC) Secure Digital (SD) Card Technical Specification provides minimum BIOS and firmware version, installation and usage information. • The Dell OpenManage IT Assistant User’s Guide provides information about IT Assistant. • Documentation specific to your third-party management console application.
PAGE 35
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. See the Safety and Regulatory information that is shipped with your system. NOTE: Warranty information may be included within this document or as a separate document.
PAGE 36
Introduction
PAGE 37
RACADM Subcommand Details 2 This section provides detailed descriptions of the RACADM subcommands including the syntax and valid entries.
PAGE 38
There are different escaping rules for single quoting versus double quoting. For double quoting: The following characters must be escaped by prepending a backslash: • $ (dollar sign) • " (double quote) • ' (single quote) • ` (back quote) • \ (backslash) For example, use the following for a string that contains the special characters, $, ",',`and \ For single quoting: • No character escaping is necessary. • A single quote cannot be used even with a backslash escaped.
PAGE 39
Example for racadm ? NOTE: 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.
PAGE 40
Example for racadm ? 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 " NOTE: To use this subcommand, you must have Login to iDRAC permission.
PAGE 41
arp NOTE: To use this subcommand, you must have Administrator and Execute Diagnostic Commands permission. Subcommand Description arp Displays the contents of the Address Resolution Protocol (ARP) table. ARP table entries cannot be added or deleted. Synopsis racadm arp chassisaction IP Address HW Type Flags HW Address Mask Device 192.168.1.1 0x1 0x2 00:00:0C:07:AC:0F * eth0 NOTE: To use this subcommand, you must have Chassis Control Administrator privilege.
PAGE 42
Table 2-1. chassisaction Subcommand Options Option Description -m 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–6 • kvm Action that you want to execute on the specified module. Values are: • powerdown — (Chassis only) Powers down the chassis. • powerup — (Chassis only) Powers up the chassis. • powercycle — Power cycles the module.
PAGE 43
clearasrscreen NOTE: To use this subcommand, you must have Clear Logs permission. Subcommand Description clearasrscreen Clears the last crash (ASR) screen that is in memory. See Configuring the Managed Server to Capture the Last Crash Screen and Disabling the Windows Automatic Reboot Option sections in the iDRAC6 Enterprise for Blade Servers User Guide. Synopsis racadm clearasrscreen closessn NOTE: To use this subcommand, you must have Administrator permission.
PAGE 44
Table 2-2 describes the closessn subcommand options. Table 2-2. closessn Subcommand Options and Descriptions Option Description -i The session ID of the session to close, which can be retrieved using racadm getssninfo subcommand. NOTE: Session executing this command cannot be closed. -a Closes all sessions. -u Close all sessions for a particular user name. NOTE: -u option can be used in local RACADM only if the username contains upto 16 characters.
PAGE 45
clrraclog NOTE: To use this subcommand, you must have Clear Logs permission. . Subcommand Description clrraclog Removes all existing records from iDRAC6 log. A new single record is created to record the date and time when the log was cleared. Synopsis racadm clrraclog clrsel NOTE: To use this subcommand, you must have Clear Logs permission. Subcommand Description clrsel Removes all existing records from the System Event Log (SEL).
PAGE 46
cmcchangeover NOTE: To use this subcommand, you must have Administrator privilege. Subcommand Description cmcchangeover Changes the state of the CMC from active to standby, or vice versa, in a redundant CMC configuration. This subcommand is useful for remote debugging or testing purposes. NOTE: This command is valid only in redundant CMC environments. For more information, see the "Understanding the Redundant CMC Environment" section of the Dell Chassis Management Controller User Guide.
PAGE 47
Synopsis racadm config [-c|-p] -f racadm config -g -o [-i ] NOTE: The configuration file retrieved using remote racadm and local racadm are not interoperable. The configuration file retrieved using remote racadm shows the index property for some of the indexed groups as read-write, for example cfgSSADRoleGroupIndex. For the config -f command, use the configuration file retrieved from the same interface.
PAGE 48
Table 2-3. config Subcommand Options and Descriptions (continued) Option Description -i The -i , or index option, is valid only for indexed groups and can be used to specify a unique group. The is a decimal integer from 1 through n, where n can vary from 1 to maximum number of indexes a particular group supports. If -i is not specified, a value of 1 is assumed for groups, which are tables that have multiple entries. The index is specified by the index value, not a named value.
PAGE 49
connect Subcommand Description connect Connects to the switch or server serial console. NOTE: You cannot use this subcommand with remote RACADM. Synopsis • racadm connect [-b] • racadm connect [-b] Table 2-4 describes the connect subcommand options. Table 2-4. connect Subcommand Options Option Description -b Connects to the switch or console using the binary mode. This is an optional argument; a server or a switch must be present.
PAGE 50
coredump NOTE: This option is applicable only for iDRAC6. NOTE: To use this subcommand, you must have Execute Debug Commands permission. Subcommand Description coredump Displays detailed information related to any recent critical issues that have occurred with the RAC. The coredump information can be used to diagnose these critical issues.
PAGE 51
coredumpdelete NOTE: This option is applicable only for iDRAC6. NOTE: To use this subcommand, you must have Clear Logs or Execute Debug Commands permission. Subcommand Description coredump Clears any currently resident coredump data stored in the RAC. NOTE: If a coredumpdelete command is issued and a coredump is not currently stored in the RAC, the command displays a success message. This behavior is expected. See the coredump subcommand for more information on viewing a coredump.
PAGE 52
Synopsis • racadm deploy -m -u root -p -s -b -o • racadm deploy -m -u root -p -s -6 -b -o NOTE: must be a number between 0 and 128. • racadm deploy -m -u root -p -d [6] • racadm deploy -a -u root -p Table 2-5 describes the deploy subcommand options. Table 2-5.
PAGE 53
Table 2-5. deploy Subcommand Options (continued) Option Description -s 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. Enables DHCP for the specified server.
PAGE 54
feature NOTE: To use this subcommand to deactivate FlexAddress, you must have Chassis Configuration Administrator privilege. A user with login privileges can view status only. Subcommand Description feature 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.
PAGE 55
Table 2-6. feature Subcommand Options (continued) Option Description -r Reformats damaged/unformatted ExtendedStorage media. CAUTION: Using the -r switch deactivates the ExtendedStorage feature, if active; reformats the SD media in the active CMC cardslot; and may reboot the active CMC.
PAGE 56
featurecard NOTE: To use this subcommand, you must have Chassis Configuration Administrator privilege. Subcommand Description featurecard Verifies proper SD card installation and displays the SD card status. Table 2-7 lists the status messages returned by the command. Table 2-7. Status Messages Returned by featurecard -s Command Status Message Actions No feature card inserted. Check the CMC to verify that the SD card was properly inserted.
PAGE 57
Synopsis racadm featurecard -s Table 2-8 describes the featurecard subcommand option. Table 2-8. featurecard Subcommand Options Option Description -s Lists active SD card features and SD card status.
PAGE 58
fwupdate NOTE: To use this subcommand for CMC you must have Chassis Configuration Administrator privilege and for iDRAC you must have Configure iDRAC6 permission. Subcommand Description fwupdate Allows you to update the firmware on the iKVM, active CMC, standby CMC, server iDRACs, or an IOM infrastructure device. You can: • Check the firmware update process status. • Update iDRAC6 or CMC firmware from a TFTP server by providing an IP address and optional path.
PAGE 59
Table 2-10 describes the firmware update method supported for each interface. Table 2-10.
PAGE 60
For remote RACADM: racadm fwupdate -p -u -d NOTE: 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.
PAGE 61
Table 2-11. fwupdate Subcommand Options (continued) Option Description -g The get option instructs the firmware to get the firmware update file from the TFTP server. You must also specify the -a, -u, and -d options. In the absence of the -a option, the defaults are read from properties contained in the group cfgRemoteHosts, using properties cfgRhostsFwUpdateIpAddr and cfgRhostsFwUpdatePath. For CMC: Downloads the firmware update using the TFTP server.
PAGE 62
Table 2-11. fwupdate Subcommand Options (continued) Option Description -m NOTE: This option is applicable only for CMC. is one of the e> following values: • cmc-active (default) • cmc-standby • kvm • server-n where n = 1–16 • server-generation where generation = iDRAC or iDRAC6 • iominf-n where n = 1–6 NOTE: CMC version 3.00 accepts IPv4, IPv6, or fully qualified domain names (FQDN) for both FTP and TFTP servers.
PAGE 63
• Upload the firmware image from the FTP server and start the firmware update. racadm fwupdate -f 192.168.0.100 fred password123 -d firmimg.cmc -m cmc-active • Start IOM infrastructure firmware update. racadm fwupdate -u -m iominf-1 • Update firmware on both the CMCs. racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.cmc -m cmc-active -m cmc-standby • Update firmware on multiple servers. racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.
PAGE 64
• Query the current status of the firmware update process for a particular module. racadm fwupdate -s -m • Cancel a firmware update in progress. racadm fwupdate -c • Upload a firmware image from the client and start the firmware update. racadm fwupdate -p -u -d firmimg.cmc NOTE: The fwupdate command generates an error when used on the extension slot of a multi-slot server. NOTE: Image path length for Remote RACADM is 256 characters and for local RACADM, it is 64 characters.
PAGE 65
getassettag NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getassettag Displays the asset tag for the chassis. Synopsis racadm getassettag [-m ] Table 2-12 describes the getassettag subcommand options. Table 2-12. getassettag Subcommand Options Option Description -m Specifies the module whose asset tag you want to view.
PAGE 66
Example • racadm getchassisname PowerEdge 2955 getconfig Subcommand Description getconfig Retrieves iDRAC6 configuration parameters individually, or all iDRAC6 configuration groups may be retrieved and saved to a file. Synopsis racadm getconfig -f racadm getconfig -g [-i ] racadm getconfig -u racadm getconfig -h racadm getconfig -g -o [-i index] Input Table 2-13 describes the getconfig subcommand options. Table 2-13.
PAGE 67
Table 2-13. getconfig Subcommand Options Option Description -i The -i , or index option, is valid only for indexed groups and can be used to specify a unique group. The is a decimal integer from 1 through n, where n can vary from 1 to maximum number of indexes a particular group supports. If -i is not specified, a value of 1 is assumed for groups, which are tables that have multiple entries. The index is specified by the index value, not a named value.
PAGE 68
• racadm getconfig -h Displays a list of the available configuration groups on iDRAC6 in an alphabetical order. • racadm getconfig -u root Displays the configuration properties for the user named root. • racadm getconfig -g cfgUserAdmin -i 2 -v Displays the user group instance at index 2 with verbose information for the property values. getdcinfo NOTE: To use this subcommand, you must have CMC Login User privilege.
PAGE 69
Example The example output below is for a system with multi-slot servers.
PAGE 70
getdcinfo -n server-1 Present None None server-2 Not Present None None server-3 Not Present None None server-4 Present None Broadcom M5708t server-5 Not Present None None server-6 Not Present None None server-7 Not Present None None server-8 Present LPe1105-M4 None server-9 Extension(1) None None server-10 Not Present None None server-11 Not Present None None server-12 Not Present None None server-13
PAGE 71
Table 2-15 describes the getflexaddr subcommand options. Table 2-15. Option getflexaddr Subcommand Options Description -i Specifies the slot information to be displayed. can be from 1 to 16.
PAGE 72
A Gigabit Ethernet Enabled B None Enabled C None Enabled idrac Management Controller Disabled • Display the current flex address setting for slot 1.
PAGE 73
getfanreqinfo NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getfanreqinfo Displays fan request for Servers and Switches in percent (%).
PAGE 74
12 SLOT-12 N/A N/A Not Present N/A 13 SLOT-13 N/A N/A Not Present N/A 14 SLOT-14 PowerEdgeM600 ON Present 15 SLOT-15 N/A N/A Not Present N/A 16 SLOT-16 N/A Extension N/A (8) N/A 33 [Switch Module Fan Request Table] 1 SLOT-01 PowerEdgeM600 ON Present 33 2 SLOT-02 PowerEdgeM905 ON Present 35 3 SLOT-03 PowerEdgeM710 ON Present 44 4 SLOT-04 PowerEdgeM610 ON Present 46 5 SLOT-05 Po
PAGE 75
[Switch Module Fan Request Table] Switch-1 Dell Ethernet PassThrough Gigabit Ethernet Present 30 Switch-2 Dell PowerConnect M6220 Gigabit Ethernet Present 30 Switch-3 N/A None Not Present N/A Switch-4 N/A None Not Present N/A Switch-5 N/A None Not Present N/A Switch-6 N/A None Not Present N/A getioinfo NOTE: To use this subcommand, you must have CMC Login User privilege.
PAGE 76
Example racadm getioinfo switch-1 Dell Ethernet Gigabit Passthrough Ethernet Present OK ON Master switch-2 N/A None Not Present N/A N/A N/A switch-3 Brocade 4424 Fibre Channel 4 Present ON Master switch-4 N/A None Not Present N/A N/A N/A switch-5 N/A None Not Present N/A N/A N/A switch-6 N/A None Not Present N/A N/A N/A OK getkvminfo NOTE: To use this subcommand, you must have CMC Login User privilege.
PAGE 77
getled NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getled Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots). Synopsis racadm getled -m Table 2-16 describes the getled subcommand options. Table 2-16. getled Subcommand Options Option Description -m Specifies the module whose LED settings you want to view.
PAGE 78
racadm getled -m server-9 server-9 Extension(1) getmacaddress NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getmacaddress Displays the MAC/WWN addresses for all modules or for a specified module. Synopsis racadm getmacaddress [-m ] [-t iscsi] [-x] racadm getmacaddress [-a] Table 2-17 describes the getmacaddress subcommand options. Table 2-17.
PAGE 79
Example • Display iSCSI MAC addresses for all servers. racadm getmacaddress -t iscsi • Display iSCSI MAC for server-1. racadm getmacaddress -m server-1 -t iscsi • Display extra iSCSI MACs for server-1 (if available). racadm getmacaddress -m server-1 -t iscsi -x • Display MAC for server-1.
PAGE 80
Server-3 Not Present N/A Server-4 Present 00:18:8B:FF:45:2A 00:18:8B:FF:AA 00:18:8B:FF:AA:04 :02 N/A N/A Server-5 Present 00:19:B9:FF:FE:E2 00:19:B9:FF:FC 00:19:B9:FF:FC:0E :0C Server-6 Present 00:22:19:D2:1D:D4 N/A Server-7 Present 00:1E:4F:FF:FC:DC 00:1E:4F:FF:F0 00:1E:4F:FF:F0:B2 :B0 Server-8 Not Present N/A N/A N/A N/A Server-9 Not Present N/A N/A N/A Server-10 Not Present N/A N/A N/A Server-11 Not Present N/A N/A N/A Server-12 Not Present N/A N/A N/A Server-13
PAGE 81
Server-1- Gigabit A Ethernet Present 00:1E:4F:2A: 00:1E:4F:2A:D AF:7B 3:97 00:1E:4F:2A :D3:99 Present 00:1E:4F:2A:D 3:98 00:1E:4F:2A :D3:9A Present Not Installed Not Installed Present Not Installed Not Installed Server-1- Fibre C Channel 4 Present Not Installed Not Installed Server-2- Gigabit A Ethernet Present 00:22:19:D2: N/A 1E:84 N/A Present N/A N/A Present Not Installed Not Installed Present Not Installed Not Installed Server-2- Fibre C Channel 4 Present Not Installed N
PAGE 82
Server-6- Gigabit A Ethernet Present 00:22:19:D2: N/A 1D:D4 N/A Present N/A N/A Present Not Installed Not Installed Present Not Installed Not Installed Server-6- Fibre C Channel 4 Present Not Installed Not Installed Server-7- Gigabit A Ethernet Present 00:1E:4F:FF: 00:1E:4F:FF:F FC:DC 0:B0 00:1E:4F:FF :F0:B2 Present 00:1E:4F:FF:F 0:B1 00:1E:4F:FF :F0:B3 Server-7- Gigabit B Ethernet Present 00:1D:09:72:0 1:C8 00:1D:09:72 :01:CA Server-7- Fibre C Channel 4 Present 21:00:00:1B:3 2
PAGE 83
Server14-C Fibre Channel 4 Present Not Installed Not Installed Server15-A Gigabit Ethernet Extension(7) N/A 00:1E:4F:FF:F 0:B4 00:1E:4F:FF :F0:B6 iSCSI Extension(7) N/A 00:1E:4F:FF:F 0:B5 00:1E:4F:FF :F0:B7 Gigabit Ethernet Extension(7) N/A 00:1D:09:71:E 1:20 00:1D:09:71 :E1:22 iSCSI Extension(7) N/A 00:1D:09:71:E 1:21 00:1D:09:71 :E1:23 Fibre Channel 4 Extension(7) N/A 21:00:00:1B:3 2:17:3A:66 21:00:00:1B :32:37:3A:6 6 Server-16 N/A Not Present N/A N/A N/A Switch-1 None Pre
PAGE 84
Table 2-18 describes the getmodinfo subcommand options. Table 2-18. getmodinfo Subcommand Options Option Description -m Specifies the module whose configuration and status information you want to view. The default command (no options) displays information about all major components in the chassis.
PAGE 85
PS-2 PS-3 PS-4 PS-5 PS-6 CMC-1 CMC-2 Switch-1 Switch-2 Switch-3 Switch-4 Switch-5 Switch-6 Server-1 Server-2 Server-3 Server-4 Server-5 Server-6 Server-7 Server-8 Server-9 Server-10 Server-11 Server-12 Server-13 Server-14 Server-15 Server-16 KVM IO-Cable FPC-Cable Not Present Present Not Present Not Present Not Present Present Not Present Not Present Not Present Not Present Not Present Not Present Not Present Not Present Present Present Present Present Present Present Not Present Not Present Extension(2) N
PAGE 86
Sample Output The getniccfg subcommand displays an appropriate error message if the operation is not successful. Otherwise, on success, 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.
PAGE 87
IP Address 15 = :: LOM Status: NIC Selection = Dedicated Link Detected = Yes Speed = 10Mb/s Duplex Mode = Half Duplex NOTE: IPv6 information is displayed only if IPv6 is enabled in iDRAC6. NOTE: LOM Status is displayed only for iDRAC6 on Rack and Tower servers and is not displayed for iDRAC6 Enterprise on Blade servers. getpbinfo NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getpbinfo Displays power budget status information.
PAGE 88
Input Power Allocated to Chassis Infrastructure = 51 watts Total Input Power Available for Allocation = 0 W Standby Input Power Capacity = 0 W [Chassis Power Supply Status Table] PS1 Online On 16.
PAGE 89
getpminfo NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getpminfo Displays power management status information.
PAGE 90
[System Power Policy Configuration] System Input Power Cap BTU/hr | 10%) Surplus for Peak Performance BTU/hr) Redundancy Policy Dynamic PSU Engagement Enabled = 7928 W (7928 = 7000 W (6130 = None = No [Power Budgeting] System Input Max Power Capacity Input Redundancy Reserve Input Power Allocated to Servers Input Power Allocated to Chassis Infrastructure Total Input Power Available for Allocation Standby Input Power Capacity = = = = = = 0 W 0 W 0 W 51W 0 W 0 W getraclog NOTE: To use this subcommand, yo
PAGE 91
getraclog Subcommand Options (continued) Table 2-19. Option Description --more Displays one screen at a time and prompts the user to continue (similar to the UNIX more command). -o Displays the output in a single line. -s Specifies the starting record used for the display. NOTE: If no options are provided, the entire log is displayed. Output The default output display shows the record number, time stamp, source, and description.
PAGE 92
Table 2-20. getractime Subcommand Options Option Description -d Displays the time in the format, yyyymmddhhmmss.mmmmmms. -z Displays timezone. NOTE: This option is specific to CMC only. -n Displays NTP peer information. NOTE: This option is specific to CMC only. NOTE: If no options are provided, the getractime subcommand displays the time in a common readable format.
PAGE 93
Example racadm getredundancymode Redundant getsel NOTE: To use this subcommand, you must have Login to iDRAC permission. Subcommand Description getsel The getsel subcommand display all sensor event log entries in the DRAC. Synopsis racadm getsel -i[-A] racadm getsel [-s ] [-c ] [-A] [-o] [-E] [-R] [--more] NOTE: If no arguments are specified, the entire log is displayed. The following getsel options (without the -i option) are used to read entries.
PAGE 94
Output The default output display shows the record number, timestamp, severity, and description. For example: Record: 1 Date/Time: 11/16/2005 22:40:43 Severity: Ok Description: System Board SEL: event log sensor for System Board, log cleared was asserted getsensorinfo NOTE: To use this subcommand, you must have CMC Login User privilege. Subcommand Description getsensorinfo Displays status for system sensors.
PAGE 95
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 Cable 1 IO-Cable OK Cable 2 FPC-Cable OK getslotname NOTE: To use this subcommand, you must have CMC Login User privilege.
PAGE 96
Table 2-22 describes the getslotname subcommand options. Table 2-22. getslotname Subcommand Options Option Description (None) Displays the slot name for all 16 slots in the chassis. -i Specifies the ID of the slot. Legal values: 1–16 Specifies whether to use the slot name or the hostname (if available).
PAGE 97
getssninfo NOTE: To use this subcommand, you must have Login to iDRAC permission. Subcommand Description getssinfo Displays a list of users that are connected to iDRAC6.
PAGE 98
Examples • racadm getssninfo SSNID Type User IP Address Login Date/Time 6 GUI root 192.168.0.10 04/07/2010 12:00:34 • racadm getssninfo -A "root" "143.166.174.19" "Telnet" "NONE" • racadm getssninfo -A -u * "root" "143.166.174.19" "Telnet" "NONE" "bob" "143.166.174.19" "GUI" "NONE" getsvctag NOTE: To use this subcommand, you must have Login to iDRAC permission. Subcommand Description getsvctag Displays the service tag of the host system.
PAGE 99
getsysinfo NOTE: To use this subcommand, you must have Login to iDRAC permission. Subcommand Description getsysinfo Displays information related to iDRAC, managed system, and watchdog configuration. NOTE: The local racadm getsysinfo subcommand on Linux displays the PrefixLength on separate lines for IPv6 Address 2 – IPv6 Address 15 and the Link Local Address. Synopsis racadm getsysinfo [-d] [-s] [-w] [-A] [-c] [-4] [-6] Table 2-24 describes the getsysinfo subcommand options. Table 2-24.
PAGE 100
Last Firmware Update = 10/26/2009 16:55:08 Hardware Version = 0.01 MAC Address = 00:24:e8:2e:c5:d3 Common settings: Register DNS RAC Name = 1 DNS RAC Name = eval710-08-r Current DNS Domain = blr.amer.dell.com Domain Name from DHCP = 1 IPv4 settings: Enabled = 1 Current IP Address = 10.94.20.134 Current IP Gateway = 10.94.20.1 Current IP Netmask = 255.255.254.0 DHCP Enabled = 1 Current DNS Server 1 = 163.244.180.39 Current DNS Server 2 = 163.244.180.
PAGE 101
Current IP Address 5 = :: Current IP Address 6 = :: Current IP Address 7 = :: Current IP Address 8 = :: Current IP Address 9 = :: Current IP Address 10 = :: Current IP Address 11 = :: Current IP Address 12 = :: Current IP Address 13 = :: Current IP Address 14 = :: Current IP Address 15 = :: DNS Servers from DHCPv6 = 0 Current DNS Server 1 = :: Current DNS Server 2 = :: System Information: System Model = PowerEdge R710 System BIOS Version = 1.0.
PAGE 102
NIC2 Ethernet iSCSI NIC3 Ethernet iSCSI NIC4 Ethernet iSCSI = 00:24:e8:2e:c5:cd = 00:24:e8:2e:c5:ce = 00:24:e8:2e:c5:cf = 00:24:e8:2e:c5:d0 = 00:24:e8:2e:c5:d1 = 00:24:e8:2e:c5:d2 Watchdog Information: Recovery Action = None Present countdown value = 15 seconds Initial countdown value = 15 seconds Examples • racadm getsysinfo -A -s "System Information:" "PowerEdge 2900" "A08" "1.0" "EF23VQ-0023" "Hostname" "Microsoft Windows 2000 version 5.
PAGE 103
Limitations 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. If it is not installed, 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. gettracelog NOTE: To use this subcommand, you must have Login to iDRAC permission.
PAGE 104
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. For example: Record: 1 Date/Time: Dec Source: ssnmgrd[175] 8 08:21:30 Description: root from 143.166.157.103: session timeout sid 0be0aef4 getuscversion NOTE: This option is applicable only for iDRAC6.
PAGE 105
getversion NOTE: To use this subcommand, you must have Login privilege. Subcommand Description getversion Displays the current software version, model and generation information, and whether or not the target device can be updated. Synopsis racadm getversion [-b | -c] [-m ] racadm getversion -l [-m ] [-f ] racadm getversion Table 2-26 describes the getversion subcommand options. Table 2-26.
PAGE 106
Table 2-26. getversion Subcommand Options (continued) Option Description -f Filters the components. Must be used with -l and be one of the following values: • bios: BIOS • idrac: iDRAC • usc: Lifecycle Controller (Unified Server Configurator) • diag: 32-bit Diagnostics • drivers: OS Driver Package • nic-x: Network Interface card. See -l output for possible values of x • raid-x: Raid Controller.
PAGE 107
• racadm getversion -c server-1 PowerEdgeM600 server-2 PowerEdgeM805 server-5 • 1.0.0 PowerEdgeM710 racadm getversion -b server-1 2.0.0 PowerEdgeM605 server-2 1.1.0 PowerEdgeM805 server-5 1.1.0 PowerEdgeM710 • racadm getversion -l -m server-1 server-1 BIOS 1.2.1 2010-11-22 iDRAC 3.20 2010-11-22 USC 1.5.0.
PAGE 108
• BIOS 1.2.1 Reinstall iDRAC 3.20 Reinstall PERC6 Emb (raid-2) 07.01.33.00 Rollback PERC6 Emb (raid-2) 07.01.33.00 Reinstall racadm getversion -l -m server-1 -f bios server-1 BIOS 1.2.1 2010-11-22 ifconfig NOTE: To use this subcommand, you must have Execute Diagnostic Commands or Configure iDRAC permission. Subcommand Description ifconfig Displays the contents of the network interface table.
PAGE 109
collisions:0 txqueuelen:1000 RX bytes:272532097 (259.9 MiB) TX bytes:0 (0.0 B) krbkeytabupload NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description krbkeytabupload Uploads a Kerberos keytab file. Synopsis racadm krbkeytabupload [-f ] is the name of the file including the path. Table 2-27 describes the krbkeytabupload subcommand options. Table 2-27.
PAGE 110
kmcSelfSignedCertGen NOTE: The current release does not support this subcommand. NOTE: This is a non-extensible command that does not take any specific options. Subcommand Description kmcSelfSignedCertGen Generates the new self signed certificate for KMS purposes. To generate a selfsigned certificate, data such as certificate specific information like Common name, Organization Unit, key size and so on, are required.This information is taken from the cfgRacSecurityData group with index set to 2.
PAGE 111
netstat NOTE: To use this subcommand, you must have Execute Diagnostic Commands permission. Subcommand Description netstat Displays the routing table and the current connections. Synopsis racadm netstat ping NOTE: To use this subcommand, you must have Execute Diagnostic Commands or Configure iDRAC permission. Subcommand Description ping Verifies that the destination IP address is reachable from iDRAC6 with the current routing-table contents. A destination IP address is required.
PAGE 112
ping6 NOTE: To use this subcommand for CMC you must have Administrator privilege for CMC and for iDRAC you must have Execute Diagnostic Commands or Configure iDRAC6 permission. Subcommand Description ping6 Verifies that the destination IPv6 address is reachable from iDRAC6 or CMC or with the current routing-table contents. A destination IPv6 address is required. An ICMP echo packet is sent to the destination IPv6 address based on the current routing-table contents.
PAGE 113
racdump NOTE: To use this subcommand for CMC you must have Administrator privilege and for iDRAC you must have Debug permission. Subcommand Description racdump Provides a single command to get dump, status, and general iDRAC6 board information. For CMC, this subcommand displays the comprehensive chassis status and configuration state information, as well as historic event logs. Used for post deployment configuration verification and during debugging sessions.
PAGE 114
Subsystem RACADM Command NIC information (CMC module) getniccfg Redundancy information getredundancymode Trace log information gettracelog RAC event log getraclog System event log getsel Synopsis racadm racdump Example racadm racdump ===================================================== ========================== General System/RAC Information ===================================================== ========================== CMC Information: CMC Date/Time = Wed, 28 Nov 2007 11:55:49 PM Active CM
PAGE 115
Chassis Information: System Model System AssetTag Service Tag Chassis Name Chassis Location Power Status = = = = = = PowerEdgeM1000eControlPanel 00000 Dell Rack System [UNDEFINED] 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.
PAGE 116
Temp 1 Ambient_Temp OK 21 celcius PWR 1 PS-1 Online OK PWR 2 PS-2 Online OK PWR 3 PS-3 Online OK PWR 4 PS-4 PWR 5 PS-5 Failed OK PWR 6 PS-6 Slot Empty N/A Slot Empty N/A 40 N/A racreset NOTE: To use this subcommand for CMC you must have Chassis Administrator privilege and for iDRAC you must have Configure iDRAC permission.
PAGE 117
Examples • racadm racreset Start the iDRAC6 soft reset sequence. • racadm racreset hard Start the iDRAC6 hard reset sequence. racresetcfg NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description racresetcfg Removes all user-configured database property entries. The database has default properties for all entries that are used to restore iDRAC6 to the default settings. After resetting the database properties, iDRAC6 resets automatically.
PAGE 118
remoteimage NOTE: To use this subcommand, you must have Administrator permission. Subcommand Description remoteimage Connects, disconnects, or deploys a media file on a remote server. Synopsis racadm remoteimage Table 2-29 describes the remoteimage subcommand options. Table 2-29. remoteimage Subcommand Options and Descriptions Option Description -c Connect the image. -d Disconnect image. -u Username to access the network share. -p Password to access the network share.
PAGE 119
Table 2-30 describes the serveraction power control options. Table 2-30. serveraction Subcommand Options String Description Specifies the action. The options for the string are: • powerdown — Powers down the managed system. • powerup — Powers up 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 power down and then power up the system.
PAGE 120
Table 2-31 describes the setassettag subcommand option. Table 2-31. setassettag Subcommand Options Option Command -m Specifies the module whose asset tag you want to set. Legal value: chassis NOTE: Because there is only one legal value, you can obtain the same output if you do not include this option. NOTE: is a maximum of 64 non-extended ASCII characters. Example Input: racadm setassettag -m chassis 783839–33 or racadm setassettag 783839–33 The asset tag was changed successfully.
PAGE 121
setflexaddr NOTE: To use this subcommand, you must have Chassis Configuration Administrator privilege. Subcommand Description setflexaddr Enables/disables FlexAddress on a particular slot/fabric. NOTE: 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 powered off to change the slot state. All servers must be powered off to change the fabric state.
PAGE 122
Example • 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 NOTE: To use this subcommand, you must have Login access and Administrator privilege for CMC and Configure iDRAC permission for iDRAC. Subcommand Description setled Sets the state (blinking or not blinking) of the LED on the specified module.
PAGE 123
Table 2-33 describes the setled subcommand options. Table 2-33. setled Subcommand Options Option Description -m NOTE: This option is applicable for CMC only. Specifies the module whose LED you want to configure. can be one of the following: • server-n where n=1–16 • switch-n where n=1–6 • cmc-active • chassis -l Specifies whether the LED should blink.
PAGE 124
setniccfg NOTE: To use the setniccfg command, you must have Configure iDRAC permission. Subcommand Description setniccfg The setniccfg subcommand sets the iDRAC6 IP address. It displays an error message if the requested operation could not be performed, or a success message if the operation completed successfully. NOTE: The terms NIC and Ethernet management port may be used interchangeably.
PAGE 125
setractime NOTE: To use this subcommand, you must have Administrator privilege. Subcommand Description setractime Sets the date and time on the CMC. Synopsis racadm setractime -d racadm setractime [-l YYYYMMDDhhmmss] -z {?|timezone|timezone-prefix*} Table 2-35 describes the setractime subcommand options. Table 2-35. setractime Subcommand Options Option Description -d Sets the time in the string yyyymmddhhmmss.
PAGE 126
Table 2-35. setractime Subcommand Options (continued) Option Description -z Sets the time zone by name or index, or lists possible time zones. may be: • lists the major timezone names/prefixes • is the case-sensitive name of your timezone or the index listed by '-z timezone-prefix*'. • is a prefix of one or more timezones, followed by '*'. NOTE: The timezone/daylight savings time is fully supported for '-l' and '-z' options.
PAGE 127
setslotname NOTE: To use this subcommand, you must have Administrator privilege. NOTE: See the "Editing Slot Names" section in the Dell Chassis Management Controller User Guide for rules for selecting slot names. Subcommand Description setslotname Displays the name and hostname (if available) of all 16 slots, or of a specified slot (indicated by the slot number) in the chassis.
PAGE 128
Example racadm setslotname -i 3 mserver3 The slot name was set successfully. setsysinfo NOTE: To use this subcommand, you must have Administrator privilege. Subcommand Description setsysinfo Sets the name or location of the chassis. Synopsis racadm setsysinfo [-c chassisname|chassislocation] Table 2-37 describes the setsysinfo subcommand options. Table 2-37. setsysinfo Subcommand Options Option Description Indicates a maximum of 64 non-extended ASCII chassis name or location.
PAGE 129
sshpkauth Subcommand Description sshpkauth Enables you to upload and manage up to 4 different SSH public keys per user. You can upload a key file or key text, view keys, or delete keys. This command has three mutually exclusive modes—upload, view, and delete that are determined by the options (see Table 2-38) provided for the command. Synopsis racadm sshpkauth Upload The upload mode allows you to upload a keyfile or to copy the key text on the command line.
PAGE 130
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 Table 2-38 describes the sshpkauth subcommand options. Table 2-38. sshpkauth Subcommand Options Option Description -i Index for the user. must be between 2 to 16 on iDRAC6. -k [ | all] Index to assign the PK key being uploaded. all only works with the -v or -d options.
PAGE 131
ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzzy+k2npnKqVEXGXIzo0sbR6J gA5YNbWs3ekoxXV fe3yJVpVc/5zrrr7XrwKbJAJTqSw8Dg3iR4n3vUaP+lPHmUv5Mn55 Ea6LHUslAXFqXmOdlThd wilU2VLw/iRH1ZymUFnut8ggbPQgqV2L8bsUaMqb5PooIIvV6hy4i sCNJU= 1024-bit RSA, converted from OpenSSH by xx_xx@xx.xx Key ID 2: Key ID 3: Key ID 4: sslcertdownload NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description sslcertdownload Downloads an SSL certificate from iDRAC6 to the client’s file system.
PAGE 132
Table 2-39. sslcertdownload Subcommand Options -f Specifies the file name of the certificate to be uploaded. If the -f option or the filename is not specified, the sslcert file in the current directory is selected. The sslcertdownload command returns 0 when successful and returns a nonzero number when unsuccessful. Example racadm sslcertdownload -t 1 -f c:\cert\cert.txt sslcertupload NOTE: To use this subcommand, you must have Configure iDRAC permission.
PAGE 133
Table 2-40 describes the sslcertupload subcommand options. Table 2-40. sslcertupload Subcommand Options Option Description -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 3 = KMS public certificate 4 = KMC public certificate NOTE: The current release does not support type 3 and 4. -f Specifies the file name of the certificate to be uploaded.
PAGE 134
sslcertview NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description sslcertview Displays the SSL server or CA certificate that exists on iDRAC6. Synopsis racadm sslcertview -t [-A] Table 2-41 describes the sslcertview subcommand options. NOTE: The current release does not support type 3 and 4 -t options. Table 2-41.
PAGE 135
Organization (O) Organizational Unit (OU) Common Name (CN) : Dell Inc. : Remote Access Group : iDRAC6 default certificate Issuer Information: Country Code (CC) State (S) Locality (L) Organization (O) Organizational Unit (OU) Common Name (CN) : : : : : : Valid From Valid To : Jul : Jul US Texas Round Rock Dell Inc. Remote Access Group iDRAC6 default certificate 8 16:21:56 2005 GMT 7 16:21:56 2010 GMT racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc.
PAGE 136
sslcsrgen NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description sslcsrgen Can be used to generate a CSR and download the 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 iDRAC6. Synopsis racadm sslcsrgen [-g] [-f ] racadm sslcsrgen -s Table 2-42 describes the sslcsrgen subcommand options. NOTE: The -f option is not supported for the serial/Telnet/ssh console.
PAGE 137
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. • CSR generation in progress. NOTE: Before a CSR can be generated, the CSR fields must be configured in the RACADM cfgRacVirtual group.
PAGE 138
Table 2-43 describes the sslkeyupload subcommand options. Table 2-43. sslkeyupload Subcommand Options Option Description -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. The sslkeyupload command returns 0 when successful and returns a nonzero number when unsuccessful. Example racadm sslkeyupload -t 1 -f c:\sslkey.
PAGE 139
testemail Subcommand Description testemail Sends a test e-mail from iDRAC6 to a specified destination. Prior to executing the test e-mail command, ensure that the SMTP server is configured and the specified index in the RACADM cfgEmailAlert group is enabled and configured properly. See "cfgEmailAlert" on page 180 for more information. Synopsis racadm testemail -i Table 2-44 provides a list and associated commands for the cfgEmailAlert group. Table 2-44.
PAGE 140
Table 2-45 describes the testemail subcommand options. Table 2-45. testemail Subcommands Option Description -i Specifies the index of the e-mail alert to test. Output Success: Test e-mail sent successfully Failure: Unable to send test e-mail testkmsconnectivity NOTE: The current release does not support this subcommand. Subcommand Description testkmsconnectivity KMS connectivity test command that allows you to test if the iDRAC DKM client is able to connect to the KMS server successfully.
PAGE 141
testfeature Subcommand Description testfeature Generic test command consisting of several sub-commands that allow you to verify the configuration and operation of specific features. Table 2-47 describes the testfeature subcommand options. Table 2-47. testfeature Subcommand Options Option Description -f Specifies the feature name.
PAGE 142
This subcommand 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.
PAGE 143
This subcommand tests the Active Directory configuration using Kerberos authentication (single sign-on or Smart Card login). Use the optional -d switch to obtain additional diagnostic information, as needed. This subcommand when executed 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.
PAGE 144
testtrap NOTE: To use this subcommand, you must have Test Alerts permission. Subcommand Description testtrap Tests the RAC’s SNMP trap alerting feature by sending a test trap from iDRAC6 to a specified destination trap listener on the network. For iDRAC6 only, before you execute the testtrap subcommand, ensure that the specified index in the RACADM cfgIpmiPet group is configured properly. For more information, see "cfgIpmiPet" on page 241.
PAGE 145
traceroute NOTE: To use this subcommand, you must have Administrator permission. Subcommand Description traceroute Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv4 address. Synopsis racadm traceroute racadm traceroute 192.168.0.1 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.
PAGE 146
usercertupload NOTE: To use this subcommand, you must have Configure iDRAC permission NOTE: This option is applicable only to iDRAC6.. Subcommand Description usercertupload Uploads a user certificate or a user CA certificate from the client to iDRAC6. Synopsis racadm usercertupload -t [-f ] -i Table 2-50 describes the usercertupload subcommand options. Table 2-50.
PAGE 147
usercertview NOTE: To use this subcommand, you must have Configure iDRAC permission. NOTE: This option is applicable only to iDRAC6. Subcommand Description usercertview Displays the user certificate or user CA certificate that exists on iDRAC6. Synopsis racadm usercertview -t [-A] -i Table 2-51 describes the sslcertview subcommand options. Table 2-51.
PAGE 148
vflashsd NOTE: To use this subcommand, you must have Access Virtual Media privilege NOTE: This option is applicable only to iDRAC6.. Subcommand Description vflashsd Allows you to initialize or get the status of the vFlash SD card. The initialize operation removes all existing partitions and resets the card. The status operation displays the status of the last operation performed on the card.
PAGE 149
Synopsis racadm vflashpartition create racadm vflashpartition delete racadm vflashpartition status racadm vflashpartition list Table 2-52 describes the vflashpartition subcommand options. Table 2-52. Option vflashpartition Subcommand Options Description -i Index of the partition for which this command applies. must be an integer from 1 to 16.
PAGE 150
Table 2-52. vflashpartition Subcommand Options (continued) Option Description -t Create a partition of type . must be: • empty – Create an empty partition. The following options are valid with the empty type: • -s – Partition size in MB. • -f – Format type for the partition based on the type of file system. Valid options are RAW, FAT16, FAT32, EXT2, or EXT3. • image – Create a partition using an image relative to iDRAC.
PAGE 151
• To delete all partitions, re-initialize the vFlash SD card: racadm vflashsd initialize • To get the status of operation on partition 1: racadm vflashpartition status -i 1 • To get the status of all existing partitions: racadm vflashpartition status -a • To list all existing partitions and its properties: racadm vflashpartition list • To get the partition size: racadm getconfig –g cfgvflashpartition –o cfgvflashpartitionsize –i 1 • To display the emulation type: racadm getconfig –g cfgvflashpart
PAGE 152
vmdisconnect NOTE: To use this subcommand, you must have Access Virtual Media permission. NOTE: This option is applicable only to iDRAC6. Subcommand Description vmdisconnect Allows a user to disconnect another user's Virtual Media session. Once disconnected, the Web-based interface reflects the correct connection status. Enables a iDRAC6 user to disconnect all active Virtual Media sessions.
PAGE 153
Synopsis racadm vmkey If is configured as reset, the vFlash memory is reset to the default size of 256 MB and removes all data from it. NOTE: This command is deprecated from iDRAC6 1.5 and iDRAC6 3.0 releases onwards. The functionality of this command is now covered by vflashsd initialize. While execution of the vmkey reset command is successful, it is recommended to use the vflashsd initialize command. For more information, see "vflashsd" on page 148.
PAGE 154
RACADM Subcommand Details
PAGE 155
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm iDRAC6 and CMC Property Database Group and Object Descriptions 3 The iDRAC6 and CMC property database contains the configuration information for iDRAC6 and CMC. Data is organized by associated object, and objects are organized by object group.
PAGE 156
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Displayable Characters Displayable characters include the following set: abcdefghijklmnopqrstuvwxwz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/ Table 3-1 lists the supported object groups. Table 3-1.
PAGE 157
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Table 3-1.
PAGE 158
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Table 3-1. Supported Object Groups (continued) Subcommand iDRAC6 on Blade iDRAC6 on Rack CMC Servers and Tower Servers cfgSmartCard cfgNetTuning cfgSensorRedundancy cfgVFlashSD cfgVFlashPartition cfgLogging cfgKMSProfile = Supported; =Not supported idRacInfo This group contains display parameters to provide information about the specifics of iDRAC6 or CMC being queried. One instance of the group is allowed.
PAGE 159
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm 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.
PAGE 160
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Example racadm getconfig -g idRacInfo # idRacType=8 # idRacProductInfo=Chassis Management Controller # idRacDescriptionInfo=This system component provides a complete set of remote management functions for blade servers # idRacVersionInfo=P21 # idRacBuildInfo=200708301525 # idRacName=CMC-1 cfgLanNetworking This group contains parameters to configure iDRAC6 or CMC NIC. One instance of the group is allowed.
PAGE 161
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgNicSelection (Read/Write) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers or CMC. Description Specifies the current mode of operation for the RAC network interface controller (NIC). Table 3-2 describes the supported modes.
PAGE 162
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Table 3-2. cfgNicSelection Supported Modes (continued) Mode Description Shared with Failover All Enables teaming capabilities between all LOMs on the LOMs host server integrated network interface controllers. The remote access device network interface is fully functional when the host operating system is configured for NIC teaming.
PAGE 163
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgNicVLanId (Read/Write) Description Specifies the VLAN ID for the network VLAN configuration (in CMC for iDRAC6 Enterprise on Blade Servers). This property is only valid if cfgNicVLanEnable is set to 1 (enabled).
PAGE 164
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm • cfgIPv6Enable • cfgIPv6AutoConfig • cfgDNSDomainNameFromDHCP • cfgDNSDomainName (Read/Write) The network administrator must ensure that these DHCP servers are configured to provide the same DNS domain name to the CMC, otherwise the domain name becomes unpredictable. cfgDNSDomainName (Read/Write) Description This is the DNS domain name.
PAGE 165
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgDNSRegisterRac (Read/Write) Description Registers the iDRAC6 or 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 1 (TRUE) 0 (FALSE) Default 0 NOTE: For IPv6, only the DHCPv6 address or static address is registered.
PAGE 166
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm 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 1 (TRUE) 0 (FALSE) Default 0 cfgDNSServer1 (Read/Write) Description Specifies the IPv4 address for DNS server 1. This property is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE).
PAGE 167
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgNicEnable (Read/Write) Description Enables or disables iDRAC6 or CMC network interface controller. If the NIC is disabled, the remote network interfaces to iDRAC6 or CMC are no longer accessible and iDRAC6 or CMC are only available through the local or serial RACADM interface.
PAGE 168
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgNicGateway (Read/Write) NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE). Description iDRAC6 or 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). Legal Values String representing a valid gateway IPv4 address. For example: 192.168.0.1. Default 192.168.0.
PAGE 169
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRemoteHosts This group provides properties that allow configuration of the SMTP server for e-mail alerts. For CMC, this group enables/disables and configures firmware updates, NTP, remote syslogging, and SMTP email alerting. Use the -m option to apply this setting to iDRAC. NOTE: Use this object with the config or getconfig subcommands.
PAGE 170
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRhostsFwUpdatePath (Read/Write) Description Specifies TFTP path where iDRAC6 or CMC firmware image file exists on the TFTP server. The TFTP path is relative to the TFTP root path on the TFTP server. NOTE: The server may still require you to specify the drive (for example, C:). Legal Values A string with a maximum length of 255 ASCII characters.
PAGE 171
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRhostsNtpServer1 NOTE: This object is applicable to CMC only. Description Specifies the first of three possible NTP servers. Legal Values A string representing a valid NTP server. For example, ntp1.ntp.net. At least one NTP server must be specified and duplicate entries are not allowed. Default Null cfgRhostsNtpServer2 NOTE: This object is applicable only for CMC.
PAGE 172
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRhostsNtpMaxDist NOTE: This object is applicable only for CMC. Description Specifies the NTP maximum distance parameter used to aid in NTP configuration. Legal Values 1 – 128 Default 16 cfgRhostsSyslogEnable (Read/Write) Description Enables or disables remote syslog to allow the RAC and SEL logs to be written to up to three remote syslog servers.
PAGE 173
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRhostsSyslogServer1 (Read/Write) Description Specifies the first of three possible remote syslog servers to store the RAC and SEL logs.This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values For iDRAC6: String from 0 to 511 characters. For CMC: Valid hostname or IPv4 or IPv6 address.
PAGE 174
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRhostsSyslogPowerLoggingEnabled NOTE: This object is applicable only for CMC. Description Enables or disables power consumption logging to remote syslog servers. Legal Values 1 (enabled) 0 (disabled) Default 0 NOTE: Remote syslog must be enabled and one or more remote syslog servers configured for power consumption to be logged. cfgRhostsSyslogPowerLoggingInterval NOTE: This object is applicable only for CMC.
PAGE 175
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgUserAdmin This group provides configuration information about the users who are allowed to access iDRAC6 or 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.
PAGE 176
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgUserAdminIpmiLanPrivilege (Read/Write) NOTE: This object property is specific to iDRAC6. Description The maximum privilege on the IPMI LAN channel. Legal Values 2 (User) 3 (Operator) 4 (Administrator) 15 (No access) Default 4 (User 2) 15 (All others) cfgUserAdminPrivilege (Read/Write) Description This property specifies the role-based authority privileges allowed for the user.
PAGE 177
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Table 3-3.
PAGE 178
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Examples Table 3-4 provides sample privilege bit masks for users with one or more privileges. Table 3-4. Sample Bit Masks for User Privileges User Privilege(s) Privilege Bit Mask The user is not allowed to access iDRAC or CMC. 0x00000000 The user may only login to 0x00000001 iDRAC or CMC and view iDRAC or CMC and server configuration information. The user may login to iDRAC or CMC and change configuration.
PAGE 179
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm 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.
PAGE 180
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgUserAdminIpmiSerialPrivilege (Read/Write) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers or CMC. Description The maximum privilege on the IPMI LAN channel.
PAGE 181
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgEmailAlertEnable (Read/Write) Description Enables or disables the alert instance. Legal Values 1 (TRUE) 0 (FALSE) Default 0 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.
PAGE 182
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Example racadm getconfig -g cfgEmailAlert -i 2 # cfgEmailAlertIndex=1 cfgEmailAlertEnable=1 cfgEmailAlertAddress=kfulton@dell.com cfgEmailAlertName=Kevin Fulton cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to iDRAC6. One instance of the group is allowed.
PAGE 183
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgSsnMgtConsRedirMaxSessions (Read/Write) NOTE: This object is applicable only for iDRAC6. Description Specifies the maximum number of Virtual Console sessions allowed on iDRAC6. Legal Values For iDRAC6 on Rack and Tower Servers: 1 – 4.
PAGE 184
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgSsnMgtSshIdleTimeout (Read/Write) Description Defines the secure shell idle timeout. This property sets the amount of time in seconds that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached. Changes to this setting do not affect the current session; you must log out and log in again to make the new settings effective.
PAGE 185
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgSsnMgtTelnetIdleTimeout (Read/Write) Description Defines the Telnet idle timeout. This property sets the amount of time in seconds that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached. Changes to this setting do not affect the current session (you must log out and log in again to make the new settings effective).
PAGE 186
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm The following sections provides information about the objects in the cfgSerial group. NOTE: The cfgSerial object group is applicable for iDRAC6 Enterprise on Blade Servers for only two properties—cfgSerialTelnetEnable=1 and cfgSerialSshEnable=1. cfgSerialBaudRate (Read/Write) Description Sets the baud rate on iDRAC6 or CMC serial port.
PAGE 187
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgSerialConsoleQuitKey (Read/Write) Default For iDRAC6: This key or key combination terminates Virtual Console text for iDRAC when using the console com2 command.
PAGE 188
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgSerialConsoleIdleTimeout (Read/Write) Description The maximum number of seconds to wait before an idle serial session is disconnected. Legal Values 0 = No timeout 60 – 1920 Default For iDRAC6: 300 For CMC: 1800 cfgSerialConsoleNoAuth (Read/Write) Description Enables or disables the RAC or CMC serial console login authentication.
PAGE 189
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm NOTE: The prompt counts as two characters. NOTE: The terminal emulator must be configured with the line wrap mode ON, if a terminal emulator is used. NOTE: You must log out, then log in again for the changes to take effect. cfgSerialHistorySize (Read/Write) Description Specifies the maximum size of the serial history buffer.
PAGE 190
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Example racadm getconfig -g cfgSerial cfgSerialBaudRate=115200 cfgSerialConsoleEnable=1 cfgSerialConsoleQuitKey=^\ cfgSerialConsoleIdleTimeout=1800 cfgSerialConsoleNoAuth=0 cfgSerialConsoleCommand= cfgSerialConsoleColumns=0 cfgSerialHistorySize=8192 cfgSerialTelnetEnable=0 cfgSerialSshEnable=1 cfgSerialTelnetEnable (Read/Write) Description Enables or disables the Telnet console interface on iDRAC6 or CMC.
PAGE 191
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm The following sections provides information about the objects in the cfgOobSnmp group. cfgOobSnmpAgentCommunity (Read/Write) Description Specifies the SNMP Community Name (identical to community string) used for SNMP traps. The community string acts as a password shared between different hosts over the network. This community string value must match with that of the other hosts for any kind of communication through SNMP.
PAGE 192
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgTrapsIndex (Read Only) Description Indicates the unique index of an alert instance Legal Values 1-4 Default 1 cfgTrapsEnable Description Enables or disables event traps on the CMC. Legal Values 1 (TRUE) 0 (FALSE) Default None cfgTrapsAlertDestIpAddr Description Sets the IP address that receives the alert. Legal Values A string representing a valid IP address. For example, 192.168.0.20.
PAGE 193
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Example racadm getconfig -g cfgTraps -i 2 # cfgTrapsIndex=2 cfgTrapsEnable=1 cfgTrapsAlertDestIpAddr= cfgTrapsCommunityName=public cfgRacTuning NOTE: Use this object with the config or getconfig subcommands. NOTE: To use this object property for CMC, you must have Chassis Configuration Administrator privilege. NOTE: For CMC, you can configure any setting that is not preceded by the hash sign (#) in the output.
PAGE 194
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRacTuneRemoteRacadmEnable (Read/Write) Description Enables or disables the Remote RACADM interface in iDRAC or CMC. Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgRacTuneCtrlEConfigDisable NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers or CMC.
PAGE 195
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRacTuneHttpsPort (Read/Write) Description Specifies the port number to use for HTTPS network communication with iDRAC6 or CMC. Legal Values 10 – 65535 Default 443 NOTE: For CMC, the following port numbers are reserved and cannot be used: 21, 68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
PAGE 196
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRacTuneIpRangeMask (Read/Write) Description Standard IP mask values with left-justified bits. For example, 255.255.255.0. For CMC, a login from the incoming IP address is allowed only if both of the following are identical: • cfgRacTuneIpRangeMask bit-wise and with incoming IP address • cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr Legal Values An IPv4 address formatted string, for example, 255.255.
PAGE 197
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRacTuneIpBlkFailWindow (Read/Write) Description Defines the time span in seconds that the failed attempts are counted. When failure attempts age beyond this limit, they are dropped from the count.
PAGE 198
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm cfgRacTuneConRedirEnable (Read/Write) NOTE: This object property is applicable only to iDRAC6. Description Enables or disables Virtual Console. Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgRacTuneConRedirEncryptEnable (Read/Write) NOTE: This object property is applicable only to iDRAC6. Description Encrypts the video in a Virtual Console session.
PAGE 199
FILE LOCATION: C:\Users\kavitha_kanagowder\Desktop\Source_final\racadmDBgrpObjDef.fm Example racadm getconfig -g cfgRacTuning [-m server-] -o