Chassis Management Controller Version 2.2 for Dell PowerEdge VRTX RACADM Command Line Reference Guide October 2016 Rev.
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. Copyright © 2017 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction................................................................................................................ 12 What’s New in This Release............................................................................................................................................ 12 Supported RACADM Interfaces......................................................................................................................................12 RACADM Syntax Usage...........
getpciecfg........................................................................................................................................................................... 53 getpminfo............................................................................................................................................................................ 55 getraclog.....................................................................................................................................
deletesecuritykey.........................................................................................................................................................94 encryptvd...................................................................................................................................................................... 94 cryptographicerase..............................................................................................................................................
cfgNicGateway (Read/Write)................................................................................................................................. 121 cfgNicMacAddress (Read Only)............................................................................................................................. 121 cfgRemoteHosts...............................................................................................................................................................
cfgTrapsEnable...........................................................................................................................................................133 cfgTrapsAlertDestIpAddr......................................................................................................................................... 134 cfgTrapsCommunityName.......................................................................................................................................
cfgADRootDomain (Read/Write)...........................................................................................................................145 cfgADEnable (Read/Write)..................................................................................................................................... 145 cfgADAuthTimeout (Read/Write)......................................................................................................................... 145 cfgADSCLEnable..........................
cfgChassisInPower (Read Only)............................................................................................................................ 155 cfgChassisPeakPower (Read Only)...................................................................................................................... 156 cfgChassisPeakPowerTimestamp (Read Only)..................................................................................................156 cfgChassisMinPower (Read Only)............................
cfgCurrentLanNetworking (Read Only).....................................................................................................................166 cfgNicCurrentIPv4Enabled...................................................................................................................................... 167 cfgNicCurrentIpAddress...........................................................................................................................................167 cfgNicCurrentNetmask........
cfgReservedIPAddressNumbers.............................................................................................................................177 cfgUseCMCDNSSettings.........................................................................................................................................
1 Introduction This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions of CMC for PowerEdge VRTX. Topics: • • • • • • What’s New in This Release Supported RACADM Interfaces RACADM Syntax Usage Supported RACADM Subcommands Other Documents You May Need Accessing support content from the Dell EMC support site What’s New in This Release ● Added the cfgQuickDeploy group.
RACADM Syntax Usage The following section describes the syntax usage for SSH/Telnet and Remote RACADM.
Table 1. Racadm command options (continued) Option Description -g Specifies the group name, if applicable. -o objectname Specifies the object name, if applicable. The following table provides the supported RACADM interfaces. Table 2. Racadm interfaces Type Local RACADM SSH/Telnet RACADM Remote RACADM CMC No Yes Yes NOTE: Multiple instances of remote RACADM can be executed on a management station.
Table 3.
Table 3. Racadm subcommands (continued) Subcommand CMC setniccfg Yes Yes setpciecfg Yes Yes setractime Yes Yes setslotname Yes Yes setsysinfo Yes Yes sshpkauth Yes Yes sslcertview Yes Yes sslcsrgen Yes Yes sslresetcfg Yes Yes testemail Yes Yes testfeature Yes Yes testtrap Yes Yes traceroute Yes Yes traceroute6 Yes Yes Other Documents You May Need To access the documents from the Dell Support site.
● Systems management software documentation describes the features, requirements, installation, and basic operation of the software. ● Documentation for any components you purchased separately provides information to configure and install these options.
2 RACADM Subcommand Details This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • jobqueue krbkeytabupload license netstat ping ping6 racdump racreset racresetcfg racresetpcie raid remoteimage serveraction set setassettag setchassisname set controllers setflexaddr setled set enclosure setniccfg setpciecfg setractime setslotname setsysinfo SSH or Telnet RACADM sshpkauth sslcertupload sslcertview sslcsrgen sslresetcfg set tempprobes testemail testfeature testtrap traceroute traceroute6 Guidelines to Quote Strings C
● ● ● ● > (greater than) < (less than) # (pound) ASCII code 32 (space) NOTE: The - (dash) character cannot be the first character of the string, regardless of whether the string is quoted. There are different escaping rules for using single quotation mark and double quotation marks. For double quoting: The following characters must be escaped by prepending a backslash: ● ● ● ● ● $ (dollar sign) " (double quotation marks) ' (single quotation marks) ` (back quotation marks) \ (backslash) For example, use
to standby and vice versa config -- modify CMC configuration properties ...
Table 6. chassislog (continued) timestamp>] [-e ] Input ● -i — Displays the number of records present in the active log. You cannot use this option with any other option. ● -c — The log type to filter the records. Provide multiple categories using a "," as the delimiter. The value is case-insensitive. Valid Category values: ○ All ○ System ○ Storage ○ Updates ○ Audit ○ Config ● -q - The sequence number from which the records must be displayed.
Table 6.
Table 6.
Table 7. chassislog export (continued) ● –l : Network share location (see the “Example” section for NFS or CIFS share) to where the Chassis Log must be exported. Example ● Export the Chassis Log to a remote CIFS share racadm chassislog export -f Mylog.xml -u admin -p mypass -l // 192.168.0.5/share - Export the Chassis Log to a remote NFS share racadm chassislog export -f Mylog.xml -l 192.168.0.5:/home/ lclog_user chassislog clear Table 8. chassislog clear Description Deletes the data in the chassis log.
Table 9. Chassisaction (continued) ○ ○ ○ ○ powerdown — (Chassis only) Turns off the chassis. powerup — (Chassis only) Turns on the chassis. powercycle — Power cycles the module. nongraceshutdown — (Chassis only) Non-gracefully turns off the chassis. ○ reset — Performs a hard reset of the module. When = switch, must be powercycle or reset. Output None Example Perform a reset of switch-1: racadm chassisaction -m switch-1 reset Module power operation successful. closessn Table 10.
clrsel Table 11. Clrsel Description Deletes all existing records from the System Event Log (SEL). To use this subcommand, you must have the Clear Logs privilege. Synopsis racadm clrsel cmcchangeover Table 12. 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 the Administrator privilege.
Table 13. Config (continued) ● -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.
● Connect to server 1 serial console racadm connect -m server-1 deploy Table 14. deploy Description Configures the static IP address, subnet mask, gateway, and password for the root user on iDRAC for the specified server. To use this subcommand, you must have the Server Administrator privilege. NOTE: You can also use setniccfg to configure static IP address, subnet mask, gateway, DHCP, speed, and duplex properties.
Table 14. deploy (continued) ● -e — Uses the CMC DNS settings for quick deploy. The legal values are: ○ 1 — Enable ○ 0 — Disable ● --qd — Updates the quick deploy parameters to the servers. This option works only with the -q option. Output None Example ● racadm deploy -m server-8 -s 192.168.0.20 255.255.255.0 192.168.0.1 The server was deployed successfully. The deploy command generates an error when used on the extension slot of a multi-slot server. ● racadm deploy -m server-9 192.168.0.11 255.255.255.
● Critical ● Warning ● Informational Valid examples of alert descriptors are: ● cmc.alert.all ● cmc.alert.audit ● cmc.alert.audit.lic ● cmc.alert.audit.warning ● cmc.alert.audit.lic.critical Input ● ● ● ● Example ● Display all available event filter configurations: get - Displays the list of event filter settings. set - Configures the actions and notifications for a given event filter configuration. -c - Alert descriptor of the specific event filter.
● Configure using subcategory and severity as parameters. For example, all Information events under the licensing subcategory in the audit category are assigned poweroff as action and all notifications are disabled: racadm eventfilters set -c cmc.alert.audit.lic.info -n none fanoffset Description Configures the internal fans to run at a higher speed than the normal speed. To use this subcommand, you must have the Chassis Configuration Administrator privilege.
NOTE: When the FlexAddress and FlexAddressPlus features are active, deactivating one of them results in deactivation of the other feature also. However, ExtendedStorage is not affected by the deactivation of FlexAddress or FlexAddresPlus. ● -r — Repair damaged/unformatted ExtendedStorage media. NOTE: The –r switch requires that the ExtendedStorage feature be deactivated. CAUTION: Using the -r switch reformats the SD media in the active CMC cardslot. Any existing ExtendedStorage data will be lost.
● Running the subcommand to update the active CMC firmware resets the CMC, causing all network connections to get logged off. While updating all other modules, including the standby CMC, the active CMC continues to function normally without resetting. ● The subcommand generates an error, when used on the extension slot of a multi-slot server. ● The CMC firmware cannot be updated to any earlier version other than 2.0 for a chassis that is configured with 1600W PSU.
○ cmc-active (default) ○ cmc-standby ○ iominf-n, where n = 1 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. ○ main-board ○ perc-fqdd, where fqdd is FQDD of the PERC ○ expander-fqdd, where fqdd is FQDD of the Storage Expander ○ hdd-fqdd, where fqdd is FQDD of the HDD ● -s — Displays the current status of the firmware update. NOTE: Use -m to display the status of the module update.
NOTE: ● If CMC is not in the network, you can only export the chassis configuration profile to the local management station.
Input valid values for : critical, warning, info valid values for : server-n, where n = 1 to 4 switch-n, where n = 1 cmc-n, where n = 1, 2 fan-n, where n = 1 to 6 ps-n, where n = 1 to 4 chassis kvm Output Display entire log: racadm getactiveerrors - Display specific module log: racadm getactiveerrors -m server-1 - Display entire informational log: racadm getactiveerrors -s info getassettag Displays the asset tag for the chassis.
getconfig Description Synopsis Retrieves CMC configuration parameters individually, or all CMC configuration groups may be retrieved and saved to a file. racadm getconfig -f racadm getconfig -g [-i ] racadm getconfig -u racadm getconfig -h racadm getconfig -g -o [-i index] Input ● -f — The -f option directs getconfig to write the entire iDRAC configuration to a configuration file.
● Displays all of the configuration properties (objects) that are contained in the group cfgLanNetworking. Example racadm getconfig -g cfgLanNetworking ● Saves all group configuration objects from iDRAC to myrac.cfg. racadm getconfig -f myrac.cfg ● Displays a list of the available configuration groups on iDRAC in an alphabetical order. racadm getconfig -h ● Displays the configuration properties for the user named root.
The following example is for a system with multi-slot servers.
● 0— Unsupported ● 1— ISCSI ● 2— FCoE-FIP ● 3— iSCSI/FCoE-FIP 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 serverassigned MAC/WWN addresses blank. If an external console controls the MAC/WWN addresses, the command displays an externally managed message.
slot4-idrac Controller 18:A9:9B:FD:C7:57 slot4-A 10 GbE KR 00:90:FA:51:36:54 10 GbE KR/3 00:90:FA:51:36:55 F8:DB:88:3D:9F:AA(ac tive) FCoE-WWN 10:00:00:90:FA:51:36 :55 20:01:F8:DB:88:3D:9F :AA(active) 10 GbE KR/3 00:90:FA:51:36:56 F8:DB:88:3D:A2:78(ac tive) F8:DB:88:3D:9F:A7(ac tive) F8:DB:88:3D:9F:A8(ac tive) NOTE: 10 GbE KR/3— The value 3 indicates the protocol type. getioinfo Table 15.
getled Description Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots). To use this subcommand, you must have the Login User privilege. Synopsis racadm getled -m Input CMC only options: -m — Specifies the module whose LED settings you want to view.
● racadm getmacaddress -a ● racadm getmacaddress -c IO-Identity ● racadm getmacaddress -c Flexaddress ● racadm getmacaddress -c Factory ● racadm getmacaddress -c all ● -m — Specifies the module whose MAC address you want to view. Input may be one of the following: server-n, where n=1–4 switch-n, where n=1 ● -t — Displays the iSCSI MAC addresses for all servers or the specified server if used with -m option.
Displays the MAC address for chassis. racadm getmacaddress -m chassis CMC Present N/A F0:4D:A2:77:71: 72 N/A Displays the MAC address for switch-1 racadm getmacaddress -m switch-1 Switch-1 Present Not Installed 00:00:00:00:00: 00 Not Installed Display MAC for server-1.
Displays the MAC address.
Server-2-A N/A N/A Present N/A N/A Gigabit Ethernet Present Not Installed Not Installed iSCSI Present Not Installed Not Installed Server-2-C Fibre Channel 4 Present Not Installed Not Installed Server-3 N/A Not Present N/A N/A N/A Server-4-A Gigabit Ethernet Present 00:18:8B:FF :45:2A 00:18:8B:FF :AA:02 00:18:8B:FF :AA:04 iSCSI Present 00:18:8B:FF :AA:03 00:18:8B:FF :AA:05 Gigabit Ethernet Not Present Not Installed Not Installed iSCSI Present Not Installed Not Instal
Gigabit Ethernet Present 00:0A:00:0A:0 0:01 Unknown IO-Identity Gigabit Ethernet Present 00:0A:00:0A:0 0:02 Unknown IO-Identity Gigabit Ethernet Present Unknown IO-Identity 00:0A:00:0A:0 0:03 Displays the MAC/WWN addresses for all LOMs or mezzanine cards.
10 GbE KR/3 Present F8:DB:88:3D: A2:7B Unknown FlexAddress NOTE: 10 GbE KR/3— The value 3 indicates the protocol type. Displays the console assigned MAC/WWN of all LOMs or mezzanine cards.
Table 16. getmodinfo (continued) ○ ○ ○ ○ ○ dvd main-board io-cable fpc-cable storage ● -A — Does not display the headers and labels in the output. Example ● racadm getmodinfo -m switch-1 Switch-1 N/A OK Present ON N/A ● racadm getmodinfo NOTE: A power state of "Primary" denotes Active CMC.
Table 16. getmodinfo (continued) Server-4 N/A DVD OK IO-Cable OK FPC-Cable OK Not Present N/A Present N/A Present 3BPV622 Present 3BPV622 N/A ON ON ON N/A N/A N/A N/A getniccfg Table 17. getniccfg Description Displays the current NIC settings.
Table 17. getniccfg (continued) racadm getniccfg -m server-3 LOM Model Name LOM Fabric Type IPv4 Enabled DHCP Enabled IP Address Subnet Mask Gateway IPv6 Enabled Autoconfiguration Enabled Link local Address IPv6 Gateway VLAN Enable VLAN ID VLAN priority = = = = = = = = = = = = = = BRCM GbE 4P 5720 bNDC Gigabit Ethernet 1 0 0.0.0.0 0.0.0.0 0.0.0.0 0 1 :: 0 1 0 racadm getniccfg -m switch-1 DHCP Enabled IP Address Subnet Mask Gateway = = = = 0 0.0.0.0 0.0.0.0 0.0.0.
PS2 PS3 PS4 [Server 1 2 3 4 Present Not Present Not Present Online Slot Empty Slot Empty 1.6 A N/A N/A 116.0 V N/A N/A Module Power Allocation Table] SLOT-01 OFF 0 W 1 SLOT-02 N/A N/A 1 SLOT-03 ON 327 W 1 SLOT-04 N/A N/A 1 1050 W N/A N/A PowerEdge M620 N/A PowerEdge M620 N/A getpciecfg Description Displays the FQDD of the PCIe slots and Virtual Adapters, and their mapping information and properties.
PCIe slot-6 Shared PERC 8 External ON Shared N/A N/A PCIe slot-7 Not Present N/A N/A N/A N/A PCIe slot-8 Not Present N/A N/A N/A N/A 1 5,6,9,10 SLOT-01 1 Present 2 5,6,9,10 SLOT-02 2 Not Present 3 5,6,9,10 Unmapped N/A N/A 4 5,6,9,10 SLOT-04 4 Not Present ● Displays FQDDs of all the PCIe slots and PCIe Virtual Adapters: racadm getpciecfg PCIe slot 01 PCIe sl
● Displays the ride-through properties of the system racadm getpciecfg -r Ride-through mode is enabled Ride-through timeout 1800 secs getpminfo Description Displays power management status information. To use this subcommand, you must have CMC Login User privilege.
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. Synopsis racadm getraclog [-s ] [-c ] Input NOTE: If no options are provided, the entire log is displayed.
● -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. Output The current iDRAC time is displayed. Example ● racadm getractime Thu Dec 8 20:15:26 2005 ● racadm getractime -d 20051208201542.000000 getredundancymode Displays the redundancy status (Redundant or NonRedundant) of the CMC.
Output Record: 12 Date/Time: 11/20/2011 14:19:34 Source: system Severity: Ok Description: C: boot completed. Example racadm getsel getsensorinfo Description Synopsis Examples Displays status of chassis sensors. NOTE: To use this subcommand, you must have CMC Login User privilege.
Blower-3 N/A 0 3000 2250 N/A N/A Blower-4 N/A 2611 3000 2250 N/A N/A Sensor Type : Temperature Sensor Units : Celsius Chassis Ambient OK 22 3 -7 42 47 Server-4 OK 20 3 -7 42 47 Sensor Type : Power PS-1 Slot Empty N/A PS-2 Online OK PS-3 Slot Empty N/A PS-4 Slot Empty N/A Sensor Type : Cable IO-Cable OK FPC-Cable OK Sensor Type : Intrusion
Values: 1 to 4 ● -h ○ ○ ○ Example - Specifies whether to display the slot name or the host name (if available). 0 — Displays the slot name 1 — Displays the host name instead of the slot name 2 — Displays the iDRAC DNS name instead of the slot name ● Display all slots names. racadm getslotname 1 SLOT-01 2 WIN-UF2EVKG8PJ5 WIN-UF2EVKG8PJ5 idrac-2QDJH62 3 4 SLOT-03 SLOT-04 ● Display the name of the third slot.
racadm getssninfo -A -u * "root" "143.166.174.19" "Telnet" "NONE" "bob" "143.166.174.19" "GUI" "NONE" getsvctag Description Displays the service tag of the host system. Synopsis racadm getsvctag Input getsvctag Output Chassis Switch-1 Server-1 Server-2 Server-3 Server-4 Example PLPC033 N/A 7654321 N/A Extension(1) PLSMS04 racadm getsvctag getsysinfo Description Displays information related to CMC and chassis.
Examples Current DNS Domain VLAN ID VLAN Priority VLAN Enabled = = = = swtest.com 1 0 0 CMC IPv4 Information: IPv4 Enabled Current IP Address Current IP Gateway Current IP Netmask DHCP Enabled Current DNS Server 1 Current DNS Server 2 DNS Servers from DHCP = = = = = = = = 1 192.168.0.1 192.168.0.1 255.255.255.128 1 192.168.0.1 0.0.0.
● -A - Does not display headers or labels. NOTE: The -A and -o options are deprecated. Output Example The default output display shows the record number, timestamp, source, and description. The timestamp begins at midnight, January 1 and increases until the system boots. After the system boots, the system’s timestamp is used. Record: 1 Date/Time: Dec Source: ssnmgrd[175] 8 08:21:30 Description: root from 143.166.157.103: session timeout sid 0be0aef4 getversion Table 18.
Table 18. getversion (continued) cmc-2 Y 3.00.000.201609223282 Main Board 2.21.A00.201510302495 System.Chassis.1#Infrastructure.1 Shared PERC8 RAID.ChassisIntegrated.1-1 23.13.06.0011 VRTX2.5x25 0:0 1.02 Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:0 AS09 Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.
Table 18. getversion (continued) is one of the following: ○ server-n, where n = 1 to 4. For example, cmc-2. ○ switch-n, where n = 1 ○ CMC-n, where n = 1 or 2 ○ mainboard ○ perc ○ expander ○ hdd ○ perc-fqdd, where fqdd is FQDD of the PERC. ○ expander-fqdd, where fqdd is FQDD of the Storage Expander. ○ hdd-fqdd, where fqdd is FQDD of the HDD.
Example $ racadm ifconfig eth0 Link encap:Ethernet 00:1D:09:FF:DA:23 HWaddr inet addr:10.35.155.136 Bcast:192.168.0.1 Mask:255.255.255.0 MULTICAST Metric:1 UP BROADCAST RUNNING MTU:1500 RX packets:2550665 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:272532097 (259.9 MiB) TX bytes:0 (0.0 B) jobqueue Description Displays the jobs in that are currently being run, delete the jobs, and create a job.
Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] ---------------------------------------------------------[Job ID=RID_852218430518] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] ---------------------------------------------------------[Job ID=RID_852215634901] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] ---------------------------------------------------------[Job ID=JID_852215394003] Job Name=ConfigRAID:GUI:RAID.ChassisIntegrated.
Synopsis racadm license .
Unique Identifier = License #1 Status Transaction ID License Description Evaluation License A2Wir6lJ1MoP8iBAtqsEKDv8 1982-04-07T21:00:00 = OK = 8 = CMC Enterprise License Type Entitlement ID = EVALUATION = Expiration = ○ Display licenses available on a specific device. For example, for RAID slot 4: racadm license view -c RAID.slot.4 ● Import a license: ○ Import a license from a CIFS share to a device (for example, Integrated CMC): racadm license import -u admin -p passwd -f License.xml -l // 192.168.
○ Replace the license on a device with a license file that is on an NFS share, and using a transaction ID. For example, transaction 27. racadm license replace -f License.xml -l 192.168.2.140:/ licshare -t 27 ○ Replace license on a device with a license file that is on a CIFS share and using a transaction ID. For example, transaction 27. racadm license replace -u admin -p passwd -f License.xml -l //192.168.2.140/licshare -t 27 ○ Replace license on a device with a license file on the local file system.
127.0.0.1:199 tcp 0 127.0.0.1:52175 tcp 0 192.168.0.1:45106 tcp 0 127.0.0.1:199 tcp 0 127.0.0.1:8195 ESTABLISHED 0 127.0.0.1:199 ESTABLISHED 0 192.168.0.1:22 ESTABLISHED 0 127.0.0.1:52174 ESTABLISHED 0 127.0.0.1:52887 ESTABLISHED ping Description Verifies that the destination IP4address is reachable from iDRAC with the current routingtable contents. A destination IP4address is required. An ICMP echo packet is sent to the destination IP address based on the current routing-table contents.
racdump Description This subcommand displays the comprehensive chassis status and configuration state information, and historic event logs. Used for post-deployment configuration verification and during debugging sessions. To use this subcommand for CMC, you must have the Administrator privilege.
Current DNS Domain = Chassis Information: System Model System AssetTag Service Tag Chassis Name Chassis Location Power Status = = = = = = PowerEdge VRTX 00000 Dell Rack System [UNDEFINED] ON =============================================================================== Session Information =============================================================================== Type SSH KVM User root root IP Address 192.168.155.10 169.254.31.
Example ● Reset CMC: racadm racreset ● Reset server 1. racadm racreset -m server-1 ● Reset servers 1 and 3. racadm racreset -m server-1 -m server-3 racresetcfg Description Synopsis Input Example Resets CMC configuration to factory default settings. NOTE: To use this, you must have the Chassis Administrator privilege. racadm racresetcfg [-m ] [-c ] ● -m ○ ○ ○ : — Must be one of the following values: chassis — default state, if -m is not specified.
raid Description Synopsis Allows you to execute commands to control RAID arrays. racadm raid Example ● Monitor Health of Storage root node. racadm raid get status Storage Root Node Status : Ok This command retrieves the controllers keys (FQDDs). ● Monitor and Inventory all Controllers connected to the server. racadm raid get controllers racadm raid get controllers -o This command is an optimized version and displays the full controller objects along with their keys.
racadm raid get vdisks racadm raid get vdisks --refkey RAID.ChassisSlot.5-1 -o -p status racadm Disk.Virtual.5:RAID.ChassisSlot.5-1 Status = Ok racadm Disk.Virtual.0:RAID.ChassisSlot.5-1 Status = Ok racadm Disk.Virtual.1:RAID.ChassisSlot.5-1 Status = Ok racadm Disk.Virtual.2:RAID.ChassisSlot.
● Monitor and Inventory all EMMs connected to the enclosure racadm raid get emms --refkey This command returns all EMM keys connected to the enclosures being mentioned as refkeys. racadm raid get emms --refkey -o This command is an optimized version and displays all EMM objects for the enclosure FQDD.
● –vdkey: A comma-separated list of virtual drive FQDDs to use in the operation. Example racadm raid blink:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 racadm raid blink:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 racadm raid blink pdkey:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1,Disk.Ba y.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 racadm raid blink vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1,Disk.Virtual.0:RAID.Chassi sIntegrated.
Table 19. createvd (continued) ● -cc: Create a CacheCade or Enhanced Cache VD. ● -vdinit: Create a virtual disk with or without initialization. The available values are: ○ yes ○ no If -vdinit is not specified, the default value is “yes”. ● -secure: Create a virtual disk using Self-Encrypting Drives (SEDs). The available values are: ○ yes ○ no If -secure is not specified, the default value is “no”. Example racadm raid createvd:RAID.ChassisIntegrated.1-1 -rl r0 pdkey:Disk.Bay.0:Enclosure.Internal.0-0:RAID.
Synopsis Input racadm raid exportlog: -l -u -p [-f ] ● ● ● ● Example –l: The network share to write the log to. –u: The network password for the share –f : The file name to write the log to. racadm raid exportlog:RAID.ChassisIntegrated.
PreservedCache = Not Present CacheMemorySize = 1024 MB PersistHotspare = Disabled SpindownUnconfiguredDrives = Disabled SpindownHotspare = Disabled Timeintervalforspindown = 30 (Minutes) SecurityStatus = Unknown EncryptionMode = None SasAddress = 0x590B11C02620E600 PciDeviceId = 0x2f PciSubdeviceId = 0x1f3e PciVendorId = 0x1000 PciSubvendorId = 0x1028 PciBus = 0x0 PciDevice = 0x0 PciFunction = 0x0 BusWidth = Unknown SlotLength = Short SlotType = Unknown CapableSpeeds = 6.0 Gb/s, 3.
Status RollupStatus Name FirmwareVersion DriverVersion RebuildRate BgiRate CheckConsistencyRate ReconstructRate PatrolReadRate PatrolReadMode PatrolReadState CheckConsistencyMode LoadBalanceSetting CopybackMode PreservedCache CacheMemorySize PersistHotspare SpindownUnconfiguredDrives SpindownHotspare Timeintervalforspindown SecurityStatus EncryptionMode SasAddress PciDeviceId PciSubdeviceId PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvail
Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Failed racadm raid get enclosures -o Enclosure.Internal.0-0:RAID.ChassisIntegrated.2-1 Status = Ok RollupStatus = Ok Name = VRTX2.5x25 0:0 BayId = 0 FirmwareVersion = 2.00 AssetTag = elan3 AssetName = VRTX200 ternal backplane SasAddress = Not applicable SlotCount = 25 Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok RollupStatus = Ok Name = MD1220 0:1 EnclosurePosition = 1 ConnectedPort = 0 FirmwareVersion = 1.
EMM.Slot.1:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok EMM.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Failed EMM.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Unknown racadm raid get emms -o Expander.Slot.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.2-1 Status = Ok State = Ready Name = Expander 0 PartNumber = 0TJ2VKA00 FirmwareVersion = 2.00 Expander.Slot.1:Enclosure.Internal.0-0:RAID.ChassisIntegrated.
FanOperationalStatus = Ok Fan.Slot.2:Enclosure.External.0-1:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok Fan.Slot.3:Enclosure.External.0-1:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok Fan.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok Fan.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok Fan.Slot.2:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok Fan.Slot.3:Enclosure.External.0-0:RAID.ChassisSlot.
Synopsis racadm raid get psus -o -p Status racadm raid get psus -o ● -o — The -o is used to display the fault-tolerant status of a enclosure. Input Example racadm raid get psus -o -p Status PSU.Slot.0:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok PSU.Slot.1:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok PSU.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok PSU.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok racadm raid get psus -o PSU.Slot.0:Enclosure.
TempSensor.Embedded.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok TempSensor.Embedded.2:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok TempSensor.Embedded.3:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok racadm raid get tempprobes -o TempSensor.Embedded.2:Enclosure.External.0-1:RAID.ChassisSlot.
hotspare Description Synopsis Input Assign or unassign global and dedicated hotspares. racadm raid hotspare: -assign {yes | no} {type {ghs | dhs}} {vdkey:} {-current | -pending} ● –current : Performs the configuration right now. NOTE: If this requires the system to reboot it will reboot then. ● –pending: Save the configuration change for a later application.
Example racadm raid cancelrebuild:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 assignva Description Assigns a virtual disk to one or more virtual adapters. NOTE: You can assign virtual disk to multiple virtual adapters when you select the mode of assignment as multiple. Synopsis Input racadm raid assignva: -vdkey: -accesspolicy {na | rw} -assignpolicy {single | multiple}{-current | -pending} ● –current : Performs the configuration right now.
init Description Synopsis Input Starts an initialization operation on the specified virtual drive. racadm raid init: -speed {fast | full} {-current | -pending} ● –current : Performs the configuration right now. NOTE: If this requires the system to reboot it will reboot then. ● –pending: Save the configuration change for a later application. You can use a combination of the –pending and –current flags on multiple commands to reduce the possible number of system reboots.
○ importconfig ○ ccheck ○ cancelcheck ○ patrolread ○ hotspare ○ init ○ assignva ○ createvd ● –o — Displays all the properties of the selected Key or Object. ● –p — Displays the property names with filter. ● FQDD — Displays all the properties of the FQDD's Key. Example ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● racadm raid get controllers racadm raid get controllers -o racadm raid get controllers -o -p name,status racadm raid get vdisks -o -p layout,status racadm raid get controllers:RAID.
● racadm raid rename:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -name ● racadm raid ctrlprop:RAID.ChassisIntegrated.1-1 [-rebuild >] [-bgi ] [-reconstruct ] [-checkconsistency ] [-ccmode {abortonerror | normal}] [-copybackmode {off | on | onwithsmart}] [-lb {auto | disabled}] [-prunconfigured {yes | no}] ● racadm raid rebuild:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 ● racadm raid cancelrebuild:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrat ed.
enableperc Description Indicates the RAID configuration of hardware RAID connected to the server. This subcommand enables the power to a RAID card. NOTE: ● Using this subcommand will power cycle the chassis and set the fault-tolerant system configuration to fault-tolerant mode. ● If any PERC adapter settings are changed or firmware is updated, a message is displayed and the fault-tolerant status is degraded.
modifysecuritykey Description Synopsis Modifies the security key and password of the controller. racadm raid modifysecuritykey: -key -oldpasswd -newpasswd Input ● -key — New key identifier for the controller ● -oldpasswd — old passphrase ● -newpasswd — new passphrase Example racadm raid modifysecuritykey:RAID.ChassisIntegrated.
unlock Description Synopsis Input Unlocks the SEDs migrated from a controller with different security key. The security status of such drives is displayed as “Locked”. racadm raid unlock:RAID.ChassisIntegrated.1-1 -key -passwd ● -key — Key ID used to secure on old controller. ● -passwd — Passphrase used to secure on old controller. NOTE: You can get the key ID using the following command: raid get pdisks -o -p foreignkeyidentifier Example racadm raid unlock:RAID.
To use this subcommand, you must have the Execute Server Control Commands permission. Synopsis racadm serveraction ● -m - Input server-n, where n=1–4 ● -a - Performs action on all servers. Not allowed with the powerstatus action. ● -f - Force the action. Required for the reseat action. ● - Specifies the action. The options for the string are: — graceshutdown — Performs a graceful shutdown of the server.
Server Power Status: ON ● Reseat server 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 Import saved CMC configuration or CMC Event Filter configuration from a file. NOTE: If CMC is not in the network, you cannot import the chassis configuration profile from a remote network share with proxy using the set command.
setassettag Description Sets the N-byte ASCII asset tag for the chassis. To use this subcommand, you must have the Administrator privilege. NOTE: The special characters \ (backslash), & (ampersand), ` (backward quotation mark), and " (double quotation mark) are not supported for this subcommand. Synopsis Input racadm setassettag -m chassis -m — Specifies the module whose asset tag you want to set.
Synopsis To enable fault-tolerant mode: Racadm raid set controllers: -p HighAvailabilityMode ha To disable fault-tolerant mode: Racadm raid set controllers: -p HighavailabilityMode none Input Example Racadm raid set controllers: -p HighAvailabilityMode ha racadm raid set controllers:RAID.ChassisSlot.5-1 -p HighAvailabilityMode ha Racadm raid set controllers: -p HighavailabilityMode none racadm raid set controllers:RAID.
● 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 the Debug Administrator privilege on CMC. To enable the servers to blink or unblink, you must have the Server Administrator or Debug Administrator privilege on CMC. Synopsis racadm setled -m -l ● -m - Specifies the module whose LED you want to configure.
setniccfg Description Sets the iDRAC IP address. It displays an error message if the requested operation could not be performed, or a success message, if the operation is completed successfully. To use this subcommand, you must have the Configure iDRAC privilege. NOTE: The terms NIC and Ethernet management port may be used interchangeably.
Input ● ● ● ● ● -c — Use this option to specify a PCIe adapter or Virtual Adapter. -i — Use this option to specify the server or module slot number. FQDD — FQDD of the specified PCIe slot or Virtual Adapter. -e — Use this option to enable the ride-through mode. -d — Use this option to disable the ride-through mode. ● -t — Use this option to set the time-out property of a ride-through mode in seconds (0, 60–1800; 0=infinite). Example ● Assign a PCIe slot to a server: racadm setpciecfg assign -c PCIE.
— 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: '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 the '-d' option). ● -z - Sets the time zone by name or index, or lists possible time zones.
To use this subcommand, you must have the Administrator privilege. 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. For more information, see the Dell OpenManage Server Administrator User's Guide at support.dell.com/manuals. ● The special characters \ (backslash), & (ampersand), ` (backward quotation mark), and " (double quotation mark) are not supported for this subcommand.
SSH or Telnet RACADM racadm getconfig -g [-o ] [-i ] racadm Example racadm getconfig -g idracinfo racadm getsysinfo sshpkauth Description Enables you to upload and manage up to six (6) different SSH public keys. You can upload a key file or key text, view keys, or delete keys.
● View all keys racadm sshpkauth -i svcacct -k all -v ● Delete all keys racadm sshpkauth -i svcacct -k all -d ● Upload key at index 2 using text option racadm sshpkauth -i svcacct -k 2 -p 0xfff -t "key text" ● Upload key at index 1 using file upload option. racadm sshpkauth -i svcacct -k 1 -p 0xfff -f idrsa.pub sslcertupload Uploads a custom SSL server or CA certificate for Directory Service from the client to iDRAC. Description To use this subcommand, you must have the CMC Configuration permission.
—2 = CA certificate for Directory Service. ● -A — Prevents printing of headers or labels. Output racadm sslcertview -t 1 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.
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 Synopsis 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.
-g option cannot be used with the -s option, and the -f option can only be used with the -g option. The sslcsrgen -s subcommand returns one of the following status codes: ● CSR was generated successfully. ● CSR does not exist. Example 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.
testemail Description Synopsis Input Sends a test e-mail to a specified destination. Prior to executing the test e-mail command, make sure that the SMTP server is configured and the specified index in the RACADM cfgEmailAlert group is enabled and configured properly. racadm testemail -i -i — Specifies the index of the e-mail alert to test.
Option Description -u The user name specified in an appropriate format for the selected authentication method. That is, Active Directory users are specified as user_name@domain_name. -p The password for the indicated user account. -d A bitmask (specified as a hexadecimal value) to select various diagnostic messaging levels. This option is optional. NOTE: -d option is not supported with the remote racadm interface.
as needed. This subcommand, when run, performs the following: ● ● ● ● ● ● ● ● ● ● Synopsis Checks command syntax. Verifies if the required system resources are available. Validates Active Directory configuration. Verifies if the SSL certificate and certificate signing request (key) exists. Acquires LDAP and Global Catalog Service records from DNS. Verifies if the CMC can acquire CMC, LDAP and Global Catalog servers FQDN through reverse IP lookups.
Example Commands for the cfgIpmiPet group: ● Enable the alert racadm config -g cfgIpmiPet -o cfgIpmiPetAlertEnable -i 1 ● Set the destination e-mail IP address racadm config -g cfgIpmiPet -o cfgIpmiPetAlertDestIpAddr -i 1 192.168.0.110 ● View the current test trap settings racadm getconfig -g cfgIpmiPet -i where is a number from 1 to 4. traceroute Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv4 address.
Synopsis racadm traceroute6 racadm traceroute fd01::1 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.
3 CMC Property Database Group and Object Descriptions The CMC property database contains the configuration information for 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 CMC. Use the group and object IDs with the RACADM subcommands to configure CMC. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output.
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 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.
Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. The following sections provide information about the objects in the cfgLanNetworking group. cfgNicIPv4Enable (Read or Write) Description Enables or disables the IPv4 stack.
cfgDNSDomainName (Read/Write) Description This is the DNS domain name. This parameter is valid only if cfgDNSDomainNameFromDHCP is set to 0 (FALSE). Legal Values A string of up to 254 ASCII characters. At least one of the characters must be alphabetic. Characters are restricted to alphanumeric, '-', and '.'. NOTE: Microsoft Active Directory supports only Fully Qualified Domain Names (FQDN) of 64 bytes or fewer.
Example: racadm getconfig -g cfgLanNetworking cfgNicEnable=1 cfgNicIPv4Enable=1 cfgNicIpAddress=192.168.0.120 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.0.1 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.
cfgDNSServer1 (Read/Write) 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 cfgDNSServer2 (Read/Write) Description Retrieves the IPv4 address for DNS server 2.
cfgNicNetmask (Read/Write) Description The subnet mask used for CMC IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE). NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE). Legal Values String representing a valid subnet mask. For example: 255.255.255.0. Default 255.255.255.0 cfgNicGateway (Read/Write) Description CMC gateway IPv4 address. The gateway IPv4 address used for static assignment of the RAC IP address.
Default 1 cfgRhostsFwUpdateIpAddr (Read/Write) Description Specifies the network TFTP server IPv4 or IPv6 address that is used for TFTP 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) Specifies TFTP path where CMC firmware image file exists on the TFTP server. The TFTP path is relative to the TFTP root path on the TFTP server.
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. 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.
This setting takes effect only if the cfgRhostsSyslogEnable parameter is set to 1 (enabled). Legal Values 10–65535 NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106. Default 514 cfgRhostsSyslogServer1 (Read/Write) Description Specifies the first of three possible remote syslog servers to store the RAC and SEL logs.This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled).
Default 0 cfgRhostsSyslogPowerLoggingInterval Description Specifies the power consumption collection/logging interval. Legal Values 1–1440 (minutes) Default 5 Example racadm getconfig -g cfgRemoteHosts [-m server-] cfgRhostsFwUpdateTftpEnable=1 cfgRhostsFwUpdateIpAddr=0.0.0.0 cfgRhostsFwUpdatePath= cfgRhostsSmtpServerIpAddr=localhost.
Legal Values The parameter is specified by a decimal integer from 1–16. Default cfgUserAdminPrivilege (Read/Write) Description This property specifies the role-based authority privileges allowed for the user. The value is represented as a bit mask that allows for any combination of privilege values. The table below describes the user privilege bit values that can be combined to create bit masks.
iDRAC Specific User Privilege Privilege Bit Mask Super User 0x0000020 Server Administrator 0x0000040 Test Alert User 0x0000080 Debug Command Administrator 0x0000100 Fabric A Administrator 0x0000200 Fabric B Administrator 0x0000400 Fabric C Administrator 0x0000800 Examples The following table provides sample privilege bit masks for users with one or more privileges. User Privileges Privilege Bit Mask The user is not allowed to access CMC.
cfgUserAdminEnable (Read/Write) Description Enables or disables an individual user. NOTE: You can enable a user for a given index, only if you set the password for the same user. Legal Values ● 1 (TRUE) ● 0 (FALSE) Default 0 cfgEmailAlert This group contains parameters to configure e-mail alerting capabilities. Up to four instances of this group are allowed. Use this object with the getconfig and config subcommands.
cfgEmailAlertEmailName Description Specifies name or other identifier associated with the destination e-mail address. The e-mail name can refer to an individual, group, location, department, and so on. Legal Values A string of up to 32 characters Default Example racadm getconfig -g cfgEmailAlert -i 2 # cfgEmailAlertIndex=1 cfgEmailAlertEnable=1 cfgEmailAlertAddress=kfulton@dell.
Legal Values 60 – 10800 Default 1800 cfgSerial This group contains configuration parameters for CMC services. One instance of the group is allowed. Use this object with the getconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. The following sections provide information about the objects in the cfgSerial group.
cfgSerialConsoleCommand (Read/Write) Description Specifies a serial command that is executed after a user logs into the serial console interface. Legal Values A string representing a valid serial command. For example, connect server-1. Default cfgSerialConsoleColumns 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. Description NOTE: The prompt counts as two characters.
cfgSerialTelnetEnable=0 cfgSerialSshEnable=1 cfgSerialTelnetEnable (Read/Write) Description Enables or disables the Telnet console interface on CMC. Legal Values ● 1 (TRUE) ● 0 (FALSE) Default 0 cfgOobSnmp This group contains parameters to configure the SNMP agent and trap capabilities of CMC. One instance of the group is allowed. The CMC SNMP agent supports the standard RFC1213 mib-2, and the Dell enterprise-specific MIB. Use this object with the config or getconfig subcommands.
Default 0 cfgOobSnmpProtocol Description Specifies the SNMP protocol used for SNMP traps. Legal Values ● 0 — All ● 1 — SNMPv3 Default 0 cfgOobSnmpTrapFormat Description Specifies the format for SNMP traps. Legal Values ● 0 — SNMPv1 ● 1 — SNMPv2 ● 2 — SNMPv3 Default 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.
cfgTrapsAlertDestIpAddr Description Sets the IP address that receives the alert. Legal Values A string representing a valid IP address. For example, 192.168.0.20. Default None 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.
cfgRacTuneDefCredentialWarningEnable Use this object with the getconfig or config subcommands. Description Enables or disables the display of the default password warning message. Legal Values 0 and 1 Default 1 cfgRacTuneRemoteRacadmEnable (Read/Write) Description Enables or disables the Remote RACADM interface. Legal Values ● 1 (TRUE) ● 0 (FALSE) Default 1 cfgRacTuneHttpPort (Read/Write) Description Specifies the port number to use for HTTP network communication.
Default 0 cfgRacTuneIpRangeAddr (Read/Write) Description Specifies the acceptable IPv4 address bit pattern in positions determined by the 1s in the range mask property (cfgRacTuneIpRangeMask). 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.
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 2–65535 Default 60 cfgRacTuneIpBlkPenaltyTime (Read/Write) Description Defines the time span in seconds that session requests from an IP address with excessive failures are rejected.
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. Some common time zone offsets for time zones in the United States are: ● ● ● ● –480 (PST—Pacific Standard Time) –420 (MST—Mountain Standard Time) –360 (CST—Central Standard Time) –300 (EST—Eastern Standard Time) For CMC: This object property is read only. Specifies the difference in number of seconds, from the UTC/ GMT.
cfgServerInfo For iDRAC this group allows you to select the BIOS first boot device and provides the option to boot the selected device only once. For CMC, this group allows you to displays information for and configure a server in the chassis. Use this object with the config or getconfig subcommands. To use this object property for CMC, you must have Chassis Configuration Administrator privilege. NOTE: For CMC, you can configure any setting that is not preceded by the hash sign (#) in the output.
cfgServerFW (Read Only) Description Displays the server's iDRAC management firmware revision. Legal Values None Default None cfgServerBIOS (Read Only) Description Displays the server's BIOS revision. Legal Values None Default None cfgServerBmcMacAddress (Read Only) Description Displays the BMC MAC address of the specified server. Legal Values None Default None cfgServerNic1MacAddress (Read Only) Description Displays the MAC address of the server NIC 1.
cfgServerNic4MacAddress (Read Only) Description Displays the MAC address of the server NIC 4. Legal Values None Default None cfgServerPriority (Read/Write) Description Sets the priority level allotted to the server in the chassis for power budgeting purposes. Legal Values 1–9 in descending priority, where 1 holds the highest priority Default 1 cfgServerNicEnable (Read/Write) Description Enables or disables LAN channel.
● 0 (disable) Default None cfgServerDNSIMCName (Read/Write) Description Displays the DNS domain name for the integrated Remote Access Controller (iDRAC.) 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. Legal Values None Default None cfgServerFirstBootDevice (Read/Write) Description Sets or displays the first boot device.
Legal Values ● 1 = TRUE ● 0 = FALSE Default 0 cfgServerPowerConsumption (Read Only) Description Displays the current power consumption for a server. Legal Values None Default None Example racadm getconfig -g cfgServerInfo -i 8 # cfgServerInfoIndex=8 # cfgServerSlotNumber=8 # cfgServerServiceTag= cfgServerName=SLOT-08 # cfgServerFW=3.
# cfgServerNic2MacAddress=00:1A:A0:FF:D9:F6 cfgServerPriority=1 cfgServerNicEnable=1 cfgServerIPMIOverLANEnable=1 # cfgServerPowerBudgetAllocation=0 cfgServerDNSRegisterIMC=0 cfgServerDNSIMCName=iDRAC-1S0M0G1 cfgServerRootPassword=******** (Write-Only) cfgServerFirstBootDevice=0 # cfgServerBootOnce=1 # cfgServerPowerConsumption=0 cfgActiveDirectory This group contains parameters to configure the Active Directory feature. Use this object with the getconfig or config subcommands.
cfgADRootDomain (Read/Write) Description Specifies the root domain of the domain forest. 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 CMC. If this property is disabled, LDAP authentication may be used for user login.
cfgADDomainController1 (Read/Write) Description Specifies the LDAP server from which you want the CMC to obtain user names . Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default None cfgADDomainController2 (Read/Write) Description Specifies the LDAP server from which you want the CMC to obtain user names .
cfgADGlobalCatalog3 (Read/Write) Description Specifies the Global Catalog server from which you want the CMC to obtain user names. Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default None cfgADType (Read/Write) Description Determines the schema type to use with Active Directory.
Default 0 cfgADGcRootDomain (Read/Write) Description The name of the Active Directory root domain used for DNS look up, to locate Global Catalog servers. Legal Values String. Maximum character length = 254 Default Null cfgADGcSRVLookupEnable (Read/Write) Description Determines how the global catalog server is looked up. If using pre‑configured global catalog servers, then CMC uses the values cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and cfgAdGlobalCatalog3.
NOTE: For CMC, enabling this option turns off cfgADEnable. Legal Values ● 1 (TRUE)— Enable ● 0 (FALSE)— Disable Default 0 cfgLDAPServer (Read/Write) Description Configures the address of the LDAP Server. IPv4 and IPv6 are supported. 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 Default Null cfgLDAPPort (Read/Write) Description Port of LDAP over SSL. Non-SSL port is not supported.
cfgLDAPGroupAttribute (Read/Write) Description Specifies which LDAP attribute is used to check for group membership. This should be an attribute of the group class. If not specified, then CMC uses the member and unique member attributes. Legal Values String. Maximum length = 254 Default Null cfgLDAPGroupAttributeIsDN (Read/Write) Description If enabled, the CMC performs DN matching; otherwise, the CMC uses the username provided at login for matching.
Legal Values String of maximum length = 1024 characters Default (objectclass=*) Searches for all objects in tree. cfgLDAPCertValidationEnable (Read/Write) Description Controls certificate validation during SSL handshake. Legal Values ● 1 (TRUE)—CMC uses the CA certificate to validate the LDAP server certificate during SSL handshake. ● 0 (FALSE)—CMC does not performthe certificate validation task of SSL handshake.
cfgLDAPSRVLookupServiceName (Read/Write) Description Configures the service name to be used in the SRV lookup. Legal Values String of maximum length of 254 characters. Default ldap cfgLDAPRoleGroup Use this object with the getconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option.
Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupPrivilege -i 1 0x0 cfgLocation This group defines objects that support physical location properties. Use this object with the getconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. cfgLocationDatacenter (Read/Write) Description Indicates DataCenter name.
Default 0 cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings. Use this object with thegetconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. The following sections provide information about the objects in the cfgStandardSchema group.
Example racadm getconfig -g cfgStandardSchema -i 1 NOTE: -i is for the index.
Legal Values None Default None cfgChassisPeakPower (Read Only) Description Indicates the maximum system input power consumption (in Watt). Legal Values Default cfgChassisPeakPowerTimestamp (Read Only) The timestamp recorded when the peak input power consumption value occurred. Description Legal Values Default cfgChassisMinPower (Read Only) Description The minimum system input power consumption value (in Watt) over the time since the value was last cleared.
Default None cfgChassisRedundantState (Read Only) Description Enables or disables power redundancy for the chassis. Legal Values ● 0 (none) ● 1 (full) Default None cfgChassisDefaultPowerCapUpperBound (Read Only) Description Indicates the maximum default value to which you can set the power cap of a chassis. Legal Values 5000 Watt Default 5000 Watt cfgChassisDefaultPowerCapUpperBoundBTU(Read Only) Description Indicates the maximum default value to which you can set the power cap of a chassis.
cfgChassisPowerCap (Read/Write) Description Indicates the maximum power consumption limit (in Watt) 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. Legal Values 2715 – 16685 Watt Default 16685 Watt cfgChassisPowerCapF (Read/Write) Description Indicates the maximum power consumption limit (in Watt) for the entire chassis.
cfgChassisPowerCapFPercent (Read/Write) Description Indicates the power consumption limit as a percentage. The percentage is computed mathematically as the minimum power + (percent * (maximum power - minimum power)). Use cfgChassisPowerCapFPercent when power consumption is to be changed regardless of whether server throttling is required. Legal Values 16 - 100 NOTE: If the specified percent is lower than the minimum value, the CMC will set the value to the minimum value.
Default None cfgChassisInPowerServerAllocation (Read Only) Description Indicates (in Watt) the cumulative power allocated to servers. There is no default as this parameter is very specific to the particular customer configuration. Legal Values None Default None cfgChassisInfrastructureInPowerAllocation (Read Only) Description Indicates the estimated cumulative DC output power consumption (in watts), determined from a field replaceable unit (FRU) on the hardware modules in the chassis.
Legal Values None Default None cfgChassisPowerButtonEnable (Read/Write) Description Indicates if the chassis power button is enabled or disabled. Legal Values ● 0 (disabled) ● 1 (enabled) Default None cfgSystemEnergyConsumptionClear (Write Only) Description Resets energy statistics when set to 1.
cfgChassisServerBasedPowerMgmtMode Description Indicates the server-based power management mode of a chassis. Legal Values ● 0 (disabled) ● 1 (enabled) Default 0 (disabled) 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.
Legal Values 0 disables the mapping and 1 enables the mapping. Default None cfgDvdInfo This group is used to view the mapping information for the DVD drive in the chassis. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. cfgDvdMapping Read or Write Description Maps the slots to the DVD drive in the chassis: Legal Values 1, 2, 3, and 4 are the slot numbers that are specified.
Legal Values ● 1 (true) ● 0 (false) Default None To use this object property, you must have the Chassis Configuration Administrator privilege. cfgAlertingSourceEmailName Description Specifies the e-mail address used to send e-mail notifications when an event occurs. Legal Values Valid e-mail address Default None Examples racadm getconfig -g cfgAlerting -o cfgAlertingSourceEmailName racadm config -g cfgAlerting -o cfgAlertingSourceEmailName user@home.com Object value modified successfully.
route information using stateless auto configuration and DHCPv6. NOTE: The CMC uses its MAC address for its DUID (DUID-LL) when communicating with a DHCPv6 server. Legal Values ● 1 (TRUE) ● 0 (FALSE) Default 1 cfgIPv6Address Description Assigns a static IPv6 address to the CMC. This property is used only if cfgIPv6AutoConfig is set to 0 (false). Legal Values A string representing a valid IPv6 address.
cfgIPv6DNSServer1 (Read/Write) Description Specifies the IPv6 DNS server address. NOTE: This property is used only if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). Legal Values A string representing a valid IPv6 entry. For example, 2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF Default :: cfgIPv6DNSServer2 (Read/Write) Description Specifies the IPv6 DNS server address. NOTE: This property is only valid if cfgIPv6DNSServersFromDHCP6 is set to 0 (false).
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 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.
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.
Legal Values Default cfgDNSCurrentDomainName Description Displays the DNS domain name. Legal Values Default cfgCurrentIPv6LanNetworking (Read Only) This group displays the current CMC IPv6 properties. Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. cfgCurrentIPv6Enabled Description Indicates whether IPv6 is enabled on the CMC.
cfgCurrentIPv6Address Description Displays the current IPv6 addresses. This property displays up to 15 global IPv6 addresses, including stateful and stateless addresses. Legal Values Default cfgCurrentIPv6Gateway Displays the current IPv6 gateway. Description Legal Values Default cfgCurrentIPv6DNSServersFromDHCP6 Indicates whether the DNS server addresses are assigned from the DHCPv6 server. Description Legal Values Default cfgCurrentIPv6DNSServer1 Displays the IPv6 address for DNS server 1.
# cfgCurrentIPv6DNSServersFromDHCP6=1 # cfgCurrentIPv6DNSServer1=2009:123::1 # cfgCurrentIPv6DNSServer2=:: cfgNetTuning This group enables users to configure the advanced network interface parameters for the RAC NIC or CMC. When configured, the updated settings may take up to a minute to become active. The following sections provide information about the objects in the cfgNetTuning group. CAUTION: Use extra precaution when modifying properties in this group.
● 1 = Auto Negotiation is Enabled Default 1 Example racadm getconfig -g cfgNetTuning cfgNetTuningNicSpeed=100 cfgNetTuningNicFullDuplex=1 cfgNetTuningNicMtu=1500 cfgNetTuningNicAutoneg=1 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.
cfgRacSecCsrLocalityName (Read/Write) Description Specifies the CSR Locality (L). Legal Values A string of up to 128 characters. Default cfgRacSecCsrStateName (Read/Write) Description Specifies the CSR State Name (S). Legal Values A string of up to 128 characters. Default cfgRacSecCsrCountryCode (Read/Write) Description Specifies the CSR Country Code (CC). Legal Values A string of 2 alphabet country code.
cfgQuickDeploy This group is used to configure IDRAC deployment settings. You must have blade administrator privileges for configuring the settings. cfgActionOnServerInsertion Table 22. cfgActionOnServerInsertion — Details Description Configures settings when a new server is inserted into the slot. Legal Values ● ● ● ● Default 0 0 1 2 3 — — — — No Action QuickDeploy Only Server Profile Only Quick Deploy and Server Profile cfgSetiDRACRootPasswordOnServerInsertion Table 23.
cfgEnableiDRACIPv4 Table 26. cfgEnableiDRACIPv4 — Details Description Enables IPv4 for each iDRAC in the chassis. Any iDRAC that is not IPv6 is always IPv4 enabled. Legal Values ● 0 — Disable ● 1 — Enable Default 1 cfgEnableiDRACIPMIOverLAN Table 27. cfgEnableiDRACIPMIOverLAN 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 28.
cfgiDRACIPv4Netmask Table 31. cfgiDRACIPv4Netmask — Details 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 32. cfgEnableiDRACIPv6 — Details Enables IPv6 for each IPv6-capable iDRAC present in the chassis. Description Legal Values ● 0 — Disable ● 1 — Enable Default 0 cfgEnableiDRACIPv6AutoConfig Table 33.
Table 35. cfgiDRACIPv6Gateway — Details (continued) Default :: cfgReservedIPAddressNumbers Table 36. cfgReservedIPAddressNumbers — Details Description The number of static IPv4 addresses reserved for iDRACs in the chassis. Legal Values 32 Default 32 cfgUseCMCDNSSettings Table 37. cfgUseCMCDNSSettings — Details Description Propagates the CMC DNS Server settings (IPv4 and IPv6) to iDRAC when a blade server is inserted in the chassis.
