Dell Chassis Management Controller Version 3.3 for PowerEdge VRTX RACADM CLI Guide July 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2008 - 2019 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction.................................................................................................................. 12 What’s new in this release.................................................................................................................................................. 12 Supported RACADM Interfaces.........................................................................................................................................
getpbinfo.............................................................................................................................................................................. 54 getpciecfg............................................................................................................................................................................ 54 getpminfo..................................................................................................................................
modifysecuritykey..........................................................................................................................................................97 deletesecuritykey........................................................................................................................................................... 97 encryptvd.........................................................................................................................................................
cfgDNSServer2 (Read/Write)................................................................................................................................... 126 cfgNicEnable (Read or Write).................................................................................................................................... 126 cfgNicIpAddress (Read or Write)..............................................................................................................................
cfgOobSnmpProtocol..................................................................................................................................................140 cfgOobSnmpTrapFormat............................................................................................................................................140 cfgTraps............................................................................................................................................................................
cfgServerBootOnce (Read/Write)............................................................................................................................152 cfgServerPowerConsumption (Read Only)..............................................................................................................152 cfgActiveDirectory.............................................................................................................................................................
cfgStandardSchema..........................................................................................................................................................164 cfgSSADRoleGroupIndex (Read Only)......................................................................................................................165 cfgSSADRoleGroupName (Read/Write)..................................................................................................................
cfgIPv6Address............................................................................................................................................................ 177 cfgIPv6PrefixLength (Read/Write)........................................................................................................................... 177 cfgIPv6Gateway (Read/Write)..................................................................................................................................
cfgiDRACIPv4GateWay...............................................................................................................................................189 cfgiDRACIPv4Netmask............................................................................................................................................... 189 cfgEnableiDRACIPv6...................................................................................................................................................
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, sslcertdownload, to download SSL certificates from CMC.
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 remote IP address of the controller.
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.
Table 3.
Table 3. Racadm subcommands (continued) Subcommand CMC testfeature Yes Yes testtrap Yes Yes traceroute Yes Yes traceroute6 Yes Yes Other documents you may need To access the documents from the Dell Support site. 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.
○ For Dell EMC Enterprise Systems Management, Dell EMC Remote Enterprise Systems Management, and Dell EMC Virtualization Solutions documents — https://www.dell.com/esmmanuals ○ For Dell EMC OpenManage documents — https://www.dell.com/openmanagemanuals ○ For iDRAC documents — https://www.dell.com/idracmanuals ○ For Dell EMC OpenManage Connections Enterprise Systems Management documents — https://www.dell.
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 sslcertdownload sslcertupload sslcertview sslcsrgen sslresetcfg sslsshresetcfg set tempprobes testcifsshare testemail testfeature
• • • • • • • ( (left parentheses) ) (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.
KVM powercycle clrraclog -- clear the CMC log clrsel -- clear the System Event Log (SEL) cmcchangeover -- Changes the redundant state of the CMC from active to standby and vice versa config -- modify CMC configuration properties ...
Table 6. chassislog (continued) Synopsis Input racadm chassislog view [-i] racadm chassislog view [-c [-s ] [-b ] [-q ] [-n ] [-r ] [-e ] • • • • • • • • • • -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.
Table 6.
Table 6. chassislog (continued) ○ SEC : Security Event NOTE: To view or export the Chassis log, only the CMC Login User privilege is required.
Table 7. chassislog export (continued) • –u : Username for the remote share to where the file must be exported. Username in a domain can be given as domain/username –p : Password for the remote share to where the file must be exported. –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.
Table 9. Chassisaction (continued) ○ switch-n, where n=1 • — Action that you want to run on the specified module. Values are: ○ ○ ○ ○ 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.
clrsel Table 11. Clrsel Description Deletes all existing records from the System Event Log (SEL). To use this subcommand, you must have the Clear Logs privilege. Synopsis racadm clrsel cmcchangeover Table 12. Cmcchangeover Description Changes the state of the CMC from active to standby, or vice versa, in a redundant CMC configuration. This subcommand is useful for remote debugging or testing purposes. To use this subcommand, you must have the Administrator privilege.
Table 13. Config (continued) • • • • • NOTE: When the –f option is specified and configuration of an attribute fails, then configuration of other attributes in that group is skipped. -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.
Table 14. Details of connect (continued) Example • Connect to I/O Module 1 serial console racadm connect -m switch-1 • Connect to server 1 serial console racadm connect -m server-1 deploy Table 15. 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.
Table 15. deploy (continued) • • • • • • ○ gateway—A string representing a valid gateway address. For example, 192.168.0.1. -d—Enables DHCP for the specified server. The -s and -d options cannot be used together in the same command. -6—Enables IPv6 auto configuration (when used with -d.) Sets static IPv6 addresses (when used with -s). -q—Displays or modifies the quick deploy parameters. -n — Specifies the number of reserved IP addresses for quick deploy. The valid values are 2 and 4.
Table 16. Details of eventfilters (continued) Valid category values are: • • • • • System Config Updates Storage Audit Valid severity values are: • • • Critical Warning Informational Valid examples of alert descriptors are: Input • cmc.alert.all • cmc.alert.audit • cmc.alert.audit.lic • cmc.alert.audit.warning • cmc.alert.audit.lic.critical • • • • get - Displays the list of event filter settings. set - Configures the actions and notifications for a given event filter configuration.
Table 16. Details of eventfilters (continued) • Configure using severity as a parameter. For example, all informational events in storage category are assigned poweroff as action, and email and snmp as notifications: racadm eventfilters set -c cmc.alert.storage.info -n email,snmp • Configure using subcategory as a parameter.
Table 18. Details of fcp attribute (continued) Synopsis racadm fcp Input • • enable: Enables the force password change feature getstatus: Displays the status of force change password feature NOTE: You must have the RAC_ADMIN privileges to run the fcp enable command. Legal Values For the fcp get status, the values are: Example • • 0 : FCP Feature has been disabled on CMC. 1 : FCP Feature has been enabled on CMC.
featurecard Table 20. Details of featurecard Description Verifies proper SD card installation and displays the SD card status. To use this subcommand, you must have the Chassis Configuration Administrator privilege. Synopsis racadm featurecard -s Input -s — Lists active SD card features and SD card status. Output An example of output is given here.
Table 21. Details of fwupdate (continued) Upload firmware image from TFTP server and start firmware update. NOTE: Run the firmware update command through only one remote racadm session at a time. Synopsis • Using Remote RACADM: racadm -r fwupdate -p -u -d NOTE: iDRAC7 targets are not supported from CMC. Use the CMC GUI to update iDRAC7 targets from CMC. When using FTP, if you provide the full path to the image file on the CLI, then the CMC uses that path to locate that file on the host.
Table 21. Details of fwupdate (continued) Output Displays a message indicating the operation that is being performed. Example NOTE: The following commands specifically apply to an active-CMC update. • Upload a firmware image from the client and start firmware update: racadm fwupdate -p -u -d vrtx_cmc.bin • Upload the firmware image from the TFTP server and start the firmware update: racadm fwupdate -g -u -a 192.168.0.100 -d vrtx_cmc.bin -m cmc-active TFTP firmwareate has been initiated.
Table 22.
Table 22. Details of get (continued) Example • Export event filter configurations to a file by using remote racadm racadm -r 192.168.0.120 -u abc -p get -f file.txt • Export the CMC XML configuration to a local share using remote racadm racadm -r 192.168.0.120 -u abc -p get -f file.xml -t xml • Export the CMC XML configuration to a CIFS share racadm get -f file.xml -t xml -u myuser -p mypass -l //192.168.0.
Table 23. Details of getactiveerrors (continued) 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 Table 24. Details of getassettag Description Displays the asset tag for the chassis. To use this subcommand, you must have the CMC Login User privilege.
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.
Table 26. Details of getconfig (continued) • 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. • racadm getconfig -u root Displays the user group instance at index 2 with verbose information for the property values. • racadm getconfig -g cfgUserAdmin -i 2 -v Table 27.
Table 29. Example server-1 Present PCIe OK PCIe OK server-2 Not Present None N/A None N/A server-3 Present PCIe OK None N/A server-4 Not Present None N/A None N/A Table 30. getdcinfo server-1 Present None None server-2 Not Present None None server-3 Not Present None None server-4 Present None Broadcom M5708t getflexaddr Table 31.
Table 31. Details of getflexaddr (continued) Synopsis racadm getflexaddr [-i ] Input -i — Specifies the slot information to be displayed. must be from 1 to 4. Table 32. Example 1 Enabled Present 2 Enabled Present 3 Enabled Not Present 4 Enabled Not Present A Gigabit Ethernet Enabled B None Enabled C None Enabled Table 32. Example Table 33.
Table 33. FlexAddress setting (continued) 10 GbE KR/3 00:90:FA:51:36:56 F8:DB:88:3D:A2:78(act ive) NOTE: 10 GbE KR/3— The value 3 indicates the protocol type. getioinfo Table 34. getioinfo Description Displays general information about the I/O modules on the chassis. To use this subcommand, you must have the CMC Login User privilege. NOTE: The fabric type may be any supported I/O fabric type, such as Ethernet, Fiber Channel, and Infiniband.
Table 36. Details of getled (continued) • • Example chassis cmc-active For CMC: • racadm getled -m server-10 • server-10 Blinking racadm getled -m chassis • server-10 Not blinking racadm getled -m server-1 • server-1 ON racadm getled -m server-9 server-9 Extension(1) getmacaddress Table 37.
Table 37. Details of getmacaddress (continued) • • -a—Displays the Ethernet and iSCSI MAC/WWN addresses for all iDRAC/LOMs/mezzanine cards. When FlexAddress is enabled for a particular slot, then the chassis-assigned MAC/WWN address is displayed. -c —Displays the ethernet, iSCSI, MAC/WWN, assignment type, and partition status of all LOMs or mezzanine cards. Valid values for the -c option are: ○ ○ ○ ○ IO-Identity—Displays the user-defined MAC/WWN addresses.
Table 39. MAC address for switch-1 (continued) Switch-1 Present Not Installed 00:00:00:00:00:0 0 Not Installed Table 40. MAC for server-1 server-1 Present 00:11:43:FD:B7:2 A 00:11:43:FD:B7:2 A 00:11:43:FD:B7:2 B server-4 Extension(1) N/A 00:11:43:FD:B7:2 C 00:11:43:FD:B7:2 D Table 41.
Table 43.
Table 43. Ethernet and iSCSI MAC/WWN addresses (continued) iSCSI Present Not Installed Not Installed Server-4-C Fibre Channel 4 Present Not Installed Not Installed Switch-1 None Present 00:00:00:00: 00:00 N/A N/A Table 44.
Table 45. MAC/WWN addresses (continued) Switch-1 10 GbE KR Present F8:B1:56:45: DD:BD N/A Factory Table 46.
• • • getmodinfo Table 48. getmodinfo Description Displays configuration and status information for all modules or a specified module (server, switch, CMC, fan unit, blower, power supply unit, chassis, DVD, main-board, IO cable, and FPC cable) in the chassis. To use this subcommand, you must have CMC Login User privilege. NOTE: The service tag field is blank for modules that do not have service tags.
Table 48.
Table 49.
getpbinfo Table 50. Details of getpbinfo Description Displays power budget status information. To use this subcommand, you must have the CMC Login User privilege.
Table 51. Details of getpciecfg (continued) Synopsis racadm getpciecfg [-c ][a] Input • • • • -a — Use this option to display the assignment of PCIe slots and Virtual Adapters. -c — Use this option to select a specific PCIe adapter or Virtual Adapter. FQDD — FQDD of the selected PCIe slot or Virtual Adapter. -r — Use this option to view the ride-through configuration settings. Example • Table 52.
Table 51. Details of getpciecfg (continued) Table 52. Details of shared external adapter in PCIe slots (continued) • 2 5,6,9,10 SLOT-02 2 Not Present 3 5,6,9,10 Unmapped N/A N/A 4 5,6,9,10 SLOT-04 4 Not Present Displays FQDDs of all the PCIe slots and PCIe Virtual Adapters: racadm getpciecfg • PCIe slot 01 PCIe 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.
Table 53.
getraclog Table 54. Details of getraclog Description The getraclog command displays RAC log entries. Synopsis racadm getraclog [-s ] [-c ] Input NOTE: If no options are provided, the entire log is displayed. • • • Output -c — Specifies the number of records to display. -s — Specifies the starting record used for the display. --more — Displays one screen at a time and prompts the user to continue.
getredundancymode Table 56. Details of getredundancymode Description Displays the redundancy status (Redundant or Non-Redundant) of the CMC. To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getredundancymode Example racadm getredundancymode Redundant getsel Table 57. Details of getsel Description Displays all sensor event log entries in the DRAC.
getsensorinfo Table 58. Details of getsensorinfo Description Displays status of chassis sensors. NOTE: To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getsensorinfo racadm getsensorinfo -c Table 59.
Table 60. Temperature sensor (continued) Server-4 OK 20 3 -7 42 47 Table 61.
getslotname Table 66. Details of getslotname Description Displays the name, host name (if available) and iDRAC DNS name of all the four slots, or of a specified slot (indicated by the slot number) in the chassis. Optionally, use this command to find if the slot name or host name, or iDRAC DNS name is displayed in the CMC Web interface, or with the getslotname [-i | -h] command. If the host name is not available, the static slot name is used.
Table 67. Details of getssninfo (continued) NOTE: Based on the Session ID (SSNID) or the user name (User), the iDRAC administrator can close the respective sessions or all the sessions using the, closessn subcommand. For more information, see closessn. Synopsis racadm getssninfo [-A] [-u | *] Input • • -A - eliminates the printing of data headers. -u - The -u user name option limits the printed output to only the detail session records for the given user name. Table 68.
Table 70. Details of getsysinfo (continued) NOTE: The Hostname and OS Name fields in the getsysinfo output display accurate information only if Dell OpenManage Server Administrator is installed on the managed system. Else, these fields may be blank or inaccurate. An exception to this are VMware operating system names, which are displayed even if Server Administrator is not installed on the managed system.
Table 70. Details of getsysinfo (continued) Examples racadm getsysinfo -d racadm getsysinfo -c racadm getsysinfo -A racadm getsysinfo -4 racadm getsysinfo -6 gettracelog Table 71. Details of gettracelog Description Synopsis Input Lists all the trace log entries in CMC. • racadm gettracelog -i [-A] • racadm gettracelog [-s ] [-c ] [--more] [-A] [-o] • • • • • • -i - Displays the number of entries in iDRAC trace log.
Table 72. getversion (continued) Synopsis • • • Input racadm getversion racadm getversion [-b | -c] [-m ] racadm getversion -l [-m ] [-f ] NOTE: The -b, -c and -l options are not available for CMC modules. NOTE: The -l option requires that the Lifecycle Controller service is enabled on the servers. For version information, see the RACADM Readme available at dell.com/support/manuals. • (none) — Displays the version information for all targets or devices.
Table 72. getversion (continued) Disk.Bay.4:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:5 AS09 Disk.Bay.5:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:6 AS09 Disk.Bay.6:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:7 AS09 Disk.Bay.7:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:8 AS09 Disk.Bay.8:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:9 AS09 Disk.Bay.9:Enclosure.Internal.0-0:RAID.
ifconfig Table 73. Details of ifconfig Description Displays the contents of the network interface table. To use this subcommand, you must have the Execute Diagnostic Commands or Configure iDRAC privilege. Synopsis racadm ifconfig 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.
Table 74. Details of jobqueue (continued) • • • • • Example • – –all — The JobIDs that are not applied are deleted. — Specifies an FQDD for which a job has to be created. reboot type — Specifies a reboot type. Valid options are none: No Reboot Job which is the default. start time — Specifies a start time for job to be scheduled in yyyymmddhhmmss format. If you specify TIME_NOW, the job is immediately run. Expiration time — Specifies the expiry time for the job to complete in yyyymmddhhmmss format.
Table 75. Details of krbkeytabupload (continued) Input -f — Specifies the file name of the keytab to be uploaded. If the file is not specified, the keytab file in the current directory is selected. Output Returns 0 when successful, and a non–zero number, when unsuccessful. Example racadm krbkeytabupload -f c:\keytab \krbkeytab.tab license Table 76. Details of license Description Manages the CMC licenses. Synopsis racadm license .
Table 76. Details of license (continued) • replace — Replaces an older license with a given license file. Use the following options along with the commands: Examples • • • -c — Specifies the FQDD of the component or device, on which the license is present. -l — Network share location to import or export the license file. -f — File name of the license file. NOTE: During export, the license file is named _.xml. • • • • -u— User name of the remote share.
Table 76. Details of license (continued) ○ Export the license to a CIFS share specifying the entitlement ID (for example, abcdxyz): racadm license export -u admin -p passwd -f License.xml -l // 192.168.2.140/licshare -e abcdxyz ○ Export license to a CIFS share specifying the FQDD. While using the -c option and exporting licenses from a device, more than one license file must be exported. Therefore, if a file name is provided, an index is appended to the end of the file name such as LicenseFile0.
100.101.22.0 eth0 0.0.0.0 255.255.255.0 U 0 0 0 ping Table 78. Details of ping Description Verifies that the destination IP4address is reachable from iDRAC with the current routing-table contents. A destination IP4address is required. An ICMP echo packet is sent to the destination IP address based on the current routing-table contents. To use this subcommand for CMC, you must have the Administrator privilege for CMC, and for iDRAC you must have the Execute Diagnostic Commands privilege.
racdump Table 80. Details of 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.
Register DNS CMC Name DNS CMC Name Current DNS Domain = 0 = cmc-servicetag = 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.
Table 81. Details of racreset (continued) NOTE: You can specify multiple modules: -m –m . 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 Table 82. Details of racresetcfg Description Resets CMC configuration to factory default settings. NOTE: To use this, you must have the Chassis Administrator privilege.
Table 83. Details of racresetpcie (continued) • • Synopsis To use this subcommand for CMC, you must have the Chassis Administrator privilege. This command cannot run successfully, if any blade server is powered on. racadm racresetpcie raid Table 84. Details of raid Description Allows you to execute commands to control RAID arrays. Synopsis racadm raid Example • Monitor Health of Storage root node.
This command displays all vdisk keys connected to the controllers being mentioned as refkeys. racadm raid get vdisks --refkey -o This command is an optimized version and displays all vdisk objects for the controller FQDD. 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.
This command displays all fan keys connected to the enclosures referred as refkeys. racadm raid get fans --refkey -o optimized version. This command displays all fan objects for the enclosure FQDD. racadm raid get fans --refkey -o -p optimized and filtered version.
Table 85. Details of blink (continued) NOTE: The physical disks associated with the adapter blink or unblink. Synopsis Input racadm raid racadm raid racadm raid VD FQDDs} racadm raid • • Example blink: blink: blink {-pdkey:
Table 86. Details of createvd (continued) • • • • disabled: Disabled – Disallow the disk from using its cache. default: Default – Use the default cache policy. SAS Drives - Use Disabled by Default. SATA Drives - Use Enabled by Default. –name: : The name to give the VD. –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.
Table 88. Details of discardcache (continued) Input • –current : Performs the configuration right now. NOTE: If this requires the system to reboot, the system is rebooted. • –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 discardcache:RAID.ChassisIntegrated.1-1 exportlog Table 89.
Table 91. Details of get controllers (continued) NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis raid get controllers -o Input • -o — The -o is used to display the fault-tolerant status of a RAID controller. Example Sample output of a CMC in which either fault-tolerant mode is not available or is not enabled. RAID.ChassisIntegrated.1-1 Status = Ok RollupStatus = Ok Name = Shared PERC8 (Embedded) FirmwareVersion = 23.8.3-0027 DriverVersion = 06.802.11.
Table 91. Details of get controllers (continued) 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.2-1 RAID.ChassisIntegrated.
get enclosure Table 92. Details of get enclosure Description Displays the status and attributes of the enclosure. NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis Input Example racadm raid get enclosures -o -p Status racadm raid get enclosures -o • • -o — The -o is used to display the fault-tolerant status of a enclosure. -p — The network password of the share. racadm raid get enclosures -o -p Status Enclosure.Internal.0-0:RAID.ChassisIntegrated.
get emms Table 93. Details of get emms Description Displays the status and attributes of the Enclosure Management Module (EMM). NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis Input racadm raid get emms -o -p Status racadm raid get emms -o • • Example -o — The -o is used to display the fault-tolerant status of a enclosure. -p — The network password of the share. racadm raid get emms -o -p Status Expander.Slot.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.
Table 93. Details of get emms (continued) PartNumber FirmwareVersion = 0W307KA00 = 1.05 get fans Table 94. Details of get fans Description Displays the status and attributes of the fans in the storage enclosure that are connected to chassis. NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis Input Example racadm raid get fans -o -p Status racadm raid get fans -o • -o — The -o is used to display the fault-tolerant status of a enclosure.
Table 94. Details of get fans (continued) Speed = 4670 RPMS Fan.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 1 Speed = 4670 RPMS Fan.Slot.2:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 2 Speed = 4670 RPMS Fan.Slot.3:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 3 Speed = 4700 RPMS get psus Table 95.
Table 95. Details of get psus (continued) Status State Name PartNumber = = = = Ok Ready PSU 1 0GV5NHA00 get tempprobes Table 96. Details of get tempprobes Description Displays the status and attributes of the temperature sensors in the storage enclosure that are connected to chassis NOTE: To use this subcommand, you must have the CMC Login User privilege.
Table 96. Details of get tempprobes (continued) MaximumWarningThreshold = 65 C MinimumFailureThreshold = -2 C MaximumFailureThreshold = 65 C TempSensor.Embedded.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok State = Ready Name = Temp Sensor 1 ReadingDegreeCelcius = 31 C MinimumWarningThreshold = -2 C MaximumWarningThreshold = 65 C MinimumFailureThreshold = -2 C MaximumFailureThreshold = 65 C TempSensor.Embedded.2:Enclosure.External.0-0:RAID.ChassisSlot.
cancelinit Table 98. Details of cancelinit Description Stops an initialization operation on the specified virtual drive. Synopsis Input racadm raid cancelinit: {-current | -pending} • –current : Immediately performs the configuration operation. NOTE: If this requires the system to restart, the system will be restarted. • –pending: Save the configuration change for a later application.
Table 100. Details of assignva (continued) • • Example NOTE: Enable cluster services on the servers when assigning virtual disk to multiple virtual adapters. Use of this mode without Cluster Services may lead to corrupted or lost data. –accesspolicy {na | rw}: Set the access policy to No Access or Read/Write. –vdkey:: The virtual drive to change the access to. racadm raid assignva:RAID.ChassisIntegrated.1-1-1 vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.
Table 102. Details of init (continued) Example racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -speed fast racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -speed full raid Table 103. Details of raid Description Monitors, retrieves inventory, and configures the storage components connected to the chassis. NOTE: To use this subcommand, you must have the Chassis Administrator privilege.
Table 103. Details of raid (continued) Example • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 94 racadm raid get controllers racadm raid get controllers -o racadm raid get controllers -o -p name,status racadm raid get vdisks -o -p layout,status racadm raid get controllers:RAID.ChassisIntegrated.1-1 racadm raid get controllers:RAID.ChassisIntegrated.1-1 -p status racadm raid resetconfig:RAID.ChassisIntegrated.1-1 racadm raid exportlog:RAID.ChassisIntegrated.
Table 103. Details of raid (continued) • • • • • • • • • racadm raid cancelrebuild:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated. 1-1 racadm raid disableperc:RAID.ChassisIntegrated.2-1 racadm raid enableperc:RAID.ChassisIntegrated.2-1 racadm raid createsecuritykey:RAID.ChassisIntegrated.1-1 -key -passwd racadm raid modifysecuritykey:RAID.ChassisIntegrated.1-1 -key -oldpasswd -newpasswd racadm raid deletesecuritykey:RAID.
enableperc Table 106. Details of enableperc Description Indicates the RAID configuration of hardware RAID connected to the server. This subcommand enables the power to a RAID card. NOTE: • • Synopsis Using this subcommand will power cycle the chassis and set the fault-tolerant system configuration to fault-tolerant mode. If any PERC adapter settings are changed or firmware is updated, a message is displayed and the fault-tolerant status is degraded.
Table 108. Details of createsecuritykey (continued) Example 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. Synopsis racadm raid modifysecuritykey: -key -oldpasswd -newpasswd Input • • • Example racadm raid modifysecuritykey:RAID.ChassisIntegrated.
Table 112. Details of cryptographicerase (continued) Synopsis racadm raid cryptographicerase: Example racadm raid cryptographicerase:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1 -1 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”. Synopsis Input racadm raid unlock:RAID.ChassisIntegrated.
Table 114. Details of remoteimage (continued) 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. Synopsis Input racadm serveraction • -m - • • • server-n, where n=1–4 -a - Performs action on all servers.
Table 115. Details of serveraction (continued) • Turn off the server from iDRAC when Power is already off on that server.
Table 116.
Table 116. Details of set (continued) Example • Configure event filter configurations from a configuration file using remote racadm racadm -r 192.168.0.120 -u -p set -f file.txt • 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.
setassettag Table 117. Details of 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.
Table 119. Details of set controllers (continued) 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.
Table 120. Details of setflexaddr (continued) • racadm setflexaddr -f A 1 Fabric A FlexAddress state set successfully • racadm setflexaddr -f idrac 1 setled Table 121. Details of 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.
Table 122. Details of set enclosure (continued) 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. Details of setniccfg Description Sets the iDRAC IP address.
Table 124. Details of setpciecfg (continued) Synopsis racadm setpciecfg assign [-c ] [-i ] racadm setpciecfg unassign [-c ] racadm setpciecfg ridethru -e racadm setpciecfg ridethru -d racadm setpciecfg ridethru -t
Table 125. Details of setractime (continued) Input • racadm setractime -z {?|timezone|timezone-prefix*} • -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. — off is the offset in minutes NOTE: 'Off' is the offset in minutes from GMT and must be in 15-minute increments.
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.
Table 127. Details of setsysinfo (continued) Input • — Indicates a maximum of 64 non-extended ASCII chassis name or location. -c — Sets the chassis name or location. • Example 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.
Table 128. Details of sshpkauth (continued) • • • • -t Key text for the PK key. -r Specifies the controller’s remote IP address. -u Specifies the user name. -f file containing key text to upload. 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.
sslcertupload Table 130. Details of sslcertupload Description Uploads a custom SSL server or CA certificate for Directory Service from the client to iDRAC. To use this subcommand, you must have the CMC Configuration permission. Synopsis racadm sslcertupload -t [-f ] Input • -t — Specifies the type of certificate to upload, either the CA certificate for Directory Service or the server certificate. — 1 = server certificate.
Table 132. Output (continued) State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) iDRAC Default certificate Issuer Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc.
racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate Jul 8 16:21:56 2005 GMT Jul 7 16:21:56 2010 GMT sslcsrgen Table 133. 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.
Table 133. Details of sslcsrgen (continued) 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\csrtest.
set tempprobes Table 135. 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.
Table 136. Details of testemail (continued) • Set the destination e-mail address — racadm config -g cfgEmailAlert -o cfgEmailAlertAddress -i 1 user1@mycompany.com • 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.
Table 138. testfeature -f ad (continued) • • • • Verifies the SSL certificate and if the certificate signing request (key) exists. Acquires LDAP and Global Catalog Service records from DNS. Acquires user privileges from the Active Directory server. Checks the time to acquire user privileges with the allotted time to login. 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.
Table 140. testfeature -f ldap Description Tests LDAP configuration and operation, and reports success as each stage of the authentication process proceeds. After successful completion, this command prints the CMC privileges assumed by the specified . If a failure occurs, the command stops with an error message that displays the required corrective action. Use the optional -d switch to obtain additional diagnostic information, as needed.
Table 142. Details of traceroute (continued) Synopsis racadm traceroute racadm traceroute 192.168.0.1 Input racadm traceroute 192.168.0.1 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 143. 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.
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 144. Details of idRacProductInfo Description A text string that identifies the product.
cfgLanNetworking This group contains parameters to configure NIC for IPv4. 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.
The CMC can obtain its DNS domain name from either a DHCP or DHCPv6 server, if all of the following properties are set to 1 (true): • • • • • • cfgNicIPv4Enable cfgNicUseDhcp cfgIPv6Enable cfgIPv6AutoConfig 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 151.
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 154.
cfgDNSServer1 (Read or Write) Table 155. 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 156.
Table 158. Details of cfgNicIpAddress (continued) 192.168.0.120 Default cfgNicNetmask (Read or Write) Table 159. 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 160.
cfgRhostsFwUpdateTftpEnable (Read or Write) Table 162. 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 163. 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 166. 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 167. 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.
cfgRhostsNtpMaxDist Table 170. Details of cfgRhostsNtpMaxDist Description Specifies the NTP maximum distance parameter used to aid in NTP configuration. Legal Values 1–128 Default 16 cfgRhostsSyslogPort (Read or Write) Table 171. 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).
cfgRhostsSyslogServer2 (Read or Write) Table 174. Details of cfgRhostsSyslogServer2 Description Specifies the second 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 cfgRhostsSyslogServer3 (Read or Write) Table 175.
Example racadm getconfig -g cfgRemoteHosts [-m server-] cfgRhostsFwUpdateTftpEnable=1 cfgRhostsFwUpdateIpAddr=0.0.0.0 cfgRhostsFwUpdatePath= cfgRhostsSmtpServerIpAddr=localhost.
cfgUserAdminPrivilege (Read or Write) Table 179. Details of cfgUserAdminPrivilege 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.
Table 180. Bit masks for user privileges (continued) iDRAC Specific User Privilege Privilege Bit Mask Server Administrator 0x0000040 Test Alert User 0x0000080 Debug Command Administrator 0x0000100 Fabric A Administrator 0x0000200 Fabric B Administrator 0x0000400 Fabric C Administrator 0x0000800 Table 181. Examples User Privileges Privilege Bit Mask The user is not allowed to access CMC. 0x00000000 The user may only log in to CMC and view CMC and server configuration information.
cfgUserAdminEnable (Read or Write) Table 184. Details of cfgUserAdminEnable 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 • • Default 0 1 (TRUE) 0 (FALSE) 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.
Table 187. Details of cfgEmailAlertAddress (continued) Legal Values E-mail address format, with a maximum length of 64 ASCII characters. Default cfgEmailAlertEmailName Table 188. Details of 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.
cfgSsnMgtWebserverTimeout (Read/Write) Table 190. Details of cfgSsnMgtWebserverTimeout Description Defines the Web server time-out. This property sets the amount of time (in seconds) that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached. Changes to this setting do not affect the current session. You must log out and log in again to make the new settings effective.
Table 193. Details of cfgSerialConsoleIdleTimeout (continued) Legal Values • • 0 = No timeout 60 – 10800 Default 1800 cfgSerialConsoleNoAuth (Read/Write) Table 194. Details of cfgSerialConsoleNoAuth Description Enables or disables the RAC or CMC serial console login authentication. Legal Values • • Default 0 0 (enables serial login authentication) 1 (disables serial login authentication) cfgSerialConsoleCommand (Read/Write) Table 195.
Table 197. Details of cfgSerialHistorySize (continued) Legal Values 0 – 8192 Default 8192 cfgSerialSshEnable (Read/Write) Table 198. Details of cfgSerialSshEnable Description Enables or disables the secure shell (SSH) interface on CMC. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) Example racadm getconfig -g cfgSerial cfgSerialBaudRate=115200 cfgSerialConsoleEnable=1 cfgSerialConsoleQuitKey=^\ cfgSerialConsoleIdleTimeout=1800 cfgSerialConsoleNoAuth=0 cfgSerialConsoleCommand= cfgSerialConsoleColum
cfgOobSnmpAgentCommunity (Read/Write) Table 200. Details of cfgOobSnmpAgentCommunity Description Specifies the SNMP Community Name (identical to community string) used for SNMP traps. The community string acts as a password shared between different hosts over the network. This community string value must match with that of the other hosts for any kind of communication through SNMP. Legal Values A string of up to 31 characters.
Table 203. Details of cfgOobSnmpTrapFormat attribute (continued) 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. To use this object property, you must have Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output.
Table 207. Details of cfgTrapsCommunityName (continued) Legal Values A string representing the community name. Default None cfgTrapsSNMPv3UserId (Read Only) Table 208. Details of cfgTrapsSNMPv3UserId attribute Description Displays the SNMP user ID of an existing CMC user. Legal Values 1-16 Default Empty cfgTrapsSNMPv3UserName Table 209. Details of cfgTrapsSNMPv3UserName attribute Description Configure SNMPv3 user name. Legal Values Any existing CMC user name.
cfgRacTuneDefCredentialWarningEnable Use this object with the getconfig or config subcommands. Table 211. Details of cfgRacTuneDefCredentialWarningEnable Description Enables or disables the display of the default password warning message. Legal Values 0 and 1 Default 1 cfgRacTuneRemoteRacadmEnable (Read/Write) Table 212. Details of cfgRacTuneRemoteRacadmEnable Description Enables or disables the Remote RACADM interface.
cfgRacTuneIpRangeEnable (Read/Write) Table 215. Details of cfgRacTuneIpRangeEnable Description Enables or disables the IPv4 Address Range validation feature. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgRacTuneIpRangeAddr (Read/Write) Table 216. Details of cfgRacTuneIpRangeAddr Description Specifies the acceptable IPv4 address bit pattern in positions determined by the 1s in the range mask property (cfgRacTuneIpRangeMask).
Table 218. Details of cfgRacTuneIpBlkEnable (continued) • Default 0 (FALSE) 0 cfgRacTuneIpBlkFailCount (Read/Write) Table 219. Details of cfgRacTuneIpBlkFailCount Description The maximum number of login failures to occur within the window (cfgRacTuneIpBlkFailWindow) before login attempts from the IP address are rejected. Legal Values 2 – 16 Default 5 cfgRacTuneIpBlkFailWindow (Read/Write) Table 220.
cfgRacTuneTelnetPort (Read/Write) Table 223. 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. Legal Values • • Default 23 For iDRAC: 1 – 65535 For CMC: 10 – 65535 cfgRacTuneDaylightOffset (Read Only) Table 224.
Table 226. Details of cfgRacTuneWebserverEnable (continued) Default 1 cfgRacTuneFipsModeEnable Table 227. Details of cfgRacTuneFipsModeEnable attribute Description Enables or disables the FIPS mode. Legal Values 0 and 1 Default 0 Usage racadm getconfig -g cfgRacTuning -o cfgRacTuneFipsModeEnableracadm config -g cfgRacTuning -o cfgRacTuneFipsModeEnable 1 NOTE: The firmware racadm prompts you to confirm whether the FIPS mode has to be enabled, but remote racadm does not prompt you to do so.
The following sections provide information about the objects in the cfgServerInfo group. cfgServerInfoIndex (Read Only) Table 230. Details of cfgServerInfoIndex Description Displays the index name of the server. Legal Values None Default None cfgServerSlotNumber (Read Only) Table 231. Details of cfgServerSlotNumber Description Specifies the location of the specified server (1–4) in the chassis. Legal Values None Default None cfgServerServiceTag (Read Only) Table 232.
cfgServerBIOS (Read Only) Table 235. Details of cfgServerBIOS Description Displays the server's BIOS revision. Legal Values None Default None cfgServerBmcMacAddress (Read Only) Table 236. Details of cfgServerBmcMacAddress Description Displays the BMC MAC address of the specified server. Legal Values None Default None cfgServerNic1MacAddress (Read Only) Table 237. Details of cfgServerNic1MacAddress Description Displays the MAC address of the server NIC 1.
cfgServerNic4MacAddress (Read Only) Table 240. Details of cfgServerNic4MacAddress Description Displays the MAC address of the server NIC 4. Legal Values None Default None cfgServerPriority (Read/Write) Table 241. Details of cfgServerPriority 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) Table 242.
cfgServerDNSRegisterIMC (Read/Write) Table 245. 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 246. Details of cfgServerDNSIMCName Description Displays the DNS domain name for the integrated Remote Access Controller (iDRAC.) Legal Values None Default None cfgServerRootPassword (Write Only) Table 247.
Table 248. Details of cfgServerFirstBootDevice (continued) • • • • Default 36–vFDD 40–VCD-DVD 44–iSCSI 60–VFLASH partition label 0 (zero) cfgServerBootOnce (Read/Write) Table 249. Details of cfgServerBootOnce Description Enables or disables the server boot once feature. This object is read-write. Legal Values • • Default 0 1 = TRUE 0 = FALSE cfgServerPowerConsumption (Read Only) Table 250. Details of cfgServerPowerConsumption Description Displays the current power consumption for a server.
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 # cfgServerFW=1.40 (Build 12) # cfgServerBIOS=4.0.
cfgADCertValidationEnable (Read/Write) Table 252. Details of cfgADCertValidationEnable Description Enables or disables Active Directory certificate validation as a part of the Active Directory configuration process. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgADRacDomain (Read/Write) Table 253. Details of cfgADRacDomain Description Active Directory Domain in which CMC resides. Legal Values Any printable text string of up to 254 characters, with no white space.
Table 256. Details of cfgADAuthTimeout (continued) NOTE: To modify this property, you must have the Configure CMC privilege. Legal Values 15–300 seconds Default 120 cfgADSCLEnable Table 257. Details of cfgADSCLEnable Description Enables you to log on to the CMC without enabling the Smart Card login. Legal Values • • Default 0 1 (Enable) 0 (Disable) cfgADSSOEnable (Read/Write) Table 258.
Table 260. Details of cfgADDomainController2 (continued) Default None cfgADDomainController3 (Read/Write) Table 261. 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 cfgADGlobalCatalog1 (Read/Write) Table 262.
cfgADType (Read/Write) Table 265. 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 266. Details of cfgADDcSRVLookupbyUserdomain Description Chooses the way the user domain is looked up for Active Directory.
cfgADGcRootDomain (Read/Write) Table 269. 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 270. Details of cfgADGcSRVLookupEnable Description Determines how the global catalog server is looked up.
Table 272. Details of cfgLDAPEnable (continued) 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 273. 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.
cfgLDAPUserAttribute (Read/Write) Table 276. Details of cfgLDAPUserAttribute Description Specifies the user attribute to search for. It is recommended to be unique within the chosen baseDN, otherwise a search filter must be configured to make sure the uniqueness of the login user. If the userDN cannot be uniquely identified, login fails with error. Legal Values String. Maximum length = 254 Default Null uid if not configured. cfgLDAPGroupAttribute (Read/Write) Table 277.
cfgLDAPBindpassword (Write Only) Table 280. Details of cfgLDAPBindpassword Description A bind password to use in conjunction with the bindDN. The bind password is sensitive data, and should be protected. This is optional but is required if anonymous bind is not supported. Legal Values String. Maximum length = 254 Default Null cfgLDAPSearchFilter (Read/Write) Table 281. Details of cfgLDAPSearchFilter Description A valid LDAP search filter.
Table 284. Details of cfgLDAPSearchTimeout (continued) Legal Values Positive integer Default 120 seconds cfgLDAPSRVLookupDomainName Table 285. Details of cfgLDAPSRVLookupDomainName Description Configures the domain name to be used in the SRV lookup. Legal Values String of maximum length of 254 alphanumeric characters and hyphens. The string must begin with a letter. Default [null] cfgLDAPSRVLookupEnable Table 286.
The following sections provide information about the objects in the cfgLdapRoleGroup group. cfgLDAPRoleGroupDN (Read/Write) Table 288. Details of cfgLDAPRoleGroupDN Description This is the Domain Name of the group in this index. For CMC, configure the LDAP distinguished name (DN) for the role group instance. Legal Values String.
cfgLocationAisle (Read/Write) Table 291. Details of cfgLocationAisle Description Indicates aisle where server is located. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationRack (Read/Write) Table 292. Details of cfgLocationRack Description Indicates rack where server is located. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationRackslot (Read/Write) Table 293. Details of cfgLocationRackslot Description Indicates the slot where a server is located.
cfgSSADRoleGroupIndex (Read Only) Table 295. Details of cfgSSADRoleGroupIndex Description Index of the Role Group as recorded in the Active Directory. Legal Values An integer between 1 and 5 Default cfgSSADRoleGroupName (Read/Write) Table 296. Details of cfgSSADRoleGroupName Description Name of the Role Group as recorded in the Active Directory forest. Legal Values Any printable text string of up to 254 characters with no white space.
$ config -g cfgStandardSchema -i 1 -o cfgSSADRoleGroupName Charlie Object value modified successfully Table 299.
Table 301. Details of cfgChassisPeakPower (continued) Legal Values Default cfgChassisPeakPowerTimestamp (Read Only) Table 302. Details of cfgChassisPeakPowerTimestamp Description The timestamp recorded when the peak input power consumption value occurred. Legal Values Default cfgChassisMinPower (Read Only) Table 303. Details of cfgChassisMinPower Description The minimum system input power consumption value (in Watt) over the time since the value was last cleared.
cfgChassisRedundantState (Read Only) Table 306. Details of cfgChassisRedundantState Description Enables or disables power redundancy for the chassis. Legal Values • • Default None 0 (none) 1 (full) cfgChassisDefaultPowerCapUpperBound (Read Only) Table 307. Details of cfgChassisDefaultPowerCapUpperBound Description Indicates the maximum default value to which you can set the power cap of a chassis.
Table 310. Details of cfgChassisDefaultPowerCapLowerBoundBTU (continued) Default Zero Watt cfgChassisPowerCap (Read/Write) Table 311. Details of cfgChassisPowerCap 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) Table 312.
Table 314. Details of cfgChassisPowerCapPercent (continued) generates an error if server throttling is necessary to achieve the power goal based on the value for this setting. Legal Values 16 -100 NOTE: If the specified percent is lower than the minimum value, the CMC will set the value to the minimum value. Default 100 cfgChassisPowerCapFPercent (Read/Write) Table 315. Details of cfgChassisPowerCapFPercent Description Indicates the power consumption limit as a percentage.
cfgChassisInMaxPowerCapacity (Read Only) Table 318. Details of cfgChassisInMaxPowerCapacity Description Indicates the total chassis power budget (in watts) available for chassis operation. Legal Values None Default None cfgChassisInRedundancyReserve (Read Only) Table 319. Details of cfgChassisInRedundancyReserve Description Indicates the amount of redundant power (in Watt) in reserve that can be utilized in the event of an AC grid or PSU failure.
Table 322. Details of cfgChassisTotalInPowerAvailable (continued) Default None cfgChassisStandbyInPowerCapacity (Read Only) Table 323. Details of cfgChassisStandbyInPowerCapacity Description Indicates the amount of power (in Watt) available for turning on any hardware modules that are either added to the chassis or if they are already present in the chassis. Legal Values None Default None cfgChassisPowerClear (Write Only) Table 324.
Table 327.
Table 329. Details of cfgChassisPowerCapBTU (continued) Legal Values 9264 - 56931 BTU/hr Default 43221 BTU/hr cfgChassisACPowerRecoveryDisable Table 330. Details of cfgChassisACPowerRecoveryDisable attribute Description If AC power recovery is disabled, the chassis is powered off after power outage is restored. Legal Values • • Default 0 0 — Enable 1 — Disable cfgKVMInfo This group is used to view the mapping information for the KVM. Use this object with the config or getconfig subcommands.
cfgDvdMapping (Read/Write) Table 333. Details of cfgDvdMapping 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. Default 1 cfgDvdSlotEnable (Read/Write) Table 334. Details of cfgDvdSlotEnable Description Enable the slots (1 to 4) to access the DVD: • • • • cfgDvdSlot1Enable cfgDvdSlot2Enable cfgDvdSlot3Enable cfgDvdSlot4Enable Legal Values 0 disables the mapping and 1 enables the mapping.
cfgAlertingSourceEmailName Table 336. Details of 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.
Table 338. Details of cfgIPv6AutoConfig (continued) NOTE: The CMC uses its MAC address for its DUID (DUID-LL) when communicating with a DHCPv6 server. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgIPv6Address Table 339. Details of 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.
Table 342. Details of cfgIPv6DNSServersFromDHCP6 (continued) 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 343. Details of cfgIPv6DNSServer1 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.
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.
# # # # # # cfgNicCurrentVlanEnable=0 cfgNicCurrentVlanID=1 cfgNicCurrentVlanPriority=0 cfgDNSCurrentServer1=192.168.0.5 cfgDNSCurrentServer2=192.168.0.6 cfgDNSCurrentDomainName=MYDOMAIN cfgNicCurrentIpAddress Table 346. Details of cfgNicCurrentIpAddress Description Displays the static IP address to the CMC. Legal Values None Default None cfgNicCurrentNetmask Table 347. Details of cfgNicCurrentNetmask Description Displays the static subnet mask for the CMC IP address.
cfgNicCurrentVlanEnable (Read Only) Table 350. Details of cfgNicCurrentVlanEnable Description Indicates whether the VLAN is enabled. Legal Values 0- VLAN is disabled 1- VLAN is enabled Default None cfgNicCurrentVlanID (Read Only) Table 351. Details of cfgNicCurrentVlanID Description Indicates the Current Virtual Lan ID Legal Values Integer Default None cfgNicCurrentVlanPriority (Read Only) Table 352.
cfgDNSCurrentDomainName Table 355. Details of 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 Table 356. Details of cfgCurrentIPv6Enabled Description Indicates whether IPv6 is enabled on the CMC.
cfgCurrentIPv6Address Table 359. Details of cfgCurrentIPv6Address Description Displays the current IPv6 addresses. This property displays up to 15 global IPv6 addresses, including stateful and stateless addresses. Legal Values None Default None cfgCurrentIPv6Gateway Table 360. Details of cfgCurrentIPv6Gateway Description Displays the current IPv6 gateway. Legal Values None Default None cfgCurrentIPv6DNSServersFromDHCP6 Table 361.
Example racadm getconfig -g cfgCurrentIPv6LanNetworking # cfgCurrentIPv6Enabled=1 # cfgCurrentIPv6AutoConfigWasUsed=1 # cfgCurrentLinkLocalAddress=fe80::21e:4fff:fe1f:5371/64 # cfgCurrentIPv6Address1=2009:123::e48f:9dd8:6f51:a669/64 # cfgCurrentIPv6Address2=fd88:1::21e:4fff:fe1f:5371/64 # cfgCurrentIPv6Address3=fd88:2::21e:4fff:fe1f:5371/64 # cfgCurrentIPv6Gateway=fe80::21c:23ff:fe77:6215 # cfgCurrentIPv6DNSServersFromDHCP6=1 # cfgCurrentIPv6DNSServer1=2009:123::1 # cfgCurrentIPv6DNSServer2=:: cfgNetTuning
Table 366. Details of cfgNetTuningNicMtu (continued) Default 1500 NOTE: IPv6 requires a minimum MTU of 1280. If IPv6 is enabled, and cfgNetTuningMtu is set to a lower value, the CMC uses an MTU of 1280. cfgNetTuningNicAutoneg (Read/Write) Table 367. Details of cfgNetTuningNicAutoneg Description Enables autonegotiation of physical link speed and duplex. If enabled, autonegotiation takes priority over other values set in this group.
cfgRacSecCsrOrganizationName (Read/Write) Table 369. Details of cfgRacSecCsrOrganizationName Description Specifies the CSR Organization Name (O). Legal Values A string of up to 64 characters. Default cfgRacSecCsrOrganizationUnit (Read/Write) Table 370. Details of cfgRacSecCsrOrganizationUnit Description Specifies the CSR Organization Unit (OU). Legal Values A string of up to 64 characters. Default cfgRacSecCsrLocalityName (Read/Write) Table 371.
cfgRacSecCsrEmailAddr (Read/Write) Table 374. Details of cfgRacSecCsrEmailAddr Description Specifies the CSR email address. Legal Values A string of up to 64 characters in email format. Default Example racadm config -g cfgRacSecurity cfgRacSecCsrKeySize=1024 cfgRacSecCommonName=CommonName cfgRacSecOrganizationName=OrgName cfgRacSecOrganizationUnit=OrgUnit cfgRacSecLocalityName=LocalityName cfgRacSecStateName=StateName cfgRacSecCountryCode=US cfgRacSecEmailAddr=Name@domain.
cfgSetiDRACRootPasswordOnServerInsertion Table 377. Details of cfgSetiDRACRootPasswordOnServerInsertion attribute Description Sets the iDRAC root password when a server is inserted into the chassis. Legal Values • • Default 0 (False) — If the value is ‘1’ when the server is inserted, the iDRAC root password is not set. 1 (True) — If the value is ‘1’ when the server is inserted, the iDRAC root password is set. 0 cfgiDRACRootPassword Table 378.
Table 381. Details of cfgEnableiDRACIPMIOverLAN attribute (continued) Legal Values • • Default 0 0 — Disable 1 — Enable cfgEnableiDRACIPv4DHCP Table 382. Details of cfgEnableiDRACIPv4DHCP attribute Description Enables DHCP for iDRAC when servers are inserted into the chassis. Legal Values • • Default 1 0 — Disable 1 — Enable cfgStartingiDRACIPv4Address Table 383. Details of cfgStartingiDRACIPv4Address attribute Description The static IPv4 address for the iDRAC located in the first slot.
cfgEnableiDRACIPv6 Table 386. Details cfgEnableiDRACIPv6 attribute Description Enables IPv6 for each IPv6-capable iDRAC present in the chassis. Legal Values • • Default 0 0 — Disable 1 — Enable cfgEnableiDRACIPv6AutoConfig Table 387. Details of cfgEnableiDRACIPv6AutoConfig attribute Enables the IPv6 feature that allows each iDRAC present in the chassis to set its IPv6 address automatically, without manual configuration of the host or DHCP servers.
Table 390. Details of cfgReservedIPAddressNumbers attribute (continued) Default 32 cfgUseCMCDNSSettings Table 391. Details of cfgUseCMCDNSSettings attribute Propagates the CMC DNS Server settings (IPv4 and IPv6) to iDRAC when a blade server is inserted in the chassis. Description Legal Values • • Default 0 0 — False 1 — True cfgServerDNSIMCNameEnable Table 392.
