CLI Guide

ManualsBrandsDell ManualsActive System ManagerChassis Management Controller Version 3.0 for Dell PowerEdge VRTX

Table Of Contents

Dell Chassis Management Controller Version

3.0 for PowerEdge VRTX

RACADM CLI Guide

September 2017

Rev. A00

Summary of content (178 pages)

PAGE 1
Dell Chassis Management Controller Version 3.0 for PowerEdge VRTX RACADM CLI Guide September 2017 Rev.
PAGE 2
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Copyright © 2017 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
PAGE 3
Contents Chapter 1: Introduction................................................................................................................ 12 What’s new in this release............................................................................................................................................... 12 Supported RACADM Interfaces......................................................................................................................................12 RACADM Syntax Usage........
PAGE 4
getpciecfg........................................................................................................................................................................... 53 getpminfo............................................................................................................................................................................ 55 getraclog.....................................................................................................................................
PAGE 5
deletesecuritykey........................................................................................................................................................ 95 encryptvd...................................................................................................................................................................... 95 cryptographicerase..............................................................................................................................................
PAGE 6
cfgNicGateway (Read/Write)................................................................................................................................ 122 cfgNicMacAddress (Read Only).............................................................................................................................122 cfgRemoteHosts..............................................................................................................................................................
PAGE 7
cfgTrapsEnable...........................................................................................................................................................134 cfgTrapsAlertDestIpAddr......................................................................................................................................... 135 cfgTrapsCommunityName.......................................................................................................................................
PAGE 8
cfgADRootDomain (Read/Write)...........................................................................................................................146 cfgADEnable (Read/Write)..................................................................................................................................... 146 cfgADAuthTimeout (Read/Write)......................................................................................................................... 146 cfgADSCLEnable..........................
PAGE 9
cfgChassisInPower (Read Only)............................................................................................................................ 156 cfgChassisPeakPower (Read Only).......................................................................................................................157 cfgChassisPeakPowerTimestamp (Read Only).................................................................................................. 157 cfgChassisMinPower (Read Only)...........................
PAGE 10
cfgCurrentLanNetworking (Read Only)..................................................................................................................... 167 cfgNicCurrentIPv4Enabled......................................................................................................................................168 cfgNicCurrentIpAddress...........................................................................................................................................168 cfgNicCurrentNetmask........
PAGE 11
cfgReservedIPAddressNumbers.............................................................................................................................178 cfgUseCMCDNSSettings.........................................................................................................................................
PAGE 12
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.
PAGE 13
Example racadm getconfig -g idracinfo racadm getsysinfo 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.
PAGE 14
Supported RACADM Subcommands The following table provides the list of RACADM subcommands and their corresponding interface support. For more information about the RACADM sub-commands including syntax and valid entries, see RACADM Subcommand Details. Table 3.
PAGE 15
Table 3.
PAGE 16
Table 3. Racadm subcommands (continued) Subcommand CMC testtrap Yes Yes traceroute Yes Yes traceroute6 Yes Yes Other documents you may need To access the documents from the Dell Support site. Along with this Reference Guide, you can access the following guides available at dell.com/support/manuals. ● The VRTX CMC Online Help provides information about using the Web interface. To access the Online Help, click Help on the CMC web interface.
PAGE 17
Accessing support content from the Dell EMC support site Access supporting content related to an array of systems management tools using direct links, going to the Dell EMC support site, or using a search engine. ● Direct links: ○ For Dell EMC Enterprise Systems Management and Dell EMC Remote Enterprise Systems Management—https:// www.dell.com/esmmanuals ○ For Dell EMC Virtualization Solutions—https://www.dell.com/SoftwareManuals ○ For Dell EMC OpenManage—https://www.dell.
PAGE 18
2 RACADM Subcommand Details This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
PAGE 19
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 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
PAGE 20
● ● ● ● > (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
PAGE 21
to standby and vice versa config -- modify CMC configuration properties ...
PAGE 22
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.
PAGE 23
Table 6.
PAGE 24
Table 6.
PAGE 25
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.
PAGE 26
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.
PAGE 27
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.
PAGE 28
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.
PAGE 29
● 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.
PAGE 30
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.
PAGE 31
● 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.
PAGE 32
● 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.
PAGE 33
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 card slot. Any existing ExtendedStorage data will be lost.
PAGE 34
● 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.
PAGE 35
○ 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.
PAGE 36
NOTE: ● If CMC is not in the network, you can only export the chassis configuration profile to the local management station.
PAGE 37
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.
PAGE 38
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.
PAGE 39
● 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.
PAGE 40
The following example is for a system with multi-slot servers.
PAGE 41
● 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.
PAGE 42
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.
PAGE 43
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.
PAGE 44
● 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.
PAGE 45
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.
PAGE 46
CMC Present N/A 00:1E:4F:1F:3C: 58 N/A Server-1 Present 00:1E:4F:2A:AF: 7B 00:1E:4F:2A:D3: 97 00:1E:4F:2A:D3: 99 Server-2 Present 00:22:19:D2:1E: 84 N/A N/A Server-3 Not Present N/A N/A N/A Server-4 Present 00:18:8B:FF:45: 2A 00:18:8B:FF:AA: 02 00:18:8B:FF:AA: 04 Switch-1 Present N/A 00:00:00:00:00: 00 N/A Displays the Ethernet and iSCSI MAC/WWN addresses for all iDRAC/LOMs/mezzanine cards.
PAGE 47
iSCSI 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 Installed Server-4-C
PAGE 48
Gigabit Ethernet Present Gigabit Ethernet Present 00:0A:00:0A:0 0:02 00:0A:00:0A:0 0:03 Unknown IO-Identity Unknown IO-Identity Displays the MAC/WWN addresses for all LOMs or mezzanine cards.
PAGE 49
Displays the console assigned MAC/WWN of all LOMs or mezzanine cards.
PAGE 50
Table 16. getmodinfo (continued) ○ ○ ○ ○ ○ ○ ○ ○ blower-n, where n = 1 to 4 ps-n, where n = 1 to 4 chassis 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.
PAGE 51
Table 16. getmodinfo (continued) Server-2 N/A Server-3 OK Server-4 N/A DVD OK IO-Cable OK FPC-Cable OK Not Present N/A Present DJ22H82 Not Present N/A Present N/A Present 3BPV622 Present 3BPV622 N/A N/A OFF DJ22H82 N/A N/A ON N/A ON N/A ON N/A getniccfg Table 17. getniccfg Description Displays the current NIC settings.
PAGE 52
Table 17. getniccfg (continued) VLAN Enable VLAN ID VLAN priority = 0 = 1 = 0 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.
PAGE 53
Max Power Conservation Mode Server Performance Over Power Redundancy = No = No [Chassis Power Supply Status Table] Rated Power> PS1 Present Online PS2 Present Online PS3 Not Present Slot Empty PS4 Not Present Slot Empty [Server 1 2 3 4
PAGE 54
PCIe slot-4 Not Present N/A N/A N/A N/A PCIe slot-5 Shared PERC 8 External ON Shared N/A N/A 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 F
PAGE 55
● Displays the properties of a PCIe slot selected using FQDD: racadm getpciecfg -c pcie.chassisslot.1 ● Displays the properties of a Virtual Adapter selected using FQDD: racadm getpciecfg -c RAID.ChassisIntegrated.2-1-4 ● 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.
PAGE 56
= 7928 W (7928 BTU/hr | 10%) Surplus for Peak Performance 7000 W (6130 BTU/hr) Redundancy Policy None Dynamic PSU Engagement Enabled No = = = [Power Budgeting] System Input Max Power Capacity = 0 W Input Redundancy Reserve = 0 W Input Power Allocated to Servers = 0 W Input Power Allocated to Chassis Infrastructure = 51W Total Input Power Available for Allocation = 0 W Standby Input Power Capacity = 0 W getraclog Description The getraclog command displays RAC log entries.
PAGE 57
Synopsis ● racadm getractime [-d] ● racadm getractime [-d][-z] ● racadm getractime [-n] Input ● -d — Displays the time in the format, yyyymmddhhmmss.mmmmmms. ● -z — Displays timezone. This option is specific to CMC only. ● -n — Displays NTP peer information. This option is specific to CMC only. NOTE: If no options are provided, the getractime subcommand displays the time in a common readable format. Output The current iDRAC time is displayed.
PAGE 58
Output Record: 12 Date/Time: 11/20/2011 14:19:34 Source: system Severity: Ok Description: C: boot completed. Example racadm getsel getsensorinfo Description Displays status of chassis sensors. NOTE: To use this subcommand, you must have CMC Login User privilege.
PAGE 59
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 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 Senso
PAGE 60
4 Blower-4 OK 1702 rpm 1108 923 N/A N/A 20 Sensor Type: Temp e> 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 Sensor Type: Power 1 PS-1 Slot Empty N/A 2 PS-2 Online OK 3 PS-3 Slot Empty N/A PS-4 Slot Empty N/A Sensor Type: Cable
PAGE 61
Displays the slot name for all the four slots in the chassis. ● -i - specifies the slot number. 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.
PAGE 62
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.
PAGE 63
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.
PAGE 64
● -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.
PAGE 65
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.
PAGE 66
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.
PAGE 67
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.
PAGE 68
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.
PAGE 69
Synopsis racadm license .
PAGE 70
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.
PAGE 71
○ 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.
PAGE 72
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.
PAGE 73
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.
PAGE 74
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.
PAGE 75
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.
PAGE 76
raid Description Allows you to execute commands to control RAID arrays. Synopsis 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.
PAGE 77
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.
PAGE 78
This command displays all fan objects for the enclosure FQDD. racadm raid get fans --refkey -o -p optimized and filtered version. ● 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.
PAGE 79
Synopsis Input racadm raid blink: racadm raid blink: racadm raid blink {-pdkey:
PAGE 80
Table 19. createvd (continued) ● –size: : The size of the VD. ○ b: Specify the size in bytes. ○ k: Specify the size in kilobytes ○ m: Specify the size in megabytes. ○ g: Specify the size in gigabytes. ○ t: Specify the size in terabytes. ● -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”.
PAGE 81
exportlog Description Export a log from the device. 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.
PAGE 82
PatrolReadRate = 30 % PatrolReadMode = Manual PatrolReadState = Stopped CheckConsistencyMode = Stop On Error LoadBalanceSetting = Disabled CopybackMode = OFF 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
PAGE 83
LearnMode HighAvailabilityMode PeerController = Not supported = Fault Tolerant(Active/Passive) = RAID.ChassisIntegrated.2-1 RAID.ChassisIntegrated.
PAGE 84
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.
PAGE 85
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.
PAGE 86
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.
PAGE 87
Synopsis Input Example 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. 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.
PAGE 88
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.
PAGE 89
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.
PAGE 90
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. 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.
PAGE 91
sIntegrated.1-1 racadm raid unblink:Enclosure.External.0-0:RAID.ChassisSlot.5-1 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.
PAGE 92
○ deletevd ○ blink ○ 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.
PAGE 93
● [-dcp {enabled|disabled|default}] [-name ] [-size {b|k|m|g|t}] [-cc] ● racadm raid discardcache:RAID.ChassisIntegrated.1-1 ● 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.
PAGE 94
Input ● –current : Performs the configuration right now. NOTE: If this requires the system to reboot, then the system will reboot. ● –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. Example ● racadm raid resetconfig:RAID.ChassisIntegrated.1-1 enableperc Description Indicates the RAID configuration of hardware RAID connected to the server.
PAGE 95
● number ● non-alphanumeric character except space Example racadm raid createsecuritykey:RAID.ChassisIntegrated.1-1 -key Key@123_ passwd Pass@123_ modifysecuritykey Description Synopsis Modifies the security key and password of the controller.
PAGE 96
Example racadm raid cryptographicerase:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrate d.1-1 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.
PAGE 97
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. Synopsis Input racadm serveraction ● -m 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.
PAGE 98
● Get Power Status on iDRAC racadm serveraction powerstatus 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.
PAGE 99
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.
PAGE 100
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.
PAGE 101
● 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 Input racadm setled -m -l ● -m - Specifies the module whose LED you want to configure.
PAGE 102
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.
PAGE 103
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.
PAGE 104
— 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.
PAGE 105
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.
PAGE 106
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.
PAGE 107
● 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.
PAGE 108
—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.
PAGE 109
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.
PAGE 110
-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.
PAGE 111
testemail Description Synopsis Input Output 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.
PAGE 112
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.
PAGE 113
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.
PAGE 114
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.
PAGE 115
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.
PAGE 116
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.
PAGE 117
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.
PAGE 118
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.
PAGE 119
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.
PAGE 120
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.
PAGE 121
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.
PAGE 122
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.
PAGE 123
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.
PAGE 124
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.
PAGE 125
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).
PAGE 126
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.
PAGE 127
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.
PAGE 128
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.
PAGE 129
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.
PAGE 130
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.
PAGE 131
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.
PAGE 132
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.
PAGE 133
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.
PAGE 134
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.
PAGE 135
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.
PAGE 136
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.
PAGE 137
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.
PAGE 138
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.
PAGE 139
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.
PAGE 140
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.
PAGE 141
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.
PAGE 142
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.
PAGE 143
● 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.
PAGE 144
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.
PAGE 145
# 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.
PAGE 146
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.
PAGE 147
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 .
PAGE 148
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.
PAGE 149
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.
PAGE 150
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.
PAGE 151
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.
PAGE 152
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 perform the certificate validation task of SSL handshake.
PAGE 153
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.
PAGE 154
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.
PAGE 155
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.
PAGE 156
Example racadm getconfig -g cfgStandardSchema -i 1 NOTE: -i is for the index.
PAGE 157
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.
PAGE 158
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.
PAGE 159
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.
PAGE 160
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.
PAGE 161
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.
PAGE 162
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.
PAGE 163
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.
PAGE 164
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.
PAGE 165
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.
PAGE 166
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.
PAGE 167
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).
PAGE 168
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.
PAGE 169
Default cfgNicCurrentDhcpWasUsed Description Indicates whether DHCP is used to configure the NIC. Legal Values 0 – address is static. 1– address was obtained from the DHCP server. Default None cfgNicCurrentVlanEnable (Read Only) Description Indicates whether the VLAN is enabled.
PAGE 170
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.
PAGE 171
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.
PAGE 172
# 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.
PAGE 173
● 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.
PAGE 174
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.
PAGE 175
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.
PAGE 176
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.
PAGE 177
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.
PAGE 178
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.