CLI Guide

ManualsBrandsDell ManualsActive System ManagerChassis Management Controller Version 6.20 For Dell PowerEdge M1000e

Dell Chassis Management Controller Version 6.20

for PowerEdge M1000e

RACADM CLI Guide

Summary of content (174 pages)

PAGE 1
Dell Chassis Management Controller Version 6.
PAGE 2
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © January 2008 - June 2018 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
PAGE 3
Contents 1 Introduction....................................................................................................................................................7 New in this release............................................................................................................................................................. 7 Supported RACADM Interfaces.....................................................................................................................................
PAGE 4
getkvminfo........................................................................................................................................................................45 getled.................................................................................................................................................................................45 getmacaddress....................................................................................................................................
PAGE 5
testemail............................................................................................................................................................................ 87 testfeature.........................................................................................................................................................................87 testtrap........................................................................................................................................
PAGE 6
cfgChassisDefaultPowerCapLowerBoundBTU (Read Only)...............................................................................146 cfgChassisDefaultPowerCapLowerBound (Read Only)...................................................................................... 146 cfgChassisDefaultPowerCapUpperBound (Read Only)...................................................................................... 146 cfgChassisDefaultPowerCapUpperBoundBTU (Read or Write).................................................
PAGE 7
1 Introduction This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions for the following: • iDRAC for Blade Servers • iDRAC on Rack and Tower Servers Most of the commands mentioned in this document are applicable for multi-generation servers. That is, the commands are applicable for iDRAC6, iDRAC7, and iDRAC8.
PAGE 8
NOTE: Local racadm and local racadm proxy runs with root user privilege. • SSH or Telnet — Also known as Firmware RACADM. Firmware RACADM is accessible by logging in to iDRAC using SSH or Telnet. Similar to Remote RACADM, at the RACADM prompt, directly run the commands without the RACADM prefix. • Remote — Supports running RACADM commands from a remote management station such as a laptop or desktop.
PAGE 9
RACADM Command Options The following table lists the options for the RACADM command: Table 1. RACADM Command Options Option Description -r Specifies the controller’s IP address. -u Specifies the user name that is used to authenticate the command transaction. If the-u option is used, the -p option must be used, and the -i option (interactive) is not allowed.
PAGE 10
Subcommand CMC Telnet/SSH/Serial Remote RACADM connect Yes Yes deploy Yes Yes feature Yes Yes featurecard Yes Yes fwupdate Yes Yes get Yes Yes getactiveerrors Yes Yes getarraycfg Yes Yes getassettag Yes Yes getchassisname Yes Yes getconfig Yes Yes getdcinfo Yes Yes getfanreqinfo Yes Yes getflexaddr Yes Yes getioinfo Yes Yes getkvminfo Yes Yes getled Yes Yes getmacaddress Yes Yes getmodinfo Yes Yes getniccfg Yes Yes getpbinfo Yes Yes getpminfo
PAGE 11
Subcommand CMC Telnet/SSH/Serial Remote RACADM krbkeytabupload No Yes netstat Yes Yes ping Yes Yes ping6 Yes Yes racdump Yes Yes racreset Yes Yes racresetcfg Yes Yes remoteimage Yes Yes set Yes Yes serveraction Yes Yes setarraycfg Yes Yes setassettag Yes Yes setchassisname Yes Yes setflexaddr Yes Yes setled Yes Yes setniccfg Yes Yes setractime Yes Yes setslotname Yes Yes setsysinfo Yes Yes sshpkauth Yes Yes sslcertdownload No Yes sslcertuploa
PAGE 12
• The iDRAC RACADM Support Matrix provides the list of sub commands and objects that are applicable for a particular iDRAC version. • Documentation specific to your third-party management console application. • The Dell OpenManage Server Administrator’s User’s Guide provides information about installing and using Dell OpenManage Server Administrator. • The Dell Update Packages User's Guide provides information about obtaining and using Dell Update Packages as part of your system update strategy.
PAGE 13
Contacting Dell NOTE: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog. Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues: 1 Go to Dell.com/support. 2 Select your support category.
PAGE 14
2 RACADM Subcommand Details This section provides detailed description of the RACADM subcommands including the syntax and valid entries.
PAGE 15
• getsel • getsensorinfo • getslotname • getssninfo • getsvctag • getsysinfo • gettracelog • getversion • ifconfig • krbkeytabupload • netstat • ping • ping6 • racdump • racreset • racresetcfg • remoteimage • set • serveraction • setarraycfg • setassettag • setchassisname • setflexaddr • setled • setniccfg • setractime • setslotname • setsysinfo • sshpkauth • sslcertdownload • sslcertupload • sslcertview • sslcsrgen • sslresetcfg • testcif
PAGE 16
Strings containing the following special characters must be quoted using double quotation marks: • $ (dollar sign) • " (double quotation mark) • ` (backward quotation mark) • \ (backward slash) • ~ (tilde) • | (vertical bar) • ( (left parentheses) • ) (right parentheses) • & (ampersand) • > (greater than) • < (less than) • # (pound) • ASCII code 32 (space) There are different escaping rules for double quotation marks.
PAGE 17
? -- display usage summary for a subcommand arp -- display the networking arp table chassisaction -- execute power-up/down/cycle or reset operation chassislog -- display the chassislog closessn -- close a session clrraclog -- clear the CMC log clrsel -- clear the System Event Log (SEL) cmcchangeover -- changes the redundant state of the CMC from active to standby and vice versa config -- modify CMC configuration properties connect -- connect to switch or blade serial console deploy -- deploy bl
PAGE 18
testemail testfeature testtrap traceroute traceroute6 wsman ------- test CMC e-mail notifications test CMC feature x test CMC SNMP trap notifications determine the route of a packet determine the route of a packet perform wsman client functions for servers.
PAGE 19
arp Table 5. arp table Description Displays the contents of the Address Resolution Protocol (ARP) table. ARP table entries cannot be added or deleted. To use this subcommand, you must have Execute Diagnostic Commands. Synopsis racadm arp Input N/A Example racadm arp Table 6. Output Address HW Type HW Address Mask Device 192.168.1.1 Ether 00:0d:65:f3:7c:bf C eth0 chassisaction Table 7. Details of chassisaction attribute Description Runs a power action on the chassis, KVM or a switch.
PAGE 20
Example • • Perform a reset of switch-3: racadm chassisaction -m switch-3 reset Module power operation successful. Perform a non graceful shutdown of the chassis: racadm chassisaction -m chassis nongraceshutdown chassislog Table 8. Details of chassislog attribute Description Displays chassis log and management operations.
PAGE 21
NOTE: This subcommand ends all the sessions other than the current session. 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. Session running this command cannot be closed. —a — Closes all sessions. • —u — Closes all sessions for a particular user name.
PAGE 22
Clear SEL log on server 1 cmcchangeover Table 12. Details of cmcchangeover attribute Description Changes the state of the CMC from active to standby, or from standby to active, in a redundant CMC configuration. This subcommand is useful for remote debugging or testing purposes To use this subcommand, you must have the Administrator privilege. NOTE: This command is applicable only in redundant CMC environments.
PAGE 23
• -p — This option must be used with the -f option. It directs config to delete the password entries contained in the config file -f after the configuration is complete. To apply the password, you must remove the preceding Read-Only marker '#' in the config file before executing the config -f command. • -g — The -g , or group option, must be used with the -o option. The specifies the group containing the object that is to be set.
PAGE 24
• Connect to server 1 serial console: racadm connect -m server-1 deploy Table 15. Details of deploy attribute Description Deploys blade server or IOM by specifying the required properties. To use this subcommand, you must have the Server Administrator privilege. NOTE: Use setniccfg to configure static IP address, subnet mask, and gateway, and DHCP, speed and duplex properties.
PAGE 25
• • • -v SNMPv2 ro — Specifies the SNMP community string for switches. Valid community strings are 1–20 characters in length, with valid ASCII characters in the range [33–125] (decimal). Protocol version set to SNMPv2. Permission on community string is read-only. -q — Displays or modifies the quick deploy parameters. -n — Specifies the number of reserved IP addresses for quick deploy. The allowed values are: 8, 16, and 32.
PAGE 26
NOTE: The general format of an alert descriptor: cmc.alert.category.[subcategory].[severity] where, category is mandatory, but subcategory and severity are optional. A severity cannot precede a subcategory. Valid category values are: • • • • • All System Updates Audit Config Valid severity values are: • • • Critical Warning Informational Valid examples of alert descriptors are: Input • cmc.alert.all • cmc.alert.audit • cmc.alert.audit.lic • cmc.alert.audit.warning • cmc.alert.audit.lic.
PAGE 27
• Configure using severity as a parameter. For example, all informational events in storage category are assigned poweroff as action, and email and snmp as notifications: racadm eventfilters set -c cmc.alert.storage.info -n email,snmp • Configure using subcategory as a parameter. For example, all configurations under the licensing subcategory in the audit category are assigned poweroff as action and all notifications are enabled: racadm eventfilters set -c cmc.alert.audit.
PAGE 28
Example • Display the current status of all chassis features: racadm feature -s • Deactivate the FlexAddressPlus feature on the chassis: racadm feature -d -c FlexAddressPlus featurecard Table 18. Details of featurecard attribute Description Verifies proper SD card installation and displays the SD card status. To use this subcommand, you must have the Chassis Configuration Administrator privilege. Synopsis racadm featurecard -s Input -s — Lists active SD card features and SD card status.
PAGE 29
NOTE: CMC firmware update is supported only for the firmware versions 3.10, 3.20, 3.21, 4.0, 4.10, 4.11, 4.30, 4.31, 4.45, and 4.5. For any version other than these, first update to any of these versions, and then update to the required version. To use this subcommand, you must have the Chassis Configuration Administrator privilege. NOTE: The fwupdate command is not supported for iDRAC7 or later. Use the CMC GUI to perform the operation.
PAGE 30
NOTE: When attempting to run firmware update task using racadm fwupdate command, if the firmware image path length is greater than 256 characters. Remote RACADM client exits with the error message "ERROR: Specified path is too long". Input • —u — Performs the firmware update operation (used with -p and -g). • —s — Displays the status of the firmware update. Use this option by itself. Lists active SD card features and SD card status. NOTE: Use —m to display the status of the module update.
PAGE 31
NOTE: You can specify the cmc-active and cmc-standby modules at the same time along with one or more server-n modules. This option enables the devices to be updated together. NOTE: Verify that the update applied to servers for a particular generation has been validated for all impacted server models. Output Displays a message indicating the operation that is being performed. Example • Upload the firmware image from the TFTP server and start the firmware update. racadm fwupdate -g -u -a 192.168.0.
PAGE 32
Table 20. Firmware update methods on CMC servers FW Update Method CMC Local RACADM No Local RACADM-TFTP No Local RACADM-FTP No Remote RACADM Yes Remote RACADM-TFTP Yes Remote RACADM-FTP Yes Firmware RACADM-TFTP Yes Firmware RACADM-FTP Yes get Table 21. Details of get attribute Description Saves CMC configuration properties to a file. NOTE: If CMC is not in the network, you cannot export the chassis configuration profile to a remote network share with proxy using the get command.
PAGE 33
Example • Export the CMC XML configuration to a local share using remote racadm racadm -r 192.168.0.120 -u abc -p get -f file.xml -t xml • Export the CMC XML configuration to a CIFS share racadm get -f file.xml -t xml -u myuser -p mypass -l //192.168.0.0/ share • Export the CMC XML configuration to an NFS share racadm get -f file.xml -t xml -l 192.168.0.0:/myshare getactiveerrors Table 22. Details of getactiveerrors attribute Description Displays CMC active errors.
PAGE 34
• Module ID Severity Message = 1 = Critical = The storage battery has failed. Module ID Severity Message = 10 = Critical = General failure after video. Module ID Severity Message = ps-6 = Critical = The power input for power supply 6 is lost. To display the Critical error messages for all the components. racadm getactiveerrors –s critical Module ID Severity Message = 1 = Critical = The storage battery has failed. Module ID Severity Message = 10 = Critical = General failure after video.
PAGE 35
getarraycfg Table 23. Details of getarraycfg attribute Description To display the storage array properties and configuration status, run this command. Synopsis getarraycfg -m [-s] Input • -m — The valid value for —m is server–, where n = 1 to 7 and 9 to 15. • -s — Query for current storage configuration process status. Output Array configured properties for: • • • • • Member Name Member IP Group Name Group IP Fabric Selection configuration completed successfully.
PAGE 36
To run this subcommand, you must have the CMC Login User privilege. Synopsis racadm getchassisname Input N/A Example racadm getchassisname CMC-JGB6B2S getconfig Table 26. Details of getconfig attribute Description Retrieves iDRAC configuration parameters individually or all iDRAC configuration groups may be retrieved and saved to a file. NOTE: This subcommand is deprecated. For viewing the configuration objects and its values, use get subcommand.
PAGE 37
• Output -v — The -v option displays more information with the display of the properties and is used with the -g option. The subcommand displays error message when: • • Invalid syntax, group name, object name, index, or any other invalid database members are entered. The RACADM CLI transport is unsuccessful. If errors are not encountered, this subcommand displays the content of the specified configuration.
PAGE 38
• Displays the current Enhanced Cooling Mode property configuration. racadm getconfig –g cfgThermal getdcinfo Table 28. Details of getdcinfo attribute Description Displays general I/O module and daughter card configuration information. Only the CMC controls daughter cards. To run this subcommand, you must have the CMC Login User privilege. NOTE: Fabric verification for server DCs is performed only when the chassis is turned on.
PAGE 39
server-8 Present FibreChannel 4 Invalid 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 Present None N/A None N/A server-15 Not Present None N/A None N/A server-16 Not Present None N/A None N/A Table 31.
PAGE 40
getflexaddr Table 32. Details of getflexaddr attribute Description Displays enabled or disabled status for the entire chassis and fabric ID decoder. If used with the -i option, the command displays MACs/WWN addresses on a per slot basis. The decoder values indicate the protocols of the network cards: • 0 — Unsupported • 1 — ISCSI • 2 — FCoE-FIP • 3 — iSCSI/FCoE-FIP To run this subcommand, you must have the CMC Login User privilege.
PAGE 41
15 Enabled Not Present 16 Enabled Not Present A Gigabit Ethernet Enabled B None Enabled C None Enabled Table 34. For Fabric type Table 35.
PAGE 42
Table 37. Example 1 SLOT-01 N/A N/A Not Present N/A 2 WIN-JGKC47ACGKG PowerEdge M630 ON Present 38 3 WIN-N24BRAT3L1J PowerEdge M630 ON Present 38 4 SLOT-04 PowerEdge M630 ON Present 17 5a nodea.NOBLEEST.
PAGE 43
Switch-6 N/A None Not Present N/A [Enhanced Cooling Mode] Enhanced Cooling Mode(ECM) Status = Disabled getioinfo Table 39. Details of getioinfo attribute Description Displays general information about the I/O modules on the chassis. To run this subcommand, you must have the CMC Login User privilege. NOTE: The fabric type may be any supported I/O fabric type, such as Ethernet, Fibre Channel, and InfiniBand.
PAGE 44
Aggregato r switch -6 MXL 10/40GbE 10 GbE KR Present OK ON Master Full Switch No • Table 41. racadm getioinfo -s abc1234 Switch-1 A1 Present Master N/A N/A abc1234 Switch-2 A2 Present Standalone 1 N/A abc1234 Switch-3 B1 Present Master N/A N/A abc1234 Switch-4 B2 Present Master N/A N/A abc1234 Switch-5 C1 Present Standalone 0 N/A abc1234 Switch-6 C2 Present Master N/A N/A • Table 42.
PAGE 45
getkvminfo Table 45. Details of getkvminfo attribute Description Displays KVM module information. To run this subcommand, you must have the CMC Login User privilege. Synopsis racadm getkvminfo Input N/A Table 46. Example KVM Present Avocent iKVM Switch 00.05.00.04 Ready getled Table 47. Details of getled attribute Description Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots).
PAGE 46
server-9 Extension(1) getmacaddress Table 48. Details of getmacaddress attribute Description Displays the MAC/WWN addresses and fabric ID decoder for all modules or for a specified module. The decoder values indicate the protocols of the network cards: • • • • 0 — Unsupported 1 — ISCSI 2 — FCoE-FIP 3 — iSCSI/FCoE-FIP To use this subcommand, you must have the CMC Login User privilege.
PAGE 47
Example • Display MACs for all modules. racadm getmacaddress • Display iSCSI MAC addresses for all servers. racadm getmacaddress -t iscsi • Display iSCSI MAC for server-1. racadm getmacaddress -m server-1 -t iscsi • Display extra iSCSI MACs for server-1 (if available). racadm getmacaddress -m server-1 -t iscsi -x • Display the user-defined MAC and WWN address.
PAGE 48
Table 53. Displays the MAC address. CMC Present N/A 00:1E:4F:1F:3C:58 N/A Server-1 Present 00:1E:4F:2A:AF:7B 00:1E:4F:2A:D3:97 00:1E:4F:2A:D3:99 Server-2 Present 00:22:19:D2:1E:84 N/A 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:02 00:18:8B:FF:AA:04 Switch-1 Present N/A 00:00:00:00:00:00 N/A Table 54.
PAGE 49
Server-4-C Fibre Channel 4 Present Switch-1 None Present Not Installed N/A Not Installed 00:00:00:00:00: N/A 00 Table 55. Displays the user-defined MAC and WWN address. server-4-A IDRACController Present 00:22:19:D2:21:F N/A 5 Factory Gigabit Ethernet Present 84:2B:2B:1B: 3D:F6 Unknown IO-Identity iSCSI Present 84:2B:2B:1B: 3D:F9 Unknown IO-Identity Table 56.
PAGE 50
Server-16-C 10 GbE KR Present F8:DB:88:3D:6F: Unknown 4D FlexAddress Table 58. Displays Ethernet and iSCSI MAC/WWN address, Assignment Type, and Partition Status of all LOMs or mezzanine cards.
PAGE 51
– kvm – io-cable – fpc-cable • -A — Suppresses headers or labels in the output. Examples Display status of all the modules in the chassis racadm getmodinfo Display status of fan module 3 in the chassis racadm getmodinfo -m fan-3 • Table 60. Details of racadm getmodinfo -m switch-1 Switch-1 Present ON OK 0000000 N/A • Table 61.
PAGE 52
Switch-6 Not Present N/A N/A N/A N/A Server-1 Present ON OK ABC1234 ABC1234 Server-2 Present ON OK ABC1234 ABC1234 Server-3 Present ON OK BCD1234 BCD1234 Server-4 Present ON OK BCD1234 BCD1234 Server-5 Present ON OK BCD1234 BCD1234 Server-6 Present ON OK BCD1234 BCD1234 Server-7 Present ON OK BCD1234 BCD1234 Server-8 Present ON OK BCD1234 BCD1234 Server-9 Present ON OK BCD1234 BCD1234 Server-10 Present ON OK ABC1234 ABC1234 Server-11 Present
PAGE 53
Output NOTE: Table 63. Output IPv4 settings: NIC Enabled =1 IPv4 Enabled =1 DHCP Enabled =1 IP Address =10.94.225.165 Subnet Mask =255.255.255.128 Gateway =10.94.225.
PAGE 54
NOTE: IPv6 Address 1 field indicates static IP and IPv6 Address 2 field indicates dynamic IP. Example • Display CMC network settings racadm getniccfg -m chassis getpbinfo Table 64. Details of getpbinfo attribute Description Displays power budget status information. To run this subcommand, you must have the CMC Login User privilege. Synopsis racadm getpbinfo Input N/A Table 65.
PAGE 55
Available Power in EPP Pool = 0 W (0 BTU/h) Used Power in EPP Pool = 0 W (0 BTU/h) EPP Percent - Available = 0.0 Table 66. Chassis Power Supply Status Table PS1 08V4DK Online 1.0 A 240.0 V 3000 W PS2 08V4DK Online 1.9 A 239.2 V 3000 W PS3 08V4DK Online 1.1 A 239.5 V 3000 W PS4 08V4DK Online 1.1 A 239.5 V 3000 W PS5 08V4DK Online 1.0 A 239.8 V 3000 W PS6 08V4DK Online 1.9 A 239.
PAGE 56
getpminfo Table 68. Details of getpminfo attribute Description Displays power management status information. To run this subcommand, you must have the CMC Login User privilege. Synopsis racadm getpminfo Input N/A Table 69.
PAGE 57
Input Redundancy Reserve = 0 W Input Power Allocated to Servers = 1875 W Input Power Allocated to Chassis Infrastructure = 1402 W Total Input Power Available for Allocation = 13408 W Standby Input Power Capacity = 0 W getraclog Table 70. Details of getraclog attribute Description Synopsis The getraclog command displays CMC log entries. • racadm getraclog [-i] • racadm getraclog [-s ] [-c ] [--more] NOTE: If options are not provided, the entire log is displayed.
PAGE 58
Jul 31 14:15:49 CMC-4C2WXF1 Extended Power Performance is Enabled Jul 31 14:15:49 CMC-4C2WXF1 Extended Power Performance is Disabled • When Enhanced Logging mode is enabled, the output of getraclog is displayed similar to chassislog output. Using racadm config -g cfgRacTuning -o cfgRacTuneEnhancedLog 1 command, Enhanced Logging feature is enabled.
PAGE 59
Redundant getsel Table 73. Details of getsel attribute Description Displays all system event log (SEL) entries in CMC. Synopsis • racadm getsel [-i] [-m ] • racadm getsel [-s ][-c ] [-m ] [--more] NOTE: If no arguments are specified, the entire log is displayed. Input • —i — Displays the number of entries in the SEL. • -s — Displays the starting record number. • -c — Specifies the number of records to display.
PAGE 60
Table 75.
PAGE 61
7 Fan-7 OK 5524 rpm N/A 3508 N/A 9034 8 Fan-8 OK 5790 rpm N/A 3697 N/A 9034 9 Fan-9 OK 5790 rpm N/A 3697 N/A 9034 Table 79. Sensor Type:Temp 1 Ambient_Temp OK 22 C N/A N/A N/A 40 Sensor Type: Power Table 80.
PAGE 62
• • -i —Displays the ID of the slot. Legal values: 1–16 -h —Specifies whether to use the slot name, the host name, or the iDRAC DNS name. The following are the valid options: – 0 = Displays slot name. – 1 = Displays host name instead of slot name. – 2 = Displays the iDRAC DNS name instead of slot name. Example • Display the name of Slot 3. racadm getslotname -i 3 • Display all slots names.
PAGE 63
• -A — does not display headers or labels. Table 84. Example SSNID Type User IP Address Login Date/Time 58999 SSH root 192.168.0.10 04/07/2016 12:00:34 Display the details of sessions without header racadm getssninfo -A "43584" "SSH" "root" "192.168.0.10" "04/07/2016 12:00:34" • Display all currently active sessions for a specific user racadm getssninfo -u root getsvctag Table 85. Details of attribute Description Displays the service tag of the host system.
PAGE 64
• —6 — Displays IPv6 settings • —c — Displays common settings • —d — Displays CMC information • —A — Eliminates the printing of headers or labels Output racadm getsysinfo CMC Information: CMC Date/Time Primary CMC Location Primary CMC Version Standby CMC Version Last Firmware Updated Hardware Version = Wed Sep 17 2014 23:13 = CMC-1 = 5.00 = 5.
PAGE 65
• Display IPv4 details without header racadm getsysinfo -A "CMC IPv4 Information:" "1" "192.168.0.10" "192.168.0.10" "255.255.255.0" "1" "192.168.0.10" "0.0.0.0" "1" gettracelog Table 87. Details of attribute Description Displays the CMC diagnostic trace log. Synopsis • racadm gettracelog [-i] • racadm gettracelog [-s ] [-c ] [--more] • —i — Displays the number of entries in CMC trace log.
PAGE 66
Table 89. Details server-1 1.40.40 (Build 08) PowerEdge M520 iDRAC Y server-2 3.50 (Build 2) PowerEdgeM610x iDRAC6 Y server-4 3.50 (Build 4) PowerEdgeM710HD iDRAC6 Table 90. Details server-1 1.0.5 PowerEdgeM520 server-2 1.0.3 PowerEdgeM610x server-4 1.0.0 PowerEdgeM710HD server-5 1.0.3 PowerEdgeM710 server-7 1.0.6 PowerEdgeM620 server-9 1.0.5 PowerEdgeM520 ifconfig Table 91.
PAGE 67
To run this subcommand, you must have the Configure Chassis Administrator privilege. NOTE: This subcommand is only supported on the remote interface(s). Synopsis racadm krbkeytabupload [-f ] is the name of the file including the path. Input -f — Specifies the filename of the keytab uploaded. If the file is not specified, the keytab file in the current directory is selected. Example Upload a kerberos keytab file from the local filesystem: racadm krbkeytabupload -f c:\keytab\krbkeyta
PAGE 68
To run this subcommand, you must have the Administrator privilege. Synopsis racadm ping Input — The IP address of the remote endpoint to ping. Output PING 192.168.0 (192.168.0): 56 data bytes64 bytes from 192.168.0: seq=0 ttl=64 time=4.121 ms 192.168.0 ping statistics 1 packets transmitted, 1 packets received, 0 percent packet lossround-trip min/avg/max = 4.121/4.121/4.121 ms ping6 Table 98.
PAGE 69
• • • • • • KVM information — getkvminfo NIC information (CMC module) — getniccfg Redundancy information — getredundancymode Trace log information — gettracelog RAC event log — getraclog System event log — getsel Synopsis racadm racdump Input N/A Output The following information is displayed when this subcommand is processed: • • • • • General system or RAC information Coredump Session information Process information Firmware build information Example racadm racdump ================================
PAGE 70
=============================================================================== Sensor Information =============================================================================== FanSpeed 1 Fan-1 OK 14495 rpm FanSpeed 2 Fan-2 OK 14505 rpm FanSpeed 3 Fan-3 OK 4839 rpm FanSpeed 4 Fan-4 OK 14527 rpm FanSpeed 5 Fan-5 OK 14505 rpm FanSpeed 6 Fan-6 OK 4835 rpm FanSpeed 7 Fan-7 OK 14521 rpm FanSpeed 8 Fan-8 Not OK 1 rpm FanSpeed 9 Fan-9 OK 4826 rpm
PAGE 71
• To reset server 1 racadm racreset -m server-1 • To reset servers 1 and 3 racadm racreset -m server-1 -m server-3 racresetcfg Table 101. Details of racresetcfg attribute Description Deletes your current CMC configuration and resets CMC to the factory default settings. After reset, the default name and password are root and calvin, respectively, and the IP address is 192.168.0.120.
PAGE 72
• Reset blade 8 configuration from CMC. racadm racresetcfg -m server-8 The RAC configuration has initiated restoration to factory defaults. Wait up to a minute for this process to complete before accessing the RAC again. remoteimage Table 102. Details of remoteimage attribute Description Connects, disconnects, or deploys a media file on a remote server. To run this subcommand, you must log in with virtual media privilege for iDRAC.
PAGE 73
UserName Password ShareName //192.168.0/xxxx/dtk_3.3_73_Linux.iso • Deploy a remote image on iDRAC CIFS Share. racadm remoteimage –c –u admin –p xxx –l 192.168.0.1:/dev/floppy.img • Deploy a remote image on iDRAC NFS Share. racadm remoteimage –c –u admin –p xxx –l 192.168.0.1:/dev/floppy.img • Deploy a remote image on iDRAC HTTP Share. racadm remoteinage -c -u "user" -p "xxx" -l http://shrloc/foo.iso • Deploy a remote image on iDRAC HTTPS Share.
PAGE 74
serveraction Table 104. Details of serveraction attribute Description Enables you to perform power management operations on the blade system. To run this subcommand, you must have the Execute Server Control Commands permission. Synopsis Input • racadm serveraction -a • racadm serveraction -m • -m — Must be one of the following values: • – server–: where n=1–16 – server–: where n=1–8; x=a–d (enter lowercase letter only).
PAGE 75
• Get Power Status of blade 16 on CMC by using the following command: racadm serveraction -m server-16 powerstatus ON • Turn off the server 16 from CMC, when the power is already turned off on that server by using the following command: racadm serveraction -m server-16 powerdown Server is already powered OFF. • Power action on all servers by using the following command: racadm serveraction -a powerup setarraycfg Table 105.
PAGE 76
Example • Set member name, member IP, member netmask, member gateway with new group name, group IP, group password, admin password selecting fabric A on server-1. racadm setarraycfg -m server-1 -n cmc-col 192.168.1.233 255.255.255.0 192.168.1.0 -e 0 -g cmc-array-grp 192.168.1.10 -f A • Set member name, member IP, member netmask, member gateway with existing group name, group IP, group password selecting fabric B on server-1. racadm setarraycfg -m server-1 -n cmc-col 192.168.1.233 255.255.255.
PAGE 77
setflexaddr Table 108. Details of setflexaddr attribute Description Enables or disables FlexAddress on a particular slot or fabric. To run this subcommand, you must have the Chassis Configuration Administrator privilege. If the fabric type is determined to be InfiniBand, the operation is canceled and the command returns an error. If the FlexAddress feature is not activated, the command returns an error. NOTE: The server must be turned off to change the slot state.
PAGE 78
– switch–, where n=1–6 – cmc-active – chassis • -l — Specifies the LED state. The values are: – 0 — No Blinking – 1 — Blinking Example • racadm setled -m chassis -l 1 • Sets LED state on Chassis to Blink racadm setled -m server-1 -1 1 • LED state was set successfully. racadm setled -m server-9 -1 1 ERROR: Server in slot 9 is an extension of the server in slot 1. NOTE: The setled command generates an error when run on the extension slot of a multi-slot server. setniccfg Table 110.
PAGE 79
• – server–: where n=1–16 – server–: where n=1–8; x=a–d (lower case) – switch–: where n=1–6 -v — VLAN settings has following legal values: no arguments imply remove VLAN tag, not compatible with server–nx (for example "server–4b") notation =between 1 and 4000, 4021 and 4094, inclusive =between 0 and 7, inclusive. • -p — Disables IPv4(default) or IPv6 protocol.
PAGE 80
– hh is the hour – mm is the minute – ss is the second – mmmmmm is the number of microseconds – s is a + (plus) sign or a − (minus) sign, which indicates the sign of the offset. – off is the offset in minutes. NOTE: Theoff is the offset in minutes from GMT and must be in 15-minute increments. The timezone is represented as an offset from GMT. 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.
PAGE 81
NOTE: Synopsis Input • The special characters “ (double quotation mark), ‘ (backward quotation mark), & (ampersand), , (comma), \ (backward slash), ; (semicolon), ' (single quote), < (open angular bracket), and > (close angular bracket) are not supported for this subcommand. • 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 82
sshpkauth Table 114. Details of sshpkauth attribute Description Enables you to upload and manage up to 4 different SSH public keys for each user. You can upload a key file or key text, view keys, or delete keys. This command has three mutually exclusive modes determined by the options — upload, view, and delete. To run this subcommand, you must have Configure user privilege. NOTE: CMC accepts RSA keys up to key strength 4096, but the recommended key strength is 2048.
PAGE 83
wilU2VLw/iRH1ZymUFnut8ggbPQgqV2L8bsUaMqb5PooIIvV6hy4isCNJU= 1024-bit RSA, converted from OpenSSH by xx_xx@xx.xx Key ID 2: Key ID 3: Key ID 4: sslcertdownload Table 115. Details of sslcertdownload attribute Description Downloads an SSL certificate from CMC to the client’s file system. To run this subcommand, you must have the Server Control privilege. NOTE: This subcommand is only supported on the remote interface(s).
PAGE 84
• -k — Specifies optional source filename for private key when using type 6. racadm -r 192.168.0.2 -u root -p xxx sslcertupload -t 2 -f cert.txt Output Certificate successfully uploaded to the RAC. Example • Uploading a server certificate. racadm -r 192.168.0.2 -u root -p xxx sslcertupload -t 1 -f cert.txt • Upload web server certificate and key racadm -r 192.168.0.2 -u root -p xxx sslcertupload -t 6 -f cert.txt -k key.txt • Uploading Active Directory Certificate racadm -r 192.168.0.
PAGE 85
State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) CMC Default certificate Valid From Jul 7 23:54:19 2011 GMT Valid To Jun 4 23:54:19 2021 GMT racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group CMC default certificate US Texas Round Rock Dell Inc. Remote Access Group CMC default certificate Jun 7 23:54:19 2011 GMT Jun 4 23:54:19 2021 GMT sslcsrgen Table 119.
PAGE 86
NOTE: Output • If the -f option is not specified, the filename defaults to sslcsr in your current directory. • The -f option is only supported on the remote interface(s). If no options are specified, a CSR is generated and downloaded to the local file system as sslcsr by default. The -g option cannot be used with the -s option, and the -f option can only be used with the -g option. The sslcsrgen -s subcommand returns one of the following status codes: Example • • CSR was generated successfully.
PAGE 87
Example • -p—Password for the CIFS share that must be tested. • -l—The CIFS share location that must be tested. racadm testcifsshare -u shareme -p shareme -l //100.97.174.77/lccifs testemail Table 121. Details of testemail attribute Description Sends a test email from CMC to a specified destination. Prior to running the test email command, make sure that the SMTP server is configured. Synopsis racadm testemail -i Input -i — Specifies the index of the email alert to test.
PAGE 88
NOTE: -d option is only supported on the firmware interface or firmware interfaces. Example • To test AD. racadm testfeature -f AD -u joe@dell.com -p dell123 • To test ADKRB:. racadm testfeature -f ADKRB -u joe@dell.com • To test LDAP. racadm testfeature -f LDAP -u joe -p dell123 -d 0xf2 testtrap Table 123. Details of testtrap attribute Description Tests the RAC’s SNMP trap alerting feature by sending a test trap from CMC to a specified destination trap listener on the network.
PAGE 89
To run this subcommand, you must have the Administrator privilege. Synopsis racadm traceroute6 Input – Specifies IPv6 address. 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.
PAGE 90
3 CMC Property Database Group and Object Descriptions CMC property database contains the configuration information. Associated object is organizing data, and object group is organizing object. The IDs for the groups and objects that the property database supports are listed in this section. To configure CMC, use the group and object IDs with the RACADM subcommands. NOTE: You can configure a setting that does not have a hash symbol (#) as the prefix in its output name.
PAGE 91
• cfgNetTuning • cfgRacSecurity • cfgQuickDeploy Displayable Characters Displayable characters include the following set: abcdefghijklmnopqrstuvwxwz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/ Table 126.
PAGE 92
Subcommand CMC cfgAlerting Yes cfgLcdInfo Yes cfgIPv6LanNetworking Yes cfgCurrentLanNetworking Yes cfgCurrentIPv6LanNetworking Yes cfgNetTuning Yes cfgRacSecurity Yes idRacInfo This group contains display parameters to provide information about the specifics of CMC being queried. One instance of the group is allowed. Use this object with the getconfig subcommand. To use this object, you must have the CMC Login User privilege.
PAGE 93
idRacVersionInfo (Read Only) Table 129. Details of Read only attribute - idRacVersionInfo Description String containing the current product firmware version Legal Values A string of up to 63 ASCII characters. Default The current version number. idRacBuildInfo (Read Only) Table 130. Details of Read only attribute - idRacBuildInfo Description String containing the current RAC firmware build version. Legal Values A string of up to 16 ASCII characters. Default The current CMC firmware build version.
PAGE 94
# idRacDescriptionInfo=This system component provides a complete set of remote management functions for blade servers # idRacVersionInfo=P21 # idRacBuildInfo=200708301525 # idRacName=CMC-1 racadm getconfig -g idRacInfo # idRacType=16 # idRacProductInfo=Integrated Dell Remote Access Controller # idRacDescriptionInfo=This system component provides a complete set of remote management functions for Dell PowerEdge Servers # idRacVersionInfo=1.06.
PAGE 95
• 0 (FALSE) Default 0 Example racadm config -g cfgLanNetworking -o cfgNicVLanEnable 1 racadm config -g cfgLanNetworking -o cfgNicVLanEnable 0 cfgNicVLanID (Read or Write) Table 135. Details of attribute - cfgNicVLanID Description Specifies the VLAN ID for the network VLAN configuration. This property is only valid if cfgNicVLanEnable is set to 1(enabled).
PAGE 96
NOTE: Microsoft Active Directory only supports Fully Qualified Domain Names (FQDN) of 64 bytes or fewer. Default cfgDNSDomainNameFromDHCP (Read or Write) Table 138. Details of attribute - cfgDNSDomainNameFromDHCP Description Specifies that CMC DNS domain name must be assigned from the network DHCP server. Legal Values • 1 — True • 0 — False 0 Default This property is used only if cfgNicUseDhcp is set to 1(true), or if both cfgIPv6Enable and cfgIPv6AutoConfig are set to 1(true).
PAGE 97
cfgDNSServer1 (Read or Write) Table 140. Details of attribute - cfgDNSServer1 Description Specifies the IPv4 address for DNS server 1. This property is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE). NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses. Legal Values String representing a valid IPv4 address. For example: 192.168.0.20. Default 0.0.0.0 cfgDNSRacName (Read or Write) Table 141.
PAGE 98
Example: racadm getconfig -g cfgLanNetworking cfgNicEnable=1 cfgNicIPv4Enable=1 cfgNicIpAddress=192.168.22.101 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.22.101 cfgNicUseDhcp=1 # cfgNicMacAddress=00:00:00:00:00:01 cfgNicVLanEnable=0 cfgNicVLanID=1 cfgNicVLanPriority=0 cfgDNSServersFromDHCP=1 cfgDNSServer1=192.168.0.5 cfgDNSServer2=192.168.0.6 cfgDNSRacName=cmc-frankly cfgDNSDomainName=fwad.lab cfgDNSDomainNameFromDHCP=1 cfgDNSRegisterRac=1 cfgDNSServer2 (Read or Write) Table 143.
PAGE 99
Default 1 cfgNicIpAddress (Read or Write) Table 145. Details of attribute - cfgNicIpAddress Description Specifies the static IPv4 address. 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 • 192.168.0.120 cfgNicNetmask (Read or Write) Table 146. Details of attribute - cfgNicNetmask Description The subnet mask used for IP address.
PAGE 100
cfgNicUseDhcp (Read or Write) Table 148. Details of attribute - cfgNicUseDhcp Description Specifies whether DHCP is used to assign the IPv4 address. If this property is set to 1 (TRUE) then the 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. Legal Values • 1 (TRUE) • 0 (FALSE) 0 Default cfgNicMacAddress (Read Only) Table 149.
PAGE 101
cfgRhostsFwUpdateIpAddr (Read or Write) Table 151. Details of attribute - cfgRhostsFwUpdateIpAddr Description Specifies the network TFTP server IPv4 or IPv6 address that is used for TFTP 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 or Write) Table 152.
PAGE 102
cfgRhostsNtpServer1 (Read or Write) Table 155. Details of attribute - cfgRhostsNtpServer1 Description Specifies the first of three possible NTP servers. Legal Values A string representing a valid NTP server. For example, ntp1.ntp.net. At least one NTP server must be specified and duplicate entries are not allowed. Default Null cfgRhostsNtpServer2 (Read or Write) Table 156. Details of attribute - cfgRhostsNtpServer2 Description Specifies the second of three possible NTP servers.
PAGE 103
cfgRhostsSyslogEnable (Read or Write) Table 159. Details of attribute - cfgRhostsSyslogEnable Description To allow the RAC and SEL logs to be written to up to three remote syslog servers Enables or disables remote syslog. Legal Values • 1 (TRUE) • 0 (FALSE) Default 0 cfgRhostsSyslogPort (Read or Write) Table 160. Details of attribute - cfgRhostsSyslogPort Description Remote syslog port number to use for writing the RAC and SEL logs to a remote syslog server.
PAGE 104
Default cfgRhostsSyslogServer3 Read or Write) Table 163. Details of attribute - cfgRhostsSyslogServer3 Description To store the RAC and SEL logs specify the third of three possible remote syslog servers. This property is only valid if cfgRhostsSyslogEnable is set to 1(enabled). Legal Values Valid host name or IPv4 or IPv6 address. Default cfgRhostsSyslogPowerLoggingEnabled Read or Write) Table 164.
PAGE 105
cfgRhostsSyslogServer1= cfgRhostsSyslogServer2= cfgRhostsSyslogServer3=cfgRhostsSyslogPowerLoggingEnabled=1 cfgRhostsSyslogPowerLoggingInterval=5 cfgUserAdmin This group provides configuration information about the users allowed to access CMC through the available remote interfaces. Up to 16 instances of the user group are allowed. Each instance represents the configuration for an individual user.
PAGE 106
Table 168.
PAGE 107
Fabric B Administrator 0x0000400 Fabric C Administrator 0x0000800 Table 169. Examples User Privileges Privilege Bit Mask The user is not allowed to access iDRAC or CMC 0x00000000 The user may only log in to iDRAC or CMC and view iDRAC or CMC and server configuration information. 0x00000001 The user may log in to iDRAC or CMC and change configuration. 0x00000001 + 0x00000002 = 0x00000003 The user may log in to iDRAC, access Virtual Media, and Virtual Console.
PAGE 108
cfgUserAdminPassword - Write Only Table 171. Details of cfgUserAdminPassword attribute Description The password for this user. User passwords are encrypted and cannot be seen or displayed after the property is written. Legal Values A string of up to 20 ASCII characters. Default ******** cfgUserAdminEnable - Read or Write Table 172. Details of cfgUserAdminEnable attribute Description Enables or disables an individual user.
PAGE 109
cfgEmailAlertEnable - Read or Write Table 174. Details of cfgEmailAlertEnable attribute Description Enables or disables the alert instance. Legal Values • 1 (TRUE) • 0 (FALSE) Default 0 cfgEmailAlertAddress - Read or Write Table 175. Details of cfgEmailAlertAddress attribute Description Specifies the destination email address for email alerts, for example, user1@company.com. Legal Values Email address format, with a maximum length of 64 ASCII characters.
PAGE 110
cfgSsnMgtRacadmTimeout (Read or Write) Table 177. Details of cfgSsnMgtRacadmTimeout attribute Description Defines the idle timeout in seconds for the Remote RACADM interface. If a remote RACADM session remains inactive for more than the specified sessions, the session closes.
PAGE 111
cfgSsnMgtTelnetIdleTimeout - Read or Write Table 180. Details of cfgSsnMgtTelnetIdleTimeout attribute Description Defines the Telnet idle timeout. This property sets the amount of time in seconds that a connection is allowed to remain idle (there is no user input). The session is canceled if the time limit exceeds this property. Changes to this setting do not affect the current session (you must log out and log in again to make the new settings effective.
PAGE 112
1 Default cfgSerialConsoleQuitKey (Read or Write) Table 183. Details of cfgSerialConsoleQuitKey attribute Description Legal value: NOTE: The CTRL key is represented by using the ^ (carat) character. 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 ^\.
PAGE 113
cfgSerialConsoleCommand - Read or Write Table 186. Details of cfgSerialConsoleCommand attribute Description Specifies a serial command that is executed after a user logs in to the serial console interface. Legal Values A string representing a valid serial command. For example, connect server-1. Default cfgSerialConsoleColumns - Read or Write Table 187.
PAGE 114
1 Default 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 or Write Table 190. Details of cfgSerialTelnetEnable attribute Description Enables or disables the Telnet console interface.
PAGE 115
Default public Example racadm getconfig -g cfgOobSnmp cfgOobSnmpTrapsEnable=1 cfgOobSnmpAgentCommunity=public cfgOobSnmpAgentEnable (Read or Write) Table 192. Details of cfgOobSnmpAgentEnable attribute Description Enables or disables the SNMP agent in CMC. Legal Values • 1 (TRUE) • 0 (FALSE) Default 0 cfgOobSnmpProtocol Table 193. Details of cfgOobSnmpProtocol attribute Description Specifies the SNMP protocol used for SNMP traps.
PAGE 116
To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have the hash sign (#) prefixed in the output. To modify a configurable object, use the —o option. cfgTrapsIndex (Read Only) Table 195. Details of cfgTrapsIndex attribute Description Indicates the unique index of an alert instance. Legal Values 1–4 Default 1 cfgTrapsEnable (Read or Write) Table 196.
PAGE 117
Default None Example racadm getconfig -g cfgTraps -i 2 # cfgTrapsIndex=2 cfgTrapsEnable=1 cfgTrapsAlertDestIpAddr= cfgTrapsCommunityName=public cfgTrapsSNMPv3UserId (Read Only) Table 199. Details of cfgTrapsSNMPv3UserId attribute Description Displays the SNMP user ID of an existing CMC user. Legal Values 1-16 Default Empty cfgTrapsSNMPv3UserName Table 200. Details of cfgTrapsSNMPv3UserName attribute Description Configure SNMPv3 user name. Legal Values Any existing CMC user name.
PAGE 118
cfgRacTuneSMBVersionEnable Table 201. Details of cfgUseCMCDNSSettings attribute Can be used for setting the SMB version. Description Legal Values • • • • • • Default NA SMBv1 SMBv2 SMBv3 1 2 3 cfgRacTuneRemoteRacadmEnable (Read or Write) Table 202. Details of cfgRacTuneRemoteRacadmEnable attribute Description Enables or disables the Remote RACADM interface. Legal Values • 1 (TRUE) • 0 (FALSE) 1 Default cfgRacTuneIdracDNSLaunchEnable (Read or Write) Table 203.
PAGE 119
cfgRacTuneEnhancedLog (Read or Write) Table 204. Details of cfgRacTuneEnhancedLog attribute Description Enables or disables the enhanced chassis log feature. Legal Values • • Default 0 1 — Enable 0 — Disable cfgRacTuneHttpPort (Read or Write) Table 205. Details of cfgRacTuneHttpPort attribute Description To use HTTP network communication, specify the port number.
PAGE 120
• 0 (FALSE) 0 Default cfgRacTuneIpRangeAddr (Read or Write) Table 208. Details of cfgRacTuneIpRangeAddr attribute Description Specifies the acceptable IPv4 address bit pattern in the positions of the "1"s in the range mask property (cfgRacTuneIpRangeMask).
PAGE 121
cfgRacTuneIpBlkFailCount (Read or Write) Table 211. Details of cfgRacTuneIpBlkFailCount attribute Description The maximum number of logins that is not successful, to occur within the window (cfgRacTuneIpBlkFailWindow) before log in attempt from the IP address is rejected. Legal Values 3–16 Default 5 cfgRacTuneIpBlkFailWindow (Read or Write) Table 212. Details of cfgRacTuneIpBlkFailWindow attribute Description Defines the time span in seconds that the unsuccessful attempts are counted.
PAGE 122
cfgRacTuneUserBlkEnable (Read or Write) Table 215. Details of cfgRacTuneUserBlkEnable attribute Description Blocks the login for maximum of 5 minutes after 5 unsuccessful login attempts. The login using any interface such as WSMAN or GUI is blocked after 5 unsuccessful attempts NOTE: This is applicable only to configure the user privilege. Legal Values • 1 — Enabled • 0 — Disabled 0 — Disabled Default cfgRacTuneSshPort (Read or Write) Table 216.
PAGE 123
cfgRacTuneDaylightOffset (Read Only) Table 218. Details of cfgRacTuneDaylightOffset attribute Description Specifies the daylight savings offset (in minutes) to use for the RAC Time. This value is 0 if the time zone is not a Daylight Saving time zone.
PAGE 124
# cfgRacTuneTimezoneOffset=-18000 # cfgRacTuneDaylightOffset=3600 cfgRacTuneWebserverEnable (Read or Write) Table 220. Details of cfgRacTuneWebserverEnable attribute Description Enables or disables the web server. If this property is disabled then it is not accessible using client web browsers. This property has no effect on the Telnet/SSH or racadm interfaces. Legal Values • 1 (TRUE) • 0 (FALSE) 1 Default cfgRacTuneFipsModeEnable Table 221.
PAGE 125
cfgRacTuneChassisNameInPromptEnable Table 223. Details of cfgRacTuneChassisNameInPromptEnable attribute Description Enables or disables display of the chassis name in the SSH prompt. Legal Values • • Default 0 0—Disable 1—Enable NOTE: You must have the chassis configuration administrator privilege to set and get the cfgRacTuneChassisNameInPromptEnable attribute. cfgServerInfo This group allows you to display and configure a server in the chassis.
PAGE 126
cfgServerServiceTag (Read Only) Table 226. Details of cfgServerServiceTag attribute Description Displays the service tag of the specified server. Legal Values None Default None cfgServerName (Read Or Write) Table 227. Details of cfgServerName attribute Description Displays the name of the specified server. 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.
PAGE 127
cfgServerBmcMacAddress (Read Only) Table 230. Details of cfgServerBmcMacAddress attribute Description Displays the BMC MAC address of the specified server. Legal Values None Default None cfgServerNic1MacAddress (Read Only) Table 231. Details of cfgServerNic1MacAddress attribute Description Displays the MAC address of the server NIC 1. Legal Values None Default None cfgServerNic2MacAddress (Read Only) Table 232.
PAGE 128
cfgServerNicEnable (Read or Write) Table 234. Details of cfgServerPriority attribute Description Enables or disables LAN channel. Legal Values • 1 — Enable • 0 — Disable None Default cfgServerIPMIOverLanEnable (Read or Write) Table 235. Details of cfgServerIPMIOverLanEnable attribute Description Enables or disables IPMI LAN channel. Legal Values • 1 — Enable • 0 — Disable None Default cfgServerPowerBudgetAllocation (Read Only) Table 236.
PAGE 129
cfgServerDNSIMCName (Read or Write) Table 238. Details of cfgServerDNSIMCName attribute Description Displays the DNS domain name for iDRAC or IMC. Legal Values A valid string values Default None Usage You can get and set the iDRAC DNS name using the cfgServerDNSIMCName attribute.
PAGE 130
cfgServerFirstBootDevice (Read or Write) Table 240. Details of cfgServerFirstBootDevice attribute Description Sets or displays the first boot device. NOTE: First attach, to configure vFlash as First Boot Device.
PAGE 131
Default None Example racadm getconfig -g cfgServerInfo -i 1a # cfgServerInfoIndex=1a # cfgServerSlotNumber=1a # cfgServerServiceTag=ABC1234 cfgServerName=SLOT-01a # cfgServerFW=1.57.57 (Build 04) # cfgServerBIOS=2.3.
PAGE 132
cfgADRacDomain (Read or Write) Table 243. Details of cfgADRacDomain attribute Description Active Directory Domain in which CMC resides. Legal Values Any printable text string of up to 254 characters, with no white space. Default cfgADRacName (Read or Write) Table 244. Details of cfgADRacName attribute Description Name of CMC as recorded in the Active Directory forest. Legal Values Any printable text string of up to 254 characters, with no white space.
PAGE 133
cfgADSCLEnable (Read or Write) Table 247. Details of cfgADSCLEnable attribute Description Enables or disables Smart Card login on CMC. Legal Values • 1 (Enable) • 0 (Disable) Default 0 cfgADSSOEnable (Read or Write) Table 248. Details of cfgADSSOEnable attribute Description Enables or disables Active Directory single sign-on authentication on CMC. Legal Values • 1 (TRUE) • 0 (FALSE) Default 0 cfgADDomainController (Read or Write) Table 249.
PAGE 134
cfgADType (Read or Write) Table 251. Details of cfgADType attribute Description To use the Active Directory, determine the schema type. Legal Values • 1— (Enables Active Directory with the extended schema) • 2— (Enables Active Directory with the standard schema) 1 Default cfgADSpecifyServerEnable (Read or Write) Table 252. Details of cfgADSpecifyServerEnable attribute Description Allows you to enable or disable and specify an LDAP server or a global catalog server.
PAGE 135
cfgADDomainController= cfgADGlobalCatalog= cfgADCertValidationEnable (Read or Write) Table 254. Details of cfgADCertValidationEnable attribute Description Enables or disables Active Directory certificate validation as a part of the Active Directory configuration process. Legal Values • 1 (TRUE) • 0 (FALSE) Default 1 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 136
NOTE: You can specify multiple servers by separating each server with a comma. For example, example.com, sub1.example.com Legal Values String. Maximum length = 254 Null Default cfgLDAPPort (Read or Write) Table 257. Details of cfgLDAPPort attribute Description Port of LDAP over SSL. Non-SSL port is not supported. Legal Values 1–65535 Default 636 cfgLDAPBaseDN (Read or Write) Table 258.
PAGE 137
cfgLDAPGroupAttribute (Read or Write) Table 260. Details of cfgLDAPGroupAttribute attribute Description Specifies which LDAP attribute is used to check for group membership. It must be an attribute of the group class. If not specified then the member and unique member attributes are used. Legal Values String maximum length = 254 Default Null cfgLDAPGroupAttributeIsDN (Read or Write) Table 261.
PAGE 138
Null Default cfgLDAPSearchFilter (Read or Write) Table 264. Details of cfgLDAPSearchFilter attribute Description To validate LDAP search filter, use the user attribute that cannot uniquely identify the login user within the chosen baseDN. The search filter only applies to userDN search and not the group membership search. Legal Values String of maximum length = 1024 characters Default (objectless=*) Searches for all objects in tree. cfgLDAPCertValidationEnable (Read or Write) Table 265.
PAGE 139
cfgLDAPSRVLookupEnable (Read or Write) Table 268. Details of cfgLDAPSRVLookupEnable attribute Description To query a DNS server for SRV records, Configure the CMC. Legal Values • 1 — True • 0 — False Default 0 cfgLDAPSRVLookupDomainName (Read Only) Table 269. Details of cfgLDAPSRVLookupDomainName attribute Description To use in the SRV lookup, configure the domain name. Legal Values String of maximum length of 254 alphanumeric characters and hyphens. The string must begin with a letter.
PAGE 140
Each LDAP-authenticated user assumes the total set of CMC privileges assigned to the matching LDAP distinguished names that the user belongs to. That is, if the user belongs to multiple role group DNs, the user receives all associated privileges for that DNs. The following sections provide information about the objects in the cfgLdapRoleGroup. cfgLDAPRoleGroupIndex (Read Only) Table 271. Details of cfgLDAPRoleGroupIndex attribute Description It is the index value of the Role Group Object.
PAGE 141
To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have hash sign (#) prefixed in the output. To modify a configurable object, use the —o option. The following sections provide information about the objects in the cfgStandardSchema. cfgSSADRoleGroupIndex (Read Only) Table 274. Details of cfgSSADRoleGroupIndex attribute Description Index of the Role Group as recorded in the Active Directory.
PAGE 142
Default cfgLocation This group defines objects that support physical location properties. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. cfgLocationDataCenter (Read or Write) Table 278. Details of cfgLocationDataCenter attribute Description Indicates data center name. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationAisle (Read or Write) Table 279.
PAGE 143
cfgLocationRackslot (Read or Write) Table 281. Details of cfgLocationRackslot attribute Description Indicates slot where server is located. Legal Values Values 1–255 (1 Byte) Default 0 cfgLocationDeviceSize (Read Only) Table 282. Details of cfgLocationDeviceSize attribute Description Indicates server chassis size. Legal Values Values 1–255 Default 0 cfgChassisPower This group contains parameters to display or configure power for the chassis.
PAGE 144
Default 0 — Disabled cfgChassisEPPEnable (Read or Write) Table 284. Details of cfgChassisEPPEnable attribute Description Enables the Extended Power Performance (EPP). Legal Values • 1 — Enabled • 0 — Disabled Default 0 — Disabled NOTE: For chassis with 3000W AC six PSU configuration (configured for Grid Redundancy policy), the default value is 1–Enabled. cfgChassisInPower (Read Only) Table 285.
PAGE 145
Default None cfgChassisMinPower (Read Only) Table 288. Details of cfgChassisMinPower attribute Description Since the user has cleared last value, the system power consumption (in watts) is maximum. Legal Values None Default None cfgChassisMinPowerTimestamp (Read Only) Table 289. Details of cfgChassisMinPowerTimestamp attribute Description The timestamp recorded when the minimum system power occurred. Legal Values None Default None cfgChassisPowerStatus (Read Only) Table 290.
PAGE 146
cfgChassisRedundantState (Read or Write) Table 291. Details of cfgChassisRedundantState attribute Description Enables or disables power redundancy for the chassis. Legal Values • 0 — No Redundancy • 1 — Grid Redundancy • 2 — PSU Redundancy Default 0 cfgChassisDefaultPowerCapLowerBoundBTU (Read Only) Table 292. Details of cfgChassisDefaultPowerCapLowerBoundBTU attribute Description Displays the default power cap lower bound value using British Thermal Unit (BTU).
PAGE 147
cfgChassisDefaultPowerCapUpperBoundBTU (Read or Write) Table 295. Details of cfgChassisDefaultPowerCapUpperBoundBTU attribute Description Displays the default power cap upper bound value using British Thermal Unit (BTU). Legal Values None Default 56931 BTU/h cfgChassisPowerCap (Read or Write) Table 296. Details of cfgChassisPowerCap attribute Description Indicates the maximum power consumption limit (in watts) for the entire chassis.
PAGE 148
cfgChassisPowerCapFBTU (Read or Write) Table 299. Details of cfgChassisPowerCapFBTU attribute Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. Use cfgChassisCapFBTU when power consumption changes regardless of whether server throttling is required. The command generates an error if the value for this setting is lower than the minimum power required for the chassis configuration.
PAGE 149
cfgChassisRedundancyPolicy (Read or Write) Table 302. Details of cfgChassisRedundancyPolicy attribute Description Sets the redundancy policy of the chassis. Legal Values • 0 — No redundancy • 1 — Grid redundancy • 2 — Power supply redundancy Default 0 — No redundancy cfgChassisDynamicPSUEngagementEnable (Read or Write) Table 303. Details of cfgChassisDynamicPSUEngagementEnable attribute Description Enables or disables dynamic engagement.
PAGE 150
Default 0 cfgChassisMaxPowerConservationMode (Read or Write) Table 306. Details of cfgChassisMaxPowerConservationMode attribute Description Enables or disables maximum power conservation mode. When enabled, all servers are immediately reduced to their minimum power levels, and all subsequent server power allocation requests are denied. In this mode, performance of powered on servers may be degraded and more servers cannot be powered on, regardless of server priority.
PAGE 151
cfgChassisInMaxPowerCapacity (Read Only) Table 309. Details of cfgChassisInMaxPowerCapacity attribute Description Indicates the total chassis power budget (in watts) available for chassis operation. Legal Values None Default None cfgChassisInRedundancyReserve (Read Only) Table 310. Details of cfgChassisInRedundancyReserve attribute Description Indicates the amount of redundant power (in watts) in reserve that can be used in the event if an AC grid or PSU is unsuccessful.
PAGE 152
cfgChassisTotalInPowerAvailable (Read Only) Table 313. Details of cfgChassisTotalInPowerAvailable attribute Description Indicates the amount of power (in watts) available for use by the chassis. Legal Values None Default None cfgChassisStandbyInPowerCapacity (Read Only) Table 314.
PAGE 153
cfgChassisPowerButtonEnable (Read or Write) Table 317. Details of cfgChassisPowerButtonEnable attribute Description Indicates if the chassis power button is enabled or disabled. Legal Values • • Default None 0 — Disabled 1 — Enabled cfgSystemEnergyConsumptionClear (Write Only) Table 318. Details of cfgSystemEnergyConsumptionClear attribute Description Resets energy statistics when set to 1.
PAGE 154
Clears cfgChassisMinPower and cfgChassisPeakPower. cfgChassisACPowerRecoveryDisable Table 319. Details of cfgChassisACPowerRecoveryDisable attribute Description If AC power recovery is disabled, the chassis is powered off after power outage is restored. Legal Values • • Default 0 0 — Enable 1 — Disable cfgThermal This group displays and configures the thermal settings. Use this object with the config or getconfig subcommands.
PAGE 155
To use this object property, you must have Chassis Configuration Administrator privilege. cfgKVMAccessToCMCEnable (Read or Write) Table 322. Details of cfgKVMAccessToCMCEnable attribute Description Enables or disables the Dell CMC Console access on the iKVM. Legal Values • 1 (Enable) • 0 (Disable) Default None cfgKVMFrontPanelEnable (Read or Write) Table 323. Details of cfgKVMFrontPanelEnable attribute Description Enables or disables front panel access on the iKVM.
PAGE 156
Default en Example racadm config -g cfgLcdInfo -o cfgLcdLocale en Object value modified successfully. cfgAlerting This group enables or disables SNMP event trap alerting and sets the event filter. Use this object with the config or getconfig subcommands. cfgAlertingEnable (Read or Write) Table 325. Details of cfgAlertingEnable attribute Description Enables or disables event traps on the CMC.
PAGE 157
Examples racadm getconfig -g cfgAlerting -o cfgAlertingSourceEmailName racadm config -g cfgAlerting -o cfgAlertingSourceEmailName user@home.com Object value modified successfully To use this object property, you must have Chassis Configuration Administrator and Test Alert User privileges. cfgIPv6LanNetworking This group is used to configure the IPv6 over LAN networking capabilities. Use this object with the config or getconfig subcommands.
PAGE 158
NOTE: This property is used only if cfgIPv6AutoConfig is set to 0 (false). Legal Values Specifies string representing a valid IPv6 entry. Default “ :: “ cfgIPv6PrefixLength (Read or Write) Table 331. Details of cfgIPv6PrefixLength attribute Description Specifies the prefix length for IPv6 address. NOTE: • Legal Values 0–128 Default 64 This property is used only if cfgIPv6AutoConfig is set to 0(false) cfgIPv6AutoConfig (Read or Write) Table 332.
PAGE 159
0 (FALSE) Default 1 cfgIPv6DNSServer1 (Read or Write) Table 334. Details of cfgIPv6DNSServer1 attribute Description Specifies the IPv6 DNS server address. NOTE: This property is used only if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). Legal Values A string representing a valid IPv6 entry. For example, 2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF Default “ :: “ cfgIPv6DNSServer2 (Read or Write) Table 335. Details of cfgIPv6DNSServer2 attribute Description Specifies the IPv6 DNS server address.
PAGE 160
• cfgDNSServer1 • cfgDNSServer2 cfgCurrentLanNetworking (Read Only) This group displays the current CMC NIC properties. Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. Synopsis racadm getconfig -g cfgCurrentLanNetworking cfgNicCurrentIpAddress (Read Only) Table 336. Details of cfgNicCurrentIpAddress attribute Description Displays the static IP address to the CMC.
PAGE 161
cfgNicCurrentDhcpWasUsed (Read Only) Table 339. Details of cfgNicCurrentDhcpWasUsed attribute Description Indicates whether DHCP is used to configure the NIC. Legal Values 0 — address is static. 0 — address was obtained from the DHCP server. Default None cfgNicCurrentVlanEnable (Read Only) Table 340. Details of cfgNicCurrentVlanEnable attribute Description Indicates whether the VLAN is enabled.
PAGE 162
cfgDNSCurrentServer1 (Read Only) Table 343. Details of cfgDNSCurrentServer1 attribute Description Displays the IP address for DNS server 1. Legal Values A Valid IPv4 DNS IP Default 0.0.0.0 cfgDNSCurrentServer2 (Read Only) Table 344. Details of cfgDNSCurrentServer2 attribute Description Displays the IP address for DNS server 2. Legal Values A Valid IPv4 DNS IP Default 0.0.0.0 cfgDNSCurrentDomainName (Read Only) Table 345.
PAGE 163
# # # # # # # # # # cfgNicCurrentIpAddress=143.166.152.116 cfgNicCurrentNetmask=255.255.255.0 cfgNicCurrentGateway=143.166.152.1 cfgNicCurrentDhcpWasUsed=0 cfgNicCurrentVlanEnable=0 cfgNicCurrentVlanID=1 cfgNicCurrentVlanPriority=0 cfgDNSCurrentServer1=192.168.0.5 cfgDNSCurrentServer2=192.168.0.6 cfgDNSCurrentDomainName=MYDOMAIN cfgCurrentIPv6LanNetworking (Read Only) This group displays the current CMC IPv6 properties. Use this object with the getconfig subcommand.
PAGE 164
cfgCurrentLinkLocalAddress (Read Only) Table 349. Details of cfgCurrentLinkLocalAddress attribute Description Displays the current IPv6 link-local address of the CMC. Legal Values None Default None cfgCurrentIPv6Address (Read Only) Table 350. Details of cfgCurrentIPv6Address attribute Description Displays the current IPv6 addresses. This property displays up to 15 global IPv6 addresses, including stateful and stateless addresses.
PAGE 165
cfgCurrentIPv6DNSServer1 (Read Only) Table 353. Details of cfgCurrentIPv6DNSServer1 attribute Description Displays the IPv6 address for DNS server 1. Legal Values Default None cfgCurrentIPv6DNSServer2 (Read Only) Table 354. Details of cfgCurrentIPv6DNSServer2 attribute Description Displays the IPv6 address for DNS server 2.
PAGE 166
cfgNetTuningNicSpeed (Read or Write) Table 355. Details of cfgNetTuningNicSpeed attribute Description Specifies the speed for the CMC NIC. This property is used only if cfgNetTuningNicAutoNeg is set to 0. Legal Values 10, 100, or 1000 Default 100 cfgNetTuningNicAutoneg (Read or Write) Table 356. Details of cfgNetTuningNicAutoneg attribute Description Enables auto negotiation of physical link speed and duplex. If enabled, auto negotiation takes priority over other values set in this group.
PAGE 167
cfgNetTuningNicMtu (Read or Write) Table 358. Details of cfgNetTuningNicMtu attribute Description Indicated the maximum size of units in bytes transmitted by 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. cfgRacSecurity This group is used to configure settings related to CMC SSL certificate signing request (CSR) feature.
PAGE 168
cfgRacSecCsrOrganizationUnit (Read or Write) Table 361. Details of cfgRacSecCsrOrganizationUnit attribute Description Specifies the CSR Organization Unit (OU). Legal Values A string of up to 64 characters. Default cfgRacSecCsrLocalityName (Read or Write) Table 362. Details of cfgRacSecCsrLocalityName attribute Description Specifies the CSR Locality (L). Legal Values A string of up to 128 characters. Default cfgRacSecCsrStateName (Read or Write) Table 363.
PAGE 169
cfgRacSecCsrEmailAddr (Read or Write) Table 365. Details of cfgRacSecCsrEmailAddr attribute Description Specifies the CSR email address. Legal Values A string of up to 64 characters. Default Example racadm config -g cfgRacSecurity cfgRacSecCsrKeySize=1024 cfgRacSecCommonName= cfgRacSecOrganizationName= cfgRacSecOrganizationUnit= cfgRacSecLocalityName= cfgRacSecStateName= cfgRacSecCountryCode= cfgRacSecEmailAddr= cfgRacSecCsrKeySize (Read or Write) Table 366.
PAGE 170
0 Default cfgSetiDRACRootPasswordOnServerInsertion Table 368. Details of cfgSetiDRACRootPasswordOnServerInsertion attribute Description Sets the iDRAC root password when a server is inserted into the chassis. Legal Values • • 0 (False) — If the value is ‘1’ when the server is inserted, the iDRAC root password is not set. 1 (True) — If the value is ‘1’ when the server is inserted, the iDRAC root password is set. 0 Default cfgiDRACRootPassword Table 369.
PAGE 171
• Default 1 — Enable 1 cfgEnableiDRACIPMIOverLAN Table 372. Details of cfgEnableiDRACIPMIOverLAN attribute Description Enables IPMI over LAN channel for iDRAC when servers are inserted into the chassis. Legal Values • 0 — Disable • 1 — Enable Default 0 cfgEnableiDRACIPv4DHCP Table 373. Details of cfgEnableiDRACIPv4DHCP attribute Description Enables DHCP for iDRAC when servers are inserted into the chassis.
PAGE 172
cfgiDRACIPv4GateWay Table 375. Details cfgiDRACIPv4GateWay attribute Description IPv4–specific default gateway that is common to all the IPv4–enabled iDRACs present in the chassis. Legal Values IP format Default 0.0.0.0 cfgiDRACIPv4Netmask Table 376. Details of cfgiDRACIPv4Netmask attribute Description IPv4–specific subnet mask that is common to all iDRACs present in the chassis. Legal Values IP format Default 255.255.255.0 cfgEnableiDRACIPv6 Table 377.
PAGE 173
cfgiDRACIPv6PrefixLength Table 379. Details of cfgiDRACIPv6PrefixLength attribute The length of the subnet in bits that is common to all IPv6-enabled iDRACs present in the chassis. Description Legal Values 0–128 Default 64 cfgiDRACIPv6Gateway Table 380. Details of cfgiDRACIPv6Gateway attribute Description IPv6-specific default gateway that is common to all IPv6-enabled iDRACs present in the chassis. Legal Values IPv6 format Default :: cfgReservedIPAddressNumbers Table 381.
PAGE 174
cfgServerDNSIMCNameEnable Table 383. Details of cfgServerDNSIMCNameEnable attribute Description Enables or disables configuration of the iDRAC DNS name prefix for blade servers that you want to insert in the chassis. NOTE: You can set the cfgServerDNSIMCNamePrefix only if the cfgServerDNSIMCNameEnable is set to 1. Else, an error message is displayed. Legal Values • • Default 0 0—Disable 1—Enable cfgServerDNSIMCNamePrefix Table 384.