New in This Release............................................................................................................................................................7
SSH, Telnet, or Remote RACADM.................................................................................................................................7
SSH or Telnet RACADM............................................................................................................................................... 8
Other Documents You May Need...................................................................................................................................... 11
Accessing documents from Dell support site......................................................................................................................11
Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands........................................13
racadm ? and ? subcommand ..........................................................................................................................................13
help and help subcommand...............................................................................................................................................15
cfgNicIPv4Enable (Read or Write)..............................................................................................................................86
cfgRacTuneEnhancedLog (Read or Write)................................................................................................................105
cfgSSADRoleGroupName (Read or Write).................................................................................................................121
cfgSSADRoleGroupDomain (Read or Write)..............................................................................................................122
cfgSSADRoleGroupPrivilege (Read or Write)............................................................................................................ 122
cfgThermalMFSPercent (Read or Write)................................................................................................................... 131
cfgLcdLocale (Read or Write)................................................................................................................................... 132
NOTE: In this version of RACADM, the Linux shell features such as ctrl+d, home, del, and end shortcut keys are not
supported.
This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database
groups and object denitions for Dell Chassis System (CMC).
New in This Release
•Added the cfgQuickDeploy group.
•Added the eventlters command.
•Added the cfgTrapsSNMPv3UserId and cfgTrapsSNMPv3UserName properties to the cfgTraps group.
•Added the cfgChassisACPowerRecoveryDisable property to the cfgChassisPower group.
•Added the cfgRacTuneFipsModeEnable and cfgRacTuneTLSProtocolVersionEnable property to the cfgRacTuning group.
•Added the cfgOobSnmpProtocol and cfgOobSnmpTrapFormat properties to the cfgOobSnmp group.
Supported RACADM Interfaces
The RACADM command-line utility provides a scriptable interface that allows you to locally congure or remotely congure your
CMC. The utility runs on the management station and the managed system. It is available on the Dell OpenManage Systems
Management and Documentation DVD or at dell.com/support.
1
The RACADM utility supports the following interfaces:
•SSH or Telnet — Also known as Firmware RACADM. Firmware RACADM is accessible by logging in to CMC using SSH or Telnet.
Similar to Remote RACADM, at the RACADM prompt, directly run the commands without the RACADM prex.
•Remote — Supports running RACADM commands from a remote management station such as a laptop or desktop. To run
Remote RACADM commands, install the DRAC Tools utility from the OpenManage software on the remote computer. To run
Remote RACADM commands:
– Formulate the command as a SSH or Telnet RACADM command.
For more information about the options, see RACADM Subcommand Details. To download the local RACADM tool from
dell.com/support, click Servers, Storage & Networking in the General Support section. Click PowerEdge, click the required
PowerEdge system, and then click Drivers & downloads.
RACADM Syntax Usage
The following section describes the syntax usage for SSH or Telnet, and Remote RACADM.
racadm -r 192.168.0.2 -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:
The following table lists the options for the RACADM command:
Table 1. RACADM Command Options
OptionDescription
-r <cmcIpAddr>
-u <username>
-p <password>
--nocertwarn
-i <indexnumber>
-g <groupname>
-o <objectname>
Species the controller’s IP address.
Species 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.
Species the password used to authenticate the command
transaction. If the -p option is used, the -i option is not allowed.
Does not display certicate related warning message.
Species the index number for the indexed group, if applicable.
Species the group name if applicable.
Species the object name if applicable.
Supported RACADM Subcommands
The following table provides the list of RACADM subcommands and their corresponding interface support. For more information
about the RACADM subcommands including syntax and valid entries, see RACADM Subcommand Details.
8
SubcommandCMC
Telnet/SSH/SerialRemote RACADM
"?" and "? <subcommand>" YesYes
help and help subcommandYesYes
arpYesYes
chassisactionYesYes
chassislogYesYes
closessnYesYes
clrraclogYesYes
clrselYesYes
cmcchangeoverYesYes
congYesYes
connectYesYes
deployYesYes
featureYesYes
featurecardYesYes
fwupdateYesYes
getYesYes
getactiveerrorsYesYes
getarraycfgYesYes
getassettagYesYes
getchassisnameYesYes
getcongYesYes
getdcinfoYesYes
getfanreqinfoYesYes
getexaddrYesYes
getioinfoYesYes
getkvminfoYesYes
getledYesYes
getmacaddressYesYes
getmodinfoYesYes
getniccfgYesYes
getpbinfoYesYes
getpminfoYesYes
getraclogYesYes
getractimeYesYes
getredundancymodeYesYes
9
SubcommandCMC
Telnet/SSH/SerialRemote RACADM
getselYesYes
getsensorinfoYesYes
getslotnameYesYes
getssninfoYesYes
getsvctagYesYes
getsysinfoYesYes
gettracelogYesYes
getversionYesYes
help and help subcommandYesYes
ifcongYesYes
krbkeytabuploadNoYes
netstatYesYes
pingYesYes
ping6YesYes
racdumpYesYes
racresetYesYes
racresetcfgYesYes
remoteimageYesYes
setYesYes
serveractionYesYes
setarraycfgYesYes
setassettagYesYes
setchassisnameYesYes
setexaddrYesYes
setledYesYes
setniccfgYesYes
setractimeYesYes
setslotnameYesYes
setsysinfoYesYes
sshpkauthYesYes
sslcertdownloadNoYes
sslcertuploadNoYes
sslcertviewYesYes
sslcsrgenYesYes
sslresetcfgYesYes
10
SubcommandCMC
Telnet/SSH/SerialRemote RACADM
testemailYesYes
testfeatureYesYes
testtrapYesYes
tracerouteYesYes
traceroute6YesYes
Other Documents You May Need
In addition to this guide, you can access the following guides available on the Dell Support website at www.dell.com/esmmanuals.
To access the documents, click the appropriate product link.
•The Chassis Management Controller User’s Guide provides information about conguring and using CMC to remotely manage
and monitor your system and its shared resources through a network.
•The Chassis Management Controller Online Help provides information about using the CMC Web interface.
•The Chassis System (CMC) Secure Digital (SD) Card Technical Specication provides minimum BIOS and rmware version,
installation and usage information.
•Documentation specic to your third-party management console application.
•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.
The following system documents are also available to provide more information about the system in which iDRAC is installed:
•The Rack Installation Guide and Rack Installation Instructions included with your rack solution describe how to install your
system into a rack.
•The Hardware Owner’s Manual provides information about system features and describes how to troubleshoot the system and
install or replace system components.
•Documentation for any components you purchased separately provides information to congure and install the options.
•Release notes or readme les 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. Always read
the updates rst because they often supersede information in other documents.
See the Safety and Regulatory information that is shipped with your system.
NOTE: Warranty information may be included within this document or as a separate document.
Accessing documents from Dell support site
You can access the required documents in one of the following ways:
•Using the following links:
– For all Enterprise Systems Management documents — Dell.com/SoftwareSecurityManuals
11
– For OpenManage documents — Dell.com/OpenManageManuals
– For Remote Enterprise Systems Management documents — Dell.com/esmmanuals
– For iDRAC and Lifecycle Controller documents — Dell.com/idracmanuals
– For OpenManage Connections Enterprise Systems Management documents — Dell.com/
OMConnectionsEnterpriseSystemsManagement
– For Serviceability Tools documents — Dell.com/ServiceabilityTools
– For Client Command Suite Systems Management documents — Dell.com/DellClientCommandSuiteManuals
•From the Dell Support site:
a.Go to Dell.com/Support/Home.
b.Under Select a product section, click Software & Security.
c.In the Software & Security group box, click the required link from the following:
– Enterprise Systems Management
– Remote Enterprise Systems Management
– Serviceability Tools
– Dell Client Command Suite
– Connections Client Systems Management
d.To view a document, click the required product version.
•Using search engines:
– Type the name and version of the document in the search box.
Contacting Dell
NOTE: If you do not have an active Internet connection, you can nd contact information on your purchase invoice,
packing slip, bill, or Dell product catalog.
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.
12
2
RACADM Subcommand Details
This section provides detailed description of the RACADM subcommands including the syntax and valid entries.
Guidelines to Quote Strings Containing Special Characters When Using
RACADM Commands
When using strings that contain special characters, use the following guidelines:
Strings containing the following special characters must be quoted using double quotation marks:
•$ (dollar sign)
•" (double quotation mark)
•` (backward quotation mark)
•\ (backward slash)
•~ (tilde)
•| (vertical bar)
•( (left parentheses)
•) (right parentheses)
•& (ampersand)
•> (greater than)
•< (less than)
•# (pound)
•ASCII code 32 (space)
There are dierent escaping rules for double quotation marks.
For using double quotation marks:
The following characters must be escaped by prepending a backward slash:
•$ (dollar sign)
•" (double quotation mark)
•` (back quotation mark)
racadm ? and ? subcommand
Description
Displays all the subcommands you can use with the RACADM command and a one-line description about each
subcommand.
? followed by <subcommand> displays the syntax for the specied command.
To use this subcommand, you must have the CMC Login User privilege.
13
You can also use the help and help <subcommand> commands to obtain the same information.
Synopsis
Input
Output
Example for RACADM?
The following output example shows the actual output for the RACADM? command. Descriptions shown in this example may vary
slightly from the descriptions in your RACADM session.
racadm ?
help -- list racadm subcommand description
help <subcommand> -- display usage summary for a subcommand
? -- list racadm subcommand description
? <subcommand> -- display usage summary for a subcommand
arp -- display the networking arp table
chassisaction -- execute power-up/down/cycle or reset operation
chassislog -- display the chassislog
closessn -- close a session
clrraclog -- clear the CMC log
clrsel -- clear the System Event Log (SEL)
cmcchangeover -- changes the redundant state of the CMC from active to standby and vice
versa
config -- modify CMC configuration properties
connect -- connect to switch or blade serial console
deploy -- deploy blade or IOM by specifying required properties
feature -- display features active on the chassis / feature deactivation
featurecard -- feature card status and list the available features
fwupdate -- update the firmware on a CMC, server, IOM inf or KVM
get -- save CMC configuration properties to a file
getactiveerrors -- display CMC active errors
getassettag -- display asset tag
getchassisname -- get the chassisname
getconfig -- display CMC configuration properties
getdcinfo -- display general I/O module and DC configuration information
getfanreqinfo -- display fan request information for Servers and Switches
getflexaddr -- display Flexaddress enablement status for all slots and fabrics.
getioinfo -- display general IO information and stack information
getkvminfo -- display the KVM module information
getled -- display the LED settings on a module
getmacaddress -- get MAC/WWN addresses
getmodinfo -- get module configuration and status information
getniccfg -- display network settings for modules
getpbinfo -- get power budget status information
getpminfo -- get power management status information
getraclog -- display the CMC log
getractime -- display the current CMC time
getredundancymode -- gets the redundancy mode of the CMC
getsel -- display records from the System Event Log (SEL)
getsensorinfo -- display system sensors
getslotname -- gets the name of the slot in the chassis
getssninfo -- display session information
getsvctag -- display service tag information
getsysinfo -- display general CMC and system information
gettracelog -- display the CMC diagnostic trace log
getversion -- display version information for modules
getarraycfg -- display's storage array properties
ifconfig -- display network interface information
jobqueue -- Jobqueue of the jobs currently scheduled
krbkeytabupload -- upload an Kerberos Keytab to the CMC
netstat -- display routing table and network statistics
racadm ?
racadm ? <subcommand>
N/A
N/A
14
ping -- send ICMP echo packets on the network
ping6 -- send ICMP echo packets on the network
racdump -- display CMC diagnostic information
racreset -- perform a CMC or RAC reset operation
racresetcfg -- restore the CMC configuration to factory defaults
remoteimage -- connect, disconnect or deploy a media file on a remote server
serveraction -- perform system power management operations
set -- import saved CMC configuration from a file
setassettag -- set the asset tag for the specified module
setchassisname -- sets the name of the chassis
setflexaddr -- enable/disable the Flexaddress feature on a per fabric, per slot basis.
setled -- set state of the LEDs on a module
setniccfg -- modify network configuration properties
setractime -- set the time on the CMC
setslotname -- sets the name of the slot in the chassis
setsysinfo -- set the chassis name and chassis location
setarraycfg -- configure's storage array properties
sshpkauth -- manage PK Authentication keys and accounts
sslcertdownload -- download an SSL certificate from the CMC
sslcertupload -- upload an SSL certificate to the CMC
sslcertview -- display a CA/server certificate in the CMC
sslcsrgen -- generate a certificate CSR from the CMC
sslresetcfg -- generate a new self-signed certificate
testemail -- test CMC e-mail notifications
testfeature -- test CMC feature x
testtrap -- test CMC SNMP trap notifications
traceroute -- determine the route of a packet
traceroute6 -- determine the route of a packet
wsman -- perform wsman client functions for servers.
Example for RACADM? <subcommand>
racadm ? getsysinfo
getsysinfo -- display general CMC and system information
Usage:
racadm getsysinfo [-d] [-c] [-A] [-4] [-6]
Lists all the subcommands available for use with RACADM and provides a short description about each
subcommand. You may also type a subcommand, group, object or Fully Qualied Descriptor (FQDD) name after
help.
•racadm help
•racadm help <subcommand>
•racadm help —g <groupname>
•racadm help –g <groupname> —o <objectname>
•<subcommand> — species the subcommand for which you need the help information.
•<device name> — species the device name such as iDRAC, BIOS, NIC, LifecycleController, FC,
system, or Storage.
•<group> — species the group name supported by the corresponding device.
•<object> — species the object for the entered group.
15
Output
arp
•The help command displays a complete list of subcommands.
•The racadm help <subcommand> command displays information for the specied subcommand only.
•The racadm help —g <groupname> command displays information for the specied group.
•The racadm help —o <objectname> command displays information for the specied object.
•The racadm help <device name> <Group> command displays information for the specied group.
•The racadm help <device name> <Object> command displays information for the specied
object.
•The racadm help <device name> <Group> <Object> command displays information for the
specied object.
Description
Synopsis
InputN/A
Example
Output
Address
192.168.1.1Ether00:0d:65:f3:7c:bf Ceth0
Displays the contents of the Address Resolution Protocol (ARP) table. ARP table entries cannot be added or
deleted.
To use this subcommand, you must have Execute Diagnostic Commands.
racadm arp
racadm arp
HW Type HW Address Mask Device
chassisaction
Description
Synopsis
Input
Runs a power action on the chassis, KVM or a switch.
To use this subcommand, you must have the Chassis Control Administrator privilege.
racadm chassisaction [-m <module>] <action>
•-m <module> — Module on which you want to carry out the action. Values are:
16
•—chassis — is the default value if -m is not specied.
—switch-<n> where n=1–6
—kvm
•<action> — Action that you want to run on the specied module. Values are:
•—powerdown — (Chassis only) Powers down the chassis.
—powerup — (Chassis only) Powers up the chassis.
—powercycle — Power cycles the module.
NOTE: If a server takes longer duration to turn o gracefully after the chassis power cycle is
initiated, CMC stops functioning indicating that graceful shutdown of the server was
unsuccessful. In this case, turn o the system ungracefully or try to gracefully turn o the
system again.
—nongraceshutdown — (Chassis only) Turns o the chassis ungracefully.
—reset — Performs a hard reset of the module.
When <module> = kvm or switch, <action> must be powercycle or reset.
Output
Example
None
•Perform a reset of switch-3:
racadm chassisaction -m switch-3 reset
Module power operation successful.
•Perform a non graceful shutdown of the chassis:
racadm chassisaction -m chassis nongraceshutdown
chassislog
DescriptionDisplays chassis log and management operations.
– Enable the quick deploy parameter in CMC DNS Settings
racadm deploy -q -e 1
– Update quick deploy parameters
racadm deploy -q --qd
•clear — Clear chassis log
closessn
Description
– To clear chassis log
racadm chassislog clear
NOTE: To clear the chassis log, you must have the Clear Logs Administrator privilege.
NOTE: racadm chassislog export -f <filename> is supported only for remote interfaces.
Closes a communication session on the device. Use getssninfo to view a list of sessions that can be closed
using this command.
17
To run this subcommand, you must have the Administrator permission.
NOTE: This subcommand ends all the sessions other than the current session.
Synopsis
Input
Output
Example
clrraclog
•racadm closessn –i <session_ID>
•racadm closessn -a
•racadm closessn -u <username>
•—i <session_ID> — The session ID of the session to close, which can be retrieved using RACADM
getssninfo subcommand.
Session running this command cannot be closed.
•—a — Closes all sessions.
•—u <username> — Closes all sessions for a particular user name.
•For Remote RACADM, use either the —u option or the —i option.
Successful or error message is displayed.
•Closes the session 1234.
racadm closessn -i 1234
•Closes all the sessions other then the active session for root user.
racadm closessn –u root
•Closes all the sessions.
racadm closessn –a
Description
Synopsis
InputN/A
Deletes the CMC log.
racadm clrraclog
clrsel
Description
Synopsis
Input-m <module> must be one of the following values:
Example
Removes all the existing records from the System Event Log (SEL).
To use this subcommand, you must have Clear Logs permission.
racadm clrsel [-m <module>]
•server-<n> — where n=1 to 16
•server-<nx> — where n=1 to 8; x = a, b, c, d (lower case)
•racadm clrsel
The SEL was cleared successfully
•racadm clrsel -m server-1
Clear SEL log on server 1
18
cmcchangeover
DescriptionChanges the state of the CMC from active to standby, or from standby to active, in a redundant CMC
conguration. This subcommand is useful for remote debugging or testing purposes
To use this subcommand, you must have the Administrator privilege.
NOTE: This command is applicable only in redundant CMC environments. For more information, see
the "Understanding the Redundant CMC Environment" section of the
Guide.
Dell Chassis System User
Synopsis
Input
Output
Example
cong
Description
Synopsis
racadm cmcchangeover
N/A
CMC failover initiated successfully.
racadm cmcchangeover
Allows you to set CMC conguration parameters individually or to batch them as part of a congurationle and
then modify CMC conguration properties. If the data is dierent, the CMC object is written with a new value.
NOTE: This subcommand will be deprecated in the later versions. For information about
congurations, see the set subcommand.
•-f — The -f <filename> option causes cong to read the contents of the lespecied by
<filename> and congure CMC. The le must contain data in the format specied in the section Parsing
Rules in the
•-continue — This option is used with -f option only. If conguration through le is unsuccessful for a
group, then conguration continues with the next group in the le. If this option is not used, then conguration stops when it is unsuccessful for a particular group. After the unsuccessful group, the rest of
the groups are not congured.
•-p — This option must be used with the -f option. It directs cong to delete the password entries
contained in the congle-f <filename> after the conguration is complete.
To apply the password, you must remove the preceding Read-Only marker '#' in the congle before
executing the config -f command.
•-g — The -g <groupName>, or group option, must be used with the -o option. The <group>species
the group containing the object that is to be set.
CMC User’s Guide available at www.dell.com/esmmanuals.
NOTE: The -f option is not supported for the Serial or Telnet or SSH console.
19
•-o — The -o <objectName>, or object option, must be used with the -g option. This option species
the object name that is written with the string
•<value> — Value to set to conguration object.
•-i — The -i <index>, or index option, is valid only for indexed groups and can be used to specify a
unique group (used with -g and -o). The <index> is a decimal integer from 1 through n, where n can vary
from 1 to maximum number of indexes a particular group supports. If -i <index> is not specied, a value
of 1 is assumed for groups, which are tables that have multiple entries. The index is specied by the index
value, not a named value.
'nx' is allowed for servers.
-c — This option performs validation but do not congure.
•
•-m — Module must be one of the following values:
– server-<n> — where n = 1–16
– server-<nx> — 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.
racadm deploy -a [server/switch] -u root -p <password>
•
•racadm deploy -q [-n <numofblades>]
Input
•—b <device> — Species the rst boot device must be used with -o. Use with-m <module> to
specify for an individual server, or with an -a for all servers.
•-o no/yes — Indicates if the server must start from the device once. Use this option with -b option.
Use with -m <module> to specify for an individual server, or with -a for all servers.
•-a — server/switch. Applies options to all modules present in the chassis of the given module type.
Specify the value as server or switch. Default value is server. Switches must support Ethernet
Management.
•-u <username> — Indicates that the <password> is supplied for the root user on the server or
switch. Root is a constant parameter, the only value that is valid with the —u option.
•—m <module> — Species the server or switch you want to congure.
Legal values:
– server-<n>, where n=1–16
– server-<nx>, where n=1– 8; x = a,b,c,d (lower case)
– switch-<n>, where n=1– 6
•-p <password> — Species the password for the root user on the server or switch. For switches, valid
passwords are 6–32 ASCII characters in length, ranging in value 32–125 (decimal). For servers, valid
passwords are 1–20 ASCII characters in length, ranging in value 32–126 (decimal).
•-s <ipaddress> <subnet> <gateway> — Sets the IP address, subnet mask, and gateway for the
specied server.
21
•-d — Enables DHCP for the specied server.
•
•-v SNMPv2 <snmpCommunityString>ro — Species the SNMP community string for switches.
•-q — Displays or modies the quick deploy parameters.
•-n <numofblades> — Species the number of reserved IP addresses for quick deploy. The allowed
•-e — Uses the CMC DNS settings for quick deploy. The legal values are:
•--qd — Updates the quick deploy parameters to the servers. This option works only with the -q option.
OutputNone
– ipaddress — A string representing a valid IP address. For example, 192.168.0.20.
– subnet — A string representing a valid subnet mask. For example, 255.255.255.0.
– gateway — A string representing a valid gateway address. For example, 192.168.0.1.
The -s and -d options cannot be used together in the same command.
-6 — Enables IPv6 auto conguration (when used with -d). Sets static IPv6 addresses (when used with -
s).
Valid community strings are 1–20 characters in length, with valid ASCII characters in the range [33–125]
(decimal). Protocol version set to SNMPv2. Permission on community string is read-only.
values are: 8, 16, and 32.
NOTE: The -q option must be specied with the -n option.
– 1 — Enable
– 0 — Disable
Example
•Set root password, congure static IPV4 address, set rst boot device to HDD, and enable boot once for
server-1.
racadm deploy -a switch -u <username> -p <password>
•View the quick deploy parameters.
racadm deploy -q
•Modify the number of reserved IP addresses for quick deploy.
racadm deploy -q -n 8
eventlters
Table 4. eventlters
Description
22
Gets, sets, and displays the list of event lter settings.
To use this subcommand with the get option, you must have the CMC Login User privilege.
Synopsis
racadm eventfilters <eventfilters command type>
racadm eventfilters get -c <alert descriptor>
racadm eventfilters set -c <alert descriptor>-n <notifications>
NOTE: The general format of an alert descriptor:
cmc.alert.category.[subcategory].[severity]
where, category is mandatory, but subcategory and severity are optional. A severity
cannot precede a subcategory.
Valid category values are:
•All
•System
•Updates
•Audit
•Cong
Valid severity values are:
•Critical
•Warning
•Informational
Valid examples of alert descriptors are:
•cmc.alert.all
•cmc.alert.audit
•cmc.alert.audit.lic
•cmc.alert.audit.warning
•cmc.alert.audit.lic.critical
Input
Example
•get — Displays the list of event lter settings.
•set — Congures the actions and notications for a given event lter conguration.
•-c — Alert descriptor of the specic event lter.
•-n — The notication to be sent when the event occurs. Valid values are all, snmp, ipmi, lcd,
email, or none. You can append multiple notications separated by a comma. You cannot enter
the values all or none with other notications.
NOTE: If both event generation interval and notications are congured and there is an
error while conguring the notications, the event generation interval is not set. The
valid values are from 0–365. 0 disables the event generation.
•Display all available event ltercongurations:
nracadm eventfilters get -c cmc.alert.all
•Display eventltercongurations for a specic category. For example, audit:
racadm eventfilters get -c cmc.alert.audit
•Display eventltercongurations for a specic subcategory. For example, licensing under the
audit category:
racadm eventfilters get -c cmc.alert.audit.lic
•Display eventltercongurations for a specic severity. For example, warning under the audit
category:
racadm eventfilters get -c cmc.alert.audit.warning
23
•Display eventltercongurations for a specic severity and subcategory. For example, a
severity of warning in the subcategory licensing under audit category:
racadm eventfilters get -c cmc.alert.audit.lic.warning
•Clear all available alert settings:
racadm eventfilters set -c cmc.alert.all -n none
•Congure using severity as a parameter. For example, all informational events in storage
category are assigned powero as action, and email and snmp as notications:
racadm eventfilters set -c cmc.alert.storage.info -n email,snmp
•Congure using subcategory as a parameter. For example, all congurations under the licensing
subcategory in the audit category are assigned powero as action and all notications are
enabled:
racadm eventfilters set -c cmc.alert.audit.lic -n all
•Congure using subcategory and severity as parameters. For example, all Information events
under the licensing subcategory in the audit category are assigned powero as action and all
notications are disabled:
racadm eventfilters set -c cmc.alert.audit.lic.info -n none
feature
DescriptionDisplays 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 a feature. After any feature included on a Dell Feature Card is
activated on a chassis, any other features that may be included on that Dell Feature Card cannot be activated
on a dierent chassis.
Synopsis
Input
NOTE: To use this subcommand to deactivate FlexAddress, you must have the Chassis Conguration
Administrator privilege. A user with login privileges can view status only.
NOTE: To deactivate FlexAddress features, the chassis must be turned o.
•racadm feature -s
•racadm feature -d -c <featurename>
•racadm feature -r -c ExtendedStorage
-s
–Displays the status of active features.
-d
–Deactivates feature specied in -c option.
NOTE: When the FlexAddress and FlexAddressPlus feature are active, deactivating one of them
results in deactivation of the other feature also.
-1
—Congures extended storage feature for standalone use.
-2
—Congures extended storage feature for redundant use.
-r
24
—Reformats damaged or unformatted extended storage media.
CAUTION: Using the -r switch deactivates the extended storage feature, if active; reformats the SD
card in the active CMC card slot; and may Restart the active CMC.
-c
— <featurename> — must be one of the following:
•flexAddress
•flexAddressPlus
•ExtendedStorage (with -d, or -r)
NOTE: The —a option is not supported for CMC 5.0.
Example
•Display the current status of all chassis features:
racadm feature -s
•Deactivate the FlexAddressPlus feature on the chassis:
racadm feature -d -c FlexAddressPlus
featurecard
DescriptionVeries proper SD card installation and displays the SD card status.
To use this subcommand, you must have the Chassis Conguration Administrator privilege.
Synopsis
Input
Output
racadm featurecard -s
-s — Lists active SD card features and SD card status.
•No feature card inserted — Action: To verify that the SD card was properly inserted, check the
CMC. In a redundant CMC conguration, make sure the CMC with the SD feature card installed is the
active CMC and not the standby CMC.
•The feature card inserted is valid and contains the following feature(s)
FlexAddress: The feature card is bound to this chassis
required.
•No features active on the chassis — Action: Install the SD card into the CMC.
•The feature card inserted is valid and contains the following feature(s)
FlexAddress: The feature card is bound to another chassis, svctag =
ABC1234, SD card SN = 01122334455
Action: Remove the SD card; locate and install the SD card for the current chassis.
•The feature card inserted is valid and contains the following feature(s)
FlexAddress: The feature card is not bound to any chassis
Action: The feature card can be moved to another chassis, or can be reactivated on the current chassis. To
reactivate on the current chassis, enter racadm racreset until the CMC module with the feature card
installed becomes active.
— Action: No action
Example
$ racadm featurecard -s
The feature card inserted is valid, serial number TEST0123456789012345678
The feature card contains the following feature(s):
FlexAddress: The feature is bound to this chassis
FlexAddressPlus: The feature is bound to this chassis
ExtendedStorage: The feature is bound to this chassis
fwupdate
Table 5. fwupdate — Details
Description
Allows you to update the rmware on the KVM, active CMC, standby CMC, iDRAC or an IOM infrastructure
device. You can:
•Check the rmware update process status.
•Update CMC from FTP or TFTP server by providing an IP address and optional path.
25
•Update CMC from the local le system using Remote RACADM.
•There can only be a single update operation in progress at any time. In addition, the fwupdate subcommand
may only update one or more devices of a single kind at a time.
NOTE: CMC rmware update is supported only for the rmware versions 3.10, 3.20, 3.21, 4.0, 4.10,
4.11, 4.30, 4.31, 4.45, and 4.5. For any version other than these, rst update to any of these versions,
and then update to the required version.
To use this subcommand, you must have the Chassis Conguration 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 rmware on the active CMC resets itself and all
the network connections are dropped. During update of all other modules, including the standby CMC,
the active CMC continues to run normally without resetting.
•In a chassis supported by DC PSUs, an error message is displayed if you attempt to update the
rmware with a version without DC PSU support.
•The fwupdate subcommand generates an error when used on the extension slot of a multi-slot server.
•While Lifecycle Controller is running for racadam commands, you cannot perform other operations
which need Lifecycle Controller Partition. If the Lifecycle Controller Partition is unreleased (because of
improper closure of racadm command in the partition), then wait 20-35 minutes to clear the Lifecycle
Controller Partition
Signed CMC Firmware Image
•For Dell’s 13th generation of PowerEdge servers and later, CMC rmware includes a signature which is
veried by CMC before update to ensure the authenticity of the uploaded rmware. The rmware update
process is successful only if the rmware image is authenticated by CMC to be a valid image from the
service provider and has not been altered. The rmware update process is stopped if CMC cannot verify
the signature of the uploaded rmware image.
•Upload rmware image from TFTP server and start rmware update.
Synopsis
NOTE: Run the rmware update command through only one remote racadm session at a time.
For SSH or Telnet or Serial:
racadm fwupdate -g -u -a <tftp_server_ip_address_or_FQDN> -d <path> [-m
<module>]
When using FTP, if you provide the full path to the image le on the CLI, then the CMC uses that path to
locate that le 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 specied user for the le. If the host system is running
Windows, then a default folder, such as C:\ftproot is searched.
26
NOTE: When attempting to run rmware update task, if the rmware image path length is greater
than 256 characters, remote RACADM client exits with the error message "ERROR: Specified path is too long".
NOTE: When attempting to run rmware update task using racadm fwupdate command, if the
rmware image path length is greater than 256 characters. Remote RACADM client exits with the
error message "
Input•—u — Performs the rmware update operation (used with -p and -g).
•—s — Displays the status of the rmware update. Use this option by itself. Lists active SD card features
and SD card status.
NOTE: Use —m to display the status of the module update. Omit -m to display the status of the active
CMC update.
NOTE: The value all is used only to obtain the status of all targets to update.
•-g — Downloads the rmware update using the TFTP server.
•-a — The IP Address option species the TFTP server IP address, used with -g option.
Species the TFTP server IP address or FQDN used for the rmware image (used with -g).
•-d — The -d, or directory option species the directory on the TFTP server or on CMC’s host server,
where the rmware update le resides.
Species the source path where the rmware image resides.
Default: Designated TFTP default directory on that host for the le if -g option is absent. If -g is used, it
defaults to a directory congured on the TFTP server.
ERROR: Specified path is too long".
•-p — The -p option is used to upload the rmware image from the client.
NOTE: This option is only supported on the remote interface(s) and Windows operating systems.
•-m <module> — Species the module or device to be updated. <module> is one of the following
values:
– cmc-active — default state if –m is not specied.
– cmc-standby
– kvm
– server-<n> — where n=1–16
– server-<nx> — where n=1–8; x = a, b, c, d (lowercase)
– server-<g> <generation> — where generation = iDRAC or iDRAC6 only.
– iominf-<n> — where n = 1–6
NOTE: Multiple modules can be specied except iominf-<n>, for example, –m <module 1> –m
<module 2> and so on.
•-f — Species the FTP server IP address or FQDN, username, and password used for rmware image.
Applies FTP download process for rmware update.
•-c — Cancels an ongoing rmware update. The cancel operation is supports the following values:
– cmc-active — This is the default option if -m is not specied.
– cmc-standby
– server-<n> — where n = 1 to 16
– server-<nx> — where n = 1 to 8; x = a to d (lowercase)
– server-<g> — where g = generation (iDRAC, iDRAC6)
– iominf-<n> — where n = 1 to 6
– kvm
NOTE: Omit -m to cancel an active CMC update.
27
CMC version 3.00 accepts IPv4, IPv6 or fully qualified domain names (FQDN) for both FTP
and TFTP servers.
NOTE: You can specify the cmc-active and cmc-standby modules at the same time along with one or
more server-n modules. This option enables the devices to be updated together.
NOTE: Verify that the update applied to servers for a particular generation has been validated for all
impacted server models.
Output
Example
Displays a message indicating the operation that is being performed.
•Upload the rmware image from the TFTP server and start the rmware update.
racadm fwupdate -g -u -a 192.168.0.2 -d firmimg.cmc -m cmc-active
TFTP rmware update has been initiated. This update process may take several minutes to complete.
•Upload the rmware image from the FTP server and start the rmware update.
racadm fwupdate -f 192.168.0.100 fred xxx -d firmimg.cmc -m cmc-active
•Upload a rmware image from the client and start rmware update.
•Query the status of all rmware targets to be updated.
racadm fwupdate -s -m all
•Query the current status of the rmware update process for a particular module.
racadm fwupdate -s -m <module>
•Download rmware update le from a specied location on the TFTP server at a specic IP address.
racadm fwupdate -g -u -a 192.168.0.2 -d <path>
28
After the image le is downloaded from the TFTP server, the update process begins. When completed,
CMC is reset.
•Read the status of the rmware update.
racadm fwupdate -s
•Cancel a rmware update in progress.
racadm fwupdate –c
NOTE: Firmware update from local RACADM (using -p -u -d options) is not supported on Linux
OS.
NOTE: These commands specically apply to an active-CMC update.
Signed CMC Firmware Image:
•To get the rmware update status:
racadm fwupdate –s –m cmc-active
Invalid rmware: The uploaded rmware image does not contain a verication signature.
The following table describes the rmware update method supported for each interface.
FW Update MethodCMC
Local RACADMNo
Local RACADM-TFTPNo
Local RACADM-FTPNo
Remote RACADMYes
Remote RACADM-TFTPYes
Remote RACADM-FTPYes
Firmware RACADM-TFTPYes
Firmware RACADM-FTPYes
get
Description
Synopsis
Input
Saves CMC conguration properties to a le.
NOTE: If CMC is not in the network, you cannot export the chassis congurationprole
to a remote network share with proxy using the get command. But, you can export the
chassis congurationprole to the local management station.
-s <severity> — Species the severity type message displayed. The command racadm
getactiveerrors
only selected message type for that module is displayed. The values for -s <severity> are:
•critical
•warning
•info
-m <module> — Species the module for which the messages such as critical, noncritical (warning), and
informational are displayed. The command racadm getactiveerrors displays critical, noncritical
(warning), and informational messages for the selected module. When used with -s option, only selected
message type for the module is displayed. The values for -m <module> are:
•server-<n> — where n=1–16
•server-<nx> — where n=1–8; x = a, b, c, d (lower case)
•switch-<n> — where n=1–6
•cmc-<n> — where n=1, 2
•fan-<n> — where n=1–9
•ps-<n> — where n=1–6
•chassis
•kvm
•lcd
displays the selected type of messages for all the modules. When used with -m option,
Examples
30
NOTE: A few of the informational messages are applicable for more than one module. To avoid
repetition of the same message for dierent modules, only one such informational message is
displayed for the default command racadm getactiveerrors. When an -m option is used on
another server or switch, the informational message is displayed, if applicable.
After you run this command, the full-height, half-height, and the quarter-height servers and switches are
automatically checked for informational messages (in the same order as mentioned here).
•To display the entire log (Critical, Warning and Informational messages) for all modules.
racadm getactiveerrors
Module ID = 1
Severity = Critical
Message = The storage battery has failed.
Module ID = 10
Severity = Critical
Message = General failure after video.
Module ID = ps-6
Severity = Critical
Message = The power input for power supply 6 is lost.
Loading...
+ 116 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.