Dell Chassis Management Controller Version 3.
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. © 2008 - 2019 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents 1 Introduction................................................................................................................................12 What’s new in this release.................................................................................................................................................. 12 Supported RACADM Interfaces.........................................................................................................................................
getpbinfo............................................................................................................................................................................... 51 getpciecfg............................................................................................................................................................................ 52 getpminfo.................................................................................................................................
modifysecuritykey..........................................................................................................................................................93 deletesecuritykey...........................................................................................................................................................93 encryptvd..........................................................................................................................................................
cfgNicEnable (Read or Write).....................................................................................................................................119 cfgNicIpAddress (Read or Write)............................................................................................................................... 119 cfgNicNetmask (Read or Write)................................................................................................................................
cfgOobSnmpTrapFormat............................................................................................................................................ 133 cfgTraps.............................................................................................................................................................................. 133 cfgTrapsIndex (Read Only).......................................................................................................................................
cfgServerPowerConsumption (Read Only)..............................................................................................................144 cfgActiveDirectory.............................................................................................................................................................145 cfgADRacName (Read/Write)...................................................................................................................................
cfgSSADRoleGroupIndex (Read Only)......................................................................................................................156 cfgSSADRoleGroupName (Read/Write).................................................................................................................. 156 cfgSSADRoleGroupDomain (Read/Write)................................................................................................................157 cfgSSADRoleGroupPrivilege (Read/Write)................
cfgIPv6PrefixLength (Read/Write)...........................................................................................................................168 cfgIPv6Gateway (Read/Write)..................................................................................................................................168 cfgIPv6DNSServersFromDHCP6 (Read/Write)..................................................................................................... 169 cfgIPv6DNSServer1 (Read/Write).................
cfgiDRACIPv4Netmask............................................................................................................................................... 180 cfgEnableiDRACIPv6................................................................................................................................................... 180 cfgEnableiDRACIPv6AutoConfig...............................................................................................................................
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 documents from the Dell EMC support site What’s new in this release • Added a new command, sslsshresetcfg, to generate self-signed SSL SSH keys.
Remote RACADM racadm -r -u -p getconfig -g [-o ] [-i ] racadm -r -u -p Example racadm -r -u myuser -p mypass getconfig -g idracinfo racadm -r -u myuser -p mypass getsysinfo 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 remote IP address.
Table 3.
Subcommand CMC getversion Yes Yes help and help Yes Yes ifconfig Yes Yes jobqueue Yes Yes krbkeytabupload No Yes license Yes Yes netstat Yes Yes ping Yes Yes ping6 Yes Yes racdump Yes Yes racreset Yes Yes racresetpcie Yes Yes racresetcfg Yes Yes raid Yes Yes remoteimage Yes Yes serveraction Yes Yes set Yes Yes setassettag Yes Yes setflexaddr Yes Yes setled Yes Yes setniccfg Yes Yes setpciecfg Yes Yes setractime Yes Yes setsl
• • • • • • The Dell Chassis Management Controller (CMC) for Dell PowerEdge VRTX Version Release Notes provides last-minute updates to the system or documentation or advanced technical reference material intended for experienced users or technicians. The Integrated Dell Remote Access Controller User’s Guide provides information about installation, configuration, and maintenance of the iDRAC on managed systems.
• • Operating Systems • Support 4. To view a document, click the required product and then click the required version. Using search engines: • Type the name and version of the document in the search box.
2 RACADM Subcommand Details This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • ifconfig 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 sslsshresetcfg set tempprobes testcifsshare testemail testfeature testtrap tracerout
• • • • • • ) (right parentheses) & (ampersand) > (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.
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 ...
[-q ] [-n ] [-r ] [-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.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • CBL: Cable JCP: Job Control VF: vFlash Media IPA: DRAC IP Address SUP: FW Update Job RFM: FlexAddress SD PSUA: PSU Absent PCI: PCI Device LIC: Licensing RFL : IDSDM Media NIC : NIC Config VFL : vFlash Event TMPS : Temperature Statistics DIS : Auto-Discovery STOR : Storage SEL : Sys Event Log OSD : OS Deployment SRD : Software RAID RFLA : IDSDM Absent TST : Test Alert FSD : Debug RED : FW Download PST : BIO
Example • Display the number of records present in the Chassis Log: racadm chassislog view -i • Display the records under the storage category with severity set to warning: racadm chassislog view -c storage -s warning • Display the records under storage and system categories with severities set to warning or critical: racadm chassislog view -c storage,system -s warning,critical • Display the records having severities set to warning or critical, starting from sequence number 4: racadm chassislog view
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. To clear the chassis log, you must have the Clear Logs Administrator privilege.
• • 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. Closessn Description Closes a communication session on the device. Use the getssninfo command to view a list of sessions that can be closed using this command.
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. NOTE: This command is valid only in redundant CMC environments. For more information, see the "Understanding the Redundant CMC Environment" section of the Dell Chassis System User Guide.
• Output indexes a particular group supports. If -i is not specified, a value of 1 is assumed for groups, which are tables that have multiple entries. The index is specified by the index value, not a named value. -c — The -c, or check option, is used with the config subcommand and allows the user to parse the .cfg file to locate syntax errors. If issues are found, the line number and a short description about the issue is displayed. This option is a check-only.
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. Synopsis • • Input racadm deploy -m -u root -p -s -b -o racadm deploy -m -u root -p -s -6 -b -o • • • • where is a number between 0 and 128.
• 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.0 192.168.0.1 • ERROR: Server in slot 9 is an extension of the server in slot 1. racadm deploy -m server-7 -u root -p calvin -s -6 ::/64 :: 10 Displayable Characters Displayable characters include the following set: abcdefghijklmnopqrstuvwxwz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/ eventfilters Table 16.
• Input • • • • cmc.alert.audit.lic.critical 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. -n - The notification to be sent when the event occurs. Valid values are all, snmp, ipmi, lcd, email, or none. You can append multiple notifications separated by a comma. You cannot enter the values all or none with other notifications.
Synopsis racadm fanoffset [-s Valid category values are: • • • • off low medium high Input s — Sets the fan speed. Example • Disable the fanoffset feature. racadm fanoffset -s off • Increases fan speed by 20% of fan’s maximum speed. Minimum speed for fan is 35% of the maximum. racadm fanoffset -s low • Increases fan speed by 50% of fan’s maximum speed. Minimum speed for fan is 65% of the maximum. racadm fanoffset -s medium • Sets fans to run at 100% of fan’s maximum speed.
feature Table 19. Details of feature Description Displays all active chassis features. The information displayed includes feature name, date activated, and the serial number of the SD card used to activate the feature. Dell Feature Cards may contain more than one feature. NOTE: To use this subcommand to deactivate FlexAddress or ExtendedStorage, you must have the Chassis Configuration Administrator privilege. A user with login privileges can view status only.
FlexAddress: not bound FlexAddressPlus: not bound ExtendedStorage: bound fwupdate Table 21. Details of fwupdate Description Allows you to update the firmware on the active and standby CMC firmware, chassis infrastructure firmware, and storage component firmware (RAID controller, hard disk drive, and expander). You can: • • • • Check the firmware update process status. Update the firmware from a FTP or a TFTP server by providing an IP address and optional path.
• • • • • • -g — For CMC, the firmware is downloaded using the TFTP server. -u — The firmware update operation is performed. -a — Specifies the TFTP server IP address or FQDN used for the firmware image (used with -g). NOTE: CMC accepts IPv4, IPv6, or fully qualified domain names (FQDN) for both FTP and TFTP servers. -d — Specifies the source path where the firmware image is stored.
• racadm fwupdate –g –u –a -d -m cmc-active Firmware update has been initiated. This update process may take several minutes to complete. • racadm fwupdate –s –m cmc-active Invalid firmware: The uploaded firmware image does not contain a verification signature get Table 22. Details of get Description Saves CMC configuration properties or CMC Event Filter configurations to a file.
• Export the CMC XML configuration to an NFS share racadm get -f file.xml -t xml -l 192.168.0.0:/myshare getactiveerrors Table 23. Details of getactiveerrors Description Displays the active errors in a chassis. To run this subcommand, you must have the CMC Login User privilege.
getchassisname Table 25. Details of getchassisname Description Displays the name of the chassis. To use this subcommand, you must have the CMC Login User privilege. Synopsis Example racadm getchassisname racadm getchassisname CMC-1 getconfig Table 26. Details of getconfig Description Retrieves CMC configuration parameters individually, or all CMC configuration groups may be retrieved and saved to a file.
• • Output -u — The -u , or user name option, can be used to display the configuration for the specified user. The option is the login name for the user. -v — The -v option displays additional details with the display of the properties and is used with the -g option.
Synopsis racadm getdcinfo Input -n — Displays the model names for the daughter cards in servers. Table 29. Example switch-1 Gigabit Ethernet OK Master server-1 Present None None server-2 Not Present None None server-3 Not Present None None server-4 Present None Broadcom M5708t Table 30. getdcinfo getflexaddr Table 31.
Table 32. Example 1 Enabled Present 2 Enabled Present 3 Enabled Not Present 4 Enabled Not Present Table 33.
-s — Displays the stack information. Table 35. Example switch-1 ON R1-PT VRTX 1Gb Master Passthrough N/A Gigabit Ethernet Present OK getled Table 36. Details of 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.
• 3—iSCSI/FCoE-FIP To use this subcommand, you must have the CMC Login User privilege. Synopsis • racadm getmacaddress • racadm getmacaddress -m chassis • racadm getmacaddress -m switch- • racadm getmacaddress [-m [-x]] [-t iscsi] • racadm getmacaddress -a • racadm getmacaddress -c IO-Identity • racadm getmacaddress -c Flexaddress • racadm getmacaddress -c Factory • racadm getmacaddress -c all • Input -m — Specifies the module whose MAC address you want to view.
• • racadm getmacaddress -c io-identity -m server -2 Displays the console assigned MAC/WWN of all LOMs or mezzanine cards. racadm getmacaddress -c all • Displays the chassis assigned WWN/MAC address. racadm getmacaddress -c flexaddress • Displays the MAC/WWN addresses for all LOMs or mezzanine cards. racadm getmacaddress -c factory Table 38. MAC address for chassis CMC Present N/A F0:4D:A2:77:71:7 2 N/A Table 39.
Table 42. MAC address CMC Present N/A 00:1E:4F:1F:3C:5 8 N/A Server-1 Present 00:1E:4F:2A:AF:7 B 00:1E:4F:2A:D3:9 7 00:1E:4F:2A:D3:9 9 Server-2 Present 00:22:19:D2:1E:8 4 N/A N/A Server-3 Not Present N/A N/A N/A Server-4 Present 00:18:8B:FF:45:2 A 00:18:8B:FF:AA:0 2 00:18:8B:FF:AA:0 4 Switch-1 Present N/A 00:00:00:00:00:0 0 N/A Table 43.
Server-2-B 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 Installed Server-4-C Fibre Channe
Gigabit Ethernet Present 00:0A:00:0A:0 0:03 Unknown IO-Identity Table 45. MAC/WWN addresses Server-3-A IDRACController Present Gigabit Ethernet Present Gigabit Ethernet Present 10 GbE KR Present Switch-1 5C:F9:DD:D6:1 C:CE 84:8F:69:FC:E 8:F0 84:8F:69:FC:E 8:F1 F8:B1:56:45:D D:BD N/A Factory Unknown Factory Unknown Factory N/A Factory Table 46.
Server-1A 10 GbE KR Not Installed 10:98:36:AC:70:EB Not Installed Not Installed Server-2 Not Installed Not Present Not Installed Not Installed Not Installed Server-3A Reserved Present Switch-4 Not Installed Not Present Not Installed Not Installed Not Installed Switch-1 Not Installed Not Present Not Installed N/A N/A NOTE: If the I/O Modules in slots 1 and 2 are absent and the getmacaddress -a and getmacaddress —c all commands are run, the output is displayed as Not Installed in th
Example • racadm getmodinfo -m switch-1 Switch-1 ON A • N/A Present OK N/ racadm getmodinfo NOTE: A power state of "Primary" denotes Active CMC.
getniccfg Table 49. getniccfg Description Displays the current NIC settings.
VLAN Enable VLAN ID VLAN priority = 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.0 getpbinfo Table 50. Details of getpbinfo Description Displays power budget status information. To use this subcommand, you must have the CMC Login User privilege.
getpciecfg Table 51. Details of getpciecfg Description Displays the FQDD of the PCIe slots and Virtual Adapters, and their mapping information and properties. NOTE: Synopsis • To use this subcommand, you must have the CMC Login User privilege. • Lengthy PCIe card names and server slot names are truncated when the assignments for all PCIe slots are displayed. racadm getpciecfg [-c ][a] Input • • • • -a — Use this option to display the assignment of PCIe slots and Virtual Adapters.
• Displays FQDDs of all the PCIe slots and PCIe Virtual Adapters: racadm getpciecfg • PCIe slot 01 PCIe slot 02 PCIe slot 03 PCIe slot 04 PCIe slot 05 PCIe slot 06 PCIe slot 07 PCIe slot 08 PCIE.ChassisSlot.1 PCIE.ChassisSlot.2 PCIE.ChassisSlot.3 PCIE.ChassisSlot.4 PCIE.ChassisSlot.5 PCIE.ChassisSlot.6 PCIE.ChassisSlot.7 PCIE.ChassisSlot.
(177 BTU/hr) Minimum System Power Start Time 01/21/2008 Minimum System Power Timestamp 01/26/2009 System Idle Power BTU/hr) System Potential Power BTU/hr) System Input Current Reading = 22:43:21 = 06:32:55 = 68 W (188 = 68 W (188 = 31.2 A [Real-Time Energy Statistics] System Energy Consumption 6.
Output The default output display shows the record number, message ID, category, agent ID, severity, time stamp, message arg, and message. The timestamp begins at midnight, January 1, and increases until the system restarts. After the system restarts, the system’s timestamp is used. SeqNumber Message ID Category AgentID Severity Timestamp Message Arg Message Example • 1 = = = = = = = = 4 CMC8550 Audit CMC Information 1982-03-21 05:33:35 Healthy Chassis health is Healthy Displays all the logs.
Example racadm getredundancymode Redundant getsel Table 57. Details of getsel Description Displays all sensor event log entries in the DRAC. Synopsis • • racadm getsel -i [-A] racadm getsel [-s ] [-c ] [-A] [-o] [-E] [-R] [--more] If no arguments are specified, the entire log is displayed. Input • • • • • • • • -A — Specifies output with no display headers or labels. -c — Provides the number of records to be displayed. -o — Displays each entry in the SEL in a single line.
Table 59. Examples UC Fan-1 OK 0 840 600 N/A N/A Fan-2 OK 0 840 600 N/A N/A Fan-3 OK 4037 840 600 N/A N/A Fan-4 OK 4045 840 600 N/A N/A Fan-5 OK 4107 840 600 N/A N/A Fan-6 OK 0 840 600 N/A N/A Blower-1 N/A 0 3000 2250 N/A N/A Blower-2 N/A 0 3000 2250 N/A N/A Blower-3 N/A 0 3000 2250 N/A N/A Blower-4 N/A 2611 3000 2250 N/A N/A Table 60.
3 Blower-3 OK 1704 rpm 1108 923 N/A N/A 20 4 Blower-4 OK 1702 rpm 1108 923 N/A N/A 20 Table 62. Temp sensor 1 Chassis Ambient OK 27 C 3 —7 42 47 2 Server-1 OK 31 C 3 —7 42 47 3 Server-3 OK 29 C 3 —7 42 47 Table 63.
• • • Example • 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 SLOT-03 4 SLOT-04 • Display the name of the third slot. racadm getslotname -i 3 • • • Verify if the option ‘0’ is set for displaying the slot name.
getsvctag Table 69. Details of 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 Table 70. Details of getsysinfo Description Displays information related to CMC and chassis.
Examples 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.
Output 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. Example 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 72.
cmc-2 3.00.000.201609223282 Y Main Board 2.21.A00.201510302495 System.Chassis.1#Infrastructure.1 Shared PERC8 23.13.06.0011 RAID.ChassisIntegrated.1-1 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.1-1 Physical Disk 0:0:1 AS09 Disk.Bay.
• • • • • • • • • • 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. NOTE: The Linux shell script does not support the characters—$ (dollar),` (back quote), \ (forward slash), & (ampersand), ( (open bracket), ) (Close bracket), = (equal), | (Pipe), ; (semi colon)," (Double quote), ' (single qu
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 Table 74.
Example • Display all the jobs: -------------------------JOB QUEUE-----------------------[Job ID=RID_853106266329] 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] ----------------------------
license Table 76. Details of license Description Manages the CMC licenses. Synopsis racadm license .
• View all the license information in the chassis. racadm license view CMC.Integrated.1 Status = OK Device = CMC.Integrated.1 Device Description = Chassis Management Controller for PowerEdge VRTX Unique Identifier = License #1 Status = OK Transaction ID = 8 License Description = CMC Enterprise Evaluation License License Type Entitlement ID A2Wir6lJ1MoP8iBAtqsEKDv8 Expiration • = EVALUATION = = 1982-04-07T21:00:00 Display licenses available on a specific device.
• Delete license using an entitlement ID. For example, xYZabcdefg racadm license delete -e xYZabcdefg • Delete license using a transaction ID. For example, 2. racadm license delete -t 2 • Replace a license. • 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.
ping6 Table 79. Details of ping6 Description Verifies that the destination IPv6 address is reachable from an iDRAC or CMC, or with the current routing-table contents. A destination IPv6 address is required. An ICMP echo packet is sent to the destination IPv6 address on the basis of current routingtable contents. To use this subcommand for CMC, you must have the Administrator privilege. Synopsis racadm ping6 Example racadm iping6 198.162.0.2 IPING6 198.162.0.2 (192.168.0.
• • • • • • • Output Power budget information - getpbinfo KVM information - getkvminfo NIC information (CMC module) - getniccfg Redundancy information - getredundancymode Trace log information - gettracelog RAC event log - getraclog System event log - getsel The following information is displayed when the racdumpsubcommand is processed: • • • • • General system/RAC information Coredump Session information Process information Firmware build information Example racadm racdump =============================
FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed 1 2 3 4 5 6 7 8 9 Fan-1 Fan-2 Fan-3 Fan-4 Fan-5 Fan-6 Fan-7 Fan-8 Fan-9 OK OK OK OK OK OK OK Not OK OK 14495 14505 4839 14527 14505 4835 14521 1 4826 rpm rpm rpm rpm rpm rpm rpm rpm rpm 7250 7250 2344 7250 7250 2344 7250 7250 2344 Temp 1 Ambient_Temp OK 21 celcius N/A PWR 1 PWR 2 PWR 3 PWR 4 PWR 5 PWR 6 PS-1 PS-2 PS-3 PS-4 PS-
Input • -m : — Must be one of the following values: • • chassis — default state, if -m is not specified. • server-n, where n=1–4 • switch-n, where n=1 -c : — Must be one of the following values: • • • • Example • ad — Reset Active Directory properties to the default value. The default setting is “disabled”. pcap — Reset Power Cap properties to the default value. flex — Reset FlexAddress properties to the default value. The default setting is “enabled”.
• 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 controllers -o -p • This command displays the filtered property values for all returned controller objects.
This command displays all enclosure keys connected to the controller being mentioned as refkeys. racadm raid get enclosures --refkey -o optimized version. This command displays all enclosure objects for the controller’s FQDD. racadm raid get enclosures --refkey -o -p • This command is an optimized and filtered version.
• Monitor and Inventory all Temperature Probes connected to the enclosure racadm raid get tempprobes --refkey This command displays all temperature probe keys connected to the enclosures being mentioned as refkeys. racadm raid get tempprobes --refkey -o This command is an optimized version and displays all temperature probe objects for the enclosure FQDD.
createvd Table 86. Details of createvd Description Creates a virtual disk based on the specification that you enter with this command. NOTE: You can create multiple virtual disks using the script at an instance. But, ensure that there is an interval of about 30 seconds to facilitate completion of the first slice virtual disk creation before running the second slice virtual disk command.
Example racadm raid createvd:RAID.ChassisIntegrated.1-1 -rl r0 pdkey:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 NOTE: Make sure to provide the current active controller FQDD in the createvd command. deletevd Table 87. Details of deletevd Description Deletes the specified virtual drive. Synopsis Input racadm raid deletevd: {-current|-pending} • –current : Performs the configuration right now. NOTE: If this requires the system to reboot, it will reboot.
Example racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l u -p [-f ] forceonline Table 90. Details of forceonline Description Forces the RAID Controller to make the specified drive online. This operation may result in obsolete or corrupted data, and should only be attempted in cases where a rebuild operation has failed or is not applicable.
SasAddress PciDeviceId PciSubdeviceId PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvailabilityMode PeerController = 0x590B11C02620E600 = 0x2f = 0x1f3e = 0x1000 = 0x1028 = 0x0 = 0x0 = 0x0 = Unknown = Short = Unknown = 6.0 Gb/s, 3.0 Gb/s = Not supported = None = N/A Sample output of a CMC in which you have firmware support for the fault-tolerant mode and the hardware, and fault-tolerant mode is active. RAID.ChassisIntegrated.
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 HighAvailabilityMode PeerController RAID.ChassisIntegrated.
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.05 ServiceTag = 6Q2XMQ1 AssetTag = slot 5 1 AssetName = MD1220 RedundantPath = Present SasAddress = Not applicable SlotCount = 24 Enclosure.External.0-0:RAID.ChassisSlot.
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.2-1 Status = Ok State = Ready Name = Expander 1 PartNumber = 0TJ2VKA00 FirmwareVersion = 2.00 EMM.Slot.0:Enclosure.External.0-1:RAID.ChassisSlot.
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.5-1 FanOperationalStatus = Ok racadm raid get fans -o Fan.Slot.0:Enclosure.External.0-1:RAID.ChassisSlot.
Input • Example -o — The -o is used to display the fault-tolerant status of a enclosure. 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.External.0-1:RAID.ChassisSlot.
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.5-1 Status = Ok State = Ready Name = Temp Sensor 2 ReadingDegreeCelcius = 29 C MinimumWarningThreshold = 8 C MaximumWarningThreshold = 45 C MinimumFailureThreshold = 3 C MaximumFailureThreshold = 55 C TempSensor.Embedded.3:Enclosure.External.0-1:RAID.ChassisSlot.
Synopsis Input 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. You can use a combination of the –pending and –current flags on multiple commands to reduce the possible number of system reboots.
assignva Table 100. Details of 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. NOTE: You can assign a virtual disk to multiple virtual adapters from CMC CLI even when the Assignment Mode is set to Single Assignment in the CMC web interface.
init Table 102. Details of init Description Starts an initialization operation on the specified virtual drive. Synopsis Input 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.
• • • Example • • • • • • • • • • • • • • • • • • • • • • • • • 90 • unblink • clearconfig • 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.
• • • • • • • • • • • • • racadm raid changepolicy:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -wp {wt|wb} -rp {nra|ra|ara} -dcp {enabled|disabled|default} racadm raid rename:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -name racadm raid rename:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -name racadm raid ctrlprop:RAID.ChassisIntegrated.
NOTE: If this requires the system to reboot, then the system will reboot. • Example –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. • racadm raid resetconfig:RAID.ChassisIntegrated.1-1 enableperc Table 106. Details of enableperc Description Indicates the RAID configuration of hardware RAID connected to the server.
-passwd — passphrase. The passphrase can be a minimum of eight characters and a maximum of 32 characters. The passphrase must have one character from each of the following: • • • • Example uppercase lowercase number non-alphanumeric character except space racadm raid createsecuritykey:RAID.ChassisIntegrated.1-1 -key Key@123_ -passwd Pass@123_ modifysecuritykey Table 109. Details of modifysecuritykey Description Modifies the security key and password of the controller.
cryptographicerase Table 112. Details of cryptographicerase Description Erases the contents of a physical disk, which is part of a secure virtual disk that has been deleted. Synopsis racadm raid cryptographicerase: Example racadm raid cryptographicerase:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.11 unlock Table 113. Details of unlock Description Unlocks the SEDs migrated from a controller with different security key. The security status of such drives is displayed as “Locked”.
Disable Remote File Started. Please check status using -s option to know Remote File Share is ENABLED or DISABLED. • racadm remoteimage -s - status Remote File Share is Enabled UserName Password ShareName //192.168.0.1/xxxx/dtk_3.3_73_Linux.iso serveraction Table 115. Details of serveraction Description Enables you to perform power management operations on the host system. To use this subcommand, you must have the Execute Server Control Commands permission.
• Turn off the server from iDRAC when Power is already off on that server.
• Configure a CMC from an XML configuration file on a local share using remote racadm racadm -r 192.168.0.120 -u -p set -f myfile.xml -t xml • Configure a CMC from an XML configuration file on a remote CIFS share racadm set -f myfile.xml -t xml -u myuser -p mypass -l // 192.168.0.0/myshare • Configure a CMC from an XML configuration file on a remote NFS share racadm set -f myfile.xml -t xml -l 192.168.0.0:/myshare setassettag Table 117.
Example racadm setchassisname dellchassis-1 The chassis name was set successfully. set controllers Table 119. Details of set controllers Description Sets the RAID controllers detected in the system and fault-tolerant mode is configured on external controllers (Shared PERC 8 External).
where 0 is disable and 1 is enable. Input • • Example -i — Enables or disables FlexAddress for the specified slot. -f — Enables or disables FlexAddress for the specified fabric. • racadm setflexaddr -i 1 0 Slot 1 FlexAddress state set successfully • racadm setflexaddr -f A 1 Fabric A FlexAddress state set successfully • racadm setflexaddr -f idrac 1 setled Table 121.
NOTE: Set enclosure is used for the storage expansion feature when available with shared external PERCs. NOTE: You cannot modify the asset names for internal enclosures. Synopsis racadm raid set enclosures: Enclosure.External.0-0:RAID.ChassisSlot.5-1 – p AssetTag racadm raid set enclosures: Enclosure.External.0-0:RAID.ChassisSlot.5-1 – p AssetName -p — Specifies the property of the enclosure to be modified. Input setniccfg Table 123.
NOTE: To use this subcommand, you must have Chassis Administrator privilege. NOTE: The slot assignment feature is licensed. Synopsis racadm setpciecfg assign [-c ] [-i ] racadm setpciecfg unassign [-c ] racadm setpciecfg ridethru -e racadm setpciecfg ridethru -d racadm setpciecfg ridethru -t
Synopsis • • • racadm setractime -d racadm setractime -l YYYYMMDDhhmmss racadm setractime -z {?|timezone|timezone-prefix*} Input • -d — Sets the time to value in the string: — yyyy is the year — mm is the month — dd is the day — hh is the hour — mm is the minutes — ss is the seconds — mmmmmm is the number of microseconds — s is a + (plus) sign or a - (minus) sign, which indicates the sign of the offset.
setslotname Table 126. Details of setslotname Description Sets the name of the server slot and enables the feature to display the slot name, host name or iDRAC DNS name of all the four server slots, or of a specified slot (indicated by the server slot number) in the chassis. Optionally, use this command to set whether the server slot name or host name is displayed in the CMC Web interface or with the getslotname -i command. If the host name is not available, the static server slot name is used.
• Example -c — Sets the chassis name or location. racadm setsysinfo -c chassisname "Dell Rack System" The chassis name was set successfully. SSH or Telnet RACADM racadm getconfig -g [-o ] [-i ] racadm Example racadm getconfig -g idracinfo racadm getsysinfo sshpkauth Table 128. Details of 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.
NOTE: This option is supported only on the remote interface(s). • • -v - View privilege and key text. -d - Delete key and privilege for the index provided. Examples : • 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.
Synopsis Input racadm sslcertview -t [-A] • -t — Specifies the type of certificate to view, either the CA certificate or server certificate. —1 = server certificate • —2 = CA certificate for Directory Service. -A — Prevents printing of headers or labels. Table 131. Output Serial Number 00 Subject Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc.
Valid To Jul 7 16:21:56 2010 GMT 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 Table 132. Details of sslcsrgen Description Generates and downloads a CSR file to the client’s local file system. The CSR can be used for creating a custom SSL certificate that can be used for SSL transactions on iDRAC.
NOTE: If the -f option is not specified, the filename defaults to sslcsr in your current directory. Output 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. CSR does not exist. racadm sslcsrgen -s or racadm sslcsrgen -g -f c:\csr\
set tempprobes Table 134. Details of set tempprobes Description Sets the minimum and maximum warning threshold of temperature probe in the enclosure Synopsis racadm raid set tempprobes:TempSensor.Embedded.0:Enclosure.External.1 0:RAID.ChassisSlot.6-1 –p MinimumWarningThreshold racadm raid set tempprobes:TempSensor.Embedded.0:Enclosure.External.1 0:RAID.ChassisSlot.6-1 –p MaximumWarningThreshold Input -p— The network password of the share.
• Set the custom message that is sent to the destination e-mail address — racadm config -g cfgEmailAlert -o cfgEmailAlertCustomMsg -i 1 "This is a test!" • Make sure that the SMTP IP address is configured properly — racadm config -g cfgRemoteHosts -o cfgRhostsSmtpServerIpAddr 192.168.0.152 • View the current e-mail alert settings — racadm getconfig -g cfgEmailAlert -i where is a number from 1 to 4. testfeature The following tables describe the testfeaturesubcommand options. Table 136.
NOTE: In the event of an error, the command displays the test that failed, all the tests performed earlier to the test that failed, and all the error messages. Synopsis Example testfeature -f ad -u -p [-d ] • testfeature –f ad –u user@domain –p secret SUCCESSFUL: User permissions are xxxxxppp. • • The last three digits are the user's permissions. testfeature –f adkrb –u user_name@domain_name SUCCESSFUL: User permissions are 80000fff.
Synopsis testfeature -f ldap -u -p [-d ] testtrap Table 140. Details of testtrap Description Tests the RAC’s SNMP trap alerting feature by sending a test trap from iDRAC to a specified destination trap listener on the network. To use this subcommand, you must have the Test Alerts privilege. NOTE: Before you execute the testtrap subcommand, make sure that the specified index in the RACADM cfgAlerting group is configured properly.
Output traceroute to 192.168.0.1 (192.168.0.1), 30 hops max, 40 byte packets 1 192.168.0.1 (192.168.0.1) 0.801 ms 0.246 ms 0.253 ms traceroute6 Table 142. Details of traceroute6 Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv6 address. To use this subcommand, you must have the Administrator privilege.
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) Table 143. Details of idRacProductInfo Description A text string that identifies the product.
One instance of the group is allowed. Some objects in this group may require iDRAC NIC to be reset, which may cause a brief loss in connectivity. Objects that change iDRAC NIC IP address settings close all active user sessions and require users to reconnect using the updated IP address settings. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege.
• • cfgDNSDomainNameFromDHCP cfgDNSDomainName (Read/Write) The network administrator must make sure that these DHCP servers are configured to provide the same DNS domain name to the CMC, otherwise the domain name becomes unpredictable. cfgDNSDomainName (Read or Write) Table 150. Details of cfgDNSDomainName 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.
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.lab cfgDNSDomainNameFromDHCP=1 cfgDNSRegisterRac=1 cfgDNSServersFromDHCP (Read or Write) Table 153.
cfgDNSServer1 (Read or Write) Table 154. Details of 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 cfgDNSServer2 (Read/Write) Table 155.
cfgNicNetmask (Read or Write) Table 158. Details of cfgNicNetmask 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 or Write) Table 159. Details of cfgNicGateway Description CMC gateway IPv4 address.
cfgRhostsFwUpdateTftpEnable (Read or Write) Table 161. Details of cfgRhostsFwUpdateTftpEnable Description Enables or disables CMC firmware update from a network TFTP server. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgRhostsFwUpdateIpAddr (Read or Write) Table 162. Details of cfgRhostsFwUpdateIpAddr 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.
icfgRhostsNtpEnable Table 165. Details of icfgRhostsNtpEnable Description Enables or disables the use of the Network Time Protocol (NTP) for date and time synchronization. Legal Values • • Default 0 1 (true) 0 (false) cfgRhostsNtpServer1 Table 166. Details of cfgRhostsNtpServer1 Description Specifies the first of three possible NTP servers. Legal Values A string representing a valid NTP server. For example, ntp1.ntp.net.
Legal Values 1–128 Default 16 cfgRhostsSyslogPort (Read or Write) Table 170. Details of cfgRhostsSyslogPort Description Remote syslog port number to use for writing the RAC and SEL logs to a remote syslog server. 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.
cfgRhostsSyslogServer3 (Read or Write) Table 174. Details of cfgRhostsSyslogServer3 Description Specifies the third of three possible remote syslog servers to store the RAC and SEL logs. This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values Valid hostname or IPv4 or IPv6 address. Default cfgRhostsSyslogPowerLoggingEnabled Table 175.
cfgUserAdmin This group provides configuration information about the users who are 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. NOTE: In the current CMC firmware version, the objects cfgUserAdminEnable and cfgUserAdminPrivilege are interrelated; changing the value of one property causes the value of the other property to change.
Table 179.
cfgUserAdminUserName (Read or Write) Table 181. Details of cfgUserAdminUserName Description The name of the user for this index. The user index is created by writing a string into this name field if the index is empty. Writing a string of double quotation marks ("") deletes the user at that index. You cannot change the name. You must delete and then recreate the name. The string cannot contain / (forward slash), \ (backslash), . (period), @ (at symbol) or quotation marks.
cfgEmailAlertIndex (Read Only) Table 184. Details of cfgEmailAlertIndex Description The unique index of an alert instance. Legal Values 1-4 Default cfgEmailAlertEnable (Read/Write) Table 185. Details of cfgEmailAlertEnable Description Enables or disables the alert instance. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgEmailAlertAddress (Read/Write) Table 186.
cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to CMC. One instance of the group is allowed. Displays current settings for and configures idle timeout properties for Web server, Telnet, SSH, and RACADM sessions. Changes to idle timeout settings take effect at the next login. To disable idle timeout for a connection, set this property to 0. The following sections provide information about the objects in the cfgSessionManagement group.
cfgSerialBaudRate (Read/Write) Table 190. Details of cfgSerialBaudRate Description Sets the baud rate on the serial port. Legal Values 2400, 4800, 9600, 19200, 28800, 38400, 57600,115200 Default 115200 cfgSerialConsoleEnable (Read/Write) Table 191. Details of cfgSerialConsoleEnable Description Enables or disables the RAC or CMC serial console interface. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgSerialConsoleIdleTimeout (Read/Write) Table 192.
cfgSerialConsoleColumns Table 195. Details of cfgSerialConsoleColumns Description Specifies the number of columns in the terminal window command line connected to the serial port. You must log out, then log in again for the changes to take effect. NOTE: The prompt counts as two characters. NOTE: The terminal emulator must be configured with the line wrap mode ON, if a terminal emulator is used. Legal Values 0–256 Default 0 (equivalent to 80) cfgSerialHistorySize (Read/Write) Table 196.
cfgSerialTelnetEnable (Read/Write) Table 198. Details of cfgSerialTelnetEnable Description Enables or disables the Telnet console interface on CMC. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) 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.
cfgOobSnmpProtocol Table 201. Details of cfgOobSnmpProtocol attribute Description Specifies the SNMP protocol used for SNMP traps. Legal Values • • Default 0 0 — All 1 — SNMPv3 cfgOobSnmpTrapFormat Table 202. Details of cfgOobSnmpTrapFormat attribute Description Specifies the format for SNMP traps. Legal Values • • • Default 0 0 — SNMPv1 1 — SNMPv2 2 — SNMPv3 cfgTraps This group displays information for and configures delivery of SNMP traps for a specific user.
cfgTrapsAlertDestIpAddr Table 205. Details of 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 Table 206. Details of 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.
cfgRacTuneSMBVersionEnable Table 209. Details of cfgUseCMCDNSSettings attribute Description Can be used for setting the SMB version. Legal Values • • • • • • Default NA SMBv1 SMBv2 SMBv3 1 2 3 cfgRacTuneDefCredentialWarningEnable Use this object with the getconfig or config subcommands. Table 210. Details of cfgRacTuneDefCredentialWarningEnable Description Enables or disables the display of the default password warning message.
cfgRacTuneHttpsPort (Read/Write) Table 213. Details of cfgRacTuneHttpsPort Description Specifies the port number to use for HTTPS network communication with. Legal Values 10–65535 NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 111, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, and 60106. Default 443 cfgRacTuneIpRangeEnable (Read/Write) Table 214. Details of cfgRacTuneIpRangeEnable Description Enables or disables the IPv4 Address Range validation feature.
• cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr. Legal Values An IPv4 address formatted string, for example, 255.255.255.0. Default 255.255.255.0 cfgRacTuneIpBlkEnable (Read/Write) Table 217. Details of cfgRacTuneIpBlkEnable Description Enables or disables the IPv4 address blocking feature. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgRacTuneIpBlkFailCount (Read/Write) Table 218.
cfgRacTuneSshPort (Read/Write) Table 221. Details of cfgRacTuneSshPort Description Specifies the port number used for the SSH interface. Legal Values 10–65535 Default 22 cfgRacTuneTelnetPort (Read/Write) Table 222. Details of cfgRacTuneTelnetPort Description Specifies the port number used for iDRAC or CMC Telnet interface. NOTE: For CMC, the following port numbers are reserved and cannot be used: 21, 68, 69, 111, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, and 60106.
cfgRacTuneWebserverEnable (Read/Write) Table 225. Details of cfgRacTuneWebserverEnable Description Enables or disables the Web server. If this property is disabled, CMC is not accessible using client Web browsers. This property has no effect on the Telnet/SSH or RACADM interfaces. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgRacTuneFipsModeEnable Table 226. Details of cfgRacTuneFipsModeEnable attribute Description Enables or disables the FIPS mode.
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) Table 233. Details of cfgServerFW Description Displays the server's iDRAC management firmware revision. Legal Values None Default None cfgServerBIOS (Read Only) Table 234. Details of cfgServerBIOS Description Displays the server's BIOS revision. Legal Values None Default None cfgServerBmcMacAddress (Read Only) Table 235. Details of cfgServerBmcMacAddress Description Displays the BMC MAC address of the specified server.
cfgServerNic3MacAddress (Read Only) Table 238. Details of cfgServerNic3MacAddress Description Displays the MAC address of the server NIC 3. Legal Values None Default None cfgServerNic4MacAddress (Read Only) Table 239. Details of cfgServerNic4MacAddress Description Displays the MAC address of the server NIC 4. Legal Values None Default None cfgServerPriority (Read/Write) Table 240.
cfgServerPowerBudgetAllocation (Read Only) Table 243. Details of cfgServerPowerBudgetAllocation Description Displays the current power allocation for the server. Legal Values • • Default None 1 (Enable) 0 (Disable) cfgServerDNSRegisterIMC (Read/Write) Table 244. Details of cfgServerDNSRegisterIMC Description Enables or disables DNS name registration for the Integrated System (iDRAC). Legal Values • • Default None 1 (enable) 0 (disable) cfgServerDNSIMCName (Read/Write) Table 245.
NOTE: For a vFlash Partition to be configured as First Boot Device, it has to be attached first. When a detached or non-existent VFlash partition or a non-standard boot device is configured as first boot device, the following error message is displayed: Invalid object value Legal Values • • • • • • • • • • 0–default 4–PXE 8–HDD 20–DIAG 28–CD-DVD 32–BIOS 36–vFDD 40–VCD-DVD 44–iSCSI 60–VFLASH partition label Default 0 (zero) cfgServerBootOnce (Read/Write) Table 248.
# cfgServerNic3MacAddress=00:0D:56:B8:69:CB # cfgServerNic4MacAddress=00:0D:56:B8:69:CD cfgServerPriority=1 cfgServerNicEnable=1 cfgServerIPMIOverLANEnable=1 # cfgServerPowerBudgetAllocation=0 cfgServerDNSRegisterIMC=0 cfgServerDNSIMCName=iDRACcfgServerRootPassword=******** (Write-Only) cfgServerFirstBootDevice=0 # cfgServerBootOnce=1 # cfgServerPowerConsumption=0 racadm getconfig -g cfgServerInfo -i 1 # cfgServerInfoIndex=1 # cfgServerSlotNumber=1 # cfgServerServiceTag=1S0M0G1 cfgServerName=SLOT-01 # cfgSe
cfgADRacName (Read/Write) Table 250. Details of cfgADRacName 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. Default cfgADCertValidationEnable (Read/Write) Table 251. Details of cfgADCertValidationEnable Description Enables or disables Active Directory certificate validation as a part of the Active Directory configuration process.
Default 0 cfgADAuthTimeout (Read/Write) Table 255. Details of cfgADAuthTimeout Description Specifies the number of seconds to wait for Active Directory authentication requests to complete before timing out. NOTE: To modify this property, you must have the Configure CMC privilege. Legal Values 15–300 seconds Default 120 cfgADSCLEnable Table 256. Details of cfgADSCLEnable Description Enables you to log on to the CMC without enabling the Smart Card login.
cfgADDomainController2 (Read/Write) Table 259. Details of cfgADDomainController2 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 cfgADDomainController3 (Read/Write) Table 260. Details of cfgADDomainController3 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 cfgADType (Read/Write) Table 264. Details of cfgADType Description Determines the schema type to use with Active Directory. Legal Values • • Default 1 1 (Enables Active Directory with the extended schema) 2 (Enables Active Directory with the standard schema) cfgADDcSRVLookupbyUserdomain (Read/Write) Table 265.
cfgADGcRootDomain (Read/Write) Table 268. Details of cfgADGcRootDomain 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) Table 269. Details of cfgADGcSRVLookupEnable Description Determines how the global catalog server is looked up.
If this property is disabled, local CMC authentication is used for user logins. NOTE: For CMC, enabling this option turns off cfgADEnable. Legal Values • • Default 0 1 (TRUE)— Enable 0 (FALSE)— Disable cfgLDAPServer (Read/Write) Table 272. Details of cfgLDAPServer 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.
Legal Values String. Maximum length = 254 Default Null uid if not configured. cfgLDAPGroupAttribute (Read/Write) Table 276. Details of cfgLDAPGroupAttribute 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) Table 277.
Default Null cfgLDAPSearchFilter (Read/Write) Table 280. Details of cfgLDAPSearchFilter Description A valid LDAP search filter. This is used if the user attribute 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 (objectclass=*) Searches for all objects in tree. cfgLDAPCertValidationEnable (Read/Write) Table 281.
Legal Values String of maximum length of 254 alphanumeric characters and hyphens. The string must begin with a letter. Default [null] cfgLDAPSRVLookupEnable Table 285. Details of cfgLDAPSRVLookupEnable Description Configures the CMC to query a DNS server for SRV records. Legal Values • • Default 0 1 (true) 0 (false) cfgLDAPSRVLookupServiceName (Read/Write) Table 286. Details of cfgLDAPSRVLookupServiceName Description Configures the service name to be used in the SRV lookup.
Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupDN -i 1 cn=everyone,ou=groups,dc=openldap,dc=com cfgLDAPRoleGroupPrivilege (Read/Write) Table 288. Details of cfgLDAPRoleGroupPrivilege Description A bit–mask defining the privileges associated with this particular group. Legal Values 0x00000000 to 0x000001ff Default 0x000 Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupPrivilege -i 1 0x0 cfgLocation This group defines objects that support physical location properties.
cfgLocationRackslot (Read/Write) Table 292. Details of cfgLocationRackslot Description Indicates the slot where a server is located. Legal Values Values from 1 - 255 (1 Byte) Default 0 cfgLocationDevicesize (Read Only) Table 293. Details of cfgLocationDevicesize Description Indicates server chassis size. Legal Values Values from 1 - 255 Default 0 cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings.
cfgSSADRoleGroupDomain (Read/Write) Table 296. Details of cfgSSADRoleGroupDomain Description Active Directory Domain in which the Role Group resides. Legal Values Any printable text string of up to 254 characters, with no white space. Default cfgSSADRoleGroupPrivilege (Read/Write) Table 297. Details of cfgSSADRoleGroupPrivilege Description Use the bit mask numbers listed in the table below to set role-based authority privileges for a Role Group.
cfgChassisPower This group is applicable only to CMC and contains parameters to display or configure power for the chassis. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. The following sections provide information about the objects in the cfgChassisPower group.
Default None cfgChassisMinPowerTimestamp (Read Only) Table 303. Details of cfgChassisMinPowerTimestamp Description The timestamp recorded when the minimum system power occurred. Legal Values None Default None cfgChassisPowerStatus (Read Only) Table 304. Details of cfgChassisPowerStatus Description Indicates the power status of the chassis.
cfgChassisDefaultPowerCapUpperBoundBTU (Read Only) Table 307. Details of cfgChassisDefaultPowerCapUpperBoundBTU Description Indicates the maximum default value to which you can set the power cap of a chassis. Legal Values 17060 BTU/h Default 17060 BTU/h cfgChassisDefaultPowerCapLowerBound (Read Only) Table 308. Details of cfgChassisDefaultPowerCapLowerBound Description Indicates the minimum default value to which you can set the power cap of a chassis.
Legal Values 2715 – 16685 Watt Default 16685 Watt cfgChassisPowerCapFBTU (Read/Write) Table 312. Details of cfgChassisPowerCapFBTU Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. Use cfgChassisCapFBTU when power consumption is to be changed 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.
cfgChassisRedundancyPolicy (Read/Write) Table 315. Details of cfgChassisRedundancyPolicy Description Sets the redundancy policy of the chassis. Legal Values • • • Default 0 (no redundancy) 0 (no redundancy) 1 (AC redundancy) 2 (power supply redundancy) cfgChassisDynamicPSUEngagementEnable (Read/Write) Table 316. Details of cfgChassisDynamicPSUEngagementEnable Description Enables or disables dynamic engagement.
cfgChassisInfrastructureInPowerAllocation (Read Only) Table 320. Details of cfgChassisInfrastructureInPowerAllocation 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 cfgChassisTotalInPowerAvailable (Read Only) Table 321.
cfgChassisPowerButtonEnable (Read/Write) Table 325. Details of cfgChassisPowerButtonEnable Description Indicates if the chassis power button is enabled or disabled. Legal Values • • Default None 0 (disabled) 1 (enabled) cfgSystemEnergyConsumptionClear (Write Only) Table 326. Details of cfgSystemEnergyConsumptionClear Description Resets energy statistics when set to 1.
cfgChassisServerBasedPowerMgmtMode Table 327. Details of cfgChassisServerBasedPowerMgmtMode Description Indicates the server-based power management mode of a chassis. Legal Values • • Default 0 (disabled) 0 (disabled) 1 (enabled) cfgChassisPowerCapBTU (Read/Write) Table 328. Details of cfgChassisPowerCapBTU Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis.
cfgKvmSlotEnable (Read/Write) Table 331. Details of cfgKvmSlotEnable Description Enable the slots (1 to 4) to access using KVM: • • • • cfgKvmSlot1Enable cfgKvmSlot2Enable cfgKvmSlot3Enable cfgKvmSlot4Enable 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.
cfgAlerting This group is enables or disables SNMP event trap alerting and sets the event filter. Use this object with the config or getconfig subcommands. cfgAlertingEnable Table 334. Details of cfgAlertingEnable Description Enables or disables event traps on the CMC. Legal Values • • Default None 1 (true) 0 (false) To use this object property, you must have the Chassis Configuration Administrator privilege. cfgAlertingSourceEmailName Table 335.
Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgIPv6AutoConfig (Read/Write) Table 337. Details of cfgIPv6AutoConfig Description Enables or disables the IPv6 Auto Configuration option. NOTE: If this value is set to 0, the CMC disables auto configuration and statically assigns IPv6 addresses. If this value is set to 1, the CMC obtains address and route information using stateless auto configuration and DHCPv6.
NOTE: This property is used only if cfgIPv6AutoConfig is set to 0 (false.) Legal Values Specifies string representing a valid IPv6 entry. Default :: cfgIPv6DNSServersFromDHCP6 (Read/Write) Table 341. Details of cfgIPv6DNSServersFromDHCP6 Description Specifies whether cfgIPv6DNSServer1 and cfgIPv6DNSServer2 are static or DHCP IPv6 addresses. NOTE: This property is used only if cfgIPv6AutoConfig is set to 1 (true). Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgIPv6DNSServer1 (Read/Write) Table 342.
Example $ racadm getconfig -g cfgIPv6LanNetworking cfgIPv6Enable=1 cfgIPv6AutoConfig=1 cfgIPv6Address=:: cfgIPv6PrefixLength=64 cfgIPv6Gateway=:: cfgIPv6DNSServersFromDHCP6=1 cfgIPv6DNSServer1=:: cfgIPv6DNSServer2=:: If both IPv4 and IPv6 are enabled on the CMC, IPv6 DNS servers take priority. The order of preference for DNS servers is: • • • • cfgIPv6DNSServer1 cfgIPv6DNSServer2 cfgDNSServer1 cfgDNSServer2 cfgCurrentLanNetworking (Read Only) This group displays the current CMC NIC properties.
# # # # # cfgNicCurrentVlanID=1 cfgNicCurrentVlanPriority=0 cfgDNSCurrentServer1=192.168.0.5 cfgDNSCurrentServer2=192.168.0.6 cfgDNSCurrentDomainName=MYDOMAIN cfgNicCurrentIpAddress Table 345. Details of cfgNicCurrentIpAddress Description Displays the static IP address to the CMC. Legal Values None Default None cfgNicCurrentNetmask Table 346. Details of cfgNicCurrentNetmask Description Displays the static subnet mask for the CMC IP address.
1- VLAN is enabled Default None cfgNicCurrentVlanID (Read Only) Table 350. Details of cfgNicCurrentVlanID Description Indicates the Current Virtual Lan ID Legal Values Integer Default None cfgNicCurrentVlanPriority (Read Only) Table 351. Details of cfgNicCurrentVlanPriority (Read Only) Description Indicates the Current Virtual Lan Priority. Legal Values Integer Default None cfgDNSCurrentServer1 Table 352. Details of cfgDNSCurrentServer1 Description Displays the IP address for DNS server 1.
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 Table 355. Details of cfgCurrentIPv6Enabled Description Indicates whether IPv6 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 IPv6.
cfgCurrentIPv6Gateway Table 359. Details of cfgCurrentIPv6Gateway Description Displays the current IPv6 gateway. Legal Values None Default None cfgCurrentIPv6DNSServersFromDHCP6 Table 360. Details of cfgCurrentIPv6DNSServersFromDHCP6 Description Indicates whether the DNS server addresses are assigned from the DHCPv6 server. Legal Values None Default None cfgCurrentIPv6DNSServer1 Table 361. Details of cfgCurrentIPv6DNSServer1 Description Displays the IPv6 address for DNS server 1.
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. Inappropriate modification of the properties in this group can result in your RAC NIC become inoperable. cfgNetTuningNicSpeed Table 363.
Legal Values • • Default 1 0 = Auto Negotiation is Disabled 1 = Auto Negotiation is Enabled 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) Table 370. Details of cfgRacSecCsrLocalityName Description Specifies the CSR Locality (L). Legal Values A string of up to 128 characters. Default cfgRacSecCsrStateName (Read/Write) Table 371. Details of cfgRacSecCsrStateName Description Specifies the CSR State Name (S). Legal Values A string of up to 128 characters. Default cfgRacSecCsrCountryCode (Read/Write) Table 372.
cfgRacSecCsrKeySize (Read/Write) Table 374. Details of cfgRacSecCsrKeySize Description Specifies the SSL asymmetric key size for the CSRs. Legal Values 1024, 2048, and 4096 Default 2048 cfgQuickDeploy This group is used to configure IDRAC deployment settings. You must have blade administrator privileges for configuring the settings. cfgActionOnServerInsertion Table 375. Details of cfgActionOnServerInsertion attribute Description Configures settings when a new server is inserted into the slot.
cfgEnableiDRACLAN Table 378. Details of cfgEnableiDRACLAN attribute Description Enables the LAN channel for iDRAC when servers are inserted into the chassis. Legal Values • • Default 1 0 — Disable 1 — Enable cfgEnableiDRACIPv4 Table 379. Details of cfgEnableiDRACIPv4 attribute Description Enables IPv4 for each iDRAC in the chassis. Any iDRAC that is not IPv6 is always IPv4 enabled. Legal Values • • Default 1 0 — Disable 1 — Enable cfgEnableiDRACIPMIOverLAN Table 380.
cfgiDRACIPv4GateWay Table 383. 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 384. 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 385.
cfgiDRACIPv6Gateway Table 388. 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 389. Details of cfgReservedIPAddressNumbers attribute Description The number of static IPv4 addresses reserved for iDRACs in the chassis. Legal Values 32 Default 32 cfgUseCMCDNSSettings Table 390.
NOTE: The maximum length of the cfgServerDNSIMCNamePrefix is 59 characters. The hyphen (–) is the only special character allowed for setting the prefix.