Reference Guide

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

Chassis Management Controller Version 2.1

for Dell PowerEdge VRTX RACADM Command

Line Reference Guide

Summary of content (182 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 computer. 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 © 2015 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
PAGE 3
Contents 1 Introduction......................................................................................................... 12 Supported RACADM Interfaces...........................................................................................................12 RACADM Syntax Usage....................................................................................................................... 12 SSH or Telnet RACADM.................................................................................
PAGE 4
getioinfo...............................................................................................................................................41 getled...................................................................................................................................................42 getmacaddress.................................................................................................................................... 42 getmodinfo..........................................
PAGE 5
get tempprobes.............................................................................................................................88 hotspare.........................................................................................................................................89 cancelinit....................................................................................................................................... 90 cancelrebuild............................................................
PAGE 6
idRacVersionInfo (Read Only)......................................................................................................117 idRacBuildInfo (Read Only)..........................................................................................................117 idRacName (Read Only)...............................................................................................................117 cfgLanNetworking..........................................................................................
PAGE 7
cfgEmailAlertIndex (Read Only).................................................................................................. 130 cfgEmailAlertEnable (Read/Write)...............................................................................................130 cfgEmailAlertAddress (Read/Write)............................................................................................. 131 cfgEmailAlertEmailName...............................................................................................
PAGE 8
cfgServerInfo..................................................................................................................................... 142 cfgServerInfoIndex (Read Only).................................................................................................. 142 cfgServerSlotNumber (Read Only)..............................................................................................142 cfgServerServiceTag (Read Only)....................................................................
PAGE 9
cfgADGcSRVLookupEnable (Read/Write)...................................................................................153 cfgADSpecifyServerEnable.......................................................................................................... 153 cfgLDAP............................................................................................................................................. 153 cfgLDAPEnable (Read/Write)............................................................................
PAGE 10
cfgChassisDefaultPowerCapUpperBoundBTU(Read Only).......................................................164 cfgChassisDefaultPowerCapLowerBound (Read Only).............................................................164 cfgChassisDefaultPowerCapLowerBoundBTU(Read Only).......................................................164 cfgChassisPowerCap (Read/Write).............................................................................................164 cfgChassisPowerCapF (Read/Write)........................
PAGE 11
cfgNicCurrentIPv4Enabled..........................................................................................................174 cfgNicCurrentIpAddress.............................................................................................................. 175 cfgNicCurrentNetmask................................................................................................................175 cfgNicCurrentGateway.....................................................................................
PAGE 12
Introduction 1 This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions of CMC for PowerEdge VRTX. Supported RACADM Interfaces The RACADM command-line utility provides a scriptable interface that allows you to remotely configure your Chassis Management Controller (CMC). The utility runs on the management station and the managed system.
PAGE 13
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. Option Description -r Specifies the controller’s remote IP address. -r racIpAddr : Use: if the iDRAC port number is not the default port (443). -u Specifies the user name that is used to authenticate the command transaction.
PAGE 14
Subcommand CMC Telnet/SSH/ Serial Remote RACADM "?" and "?" Yes Yes chassisaction Yes Yes chassislog No No closessn Yes Yes clrsel Yes Yes cmcchangeover Yes Yes config Yes Yes connect Yes Yes deploy Yes Yes eventfilters Yes Yes fanoffset Yes Yes feature Yes Yes featurecard Yes Yes fwupdate Yes Yes get Yes Yes getactiveerrors No Yes getassettag Yes Yes getchassisname Yes Yes getconfig Yes Yes getdcinfo Yes Yes getflexaddr Yes Yes g
PAGE 15
Subcommand CMC 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 racresetcfg Yes Yes raid Yes Yes remoteimage Yes Yes serveraction
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
• The rack documentation included with your rack solution describes how to install your system into a rack, if required. • For the full name of an abbreviation or acronym used in this document, see the Glossary at dell.com/ support/manuals. • Systems management software documentation describes the features, requirements, installation, and basic operation of the software. • Documentation for any components you purchased separately provides information to configure and install these options.
PAGE 18
RACADM Subcommand Details 2 This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
PAGE 19
• ` (back quotation marks) • \ (backslash) For example, use the following for a string that contains the special characters, $, ",',`and \. For single quotation marks: • No character escaping is necessary. • 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).
PAGE 20
testemail testfeature testtrap traceroute traceroute6 ------ test CMC e-mail notifications test CMC feature x test CMC SNMP trap notifications determine the route of a packet determine the route of a packet Example for RACADM ? racadm ? getsysinfo getsysinfo -- display general CMC and system information Usage: racadm getsysinfo [-d] [-c] [-A] [-4] [-6] ----------------------------------------------------------Valid Options: -d : show CMC information -c : show chassis information -A : do not
PAGE 21
• • • • • • • • • • • – System – Storage – Updates – Audit – Config -q - The sequence number from which the records must be displayed. -n - Specifies the n Number of records to be displayed. -r - Displays events that have occurred after this time. The time format is yyyy-mm-dd HH:MM:SS. The time stamp must be provided within double quotes. -e - Displays events that have occurred before this time. The time format is yyyy-mm-dd HH:MM:SS. The time stamp must be provided within double quotes.
PAGE 22
• Display all records of events that have occurred between 2011-01-02 23:33:40 and 2011-01-03 00:32:15: racadm chassislog view -r "2011-01-02 23:33:40" -e "2011-01-03 00:32:15" • 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 Description Exports the Chassis log to a remote share. To export the chassis log, you must have the Clear Logs Administrator privilege.
PAGE 23
To clear the chassis log, you must have the Clear Logs Administrator privilege. Synopsis racadm chassislog clear racadm -r -u p chassislog clear Example • Clear the Chassis Log racadm chassislog clear • Clear the Chassis Log using remote racadm racadm -r 192.168.0.11 -u root -p calvin chassislog clear chassisaction Description Executes a power action on the chassis or a switch. To use this subcommand, you must have the Chassis Control Administrator privilege.
PAGE 24
closessn Description Closes a communication session on the device. Use the getssninfo command to view a list of sessions that can be closed using this command. To use this subcommand, you must have the Administrator privilege. Synopsis • • • racadm closessn –i racadm closessn -a racadm closessn -u Input • -i — The session ID of the session to be ended, which can be retrieved using RACADM getssninfo subcommand. Session executing this command cannot be ended.
PAGE 25
To use this subcommand, you must have the Administrator privilege. NOTE: This command is valid only in redundant CMC environments. For more information, see the "Understanding the Redundant CMC Environment" section of the Dell Chassis System User Guide. Synopsis racadm cmcchangeover Input None Output CMC failover initiated successfully. Example racadm cmcchangeover config Description Allows you to set CMC configuration parameters individually or to batch them as part of a configuration file.
PAGE 26
number and a short description about the issue is displayed. This option is a checkonly. Output This subcommand generates error output for any of the following reasons: • • Invalid syntax, group name, object name, index, or other invalid database members. RACADM CLI failures. This subcommand returns an indication of the number of configuration objects that were written out of the total objects in the .cfg file. Examples • • racadm config -g cfgLanNetworking -o cfgNicIpAddress 192.168.0.5.
PAGE 27
deploy Description Configures the static IP address, subnet mask, gateway, and password for the root user on iDRAC for the specified server. To use this subcommand, you must have the Server Administrator privilege. NOTE: You can also use setniccfg to configure static IP address, subnet mask, gateway, DHCP, speed, and duplex properties.
PAGE 28
• • • -6 — Enables IPv6 auto configuration (when used with -d.) Sets static IPv6 addresses (when used with -s). -q — Displays or modifies the quick deploy parameters. -n — Specifies the number of reserved IP addresses for quick deploy. The valid values are 2 and 4. Output None Example • • • racadm deploy -m server-8 -s 192.168.0.20 255.255.255.0 192.168.0.1 The server was deployed successfully.
PAGE 29
Valid category values are: • • • • • System Config Updates Storage Audit Valid severity values are: • • • Critical Warning Informational Valid examples of alert descriptors are: Input • cmc.alert.all • cmc.alert.audit • cmc.alert.audit.lic • cmc.alert.audit.warning • cmc.alert.audit.lic.critical • • get - Displays the list of event filter settings. set - Configures the actions and notifications for a given event filter configuration. -c - Alert descriptor of the specific event filter.
PAGE 30
• Clear all available alert settings: racadm eventfilters set -c cmc.alert.all -n none • Configure using severity as a parameter. For example, all informational events in storage category are assigned poweroff as action, and email and snmp as notifications: racadm eventfilters set -c cmc.alert.storage.info -n email,snmp • Configure using subcategory as a parameter.
PAGE 31
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. NOTE: To deactivate FlexAddress features, the chassis must be turned off.
PAGE 32
Output An example of output is given here.
PAGE 33
Upload firmware image from TFTP server and start firmware update. Synopsis • Using Remote RACADM: racadm -r fwupdate -p -u -d NOTE: iDRAC7 targets are not supported from CMC. Use the CMC GUI to update iDRAC7 targets from CMC. When using FTP, if you provide the full path to the image file on the CLI, then the CMC uses that path to locate that file on the host.
PAGE 34
• – hdd-fqdd, where fqdd is FQDD of the HDD -s — Displays the current status of the firmware update. NOTE: Use -m to display the status of the module update. Omit -m to display the status of the active CMC update. NOTE: Use all to get the status of all the targets that must be updated. • -c — Cancels the current firmware update of a module. NOTE: The Enclosure, Expander, HDD, and PERC updates cannot be cancelled. Output Displays a message indicating the operation that is being performed.
PAGE 35
NOTE: • Synopsis If CMC is not in the network, you can only export the chassis configuration profile to the local management station. racadm get -f racadm -r -u -p get -f racadm -r -u -p get -f -t xml racadm get -f -t xml -u -p -l racadm get -f -t xml -l Input • • • • • –f: save event filter configurations to a file.
PAGE 36
Input valid values for : critical, warning, info valid values for : server-n, where n = 1 to 4 switch-n, where n = 1 cmc-n, where n = 1, 2 fan-n, where n = 1 to 6 ps-n, where n = 1 to 4 chassis kvm Output Display entire log: racadm getactiveerrors - Display specific module log: racadm getactiveerrors -m server-1 - Display entire informational log: racadm getactiveerrors -s info getassettag Description Displays the asset tag for the chassis.
PAGE 37
Example racadm getchassisname CMC-1 getconfig Description Retrieves CMC configuration parameters individually, or all CMC configuration groups may be retrieved and saved to a file.
PAGE 38
Output This subcommand generates error output upon encountering either of the following: • • Invalid syntax, group name, object name, index, or other invalid database members RACADM CLI transport failures If errors are not encountered, this subcommand displays the contents of the specified configuration. Example • Displays all of the configuration properties (objects) that are contained in the group cfgLanNetworking.
PAGE 39
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 40
getflexaddr Description Enabled or disabled status is displayed for the entire chassis and fabric ID decoder. Use the command with -i option to display the MACs/WWN on a per-slot-basis The decoder values in the Type column 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 CMC Login User privilege. NOTE: If FlexAddress is not activated on the chassis, the command displays serverassigned MAC/WWN addresses.
PAGE 41
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:AA(active) FCoE-WWN 10:00:00:90:FA: 51:36:55 20:01:F8:DB:88:3D: 9F:AA(active) 10 GbE KR/3 00:90:FA:51:36:56 F8:DB: 88:3D:A2:78(active) NOTE: 10 GbE KR/3— The value 3 indicates the protocol type.
PAGE 42
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 43
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 44
Displays the MAC address for chassis. racadm getmacaddress -m chassis CMC Present N/A F0:4D:A2:77:71: 72 N/A Displays the MAC address for switch-1 racadm getmacaddress -m switch-1 Switch-1 Present Not Installed 00:00:00:00:00: 00 Not Installed Display MAC for server-1.
PAGE 45
CMC Present N/A 00:1E:4F:1F:3C: N/A 58 Server-1 Present 00:1E:4F:2A:AF: 00:1E:4F: 7B 2A:D3:97 00:1E:4F: 2A:D3:99 Server-2 Present 00:22:19:D2:1E: N/A 84 N/A Server-3 Not Present N/A N/A N/A Server-4 Present 00:18:8B:FF: 45:2A 00:18:8B:FF:AA: 00:18:8B:FF:AA: 02 04 Switch-1 Present N/A 00:00:00:00:00: N/A 00 Displays the Ethernet and iSCSI MAC/WWN addresses for all iDRAC/LOMs/mezzanine cards.
PAGE 46
Server-3 N/A Not Present N/A Server-4-A Gigabit Ethernet Present 00:18:8B:FF: 00:18:8B:FF: 00:18:8B:FF: 45:2A AA:02 AA:04 iSCSI Present 00:18:8B:FF: 00:18:8B:FF: AA:03 AA:05 Gigabit Ethernet Not Present Not Installed Not Installed iSCSI Present Not Installed Not Installed Server-4-C Fibre Channel 4 Present Not Installed Not Installed Switch-1 None Present Server-4-B N/A N/A N/A 00:00:00:00: N/A 00:00 Displays the user-defined MAC and WWN address.
PAGE 47
Switch-1 Gigabit Ethernet Present 10 GbE KR Present 84:8F: 69:FC:E8:F1 F8:B1:56:45: DD:BD Unknown Factory N/A Factory Displays the chassis-assigned WWN/MAC address.
PAGE 48
To use this subcommand, you must have CMC Login User privilege. NOTE: The service tag field is blank for modules that do not have service tags. Synopsis racadm getmodinfo [-m ] [-A] Input • -m — Specifies the module for which the configuration and status information is required. The default command (no options) displays information about all the major components in the chassis.
PAGE 49
Blower-2 Present ON OK N/A Blower-3 Present ON OK N/A Blower-4 Present ON OK N/A PS-1 Present Online N/A N/A PS-2 Present Online OK N/A PS-3 Not Present N/A N/A N/A PS-4 Not Present N/A N/A N/A CMC-1 Present Standby OK N/A CMC-2 Present Primary N/A N/A Switch-1 Present ON N/A N/A Server-1 Present OFF OKA N/A Server-2 Not Present N/A N/A N/A Server-3 Present ON N/A N/A Server-4 Not Present N/A OK N/A DVD Present ON N/A N/A IO-Cable PL
PAGE 50
Example racadm getniccfg NIC Enabled = 1 IPv4 Enabled = 1 DHCP Enabled = 1 Static IP Address = 192.168.0.120 Static Subnet Mask = 255.255.255.0 Static Gateway = 192.168.0.12 Current IP Address = 192.168.0.12 Current Subnet Mask = 255.255.254.0 Current Gateway = 192.168.0.
PAGE 51
Gateway = 192.168.0.1 IPv6 Enabled = 0 Autoconfiguration Enabled = 0 Link local Address = IPv6 Gateway = :: VLAN Enable = 0 VLAN ID = 1 VLAN priority = 0 racadm getniccfg -m switch-1 DHCP Enabled = 1 IP Address = 192.168.0.12 Subnet Mask = 255.255.255.0 Gateway = 192.168.0.12 Output The getniccfg subcommand displays an appropriate error message if the operation is not successful.
PAGE 52
IPv6 settings: IPv6 Enabled = 0 DHCP6 Enabled = 1 IP Address 1 = :: Gateway = :: Link Local Address = :: IP Address 2 = :: IP Address 3 = :: IP Address 4 = :: IP Address 5 = :: IP Address 6 = :: IP Address 7 = :: IP Address 8 = :: IP Address 9 = :: IP Address 10 = :: IP Address 11 = :: IP Address 12 = :: IP Address 13 = :: IP Address 14 = :: IP Address 15 = :: LOM Status: NIC Selection = Dedicated Link Detected = Yes Speed = 10Mb/s Duplex Mode = Half Duplex getpbi
PAGE 53
Minimum System Power Minimum System Power Timestamp Overall Power Health Redundancy System Input Power Cap Redundancy Policy Dynamic PSU Engagement Enabled System Input Max Power Capacity Input Redundancy Reserve Input Power Allocated to Servers Input Power Allocated to Chassis Infrastructure Total Input Power Available for Allocation Standby Input Power Capacity Server Based Power Management Mode Max Power Conservation Mode Server Performance Over Power Redundancy [Chassis Power Supply Status Table]
PAGE 54
• PCIe slot-1 Broadcom Corporation NetXtreme II OFF Unmapped N/A N/A PCIe slot-2 Ethernet Server Adapter I350-T2 OFF Unmapped N/A N/A PCIe slot-3 Broadcom Corporation NetXtreme BCM OFF Unmapped N/A N/A PCIe slot-4 Not Present N/A N/A N/A N/A PCIe slot-5 Shared PERC 8 External ON Shared N/A N/A PCIe slot-6 Shared PERC 8 External ON Shared N/A N/A PCIe slot-7 Not Present N/A N/A
PAGE 55
PCIe PCIe PCIe PCIe PCIe slot slot slot slot slot 04 05 06 07 08 PCIE.ChassisSlot.4 PCIE.ChassisSlot.5 PCIE.ChassisSlot.6 PCIE.ChassisSlot.7 PCIE.ChassisSlot.8 PCIe slot 09 1-1-1 PCIe slot 09 1-1-2 PCIe slot 09 1-1-3 PCIe slot 09 1-1-4 Virtual Adapter 01 RAID.ChassisIntegrated. Virtual Adapter 02 RAID.ChassisIntegrated. Virtual Adapter 03 RAID.ChassisIntegrated. Virtual Adapter 04 RAID.ChassisIntegrated.
PAGE 56
22:43:21 01/21/2008 Minimum System Power Timestamp 06:32:55 01/26/2009 System Idle Power (188 BTU/hr) System Potential Power (188 BTU/hr) System Input Current Reading A = = 68 W = 68 W = 31.2 [Real-Time Energy Statistics] System Energy Consumption = 6.
PAGE 57
• • -s — Specifies the starting record used for the display. --more — Displays one screen at a time and prompts the user to continue. 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.
PAGE 58
To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getredundancymode Example racadm getredundancymode Redundant 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.
PAGE 59
Examples racadm getsensorinfo Sensor Type : FanSpeed Sensor Units : rpm UC Fan-1 OK 0 840 600 N/A N/A Fan-2 OK 0 840 600 N/A N/A Fan-3 OK 4037 840 600 N/A N/A Fan-4 OK 4045 840 600 N/A N/A Fan-5 OK 4107 840 600 N/A N/A Fan-6 OK 0 840 600 N/A N/A Blower-1 N/A 0 3000 2250 N/A N/A Blower-2 N/A 0 3000 2250 N/A N/A Blower-3 N/A 0 3000 2250 N/A N/A Blower-4 N/A 2611 3000 2250 N/A N/A Sen
PAGE 60
getslotname Description Displays the name, host name (if available) and iDRAC DNS name of all the four slots, or of a specified slot (indicated by the slot number) in the chassis. Optionally, use this command to find if the slot name or host name, or iDRAC DNS name is displayed in the CMC Web interface, or with the getslotname [-i | -h] command. If the host name is not available, the static slot name is used.
PAGE 61
• • • 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. Synopsis racadm getssninfo [-A] [-u | *] Input • • -A - eliminates the printing of data headers.
PAGE 62
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 63
System AssetTag Service Tag Express Service Code Chassis Name Chassis Location Chassis Midplane Version Power Status System ID Examples = = = = = = = = 00000 CMC[UNDEFINED] 1.0 ON 1487 racadm getsysinfo -d racadm getsysinfo -c racadm getsysinfo -A racadm getsysinfo -4 racadm getsysinfo -6 gettracelog Description Synopsis Input Lists all the trace log entries in CMC.
PAGE 64
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 65
• Example – drivers: OS Driver Package – nic-x: Network Interface card. See -l output for possible values of x. – raid-x: RIAD Controller. See -l output for possible values of x. -m - Specifies the module or device for which you must retrieve the version information. is one of the following: – server-n, where n = 1 to 4. For example, cmc-2. – switch-n, where n = 1 – CMC-n, where n = 1 or 2 – mainboard – perc – expander – hdd – perc-fqdd, where fqdd is FQDD of the PERC.
PAGE 66
Example $ racadm ifconfig eth0 Link encap:Ethernet 00:1D:09:FF:DA:23 HWaddr inet addr:10.35.155.136 Bcast:192.168.0.1 Mask:255.255.255.0 MULTICAST Metric:1 UP BROADCAST RUNNING MTU:1500 RX packets:2550665 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 1000 (259.9 MiB) (0.0 B) collisions:0 txqueuelen: RX bytes:272532097 TX bytes:0 jobqueue Description Displays the jobs in that are currently being run, delete the jobs, and create a job.
PAGE 67
[Job ID=RID_853106266329] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] --------------------------------------------------------[Job ID=RID_852218430518] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] --------------------------------------------------------[Job ID=RID_852215634901] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] --------------------------------------------------------[Job ID=JID_852215394003] Job Name=ConfigRAID:GUI:RAID.
PAGE 68
license Description Manages the CMC licenses. Synopsis racadm license .
PAGE 69
Examples • • -l — Network share location to import or export the license file. -f — File name of the license file. • • • • NOTE: During export, the license file is named _.xml. -u— User name of the remote share. -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.
PAGE 70
– Export the license to a CIFS share specifying the entitlement ID (for example, abcdxyz): racadm license export -u admin -p passwd -f License.xml -l //192.168.2.140/licshare -e abcdxyz – Export license to a CIFS share specifying the FQDD. While using the -c option and exporting licenses from a device, more than one license file must be exported. Therefore, if a file name is provided, an index is appended to the end of the file name such as LicenseFile0.xml, LicenseFile1.xml, and so on.
PAGE 71
U 0 30 1 lo fe80::200:ff:fe00:d01/128 :: U 0 0 1 lo fe80::/64 :: U 256 0 0 eth1 ff00::/8 :: U 256 0 0 eth1 Kernel IP routing table Destination Gateway Genmask Flags MSS Window irtt Iface 192.168.0.1 0.0.0.0 255.255.255.0 U 0 0 0 bond0 0.0.0.0 192.168.0.1 0.0.0.0 UG 0 0 0 bond0 Active Internet connections (w/o servers) Proto Recv-Q Send-Q Local Address Foreign Address State tcp 0 0 127.0.0.1:8195 127.0.0.1:52887 ESTABLISHED tcp 0 0 127.0.0.1:199 127.0.0.1:52174 ESTABLISHED tcp 0 0 127.0.0.1:52175 127.0.0.
PAGE 72
To use this subcommand for CMC, you must have the Administrator privilege for CMC, and for iDRAC you must have the Execute Diagnostic Commands privilege. Synopsis racadm ping 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.
PAGE 73
• • • • • • • • • • • • Output Session information - getssinfo Sensor information - getsensorinfo Switches information (IO Module) - getioinfo Mezzanine card information (Daughter card) getdcinfo All modules information - getmodinfo Power budget information - getpbinfo KVM information - getkvminfo NIC information (CMC module) - getniccfg Redundancy information getredundancymode Trace log information - gettracelog RAC event log - getraclog System event log - getsel The following information is displayed wh
PAGE 74
=============================================================================== Session Information =============================================================================== Type SSH KVM User root root IP Address 192.168.155.10 169.254.31.
PAGE 75
• Reset server 1. racadm racreset -m server-1 • 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 76
raid Description Allows you to execute commands to control RAID arrays. Synopsis racadm raid Example • Monitor Health of Storage root node racadm raid get status Storage Root Node Status : Ok This command retrieves the controllers keys, (FQDDs.) • Monitor and Inventory all Controllers connected to the server racadm raid get controllers racadm raid get controllers -o This command is an optimized version and displays the full controller objects along with their keys.
PAGE 77
racadm raid get vdisks racadm raid get vdisks --refkey RAID.ChassisSlot.5-1 -o -p status racadm Disk.Virtual.5:RAID.ChassisSlot.5-1 Status = Ok racadm Disk.Virtual.0:RAID.ChassisSlot.5-1 Status = Ok racadm Disk.Virtual.1:RAID.ChassisSlot.5-1 Status = Ok • racadm Disk.Virtual.2:RAID.ChassisSlot.
PAGE 78
This command will return all EMM keys connected to the enclosures being mentioned as refkeys. racadm raid get emms --refkey -o This command is an optimized version and displays all EMM objects for the enclosure FQDD. racadm raid get emms --refkey -o -p This command is an optimized and filtered version.
PAGE 79
• Example –vdkey: A comma-seperated list of virtual drive FQDDs to use in the operation. racadm raid blink:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 racadm raid blink:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 racadm raid blink -pdkey:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1,Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 racadm raid blink -vdkey:Disk.Virtual.0:RAID.ChassisIntegrated. 1-1,Disk.Virtual.0:RAID.ChassisIntegrated.
PAGE 80
• Example -cc: Create a CacheCade or Enhanced Cache VD. racadm raid createvd:RAID.ChassisIntegrated.1-1 -rl r0 pdkey:Disk.Bay.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated.1-1 NOTE: Make sure to provide the current active controller FQDD in the createvd command. deletevd Description Deletes the specified virtual drive. Synopsis racadm raid deletevd: {-current|-pending} Input • –current : Performs the configuration right now.
PAGE 81
Example racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l -u -p [-f ] forceonline Description Forces the RAID Controller to make the specified drive online. This operation may result in obsolete or corrupted data, and should only be attempted in cases where a rebuild operation has failed or is not applicable. Synopsis racadm raid forceonline: {current|pending} Input • • –current : Performs the configuration right now.
PAGE 82
SecurityStatus EncryptionMode SasAddress PciDeviceId PciSubdeviceId PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvailabilityMode PeerController = Unknown = None = 0x590B11C02620E600 = 0x2f = 0x1f3e = 0x1000 = 0x1028 = 0x0 = 0x0 = 0x0 = Unknown = Short = Unknown = 6.0 Gb/s, 3.
PAGE 83
PeerController 2-1 RAID.ChassisIntegrated.
PAGE 84
Example racadm raid get enclosures -o -p Status Enclosure.Internal.0-0:RAID.ChassisIntegrated.2-1 Status = Ok Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Failed racadm raid get enclosures -o Enclosure.Internal.0-0:RAID.ChassisIntegrated.2-1 Status = Ok RollupStatus = Ok Name = VRTX2.5x25 0:0 BayId = 0 FirmwareVersion = 2.00 AssetTag = elan3 AssetName = VRTX200 ternal backplane SasAddress = Not applicable SlotCount = 25 Enclosure.External.
PAGE 85
Example racadm raid get emms -o -p Status Expander.Slot.0:Enclosure.Internal.0-0:RAID.ChassisIntegrated. 2-1 Status = Ok Expander.Slot.1:Enclosure.Internal.0-0:RAID.ChassisIntegrated. 2-1 Status = Ok EMM.Slot.0:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok EMM.Slot.1:Enclosure.External.0-1:RAID.ChassisSlot.5-1 Status = Ok EMM.Slot.0:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Failed EMM.Slot.1:Enclosure.External.0-0:RAID.ChassisSlot.5-1 Status = Unknown racadm raid get emms -o Expander.
PAGE 86
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 87
State = Ready Name = Fan 1 Speed = 4670 RPMS Fan.Slot.2:Enclosure.External.0-0:RAID.ChassisSlot.5-1 FanOperationalStatus = Ok State = Ready Name = Fan 2 Speed = 4670 RPMS Fan.Slot.3:Enclosure.External.0-0:RAID.ChassisSlot.
PAGE 88
get tempprobes Description Displays the status and attributes of the temperature sensors in the storage enclosure that are connected to chassis NOTE: To use this subcommand, you must have the CMC Login User privilege. Synopsis racadm raid get tempprobes -o -p Status racadm raid get tempprobes -o 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.
PAGE 89
ReadingDegreeCelcius = 32 C MinimumWarningThreshold = -2 C MaximumWarningThreshold = 65 C MinimumFailureThreshold = -2 C MaximumFailureThreshold = 65 C TempSensor.Embedded.1:Enclosure.External.0-0:RAID.ChassisSlot. 5-1 Status = Ok State = Ready Name = Temp Sensor 1 ReadingDegreeCelcius = 31 C MinimumWarningThreshold = -2 C MaximumWarningThreshold = 65 C MinimumFailureThreshold = -2 C MaximumFailureThreshold = 65 C TempSensor.Embedded.2:Enclosure.External.0-0:RAID.ChassisSlot.
PAGE 90
0-0:RAID.ChassisIntegrated.1-1 -assign yes -type ghs racadm raid hotspare:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 -assign yes -type dhs vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 cancelinit Description Stops an initialization operation on the specified virtual drive. Synopsis racadm raid cancelinit: {-current | -pending} Input • –current : Immediately performs the configuration operation.
PAGE 91
• • Example NOTE: Enable cluster services on the servers when assigning Virtual Disk to multiple Virtual Adapters. Use of this mode without Cluster Services may lead to corrupted or lost data. –accesspolicy {na | rw}: Set the access policy to No Access or Read/Write. –vdkey:: The Virtual Drive to change the access to. racadm raid assignva:RAID.ChassisIntegrated.1-1-1 vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -accesspolicy { na | rw } racadm raid assignva:RAID.ChassisIntegrated.
PAGE 92
racadm raid init:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -speed full raid Description Monitors, retrieves inventory, and configures the storage components connected to the chassis. NOTE: To use this subcommand, you must have the Chassis Administrator privilege.
PAGE 93
Example • • • • • • • • • • • • • • • • • • • • • • • 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 94
rebuild Description Starts a rebuild on a specified virtual drive. Synopsis racadm raid rebuild: {-current | -pending} Input • –current : Performs the configuration. NOTE: If this requires the system to restart, the system is restarted. • Example –pending: Save the configuration change for a later use. You can use a combination of the –pending and –current flags on multiple commands to reduce the possible number of system restarts. racadm raid rebuild:Disk.Bay.0:Enclosure.
PAGE 95
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 will power cycle the chassis and set the fault-tolerant system configuration to Single PERC mode. Synopsis racadm raid disableperc: Example racadm raid disableperc:RAID.ChassisIntegrated.2-1 remoteimage Description Connects, disconnects, or deploys a media file on a remote server.
PAGE 96
To use this subcommand, you must have the Execute Server Control Commands permission. Synopsis racadm serveraction Input • • • • -m server-n, where n=1–4 -a - Performs action on all servers. Not allowed with the powerstatus action. -f - Force the action. Required for the reseat action. - Specifies the action. The options for the string are: — graceshutdown — Performs a graceful shutdown of the server.
PAGE 97
• Get Power Status on iDRAC racadm serveraction powerstatus • Server Power Status: ON Reseat server 2 on CMC $ racadm serveraction -m server-2 reseat -f • Server power operation successful Explanation of Support iDRAC needs to support graceful shutdown The support of address individual blades is expected on the CMC set Description Import saved CMC configuration or CMC Event Filter configuration from a file.
PAGE 98
setassettag Description Sets the N-byte ASCII asset tag for the chassis. To use this subcommand, you must have the Administrator privilege. NOTE: The special characters \ (backslash), & (ampersand), ` (backward quotation mark), and " (double quotation mark) are not supported for this subcommand. Synopsis racadm setassettag -m chassis Input -m — Specifies the module whose asset tag you want to set.
PAGE 99
set controllers Description Sets the RAID controllers detected in the system and fault-tolerant mode is configured on external controllers (Shared PERC 8 External).
PAGE 100
Input • • -i — Enables or disables FlexAddress for the specified slot. -f — Enables or disables FlexAddress for the specified fabric. Example • racadm setflexaddr -i 1 0 Slot 1 FlexAddress state set successfully • racadm setflexaddr -f A 1 Fabric A FlexAddress state set successfully • racadm setflexaddr -f idrac 1 setled Description Sets the state (blinking or not blinking) of the LED on the specified module.
PAGE 101
NOTE: Set enclosure is used for the storage expansion feature when available with shared external PERCs. Synopsis racadm raid set enclosures: 0-0:RAID.ChassisSlot.5-1 –p racadm raid set enclosures: 0-0:RAID.ChassisSlot.5-1 –p Input -p— Specifies the property of the enclosure to be modified. Enclosure.External. AssetTag Enclosure.External. AssetName Example setniccfg Description Sets the iDRAC IP address.
PAGE 102
setpciecfg Description You can configure PCIe slots and Virtual Adapters, and also set the ride-through properties. NOTE: To use this subcommand, you must have Chassis Administrator privilege. NOTE: The slot assignment feature is licensed.
PAGE 103
To use this subcommand, you must have the Administrator privilege. Synopsis • • • Input • racadm setractime -d racadm setractime -l YYYYMMDDhhmmss racadm setractime -z {?|timezone|timezoneprefix*} -d — Sets the time to value in the string: — yyyy is the year — mm is the month — dd is the day — hh is the hour — mm is the minutes — ss is the seconds — mmmmmm is the number of microseconds — s is a + (plus) sign or a - (minus) sign, which indicates the sign of the offset.
PAGE 104
— 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. 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 105
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 106
sshpkauth Description Enables you to upload and manage up to six (6) different SSH public keys. You can upload a key file or key text, view keys, or delete keys. racadm sshpkauth -i svcacct -k -p -t racadm sshpkauth -i svcacct -k -p -f racadm sshpkauth -v -i svcacct -k racadm sshpkauth -d -i svcacct -k NOTE: For DSA keys greater than 2048, use the following racadm command.
PAGE 107
sslcertupload Description Uploads a custom SSL server or CA certificate for Directory Service from the client to iDRAC. To use this subcommand, you must have the CMC Configuration permission. Synopsis racadm sslcertupload -t [-f ] Input • -t — Specifies the type of certificate to upload, either the CA certificate for Directory Service or the server certificate. — 1 = server certificate.
PAGE 108
Serial Number 00 Subject Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) iDRAC Default certificate Issuer Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc.
PAGE 109
racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate Jul 8 16:21:56 2005 GMT Jul 7 16:21:56 2010 GMT sslcsrgen Description Generates and downloads a CSR file to the client’s local file system. The CSR can be used for creating a custom SSL certificate that can be used for SSL transactions on iDRAC.
PAGE 110
The sslcsrgen -s subcommand returns one of the following status codes: • • Example CSR was generated successfully. CSR does not exist. racadm sslcsrgen -s or racadm sslcsrgen -g -f c:\csr \csrtest.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.
PAGE 111
testemail Description Sends a test e-mail to a specified destination. Prior to executing the test email command, make sure that the SMTP server is configured and the specified index in the RACADM cfgEmailAlert group is enabled and configured properly. Synopsis racadm testemail -i Input -i — Specifies the index of the e-mail alert to test.
PAGE 112
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 113
• testfeature –f adkrb –u user_name@domain_name SUCCESSFUL: User permissions are 80000fff. • testfeature -f ldap -u harold -p barrel SUCCESSFUL: User permissions are 0x00000fff. testfeature -f adkrb Description Tests the Active Directory configuration using the Kerberos authentication (single sign-on or Smart Card login). Use the optional -d switch to obtain additional diagnostic information, as needed. This subcommand, when run, performs the following: • • • • • • • • • • Checks command syntax.
PAGE 114
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 115
Output traceroute to 192.168.0.1 (192.168.0.1), 30 hops max, 40 byte packets 1 192.168.0.1 (192.168.0.1) 0.801 ms 0.246 ms 0.253 ms traceroute6 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.
PAGE 116
CMC Property Database Group and Object Descriptions 3 The CMC property database contains the configuration information for CMC. Data is organized by associated object, and objects are organized by object group. The IDs for the groups and objects that the property database supports are listed in this section for CMC. Use the group and object IDs with the RACADM subcommands to configure CMC. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output.
PAGE 117
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 118
Default 0 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 119
cfgDNSDomainName (Read/Write) Description This is the DNS domain name. This parameter is valid only if cfgDNSDomainNameFromDHCP is set to 0 (FALSE). Legal Values A string of up to 254 ASCII characters. At least one of the characters must be alphabetic. Characters are restricted to alphanumeric, '-', and '.'. NOTE: Microsoft Active Directory supports only Fully Qualified Domain Names (FQDN) of 64 bytes or fewer.
PAGE 120
Example: racadm getconfig -g cfgLanNetworking cfgNicEnable=1 cfgNicIPv4Enable=1 cfgNicIpAddress=192.168.0.120 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.0.1 cfgNicUseDhcp=1 # cfgNicMacAddress=00:00:00:00:00:01 cfgNicVLanEnable=0 cfgNicVLanID=1 cfgNicVLanPriority=0 cfgDNSServersFromDHCP=1 cfgDNSServer1=192.168.0.5 cfgDNSServer2=192.168.0.6 cfgDNSRacName=cmc-frankly cfgDNSDomainName=fwad.
PAGE 121
NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses. Legal Values String representing a valid IPv4 address. For example: 192.168.0.20. Default 0.0.0.0 cfgDNSServer2 (Read/Write) Description Retrieves the IPv4 address for DNS server 2. 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. Legal Values String representing a valid IPv4 address.
PAGE 122
cfgNicNetmask (Read/Write) Description The subnet mask used for CMC IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE). NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE). Legal Values String representing a valid subnet mask. For example: 255.255.255.0. Default 255.255.255.0 cfgNicGateway (Read/Write) Description CMC gateway IPv4 address. The gateway IPv4 address used for static assignment of the RAC IP address.
PAGE 123
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. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgRhostsFwUpdateIpAddr (Read/Write) Description Specifies the network TFTP server IPv4 or IPv6 address that is used for TFTP CMC firmware update operations. Legal Values A string representing a valid IPv4 or IPv6 address. For example, 192.168.
PAGE 124
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 125
cfgRhostsNtpMaxDist Description Specifies the NTP maximum distance parameter used to aid in NTP configuration. Legal Values 1–128 Default 16 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.
PAGE 126
cfgRhostsSyslogServer2 (Read/Write) Description Specifies the second of three possible remote syslog servers to store the RAC and SEL logs. This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values Valid hostname or IPv4 or IPv6 address. Default cfgRhostsSyslogServer3 (Read/Write) 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).
PAGE 127
cfgRhostsFwUpdatePath= cfgRhostsSmtpServerIpAddr=localhost.
PAGE 128
cfgUserAdminPrivilege (Read/Write) Description This property specifies the role-based authority privileges allowed for the user. The value is represented as a bit mask that allows for any combination of privilege values. The table below describes the user privilege bit values that can be combined to create bit masks.
PAGE 129
Chassis Control Administrator 0x0000010 Super User 0x0000020 Server Administrator 0x0000040 Test Alert User 0x0000080 Debug Command Administrator 0x0000100 Fabric A Administrator 0x0000200 Fabric B Administrator 0x0000400 Fabric C Administrator 0x0000800 Examples The following table provides sample privilege bit masks for users with one or more privileges. User Privilege(s) Privilege Bit Mask The user is not allowed to access CMC.
PAGE 130
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. Default ******** cfgUserAdminEnable (Read/Write) Description Enables or disables an individual user. NOTE: You can enable a user for a given index, only if you set the password for the same user.
PAGE 131
• Default 0 (FALSE) 0 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. The e-mail name can refer to an individual, group, location, department, and so on.
PAGE 132
Default iDRAC - 60 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.
PAGE 133
cfgSerialConsoleEnable (Read/Write) Description Enables or disables the RAC or CMC serial console interface. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) 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 134
NOTE: The terminal emulator must be configured with the line wrap mode ON, if a terminal emulator is used. Legal Values 0–256 Default 0 (equivalent to 80) cfgSerialHistorySize (Read/Write) Description Specifies the maximum size of the serial history buffer. Legal Values 0 – 8192 Default 8192 cfgSerialSshEnable (Read/Write) Description Enables or disables the secure shell (SSH) interface on CMC.
PAGE 135
cfgOobSnmp This group contains parameters to configure the SNMP agent and trap capabilities of CMC. One instance of the group is allowed. The CMC SNMP agent supports the standard RFC1213 mib-2, and the Dell enterprise-specific MIB. Use this object with the config or getconfig subcommands. To use this object property, you must have Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output.
PAGE 136
This object property is applicable only to CMC. Use this object with the config or getconfig subcommands. To use this object property, you must have Chassis Configuration Administrator privilege. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. cfgTrapsIndex (Read Only) Description Indicates the unique index of an alert instance.
PAGE 137
Example racadm getconfig -g cfgTraps -i 2 # cfgTrapsIndex=2 cfgTrapsEnable=1 cfgTrapsAlertDestIpAddr= cfgTrapsCommunityName=public 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 138
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 139
cfgRacTuneIpRangeMask (Read/Write) Description Standard IP mask values with left-justified bits. For example, 255.255.255.0. A login from the incoming IP address is allowed only if both of the following are identical: • • cfgRacTuneIpRangeMask bit-wise and with incoming IP address cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr. Legal Values An IPv4 address formatted string, for example, 255.255.255.0. Default 255.255.255.
PAGE 140
cfgRacTuneIpBlkPenaltyTime (Read/Write) Description Defines the time span in seconds that session requests from an IP address with excessive failures are rejected. Legal Values 2–65535 Default 300 cfgRacTuneSshPort (Read/Write) Description Specifies the port number used for the SSH interface. Legal Values 10–65535 Default 22 cfgRacTuneTelnetPort (Read/Write) Description Specifies the port number used for iDRAC or CMC Telnet interface.
PAGE 141
cfgRacTuneHttpsPort=443 cfgRacTuneTelnetPort=23 cfgRacTuneSshPort=22 cfgRacTuneIpRangeEnable=0 cfgRacTuneIpRangeAddr=192.168.1.1 cfgRacTuneIpRangeMask=255.255.255.
PAGE 142
browsers. This property has no effect on the Telnet/SSH or RACADM interfaces. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgServerInfo For iDRAC this group allows you to select the BIOS first boot device and provides the option to boot the selected device only once. For CMC, this group allows you to displays information for and configure a server in the chassis. Use this object with the config or getconfig subcommands.
PAGE 143
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. Default SLOT - cfgServerFW (Read Only) Description Displays the server's iDRAC management firmware revision.
PAGE 144
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 145
cfgServerIPMIOverLanEnable (Read/Write) Description Enables or disables IPMI LAN channel. Legal Values • • Default None 1 (enable) 0 (disable) 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).
PAGE 146
cfgServerFirstBootDevice (Read/Write) Description Sets or displays the first boot device. This object is read-write. NOTE: For a vFlash Partition to be configured as First Boot Device, it has to be attached first.
PAGE 147
# cfgServerInfoIndex=8 # cfgServerSlotNumber=8 # cfgServerServiceTag= cfgServerName=SLOT-08 # cfgServerFW=3.
PAGE 148
# cfgServerBIOS=4.0.
PAGE 149
cfgADCertValidationEnable (Read/Write) Description Enables or disables Active Directory certificate validation as a part of the Active Directory configuration process. Legal Values • • Default 1 1 (TRUE) 0 (FALSE) cfgADRacDomain (Read/Write) Description Active Directory Domain in which CMC resides. Legal Values Any printable text string of up to 254 characters, with no white space. Default 1 cfgADRootDomain (Read/Write) Description Specifies the root domain of the domain forest.
PAGE 150
NOTE: To modify this property, you must have the Configure CMC privilege. Legal Values 15–300 seconds Default 120 cfgADSCLEnable Description Enables you to log on to the CMC without enabling the Smart Card login. Legal Values • • Default 0 1 (Enable) 0 (Disable) cfgADSSOEnable (Read/Write) Description Enables or disables Active Directory single sign-on authentication on CMC.
PAGE 151
cfgADDomainController3 (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 cfgADGlobalCatalog1 (Read/Write) Description Specifies the Global Catalog server from which you want the CMC to obtain user names.
PAGE 152
cfgADType (Read/Write) Description Determines the schema type to use with Active Directory. Legal Values • • Default 1 (Enables Active Directory with the extended schema) 2 (Enables Active Directory with the standard schema) 1 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 153
Default 0 cfgADGcRootDomain (Read/Write) Description The name of the Active Directory root domain used for DNS look up, to locate Global Catalog servers. Legal Values String. Maximum character length = 254 Default Null cfgADGcSRVLookupEnable (Read/Write) Description Determines how the global catalog server is looked up. If using pre‑configured global catalog servers, then CMC uses the values cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and cfgAdGlobalCatalog3.
PAGE 154
cfgLDAPEnable (Read/Write) Description Turns LDAP service on or off. If this property is disabled, local CMC authentication is used for user logins. NOTE: For CMC, enabling this option turns off cfgADEnable. Legal Values • • Default 0 1 (TRUE)— Enable 0 (FALSE)— Disable cfgLDAPServer (Read/Write) 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.
PAGE 155
cfgLDAPUserAttribute (Read/Write) Description Specifies the user attribute to search for. It is recommended to be unique within the chosen baseDN, otherwise a search filter must be configured to make sure the uniqueness of the login user. If the userDN cannot be uniquely identified, login fails with error. Legal Values String. Maximum length = 254 Default Null uid if not configured. cfgLDAPGroupAttribute (Read/Write) Description Specifies which LDAP attribute is used to check for group membership.
PAGE 156
NOTE: If cfgLDAPBindDN is [null] and cfgLDAPBindPassword is [null], then the CMC attempts an anonymous bind. Legal Values String. Maximum length = 254 Default Null cfgLDAPBindpassword (Write Only) 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.
PAGE 157
cfgLDAPNetworkTimeout Description Configures the network timeout in seconds. Legal Values Positive integer Default 30 seconds cfgLDAPSearchTimeout Description Configures the search timeout in seconds. Legal Values Positive integer Default 120 seconds cfgLDAPSRVLookupDomainName Description Configures the domain name to be used in the SRV lookup. Legal Values String of maximum length of 254 alphanumeric characters and hyphens. The string must begin with a letter.
PAGE 158
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 159
Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupPrivilege -i 1 0x0 cfgLocation This group defines objects that support physical location properties. Use this object with the getconfig or config subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. cfgLocationDatacenter (Read/Write) Description Indicates DataCenter name.
PAGE 160
cfgLocationDevicesize (Read Only) Description Indicates server chassis size. Legal Values Values from 1 - 255 Default 0 cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings. 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.
PAGE 161
Default cfgSSADRoleGroupPrivilege (Read/Write) Description Use the bit mask numbers listed in the table below to set role-based authority privileges for a Role Group. Legal Values 0x00000000 0x00000fff Default Example racadm getconfig -g cfgStandardSchema -i 1 NOTE: -i is for the index.
PAGE 162
cfgChassisPower This group is applicable only to CMC and contains parameters to display or configure power for the chassis. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. The following sections provide information about the objects in the cfgChassisPower group.
PAGE 163
cfgChassisMinPower (Read Only) Description The minimum system input power consumption value (in Watt) over the time since the value was last cleared. Legal Values None Default None cfgChassisMinPowerTimestamp (Read Only) Description The timestamp recorded when the minimum system power occurred. Legal Values None Default None cfgChassisPowerStatus (Read Only) Description Indicates the power status of the chassis.
PAGE 164
Default 5000 Watt cfgChassisDefaultPowerCapUpperBoundBTU(Read Only) Description Indicates the maximum default value to which you can set the power cap of a chassis. Legal Values 17060 BTU/h Default 17060 BTU/h cfgChassisDefaultPowerCapLowerBound (Read Only) Description Indicates the minimum default value to which you can set the power cap of a chassis.
PAGE 165
error if the value for this setting is lower than the minimum power required for the chassis configuration. Legal Values 2715 – 16685 Watt Default 16685 Watt cfgChassisPowerCapFBTU (Read/Write) Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. Use cfgChassisCapFBTU when power consumption is to be changed regardless of whether server throttling is required.
PAGE 166
NOTE: If the specified percent is lower than the minimum value, the CMC will set the value to the minimum value. Default 100 cfgChassisRedundancyPolicy (Read/Write) Description Sets the redundancy policy of the chassis. Legal Values • • • Default 0 (no redundancy) 0 (no redundancy) 1 (AC redundancy) 2 (power supply redundancy) cfgChassisDynamicPSUEngagementEnable (Read/Write) Description Enables or disables dynamic engagement.
PAGE 167
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 168
cfgChassisPowerClearTimestamp (Read Only) Description Time stamp when cfgChassisMinPower and cfgChassisMaxPowerCapacity were reset. Legal Values None 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 169
• cfgChassisPowerButtonEnable=1 cfgChassisAllow110VACOperation=0 cfgChassisMaxPowerConservationMode=0 cfgChassisPerformanceOverRedundancy=1 # cfgSystemEnergyConsumptionClear = ****(Write-Only) cfgChassisServerBasedPowerMgmtMode=0 racadm config -g cfgChassisPower ‑o cfgChassisPowerClear 1 Clears cfgChassisMinPower and cfgChassisPeakPower. cfgChassisServerBasedPowerMgmtMode Description Indicates the server-based power management mode of a chassis.
PAGE 170
• • cfgKvmSlot3Enable cfgKvmSlot4Enable Legal Values 0 disables the mapping and 1 enables the mapping. Default None cfgDvdInfo This group is used to view the mapping information for the DVD drive in the chassis. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege.
PAGE 171
cfgAlerting This group is enables or disables SNMP event trap alerting and sets the event filter. Use this object with the config or getconfig subcommands. cfgAlertingEnable 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 172
cfgIPv6Enable (Read/Write) Description Enables or disables the IPv6 stack. Legal Values • • Default 0 1 (TRUE) 0 (FALSE) 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.
PAGE 173
Default 64 cfgIPv6Gateway (Read/Write) 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. Default :: 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).
PAGE 174
Default :: Example $ racadm getconfig -g cfgIPv6LanNetworking cfgIPv6Enable=1 cfgIPv6AutoConfig=1 cfgIPv6Address=:: cfgIPv6PrefixLength=64 cfgIPv6Gateway=:: cfgIPv6DNSServersFromDHCP6=1 cfgIPv6DNSServer1=:: cfgIPv6DNSServer2=:: If both IPv4 and IPv6 are enabled on the CMC, IPv6 DNS servers take priority.
PAGE 175
# # # # # # # # # # cfgNicCurrentIpAddress=143.166.152.116 cfgNicCurrentNetmask=255.255.255.0 cfgNicCurrentGateway=143.166.152.1 cfgNicCurrentDhcpWasUsed=0 cfgNicCurrentVlanEnable=0 cfgNicCurrentVlanID=1 cfgNicCurrentVlanPriority=0 cfgDNSCurrentServer1=192.168.0.5 cfgDNSCurrentServer2=192.168.0.6 cfgDNSCurrentDomainName=MYDOMAIN cfgNicCurrentIpAddress Description Displays the static IP address to the CMC.
PAGE 176
cfgNicCurrentVlanEnable (Read Only) Description Indicates whether the VLAN is enabled. Legal Values 0- VLAN is disabled 1- VLAN is enabled Default None cfgNicCurrentVlanID (Read Only) Description Indicates the Current Virtual Lan ID Legal Values Integer Default None cfgNicCurrentVlanPriority (Read Only) Description Indicates the Current Virtual Lan Priority. Legal Values Integer Default None cfgDNSCurrentServer1 Description Displays the IP address for DNS server 1.
PAGE 177
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. If the current property value is set to 0 (false), the remote network interfaces to the CMC are not accessible over IPv6.
PAGE 178
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. Legal Values Default cfgCurrentIPv6DNSServersFromDHCP6 Description Indicates whether the DNS server addresses are assigned from the DHCPv6 server.
PAGE 179
# # # # # # # 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 This group enables users to configure the advanced network interface parameters for the RAC NIC or CMC.
PAGE 180
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 181
cfgRacSecCsrOrganizationUnit (Read/Write) Description Specifies the CSR Organization Unit (OU). Legal Values A string of up to 254 characters. Default cfgRacSecCsrLocalityName (Read/Write) Description Specifies the CSR Locality (L). Legal Values A string of up to 254 characters. Default cfgRacSecCsrStateName (Read/Write) Description Specifies the CSR State Name (S). Legal Values A string of up to 254 characters.
PAGE 182
cfgRacSecStateName= cfgRacSecCountryCode= cfgRacSecEmailAddr= cfgRacSecCsrKeySize (Read/Write) Description Specifies the SSL asymmetric key size for the CSRs.