Reference Guide

ManualsBrandsDell ManualsActive System ManageriDRAC7 with Lifecycle Controller Version 2.10.10.10

Integrated Dell Remote Access Controller 8

(iDRAC8) and iDRAC7 Version 2.10.10.10

RACADM Command Line Interface Reference

Guide

Summary of content (504 pages)

PAGE 1
Integrated Dell Remote Access Controller 8 (iDRAC8) and iDRAC7 Version 2.10.10.
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.........................................................................................................10 What’s New in This Release................................................................................................................ 10 Supported RACADM Interfaces........................................................................................................... 11 RACADM Syntax Usage..................................................................................
PAGE 4
getniccfg............................................................................................................................................. 44 getraclog............................................................................................................................................. 45 getractime........................................................................................................................................... 47 getsel.............................................
PAGE 5
systemerase........................................................................................................................................117 systemperfstatistics............................................................................................................................117 techsupreport.................................................................................................................................... 118 testemail......................................................
PAGE 6
cfgIPv6LanNetworking..................................................................................................................... 188 cfgIpv6StaticLanNetworking.............................................................................................................193 cfgIPv6URL........................................................................................................................................ 195 cfgIpmiSerial...................................................................
PAGE 7
iDRAC.LDAPRoleGroup.................................................................................................................... 286 iDRAC.LocalSecurity......................................................................................................................... 287 iDRAC.Logging..................................................................................................................................288 iDRAC.NIC.......................................................................
PAGE 8
BIOS.OneTimeBoot.......................................................................................................................... 360 BIOS.ProcSettings............................................................................................................................. 362 BIOS.ProxyAttributes.........................................................................................................................378 BIOS.PxeDevice1Settings......................................................
PAGE 9
B Legacy and New Groups and Objects.......................................................... 491 cfgSSADRoleGroupPrivilege (Read or Write)...................................................................................
PAGE 10
Introduction 1 This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions for the following: • iDRAC for Blade Servers • iDRAC on Rack and Tower Servers Most of the commands mentioned in this document are applicable for multi-generation servers. That is, the commands are applicable for iDRAC6, iDRAC7, and iDRAC8.
PAGE 11
• Support for patrol read in unconfigured areas using the Storage.Controller.PatrolReadUnconfiguredArea attribute. • Support to modify the controller mode to RAID or HBA using the Storage.Controller.RequestedControllerMode attribute. • Support to indicate the web server encryption state using the iDRAC.WebServer.SSLEncryptionBitLength attribute. • Support to indicate the VNC server encryption state using the iDRAC.VNCServer.SSLEncryptionBitLength attribute.
PAGE 12
Example racadm getsysinfo racadm -r 192.168.0 -u username -p xxx getsysinfo racadm -r 192.168.0 -u username -p xxx getconfig -g cfgchassispower Remote RACADM racadm -r -u -p Example racadm -r 192.168.0 -u root -p xxxx getsysinfo Security Alert: Certificate is invalid - Certificate is not signed by Trusted Third Party Continuing execution. NOTE: The following command does not display a security error: racadm -r 192.168.
PAGE 13
Option Description -r Specifies the controller’s IP address. -r -r : Specifies the controller’s remote IP address. 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. If the-u option is used, the -p option must be used, and the -i option (interactive) is not allowed.
PAGE 14
. . . . . . . vflashsd vflashpartition vmdisconnect cd quit • Example 2: racadm> get • Example 2: racadm> get get getconfig getled getniccfg getraclog getractime getsel getsensorinfo getssninfo getsvctag getsysinfo gettracelog getversion • Example 3: racadm> getl racadm> getled or LEDState: Not-Blinking • Example 3 racadm> getv Bios Version = 1.5.0 iDRAC Version = 1.40.40 USC Version = 1.1.5.
PAGE 15
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers Telnet/SSH/ Serial Local Remote Telnet/SSH Local RACAD RACAD /Serial RACAD M M M Remot e RACAD M clearpending Yes Yes Yes Yes Yes Yes closessn Yes Yes Yes Yes Yes Yes clrsel Yes Yes Yes Yes Yes Yes config Yes Yes Yes Yes Yes Yes coredump Yes Yes Yes Yes Yes Yes coredumpdelete Yes Yes Yes Yes Yes Yes diagnostics Yes Yes Yes Yes Yes Yes eventfilters Yes Yes Yes Yes Yes Yes fcstatisti
PAGE 16
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers Telnet/SSH/ Serial Local Remote Telnet/SSH Local RACAD RACAD /Serial RACAD M M M Remot e RACAD M krbkeytabupload No Yes Yes No Yes Yes lclog Yes Yes Yes Yes Yes Yes license Yes Yes Yes Yes Yes Yes nicstatistics Yes Yes Yes Yes Yes Yes ping Yes Yes Yes Yes Yes Yes ping6 Yes Yes Yes Yes Yes Yes racdump Yes No Yes Yes Yes Yes racreset Yes Yes Yes Yes Yes Yes racresetcfg Yes Yes Yes
PAGE 17
Subcommand iDRAC on Blade Servers iDRAC on Rack and Tower Servers Telnet/SSH/ Serial Local Remote Telnet/SSH Local RACAD RACAD /Serial RACAD M M M Remot e RACAD M testtrap Yes Yes Yes Yes Yes Yes testalert Yes Yes Yes Yes Yes Yes traceroute Yes Yes Yes Yes Yes Yes traceroute6 Yes Yes Yes Yes Yes Yes update Yes Yes Yes Yes Yes Yes usercertupload No Yes Yes No Yes Yes usercertview Yes Yes Yes Yes Yes Yes vflashsd Yes Yes Yes Yes Yes Yes vflashparti
PAGE 18
• Release notes or readme files may be included to provide last-minute updates to the system or documentation or advanced technical reference material intended for experienced users or technicians. • For more information about IOM network settings, see the Dell PowerConnect M6220 Switch Important Information document and the Dell PowerConnect 6220 Series Port Aggregator White Paper. Updates are sometimes included with the system to describe changes to the system, software, and/or documentation.
PAGE 19
Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues: 1. Go to dell.com/support. 2. Select your support category. 3. Verify your country or region in the Choose a Country/Region drop-down list at the bottom of the page. 4. Select the appropriate service or support link based on your need.
PAGE 20
RACADM Subcommand Details 2 This section provides detailed description of the RACADM subcommands including the syntax and valid entries.
PAGE 21
For using single quotation marks: • No character escaping is necessary. • A single quotation mark is not used even with a backward slash escaped. NOTE: An empty string may be specified as either ” “(using double quotation marks) or ' '(using single quotation marks). help and help subcommand Description Lists all the subcommands available for use with RACADM and provides a short description about each subcommand.
PAGE 22
Input N/A Example racadm arp Output Address HW Type HW Address Mask Device 192.168.1.1 Ether 00:0d: 65:f3:7c:bf C eth0 autoupdatescheduler Description You can automatically update the firmware of the devices on the server. To run this subcommand, you must have the Server Control privilege. NOTE: • • • • • • • Synopsis The autoupdatescheduler subcommand can be enabled or disabled. Lifecycle Controller and CSIOR may not be enabled to run this subcommand.
PAGE 23
• • • • • • • • • • NOTE: If the file is in a subfolder within the share location, then enter the network share location in the –l option and enter the subfolder location and the filename in the –f option. -ph — Specifies the FTP/HTTP proxy host name. -pu — Specifies the FTP/HTTP proxy user name. -pp — Specifies the FTP/HTTP proxy password. -po — Specifies the FTP/HTTP proxy port. -pt — Specifies the FTP/HTTP proxy type. -time — Specifies the time to schedule an autoupdate in the HH:MM format.
PAGE 24
– For HTTP, run the command: racadm autoupdatescheduler create -u httpuser -p httppwd l http://test.com -f cat.xml -ph 10.20.30.40 -pu padmin -pp ppwd -po 8080 -pt http -time 14:30 -dom 1 -rp 5 -a 1 – For TFTP, run the command: racadm autoupdatescheduler create -l tftp://1.2.3.4 -f cat.xml.gz -time 14:30 -dom 1 -rp 5 -a 1 – To view AutoUpdateScheduler parameter: racadm autoupdatescheduler view hostname = 192.168.0 sharename = nfs sharetype = nfs catalogname = Catlog.
PAGE 25
– Input: racadm/power> cd.. – Output: system>> • Example 2: To traverse back from system object to the prompt: – Input:racadm/system> cd.. – Output: racadm>> clearasrscreen Description Clears the last crash (ASR) screen that is in memory. For more information, see "Enabling Last Crash Screen" section in the iDRAC User’s Guide. NOTE: To run this subcommand, you must have the Clear Logs permission. Synopsis racadm clearasrscreen Input None Output Clears the last crash screen buffer.
PAGE 26
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 run this subcommand, you must have the Administrator permission NOTE: This subcommand ends all the sessions other than the current session.
PAGE 27
config Description Allows you to set iDRAC configuration parameters individually or to batch them as part of a configuration file and then modify CMC configuration properties. If the data is different, the iDRAC object is written with a new value. NOTE: This subcommand will be deprecated in the later versions. For information about configurations, see the set subcommand.
PAGE 28
– server- — where n = 1–8; x = a to d (lower case) NOTE: Only available for cfgRemoteHosts, cfgRacTuning, cfgSerial, cfgSessionManagement, cfgLanNetworking or cfgIPv6LanNetworking. Output Examples This subcommand generates error output for any of the following reasons: • • Invalid syntax, group name, object name, index or other invalid database members. If the RACADM command-line interface is unsuccessful. • To set the cfgNicIpAddress configuration parameter (object) to the value 192.168.0.
PAGE 29
NOTE: To use this subcommand, you must have the Execute Debug privilege. Synopsis racadm coredump Example • racadm coredump There is no coredump currently available.
PAGE 30
• • • • • • • The results of the latest successfully executed remote Diagnostics will be available and retrievable remotely through an NFS or a CIFS share. – 0(Express) — The express mode executes a subset of diagnostic tests. – 1(Extended) — The extended mode executes all available diagnostics tests. – 2(Both) — Runs express and extended tests serially in sequence. -f — Specifies the name of the configuration file. -l — Specifies the location of the network share (NFS or CIFS).
PAGE 31
To use this subcommand with the set and test option, you must have the Administrator privilege. Synopsis racadm eventfilters racadm eventfilters get -c racadm eventfilters set -c -a -n racadm eventfilters set -c -a -r racadm eventfilters test -i NOTE: The general format of an alert category: idrac.alert.category.[subcategory].
PAGE 32
• • -r — Event generation interval. This option is applicable only to the temperature statistics subcategory tmps. You can use this option as a stand-alone or with -n and -a. NOTE: If both event generation interval and notifications are configured and there is an error while configuring the notifications, the event generation interval is not set. The valid values are 0–365. 0 disables the event generation. Example 32 • Display all available event filter configurations: racadm eventfilters get -c idrac.
PAGE 33
fcstatistics Description Displays a list of FCs (FQDDs), managed server for which statistics is available. Synopsis racadm fcstatistics Input — Specify the FQDD of the target FC device. Example racadm fcstatistics frontpanelerror Description Enables or disables the live-feed of the errors currently being displayed on the LCD screen. For error acknowledge use hide, and error assert use show.
PAGE 34
To use this subcommand, you must have Configure iDRAC permission. To use this subcommand, you must have the Chassis Configuration Administrator privilege. NOTE: The fwupdate command is not supported for iDRAC7 or later. Use the CMC GUI to perform the operation. NOTE: • • • • Running the fwupdate subcommand to update the firmware on the active CMC resets itself and all the network connections are dropped.
PAGE 35
For Remote RACADM: racadm fwupdate -p -u -d [-m ] racadm fwupdate -g -u -a 192.168.0 -d firmimg.cmc -m cmc-active 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 full path is not provided and the host system is running Linux or another variant of UNIX , then CMC searches the home directory of the specified user for the file. If the host system is running Windows, then a default folder, such as C:\ftproo
PAGE 36
NOTE: The-p option is supported on local and remote RACADM and is not supported with the serial/Telnet/ssh console and on the Linux operating systems. • -r — The rollback option is used to roll back to the standby firmware. • -p — Stops the current firmware update of a module. NOTE: This option is only supported on the remote interface(s). • -m — Specifies the module or device to be updated.
PAGE 37
racadm fwupdate –g –u –a 192.168.0 –d firming-4.40-A00.cmc –m cmc-active Firmware update has been initiated. This update process may take several minutes to complete. racadm fwupdate –s Cannot update local CMC firmware: The uploaded firmware image does not support the installed power supplies. • Upload the firmware image from the FTP server and start the firmware update. racadm fwupdate -f 192.168.0.100 fred xxx -d firmimg.
PAGE 38
The following table describes the firmware update method supported for each interface.
PAGE 39
To run this subcommand for configuration xml file type, the Lifecycle Contoller version 1.1 or later is required. Synopsis racadm get -f racadm get ....