Reference Guide

ManualsBrandsDell ManualsActive System ManageriDRAC7 Version 1.20.20

RACADM Command Line Reference Guide for iDRAC7

1.20.20 and CMC 4.1

Summary of content (225 pages)

PAGE 1
RACADM Command Line Reference Guide for iDRAC7 1.20.20 and CMC 4.
PAGE 2
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2012 Dell Inc.
PAGE 3
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Introduction................................................................................................................................17 New In The Release................................................................................................................................................17 Downloading And Installing Supported RACADM Interfaces.........
PAGE 4
getflexaddr..............................................................................................................................................................46 getfanreqinfo..........................................................................................................................................................48 getioinfo.................................................................................................................................................................
PAGE 5
setled......................................................................................................................................................................92 setniccfg.................................................................................................................................................................92 setractime..........................................................................................................................................................
PAGE 6
cfgDNSRacName (Read/Write)......................................................................................................................117 cfgDNSRegisterRac (Read/Write)..................................................................................................................118 cfgDNSServersFromDHCP (Read/Write).......................................................................................................119 cfgDNSServer1 (Read/Write).................................................
PAGE 7
cfgEmailAlertEmailName...............................................................................................................................130 cfgSessionManagement.......................................................................................................................................130 cfgSsnMgtRacadmTimeout (Read/Write)......................................................................................................131 cfgSsnMgtConsRedirMaxSessions (Read/Write).................
PAGE 8
cfgRacTuneConRedirEnable (Read/Write).....................................................................................................142 cfgRacTuneConRedirEncryptEnable (Read/Write)........................................................................................142 cfgRacTuneAsrEnable (Read/Write)..............................................................................................................142 cfgRacTuneDaylightOffset (Read Only)....................................................
PAGE 9
cfgADRacName (Read/Write)........................................................................................................................153 cfgADRootDomain..........................................................................................................................................154 cfgADEnable (Read/Write).............................................................................................................................154 cfgADSCLEnable.......................................
PAGE 10
cfgLdapRoleGroupPrivilege (Read/Write)......................................................................................................164 cfgLocation...........................................................................................................................................................164 cfgLocationDatacenter (Read/Write).............................................................................................................164 cfgLocationAisle (Read/Write)......................
PAGE 11
cfgIpmiSol.............................................................................................................................................................173 cfgIpmiSolEnable (Read/Write)......................................................................................................................173 cfgIpmiSolBaudRate (Read/Write).................................................................................................................174 cfgIpmiSolMinPrivilege (Read/Write).......
PAGE 12
cfgServerPowerLastDayAvg (Read Only)......................................................................................................181 cfgServerPowerLastWeekAvg (Read Only)...................................................................................................181 cfgServerPowerLastHourMinPower (Read Only)..........................................................................................182 cfgServerPowerLastHourMinTime (Read Only).....................................................
PAGE 13
cfgIPv6Address1 (Read/Write).......................................................................................................................191 cfgIPv6Gateway (Read/Write)........................................................................................................................191 cfgIPv6PrefixLength (Read/Write).................................................................................................................192 cfgIPv6AutoConfig (Read/Write)...............................
PAGE 14
cfgCurrentIPv6DNSServer2...........................................................................................................................200 cfgIPv6URL............................................................................................................................................................200 cfgIPv6URLstring (Read Only)........................................................................................................................200 cfgIpmiSerial..........................
PAGE 15
cfgVFlashPartitionAttachState (Read/Write).................................................................................................209 cfgLogging............................................................................................................................................................209 cfgLoggingSELOEMEventFilterEnable (Read/Write)......................................................................................210 cfgRacSecurity.................................................
PAGE 16
System.Power.Cap.Percent (Read/Write)......................................................................................................219 System.Power.EnergyConsumption (Read Only)...........................................................................................219 System.Power.EnergyConsumption.Clear Write Only....................................................................................219 System.Power.Max.Headroom Write Only.............................................................
PAGE 17
Introduction 1 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 System (CMC) New In The Release The following are the new subcommands and groups added in this release: • inlettemphistory • testalert • iDRAC.SNMP.Alert • iDRAC.SNMP.Alert.[i].
PAGE 18
The RACADM utility supports the following interfaces: • Local — Supports executing RACADM commands from the managed server’s operating system. You must install the OpenManage software on the managed server to run local RACADM commands. Only one instance of Local RACADM can be executed on a system at a time. If the user tries to open another instance, an error message is displayed and the second instance of Local RACADM closes immediately. To download the local RACADM tool from support.dell.
PAGE 19
Example racadm -r -u -p getconfig -g idracinfo racadm -r -u -p getsysinfo RACADM Command Options Table 1‑1 lists the options for the RACADM command. Option Description -r -r racIpAddr : Specifies the controller’s remote IP address. Use: if the iDRAC port number is not the default port (443) -u Specifies the user name that is used to authenticate the command transaction.
PAGE 20
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC Telne Local Rem t/SS RAC ote H/ ADM RAC Seria AD l M Telne Local Remo t/SSH RACA te / DM RACA Seria DM l Telne t/SSH / Serial Remo te RACA DM "?" and "? " No No No No No No Yes Yes arp Yes Yes Yes Yes Yes Yes Yes Yes chassisaction No No No No No No Yes Yes clearasrscreen Yes Yes Yes Yes Yes Yes No No closessn Yes Yes Yes Yes Yes Yes Yes Yes clrsel Yes Yes Yes Yes Yes Y
PAGE 21
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC getpbinfo No No No No No No Yes Yes getpminfo No No No No No No Yes Yes getraclog Yes Yes Yes Yes Yes Yes Yes Yes getractime Yes Yes Yes Yes Yes Yes Yes Yes getredundancymode No No No No No No Yes Yes getsel Yes Yes Yes Yes Yes Yes Yes Yes getsensorinfo Yes Yes Yes Yes Yes Yes Yes Yes getslotname No No No No No No Yes Yes getssninfo Yes Yes Yes Yes Yes Yes
PAGE 22
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC setflexaddr No No No No No No Yes Yes setled Yes Yes Yes Yes Yes Yes Yes Yes setniccfg Yes Yes Yes Yes Yes Yes Yes Yes setractime No No No No No No Yes Yes setslotname No No No No No No Yes Yes setsysinfo No No No No No No Yes Yes sshpkauth Yes Yes Yes Yes Yes Yes Yes Yes sslcertdownload No Yes Yes No Yes Yes No Yes sslcertupload No Yes Yes No Yes Yes No Y
PAGE 23
• The Chassis Management Controller Online Help provides information about using the CMC Web interface. • The Chassis System (CMC) Secure Digital (SD) Card Technical Specification provides minimum BIOS and firmware version, installation and usage information. • The Dell OpenManage IT Assistant User’s Guide provides information about IT Assistant. • Documentation specific to your third-party management console application.
PAGE 24
PAGE 25
RACADM Subcommand Details 2 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 guidelines: Strings containing the following special characters must be quoted using single quotes or double quotes: • $ (dollar sign) • " (double quote) • ' (single quote) • ` (back quote) • \ (backslash)
PAGE 26
• A single quote cannot be used even with a backslash escaped. NOTE: An empty string may be specified as either "" (using double quotes) or '' (using single quotes). "?"and "?" Description Displays all the subcommands you can use with the RACADM command and a one-line description of each subcommand. ? followed by displays the syntax for the specified command. To use this subcommand, you must have CMC Login User privilege.
PAGE 27
-d -c -A -4 -6 : : : : : show CMC information show chassis information do not show headers or labels show CMC IPv4 information show CMC IPv6 information help and help subcommand Description Synopsis Input Output Lists all the subcommands available to use with RACADM and provides a short description for each. You may also type a subcommand, group, object, or FQDD alias after help, to get the syntax for the specified keyword.
PAGE 28
Output IP Address HW Type Flags HW Address Mask Device 192.168.1.1 0x1 0x2 00:00:0C:07:AC:0F * eth0 chassisaction Description Executes a power action on the chassis, iKVM, or a server. To use this subcommand, you must have Chassis Control Administrator privilege Synopsis racadm chassisaction [-m ] Input • -m — Module on which you want to carry out the action. Values are: — chassis - this is the default value if -m is not specified.
PAGE 29
Input None Output None Example None 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 Input • • • racadm closessn –i racadm closessn -a racadm closessn -u • -i — The session ID of the session to close, which can be retrieved using racadm getssninfo subcommand.
PAGE 30
cmcchangeover Description Changes the state of the CMC from active to standby, or vice versa, in a redundant CMC configuration. This subcommand is useful for remote debugging or testing purposes. 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.
PAGE 31
• Output -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 only. This subcommand generates error output for any of the following reasons: Examples • • Invalid syntax, group name, object name, index, or other invalid database members. RACADM CLI failures.
PAGE 32
This option is applicable only for iDRAC. To use this subcommand, you must have Execute Debug Commands permission See the coredumpdelete subcommand for more information about clearing the coredump. Synopsis racadm coredump Input None Output None Example • racadm coredump No Core Dump Data is currently available.
PAGE 33
To use this subcommand, you must have Server Administrator privilege. NOTE: You can also use setniccfg to configure static IP address, subnet mask, and gateway, as well as DHCP, speed, and duplex properties.
PAGE 34
• ERROR: Server in slot 9 is an extension of the server in slot 1. racadm deploy -m server-7 -u root -p calvin -s -6 ::/64 :: 10 eventfilters Description Gets, sets, and displays the list of event filter settings. To use this subcommand with the get option, you must have Administrator privilege. This subcommand is applicable only for iDRAC.
PAGE 35
• • -n - The notification to be sent when the event occurs. Valid values are all, snmp, ipmi, lcd, email, or none. You can append multiple notifications separated by a comma. You cannot enter the values all or none with other notifications. -r - Event generation interval. This is applicable only to the temperature statistics subcategory - tmps. You can use this option as a stand-alone or with -n and -a.
PAGE 36
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 activated on a chassis, any other features that may be included on that Dell Feature Card cannot be activated on a different chassis.
PAGE 37
Output • • • • • Example 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 following feature(s) FlexAddress: The feature card is bound to this chassis — Action: No action required. No features active on the chassis — Action: Install the SD card into the CMC.
PAGE 38
at any time. In addition, the fwupdate subcommand may only update one or more devices of a single kind at a time. To use this subcommand for CMC you must have Chassis Configuration Administrator privilege and for iDRAC you must have Configure iDRAC permission. NOTE: Running the fwupdate subcommand to update the firmware on the active CMC resets itself causing all network connections to be dropped.
PAGE 39
Input • • -u — For iDRAC: 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. At the end of the update, iDRAC performs a soft reset. For CMC: Performs the firmware update operation. -s— For iDRAC: The status option returns the current status of where you are in the update process. This option is always used by itself. Lists active SD card features and SD card status.
PAGE 40
CMC version 3.00 accepts IPv4, IPv6, or fully qualified domain names (FQDN) for both FTP and TFTP servers. NOTE: You can specify the cmc-active and cmc-standby modules at the same time along with one or more server-n modules. This enables the devices to be updated together. This option is applicable only for CMC. When you use the server-generation option, the CMC updates all iDRACs of that particular generation that can be updated.
PAGE 41
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 RACADM - FTP Yes Yes No Remote RACADM Yes Yes Yes Remote RACADM-TFTP Yes Yes Yes Remote RACADM-FTP Yes Yes Yes Firmware RACADM-TFTP Yes Yes Yes Firmware RACADM-FTP Yes Yes Yes get Description Synopsis Input Allows the user to read the value of configuration objects on the iDRAC.
PAGE 42
Examples Get system LCD information: racadm get system.lcd LCDUserString=test getassettag Description Displays the asset tag for the chassis. To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getassettag [-m ] Input -m — Specifies the module whose asset tag you want to view. Legal value: chassis Example • • racadm getassettag -m chassis racadm getassettag chassis 78373839–33 getchassisname Description Displays the name of the chassis.
PAGE 43
• • • • • • Output 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. If the group is an indexed group, use the -i option. -h — The -h, or help option, displays a list of all available configuration groups in alphabetical order. This option is useful when you do not remember exact group names.
PAGE 44
Displays the user group instance at index 2 with verbose information for the property values. getdcinfo Description Displays general I/O module and daughter card configuration information. Only the CMC controls daughtercards. To use this subcommand, you must have CMC Login User privilege. NOTE: Fabric verification for server DCs is performed only when the chassis is powered on.
PAGE 45
server-5 Not Present None N/A None N/A server-6 Not Present None N/A None N/A server-7 Not Present None N/A None N/A server-8 Present FibreChannel Invalid 4 None N/A server-9 Extension(1) None N/A None N/A server-10 Not Present None N/A None N/A server-11 Not Present None N/A None N/A server-12 Not Present None N/A None N/A server-13 Not Present None N/A None N/A server-14 Not Presen
PAGE 46
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, you must have CMC Login User privilege. NOTE: If FlexAddress is not activated on the chassis, the command displays server-assigned MAC/WWN addresses. If the slot is empty, the command leaves the server-assigned MAC/WWN addresses blank.
PAGE 47
11 Enabled Not Present 12 Enabled Not Present 13 Enabled Extension(5) 14 Enabled Not Present 15 Enabled Not Present 16 Enabled Not Present idrac System Disabled Display the current flex address setting for slot 1.
PAGE 48
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.
PAGE 49
14 SLOT-14 PowerEdgeM60 ON 0 Present 33 15 SLOT-15 N/A N/A Not Present N/A 16 SLOT-16 N/A Extension(8) N/A N/A Switch Module Fan Request Table 1 SLOT-01 PowerEdgeM60 ON 0 Present 33 2 SLOT-02 PowerEdgeM90 ON 5 Present 35 3 SLOT-03 PowerEdgeM71 ON 0 Present 44 4 SLOT-04 PowerEdgeM61 ON 0 Present 46 5 SLOT-05 PowerEdgeM61 ON 0 Present 46 6 SLOT-06 Not Present N/A 7 SLOT-07 PowerEdgeM
PAGE 50
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 Not Present N/A Switch-6 N/A None Not Present N/A getioinfo Description Displays general information about the I/O modules on the chassis. To use this subcommand, you must have CMC Login User privilege.
PAGE 51
getkvminfo Description Displays iKVM module information. To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getkvminfo Example racadm getkvminfo KVM Present Avocent iKVM Switch 00.05.00.04 Ready getled Description Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots). To use this subcommand, you must have Login User privilege.
PAGE 52
getmacaddress Description Synopsis Input Displays the MAC/WWN addresses for all modules or for a specified module. To use this subcommand, you must have CMC Login User privilege. • • racadm getmacaddress [-m ] [-t iscsi] [-x] racadm getmacaddress [-a] • -m — Specifies the module whose MAC address you want to view.
PAGE 53
00:11:43:FD:B7: 00:11:43:FD:B7: 2C 2D racadm getmacaddress CMC Present N/A 00:1E:4F:1F:3C: N/A 58 Server-1 Present 00:1E:4F:2A:AF: 00:1E:4F: 7B 2A:D3:97 00:1E:4F: 2A:D3:99 Server-2 Present 00:22:19:D2:1E: N/A 84 N/A Server-3 Not Present N/A N/A N/A Server-4 Present 00:18:8B:FF: 45:2A 00:18:8B:FF:AA: 00:18:8B:FF:AA: 02 04 Server-5 Present 00:19:B9:FF:FE: 00:19:B9:FF:FC: 00:19:B9:FF:FC: E2 0C 0E Server-6 Pr
PAGE 54
Switch-3 Present N/A 00:00:00:00:00: N/A 00 Switch-4 Present N/A 00:00:00:00:00: N/A 00 Switch-5 Present N/A 00:05:1E:08:EB: N/A 0B Switch-6 Not Present N/A N/A N/A Display Ethernet and iSCSI MACS of all LOMs/mezzanine cards.
PAGE 55
Server-4-B Gigabit Ethernet Not Present Not Installed Not Installed iSCSI Present Not Installed Not Installed Server-4-C Fibre Channel 4 Present Not Installed Not Installed Server-5-A Gigabit Ethernet Present 00:19:B9:FF: 00:19:B9:FF: 00:19:B9:FF: FE:E2 FC:0C FC:0E iSCSI Present 00:19:B9:FF: 00:19:B9:FF: FC:0D FC:0F Gigabit Ethernet Present Not Installed Not Installed iSCSI Present Not Installed Not Installed Server-5-C Fibre Channel 4 Present Not Installed Not Installed Se
PAGE 56
Server-13-A Gigabit Ethernet Present 00:18:8B:FF: 00:18:8B:FF: 00:18:8B:FF: 45:26 A9:F2 A9:F4 iSCSI Present 00:18:8B:FF: 00:18:8B:FF: A9:F3 A9:F5 Gigabit Ethernet Present 00:1D: 09:71:E0:78 00:1D: 09:71:E0:7A iSCSI Present 00:1D: 09:71:E0:79 00:1D: 09:71:E0:7B Server-13-C Fibre Channel 4 Present 21:00:00:1B: 21:01:00:1B: 32:0E:EF:30 32:2E:EF:30 Server-14-A Gigabit Ethernet Present 00:22:19:D2: N/A 1E:A2 N/A iSCSI Present N/A N/A Gigabit Ethernet Present Not Installed Not Insta
PAGE 57
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 use this subcommand, you must have CMC Login User privilege. NOTE: The service tag field is blank for modules that do not have service tags.
PAGE 58
Switch-2 Switch-3 Switch-4 Switch-5 Switch-6 Server-1 Server-2 Server-3 Server-4 Server-5 Server-6 Server-7 Server-8 Server-9 Server-10 Server-11 Server-12 Server-13 Server-14 Server-15 Server-16 KVM IO-Cable FPC-Cable Not Present Not Present Not Present Not Present Not Present Not Present Present Present Present Present Present Present Not Present Not Present Extension(2) Not Present Present Not Present Present Present Present Present Present Present N/A N/A N/A N/A N/A N/A OFF ON ON ON ON ON N/A N/A N/A
PAGE 59
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 60
getpbinfo Description Displays power budget status information. To use this subcommand, you must have CMC Login User privilege.
PAGE 61
9 10 11 12 13 14 15 16 SLOT-09 SLOT-10 SLOT-11 SLOT-12 SLOT-13 SLOT-14 SLOT-15 SLOT-16 N/A Extension(2) N/A ON N/A ON ON ON N/A N/A N/A 125 N/A 342 140 125 W W W W 5 5 5 5 5 5 5 5 N/A N/A N/A PowerEdgeM600 N/A N/A N/A getpminfo Description Displays power management status information. To use this subcommand, you must have CMC Login User privilege.
PAGE 62
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 Available for Allocation = 0 W Standby Input Power Capacity = 0 W getraclog Description The getraclog command displays RAC log entries.
PAGE 63
getractime Description Displays the current iDRAC time. Synopsis Input • • racadm getractime [-d] racadm getractime [-d] [-z] [-n] • • • -d — Displays the time in the format, yyyymmddhhmmss.mmmmmms. -z — Displays timezone. This option is specific to CMC only. -n — Displays NTP peer information. This option is specific to CMC only. NOTE: If no options are provided, the getractime subcommand displays the time in a common readable format.
PAGE 64
• • • • • -s — Specifies the starting record used for the display. -E — Displays RAW SEL data with the other data for each entry. -R — Displays only RAW SEL data for each entry. -i — Displays the number of entries in the SEL. --more — Displays one screen at a time and prompts the user to continue (similar to the UNIX more command.) NOTE: For CMC: the -A, -E, -o, and -R options are deprecated. Output Record: 12 Date/Time: 11/20/2011 14:19:34 Source: system Severity: Ok Description: C: boot completed.
PAGE 65
Temp 1 Ambient_Temp OK 22 PWR 1 PS-1 Online OK PWR 2 PS-2 Online OK PWR 3 PS-3 Online OK PWR 4 PS-4 Slot Empty PWR 5 PS-5 Failed PWR 6 PS-6 celcius N/A 40 N/A OK Slot Empty N/A Cable 1 IO-Cable OK Cable 2 FPC-Cable OK getslotname Description Displays the name and hostname (if available) of all 16 slots, or of a specified slot (indicated by the slot number) in
PAGE 66
8 9 10 11 12 13 14 15 16 SLOT-08 SLOT-09 SLOT-10 SLOT-11 SLOT-12 SLOT-13 SLOT-14 SLOT-15 SLOT-16 racadm getslotname -i 1 Webserver-1 getssninfo Description Displays a list of users that are connected to iDRAC.
PAGE 67
Input getsvctag Output Y76TP0G 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: 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.
PAGE 68
Current DNS Server 2 DNS Servers from DHCP = 163.244.180.
PAGE 69
"Microsoft Windows 2000 version 5.0, Build Number 2195, Service Pack 2" "ON" • racadm getsysinfo -w -s System Information: System Model System Revision System BIOS Version BMC Firmware Version Service Tag Host Name OS Name Power Status = = = = = = = = Watchdog Information: Recovery Action Present countdown value Initial countdown value = None = 0 seconds = 0 seconds PowerEdge 2900 I 0.2.3 0.
PAGE 70
This option is applicable only for iDRAC. Synopsis racadm getuscversion Example $ racadm getuscversion 1.2.3.4 getversion Description Synopsis Input Displays the current software version, model and generation information, and whether or not the target device can be updated. To use this subcommand, you must have CMC Login User privilege.
PAGE 71
server-2 1.50 PowerEdgeM600 iDRAC Y server-3 2.10 PowerEdgeM610 iDRAC Y server-4 1.50 PowerEdgeM605 iDRAC Y cmc-1 2.10.X06.200906 080825 Y racadm getversion -c server-1 PowerEdgeM600 server-2 PowerEdgeM805 server-5 1.0.0 PowerEdgeM710 server-1 2.0.0 PowerEdgeM605 server-2 1.1.0 PowerEdgeM805 server-5 1.
PAGE 72
Broadcom 5709 Emb(nic-1) 5.2.0 2011-02-02 PERC6 EMB (raid-2) 07.01.34.00 2011-02-02 BIOS 0.1.7 Rollback BIOS 1.2.1 Reinstall iDRAC 3.20 Reinstall PERC6 Emb (raid-2) 07.01.33.00 Rollback PERC6 Emb (raid-2) 07.01.33.00 Reinstall racadm getversion -l -m server-1 -f bios server-1 BIOS 1.2.
PAGE 73
Subdevice ID: Perm ISCSI MAC Address: Slot Type: Data Bus Width: Slot Length: Perm FCoE MAC Address: PCI Bus: PCI Device: PCI Function: Update Time: Sync Time: Product Name: Permanent MAC Address: WWPN: Family Version: Controller BIOS Version: EFI Version: Max Bandwidth: Min Bandwidth: Current Commit Index: FCoE WWNN: Vendor Name: Ports Count: Number PCIE Functions Supported: Number PCIE Functions Enabled: Link Duplex: Link Speed: Auto Negotiation: Transmit Flow Control: Receive Flow Control: Media Type: St
PAGE 74
Example $ racadm ifconfig eth0 Link encap:Ethernet HWaddr 00:1D:09:FF:DA:23 inet addr:10.35.155.136 Mask:255.255.255.0 Metric:1 overruns:0 frame:0 carrier:0 Bcast:10.35.155.255 UP BROADCAST RUNNING MULTICAST MTU:1500 RX packets:2550665 errors:0 dropped:0 TX packets:0 errors:0 dropped:0 overruns:0 collisions:0 txqueuelen:1000 (0.0 B) RX bytes:272532097 (259.9 MiB) TX bytes:0 inlettemphistory Description Synopsis Input Exports the inlet temperature history data file.
PAGE 75
Example • Export the log to a remote CIFS share: racadm inlettemphistory export -f Mylog.xml -u admin p mypass -l //1.2.3.4/share -t xml • Export the log to local file system using Local RACADM: racadm inlettemphistory export -f Mylog.xml -t xml • Export the log to management station using Remote RACADM: racadm -r 1.2.3.4 -u user -p pass inlettemphistory export -f Mylog.csv -t csv • View the inlet temperature history: racadm inlettemphistory get Duration Above Warning Threshold as Percentage = 0.
PAGE 76
lclog Description Allows the user to export the lifecycle log history, and view the lifecycle log for a particular device or category. To use this subcommand, you must have Configure iDRAC permission. This subcommand is applicable for iDRAC only. NOTE: On Local RACADM, when you run this command, the data is exposed to RACADM as a USB partition. This may display a pop up. Synopsis Input racadm lclog view -i -a -c -s -b -q
PAGE 77
• • • • • • • -d - Specifies the path to the file on the FTP server. -l - Specifies the location of the network share or area on file system where lifecycle log is exported. Two types of network shares are supported: — SMB mounted path: //// — NFS mounted path: :/. -u — Specifies the user name for accessing the FTP Server, or Domain and User Name for accessing network share location.
PAGE 78
• Display all the available records from the active Life Cycle Log: racadm lclog view license Description Synopsis Input Manages hardware licenses. This subcommand is applicable for iDRAC only.
PAGE 79
NOTE: Only a user with Administrator privileges can use the import, export, delete, and replace commands. You do not need Administrator privileges to use the view command. Examples • View All License Information on System $racadm license view iDRAC.Embedded.1 Status = OK Device = iDRAC.Embedded.
PAGE 80
• Export license to a NFS share using transaction ID, in this case transaction 27 : racadm license export -f License.xml -l 192.168.2.140:/licshare -t 27 • 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, more than one license file may be exported.
PAGE 81
Examples • Displays the statistics for the NIC FQDD. $racadm nicstatistics • 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 statistics $ racadm nicstatistics NIC.Slot.5-2-1 : QLogic CNA Gigabit Ethernet-B8:AC:6F:B3:BF:10 NIC.Slot.
PAGE 82
Example racadm iping6 10.9.72.254 IPING6 10.9.72.254 (10.9.72.254): 56 data bytes 64 bytes from 10.9.72.254: icmp_seq=0 ttl=121 time=2.9 ms --- 10.9.72.254 ping statistics --1 packets transmitted, 1 packets received, 0 percent packet loss round-trip min/avg/max = 2.9/2.9/2.9 ms racdump Description Provides a single command to get dump, status, and general iDRAC board information.
PAGE 83
Example Example racadm racdump =============================================================================== General System/RAC Information =============================================================================== CMC Information: CMC Date/Time Active CMC Version Standby CMC Version Last Firmware Update Hardware Version Current IP Address Current IP Gateway Current IP Netmask DHCP Enabled MAC Address Current DNS Server 1 Current DNS Server 2 DNS Servers from DHCP Register DNS CMC Name DNS CMC Name C
PAGE 84
Temp 1 PWR 1 PWR 2 PWR 3 PWR 4 PWR 5 PWR 6 Ambient_Temp PS-1 PS-2 PS-3 PS-4 PS-5 PS-6 OK 21 celcius N/A 40 Online OK Online OK Online OK Slot Empty N/A Failed OK Slot Empty N/A racreset Description Issues a reset to iDRAC. The reset event is written into iDRAC log. To use this subcommand for CMC you must have Chassis Administrator privilege and for iDRAC you must have Configure iDRAC permission.
PAGE 85
Deletes your current iDRAC configuration and resets iDRAC 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.168.0.120. Only for iDRAC Enterprise on Blade servers, it is IP address plus the number of the slot the server inhabits in the chassis. If you issue racresetcfg from a network client (for example, a supported Web browser, Telnet/ssh, or remote RACADM), you must use the default IP address.
PAGE 86
To use this subcommand for CMC you must have Chassis Administartor privilege and for iDRAC you must have Configure iDRAC permission. Synopsis racadm raid Example • Monitor Health of Storage root node racadm raid get status Storage Root Node Status : Ok The above command retrieves the controllers keys, (FQDDs.
PAGE 87
The above command displays all enclosure objects for the connector FQDD. racadm raid get enclosures --refkey -o -p The above command is an optimized and filtered version.
PAGE 88
• Monitor and Inventory all Power Supply Units connected to the enclosure racadm raid get psus --refkey The above command displays all power supply units connected to the enclosures being mentioned as refkeys. racadm raid get psus --refkey -o The above command is an optimized version and displays all power supply units objects for the enclosure FQDD.
PAGE 89
• Deploy a remote image to server 1 from the CMC racadm remoteimage -c –m server-1 -u root -p calvin l '//192.168.0.180/dev/floppy.img' serveraction Description Enables users to perform power management operations on the host system. To use this subcommand, you must have Execute Server Control Commands permission. Synopsis racadm serveraction Input • • • • -m server-nx where n=1-8 ; x = a,b,c,d -a - Performs action on all servers. Not allowed with the powerstatus action.
PAGE 90
• • racadm serveraction powerstatus Server Power Status: ON Reseat blade 2 on CMC $ racadm serveraction -m server-2 reseat -f Server power operation successful Explanation of Support iDRAC Needs to support graceful shutdown The support of address individual blades is expected on the CMC set Description Synopsis Input Output Example Allows the user to set the value of configuration objects on a device. To use this subcommand, you must have Configure privilege.
PAGE 91
You can obtain the same output if you do not include this option, as there is only one legal value. is a maximum of 64 non-extended ASCII characters. Example • racadm setassettag -m chassis 783839–33 • racadm setassettag 783839–33 The asset tag was changed successfully. setchassisname Description Sets the name of the chassis in the LCD. To use this subcommand, you must have Administrator privilege.
PAGE 92
• 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 on CMC. To enable the servers to blink or unblink, you must have Server Administrator or Debug Administrator privilege on CMC. To use this subcommand for iDRAC, you must have Configure iDRAC permission.
PAGE 93
NOTE: The terms NIC and Ethernet management port may be used interchangeably. Synopsis Input • racadm setniccfg -d • racadm setniccfg -d6 • racadm setniccfg -s • racadm setniccfg -s6 • racadm setniccfg -o • • • -d — Enables DHCP for the NIC (default is DHCP disabled.) -d6 — Enables AutoConfig for the NIC. It is enabled by default. -s — Enables static IP settings.
PAGE 94
— s is a + (plus) sign or a - (minus) sign, which indicates the sign of the offset — off is the offset in minutes NOTE: The off is the offset in minutes from GMT and must be in 15-minute increments. The timezone is represented as an offset from GMT, and the clock does not automatically adjust to daylight savings time (for '-d' option). • -z - Sets the time zone by name or index, or lists possible time zones. For example, PST8PDT (Western United States), 294 (Seoul), 344 (Sydney).
PAGE 95
command. If the hostname is not available, the static slot name is used. To use this subcommand, you must have Administrator privilege. For rules for selecting slot names, see the "Editing Slot Names" section in the Dell Chassis Management Controller User Guide . NOTE: The OMSA server agent must be present and running on the server to use the Display Hostname feature. If the agent is not running, the setting is ignored.
PAGE 96
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 delete keys. This command has three mutually exclusive modes— upload, view, and delete that are determined by the options. Upload The upload mode allows you to upload a keyfile or to copy the key text on the command line. You cannot upload and copy a key at the same time.
PAGE 97
• -d - Delete the key for the index provided. Examples Upload an invalid key to iDRAC User 2 in the first key space using a string: $ racadm sshpkauth -i 2 -k 1 -t "This is invalid key Text" ERROR: Key text appears to be corrupt Upload a valid key to iDRAC User 2 in the first key space using a file: $ racadm sshpkauth -i 2 -k 1 -f pkkey.key Key file successfully uploaded.
PAGE 98
sslcertupload Description Uploads a custom SSL server or CA certificate for Directory Service from the client to iDRAC. To use this subcommand, you must have Configure iDRAC permission. Synopsis racadm sslcertupload -t [-f ] Input • • • • -t — Specifies the type of certificate to upload, either the CA certificate for Directory Service or the server certificate.
PAGE 99
Serial Number 00 Subject Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) iDRAC Default certificate Issuer Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc.
PAGE 100
racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate Jul 8 16:21:56 2005 GMT Jul 7 16:21:56 2010 GMT 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.
PAGE 101
The sslcsrgen -s subcommand returns one of the following status codes: • • Example CSR was generated successfully. CSR does not exist. racadm sslcsrgen -s or racadm sslcsrgen -g -f c:\csr \csrtest.txt 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.
PAGE 102
testemail Description Sends a test e-mail from iDRAC to a specified destination. Prior to executing the test email command, make sure that the SMTP server is configured and the specified index in the RACADM cfgEmailAlert group is enabled and configured properly. See cfgEmailAlert for more information. Synopsis racadm testemail -i Input -i — Specifies the index of the e-mail alert to test.
PAGE 103
Option Description -f Specifies the feature name. testfeature supports the following features: • • • ad — Tests Active Directory configuration using simple authentication (user name and password) adkrb — Tests Active Directory configuration using Kerberos authentication ldap — Tests LDAP configuration and operation (requires user name and password) -u The user name specified in an appropriate format for the selected authentication method.
PAGE 104
• • The last three digits are the user's permissions. testfeature –f adkrb –u user_name@domain_name SUCCESSFUL: User permissions are 80000fff testfeature -f ldap -u harold -p barrel SUCCESSFUL: User permissions are 0x00000fff testfeature -f adkrb Description Tests the Active Directory configuration using Kerberos authentication (single sign-on or Smart Card login). Use the optional -d switch to obtain additional diagnostic information, as needed.
PAGE 105
Description Tests LDAP configuration and operation, and reports success as each stage of the authentication process proceeds. On successful completion, this command prints the CMC privileges assumed by the specified . If a failure occurs, the command terminates with an error message that displays the required corrective action. Use the optional -d switch to obtain additional diagnostic information, as needed.
PAGE 106
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 iDRAC. Synopsis racadm testalert -i Input -i — Specifies the index of the trap test. index must be an integer from 1 to 8 on iDRAC. Output Success: Test trap sent successfully Failure: Unable to send test trap Example • Test a trap with index as 1 racadm testalert -i 1 Test trap sent successfully.
PAGE 107
Output traceroute to fd01::1 (fd01::1) from fd01::3, 30 hops max, 16 byte packets 1 fd01::1 (fd01::1) 14.324 ms 0.26 ms 0.244 ms usercertupload Description Uploads a user certificate or a user CA certificate from the client to iDRAC. To use this subcommand, you must have Configure iDRAC permission. This option is applicable only to iDRAC.
PAGE 108
• -I — Index number of the user. Valid values are 1-16. version Description Displays the RACADM version information. This option is applicable only for iDRAC. Synopsis racadm version vflashsd Description 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. To use this subcommand, you must have Access Virtual Media privilege.
PAGE 109
Option Description -i < index > 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 > Label that is displayed when the partition is mounted on the operating system. must be a string up to six alphanumeric characters. -e Emulation type for the partition.
PAGE 110
NOTE: The image file name extension is case sensitive. If the file name extension is in upper case, for example FOO.ISO instead of FOO.iso, then the command returns a syntax error.
PAGE 111
iDRAC and CMC Property Database Group and Object Descriptions 3 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 database supports are listed in this section for iDRAC Enterprise on Blade Servers, iDRAC Enterprise or Express on Rack and Tower Servers and CMC.
PAGE 112
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC ifcRacManagedNodeOs Yes Yes No cfgRacSecurity No No Yes cfgRacVirtual Yes Yes No cfgServerInfo No Yes Yes cfgActiveDirectory Yes Yes Yes cfgLDAP Yes Yes Yes cfgLdapRoleGroup Yes Yes Yes cfgStandardSchema Yes Yes Yes cfgChassisPower No No Yes cfgIpmiSol Yes Yes No cfgIpmiLan Yes Yes No cfgIpmiPetIpv6 Yes Yes No cfgIpmiPef Yes Yes No cfgIpmiPet Yes Yes No cfgUserDomain Yes Yes N
PAGE 113
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 sections provide information about the objects in the idRACInfo group. idRacProductInfo (Read Only) Description A text string that identifies the product. Legal Values A string of up to 63 ASCII characters.
PAGE 114
Default for CMC CMC iDRAC Type (Read Only) Description Identifies the remote access controller type.
PAGE 115
cfgNicIPv4Enable (Read/Write) Description Enables or disables iDRAC or CMC IPv4 stack. Legal Values • • Default 1 (TRUE) 0 (FALSE) 0 cfgNicSelection Read or Write Description Specifies the current mode of operation for the RAC network interface controller (NIC). The table below describes the supported modes. This object is applicable only for iDRAC on Rack and Tower Servers and not for iDRAC Enterprise on Blade Servers or CMC.
PAGE 116
NOTE: For iDRAC Enterprise on Blade Servers, this object enables or disables the VLAN capabilities of iDRAC from CMC. This is Read only for iDRAC on Blade servers. iDRAC displays only the current VLAN settings and you cannot modify the settings from iDRAC. All chassis management traffic, including the CMC and all iDRACs, resides on this external VLAN when enabled. No iDRAC configuration change is required to use this external management network VLAN.
PAGE 117
cfgDNSDomainNameFromDHCP (Read/Write) Description Specifies that iDRAC or CMC DNS domain name should be assigned from the network DHCP server. Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 For CMC, this property is used only if cfgNicUseDhcp is set to 1 (true), or if both cfgIPv6Enable and cfgIPv6AutoConfig are set to 1 (true).
PAGE 118
Default For iDRAC: idrac- For CMC: cmc- cfgDNSRegisterRac (Read/Write) Description Registers the iDRAC or CMC name on the DNS server. When you set this parameter, the CMC registers its DNS name for its IPv4 and IPv6 addresses with the DNS server. Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 NOTE: For IPv6, only the DHCPv6 address or static address is registered. Example: racadm getconfig -g cfgLanNetworking cfgNicEnable=1 cfgNicIPv4Enable=1 cfgNicIpAddress=192.168.22.
PAGE 119
cfgDNSServersFromDHCP (Read/Write) Description Specifies if the DNS server IPv4 addresses should be assigned from the DHCP server on the network. For CMC, this property is used only if cfgNicUseDhcp is set to 1 (true). Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 cfgDNSServer1 (Read/Write) Description Specifies the IPv4 address for DNS server 1. This property is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE).
PAGE 120
cfgNicIpAddress (Read/Write) Description Specifies the static IPv4 address to be assigned to the RAC or CMC. NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0(FALSE.) Legal Values String representing a valid IPv4 address. For example: 192.168.0.20. Default • • • For iDRAC on Rack and Tower Servers: 192.168.0.120 For iDRAC Enterprise on Blade Servers: 192.168.0.n, where n is 120 plus the server slot number. For CMC: 192.168.0.
PAGE 121
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 user can configure the cfgNicIpAddress, cfgNicNetmask, and cfgNicGateway properties.
PAGE 122
cfgRhostsFwUpdateIpAddr (Read/Write) Description Specifies the network TFTP server IPv4 or IPv6 address that is used for TFTP iDRAC or CMC firmware update operations. Legal Values A string representing a valid IPv4 or IPv6 address. For example, 192.168.0.61 Default For IPv4, it is 0.0.0.0 cfgRhostsFwUpdatePath (Read/Write) Description Specifies TFTP path where iDRAC or CMC firmware image file exists on the TFTP server. The TFTP path is relative to the TFTP root path on the TFTP server.
PAGE 123
This object is applicable only for CMC. Legal Values A string representing a valid NTP server. For example, ntp1.ntp.net. At least one NTP server must be specified and duplicate entries are not allowed. Default Null cfgRhostsNtpServer2 Description Specifies the second of three possible NTP servers. This object is applicable only for CMC. Legal Values A string representing a valid NTP server. For example, ntp2.ntp.net. At least one NTP server must be specified and duplicate entries are not allowed.
PAGE 124
cfgRhostsSyslogPort (Read/Write) Description Remote syslog port number to use for writing the RAC and SEL logs to a remote syslog server. For CMC, this setting takes effect only if the cfgRhostsSyslogEnable parameter is set to 1 (enabled). Legal Values 10 — 65535 NOTE: For CMC, the following port numbers are reserved and cannot be used: 21, 68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
PAGE 125
cfgRhostsSyslogPowerLoggingEnabled Description Enables or disables power consumption logging to remote syslog servers. This object is applicable only for CMC. NOTE: Remote syslog must be enabled and one or more remote syslog servers must be configured for power consumption to be logged. Legal Values • • Default 1 (enabled) 0 (disabled) 0 cfgRhostsSyslogPowerLoggingInterval Description Specifies the power consumption collection/logging interval. This object is applicable only for CMC.
PAGE 126
NOTE: In the current CMC firmware version, the objects cfgUserAdminEnable and cfgUserAdminPrivilege are interrelated; changing the value of one property causes the value of the other property to change. For example, if a user does not have login privilege, the user is disabled by default. When you enable the user by changing the value of UserAdminEnable to 1, the right most digit of the UserAdminPrivilege also becomes 1.
PAGE 127
Default 0x00000000 Example racadm getconfig -g cfgUserAdmin -i 1 # cfgUserAdminIndex=1 cfgUserAdminEnable=1 cfgUserAdminUserName=root # cfgUserAdminPassword=******** (Write-Only) cfgUserAdminPrivilege=0x00000fff The following table lists the bit masks for user priveleges.
PAGE 128
The user may login to iDRAC or CMC and change configuration. 0x00000001 + 0x00000002 = 0x00000003 The user may login to iDRAC, access Virtual Media, and Virtual Console. 0x00000001 + 0x00000040 + 0x00000080 = 0x000000C1 cfgUserAdminUserName (Read/Write) Description The name of the user for this index. The user index is created by writing a string into this name field if the index is empty. Writing a string of double quotes ("") deletes the user at that index. You cannot change the name.
PAGE 129
cfgUserAdminSolEnable (Read/Write) Description Enables or disables Serial Over LAN (SOL) user access for the user. This object property is specific to iDRAC. Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 cfgUserAdminIpmiSerialPrivilege (Read/Write) Description The maximum privilege on the IPMI LAN channel. This object is applicable only for iDRAC on Rack and Tower Servers and not for iDRAC Enterprise on Blade Servers or CMC.
PAGE 130
cfgEmailAlertEnable (Read/Write) Description Enables or disables the alert instance. Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 cfgEmailAlertAddress (Read/Write) Description Specifies the destination email address for email alerts, for example, user1@company.com. Legal Values E-mail address format, with a maximum length of 64 ASCII characters. Default cfgEmailAlertCustomMsg (Read/Write) Description Specifies a custom message that forms the subject of the alert.
PAGE 131
RACADM sessions. Changes to idle timeout settings take effect at the next login. To disable idle timeout for a connection, set this property to 0. Use the -m option to apply this setting to iDRAC. The following sections provide information about the objects in the cfgSessionManagement group. cfgSsnMgtRacadmTimeout (Read/Write) Description Defines the idle timeout in seconds for the Remote RACADM interface.
PAGE 132
• In case of iDRAC Enterprise on Blade Servers: Session timed out. Closing the session. 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 guarantee that the client is responding.
PAGE 133
cfgSerialBaudRate (Read/Write) Description Sets the baud rate on iDRAC or CMC serial port. Legal Values Default • • For iDRAC: 9600, 28800, 57600, 115200 For CMC: 2400, 4800, 9600, 19200, 28800, 38400, 57600,115200 • • For iDRAC: 57600 For CMC: 115200 cfgSerialConsoleEnable (Read/Write) Description Legal Values Default Enables or disables the RAC or CMC serial console interface.
PAGE 134
NOTE: The CTRL key does not generate a character by itself, but must be struck simultaneously with another key to generate a character. For example, striking both the CTRL key and the \ key simultaneously (rather than sequentially) is denoted as ^\. Configuration options: The value must start with the ^ character, and be followed by one of the characters— az, A-Z, [, ], \ Legal value: String of up to 4 characters Default: • • For iDRAC: <\> For CMC: ^\ NOTE: For information on using RACADM comman
PAGE 135
Default cfgSerialConsoleColumns Description Specifies the number of columns in the terminal window command line connected to the serial port. You must log out, then log in again for the changes to take effect. This object property is applicable only for CMC. NOTE: The prompt counts as two characters. NOTE: The terminal emulator must be configured with the line wrap mode ON, if a terminal emulator is used.
PAGE 136
Example racadm getconfig -g cfgSerial cfgSerialBaudRate=115200 cfgSerialConsoleEnable=1 cfgSerialConsoleQuitKey=^\ cfgSerialConsoleIdleTimeout=1800 cfgSerialConsoleNoAuth=0 cfgSerialConsoleCommand= cfgSerialConsoleColumns=0 cfgSerialHistorySize=8192 cfgSerialTelnetEnable=0 cfgSerialSshEnable=1 cfgSerialTelnetEnable (Read/Write) Description Enables or disables the Telnet console interface on iDRAC or CMC.
PAGE 137
Example racadm getconfig -g cfgOobSnmp cfgOobSnmpTrapsEnable=1 cfgOobSnmpAgentCommunity=public cfgOobSnmpAgentEnable (Read/Write) Description Enables or disables the SNMP agent in iDRAC or CMC. Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 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.
PAGE 138
cfgTrapsCommunityName Description Sets the community string (identical to the community name) used for authentication. The community string acts as a password shared between different hosts over the network. This community string value must match with that of the other hosts for any kind of communication through SNMP. Legal Values A string representing the community name.
PAGE 139
Default 1 cfgRacTuneCtrlEConfigDisable Description Enables or disables the ability of the local user to configure iDRAC from the BIOS POST option-ROM. This object is applicable only for iDRAC on Rack and Tower Servers and not for iDRAC Enterprise on Blade Servers or CMC. Legal Values Default • • 1 (TRUE) 0 (FALSE) 0 cfgRacTuneHttpPort (Read/Write) Description Specifies the port number to use for HTTP network communication with iDRAC or CMC.
PAGE 140
cfgRacTuneIpRangeAddr (Read/Write) Description Specifies the acceptable IPv4 address bit pattern in positions determined by the "1"s in the range mask property (cfgRacTuneIpRangeMask). For CMC, a login from the incoming IP address is allowed only if the following are identical: • • cfgRacTuneIpRangeMask bit-wise and with incoming IP address cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr Legal Values An IPv4 address formatted string, for example, 192.168.0.44. Default 192.168.1.
PAGE 141
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. Legal Values Default • • For iDRAC: 10 – 655356 For CMC: 2 – 655356 60 cfgRacTuneIpBlkPenaltyTime (Read/Write) Description Defines the time span in seconds that session requests from an IP address with excessive failures are rejected.
PAGE 142
cfgRacTuneConRedirEnable (Read/Write) Description Enables or disables Virtual Console. This object property is applicable only to iDRAC. Legal Values • • Default 1 (TRUE) 0 (FALSE) 1 cfgRacTuneConRedirEncryptEnable (Read/Write) Description Encrypts the video in a Virtual Console session. This object property is applicable only to iDRAC. Legal Values • • Default 1 (TRUE) 0 (FALSE) 1 cfgRacTuneAsrEnable (Read/Write) Description Enables or disables iDRAC last crash screen capture feature.
PAGE 143
cfgRacTuneIpRangeAddr=192.168.1.1 cfgRacTuneIpRangeMask=255.255.255.0 cfgRacTuneIpBlkEnable=0 cfgRacTuneIpBlkFailCount=5 cfgRacTuneIpBlkFailWindow=60 cfgRacTuneIpBlkPenaltyTime=300 # cfgRacTuneTimezoneOffset=-18000 # cfgRacTuneDaylightOffset=3600 cfgRacTuneTimezoneOffset (Read Only) Description Specifies the time zone offset (in minutes) from Greenwich Mean Time (GMT)/Coordinated Universal Time (UTC) to use for the RAC Time.
PAGE 144
cfgRacTuneLocalConfigDisable (Read/Write) Description Disables write access to iDRAC configuration data. NOTE: Access can be disabled using the local RACADM or iDRAC Web interface; however, once disabled, access can be re-enabled only through iDRAC Web interface. This object property is applicable only to iDRAC. Legal Values Default • • 0 (TRUE-Enables) 1 (FALSE-Disables) 0 cfgRacTuneWebserverEnable (Read/Write) Description Enables or disables iDRAC or CMC web server.
PAGE 145
session user gets a read only access after the default timeout value of 30 seconds.) 2 (If the user of the first session has not responded for session sharing request by subsequent user, the next session user gets administrator access after default timeout value of 30 seconds.) Default 0 cfgRacTunePluginType (Read/Write) Description Legal Values Default Specifies the plug-in type to use when running virtual console from browser. This object property is applicable only to iDRAC.
PAGE 146
cfgVirMediaAttached (Read/Write) Description This object is used to attach virtual devices to the system via the USB bus. When the devices are attached, the server recognizes valid USB mass storage devices attached to the system. This is equivalent to attaching a local USB CDROM/floppy drive to a USB port on the system. When the devices are attached, they can be connected to the virtual devices remotely using iDRAC Web interface or the CLI.
PAGE 147
cfgSDWriteProtect (Read Only) Description Displays if the physical write protect latch on the SD card is enabled or disabled. NOTE: This command is deprecated from iDRAC 1.5 and CMC 3.0 releases onwards. The functionality of this command is now covered by cfgVFlashSDWriteProtect. While execution of the cfgSDWriteProtect command is successful, it is recommended to use the cfgVFlashSDWriteProtect command. For more information, see "cfgVFlashSDWriteProtect" on page 132.
PAGE 148
Default None cfgServerServiceTag (Read Only) Description Displays the service tag of the specified server. This object is applicable only to CMC. Legal Values None Default None cfgServerName (Read/Write) Description Displays the name of the specified server. This object is applicable only to CMC. Legal Values Maximum of 15 non-extended ASCII characters, (ASCII codes 32 through 126). For more information, see Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands.
PAGE 149
cfgServerNic1MacAddress (Read Only) Description Displays the MAC address of the server NIC 1. This object is applicable only to CMC. Legal Values None Default None cfgServerNic2MacAddress (Read Only) Description Displays the MAC address of the server NIC 2. This object is applicable only to CMC. Legal Values None Default None cfgServerNic3MacAddress (Read Only) Description Displays the MAC address of the server NIC 3. This object is applicable only to CMC.
PAGE 150
cfgServerNicEnable (Read/Write) Description Enables or disables LAN channel. This object is applicable only to CMC. Legal Values Default • • 1 (Enable) 0 (Disable) None cfgServerIPMIOverLanEnable (Read/Write) Description Enables or disables IPMI LAN channel. This object is applicable only to CMC. Legal Values Default • • 1 (enable) 0 (disable) None cfgServerPowerBudgetAllocation (Read Only) Description Legal Values Default Displays the current power allocation for the server.
PAGE 151
cfgServerDNSIMCName (Read/Write) Description Displays the DNS domain name for the integrated Remote Access Controller (iDRAC.) This object is applicable only to CMC. Legal Values None Default None cfgServerRootPassword (Write Only) Description Displays the password for iDRAC as a series of asterisks (*). It cannot be seen or displayed after this property is written. This object is applicable only to CMC.
PAGE 152
cfgServerBootOnce (Read/Write) Description Enables or disables the server boot once feature. For CMC, this object is Write only. Legal Values Default • • 1 = TRUE 0 = FALSE 0 cfgServerPowerConsumption (Read Only) Description Displays the current power consumption for a server. This object is applicable only to CMC.
PAGE 153
# cfgServerServiceTag=1S0M0G1 cfgServerName=SLOT-01 # cfgServerFW=1.40 (Build 12) # cfgServerBIOS=4.0.
PAGE 154
cfgADRootDomain Description Specifies the root domain of the domain forest. This object is applicable only to CMC. Legal Values Any printable text string of up to 254 characters, with no white space. Default cfgADEnable (Read/Write) Description Enables or disables Active Directory user authentication on iDRAC or CMC. If this property is disabled on iDRAC, only local iDRAC authentication is used for user logins.
PAGE 155
cfgADDomainController Description Specifies the AD server from which you want the CMC to obtain user names. Must be used with cfgADSpecifyServerEnable. This object is applicable only to CMC. Legal Values Valid IP address or fully qualified domain name (FQDN). Default None cfgADDomainController1 (Read/Write) Description Specifies the LDAP server from which you want the iDRAC to obtain user names . This object is applicable only to iDRAC.
PAGE 156
Default 120 cfgADType (Read/Write) Description Determines the schema type to use with Active Directory. Legal Values • • Default 1 (Enables Active Directory with the extended schema) 2 (Enables Active Directory with the standard schema) 1 cfgADSpecifyServerEnable Description Allows you to enable or disable and specify an LDAP server or a global catalog server. Use cfgADDomainController or cfgADGlobalCatalog to specify the IP address. This object is applicable only to CMC.
PAGE 157
cfgADGlobalCatalog1 (Read/Write) Description Specifies the Global Catalog server from which you want the iDRAC to obtain user names. This object is applicable only to iDRAC. Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default None cfgADGlobalCatalog2 (Read/Write) Description Specifies the Global Catalog server from which you want the iDRAC to obtain user names. This object is applicable only to iDRAC.
PAGE 158
cfgAdDomainController3. iDRAC does not fail over to the specified domain controllers when DNS lookup fails or none of the servers returned by the DNS lookup works. This object is applicable only to iDRAC. Legal Values • • Default 1 (TRUE)—use DNS to look up domain controllers 0 (FALSE)—use pre‑configured domain controllers 0 cfgADDcSRVLookupbyUserdomain (Read/Write) Description Chooses the way the user domain is looked up for Active Directory. This object is applicable only to iDRAC.
PAGE 159
cfgADGcRootDomain (Read/Write) Description The name of the Active Directory root domain used for DNS look up, to locate Global Catalog servers. This object is applicable only to iDRAC. Legal Values String. Maximum length = 254 Default Null cfgLDAP This group allows you to configure settings related to the Lightweight Directory Access Protocol (LDAP). Use this object with the config or getconfig subcommands.
PAGE 160
cfgLdapPort (Read/Write) Description Port of LDAP over SSL. Non-SSL port is not supported. Legal Values 1 - 65535 Default 636 cfgLdapBasedn (Read/Write) Description The Domain Name of the branch of the directory where all searches should start from. Legal Values String. Maximum length = 254 Default Null cfgLdapUserAttribute (Read/Write) Description Specifies the user attribute to search for.
PAGE 161
cfgLdapGroupAttributeIsDN (Read/Write) Description For iDRAC: When it is set to 1, iDRAC compares the userDN retrieved from the directory to compare to the members of the group; if it is set to 0, the user name provided by the login user is used to compare to the members of the group. This does not impact the search algorithm for the bind. iDRAC always searches the userDN and uses the userDN to bind.
PAGE 162
• Default For CMC: String of maximum length = 1024 characters (objectclass=*) Searches for all objects in tree. cfgLDAPCertValidationEnable (Read/Write) Description Controls certificate validation during SSL handshake. Legal Values • • Default 1 (TRUE)—iDRAC or CMC uses the CA certificate to validate the LDAP server certificate during SSL handshake. 0 (FALSE)—iDRAC or CMC skips the certificate validation step of SSL handshake.
PAGE 163
This object is applicable only to CMC. Legal Values String of maximum length of 254 alphanumeric characters and hyphens. The string must begin with a letter. Default [null] cfgLDAPSRVLookupServiceName (Read/Write) Description Configures the service name to be used in the SRV lookup. This object is applicable only to CMC. Legal Values String of maximum length of 254 characters. Default ldap cfgLdapRoleGroup For iDRAC, this group allows the user to configure role groups for LDAP.
PAGE 164
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 String. Maximum length = 1024 Default None Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupDN -i 1 cn=everyone,ou=groups,dc=openldap,dc=com cfgLdapRoleGroupPrivilege (Read/Write) Description A bit–mask defining the privileges associated with this particular group.
PAGE 165
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 cfgLocationDevicesize (Read Only) Description Indicates server chassis size.
PAGE 166
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 cfgSSADRoleGroupPrivilege (Read/Write) Description Use the bit mask numbers listed in the table below to set role-based authority privileges for a Role Group.
PAGE 167
The following sections provide information about the objects in the cfgChassisPower group. cfgChassisExternalPowerManagementMode Description Allows to enable or disable External Power Management. When this mode is enabled: • • • The chassis power capacity is set to maximum value. The server power priorities are set to 1. These properties cannot be changed by racadm or GUI. When the external power management mode is disabled, the power capacity and server power priorities are preserved.
PAGE 168
Default None cfgChassisMinPowerTimestamp (Read Only) Description The timestamp recorded when the minimum system power occurred. Legal Values None Default None cfgChassisPowerStatus (Read Only) Description Legal Values Default Indicates the power status of the chassis. • • • • • • 1 (other) 2 (unknown) 3 (OK) 4 (non-critical) 5 (critical) 6 (non-recoverable) None cfgChassisRedundantState (Read Only) Description Legal Values Default Enables or disables power redundancy for the chassis.
PAGE 169
than the minimum power required for the chassis configuration. Legal Values 2715 – 16685 watts Default 16685 watts cfgChassisPowerCapBTU (Read/Write) Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. The command generates an error if server throttling is necessary to achieve the power goal based on the value for this setting.
PAGE 170
cfgChassisRedundancyPolicy (Read/Write) Description Sets the redundancy policy of the chassis. Legal Values • • • Default 0 (no redundancy) 1 (AC redundancy) 2 (power supply redundancy) 0 (no redundancy) cfgChassisDynamicPSUEngagementEnable (Read/Write) Description Enables or disables dynamic engagement.
PAGE 171
cfgChassisPerformanceOverRedundancy (Read/Write) Description Enables or disables server performance over power redundancy. When enabled, this option favors server performance and server powerup, over maintaining power redundancy. When disabled, the system favors power redundancy over server performance.
PAGE 172
Default None cfgChassisTotalInPowerAvailable (Read Only) Description Indicates the amount of power (in watts) available for use by the chassis. Legal Values None Default None cfgChassisStandbyInPowerCapacity (Read Only) Description Indicates the amount of power (in watts) available for powering up any hardware modules that are either added to the chassis or powered up (if they are already present in the chassis).
PAGE 173
Default None Examples • racadm getconfig -g cfgChassisPower # cfgChassisInPower=0 W | 0 BTU/hr # cfgChassisPeakPower=0 W # cfgChassisPeakPowerTimestamp=06:32:55 01/26/2009 # cfgChassisMinPower=0 W # cfgChassisMinPowerTimestamp=06:32:55 01/26/2009 # cfgChassisPowerStatus=5 # cfgChassisRedundantState=0 cfgChassisPowerCap=16685 W cfgChassisPowerCapF=16685 W cfgChassisPowerCapBTU=56931 BTU/hr cfgChassisPowerCapFBTU=56931 BTU/hr cfgChassisPowerCapPercent =100% cfgChassisPowerCapFPercent =100% cfgChassisRedund
PAGE 174
cfgIpmiSolBaudRate (Read/Write) Description Specifies baud rate for serial communication over LAN. Legal Values 9600, 19200, 57600, 115200 Default 115200 cfgIpmiSolMinPrivilege (Read/Write) Description Specifies the minimum privilege level required for SOL access. Legal Values Default • • • 2 (User) 3 (Operator) 4 (Administrator) 4 cfgIpmiSolAccumulateInterval (Read/Write) Description Specifies the typical amount of time that iDRAC waits before transmitting a partial SOL character data packet.
PAGE 175
• Default 0 (FALSE) 0 cfgIpmiLanPrivLimit (Read/Write) Description Specifies the maximum privilege level allowed for IPMI over LAN access. Legal Values Default • • • 2 (User) 3 (Operator) 4 (Administrator) 4 cfgIpmiLanAlertEnable (Read/Write) Description Enables or disables global e-mail alerting. This property overrides all individual e-mail alerting enable/disable properties.
PAGE 176
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. Legal Values IPv6 address Default cfgIpmiPetIPv6AlertEnable (Read/Write) Description Enables or disables the IPv6 alert destination for the trap.
PAGE 177
Default The index value of a platform event filter object. cfgIpmiPefAction (Read/Write) Description Specifies the action that is performed on the managed server when the alert is triggered. NOTE: For iDRAC on Rack and Tower servers, this object is read-only for indexes 20, 21, and 22. Legal Values Default • • • • 0 (None) 1 (Power Down) 2 (Reset) 3 (Power Cycle) 0 cfgIpmiPefEnable (Read/Write) Description Enables or disables a specific platform event filter.
PAGE 178
cfgIpmiPetAlertEnable (Read/Write) Description Enables or disables a specific trap. Legal Values • • Default 1 (TRUE) 0 (FALSE) 0 cfgUserDomain This group is applicable only for iDRAC and 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 provide information about the objects in the cfgUserDomain group. cfgUserDomainIndex (Read Only) Description Represents a specific domain.
PAGE 179
cfgServerPowerAllocation (Read Only) 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. NOTE: This object is applicable only for iDRAC Enterprise on Rack and Tower Servers and not for iDRAC on Blade Servers or CMC.
PAGE 180
cfgServerMaxPowerCapacity (Read Only) Description Represents the maximum server power capacity based on the current component consumption. This object is applicable only for iDRAC. Legal Values Not applicable Default cfgServerPeakPowerConsumption (Read Only) Description Represents the maximum power consumed by the server until the current time. This object is applicable only for iDRAC.
PAGE 181
cfgServerPowerCapBtuhr (Read/Write) Description Represents the server power threshold in BTU/hr. This object is applicable only for iDRAC. NOTE: This value is applicable only if cfgServerPowerCapEnable is set to 1. Legal Values None Default Server power threshold in BTU/hr. cfgServerPowerCapPercent (Read/Write) Description Represents the server power threshold in percentage. This object is applicable only for iDRAC. NOTE: This value is applicable only if cfgServerPowerCapEnable is set to 1.
PAGE 182
cfgServerPowerLastHourMinPower (Read Only) Description Displays the minimum power value during the last hour. This object is applicable only for iDRAC. Legal Values Not applicable Default Minimum power value during the last hour. cfgServerPowerLastHourMinTime (Read Only) Description Displays the timestamp of minimum power value during the last minute. This object is applicable only for iDRAC.
PAGE 183
• • • • Default YYYY = Year HH = hour MM=Minutes SS = Seconds Maximum power value during the last hour. cfgServerPowerLastDayMinPower (Read Only) Description Displays the minimum power value during the last day. This object is applicable only for iDRAC. Legal Values Not applicable Default Minimum power value during the last day. cfgServerPowerLastDayMinTime (Read Only) Description Displays the timestamp of minimum power value during the last day. This object is applicable only for iDRAC.
PAGE 184
cfgServerPowerLastDayMaxTime (Read Only) Description Displays the timestamp of maximum power value during the last day. This object is applicable only for iDRAC. Legal Values Time in the format: DD MM Date HH:MM:SS YYYY where, • • • • • • • Default DD = Day of the week MM = Month Date = Date YYYY = Year HH = hour MM = Minutes SS = Seconds Maximum power value during the last day. cfgServerPowerLastWeekMinPower (Read Only) Description Displays the minimum power value during the last week.
PAGE 185
cfgServerPowerLastWeekMaxPower (Read Only) Description Displays the maximum power value during the last week. This object is applicable only for iDRAC. Legal Values None Default Maximum power value during the last week. cfgServerPowerLastWeekMaxTime (Read Only) Description Displays the timestamp of maximum power value during the last week. This object is applicable only for iDRAC. Legal Values A string of up to 32 characters.
PAGE 186
Default Difference between the available power and the peak power consumption. cfgServerActualAmperageConsumption (Read Only) Description Displays the current power consumption. This object is applicable only for iDRAC. Legal Values Not applicable Default Current power consumption. cfgServerPeakAmperage (Read Only) Description Displays the current peak power consumption. Legal Values Not applicable Default Current peak power consumption.
PAGE 187
cfgServerCumulativePowerConsumptionTimeStamp (Read Only) Description Displays the timestamp of the cumulative power consumption. This object is applicable only for iDRAC. Legal Values A string of up to 32 characters. Time in the format: DD MM Date HH:MM:SS YYYY where, • • • • • • • Default DD = Day of the week MM= Month Date=Date YYYY = Year HH = hour MM=Minutes SS = Seconds Timestamp of the cumulative power consumption.
PAGE 188
cfgKVMAccessToCMCEnable Description Enables or disables the Dell CMC Console access on the iKVM. Legal Values • • Default 1 (enable) 0 (disable) None cfgKVMFrontPanelEnable Description Enables or disables front panel access on the iKVM. Legal Values • • Default 1 (enable) 0 (disable) None Example racadm getconfig -g cfgKVMInfo cfgKVMAccessToCMCEnable=1 cfgKVMFrontPanelEnable=1 cfgAlerting This group is enables or disables SNMP event trap alerting and sets the event filter.
PAGE 189
cfgAlertingSourceEmailName Description Specifies e-mail address used to send e-mail notifications when an event occurs. Legal Values None Default None Examples racadm getconfig -g cfgAlerting -o cfgAlertingSourceEmailName racadm config -g cfgAlerting -o cfgAlertingSourceEmailName user@home.com Object value modified successfully. cfgLcdLocale Description Specifies the Language (locale) for the Blade Chassis LCD interface. Legal Values de, fr, en, es, ja, zh-cn.
PAGE 190
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 191
cfgIPv6LanNetworking This group is used to configure the IPv6 over LAN networking capabilities. Use this object with the config or getconfig subcommands. To use this object property for CMC, you must have Chassis Configuration Administrator privilege. NOTE: Use the -m option to apply this setting to iDRAC. The following sections provide information about the objects in the cfgIPv6LanNetworking group. cfgIPv6Enable (Read/Write) Description Enables or disables iDRAC or CMC IPv6 stack.
PAGE 192
cfgIPv6PrefixLength (Read/Write) Description Specifies the prefix length for iDRAC or CMC IPv6 address. NOTE: For CMC, this property is used only if cfgIPv6AutoConfig is set to 0 (false) Legal Values For iDRAC: 1 - 128 For CMC: 0 - 128 Default 64 cfgIPv6AutoConfig (Read/Write) Description Enables or disables the IPv6 Auto Configuration option. NOTE: If this value is set to 0, the CMC disables auto configuration and statically assigns IPv6 addresses.
PAGE 193
cfgIPv6Address3 (Read Only) Description The iDRAC IPv6 third address. This object is applicable only for iDRAC. Legal Values String representing a valid IPv6 entry. Default :: cfgIPv6Address4 (Read Only) Description The iDRAC IPv6 fourth address. This object is applicable only for iDRAC. Legal Values String representing a valid IPv6 entry. Default :: cfgIPv6Address5 (Read Only) Description The iDRAC IPv6 fifth address. This object is applicable only for iDRAC.
PAGE 194
Default :: cfgIPv6Address9 (Read Only) Description The iDRAC IPv6 ninth address. This object is applicable only for iDRAC. Legal Values String representing a valid IPv6 entry. Default :: cfgIPv6Address10 (Read Only) Description The iDRAC IPv6 tenth address. This object is applicable only for iDRAC. Legal Values String representing a valid IPv6 entry. Default :: cfgIPv6Address11 (Read Only) Description The iDRAC IPv6 eleventh address. This object is applicable only for iDRAC.
PAGE 195
cfgIPv6Address14 (Read Only) Description The iDRAC IPv6 fourteenth address. This object is applicable only for iDRAC. Legal Values String representing a valid IPv6 entry. Default :: cfgIPv6Address15 (Read Only) Description The iDRAC IPv6 fifteenth address. This object is applicable only for iDRAC. Legal Values String representing a valid IPv6 entry.
PAGE 196
Default :: Example $ racadm getconfig -g cfgIPv6LanNetworking cfgIPv6Enable=1 cfgIPv6AutoConfig=1 cfgIPv6Address=:: cfgIPv6PrefixLength=64 cfgIPv6Gateway=:: cfgIPv6DNSServersFromDHCP6=1 cfgIPv6DNSServer1=:: cfgIPv6DNSServer2=:: If both IPv4 and IPv6 are enabled on the CMC, IPv6 DNS servers take priority.
PAGE 197
Description Displays the static gateway for the CMC IP address. Legal Values Default cfgNicCurrentDhcpWasUsed Description Indicates whether DHCP is used to configure the NIC. Legal Values 0 – address is static. 1– address was obtained from the DHCP server. Default None cfgNicCurrentVlanEnable (Read Only) Description Indicates whether the VLAN is enabled.
PAGE 198
Default cfgDNSCurrentDomainName Description Displays the DNS domain name. Legal Values Default cfgNicCurrentIPv4Enabled Description Indicates whether IPv4 is enabled on the CMC. If the current property value is set to 0 (false), the remote network interfaces to the CMC are not accessible over IPv4. Legal Values Default Example racadm getconfig -g cfgCurrentLanNetworking # cfgNicCurrentIPv4Enabled=1 # cfgNicCurrentIpAddress=143.166.152.116 # cfgNicCurrentNetmask=255.255.255.
PAGE 199
cfgCurrentIPv6AutoConfigWasUsed Description Indicates whether auto configuration is used to obtain IPv6 settings, including stateless IPv6 address(es) and gateway. Legal Values 0 (static addressing is used) 1 (address is obtained from the DHCPv6 server and/or stateless auto configuration) Default None cfgCurrentLinkLocalAddress Description Displays the current IPv6 link-local address of the CMC. Legal Values Default cfgCurrentIPv6Address1 Description Displays the current IPv6 addresses.
PAGE 200
Default cfgCurrentIPv6DNSServer2 Description Displays the IPv6 address for DNS server 2.
PAGE 201
cfgIpmiSerialConnectionMode (Read/Write) Description When the iDRAC cfgSerialConsoleEnable property is set to 0 (disabled), the iDRAC 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 202
cfgIpmiSerialLineEdit (Read/Write) Description Enables or disables line editing on the IPMI serial interface. Legal Values Default • • 0 (FALSE) 1 (TRUE) 1 cfgIpmiSerialEchoControl (Read/Write) Description Enables or disables echo control on the IPMI serial interface. Legal Values Default • • 0 (FALSE) 1 (TRUE) 1 cfgIpmiSerialDeleteControl (Read/Write) Description Enables or disables delete control on the IPMI serial interface.
PAGE 203
cfgIpmiSerialInputNewLineSequence (Read/Write) Description Specifies the input newline sequence specification for the IPMI serial interface. Legal Values Default • • 1 (ENTER) 2 (NULL) 1 cfgSmartCard This group specifies properties used to support access to iDRAC using a smart card. This group is applicable only for iDRAC. The following sections provide information about the objects in the cfgSmartCard group.
PAGE 204
This group is applicable only for iDRAC on Rack and Tower Servers and not for iDRAC Enterprise on Blade Servers. CAUTION: Use extra precaution when modifying properties in this group. Inappropriate modification of the properties in this group can result in your RAC NIC become inoperable. cfgNetTuningNicSpeed Description Specifies the speed for the CMC NIC. This property is used only if cfgNetTuningNicAutoNeg is set to 0.
PAGE 205
• Default 1 (Full Duplex) 1 cfgNetTuningNicMtu (Read/Write) Description The size in bytes of the maximum transmission unit used by iDRAC or CMC NIC. Legal Values 576 – 1500 Default 1500 NOTE: IPv6 requires a minimum MTU of 1280. If IPv6 is enabled, and cfgNetTuningMtu is set to a lower value, the CMC uses an MTU of 1280. cfgSensorRedundancy This group is used to set the power supply redundancy. This group is applicable only for iDRAC.
PAGE 206
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 redundancy support.
PAGE 207
cfgVFlashSDEnable (Read/Write) Description Enables or disables the vFlash SD card. NOTE: Disabling vFlashPartition by setting cfgVFlashSDEnable to 0 does not require a license. Legal Values Default • • 0 (Disable) 1 (Enable) 1 cfgVFlashSDSize (Read Only) Description Displays the size of the vFlash SD card in megabytes (MB). Legal Values A string of upto 64 characters.
PAGE 208
• Default Unknown OK cfgVFlashSDWriteProtect (Read Only) Description Displays whether the physical write-protect latch on the vFlash SD card is enabled or disabled. Legal Values Default • • 0 (vFlash is not write-protected) 1 (vFlash is write-protected) None 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. This group is applicable only for iDRAC.
PAGE 209
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 Values String: • • • • • • Default FAT16 FAT32 EXT2 EXT3 CD RAW None cfgVFlashPartitionAccessType (Read/Write) Description Indicates the partition access permissions.
PAGE 210
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 Default • • 0 (Disable) 1 (Enable) 0 cfgRacSecurity This group is used to configure settings related to CMC SSL certificate signing request (CSR) feature. The properties in this group must be configured before generating a CSR from CMC. Use this object with the config or getconfig subcommands.
PAGE 211
cfgRacSecCsrLocalityName (Read/Write) Description Specifies the CSR Locality (L). Legal Values A string of up to 254 characters. Default cfgRacSecCsrStateName (Read/Write) Description Specifies the CSR State Name (S). Legal Values A string of up to 254 characters. Default cfgRacSecCsrCountryCode (Read/Write) Description Specifies the CSR Country Code (CC). Legal Values A string of 2 alphabet country code.
PAGE 212
cfgRacSecCsrKeySize (Read/Write) Description Specifies the SSL asymmetric key size for the CSRs.
PAGE 213
Database Objects With Get and Set Commands 4 These groups and object names must be used with the get and set commands. When addressing these objects they must begin with either a FQDD or FQDD Alias. These groups and objects are not applicable for CMC. System.Power This group provides information on power management features for iDRAC. The following section provides information about the objects in the System.Power group. System.Power.
PAGE 214
Default None System.Power.Cap.Enable (Read/Write) Description Enables Server Capping. NOTE: This value is read only on Blade servers because CMC controls the capping. Legal Values Default • • 0 - Disable 1 - Enable 0 System.Power.Cap.Watts (Read Only) Description Represents the Maximum Power in Watts a device is allowed to consume. The device may throttle in order to meet this capacity. NOTE: This value is applicable only if System.Power.Cap.Enable is set to 1.
PAGE 215
System.Power.Hotspare.Enable Read or Write Description Enables RapidOn feature for the primary PSU selection. NOTE: This value is supported only on iDRAC on Rack and Tower servers. Legal Values 0 - Disable 1- Enable Default 1 System.Power.PFC.Enable (Read/Write) Description Enables the power factor correction feature. NOTE: This value is supported only on iDRAC on Rack and Tower servers. NOTE: This value is applicable only if System.Power.Cap.Enable is set to 1.
PAGE 216
Time in the format Day Month Date HH:MM:SS Year • • • • • • Default HH = hour MM=Minutes SS = Seconds OO = Month DD = Day YYYY = Year None System.Power.Max.PowerClear Write Only Description Clears the current recorded power statistics. Legal Values 0 - Do not clear 1 - Clear the Power Consumption Statistics Default None System.Power.Avg.LastHour (Read Only) Description Displays the average power value during the last hour. Legal Values Integer > 0 Default None System.Power.Avg.
PAGE 217
System.Power.Max.LastDay.TimeStamp (Read Only) Description Displays the timestamp of maximum power value during the last day. Legal Values Time in the format Day Month Date HH:MM:SS Year • • • • • • Default HH = hour MM=Minutes SS = Seconds OO = Month DD = Day YYYY = Year 0 System.Power.Avg.LastWeek (Read Only) Description Displays the average power value during the last week. Legal Values Integer > 0 Default 0 System.Power.Min.LastWeek.
PAGE 218
System.Power.Max.LastWeek.TimeStamp (Read Only) Description Displays the timestamp of maximum power value during the last week. Legal Values Time in the format Day Month Date HH:MM:SS Year • • • • • • Default HH = hour MM=Minutes SS = Seconds OO = Month DD = Day YYYY = Year 0 System.Power.RedundancyPolicy (Read/Write) Description Sets the redundancy policy of the system. NOTE: This object is not applicable on iDRAC on Blade servers. iDRAC on Blade servers does not control power supplies.
PAGE 219
• Default 64 - 5+x Redundant 0 System.Power.RedundantState (Read Only) Description Retrieves the redundancy state for the chassis. Legal Values Default • • 0 - None 1 - Full 0 System.Power.Cap.Percent (Read/Write) Description Represents the maximum power as a percentage of total power that a device is allowed to consume. The device may throttle in order to meet this cap. NOTE: This value is applicable only if System.Power.Cap.Enable is set to 1. Legal Values String up to 32 characters.
PAGE 220
System.Power.Max.Headroom Write Only Description Displays the difference between the available power and the current power consumption. NOTE: This object is not applicable on iDRAC on Blade servers. Legal Values Integer > 0 Default 0 System.Power.EnergyConsumption.StarttimeStamp Description Displays the Start time for the Power Consumption.
PAGE 221
System.Power.Supply.[i].MaxInputPower (Read Only) Description Displays the AC input rated power in Watts. Legal Values Integer > 0 Default 0 System.Power.Supply.[i].MaxOutputPower ((Read Only)) Description Displays the DC output rated power in Watts. Legal Values Integer > 0 Default 0 System.Power.Supply.[i].Status (Read Only) Description Displays the status of the power supply unit. Legal Values Default • • • • 0 - absent 1 - present and OK 2 - failure 3 - predictive failure 0 System.
PAGE 222
Default None System.Power.Supply.[i].LineStatus (Read Only) Description Specifies if this power supply is powered off or on. Legal Values Integer > 0 Default None System.Power.Supply.[i].PMBusMonitoring (Read Only) Description Specifies if this PMBus is present or not. Legal Values Integer > 0 Default 0 System.Location This group provides information on the server's physical location characteristics. This group is not applicable for iDRAC.
PAGE 223
System.Location.Rack.Slot (Read/Write) Description Indicates the slot where server is located. Legal Values 1- 255 (1 Byte) Default 0 System.Location.DeviceSize (Read Only) Description Indicates server chassis size. Legal Values 1- 255 Default 0 System.Location.Chassis.Name Read or Write Description Indicates chassis name. Legal Values String of up to 127 ASCII characters Default 0 System.Location.Chassis.Slot Read Only Description Indicates chassis slot.
PAGE 224
LifecycleController.LCAttributes.LifecycleControllerState (Read/Write) Description Configures the lifecycle controller state. Legal Values Default • • • 0 - Disable 1 - Enable 2 - Recovery mode 2 LifecycleController.LCAttributes.PartFirmwareUpdate (Read/Write) Description Configures the Part Firmware Update. Legal Values Default • • • 0 - Disable 1 - Allow version upgrade only. 2 - Match firmware of replaced part. 0 LifecycleController.LCAttributes.
PAGE 225
iDRAC.IMC This group provides information on managing the administrative state of the Internal Management Communication (IMC.) iDRAC.IMC.AdministrativeState (Read/Write) Description Manage the administrative state of the IMC. Legal Values String of up to 62 ASCII characters • • Default 0 - Disable 1 - Enable 0 iDRAC.SNMP.Alert This group contains parameters to configure the FQDN for sending alerts. This group is indexed from 1 to 16. NOTE: This group is applicable only for iDRAC. iDRAC.SNMP.Alert.