Page 3 - Contents
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Introduction................................................................................................................................33 New in This Rele...
Page 33 - Introduction; New in This Release
1 Introduction This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions for the following: • iDRAC Enterprise or Express for Blade Servers • iDRAC Enterprise or Express on Rack and Tower Servers • Dell Chassis S...
Page 34 - Supported RACADM Interfaces; RACADM Syntax Usage; Local RACADM; SSH or Telnet RACADM
Supported RACADM Interfaces The RACADM command-line utility provides a scriptable interface that allows you to locally or remotely configure your Remote Access Controller (RAC). The utility runs on the management station and the managed system. It is available on the Dell OpenManage Systems Manageme...
Page 35 - Remote RACADM; RACADM Command Options
Remote RACADM racadm -r <racIpAddr> -u <username> -p <password> getconfig -g <groupname> [-o <objectname>] [-i <indexnumber>] racadm -r <racIpAddr> -u <username> -p <password> <subcommand> Example racadm -r <racIpAddr> -u <username...
Page 36 - Supported RACADM Subcommands
Supported RACADM Subcommands The following table 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. Subcommand iDRAC on Blade Servers iDRAC on Rack an...
Page 39 - Other Documents You May Need
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC usercertview Yes Yes Yes Yes Yes Yes No No vflashsd Yes Yes Yes Yes Yes Yes No No vflashpartition Yes Yes Yes Yes Yes Yes No No vmdisconnect Yes Yes Yes Yes Yes Yes No No Other Documents You May Need In addition to this guide, you...
Page 41 - RACADM Subcommand Details; Guidelines to Quote Strings Containing Special Characters When
2 RACADM Subcommand Details This section provides detailed descriptions of the RACADM subcommands including the syntax and valid entries. Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands When using strings that contain special characters, use the following guideli...
Page 43 - arp
-c : show chassis information -A : do not show headers or labels -4 : show CMC IPv4 information -6 : show CMC IPv6 information help and help <subcommand> Description Lists all the subcommands available for use with RACADM and provides a short description for each. You may also type a subcomman...
Page 45 - chassisaction
Input racadm> cd <object> Output Use the command to execute object related get or set commands. Example • Example 1: To execute all system related get or set commands: – Input: [root@idrac- <username>]racadm> cd system – Output: [root@idrac- <username>]system> • Example 2:...
Page 46 - clearasrscreen
To use this subcommand, you must have Chassis Control Administrator privilege Synopsis racadm chassisaction [-m < module >] < action > Input • -m < module> — Module on which you want to carry out the action. Values are: — chassis - this is the default value if -m is not specified.—...
Page 47 - closessn; clrsel; cmcchangeover
closessn Description Closes a communication session on the device. Use getssninfo to view a list of sessions that can be closed using this command.To use this subcommand, you must have Administrator permission. Synopsis • racadm closessn –i < session id > • racadm closessn -a • racadm closessn...
Page 48 - config
To use this subcommand, you must have Administrator privilege. NOTE: This command is valid only in redundant CMC environments. For more information, see the "Understanding the Redundant CMC Environment" section of the Dell Chassis System User Guide. Synopsis racadm cmcchangeover Input None O...
Page 49 - connect
• -c — The -c, or check option, is used with the config subcommand and allows the user to parse the .cfg file to locate syntax errors. If errors are found, the line number and a short description of what is incorrect are displayed. Write permission does not apply to iDRAC. This option is a check onl...
Page 50 - coredump; coredumpdelete
Input -b — Connects to the switch or console using the binary mode. This is an optional argument; a server or a switch must be present. NOTE: If you use the -b option, reset the CMC to terminate the connect operation. • server-nx —where n=1-8 ; x = a,b,c,d • switch-n — switch-n where n= <a1 | a2 ...
Page 51 - deploy
This option is applicable only for iDRAC.To use this subcommand, you must have Clear Logs or Execute Debug Commands permission. 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 co...
Page 52 - eventfilters
• -u root — Indicates that the < password> is supplied for the root user on the server or switch. Root is a constant parameter, the only value that is valid with the ‑ u option. • -m < module> — Specifies the server or switch you want to configure. Legal values: – sever-n, where n=1–16 –...
Page 55 - feature; featurecard
feature Description Displays all active chassis features. The information displayed includes feature name, date activated, and the serial number of the SD card used to activate the feature.Dell Feature Cards may contain more than one feature. After any feature included on a Dell Feature Card is acti...
Page 56 - fwupdate
Output • No feature card inserted — Action: Check the CMC to verify that the SD card was properly inserted. In a redundant CMC configuration, make sure the CMC with the SD feature card installed is the active CMC and not the standby CMC. • The feature card inserted is valid and contains the followin...
Page 60 - get
NOTE: For CMC, these commands specifically apply to an active-CMC update. The following table describes the firmware update method supported for each interface. FW Update Method iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC Local RACADM Yes Yes No Local RACADM - TFTP Yes Yes No Local RA...
Page 61 - getarraycfg
• <object> — Specifies the object name of the value to be read. • <index> — Specifies where FQDD Alias's or Groups need to be indexed. • -f <filename> — This option enables you to save the RAC configuration to a file.Enables the subcommand to write the device configuration to a fil...
Page 62 - getassettag; getchassisname; getconfig
<module> configuration completed successfully. Example • Get the configured storage array properties from server-3 racadm getarraycfg -m server-3 • Query for current storage configuration process status on server-3 racadm getarraycfg -m server-3 -s getassettag Description Displays the asset ta...
Page 64 - getdcinfo
racadm getconfig -u root • Displays the user group instance at index 2 with verbose information for the property values. racadm getconfig -g cfgUserAdmin -i 2 -v getdcinfo Description Displays general I/O module and daughter card configuration information. Only the CMC controls daughtercards.To use ...
Page 66 - getflexaddr
server-13 Not Present None None server-14 Not Present None None server-15 Not Present None None server-16 Not Present None None getflexaddr Description Displays enabled/disabled status for the entire chassis. If used with -i, the command displays MACs/WWN on a per slot basis.To use this subcommand, ...
Page 68 - getfanreqinfo
getfanreqinfo Description Displays fan speed request for Servers and Switches in percent (%).To use this subcommand, you must have CMC Login User privilege.This subcommand is not applicable for iDRAC. Synopsis racadm getfanreqinfo Input None Output None Example racadm getfanreqinfo [Ambient Temperat...
Page 70 - getioinfo
< IO Name > < Name > < Type > < Presence > < Fan Request% > Switch-1 Dell Ethernet Pass-Through 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...
Page 72 - getmacaddress
getmacaddress Description Displays the MAC/WWN addresses for all modules or for a specified module.To use this subcommand, you must have CMC Login User privilege. Synopsis • racadm getmacaddress [-m < module>] [-t iscsi] [-x] • racadm getmacaddress [-a] Input • -m < module> — Specifies t...
Page 77 - getmodinfo
Switch-6 N/A Not Present N/A N/A N/A getmodinfo Description Displays configuration and status information for all modules or a specified module (server, switch, CMC, fan unit, power supply unit, KVM, or I2C cable) in the chassis.For CMC only, a power state of "Primary" denotes Active CMC.To ...
Page 78 - getniccfg
Switch-2 Not Present N/A N/A N/A Switch-3 Not Present N/A N/A N/A Switch-4 Not Present N/A N/A N/A Switch-5 Not Present N/A N/A N/A Switch-6 Not Present N/A N/A N/A Server-1 Not Present N/A N/A N/A Server-2 Present OFF OK Server-3 Present ON OK S YW Server-4 Present ON OK Server-5 Present ON OK Serv...
Page 80 - getpbinfo
getpbinfo Description Displays power budget status information.To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getpbinfo Example racadm getpbinfo [Power Budget Status] System Input Power = 700 W Peak System Power = 0 W Peak System Power Timestamp = 01:08:23 01/27/2009...
Page 81 - getpminfo
9 SLOT-09 N/A N/A 5 N/A 10 SLOT-10 Extension(2) N/A 5 N/A 11 SLOT-11 N/A N/A 5 N/A 12 SLOT-12 ON 125 W 5 PowerEdgeM600 13 SLOT-13 N/A N/A 5 N/A 14 SLOT-14 ON 342 W 5 N/A 15 SLOT-15 ON 140 W 5 16 SLOT-16 ON 125 W 5 N/A getpminfo Description Displays power management status information.To use this sub...
Page 82 - getraclog
Performance = 7000 W (6130 BTU/hr) Redundancy Policy = None Dynamic PSU Engagement Enabled = No [Power Budgeting] System Input Max Power Capacity = 0 W Input Redundancy Reserve = 0 W Input Power Allocated to Servers = 0 W Input Power Allocated to Chassis Infrastructure = 51W Total Input Power Availa...
Page 83 - getractime
Message Arg 2 = 10.92.68.245 FQDD = iDRAC.Embedded.1 Example • Display the starting record and the number of records. racadm getraclog -s 10 -c 2 • Display a few records and prompt to display another set of records. $ racadm getraclog --more Dec 4 22:23:09 CMC-JP4BF2S Login success from 10.94.46.52 ...
Page 84 - getredundancymode; getsel; getsensorinfo
getredundancymode Description Displays the redundancy status (Redundant or Non- Redundant) of the CMC.To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getredundancymode Example racadm getredundancymode Redundant getsel Description Displays all sensor event log entries ...
Page 87 - getslotname
System Board CMOS Battery Ok Present NA NA Sensor Type : PERFOMANCE <Sensor Name> <Status> <State> <lc> <uc> System Board Power Optimized Ok Not Degraded NA NA Sensor Type : INTRUSION <Sensor Name> <Intrusion> <Status> System Board Intrusion Closed Pow...
Page 88 - getssninfo; getsvctag
11 SLOT-11 12 SLOT-12 13 SLOT-13 14 SLOT-14 15 SLOT-15 16 SLOT-16 racadm getslotname -i 1Webserver-1 getssninfo Description Displays a list of users that are connected to iDRAC. The following information is displayed: • Session ID • Username • IP address (if applicable) • Session type (for example, ...
Page 89 - getsysinfo
Example racadm getsvctag getsysinfo Description 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.NOTE: T...
Page 91 - gettracelog; getversion
System Revision = I System BIOS Version = 0.2.3 BMC Firmware Version = 0.17 Service Tag = 48192 Host Name = racdev103 OS Name = Microsoft Windows Server 2003 Power Status = OFF Watchdog Information: Recovery Action = None Present countdown value = 0 seconds Initial countdown value = 0 seconds gettra...
Page 94 - hwinventory
hwinventory Description Allows you to display or export current internal hardware inventory or shipped hardware inventory by device.To use this subcommand, you must have login privilege.This subcommand is applicable for iDRAC only. Synopsis • racadm hwinventory • racadm hwinventory NIC|FC • racadm h...
Page 99 - krbkeytabupload
where valid options are -i and –all. racadm jobqueue create < fqdd > [-r < reboot type > ] [-s < start time > ] [-e <expiry time>] Input • -i — Specifies a JobID that can be displayed or deleted. • --all — The JobIDs which are not applied will be deleted. • -fqdd — Specifies ...
Page 100 - lclog
Example racadm krbkeytabupload -f c:\keytab \krbkeytab.tab lclog Description Allows you to export the lifecycle log history, view the lifecycle log for a particular device or category, add comment to a record in lifecycle log, and add a worknote(an entry) in the lifecycle log.To use this subcommand,...
Page 102 - license
NOTE: To view or export the lifecycle log you need Login to iDRAC permission only. Example • Display the number of records present in the Lifecycle Log: racadm lclog view -i • Display the records added by the iDRAC agent idrac, under the storage category and storage physical disk subcategory, with s...
Page 105 - netstat
• Export license to a CIFS share specifying the entitlement ID, in this case abcdxyz : racadm license export -u admin -p passwd -f License.xml -l //192.168.2.140/licshare -e abcdxyz • Export license to a CIFS share specifying the FQDD. While using the -c option and exporting license(s) from a device...
Page 106 - nicstatistics
ff00::/8 :: U 256 0 0 eth1 Kernel IP routing table Destination Gateway Genmask Flags MSS Window irtt Iface 10.94.161.0 0.0.0.0 255.255.255.0 U 0 0 0 bond0 0.0.0.0 10.94.161.1 0.0.0.0 UG 0 0 0 bond0 Active Internet connections (w/o servers) Proto Recv-Q Send-Q Local Address Foreign Address State tcp ...
Page 107 - ping
• Displays the statistics for the integrated NIC. $ racadm nicstatistics NIC.Integrated.1-1 Total Bytes Received:0 Total Bytes Transmitted: 0 Total Unicast Bytes Received: 0 Total Multicast Bytes Received: 0 Total Broadcast Bytes Received: 0 Total Unicast Bytes Transmitted: 0 • Get the network stati...
Page 108 - racdump
Reply from 2011:de11:bdc:194::31: time<1ms Reply from 2011:de11:bdc:194::31: time<1ms Ping statistics for 2011:de11:bdc:194::31: Packets: Sent = 4, Received = 4, Lost = 0 (0% loss), Approximate round trip times in milli-seconds: Minimum = 0ms, Maximum = 0ms, Average = 0ms racdump Description P...
Page 110 - racreset
< senType > < Num > < sensorName > < status > < AC-OK status > PWR 1 PS-1 Online OK PWR 2 PS-2 Online OK PWR 3 PS-3 Online OK PWR 4 PS-4 Slot Empty N/A PWR 5 PS-5 Failed OK PWR 6 PS-6 Slot Empty N/A racreset Description Resets iDRAC . The reset event is logged in the iD...
Page 111 - racresetcfg
• To reset CMC: racadm racreset • To reset server 1: racadm racreset -m server-1 • To reset servers 1 and 3: racadm racreset -m server-1 server-3 • To force reset iDRAC on servers 1 and 5: racadm racreset -m server-1 server-5 -f NOTE: The command will force reset iDRAC on both the servers. racresetc...
Page 112 - raid
iDRAC only options: • -f — Force resetcfg. If any VFlash partition creation or formatting is in progress when this command is issued, iDRAC sends back a warning message indicating the same. You can perform a force reset using this option. Example • Reset the configuration on iDRAC: racadm racresetcf...
Page 114 - remoteimage
The above command displays all fan keys connected to the enclosures referred as refkeys. racadm raid get fans --refkey < enclosure FQDDs separated by comma > -o optimized version. The above command displays all fan objects for the enclosure FQDD. racadm raid get fans --refkey < enclosure FQ...
Page 116 - serveraction
• Deploy a remote image on iDRAC NFS share for all the servers: racadm remoteimage -c -a -l '192.168.0.180:/dev/ floppy.img' -u root -p calvin serveraction Description Enables you to perform power management operations on the host system.To use this subcommand, you must have Execute Server Control C...
Page 117 - set
• Get Power Status on iDRACracadm serveraction powerstatusServer Power Status: ON • Reseat blade 2 on CMC$ racadm serveraction -m server-2 reseat -fServer power operation successful • Explanation of SupportiDRAC Needs to support graceful shutdownThe support of address individual blades is expected o...
Page 118 - setarraycfg
• -s — Power state of the host when the import operation completes. The parameters are "On" for powered ON and "Off" for powered OFF. If this parameter is not specified, power ON is taken as default. Output • Object value modified successfully • Failure message indicating reason for ...
Page 119 - setassettag
• —e — Enables to select existing or create new group for a member. The valid values are: – 0 — to create new group– 1 — to use existing group NOTE: If —e is 0, then admin password is mandatory. • <groupName> — Name of the group for administrative purpose. You can use up to 64 alphanumeric cha...
Page 120 - setchassisname; setflexaddr
Legal value: chassisYou can obtain the same output if you do not include this option, as there is only one legal value.< assettag> is a maximum of 64 non-extended ASCII characters. Example • racadm setassettag -m chassis 783839–33 • racadm setassettag 783839–33 The asset tag was changed succes...
Page 121 - setled
• racadm setflexaddr -f A 1 Fabric A FlexAddress state set successfully • racadm setflexaddr -f idrac 1 setled Description Sets the state (blinking or not blinking) of the LED on the specified module.To blink or unblink the chassis, I/O modules or the CMC, you must have Debug Administrator privilege...
Page 124 - setslotname; setsysinfo
setslotname Description Displays the name and hostname (if available) of all 16 slots, or of a specified slot (indicated by the slot number) in the chassis. Optionally, this command can be used to set whether the slot name or hostname is displayed in the CMC User Interface or with the getslotname -i...
Page 125 - sshpkauth
• -c — Sets the chassis name or location. Example racadm setsysinfo -c chassisname "Dell Rack System" The chassis name was set successfully. sshpkauth Description 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...
Page 126 - sslcertdownload
options. < key index> must be between 1 to 4 or all on iDRAC. • -t < PK Key Text> - Key text for the SSH Public key. • -f < filename> - File containing the key text to upload. The -f option is not supported on Telnet/ssh/serial RACADM. • -v - View the key text for the index provide...
Page 127 - sslcertupload
2 = CA certificate for Directory Service3 = Custom signing certificate Output Returns 0 when successful and a nonzero number when unsuccessful. Example racadm sslcertdownload -t 1 -f c:\cert \cert.txt NOTE: This command is not supported in the firmware racadm interface as is not a file system. sslce...
Page 128 - sslcertview
• Uploading a PKCS file without any passphrase: racadm sslcertupload –t 3 –f <filename> • Uploading a PKCS file with a passphrase: racadm sslcertupload –t 3 –f <filename> –p <passphrase> sslcertview Description Displays the SSL server or CA certificate that exists on iDRAC.To use t...
Page 129 - sslcertdelete
Organizational Unit (OU) Remote Access Group Common Name (CN) iDRAC Default certificate Common Name (CN) iDRAC Default certificate Valid From Jul 8 16:21:56 2005 GMT Valid To Jul 7 16:21:56 2010 GMT racadm sslcertview -t 1 -A00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certific...
Page 130 - sslcsrgen; sslkeyupload
sslcsrgen Description Generates and downloads a CSR file to the client’s local file system. The CSR can be used for creating a custom SSL certificate that can be used for SSL transactions on iDRAC.To use this subcommand, you must have Configure iDRAC permission. Synopsis racadm sslcsrgen [-g] [-f &l...
Page 131 - sslresetcfg; systemconfig
1 = SSL key used to generate the server certificate • -f — Specifies the file name of the SSL key to be uploaded. Output Returns 0 when successful and a nonzero number when unsuccessful. Example racadm sslkeyupload -t 1 -f c: \sslkey.txt sslresetcfg Description Restores the web-server certificate to...
Page 132 - testemail
• -l — Network share location, can be either CIFS or NFS. • -f — Image file name. • -u — Username for the remote share access. • -p — Password for the remote share access. • --vFlash — Choose vFlash SD as target location for Backup. <filename is not required for this target type. • --nopreserve —...
Page 133 - testfeature
• Enable the alert — racadm config -g cfgEmailAlert -o cfgEmailAlertEnable -i 1 • Set the destination e-mail address — racadm config -g cfgEmailAlert -o cfgEmailAlertAddress -i 1 [email protected] • Set the custom message that is sent to the destination e-mail address — racadm config -g cfgEmailAler...
Page 135 - testtrap
• Verifies that the CMC acquires a Kerberos TGT. • Acquires user privileges from the Active Directory server. • Checks the time to acquire user privileges with the allotted time to login. NOTE: In the event of an error, the command outputs all tests performed up to and including the test that failed...
Page 136 - testalert; traceroute; traceroute6
• View the current test trap settings racadm getconfig -g cfgIpmiPet -i < index > where < index> is a number from 1 to 4 testalert Description Tests FQDN supported SNMP trap notifications.To use this subcommand, you must have Test Alert User Access .This subcommand is applicable only for...
Page 138 - usercertview; vflashsd
To use this subcommand, you must have Configure iDRAC permission.This option is applicable only to iDRAC. Synopsis racadm usercertupload -t < type > [-f < filename >] -i < index > Input • -t — Specifies the type of certificate to upload, either the CA certificate or server certific...
Page 139 - vflashpartition
• racadm vflashsd status vflashpartition Description Manages the partitions on the vFlash SD card. NOTE: To use this subcommand, you must have the iDRAC7 Enterprise license. Synopsis racadm vflashpartition <create | delete | status | list> - i<index> -o<label> -e<emulation type&...
Page 140 - vmdisconnect
• Status of all existing partitions: racadm vflashpartition status -a • List all the existing partitions and its properties: racadm vflashpartition list vmdisconnect Description Allows you to disconnect another Virtual Media session. Once disconnected, the Web-based interface reflects the correct co...
Page 141 - Displayable Characters
3 iDRAC and CMC Property Database Group and Object Descriptions The iDRAC and CMC property database contains the configuration information for iDRAC and CMC. Data is organized by associated object, and objects are organized by object group. The IDs for the groups and objects that the property databa...
Page 143 - idRacInfo
idRacInfo This group contains display parameters to provide information about the specifics of iDRAC or CMC being queried. One instance of the group is allowed.For CMC, use this object with the getconfig subcommand.To use this object for CMC, you must have CMC Login User privilege.The following sect...
Page 151 - cfgStaticLanNetworking
cfgNicUseDhcp (Read/Write) Description Specifies whether DHCP is used to assign the iDRAC or CMC IPv4 address. If this property is set to 1 (TRUE), then iDRAC or CMC IPv4 address, subnet mask, and gateway are assigned from the DHCP server on the network. If this property is set to 0 (FALSE), the use...
Page 153 - cfgDNSStaticServersFromDHCP (Read or Write)
cfgNicStaticGateway (Read or Write) Description Returns or sets the static IPv4 address. Legal Values Any Valid IPv4 address Default 192.168.0.120 cfgDNSStaticServersFromDHCP (Read or Write) Description Specifies the DNS server static IP addresses. Legal Values • DNS Addresses are configured on the ...
Page 154 - cfgDNSStaticDomainNameFromDHCP (Read or Write); cfgRemoteHosts
NOTE: Microsoft Active Directory only supports Fully Qualified Domain Names (FQDN) of 64 characters or fewer length. Default Null cfgDNSStaticDomainNameFromDHCP (Read or Write) Description Specifies the device DNS static domain name. Legal Values • 0 — Do not use DHCP to get the Domain Name • 1 — Us...
Page 157 - cfgRhostsSyslogPowerLoggingEnabled
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 iDRAC: String from 0 to 63 characters. • For CMC: Valid hostname or...
Page 158 - cfgRhostsSyslogPowerLoggingInterval; cfgUserAdmin
cfgRhostsSyslogPowerLoggingInterval Description Specifies the power consumption collection/logging interval.This object is applicable only for CMC. NOTE: This object is applicable only for CMC. Legal Values 1 - 1440 (minutes) Default 5 Example racadm getconfig -g cfgRemoteHosts [-m server-< n >...
Page 163 - cfgEmailAlertEmailName; cfgSessionManagement
cfgEmailAlertAddress (Read/Write) Description Specifies the destination email address for email alerts, for example, [email protected]. Legal Values E-mail address format, with a maximum length of 64 ASCII characters. Default < blank> cfgEmailAlertCustomMsg (Read/Write) Description Specifies a...
Page 165 - cfgSerial
After the message is displayed, the system returns to the shell that generated the Secure Shell session. Legal Values • 0 (No timeout) • 60 – 10800 NOTE: If 0 (no timeout), the network connection does not send keep alive packets to probe the client. Otherwise, keep alive packets are sent to guarante...
Page 167 - cfgSerialConsoleColumns
Configuration options: The value must start with the ^ character, and be followed by one of the characters— a-z, A-Z, [, ], \ Legal value: String of up to 4 characters Default: • For iDRAC: < Ctrl><\> • For CMC: ^\ NOTE: For information on using RACADM commands for special characters, se...
Page 169 - cfgOobSnmp
cfgSerialTelnetEnable (Read/Write) Description Enables or disables the Telnet console interface on iDRAC or CMC. Legal Values • 1 (TRUE) • 0 (FALSE) Default 0 cfgOobSnmp This group contains parameters to configure the SNMP agent and trap capabilities of iDRAC or CMC. One instance of the group is all...
Page 170 - cfgTraps; cfgTrapsEnable
cfgTraps This group displays information for and configures delivery of SNMP traps for a specific user.This object property is applicable only to CMC. Use this object with the config or getconfig subcommands.To use this object property, you must have Chassis Configuration Administrator privilege. NO...
Page 171 - cfgRacTuning; cfgRacTuneCtrlEConfigDisable
cfgTrapsAlertDestIpAddr= cfgTrapsCommunityName=public cfgRacTuning This group is used to configure various iDRAC or CMC configuration properties, such as valid ports and security port restrictions.Use this object with the config or getconfig subcommands.To use this object property for CMC, you must ...
Page 180 - cfgServerInfo
Default 0 cfgServerInfo For iDRAC this group allows you to select the BIOS first boot device and provides the option to boot the selected device only once.For CMC, this group allows you to displays information for and configure a server in the chassis.Use this object with the config or getconfig sub...
Page 183 - cfgServerPowerBudgetAllocation (Read Only)
cfgServerPowerBudgetAllocation (Read Only) Description Displays the current power allocation for the server.This object is applicable only to CMC. Legal Values • 1 (Enable) • 0 (Disable) Default None cfgServerDNSRegisterIMC (Read/Write) Description Enables or disables DNS name registration for the I...
Page 185 - cfgActiveDirectory
# cfgServerBmcMacAddress=00:21:9B:FE:5F:58# cfgServerNic1MacAddress=00:0D:56:B8:69:63170 CMC Property Database Group and Object Definitions# cfgServerNic2MacAddress=00:0D:56:B8:69:65# cfgServerNic3MacAddress=00:0D:56:B8:69:CB# cfgServerNic4MacAddress=00:0D:56:B8:69:CDcfgServerPriority=1cfgServerNicE...
Page 187 - cfgADDomainController
• 0 (Disable) Default 0 cfgADSSOEnable (Read/Write) Description Enables or disables Active Directory single sign-on authentication on iDRAC. Legal Values • 1 (TRUE) • 0 (FALSE) Default 0 cfgADDomainController Description Specifies the AD server from which you want the CMC to obtain user names. Must ...
Page 191 - cfgLDAP
cfgADGcSRVLookupEnable (Read/Write) Description Determines how the global catalog server is looked up. If using pre ‑ configured global catalog servers, then iDRAC uses the values cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and cfgAdGlobalCatalog3.This object is applicable only to iDRAC. Legal Values ...
Page 195 - cfgLDAPSRVLookupDomainName; cfgLdapRoleGroup
This object is applicable only to CMC. Legal Values • 1 (true) • 0 (false) Default 0 cfgLDAPSRVLookupDomainName Description Configures the domain name to be used in the SRV lookup.This object is applicable only to CMC. Legal Values String of maximum length of 254 alphanumeric characters and hyphens....
Page 196 - cfgLocation
This object is applicable only for iDRAC. Legal Values An integer between 1 and 5 Default < instance> cfgLdapRoleGroupDN (Read/Write) Description This is the Domain Name of the group in this index.For CMC, configure the LDAP distinguished name (DN) for the role group instance. Legal Values Str...
Page 197 - cfgStandardSchema
Default 0 cfgLocationRack (Read/Write) Description Indicates rack where server is located. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationRackslot (Read/Write) Description Indicates slot where server is located. Legal Values Values from 1 - 255 (1 Byte) Default 0 cfgLocationD...
Page 198 - cfgChassisPower
Default < blank> cfgSSADRoleGroupDomain (Read/Write) Description Active Directory Domain in which the Role Group resides. Legal Values Any printable text string of up to 254 characters, with no white space. Default < blank> cfgSSADRoleGroupPrivilege (Read/Write) Description Use the bit m...
Page 199 - cfgChassisExternalPowerManagementMode
NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. The following sections provide information about the objects in the cfgChassisPower group. cfgChassisExternalPowerManagementMode Description Allows to enab...
Page 203 - cfgChassisInRedundancyReserve (Read Only)
cfgChassisMaxPowerConservationMode (Read/Write) Description Enables or disables maximum power conservation mode. When enabled, all servers are immediately reduced to their minimum power levels, and all subsequent server power allocation requests are denied. In this mode, performance of powered on se...
Page 205 - cfgSystemEnergyConsumptionClear (Write Only)
cfgChassisPowerButtonEnable (Read/Write) Description Indicates if the chassis power button is enabled or disabled. Legal Values • 0 (disabled) • 1 (enabled) Default None cfgSystemEnergyConsumptionClear (Write Only) Description Resets energy statistics when set to 1. Legal Values None Default None Ex...
Page 206 - cfgIpmiSol
cfgIpmiSol This group is applicable only for iDRAC and is used to configure the Serial Over LAN (SOL) capabilities of the system.The following sections provide information about the objects in the cfgIpmiSol group. cfgIpmiSolEnable (Read/Write) Description Enables or disables SOL. Legal Values • 1 (...
Page 207 - cfgIpmiLan
cfgIpmiSolSendThreshold (Read/Write) Description Specifies the SOL threshold limit value and the maximum number of bytes to buffer before sending an SOL data packet. Legal Values 1 – 255 Default 255 cfgIpmiLan This group is applicable only for iDRAC and is used to configure the IPMI over LAN capabil...
Page 208 - cfgIpmiPetIpv6; cfgIpmiPetIPv6AlertDestIpAddr
cfgIpmiLanEncryptionKey (Read/Write) Description Specifies the IPMI encryption key. Legal Values A string of hexadecimal digits from 0 to 40 characters with no spaces. Only an even amount of digits is allowed. Default 0000000000000000000000000000000000000000 cfgIpmiLanPetCommunityName (Read/Write) D...
Page 209 - cfgIpmiPef
cfgIpmiPef This group is applicable only for iDRAC and is used to configure the platform event filters available on the managed server.The event filters can be used to control policy related to actions that are triggered when critical events occur on the managed server.The following sections provide...
Page 211 - cfguserdomainname; cfgServerPower; cfgServerActualPowerConsumption (Read Only)
cfguserdomainname Description Specifies the Active Directory user domain name. Legal Values A string of up to 254 ASCII characters Default < blank> cfgServerPower This group provides several power management features.The following sections provide information about the objects in the cfgServer...
Page 213 - cfgServerPowerConsumptionClear (Write Only)
Default Maximum power consumption timestamp. cfgServerPowerConsumptionClear (Write Only) Description Clears the current recorded power statistics.This object is applicable only for iDRAC. Legal Values 1 — Clears the Power Consumption Statistics Default None cfgServerPowerCapWatts (Read/Write) Descri...
Page 220 - cfgKVMInfo; cfgKVMAccessToCMCEnable; cfgAlerting
cfgServerPowerPCIeAllocation (Read/Write) Description Amount of power allocated to the PCIe cards.This object is applicable for iDRAC Enterprise only for specific Blade Servers and not for iDRAC on Rack and Tower Servers or CMC.You must have Administrator privileges to modify the value for this obje...
Page 221 - cfgLcdLocale
Use this object with the config or getconfig subcommands.To use this object property, you must have Chassis Configuration Administrator privilege. cfgAlertingEnable Description Enables or disables event traps on the CMC. Legal Values • 1 (true) • 0 (false) Default None cfgAlertingFilterMask Descript...
Page 222 - cfgServerPowerSupply; cfgServerPowerSupplyIndex
cfgServerPowerSupply This group is applicable only for iDRAC and contains information related to the power supplies. The following sections provide information about the objects in the cfgServerPowerSupply group.The cfgServerPowerSupply object group is applicable only for iDRAC on Rack and Tower Ser...
Page 223 - cfgIPv6LanNetworking; cfgIPv6Address
cfgServerPowerSupplyFwVer (Read Only) Description Displays the firmware version of the power supply unit, in the format x.xx.xxx. Legal Values A string up to 8 characters. Default Null cfgServerPowerSupplyCurrentDraw (Read Only) Description Displays the instantaneous current consumption in 0.1 Amps....
Page 228 - cfgIpv6StaticLanNetworking
cfgIPv6DNSServer1 (Read/Write) Description Specifies the IPv6 DNS server address. NOTE: This property is used only if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). Legal Values A string representing a valid IPv6 entry. For example, 2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF Default :: cfgIPv6DNSServer...
Page 229 - cfgIPv6StaticPrefixLength (Read or Write)
cfgIPv6StaticEnable (Read or Write) Description Enables or disables the static IPv6 stack. Legal Values • 0 — Disabled • 1 — Enabled Default 0 — Disabled NOTE: If this object is modified, then the object cfgIPv6Enable is also modified. cfgIPv6StaticAddress1 (Read or Write) Description Returns or set...
Page 230 - cfgIPv6StaticDNSServersFromDHCP6 (Read or Write); cfgNicCurrentIpAddress
cfgIPv6StaticDNSServersFromDHCP6 (Read or Write) Description Specifies the DNS server static IP addresses. Legal Values • 0 — DNS Server should be configured as static. • 1 — The device will get the DNS servers from DHCPv6. Default 0— Disabled cfgIPv6StaticDNSServer1 (Read or Write) Description Spec...
Page 234 - cfgIPv6URL
cfgCurrentIPv6DNSServersFromDHCP6 Description Indicates whether the DNS server addresses are assigned from the DHCPv6 server. Legal ValuesDefault cfgCurrentIPv6DNSServer1 Description Displays the IPv6 address for DNS server 1. Legal ValuesDefault cfgCurrentIPv6DNSServer2 Description Displays the IPv...
Page 237 - cfgSmartCard
• 3 (< CR>) • 4 (< LF-CR>) • 5 (< LF>) Default 1 cfgIpmiSerialInputNewLineSequence (Read/Write) Description Specifies the input newline sequence specification for the IPMI serial interface. Legal Values • 1 (ENTER) • 2 (NULL) Default 1 cfgSmartCard This group specifies properties u...
Page 238 - cfgNetTuning; cfgNetTuningNicSpeed
cfgNetTuning This group enables users to configure the advanced network interface parameters for the RAC NIC or CMC. When configured, the updated settings may take up to a minute to become active.The following sections provide information about the objects in the cfgNetTuning group.This group is app...
Page 239 - cfgSensorRedundancy
cfgNetTuningNicFullDuplex (Read/Write) Description Specifies the duplex setting for the RAC or CMC NIC. This property is used only if the cfgNetTuningNicAutoNeg is set to 0 (disabled). Legal Values • 0 (Half Duplex) • 1 (Full Duplex) Default 1 cfgNetTuningNicMtu (Read/Write) Description The size in ...
Page 240 - cfgSensorRedundancyCapabilities (Read Only); cfgVFlashSD
cfgSensorRedundancyCapabilities (Read Only) Description Returns the redundancy capabilities in the form of a bitmask. This bitmask allows the user to know which values can be set for cfgSensorRedundancyPolicy. Legal Values A bit mask. More than 1-bit can be set at a time to indicate multiple redunda...
Page 242 - cfgVFlashPartition
• Unknown Default OK cfgVFlashSDWriteProtect (Read Only) Description Displays whether the physical write-protect latch on the vFlash SD card is enabled or disabled. Legal Values • 0 (vFlash is not write-protected) • 1 (vFlash is write-protected) Default None cfgVFlashPartition This group is used to ...
Page 243 - cfgVFlashPartitionFlashOSVolLabel; cfgLogging
cfgVFlashPartitionFlashOSVolLabel Description Displays the label for the partition that is visible to the operating system. Legal Values An alphanumeric string of up to six characters. Default None cfgVFlashPartitionFormatType (ReadOnly) Description Displays the format type of the partition. Legal V...
Page 244 - cfgRacSecurity
The following section provide information about the objects in the cfgLogging group: cfgLoggingSELOEMEventFilterEnable (Read/Write) Description Enables or disables the SEL Log filtering. Legal Values • 0 (Disable) • 1 (Enable) Default 0 cfgRacSecurity This group is used to configure settings related...
Page 247 - Database Objects With Get and Set Commands
4 Database Objects With Get and Set Commands This chapter provides the database groups and objects that must be used with the get or set subcommands. These are applicable only for iDRAC7 and are not applicable for CMC. When using these objects, they must begin with FQDD or FQDD alias. NOTE: • The ob...
Page 319 - BIOS.BiosBootSettings
Write Privilege Configure iDRAC License Required iDRAC7 Express or iDRAC7 Enterprise Dependency None BIOS.BiosBootSettings You can manage the BIOS boot settings using the objects in this group. BIOS.BiosBootSettings.BiosBootSeq (Read or Write) Description Determines the Bios boot sequence of the sys...
Page 320 - BIOS.IntegratedDevices
Dependency Read Only if BootMode is set to UEFI BIOS.BiosBootSettings.UefiBootSeq (Read or Write) Description UEFI boot sequence Legal Values None Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency Read Only if BootMode is set to BIOS BIOS.IntegratedDevice...
Page 350 - BIOS.SerialCommSettings
License Required iDRAC7 Express or iDRAC7 Enterprise Dependency None BIOS.SataSettings.SataPortH (Read or Write) Description Sets the drive type of the selected device. Legal Values • Off • Auto Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency Read Only ...
Page 356 - BIOS.SysProfileSettings
Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency None BIOS.SysProfileSettings Use the objects in this group to manage the system profile settings. BIOS.SysProfileSettings.MemFrequency (Read or Write) Description Set the speed of the system memory to maxi...
Page 365 - NIC.DeviceLevelConfig
• Unavailable Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency None NIC.DeviceLevelConfig Use the objects in this group to manage the device level configurations. NIC.DeviceLevelConfig.EVBModesSupport (Read Only) Description Indicates the type of EVB Mod...
Page 368 - NIC.FCoEConfiguration
• Unavailable Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency None NIC.FCoEConfiguration The following section provides information about the objects in the NIC.FCoEConfiguration group. NIC.FCoEConfiguration.ConnectFirstFCoETarget (Read or Write) Descri...
Page 377 - NIC.IscsiInitiatorParams
Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency Not Available if 'IscsiGenParams.IpVer' is set to 'IPv6' and 'VndrConfigGroup.iSCSIBootSupport' is Unavailable. NIC.IscsiGenParams.TcpTimestmp (Read or Write) Description Enables or disables use of TCP tim...
Page 379 - NIC.IscsiSecondaryDeviceParams
NIC.IscsiInitiatorParams.IscsiInitiatorPrimDns (Read or Write) Description Specifies the Primary DNS IP address of the iSCSI initiator. Legal Values String of 2 to 39 characters (Ipv4 or Ipv6 gateway) Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 Enterprise Dependency Not ...
Page 380 - NIC.IscsiSecondTgtParams
NIC.IscsiSecondaryDeviceParams.SecondaryDeviceMacAddr (Read or Write) Description Specifies the MAC address of a secondary iSCSI boot adapter for redundancy in case of boot failure. Legal Values String of up to 17 characters Write Privilege Server Control License Required iDRAC7 Express or iDRAC7 En...
Page 384 - NIC.NICPartitioningConfig
License Required iDRAC7 Express or iDRAC7 Enterprise Dependency None NIC.NICConfig.WakeOnLanLnkSpeed (Read or Write) Description Select the port speed used for Wake on LAN mode. Legal Values • AutoNeg • 10Mbps Half • 10Mbps Full • 100Mbps Half • 100Mbps Full Write Privilege Server Control License Re...