Quick Reference Guide

ManualsBrandsDell ManualsSoftwareDell Chassis Management Controller Version 4.1

RACADM Command Line Reference Guide for iDRAC7

1.00.00 and CMC 4.1

Summary of content (223 pages)

PAGE 1
RACADM Command Line Reference Guide for iDRAC7 1.00.00 and CMC 4.
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. © 2012 Dell Inc.
PAGE 3
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Introduction................................................................................................................................17 Installing Racadm...................................................................................................................................................17 Supported RACADM Interfaces..................................
PAGE 4
getfanreqinfo..........................................................................................................................................................46 getioinfo..................................................................................................................................................................48 getkvminfo..............................................................................................................................................................
PAGE 5
setractime...............................................................................................................................................................90 setslotname............................................................................................................................................................92 setsysinfo................................................................................................................................................................
PAGE 6
cfgDNSServer1 (Read/Write).........................................................................................................................117 cfgDNSServer2 (Read/Write).........................................................................................................................117 cfgNicEnable (Read/Write)............................................................................................................................117 cfgNicIpAddress (Read/Write).............................
PAGE 7
cfgSsnMgtConsRedirMaxSessions (Read/Write)..........................................................................................129 cfgSsnMgtWebserverTimeout (Read/Write).................................................................................................129 cfgSsnMgtSshIdleTimeout (Read/Write).......................................................................................................129 cfgSsnMgtTelnetIdleTimeout (Read/Write).......................................................
PAGE 8
cfgRacTuneDaylightOffset (Read Only)..........................................................................................................140 cfgRacTuneTimezoneOffset (Read Only).......................................................................................................141 cfgRacTuneLocalServerVideo (Read/Write)..................................................................................................141 cfgRacTuneLocalConfigDisable (Read/Write).........................................
PAGE 9
cfgADSCLEnable............................................................................................................................................152 cfgADSSOEnable (Read/Write)......................................................................................................................152 cfgADDomainController.................................................................................................................................153 cfgADDomainController1 (Read/Write)................
PAGE 10
cfgLocationAisle (Read/Write).......................................................................................................................162 cfgLocationRack (Read/Write).......................................................................................................................163 cfgLocationRackslot (Read/Write).................................................................................................................163 cfgLocationDevicesize (Read Only)...........................
PAGE 11
cfgIpmiSolMinPrivilege (Read/Write)............................................................................................................172 cfgIpmiSolAccumulateInterval (Read/Write).................................................................................................172 cfgIpmiSolSendThreshold (Read/Write)........................................................................................................172 cfgIpmiLan.....................................................................
PAGE 12
cfgServerPowerLastHourMinTime (Read Only).............................................................................................180 cfgServerPowerLastHourMaxPower (Read Only).........................................................................................180 cfgServerPowerLastHourMaxTime (Read Only)............................................................................................180 cfgServerPowerLastDayMinPower (Read Only).............................................................
PAGE 13
cfgIPv6AutoConfig (Read/Write)....................................................................................................................190 cfgIPv6LinkLocalAddress (Read Only)...........................................................................................................190 cfgIPv6Address2 (Read Only).........................................................................................................................190 cfgIPv6Address3 (Read Only).....................................
PAGE 14
cfgIpmiSerial.........................................................................................................................................................198 cfgIpmiSerialBaudRate (Read/Write).............................................................................................................198 cfgIpmiSerialConnectionMode (Read/Write).................................................................................................199 cfgIpmiSerialChanPrivLimit (Read/Write)...............
PAGE 15
cfgRacSecurity.....................................................................................................................................................208 cfgRacSecCsrCommonName (Read/Write)...................................................................................................208 cfgRacSecCsrOrganizationName (Read/Write).............................................................................................208 cfgRacSecCsrOrganizationUnit (Read/Write)............................
PAGE 16
System.Power.EnergyConsumption.StarttimeStamp.....................................................................................218 System.Power.PCIeAllocation (Read/Write)..................................................................................................218 System.Power.Supply...........................................................................................................................................218 System.Power.Supply.[i].MaxInputPower (Read Only).........................
PAGE 17
Introduction 1 This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions for the following: • iDRAC Enterprise or Express for Blade Servers • iDRAC Enterprise or Express on Rack and Tower Servers • Dell Chassis System (CMC) Installing Racadm For information on installing and unistalling RACADM, see the Dell OpenManage Server Administrator Installation Guide at support.dell.com/manuals.
PAGE 18
Example racadm getconfig -g idracinfo racadm getsysinfo 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 -p getconfig -g idracinfo racadm -r -u -p getsysinfo RACADM Command Options Table 1‑1 lists the options for the RACADM command.
PAGE 19
Option Description -o objectname Specifies the object name if applicable. The following table provides the supported RACADM interfaces for iDRAC Enterprise and iDRAC Express. iDRAC Type Local RACADM SSH/Telnet RACADM Remote RACADM iDRAC Enterprise Yes Yes Yes iDRAC Express Yes Yes Yes CMC No Yes Yes NOTE: Multiple instances of remote RACADM can be executed on a management station, while only one instance of local RACADM can be executed on a managed node.
PAGE 20
Subcomma nd iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC featurecard No No No No No No Yes Yes fwupdate Yes Yes Yes Yes Yes Yes Yes Yes get Yes Yes Yes Yes Yes Yes No No getassettag No No No No No No Yes Yes getchassisn No ame No No No No No Yes Yes getconfig Yes Yes Yes Yes Yes Yes Yes Yes getdcinfo No No No No No No Yes Yes getfanreqinf No o No No No No No Yes Yes getflexaddr No No No No No No Yes Yes getioinfo
PAGE 21
Subcomma nd iDRAC on Blade Servers iDRAC on Rack and Tower Servers CMC getuscversi Yes on Yes Yes Yes Yes Yes No No "help" and Yes "help Yes Yes Yes Yes Yes Yes Yes hwinventor y Yes Yes Yes Yes Yes Yes No No ifconfig Yes Yes Yes Yes Yes Yes Yes Yes krbkeytabu pload Yes Yes Yes Yes Yes Yes No Yes lclog Yes Yes Yes Yes Yes Yes No No license Yes Yes Yes Yes Yes Yes No No netstat Yes Yes Yes Yes Yes Yes Yes Yes nicstatistics
PAGE 22
Subcomma nd iDRAC on Blade Servers sslcertdow nload No Yes sslcertuplo ad No iDRAC on Rack and Tower Servers CMC Yes No Yes Yes No Yes Yes Yes No Yes Yes No Yes sslcertview Yes Yes Yes Yes Yes Yes Yes Yes sslcsrgen Yes Yes Yes Yes Yes Yes Yes Yes sslkeyuploa No d Yes Yes No Yes Yes No No sslresetcfg Yes Yes Yes Yes Yes Yes Yes Yes testemail Yes Yes Yes Yes Yes Yes Yes Yes testfeature No No No No No No Yes Yes testtrap Yes Yes Yes
PAGE 23
• The Dell OpenManage Server Administrator’s User’s Guide provides information about installing and using Dell OpenManage Server Administrator. • The Dell Update Packages User's Guide provides information about obtaining and using Dell Update Packages as part of your system update strategy. • The Glossary provides information about the terms used in this document.
PAGE 24
PAGE 25
RACADM Subcommand Details 2 This section provides detailed descriptions of the RACADM subcommands including the syntax and valid entries.
PAGE 26
• A single quote cannot be used even with a backslash escaped. NOTE: An empty string may be specified as either "" (using double quotes) or '' (using single quotes). "?"and "?" Description Displays all the subcommands you can use with the RACADM command and a one-line description of each subcommand. ? followed by displays the syntax for the specified command. To use this subcommand, you must have CMC Login User privilege.
PAGE 27
-d -c -A -4 -6 : : : : : show CMC information show chassis information do not show headers or labels show CMC IPv4 information show CMC IPv6 information help and help subcommand Description Synopsis Input Output Lists all the subcommands available to use with RACADM and provides a short description for each. You may also type a subcommand, group, object, or FQDD alias after help, to get the syntax for the specified keyword.
PAGE 28
Output IP Address HW Type Flags HW Address Mask Device 192.168.1.1 0x1 0x2 00:00:0C:07:AC:0F * eth0 chassisaction Description Executes a power action on the chassis, iKVM, or a server. To use this subcommand, you must have Chassis Control Administrator privilege Synopsis racadm chassisaction [-m ] Input • -m — Module on which you want to carry out the action. Values are: — chassis - this is the default value if -m is not specified.
PAGE 29
Input None Output None Example None closessn Description Closes a communication session on the device. Use getssninfo to view a list of sessions that can be closed using this command. To use this subcommand, you must have Administrator permission. Synopsis Input • • • racadm closessn –i racadm closessn -a racadm closessn -u • -i — The session ID of the session to close, which can be retrieved using racadm getssninfo subcommand.
PAGE 30
cmcchangeover Description Changes the state of the CMC from active to standby, or vice versa, in a redundant CMC configuration. This subcommand is useful for remote debugging or testing purposes. To use this subcommand, you must have 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.
PAGE 31
• Output -c — The -c, or check option, is used with the config subcommand and allows the user to parse the .cfg file to locate syntax errors. If errors are found, the line number and a short description of what is incorrect are displayed. Write permission does not apply to iDRAC. This option is a check only. 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.
PAGE 32
• Another critical condition occurs on iDRAC. In this case, the coredump information is relative to the last critical error that occurred. This option is applicable only for iDRAC. To use this subcommand, you must have Execute Debug Commands permission See the coredumpdelete subcommand for more information about clearing the coredump. Synopsis racadm coredump Input None Output None Example • • racadm coredump No Core Dump Data is currently available.
PAGE 33
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 Server Administrator privilege. NOTE: You can also use setniccfg to configure static IP address, subnet mask, and gateway, as well as DHCP, speed, and duplex properties.
PAGE 34
Example • • • racadm deploy -m server-8 -s 192.168.0.20 255.255.255.0 192.168.0.1 The server was deployed successfully. The deploy command generates an error when used on the extension slot of a multi-slot server. racadm deploy -m server-9 192.168.0.11 255.255.255.0 192.168.0.1 ERROR: Server in slot 9 is an extension of the server in slot 1. racadm deploy -m server-7 -u root -p calvin -s -6 ::/64 :: 10 feature Description Displays all active chassis features.
PAGE 35
featurecard Description Verifies proper SD card installation and displays the SD card status. To use this subcommand, you must have Chassis Configuration Administrator privilege. Synopsis racadm featurecard -s Input -s — Lists active SD card features and SD card status. Output • • • • • Example No feature card inserted — Action: Check the CMC to verify that the SD card was properly inserted.
PAGE 36
fwupdate Description Allows you to update the firmware on the iKVM, active CMC, standby CMC, server iDRACs, or an IOM infrastructure device. You can: • • • • • Check the firmware update process status. Update iDRAC or CMC firmware from a FTP or a TFTP server by providing an IP address and optional path. Update iDRAC or CMC firmware from the local file system using Local and Remote RACADM. Rollback to the standby firmware.
PAGE 37
For Remote RACADM: racadm 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. If you do not provide a full path, then the CMC searches the home directory of the specified user for the file if the host system is running Linux or another variant of UNIX.
PAGE 38
• This option is applicable only for CMC. -m — Specifies the module or device to be updated. is one of the following values: — cmc-active (default) — cmc-standby — kvm — server-nx where n=1-8 ; x = a,b,c,d — server-generation where generation = iDRAC or iDRAC6 only. — iominf-n where n = 1–6 NOTE: iDRAC7 targets are not supported from CMC. Use the CMC GUI to update iDRAC7 targets from CMC. CMC version 3.
PAGE 39
• Download firmware update file from a specified location on the TFTP server at a specific IP address. racadm fwupdate -g -u -a 143.166.154.143 -d After the image file is downloaded from the TFTP server, the update process begins. When completed, iDRAC is reset. • Read the current status of the firmware update. racadm fwupdate -s NOTE: Firmware update from local racadm (using -p -u -d options) is not supported on linux OS. NOTE: For CMC, these commands specifically apply to an active-CMC update.
PAGE 40
• • • • • • Examples — Specifies the group containing the object that is to be read.