Reference Guide

ManualsBrandsDell ManualsActive System ManageriDRAC6 for Monolithic Servers Version 1.5

Integrated Dell Remote

Access Controller 6 (iDRAC6)

Administrator Reference

Guide

Summary of content (168 pages)

PAGE 1
Integrated Dell Remote Access Controller 6 (iDRAC6) Administrator Reference Guide
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. © 2010 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 . . . . . . . . . . . . . . . . . . . . . . . Supported RACADM Interfaces . . . . . . . . . . . . . Supported RACADM Subcommands. Other Documents You May Need 2 17 . . . . . . . . . . 18 . . . . . . . . . . . . 21 RACADM Subcommand Details . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 help . arp 17 . . . . . . . . . . . . . . . . . . . . . 24 closessn . . . . . . . . . . .
PAGE 4
getraclog . . . . . . . . . . . . . . . . . . . . . . . . . 37 getractime . . . . . . . . . . . . . . . . . . . . . . . . 38 . . . . . . . . . . . . . . . . . . . . . . . . . . 39 getsel . getssninfo . . . . . . . . . . . . . . . . . . . . . . . . 41 getsvctag . . . . . . . . . . . . . . . . . . . . . . . . . 42 getsysinfo . . . . . . . . . . . . . . . . . . . . . . . . . 43 . . . . . . . . . . . . . . . . . . . . . . . 47 . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 5
sslcertupload . . . . . . . . . . . . . . . . . . . . . . 61 . . . . . . . . . . . . . . . . . . . . . . . 62 . . . . . . . . . . . . . . . . . . . . . . . . 64 sslcertview. sslcsrgen . . . . . . . . . . . . . . . . . . . . . . . 65 . . . . . . . . . . . . . . . . . . . . . . . . 66 . . . . . . . . . . . . . . . . . . . . . . . . . 67 sslkeyupload . testemail . testtrap . traceroute . . . . . . . . . . . . . . . . . . . . . . . . traceroute6 . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 6
idRacBuildInfo (Read Only) . . . . . . . . . . . . . 80 . . . . . . . . . . . . . . 81 . . . . . . . . . . . . . . . 81 . . . . . . . . . . . . . . . . . . . 81 idRacName (Read Only) idRacType (Read Only) cfgLanNetworking . . . . . . . . . . . 81 . . . . . . . . . . . 82 cfgNicIPv4Enable (Read/Write). cfgNicSelection (Read/Write) cfgNicVLanEnable (Read/Write) cfgNicVLanId (Read/Write) . . . . . . . . . . . 83 . . . . . . . . . . . . 83 cfgNicVLanPriority (Read/Write) . . . . . . . . . .
PAGE 7
cfgUserAdmin . . . . . . . . . . . . . . . . . . . . . . cfgUserAdminIndex (Read Only) . . . . . . . . . . cfgUserAdminIpmiLanPrivilege (Read/Write) cfgUserAdminPrivilege (Read/Write) . . . 91 91 . . . . . . 92 . . . . . . . 93 . . . . . . . . 93 cfgUserAdminPassword (Write Only) cfgUserAdminSolEnable (Read/Write) . . . . . . . 93 . . . . . . . . . 93 . . . . . . . . . . . . . . . . . . . . . . 94 cfgUserAdminIpmiSerialPrivilege (Read/Write) . . . . . . . . . . .
PAGE 8
cfgSerialTelnetEnable (Read/Write) cfgOobSnmp . . . . . . . 100 . . . . . . . . . . . . . . . . . . . . . . 101 . . 101 . . . . . 101 . . . . . . . . . . . . . . . . . . . . . 101 cfgOobSnmpAgentCommunity (Read/Write) . cfgOobSnmpAgentEnable (Read/Write) cfgRacTuning . . . . . . 101 . . . . . . . 102 . . . . . . . . . 102 cfgRacTuneConRedirPort (Read/Write) cfgRacTuneRemoteRacadmEnable (Read/Write) . . . . . . . . . . . . cfgRacTuneCtrlEConfigDisable . cfgRacTuneHttpPort (Read/Write) . .
PAGE 9
ifcRacMnOsHostname (Read Only) . . . . . . . . 108 . . . . . . . . . 108 . . . . . . . . . . . . . . . . . . . . . 108 ifcRacMnOsOsName (Read Only) cfgRacSecurity. . . . . 108 . . . . . . . . . . . . . . . . . . . . 109 cfgRacSecCsrCommonName (Read/Write) cfgRacSecCsrOrganizationName (Read/Write) cfgRacSecCsrOrganizationUnit (Read/Write) . . . 109 . . . . 109 . . . . . . 109 cfgRacSecCsrLocalityName (Read/Write) .
PAGE 10
cfgADType (Read/Write) . . . . . . . . . . . . . . . . . . . . 117 cfgADGlobalCatalog2 (Read/Write) . . . . . . . . 117 cfgADGlobalCatalog3 (Read/Write) . . . . . . . . 118 cfgADCertValidationEnable (Read/Write) . . . . 118 cfgADDcSRVLookupEnable (Read/Write) . . . . 118 cfgADDcSRVLookupbyUserdomain (Read/Write) . . . . . . . . . . . . . . . . . . . 119 cfgADDcSRVLookupDomainName (Read/Write) . . . . . . . . . . . . . . . . . . . 119 cfgADGcSRVLookupEnable (Read/Write) . . . . 119 .
PAGE 11
cfgSSADRoleGroupPrivilege (Read/Write) . cfgIpmiSol . . . . 124 . . . . . . . . . . . . . . . . . . . . . . . . 125 cfgIpmiSolEnable (Read/Write). . . . . . . . . . . cfgIpmiSolBaudRate (Read/Write) . . . . . . . . . cfgIpmiSolMinPrivilege (Read/Write) . . . . . . . cfgIpmiSolAccumulateInterval (Read/Write) 126 126 . . . . . . 126 . . . . . . . . . . . . . . . . . . . . . . . 126 cfgIpmiLanEnable (Read/Write) . . . . . . . . . . cfgIpmiLanPrivLimit (Read/Write) . . . . . . . . .
PAGE 12
cfgServerPower . . . . . . . . . . . . . . . . . . . . cfgServerPowerStatus (Read Only) . . . . . . . cfgServerPowerAllocation (Read Only) cfgServerActualPowerConsumption (Read Only) . . . . . . . . . . . . . . 132 . . . . . . 132 . . . . . cfgServerMinPowerCapacity (Read Only) . . . . cfgServerMaxPowerCapacity (Read Only) . . . . . . . . 133 . 133 . . . . . . . 133 cfgServerPowerCapWatts (Read/Write) . . . . . 134 cfgServerPowerCapBtuhr (Read/Write) . . . . . 134 . . . 134 . . . .
PAGE 13
cfgServerPowerLastDayMaxTime (Read Only) . . . . . . . . . . . . . . . . . . . . . cfgServerPowerLastWeekMinPower (Read Only) . . . . . . . . . . . . . . cfgServerPowerLastWeekMinTime (Read Only) . . . . . . . . . . . . . . . . . . . . 138 . . . . . . . . 139 cfgServerPowerLastWeekMaxPower (Read Only) . . . . . . . . . . . . . . cfgServerPowerLastWeekMaxTime (Read Only) . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . .
PAGE 14
cfgServerPowerSupplyType cfgIPv6LanNetworking. . . . . . . . . . . . 146 . . . . . . . . . . . . . . . . 146 cfgIPv6Enable (Read/Write) . . . . . . . . . . . . . . . . . . . . . 146 cfgIPv6Gateway (Read/Write) . . . . . . . . . . 146 cfgIPv6PrefixLength (Read/Write) cfgIPv6AutoConfig (Read/Write) . . . . . . . . 147 . . . . . . . . . 147 cfgIPv6LinkLocalAddress (Read Only) . . . . . . 147 cfgIPv6Address2 (Read Only) . . . . . . . . . . . 147 cfgIPv6Address3 (Read Only) . . . . . . . .
PAGE 15
cfgIpmiSerialFlowControl (Read/Write) cfgIpmiSerialHandshakeControl (Read/Write) . . . . . . . . . . . . . . . . 152 . . . . . . . . . . 153 cfgIpmiSerialLineEdit (Read/Write) . . . . . . . . cfgIpmiSerialEchoControl (Read/Write) . . . . . . cfgIpmiSerialDeleteControl (Read/Write) cfgIpmiSerialNewLineSequence (Read/Write) . . . . . . . . . . . 153 . . . . . . . . . 154 . . . . . . 154 . . . . . . . . . . . . . . . . . . . . . . 155 . . . . . 155 . . . . . . 155 . . . . . . . . . . . . .
PAGE 16
cfgVFlashPartition . . . . . . . . . . . . . . . . . . . . . . . . . . 161 cfgVFlashPartitionSize (ReadOnly) . . . . . . . . 161 . . . . . . . . 162 cfgVFlashPartitionEmulationType (ReadOnly) . . . . . . . . . . . . cfgVFlashPartitionOSVolLabel (ReadOnly) . . . . cfgVFlashPartitionFormatType (ReadOnly) . 4 16 . . . 162 162 cfgVFlashPartitionAccessType (Read/Write) . . . 163 cfgVFlashPartitionAttachState (Read/Write) . . . 163 . . . . . 165 . . . . . . . . . . . . . . . . . . . . . .
PAGE 17
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 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).
PAGE 18
Table 1-1 provides the supported RACADM interfaces for iDRAC6 Enterprise and iDRAC6 Express. Table 1-1. Supported RACADM Interfaces iDRAC Type Local RACADM SSH/Telnet RACADM Remote RACADM iDRAC6 Enterprise iDRAC6 Express = Supported; = Not supported Supported RACADM Subcommands Table 1-2 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 23.
PAGE 19
Table 1-2.
PAGE 20
Table 1-2.
PAGE 21
Other Documents You May Need In addition to this guide, you can access the following guides available on the Dell Support website at support.dell.com/manuals. On the Manuals page, click SoftwareSystems Management. Click on the appropriate product link on the right-side to access the documents.
PAGE 22
Introduction
PAGE 23
RACADM Subcommand Details 2 This section provides detailed descriptions of the RACADM subcommands including the syntax and valid entries. CAUTION: The latest iDRAC6 1.5 and 3.0 firmware releases supports only the latest RACADM version. You may encounter errors if you use an older version of RACADM to query iDRAC6 with the latest firmware. Install the RACADM version shipped with the Dell Systems Management Tools and Documentation DVD Version 6.3.
PAGE 24
arp NOTE: To use this subcommand, you must have Administrator and Execute Diagnostic Commands permission. Subcommand Definition arp Displays the contents of the Address Resolution Protocol (ARP) table. ARP table entries cannot be added or deleted. Synopsis racadm arp Example IP Address HW Type Flags HW Address Mask Device 192.168.1.1 0x1 0x2 00:00:0C:07:AC:0F * eth0 clearasrscreen NOTE: To use this subcommand, you must have Clear Logs permission.
PAGE 25
closessn NOTE: To use this subcommand, you must have Administrator permission. Subcommand Definition closessn Closes a communication session on the device. Use getssninfo to view a list of sessions that can be closed using this command. Synopsis racadm closessn –i racadm closessn -a racadm closessn -u Options Table 2-1 describes the closessn subcommand options. Table 2-1.
PAGE 26
Examples: • racadm closessn -i 1234 Closes the session 1234. • racadm closessn –u root Closes all the sessions for root user. • racadm closessn –a Closes all the sessions. clrraclog NOTE: To use this subcommand, you must have Clear Logs permission. . Subcommand Definition clrraclog Removes all existing records from the iDRAC6 log. A new single record is created to record the date and time when the log was cleared.
PAGE 27
config NOTE: To use this subcommand, you must have Log In iDRAC permission. Subcommand Definition config Configures the iDRAC6. Synopsis racadm config [-c|-p] -f racadm config -g -o [-i ] Description The config subcommand allows you to set iDRAC6 configuration parameters individually or to batch them as part of a configuration file. If the data is different, that iDRAC6 object is written with the new value.
PAGE 28
Table 2-2. config Subcommand Options and Descriptions (continued) Option Description -p The -p, or password option, directs config to delete the password entries contained in the config file -f after the configuration is complete. -g The -g , or group option, must be used with the -o option. The specifies the group containing the object that is to be set. -o The -o , or object option, must be used with the -g option.
PAGE 29
Examples • racadm config -g cfgLanNetworking -o cfgNicIpAddress 10.35.10.100 Sets the cfgNicIpAddress configuration parameter (object) to the value 10.35.10.110. This IP address object is contained in the group cfgLanNetworking. • racadm config -f myrac.cfg Configures or reconfigures the iDRAC6. The myrac.cfg file may be created from the getconfig command. The myrac.cfg file may also be edited manually as long as the parsing rules are followed. NOTE: The myrac.cfg file does not contain passwords.
PAGE 30
If available, the coredump information is persistent across iDRAC6 power cycles and remains available until either of the following conditions occur: • The coredump information is cleared with the coredumpdelete subcommand. • Another critical condition occurs on the RAC. In this case, the coredump information is relative to the last critical error that occurred. See the coredumpdelete subcommand for more information about clearing the coredump.
PAGE 31
fwupdate NOTE: To use this subcommand, you must have Configure iDRAC6 permission. Before you begin your firmware update, see the Advanced iDRAC6 Configuration section in the iDRAC6 User’s Guide available on the Dell Support website at support.dell.com/manuals.
PAGE 32
Input Table 2-3 describes the fwupdate subcommand options. NOTE: The -p option is supported on local and remote RACADM and is not supported with the serial/Telnet/ssh console. The -p option is also not supported on Linux Operating Systems. Table 2-3. fwupdate Subcommand Options Option Description -u The update option performs a checksum of the firmware update file and starts the actual update process. This option may be used along with the -g or -p options.
PAGE 33
Examples • racadm fwupdate -g -u - a 143.166.154.143 -d In this example, the -g option tells the firmware to download the firmware update file from a location (specified by the -d option) on the TFTP server at a specific IP address (specified by the -a option). After the image file is downloaded from the TFTP server, the update process begins. When completed, iDRAC6 is reset. • racadm fwupdate -s This option reads the current status of the firmware update.
PAGE 34
Input Table 2-4 describes the getconfig subcommand options. Table 2-4. getconfig Subcommand Options Option Description -f The -f option directs getconfig to write the entire iDRAC6 configuration to a configuration file. This file can be used for batch configuration operations using the config subcommand. -g The -g , or group option, can be used to display the configuration for a single group. The groupName is the name for the group used in the racadm.cfg files.
PAGE 35
If errors are not encountered, this subcommand displays the contents of the specified configuration. Examples • racadm getconfig -g cfgLanNetworking Displays all of the configuration properties (objects) that are contained in the group cfgLanNetworking. • racadm getconfig -f myrac.cfg Saves all group configuration objects from the iDRAC6 to myrac.cfg. • racadm getconfig -h Displays a list of the available configuration groups on the iDRAC6 in an alphabetical order.
PAGE 36
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 37
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. getraclog NOTE: To use this subcommand, you must have Login to iDRAC permission. Command Definition getraclog -i Displays the number of entries in the iDRAC6 log.
PAGE 38
Table 2-5. getraclog Subcommand Options (continued) 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 39
Description With no options, the getractime subcommand displays the time in a common readable format. With the -d option, getractime displays the time in the format, yyyymmddhhmmss.mmmmmms, which is the same format returned by the UNIX date command. Output The getractime subcommand displays the output on one line. Sample Output racadm getractime Thu Dec 8 20:15:26 2005 racadm getractime -d 20051208201542.000000 getsel NOTE: To use this subcommand, you must have Login to iDRAC permission.
PAGE 40
NOTE: If no arguments are specified, the entire log is displayed. Table 2-6. getsel Subcommand Options Option Description -A Specifies output with no display headers or labels. -c Provides the number of records to be displayed. -o Displays each entry in the SEL in a single line. -s Specifies the starting record used for the display. -E Displays RAW SEL data with the other data for each entry. -R Displays only RAW SEL data for each entry. -i Displays the number of entries in the SEL.
PAGE 41
getssninfo NOTE: To use this subcommand, you must have Login to iDRAC permission. Subcommand Definition getssninfo Retrieves session information for one or more currently active or pending sessions from the Session Manager's session table. Synopsis racadm getssninfo [-A] [-u | *] Description The getssninfo subcommand returns a list of users that are connected to the iDRAC6.
PAGE 42
Examples • racadm getssninfo The following table provides an example of output from the getssninfo command. 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.
PAGE 43
getsysinfo NOTE: To use this subcommand, you must have Login to iDRAC permission. Command Definition getsysinfo Displays iDRAC6 information, system information, and watchdog status information. Synopsis racadm getsysinfo [-d] [-s] [-w] [-A] [-c] [-4] [-6] Description The getsysinfo subcommand displays information related to the iDRAC, managed system, and watchdog configuration.
PAGE 44
Output The getsysinfo subcommand displays information related to the RAC, managed system, and watchdog configuration. Sample Output RAC Information: RAC Date/Time = 10/27/2009 14:38:00 Firmware Version = 1.30 Firmware Build = 20 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.
PAGE 45
Enabled = 1 Current IP Address 1 = :: Current IP Gateway = :: Autoconfig = 1 Link Local IP Address = fe80::224:e8ff:fe2e:c5d3/255 Current IP Address 2 = :: Current IP Address 3 = :: Current IP Address 4 = :: 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 = :: Cur
PAGE 46
Power Status = ON Embedded NIC MAC Addresses: NIC1 Ethernet iSCSI NIC2 Ethernet iSCSI NIC3 Ethernet iSCSI NIC4 Ethernet iSCSI = 00:24:e8:2e:c5:cb = 00:24:e8:2e:c5:cc = 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.
PAGE 47
Server 2003 Power Status = OFF Watchdog Information: Recovery Action = None Present countdown value = 0 seconds Initial countdown value = 0 seconds 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.
PAGE 48
Table 2-9. gettracelog Subcommand options Option Description -i Displays the number of entries in iDRAC6 trace log. --more Displays one screen at a time and prompts the user to continue (similar to the UNIX more command). -o Displays each entry in a single line. -c Specifies the number of records to display. -s Specifies the starting record to display. -A Do not display headers or labels. Output The default output display shows the record number, timestamp, source, and description.
PAGE 49
Example $ racadm ifconfig eth0 Link encap:Ethernet HWaddr 00:1D:09:FF:DA:23 inet addr:10.35.155.136 Bcast:10.35.155.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:2550665 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:272532097 (259.9 MiB) TX bytes:0 (0.0 B) krbkeytabupload NOTE: To use this subcommand, you must have Configure iDRAC permission.
PAGE 50
Table 2-10. kerbkeytabupload Subcommand Options Option Description -f Specifies the file name of the keytab to be uploaded. If the file is not specified, the keytab file in the current directory is selected. The krbkeytabupload command returns 0 when successful and returns a non–zero number when unsuccessful. Example racadm krbkeytabupload -f c:\keytab\krbkeytab.tab localConRedirDisable NOTE: Only a local RACADM user can execute this command.
PAGE 51
ping NOTE: To use this subcommand, you must have Execute Diagnostic Commands or Configure iDRAC permission. Subcommand Definition ping Verifies that the destination IP address is reachable from the iDRAC6 with the current routing-table contents. A destination IP address is required. An ICMP echo packet is sent to the destination IP address based on the current routing-table contents.
PAGE 52
racdump NOTE: To use this subcommand, you must have Debug permission. Subcommand Definition racdump Displays status and general iDRAC6 information. Synopsis racadm racdump Description The racdump subcommand provides a single command to get dump, status, and general iDRAC6 board information.
PAGE 53
Description The racreset subcommand issues a reset to the iDRAC6. The reset event is written into the iDRAC6 log. NOTE: You must reboot your system after performing a hard reset of the iDRAC6 as described in Table 2-11. Table 2-11 describes the racreset subcommand options. Table 2-11. racreset Subcommand Options Option Description hard A hard reset performs a deep reset operation on the remote access controller.
PAGE 54
Description The racresetcfg command 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, the iDRAC6 resets automatically. NOTE: This command deletes your current iDRAC6 configuration and resets the iDRAC6 and serial configuration to the default settings. After reset, the default name and password is root and calvin, respectively, and the IP address is 192.
PAGE 55
Table 2-12 describes the remoteimage subcommand options. Table 2-12. 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. -l Image location on the network share; use double quotes around the location.
PAGE 56
Table 2-13. serveraction Subcommand Options String Definition 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 57
racadm setniccfg -s6 racadm setniccfg -o Description The setniccfg subcommand sets the iDRAC6 IP address. • The -d option enables DHCP for the NIC (default is DHCP disabled). • The -d6 option enables AutoConfig for the NIC. It is enabled by default. • The -s option enables static IP settings. The IPv4 address, netmask, and gateway can be specified. Otherwise, the existing static settings are used.
PAGE 58
Upload The upload mode allows you to upload a keyfile or to copy the key text on the command line. You cannot upload and copy a key at the same time. Local and Remote RACADM: racadm sshpkauth -i <2 to 16> -k <1 to 4> -f racadm sshpkauth -i <2 to 16> -k <1 to 4> -t Telnet/ssh/serial RACADM: racadm sshpkauth -i <2 to 16> -k <1 to 4> -t View The view mode allows the user to view a key specified by the user or all keys.
PAGE 59
Options Table 2-14. 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. must be between 1 to 4 or all on iDRAC6. -t Key text for the SSH Public key. -f File containing the key text to upload. The -f option is not supported on Telnet/ssh/serial RACADM.
PAGE 60
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 sslcertupload Downloads an SSL certificate from iDRAC6 to the client’s file system. Synopsis racadm sslcertdownload -t [-f ] Options Table 2-15 describes the sslcertdownload subcommand options. Table 2-15.
PAGE 61
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. Subcommand Description sslcertupload Uploads a custom SSL server or CA certificate for Directory Service from the client to the iDRAC6. Synopsis racadm sslcertupload -t [-f ] Options Table 2-16 describes the sslcertupload subcommand options.
PAGE 62
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 the iDRAC6. Synopsis racadm sslcertview -t [-A] Options Table 2-17 describes the sslcertview subcommand options. Table 2-17. sslcertview Subcommand Options Option Description -t Specifies the type of certificate to view, either the CA certificate or server certificate.
PAGE 63
Organizational Unit (OU) Common Name (CN) : 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 64
sslcsrgen NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description sslcsrgen Generates and downloads an SSL Certificate Signing Request (CSR) from iDRAC6. Synopsis racadm sslcsrgen [-g] [-f ] racadm sslcsrgen -s Description The sslcsrgen subcommand 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.
PAGE 65
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 cfgRacSecurity group. For example: racadm config -g cfgRacSecurity -o cfgRacSecCsrCommonName MyCompany NOTE: In telnet/ssh console, you can only generate and not download the CSR file Examples racadm sslcsrgen -s or racadm sslcsrgen -g -f c:\csr\csrtest.
PAGE 66
Table 2-19. sslkeyupload Subcommand Options Option Description -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.txt testemail Subcommand Description testemail Tests the RAC’s e-mail alerting feature. Synopsis racadm testemail -i Description Sends a test e-mail from the iDRAC6 to a specified destination.
PAGE 67
Table 2-20. testemail Configuration (continued) Action Command Set the destination e-mail address racadm config -g cfgEmailAlert -o cfgEmailAlertAddress -i 1 user1@mycompany.com Set the custom message that is sent to the destination e-mail address racadm config -g cfgEmailAlert -o cfgEmailAlertCustomMsg -i 1 "This is a test!" Ensure that the SMTP IP address is configured properly racadm config -g cfgRemoteHosts -o cfgRhostsSmtpServerIpAddr 192.168.0.
PAGE 68
Synopsis racadm testtrap -i Description The testtrap subcommand tests the RAC’s SNMP trap alerting feature by sending a test trap from the iDRAC6 to a specified destination trap listener on the network. 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 130. Table 2-22 provides a list and associated commands for the cfgIpmiPet group. Table 2-22.
PAGE 69
traceroute NOTE: To use this subcommand, you must have Administrator permission. Subcommand Definition 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 70
usercertupload NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description usercertupload Uploads a user certificate or a user CA certificate from the client to the iDRAC6. Synopsis racadm usercertupload -t [-f ] -i Options Table 2-24 describes the usercertupload subcommand options. Table 2-24.
PAGE 71
usercertview NOTE: To use this subcommand, you must have Configure iDRAC permission. Subcommand Description usercertview Displays the user certificate or user CA certificate that exists on the iDRAC6. Synopsis racadm sslcertview -t [-A] -i Options Table 2-25 describes the sslcertview subcommand options. Table 2-25. sslcertview Subcommand Options Option Description -t Specifies the type of certificate to view, either the user certificate or the user CA certificate.
PAGE 72
vflashsd NOTE: To use this subcommand, you must have Access Virtual Media privilege. Subcommand Description vflashsd Allows you to initialize or get the status of the vflash SD card. Synopsis racadm vflashsd initialize racadm vflashsd status Description The vflashsd subcommand 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 73
Options Table 2-26 describes the sslcertview subcommand options. Table 2-26. Option vflashpartition Subcommand Options Description -i Index of the partition for which this command applies. must be an integer from 1 to 16. NOTE: For the standard SD card, the index value is 1 because only one partition of size 256 MB is supported. Options valid only with create action -o Label that is displayed when the partition is mounted on the operating system.
PAGE 74
Description The vflashpartition subcommand allows you to perform the following: • Create an empty partition • Create a partition using an image file • Format a partition • View available partitions • Delete existing partitions • Get the status of partitions NOTE: Create partition using image file is not supported in local RACADM.
PAGE 75
• To display the emulation type: racadm getconfig –g cfgvflashpartition –I 1 –o cfgvflashpartitionemulatiotype • To display the label for the partition that is visible to the operating system: racadm getconfig –g cfgvflashpartition cfgvflashPartitionlabel • To display the format type of the partition: racadm getconfig –g cfgvflashpartition cfgvflashPartitionFormatType • –i 1 –o To change a read-only partition to read-write: racadm config –g cfgvflashpartition cfgvflashPartitionAccessType 1 • –i 1
PAGE 76
The vmdisconnect subcommand enables a iDRAC6 user to disconnect all active Virtual Media sessions. The active Virtual Media sessions can be displayed in the iDRAC6 Web-based interface or by using the RACADM subcommands such as remoteimage or getssninfo. vmkey NOTE: To use this subcommand, you must have Access Virtual Media permission. Subcommand Description vmkey Performs Virtual Media key-related operations.
PAGE 77
3 iDRAC6 Property Database Group and Object Definitions The iDRAC6 property database contains the configuration information for iDRAC6. Data is organized by associated object, and objects are organized by object group. The IDs for the groups and objects that the property database supports are listed in this section for iDRAC6 Enterprise on Blade Servers and iDRAC6 Enterprise or Express on Rack and Tower Servers. Use the group and object IDs with the RACADM subcommands to configure the iDRAC6.
PAGE 78
Table 3-1.
PAGE 79
Table 3-1.
PAGE 80
idRacInfo This group contains display parameters to provide information about the specifics of the iDRAC6 being queried. One instance of the group is allowed. The following sections provides information about the objects in the idRACInfo group. idRacProductInfo (Read Only) Description A text string that identifies the product. Legal Values A string of up to 63 ASCII characters. Default Integrated Dell Remote Access Controller.
PAGE 81
idRacName (Read Only) Description A user-assigned name to identify this controller. Legal Values A string of up to 15 ASCII characters. Default iDRAC idRacType (Read Only) Description Identifies the remote access controller type as iDRAC6. Legal Values Product ID Default For iDRAC6 on Rack and Servers: 10 For iDRAC6 Enterprise on Blade Servers: 8 cfgLanNetworking This group contains parameters to configure the iDRAC6 NIC. One instance of the group is allowed.
PAGE 82
cfgNicSelection (Read/Write) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. Description Specifies the current mode of operation for the RAC network interface controller (NIC). Table 3-2 describes the supported modes. Legal Values 0 = Shared 1 = Shared with Failover LOM2 2 = Dedicated 3 = Shared with Failover All LOMs (iDRAC6 Enterprise only) Default 0 (iDRAC6 Express) 2 (iDRAC6 Enterprise) Table 3-2.
PAGE 83
Table 3-2. cfgNicSelection Supported Modes (continued) Description (continued) Mode 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. The remote access device receives data through NIC 1 and NIC 2, but transmits data only through NIC 1. Failover occurs from NIC 2 to NIC 3 and then to NIC 4.
PAGE 84
cfgNicVLanPriority (Read/Write) Description Specifies the VLAN Priority 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 85
cfgDNSRacName (Read/Write) Description Displays the iDRAC6 name, which is rac-service tag by default. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE). Legal Values A string of up to 63 ASCII characters. At least one character must be alphabetic. NOTE: Some DNS servers only register names of 31 characters or fewer.
PAGE 86
cfgDNSServer2 (Read/Write) Description Retrieves the IPv4 address for DNS server 2. This parameter is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE). NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses. Legal Values String representing a valid IPv4 address. For example: 192.168.0.20. Default 0.0.0.0 cfgNicEnable (Read/Write) Description Enables or disables the iDRAC6 network interface controller.
PAGE 87
cfgNicNetmask (Read/Write) NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE). Description The subnet mask used for the iDRAC6 IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE). Legal Values String representing a valid subnet mask. For example: 255.255.255.0. Default 255.255.255.0 cfgNicGateway (Read/Write) NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE).
PAGE 88
cfgNicMacAddress (Read Only) Description The iDRAC6 NIC MAC address. Legal Values String representing the iDRAC6 NIC MAC address. Default The current MAC address of the iDRAC6 NIC. For example, 00:12:67:52:51:A3. cfgRemoteHosts This group provides properties that allow configuration of the SMTP server for e-mail alerts. The following sections provides information about the objects in the cfgRemoteHosts group.
PAGE 89
cfgRhostsFwUpdatePath (Read/Write) Description Specifies TFTP path where the iDRAC6 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. Default cfgRhostsSmtpServerIpAddr (Read/Write) Description The IPv4 or IPv6 address of the network SMTP server.
PAGE 90
cfgRhostsSyslogServer1 (Read/Write) Description Name of remote syslog server. This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values String from 0 to 511 characters. Default cfgRhostsSyslogServer2 (Read/Write) Description Name of remote syslog server. This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values String from 0 to 511 characters.
PAGE 91
cfgUserAdminIpmiLanPrivilege (Read/Write) 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. The value is represented as a bit mask that allows for any combination of privilege values.
PAGE 92
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 the iDRAC. 0x00000000 The user may only login to the 0x00000001 iDRAC and view iDRAC and server configuration information. The user may login to the iDRAC 0x00000001 + 0x00000002 = 0x00000003 and change configuration.
PAGE 93
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. Legal Values 1 (TRUE) 0 (FALSE) Default 1 (User 2) 0 (All others) cfgUserAdminSolEnable (Read/Write) Description Enables or disables Serial Over LAN (SOL) user access for the user.
PAGE 94
cfgEmailAlert This group contains parameters to configure the iDRAC6 e-mail alerting capabilities. Up to four instances of this group are allowed. The following sections provides information about the objects in the cfgEmailAlert group. cfgEmailAlertIndex (Read Only) Description The unique index of an alert instance. Legal Values 1-4 Default cfgEmailAlertEnable (Read/Write) Description Enables or disables the alert instance.
PAGE 95
cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to the iDRAC6. One instance of the group is allowed. The following sections provides information about the objects in the cfgSessionManagement group. cfgSsnMgtRacadmTimeout (Read/Write) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. Description Defines the idle timeout in seconds for the Remote RACADM interface.
PAGE 96
cfgSsnMgtWebserverTimeout (Read/Write) Description Defines the Web server 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. An expired Web server session logs out the current session.
PAGE 97
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 98
cfgSerial This group contains configuration parameters for the iDRAC6 services. One instance of the group is allowed. The following sections provides information about the objects in the cfgSerial group. NOTE: The cfgSerial object group is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. cfgSerialBaudRate (Read/Write) Description Sets the baud rate on the iDRAC6 serial port.
PAGE 99
cfgSerialConsoleQuitKey (Read/Write) Description This key or key combination terminates text Virtual Console when using the console com2 command.
PAGE 100
cfgSerialConsoleCommand (Read/Write) Description Specifies a serial command that is executed after a user logs into the serial console interface. Legal Values A string of up to 128 characters. Default cfgSerialHistorySize (Read/Write) Description Specifies the maximum size of the serial history buffer. Legal Values 0 – 8192 Default 8192 cfgSerialCom2RedirEnable (Read/Write) Description Enables or disables the console for COM 2 port redirection.
PAGE 101
cfgOobSnmp This group contains parameters to configure the SNMP agent and trap capabilities of the iDRAC6. One instance of the group is allowed. The following sections provides information about the objects in the cfgOobSnmp group. cfgOobSnmpAgentCommunity (Read/Write) Description Specifies the SNMP Community Name used for SNMP traps. Legal Values A string of up to 31 characters. Default public cfgOobSnmpAgentEnable (Read/Write) Description Enables or disables the SNMP agent in the iDRAC6.
PAGE 102
cfgRacTuneRemoteRacadmEnable (Read/Write) Description Enables or disables the Remote RACADM interface in the iDRAC. 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. Description Enables or disables the ability to disable the ability of the local user to configure the iDRAC from the BIOS POST option-ROM.
PAGE 103
cfgRacTuneIpRangeEnable (Read/Write) Description Enables or disables the IPv4 Address Range validation feature of the iDRAC6. Legal Values 1 (TRUE) 0 (FALSE) Default 0 cfgRacTuneIpRangeAddr (Read/Write) Description Specifies the acceptable IPv4 address bit pattern in positions determined by the "1"s in the range mask property (cfgRacTuneIpRangeMask). Legal Values An IPv4 address formatted string, for example, 192.168.0.44. Default 192.168.1.
PAGE 104
cfgRacTuneIpBlkFailCount (Read/Write) Description The maximum number of login failures to occur within the window (cfgRacTuneIpBlkFailWindow) before login attempts from the IP address are rejected. Legal Values 2 – 16 Default 5 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 105
cfgRacTuneConRedirEnable (Read/Write) Description Enables or disables Virtual Console. Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgRacTuneConRedirEncryptEnable (Read/Write) Description Encrypts the video in a Virtual Console session. Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgRacTuneAsrEnable (Read/Write) NOTE: This object requires an iDRAC6 reset before it becomes active. Description Enables or disables the iDRAC6 last crash screen capture feature.
PAGE 106
cfgRacTuneTimezoneOffset (Read/Write) Description Specifies the time zone offset (in minutes) from GMT/UTC to use for the RAC Time. Some common time zone offsets for time zones in the United States are: • –480 (PST—Pacific Standard Time) • –420 (MST—Mountain Standard Time) • –360 (CST—Central Standard Time) • –300 (EST—Eastern Standard Time) Legal Values –720 – 7800 Default 0 cfgRacTuneLocalServerVideo (Read/Write) Description Enables (switches on) or disables (switches off) the local server video.
PAGE 107
cfgRacTuneWebserverEnable (Read/Write) Description Enables or disables the iDRAC6 web server. If this property is disabled, the iDRAC6 will not be accessible using client web browsers. This property has no effect on the Telnet/SSH or RACADM interfaces. Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgRacTuneVirtualConsoleAuthorizeMultipleSessions (Read/Write) NOTE: To modify this property, you must have Configure iDRAC permission.
PAGE 108
ifcRacManagedNodeOs This group contains properties that describe the managed server operating system. One instance of the group is allowed. The following sections provides information about the objects in the ifcRacManagedNodeOs group. ifcRacMnOsHostname (Read Only) Description The host name of the managed server. Legal Values A string of up to 255 characters. Default ifcRacMnOsOsName (Read Only) Description The operating system name of the managed server.
PAGE 109
cfgRacSecCsrOrganizationName (Read/Write) Description Specifies the CSR Organization Name (O). Legal Values A string of up to 254 characters. Default cfgRacSecCsrOrganizationUnit (Read/Write) Description Specifies the CSR Organization Unit (OU). Legal Values A string of up to 254 characters. Default cfgRacSecCsrLocalityName (Read/Write) Description Specifies the CSR Loyalty (L). Legal Values A string of up to 254 characters.
PAGE 110
cfgRacSecCsrEmailAddr (Read/Write) Description Specifies the CSR email address. Legal Values A string of up to 254 characters. Default cfgRacSecCsrKeySize (Read/Write) Description Specifies the SSL asymmetric key size for the CSRs. Legal Values 1024 2048 Default 1024 cfgRacVirtual This group contains parameters to configure the iDRAC6 Virtual Media feature. One instance of the group is allowed. The following sections provides information about the objects in the cfgRacVirtual group.
PAGE 111
cfgVirMediaBootOnce (Read/Write) Description Enables or disables the Virtual Media Boot Once feature of the iDRAC6. If this property is enabled when the host server is rebooted, this feature will attempt to boot from the virtual media devices—if the appropriate media is installed in the device. Legal Values 1 (TRUE) 0 (FALSE) Default 0 cfgVirtualFloppyEmulation (Read/Write) NOTE: Virtual Media has to be reattached (using cfgRacVirMediaAttached) for this change to take effect.
PAGE 112
cfgVirMediaKeyEnable (Read/Write) Description Enables or disables the Virtual Media key feature of the RAC. NOTE: This command is deprecated from 1.5 and 3.0 releases onwards. The functionality of this command is now covered by cfgVFlashSDEnable. While execution of the cfgVirMediaKeyEnable command will be successful, it is recommended to use the cfgVFlashSDEnable command. For more information, see "cfgVFlashSDEnable (Read/Write)" on page 159.
PAGE 113
cfgLCDriveEnable (Read/Write) Description Enable/disable the USC-LCE device from showing up in the operating system. It must be disabled if your using ESXi operating system. Allows proper operation of operating system and drivers interfacing with the iDRAC/USC-LCE USB devices. Legal Values 1 (Enabled) 0 (Disabled) Default 1 cfgServerInfo This group allows you to select the BIOS first boot device and to boot the selected device only once.
PAGE 114
cfgServerFirstBootDevice (Read/Write) Description Sets or displays the first boot device. You can also set a vFlash partition that is attached as a bootable device. For more information, see "cfgVFlashPartitionOSVolLabel (ReadOnly)" on page 162. Legal Values No-Override PXE HDD DIAG CD-DVD BIOS vFDD VCD-DVD iSCSI VFLASH FDD SD Default No-Override cfgServerBootOnce (Read/Write) Description Enables or disables the server boot once feature.
PAGE 115
cfgActiveDirectory This group contains parameters to configure the iDRAC6 Active Directory feature. The following sections provides information about the objects in the cfgActiveDirectory group. cfgADRacDomain (Read/Write) Description Active Directory Domain in which the iDRAC6 resides. Legal Values Any printable text string of up to 254 characters, with no white space. Default cfgADRacName (Read/Write) Description Name of iDRAC6 as recorded in the Active Directory forest.
PAGE 116
cfgADSSOEnable (Read/Write) Description Enables or disables Active Directory single sign-on authentication on iDRAC6. Legal Values 1 (TRUE) 0 (FALSE) Default 0 cfgADDomainController1 (Read/Write) Description iDRAC6 uses the value you specify to search the LDAP server for user names. Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN).
PAGE 117
cfgADAuthTimeout (Read/Write) NOTE: To modify this property, you must have Configure iDRAC permission. Description Specifies the number of seconds to wait for Active Directory authentication requests to complete before timing out. Legal Values 15 – 300 seconds Default 120 cfgADType (Read/Write) Description Determines the schema type to use with Active Directory.
PAGE 118
cfgADGlobalCatalog3 (Read/Write) Description iDRAC6 uses the value you specify to search the Global Catalog server for user names. Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default No default value cfgADCertValidationEnable (Read/Write) Description Enables or disables Active Directory certificate validation as a part of the Active Directory configuration process.
PAGE 119
cfgADDcSRVLookupbyUserdomain (Read/Write) Description Chooses the way the user domain is looked up for Active Directory. Legal Values 1 (TRUE)—use user domain as the search domain to look up DCs. The user domain is chosen from the user domain list or entered by the login user. 0 (FALSE)—use the configured search domain cfgADDcSrvLookupDomainName to look up DCs.
PAGE 120
cfgLDAP This group allows you to configure settings related to the Lightweight Directory Access Protocol (LDAP). The following sections provides information about the objects in the cfgLDAP group. cfgLdapEnable (Read/Write) Description Turns LDAP service on or off. Legal Values 1 (TRUE)—Enable LDAP Services 0 (FALSE)—Disable LDAP Services Default 0 cfgLdapServer (Read/Write) Description Configures the address of the LDAP Server. Legal Values String.
PAGE 121
cfgLdapUserAttribute (Read/Write) Description Specifies the user attribute to search for. If not configured, the default is to use uid. It is recommended to be unique within the chosen baseDN, otherwise a search filter must be configured to ensure the uniqueness of the login user. If the user DN cannot be uniquely identified, login will fail with anerror. Legal Values String. Maximum length = 254 Default Null uid if not configured.
PAGE 122
cfgLdapBinddn (Read/Write) Description The distinguished name of a user used to bind to the server when searching for the login user's DN. If not provided, an anonymous bind is used. This is optional but is required if anonymous bind is not supported. Legal Values String. Maximum length = 254 Default Null cfgLdapBindpassword (Write only) Description A bind password to use in conjunction with the bind DN. The bind password is sensitive data, and should be properly protected.
PAGE 123
cfgLdapRoleGroup This group allows the user to configure role groups for LDAP. The following sections provides information about the objects in the cfgLdapRoleGroup group. cfgLdapRoleGroupIndex (Read Only) Description This is the index value of the Role Group Object. Legal Values An integer between 1 and 5 Default cfgLdapRoleGroupDN (Read/Write) Description This is the Domain Name of the group in this index. Legal Values String.
PAGE 124
cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings. The following sections provides information about the objects in the cfgStandardSchema group. cfgSSADRoleGroupIndex (Read Only) Description Index of the Role Group as recorded in the Active Directory. Legal Values An integer between 1 and 5 Default cfgSSADRoleGroupName (Read/Write) Description Name of the Role Group as recorded in the Active Directory forest.
PAGE 125
Table 3-5. Bit Masks for Role Group Privileges Role Group Privilege Bit Mask Login to iDRAC 0x00000001 Configure iDRAC 0x00000002 Configure Users 0x00000004 Clear Logs 0x00000008 Execute Server Control Commands 0x00000010 Access Virtual Console 0x00000020 Access Virtual Media 0x00000040 Test Alerts 0x00000080 Execute Debug Commands 0x00000100 cfgIpmiSol This group is used to configure the Serial Over LAN (SOL) capabilities of the system.
PAGE 126
cfgIpmiSolMinPrivilege (Read/Write) Description Specifies the minimum privilege level required for SOL access. Legal Values 2 (User) 3 (Operator) 4 (Administrator) Default 4 cfgIpmiSolAccumulateInterval (Read/Write) Description Specifies the typical amount of time that the iDRAC6 waits before transmitting a partial SOL character data packet. This value is 1based 5ms increments. Legal Values 1 – 255 Default 10 cfgIpmiSolSendThreshold (Read/Write) Description The SOL threshold limit value.
PAGE 127
cfgIpmiLanPrivLimit (Read/Write) Description Specifies the maximum privilege level allowed for IPMI over LAN access. Legal Values 2 (User) 3 (Operator) 4 (Administrator) Default 4 cfgIpmiLanAlertEnable (Read/Write) Description Enables or disables global e-mail alerting. This property overrides all individual e-mail alerting enable/disable properties. Legal Values 1 (TRUE) 0 (FALSE) Default 0 cfgIpmiEncryptionKey (Read/Write) Description The IPMI encryption key.
PAGE 128
cfgIpmiPetIpv6 This group is used to configure IPv6 platform event traps on the managed server. The following sections provides information about the objects in the cfgIpmiPetIpv6 group. cfgIpmiPetIPv6Index (Read Only) Description Unique identifier for the index corresponding to the trap. Legal Values 1–4 Default cfgIpmiPetIPv6AlertDestIpAddr Description Configures the IPv6 alert destination IP address for the trap.
PAGE 129
cfgIpmiPefName (Read Only) Description Specifies the name of the platform event filter. Legal Values A string of up to 255 characters Default The name of the index filter cfgIpmiPefIndex (Read/Write) Description Specifies the index of a specific platform event filter. Legal Values For iDRAC6 on Rack and Tower Servers: 1 – 22 For iDRAC6 Enterprise on Blade Servers: 1-9 Default The index value of a platform event filter object.
PAGE 130
cfgIpmiPet This group is used to configure platform event traps on the managed server. The following sections provides information about the objects in the cfgIpmiPet group. cfgIpmiPetIndex (Read Only) Description Unique identifier for the index corresponding to the trap. Legal Values 1-4 Default The index value of a specific platform event trap. cfgIpmiPetAlertDestIpAddr (Read/Write) Description Specifies the destination IPv4 address for the trap receiver on the network.
PAGE 131
cfgUserDomain This group is used to configure the Active Directory user domain names. A maximum of 40 domain names can be configured at any given time. The following sections provides information about the objects in the cfgUserDomain group. cfgUserDomainIndex (Read Only) Description Represents a specific domain. Legal Values 1 – 40 Default The index value cfgUserDomainName (Read Only) Description Specifies the Active Directory user domain name. Legal Values A string of up to 255 ASCII characters.
PAGE 132
cfgServerPowerAllocation (Read Only) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. Description Represents the available allocated power supply for server usage. NOTE: In case of more than one power supply, this object represents the minimum capacity power supply. Legal Values A string of up to 32 characters.
PAGE 133
cfgServerMaxPowerCapacity (Read Only) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. Description Represents the maximum server power capacity. Legal Values A string of up to 32 characters. Default cfgServerPeakPowerConsumption (Read Only) Description Represents the maximum power consumed by the server until the current time. Legal Values A string of up to 32 characters.
PAGE 134
cfgServerPowerCapWatts (Read/Write) Description Represents the server power threshold in Watts. Legal Values A string of up to 32 characters. Default Server power threshold in Watts. cfgServerPowerCapBtuhr (Read/Write) Description Represents the server power threshold in BTU/hr. Legal Values A string of up to 32 characters. Default Server power threshold in BTU/hr. cfgServerPowerCapPercent (Read/Write) Description Represents the server power threshold in percentage.
PAGE 135
cfgServerPowerLastDayAvg (Read Only) Description Displays the average power value during the last day. Legal Values A string of up to 32 characters. Default Average power value during the last day. cfgServerPowerLastWeekAvg (Read Only) Description Displays the average power value during the last week. Legal Values A string of up to 32 characters. Default Average power value during the last week.
PAGE 136
cfgServerPowerLastHourMaxPower (Read Only) Description Displays the maximum power value during the last hour. Legal Values A string of up to 32 characters. Default Maximum power value during the last hour. cfgServerPowerLastHourMaxTime (Read Only) Description Displays the timestamp of maximum power value during the last hour. Legal Values A string of up to 32 characters.
PAGE 137
cfgServerPowerLastDayMinTime (Read Only) Description Displays the timestamp of minimum power value during the last day. Legal Values A string of up to 32 characters. Time in the format: DD MM Date YYYY HH:MM:SS where, • DD = Day of the week • MM= Month • Date=Date • YYYY = Year • HH = hour • MM=Minutes • SS = Seconds Default Minimum power value during the last day. cfgServerPowerLastDayMaxPower (Read Only) Description Displays the maximum power value during the last day.
PAGE 138
cfgServerPowerLastDayMaxTime (Read Only) Description Displays the timestamp of maximum power value during the last day. Legal Values A string of up to 32 characters. Time in the format: DD MM Date YYYY HH:MM:SS where, • DD = Day of the week • MM= Month • Date=Date • YYYY = Year • HH = hour • MM=Minutes • SS = Seconds Default Maximum power value during the last day. cfgServerPowerLastWeekMinPower (Read Only) Description Displays the minimum power value during the last week.
PAGE 139
cfgServerPowerLastWeekMinTime (Read Only) Description Displays the timestamp of minimum power value during the last week. Legal Values A string of up to 32 characters. Time in the format: DD MM Date YYYY HH:MM:SS where, • DD = Day of the week • MM= Month • Date=Date • YYYY = Year • HH = hour • MM=Minutes • SS = Seconds Default Minimum power value during the last week cfgServerPowerLastWeekMaxPower (Read Only) Description Displays the maximum power value during the last week.
PAGE 140
cfgServerPowerLastWeekMaxTime (Read Only) Description Displays the timestamp of maximum power value during the last week. Legal Values A string of up to 32 characters. Time in the format: DD MM Date YYYY HH:MM:SS where, • DD = Day of the week • MM= Month • Date=Date • YYYY = Year • HH = hour • MM=Minutes • SS = Seconds Default Maximum power value during the last week.
PAGE 141
cfgServerPowerPeakHeadroom (Read Only) NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. Description Displays the difference between the available power and the peak power consumption. Legal Values A string of up to 32 characters. Default Difference between the available power and the peak power consumption. cfgServerActualAmperageConsumption (Read Only) Description Displays the current power consumption.
PAGE 142
cfgServerPeakAmperageTimeStamp (Read Only) Description Displays the timestamp of the current peak power consumption. Legal Values A string of up to 32 characters. Time in the format: DD MM Date YYYY HH:MM:SS where, • DD = Day of the week • MM= Month • Date=Date • YYYY = Year • HH = hour • MM=Minutes • SS = Seconds Default Timestamp of the current peak power consumption. cfgServerCumulativePowerConsumption (Read Only) Description Displays the cumulative power consumption.
PAGE 143
cfgServerCumulativePowerConsumptionTimeStamp (Read Only) Description Displays the timestamp of the cumulative power consumption. Legal Values A string of up to 32 characters. Time in the format: DD MM Date YYYY HH:MM:SS where, • DD = Day of the week • MM= Month • Date=Date • YYYY = Year • HH = hour • MM=Minutes • SS = Seconds Default Timestamp of the cumulative power consumption.
PAGE 144
cfgServerPowerPCIeAllocation (Read/Write) NOTE: This object is applicable for iDRAC6 Enterprise only for specific Blade Servers and not for iDRAC6 on Rack and Tower Servers. NOTE: You must have Administrator privileges to modify the value for this object. Description Amount of power allocated to the PCIe cards. Legal Values 0W: For platforms that do not support PCIe cards. 100W - 500W: For platforms that support PCIe cards. Default 0: For platforms that do not support PCIe cards.
PAGE 145
cfgServerPowerSupplyMaxInputPower (Read Only) Description Displays the AC input rated power in Watts. Legal Values A string of up to 32 characters. Default 0 cfgServerPowerSupplyMaxOutputPower (Read Only) Description Displays the AC output rated power in Watts. Legal Values A string of up to 32 characters. Default 0 cfgServerPowerSupplyOnlineStatus (Read Only) Description Displays the status of the power supply unit.
PAGE 146
cfgServerPowerSupplyType Description Displays whether the power supply is AC or DC. Legal Values A string of up to 32 characters. Default 0 cfgIPv6LanNetworking This group is used to configure the IPv6 over LAN networking capabilities. The following sections provides information about the objects in the cfgIPv6LanNetworking group. cfgIPv6Enable (Read/Write) Description Enables or disables the iDRAC6 IPv6 stack.
PAGE 147
cfgIPv6PrefixLength (Read/Write) Description The prefix length for iDRAC6 IPv6 address 1. Legal Values 1-128 Default 64 cfgIPv6AutoConfig (Read/Write) Description Enables or disables the IPv6 Auto Config option. Legal Values 1 (TRUE) 0 (FALSE) Default 0 cfgIPv6LinkLocalAddress (Read Only) Description The iDRAC6 IPv6 link local address. Legal Values A string representing a valid IPv6 entry. Default :: cfgIPv6Address2 (Read Only) Description An iDRAC6 IPv6 address.
PAGE 148
cfgIPv6Address4 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address5 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address6 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address7 (Read Only) Description iDRAC6 IPv6 address.
PAGE 149
cfgIPv6Address9 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address10 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address11 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address12 (Read Only) Description iDRAC6 IPv6 address.
PAGE 150
cfgIPv6Address14 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Address15 (Read Only) Description iDRAC6 IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6DNSServersFromDHCP6 (Read/Write) Description Specifies whether cfgIPv6DNSServer1 and cfgIPv6DNSServer2 are static or DHCP IPv6 addresses.
PAGE 151
cfgIPv6URL This group specifies properties used to configure the iDRAC6 IPv6 URL. The following sections provides information about the objects in the cfgIPv6URL group. cfgIPv6URLstring (Read Only) Description The iDRAC6 IPv6 URL. Legal Values A string of up to 80 characters. Default cfgIpmiSerial This group specifies properties used to configure the IPMI serial interface of the BMC.
PAGE 152
cfgIpmiSerialConnectionMode (Read/Write) Description When the iDRAC6 cfgSerialConsoleEnable property is set to 0 (disabled), the iDRAC6 serial port becomes the IPMI serial port. This property determines the IPMI defined mode of the serial port. In Basic mode, the port uses binary data with the intent of communicating with an application program on the serial client. In Terminal mode, the port assumes that a dumb ASCII terminal is connected and allows very simple commands to be entered.
PAGE 153
cfgIpmiSerialHandshakeControl (Read/Write) Description Enables or disables the IPMI terminal mode handshake control. Legal Values 0 (FALSE) 1 (TRUE) Default 1 cfgIpmiSerialLineEdit (Read/Write) Description Enables or disables line editing on the IPMI serial interface. Legal Values 0 (FALSE) 1 (TRUE) Default 1 cfgIpmiSerialEchoControl (Read/Write) Description Enables or disables echo control on the IPMI serial interface.
PAGE 154
cfgIpmiSerialNewLineSequence (Read/Write) Description Specifies the newline sequence specification for the IPMI serial interface. Legal Values 0 (None) 1 (CR-LF) 2 (NULL) 3 () 4 () 5 () Default 1 cfgIpmiSerialInputNewLineSequence (Read/Write) Description Specifies the input newline sequence specification for the IPMI serial interface.
PAGE 155
cfgSmartCard This group specifies properties used to support access to iDRAC6 using a smart card. The following sections provides information about the objects in the cfgSmartCard group. cfgSmartCardLogonEnable (Read/Write) Description Enables, disables, or enables with Remote RACADM support for access to iDRAC6 using a smart card. NOTE: Enabling with remote RACADM is only applicable for iDRAC6 on Rack and Tower Servers.
PAGE 156
cfgNetTuning This group enables users to configure the advanced network interface parameters for the RAC NIC. When configured, the updated settings may take up to a minute to become active. The following sections provides information about the objects in the cfgNetTuning group. NOTE: The cfgNetTuning object group is applicable only for iDRAC6 on Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers. CAUTION: Use extra precaution when modifying properties in this group.
PAGE 157
cfgNetTuningNicFullDuplex (Read/Write) Description Specifies the duplex setting for the RAC NIC. This property is not used if the cfgNetTuningNicAutoNeg is set to 1 (enabled). Legal Values 0 (Half Duplex) 1 (Full Duplex) Default 1 cfgNetTuningNicMtu (Read/Write) Description The size in bytes of the maximum transmission unit used by the iDRAC6 NIC. Legal Values 576 – 1500 Default 1500 cfgSensorRedundancy This group is used to set the power supply redundancy.
PAGE 158
cfgSensorRedundancyPolicy (Read/Write) Description Sets the power supply redundancy policy. Legal Values 2 - N/A, for sytems that are not supported 3 - Non Redundant 4 - 1+1 Redundant 4 - 2+1 Redundant 16 - 2+2 Redundant Default 0 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.
PAGE 159
cfgSensorRedundancyStatus (Read Only) Description Indicates the redundancy status. The status is N/A on platforms that does not support the power supply sensor redundancy. Legal Values String: • N/A • Full • Lost • Degraded Default No default value cfgVFlashSD This group is used to configure the properties for the vFlash SD card. The following sections provides information about the objects in the cfgVFlashSD group. cfgVFlashSDEnable (Read/Write) Description Enables or disables the vFlash SD card.
PAGE 160
cfgVFlashSDLicensed (Read Only) Description Displays whether a SD card or vFlash SD card is inserted. The vFlash SD card supports the new enhanced vFlash features and the SD card supports only the limited vFlash features. Legal Values 0 (SD card is inserted) 1 (vFlash SD card is inserted) Default No default value cfgVFlashSDAvailableSize (Read Only) Description Displays the available space (in MB) on the vFlash SD card that can be used to create new partitions.
PAGE 161
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 No default value cfgVFlashPartition This group is used to configure properties for individual partitions on the vFlash SD Card. Up to 16 partitions are supported, indexed from 1 to 16.
PAGE 162
cfgVFlashPartitionEmulationType (ReadOnly) Description Displays the emulation type for the partition. Legal Values String: • HDD • Floppy • CDROM Default No default value cfgVFlashPartitionOSVolLabel (ReadOnly) 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 No default value cfgVFlashPartitionFormatType (ReadOnly) Description Displays the format type of the partition.
PAGE 163
cfgVFlashPartitionAccessType (Read/Write) Description Indicates the partition access permissions. It configures the access type to read-write. Legal Values 0(Read-only) 1(Read-write) Default 0 cfgVFlashPartitionAttachState (Read/Write) Description Displays whether the partition is attached or detached.
PAGE 164
iDRAC6 Property Database Group and Object Definitions
PAGE 165
Deprecated Commands, Groups, and Objects 4 This section provides information about the deprecated RACADM subcommands, groups, and objects in the current release. Few commands, groups, or objects are deprecated in RACADM either due to a new command or object replacing the functionality of an existing command or object, or the feature is no longer supported. For the deprecated command or object: • If you run the racadm help command, the deprecated command is not displayed in the command list.
PAGE 166
• If you query a deprecated group or object, then the values are returned. • If you try to configure a deprecated group or object, the configuration succeeds. • If you request a group that contains a deprecated object, the deprecated object is not displayed in the results. Table 4-1 lists the RACADM subcommands deprecated in the current release. Table 4-1.
PAGE 167
Index C R community string, SNMP, 127 RACADM supported interfaces, 17 D Deprecated commands and objects, 165 P property database groups cfgActiveDirectory, 115 cfgEmailAlert, 94 cfgIpmiLan, 126 cfgIpmiPef, 128 cfgIpmiPet, 130 cfgIpmiSerial, 151, 155 cfgIpmiSol, 125 cfgLanNetworking, 81 cfgNetTuning, 156 cfgRacSecurity, 108 cfgRacTuning, 101 cfgRacVirtual, 110 cfgSerial, 98 cfgSessionManagement, 95 cfgUserAdmin, 90 idRacInfo, 80 ifcRacManagedNodesOs, 108 RACADM subcommands arp, 24 clearasrscreen, 24 cl
PAGE 168
sslcertupload, 61, 65 sslcertview, 62 sslcsrgen, 64 testemail, 66 testtrap, 67 traceroute, 69 traceroute6, 69 usercertupload, 70 userertview, 71 vmdisconnect, 75 vmkey, 76 S SNMP community string, 127 sslcertdownload, 60 U usercertupload, 70 168 Index