Reference Guide

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

Chassis Management Controller Version 2.2 for Dell

PowerEdge VRTX RACADM Command Line Reference

Guide

Summary of content (167 pages)

PAGE 1
Chassis Management Controller Version 2.
PAGE 2
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Copyright © 2017 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
PAGE 3
Contents 1 Introduction....................................................................................................................12 What’s New in This Release.............................................................................................................................................. 12 Supported RACADM Interfaces........................................................................................................................................ 12 RACADM Syntax Usage............
PAGE 4
getmodinfo.......................................................................................................................................................................45 getniccfg.......................................................................................................................................................................... 47 getpbinfo............................................................................................................................................
PAGE 5
init.............................................................................................................................................................................. 82 raid............................................................................................................................................................................. 83 rebuild..............................................................................................................................................
PAGE 6
cfgNicIPv4Enable (Read or Write)............................................................................................................................ 106 cfgNicVLanId (Read or Write)................................................................................................................................... 107 cfgDNSDomainNameFromDHCP (Read/Write)........................................................................................................ 107 cfgDNSDomainName (Read/Write)............
PAGE 7
cfgSerial.......................................................................................................................................................................... 119 cfgSerialBaudRate (Read/Write)............................................................................................................................... 119 cfgSerialConsoleEnable (Read/Write).......................................................................................................................
PAGE 8
cfgServerName (Read/Write).................................................................................................................................. 129 cfgServerFW (Read Only)........................................................................................................................................ 129 cfgServerBIOS (Read Only)......................................................................................................................................
PAGE 9
cfgLDAPUserAttribute (Read/Write)........................................................................................................................ 139 cfgLDAPGroupAttribute (Read/Write)......................................................................................................................139 cfgLDAPGroupAttributeIsDN (Read/Write).............................................................................................................. 140 cfgLDAPBinddn (Read/Write)...................
PAGE 10
cfgChassisInMaxPowerCapacity (Read Only)........................................................................................................... 149 cfgChassisInRedundancyReserve (Read Only)......................................................................................................... 149 cfgChassisInPowerServerAllocation (Read Only)......................................................................................................150 cfgChassisInfrastructureInPowerAllocation (Read Only).....
PAGE 11
cfgCurrentIPv6Enabled.............................................................................................................................................159 cfgCurrentIPv6AutoConfigWasUsed.........................................................................................................................159 cfgCurrentLinkLocalAddress..................................................................................................................................... 160 cfgCurrentIPv6Address.....
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. What’s New in This Release • Added the cfgQuickDeploy group. • Added the cfgTrapsSNMPv3UserId and cfgTrapsSNMPv3UserName to the cfgTraps group. • Added the cfgUserAdminSNMPv3Enable, cfgUserAdminSNMPv3AuthenticationType, and cfgUserAdminSNMPv3PrivacyType to the cfgUserAdmin group.
PAGE 13
SSH or Telnet RACADM racadm getconfig -g [-o ] [-i ] racadm 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 tabl
PAGE 14
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 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 ping6 Yes Yes racdump Yes Yes racreset Yes Yes racresetpcie Yes Yes racresetcf
PAGE 16
Subcommand CMC 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. • The VRTX CMC Online Help provides information about using the Web interface.
PAGE 17
system and the system setup placemat that shipped with your system. Download the QRL application from your mobile platform to enable the application on your mobile device. Updates are sometimes included with the system to describe changes to the system, software, and/or documentation. Always read the updates first, because they often supersede information in other documents.
PAGE 18
2 RACADM Subcommand Details This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
PAGE 19
• A single quotation mark cannot be used even with a backslash escaped. NOTE: An empty string may be specified as either "" (using double quotation marks) or '' (using single quotation mark). "?"and "?" 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.
PAGE 20
-c -A -4 -6 : : : : show chassis information do not show headers or labels show CMC IPv4 information show CMC IPv6 information help and help Table 5. Help commands Description Lists all the subcommands available for use with RACADM and provides a short description for each. You may also type a subcommand after help. Synopsis • racadm help • racadm help Input None Output • Example racadm help getsysinfo The help command displays a complete list of subcommands.
PAGE 21
• -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 22
– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – 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 23
• 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 24
• 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 racadm chassisaction [-m ] Input • -m — Module on which you want to carry out the action.
PAGE 25
Input • • • -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. racadm closessn –a Closes all the sessions.
PAGE 26
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 27
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 28
• -u root — Indicates that the is supplied for the root user on the server. root is a constant parameter, the only value that is valid with the ‑u option. • -m — Specifies the server you want to configure. Legal value must be one of the following values: – server- where n=1 to 4 – switch- where n=1 -p — Specifies the password for the root user on the server.
PAGE 29
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].[severity] where, category is mandatory, but subcategory and severity are optional. A severity cannot precede a subcategory.
PAGE 30
• Display eventfilter configurations for a specific severity and subcategory. For example, a severity of warning in the subcategory licensing under audit category: racadm eventfilters get -c cmc.alert.audit.lic.warning • Clear all available alert settings: racadm eventfilters set -c cmc.alert.all -n none • Configure using severity as a parameter.
PAGE 31
NOTE: To deactivate FlexAddress features, the chassis must be turned off. Synopsis Input • racadm feature -s • racadm feature -d -c • racadm feature -r -c ExtendedStorage • -s — Displays the status of active features. • -d — Deactivates the feature specified in -c option. NOTE: When the FlexAddress and FlexAddressPlus features are active, deactivating one of them results in deactivation of the other feature also.
PAGE 32
fwupdate Description Allows you to update the firmware on the active and standby CMC firmware, chassis infrastructure firmware, and storage component firmware (RAID controller, hard disk drive, and expander). You can: • • • • Check the firmware update process status. Update the firmware from a FTP or a TFTP server by providing an IP address and optional path. Update the firmware from the local file system using remote RACADM. The subcommand updates one or more devices of a single type at a time.
PAGE 33
• • • NOTE: CMC accepts IPv4, IPv6, or fully qualified domain names (FQDN) for both FTP and TFTP servers. -d — Specifies the source path where the firmware image is stored. NOTE: The default source path is local Default: Designated TFTP default directory on that host for the file if -g option is absent. If -g is used, it defaults to a directory configured on the TFTP server. -o — Turns off the servers to perform an update. -m — Specifies the module or device to be updated.
PAGE 34
get Description Saves CMC configuration properties or CMC Event Filter configurations to a file. NOTE: • Synopsis If CMC is not in the network, you can only export the chassis configuration profile to the local management station.
PAGE 35
switch-n, where n = 1 cmc-n, where n = 1, 2 fan-n, where n = 1 to 6 ps-n, where n = 1 to 4 chassis kvm Output Display entire log: racadm getactiveerrors - Display specific module log: racadm getactiveerrors -m server-1 - Display entire informational log: racadm getactiveerrors -s info getassettag Description Displays the asset tag for the chassis. To use this subcommand, you must have the CMC Login User privilege.
PAGE 36
getconfig Description Retrieves CMC configuration parameters individually, or all CMC configuration groups may be retrieved and saved to a file. Synopsis racadm getconfig -f racadm getconfig -g [-i ] racadm getconfig -u racadm getconfig -h racadm getconfig -g -o [-i index] Input • • • • • • • Output -f — The -f option directs getconfig to write the entire iDRAC configuration to a configuration file.
PAGE 37
• 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 If you do not configure the following key attributes in their respective groups for a particular index, the groups are not saved in to the file.
PAGE 38
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 getdcinfo -n server-1 Present None None server-2 Not Present None None server-3 Not Present None None server-4 Present None Broadcom M5708t getflexaddr Description Enabled or disabled status is
PAGE 39
1 Enabled Present 2 Enabled Present 3 Enabled Not Present 4 Enabled Not Present Displays the current FlexAddress setting for slot 4 racadm getflexaddr -i 4 Slot-4 server presence = Present Slot-4 flexaddress enabled = 1 slot4-idrac Controller 18:A9:9B:FD:C7:57 F8:DB:88:3D: 9F:A7(active) slot4-A 10 GbE KR 00:90:FA:51:36:54 F8:DB:88:3D: 9F:A8(active) 10 GbE KR/3 00:90:FA:51:36:55 F8:DB:88:3D: 9F:
PAGE 40
switch-1 ON R1-PT VRTX 1Gb Master Passthrough N/A Gigabit Ethernet Present OK getled Description Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots). To use this subcommand, you must have the Login User privilege. Synopsis racadm getled -m Input CMC only options: -m — Specifies the module whose LED settings you want to view.
PAGE 41
Input • racadm getmacaddress [-m [-x]] [-t iscsi] • racadm getmacaddress -a • racadm getmacaddress -c IO-Identity • racadm getmacaddress -c Flexaddress • racadm getmacaddress -c Factory • racadm getmacaddress -c all • -m — Specifies the module whose MAC address you want to view. may be one of the following: server-n, where n=1–4 switch-n, where n=1 • • • • -t — Displays the iSCSI MAC addresses for all servers or the specified server if used with -m option.
PAGE 42
CMC Present N/A F0:4D:A2:77:71:72 N/A Displays the MAC address for switch-1 racadm getmacaddress -m switch-1 Switch-1 Present Not Installed 00:00:00:00:00:00 Not Installed Display MAC for server-1.
PAGE 43
CMC N/A Present N/A 00:1E:4F:1F: 3C:58 N/A Server-1-A Gigabit Ethernet Present 00:1E:4F: 2A:AF:7B 00:1E:4F: 2A:D3:97 00:1E:4F: 2A:D3:99 iSCSI Present 00:1E:4F: 2A:D3:98 00:1E:4F: 2A:D3:9A Gigabit Ethernet Present Not Installed Not Installed iSCSI Present Not Installed Not Installed Server-1-C Fibre Channel 4 Present Not Installed Not Installed Server-2-A Gigabit Ethernet Present 00:22:19:D2
PAGE 44
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 Displays the MAC/WWN addresses for all LOMs or mezzanine cards.
PAGE 45
Server-1-A IDRACController Present 18:A9:9B:FD:C4:DF N/A Factory Gigabit Ethernet Present 00:0A:00:0A:00:00 Unknown IO-Identity Gigabit Ethernet Present 84:8F:69:FC:E8:F1 Unknown Factory Present F8:DB:88:3D:A2:7A Unknown FlexAddress Unknown FlexAddress Server-3-A Server-4-A 10 GbE KR/3 FCoE-WWN Present 20:01:F8:DB: 88:3D:A2:7A getmodinfo Table 16.
PAGE 46
NOTE: A power state of "Primary" denotes Active CMC.
PAGE 47
A N/A Server-3 OFF DJ22H82 Server-4 A N/A DVD ON A IO-Cable ON 3BPV622 FPC-Cable ON 3BPV622 N/A N/A Present OK DJ22H82 Not Present N/A N/A Present OK N/A Present OK N/A Present OK N/A N/ N/ getniccfg Table 17. getniccfg Description Displays the current NIC settings.
PAGE 48
VLAN ID VLAN priority = 1 = 0 racadm getniccfg -m server-3 LOM Model Name = BRCM GbE 4P 5720 bNDC LOM Fabric Type = Gigabit Ethernet IPv4 Enabled = 1 DHCP Enabled = 0 IP Address = 0.0.0.0 Subnet Mask = 0.0.0.0 Gateway = 0.0.0.0 IPv6 Enabled = 0 Autoconfiguration Enabled = 1 Link local Address = IPv6 Gateway = :: VLAN Enable = 0 VLAN ID = 1 VLAN priority = 0 racadm getniccfg -m switch-1 DHCP Enabled = 0 IP Address = 0.0.0.0 Subnet Mask = 0.0.0.0 Gateway = 0.0.0.
PAGE 49
PS3 PS4 [Server 1 2 3 4 Not Present Not Present Slot Empty Slot Empty N/A N/A N/A N/A Module Power Allocation Table] SLOT-01 OFF 0 W 1 SLOT-02 N/A N/A 1 SLOT-03 ON 327 W 1 SLOT-04 N/A N/A 1 N/A N/A PowerEdge M620 N/A PowerEdge M620 N/A getpciecfg Description Displays the FQDD of the PCIe slots and Virtual Adapters, and their mapping information and properties.
PAGE 50
• 1 5,6,9,10 SLOT-01 1 Present 2 5,6,9,10 SLOT-02 2 Not Present 3 5,6,9,10 Unmapped N/A N/A 4 5,6,9,10 SLOT-04 4 Not Present Displays FQDDs of all the PCIe slots and PCIe Virtual Adapters: racadm getpciecfg PCIe slot 01 PCIe 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.
PAGE 51
Peak System Power Start Time 01/16/2008 Peak System Power Timestamp 01/26/2009 Minimum System Power BTU/hr) Minimum System Power Start Time 01/21/2008 Minimum System Power Timestamp 01/26/2009 System Idle Power BTU/hr) System Potential Power BTU/hr) System Input Current Reading = 16:02:10 = 06:32:55 = 400 W (177 = 22:43:21 = 06:32:55 = 68 W (188 = 68 W (188 = 31.2 A [Real-Time Energy Statistics] System Energy Consumption 6.
PAGE 52
Output The default output display shows the record number, message ID, category, agent ID, severity, time stamp, message arg, and message. The timestamp begins at midnight, January 1, and increases until the system restarts. After the system restarts, the system’s timestamp is used. SeqNumber = 4 Message ID = CMC8550 Category = Audit AgentID = CMC Severity = Information Timestamp = 1982-03-21 05:33:35 Message Arg 1 = Healthy Message = Chassis health is Healthy Example • Displays all the logs.
PAGE 53
getsel Description Displays all sensor event log entries in the DRAC. Synopsis • • racadm getsel -i [-A] racadm getsel [-s ] [-c ] [-A] [-o] [-E] [-R] [--more] If no arguments are specified, the entire log is displayed. Input • • • • • • • • -A — Specifies output with no display headers or labels. -c — Provides the number of records to be displayed. -o — Displays each entry in the SEL in a single line. -s — Specifies the starting record used for the display.
PAGE 54
Fan-5 OK 4107 840 600 N/A N/A Fan-6 OK 0 840 600 N/A N/A Blower-1 N/A 0 3000 2250 N/A N/A Blower-2 N/A 0 3000 2250 N/A N/A Blower-3 N/A 0 3000 2250 N/A N/A Blower-4 N/A 2611 3000 2250 N/A N/A Sensor Type : Temperature Sensor Units : Celsius Chassis Ambient OK 22 3 -7 42 47 Server-4 OK 20 3 -7 42 47 Sensor Type : Power PS-1 Slot Empty N/A PS-2 Online OK P
PAGE 55
• -h - Specifies whether to display the slot name or the host name (if available). – 0 — Displays the slot name – 1 — Displays the host name instead of the slot name – 2 — Displays the iDRAC DNS name instead of the slot name • Example Display all slots names. racadm getslotname 1 SLOT-01 2 WIN-UF2EVKG8PJ5 WIN-UF2EVKG8PJ5 idrac-2QDJH62 3 SLOT-03 4 SLOT-04 • Display the name of the third slot.
PAGE 56
getsvctag Description Displays the service tag of the host system. Synopsis racadm getsvctag Input getsvctag Output Chassis Switch-1 Server-1 Server-2 Server-3 Server-4 Example racadm getsvctag PLPC033 N/A 7654321 N/A Extension(1) PLSMS04 getsysinfo Description Displays information related to CMC and chassis.
PAGE 57
Examples Current DNS Server 1 Current DNS Server 2 DNS Servers from DHCP = 192.168.0.1 = 0.0.0.
PAGE 58
Example Record: 1 Date/Time: Dec Source: ssnmgrd[175] 8 08:21:30 Description: root from 143.166.157.103: session timeout sid 0be0aef4 getversion Table 18. getversion Description Displays the current firmware version of various modules in the chassis, iDRAC version on the attached servers, and whether the target device can be updated. NOTE: To use this subcommand, you must have CMC Login User privilege.
PAGE 59
Physical Disk 0:0:12 AS09 12:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:13 AS09 13:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:14 AS09 14:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:18 AS09 18:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:19 AS09 19:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:2 AS09 2:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 Physical Disk 0:0:3 AS09 3:Enclosure.
PAGE 60
• Retrieve the version for all modules: racadm getversion • Retrieve the iDRAC version in all the servers that are attached to the chassis: racadm getversion -f idrac 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 61
Example • 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 62
license Description Manages the CMC licenses. Synopsis racadm license .
PAGE 63
Examples • View licenses: – View all the license information in the chassis. racadm license view CMC.Integrated.1 Status = OK Device = CMC.Integrated.1 Device Description = Chassis Management Controller for PowerEdge VRTX Unique Identifier = License #1 Status = OK Transaction ID = 8 License Description = CMC Enterprise Evaluation License A2Wir6lJ1MoP8iBAtqsEKDv8 1982-04-07T21:00:00 License Type Entitlement ID = EVALUATION = Expiration = – Display licenses available on a specific device.
PAGE 64
– Replace the license on a device with a license file that is on an NFS share, and using a transaction ID. For example, transaction 27. racadm license replace -f License.xml -l 192.168.2.140:/licshare -t 27 – Replace license on a device with a license file that is on a CIFS share and using a transaction ID. For example, transaction 27. racadm license replace -u admin -p passwd -f License.xml -l // 192.168.2.140/licshare -t 27 – Replace license on a device with a license file on the local file system.
PAGE 65
tcp 0 127.0.0.1:52175 tcp 0 192.168.0.1:45106 tcp 0 127.0.0.1:199 tcp 0 127.0.0.1:8195 0 127.0.0.1:199 ESTABLISHED 0 192.168.0.1:22 ESTABLISHED 0 127.0.0.1:52174 ESTABLISHED 0 127.0.0.1:52887 ESTABLISHED ping Description Verifies that the destination IP4address is reachable from iDRAC with the current 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.
PAGE 66
To use this subcommand for CMC, you must have the Administrator privilege.
PAGE 67
Chassis Name Chassis Location Power Status = Dell Rack System = [UNDEFINED] = ON =============================================================================== Session Information =============================================================================== Type SSH KVM User root root IP Address 192.168.155.10 169.254.31.
PAGE 68
• Reset servers 1 and 3. racadm racreset -m server-1 -m server-3 racresetcfg Description Resets CMC configuration to factory default settings. NOTE: To use this, you must have the Chassis Administrator privilege. Synopsis racadm racresetcfg [-m ] [-c ] Input • -m : — Must be one of the following values: • – chassis — default state, if -m is not specified.
PAGE 69
Example • Monitor Health of Storage root node. racadm raid get status Storage Root Node Status : Ok This command retrieves the controllers keys (FQDDs). • Monitor and Inventory all Controllers connected to the server. racadm raid get controllers racadm raid get controllers -o This command is an optimized version and displays the full controller objects along with their keys.
PAGE 70
This command displays all enclosure keys connected to the controller being mentioned as refkeys. racadm raid get enclosures --refkey -o optimized version. This command displays all enclosure objects for the controller’s FQDD. racadm raid get enclosures --refkey -o -p This command is an optimized and filtered version.
PAGE 71
This command is an optimized version and displays all temperature probe objects for the enclosure FQDD. racadm raid get tempprobes --refkey -o -p optimized and filtered version • Monitor and Inventory all Power Supply Units connected to the enclosure racadm raid get psus --refkey This command displays all power supply units connected to the enclosures being mentioned as refkeys.
PAGE 72
Input • • • • • • • • • • • • • • • • • • • -rl: Set the RAID Level. r0: RAID 0 – Striping. r1: RAID 1 – Mirroring. r5: RAID 5 – Striping with Parity. r6: RAID 6 – Striping with Extra Parity. r10: RAID 10 – Spanned Striping with Mirroring. r50: RAID 50 – Spanned Striping with Parity. r60: RAID 60 – Spanned Striping with Extra Parity. -wp {wt | wb | fwb}: Set the write policy to Write Through, Write Back, or Forced Write Back.
PAGE 73
• Example –pending: Save the configuration change for a later application. You can use a combination of the – pending and –current flags on multiple commands to reduce the possible number of system reboots. racadm raid deletevd:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 discardcache Description Discards any pinned or persistent cache present on the RAID controller.
PAGE 74
NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis raid get controllers -o Input • Example Sample output of a CMC in which either fault-tolerant mode is not available or is not enabled. -o — The -o is used to display the fault-tolerant status of a RAID controller. RAID.ChassisIntegrated.1-1 Status = Ok RollupStatus = Ok Name = Shared PERC8 (Embedded) FirmwareVersion = 23.8.3-0027 DriverVersion = 06.802.11.
PAGE 75
CheckConsistencyMode LoadBalanceSetting CopybackMode PreservedCache CacheMemorySize PersistHotspare SpindownUnconfiguredDrives SpindownHotspare Timeintervalforspindown SecurityStatus EncryptionMode SasAddress PciDeviceId PciSubdeviceId PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvailabilityMode PeerController 2-1 RAID.ChassisIntegrated.
PAGE 76
PeerController 1-1 = RAID.ChassisIntegrated. 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 racadm raid get enclosures -o -p Status racadm raid get enclosures -o Input • • Example racadm raid get enclosures -o -p Status -o — The -o is used to display the fault-tolerant status of a enclosure. -p — The network password of the share. Enclosure.Internal.0-0:RAID.ChassisIntegrated.
PAGE 77
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 racadm raid get emms -o -p Status racadm raid get emms -o Input • • Example racadm raid get emms -o -p Status -o — The -o is used to display the fault-tolerant status of a enclosure. -p — The network password of the share. Expander.Slot.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.2-1 Status = Ok Expander.Slot.
PAGE 78
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 racadm raid get fans -o -p Status racadm raid get fans -o Input • Example racadm raid get fans -o -p Status -o — The -o is used to display the fault-tolerant status of a enclosure. Fan.Slot.0:Enclosure.External.0-1:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok Fan.Slot.1:Enclosure.External.
PAGE 79
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 Description Displays the status and attributes of the Power Supply Unit (PSU) in the storage enclosure that are connected to chassis NOTE: To use this subcommand, you must have the CMC Login User privilege.
PAGE 80
Input • Example racadm raid get tempprobes -o -p Status -o — The -o is used to display the fault-tolerant status of a enclosure. TempSensor.Embedded.2:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok TempSensor.Embedded.3:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok TempSensor.Embedded.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok TempSensor.Embedded.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Ok TempSensor.Embedded.2:Enclosure.External.0-0:RAID.ChassisSlot.
PAGE 81
ReadingDegreeCelcius MinimumWarningThreshold MaximumWarningThreshold MinimumFailureThreshold MaximumFailureThreshold = = = = = 26 C 13 C 46 C 3 C 55 C hotspare Description Assign or unassign global and dedicated hotspares. Synopsis racadm raid hotspare: -assign {yes | no} {type {ghs | dhs}} {vdkey:} {-current | -pending} Input • –current : Performs the configuration right now. NOTE: If this requires the system to reboot it will reboot then.
PAGE 82
Example racadm raid cancelrebuild:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 assignva Description Assigns a virtual disk to one or more virtual adapters. NOTE: You can assign virtual disk to multiple virtual adapters when you select the mode of assignment as multiple. Synopsis racadm raid assignva: -vdkey: -accesspolicy {na | rw} assignpolicy {single | multiple}{-current | -pending} Input • –current : Performs the configuration right now.
PAGE 83
Input • –current : Performs the configuration right now. NOTE: If this requires the system to reboot it will reboot then. • • Example –pending: Save the configuration change for a later application. You can use a combination of the – pending and –current flags on multiple commands to reduce the possible number of system reboots. –speed{fast | full}: Perform a fast or full (slow) initialization on the virtual drive. racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.
PAGE 84
Example 84 • 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.
PAGE 85
• racadm raid createsecuritykey:RAID.ChassisIntegrated.1-1 -key -passwd • racadm raid modifysecuritykey:RAID.ChassisIntegrated.1-1 -key -oldpasswd -newpasswd • racadm raid deletesecuritykey:RAID.ChassisIntegrated.1-1 • racadm raid encryptvd:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 • racadm raid cryptographicerase:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 • racadm raid unlock:RAID.ChassisIntegrated.
PAGE 86
disableperc Description Indicates the RAID configuration of hardware RAID connected to the system. This subcommand disables the power to a RAID card. NOTE: • Using this subcommand power cycles the chassis and sets the fault-tolerant system configuration to Single PERC mode. Synopsis racadm raid disableperc: Example racadm raid disableperc:RAID.ChassisIntegrated.2-1 createsecuritykey Description Assigns a security key to the controller.
PAGE 87
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 Description Erases the contents of a physical disk, which is part of a secure virtual disk that has been deleted.
PAGE 88
• racadm remoteimage -d - disconnect • Disable Remote File Started. Please check status using -s option to know Remote File Share is ENABLED or DISABLED. racadm remoteimage -s - status Remote File Share is Enabled UserName Password ShareName //192.168.0.1/xxxx/dtk_3.3_73_Linux.iso serveraction 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.
PAGE 89
• Server is already powered OFF. Turn off the server from iDRAC when Power is already off on that server.
PAGE 90
• Configure a CMC from an XML configuration file on a remote NFS share racadm set -f myfile.xml -t xml -l 192.168.0.0:/myshare setassettag 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.
PAGE 91
To disable fault-tolerant mode: Racadm raid set controllers: -p HighavailabilityMode none Input Example Racadm raid set controllers: -p HighAvailabilityMode ha racadm raid set controllers:RAID.ChassisSlot.5-1 -p HighAvailabilityMode ha Racadm raid set controllers: -p HighavailabilityMode none racadm raid set controllers:RAID.ChassisSlot.
PAGE 92
To blink or unblink the chassis, I/O modules or the CMC, you must have the Debug Administrator privilege on CMC. To enable the servers to blink or unblink, you must have the Server Administrator or Debug Administrator privilege on CMC. Synopsis racadm setled -m -l Input • -m - Specifies the module whose LED you want to configure.
PAGE 93
NOTE: The terms NIC and Ethernet management port may be used interchangeably. Synopsis Input Example • racadm setniccfg -d • racadm setniccfg -d6 • racadm setniccfg -s • racadm setniccfg -s6 • 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.
PAGE 94
• Unassign a Virtual Adapter: racadm setpciecfg unassign -c RAID.ChassisIntegrated.1-1-3 • Enable ride-through mode racadm setpciecfg ridethru -e IOV000: Successfully completed the operation. • 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.
PAGE 95
— is a prefix of one or more timezones, followed by '*'. NOTE: The timezone or daylight savings time is fully supported for '-l' and '-z' options. Omit the '-l' option to set the timezone only (eg. '-z US/Central'). • -l — Sets the local date and time in the string yyymmddhhmmss where: — yyyy is the year — 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.
PAGE 96
Example • Set the name of slot 3 as server3: racadm setslotname -i 3 server3 • Enable system to display host names (1= Hostname): racadm setslotname -h 1 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), and " (double quote) are not supported for this subcommand.
PAGE 97
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 racadm sshpkauth Input • • -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.
PAGE 98
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 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 99
racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate Jul 8 16:21:56 2005 GMT Jul 7 16:21:56 2010 GMT sslcsrgen Description 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 100
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 Description Restores the web-server certificate to factory default and restarts web-server.
PAGE 101
• 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.
PAGE 102
• 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. Synopsis testfeature -f ad -u -p [-d ] Example • • • testfeature –f ad –u user@domain –p secret SUCCESSFUL: User permissions are xxxxxppp. The last three digits are the user's permissions.
PAGE 103
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. Synopsis testfeature -f ldap -u -p [-d ] testtrap Description Tests the RAC’s SNMP trap alerting feature by sending a test trap from iDRAC to a specified destination trap listener on the network. To use this subcommand, you must have the Test Alerts privilege.
PAGE 104
traceroute6 Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv6 address. To use this subcommand, you must have the Administrator privilege. Synopsis racadm traceroute6 racadm traceroute fd01::1 Output traceroute to fd01::1 (fd01::1) from fd01::3, 30 hops max, 16 byte packets 1 fd01::1 (fd01::1) 14.324 ms 0.26 ms 0.
PAGE 105
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 106
idRacVersionInfo (Read Only) Description String containing the current product firmware version. Legal Values A string of up to 63 ASCII characters. Default The current version number. idRacBuildInfo (Read Only) Description String containing the current RAC firmware build version. Legal Values A string of up to 16 ASCII characters. Default for CMC The current CMC firmware build version. idRacName (Read Only) Description A user-assigned name to identify this controller.
PAGE 107
cfgNicVLanId (Read or Write) Description Specifies the VLAN ID for the network VLAN configuration (in CMC for iDRAC Enterprise on server modules). This property is only valid if cfgNicVLanEnable is set to 1 (enabled). Legal Values 1 – 4000 and 4021 – 4094 Default 1 Example racadm config -g cfgLanNetworking -o cfgNicVlanID 1 cfgDNSDomainNameFromDHCP (Read/Write) Description Specifies that the DNS domain name should be assigned from the network DHCP server.
PAGE 108
cfgDNSRacName (Read/Write) 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/Write) Description Registers the CMC name on the DNS server.
PAGE 109
cfgDNSServersFromDHCP (Read/Write) Description Specifies if the DNS server IPv4 addresses should be assigned from the DHCP server on the network. For CMC, this property is used only if cfgNicUseDhcp is set to 1 (true). Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgDNSServer1 (Read/Write) Description Specifies the IPv4 address for DNS server 1. This property is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE).
PAGE 110
cfgNicIpAddress (Read/Write) Description Specifies the static IPv4 address to be assigned to the RAC or CMC. NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE.) Legal Values String representing a valid IPv4 address. For example: 192.168.0.20. Default 192.168.0.120 cfgNicNetmask (Read/Write) Description The subnet mask used for CMC IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE).
PAGE 111
This group enables/disables and configures firmware updates, NTP, remote syslogging, and SMTP email alerting. 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/Write) Description Enables or disables CMC firmware update from a network TFTP server.
PAGE 112
cfgRhostsNtpEnable 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 Description Specifies the first of three possible NTP servers. Legal Values A string representing a valid NTP server. For example, ntp1.ntp.net. At least one NTP server must be specified and duplicate entries are not allowed.
PAGE 113
cfgRhostsSyslogEnable (Read/Write) Description Enables or disables remote syslog to allow the RAC and SEL logs to be written to up to three remote syslog servers. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgRhostsSyslogPort (Read/Write) 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).
PAGE 114
Default cfgRhostsSyslogPowerLoggingEnabled Description Enables or disables power consumption logging to remote syslog servers. NOTE: Remote syslog must be enabled and one or more remote syslog servers must be configured for power consumption to be logged. Legal Values • • Default 0 1 (enabled) 0 (disabled) cfgRhostsSyslogPowerLoggingInterval Description Specifies the power consumption collection/logging interval.
PAGE 115
Use this object with the config or getconfig subcommands. You must supply an index group number to use these commands as follows: -i 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 cfgUserAdmin group.
PAGE 116
iDRAC Specific User Privilege Privilege Bit Mask Access Virtual Media 0x00000040 Test Alerts 0x00000080 Execute Debug Commands 0x00000100 CMC Specific User Privilege CMC Login User 0x0000001 Chassis Configuration Administrator 0x0000002 User Configuration Administrator 0x0000004 Clear Logs Administrator 0x0000008 Chassis Control Administrator 0x0000010 Super User 0x0000020 Server Administrator 0x0000040 Test Alert User 0x0000080 Debug Command Administrator 0x0000100 Fabric A Admini
PAGE 117
recreate the name. The string cannot contain / (forward slash), \ (backslash), . (period), @ (at symbol) or quotation marks. NOTE: This property value must be unique among user names. Legal Values A string of up to 16 ASCII characters. Default • • root (User 2) (All others) cfgUserAdminPassword (Write Only) Description The password for this user. User passwords are encrypted and cannot be seen or displayed after the property is written. Legal Values A string of up to 20 ASCII characters.
PAGE 118
cfgEmailAlertEnable (Read/Write) Description Enables or disables the alert instance. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgEmailAlertAddress (Read/Write) 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 Description Specifies name or other identifier associated with the destination e-mail address.
PAGE 119
CMC - 30 Example racadm getconfig -g cfgSessionManagement cfgSsnMgtWebserverTimeout=0 cfgSsnMgtTelnetIdleTimeout=0 cfgSsnMgtSshIdleTimeout=300 cfgSsnMgtRacadmTimeout=0 cfgSsnMgtWebserverTimeout (Read/Write) 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.
PAGE 120
cfgSerialConsoleIdleTimeout (Read/Write) Description The maximum number of seconds to wait before an idle serial session is disconnected. Legal Values • • Default 1800 0 = No timeout 60 – 10800 cfgSerialConsoleNoAuth (Read/Write) Description Enables or disables the RAC or CMC serial console login authentication.
PAGE 121
cfgSerialSshEnable (Read/Write) 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= cfgSerialConsoleColumns=0 cfgSerialHistorySize=8192 cfgSerialTelnetEnable=0 cfgSerialSshEnable=1 cfgSerialTelnetEnable (Read/Write) Description Enables or
PAGE 122
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. Default public Example racadm getconfig -g cfgOobSnmp # racadm getconfig -g cfgoobsnmp cfgOobSnmpAgentEnable=1 cfgOobSnmpAgentCommunity=public cfgOobSnmpProtocol=ALL cfgOobSnmpTrapFormat=SNMPv1 cfgOobSnmpAgentEnable (Read/Write) Description Enables or disables the SNMP agent.
PAGE 123
cfgTrapsIndex (Read Only) Description Indicates the unique index of an alert instance. Legal Values 1-4 Default 1 cfgTrapsEnable Description Enables or disables event traps. Legal Values • • Default None 1 (TRUE) 0 (FALSE) 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.
PAGE 124
cfgTrapsSNMPv3UserName Table 21. cfgTrapsSNMPv3UserName — Details Description Configure SNMPv3 user name. Legal Values Any existing CMC user name. Default Empty 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.
PAGE 125
NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 111, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, and 60106. Default 80 cfgRacTuneHttpsPort (Read/Write) Description Specifies the port number to use for HTTPS network communication with. Legal Values 10–65535 NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 111, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, and 60106.
PAGE 126
• cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr. Legal Values An IPv4 address formatted string, for example, 255.255.255.0. Default 255.255.255.0 cfgRacTuneIpBlkEnable (Read/Write) Description Enables or disables the IPv4 address blocking feature.
PAGE 127
cfgRacTuneTelnetPort (Read/Write) 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) Description Specifies the daylight savings offset (in minutes) to use for the RAC Time.
PAGE 128
cfgRacTuneFipsModeEnable 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. cfgRacTuneTLSProtocolVersionEnable Description Sets the minimum TLS protocol version. Legal Values • • • Default 1 0 - TLSv1.
PAGE 129
Default None cfgServerServiceTag (Read Only) Description Displays the service tag of the specified server. Legal Values None Default None cfgServerName (Read/Write) Description Displays the name of the specified server. Legal Values Maximum of 15 non-extended ASCII characters, (ASCII codes 32–126). For more information, see Guidelines to Quote Strings Containing Special Characters when Using RACADM Commands.
PAGE 130
cfgServerNic2MacAddress (Read Only) Description Displays the MAC address of the server NIC 2. Legal Values None Default None cfgServerNic3MacAddress (Read Only) Description Displays the MAC address of the server NIC 3. Legal Values None Default None cfgServerNic4MacAddress (Read Only) Description Displays the MAC address of the server NIC 4.
PAGE 131
cfgServerPowerBudgetAllocation (Read Only) Description Displays the current power allocation for the server. Legal Values • • Default None 1 (Enable) 0 (Disable) cfgServerDNSRegisterIMC (Read/Write) Description Enables or disables DNS name registration for the Integrated System (iDRAC). Legal Values • • Default None 1 (enable) 0 (disable) cfgServerDNSIMCName (Read/Write) Description Displays the DNS domain name for the integrated Remote Access Controller (iDRAC.
PAGE 132
• • • • • • Default 28–CD-DVD 32–BIOS 36–vFDD 40–VCD-DVD 44–iSCSI 60–VFLASH partition label 0 (zero) cfgServerBootOnce (Read/Write) 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) Description Displays the current power consumption for a server.
PAGE 133
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 134
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 135
cfgADEnable (Read/Write) Description Enables or disables Active Directory user authentication on CMC. If this property is disabled, LDAP authentication may be used for user login. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) cfgADAuthTimeout (Read/Write) Description Specifies the number of seconds to wait for Active Directory authentication requests to complete before timing out. NOTE: To modify this property, you must have the Configure CMC privilege.
PAGE 136
cfgADDomainController2 (Read/Write) Description Specifies the LDAP server from which you want the CMC to obtain user names . Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default None cfgADDomainController3 (Read/Write) Description Specifies the LDAP server from which you want the CMC to obtain user names .
PAGE 137
cfgADType (Read/Write) 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) Description Chooses the way the user domain is looked up for Active Directory. Legal Values • • Default 1 (TRUE)—use user domain as the search domain to look up DCs.
PAGE 138
cfgADGcSRVLookupEnable (Read/Write) Description Determines how the global catalog server is looked up. If using pre‑configured global catalog servers, then CMC uses the values cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and cfgAdGlobalCatalog3. Legal Values • • Default 0(FALSE)—use pre‑configured Global Catalog Servers (GCS) 1(TRUE)—use DNS to look up GCS 0 cfgADSpecifyServerEnable Description Allows you to enable or disable and specify an LDAP server or a global catalog server.
PAGE 139
cfgLDAPServer (Read/Write) Description Configures the address of the LDAP Server. IPv4 and IPv6 are supported. NOTE: You can specify multiple servers by separating each server with a comma. For example, example.com, sub1.example.com Legal Values String. Maximum length = 254 Default Null cfgLDAPPort (Read/Write) Description Port of LDAP over SSL. Non-SSL port is not supported.
PAGE 140
not specified, then CMC uses the member and unique member attributes. Legal Values String. Maximum length = 254 Default Null cfgLDAPGroupAttributeIsDN (Read/Write) Description If enabled, the CMC performs DN matching; otherwise, the CMC uses the username provided at login for matching.
PAGE 141
cfgLDAPCertValidationEnable (Read/Write) Description Controls certificate validation during SSL handshake. Legal Values • • Default 1 (TRUE)—CMC uses the CA certificate to validate the LDAP server certificate during SSL handshake. 0 (FALSE)—CMC does not performthe certificate validation task of SSL handshake. 1 cfgLDAPNetworkTimeout Description Configures the network timeout in seconds.
PAGE 142
Default ldap cfgLDAPRoleGroup Use this object with the getconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. This group configures Generic LDAP Role group descriptions and defines the CMC privileges that LDAP–authenticated users are granted.
PAGE 143
cfgLocation This group defines objects that support physical location properties. Use this object with the getconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. cfgLocationDatacenter (Read/Write) Description Indicates DataCenter name. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationAisle (Read/Write) Description Indicates aisle where server is located.
PAGE 144
cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings. Use this object with thegetconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. The following sections provide information about the objects in the cfgStandardSchema group.
PAGE 145
NOTE: -i is for the index.
PAGE 146
cfgChassisInPower (Read Only) 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) Description Indicates the maximum system input power consumption (in Watt). Legal Values Default cfgChassisPeakPowerTimestamp (Read Only) Description The timestamp recorded when the peak input power consumption value occurred.
PAGE 147
• • Default 5 (critical) 6 (non-recoverable) None cfgChassisRedundantState (Read Only) Description Enables or disables power redundancy for the chassis. Legal Values • • Default None 0 (none) 1 (full) cfgChassisDefaultPowerCapUpperBound (Read Only) Description Indicates the maximum default value to which you can set the power cap of a chassis.
PAGE 148
cfgChassisPowerCap (Read/Write) Description Indicates the maximum power consumption limit (in Watt) for the entire chassis. The command generates an error if server throttling is necessary to achieve the power goal based on the value for this setting. Legal Values 2715 – 16685 Watt Default 16685 Watt cfgChassisPowerCapF (Read/Write) Description Indicates the maximum power consumption limit (in Watt) for the entire chassis.
PAGE 149
cfgChassisPowerCapFPercent (Read/Write) Description Indicates the power consumption limit as a percentage. The percentage is computed mathematically as the minimum power + (percent * (maximum power - minimum power)). Use cfgChassisPowerCapFPercent when power consumption is to be changed regardless of whether server throttling is required. Legal Values 16 - 100 NOTE: If the specified percent is lower than the minimum value, the CMC will set the value to the minimum value.
PAGE 150
Default None cfgChassisInPowerServerAllocation (Read Only) Description Indicates (in Watt) the cumulative power allocated to servers. There is no default as this parameter is very specific to the particular customer configuration. Legal Values None Default None cfgChassisInfrastructureInPowerAllocation (Read Only) Description Indicates the estimated cumulative DC output power consumption (in watts), determined from a field replaceable unit (FRU) on the hardware modules in the chassis.
PAGE 151
Default None cfgChassisPowerButtonEnable (Read/Write) Description Indicates if the chassis power button is enabled or disabled. Legal Values • • Default None 0 (disabled) 1 (enabled) cfgSystemEnergyConsumptionClear (Write Only) Description Resets energy statistics when set to 1.
PAGE 152
cfgChassisServerBasedPowerMgmtMode Description Indicates the server-based power management mode of a chassis. Legal Values • • Default 0 (disabled) 0 (disabled) 1 (enabled) cfgChassisPowerCapBTU (Read/Write) Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. The command generates an error if server throttling is necessary to achieve the power goal based on the value for this setting.
PAGE 153
• cfgKvmSlot4Enable Legal Values 0 disables the mapping and 1 enables the mapping. Default None cfgDvdInfo This group is used to view the mapping information for the DVD drive in the chassis. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. cfgDvdMapping Read or Write Description Maps the slots to the DVD drive in the chassis: Legal Values 1, 2, 3, and 4 are the slot numbers that are specified.
PAGE 154
cfgAlertingEnable Description Enables or disables event traps on the CMC. Legal Values • • Default None 1 (true) 0 (false) To use this object property, you must have the Chassis Configuration Administrator privilege. cfgAlertingSourceEmailName Description Specifies the e-mail address used to send e-mail notifications when an event occurs.
PAGE 155
cfgIPv6AutoConfig (Read/Write) Description Enables or disables the IPv6 Auto Configuration option. NOTE: If this value is set to 0, the CMC disables auto configuration and statically assigns IPv6 addresses. If this value is set to 1, the CMC obtains address and route information using stateless auto configuration and DHCPv6. NOTE: The CMC uses its MAC address for its DUID (DUID-LL) when communicating with a DHCPv6 server.
PAGE 156
cfgIPv6DNSServersFromDHCP6 (Read/Write) Description Specifies whether cfgIPv6DNSServer1 and cfgIPv6DNSServer2 are static or DHCP IPv6 addresses. NOTE: This property is used only if cfgIPv6AutoConfig is set to 1 (true). Legal Values 1 (TRUE) 0 (FALSE) Default 1 cfgIPv6DNSServer1 (Read/Write) 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.
PAGE 157
• cfgIPv6DNSServer2 • cfgDNSServer1 • cfgDNSServer2 cfgCurrentLanNetworking (Read Only) This group displays the current CMC NIC properties. Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. Synopsis racadm getconfig -g cfgCurrentLanNetworking cfgNicCurrentIPv4Enabled Description Indicates whether IPv4 is enabled on the CMC.
PAGE 158
cfgNicCurrentGateway Displays the static gateway for the CMC IP address. Description Displays the static gateway for the CMC IP address. Legal Values Default cfgNicCurrentDhcpWasUsed Description Indicates whether DHCP is used to configure the NIC. Legal Values 0 – address is static. 1– address was obtained from the DHCP server. Default None cfgNicCurrentVlanEnable (Read Only) Description Indicates whether the VLAN is enabled.
PAGE 159
Default None cfgDNSCurrentServer2 Description Displays the IP address for DNS server 2. Legal Values Default cfgDNSCurrentDomainName Description Displays the DNS domain name. Legal Values Default cfgCurrentIPv6LanNetworking (Read Only) This group displays the current CMC IPv6 properties. Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. cfgCurrentIPv6Enabled Description Indicates whether IPv6 is enabled on the CMC.
PAGE 160
cfgCurrentLinkLocalAddress Description Displays the current IPv6 link-local address of the CMC. Legal Values Default cfgCurrentIPv6Address Description Displays the current IPv6 addresses. This property displays up to 15 global IPv6 addresses, including stateful and stateless addresses. Legal Values Default cfgCurrentIPv6Gateway Description Displays the current IPv6 gateway.
PAGE 161
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
PAGE 162
cfgNetTuningNicAutoneg (Read/Write) Description Enables autonegotiation of physical link speed and duplex. If enabled, autonegotiation takes priority over other values set in this group.
PAGE 163
cfgRacSecCsrOrganizationUnit (Read/Write) Description Specifies the CSR Organization Unit (OU). Legal Values A string of up to 64 characters. Default cfgRacSecCsrLocalityName (Read/Write) Description Specifies the CSR Locality (L). Legal Values A string of up to 128 characters. Default cfgRacSecCsrStateName (Read/Write) Description Specifies the CSR State Name (S). Legal Values A string of up to 128 characters.
PAGE 164
cfgRacSecCsrKeySize (Read/Write) Description Specifies the SSL asymmetric key size for the CSRs. Legal Values 1024, 2048, and 4096 Default 2048 cfgQuickDeploy This group is used to configure IDRAC deployment settings. You must have blade administrator privileges for configuring the settings. cfgActionOnServerInsertion Table 22. cfgActionOnServerInsertion — Details Description Configures settings when a new server is inserted into the slot.
PAGE 165
cfgEnableiDRACLAN Table 25. cfgEnableiDRACLAN — Details Description Enables the LAN channel for iDRAC when servers are inserted into the chassis. Legal Values • 0 — Disable • 1 — Enable Default 1 cfgEnableiDRACIPv4 Table 26. cfgEnableiDRACIPv4 — Details Description Enables IPv4 for each iDRAC in the chassis. Any iDRAC that is not IPv6 is always IPv4 enabled. Legal Values • 0 — Disable • 1 — Enable Default 1 cfgEnableiDRACIPMIOverLAN Table 27.
PAGE 166
192.168.0.121 Default cfgiDRACIPv4GateWay Table 30. cfgiDRACIPv4GateWay — Details Description IPv4–specific default gateway that is common to all the IPv4–enabled iDRACs present in the chassis. Legal Values IP format Default 0.0.0.0 cfgiDRACIPv4Netmask Table 31. cfgiDRACIPv4Netmask — Details Description IPv4–specific subnet mask that is common to all iDRACs present in the chassis. Legal Values IP format Default 255.255.255.0 cfgEnableiDRACIPv6 Table 32.
PAGE 167
cfgiDRACIPv6PrefixLength Table 34. cfgiDRACIPv6PrefixLength — Details The length of the subnet in bits that is common to all IPv6-enabled iDRACs present in the chassis. Description Legal Values 0–128 Default 64 cfgiDRACIPv6Gateway Table 35. cfgiDRACIPv6Gateway — Details Description IPv6-specific default gateway that is common to all IPv6-enabled iDRACs present in the chassis. Legal Values IPv6 format Default :: cfgReservedIPAddressNumbers Table 36.