CLI Guide

ManualsBrandsDell ManualsActive System ManagerChassis Management Controller Version 3.20 For Dell PowerEdge VRTX

Dell Chassis Management Controller Version 3.20

for PowerEdge VRTX

RACADM CLI Guide

Summary of content (195 pages)

PAGE 1
Dell Chassis Management Controller Version 3.
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. © June 2013 - June 2018 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
PAGE 3
Contents 1 Introduction.................................................................................................................................................. 12 What’s new in this release............................................................................................................................................... 12 Supported RACADM Interfaces......................................................................................................................................
PAGE 4
getmodinfo........................................................................................................................................................................47 getniccfg........................................................................................................................................................................... 48 getpbinfo..........................................................................................................................................
PAGE 5
init.................................................................................................................................................................................87 raid................................................................................................................................................................................87 rebuild..........................................................................................................................................
PAGE 6
cfgLanNetworking...........................................................................................................................................................113 cfgNicIPv4Enable (Read or Write)..........................................................................................................................113 cfgNicVLanId (Read or Write).................................................................................................................................
PAGE 7
cfgSsnMgtWebserverTimeout (Read/Write)....................................................................................................... 129 cfgSerial........................................................................................................................................................................... 129 cfgSerialBaudRate (Read/Write)...........................................................................................................................
PAGE 8
cfgServerInfoIndex (Read Only)............................................................................................................................. 143 cfgServerSlotNumber (Read Only)........................................................................................................................ 143 cfgServerServiceTag (Read Only)..........................................................................................................................143 cfgServerName (Read/Write).............
PAGE 9
cfgLDAPServer (Read/Write).................................................................................................................................157 cfgLDAPPort (Read/Write).....................................................................................................................................157 cfgLDAPBasedn (Read/Write)............................................................................................................................... 157 cfgLDAPUserAttribute (Read/Write).
PAGE 10
cfgChassisPowerCapFPercent (Read/Write).......................................................................................................170 cfgChassisRedundancyPolicy (Read/Write)......................................................................................................... 170 cfgChassisDynamicPSUEngagementEnable (Read/Write)................................................................................. 171 cfgChassisInMaxPowerCapacity (Read Only)..........................................
PAGE 11
cfgDNSCurrentServer2........................................................................................................................................... 183 cfgDNSCurrentDomainName..................................................................................................................................183 cfgCurrentIPv6LanNetworking (Read Only)...............................................................................................................183 cfgCurrentIPv6Enabled................
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
Table 2. Racadm interfaces Type Local RACADM SSH/Telnet RACADM Remote RACADM CMC No Yes Yes NOTE: Multiple instances of remote RACADM can be executed on a management station. 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
Subcommand CMC getmodinfo Yes Yes getniccfg Yes Yes getpbinfo Yes Yes getpciecfg Yes Yes getpminfo Yes Yes getraclog Yes Yes getractime Yes Yes getredundancymode Yes Yes getsel Yes Yes getsensorinfo Yes Yes getslotname Yes Yes getssninfo Yes Yesz getsvctag Yes Yes getsysinfo Yes Yes getversion Yes Yes help and help Yes Yes ifconfig Yes Yes jobqueue Yes Yes krbkeytabupload No Yes license Yes Yes netstat Yes Yes ping Yes Yes ping
PAGE 16
Subcommand CMC setractime Yes Yes setslotname Yes Yes setsysinfo Yes Yes sshpkauth Yes Yes sslcertview Yes Yes sslcsrgen Yes Yes sslresetcfg Yes Yes testemail Yes Yes testfeature Yes Yes testtrap Yes Yes traceroute Yes Yes traceroute6 Yes Yes Other documents you may need To access the documents from the Dell Support site. Along with this Reference Guide, you can access the following guides available at dell.com/support/manuals.
PAGE 17
• Documentation for any components you purchased separately provides information to configure and install these options. • Any media that ships with your system that provides documentation and tools for configuring and managing your system, including those pertaining to the operating system, system management software, system updates, and system components that you purchased with your system.
PAGE 18
2 RACADM Subcommand Details This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
PAGE 19
• getsel • getsensorinfo • getslotname • getssninfo • getsvctag • getsysinfo • gettracelog • getversion • 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 RAC
PAGE 20
Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands When using strings that contain special characters, use the following guidelines: Strings containing the following special characters must be quoted using single quotation marks or double quotation marks: • $ (dollar sign) • " (double quotation marks) • ' (single quotation marks) • ` (back quotation marks) • \ (backslash) • ~ (tilde) • ; (semicolon) • | (vertical bar) • ( (left parentheses) • ) (right par
PAGE 21
Racadm help and help with subcommand Table 4. Racadm help commands Description Displays all the subcommands you can use with the RACADM command and a one-line description of each subcommand. ? followed by displays the syntax for the specified command. To use this subcommand, you must have the CMC Login User privilege. You can also use the help and help commands to obtain the same information.
PAGE 22
-4 : show CMC IPv4 information -6 : show CMC IPv6 information help and help subcommand Table 5. Help command Description Synopsis Input Lists all the subcommands available for use with RACADM and provides a short description for each. You may also type a subcommand after help. • racadm help • racadm help None Output • Example The help command displays a complete list of subcommands. racadm help getsysinfo chassislog Table 6.
PAGE 23
• -l - Specifies the location of the network share or area on file system where chassis log is exported. Two types of network shares are supported: — SMB mounted path: //// — NFS mounted path: :/. • • • • -u — Specifies the user name for accessing the FTP Server, or Domain and User Name for accessing network share location.
PAGE 24
– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – RFLA : IDSDM Absent TST : Test Alert FSD : Debug RED : FW Download PST : BIOS POST BOOT : BOOT Control SSD : PCIe SSD IOV : IO Virtualization PR : Part Exchange SWU : Software Change USR : User Tracking PDR : Physical Disk VDR : Virtual Disk SWC : Software Config DKM : Dell Key Mngr NDR : NIC OS Driver RAC : RAC Event ASR : Auto Sys Reset HWC : Hardware Config RRDU : IDSDM Redundancy AMP : Amperage VLT : Voltage DH : Cert Mgmt TMP : Temperat
PAGE 25
• Display all the available records from the active Chassis log: racadm chassislog view -n all • Display the last 25 records from the Chassis log: racadm chassislog view chassislog export Table 7. chassislog export Description Exports the Chassis log to a remote share. To export the chassis log, you must have the Clear Logs Administrator privilege.
PAGE 26
• Clear the Chassis Log using remote racadm racadm -r 192.168.0.11 -u root -p calvin chassislog clear chassisaction Table 9. Chassisaction Description Runs a power action on the chassis or a switch. To use this subcommand, you must have the Chassis Control Administrator privilege. NOTE: For remote racadm, check the power status of the module using the getmodinfo command. Synopsis Input racadm chassisaction [-m ] • -m — Module on which you want to carry out the action.
PAGE 27
Input • racadm closessn -u • -i — The session ID of the session to be ended, which can be retrieved using RACADM getssninfo subcommand. Session running this command cannot be ended. -a — Closes all sessions. -u — Close all sessions for a particular user name. – Remote RACADM: -u option or -i option • • Output None Example • • • racadm closessn -i 1234 Closes the session 1234. racadm closessn –u root Closes all the sessions for root user.
PAGE 28
Example racadm cmcchangeover config Table 13. Config Description Allows you to set CMC configuration parameters individually or to batch them as part of a configuration file. If the data is different, that CMC object is written with the new value. Synopsis racadm config [-c|-p] -f racadm config -g -o [-i ] NOTE: The configuration file retrieved using remote racadm are not interoperable.
PAGE 29
connect Table 14. Details of connect Description Synopsis Input Connects to the switch or server serial console. • racadm connect [-b] —m • racadm connect [-b] • racadm connect [-b] -b — Connects to the switch or console using the binary mode. This is an optional argument; a server or a switch must be present. NOTE: If you use the -b option, reset the CMC to terminate the connect operation.
PAGE 30
Legal values: device=None, PXE, hard disk drive (HDD), CD-DVD, vFDD, vCD-DVD, iSCSI, SD, FDD, RFS • -o — Indicates if the server should boot from the device once; must be used with o. Use with -m to specify for an individual server, or with -a for all servers. • -a — Creates and enables an iDRAC root user if it does not exist, and is executed on all the existing servers in the chassis. -u root — Indicates that the is supplied for the root user on the server.
PAGE 31
eventfilters Table 16. Details of eventfilters Description Gets, sets, and displays the list of event filter settings. To use this subcommand with the get option, you must have the CMC Login User privilege. Synopsis racadm eventfilters racadm eventfilters get -c racadm eventfilters set -c -n NOTE: The general format of an alert descriptor: cmc.alert.category.[subcategory].
PAGE 32
• Display eventfilter configurations for a specific subcategory. For example, licensing under the audit category: racadm eventfilters get -c cmc.alert.audit.lic • Display eventfilter configurations for a specific severity. For example, warning under the audit category: racadm eventfilters get -c cmc.alert.audit.warning • Display eventfilter configurations for a specific severity and subcategory.
PAGE 33
feature Table 18. Details of feature Description Displays all active chassis features. The information displayed includes feature name, date activated, and the serial number of the SD card used to activate the feature. Dell Feature Cards may contain more than one feature. NOTE: To use this subcommand to deactivate FlexAddress or ExtendedStorage, you must have the Chassis Configuration Administrator privilege. A user with login privileges can view status only.
PAGE 34
Active CMC: The feature card inserted is valid, serial number = CN0H871T137401112222A00 The feature card contains the following feature(s): FlexAddress: bound FlexAddressPlus: bound ExtendedStorage: bound Standby CMC: The feature card contains the following feature(s): FlexAddress: not bound FlexAddressPlus: not bound ExtendedStorage: bound fwupdate Table 20.
PAGE 35
NOTE: While performing firmware update using the racadm fwupdate command, if the number of characters in the firmware image path is greater than 256 characters, Remote RACADM session logs off with the error message ERROR: Specified path is too long. • Input racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.cmc -m cmc-active NOTE: Firmware update from local RACADM (using the -p, -u, or -d options) is not supported on Linux operating system.
PAGE 36
• Upload the firmware image from the FTP server and start the firmware update. racadm fwupdate -f 192.168.0.100 fred password123 -d vrtx_cmc.bin active • Start IOM infrastructure firmware update. racadm fwupdate -u -m iominf-1 • Update firmware on both the CMCs. racadm fwupdate -g -u -a 192.168.0.100 -d vrtx_cmc.bin cmc-standby -m cmc- -m cmc-active -m Signed CMC Firmware Image: • racadm fwupdate –g –u –a -d -m cmc-active • Firmware update has been initiated.
PAGE 37
• Export the CMC XML configuration to a local share using remote racadm racadm -r 192.168.0.120 -u abc -p get -f file.xml -t xml • Export the CMC XML configuration to a CIFS share racadm get -f file.xml -t xml -u myuser -p mypass -l //192.168.0.0/ share • Export the CMC XML configuration to an NFS share racadm get -f file.xml -t xml -l 192.168.0.0:/myshare getactiveerrors Table 22. Details of getactiveerrors Description Displays the active errors in a chassis.
PAGE 38
To use this subcommand, you must have the CMC Login User privilege. Synopsis racadm getassettag [-m ] Input -m — Specifies the module whose asset tag you want to view. Legal value: chassis Example • racadm getassettag -m chassis • racadm getassettag chassis 78373839–33 getchassisname Table 24. Details of getchassisname Description Displays the name of the chassis. To use this subcommand, you must have the CMC Login User privilege.
PAGE 39
• • • Output is a decimal integer from 1 through n, where n can vary from 1 to maximum number of indexes a particular group supports. If -i is not specified, a value of 1 is assumed for groups, which are tables that have multiple entries. The index is specified by the index value, not a named value. -o — The -o or object option specifies the object name that is used in the query. This option is optional and can be used with the -g option.
PAGE 40
getdcinfo Table 27. Details of getdcinfo Description Displays general I/O module and daughter card configuration information. Only the CMC controls daughtercards. To use this subcommand, you must have the CMC Login User privilege. NOTE: Fabric verification for server DCs is performed only when the chassis is turned on. When the chassis is on stand-by power, iDRACs on the server modules remain turned off and thus are unable to report the server's DC fabric type.
PAGE 41
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. Synopsis racadm getflexaddr [-i ] Input -i — Specifies the slot information to be displayed. must be from 1 to 4. Table 31.
PAGE 42
NOTE: The fabric type may be any supported I/O fabric type, such as Ethernet, Fiber Channel, and Infiniband. Synopsis racadm getioinfo racadm getioinfo [-m ] racadm getioinfo [-m ][-s] Input -m — Specifies the module or device. The must be switch — , where n = 1–2 -s — Displays the stack information. Table 34.
PAGE 43
getmacaddress Table 36. Details of getmacaddress Description Displays the MAC/WWN addresses and fabric ID decoder for all modules or for a specified module. The decoder values indicate the protocols of the network cards: • 0—Unsupported • 1—ISCSI • 2—FCoE-FIP • 3—iSCSI/FCoE-FIP To use this subcommand, you must have the CMC Login User privilege.
PAGE 44
• Display extra iSCSI MACs for server-1 (if available). racadm getmacaddress -m server-1 -t iscsi -x • Displays the user-defined MAC and WWN address. – racadm getmacaddress -c io-identity – racadm getmacaddress -c io-identity -m server -2 • Displays the console assigned MAC/WWN of all LOMs or mezzanine cards. racadm getmacaddress -c all • Displays the chassis assigned WWN/MAC address. racadm getmacaddress -c flexaddress • Displays the MAC/WWN addresses for all LOMs or mezzanine cards.
PAGE 45
Switch-1 Present N/A 00:00:00:00:00:00 N/A Table 42.
PAGE 46
Gigabit Ethernet Present 00:0A:00:0A: 00:00 Unknown IO-Identity Gigabit Ethernet Present 00:0A:00:0A: 00:01 Unknown IO-Identity Gigabit Ethernet Present 00:0A:00:0A: 00:02 Unknown IO-Identity Gigabit Ethernet Present 00:0A:00:0A: 00:03 Unknown IO-Identity Table 44.
PAGE 47
Server-3-A Reserved Present Switch-4 Not Installed Not Present Not Installed Not Installed Not Installed Switch-1 Not Installed Not Present Not Installed N/A N/A NOTE: If the I/O Modules in slots 1 and 2 are absent and the getmacaddress -a and getmacaddress —c all commands are run, the output is displayed as Not Installed in the following columns: • • • getmodinfo Table 47.
PAGE 48
Chassis Not OK Main-Board OK Storage OK Fan-1 Not OK Fan-2 OK Fan-3 OK Fan-4 OK Fan-5 OK Fan-6 OK Blower-1 OK Blower-2 OK Blower-3 OK Blower-4 OK PS-1 OK PS-2 OK PS-3 A PS-4 A CMC-1 OK CMC-2 OK Switch-1 OK Server-1 N/A Server-2 A Server-3 OK Server-4 A DVD OK IO-Cable OK FPC-Cable OK Present 3BPV622 Present N/A Present 3BPV622 Unknown N/A Present N/A Present N/A Present N/A Present N/A Present N/A Present N/A Present N/A Present N/A Present N/A Present N/A Present N/A Not Present N/A Not Present N/A Presen
PAGE 49
Input racadm getniccfg racadm getniccfg –m where –m must be one of the following values: • chassis • : default state if -m is not specified server-n • : where n = 1 to 4 switch-n : where n = 1 Example racadm getniccfg NIC Enabled IPv4 Enabled DHCP Enabled Static IP Address Static Subnet Mask Static Gateway Current IP Address Current Subnet Mask Current Gateway IPv6 Enabled Autoconfiguration Enabled Static IPv6 Address Static IPv6 Gateway Link Local Address Current IPv6 Address 1 Current IPv
PAGE 50
getpbinfo Table 49. Details of getpbinfo Description Displays power budget status information. To use this subcommand, you must have the CMC Login User privilege.
PAGE 51
NOTE: • • To use this subcommand, you must have the CMC Login User privilege. Lengthy PCIe card names and server slot names are truncated when the assignments for all PCIe slots are displayed. Synopsis racadm getpciecfg [-c ][a] Input • • • • Example • -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.
PAGE 52
PCIe PCIe PCIe PCIe slot slot slot slot 10 10 10 10 Virtual Virtual Virtual Virtual Adapter Adapter Adapter Adapter 01 02 03 04 RAID.ChassisIntegrated.2-1-1 RAID.ChassisIntegrated.2-1-2 RAID.ChassisIntegrated.2-1-3 RAID.ChassisIntegrated.2-1-4 • 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.
PAGE 53
Overall Power Health = OK Redundancy = No [System Power Policy Configuration] System Input Power Cap 7928 W (7928 BTU/hr | 10%) Surplus for Peak Performance W (6130 BTU/hr) Redundancy Policy Dynamic PSU Engagement Enabled = = 7000 = None = 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 ge
PAGE 54
getractime Table 54. Details of getractime Description Displays the current iDRAC time. Synopsis Input • racadm getractime [-d] • racadm getractime [-d][-z] • racadm getractime [-n] • • • -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.
PAGE 55
Input • • • • • • • • -A — Specifies output with no display headers or labels. -c — Provides the number of records to be displayed. -o — Displays each entry in the SEL in a single line. -s — Specifies the starting record used for the display. -E — Displays RAW SEL data with the other data for each entry. -R — Displays only RAW SEL data for each entry. -i — Displays the number of entries in the SEL. --more — Displays one screen at a time and prompts the user to continue (similar to the UNIX more command.
PAGE 56
Blower-4 N/A 2611 3000 2250 N/A N/A Table 59. Temperature sensor Chassis Ambient OK 22 3 -7 42 47 Server-4 20 3 -7 42 47 OK Table 60.
PAGE 57
Table 63. Cable sensor 1 IO-Cable OK 2 FPC-Cable OK 1 Chassis Intrusion Closed Table 64. Door sensor getslotname Table 65. 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.
PAGE 58
getssninfo Table 66. Details of getssninfo Description Displays a list of users that are connected to iDRAC. The following information is displayed: • • • • • Session ID Username IP address (if applicable) Session type (for example, serial or Telnet) Login date and time in MM/DD/YYYY HH:MM:SS format 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.
PAGE 59
Example racadm getsvctag getsysinfo Table 69. Details of getsysinfo Description Displays information related to CMC and chassis. 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.
PAGE 60
System Model System AssetTag Service Tag Express Service Code Chassis Name Chassis Location Chassis Midplane Version Power Status System ID Examples = = = = = = = = = PowerEdge VRTX 00000 CMC[UNDEFINED] 1.0 ON 1487 racadm getsysinfo -d racadm getsysinfo -c racadm getsysinfo -A racadm getsysinfo -4 racadm getsysinfo -6 gettracelog Table 70. Details of gettracelog Description Synopsis Input Lists all the trace log entries in CMC.
PAGE 61
NOTE: To use this subcommand, you must have CMC Login User privilege. Synopsis • racadm getversion • racadm getversion [-b | -c] [-m ] • racadm getversion -l [-m ] [-f ] Input 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.
PAGE 62
Physical Disk 0:0:6 AS09 6:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:7 AS09 7:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:8 AS09 8:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:9 AS09 9:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 • • • • • Disk.Bay. Disk.Bay. Disk.Bay. Disk.Bay. -b - Displays the server's current BIOS version (default is iDRAC version). -c - Displays the server's current CPLD version.
PAGE 63
ifconfig Table 72. 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 09:FF:DA:23 HWaddr 00:1D: inet addr:10.35.155.136 192.168.0.1 Mask:255.255.255.
PAGE 64
• • Example 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. If you specify TIME_NA, the wait-time is not applicable for the job.
PAGE 65
Example racadm krbkeytabupload -f c:\keytab \krbkeytab.tab license Table 75. Details of license Description Manages the CMC licenses. Synopsis racadm license .
PAGE 66
• • • • Examples • NOTE: During export, the license file is named _.xml. -u— User name of the remote share. -p — Password for the remote share. -e — Specifies the entitlement ID of the license file. -t — Specifies the transaction ID of the license file. View licenses: – View all the license information in the chassis. racadm license view CMC.Integrated.1 Status = OK Device = CMC.Integrated.
PAGE 67
– Delete license using a transaction ID. For example, 2. racadm license delete -t 2 • Replace a license. – Replace the license on a device with a license file that is on an NFS share, and using a transaction ID. For example, transaction 27. racadm license replace -f License.xml -l 192.168.2.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.
PAGE 68
ping6 Table 78. Details of ping6 Description Verifies that the destination IPv6 address is reachable from an iDRAC or CMC, or with the current routing-table contents. A destination IPv6 address is required. An ICMP echo packet is sent to the destination IPv6 address on the basis of current routing-table contents. To use this subcommand for CMC, you must have the Administrator privilege. Synopsis racadm ping6 Example racadm iping6 198.162.0.2 IPING6 198.162.0.2 (192.168.0.
PAGE 69
Output • Redundancy information - getredundancymode • Trace log information - gettracelog • RAC event log - getraclog • System event log - getsel The following information is displayed when the racdumpsubcommand is processed: • • • • • General system/RAC information Coredump Session information Process information Firmware build information Example racadm racdump =============================================================================== General System/RAC Information ========================
PAGE 70
FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed FanSpeed 3 4 5 6 7 8 9 Fan-3 Fan-4 Fan-5 Fan-6 Fan-7 Fan-8 Fan-9 OK OK OK OK OK Not OK OK 4839 14527 14505 4835 14521 1 4826 rpm rpm rpm rpm rpm rpm rpm 2344 7250 7250 2344 7250 7250 2344 Temp 1 Ambient_Temp OK 21 celcius N/A PWR 1 PWR 2 PWR 3 PWR 4 PWR 5 PWR 6 PS-1 PS-2 PS-3 PS-4 PS-5 PS-6 14500 14500 14500 14500 14500 14500 14500 40
PAGE 71
– server-n, where n=1–4 – switch-n, where n=1 • -c : — Must be one of the following values: – ad — Reset Active Directory properties to the default value. The default setting is “disabled”. – pcap — Reset Power Cap properties to the default value. – flex — Reset FlexAddress properties to the default value. The default setting is “enabled”. – dpse — Reset Dynamic Power Supply Engagement to the default value. The default setting is “disabled”.
PAGE 72
• This command displays the filtered property values for all returned controller objects. Monitor and Inventory all batteries connected to the controller racadm raid get batteries --refkey This command displays all battery keys connected to the controllers referred to as refkeys. racadm raid get batteries --refkey -o This command is an optimized version and displays all battery objects for the controller FQDD.
PAGE 73
This command displays the wear gauge property of the Solid State Drives (SSDs). racadm raid get pdisks -o -p RemainingRatedWriteEndurance This command is an optimized version and displays all disk objects for the enclosure FQDD. racadm raid get pdisks --refkey -o -p optimized and filtered version.
PAGE 74
This command is an optimized and filtered version. blink Table 84. Details of blink Description Starts blinking or identifies operation on the specified device. NOTE: The physical disks associated with the adapter blink or unblink. Synopsis racadm racadm racadm FQDDs} racadm raid blink: raid blink: raid blink {-pdkey:
PAGE 75
• • • • • • • • • • • • • -wp {wt | wb | fwb}: Set the write policy to Write Through, Write Back, or Forced Write Back. -rp {nra|ra|ara}: Set the read policy to No Read Ahead, Read Ahead, or Adaptive Read Ahead. -ss: Specify the stripe size to use. -sc: Number of spans in the virtual disk. This value must be entered while creating spanned RAID levels such as 10, 50, and 60. -pdkey: : The PDs to use in the VD. -dcp: Set the Disk Cache Policy in the VD.
PAGE 76
discardcache Table 87. Details of discardcache Description Discards any pinned or persistent cache present on the RAID controller. Synopsis racadm raid discardcache: {-current | -pending} 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.
PAGE 77
Example racadm raid forceonline:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 get controllers Table 90. Details of get controllers Description The command lists all RAID controllers detected in the system and their properties. NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis Input Example raid get controllers -o • -o — The -o is used to display the fault-tolerant status of a RAID controller.
PAGE 78
Sample output of a CMC in which you have firmware support for the fault-tolerant mode and the hardware, and fault-tolerant mode is active. RAID.ChassisIntegrated.
PAGE 79
EncryptionMode SasAddress PciDeviceId PciSubdeviceId PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvailabilityMode PeerController = = = = = = = = = = = = = = = None 0x590B11C02620E600 0x2f 0x1f3e 0x1000 0x1028 0x0 0x0 0x0 Unknown Short Unknown 6.0 Gb/s, 3.0 Gb/s Not supported Fault Tolerant(Active/Passive) = RAID.ChassisIntegrated.1-1 get enclosure Table 91.
PAGE 80
RedundantPath = Present SasAddress = Not applicable SlotCount = 24 Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Failed RollupStatus = Failed Name = MD1220 0:0 EnclosurePosition = 0 ConnectedPort = 0 FirmwareVersion = 1.05 ServiceTag = BWQPWP1 AssetTag = slot 5 0 AssetName = MD1220 RedundantPath = Present SasAddress = Not applicable SlotCount = 24 get emms Table 92. Details of get emms Description Displays the status and attributes of the Enclosure Management Module (EMM).
PAGE 81
State = Ready Name = EMM 0 PartNumber = 0W307KA00 FirmwareVersion = 1.05 EMM.Slot.1:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok State = Ready Name = EMM 1 PartNumber = 0W307KA00 FirmwareVersion = 1.05 EMM.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Failed State = Failed Name = EMM 0 PartNumber = 0W307KA00 FirmwareVersion = 1.05 EMM.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Unknown State = Unknown Name = EMM 1 PartNumber = 0W307KA00 FirmwareVersion = 1.
PAGE 82
Fan.Slot.1:Enclosure.External.0-1:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 1 Speed = 4620 RPMS Fan.Slot.2:Enclosure.External.0-1:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 2 Speed = 4490 RPMS Fan.Slot.3:Enclosure.External.0-1:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 3 Speed = 4560 RPMS Fan.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 0 Speed = 4670 RPMS Fan.
PAGE 83
PSU.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok racadm raid get psus -o PSU.Slot.0:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok State = Ready Name = PSU 0 PartNumber = 0NFCG1A01 PSU.Slot.1:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok State = Ready Name = PSU 1 PartNumber = 0NFCG1A01 PSU.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok State = Ready Name = PSU 0 PartNumber = 0D1YWRA00 PSU.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.
PAGE 84
MaximumWarningThreshold = 45 C MinimumFailureThreshold = 3 C MaximumFailureThreshold = 55 C TempSensor.Embedded.3:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok State = Ready Name = Temp Sensor 3 ReadingDegreeCelcius = 25 C MinimumWarningThreshold = 10 C MaximumWarningThreshold = 46 C MinimumFailureThreshold = 3 C MaximumFailureThreshold = 55 C TempSensor.Embedded.0:Enclosure.External.0-0:RAID.ChassisSlot.
PAGE 85
• • • Example –assign {yes | no}: Assign or Unassign the physical disk drive as a hotspare. –type { ghs | dhs} : Assign as a global or dedicated hotspare. –vdkey: : Required for dedicated hotspare. Assign the dedicated hotspare to the specified VD. racadm raid 1-1 -assign racadm raid 1-1 -assign racadm raid 1-1 -assign hotspare:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated. no hotspare:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated. yes -type ghs hotspare:Disk.Bay.
PAGE 86
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. Synopsis racadm raid assignva: -vdkey: -accesspolicy {na | rw} assignpolicy {single | multiple}{-current | -pending} Input • • • • • –current : Performs the configuration right now.
PAGE 87
init Table 101. Details of init Description Starts an initialization operation on the specified virtual drive. Synopsis racadm raid init: -speed {fast | full} {-current | -pending} Input • –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 88
Example 88 • • • – unblink – clearconfig – importconfig – ccheck – cancelcheck – patrolread – hotspare – init – assignva – createvd –o — Displays all the properties of the selected Key or Object. –p — Displays the property names with filter. FQDD — Displays all the properties of the FQDD's Key. • racadm raid 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.
PAGE 89
• [-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 90
resetconfig Table 104. Details of resetconfig Description Removes the current RAID Configuration (Virtual Drives and Hotspares) from the RAID controller. This operation is not data-destructive, but is difficult to reverse. Synopsis racadm raid resetconfig: {-current|pending} 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.
PAGE 91
createsecuritykey Table 107. Details of createsecuritykey Description Assigns a security key to the controller. Synopsis racadm raid createsecuritykey: -key -passwd Input -key — key id. The key identifier can be a minimum of one character and maximum of 32 characters. It must not have spaces. -passwd — passphrase. The passphrase can be a minimum of eight characters and a maximum of 32 characters.
PAGE 92
encryptvd Table 110. Details of encryptvd Description Encrypts the virtual disk, if the virtual disk is created with Self-Encrypting Drives (SEDs) and is not encrypted. NOTE: Virtual disk must be created with SEDs. You cannot create a mix of non-secure and secure disks on same disk groups. Synopsis racadm raid encryptvd: Example racadm raid encryptvd:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 cryptographicerase Table 111.
PAGE 93
To use this subcommand, you must have the Administrator privilege. Synopsis racadm remoteimage Input Example • • • • • • -c - Connect the image. -d - Disconnect the image. -u - Username to access the network share. -p - Password to access the network share. -l - Image location on the network share; use double quotation marks with a location. -s - Display current status; –a is assumed, if not specified. • racadm remoteimage -c -u "user" -p "pass" -l //shrloc/foo.
PAGE 94
— reseat — Performs a virtual reseat of the server. This operation simulates reseating the server by resetting the iDRAC on a server. NOTE: The action powerstatus is not allowed with an -a option. Output Displays an error message if the requested operation fails, or a success message if the operation is completed.
PAGE 95
NOTE: If CMC is not in the network, you cannot import the chassis configuration profile from a remote network share with proxy using the set command. But, you can import the chassis configuration profile from the local management station.
PAGE 96
• racadm setassettag 783839–33 The asset tag was changed successfully. setchassisname Table 117. Details of setchassisname Description Sets the name of the chassis in the LCD. To use this subcommand, you must have the Administrator privilege. NOTE: The special characters \ (backslash), & (ampersand), ` (back quote), > (greater than), < (less than), and " (double quote) are not supported for this subcommand.
PAGE 97
setflexaddr Table 119. Details of setflexaddr Description Enables or disables FlexAddress on a particular slot or fabric. To use this subcommand, you must have the Chassis Configuration Administrator privilege. If the fabric type is determined to be Infiniband, the operation is canceled and the command returns an error. If the FlexAddress feature is not activated, the command returns an error. NOTE: The server must be turned off to change the slot state.
PAGE 98
— cmc-active — chassis • -l - Specifies whether the LED should blink. can be one of the following: – 0 — no blinking – 1 — blinking Example • racadm setled -m server-1 -1 1 LED state was set successfully. NOTE: The setled command generates an error when used on the extension slot of a multi-slot server. • racadm setled -m server-9 -1 1 ERROR: Server in slot 9 is an extension of the server in slot 1. set enclosure Table 121.
PAGE 99
Input • racadm setniccfg -o • • • • -d — Enables DHCP for the NIC (default is “DHCP disabled”.) -d6 — Enables AutoConfig for the NIC. It is enabled by default. -s — Enables static IP settings. The IPv4 address, netmask, and gateway can be specified. Otherwise, the existing static settings are used. , , and must be typed as dot-separated strings. racadm setniccfg -s 192.168.0.120 255.255.255.0 192.168.0.1 -s6 — Enables static IPv6 settings.
PAGE 100
• Disable ride-through mode racadm setpciecfg ridethru -d IOV000: Successfully completed the operation. • Set the ride-through time out value in seconds (0, 60–1800; 0 = infinite) racadm setpciecfg ridethru -t 300 IOV000: Successfully completed the operation. setractime Table 124. Details of setractime Description Sets the date and time on the CMC. To use this subcommand, you must have the Administrator privilege. Synopsis Input • • • racadm setractime -d
PAGE 101
— mm is the month — dd is the day — hh is the hour — mm is the minute — ss is the second — Setting the time using the -l and -z options is recommended. This command format allows the CMC to fully support local time zones, including the ability to automatically adjust the CMC time to the local Daylight Savings Time. Example The setractime subcommand supports dates ranging from 1/1/1970 00:00:00 through 12/31/2030 23:59:59.
PAGE 102
setsysinfo Table 126. Details of setsysinfo Description Sets the name or location of the chassis. To use this subcommand, you must have the Administrator privilege. NOTE: The special characters \ (backslash), & (ampersand), ` (back quote), > (greater than), < (less than), and " (double quote) are not supported for this subcommand. Synopsis racadm setsysinfo [-c chassisname| chassislocation] Input • • Example — Indicates a maximum of 64 non-extended ASCII chassis name or location.
PAGE 103
For DSA keys greater than 2048, use the following racadm command. CMC accepts RSA keys up to key strength 4096, but the recommended key strength is 1024. racadm -r 192.168.8.14 -u root -p calvin sshpkauth -i svcacct -k 1 -p 0xfff -f dsa_2048.pub Synopsis Input racadm sshpkauth • • • • • • • -i Index for the user. is the Index for CMC. -k index from 1-6 (or all for -v / -d options) to assign the PK key being uploaded. -p privilege level to give to user for this PK key. -t Key text for the PK key.
PAGE 104
Output The sslcertupload command returns 0 when successful, and returns a nonzero number when unsuccessful. Example racadm sslcertupload -t 1 -f c:\cert\cert.txt sslcertview Table 129. Details of sslcertview Description Displays the SSL server or CA certificate that exists on iDRAC. Synopsis racadm sslcertview -t [-A] Input • • -t — Specifies the type of certificate to view, either the CA certificate or server certificate. —1 = server certificate —2 = CA certificate for Directory Service.
PAGE 105
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 131. 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.
PAGE 106
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. For example: racadm config -g cfgRacSecurity -o cfgRacSecCsrCommonName MyCompany NOTE: In telnet/ssh console, you can only generate and not download the CSR file. NOTE: The duration for generating a CSR key depends on the length specified for the key. sslresetcfg Table 132.
PAGE 107
Example • -p—Password for the CIFS share that must be tested. • -l—The CIFS share location that must be tested. racadm testcifsshare -u shareme -p shareme -l //100.97.174.77/lccifs testemail Table 134. Details of testemail Description 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.
PAGE 108
Option Description • ldap — Tests LDAP configuration and operation (requires user name and password). -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.
PAGE 109
-d switch to obtain additional diagnostic information, as needed. This subcommand, when run, performs the following: • • • • • • • • • • 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 110
• 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 Table 140. Details of traceroute Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv4 address.
PAGE 111
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 112
• cfgNetTuning • cfgRacSecurity • cfgQuickDeploy 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 142.
PAGE 113
idRacName (Read Only) Table 145. Details of idRacName Description A user-assigned name to identify this controller. Legal Values A string of up to 15 ASCII characters. Default for CMC CMC 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.
PAGE 114
Default 1 Example racadm config -g cfgLanNetworking -o cfgNicVlanID 1 cfgDNSDomainNameFromDHCP (Read or Write) Table 148. Details of cfgDNSDomainNameFromDHCP Description Legal Values Default Specifies that the DNS domain name should be assigned from the network DHCP server. • • 1 (TRUE) 0 (FALSE) 0 This property is used only if cfgNicUseDhcp is set to 1 (true), or if both cfgIPv6Enable and cfgIPv6AutoConfig are set to 1 (true).
PAGE 115
cfgDNSRacName (Read or Write) Table 150. Details of cfgDNSRacName Description Displays the CMC name, which is rac-service tag by default. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE). Legal Values A string of up to 63 ASCII characters. At least one character must be alphabetic. NOTE: Some DNS servers only register names of 31 characters or fewer. Default cmc- cfgDNSRegisterRac (Read or Write) Table 151.
PAGE 116
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 152.
PAGE 117
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 154. Details of cfgDNSServer2 Description Retrieves the IPv4 address for DNS server 2. This parameter is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE). NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses.
PAGE 118
cfgNicNetmask (Read or Write) Table 157. 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 158. Details of cfgNicGateway Description CMC gateway IPv4 address.
PAGE 119
Use this object with the config or getconfig subcommands. To use this object property, you must have Chassis Configuration Administrator privilege. The following sections provide information about the objects in the cfgRemoteHosts group. cfgRhostsFwUpdateTftpEnable (Read or Write) Table 160. Details of cfgRhostsFwUpdateTftpEnable Description Legal Values Default Enables or disables CMC firmware update from a network TFTP server.
PAGE 120
cfgRhostsSmtpServerIpAddr (Read or Write) Table 163. Details of cfgRhostsSmtpServerIpAddr Description The IPv4 or IPv6 address of the network SMTP server. The SMTP server transmits e-mail alerts from CMC if the alerts are configured and enabled. Legal Values A string representing a valid SMTP server IPv4 or IPv6 address. For example: 192.168.0.55. Default localhost.localdomain icfgRhostsNtpEnable Table 164.
PAGE 121
cfgRhostsNtpServer2 Table 166. Details of 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. Default Null cfgRhostsNtpServer3 Table 167. Details of cfgRhostsNtpServer3 Description Specifies the third of three possible NTP servers. Legal Values A string representing a valid NTP server. For example, ntp3.
PAGE 122
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 cfgRhostsSyslogEnable (Read or Write) Table 170. Details of cfgRhostsSyslogEnable Description Legal Values Default Enables or disables remote syslog to allow the RAC and SEL logs to be written to up to three remote syslog servers.
PAGE 123
cfgRhostsSyslogServer3 (Read or Write) Table 173. Details of cfgRhostsSyslogServer3 Description Specifies the third of three possible remote syslog servers to store the RAC and SEL logs. This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values Valid hostname or IPv4 or IPv6 address. Default cfgRhostsSyslogPowerLoggingEnabled Table 174.
PAGE 124
cfgRhostsSyslogEnable=0 cfgRhostsSyslogPort=514 cfgRhostsSyslogServer1= cfgRhostsSyslogServer2= cfgRhostsSyslogServer3=cfgRhostsSyslogPowerLoggingEnabled=1 cfgRhostsSyslogPowerLoggingInterval=5 cfgUserAdmin This group provides configuration information about the users who are allowed to access CMC through the available remote interfaces. Up to 16 instances of the user group are allowed. Each instance represents the configuration for an individual user.
PAGE 125
Example racadm getconfig -g cfgUserAdmin -i 1 # cfgUserAdminIndex=1 cfgUserAdminUserName=root # cfgUserAdminPassword=******** (Write-Only) cfgUserAdminEnable=1 cfgUserAdminPrivilege=0x00000fff cfgUserAdminSNMPv3Enable=0 cfgUserAdminSNMPv3AuthenticationType=SHA cfgUserAdminSNMPv3PrivacyType=AES Table 178.
PAGE 126
iDRAC Specific User Privilege Privilege Bit Mask Fabric C Administrator 0x0000800 Table 179. 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. 0x00000001 The user may log in to CMC and change configuration. 0x00000001 + 0x00000002 = 0x00000003 The user may log in, access Virtual Media, and Virtual Console.
PAGE 127
cfgUserAdminEnable (Read or Write) Table 182. 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 • • 1 (TRUE) 0 (FALSE) 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 128
Default 0 cfgEmailAlertAddress (Read/Write) Table 185. Details of cfgEmailAlertAddress Description Specifies the destination email address for email alerts, for example, user1@company.com. Legal Values E-mail address format, with a maximum length of 64 ASCII characters. Default cfgEmailAlertEmailName Table 186. Details of cfgEmailAlertEmailName Description Specifies name or other identifier associated with the destination email address.
PAGE 129
cfgSsnMgtRacadmTimeout (Read/Write) Table 187. Details of cfgSsnMgtRacadmTimeout Description Defines the idle timeout in seconds for the Remote RACADM interface. If a remote RACADM session remains inactive for more than the specified timeout, the session is automatically ended.
PAGE 130
cfgSerialBaudRate (Read/Write) Table 189. Details of cfgSerialBaudRate Description Sets the baud rate on the serial port. Legal Values 2400, 4800, 9600, 19200, 28800, 38400, 57600,115200 Default 115200 cfgSerialConsoleEnable (Read/Write) Table 190. Details of cfgSerialConsoleEnable Description Legal Values Default Enables or disables the RAC or CMC serial console interface. • • 1 (TRUE) 0 (FALSE) 1 cfgSerialConsoleIdleTimeout (Read/Write) Table 191.
PAGE 131
Default 0 cfgSerialConsoleCommand (Read/Write) Table 193. Details of cfgSerialConsoleCommand 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 Table 194. Details of cfgSerialConsoleColumns Description Specifies the number of columns in the terminal window command line connected to the serial port.
PAGE 132
cfgSerialSshEnable (Read/Write) Table 196. Details of cfgSerialSshEnable Description Legal Values Default Enables or disables the secure shell (SSH) interface on CMC. • • 1 (TRUE) 0 (FALSE) 1 Example racadm getconfig -g cfgSerial cfgSerialBaudRate=115200 cfgSerialConsoleEnable=1 cfgSerialConsoleQuitKey=^\ cfgSerialConsoleIdleTimeout=1800 cfgSerialConsoleNoAuth=0 cfgSerialConsoleCommand= cfgSerialConsoleColumns=0 cfgSerialHistorySize=8192 cfgSerialTelnetEnable=0 cfgSerialSshEnable=1 cfgSerialTelnetEnab
PAGE 133
cfgOobSnmpAgentCommunity (Read/Write) Table 198. 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.
PAGE 134
cfgOobSnmpTrapFormat Table 201. Details of cfgOobSnmpTrapFormat attribute 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. To use this object property, you must have Chassis Configuration Administrator privilege.
PAGE 135
cfgTrapsAlertDestIpAddr Table 204. Details of cfgTrapsAlertDestIpAddr Description Sets the IP address that receives the alert. Legal Values A string representing a valid IP address. For example, 192.168.0.20. Default None cfgTrapsCommunityName Table 205. Details of cfgTrapsCommunityName Description Sets the community string (identical to the community name) used for authentication. The community string acts as a password shared between different hosts over the network.
PAGE 136
cfgRacTuning This group is used to configure various iDRAC or CMC configuration properties, such as valid ports and security port restrictions. 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. To modify a configurable object, use the -o option. Use the -m option to apply this setting to iDRAC.
PAGE 137
cfgRacTuneRemoteRacadmEnable (Read/Write) Table 210. Details of cfgRacTuneRemoteRacadmEnable Description Legal Values Default Enables or disables the Remote RACADM interface. • • 1 (TRUE) 0 (FALSE) 1 cfgRacTuneHttpPort (Read/Write) Table 211. Details of cfgRacTuneHttpPort Description Specifies the port number to use for HTTP network communication.
PAGE 138
cfgRacTuneIpRangeEnable (Read/Write) Table 213. Details of cfgRacTuneIpRangeEnable Description Legal Values Default Enables or disables the IPv4 Address Range validation feature. • • 1 (TRUE) 0 (FALSE) 0 cfgRacTuneIpRangeAddr (Read/Write) Table 214. Details of cfgRacTuneIpRangeAddr Description Specifies the acceptable IPv4 address bit pattern in positions determined by the 1s in the range mask property (cfgRacTuneIpRangeMask).
PAGE 139
cfgRacTuneIpBlkEnable (Read/Write) Table 216. Details of cfgRacTuneIpBlkEnable Description Legal Values Default Enables or disables the IPv4 address blocking feature. • • 1 (TRUE) 0 (FALSE) 0 cfgRacTuneIpBlkFailCount (Read/Write) Table 217. 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.
PAGE 140
Default 300 cfgRacTuneSshPort (Read/Write) Table 220. Details of cfgRacTuneSshPort Description Specifies the port number used for the SSH interface. Legal Values 10–65535 Default 22 cfgRacTuneTelnetPort (Read/Write) Table 221. 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.
PAGE 141
cfgRacTuneTimezoneOffset (Read Only) Table 223. Details of cfgRacTuneTimezoneOffset 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.
PAGE 142
cfgRacTuneTLSProtocolVersionEnable Table 226. Details of cfgRacTuneTLSProtocolVersionEnable attribute Description Sets the minimum TLS protocol version. Legal Values • • • Default 1 0 - TLSv1.0, TLSv1.1, and TLSv1.2 are enabled. 1 - TLSv1.1 and TLSv1.2 are enabled. 2 - only TLSv1.2 is enabled. cfgRacTuneChassisNameInPromptEnable Table 227. Details of cfgRacTuneChassisNameInPromptEnable attribute Description Enables or disables display of the chassis name in the SSH prompt.
PAGE 143
cfgServerInfoIndex (Read Only) Table 228. Details of cfgServerInfoIndex Description Displays the index name of the server. Legal Values None Default None cfgServerSlotNumber (Read Only) Table 229. 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 230. Details of cfgServerServiceTag Description Displays the service tag of the specified server.
PAGE 144
cfgServerFW (Read Only) Table 232. Details of cfgServerFW Description Displays the server's iDRAC management firmware revision. Legal Values None Default None cfgServerBIOS (Read Only) Table 233. Details of cfgServerBIOS Description Displays the server's BIOS revision. Legal Values None Default None cfgServerBmcMacAddress (Read Only) Table 234. Details of cfgServerBmcMacAddress Description Displays the BMC MAC address of the specified server.
PAGE 145
cfgServerNic2MacAddress (Read Only) Table 236. Details of cfgServerNic2MacAddress Description Displays the MAC address of the server NIC 2. Legal Values None Default None cfgServerNic3MacAddress (Read Only) Table 237. Details of cfgServerNic3MacAddress Description Displays the MAC address of the server NIC 3. Legal Values None Default None cfgServerNic4MacAddress (Read Only) Table 238. Details of cfgServerNic4MacAddress Description Displays the MAC address of the server NIC 4.
PAGE 146
cfgServerNicEnable (Read/Write) Table 240. Details of cfgServerNicEnable Description Legal Values Default Enables or disables LAN channel. • • 1 (Enable) 0 (Disable) None cfgServerIPMIOverLanEnable (Read/Write) Table 241. Details of cfgServerIPMIOverLanEnable Description Legal Values Default Enables or disables IPMI LAN channel. • • 1 (enable) 0 (disable) None cfgServerPowerBudgetAllocation (Read Only) Table 242.
PAGE 147
Default None cfgServerDNSIMCName (Read/Write) Table 244. 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 245. Details of cfgServerRootPassword Description Displays the password for iDRAC as a series of asterisks (*). It cannot be seen or displayed after this property is written.
PAGE 148
• Default 60–VFLASH partition label 0 (zero) cfgServerBootOnce (Read/Write) Table 247. Details of cfgServerBootOnce Description Enables or disables the server boot once feature. This object is read-write. Legal Values Default • • 1 = TRUE 0 = FALSE 0 cfgServerPowerConsumption (Read Only) Table 248. Details of cfgServerPowerConsumption Description Displays the current power consumption for a server.
PAGE 149
cfgServerPriority=1 cfgServerNicEnable=1 cfgServerIPMIOverLANEnable=1 # cfgServerPowerBudgetAllocation=0 cfgServerDNSRegisterIMC=0 cfgServerDNSIMCName=iDRACcfgServerRootPassword=******** (Write-Only) cfgServerFirstBootDevice=0 # cfgServerBootOnce=1 # cfgServerPowerConsumption=0 racadm getconfig -g cfgServerInfo -i 1 # cfgServerInfoIndex=1 # cfgServerSlotNumber=1 # cfgServerServiceTag=1S0M0G1 cfgServerName=SLOT-01 # cfgServerFW=1.40 (Build 12) # cfgServerBIOS=4.0.
PAGE 150
cfgActiveDirectory This group contains parameters to configure the Active Directory feature. 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. The following sections provide information about the objects in the cfgActiveDirectory group.
PAGE 151
cfgADRootDomain (Read/Write) Table 252. Details of cfgADRootDomain 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) Table 253. Details of cfgADEnable Description Enables or disables Active Directory user authentication on CMC. If this property is disabled, LDAP authentication may be used for user login.
PAGE 152
cfgADSCLEnable Table 255. Details of cfgADSCLEnable Description Legal Values Default Enables you to log on to the CMC without enabling the Smart Card login. • • 1 (Enable) 0 (Disable) 0 cfgADSSOEnable (Read/Write) Table 256. Details of cfgADSSOEnable Description Legal Values Default Enables or disables Active Directory single sign-on authentication on CMC. • • 1 (TRUE) 0 (FALSE) 0 cfgADDomainController1 (Read/Write) Table 257.
PAGE 153
cfgADDomainController2 (Read/Write) Table 258. Details of cfgADDomainController2 Description Specifies the LDAP server from which you want the CMC to obtain user names . Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default None cfgADDomainController3 (Read/Write) Table 259. Details of cfgADDomainController3 Description Specifies the LDAP server from which you want the CMC to obtain user names .
PAGE 154
Default None cfgADGlobalCatalog3 (Read/Write) Table 262. Details of cfgADGlobalCatalog3 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) Table 263. Details of cfgADType Description Determines the schema type to use with Active Directory.
PAGE 155
cfgADDcSRVLookupDomainName (Read/Write) Table 265. Details of cfgADDcSRVLookupDomainName Description This is the Active Directory Domain to use when cfgAddcSrvLookupbyUserDomain is set to 0. Legal Values String. Maximum length = 254 Default Null cfgADDcSRVLookupEnable (Read/Write) Table 266. Details of cfgADDcSRVLookupEnable Description Legal Values Default Configures CMC to use pre‑configured domain controllers or to use DNS to find the domain controller.
PAGE 156
cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and cfgAdGlobalCatalog3. Legal Values Default • • 0(FALSE)—use pre‑configured Global Catalog Servers (GCS) 1(TRUE)—use DNS to look up GCS 0 cfgADSpecifyServerEnable Table 269. Details of cfgADSpecifyServerEnable Description Legal Values Default Allows you to enable or disable and specify an LDAP server or a global catalog server. Use cfgADDomainController or cfgADGlobalCatalog to specify the IP address.
PAGE 157
cfgLDAPServer (Read/Write) Table 271. Details of cfgLDAPServer Description Configures the address of the LDAP Server. IPv4 and IPv6 are supported. NOTE: You can specify multiple servers by separating each server with a comma. For example, example.com, sub1.example.com Legal Values String. Maximum length = 254 Default Null cfgLDAPPort (Read/Write) Table 272. Details of cfgLDAPPort Description Port of LDAP over SSL. Non-SSL port is not supported.
PAGE 158
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 275. Details of cfgLDAPGroupAttribute Description Specifies which LDAP attribute is used to check for group membership. This should be an attribute of the group class. If not specified, then CMC uses the member and unique member attributes.
PAGE 159
Default Null cfgLDAPBindpassword (Write Only) Table 278. 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 279. Details of cfgLDAPSearchFilter Description A valid LDAP search filter.
PAGE 160
cfgLDAPNetworkTimeout Table 281. Details of cfgLDAPNetworkTimeout Description Configures the network timeout in seconds. Legal Values Positive integer Default 30 seconds cfgLDAPSearchTimeout Table 282. Details of cfgLDAPSearchTimeout Description Configures the search timeout in seconds. Legal Values Positive integer Default 120 seconds cfgLDAPSRVLookupDomainName Table 283. Details of cfgLDAPSRVLookupDomainName Description Configures the domain name to be used in the SRV lookup.
PAGE 161
cfgLDAPSRVLookupServiceName (Read/Write) Table 285. Details of cfgLDAPSRVLookupServiceName 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.
PAGE 162
cfgLDAPRoleGroupPrivilege (Read/Write) Table 287. Details of cfgLDAPRoleGroupPrivilege Description A bit–mask defining the privileges associated with this particular group. Legal Values 0x00000000 to 0x000001ff Default 0x000 Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupPrivilege -i 1 0x0 cfgLocation This group defines objects that support physical location properties. Use this object with the getconfig or config subcommands.
PAGE 163
cfgLocationRack (Read/Write) Table 290. 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 291. Details of cfgLocationRackslot Description Indicates the slot where a server is located. Legal Values Values from 1 - 255 (1 Byte) Default 0 cfgLocationDevicesize (Read Only) Table 292. Details of cfgLocationDevicesize Description Indicates server chassis size.
PAGE 164
cfgSSADRoleGroupIndex (Read Only) Table 293. 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 294. 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.
PAGE 165
Example racadm getconfig -g cfgStandardSchema -i 1 NOTE: -i is for the index. # cfgSSADRoleGroupIndex=1 cfgSSADRoleGroupName= cfgSSADRoleGroupDomain= cfgSSADRoleGroupPrivilege= $ config -g cfgStandardSchema -i 1 -o cfgSSADRoleGroupName Charlie Object value modified successfully Table 297.
PAGE 166
cfgChassisInPower (Read Only) Table 298. Details of cfgChassisInPower Description Indicates the cumulative input power consumption data (in Watt and BTU/hr) captured from all healthy and functional PSUs in the chassis. Legal Values None Default None cfgChassisPeakPower (Read Only) Table 299. Details of cfgChassisPeakPower Description Indicates the maximum system input power consumption (in Watt). Legal Values Default cfgChassisPeakPowerTimestamp (Read Only) Table 300.
PAGE 167
cfgChassisMinPowerTimestamp (Read Only) Table 302. Details of cfgChassisMinPowerTimestamp Description The timestamp recorded when the minimum system power occurred. Legal Values None Default None cfgChassisPowerStatus (Read Only) Table 303. Details of cfgChassisPowerStatus Description Legal Values Default Indicates the power status of the chassis. • • • • • • 1 (other) 2 (unknown) 3 (OK) 4 (non-critical) 5 (critical) 6 (non-recoverable) None cfgChassisRedundantState (Read Only) Table 304.
PAGE 168
cfgChassisDefaultPowerCapUpperBound (Read Only) Table 305. Details of cfgChassisDefaultPowerCapUpperBound 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) Table 306. Details of cfgChassisDefaultPowerCapUpperBoundBTU Description Indicates the maximum default value to which you can set the power cap of a chassis.
PAGE 169
cfgChassisPowerCap (Read/Write) Table 309. 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 310.
PAGE 170
cfgChassisPowerCapPercent (Read or Write) Table 312. Details of cfgChassisPowerCapPercent Description Indicates the power consumption limit as a percentage. The percentage is computed mathematically as the minimum power + (percent * (maximum power - minimum power)). The command generates an error if server throttling is necessary to achieve the power goal based on the value for this setting.
PAGE 171
cfgChassisDynamicPSUEngagementEnable (Read/Write) Table 315. Details of cfgChassisDynamicPSUEngagementEnable Description Enables or disables dynamic engagement. Legal Values • • Default 0 (disabled) 1 (enabled) 0 (disabled) cfgChassisInMaxPowerCapacity (Read Only) Table 316. 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 317.
PAGE 172
cfgChassisInfrastructureInPowerAllocation (Read Only) Table 319. Details of cfgChassisInfrastructureInPowerAllocation Description Indicates the estimated cumulative DC output power consumption (in watts), determined from a field replaceable unit (FRU) on the hardware modules in the chassis. Legal Values None Default None cfgChassisTotalInPowerAvailable (Read Only) Table 320.
PAGE 173
cfgChassisPowerClearTimestamp (Read Only) Table 323. Details of cfgChassisPowerClearTimestamp Description Time stamp when cfgChassisMinPower and cfgChassisMaxPowerCapacity were reset. Legal Values None Default None cfgChassisPowerButtonEnable (Read/Write) Table 324. Details of cfgChassisPowerButtonEnable Description Indicates if the chassis power button is enabled or disabled. Legal Values • • Default 0 (disabled) 1 (enabled) None cfgSystemEnergyConsumptionClear (Write Only) Table 325.
PAGE 174
# cfgChassisInPowerServerAllocation=0 W # cfgChassisInfrastructureInPowerAllocation=51 W # cfgChassisTotalInPowerAvailable=0 W # cfgChassisStandbyInPowerCapacity=0 W # cfgChassisPowerClear=******** (Write-Only) # cfgChassisPowerClearTimestamp=18:00:00 12/31/1969 cfgChassisServerBasedPowerMgmtMode=0 cfgChassisPowerButtonEnable=1 cfgChassisAllow110VACOperation=0 cfgChassisMaxPowerConservationMode=0 cfgChassisPerformanceOverRedundancy=1 # cfgSystemEnergyConsumptionClear = ****(Write-Only) cfgChassisServerBased
PAGE 175
Default 0 cfgKVMInfo This group is used to view the mapping information for the KVM. Use this object with the config or getconfig subcommands. To use this object property, you must have Chassis Configuration Administrator privilege. cfgKvmMapping (Read/Write) Table 329. Details of cfgKvmMapping Description Maps the slots to the KVM. Legal Values 1, 2, 3, and 4 are the slot numbers that are specified. Default 1 cfgKvmSlotEnable (Read/Write) Table 330.
PAGE 176
cfgDvdMapping (Read/Write) Table 331. 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 332. 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.
PAGE 177
cfgAlertingEnable Table 333. Details of cfgAlertingEnable Description Legal Values Default Enables or disables event traps on the CMC. • • 1 (true) 0 (false) None To use this object property, you must have the Chassis Configuration Administrator privilege. cfgAlertingSourceEmailName Table 334. Details of cfgAlertingSourceEmailName Description Specifies the e-mail address used to send e-mail notifications when an event occurs.
PAGE 178
cfgIPv6Enable (Read/Write) Table 335. Details of cfgIPv6Enable Description Enables or disables the IPv6 stack. Legal Values • • Default 1 (TRUE) 0 (FALSE) 0 cfgIPv6AutoConfig (Read/Write) Table 336. Details of cfgIPv6AutoConfig Description Enables or disables the IPv6 Auto Configuration option. NOTE: If this value is set to 0, the CMC disables auto configuration and statically assigns IPv6 addresses.
PAGE 179
cfgIPv6PrefixLength (Read/Write) Table 338. Details of cfgIPv6PrefixLength Description Specifies the prefix length for IPv6 address. NOTE: This property is used only if cfgIPv6AutoConfig is set to 0 (false) Legal Values 0–128 Default 64 cfgIPv6Gateway (Read/Write) Table 339. Details of cfgIPv6Gateway Description CMC gateway IPv6 address. NOTE: This property is used only if cfgIPv6AutoConfig is set to 0 (false.) Legal Values Specifies string representing a valid IPv6 entry.
PAGE 180
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) Table 342. Details of cfgIPv6DNSServer2 Description Specifies the IPv6 DNS server address. NOTE: This property is only valid if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). Legal Values A string representing a valid IPv6 entry.
PAGE 181
Synopsis racadm getconfig -g cfgCurrentLanNetworking cfgNicCurrentIPv4Enabled Table 343. Details of 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 None Default None Example racadm getconfig -g cfgCurrentLanNetworking # cfgNicCurrentIPv4Enabled=1 # cfgNicCurrentIpAddress=143.166.152.116 # cfgNicCurrentNetmask=255.255.255.
PAGE 182
cfgNicCurrentGateway Table 346. Details of cfgNicCurrentGateway Description Displays the static gateway for the CMC IP address. Legal Values None Default None cfgNicCurrentDhcpWasUsed Table 347. Details of 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) Table 348.
PAGE 183
cfgNicCurrentVlanPriority (Read Only) Table 350. Details of cfgNicCurrentVlanPriority (Read Only) Description Indicates the Current Virtual Lan Priority. Legal Values Integer Default None cfgDNSCurrentServer1 Table 351. Details of cfgDNSCurrentServer1 Description Displays the IP address for DNS server 1. Legal Values A Valid IPv4 DNS IP Default None cfgDNSCurrentServer2 Table 352. Details of cfgDNSCurrentServer2 Description Displays the IP address for DNS server 2.
PAGE 184
Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. cfgCurrentIPv6Enabled Table 354. Details of cfgCurrentIPv6Enabled Description Indicates whether IPv6 is enabled on the CMC. If the current property value is set to 0 (false), the remote network interfaces to the CMC are not accessible over IPv6. Legal Values None Default None cfgCurrentIPv6AutoConfigWasUsed Table 355.
PAGE 185
cfgCurrentIPv6Address Table 357. 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 358. Details of cfgCurrentIPv6Gateway Description Displays the current IPv6 gateway. Legal Values None Default None cfgCurrentIPv6DNSServersFromDHCP6 Table 359.
PAGE 186
cfgCurrentIPv6DNSServer2 Table 361. Details of cfgCurrentIPv6DNSServer2 Description Displays the IPv6 address for DNS server 2.
PAGE 187
cfgNetTuningNicFullDuplex (Read/Write) Table 363. Details of cfgNetTuningNicFullDuplex Description Legal Values Default Specifies the duplex setting for the RAC or CMC NIC. This property is used only if the cfgNetTuningNicAutoNeg is set to 0 (disabled). • • 0 (Half Duplex) 1 (Full Duplex) 1 cfgNetTuningNicMtu (Read/Write) Table 364. Details of cfgNetTuningNicMtu Description The size in bytes of the maximum transmission unit used by CMC NIC.
PAGE 188
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. To use this object property, you must have Chassis Configuration Administrator privilege. For more information on generating certificate signing requests, see the subcommand "sslcsrgen.
PAGE 189
cfgRacSecCsrLocalityName (Read/Write) Table 369. Details of cfgRacSecCsrLocalityName Description Specifies the CSR Locality (L). Legal Values A string of up to 128 characters. Default cfgRacSecCsrStateName (Read/Write) Table 370. Details of cfgRacSecCsrStateName Description Specifies the CSR State Name (S). Legal Values A string of up to 128 characters. Default cfgRacSecCsrCountryCode (Read/Write) Table 371.
PAGE 190
cfgRacSecOrganizationName=OrgName cfgRacSecOrganizationUnit=OrgUnit cfgRacSecLocalityName=LocalityName cfgRacSecStateName=StateName cfgRacSecCountryCode=US cfgRacSecEmailAddr=Name@domain.com cfgRacSecCsrKeySize (Read/Write) Table 373. Details of cfgRacSecCsrKeySize Description Specifies the SSL asymmetric key size for the CSRs. Legal Values 1024, 2048, and 4096 Default 2048 cfgQuickDeploy This group is used to configure IDRAC deployment settings.
PAGE 191
cfgiDRACRootPassword Table 376. Details of cfgiDRACRootPassword attribute Description The root password is applied when servers are inserted into the chassis. Legal Values Up to 64 characters. Default calvin cfgEnableiDRACLAN Table 377. Details of cfgEnableiDRACLAN attribute Description Enables the LAN channel for iDRAC when servers are inserted into the chassis. Legal Values • 0 — Disable • 1 — Enable Default 1 cfgEnableiDRACIPv4 Table 378.
PAGE 192
0 Default cfgEnableiDRACIPv4DHCP Table 380. Details of cfgEnableiDRACIPv4DHCP attribute Description Enables DHCP for iDRAC when servers are inserted into the chassis. Legal Values • 0 — Disable • 1 — Enable 1 Default cfgStartingiDRACIPv4Address Table 381. Details of cfgStartingiDRACIPv4Address attribute Description The static IPv4 address for the iDRAC located in the first slot. Legal Values IP format Default 192.168.0.121 cfgiDRACIPv4GateWay Table 382.
PAGE 193
cfgEnableiDRACIPv6 Table 384. Details cfgEnableiDRACIPv6 attribute Enables IPv6 for each IPv6-capable iDRAC present in the chassis. Description Legal Values • 0 — Disable • 1 — Enable 0 Default cfgEnableiDRACIPv6AutoConfig Table 385. 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.
PAGE 194
:: Default cfgReservedIPAddressNumbers Table 388. Details of cfgReservedIPAddressNumbers attribute The number of static IPv4 addresses reserved for iDRACs in the chassis. Description Legal Values 32 Default 32 cfgUseCMCDNSSettings Table 389. 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 — False • 1 — True 0 cfgServerDNSIMCNameEnable Table 390.
PAGE 195
NOTE: You can set the cfgServerDNSIMCNamePrefix only if the cfgServerDNSIMCNameEnable is set to 1. Else, an error message is displayed. NOTE: The maximum length of the cfgServerDNSIMCNamePrefix is 59 characters. The hyphen (–) is the only special character allowed for setting the prefix.