RACADM Command Line
Reference Guide for
iDRAC6 1.95, iDRAC6 3.5, and
CMC 3.2
Contents
1
23
23
24
24
24
24
25
26
30
2
33
33
34
36
37
37
39
39
41
Contents
3
41
42
42
45
46
47
47
50
52
54
61
61
62
64
66
69
71
72
73
74
79
4
Contents
81
83
85
86
87
88
89
90
91
93
94
95
99
100
101
104
105
106
106
107
107
Contents
5
108
109
112
113
114
114
115
116
117
118
120
121
123
124
125
127
128
130
132
133
134
6
Contents
135
136
139
140
141
141
143
143
144
144
148
148
3
.
.
.
.
.
.
151
152
154
154
155
155
155
155
155
156
Contents
7
156
157
158
159
159
159
160
160
161
162
162
162
163
163
163
164
164
164
165
165
165
166
166
166
167
167
167
168
168
168
169
169
169
8
Contents
170
170
171
171
172
172
174
175
175
175
176
176
176
177
177
177
177
178
178
179
180
181
181
182
182
183
184
184
184
184
Contents
9
185
185
185
186
186
187
187
187
188
188
188
188
189
189
190
190
190
191
191
191
192
192
192
193
193
193
193
194
194
194
10
Contents
195
196
196
196
197
197
198
198
198
199
199
199
200
200
201
201
202
202
202
203
203
203
203
204
204
204
204
205
205
205
205
Contents
11
206
206
206
206
207
207
208
209
210
210
210
210
211
211
211
211
212
212
212
212
213
213
214
214
214
215
215
216
216
216
12
Contents
217
217
217
218
218
218
219
219
219
220
220
220
220
221
221
221
221
222
222
223
223
223
224
224
224
225
225
225
225
226
226
Contents
13
226
226
226
227
227
227
228
228
228
228
229
229
230
230
230
230
230
230
231
232
232
232
232
233
233
14
Contents
233
233
234
234
234
234
235
235
235
235
235
236
236
236
236
237
237
237
237
238
238
238
238
238
239
239
240
240
240
Contents
15
240
241
241
241
242
242
242
242
243
243
245
246
247
248
248
249
249
249
250
16
Contents
251
251
251
252
252
252
253
253
253
253
254
254
254
255
255
256
256
256
256
257
257
257
258
258
258
Contents
17
259
259
259
259
260
260
260
260
261
261
261
261
262
262
262
263
264
264
264
264
264
264
264
264
265
265
265
266
266
266
266
266
18
Contents
266
266
267
267
267
267
268
268
268
269
269
269
269
270
271
271
271
272
272
272
273
273
273
273
274
274
274
275
Contents
19
275
275
275
276
276
276
277
277
277
277
278
278
278
279
279
279
280
280
280
280
281
281
281
282
282
282
282
282
283
283
20
Contents
283
284
284
284
284
285
285
285
285
285
286
4
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
289
291
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Contents
21
22
Contents
1
Introduction
This document provides information about the RACADM subcommands,
supported RACADM interfaces, and property database groups and object
definitions for the following:
•
•
•
iDRAC6 Enterprise on Blade Servers
iDRAC6 Enterprise or Express on Rack and Tower Servers
Dell Chassis Management Controller (CMC)
Supported RACADM Interfaces
The RACADM command-line utility provides a scriptable interface that
allows you to locally or remotely configure your Remote Access Controller
(RAC). 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 support.dell.com.
The RACADM utility supports the following interfaces:
•
Local — Supports executing RACADM commands from the managed
server’s operating system. You must install the OpenManage software on
the managed server to run local racadm commands. Only one instance of
local RACADM can be executed on a system at a time. If the user tries to
open another instance, an error message is displayed and the second
instance of local RACADM closes immediately.
•
•
SSH or Telnet — Also referred as Firmware racadm. Supports executing
RACADM commands from a SSH or Telnet session to iDRAC.
Remote — Supports executing RACADM commands from a remote
management station such as a laptop or desktop computer. You must
install the OpenManage software on the remote computer to run remote
RACADM commands. To execute remote RACADM commands, you
must formulate the command like a local or SSH/Telnet RACADM
command except that you must also use the –r –i options or the –r –u –p
options. For more information on these options, see the "RACADM
Introduction
23
RACADM Syntax Usage
The following section describes the syntax usage for local, SSH/Telnet, and
Remote RACADM.
Local RACADM
racadm getconfig -g <groupname> [-o <objectname>] [-i
<indexnumber>]
racadm <subcommand>
Example
racadm getconfig -g idracinfo
racadm getsysinfo
SSH/Telnet RACADM
racadm getconfig -g <groupname> [-o <objectname>] [-i
<indexnumber>]
racadm <subcommand>
Example
racadm getconfig -g idracinfo
racadm getsysinfo
Remote RACADM
racadm -r -u -p getconfig -g <groupname> [-o
<objectname>] [-i <indexnumber>]
racadm -r -u -p <subcommand>
Example
racadm -r -u -p getconfig -g idracinfo
racadm -r -u -p getsysinfo
24
Introduction
RACADM Command Options
Table 1-1. RACADM Command Options
Option
Description
-r <racIpAddr>
Specifies the controller’s remote IP address.
-r <racIpAddr>:<port
number>
Use:<port number> if the iDRAC6 port number is not
the default port (443)
-u <usrName>
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.
-p <password>
Specifies the password used to authenticate the
command transaction. If the -p option is used, the -i
option is not allowed.
-S
Specifies that RACADM should check for invalid
certificate errors. RACADM stops the execution of the
command with an error message if it detects an invalid
certificate.
-i <indexnumber>
Specifies the index number for the indexed group, if
applicable.
-g <groupname>
Specifies the group name if applicable.
Specifies the object name if applicable.
-o <objectname>
Enterprise and iDRAC6 Express.
Table 1-2. Supported RACADM Interfaces
iDRAC Type
Local RACADM SSH/Telnet RACADM Remote RACADM
iDRAC6 Enterprise
iDRAC6 Express
CMC
= Supported;
= Not supported
Introduction
25
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.
Supported RACADM Subcommands
corresponding interface support. For detailed information of the RACADM
subcommands including syntax and valid entries, see "RACADM
Table 1-3. RACADM Subcommands
Subcommand
iDRAC6 on Blade
Servers
iDRAC6 on Rack and CMC
Tower Servers
Telnet Local
/SSH/ RACADM RACADM SSH/S RACADM RACADM /SSH/ RACADM
Serial erial Serial
Remote Telnet/ Local
Remote
Telnet Remote
26
Introduction
Table 1-3. RACADM Subcommands (continued)
Subcommand
iDRAC6 on Blade
Servers
iDRAC6 on Rack and CMC
Tower Servers
Telnet Local
/SSH/ RACADM RACADM SSH/S RACADM RACADM /SSH/ RACADM
Serial erial Serial
Remote Telnet/ Local
Remote
Telnet Remote
Introduction
27
Table 1-3. RACADM Subcommands (continued)
Subcommand
iDRAC6 on Blade
Servers
iDRAC6 on Rack and CMC
Tower Servers
Telnet Local
/SSH/ RACADM RACADM SSH/S RACADM RACADM /SSH/ RACADM
Serial erial Serial
Remote Telnet/ Local
Remote
Telnet Remote
28
Introduction
Table 1-3. RACADM Subcommands (continued)
Subcommand
iDRAC6 on Blade
Servers
iDRAC6 on Rack and CMC
Tower Servers
Telnet Local
/SSH/ RACADM RACADM SSH/S RACADM RACADM /SSH/ RACADM
Serial erial Serial
Remote Telnet/ Local
Remote
Telnet Remote
Introduction
29
Table 1-3. RACADM Subcommands (continued)
Subcommand
iDRAC6 on Blade
Servers
iDRAC6 on Rack and CMC
Tower Servers
Telnet Local
/SSH/ RACADM RACADM SSH/S RACADM RACADM /SSH/ RACADM
Serial erial Serial
Remote Telnet/ Local
Remote
Telnet Remote
Other Documents You May Need
In addition to this guide, you can access the following guides available on the
Dell Support website at dell.com/support/manuals. Select Choose from a list
of all Dell products and click Continue. Click Software, Monitors,
Electronics & PeripheralsSoftware
•
Click Remote Enterprise System Management to view the documents for
iDRAC, Lifecycle Controller, Chassis Management Controller, and
Baseboard Management Controller Management Utilities:
30
Introduction
–
–
The Integrated Dell Remote Access Controller 6 (iDRAC6) Enterprise
for Blade Servers User Guide provides information about configuring
and using an iDRAC6 for blade servers to remotely manage and
monitor your system and its shared resources through a network.
The Integrated Dell Remote Access Controller 6 (iDRAC6) User
Guide provides complete information about configuring and using an
iDRAC6 for rack and tower servers to remotely manage and monitor
your system and its shared resources through a network.
–
–
The CMC online Help provides information about using the CMC
Web interface.
The Chassis Management Controller (CMC) Secure Digital (SD) Card
Technical Specification provides minimum BIOS and firmware version,
installation and usage information.
•
Click Enterprise System Management to view documents for
OpenManage Server Administrator and Dell Update Package.
–
–
The Dell OpenManage IT Assistant User’s Guide provides information
about IT Assistant.
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 CMC 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 specific to your third-party management console
application.
Introduction
31
•
•
Documentation for any components you purchased separately provides
information to configure and install these options.
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 on 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 first
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.
32
Introduction
2
RACADM Subcommand Details
This section provides detailed descriptions 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
single quotes or double quotes:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
$ (dollar sign)
" (double quote)
' (single quote)
` (back quote)
\ (backslash)
~ (tilde)
; (semicolon)
| (vertical bar)
( (left parentheses)
) (right parentheses)
& (ampersand)
> (greater than)
< (less than)
# (pound)
ASCII code 32 (space)
NOTE: The - (dash) character cannot be the first character of the string, regardless
of whether the string is quoted.
RACADM Subcommand Details
33
There are different escaping rules for single quoting versus double quoting.
For double quoting:
The following characters must be escaped by prepending a backslash:
•
•
•
•
•
$ (dollar sign)
" (double quote)
' (single quote)
` (back quote)
\ (backslash)
For example, use the following for a string that contains the special
characters, $, ",',`and \
For single quoting:
•
•
No character escaping is necessary.
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 "? <subcommand>"
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
?
Displays all the subcommands you can use with the racadm
command and a one-line description of each subcommand.
? <subcommand>
Displays the syntax for the specified command.
NOTE: You can also use the help and help <subcommand> commands to obtain the
same information.
Synopsis
racadm ?
racadm ? <subcommand>
34
RACADM Subcommand Details
Example for racadm ?
NOTE: The following output example shows only part of 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 chassis or switch power-
up/down/cycle or KVM powercycle
clrraclog
clrsel
-- clear the CMC log
-- 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
...
setniccfg
properties
setractime
setslotname
chassis
-- modify network configuration
-- set the time on the CMC
-- sets the name of the slot in the
setsysinfo
location
sslcertview
the CMC
-- set the chassis name and chassis
-- display a CA/server certificate in
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 ? <subcommand>
racadm ? getsysinfo
RACADM Subcommand Details
35
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 show headers or labels
-4 : show CMC IPv4 information
-6 : show CMC IPv6 information
"help" and "help <subcommand>"
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
help
Lists all the subcommands available to use with RACADM
and provides a short description for each. You may also type a
subcommand after help to get the syntax for a specific
subcommand.
Synopsis
racadm help
racadm help <subcommand>
Output
The racadm help command displays a complete list of subcommands.
The racadm help <subcommand> command displays information for the
specified subcommand only.
36
RACADM Subcommand Details
arp
NOTE: To use this subcommand, you must have Administrator and Execute
Diagnostic Commands permission.
Subcommand
Description
arp
Displays the contents of the Address Resolution
Protocol (ARP) table. ARP table entries cannot be
added or deleted.
Synopsis
racadm arp
Example
For rack and tower servers:
/admin1-> racadm arp
Address
HWtype HWaddress
Flags Mask Iface
10.94.161.1 ether
00:0F:F7:2C:1C:C4 2
eth0
For blade servers:
$ racadm arp
Address
HWtype Flags HWaddress
Mask Device
10.94.161.1 0x1
0x2
00:0F:F7:2C:1C:C4 *
eth0
chassisaction
IP Address
HW Type
0x1
Flags
0x2
HW Address
Mask
Device
192.168.1.1
00:00:0C:07:AC:0F
*
eth0
RACADM Subcommand Details
37
NOTE: To use this subcommand, you must have Chassis Control Administrator
privilege.
Subcommand
Description
chassisaction
Executes a power action on the chassis, iKVM, or a
server.
Synopsis
racadm chassisaction [-m <module>] <action>
Table 2-1 describes the chassasaction subcommand
options
Table 2-1. chassisaction Subcommand Options
Option
Description
-m
Module on which you want to carry out the action. Values are:
<module>
•
•
chassis- this is the default value if -mis not specified.
switch-nwhere =1–6
n
• kvm
<action> Action that you want to execute on the specified module. Values are:
•
•
•
•
powerdown— (Chassis only) Powers down the chassis.
powerup— (Chassis only) Powers up the chassis.
powercycle— Power cycles the module.
nongraceshutdown— (Chassis only) Shuts down the chassis non-
gracefully.
•
reset— Performs a hard reset of the module.
NOTE: When <module> = kvm or switch, <action> must be powercycle or reset.
Example
•
Perform a reset of switch-3.
racadm chassisaction -m switch-3 reset
Module power operation successful.
38
RACADM Subcommand Details
clearasrscreen
NOTE: To use this subcommand, you must have Clear Logs permission.
Subcommand
Description
clearasrscreen
Clears the last crash (ASR) screen that is in memory. See
Configuring the Managed Server to Capture the Last Crash
Screen and Disabling the Windows Automatic Reboot Option
sections in the iDRAC6 Enterprise for Blade Servers User
Guide.
Synopsis
racadm clearasrscreen
closessn
NOTE: To use this subcommand, you must have Administrator permission.
Subcommand
Description
closessn
Closes a communication session on the device. Use
getssninfo to view a list of sessions that can be
closed using this command.
Synopsis
racadm closessn –i <session id>
racadm closessn -a
racadm closessn -u <username>
RACADM Subcommand Details
39
Table 2-2. closessn Subcommand Options and Descriptions
Option
Description
-i<session id>
The session ID of the session to close, which can be retrieved
using racadm getssninfo subcommand.
NOTE: Session executing this command cannot be closed.
-a
Closes all sessions.
-u <user name> Close all sessions for a particular user name.
NOTE: -u option can be used in local RACADM only if the username
contains upto 16 characters.
If the user name contains more than 16 characters, use one of the
following options to close a session:
Local RACADM: -i option
Remote RACADM: -u option or -i option
Examples:
• racadm closessn -i 1234
Closes the session 1234.
•
racadm closessn –u root
Closes all the sessions for root user.
• racadm closessn –a
Closes all the sessions.
40
RACADM Subcommand Details
clrraclog
NOTE: To use this subcommand, you must have Clear Logs permission. .
Subcommand
Description
clrraclog
Removes all existing records from iDRAC6 log. A new
single record is created to record the date and time when
the log was cleared.
Synopsis
racadm clrraclog
clrsel
NOTE: To use this subcommand, you must have Clear Logs permission.
Subcommand
Description
clrsel
Removes all existing records from the System Event Log
(SEL).
Synopsis
racadm clrsel
RACADM Subcommand Details
41
cmcchangeover
NOTE: To use this subcommand, you must have Administrator privilege.
Subcommand
Description
cmcchangeover
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.
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 Management Controller User Guide.
Synopsis
racadm cmcchangeover
Output
CMC failover initiated successfully.
config
NOTE: To use this subcommand, you must have Log In iDRAC permission.
Subcommand
Description
config
This subcommand allows you to set iDRAC6
configuration parameters individually or to batch them as
part of a configuration file. If the data is different, that
iDRAC6 object is written with the new value.
42
RACADM Subcommand Details
Synopsis
racadm config [-c|-p] -f <filename>
racadm config -g <groupName> -o <objectName> [-i
<index>] <Value>
NOTE: The configuration file retrieved using remote racadm and local racadm are
not interoperable. The configuration file retrieved using remote racadm shows the
index property for some of the indexed groups as read-write, for example
cfgSSADRoleGroupIndex. For the config -f <file name>command, use
the configuration file retrieved from the same interface. For example, for local
racadm config -f <file name>, use the file generated from the local
racadm command getconfig -f <file name>.
Input
NOTE: The -f and -p options are not supported for the serial/Telnet/ssh console.
Table 2-3. config Subcommand Options and Descriptions
Option Description
-f
The -f <filename> option causes config to read the contents of the file
specified by <filename> and configure iDRAC6. The file must contain
data in the format specified in the section Parsing Rules in the iDRAC6
User’s Guide available on the Dell Support website at
dell.com/support/manuals.
-p
-g
-o
The -p, or password option, directs config to delete the password entries
contained in the config file -f <filename> after the configuration is
complete.
The -g <groupName>, or group option, must be used with the -o option.
The <groupName> specifies the group containing the object that is to be
set.
The -o <objectName> <Value>, or object option, must be used with the -g
option. This option specifies the object name that is written with the string
<value>.
RACADM Subcommand Details
43
Table 2-3. config Subcommand Options and Descriptions (continued)
Option Description
-i
The -i <index>, or index option, is valid only for indexed groups and can be
used to specify a unique group. 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 specified, a value of 1 is
assumed for groups, which are tables that have multiple entries. The index
is specified by the index value, not a named value.
-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. Writes do
not occur to iDRAC6. This option is a check only.
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 10.35.10.100
Sets the cfgNicIpAddress configuration parameter (object) to the value
10.35.10.110. This IP address object is contained in the group
cfgLanNetworking
.
•
racadm config -f myrac.cfg
Configures or reconfigures iDRAC6. The myrac.cfg file may be created
from the getconfig command. The myrac.cfg file may also be edited
manually as long as the parsing rules are followed.
NOTE: The myrac.cfg file does not contain passwords. To include passwords
in the file, you must enter them manually. If you want to remove password
information from the myrac.cfg file during configuration, use the -p option.
44
RACADM Subcommand Details
connect
Subcommand
Description
connect
Connects to the switch or server serial console.
NOTE: You cannot use this subcommand with remote RACADM.
Synopsis
• racadm connect [-b] <server-n>
• racadm connect [-b] <switch-n>
Table 2-4. connect Subcommand Options
Option
Description
-b
Connects to the switch or console using the binary
mode. This is an optional argument; a server or a switch
must be present.
server-n or
Server or switch to connect to.
switch-n
•
•
server-
n
n
where
where
n
=1–16
switch-
n=<a1 | a2 | b1 | b2 | c1 | c2>
NOTE: If you use the -b option, reset the CMC to terminate the connect operation.
NOTE: See the Dell Chassis Management Controller User Guide for examples on
using the connect subcommand.
RACADM Subcommand Details
45
coredump
NOTE: This option is applicable only for iDRAC6.
NOTE: To use this subcommand, you must have Execute Debug Commands
permission.
Subcommand
Description
coredump
Displays detailed information related to any recent
critical issues that have occurred with the RAC. The
coredump information can be used to diagnose these
critical issues.
If available, the coredump information is persistent across
iDRAC6 power cycles and remains available until either
of the following conditions occur:
• The coredump information is cleared with the
coredumpdelete subcommand.
• Another critical condition occurs on the RAC. In this
case, the coredump information is relative to the last
critical error that occurred.
information about clearing the coredump.
Synopsis
racadm coredump
46
RACADM Subcommand Details
coredumpdelete
NOTE: This option is applicable only for iDRAC6.
NOTE: To use this subcommand, you must have Clear Logs or Execute Debug
Commands permission.
Subcommand
Description
coredump
Clears any currently resident coredump data stored in the
RAC.
NOTE: If a coredumpdelete command is issued and a coredump is not
currently stored in the RAC, the command displays a success message.
This behavior is expected.
See the coredump subcommand for more information on viewing
a coredump.
Synopsis
racadm coredumpdelete
deploy
NOTE: To use this subcommand, you must have Server Administrator privilege.
Subcommand
Description
deploy
Configures the static IP address, subnet mask, gateway,
and password for the root user on iDRAC for the specified
server.
NOTE: You can also use setniccfg to configure static IP address, subnet mask, and
gateway, as well as DHCP, speed, and duplex properties.
RACADM Subcommand Details
47
Synopsis
•
racadm deploy -m <module> -u root -p <password> -s
ipaddress> <subnet> <gateway> -b <device> -o <no|yes>
racadm deploy -m <module> -u root -p <password> -s -6
<
•
<
ipv6Address> <prefixlen> <gateway> -b <device> -o <no|yes>
NOTE: <prefixlen> must be a number between 0 and 128.
•
•
racadm deploy -m <module> -u root -p <password> -d [-
6]
racadm deploy -a -u root -p <password
>
Table 2-5. deploy Subcommand Options
Option
Description
-b <device>
Specifies the first boot device; must be used with
-o.
Use with -m<module> to specify for a individual
server, or with -afor all servers
Legal values: device=None, PXE, HDD, CD-
DVD, vFDD, vCD-DVD, iSCSI, SD, FDD
-o <no|yes>
Indicates if the server should boot from the
device once; must be used with -o.
Use with -m<module> to specify for a individual
server, or with -afor all servers
-a
Creates and enables an iDRAC root user if it does
not already exist, and is executed on all the
existing servers in the chassis
-u root
Indicates that the <password> is supplied for the
root user on the server. rootis a constant
parameter, the only value that is valid with the -u
option.
-m <module>
Specifies the server you want to configure.
Legal values: server-n, where n=1–16
-p <password>
Specifies the password for the root user on the
server.
48
RACADM Subcommand Details
Table 2-5. deploy Subcommand Options (continued)
Option
Description
-s <ipaddress subnet gateway>
Sets the IP address, subnet mask, and gateway for
the specified server, separated by single spaces.
•
•
•
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.
-d
-6
Enables DHCP for the specified server.
NOTE: The -sand -doptions cannot be used
together in the same command.
Enables IPv6 auto configuration (when used with
-d)
Sets static IPv6 addresses (when used with -s)
Example
• racadm deploy -m server-8 -s 192.168.0.20
255.255.255.0 192.168.0.1
The server was deployed successfully.
NOTE: 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
RACADM Subcommand Details
49
feature
NOTE: To use this subcommand to deactivate FlexAddress, you must have Chassis
Configuration Administrator privilege. A user with login privileges can view status
only.
Subcommand
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. 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 different chassis.
NOTE: To deactivate FlexAddress features, the chassis must be powered off.
Synopsis
racadm feature -s
racadm feature -d -c <featurename>
racadm feature -a -c ExtendedStorage
racadm feature -1 -c ExtendedStorage
racadm feature -2 -c ExtendedStorage
racadm feature -r -c ExtendedStorage
Table 2-6. feature Subcommand Options
Option
-s
Description
Displays the status of active features.
Deactivates feature specified in -c option.
Activates ExtendedStorage feature.
-d
-a
-1
Configures ExtendedStorage feature for standalone use.
Configures ExtendedStorage feature for redundant use.
-2
50
RACADM Subcommand Details
Table 2-6. feature Subcommand Options (continued)
Option
Description
-r
Reformats damaged/unformatted ExtendedStorage media.
CAUTION: Using the -r switch deactivates the ExtendedStorage
feature, if active; reformats the SD media in the active CMC cardslot;
and may reboot the active CMC.
-c
<featurename> must be one of the following:
• flexaddress (with -d)
• flexaddressplus (with -d)
• ExtendedStorage (with -a,-d,-1,-2, or -r)
Example
• racadm feature -d -c flexaddress
The feature FlexAddress is deactivated on the
chassis successfully
• racadm feature -s
Feature Name = FlexAddress
Date/time Activated = 26 Apr 2010 - 10:16:48
Feature installed from SD-card serial number =
TEST0123456789012345678
Feature Name = FlexAddressPlus
Date/time Activated = 26 Apr 2010 - 10:16:48
Feature installed from SD-card serial number =
TEST0123456789012345678
Feature name = ExtendedStorage (for redundant use)
Date/time Activated = 06 May 2010 - 07:42:20
Feature installed from SD-card serial number =
TEST0123456789012345678
RACADM Subcommand Details
51
featurecard
NOTE: To use this subcommand, you must have Chassis Configuration
Administrator privilege.
Subcommand Description
featurecard Verifies proper SD card installation and displays the SD card status.
Table 2-7. Status Messages Returned by featurecard -s Command
Status Message
Actions
No feature card inserted.
Check the CMC to verify that the SD card was
properly inserted. In a redundant CMC
configuration, 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 No action required.
contains the following feature(s)
FlexAddress: The feature card is
bound to this chassis
No features active on the chassis
Install the SD card into the CMC.
The feature card inserted is valid and Remove the SD card; locate and install the SD
contains the following feature(s)
FlexAddress: The feature card is
bound to another chassis,
svctag = ABC1234, SD card
SN = 01122334455
card for the current chassis.
The feature card inserted is valid and The feature card can be moved to another
contains the following feature(s) chassis, or can be reactivated on the current
FlexAddress: The feature card is not chassis. To reactivate on the current chassis,
bound to any chassis
enter racadm racresetuntil the CMC
module with the feature card installed becomes
active.
52
RACADM Subcommand Details
Synopsis
racadm featurecard -s
Table 2-8. featurecard Subcommand Options
Option
Description
-s
Lists active SD card features and SD card status.
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
RACADM Subcommand Details
53
fwupdate
NOTE: To use this subcommand for CMC you must have Chassis Configuration
Administrator privilege and for iDRAC you must have Configure iDRAC6 permission.
Subcommand
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 iDRAC6 or CMC firmware from a TFTP server by
providing an IP address and optional path.
• Update iDRAC6 or CMC firmware from the local file system
using local RACADM.
• Rollback to the standby firmware.
Table 2-9. fwupdate Subcommand Options
Option
Description
-s
Lists active SD card features and SD card status.
NOTE: This subcommand performs updates to the iDRAC firmware (if CMC
firmware version is 2.0 or later and iDRAC firmware version is 1.4) when the existing
firmware is corrupted. 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.
Before you begin your firmware update, see the Advanced iDRAC6
Configuration section in the iDRAC6 User’s Guide available on the Dell
Support website at dell.com/support/manuals.
NOTE: Running the fwupdate subcommand to update the firmware on the active
CMC resets itself causing all network connections to be dropped. During update of
all other modules, including the standby CMC, the active CMC continues to run
normally without resetting.
54
RACADM Subcommand Details
interface.
Table 2-10. Firmware Update Matrix
FW Update Method
Monolithic Modular
CMC
Local RACADM
Local RACADM - TFTP
Remote RACADM
Remote RACADM-TFTP
Remote RACADM-FTP
Firmware RACADM-TFTP
Firmware RACADM-FTP
Synopsis for iDRAC6
racadm fwupdate -s
racadm fwupdate -g -u -a <TFTP_Server_IP_Address> [-d
<path>]
racadm fwupdate -r
racadm fwupdate -p -u [-d <path>]
Synopsis for CMC
For local RACADM:
racadm fwupdate -g -u -a <tftp server ip address or
FQDN> -d <path> [-m <module>]
racadm fwupdate -f <ftp server ip address or FQDN>
<username> <password> -d <path> [-m <module>]
racadm fwupdate -u -m iominf-<n>
racadm fwupdate -s [-m <module>]
racadm fwupdate -c [-m <module>]
RACADM Subcommand Details
55
For remote RACADM:
racadm fwupdate -p -u -d <firmware image>
NOTE: 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. If the host system is
running Windows, then a default folder, such as C:\ftproot is searched.
NOTE: When attempting to run firmware update task using "racadm fwupdate"
command, if the firmware image path length is greater than 64 characters, remote
RACADM client exits with the error message "ERROR: Specified path is too long".
Input
NOTE: The -p option is supported on local and remote RACADM and is not
supported with the serial/Telnet/ssh console. The -p option is also not supported on
Linux operating systems.
Table 2-11. fwupdate Subcommand Options
Option Description
-u
For iDRAC: The update option performs a checksum of the firmware update file
and starts the actual update process. This option may be used along with the -g
or -p options. At the end of the update, iDRAC6 performs a soft reset.
For CMC: Performs the firmware update operation.
-s
For iDRAC: The status option returns the current status of where you are in
the update process. This option is always used by itself.
For CMC: Displays the current status of the firmware update.
NOTE: Use -mto display the status of the module update. Omit -mto display
the status of the active CMC update.
NOTE: The all value can only be used to obtain the status of all targets to be
updated.
56
RACADM Subcommand Details
Table 2-11. fwupdate Subcommand Options (continued)
Option Description
-g
The get option instructs the firmware to get the firmware update file from
the TFTP server. You must also specify the -a, -u, and -d options. In the
absence of the -a option, the defaults are read from properties contained in
the group cfgRemoteHosts, using properties cfgRhostsFwUpdateIpAddr
and cfgRhostsFwUpdatePath.
For CMC: Downloads the firmware update using the TFTP server.
-a
The IP Address option specifies the TFTP server IP address, used with -g
option.
For CMC: Specifies the TFTP server IP address or FQDN used for the
firmware image (used with -g).
-d
For iDRAC: The -d, or directory, option specifies the directory on the TFTP
server or on iDRAC6’s host server where the firmware update file resides.
For CMC: Specifies the source path where the firmware image resides.
Default: Designated TFTP default directory on that host for the file if -g
option is absent. If -g is used, defaults to directory configured on the TFTP
server.
-p
For iDRAC: The -p, or put, option is used to update the firmware file from
the managed system to iDRAC6. The -u option must be used with the -p
option.
NOTE: This option is not applicable for CMC.
-r
The rollback option is used to rollback to the standby firmware.
NOTE: This option is not applicable for CMC.
-c
Cancels the current firmware update of a module.
NOTE: This option is applicable only for CMC.
RACADM Subcommand Details
57
Table 2-11. fwupdate Subcommand Options (continued)
Option Description
-m
NOTE: This option is applicable only for CMC.
<modul
e>
Specifies the module or device to be updated. <module> is one of the
following values:
•
cmc-active(default)
• cmc-standby
• kvm
•
•
•
server-nwhere
server-generationwhere generation = iDRAC or iDRAC6
iominf-nwhere = 1–6
n
= 1–16
n
NOTE: 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-activeand cmc-standbymodules at
the same time along with one or more server-nmodules. This enables the
devices to be updated together.
NOTE: See "Updating the IOM Infrastructure Device Firmware" section of the
"Using the CMC Web Interface" chapter of the Dell Chassis Management
Controller User Guide for additional information on the IOM infrastructure
device firmware update process.
When you use the server-generationoption, the CMC updates all
iDRACs of that particular generation that can be updated.
NOTE: Verify that the update applied to servers for a particular generation has
been validated for all impacted server models.
Examples for CMC
Upload the firmware image from the TFTP server and start the firmware
•
update.
racadm fwupdate -g -u -a 192.168.0.100 -d
firmimg.cmc -m cmc-active
TFTP firmware update has been initiated. This
update process may take several minutes to
complete.
58
RACADM Subcommand Details
•
Upload the firmware image from the FTP server and start the firmware
update.
racadm fwupdate -f 192.168.0.100 fred password123
-d firmimg.cmc -m cmc-active
•
•
Start IOM infrastructure firmware update.
racadm fwupdate -u -m iominf-1
Update firmware on both the CMCs.
racadm fwupdate -g -u -a 192.168.0.100 -d
firmimg.cmc -m cmc-active -m cmc-standby
•
•
•
•
Update firmware on multiple servers.
racadm fwupdate -g -u -a 192.168.0.100 -d
firmimg.imc -m server-1 -m server-2 -m server-3
Update firmware on servers of iDRAC6 generation.
racadm fwupdate -g -u -a 192.168.0.100 -d
firmimg.imc -m server-idrac6
Update firmware on multiple IOM infrastructures.
racadm fwupdate -u -m iominf-4 -m iominf-5 -m
iominf-6
Query the current status of all firmware targets to be updated.
racadm fwupdate -s -m all
RACADM Subcommand Details
59
•
Query the current status of the firmware update process for a particular
module.
racadm fwupdate -s -m <module>
•
•
Cancel a firmware update in progress.
racadm fwupdate -c
Upload a firmware image from the client and start the firmware update.
racadm fwupdate -p -u -d firmimg.cmc
NOTE: The fwupdate command generates an error when used on the extension
slot of a multi-slot server.
NOTE: Image path length for Remote RACADM is 256 characters and for local
RACADM, it is 64 characters.
Output
Displays a message indicating the operation that is being performed.
Examples
• racadm fwupdate -g -u - a 143.166.154.143 -d
<path>
In this example, the -g option tells the firmware to download the firmware
update file from a location (specified by the -d option) on the TFTP server
at a specific IP address (specified by the -a option). After the image file is
downloaded from the TFTP server, the update process begins. When
completed, iDRAC6 is reset.
• racadm fwupdate -s
This option reads the current status of the firmware update.
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.
60
RACADM Subcommand Details
getassettag
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getassettag
Displays the asset tag for the chassis.
Synopsis
racadm getassettag [-m <module>]
Table 2-12. getassettag Subcommand Options
Option
Description
-m<module> Specifies the module whose asset tag you want to view.
Legal value: chassis
Example
• racadm getassettag -m chassis
or
racadm getassettag
chassis 78373839–33
getchassisname
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getchassisname Displays the name of the chassis.
Synopsis
racadm getchassisname
RACADM Subcommand Details
61
Example
• racadm getchassisname
PowerEdge 2955
getconfig
Subcommand
Description
getconfig
Retrieves iDRAC6 configuration parameters individually, or all
iDRAC6 configuration groups may be retrieved and saved to a file.
Synopsis
racadm getconfig -f <filename>
racadm getconfig -g <groupName> [-i <index>]
racadm getconfig -u <username>
racadm getconfig -h
racadm getconfig -g <groupName> -o <objectName> [-i
index]
Input
Table 2-13. getconfig Subcommand Options
Option Description
-f
The -f <filename> option directs getconfig to write the entire iDRAC6
configuration to a configuration file. This file can be used for batch
configuration operations using the config subcommand.
-g
-h
The -g <groupName>, or group option, can be used to display the
configuration for a single group. The groupName is the name for the group
used in the racadm.cfg files. If the group is an indexed group, use the -i option.
The -h, or help option, displays a list of all available configuration groups in
alphabetical order. This option is useful when you do not remember exact
group names.
62
RACADM Subcommand Details
Table 2-13. getconfig Subcommand Options
Option Description
-i
The -i <index>, or index option, is valid only for indexed groups and can be
used to specify a unique group. 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 specified, a value of 1 is
assumed for groups, which are tables that have multiple entries. The index is
specified by the index value, not a named value.
-o
-u
The -o <objectname> or object option specifies the object name that is used
in the query. This option is optional and can be used with the -g option.
The -u <username>, or user name option, can be used to display the
configuration for the specified user. The <username> option is the login
name for the user.
-v
The -v option displays additional details with the display of the properties and
is used with the -g option.
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.
Examples
•
racadm getconfig -g cfgLanNetworking
Displays all of the configuration properties (objects) that are contained in
the group cfgLanNetworking
.
•
racadm getconfig -f myrac.cfg
Saves all group configuration objects from iDRAC6 to myrac.cfg
.
RACADM Subcommand Details
63
•
racadm getconfig -h
Displays a list of the available configuration groups on iDRAC6 in an
alphabetical order.
• racadm getconfig -u root
Displays the configuration properties for the user named root.
•
racadm getconfig -g cfgUserAdmin -i 2 -v
Displays the user group instance at index 2 with verbose information for
the property values.
getdcinfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getdcinfo
Displays general I/O module and daughter card configuration
information.
NOTE: Fabric verification for server DCs is performed only when the chassis is
powered on. When the chassis is on standby power, iDRACs on the server modules
remain powered off and thus are unable to report the server's DC fabric type. The
DC fabric type may not be reported in the CMC user interface until iDRAC on the
server is powered on.
Synopsis
racadm getdcinfo
Table 2-14. getdcinfo Subcommand Options
Option
Description
-n
Displays the model names for the daughter cards in servers.
64
RACADM Subcommand Details
Example
The example output below is for a system with multi-slot servers.
racadm getdcinfo
Group A I/O Type : Gigabit Ethernet
Group B I/O Type : Gigabit Ethernet
Group C I/O Type : Gigabit Ethernet
<IO#>
<Type>
<State>
OK
<Role>
Master
N/A
switch-1
switch-2
switch-3
switch-4
switch-5
switch-6
Gigabit Ethernet
None
N/A
OK
Gigabit Ethernet
None
Master
N/A
N/A
OK
Gigabit Ethernet
None
Member
N/A
N/A
<Server#>
<Presence>
<DC1 Type>
<DC1
<DC2 Type>
<DC2
State>
State>
server-1
server-2
server-3
server-4
Present
None
None
None
None
N/A
None
None
None
N/A
N/A
N/A
OK
Not Present
Not Present
Present
N/A
N/A
N/A
Gigabit
Ethernet
server-5
server-6
server-7
server-8
server-9
server-10
server-11
server-12
server-13
server-14
server-15
server-16
Not Present
Not Present
Not Present
Present
None
None
None
N/A
N/A
N/A
None
None
None
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
FibreChannel 4 Invalid None
Extension(1) None
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
None
None
None
None
None
None
None
None
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
None
None
None
None
None
None
None
RACADM Subcommand Details
65
getdcinfo -n
<Server#>
server-1
server-2
server-3
server-4
server-5
server-6
server-7
server-8
server-9
server-10
server-11
server-12
server-13
server-14
server-15
server-16
<Presence>
<DC1 Model Name>
<DC2 Model Name>
Present
None
None
Not Present
Not Present
Present
None
None
None
None
None
Broadcom M5708t
None
Not Present
Not Present
Not Present
Present
None
None
None
None
None
LPe1105-M4
None
Extension(1) None
None
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
None
None
None
None
None
None
None
None
None
None
None
None
None
None
getflexaddr
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
getflexaddr
Description
Displays enabled/disabled status for the entire chassis. If used with
-i, the command displays MACs/WWN on a per slot basis.
NOTE: If FlexAddress is not activated on the chassis, the command displays
server-assigned MAC/WWN addresses. If the slot is empty, the command leaves
the server-assigned MAC/WWN addresses blank. If an external console controls
the MAC/WWN addresses, the command displays an externally managed message.
Synopsis
racadm getflexaddr [-i <slotNum>]
66
RACADM Subcommand Details
Table 2-15. getflexaddr Subcommand Options
Option
Description
-i <slotNum> Specifies the slot information to be displayed. <slotNum> can be
from 1 to 16.
Example
•
Display current flex address settings for all slots and fabrics
racadm getflexaddr
<Slot#> <Status> <Server Presence>
1
Enabled Present
2
Enabled Present
3
Enabled Not Present
Enabled Not Present
Enabled Present
4
5
6
Enabled Not Present
Enabled Not Present
Enabled Not Present
Enabled Not Present
Enabled Extension(2)
Enabled Not Present
Enabled Not Present
Enabled Extension(5)
Enabled Not Present
Enabled Not Present
Enabled Not Present
7
8
9
10
11
12
13
14
15
16
RACADM Subcommand Details
67
<Fabric> <Type>
<Status>
A
B
C
Gigabit Ethernet Enabled
None
None
Enabled
Enabled
idrac Management Controller Disabled
•
Display the current flex address setting for slot 1.
racadm getflexaddr -i 1
Slot-1 server presence = Present
Slot-1 flexaddress enabled = 1
<Fabric> <Type>
<Server-Assigned> <Chassis-Assigned>
slot1-A1 Gigabit
Ethernet
00:1C:23:CD:AC:D2 00:1E:C9:FF:E3:21
(active)
iSCSI
00:1C:23:CD:AC:D3 00:1E:C9:FF:E3:22
(active)
slot1-A2 Gigabit
Ethernet
00:1C:23:CD:AC:D4 00:1E:C9:FF:E3:23
(active)
iSCSI
00:1C:23:CD:AC:D5 00:1E:C9:FF:E3:24
(active)
slot1-B1 Gigabit
Ethernet
00:1D:09:71:B3:60 00:1E:C9:FF:E3:25(active)
iSCSI
00:1D:09:71:B3:61 00:1E:C9:FF:E3:26(active)
00:1D:09:71:B3:62 00:1E:C9:FF:E3:27(active)
slot1-B2 Gigabit
Ethernet
iSCSI
00:1D:09:71:B3:63 00:1E:C9:FF:E3:28(active)
slot1-C1 Fiber
Channel 4
10:00:00:00:C9:63 20:01:00:1E:C9:FF:E3:29(active)
:51:0E
slot1-C2 Fiber
Channel 4
10:00:00:00:C9:63 20:02:00:1E:C9:FF:E3:29(active)
:51:0D
68
RACADM Subcommand Details
getfanreqinfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getfanreqinfo
Displays fan request for Servers and Switches in percent (%).
Synopsis
racadm getfanreqinfo
Example
racadm getfanreqinfo
[Ambient Temperature Fan Request %]
38
[Server Module Fan Request Table]
<Slot#> <Server
Name>
<Blade Type>
<Power
State>
<Presence> <Fan
Request%>
1
SLOT-01
SLOT-02
SLOT-03
SLOT-04
SLOT-05
SLOT-06
SLOT-07
PowerEdgeM600 ON
PowerEdgeM905 ON
PowerEdgeM710 ON
PowerEdgeM610 ON
PowerEdgeM610 ON
Present
Present
Present
Present
Present
33
2
35
44
46
46
3
4
5
6
N/A
N/A
Not Present N/A
7
PowerEdgeM605 ON
Present
100
fwupdate
8
SLOT-08
SLOT-09
SLOT-10
PowerEdgeM710 ON
Present
44
9
N/A
N/A
N/A
Not Present N/A
10
Extension N/A
N/A
(2)
11
SLOT-11
N/A
Extension N/A
(3)
N/A
RACADM Subcommand Details
69
12
13
14
15
16
SLOT-12
SLOT-13
SLOT-14
SLOT-15
SLOT-16
N/A
N/A
N/A
N/A
Not Present N/A
Not Present N/A
PowerEdgeM600 ON
Present
33
N/A
N/A
N/A
Not Present N/A
Extension N/A
N/A
(8)
[Switch Module Fan Request Table]
<Slot#> <Server
Name>
<Blade Type>
<Power
State>
<Presence> <Fan
Request%>
1
SLOT-01
SLOT-02
SLOT-03
SLOT-04
SLOT-05
SLOT-06
SLOT-07
PowerEdgeM600 ON
PowerEdgeM905 ON
PowerEdgeM710 ON
PowerEdgeM610 ON
PowerEdgeM610 ON
Present
Present
Present
Present
Present
33
2
35
44
46
46
3
4
5
6
N/A
N/A
Not Present N/A
7
PowerEdgeM605 ON
Present
100
44
fwupdate
8
SLOT-08
SLOT-09
SLOT-10
PowerEdgeM710 ON
Present
9
N/A
N/A
N/A
Not Present N/A
10
Extension N/A
N/A
(2)
11
SLOT-11
N/A
Extension N/A
(3)
N/A
12
13
14
15
16
SLOT-12
SLOT-13
SLOT-14
SLOT-15
SLOT-16
N/A
N/A
N/A
N/A
Not Present N/A
Not Present N/A
PowerEdgeM600 ON
Present
Not Present N/A
Extension N/A N/A
(8)
33
N/A
N/A
N/A
70
RACADM Subcommand Details
[Switch Module Fan Request Table]
<IO
Name>
<Name>
<Type>
<Presence> <Fan
Request%>
Switch-1 Dell Ethernet Pass- Gigabit
Present
Present
30
Through
Ethernet
Switch-2 Dell PowerConnect
M6220
Gigabit
Ethernet
30
Switch-3 N/A
Switch-4 N/A
Switch-5 N/A
Switch-6 N/A
None
None
None
None
Not Present N/A
NotPresent N/A
Not Present N/A
Not Present N/A
getioinfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
getioinfo
Description
Displays general information about the I/O modules on the chassis.
NOTE: The fabric type may be any supported I/O fabric type, such as Ethernet,
Fiber Channel, and Infiniband.
Synopsis
racadm getioinfo
RACADM Subcommand Details
71
Example
racadm getioinfo
<IO>
<Name>
<Type>
<Presence> <POST>
Present OK
<Power> <Role>
switch-1
DellEthernet Gigabit
ON
Master
Passthrough
N/A
Ethernet
None
switch-2
switch-3
Not Present N/A
Present OK
N/A
ON
N/A
Brocade 4424 Fibre
Channel 4
Master
switch-4
switch-5
switch-6
N/A
N/A
N/A
None
Not Present N/A
Not Present N/A
Not Present N/A
N/A
N/A
N/A
N/A
N/A
N/A
None
None
getkvminfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getkvminfo
Displays iKVM module information.
Synopsis
racadm getkvminfo
Example
racadm getkvminfo
<module> <presence>
<model>
Avocent iKVM Switch
<FW Version> <status>
00.05.00.04 Ready
KVM
Present
72
RACADM Subcommand Details
getled
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getled
Displays the LED settings on a module: blinking, not blinking, or
unknown (for empty slots).
Synopsis
racadm getled -m <module>
Table 2-16. getled Subcommand Options
Option
Description
-m <module>
Specifies the module whose LED settings you want to view.
<module> can be one of the following:
•
•
server-nwhere
n
=1–16
switch-nwhere
n
=1–6
• chassis
• cmc-active
Examples
• racadm getled -m server-10
<module>
server-10
<LED state>
Blinking
• racadm getled -m chassis
<module>
server-10
<LED state>
Not blinking
• racadm getled -m server-1
<module>
server-1
<LED state>
ON
RACADM Subcommand Details
73
racadm getled -m server-9
<module>
server-9
<LED state>
Extension(1)
getmacaddress
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getmacaddress Displays the MAC/WWN addresses for all modules or for a
specified module.
Synopsis
racadm getmacaddress [-m <module>] [-t iscsi] [-x]
racadm getmacaddress [-a]
Table 2-17. getmacaddress Subcommand Options
Option
Description
-m<module> Specifies the module whose MAC address you want to view.
<module> may be one of the following:
• chassis
•
•
server-n where n=1–16
switch-n where =1–6
n
-t
Displays the iSCSI MAC addresses for all servers or the specified
server if used with -m option.
-x
Displays the extra MACs (Ethernet or iSCSI) for servers with
additional LOM MACs and must be used with -m option.
-a
Displays the Ethernet and iSCSI MAC/WWN addresses for all
iDRAC/LOMs/mezzanine cards. When FlexAddress is enabled for a
particular slot, then the chassis-assigned MAC/WWN address is
displayed.
74
RACADM Subcommand Details
Example
•
•
•
•
Display iSCSI MAC addresses for all servers.
racadm getmacaddress -t iscsi
Display iSCSI MAC for server-1.
racadm getmacaddress -m server-1 -t iscsi
Display extra iSCSI MACs for server-1 (if available).
racadm getmacaddress -m server-1 -t iscsi -x
Display MAC for server-1.
racadm getmacaddress -m server-1
<Name>
<Presence>
<BMC MAC Address> <NIC1 MAC
Address>
<NIC2 MAC
Address>
server-1 Present
00:11:43:FD:B7:2A 00:11:43:FD:B7: 00:11:43:FD:B7:2B
2A
server-9 Extension(1) N/A
00:11:43:FD:B7: 00:11:43:FD:B7:2D
2C
•
Display extra MACs for server-1 (if available).
racadm getmacaddress -m server-1 -x
<Name>
<Presence>
<BMC MAC Address> <NIC1 MAC
Address>
<NIC2 MAC
Address>
server-1 Present
00:11:43:FD:B7:2A 00:11:43:FD:B7: 00:11:43:FD:B7:2B
2A
00:11:43:FD:B7: 00:11:43:FD:B7:2D
2C
racadm getmacaddress
<Name>
CMC
<Presence>
Present
<BMC MAC Address> <NIC1 MAC
Address>
<NIC2 MAC
Address>
N/A
00:1E:4F:1F:3C N/A
:58
Server-1
Server-2
Present
00:1E:4F:2A:AF:7B 00:1E:4F:2A:D3 00:1E:4F:2A:D3:99
:97
Present
00:22:19:D2:1E:84 N/A
N/A
RACADM Subcommand Details
75
Server-3
Server-4
Not Present N/A
N/A
N/A
Present
00:18:8B:FF:45:2A 00:18:8B:FF:AA 00:18:8B:FF:AA:04
:02
Server-5
Present
00:19:B9:FF:FE:E2 00:19:B9:FF:FC 00:19:B9:FF:FC:0E
:0C
Server-6
Server-7
Present
Present
00:22:19:D2:1D:D4 N/A
N/A
00:1E:4F:FF:FC:DC 00:1E:4F:FF:F0 00:1E:4F:FF:F0:B2
:B0
Server-8
Server-9
Not Present N/A
Not Present N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Server-10 Not Present N/A
Server-11 Not Present N/A
Server-12 Not Present N/A
Server-13 Present
00:18:8B:FF:45:26 00:18:8B:FF:A9 00:18:8B:FF:A9:F4
:F2
Server-14 Present
00:22:19:D2:1E:A2 N/A
N/A
Server-15 Extension(7) N/A
00:1E:4F:FF:F0 00:1E:4F:FF:F0:B6
:B4
Server-16 Not Present N/A
N/A
N/A
Switch-1
Switch-2
Switch-3
Switch-4
Switch-5
Switch-6
Present
Present
Present
Present
Present
N/A
N/A
N/A
N/A
N/A
00:00:00:00:00 N/A
:00
00:00:00:00:00 N/A
:00
00:00:00:00:00 N/A
:00
00:00:00:00:00 N/A
:00
00:05:1E:08:EB N/A
:0B
Not Present N/A
N/A
N/A
•
Display Ethernet and iSCSI MACS of all LOMs/mezzanine cards.
racadm getmacaddress -a
<Name>
CMC
<Type>
N/A
<Presence>
Present
<BMC MAC
Address>
<NIC1 MAC
Address>
<NIC2 MAC
Address>
N/A
00:1E:4F:1F:3 N/A
C:58
76
RACADM Subcommand Details
Server-1- Gigabit
Present
Present
Present
Present
Present
Present
00:1E:4F:2A: 00:1E:4F:2A:D 00:1E:4F:2A
AF:7B 3:97 :D3:99
A
Ethernet
iSCSI
00:1E:4F:2A:D 00:1E:4F:2A
3:98 :D3:9A
Server-1- Gigabit
Not Installed Not
Installed
B
Ethernet
iSCSI
Not Installed Not
Installed
Server-1- Fibre
Not Installed Not
Installed
C
Channel 4
Server-2- Gigabit
00:22:19:D2: N/A
1E:84
N/A
A
Ethernet
iSCSI
Present
Present
N/A
N/A
Server-2- Gigabit
Not Installed Not
Installed
B
Ethernet
iSCSI
Present
Not Installed Not
Installed
Server-2- Fibre
Present
Not Installed Not
Installed
C
Channel 4
Server-3
N/A
Not Present N/A
N/A
N/A
Server-4- Gigabit
Present
Present
Not Present
Present
Present
Present
Present
Present
Present
Present
00:18:8B:FF: 00:18:8B:FF:A 00:18:8B:FF
45:2A A:02 :AA:04
A
Ethernet
iSCSI
00:18:8B:FF:A 00:18:8B:FF
A:03 :AA:05
Server-4- Gigabit
Not Installed Not
Installed
B
Ethernet
iSCSI
Not Installed Not
Installed
Server-4- Fibre
Not Installed Not
Installed
C
Channel 4
Server-5- Gigabit
00:19:B9:FF: 00:19:B9:FF:F 00:19:B9:FF
FE:E2 C:0C :FC:0E
A
Ethernet
iSCSI
00:19:B9:FF:F 00:19:B9:FF
C:0D :FC:0F
Server-5- Gigabit
Not Installed Not
Installed
B
Ethernet
iSCSI
Not Installed Not
Installed
Server-5- Fibre
Channel 4
Not Installed Not
Installed
C
RACADM Subcommand Details
77
Server-6- Gigabit
Present
00:22:19:D2: N/A
1D:D4
N/A
N/A
A
Ethernet
iSCSI
Present
Present
N/A
Server-6- Gigabit
Not Installed Not
Installed
B
Ethernet
iSCSI
Present
Present
Present
Present
Present
Present
Not Installed Not
Installed
Server-6- Fibre
Not Installed Not
Installed
C
Channel 4
Server-7- Gigabit
00:1E:4F:FF: 00:1E:4F:FF:F 00:1E:4F:FF
FC:DC 0:B0 :F0:B2
A
Ethernet
iSCSI
00:1E:4F:FF:F 00:1E:4F:FF
0:B1 :F0:B3
Server-7- Gigabit
Ethernet
00:1D:09:72:0 00:1D:09:72
1:C8 :01:CA
B
Server-7- Fibre
21:00:00:1B:3 21:01:00:1B
C
Channel 4
2:0E:CF:34
:32:2E:CF:3
4
Server-8
Server-9
N/A
N/A
Not Present N/A
Not Present N/A
Not Present N/A
Not Present N/A
Not Present N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Server-10 N/A
Server-11 N/A
Server-12 N/A
Server-
13-A
Gigabit
Ethernet
Present
Present
Present
Present
Present
00:18:8B:FF: 00:18:8B:FF:A 00:18:8B:FF
45:26 9:F2 :A9:F4
iSCSI
00:18:8B:FF:A 00:18:8B:FF
9:F3 :A9:F5
Server-
13-B
Gigabit
Ethernet
00:1D:09:71:E 00:1D:09:71
0:78 :E0:7A
iSCSI
00:1D:09:71:E 00:1D:09:71
0:79 :E0:7B
Server-
13-C
Fibre
Channel 4
21:00:00:1B:3 21:01:00:1B
2:0E:EF:30
:32:2E:EF:3
0
Server-
14-A
Gigabit
Ethernet
Present
00:22:19:D2: N/A
1E:A2
N/A
iSCSI
Present
Present
N/A
N/A
Server-
14-B
Gigabit
Ethernet
Not Installed Not
Installed
iSCSI
Present
Not Installed Not
Installed
78
RACADM Subcommand Details
Server-
14-C
Fibre
Channel 4
Present
Not Installed Not
Installed
Server-
15-A
Gigabit
Ethernet
Extension(7) N/A
Extension(7) N/A
Extension(7) N/A
Extension(7) N/A
Extension(7) N/A
00:1E:4F:FF:F 00:1E:4F:FF
0:B4 :F0:B6
iSCSI
00:1E:4F:FF:F 00:1E:4F:FF
0:B5 :F0:B7
Server-
15-B
Gigabit
Ethernet
00:1D:09:71:E 00:1D:09:71
1:20 :E1:22
iSCSI
00:1D:09:71:E 00:1D:09:71
1:21 :E1:23
Server-
15-C
Fibre
Channel 4
21:00:00:1B:3 21:00:00:1B
2:17:3A:66
:32:37:3A:6
6
Server-16 N/A
Not Present N/A
N/A
N/A
Switch-1
Switch-2
Switch-3
Switch-4
Switch-5
Switch-6
None
None
None
None
None
N/A
Present
Present
Present
Present
Present
N/A
N/A
N/A
N/A
N/A
00:00:00:00:0 N/A
0:00
00:00:00:00:0 N/A
0:00
00:00:00:00:0 N/A
0:00
00:00:00:00:0 N/A
0:00
00:05:1E:08:E N/A
B:0B
Not Present N/A
N/A
N/A
getmodinfo
NOTE: 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.
Subcommand
Description
getmodinfo
Displays configuration and status information for all modules or a
specified module (server, switch, CMC, fan unit, power supply
unit, KVM, or I2C cable) in the chassis.
Synopsis
racadm getmodinfo [-m <module>] [-A]
RACADM Subcommand Details
79
Table 2-18. getmodinfo Subcommand Options
Option
Description
-m <module>
Specifies the module whose configuration and status information
you want to view. The default command (no options) displays
information about all major components in the chassis.
<module> may be any of the following values:
•
•
•
•
•
server-n where
switch-nwhere
n
=
1–16
n=
1–6
CMC-nwhere
n
=
1–2
1–9
fan-nwhere
n=
ps-nwhere
n=1–6
• chassis
•
•
•
kvm
io-cable
fpc-cable
-A
Suppresses headers and labels in the output.
Example
• racadm getmodinfo -m switch-1
<module>
Switch-1
<presence>
Present
<pwrState>
ON
<health>
OK
<svcTag>
CG09074
• racadm getmodinfo
<module>
Chassis
Fan-1
Fan-2
Fan-3
Fan-4
Fan-5
Fan-6
Fan-7
Fan-8
Fan-9
PS-1
<presence>
Present
Present
Present
Present
Present
Present
Present
Present
Present
Present
Present
<pwrState>
ON
ON
ON
ON
ON
ON
ON
ON
ON
ON
Online
<health>
Not OK
OK
OK
OK
OK
OK
OK
OK
<svcTag>
ABC1234
OK
OK
OK
80
RACADM Subcommand Details
PS-2
PS-3
PS-4
PS-5
PS-6
CMC-1
CMC-2
Not Present
Present
Not Present
Not Present
Not Present
Present
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
Not Present
Present
Present
Present
Present
Present
Present
Not Present
Not Present
Extension(2) N/A
Not Present
Present
N/A
Online
N/A
N/A
N/A
Primary
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
OFF
ON
N/A
OK
N/A
N/A
N/A
OK
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
OK
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Switch-1
Switch-2
Switch-3
Switch-4
Switch-5
Switch-6
Server-1
Server-2
Server-3
Server-4
Server-5
Server-6
Server-7
Server-8
Server-9
Server-10
Server-11
Server-12
Server-13
Server-14
Server-15
Server-16
KVM
OK
OK
OK
OK
S YW
ON
ON
ON
ON
N/A
N/A
1234567
OK
N/A
N/A
N/A
N/A
OK
N/A
OK
OK
N/A
N/A
N/A
N/A
N/A
ON
N/A
ON
ON
ON
Not Present
Present
Present
Present
Present
N/A
0000015
OK
OK
ON
IO-Cable
FPC-Cable
Present
Present
ON
OK
ABC1234
ABC1234
ON
OK
NOTE: For CMC (only) a power state of "Primary" denotes Active CMC.
getniccfg
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getniccfg
The getniccfg subcommand displays the current NIC settings.
Synopsis
racadm getniccfg
RACADM Subcommand Details
81
Sample Output
The getniccfg subcommand displays an appropriate error message if the
operation is not successful. Otherwise, on success, the output is displayed in
the following format:
IPv4 settings:
NIC Enabled
IPv4 Enabled = 1
DHCP Enabled
IP Address
= 1
= 1
= 10.35.0.64
= 255.255.255.0
= 10.35.0.1
Subnet Mask
Gateway
IPv6 settings:
IPv6 Enabled
DHCP6 Enabled
IP Address 1
Gateway
= 0
= 1
= ::
= ::
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
= ::
= ::
= ::
= ::
= ::
= ::
= ::
= ::
= ::
= ::
= ::
= ::
= ::
82
RACADM Subcommand Details
IP Address 15
= ::
LOM Status:
NIC Selection = Dedicated
Link Detected = Yes
Speed
= 10Mb/s
Duplex Mode
= Half Duplex
NOTE: IPv6 information is displayed only if IPv6 is enabled in iDRAC6.
NOTE: LOM Status is displayed only for iDRAC6 on Rack and Tower servers and is
not displayed for iDRAC6 Enterprise on Blade servers.
getpbinfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getpbinfo
Displays power budget status information.
Synopsis
racadm getpbinfo
Example
racadm getpbinfo
[Power Budget Status]
System Input Power
= 700 W
Peak System Power
= 0 W
Peak System Power Timestamp
Minimum System Power
= 01:08:23 01/27/2009
= 0 W
Minimum System Power Timestamp = 20:18:30 01/27/2000
Overall Power Health
Redundancy
= Not OK
= No
System Input Power Cap
Redundancy Policy
= 7928 W
= None
Dynamic PSU Engagement Enabled = No
System Input Max Power Capacity = 0 W
Input Redundancy Reserve
= 0 W
Input Power Allocated to Servers = 0 W
RACADM Subcommand Details
83
Input Power Allocated to Chassis Infrastructure = 51 watts
Total Input Power Available for Allocation
Standby Input Power Capacity
= 0 W
= 0 W
[Chassis Power Supply Status Table]
<Name> <Presence> <Power State> <Input Current> <Input Volts>
<Output Rating>
PS1
Online
On
16.1 A
32 V
N/A
N/A
N/A
2360 W
PS2
Not Present
Not Present
Not Present
Slot Empty
Slot Empty
Slot Empty
N/A
N/A
PS3
N/A
N/A
PS4
N/A
N/A
PS5
N/A
PS6
N/A
[Server Module Power Allocation Table]
<Slot#><Server Name><PowerState><Allocation><Priority><Blade Type>
Not Present
Not Present
Slot Empty
Slot Empty
N/A
N/A
N/A
N/A
1
2
3
4
5
6
7
8
SLOT-01
SLOT-02
SLOT-03
SLOT-04
SLOT-05
SLOT-06
SLOT-07
SLOT-08
SLOT-09
SLOT-10
SLOT-11
SLOT-12
SLOT-13
SLOT-14
SLOT-15
SLOT-16
N/A
OFF
ON
ON
ON
ON
ON
N/A
N/A
N/A
0 W
5
5
5
5
5
5
5
5
5
5
5
5
5
5
5
5
N/A
PowerEdgeM805
N/A
164 W
155 W
180 W
180 W
170 W
N/A
PowerEdgeM600
N/A
N/A
N/A
N/A
9
N/A
10
11
12
13
14
15
16
Extension(2) N/A
N/A
ON
N/A
ON
ON
ON
N/A
125 W
N/A
342 W
140 W
125 W
PowerEdgeM600
N/A
N/A
N/A
84
RACADM Subcommand Details
getpminfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getpminfo
Displays power management status information.
Synopsis
racadm getpminfo
Example
racadm getpminfo
[Real-Time Power Statistics]
System Input Power
Peak System Power
Peak System Power Start Time
Peak System Power Timestamp
Minimum System Power
= 600 W (188 BTU/hr)
= 600 W (188 BTU/hr
= 16:02:10 01/16/2008
= 06:32:55 01/26/2009
= 400 W (177 BTU/hr)
Minimum System Power Start Time = 22:43:21 01/21/2008
Minimum System Power Timestamp = 06:32:55 01/26/2009
System Idle Power
System Potential Power
System Input Current Reading
= 68 W (188 BTU/hr)
= 68 W (188 BTU/hr)
= 31.2 A
[Real-Time Energy Statistics]
System Energy Consumption
= 6.4 kWh
System Energy Consumption Start Time
01/16/2008
= 16:02:10
System Energy Consumption Timestamp
01/16/2008
= 16:02:10
[System Power Status]
Chassis Power State
Overall Power Health
Redundancy
= ON
= OK
= No
RACADM Subcommand Details
85
[System Power Policy Configuration]
System Input Power Cap
BTU/hr | 10%)
Surplus for Peak Performance
BTU/hr)
= 7928 W (7928
= 7000 W (6130
Redundancy Policy
Dynamic PSU Engagement Enabled
= None
= No
[Power Budgeting]
System Input Max Power Capacity
Input Redundancy Reserve
Input Power Allocated to Servers
= 0 W
= 0 W
= 0 W
Input Power Allocated to Chassis Infrastructure = 51W
Total Input Power Available for Allocation
Standby Input Power Capacity
= 0 W
= 0 W
getraclog
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getraclog
The getraclog -i command displays all the RAC log entries in the
DRAC.
Synopsis
racadm getraclog -i
racadm getraclog [-A] [-o] [-c count] [-s start-
record] [--more]
Table 2-19. getraclog Subcommand Options
Option
-A
Description
Displays the output with no headers or labels.
Provides the maximum count of entries to be returned.
-c
86
RACADM Subcommand Details
Table 2-19. getraclog Subcommand Options (continued)
Option
Description
--more
Displays one screen at a time and prompts the user to continue (similar to
the UNIX more command).
-o
-s
Displays the output in a single line.
Specifies the starting record used for the display.
NOTE: If no options are provided, the entire log is displayed.
Output
The default output display shows the record number, time stamp, source, and
description. The timestamp begins at midnight, January 1 and increases until
the system boots. After the system boots, the system’s timestamp is used.
NOTE: For iDRAC6 Enterprise on Blade Servers, iDRAC6 Log entries for SystemBoot
displayed using the local racadm command racadm getraclogmay not be
correctly formatted. For example, some extra characters may be displayed in the
Description field, or the Source field may be empty.
Sample Output
Record:
1
Date/Time:
Source:
Dec 8 08:10:11
login[433]
Description: root login from 143.166.157.103
getractime
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getractime
The getractime subcommand displays the current DRAC time.
time in specific formats:
RACADM Subcommand Details
87
Table 2-20. getractime Subcommand Options
Option
-d
Description
Displays the time in the format, yyyymmddhhmmss.mmmmmms.
Displays timezone.
-z
NOTE: This option is specific to CMC only.
Displays NTP peer information.
NOTE: This option is specific to CMC only.
-n
NOTE: If no options are provided, the getractime subcommand displays the time in
a common readable format.
Synopsis
racadm getractime [-d]
racadm getractime [-d] [-z] [-n]
Sample Output
racadm getractime
Thu Dec 8 20:15:26 2005
racadm getractime -d
20051208201542.000000
getredundancymode
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getredundancy Displays the redundancy status (Redundant or Non-Redundant) of
mode
the CMC.
Synopsis
racadm getredundancymode
88
RACADM Subcommand Details
Example
racadm getredundancymode
Redundant
getsel
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getsel
The getsel subcommand display all sensor event log entries in the
DRAC.
Synopsis
racadm getsel -i[-A]
racadm getsel [-s <start>] [-c <count>] [-A] [-o] [-E]
[-R] [--more]
NOTE: If no arguments are specified, the entire log is displayed.
The following getsel options (without the -i option) are used to read entries.
Table 2-21. getsel Subcommand Options
Option
-A
Description
Specifies output with no display headers or labels.
Provides the number of records to be displayed.
Displays each entry in the SEL in a single line.
Specifies the starting record used for the display.
Displays RAW SEL data with the other data for each entry.
Displays only RAW SEL data for each entry.
Displays the number of entries in the SEL.
-c
-o
-s
-E
-R
-i
--more
Displays one screen at a time and prompts the user to continue (similar to
the UNIX more command).
RACADM Subcommand Details
89
Output
The default output display shows the record number, timestamp, severity, and
description.
For example:
Record:
Date/Time: 11/16/2005 22:40:43
Severity: Ok
1
Description: System Board SEL: event log sensor for
System Board, log cleared was asserted
getsensorinfo
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getsensorinfo
Displays status for system sensors.
Synopsis
racadm getsensorinfo
Examples
racadm getsensorinfo
<senType> <Num> <sensorName> <status> <reading> <units> <lc> <uc>
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
1
2
3
4
5
6
7
8
9
Fan-1
Fan-2
Fan-3
Fan-4
Fan-5
Fan-6
Fan-7
Fan-8
Fan-9
OK
OK
4768
4873
4832
4704
4833
4829
4719
1
rpm
rpm
rpm
rpm
rpm
rpm
rpm
rpm
rpm
2344 14500
2344 14500
2344 14500
2344 14500
2344 14500
2344 14500
2344 14500
2344 14500
2344 14500
OK
OK
OK
OK
OK
Not OK
OK
4815
<senType> <Num> <sensorName> <status> <reading> <units> <lc> <uc>
Temp Ambient_Temp OK 22 celcius N/A 40
1
90
RACADM Subcommand Details
<senType> <Num>
<sensorName>
PS-1
<status>
Online
<AC-OK status>
PWR
PWR
PWR
PWR
PWR
PWR
1
2
3
4
5
6
OK
PS-2
Online
OK
PS-3
Online
OK
PS-4
Slot Empty
Failed
N/A
OK
PS-5
PS-6
Slot Empty
N/A
<senType> <Num>
<sensorName>
IO-Cable
<status>
Cable
Cable
1
2
OK
OK
FPC-Cable
getslotname
NOTE: To use this subcommand, you must have CMC Login User privilege.
Subcommand
Description
getslotname
Displays the name and hostname (if available) of all 16 slots, or of a
specified slot (indicated by the slot number) in the chassis.
Optionally, this command can be used to find if the slot name or
hostname is displayed in the CMC User Interface or with the
getslotname -i <slot ID>command. If the hostname
is not available, the static slot name is used.
Synopsis
racadm getslotname
racadm getslotname -i <slot ID>
racadm getslotname -h
RACADM Subcommand Details
91
Table 2-22. getslotname Subcommand Options
Option
Description
(None)
Displays the slot name for all 16 slots in
the chassis.
-i <slot ID>
Specifies the ID of the slot.
Legal values: 1–16
-h
Specifies whether to use the slot name
or the hostname (if available).
1=use hostnames, 0=use slotnames
Example
• racadm getslotname
<Slot #> <Slot Name>
<Host name>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
SLOT-01
Webserver01
Webserver3
SLOT-04
SLOT-05
SLOT-06
SLOT-07
SLOT-08
SLOT-09
SLOT-10
SLOT-11
SLOT-12
SLOT-13
SLOT-14
SLOT-15
SLOT-16
WXP-8GRB221
WXP-319QWEecet5
• racadm getslotname -i 1
Webserver-1
92
RACADM Subcommand Details
getssninfo
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getssinfo
Displays a list of users that are connected to iDRAC6. The
following information is displayed:
• Session ID
• Username
• IP address (if applicable)
• Session type (for example, serial or Telnet)
• Login date and time in MM/DD/YYYY HH:MM:SS format
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 ,
Synopsis
racadm getssninfo [-A] [-u <username> | *]
Table 2-23. getssninfo Subcommand Options
Option Description
-A
-u
The -A option eliminates the printing of data headers.
The -u <username> user name option limits the printed output to only
the detail session records for the given user name. If an (*) symbol is given
as the user name, all users are listed. Summary information is not printed
when this option is specified.
RACADM Subcommand Details
93
Examples
• racadm getssninfo
SSNID
Type
User
IP Address
Login Date/Time
6
GUI
root
192.168.0.10
04/07/2010 12:00:34
• racadm getssninfo -A
"root" "143.166.174.19" "Telnet" "NONE"
• racadm getssninfo -A -u *
"root" "143.166.174.19" "Telnet" "NONE"
"bob" "143.166.174.19" "GUI" "NONE"
getsvctag
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getsvctag
Displays the service tag of the host system.
Synopsis
racadm getsvctag
Example
Type getsvctagat the command prompt. The output is displayed as
follows:
Y76TP0G
94
RACADM Subcommand Details
getsysinfo
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
getsysinfo
Displays information related to iDRAC, managed system, and
watchdog configuration.
NOTE: The local racadm getsysinfo subcommand on Linux displays the
PrefixLength on separate lines for IPv6 Address 2 – IPv6 Address 15 and the Link
Local Address.
Synopsis
racadm getsysinfo [-d] [-s] [-w] [-A] [-c] [-4] [-6]
Table 2-24. getsysinfo Subcommand Options
Option
-4
Description
Displays IPv4 settings
-6
Displays IPv6 settings
-c
Displays common settings
Displays iDRAC6 information
Displays system information
Displays watchdog information
Eliminates the printing of headers/labels
-d
-s
-w
-A
If the -w option is not specified, then the other options are used as defaults.
Sample Output
RAC Information:
RAC Date/Time
= 10/27/2009 14:38:00
Firmware Version
Firmware Build
= 1.30
= 20
RACADM Subcommand Details
95
Last Firmware Update
Hardware Version
MAC Address
= 10/26/2009 16:55:08
= 0.01
= 00:24:e8:2e:c5:d3
Common settings:
Register DNS RAC Name = 1
DNS RAC Name
= eval710-08-r
= blr.amer.dell.com
Current DNS Domain
Domain Name from DHCP = 1
IPv4 settings:
Enabled
= 1
Current IP Address
Current IP Gateway
Current IP Netmask
DHCP Enabled
= 10.94.20.134
= 10.94.20.1
= 255.255.254.0
= 1
Current DNS Server 1
Current DNS Server 2
= 163.244.180.39
= 163.244.180.40
DNS Servers from DHCP = 1
IPv6 settings:
Enabled
= 1
Current IP Address 1
Current IP Gateway
Autoconfig
= ::
= ::
= 1
Link Local IP Address = fe80::224:e8ff:fe2e:c5d3/255
Current IP Address 2
Current IP Address 3
Current IP Address 4
= ::
= ::
= ::
96
RACADM Subcommand Details
Current IP Address 5
Current IP Address 6
Current IP Address 7
Current IP Address 8
Current IP Address 9
= ::
= ::
= ::
= ::
= ::
Current IP Address 10 = ::
Current IP Address 11 = ::
Current IP Address 12 = ::
Current IP Address 13 = ::
Current IP Address 14 = ::
Current IP Address 15 = ::
DNS Servers from DHCPv6 = 0
Current DNS Server 1
Current DNS Server 2
= ::
= ::
System Information:
System Model
= PowerEdge R710
= 1.0.4
System BIOS Version
Service Tag
= 2X2Q12S
Express Svc Code
Host Name
= 39059052868
= WIN-IHF5D2BF5SN
OS Name = Microsoft Windows Server 2008, Enterprise
x64 Edition
System Revision
Power Status
= I
= ON
Embedded NIC MAC Addresses:
NIC1 Ethernet
iSCSI
= 00:24:e8:2e:c5:cb
= 00:24:e8:2e:c5:cc
RACADM Subcommand Details
97
NIC2 Ethernet
iSCSI
= 00:24:e8:2e:c5:cd
= 00:24:e8:2e:c5:ce
= 00:24:e8:2e:c5:cf
= 00:24:e8:2e:c5:d0
= 00:24:e8:2e:c5:d1
= 00:24:e8:2e:c5:d2
NIC3 Ethernet
iSCSI
NIC4 Ethernet
iSCSI
Watchdog Information:
Recovery Action
= None
Present countdown value = 15 seconds
Initial countdown value = 15 seconds
Examples
• racadm getsysinfo -A -s
"System Information:" "PowerEdge 2900" "A08" "1.0"
"EF23VQ-0023" "Hostname"
"Microsoft Windows 2000 version 5.0, Build Number
2195, Service Pack 2" "ON"
• racadm getsysinfo -w -s
System Information:
System Model
System Revision
System BIOS Version
BMC Firmware Version
Service Tag
= PowerEdge 2900
= I
= 0.2.3
= 0.17
= 48192
Host Name
OS Name
= racdev103
= Microsoft Windows
Server 2003
Power Status
= OFF
Watchdog Information:
Recovery Action
= None
Present countdown value = 0 seconds
Initial countdown value = 0 seconds
98
RACADM Subcommand Details
Limitations
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. If it is not installed, 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.
gettracelog
NOTE: To use this subcommand, you must have Login to iDRAC permission.
Subcommand
Description
gettracelog
The gettracelog sub command lists all the trace log entries in the
DRAC.
Table 2-25. gettracelog Subcommand options
Option
-i
Description
Displays the number of entries in iDRAC6 trace log.
-m
Displays one screen at a time and prompts the user to continue
(similar to the UNIX more command).
-o
-c
-s
Displays each entry in a single line.
Specifies the number of records to display.
Specifies the starting record to display.
Do not display headers or labels.
-A
Synopsis
racadm gettracelog -i[-A]
racadm gettracelog [-s <start>] [-c <count>] [-m] [-A]
[-o]
RACADM Subcommand Details
99
Output
The default output display shows the record number, timestamp, source, and
description. The timestamp begins at midnight, January 1 and increases until
the system boots. After the system boots, the system’s timestamp is used.
For example:
Record:
Date/Time: Dec 8 08:21:30
Source: ssnmgrd[175]
1
Description: root from 143.166.157.103: session
timeout sid 0be0aef4
getuscversion
NOTE: This option is applicable only for iDRAC6.
Subcommand
Description
getuscversion
Displays the current USC software version details in iDRAC.
Synopsis
racadm getuscversion
Example
$ racadm getuscversion
1.2.3.4
100
RACADM Subcommand Details
getversion
NOTE: To use this subcommand, you must have Login privilege.
Subcommand
Description
getversion
Displays the current software version, model and generation
information, and whether or not the target device can be updated.
Synopsis
racadm getversion [-b | -c] [-m <module>]
racadm getversion -l [-m <module>] [-f <filter>]
racadm getversion
Table 2-26. getversion Subcommand Options
Option
Description
(none)
Displays the version information for all targets or devices.
-m
<module>
Specifies the module or device for which you want to retrieve the
version information.
<module> is one of the following:
•
server-
• cmc- where n= 1 or 2. For example, cmc-2
Displays the server's current CPLD version.
n
where
n
= 1-16. For example, server-1.
n
.
-c
-b
-l
Displays the server's current BIOS version (default is iDRAC version).
Displays the firmware versions of available server components.
RACADM Subcommand Details
101
Table 2-26. getversion Subcommand Options (continued)
Option
Description
-f <filter>
Filters the components. Must be used with -l and be one of the
following values:
• bios: BIOS
• idrac: iDRAC
• usc: Lifecycle Controller (Unified Server Configurator)
• diag: 32-bit Diagnostics
• drivers: OS Driver Package
• nic-x: Network Interface card. See -
l
output for possible values of x
• raid-x: Raid Controller. See - output for possible values of x
l
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 on the Dell
Support website at dell.com/support/manuals.
Example
• racadm getversion -m server-15
<server> <iDRAC version> <model name> <Gen> <Updatable>
server-15
2.00(Build 10) PowerEdgeM605 iDRAC
N
racadm getversion
<Server> <iDRAC Version> <Blade Type> <Gen> <Updatable>
server-2 1.50
server-3 2.10
server-4 1.50
PowerEdgeM600 iDRAC Y
PowerEdgeM610 iDRAC6 Y
PowerEdgeM605 iDRAC Y
<CMC>
cmc-1
<CMC Version>
<Updatable>
2.10.X06.200906
080825
Y
102
RACADM Subcommand Details
• racadm getversion -c
<Server>
server-1
server-2
server-5
<CPLD Version> <Blade Type>
PowerEdgeM600
PowerEdgeM805
PowerEdgeM710
1.0.0
• racadm getversion -b
<Server>
server-1
server-2
server-5
<BIOS Version> <Blade Type>
2.0.0
1.1.0
1.1.0
PowerEdgeM605
PowerEdgeM805
PowerEdgeM710
• racadm getversion -l -m server-1
<Server> <Component>
server-1 BIOS
iDRAC
<Version>
1.2.1
<Install Date>
2010-11-22
2010-11-22
2011-02-05
2011-02-07
2010-11-22
2011-02-02
3.20
USC
1.5.0.667
5144A0
6.3.0.15
5.2.0
Diagnostics
OS Drivers
Broadcom 5709
Emb(nic-1)
Broadcom 5709
Emb(nic-1)
5.2.0
5.2.0
5.2.0
2011-02-02
2011-02-02
2011-02-02
Broadcom 5709
Emb(nic-1)
Broadcom 5709
Emb(nic-1)
PERC6 EMB (raid-2) 07.01.34.00
BIOS 0.1.7
2011-02-02
Rollback
RACADM Subcommand Details
103
BIOS
1.2.1
3.20
Reinstall
Reinstall
Rollback
Reinstall
iDRAC
PERC6 Emb (raid-2) 07.01.33.00
PERC6 Emb (raid-2) 07.01.33.00
• racadm getversion -l -m server-1 -f bios
<Server>
server-1
<Component>
BIOS
<Version>
1.2.1
<Install Date>
2010-11-22
ifconfig
NOTE: To use this subcommand, you must have Execute Diagnostic Commands or
Configure iDRAC permission.
Subcommand
Description
ifconfig
Displays the contents of the network interface table.
Synopsis
racadm ifconfig
Example
$ racadm ifconfig
eth0 Link encap:Ethernet HWaddr 00:1D:09:FF:DA:23
inet addr:10.35.155.136 Bcast:10.35.155.255
Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500
Metric:1
RX packets:2550665 errors:0 dropped:0
overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0
carrier:0
104
RACADM Subcommand Details
collisions:0 txqueuelen:1000
RX bytes:272532097 (259.9 MiB) TX bytes:0
(0.0 B)
krbkeytabupload
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand
Description
krbkeytabupload
Uploads a Kerberos keytab file.
Synopsis
racadm krbkeytabupload [-f <filename>]
<filename> is the name of the file including the path.
Table 2-27. kerbkeytabupload Subcommand Options
Option
Description
-f
Specifies the file name of the keytab to be uploaded. If the file is not
specified, the keytab file in the current directory is selected.
The krbkeytabupload command returns 0when successful and returns
a non–zero number when unsuccessful.
Example
racadm krbkeytabupload -f c:\keytab\krbkeytab.tab
RACADM Subcommand Details
105
kmcSelfSignedCertGen
NOTE: The current release does not support this subcommand.
NOTE: This is a non-extensible command that does not take any specific options.
Subcommand
Description
kmcSelfSignedCertGen Generates the new self signed certificate for KMS
purposes.
To generate a selfsigned certificate, data such as certificate specific
information like Common name, Organization Unit, key size and so on, are
required.This information is taken from the cfgRacSecurityData group with
index set to 2.
localConRedirDisable
NOTE: Only a local RACADM user can execute this command.
NOTE: This option is applicable only for iDRAC6..
Subcommand
Description
localConRedirDisable
Disables Virtual Console to the management station.
Synopsis
racadm localConRedirDisable <option>
If <option>is set to 1, Virtual Console is disabled.
If <option>is set to 0, Virtual Console is enabled.
106
RACADM Subcommand Details
netstat
NOTE: To use this subcommand, you must have Execute Diagnostic Commands
permission.
Subcommand
Description
netstat
Displays the routing table and the current connections.
Synopsis
racadm netstat
ping
NOTE: To use this subcommand, you must have Execute Diagnostic Commands or
Configure iDRAC permission.
Subcommand Description
ping
Verifies that the destination IP address is reachable from iDRAC6
with the current routing-table contents. A destination IP address is
required. An ICMP echo packet is sent to the destination IP address
based on the current routing-table contents.
Synopsis
racadm ping <ipaddress>
RACADM Subcommand Details
107
ping6
NOTE: To use this subcommand for CMC you must have Administrator privilege for
CMC and for iDRAC you must have Execute Diagnostic Commands or Configure
iDRAC6 permission.
Subcommand Description
ping6
Verifies that the destination IPv6 address is reachable from iDRAC6
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 based on the current routing-table contents.
Synopsis
racadm ping6 <ipv6address>
Examples
racadm iping6 10.9.72.254
IPING6 10.9.72.254 (10.9.72.254): 56 data bytes
64 bytes from 10.9.72.254: icmp_seq=0 ttl=121 time=2.9
ms
--- 10.9.72.254 ping statistics ---
1 packets transmitted, 1 packets received, 0 percent
packet loss
round-trip min/avg/max = 2.9/2.9/2.9 ms
108
RACADM Subcommand Details
racdump
NOTE: To use this subcommand for CMC you must have Administrator privilege
and for iDRAC you must have Debug permission.
Subcommand Description
racdump
Provides a single command to get dump, status, and general iDRAC6
board information.
For CMC, this subcommand displays the comprehensive chassis
status and configuration state information, as well as historic event
logs. Used for post deployment configuration verification and during
debugging sessions.
The following information is displayed when the racdump subcommand is
processed:
•
•
•
•
•
General system/RAC information
Coredump
Session information
Process information
Firmware build information
Racdump includes the following subsystems and aggregates the following
RACADM commands:
Subsystem
RACADM Command
getsysinfo
General System/RAC information
Session information
getssinfo
Sensor information
getsensorinfo
getioinfo
Switches information (IO Module)
Mezzanine card information (Daughter card) getdcinfo
All modules information
Power budget information
KVM information
getmodinfo
getpbinfo
getkvminfo
RACADM Subcommand Details
109
Subsystem
RACADM Command
getniccfg
NIC information (CMC module)
Redundancy information
getredundancymode
Synopsis
racadm racdump
Example
racadm racdump
=====================================================
==========================
General System/RAC Information
=====================================================
==========================
CMC Information:
CMC Date/Time
=
Wed, 28 Nov 2007 11:55:49 PM
Active CMC Version
Standby CMC Version
Last Firmware Update
Hardware Version
Current IP Address
Current IP Gateway
Current IP Netmask
DHCP Enabled
= X08
= N/A
= Wed Nov 21 21:37:56 2007
= 2
= 10.35.155.160
= 10.35.155.1
= 255.255.255.0
= 1
MAC Address
Current DNS Server 1
Current DNS Server 2
= 00:55:AB:39:10:0F
= 0.0.0.0
= 0.0.0.0
DNS Servers from DHCP = 0
Register DNS CMC Name = 0
DNS CMC Name
= cmc-servicetag
Current DNS Domain
=
Chassis Information:
System Model
= PowerEdgeM1000eControlPanel
110
RACADM Subcommand Details
System AssetTag
Service Tag
= 00000
=
Chassis Name
Chassis Location
Power Status
= Dell Rack System
= [UNDEFINED]
= ON
=====================================================
==========================
Session Information
=====================================================
==========================
Type
SSH
User
root
root
IP Address
Login Date/Time
10.9.72.252
169.254.31.30
11/28/2007 23:40:53
11/28/2007 18:44:51
KVM
=====================================================
==========================
Sensor Information
=====================================================
==========================
<senType> <Num> <sensorName> <status> <reading> <units> <lc> <uc>
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
FanSpeed
1
2
3
4
5
6
7
8
9
Fan-1
Fan-2
Fan-3
Fan-4
Fan-5
Fan-6
Fan-7
Fan-8
Fan-9
OK
OK
14495
14505
4839
14527
14505
4835
14521
1
rpm
rpm
rpm
rpm
rpm
rpm
rpm
rpm
rpm
7250 14500
7250 14500
2344 14500
7250 14500
7250 14500
2344 14500
7250 14500
7250 14500
2344 14500
OK
OK
OK
OK
OK
Not OK
OK
4826
<senType> <Num> <sensorName> <status> <reading> <units> <lc> <uc>
Temp Ambient_Temp OK 21 celcius N/A 40
1
RACADM Subcommand Details
111
<senType> <Num> <sensorName> <status>
<AC-OK status>
PWR
PWR
PWR
PWR
PWR
PWR
1
2
3
4
5
6
PS-1
PS-2
PS-3
PS-4
PS-5
PS-6
Online
Online
OK
OK
Online
OK
Slot Empty
Failed
N/A
OK
Slot Empty
N/A
racreset
NOTE: To use this subcommand for CMC you must have Chassis Administrator
privilege and for iDRAC you must have Configure iDRAC permission.
NOTE: When you issue a racreset subcommand, iDRAC6 may require up to two
minutes to return to a usable state.
Subcommand Description
racreset
Issues a reset to iDRAC6. The reset event is written into iDRAC6 log.
NOTE: You must reboot your system after performing a hard reset of iDRAC6 as
described in Table 2-28.
Synopsis
racadm racreset [hard | soft]
Table 2-28. racreset Subcommand Options
Option
Description
hard
A hard reset performs a deep reset operation on the remote access
controller. A hard reset should only be used as a last case resort of
resetting iDRAC6 controller for recovery purposes.
soft
A soft reset performs a graceful reboot operation on the RAC.
Examples
• racadm racreset
Start the iDRAC6 soft reset sequence.
112
RACADM Subcommand Details
• racadm racreset hard
Start the iDRAC6 hard reset sequence.
racresetcfg
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand Description
racresetcfg
Removes all user-configured database property entries. The database
has default properties for all entries that are used to restore iDRAC6
to the default settings. After resetting the database properties,
iDRAC6 resets automatically.
NOTE: The racresetcfg subcommand does not reset the cfgDNSRacName object.
NOTE: This command deletes your current iDRAC6 configuration and resets
iDRAC6 and serial configuration to the default settings. After reset, the default name
and password is root and calvin, respectively, and the IP address is 192.168.0.120.
Only for iDRAC6 Enterprise on Blade servers, it is IP address plus the number of the
slot the server inhabits in the chassis. If you issue racresetcfg from a network client
(for example, a supported Web browser, Telnet/ssh, or remote RACADM), you must
use the default IP address.
NOTE: Certain iDRAC6 firmware processes need to be stopped and restarted for
reset to defaults to complete. iDRAC6 becomes unresponsive for about 30 seconds
while this operation completes.
Synopsis
racadm racresetcfg
RACADM Subcommand Details
113
remoteimage
NOTE: To use this subcommand, you must have Administrator permission.
Subcommand Description
remoteimage Connects, disconnects, or deploys a media file on a remote server.
Synopsis
racadm remoteimage <options>
Table 2-29. remoteimage Subcommand Options and Descriptions
Option Description
-c
-d
-u
-p
-l
Connect the image.
Disconnect image.
Username to access the network share.
Password to access the network share.
Image location on the network share; use double quotes around the
location.
-s
Display current status; –a is assumed if not specified.
NOTE: If a drive is already connected, this remote image -c (connect) command
terminates the previous command or the previous session.
Example
racadm remoteimage -c -u user -p password -l
//10.94.192.100/CommonShare/diskette.img
114
RACADM Subcommand Details
serveraction
NOTE: To use this subcommand, you must have Execute Server Control Commands
permission.
Subcommand Description
serveraction Enables users to perform power management operations on the host
system.
Synopsis
racadm serveraction <action>
Table 2-30. serveraction Subcommand Options
String
Description
<action>
Specifies the action. The options for the <action> string are:
•
•
•
powerdown — Powers down the managed system.
powerup — Powers up the managed system.
powercycle — Issues a power-cycle operation on the managed
system. This action is similar to pressing the power button on the
system’s front panel to power down and then power up the system.
•
•
powerstatus — Displays the current power status of the server (ON
or OFF)
hardreset — Performs a reset (reboot) operation on the managed
system.
Output
The serveraction subcommand displays an error message if the requested
operation could not be performed, or a success message if the operation is
completed successfully.
RACADM Subcommand Details
115
Table 2-31. setassettag Subcommand Options
Option
Command
-m <module>
Specifies the module whose asset tag you want to set.
Legal value: chassis
NOTE: Because there is only one legal value, you can
obtain the same output if you do not include this option.
NOTE: <assettag> is a maximum of 64 non-extended ASCII
characters.
Example
Input:
racadm setassettag -m chassis 783839–33
or
racadm setassettag 783839–33
The asset tag was changed successfully.
setchassisname
NOTE: To use this subcommand, you must have Administrator privilege.
Subcommand Description
setchassisname Sets the name of the chassis in the LCD.
Synopsis
racadm setchassisname <name>
NOTE: Chassisname is a maximum of 64 non-extended ASCII characters
Example
racadm setchassisname dellchassis-1
The chassis name was set successfully.
RACADM Subcommand Details
117
setflexaddr
NOTE: To use this subcommand, you must have Chassis Configuration
Administrator privilege.
Subcommand Description
setflexaddr
Enables/disables FlexAddress on a particular slot/fabric.
NOTE: If the fabric type is determined to be Infiniband, the operation is canceled
and the command returns an error. If the FlexAddress feature is not activated, the
command returns an error.
NOTE: The server must be powered off to change the slot state. All servers must be
powered off to change the fabric state. The MAC/WWN addresses must be
managed locally (not by an external console) to use this command.
Synopsis
racadm setflexaddr [-i <slot#> <state>]
[-f <fabricName> <state>]
<slot#> = 1 to 16
<fabricName> = A, B, C
<state> = 0 or 1
where 0 is disable and 1 is enable.
Table 2-32. setflexaddr Subcommand Options
Option
Description
-i <slot#> <state>
Enables/disables FlexAddress for the specified slot.
-f <fabricName> <state> Enables/disables FlexAddress for the specified fabric.
118
RACADM Subcommand Details
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
NOTE: To use this subcommand, you must have Login access and Administrator
privilege for CMC and Configure iDRAC permission for iDRAC.
Subcommand Description
setled
Sets the state (blinking or not blinking) of the LED on the specified
module.
Synopsis for iDRAC6
racadm setled -l <ledState>
Synopsis for CMC
racadm setled -m <module> -l <ledState>
RACADM Subcommand Details
119
Table 2-33. setled Subcommand Options
Option
Description
-m <module>
NOTE: This option is applicable for CMC only.
Specifies the module whose LED you want to configure.
<module> can be one of the following:
•
•
server-nwhere
n
=1–16
=1–6
switch-nwhere
n
• cmc-active
• chassis
-l <ledstate>
Specifies whether the LED should blink.
<ledstate> can be one of the following:
•
•
0
1
— no blinking
— blinking
Example for CMC
• racadm setled -m server-1 -1 1
LED state was set successfully.
NOTE: The setled command generates an error when used on the extension slot of
a multi-slot server.
• racadm setled -m server-9 -1 1
ERROR: Server in slot 9 is an extension of the
server in slot 1.
Example for iDRAC6
• racadm setled -l 1
LED state was set successfully.
120
RACADM Subcommand Details
setniccfg
NOTE: To use the setniccfg command, you must have Configure iDRAC permission.
Subcommand Description
setniccfg The setniccfg subcommand sets the iDRAC6 IP address. It displays
an error message if the requested operation could not be performed,
or a success message if the operation completed successfully.
NOTE: The terms NIC and Ethernet management port may be used
interchangeably.
Synopsis
racadm setniccfg -d
racadm setniccfg -d6
racadm setniccfg -s <IPv4Address> <netmask> <IPv4
gateway>
racadm setniccfg -s6 <IPv6 Address> <IPv6 Prefix
Length> <IPv6 Gateway>
racadm setniccfg -o
Table 2-34. setniccfg Subcommand Options
Option Description
-d
Enables DHCP for the NIC (default is DHCP disabled).
Enables AutoConfig for the NIC. It is enabled by default.
-d6
-s
Enables static IP settings. The IPv4 address, netmask, and gateway can be
specified. Otherwise, the existing static settings are used. <IPv4Address>,
<netmask>, and <gateway> must be typed as dot-separated strings.
racadm setniccfg -s 192.168.0.120 255.255.255.0
192.168.0.1
-s6
Enables static IPv6 settings. The IPv6 address, Prefix Length, and the IPv6
Gateway can be specified.
RACADM Subcommand Details
121
setractime
NOTE: To use this subcommand, you must have Administrator privilege.
Subcommand Description
setractime
Sets the date and time on the CMC.
Synopsis
racadm setractime -d <yyyymmddhhmmss.mmmmmmsoff>
racadm setractime [-l YYYYMMDDhhmmss] -z
{?|timezone|timezone-prefix*}
Table 2-35. setractime Subcommand Options
Option
Description
-d
Sets the time in the string yyyymmddhhmmss.mmmmmmsoff where:
•
•
•
•
•
•
•
•
yyyyis a the year
mmis the month
ddis the day
hhis the hour
mmis the minutes
ssis the seconds
mmmmmmis the number of microseconds
s
is a
+
(plus) sign or a
-
(minus) sign, which indicates the sign of the
offset
•
offis the offset in minutes
NOTE: The offis the offset in minutes from GMT and must be in 15-minute
increments. The timezone is represented as an offset from GMT, and the
clock does not automatically adjust for daylight savings time (for '-d'
option).
122
RACADM Subcommand Details
Table 2-35. setractime Subcommand Options (continued)
Option Description
-z <zone> Sets the time zone by name or index, or lists possible time zones.
<zone> may be:
• <?> lists the major timezone names/prefixes
• <timezone> is the case-sensitive name of your timezone or the index
listed by '-z timezone-prefix*'.
• <timezone-prefix*> is a prefix of one or more timezones, followed by
'*'.
NOTE: The timezone/daylight savings time is fully supported for '-l' and '-z'
options. Omit the '-l' option to set the timezone only (eg. '-z US/Central').
-l
Sets the local date and time in the string yyyymmddhhmmsswhere:
•
•
•
•
•
•
yyyyis a the year
mmis the month
ddis the day
hhis the hour
mmis the minute
ssis the second
NOTE: 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. To set the date to October 24, 2007 at 3:02:30
PM PST:
racadm setractime -l 20071024150230 -z PST8PDT
The time was set successfully.
RACADM Subcommand Details
123
setslotname
NOTE: To use this subcommand, you must have Administrator privilege.
NOTE: See the "Editing Slot Names" section in the Dell Chassis Management
Controller User Guide for rules for selecting slot names.
Subcommand Description
setslotname Displays the name and hostname (if available) of all 16 slots, or of a
specified slot (indicated by the slot number) in the chassis.
Optionally, this command can be used to set whether the slot name or
hostname is displayed in the CMC User Interface or with the
getslotname -i <slot ID> command. If the hostname is not available,
the static slot name is used.
NOTE: The OMSA server agent must be present and running on the server to use
the Display Hostname feature. If the agent is not running, the setting is ignored. For
more information, see the Dell OpenManage Server Administrator User's Guide at
dell.com/support/manuals.
Synopsis
racadm setslotname -i <slotID> <slotname>
racadm setslotname -h <enabled>
Table 2-36. setslotname Subcommand Options
Option
Description
<slotID>
Displays the location of the slot in the chassis.
Legal values: 1–16
<slotname>
The new name to assign to the slot.
Sets whether the server's hostname is used for display purposes.
1 = enabled
<enabled>
Legal values: 0, 1
124
RACADM Subcommand Details
Example
racadm setslotname -i 3 mserver3
The slot name was set successfully.
setsysinfo
NOTE: To use this subcommand, you must have Administrator privilege.
Subcommand Description
setsysinfo
Sets the name or location of the chassis.
Synopsis
racadm setsysinfo [-c chassisname|chassislocation]
<string>
Table 2-37. setsysinfo Subcommand Options
Option
Description
<string>
Indicates a maximum of 64 non-extended ASCII chassis name
or location.
-c
Sets the chassis name or location.
Example
racadm setsysinfo -c chassisname "Dell Rack System"
The chassis name was set successfully.
RACADM Subcommand Details
125
sshpkauth
Subcommand Description
sshpkauth
Enables you to upload and manage up to 4 different SSH public keys
per user. You can upload a key file or key text, view keys, or delete keys.
This command has three mutually exclusive modes—upload, view, and delete
command.
Synopsis
racadm sshpkauth
Upload
The upload mode allows you to upload a keyfile or to copy the key text on the
command line. You cannot upload and copy a key at the same time.
Local and Remote RACADM:
racadm sshpkauth -i <2 to 16> -k <1 to 4> -f
<filename>
racadm sshpkauth -i <2 to 16> -k <1 to 4> -t
<key-text>
Telnet/ssh/serial RACADM:
racadm sshpkauth -i <2 to 16> -k <1 to 4> -t
<key-text>
View
The view mode allows the user to view a key specified by the user or all keys.
racadm sshpkauth -i <2 to 16> -v -k <1 to 4>
racadm sshpkauth -i <2 to 16> -v -k all
126
RACADM Subcommand Details
Delete
The delete mode allows the user to delete a key specified by the user or all
keys.
racadm sshpkauth -i <2 to 16> -d -k <1 to 4>
racadm sshpkauth -i <2 to 16> -d -k all
Table 2-38. sshpkauth Subcommand Options
Option
Description
-i <user index>
Index for the user. <user index> must be between 2 to 16 on
iDRAC6.
-k [<key index> | all] Index to assign the PK key being uploaded. all only works with
the -v or -d options. <key index> must be between 1 to 4 or
all on iDRAC6.
-t <PK Key Text>
Key text for the SSH Public key.
-f <filename>
File containing the key text to upload. The -f option is not
supported on Telnet/ssh/serial RACADM.
-v
View the key text for the index provided.
Delete the key for the index provided.
-d
Examples
Upload an invalid key to iDRAC6 User 2 in the first key space using a string:
$ racadm sshpkauth -i 2 -k 1 -t "This is invalid key
Text"
ERROR: Key text appears to be corrupt
Upload a valid key to iDRAC6 User 2 in the first key space using a file:
$ racadm sshpkauth -i 2 -k 1 -f pkkey.key
Key file successfully uploaded.
Get all keys for User 2 on iDRAC6:
$ racadm sshpkauth -v -i 2 -k all
********************* User ID 2 ******************
Key ID 1:
RACADM Subcommand Details
127
ssh-rsa
AAAAB3NzaC1yc2EAAAABIwAAAIEAzzy+k2npnKqVEXGXIzo0sbR6J
gA5YNbWs3ekoxXV
fe3yJVpVc/5zrrr7XrwKbJAJTqSw8Dg3iR4n3vUaP+lPHmUv5Mn55
Ea6LHUslAXFqXmOdlThd
wilU2VLw/iRH1ZymUFnut8ggbPQgqV2L8bsUaMqb5PooIIvV6hy4i
sCNJU= 1024-bit RSA, converted from OpenSSH by
Key ID 2:
Key ID 3:
Key ID 4:
sslcertdownload
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand
Description
sslcertdownload Downloads an SSL certificate from iDRAC6 to the client’s file system.
Synopsis
racadm sslcertdownload -t <type> [-f <filename>]
Table 2-39. sslcertdownload Subcommand Options
Option Description
-t
Specifies the type of certificate to download, either the CA certificate for
Directory Service or the server certificate.
1 = server certificate
2 = CA certificate for Directory Service
3 = KMS public certificate
4 = KMC public certificate
NOTE: The current release does not support type 3 and 4.
128
RACADM Subcommand Details
Table 2-39. sslcertdownload Subcommand Options
-f
Specifies the file name of the certificate to be uploaded. If the -f option or the
filename is not specified, the sslcert file in the current directory is selected.
The sslcertdownload command returns 0when successful and returns a
nonzero number when unsuccessful.
Example
racadm sslcertdownload -t 1 -f c:\cert\cert.txt
sslcertupload
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand
Description
sslcertupload
Uploads a custom SSL server or CA certificate
for Directory Service from the client to
iDRAC6.
Synopsis
racadm sslcertupload -t <type> [-f <filename>]
RACADM Subcommand Details
129
Table 2-40. sslcertupload Subcommand Options
Option Description
-t
Specifies the type of certificate to upload, either the CA certificate for
Directory Service or the server certificate.
1 = server certificate
2 = CA certificate for Directory Service
3 = KMS public certificate
4 = KMC public certificate
NOTE: The current release does not support type 3 and 4.
-f
Specifies the file name of the certificate to be uploaded. If the file is not
specified, the sslcert file in the current directory is selected.
-e
Allows for upload of multiple certificate format types.
1 = Base64
2 = PKCS12
NOTE: The current release does not support this option.
Pin for decrypting the PKCS12 file uploaded.
NOTE: If <format type> is selected as 2 it is mandatory to specify -p option.
NOTE: The current release does not support this option
-p
The sslcertupload command returns 0when successful and returns a nonzero
number when unsuccessful.
Example
racadm sslcertupload -t 1 -f c:\cert\cert.txt
130
RACADM Subcommand Details
sslcertview
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand
Description
sslcertview
Displays the SSL server or CA certificate that
exists on iDRAC6.
Synopsis
racadm sslcertview -t <type> [-A]
NOTE: The current release does not support type 3 and 4 -t options.
Table 2-41. sslcertview Subcommand Options
Option
Description
-t
Specifies the type of certificate to view, either the CA certificate or
server certificate.
1 = server certificate
2 = CA certificate for Directory Service
3 = KMS public certificate
4 = KMC public certificate
NOTE: The current release does not support type 3 and 4.
Prevents printing headers/labels.
-A
Sample Output
racadm sslcertview -t 1
Serial Number
: 00
Subject Information:
Country Code (CC)
State (S)
: US
: Texas
: Round Rock
Locality (L)
RACADM Subcommand Details
131
Organization (O)
: Dell Inc.
Organizational Unit (OU) : Remote Access Group
Common Name (CN)
: iDRAC6 default certificate
Issuer Information:
Country Code (CC)
State (S)
: US
: Texas
Locality (L)
Organization (O)
: Round Rock
: Dell Inc.
Organizational Unit (OU) : Remote Access Group
Common Name (CN)
: iDRAC6 default certificate
Valid From
Valid To
: Jul 8 16:21:56 2005 GMT
: Jul 7 16:21:56 2010 GMT
racadm sslcertview -t 1 -A
00
US
Texas
Round Rock
Dell Inc.
Remote Access Group
iDRAC6 default certificate
US
Texas
Round Rock
Dell Inc.
Remote Access Group
iDRAC6 default certificate
Jul 8 16:21:56 2005 GMT
Jul 7 16:21:56 2010 GMT
132
RACADM Subcommand Details
sslcsrgen
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand Description
sslcsrgen
Can be used to generate a CSR and download the 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 iDRAC6.
Synopsis
racadm sslcsrgen [-g] [-f <filename>]
racadm sslcsrgen -s
NOTE: The -f option is not supported for the serial/Telnet/ssh console.
Table 2-42. sslcsrgen Subcommand Options
Option Description
-g
-s
Generates a new CSR.
Returns the status of a CSR generation process (generation in progress,
active, or none).
-f
-t
Specifies the filename of the location, <filename>, where the CSR is
downloaded.
Specifies the type of certificate to view, either the CA certificate or
server certificate.
1 = webserver CSR - enables you to generate a CSR for the
webcertificate server certificate.
2 = KMC certificate - enables you to generate a CSR for the KMC
certificate and a CA certificate for Directory Service.
NOTE: The current release does not support type 2.
NOTE: If the -f option is not specified, the filename defaults to sslcsr in your current
directory.
RACADM Subcommand Details
133
If no options are specified, a CSR is generated and downloaded to the local
file system as sslcsr by default. The -g option cannot be used with the -s
option, and the -f option can only be used with the -g option.
The sslcsrgen -s subcommand returns one of the following status codes:
•
•
•
CSR was generated successfully.
CSR does not exist.
CSR generation in progress.
NOTE: Before a CSR can be generated, the CSR fields must be configured in the
racadm config -g cfgRacSecurity -o
cfgRacSecCsrCommonName MyCompany
NOTE: In telnet/ssh console, you can only generate and not download the CSR file.
Examples
racadm sslcsrgen -s
or
racadm sslcsrgen -g -f c:\csr\csrtest.txt
sslkeyupload
NOTE: To use this subcommand, you must have Configure iDRAC permission.
Subcommand
Description
sslkeyupload
Uploads SSL key from the client to iDRAC6.
Synopsis
racadm sslkeyupload -t <type> -f <filename>
134
RACADM Subcommand Details
Table 2-43. sslkeyupload Subcommand Options
Option
Description
-t
Specifies the key to upload.
1 = SSL key used to generate the server certificate
Specifies the file name of the SSL key to be uploaded.
-f
The sslkeyupload command returns 0when successful and returns a nonzero
number when unsuccessful.
Example
racadm sslkeyupload -t 1 -f c:\sslkey.txt
sslresetcfg
NOTE: To use this subcommand, you must have Chassis Configuration
Administrator privilege for CMC and Configure iDRAC permission for iDRAC.
Subcommand Description
sslresetcfg
Restores the web-server certificate to factory default and restarts web-
server. The certificate takes effect 30 seconds after the command is
entered.
Synopsis
racadm sslresetcfg
Example
• $ racadm sslresetcfg
Certificate generated successfully and webserver
restarted.
NOTE: For more information on managing SSL certificates, see the “Securing CMC
Communications Using SSL and Digital Certificates” section in the Dell Chassis
Management Controller User Guide.
RACADM Subcommand Details
135
testemail
Subcommand Description
testemail
Sends a test e-mail from iDRAC6 to a specified destination. Prior to
executing the test e-mail command, ensure that the SMTP server is
configured and the specified index in the RACADM cfgEmailAlert
page 176 for more information.
Synopsis
racadm testemail -i <index>
group.
Table 2-44. testemail Configuration
Action
Command
Enable the alert
racadm config -g cfgEmailAlert -o
cfgEmailAlertEnable -i 1 1
Set the destination e-mail racadm config -g cfgEmailAlert -o
address
cfgEmailAlertAddress -i 1
Set the custom message
that is sent to the
racadm config -g cfgEmailAlert -o
cfgEmailAlertCustomMsg -i 1 "This is a
destination e-mail address test!"
Ensure that the SMTP IP racadm config -g cfgRemoteHosts -o
address is configured
properly
cfgRhostsSmtpServerIpAddr 192.168.0.152
View the current e-mail
alert settings
racadm getconfig -g cfgEmailAlert -i
<index>
where <index>is a number from 1 to 4
136
RACADM Subcommand Details
Table 2-45. testemail Subcommands
Option
Description
-i
Specifies the index of the e-mail alert to test.
Output
Success: Test e-mail sent successfully
Failure: Unable to send test e-mail
testfeature
Subcommand Description
testfeature
Generic test command consisting of several sub-commands that allow
you to verify the configuration and operation of specific features.
Table 2-46. testfeature Subcommand Options
Option
Description
-f
Specifies the feature name. testfeature supports the following
<feature>
features:
• ad — Tests Active Directory configuration using simple
authentication (user name and password)
• adkrb — Tests Active Directory configuration using Kerberos
authentication
• 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.
<username>
-p<password> The password for the indicated user account.
RACADM Subcommand Details
137
Table 2-46. testfeature Subcommand Options
Option Description
-d <bitmask> A bitmask (specified as a hexadecimal value) to select various
diagnostic messaging levels. This option is optional.
NOTE: -d option is not supported with the remote racadm interface.
Subcommands
testfeature -f ad
Synopsis
testfeature -f ad -u <username> -p <password> [-d
<diagnostic-message-level>]
This subcommand tests Active Directory configuration using simple
authentication (user name and password). Use the optional -dswitch to
obtain additional diagnostic information, as needed.
This subcommand when executed performs the following:
•
•
•
•
Checks command syntax.
Verifies whether the required system resources are available.
Validates Active Directory configuration.
Verifies the SSL certificate and if the certificate signing request (key)
exists.
•
•
•
Acquires LDAP and Global Catalog Service records from DNS.
Acquires user privileges from the Active Directory server.
Checks the time to acquire user privileges with the allotted time to login.
NOTE: In the event of an error, the command displays the test that failed and all the
the tests performed earlier to the test that failed, including all the error messages.
Examples
• testfeature –f ad –u user@domain –p secret
SUCCESSFUL: User permissions are xxxxxppp
NOTE: The last three digits are the user's permissions.
138
RACADM Subcommand Details
• 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
Synopsis
testfeature -f adkrb -u <username> [-d <diagnostic-
message-level>]
This subcommand tests the Active Directory configuration using Kerberos
authentication (single sign-on or Smart Card login). Use the optional -d
switch to obtain additional diagnostic information, as needed. This
subcommand when executed performs the following:
•
•
•
•
•
•
Checks command syntax.
Verifies if the required system resources are available.
Validates Active Directory configuration.
Verifies if the SSL certificate and certificate signing request (key) exists.
Acquires LDAP and Global Catalog Service records from DNS.
Verifies if the CMC can acquire CMC, LDAP and Global Catalog servers
FQDN through reverse IP lookups.
•
Verifies that the CMC principal name matches the principal name in the
uploaded Keytab file.
•
•
•
Verifies that the CMC acquires a Kerberos TGT.
Acquires user privileges from the Active Directory server.
Checks the time to acquire user privileges with the allotted time to login.
NOTE: In the event of an error, the command outputs all tests performed up to and
including the test that failed, as well as all error messages.
RACADM Subcommand Details
139
testfeature -f ldap
Synopsis
testfeature -f ldap -u <username> -p <password> [-d
<diagnostic-message-level>]
This subcommand tests LDAP configuration and operation, and reports
success as each stage of the authentication process proceeds. On successful
completion, this command prints the CMC privileges assumed by the
specified <username>.
If a failure occurs, the command terminates with an error message that
displays the required corrective action. Use the optional -d switch to obtain
additional diagnostic information, as needed.
testtrap
NOTE: To use this subcommand, you must have Test Alerts permission.
Subcommand Description
testtrap
Tests the RAC’s SNMP trap alerting feature by sending a test trap
from iDRAC6 to a specified destination trap listener on the network.
For iDRAC6 only, before you execute the testtrap subcommand, ensure that
the specified index in the RACADM cfgIpmiPet group is configured properly.
For more information, see "cfgIpmiPet" on page 237.
NOTE: The cfgIpmiPet group is applicable only for iDRAC6.
.
Table 2-47. cfgIpmiPet Commands
Action
Command
Enable the alert
racadm config -g cfgIpmiPet -o
cfgIpmiPetAlertEnable -i 1 1
Set the destination
e-mail IP address
racadm config -g cfgIpmiPet -o
cfgIpmiPetAlertDestIpAddr -i 1
192.168.0.110
140
RACADM Subcommand Details
Table 2-47. cfgIpmiPet Commands
Action Command
View the current test racadm getconfig -g cfgIpmiPet -i
trap settings
<index>
where <index>is a number from 1 to 4
Synopsis
racadm testtrap -i <index>
Table 2-48. testtrap Subcommand Options
Option
Description
-i
Specifies the index of the trap configuration to use for the test Valid
values are from 1 to 4.
traceroute
NOTE: To use this subcommand, you must have Administrator permission.
Subcommand
Description
traceroute
Traces the network path of routers that packets take
as they are forwarded from your system to a
destination IPv4 address.
Synopsis
racadm traceroute <IPv4 address>
racadm traceroute 192.168.0.1
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
RACADM Subcommand Details
141
traceroute6
NOTE: To use this subcommand, you must have Administrator permission.
Subcommand
Description
traceroute6
Traces the network path of routers that packets take
as they are forwarded from your system to a
destination IPv6 address.
Synopsis
racadm traceroute6 <IPv6 address>
racadm traceroute fd01::1
traceroute to fd01::1 (fd01::1) from fd01::3, 30 hops
max, 16 byte packets
1 fd01::1 (fd01::1) 14.324 ms 0.26 ms 0.244 ms
usercertupload
NOTE: To use this subcommand, you must have Configure iDRAC permission
NOTE: This option is applicable only to iDRAC6..
Subcommand
Description
usercertupload
Uploads a user certificate or a user CA
certificate from the client to iDRAC6.
Synopsis
racadm usercertupload -t <type> [-f <filename>] -i
<index>
142
RACADM Subcommand Details
Table 2-49. usercertupload Subcommand Options
Option
Description
-t
Specifies the type of certificate to upload, either the CA certificate or
server certificate.
1 = user certificate
2 = user CA certificate
-f
-i
Specifies the file name of the certificate to be uploaded. If the file is
not specified, the sslcert file in the current directory is selected.
Index number of the user. Valid values 1-16.
The usercertupload command returns 0when successful and returns a
nonzero number when unsuccessful.
Example
racadm usercertupload -t 1 -f c:\cert\cert.txt -i 6
RACADM Subcommand Details
143
usercertview
NOTE: To use this subcommand, you must have Configure iDRAC permission.
NOTE: This option is applicable only to iDRAC6.
Subcommand
Description
usercertview
Displays the user certificate or user CA
certificate that exists on iDRAC6.
Synopsis
racadm usercertview -t <type> [-A] -i <index>
Table 2-50. sslcertview Subcommand Options
Option
Description
-t
Specifies the type of certificate to view, either the user certificate or
the user CA certificate.
1 = user certificate
2 = user CA certificate
-A
-i
Prevents printing headers/labels.
Index number of the user. Valid values are 1-16.
version
NOTE: This option is applicable only for iDRAC6.
Subcommand
Description
version
Displays the RACADM version information.
Synopsis
racadm version
144
RACADM Subcommand Details
vflashsd
NOTE: To use this subcommand, you must have Access Virtual Media privilege
NOTE: This option is applicable only to iDRAC6..
Subcommand
Description
vflashsd
Allows you to initialize or get the status of the vFlash SD card. The
initialize operation removes all existing partitions and resets the
card. The status operation displays the status of the last operation
performed on the card.
Synopsis
racadm vflashsd initialize
racadm vflashsd status
vflashpartition
NOTE: To use this subcommand, you must have Access Virtual Media privilege.
NOTE: This option is applicable only to iDRAC6.
Subcommand
Description
vflashpartition Allows you to perform the following:
• Create an empty partition
• Create a partition using an image file
• Format a partition
• View available partitions
• Delete existing partitions
• Get the status of partitions
NOTE: Create partition using image file is not supported in local RACADM.
RACADM Subcommand Details
145
Synopsis
racadm vflashpartition create <options>
racadm vflashpartition delete <options>
racadm vflashpartition status <options>
racadm vflashpartition list <options>
Table 2-51. vflashpartition Subcommand Options
Option
Description
-i <index> Index of the partition for which this command applies.
<index> must be an integer from 1 to 16.
NOTE: For the standard SD card, the index value is 1 because only one
partition of size 256 MB is supported.
Options valid only with create action
-o <label> Label that is displayed when the partition is mounted on the
operating system.
<label> must be a string up to six alphanumeric characters.
-e <type> Emulation type for the partition. <type> must be floppy, cddvd, or
HDD.
146
RACADM Subcommand Details
Table 2-51. vflashpartition Subcommand Options (continued)
Option Description
-t <type> Create a partition of type <type>. <type> must be:
• empty – Create an empty partition. The following options are valid
with the empty type:
• -s <size> – Partition size in MB.
• -f <type> – Format type for the partition based on the type of
file system. Valid options are RAW, FAT16, FAT32, EXT2, or
EXT3.
• image – Create a partition using an image relative to iDRAC. The
following options are valid with the image type:
• -l <path> – Specifies the remote path relative to iDRAC. The
path can be on a mounted drive:
SMB path: //<ip or domain>/<share_name> /<path_to_image
>
NFS path: <ipaddress>:/<path_to_image
>
• -u <user> – Username for accessing the remote image.
• -p <password> – Password for accessing the remote image.
Options valid only with status action
-a
Displays the status of operations on all existing partitions.
Examples
•
•
To create a 20MB empty partition:
racadm vflashpartition create -i 1 -o drive1 -t
empty -e HDD -f fat16 -s 20
To create a partition using an image file on a remote system:
racadm vflashpartition create –i 1 –o drive1 –e
HDD –t image –l //myserver/sharedfolder/foo.iso –u
root –p mypassword
NOTE: This command is case sensitive for the image file name extension. If the file
name extension is in upper case, for example FOO.ISO instead of FOO.iso,
then the command returns a syntax error.
•
To delete a partition:
racadm vflashpartition delete -i 1
RACADM Subcommand Details
147
•
•
•
•
•
To delete all partitions, re-initialize the vFlash SD card:
racadm vflashsd initialize
To get the status of operation on partition 1:
racadm vflashpartition status -i 1
To get the status of all existing partitions:
racadm vflashpartition status -a
To list all existing partitions and its properties:
racadm vflashpartition list
To get the partition size:
racadm getconfig –g cfgvflashpartition –o
cfgvflashpartitionsize –i 1
•
•
•
•
•
To display the emulation type:
racadm getconfig –g cfgvflashpartition –I 1 –o
cfgvflashpartitionemulatiotype
To display the label for the partition that is visible to the operating system:
racadm getconfig –g cfgvflashpartition –i 1 –o
cfgvflashPartitionlabel
To display the format type of the partition:
racadm getconfig –g cfgvflashpartition –i 1 –o
cfgvflashPartitionFormatType
To change a read-only partition to read-write:
racadm config –g cfgvflashpartition –i 1 –o
cfgvflashPartitionAccessType 1
To attach a partition to the host operating system:
racadm config –g cfgvflashpartition –i 1 –o
cfgvflashPartitionAttachState 1
148
RACADM Subcommand Details
vmdisconnect
NOTE: To use this subcommand, you must have Access Virtual Media permission.
NOTE: This option is applicable only to iDRAC6.
Subcommand Description
vmdisconnect Allows a user to disconnect another user's Virtual Media session. Once
disconnected, the Web-based interface reflects the correct connection
status.
Enables a iDRAC6 user to disconnect all active Virtual Media
sessions. The active Virtual Media sessions can be displayed in
iDRAC6 Web-based interface or by using the RACADM
subcommands such as remoteimage or getssninfo.
Synopsis
racadm vmdisconnect
vmkey
NOTE: To use this subcommand, you must have Access Virtual Media permission
NOTE: This option is applicable only to iDRAC6..
Subcommand Description
vmkey
When a custom Virtual Media key image is uploaded to the RAC, the
key size becomes the image size. The vmkey subcommand can be
used to reset the key back to its original default size, which is 256 MB
on iDRAC6.
RACADM Subcommand Details
149
Synopsis
racadm vmkey <action>
If <action>is configured as reset, the vFlash memory is reset to the
default size of 256 MB and removes all data from it.
NOTE: This command is deprecated from iDRAC6 1.5 and iDRAC6 3.0 releases
onwards. The functionality of this command is now covered by vflashsd
initialize. While execution of the vmkey resetcommand is
successful, it is recommended to use the vflashsd initialize
command. For more information, see "vflashsd" on page 145.
150
RACADM Subcommand Details
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
3
iDRAC6 and CMC Property
Database Group and Object
Descriptions
The iDRAC6 and CMC property database contains the configuration
information for iDRAC6 and 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 iDRAC6
Enterprise on Blade Servers, iDRAC6 Enterprise or Express on Rack and
Tower Servers and CMC.
Use the group and object IDs with the RACADM subcommands to configure
iDRAC6 and CMC.
Enterprise on Blade Servers, iDRAC6 on Rack and Tower Servers and CMC.
CAUTION: Racadm sets the value of objects without performing any functional
validation on them. For example, RACADM allows you to set the Certificate
Validation object to 1 with the Active Directory object set to 0, even though
Certificate Validation can happen only if Active Directory is enabled. Similarly, the
cfgADSSOEnable object can be set to 0 or 1 even if the cfgADEnable object is 0,
but it takes effect only if Active Directory is enabled.
All string values are limited to displayable ASCII characters, except where
otherwise noted.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
151
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Displayable Characters
Displayable characters include the following set:
abcdefghijklmnopqrstuvwxwz
ABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/
Table 3-1. Supported Object Groups
Subcommand
iDRAC6 on Blade iDRAC6 on Rack
Servers and Tower Servers
CMC
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
152
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Table 3-1. Supported Object Groups (continued)
Subcommand
iDRAC6 on Blade iDRAC6 on Rack
Servers and Tower Servers
CMC
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
153
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Table 3-1. Supported Object Groups (continued)
Subcommand
iDRAC6 on Blade iDRAC6 on Rack
Servers and Tower Servers
CMC
= Supported;
=Not supported
idRacInfo
This group contains display parameters to provide information about the
specifics of iDRAC6 or CMC being queried. One instance of the group is
allowed.
NOTE: For CMC, use this object with the getconfig subcommand.
NOTE: To use this object for CMC, you must have CMC Login User privilege.
The following sections provides information about the objects in the
idRACInfo group.
idRacProductInfo (Read Only)
Description
A text string that identifies the product.
A string of up to 63 ASCII characters.
Integrated Dell Remote Access Controller.
Chassis Management Controller.
Legal Values
Default for iDRAC
Default for CMC
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
154
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
idRacDescriptionInfo (Read Only)
Description
Legal Values
Default
A text description of the RAC type.
A string of up to 255 ASCII characters.
This system component provides a complete set of remote
management functions for Dell PowerEdge servers.
idRacVersionInfo (Read Only)
Description
Legal Values
Default
String containing the current product firmware version.
A string of up to 63 ASCII characters.
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 iDRAC
Default for CMC
The current iDRAC6 firmware build version.
The current CMC firmware build version.
idRacName (Read Only)
Description
A user-assigned name to identify this controller.
Legal Values
A string of up to 15 ASCII characters.
Default for iDRAC
Default for CMC
iDRAC
CMC
idRacType (Read Only)
Description
Legal Values
Default
Identifies the remote access controller type as iDRAC6.
Product ID
For iDRAC6 on Rack and Servers: 10
For iDRAC6 Enterprise on Blade Servers: 8
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
155
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Example
racadm getconfig -g idRacInfo
# idRacType=8
# idRacProductInfo=Chassis Management Controller
# idRacDescriptionInfo=This system component provides
a complete set of remote management functions for
blade servers
# idRacVersionInfo=P21
# idRacBuildInfo=200708301525
# idRacName=CMC-1
cfgLanNetworking
This group contains parameters to configure iDRAC6 or CMC NIC.
One instance of the group is allowed. Some objects in this group may require
iDRAC6 NIC to be reset, which may cause a brief loss in connectivity. Objects
that change iDRAC6 NIC IP address settings closes all active user sessions
and require users to reconnect using the updated IP address settings.
NOTE: For CMC, use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, 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.
NOTE: For any network property changes on iDRAC6 to be successfully executed
through RACADM, you must first enable iDRAC6 NIC.
The following sections provides information about the objects in the
cfgLanNetworking group.
cfgNicIPv4Enable (Read/Write)
Description Enables or disables iDRAC6 or CMC IPv4 stack.
Legal Values 1 (TRUE)
0 (FALSE)
Default
1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
156
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNicSelection (Read/Write)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description Specifies the current mode of operation for the RAC network interface
Legal Values 0 = Shared
1 = Shared with Failover LOM2
2 = Dedicated
3 = Shared with Failover All LOMs (iDRAC6 Enterprise only)
Default
0 (iDRAC6 Express)
2 (iDRAC6 Enterprise)
Table 3-2. cfgNicSelection Supported Modes
Mode
Description
Shared
Used if the host server integrated NIC is shared with the
RAC on the host server. This mode enables
configurations to use the same IP address on the host
server and the RAC for common accessibility on the
network.
Shared with Failover:
LOM 2
Enables teaming capabilities between host server LOM2
integrated network interface controllers.
Dedicated
Specifies that the RAC NIC is used as the dedicated
NIC for remote accessibility.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
157
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Table 3-2. cfgNicSelection Supported Modes (continued)
Mode
Description
Shared with Failover All Enables teaming capabilities between all LOMs on the
LOMs
host server integrated network interface controllers.
The remote access device network interface is fully
functional when the host operating system is configured
for NIC teaming. The remote access device receives data
through NIC 1 and NIC 2, but transmits data only
through NIC 1.
Failover occurs from NIC 2 to NIC 3 and then to NIC 4.
If NIC 4 fails, the remote access device fails over all data
transmission back to NIC 1, but only if the original NIC
1 failure has been corrected.
cfgNicVLanEnable (Read/Write)
NOTE: For iDRAC6 Enterprise on Blade Servers, this object is read-only and VLAN
settings can be configured through CMC Web Interface. iDRAC6 displays only the
current VLAN settings and you cannot modify the settings from iDRAC6.
Description
Enables or disables the VLAN capabilities of the RAC/BMC.
NOTE: For iDRAC6 Enterprise on Blade Servers, this object enables
or disables the VLAN capabilities of iDRAC6 from CMC.
All chassis management traffic, including the CMC and all
iDRACs, resides on this external VLAN when enabled. No iDRAC
configuration change is required to use this external management
network VLAN.
Legal Values
1 (TRUE)
0 (FALSE)
0
Default
Example
racadm config -g cfgLanNetworking -o
cfgNicVLanEnable 1
racadm config -g cfgLanNetworking -o
cfgNicVLanEnable 0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
158
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNicVLanId (Read/Write)
Description
Specifies the VLAN ID for the network VLAN configuration (in
CMC for iDRAC6 Enterprise on Blade Servers). This property is only
valid if cfgNicVLanEnable is set to 1 (enabled).
Legal Values
Default
1 – 4000 and 4021 – 4094
1
Example
racadm config -g cfgLanNetworking -o
cfgNicVlanID 1
cfgNicVLanPriority (Read/Write)
Description
Specifies the VLAN Priority for the network VLAN configuration
(in CMC for iDRAC6 Enterprise on Blade Servers). This property is
only valid if cfgNicVLanEnable is set to 1 (enabled).
Legal Values
Default
0-7
0
Example
racadm config -g cfgLanNetworking -o
cfgNicVLanPriority 7
cfgDNSDomainNameFromDHCP (Read/Write)
Description
Legal Values
Specifies that iDRAC or CMC DNS domain name should be
assigned from the network DHCP server.
1 (TRUE)
0 (FALSE)
0
Default
For CMC, this property is used only if cfgNicUseDhcp is set to 1 (true), or if
both cfgIPv6Enable and cfgIPv6AutoConfig are set to 1 (true).
The CMC can obtain its DNS domain name from either a DHCP or
DHCPv6 server, if all of the following properties are set to 1 (true):
•
•
cfgNicIPv4Enable
cfgNicUseDhcp
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
159
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
•
•
•
•
cfgIPv6Enable
cfgIPv6AutoConfig
cfgDNSDomainNameFromDHCP
cfgDNSDomainName (Read/Write)
The network administrator must ensure that these DHCP servers are
configured to provide the same DNS domain name to the CMC, otherwise
the domain name becomes unpredictable.
cfgDNSDomainName (Read/Write)
Description
Legal Values
This is the DNS domain name. This parameter is only valid if
cfgDNSDomainNameFromDHCP is set to 0 (FALSE).
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 only supports Fully Qualified
Domain Names (FQDN) of 64 bytes or fewer.
Default
<blank>
cfgDNSRacName (Read/Write)
Description
Displays the iDRAC6 or CMC name, which is rac-service tag by
default. This parameter is only valid if cfgDNSRegisterRac is set to
1 (TRUE).
Legal Values
A string of up to 63 ASCII characters. At least one character must
be alphabetic.
NOTE: Some DNS servers only register names of 31 characters or
fewer.
Default
For iDRAC: idrac-<service tag>
For CMC: cmc-<service tag>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
160
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgDNSRegisterRac (Read/Write)
Description
Registers the iDRAC6 or CMC name on the DNS server. When you
set this parameter, the CMC registers its DNS name for its IPv4
and IPv6 addresses with the DNS server.
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
NOTE: For IPv6, only the DHCPv6 address or static address is registered.
Example:
racadm getconfig -g cfgLanNetworking
cfgNicEnable=1
cfgNicIPv4Enable=1
cfgNicIpAddress=192.168.22.101
cfgNicNetmask=255.255.255.0
cfgNicGateway=192.168.22.101
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.lab
cfgDNSDomainNameFromDHCP=1
cfgDNSRegisterRac=1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
161
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgDNSServersFromDHCP (Read/Write)
Description
Specifies if the DNS server IPv4 addresses should be assigned from
the DHCP server on the network.
For CMC, this property is used only if cfgNicUseDhcp is set to 1
(true).
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
cfgDNSServer1 (Read/Write)
Description
Specifies the IPv4 address for DNS server 1. This property 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
Default
String representing a valid IPv4 address. For example: 192.168.0.20.
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
Default
String representing a valid IPv4 address. For example: 192.168.0.20.
0.0.0.0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
162
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNicEnable (Read/Write)
Description
Enables or disables iDRAC6 or CMC network interface controller.
If the NIC is disabled, the remote network interfaces to iDRAC6 or
CMC are no longer accessible and iDRAC6 or CMC are only
available through the local or serial RACADM interface.
Legal Values
Default
1 (TRUE)
0 (FALSE)
1
cfgNicIpAddress (Read/Write)
NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set
to 0(FALSE).
Description
Specifies the static IPv4 address to be assigned to the RAC or CMC.
This property is only valid if cfgNicUseDhcp is set to 0 (FALSE).
Legal Values
Default
String representing a valid IPv4 address. For example: 192.168.0.20.
For iDRAC6 on Rack and Tower Servers: 192.168.0.120
For iDRAC6 Enterprise on Blade Servers: 192.168.0.n, where n is 120
plus the server slot number.
For CMC: 192.168.0.120
cfgNicNetmask (Read/Write)
NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set
to 0 (FALSE).
Description
The subnet mask used for iDRAC6 or CMC IP address.
This property is only valid if cfgNicUseDhcp is set to 0 (FALSE).
Legal Values
Default
String representing a valid subnet mask. For example:
255.255.255.0.
255.255.255.0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
163
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNicGateway (Read/Write)
NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set
to 0 (FALSE).
Description
iDRAC6 or CMC gateway IPv4 address.
The gateway IPv4 address used for static assignment of the RAC IP
address. This property is only valid if cfgNicUseDhcp is set to 0
(FALSE).
Legal Values
Default
String representing a valid gateway IPv4 address. For example:
192.168.0.1.
192.168.0.1
cfgNicUseDhcp (Read/Write)
Description
Specifies whether DHCP is used to assign the iDRAC6 or CMC
IPv4 address. If this property is set to 1 (TRUE), then iDRAC6 or
CMC IPv4 address, subnet mask, and gateway are assigned from
the DHCP server on the network. If this property is set to 0
(FALSE), the user can configure the cfgNicIpAddress,
cfgNicNetmask, and cfgNicGateway properties.
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
cfgNicMacAddress (Read Only)
Description
The iDRAC6 or CMC NIC MAC address in the format:
dd:dd:dd:dd:dd:dd, where d is a hexadecimal digit in range 0 - 9, A -
F
Legal Values
Default
String representing iDRAC6 or CMC NIC MAC address.
The current MAC address of iDRAC6 or CMC NIC. For example,
00:12:67:52:51:A3.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
164
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRemoteHosts
This group provides properties that allow configuration of the SMTP server
for e-mail alerts.
For CMC, this group enables/disables and configures firmware updates, NTP,
remote syslogging, and SMTP email alerting. Use the -m option to apply this
setting to iDRAC.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
The following sections provides information about the objects in the
cfgRemoteHosts group.
cfgRhostsFwUpdateTftpEnable (Read/Write)
Description
Legal Values
Enables or disables iDRAC6 or CMC firmware update from a
network TFTP server.
1 (TRUE)
0 (FALSE)
1
Default
cfgRhostsFwUpdateIpAddr (Read/Write)
Description
Legal Values
Default
Specifies the network TFTP server IPv4 or IPv6 address that is used
for TFTP iDRAC6 or CMC firmware update operations.
A string representing a valid IPv4 or IPv6 address. For example,
192.168.0.61
For IPv4, it is 0.0.0.0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
165
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRhostsFwUpdatePath (Read/Write)
Description
Specifies TFTP path where iDRAC6 or CMC firmware image file
exists on the TFTP server. The TFTP path is relative to the TFTP
root path on the TFTP server.
NOTE: The server may still require you to specify the drive (for
example, C:).
Legal Values
Default
A string with a maximum length of 255 ASCII characters.
<blank>
cfgRhostsSmtpServerIpAddr (Read/Write)
Description
The IPv4 or IPv6 address of the network SMTP server. The SMTP
server transmits e-mail alerts from iDRAC6 or CMC if the alerts are
configured and enabled.
Legal Values
Default
A string representing a valid SMTP server IPv4 or IPv6 address. For
example: 192.168.0.55.
For iDRAC6: For IPv4, it is 0.0.0.0
For CMC: localhost.localdomain
cfgRhostsNtpEnable
NOTE: This object is applicable only for CMC.
Description
Enables or disables the use of the Network Time Protocol (NTP) for
date and time synchronization.
Legal Values
1 (true)
0 (false)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
166
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRhostsNtpServer1
NOTE: This object is applicable to CMC only.
Description
Legal Values
Specifies the first of three possible NTP servers.
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.
Default
Null
cfgRhostsNtpServer2
NOTE: This object is applicable only for CMC.
Description
Legal Values
Specifies the second of three possible NTP servers.
A string representing a valid NTP server. For example, ntp2.ntp.net.
At least one NTP server must be specified and duplicate entries are
not allowed.
Default
Null
cfgRhostsNtpServer3
NOTE: This object is applicable only for CMC.
Description
Legal Values
Specifies the third of three possible NTP servers.
A string representing a valid NTP server. For example, ntp3.ntp.net.
At least one NTP server must be specified and duplicate entries are
not allowed.
Default
Null
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
167
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRhostsNtpMaxDist
NOTE: This object is applicable only for CMC.
Description
Specifies the NTP maximum distance parameter used to aid in
NTP configuration.
Legal Values
Default
1 – 128
16
cfgRhostsSyslogEnable (Read/Write)
Description
Legal Values
Enables or disables remote syslog to allow the RAC and SEL logs to
be written to up to three remote syslog servers.
1 (TRUE)
0 (FALSE)
0
Default
cfgRhostsSyslogPort (Read/Write)
Description
Remote syslog port number to use for writing the RAC and SEL
logs to a remote syslog server.
For CMC, this setting takes effect only if the
cfgRhostsSyslogEnable parameter is set to 1 (enabled).
Legal Values
Default
10 — 65535
514
NOTE: For CMC, the following port numbers are reserved and cannot be used: 21,
68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
168
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRhostsSyslogServer1 (Read/Write)
Description
Specifies the first 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
Default
For iDRAC6: String from 0 to 511 characters.
For CMC: Valid hostname or IPv4 or IPv6 address.
<blank>
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
Default
For iDRAC6: String from 0 to 511 characters.
For CMC: Valid hostname or IPv4 or IPv6 address.
<blank>
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).
Legal Values
Default
For iDRAC6: String from 0 to 511 characters.
For CMC: Valid hostname or IPv4 or IPv6 address.
<blank>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
169
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRhostsSyslogPowerLoggingEnabled
NOTE: This object is applicable only for CMC.
Description
Legal Values
Enables or disables power consumption logging to remote syslog
servers.
1 (enabled)
0 (disabled)
0
Default
NOTE: Remote syslog must be enabled and one or more remote syslog servers
configured for power consumption to be logged.
cfgRhostsSyslogPowerLoggingInterval
NOTE: This object is applicable only for CMC.
Description
Legal Values
Default
Specifies the power consumption collection/logging interval.
1-1440 (minutes)
5
Example
racadm getconfig -g cfgRemoteHosts [-m server-<n>]
cfgRhostsFwUpdateTftpEnable=1
cfgRhostsFwUpdateIpAddr=0.0.0.0
cfgRhostsFwUpdatePath=
cfgRhostsSmtpServerIpAddr=localhost.localdomain
cfgRhostsNtpEnable=0
cfgRhostsNtpServer1=
cfgRhostsNtpServer2=
cfgRhostsNtpServer3=
cfgRhostsNtpMaxDist=16
cfgRhostsSyslogEnable=0
cfgRhostsSyslogPort=514
cfgRhostsSyslogServer1=
cfgRhostsSyslogServer2=
cfgRhostsSyslogServer3=cfgRhostsSyslogPowerLoggingEnabled=1
cfgRhostsSyslogPowerLoggingInterval=5
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
170
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgUserAdmin
This group provides configuration information about the users who are
allowed to access iDRAC6 or CMC through the available remote interfaces.
Up to 16 instances of the user group are allowed. Each instance represents the
configuration for an individual user.
NOTE: In the current CMC firmware version, the objects cfgUserAdminEnable and
cfgUserAdminPrivilege are interrelated; changing the value of one property causes
the value of the other property to change. For example, if a user does not have login
privilege, the user is disabled by default. When you enable the user by changing the
value of UserAdminEnable to 1, the right most digit of the UserAdminPrivilege also
becomes 1. On the other hand, if you change the right most digit of the
UserAdminPrivilege to 0, the value of UserAdminEnable becomes 0.
NOTE: Use this object with the config or getconfig subcommands. You must supply
an index group number to use these commands as follows: -i <index group>
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, you can configure any setting that is not preceded by the hash
sign (#) in the output. To modify a configurable object, use the -o option.
The following sections provide information about the objects in the
cfgUserAdmin group.
cfgUserAdminIndex (Read Only)
Description
The unique index of a user.
For CMC, the index number is used to specify a unique group
name. Only valid for indexed groups.
Legal Values
For iDRAC6: This parameter is populated based on the existing
instances.
For CMC: The parameter is specified by a decimal integer from
1–16.
Default
<index of the instance>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
171
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgUserAdminIpmiLanPrivilege (Read/Write)
NOTE: This object property is specific to iDRAC6.
Description
Legal Values
The maximum privilege on the IPMI LAN channel.
2 (User)
3 (Operator)
4 (Administrator)
15 (No access)
4 (User 2)
Default
15 (All others)
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
privilege bit values that can be combined to create bit masks.
Legal Values
For iDRAC6: 0x00000000 to 0x000001ff, and 0x0
For CMC: 0x0000000-0x0000fff, and 0x0
0x00000000
Default
Example
racadm getconfig -g cfgUserAdmin -i 1
# cfgUserAdminIndex=1
cfgUserAdminEnable=1
cfgUserAdminUserName=root
# cfgUserAdminPassword=******** (Write-Only)
cfgUserAdminPrivilege=0x00000fff
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
172
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Table 3-3. Bit Masks for User Privileges
iDRAC Specific User Privilege
Login to iDRAC
Privilege Bit Mask
0x00000001
0x00000002
0x00000004
0x00000008
0x00000010
Configure iDRAC
Configure Users
Clear Logs
Execute Server Control
Commands
Access Virtual Console
Access Virtual Media
Test Alerts
0x00000020
0x00000040
0x00000080
0x00000100
Execute Debug Commands
CMC Specific User Privelege
CMC Login User
0x0000001
0x0000002
Chassis Configuration
Administrator
User Configuration Administrator 0x0000004
Clear Logs Administrator
Chassis Control Administrator
Super User
0x0000008
0x0000010
0x0000020
0x0000040
0x0000080
Server Administrator
Test Alert User
Debug Command Administrator 0x0000100
Fabric A Administrator
Fabric B Administrator
Fabric C Administrator
0x0000200
0x0000400
0x0000800
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
173
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Examples
privileges.
Table 3-4. Sample Bit Masks for User Privileges
User Privilege(s)
Privilege Bit Mask
The user is not allowed to access 0x00000000
iDRAC or CMC.
The user may only login to
iDRAC or CMC and view iDRAC
or CMC and server configuration
information.
0x00000001
The user may login to iDRAC or 0x00000001 + 0x00000002 = 0x00000003
CMC and change configuration.
The user may login to iDRAC,
0x00000001 + 0x00000040 + 0x00000080 =
access Virtual Media, and access 0x000000C1
Virtual Console.
cfgUserAdminUserName (Read/Write)
Description
The name of the user for this index. The user index is created by
writing a string into this name field if the index is empty. Writing a
string of double quotes ("") deletes the user at that index. You
cannot change the name. You must delete and then recreate the
name. The string cannot contain / (forward slash), \ (backslash), .
(period), @ (at symbol) or quotation marks.
NOTE: This property value must be unique among user names.
A string of up to 16 ASCII characters.
root (User 2)
Legal Values
Default
<blank> (All others)
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
174
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
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
Default
A string of up to 20 ASCII characters.
********
cfgUserAdminEnable (Read/Write)
Description
Legal Values
Enables or disables an individual user.
1 (TRUE)
0 (FALSE)
Default
For iDRAC6: 1 (User 2), 0 (All others)
For CMC: 0
cfgUserAdminSolEnable (Read/Write)
NOTE: This object property is specific to iDRAC6.
Description
Legal Values
Enables or disables Serial Over LAN (SOL) user access for the user.
1 (TRUE)
0 (FALSE)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
175
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgUserAdminIpmiSerialPrivilege (Read/Write)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description
Legal Values
The maximum privilege on the IPMI LAN channel.
2 (User)
3 (Operator)
4 (Administrator)
15 (No access)
4 (User 2)
Default
15 (All others)
cfgEmailAlert
This group contains parameters to configure iDRAC6 or CMC e-mail alerting
capabilities. Up to four instances of this group are allowed.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privileges.
NOTE: For CMC, you can configure any setting that is not preceded by the hash
sign (#) in the output. To modify a configurable object, use the -o option.
The following sections provides information about the objects in the
cfgEmailAlert group.
cfgEmailAlertIndex (Read Only)
Description
Legal Values
Default
The unique index of an alert instance.
1-4
<instance>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
176
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgEmailAlertEnable (Read/Write)
Description
Legal Values
Enables or disables the alert instance.
1 (TRUE)
0 (FALSE)
0
Default
cfgEmailAlertAddress (Read/Write)
Description
Legal Values
Default
Specifies the destination email address for email alerts, for example,
user1@company.com.
E-mail address format, with a maximum length of 64 ASCII
characters.
<blank>
cfgEmailAlertCustomMsg (Read/Write)
NOTE: This object property is specific to iDRAC6.
Description
Legal Values
Default
Specifies a custom message that forms the subject of the alert.
A string of up to 32 characters
<blank>
cfgEmailAlertEmailName
NOTE: This object property is specific to CMC.
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, etc.
Legal Values
Default
A string of up to 32 characters
<blank>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
177
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Example
racadm getconfig -g cfgEmailAlert -i 2
# cfgEmailAlertIndex=1
cfgEmailAlertEnable=1
cfgEmailAlertName=Kevin Fulton
cfgSessionManagement
This group contains parameters to configure the number of sessions that can
connect to iDRAC6. One instance of the group is allowed. Displays current
settings for and configures idle timeout properties for Web server, Telnet,
SSH, and RACADM sessions. Changes to idle timeout settings take effect at
the next login. To disable idle timeout for a connection, set this property to 0.
Use the -m option to apply this setting to iDRAC.
The following sections provides information about the objects in the
cfgSessionManagement group.
cfgSsnMgtRacadmTimeout (Read/Write)
NOTE: This object is applicable for iDRAC6 on Rack and Tower Servers and CMC,
but not for iDRAC6 Enterprise on Blade Servers.
Description
Defines the idle timeout in seconds for the Remote RACADM
interface. If a remote RACADM session remains inactive for more
than the specified sessions, the session closes.
Legal Values
Default
10 –1920
60
Example
racadm getconfig -g cfgSessionManagement [-m server-
<n>] -o <object name> <object value>
cfgSsnMgtWebserverTimeout=0
cfgSsnMgtTelnetIdleTimeout=0
cfgSsnMgtSshIdleTimeout=300
cfgSsnMgtRacadmTimeout=0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
178
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSsnMgtConsRedirMaxSessions (Read/Write)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Specifies the maximum number of Virtual Console sessions allowed
on iDRAC6.
For iDRAC6 on Rack and Tower Servers: 1 – 4.
For iDRAC6 Enterprise on Blade Servers: 1-2
For iDRAC6 on Rack and Tower Servers: 4
For iDRAC6 Enterprise on Blade Servers: 2
Default
cfgSsnMgtWebserverTimeout (Read/Write)
Description
Defines the Web server timeout. This property sets the amount of
time in seconds that a connection is allowed to remain idle (there is
no user input). The session is cancelled if the time limit set by this
property is reached. Changes to this setting do not affect the
current session; you must log out and log in again to make the new
settings effective.
An expired Web server session logs out the current session.
Legal Values
Default
60 – 10800
1800
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
179
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSsnMgtSshIdleTimeout (Read/Write)
Description
Defines the secure shell idle timeout. This property sets the
amount of time in seconds that a connection is allowed to remain
idle (there is no user input). The session is cancelled if the time
limit set by this property is reached. Changes to this setting do not
affect the current session; you must log out and log in again to
make the new settings effective.
An expired secure shell session displays the following error message:
• In case of iDRAC6 on Rack and Tower Servers:
Connection timed out
• In case of iDRAC6 Enterprise on Blade Servers:
Session timed out. Closing the session...
After the message is displayed, the system returns you to the shell
that generated the Secure Shell session.
Legal Values
Default
0 (No timeout)
0 – 10800
For iDRAC6 on Rack and Tower Servers: 300
For iDRAC6 Enterprise on Blade Servers and CMC: 1800
NOTE: If 0 (no timeout), the network connection does not send keep alive packets
to probe the client. Otherwise, keep alive packets are sent to guarantee that the
client is responding.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
180
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSsnMgtTelnetIdleTimeout (Read/Write)
Description
Defines the Telnet idle timeout. This property sets the amount of
time in seconds that a connection is allowed to remain idle (there is
no user input). The session is cancelled if the time limit set by this
property is reached. Changes to this setting do not affect the
current session (you must log out and log in again to make the new
settings effective).
An expired Telnet session displays the following error message:
• In case of iDRAC6 on Rack and Tower Servers:
Connection timed out
• In case of iDRAC6 Enterprise on Blade Servers:
Session timed out. Closing the session...
After the message is displayed, the system returns you to the shell
that generated the Telnet session.
Legal Values
Default
0 (No timeout)
0– 10800
For CMC: 60 – 10800
For iDRAC6 on Rack and Tower Servers: 300
For iDRAC6 Enterprise on Blade Servers and CMC: 1800
NOTE: If 0 (no timeout), the network connection does not send keep alive packets
to probe the client. Otherwise, keep alive packets are sent to guarantee that the
client is responding.
cfgSerial
This group contains configuration parameters for iDRAC6 or CMC services.
One instance of the group is allowed.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
181
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
The following sections provides information about the objects in the
cfgSerial group.
NOTE: The cfgSerial object group is applicable for iDRAC6 Enterprise on Blade
Servers for only two properties—cfgSerialTelnetEnable=1 and
cfgSerialSshEnable=1.
cfgSerialBaudRate (Read/Write)
Description
Legal Values
Sets the baud rate on iDRAC6 or CMC serial port.
For iDRAC6: 9600, 28800, 57600, 115200
For CMC: 2400, 4800, 9600, 19200, 28800, 38400, 57600,115200
For iDRAC6: 57600
Default
For CMC: 115200
cfgSerialConsoleEnable (Read/Write)
Description
Legal Values
Enables or disables the RAC or CMC serial console interface.
1 (TRUE)
0 (FALSE)
Default
For iDRAC6: 0
For CMC: 1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
182
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSerialConsoleQuitKey (Read/Write)
Default
For iDRAC6:
This key or key combination terminates Virtual Console text for
iDRAC when using the console com2 command.
The cfgSerialConsoleQuitKey value can be represented by one of
the following:
• Decimal value — For example, 95
• Hexadecimal value — For example, 0x12
• Octal value — For example, 007
• ASCII value — For example, ^a
ASCII values may be represented using the following Escape Key
codes:
• ^ followed by any alphabetic (a-z, A-Z)
• ^ followed by the listed special characters: [ ] \ ^ _
For CMC:
This key specifies the character that aborts the serial text console
connect (or racadm connect) command.
NOTE: The CTRL key is represented by using the ^ (carat) character.
NOTE: The CTRL key does not generate a character by itself, but must
be struck simultaneously with another key to generate a character.
For example, striking both the CTRL key and the \ key
simultaneously (rather than sequentially) is denoted as ^\.
Configuration options: The value must start with the ^ character,
and be followed by one of the characters— a-z, A-Z, [, ], \
Legal value:
Default:
String of up to 4 characters
For iDRAC: <Ctrl><\>
Fo CMC: ^\
NOTE: For information on using RACADM commands for special
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
183
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSerialConsoleIdleTimeout (Read/Write)
Description
Legal Values
The maximum number of seconds to wait before an idle serial
session is disconnected.
0 = No timeout
60 – 1920
Default
For iDRAC6: 300
For CMC: 1800
cfgSerialConsoleNoAuth (Read/Write)
Description
Legal Values
Enables or disables the RAC or CMC serial console login
authentication.
0 (enables serial login authentication)
1 (disables serial login authentication)
0
Default
cfgSerialConsoleCommand (Read/Write)
Description
Legal Values
Specifies a serial command that is executed after a user logs into
the serial console interface.
For iDRAC6: A string of up to 128 characters.
For CMC: A string representing a valid serial command. For
example, connect server-1.
Default
<blank>
cfgSerialConsoleColumns
NOTE: This object property is applicable only for CMC.
Description
Specifies the number of columns in the terminal window command
line connected to the serial port.
Legal Values
Default
0 – 256
0 (equivalent to 80)
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
184
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
NOTE: The prompt counts as two characters.
NOTE: The terminal emulator must be configured with the line wrap mode ON, if a
terminal emulator is used.
NOTE: You must log out, then log in again for the changes to take effect.
cfgSerialHistorySize (Read/Write)
Description
Legal Values
Default
Specifies the maximum size of the serial history buffer.
0 – 8192
8192
cfgSerialCom2RedirEnable (Read/Write)
The cfgSerialCom2RedirEnable object property is applicable only for iDRAC6 on
Rack and Tower Servers. It is not applicable for iDRAC6 Enterprise on Blade Servers and
CMC.
Description
Legal Values
Enables or disables the console for COM 2 port redirection.
1 (TRUE)
0 (FALSE)
1
Default
cfgSerialSshEnable (Read/Write)
Description
Legal Values
Enables or disables the secure shell (SSH) interface on iDRAC6 or
CMC.
1 (TRUE)
0 (FALSE)
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
185
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Example
racadm getconfig -g cfgSerial
cfgSerialBaudRate=115200
cfgSerialConsoleEnable=1
cfgSerialConsoleQuitKey=^\
cfgSerialConsoleIdleTimeout=1800
cfgSerialConsoleNoAuth=0
cfgSerialConsoleCommand=
cfgSerialConsoleColumns=0
cfgSerialHistorySize=8192
cfgSerialTelnetEnable=0
cfgSerialSshEnable=1
cfgSerialTelnetEnable (Read/Write)
Description
Legal Values
Enables or disables the Telnet console interface on iDRAC6 or
CMC.
1 (TRUE)
0 (FALSE)
0
Default
cfgOobSnmp
This group contains parameters to configure the SNMP agent and trap
capabilities of iDRAC6 or CMC. One instance of the group is allowed.
The CMC SNMP agent supports the standard RFC1213 mib-2, and the Dell
enterprise-specific MIB.
NOTE: For CMC, use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, 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.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
186
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
The following sections provides information about the objects in the
cfgOobSnmp group.
cfgOobSnmpAgentCommunity (Read/Write)
Description
Specifies the SNMP Community Name (identical to community
string) used for SNMP traps. The community string acts as a
password shared between different hosts over the network. This
community string value must match with that of the other hosts for
any kind of communication through SNMP.
Legal Values
Default
A string of up to 31 characters.
public
Example
racadm getconfig -g cfgOobSnmp
cfgOobSnmpTrapsEnable=1
cfgOobSnmpAgentCommunity=public
cfgOobSnmpAgentEnable (Read/Write)
Description
Legal Values
Enables or disables the SNMP agent in iDRAC6 or CMC.
1 (TRUE)
0 (FALSE)
0
Default
cfgTraps
This group displays information for and configures delivery of SNMP traps for
a specific user.
NOTE: This object property is applicable only to CMC. Use this object with the
config or getconfig subcommands.
NOTE: 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.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
187
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgTrapsIndex (Read Only)
Description
Legal Values
Default
Indicates the unique index of an alert instance
1 - 4
1
cfgTrapsEnable
Description
Legal Values
Enables or disables event traps on the CMC.
1 (TRUE)
0 (FALSE)
None
Default
cfgTrapsAlertDestIpAddr
Description
Legal Values
Default
Sets the IP address that receives the alert.
A string representing a valid IP address. For example, 192.168.0.20.
None
cfgTrapsCommunityName
Description
Sets the community string (identical to the community name) used
for authentication. The community string acts as a password shared
between different hosts over the network. This community string
value must match with that of the other hosts for any kind of
communication through SNMP.
Legal Values
Default
A string representing the community name.
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
188
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Example
racadm getconfig -g cfgTraps -i 2
# cfgTrapsIndex=2
cfgTrapsEnable=1
cfgTrapsAlertDestIpAddr=
cfgTrapsCommunityName=public
cfgRacTuning
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, 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.
Use the -m option to apply this setting to iDRAC.
This group is used to configure various iDRAC6 or CMC configuration
properties, such as valid ports and security port restrictions.
The following sections provides information about the objects in the
cfgRacTuning group.
cfgRacTuneConRedirPort (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Specifies the port to be used for keyboard, mouse, video, and
Virtual Media traffic to iDRAC6.
Legal Values
Default
1025 – 65535
5900
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
189
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneRemoteRacadmEnable (Read/Write)
Description
Legal Values
Enables or disables the Remote RACADM interface in iDRAC or
CMC.
1 (TRUE)
0 (FALSE)
1
Default
cfgRacTuneCtrlEConfigDisable
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description
Legal Values
Enables or disables the ability to disable the ability of the local user
to configure iDRAC from the BIOS POST option-ROM.
1 (TRUE)
0 (FALSE)
0
Default
cfgRacTuneHttpPort (Read/Write)
Description
Specifies the port number to use for HTTP network
communication with iDRAC6 or CMC.
Legal Values
Default
10 – 65535
80
NOTE: For CMC, the following port numbers are reserved and cannot be used: 21,
68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
190
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneHttpsPort (Read/Write)
Description
Specifies the port number to use for HTTPS network
communication with iDRAC6 or CMC.
Legal Values
Default
10 – 65535
443
NOTE: For CMC, the following port numbers are reserved and cannot be used: 21,
68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
cfgRacTuneIpRangeEnable (Read/Write)
Description
Legal Values
Enables or disables the IPv4 Address Range validation feature of
iDRAC6 or CMC.
1 (TRUE)
0 (FALSE)
0
Default
cfgRacTuneIpRangeAddr (Read/Write)
Description
Specifies the acceptable IPv4 address bit pattern in positions
determined by the "1"s in the range mask property
(cfgRacTuneIpRangeMask).
For CMC, a login from the incoming IP address is allowed only if
the following are identical:
• cfgRacTuneIpRangeMask bit-wise and with incoming IP address
• cfgRacTuneIpRanbeMask bit-wise and with
cfgRacTuneIpRangeAddr
Legal Values
Default
An IPv4 address formatted string, for example, 192.168.0.44.
192.168.1.1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
191
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneIpRangeMask (Read/Write)
Description
Standard IP mask values with left-justified bits. For example,
255.255.255.0.
For CMC, 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
Default
An IPv4 address formatted string, for example, 255.255.255.0.
Standard IP mask values with left-justified bits.
255.255.255.0
cfgRacTuneIpBlkEnable (Read/Write)
Description
Legal Values
Enables or disables the IPv4 address blocking feature of iDRAC6 or
CMC.
1 (TRUE)
0 (FALSE)
0
Default
cfgRacTuneIpBlkFailCount (Read/Write)
Description
The maximum number of login failures to occur within the window
(cfgRacTuneIpBlkFailWindow) before login attempts from the IP
address are rejected.
Legal Values
Default
2 – 16
5
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
192
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneIpBlkFailWindow (Read/Write)
Description
Defines the time span in seconds that the failed attempts are
counted. When failure attempts age beyond this limit, they are
dropped from the count.
Legal Values
Default
For iDRAC6: 10 – 65535
For CMC: 2 – 655356
60
cfgRacTuneIpBlkPenaltyTime (Read/Write)
Description
Legal Values
Defines the time span in seconds that session requests from an IP
address with excessive failures are rejected.
For iDRAC6: 10 – 655356
For CMC: 2 – 655356
300
Default
cfgRacTuneSshPort (Read/Write)
Description
Legal Values
Specifies the port number used for iDRAC6 or CMC SSH
interface.
For iDRAC6: 1 – 65535
For CMC: 10 – 65535
22
Default
cfgRacTuneTelnetPort (Read/Write)
Description
Legal Values
Specifies the port number used for iDRAC6 or CMC Telnet
interface.
For iDRAC6: 1 – 65535
For CMC: 10 – 65535
23
Default
NOTE: For CMC, the following port numbers are reserved and cannot be used: 21,
68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
193
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneConRedirEnable (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
Description
Legal Values
Enables or disables Virtual Console.
1 (TRUE)
0 (FALSE)
1
Default
cfgRacTuneConRedirEncryptEnable (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
Description
Legal Values
Encrypts the video in a Virtual Console session.
1 (TRUE)
0 (FALSE)
1
Default
cfgRacTuneAsrEnable (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
NOTE: This object requires an iDRAC6 reset before it becomes active.
Description
Legal Values
Enables or disables iDRAC6 last crash screen capture feature.
1 (TRUE)
0 (FALSE)
0
Default
cfgRacTuneDaylightOffset (Read Only)
Description
Specifies the daylight savings offset (in minutes) to use for the RAC
Time. This value is 0 if the time zone is not a Daylight Saving time
zone.
Legal Values
Default
0 – 60
0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
194
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Example
racadm getconfig -g cfgRacTuning [-m server-<n>] -o
<object name> <object value>
cfgRacTuneRemoteRacadmEnable=1
cfgRacTuneWebserverEnable=1
cfgRacTuneHttpPort=80
cfgRacTuneHttpsPort=443
cfgRacTuneTelnetPort=23
cfgRacTuneSshPort=22
cfgRacTuneIpRangeEnable=0
cfgRacTuneIpRangeAddr=192.168.1.1
cfgRacTuneIpRangeMask=255.255.255.0
cfgRacTuneIpBlkEnable=0
cfgRacTuneIpBlkFailCount=5
cfgRacTuneIpBlkFailWindow=60
cfgRacTuneIpBlkPenaltyTime=300
# cfgRacTuneTimezoneOffset=-18000
# cfgRacTuneDaylightOffset=3600
cfgRacTuneTimezoneOffset (Read Only)
Description
Specifies the time zone offset (in minutes) from Greenwich Mean
Time (GMT)/Coordinated Universal Time (UTC) to use for the
RAC Time. Some common time zone offsets for time zones in the
United States are:
• –480 (PST—Pacific Standard Time)
• –420 (MST—Mountain Standard Time)
• –360 (CST—Central Standard Time)
• –300 (EST—Eastern Standard Time)
For CMC: This object property is read only. Specifies the difference
in number of seconds, from the (UTC)/ (GMT). This value is
negative if the current time zone is west of Greenwich.
Legal Values
Default
–720 – 7800
0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
195
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneLocalServerVideo (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
Description
Legal Values
Enables (switches on) or disables (switches off) the local server
video.
1 (TRUE - Enables)
0 (FALSE- Disables)
1
Default
cfgRacTuneLocalConfigDisable (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
Description
Disables write access to iDRAC6 configuration data by setting to 1.
NOTE: Access can be disabled using the local RACADM or iDRAC6
Web interface; however, once disabled, access can be re-enabled
only through iDRAC6 Web interface.
Legal Values
Default
0 (TRUE-Enables)
1 (FALSE-Disables)
0
cfgRacTuneWebserverEnable (Read/Write)
Description
Enables or disables iDRAC6 or CMC web server. If this property is
disabled, iDRAC6 or CMC is not accessible using client web
browsers. This property has no effect on the Telnet/SSH or
RACADM interfaces.
Legal Values
Default
1 (TRUE)
0 (FALSE)
1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
196
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacTuneVirtualConsoleAuthorizeMultipleSessions (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
NOTE: To modify this property, you must have Configure iDRAC permission.
This object can be used only with remote or firmware (SSH or Telnet) RACADM and
not with local RACADM or with earlier DRAC products.
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers.
Description
Legal Values
If a first user is already using the Virtual Console, the value of this
object effects the privileges granted to the subsequent user’s shared
request after the timeout of 30 seconds.
0 (If the user of the first session has not responded for session
sharing request by subsequent user, the next session user gets an
access denied error after the default timeout value of 30 seconds.)
1(If the user of the first session has not responded for session
sharing request by subsequent user, the next session user gets a read
only access after the default timeout value of 30 seconds.)
2 (If the user of the first session has not responded for session
sharing request by subsequent user, the next session user gets
administrator access after default timeout value of 30 seconds.)
Default
0
cfgRacTunePluginType (Read/Write)
NOTE: This object property is applicable only to iDRAC6.
Description
Legal Values
Specifies the plug-in type to use when running virtual console from
browser.
0 = Use Active X /Native Plugin
1 = Use Java Plugin
Default
0 = Active X /Native Plugin
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
197
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
ifcRacManagedNodeOs
NOTE: This object is applicable only to iDRAC6.
This group contains properties that describe the managed server
operating system. One instance of the group is allowed.
The following sections provides information about the objects in the
ifcRacManagedNodeOs group.
ifcRacMnOsHostname (Read Only)
Description
Legal Values
Default
The host name of the managed server.
A string of up to 255 characters.
<blank>
ifcRacMnOsOsName (Read Only)
Description
Legal Values
Default
The operating system name of the managed server.
A string of up to 255 characters.
<blank>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
198
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacVirtual
NOTE: This object is applicable only to iDRAC6.
This group contains parameters to configure the iDRAC6 Virtual Media
feature. One instance of the group is allowed.
The following sections provides information about the objects in the
cfgRacVirtual group.
cfgRacVirMediaAttached (Read/Write)
Description
This object is used to attach virtual devices to the system via the
USB bus. When the devices are attached the server recognizes valid
USB mass storage devices attached to the system. This is equivalent
to attaching a local USB CDROM/floppy drive to a USB port on the
system. When the devices are attached they can be connected to
the virtual devices remotely using iDRAC6 Web interface or the
CLI. Setting this object to 0 causes the devices to detach from the
USB bus.
Legal Values
Default
0 = Detach
1 = Attach
2 = Auto-Attach
0
cfgVirMediaBootOnce (Read/Write)
Description
Enables or disables the Virtual Media Boot Once feature of
iDRAC6.
If this property is enabled when the host server is rebooted, this
feature attempts to boot from the virtual media devices—if the
appropriate media is installed in the device.
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
199
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgVirtualFloppyEmulation (Read/Write)
NOTE: Virtual Media has to be reattached (using cfgVirMediaAttached) for this
change to take effect.
Description
When set to 0, the virtual floppy drive is recognized as a removable
disk by Windows operating systems. Windows operating systems
assigns a drive letter that is C: or higher during enumeration. When
set to 1, the Virtual Floppy drive is seen as a floppy drive by
Windows operating systems. Windows operating systems assigns a
drive letter of A: or B:.
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
cfgVirMediaKeyEnable (Read/Write)
Description
Enables or disables the Virtual Media key feature of the RAC.
NOTE: This command is deprecated from 1.5 and 3.0 releases
onwards. The functionality of this command is now covered by
cfgVFlashSDEnable. While execution of the
cfgVirMediaKeyEnablecommand is successful, it is
recommended to use the cfgVFlashSDEnablecommand. For
more information, see "cfgVFlashSDEnable (Read/Write)" on page 275.
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
200
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSDWriteProtect (Read only)
Description
Displays if the physical write protect latch on the SD card is
enabled or disabled.
NOTE: This command is deprecated from 1.5 and 3.0 releases
onwards. The functionality of this command is now covered by
cfgVFlashSDWriteProtect. While execution of the
cfgSDWriteProtectcommand is successful, it is
recommended to use the cfgVFlashSDWriteProtect
command. For more information, see "cfgVFlashSDWriteProtect (Read
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
cfgLCDriveEnable (Read/Write)
Description
Enable/disable the USC-LCE device from showing up in the
operating system. It must be disabled in ESXi operating system.
Allows proper operation of operating system and drivers interfacing
with the iDRAC/USC-LCE USB devices.
Legal Values
Default
1 (Enabled)
0 (Disabled)
1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
201
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerInfo
This group allows you to select the BIOS first boot device and to boot the
selected device only once.
For CMC, this group allows you to displays information for and configure a
server in the chassis.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, you can configure any setting that is not preceded by the hash
sign (#) in the output. To modify a configurable object, use the -o option
The following sections provide information about the objects in the
cfgServerInfo group.
cfgServerInfoIndex (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the index name of the server.
None
None
cfgServerSlotNumber (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Specifies the location of the specified server (1–16) in the chassis.
None
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
202
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerServiceTag (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the service tag of the specified server.
None
None
cfgServerName (Read/Write)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Displays the name of the specified server.
Maximum of 15 non-extended ASCII characters, (ASCII codes 32
through 126). For more information, see "Guidelines to Quote
Default
SLOT-<slot number>
cfgServerFW (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the server's iDRAC management firmware revision.
None
None
cfgServerBIOS (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the server's BIOS revision.
None
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
203
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerBmcMacAddress (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the BMC MAC address of the specified server.
None
None
cfgServerNic1MacAddress (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the MAC address of the server NIC 1.
None
None
cfgServerNic2MacAddress (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the MAC address of the server NIC 2.
None
None
cfgServerNic3MacAddress (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the MAC address of the server NIC 3.
None
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
204
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerNic4MacAddress (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the MAC address of the server NIC 4.
None
None
cfgServerPriority (Read/Write)
NOTE: This object is applicable only to CMC.
Description
Sets the priority level allotted to the server in the chassis for power
budgeting purposes.
Legal Values
Default
1–9 in descending priority, where 1 holds the highest priority
1
cfgServerNicEnable (Read/Write)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Enables or disables LAN channel.
1 (enable)
0 (disable)
None
Default
cfgServerIPMIOverLanEnable (Read/Write)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Enables or disables IPMI LAN channel.
1 (enable)
0 (disable)
None
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
205
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerBudgetAllocation (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Displays the current power allocation for the server.
1 (enable)
0 (disable)
None
Default
cfgServerDNSRegisterIMC (Read/Write)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Enables or disables DNS name registration for the Integrated
Management Controller (iDRAC).
1 (enable)
0 (disable)
None
Default
cfgServerDNSIMCName (Read/Write)
NOTE: This object is applicable only to CMC.
Description
Displays the DNS domain name for the integrated Remote Access
Controller, iDRAC.
Legal Values
Default
None
None
cfgServerRootPassword (Write only)
NOTE: This object is applicable only to CMC.
Description
Displays the password for iDRAC as a series of asterisks (*). It
cannot be seen or displayed after this property is written.
Legal Values
Default
None
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
206
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerFirstBootDevice (Read/Write)
NOTE: For CMC, this object is Write only.
NOTE: For a vFlash Partition to be configured as First Boot Device, it has to be
attached first. When a detached / non-existent VFlash partition or a non-standard
boot device is configured as first boot device, the following error message is
displayed:
Invalid object value
Description
Legal Values
Sets or displays the first boot device.
For iDRAC6, you can also set a vFlash partition that is attached as
a bootable device. For more information, see
No-Override
PXE
HDD
DIAG
CD-DVD
BIOS
vFDD
VCD-DVD
iSCSI
VFLASH
FDD
SD
Default
No-Override
cfgServerBootOnce (Read/Write)
NOTE: For CMC, this object is Write only.
Description
Legal Values
Enables or disables the server boot once feature.
1 = TRUE
0 = FALSE
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
207
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerConsumption (Read only)
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Displays the current power consumption for a server
None
None
Example
racadm getconfig -g cfgServerInfo -i 8
# cfgServerInfoIndex=8
# cfgServerSlotNumber=8
# cfgServerServiceTag=
cfgServerName=SLOT-08
# cfgServerFW=3.0
# cfgServerBIOS=
# cfgServerBmcMacAddress=00:21:9B:FE:5F:58
# cfgServerNic1MacAddress=00:0D:56:B8:69:63
170 CMC Property Database Group and Object Definitions
# cfgServerNic2MacAddress=00:0D:56:B8:69:65
# cfgServerNic3MacAddress=00:0D:56:B8:69:CB
# cfgServerNic4MacAddress=00:0D:56:B8:69:CD
cfgServerPriority=1
cfgServerNicEnable=1
cfgServerIPMIOverLANEnable=1
# cfgServerPowerBudgetAllocation=0
cfgServerDNSRegisterIMC=0
cfgServerDNSIMCName=iDRAC-
# cfgServerRootPassword=******** (Write-Only)
# cfgServerFirstBootDevice=******** (Write-Only)
# cfgServerBootOnce=******** (Write-Only)
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
208
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
# cfgServerPowerConsumption=0
racadm getconfig -g cfgServerInfo -i 1
# cfgServerInfoIndex=1
# cfgServerSlotNumber=1
# cfgServerServiceTag=1S0M0G1
cfgServerName=SLOT-01
# cfgServerFW=1.40 (Build 12)
# cfgServerBIOS=4.0.2
# cfgServerBmcMacAddress=00:18:8B:FF:41:43
# cfgServerNic1MacAddress=00:1A:A0:FF:D9:F4
# cfgServerNic2MacAddress=00:1A:A0:FF:D9:F6
cfgServerPriority=1
cfgServerNicEnable=1
cfgServerIPMIOverLANEnable=1
# cfgServerPowerBudgetAllocation=0
cfgServerDNSRegisterIMC=0
cfgServerDNSIMCName=iDRAC-1S0M0G1
# cfgServerRootPassword=******** (Write-Only)
# cfgServerFirstBootDevice=******** (Write-Only)
# cfgServerBootOnce=******** (Write-Only)
# cfgServerPowerConsumption=0
cfgActiveDirectory
This group contains parameters to configure iDRAC6 or CMC Active
Directory feature.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, 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.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
209
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
The following sections provides information about the objects in the
cfgActiveDirectory group.
cfgADRacDomain (Read/Write)
Description
Legal Values
Active Directory Domain in which iDRAC6 or CMC resides.
Any printable text string of up to 254 characters, with no white
space.
Default
<blank>
cfgADRacName (Read/Write)
Description
Legal Values
Default
Name of iDRAC6 or CMC as recorded in the Active Directory
forest.
Any printable text string of up to 254 characters, with no white
space.
<blank>
cfgADRootDomain
NOTE: This object is applicable only to CMC.
Description
Legal Values
Specifies the root domain of the domain forest.
Any printable text string of up to 254 characters, with no white
space.
Default
<blank>
cfgADEnable (Read/Write)
Description
Enables or disables Active Directory user authentication on
iDRAC6 or CMC. If this property is disabled, only local iDRAC6 or
CMC authentication is used for user logins.
Legal Values
Default
1 (TRUE)
0 (FALSE)
0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
210
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgADSCLEnable
NOTE: This object is applicable only to CMC.
Description
Legal Values
Enables you to log on to the CMC without enabling the Smart
Card login
1 (Enable)
0 (Disable)
0
Default
cfgADSSOEnable (Read/Write)
Description
Legal Values
Enables or disables Active Directory single sign-on authentication
on iDRAC6.
1 (TRUE)
0 (FALSE)
0
Default
cfgADDomainController
NOTE: This object is applicable only to CMC.
Description
Specifies the LDAP server from which you want the CMC to obtain
user names. Must be used with cfgADSpecifyServerEnable.
Valid IP address or fully qualified domain name (FQDN).
None
Legal Values
Default
cfgADDomainController1 (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Default
iDRAC6 uses the value specified to search the LDAP server for user
names.
A string of up to 254 ASCII characters representing a valid IP
address or a fully qualified domain name (FQDN).
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
211
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgADDomainController2 (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Default
iDRAC6 uses the value specified to search the LDAP server for user
names.
A string of up to 254 ASCII characters representing a valid IP
address or a fully qualified domain name (FQDN).
None
cfgADDomainController3 (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Default
iDRAC6 uses the value specified to search the LDAP server for user
names.
A string of up to 254 ASCII characters representing a valid IP
address or a fully qualified domain name (FQDN).
None
cfgADAuthTimeout (Read/Write)
NOTE: To modify this property, you must have Configure iDRAC permission.
Description
Specifies the number of seconds to wait for Active Directory
authentication requests to complete before timing out.
Legal Values
Default
15 – 300 seconds
120
cfgADType (Read/Write)
Description
Legal Values
Determines the schema type to use with Active Directory.
1 (Enables Active Directory with the extended schema)
2 (Enables Active Directory with the standard schema)
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
212
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgADSpecifyServerEnable
NOTE: This object is applicable only to CMC.
Description
Allows you to enable or disable and specify an LDAP server or a
global catalog server. Use cfgADDomainController or
cfgADGlobalCatalog to specify the IP address
Legal Values
Default
1 (enabled)
0 (disabled)
0
cfgADGlobalCatalog
NOTE: This object is applicable only to CMC.
Description
Specifies the global catalog server from which you want the CMC to
obtain user names. Must be used with cfgADSpecifyServerEnable.
Legal Values Valid IP address or FQDN.
Default
None
Example
racadm getconfig -g cfgActiveDirectory
cfgADEnable=1
cfgADSCLEnable=0
cfgADSSOEnable=0
cfgADRacDomain=
cfgADRootDomain=help
cfgADRacName=
cfgADRacAuthTimeout=300
cfgADType=0x4
cfgADSpecifyServerEnable=1
cfgADDomainController=192.168.1.1
cfgADGlobalCatalog=127.0.0.1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
213
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgADGlobalCatalog1 (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Default
iDRAC6 uses the value specified to search the Global Catalog
server for user names.
A string of up to 254 ASCII characters representing a valid IP
address or a fully qualified domain name (FQDN).
None
cfgADGlobalCatalog2 (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Default
iDRAC6 uses the value specified to search the Global Catalog
server for user names.
A string of up to 254 ASCII characters representing a valid IP
address or a fully qualified domain name (FQDN).
None
cfgADGlobalCatalog3 (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Default
iDRAC6 uses the value specified to search the Global Catalog
server for user names.
A string of up to 254 ASCII characters representing a valid IP
address or a fully qualified domain name (FQDN).
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
214
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgADCertValidationEnable (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Enables or disables Active Directory certificate validation as a part
of the Active Directory configuration process.
1 (TRUE)
0 (FALSE)
1
Default
cfgADDcSRVLookupEnable (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Configures iDRAC6 to use pre-configured domain controllers or to
use DNS to find the domain controller. If using pre-configured
domain controllers, then the domain controllers to use are specified
under cfgAdDomainController1, cfgAdDomainController2, and
cfgAdDomainController3. iDRAC6 does not fail over to the
specified domain controllers when DNS lookup fails or none of the
servers returned by the DNS lookup works.
Legal Values
Default
1 (TRUE)—use DNS to look up domain controllers
0 (FALSE)—use pre-configured domain controllers
0
cfgADDcSRVLookupbyUserdomain (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Legal Values
Chooses the way the user domain is looked up for Active Directory.
1 (TRUE)—use user domain as the search domain to look up DCs.
The user domain is chosen from the user domain list or entered by
the login user.
0 (FALSE)—use the configured search domain
cfgADDcSrvLookupDomainName to look up DCs.
Default
1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
215
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgADDcSRVLookupDomainName (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
This is the Active Directory Domain to use when
cfgAddcSrvLookupbyUserDomain is set to 0.
Legal Values
Default
String. Maximum length = 254
Null
cfgADGcSRVLookupEnable (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
Determines how the global catalog server is looked up. If using
pre-configured global catalog servers, then iDRAC6 uses the values
cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and
cfgAdGlobalCatalog3.
Legal Values
Default
0(FALSE)—use pre-configured Global Catalog Servers (GCS)
1(TRUE)—use DNS to look up GCS
0
cfgADGcRootDomain (Read/Write)
NOTE: This object is applicable only to iDRAC6.
Description
The name of the Active Directory root domain used for DNS look
up, to locate Global Catalog servers.
String. Maximum length = 254
Null
Legal Values
Default
cfgLDAP
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, 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
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
216
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
This group allows you to configure settings related to the Lightweight
Directory Access Protocol (LDAP).
The following sections provides information about the objects in the
cfgLDAP group.
cfgLdapEnable (Read/Write)
Description
Turns LDAP service on or off.
If this property is disabled, local CMC authentication is used for
user logins.
Legal Values
Default
1 (TRUE)—Enable LDAP Services
0 (FALSE)—Disable LDAP Services
0
NOTE: For CMC, enabling this option turns off cfgADEnable.
cfgLdapServer (Read/Write)
Description
Legal Values
Configures the address of the LDAP Server. IPv4 and IPv6 are
supported.
String.
For iDRAC6: Maximum length = 1024
For CMC: Maximum length = 254
Null
Default
NOTE: You can specify multiple servers by separating each server with a comma.
For example, example.com, sub1.example.com
cfgLdapPort (Read/Write)
Description
Legal Values
Default
Port of LDAP over SSL. Non-SSL port is not supported.
1 - 65535
636
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
217
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgLdapBasedn (Read/Write)
Description
The Domain Name of the branch of the directory where all searches
should start from.
Legal Values
Default
String. Maximum length = 254
Null
cfgLdapUserAttribute (Read/Write)
Description
Specifies the user attribute to search for. If not configured, the
default used is uid. It is recommended to be unique within the
chosen baseDN, otherwise a search filter must be configured to
ensure the uniqueness of the login user. If the user DN cannot be
uniquely identified, login fails with error.
Legal Values
Default
String. Maximum length = 254
Null
uid if not configured.
cfgLdapGroupAttribute (Read/Write)
Description
Specify which LDAP attribute is used to check for group
membership. This should be an attribute of the group class. If not
specified, then iDRAC6 or CMC uses the member and unique
member attributes.
Legal Values
Default
String. Maximum length = 254
Null
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
218
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgLdapGroupAttributeIsDN (Read/Write)
Description
When it is set to 1, iDRAC6 compares the userDN retrieved from
the directory to compare to the members of the group; if it is set to
0, the user name provided by the login user is used to compare to
the members of the group. This does not impact the search
algorithm for the bind. iDRAC6 always searches the userDN and
uses the userDN to bind.
For CMC, if enabled, the CMC performs DN matching, otherwise
the CMC uses the user name provided at login for matching.
Legal Values
Default
1 (TRUE)—Use the userDN from the LDAP Server
0 (FALSE)—Use the userDN provided by the login user
1
cfgLdapBinddn (Read/Write)
Description
The distinguished name of a user used to bind to the server when
searching for the login user's DN. If not provided, an anonymous
bind is used. This is optional but is required if anonymous bind is
not supported.
Legal Values
Default
String. Maximum length = 254
Null
NOTE: If cfgLDAPBindDN is [null] and cfgLDAPBindPassword is [null], then the
CMC attempts an anonymous bind.
cfgLdapBindpassword (Write only)
Description
A bind password to use in conjunction with the bindDN. The bind
password is sensitive data, and should be properly protected. This is
optional but is required if anonymous bind is not supported.
Legal Values
Default
String. Maximum length = 254
Null
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
219
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgLdapSearchFilter (Read/Write)
Description
A valid LDAP search filter. This is used if the user attribute cannot
uniquely identify the login user within the chosen baseDN. The
search filter only applies to userDN search and not the group
membership search.
Legal Values
Default
For iDRAC6: String of maximum length = 254 characters
For CMC: String of maximum length = 1024 characters
(objectclass=*)
Searches for all objects in tree.
cfgLDAPCertValidationEnable (Read/Write)
Description
Legal Values
Controls certificate validation during SSL handshake.
1 (TRUE)—iDRAC6 or CMC uses the CA certificate to validate
the LDAP server certificate during SSL handshake.
0 (FALSE)—iDRAC6 or CMC skips the certificate validation step
of SSL handshake.
Default
1
cfgLDAPNetworkTimeout
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Configures the network timeout in seconds.
Positive integer
30 seconds
cfgLDAPSearchTimeout
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Configures the search timeout in seconds.
Positive integer
120 seconds
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
220
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgLDAPSRVLookupEnable
NOTE: This object is applicable only to CMC.
Description
Legal Values
Configures the CMC to query a DNS server for SRV records.
1 (true)
0 (false)
0
Default
cfgLDAPSRVLookupDomainName
NOTE: This object is applicable only to CMC.
Description
Legal Values
Configures the domain name to be used in the SRV lookup.
String of maximum length of 254 alphanumeric characters and
hyphens. The string must begin with a letter.
Default
[null]
cfgLDAPSRVLookupServiceName
NOTE: This object is applicable only to CMC.
Description
Legal Values
Default
Configures the service name to be used in the SRV lookup.
String of maximum length of 254 characters.
ldap
cfgLdapRoleGroup
This group allows the user to configure role groups for LDAP.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, 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.
For CMC, this object configures Generic LDAP Role group Descriptions and
defines the CMC privileges that LDAP-authenticated users are granted.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
221
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgLDAPRoleGroup is indexed, containing instances numbered from 1 to 5.
Each object instance consists of a pair of properties:
•
•
cfgLDAPRoleGroupDN: an LDAP distinguished name (DN)
cfgLDAPRoleGroupPrivilege: a CMC privilege map
Each LDAP-authenticated user assumes the total set of CMC privileges
assigned to the matching LDAP distinguished names that the user belongs to.
That is, if the user belongs to multiple role group DNs, the user receives all
associated privileges for those DNs.
The following sections provides information about the objects in the
cfgLdapRoleGroup group.
cfgLdapRoleGroupIndex (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
This is the index value of the Role Group Object.
An integer between 1 and 5
<instance>
cfgLdapRoleGroupDN (Read/Write)
Description
This is the Domain Name of the group in this index.
For CMC, configure the LDAP distinguished name (DN) for the
role group instance.
Legal Values
Default
String. Maximum length = 1024
None
Example
racadm getconfig -g cfgLDAPRoleGroup -o
cfgLDAPRoleGroupDN -i 1 cn=everyone,ou=groups,dc=
openldap,dc=com
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
222
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgLdapRoleGroupPrivilege (Read/Write)
Description
Legal Values
A bit–mask defining the privileges associated with this particular
group.
2,3,4, and 5
where:
• 2 - User
• 3 - Admin
• 4 - Operator
• 15 - No Access
15
Default
Example
racadm getconfig -g cfgLDAPRoleGroup -o
cfgLDAPRoleGroupPrivilege -i 1 2
cfgStandardSchema
This group contains parameters to configure the Active Directory standard
schema settings.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: For CMC, you can configure any setting that is not preceded by the hash
sign (#) in the output. To modify a configurable object, use the -o option.
The following sections provides information about the objects in the
cfgStandardSchema group.
cfgSSADRoleGroupIndex (Read Only)
Description
Legal Values
Default
Index of the Role Group as recorded in the Active Directory.
An integer between 1 and 5
<instance>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
223
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSSADRoleGroupName (Read/Write)
Description
Legal Values
Name of the Role Group as recorded in the Active Directory forest.
Any printable text string of up to 254 characters with no white
space.
Default
<blank>
cfgSSADRoleGroupDomain (Read/Write)
Description
Legal Values
Active Directory Domain in which the Role Group resides.
Any printable text string of up to 254 characters, with no white
space.
Default
<blank>
cfgSSADRoleGroupPrivilege (Read/Write)
Description
Legal Values
privileges for a Role Group.
For iDRAC6: 0x00000000 to 0x000001ff
For CMC: 0x00000000–0x00000fff
<blank>
Default
Example
racadm getconfig -g cfgStandardSchema
# cfgSSADRoleGroupIndex=1
cfgSSADRoleGroupName=blsys-1
cfgSSADRoleGroupDomain=
cfgSSADRolGroupPrivilege=3081
Table 3-5. Bit Masks for Role Group Privileges
Role Group Privilege
Login to iDRAC
Bit Mask
0x00000001
0x00000002
Configure iDRAC
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
224
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
Table 3-5. Bit Masks for Role Group Privileges (continued)
Role Group Privilege
Configure Users
Bit Mask
0x00000004
0x00000008
0x00000010
0x00000020
0x00000040
0x00000080
0x00000100
Clear Logs
Execute Server Control Commands
Access Virtual Console
Access Virtual Media
Test Alerts
Execute Debug Commands
cfgChassisPower
This group is applicable only to CMC and contains parameters to display or
configure power for the chassis.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: 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.
The following sections provides information about the objects in the
cfgChassisPower group.
cfgChassisInPower (Read Only)
Indicates the cumulative input power consumption data (in watts and
BTU/hr) captured from all healthy and functional PSUs in the chassis.
cfgChassisPeakPower (Read Only)
The maximum system input power consumption (in watts) since the value
was last cleared by a user.
cfgChassisPeakPowerTimestamp (Read Only)
The timestamp recorded when the peak input power consumption value
occurred.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
225
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgChassisMinPower (Read Only)
The minimum system input power consumption value (in watts) over the
time since the value was last cleared.
cfgChassisMinPowerTimestamp (Read Only)
The timestamp recorded when the minimum system power occurred.
cfgChassisPowerStatus (Read Only)
Description
Legal Values
Indicates the power status of the chassis.
1 (other)
2 (unknown)
3 (OK)
4 (non-critical)
5 (critical)
6 (non-recoverable)
None
Default
cfgChassisRedundantState (Read Only)
Description
Legal Values
Enables or disables power redundancy for the chassis.
0 (none)
1 (full)
None
Default
cfgChassisPowerCap (Read/Write)
Description
Indicates the maximum power consumption limit (in watts) for the
entire chassis. The command generates an error if server throttling
is necessary to achieve the power goal based on the value for this
setting.
Legal Values
Default
2715–16685 watts
16685 watts
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
226
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgChassisPowerCapF (Read/Write)
Description
Indicates the maximum power consumption limit (in watts) for the
entire chassis. Use cfgChassisPowerCapF when power
consumption is to be changed regardless of whether server
throttling is required. This command generates an error if the value
for this setting is lower than the minimum power required for the
chassis configuration.
Legal Values
Default
2715–16685 watts
16685 watts
cfgChassisPowerCapBTU (Read/Write)
Description
Indicates the maximum power consumption limit (in BTU/hr) for
the entire chassis. The command generates an error if server
throttling is necessary to achieve the power goal based on the value
for this setting.
Legal Values
Default
9264 - 56931 BTU/hr
43221 BTU/hr
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. The command generates an error if the value
for this setting is lower than the minimum power required for the
chassis configuration.
Legal Values
Default
9264 - 56931 BTU/hr
56931 BTU/hr
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
227
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgChassisPowerCapPercent (Read/Write)
Description
Indicates the power consumption limit as a percentage. The
percentage is computed mathematically as the minimum power +
(percent * (maximum power - minimum power)). The command
generates an error if server throttling is necessary to achieve the
power goal based on the value for this setting.
Legal Values
Default
16 -100
100
cfgChassisPowerCapFPercent (Read/Write)
Description
Indicates the power consumption limit as a percentage. The
percentage is computed mathematically as the minimum power +
(percent * (maximum power - minimum power)). Use
cfgChassisPowerCapFPercent when power consumption is to be
changed regardless of whether server throttling is required.
Legal Values
Default
16 -100
100
cfgChassisRedundancyPolicy (Read/Write)
Description
Legal Values
Sets the redundancy policy of the chassis.
0 (no redundancy)
1 (AC redundancy)
2 (power supply redundancy)
0 (no redundancy)
Default
cfgChassisDynamicPSUEngagementEnable (Read/Write)
Description
Legal Values
Enables or disables dynamic engagement.
0 (disabled)
1 (enabled)
0 (disabled)
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
228
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgChassisAllow110VACOperation (Read/Write)
Description
Enables or disables normal chassis power allocations when any
power supply unit is connected to 110V AC service. If disabled and
110V power supplies are detected, all subsequent server power
allocation requests are denied. In this mode additional servers
cannot be powered on, regardless of server priority.
Legal Values
Default
0 (disabled)
1 (enabled)
0 (disabled)
cfgChassisMaxPowerConservationMode (Read/Write)
Description
Enables or disables max power conservation mode. When enabled,
all servers are immediately reduced to their minimum power levels,
and all subsequent server power allocation requests are denied. In
this mode performance of powered on servers may be degraded, and
additional servers cannot be powered on, regardless of server
priority.
Legal Values
Default
0 (disabled)
1 (enabled)
0 (disabled)
cfgChassisPerformanceOverRedundancy (Read/Write)
Description
Enables or disables server performance over power redundancy.
When enabled, this option favors server performance and server
powerup, over maintaining power redundancy. When disabled, the
system favors power redundancy over server performance. When
disabled, then if the power supplies in the chassis do not provide
sufficient power, both for redundancy, as well as full performance,
then some servers may not be granted sufficient power for full
performance, or may not be powered on, in order to maintain
redundancy.
Legal Values
Default
0 (disabled)
1 (enabled)
1 (enabled)
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
229
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgChassisInMaxPowerCapacity (Read Only)
Indicates the total chassis power budget (in watts) available for chassis
operation.
cfgChassisInRedundancyReserve (Read Only)
Indicates the amount of redundant power (in watts) in reserve that can be
utilized in the event of an AC grid or PSU failure. This value is 0 if the
Redundancy Policy is set to 0 (no redundancy).
cfgChassisInPowerServerAllocation (Read Only)
Indicates (in watts) the cumulative power allocated to servers. There is no
default as this parameter is very specific to the particular customer
configuration.
cfgChassisInfrastructureInPowerAllocation (Read Only)
Indicates the estimated cumulative DC output power consumption (in
watts), determined from a field replaceable unit (FRU) on the hardware
modules in the chassis.
cfgChassisTotalInPowerAvailable (Read Only)
Indicates the amount of power (in watts) available for use by the chassis.
cfgChassisStandbyInPowerCapacity (Read Only)
Indicates the amount of power (in watts) available for powering up any
hardware modules that are either added to the chassis or powered up (if they
are already present in the chassis).
cfgChassisPowerClear (Write Only)
To reset cfgChassisMinPower and cfgChassisMaxPowerCapacity, set this
object to 1.
cfgChassisPowerClearTimestamp (Read Only)
Time stamp when cfgChassisMinPower and cfgChassisMaxPowerCapacity
were reset.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
230
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgChassisPowerButtonEnable (Read/Write)
Description
Legal Values
Indicates if the chassis power button is enabled or disabled.
0 (disabled)
1 (enabled).
None
Default
cfgSystemEnergyConsumptionClear (Write Only)
To reset energy statistics, set this value to 1.
Examples
racadm getconfig -g cfgChassisPower
# cfgChassisInPower=0 W | 0 BTU/hr
# cfgChassisPeakPower=0 W
# cfgChassisPeakPowerTimestamp=06:32:55 01/26/2009
# cfgChassisMinPower=0 W
# cfgChassisMinPowerTimestamp=06:32:55 01/26/2009
# cfgChassisPowerStatus=5
# cfgChassisRedundantState=0
cfgChassisPowerCap=16685 W
cfgChassisPowerCapF=16685 W
cfgChassisPowerCapBTU=56931 BTU/hr
cfgChassisPowerCapFBTU=56931 BTU/hr
cfgChassisPowerCapPercent =100%
cfgChassisPowerCapFPercent =100%
cfgChassisRedundancyPolicy=0
cfgChassisDynamicPSUEngagementEnable=0
# cfgChassisInMaxPowerCapacity=0 W
# cfgChassisInRedundancyReserve=0 W
# cfgChassisInPowerServerAllocation=0 W
# cfgChassisInfrastructureInPowerAllocation=51 W
# cfgChassisTotalInPowerAvailable=0 W
# cfgChassisStandbyInPowerCapacity=0 W
# cfgChassisPowerClear=******** (Write-Only)
# cfgChassisPowerClearTimestamp=18:00:00 12/31/1969
cfgChassisPowerButtonEnable=1
cfgChassisAllow110VACOperation=0
cfgChassisMaxPowerConservationMode=0
cfgChassisPerformanceOverRedundancy=1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
231
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSystemEnergyConsumptionClear = ****(Write-Only)
racadm config -g cfgChassisPower
-o cfgChassisPowerClear 1
Clears cfgChassisMinPower and cfgChassisPeakPower
.
cfgIpmiSol
This group is applicable only for iDRAC6 and is used to configure the Serial
Over LAN (SOL) capabilities of the system.
The following sections provides information about the objects in the
cfgIpmiSol group.
cfgIpmiSolEnable (Read/Write)
Description
Legal Values
Enables or disables SOL.
1 (TRUE)
0 (FALSE)
1
Default
cfgIpmiSolBaudRate (Read/Write)
Description
Legal Values
Default
The baud rate for serial communication over LAN.
9600, 19200, 57600, 115200
115200
cfgIpmiSolMinPrivilege (Read/Write)
Description
Legal Values
Specifies the minimum privilege level required for SOL access.
2 (User)
3 (Operator)
4 (Administrator)
4
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
232
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiSolAccumulateInterval (Read/Write)
Description
Specifies the typical amount of time that iDRAC6 waits before
transmitting a partial SOL character data packet. This value is 1-
based 5ms increments.
Legal Values
Default
1 – 255
10
cfgIpmiSolSendThreshold (Read/Write)
Description
The SOL threshold limit value. Specifies the maximum number of
bytes to buffer before sending an SOL data packet.
Legal Values
Default
1 – 255
255
cfgIpmiLan
This group is applicable only for iDRAC6 and is used to configure the IPMI
over LAN capabilities of the system.
The following sections provides information about the objects in the
cfgIpmiLan group.
cfgIpmiLanEnable (Read/Write)
Description
Legal Values
Enables or disables the IPMI over LAN interface.
1 (TRUE)
0 (FALSE)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
233
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiLanPrivLimit (Read/Write)
Description
Legal Values
Specifies the maximum privilege level allowed for IPMI over LAN
access.
2 (User)
3 (Operator)
4 (Administrator)
4
Default
cfgIpmiLanAlertEnable (Read/Write)
Description
Legal Values
Enables or disables global e-mail alerting. This property overrides
all individual e-mail alerting enable/disable properties.
1 (TRUE)
0 (FALSE)
0
Default
cfgIpmiEncryptionKey (Read/Write)
Description
Legal Values
The IPMI encryption key.
A string of hexadecimal digits from 0 to 40 characters with no
spaces. Only an even amount of digits is allowed.
Default
0000000000000000000000000000000000000000
cfgIpmiPetCommunityName (Read/Write)
Description
Legal Values
Default
The SNMP community name for traps.
A string of up to 18 characters.
public
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
234
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiPetIpv6
This group is applicable only for iDRAC6 and is used to configure IPv6
platform event traps on the managed server.
The following sections provides information about the objects in the
cfgIpmiPetIpv6 group.
cfgIpmiPetIPv6Index (Read Only)
Description
Legal Values
Default
Unique identifier for the index corresponding to the trap.
1 – 4
<index value>
cfgIpmiPetIPv6AlertDestIpAddr
Description
Legal Values
Default
Configures the IPv6 alert destination IP address for the trap.
IPv6 address
<blank>
cfgIpmiPetIPv6AlertEnable (Read/Write)
Description
Legal Values
Enables or disables the IPv6 alert destination for the trap.
1 (TRUE)
0 (FALSE)
0
Default
cfgIpmiPef
This group is applicable only for iDRAC6 and is used to configure the
platform event filters available on the managed server.
The event filters can be used to control policy related to actions that are
triggered when critical events occur on the managed server.
The following sections provides information about the objects in the
cfgIpmiPef group.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
235
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiPefName (Read Only)
Description
Legal Values
Default
Specifies the name of the platform event filter.
A string of up to 255 characters.
The name of the index filter.
cfgIpmiPefIndex (Read/Write)
Description
Legal Values
Specifies the index of a specific platform event filter.
For iDRAC6 on Rack and Tower Servers: 1 – 22
For iDRAC6 Enterprise on Blade Servers: 1-9
The index value of a platform event filter object.
Default
cfgIpmiPefAction (Read/Write)
Description
Legal Values
Specifies the action that is performed on the managed server when
the alert is triggered.
NOTE: For iDRAC6 on Rack and Tower servers, this object is read-only
for indexes 20, 21, and 22.
0 (None)
1 (Power Down)
2 (Reset)
3 (Power Cycle)
0
Default
cfgIpmiPefEnable (Read/Write)
Description
Legal Values
Enables or disables a specific platform event filter.
1 (TRUE)
0 (FALSE)
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
236
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiPet
This group is applicable only for iDRAC6 and is used to configure platform
event traps on the managed server.
The following sections provides information about the objects in the
cfgIpmiPet group.
cfgIpmiPetIndex (Read Only)
Description
Legal Values
Default
Unique identifier for the index corresponding to the trap.
1-4
The index value of a specific platform event trap.
cfgIpmiPetAlertDestIpAddr (Read/Write)
Description
Specifies the destination IPv4 address for the trap receiver on the
network. The trap receiver receives an SNMP trap when an event is
triggered on the managed server.
Legal Values
Default
A string representing a valid IPv4 address. For example,
192.168.0.67.
0.0.0.0
cfgIpmiPetAlertEnable (Read/Write)
Description
Legal Values
Enables or disables a specific trap.
1 (TRUE)
0 (FALSE)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
237
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgUserDomain
This group is applicable only for iDRAC6 and is used to configure the Active
Directory user domain names. A maximum of 40 domain names can be
configured at any given time.
The following sections provides information about the objects in the
cfgUserDomain group.
cfgUserDomainIndex (Read Only)
Description
Legal Values
Default
Represents a specific domain.
1 – 40
The index value.
cfgUserDomainName (Read Only)
Description
Legal Values
Default
Specifies the Active Directory user domain name.
A string of up to 255 ASCII characters.
<blank>
cfgServerPower
This group provides several power management features.
The following sections provides information about the objects in the
cfgServerPower group.
cfgServerPowerStatus (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Represents the server power state, either ON or OFF.
1 (ON)
0 (OFF)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
238
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerAllocation (Read Only)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC. For iDRAC6 on Rack and Tower
Servers the object is available only under Modular FW and Remote RACADM, and
not in Local RACADM.
Description
Represents the available allocated power supply for server usage.
NOTE: In case of more than one power supply, this object represents
the minimum capacity power supply.
Legal Values
Default
A string of up to 32 characters.
<blank>
cfgServerActualPowerConsumption (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Represents the power consumed by the server at the current time.
A string of up to 32 characters.
<blank>
cfgServerPowerCapEnable (Read Only)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description
Legal Values
Enables or disables the user specified power budget threshold.
0 - Disables the user specified power budget threshold
1- Enables the user specified power budget threshold
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
239
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerMinPowerCapacity (Read Only)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description
Legal Values
Default
Represents the minimum server power capacity.
A string of up to 32 characters.
<blank>
cfgServerMaxPowerCapacity (Read Only)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description
Legal Values
Default
Represents the maximum server power capacity.
A string of up to 32 characters.
<blank>
cfgServerPeakPowerConsumption (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Represents the maximum power consumed by the server until the
current time.
Legal Values
Default
A string of up to 32 characters.
<current server peak power consumption>
cfgServerPeakPowerConsumptionTimestamp (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Time when the maximum power consumption was recorded.
A string of up to 32 characters.
Maximum power consumption timestamp.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
240
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerConsumptionClear (Write Only)
NOTE: This object is applicable only for iDRAC6.
Description
Resets the cfgServerPeakPowerConsumption (Read/Write)
property to 0 and the cfgServerPeakPowerConsumptionTimestamp
property to the current iDRAC time.
Legal Values
Default
1 (TRUE)
0 (FALSE)
None
cfgServerPowerCapWatts (Read/Write)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Represents the server power threshold in Watts.
A string of up to 32 characters.
Server power threshold in Watts.
cfgServerPowerCapBtuhr (Read/Write)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Represents the server power threshold in BTU/hr.
A string of up to 32 characters.
Server power threshold in BTU/hr.
cfgServerPowerCapPercent (Read/Write)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Represents the server power threshold in percentage.
A string of up to 32 characters.
Server power threshold in percentage.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
241
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastMinAvg (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the average power value during the last minute.
A string of up to 32 characters.
Average power value during the last minute.
cfgServerPowerLastHourAvg (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the average power value during the last hour.
A string of up to 32 characters.
Average power value during the last hour.
cfgServerPowerLastDayAvg (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the average power value during the last day.
A string of up to 32 characters.
Average power value during the last day.
cfgServerPowerLastWeekAvg (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the average power value during the last week.
A string of up to 32 characters.
Average power value during the last week.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
242
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastHourMinPower (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the minimum power value during the last hour.
A string of up to 32 characters.
Minimum power value during the last hour.
cfgServerPowerLastHourMinTime (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of minimum power value during the last
minute.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD= Day of the week
• MM= Month
• Date=Date
• YYYY = Year
• HH = hour
• MM=Minutes
• SS = Seconds
Default
Minimum power value during the last minute.
cfgServerPowerLastHourMaxPower (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the maximum power value during the last hour.
A string of up to 32 characters.
Maximum power value during the last hour.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
243
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastHourMaxTime (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of maximum power value during the last
hour.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD= Day of the week
• MM= Month
• Date=Date
• YYYY = Year
• HH = hour
• MM=Minutes
• SS = Seconds
Default
Maximum power value during the last hour.
cfgServerPowerLastDayMinPower (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the minimum power value during the last day.
A string of up to 32 characters.
Minimum power value during the last day.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
244
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastDayMinPowerTime (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of minimum power value during the last
day.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD = Day of the week
• MM = Month
• Date = Date
• YYYY = Year
• HH = hour
• MM = Minutes
• SS = Seconds
Default
Minimum power value during the last day.
cfgServerPowerLastDayMaxPower (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the maximum power value during the last day.
A string of up to 32 characters.
Maximum power value during the last day.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
245
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastDayMaxPowerTime (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of maximum power value during the last
day.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD = Day of the week
• MM = Month
• Date = Date
• YYYY = Year
• HH = hour
• MM = Minutes
• SS = Seconds
Default
Maximum power value during the last day.
cfgServerPowerLastWeekMinPower (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the minimum power value during the last week.
A string of up to 32 characters.
Minimum power value during the last week.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
246
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastWeekMinPowerTime (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of minimum power value during the last
week.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD = Day of the week
• MM = Month
• Date = Date
• YYYY = Year
• HH = hour
• MM = Minutes
• SS = Seconds
Default
Minimum power value during the last week
cfgServerPowerLastWeekMaxPower (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the maximum power value during the last week.
A string of up to 32 characters.
Maximum power value during the last week.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
247
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerLastWeekMaxPowerTime (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of maximum power value during the last
week.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD = Day of the week
• MM= Month
• Date = Date
• YYYY = Year
• HH = hour
• MM = Minutes
• SS = Seconds
Default
Maximum power value during the last week.
cfgServerPowerInstHeadroom (Read Only)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers.
Description
Displays the difference between the available power and the current
power consumption.
Legal Values
Default
A string of up to 32 characters.
Difference between the available power and the current power
consumption.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
248
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerPeakHeadroom (Read Only)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers or CMC.
Description
Displays the difference between the available power and the peak
power consumption.
Legal Values
Default
A string of up to 32 characters.
Difference between the available power and the peak power
consumption.
cfgServerActualAmperageConsumption (Read Only)
NOTE: This object is applicable only for iDRAC6
Description
Legal Values
Default
Displays the current power consumption.
A string of up to 32 characters.
Current power consumption.
cfgServerPeakAmperage (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the current peak power consumption.
A string of up to 32 characters.
Current peak power consumption.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
249
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPeakAmperageTimeStamp (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of the current peak power consumption.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD = Day of the week
• MM = Month
• Date = Date
• YYYY = Year
• HH = hour
• MM = Minutes
• SS = Seconds
Default
Timestamp of the current peak power consumption.
cfgServerCumulativePowerConsumption (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
Displays the cumulative power consumption.
A string of up to 32 characters.
Cumulative power consumption.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
250
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerCumulativePowerConsumptionTimeStamp (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Displays the timestamp of the cumulative power consumption.
A string of up to 32 characters.
Time in the format: DD MM Date YYYY HH:MM:SS
where,
• DD = Day of the week
• MM= Month
• Date=Date
• YYYY = Year
• HH = hour
• MM=Minutes
• SS = Seconds
Default
Timestamp of the cumulative power consumption.
cfgServerCumulativePowerClear (Write Only)
NOTE: This object is applicable only for iDRAC6.
Description
Clears the cfgServerCumulativePowerConsumption and
cfgServerCumulativePowerConsumptionTimeStamp values.
Legal Values
Default
A string of up to 32 characters.
None
cfgServerPeakPowerClear (Write Only)
NOTE: This object is applicable only for iDRAC6.
Description
Clears the cfgServerPeakPowerConsumption and
cfgServerPeakPowerConsumptionTimestamp values.
Legal Values
Default
A string of up to 32 characters.
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
251
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerPCIeAllocation (Read/Write)
NOTE: This object is applicable only for iDRAC6.
NOTE: This object is applicable for iDRAC6 Enterprise only for specific Blade
Servers and not for iDRAC6 on Rack and Tower Servers or CMC.
NOTE: You must have Administrator privileges to modify the value for this object..
Description
Legal Values
Amount of power allocated to the PCIe cards.
0W: For platforms that do not support PCIe cards.
100W - 500W: For platforms that support PCIe cards.
0: For platforms that do not support PCIe cards.
500W: For platforms that support PCIe cards.
Default
cfgKVMInfo
NOTE: This object is applicable only for CMC.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: 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.
This group is used to display information for and configure the iKVM.
cfgKVMAccessToCMCEnable
Description
Legal Values
Enables or disables the Dell CMC Console access on the iKVM.
1 (enable)
0 (disable)
None
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
252
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgKVMFrontPanelEnable
Description
Legal Values
Enables or disables front panel access on the iKVM.
1 (enable)
0 (disable)
None
Default
Example
racadm getconfig -g cfgKVMInfo
cfgKVMAccessToCMCEnable=1
cfgKVMFrontPanelEnable=1
cfgAlerting
NOTE: This object is applicable only for CMC.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property, you must have Chassis Configuration
Administrator privilege.
This group is used to enables or disable SNMP event trap alerting and set the
event filter.
cfgAlertingEnable
Description
Legal Values
Enables or disables event traps on the CMC.
1 (true)
0 (false)
None
Default
cfgAlertingFilterMask
Description
Legal Values
Default
Sets the event filter
Hex values 0x0 – 0x01ffffff
0x17ff8db
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
253
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgAlertingSourceEmailName
Description
E-mail address used to send e-mail notifications when an event
occurs.
Legal Values
Default
None
None
Examples
• racadm getconfig -g cfgAlerting -o
cfgAlertingEnable 1
• racadm config -g cfgAlerting -o cfgAlertingEnable
1
Object value modified successfully.
cfgServerPowerSupply
This group is applicable only for iDRAC6 and contains information related to
the power supplies. The following sections provide information about the
objects in the cfgServerPowerSupply group.
NOTE: The cfgServerPowerSupply object group is applicable only for iDRAC6 on
Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers.
NOTE: The getconfig subcommand always shows eight cfgServerPowerSupply
indexes, even if two power supplies are installed in the system or the system
supports a maximum of two power supply units. For the uninstalled and
unsupported units, all the objects in the cfgServerPowerSupply group displays a
value of 0.
cfgServerPowerSupplyIndex
Description
Legal Values
Default
Index of the power supply unit.
Integer from 1-8
None
NOTE: Indexes from 1 – 8 are supported to support up to 8 power supply units. If
any power supply unit is not present, cfgServerPowerSupplyOnlineStatus is absent
and for all the other properties, it is 0.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
254
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerSupplyMaxInputPower (Read Only)
Description
Legal Values
Default
Displays the AC input rated power in Watts.
A string of up to 32 characters.
0
cfgServerPowerSupplyMaxOutputPower (Read Only)
Description
Legal Values
Default
Displays the AC output rated power in Watts.
A string of up to 32 characters.
0
cfgServerPowerSupplyOnlineStatus (Read Only)
Description
Legal Values
Displays the status of the power supply unit.
• 0 - Present
• 1 - Absent
• 2 - Failure
• 3 - Predictive failure
0
Default
cfgServerPowerSupplyFwVer (Read Only)
Description
Legal Values
Default
Displays the firmware version of the power supply unit.
A string up to 8 characters.
Null
cfgServerPowerSupplyCurrentDraw (Read Only)
Description
Legal Values
Default
Displays the instantaneous current consumption in 0.1 Amps.
A string of up to 32 characters.
0
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
255
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgServerPowerSupplyType
Description
Legal Values
Default
Displays whether the power supply is AC or DC.
A string of up to 32 characters.
0
cfgIPv6LanNetworking
This group is used to configure the IPv6 over LAN networking capabilities.
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property for CMC, you must have Chassis Configuration
Administrator privilege.
NOTE: Use the -m option to apply this setting to iDRAC.
The following sections provides information about the objects in the
cfgIPv6LanNetworking group.
cfgIPv6Enable (Read/Write)
Description
Legal Values
Enables or disables iDRAC6 or CMC IPv6 stack.
1 (TRUE)
0 (FALSE)
0
Default
cfgIPv6Address
NOTE: This object is applicable only for CMC.
Description
Legal Values
Default
Assigns a static IPv6 address to the CMC. This property is used
only if cfgIPv6AutoConfig is set to 0 (false).
A string representing a valid IPv6 address. For example,
2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF
::
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
256
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIPv6Address1 (Read/Write)
Description
Legal Values
Default
iDRAC6 or CMC IPv6 address.
String representing a valid IPv6 entry.
::
cfgIPv6Gateway (Read/Write)
Description
iDRAC6 or CMC gateway IPv6 address.
NOTE: For CMC, this property is used only if cfgIPv6AutoConfig is set
to 0 (false)
Legal Values
Default
String representing a valid IPv6 entry.
::
cfgIPv6PrefixLength (Read/Write)
Description
The prefix length for iDRAC6 or CMC IPv6 address1.
NOTE: For CMC, this property is used only if cfgIPv6AutoConfig is set
to 0 (false)
Legal Values
Default
For iDRAC6: 1-128
For CMC: 0-128
64
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
257
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
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.
Legal Values
Default
1 (TRUE)
0 (FALSE)
For iDRAC6: 0
For CMC: 1
NOTE: The CMC uses its MAC address for its DUID (DUID-LL) when communicating
with a DHCPv6 server.
cfgIPv6LinkLocalAddress (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 link local address.
A string representing a valid IPv6 entry.
::
cfgIPv6Address2 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 second address.
A string representing a valid IPv6 entry.
::
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
258
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIPv6Address3 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 third address.
String representing a valid IPv6 entry.
::
cfgIPv6Address4 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 fourth address.
String representing a valid IPv6 entry.
::
cfgIPv6Address5 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 fifth address.
String representing a valid IPv6 entry.
::
cfgIPv6Address6 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 sixth address.
String representing a valid IPv6 entry.
::
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
259
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIPv6Address7 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 seventh address.
String representing a valid IPv6 entry.
::
cfgIPv6Address8 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 eighth address.
String representing a valid IPv6 entry.
::
cfgIPv6Address9 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 ninth address..
String representing a valid IPv6 entry.
::
cfgIPv6Address10 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 tenth address.
String representing a valid IPv6 entry.
::
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
260
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIPv6Address11 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 eleventh address.
String representing a valid IPv6 entry.
::
cfgIPv6Address12 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 twelfth address.
String representing a valid IPv6 entry.
::
cfgIPv6Address13 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 thirteenth address.
String representing a valid IPv6 entry.
::
cfgIPv6Address14 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 fourteenth address.
String representing a valid IPv6 entry.
::
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
261
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIPv6Address15 (Read Only)
NOTE: This object is applicable only for iDRAC6.
Description
Legal Values
Default
The iDRAC6 IPv6 fifteenth address.
String representing a valid IPv6 entry.
::
cfgIPv6DNSServersFromDHCP6 (Read/Write)
Description
Specifies whether cfgIPv6DNSServer1 and cfgIPv6DNSServer2 are
static or DHCP IPv6 addresses.
NOTE: For CMC, this property is used only if cfgIPv6AutoConfig is set
to 1 (true).
Legal Values
Default
1 (TRUE)
0 (FALSE)
For iDRAC6: 0
For CMC: 1
cfgIPv6DNSServer1 (Read/Write)
Description
An IPv6 DNS server address.
NOTE: For CMC, this property is used only if
cfgIPv6DNSServersFromDHCP6 is set to 0 (false).
Legal Values
Default
A string representing a valid IPv6 entry. For example,
2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF
::
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
262
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIPv6DNSServer2 (Read/Write)
Description
An IPv6 DNS server address.
NOTE: This property is only valid if cfgIPv6DNSServersFromDHCP6 is
set to 0 (false).
Legal Values
A string representing a valid IPv6 entry. For example,
2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF
::
Default
Example
$ racadm getconfig -g cfgIPv6LanNetworking [-m server-
<n>]
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. The order of preference for DNS servers is:
•
•
•
•
cfgIPv6DNSServer1
cfgIPv6DNSServer2
cfgDNSServer1
cfgDNSServer2
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
263
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgCurrentLanNetworking (Read only)
This group displays the current CMC NIC properties.
NOTE: This object property is applicable only for CMC. Use this object with the
getconfig subcommand.
NOTE: To use this object property, you must have CMC Login User privilege.
Synopsis
racadm getconfig -g cfgCurrentLanNetworking
cfgNicCurrentIpAddress
Displays the static IP address to the CMC.
cfgNicCurrentNetmask
Displays the static subnet mask for the CMC IP address.
cfgNicCurrentGateway
Displays the static gateway for the CMC IP address.
cfgNicCurrentDhcpWasUsed
Description
Indicates whether DHCP is used to configure the NIC.
Legal Values
0 – address is static.
1– address was obtained from the DHCP server.
None
Default
cfgDNSCurrentServer1
Displays the IP address for DNS server 1.
cfgDNSCurrentServer2
Displays the IP address for DNS server 2.
cfgDNSCurrentDomainName
Displays the DNS domain name.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
264
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNicCurrentIPv4Enabled
Indicates whether IPv4 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 IPv4.
Example
racadm getconfig -g cfgCurrentLanNetworking
# cfgNicCurrentIPv4Enabled=1
# 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
cfgCurrentIPv6LanNetworking (Read only)
This group displays the current CMC IPv6 properties.
NOTE: This object property is applicable only for CMC. Use this object with the
getconfig subcommand.
NOTE: To use this object property, you must have CMC Login User privilege.
cfgCurrentIPv6Enabled
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.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
265
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgCurrentIPv6AutoConfigWasUsed
Description
Indicates whether auto configuration is used to obtain IPv6
settings, including stateless IPv6 address(es) and gateway.
Legal Values
0 (static addressing is used)
1 (address is obtained from the DHCPv6 server and/or stateless
auto configuration)
Default
None
cfgCurrentLinkLocalAddress
Displays the current IPv6 link-local address of the CMC.
cfgCurrentIPv6Address1
Displays the current IPv6 addresses. This property displays up to 15 global
IPv6 addresses, including stateful and stateless addresses.
cfgCurrentIPv6Gateway
Displays the current IPv6 gateway.
cfgCurrentIPv6DNSServersFromDHCP6
Indicates whether the DNS server addresses are assigned from the DHCPv6
server.
cfgCurrentIPv6DNSServer1
Displays the IPv6 address for DNS server 1.
cfgCurrentIPv6DNSServer2
Displays the IPv6 address for DNS server 2.
Example
$ racadm getconfig -g cfgCurrentIPv6LanNetworking
# cfgCurrentIPv6Enabled=1
# cfgCurrentIPv6AutoConfigWasUsed=1
# cfgCurrentLinkLocalAddress=
fe80::21e:4fff:fe1f:5371/64
# cfgCurrentIPv6Address1=
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
266
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
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=::
cfgIPv6URL
This group specifies properties used to configure iDRAC6 IPv6 URL.
The following sections provides information about the objects in the
cfgIPv6URL group.
cfgIPv6URLstring (Read Only)
Description
Legal Values
Default
The iDRAC6 IPv6 URL.
A string of up to 80 characters.
<blank>
cfgIpmiSerial
This group is applicable only for iDRAC6 and specifies properties used to
configure the IPMI serial interface of the BMC.
NOTE: The cfgIpmiSerial object group is applicable only for iDRAC6 on Rack and
Tower Servers and not for iDRAC6 Enterprise on Blade Servers or CMC.
cfgIpmiSerialBaudRate (Read/Write)
Description
Legal Values
Default
Specifies the baud rate for a serial connection over IPMI.
9600, 19200, 57600, 115200
57600
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
267
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiSerialConnectionMode (Read/Write)
Description When the iDRAC6 cfgSerialConsoleEnable property is set to 0
(disabled), the iDRAC6 serial port becomes the IPMI serial port. This
property determines the IPMI defined mode of the serial port.
In Basic mode, the port uses binary data with the intent of
communicating with an application program on the serial client. In
Terminal mode, the port assumes that a dumb ASCII terminal is
connected and allows very simple commands to be entered.
Legal Values 0 (Terminal)
1 (Basic)
Default
1
cfgIpmiSerialChanPrivLimit (Read/Write)
Description
Legal Values
Specifies the maximum privilege level allowed on the IPMI serial
channel.
2 (User)
3 (Operator)
4 (Administrator)
4
Default
cfgIpmiSerialFlowControl (Read/Write)
Description
Legal Values
Specifies the flow control setting for the IPMI serial port.
0 (None)
1 (CTS/RTS)
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
268
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiSerialHandshakeControl (Read/Write)
Description
Legal Values
Enables or disables the IPMI terminal mode handshake control.
0 (FALSE)
1 (TRUE)
1
Default
cfgIpmiSerialLineEdit (Read/Write)
Description
Legal Values
Enables or disables line editing on the IPMI serial interface.
0 (FALSE)
1 (TRUE)
1
Default
cfgIpmiSerialEchoControl (Read/Write)
Description
Legal Values
Enables or disables echo control on the IPMI serial interface.
0 (FALSE)
1 (TRUE)
1
Default
cfgIpmiSerialDeleteControl (Read/Write)
Description
Legal Values
Enables or disables delete control on the IPMI serial interface.
0 (FALSE)
1 (TRUE)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
269
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgIpmiSerialNewLineSequence (Read/Write)
Description
Legal Values
Specifies the newline sequence specification for the IPMI serial
interface.
0 (None)
1 (CR-LF)
2 (NULL)
3 (<CR>)
4 (<LF-CR>)
5 (<LF>)
1
Default
cfgIpmiSerialInputNewLineSequence (Read/Write)
Description
Legal Values
Specifies the input newline sequence specification for the IPMI
serial interface.
1 (CR-LF)
2 (NULL)
1
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
270
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSmartCard
This group is applicable only for iDRAC6 and specifies properties used to
support access to iDRAC6 using a smart card.
The following sections provides information about the objects in the
cfgSmartCard group.
cfgSmartCardLogonEnable (Read/Write)
Description
Legal Values
Enables, disables, or enables with Remote RACADM support for
access to iDRAC6 using a smart card.
NOTE: Enabling with remote RACADM is only applicable for iDRAC6
on Rack and Tower Servers.
0 (Disabled)
1 (Enabled)
2 (Enabled with Remote RACADM) - This is not applicable for
iDRAC6 Enterprise on Blade Servers.
Default
0
cfgSmartCardCRLEnable (Read/Write)
NOTE: This object is applicable only for iDRAC6 on Rack and Tower Servers and
not for iDRAC6 Enterprise on Blade Servers.
Description
Legal Values
Enables or disables the Certificate Revocation List (CRL).
1 (TRUE)
0 (FALSE)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
271
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNetTuning
This group enables users to configure the advanced network interface
parameters for the RAC NIC or CMC. When configured, the updated
settings may take up to a minute to become active.
The following sections provides information about the objects in the
cfgNetTuning group.
NOTE: The cfgNetTuning object group is applicable only for iDRAC6 on Rack and
Tower Servers and not for iDRAC6 Enterprise on Blade Servers.
CAUTION: Use extra precaution when modifying properties in this group.
Inappropriate modification of the properties in this group can result in your RAC
NIC become inoperable.
cfgNetTuningNicSpeed
Description
Specifies the speed for the CMC NIC. This property is used only if
cfgNetTuningNicAutoNeg is set to 0 (disabled).
Legal Values
Default
10 or 100
100
cfgNetTuningNicAutoneg (Read/Write)
Description
Enables autonegotiation of physical link speed and duplex. If
enabled, autonegotiation takes priority over values set in the
cfgNetTuningNic100MB and cfgNetTuningNicFullDuplex
objects.
Legal Values
1 (TRUE)
0 (FALSE)
1
Default
Example
racadm getconfig -g cfgNetTuning
cfgNetTuningNicSpeed=100
cfgNetTuningNicFullDuplex=1
cfgNetTuningNicMtu=1500
cfgNetTuningNicAutoneg=1
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
272
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgNetTuningNic100MB (Read/Write)
Description
Legal Values
Specifies the speed to use for the RAC NIC. This property is not
used if the cfgNetTuningNicAutoNeg is set to 1 (enabled).
0 (10 MBit)
1 (100 MBit)
1
Default
cfgNetTuningNicFullDuplex (Read/Write)
Description
Specifies the duplex setting for the RAC or CMC NIC. This
property is used only if the cfgNetTuningNicAutoNeg is set to 0
(disabled).
Legal Values
Default
0 (Half Duplex)
1 (Full Duplex)
1
cfgNetTuningNicMtu (Read/Write)
Description
The size in bytes of the maximum transmission unit used by
iDRAC6 or CMC NIC.
Legal Values
Default
576 – 1500
1500
NOTE: IPv6 requires a minimum MTU of 1280. If IPv6 is enabled, and
cfgNetTuningMtu is set to a lower value, the CMC uses an MTU of 1280.
cfgSensorRedundancy
This group is applicable only for iDRAC6 and is used to set the power supply
redundancy.
The following sections provides information about the objects in the
cfgSensorRedundancy group.
NOTE: The cfgSensorRedundancy object group is applicable only for iDRAC6 on
Rack and Tower Servers and not for iDRAC6 Enterprise on Blade Servers.
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
273
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSensorRedundancyIndex (Read Only)
Description
Index for the sensor redundancy group being read. Only power
supply redundancy is supported.
Legal Values
Default
1
None
cfgSensorRedundancyPolicy (Read/Write)
Description
Legal Values
Sets the power supply redundancy policy.
2 - N/A, for sytems that are not supported
3 - Non Redundant
4 - 1+1 Redundant
4 - 2+1 Redundant
16 - 2+2 Redundant
Default
Any legal value at that particular execution instance.
cfgSensorRedundancyCapabilities (Read Only)
Description
Returns the redundancy capabilities in the form of a bitmask. This
bitmask allows the user to know which values can be set for
cfgSensorRedundancyPolicy.
Legal Values
A bit mask. More than 1-bit can be set at a time to indicate
multiple redundancy support.
0- N/A, for sytems that are not supported
1- Non Redundant
2- 1+1 - Redundant
4- 2+1 - Redundant
8- 2+2 - Redundant
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
274
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgSensorRedundancyStatus (Read Only)
Description
Legal Values
Indicates the redundancy status. The status is N/A on platforms
that does not support the power supply sensor redundancy.
String:
• N/A
• Full
• Lost
• Degraded
None
Default
cfgVFlashSD
This group is applicable only for iDRAC6 and is used to configure the
properties for the vFlash SD card.
The following sections provides information about the objects in the
cfgVFlashSD group.
cfgVFlashSDEnable (Read/Write)
Description
Legal Values
Enables or disables the vFlash SD card.
0 (vFlash is disabled)
1 (vFlash is enabled)
1
Default
cfgVFlashSDSize (Read Only)
Description
Legal Values
Default
Displays the size of the vFlash SD card in megabytes (MB).
A string of upto 64 characters.
<card size>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
275
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgVFlashSDLicensed (Read Only)
Description
Displays whether a SD card or vFlash SD card is inserted. The
vFlash SD card supports the new enhanced vFlash features and the
SD card supports only the limited vFlash features.
Legal Values
Default
0 (SD card is inserted)
1 (vFlash SD card is inserted)
None
cfgVFlashSDAvailableSize (Read Only)
Description
Displays the available space (in MB) on the vFlash SD card that can
be used to create new partitions.
Legal Values
Default
A string of up to 64 characters.
If the card is not initialized, default is 0. If initialized, displays the
unused space on the card.
cfgVFlashSDHealth (Read Only)
Description
Legal Values
Displays the current health status of the vFlash SD card.
String:
• OK
• Warning
• Critical
• Unknown
OK
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
276
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgVFlashSDWriteProtect (Read Only)
Description
Legal Values
Displays whether the physical write-protect latch on the vFlash SD
card is enabled or disabled.
0 (vFlash is not write-protected)
1 (vFlash is write-protected)
None
Default
cfgVFlashPartition
This group is applicable only for iDRAC6 and is used to configure properties
for individual partitions on the vFlash SD Card. Up to 16 partitions are
supported, indexed from 1 to 16.
NOTE: For SD cards, the index value is limited to 1 because only a single partition
of size 256 MB is allowed.
The following sections provides information about the objects in the
cfgVFlashPartition group.
cfgVFlashPartitionIndex (ReadOnly)
Description
Legal Values
Default
Displays the size of the partition.
Integer from 1-16
None
cfgVFlashPartitionSize (ReadOnly)
Description
Legal Values
Default
The index value of the partition.
1MB to 4 GB
None
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
277
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgVFlashPartitionEmulationType (ReadWrite)
Description
Legal Values
Displays the emulation type for the partition.
String:
• HDD
• Floppy
• CDROM
None
Default
cfgVFlashPartitionOSVolLabel (ReadOnly)
Description
Displays the label for the partition that is visible to the operating
system.
Legal Values
Default
An alphanumeric string of up to six characters.
None
cfgVFlashPartitionFormatType (ReadOnly)
Description
Legal Values
Displays the format type of the partition.
String:
• FAT16
• FAT32
• EXT2
• EXT3
• CD
• RAW
None
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
278
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgVFlashPartitionAccessType (Read/Write)
Description
Legal Values
Indicates the partition access permissions. It configures the access
type to read-write.
0(Read-only)
1(Read-write)
0
Default
cfgVFlashPartitionAttachState (Read/Write)
Description
Legal Values
Displays whether the partition is attached or detached.
1 (Attached)
0 (Detached)
0
Default
cfgLogging
This group is applicable only for iDRAC6 and contains parameters to enable
or disable the OEM event log filtering.
The following section provides information about the objects in the
cfgLogging group:
cfgLoggingSELOEMEventFilterEnable (Read/Write)
Description
Legal Values
Enables or disables the SEL Log filtering.
0 (SEL Log filtering is Disabled)
1 (SEL Log filtering is Enabled)
0
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
279
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgKMSProfile
NOTE: This current release does not support this group.
This group is applicable only for iDRAC6 and is an indexed group which
currently only supports two indices, since iDRAC only communicates with
any one of the two KMSs using their specific profile information.
NOTE: This group is also configurable using the -f option and follows the read only
value of cfgKMSProfileIndex as the anchor value for the indexed group.
The following section provides information about the objects in the
cfgKMSProfile group:
cfgKMSProfileIndex(Read only)
Description
Legal Values
Index of the profile
1
2
Default
None
cfgKMSProfileIPAddress(Read/Write)
Description
Legal Values
Default
IP address/FQDN of the KMS
IPv4, IPv6, FQDN
0.0.0.0
cfgKMSProfilePortNumber(Read/Write)
Description
Port number indicates the port on which the Key management
server is listening to. For KMC to communicate to the KMS, one
needs to configure the same port number as on the KMS.
Legal Values
Default
1 to 65535
443
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
280
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgKMSProfileTimeout(Read/Write)
Description
The timeout value indicates the keep-alive time for the KMC-KMS
connection.
Legal Values
Default
15 to 600 seconds
300 seconds
cfgKMSProfileDeviceGroup(Read/Write)
Description
Device group indicates the group on the KMS to which the device
will belong to. The Device group on the KMS is a configurable
string, which must be provided to the KMC for it to retrieve the
keys.
Legal Values
Default
AlphaNumeric character values with only underscore as special
character.
Poweredge
cfgRacSecurity
NOTE: Use this object with the config or getconfig subcommands.
NOTE: To use this object property, you must have Chassis Configuration
Administrator privilege. This object property is specific to CMC only.
NOTE: For iDRAC6 this group is replaced with cfgRacSecrityData.
This group is used to configure settings related to CMC SSL certificate
signing request (CSR) feature. The properties in this group must be
configured before generating a CSR from CMC.
For more information on generating certificate signing requests, see the
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
281
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
The following sections provides information about the objects in the
cfgRacSecurity group.
cfgRacSecCsrCommonName (Read/Write)
Description
Specifies the CSR Common Name (CN) that must be an IP or
CMC name as given in the certificate.
Legal Values
Default
A string of up to 254 characters.
<blank>
cfgRacSecCsrOrganizationName (Read/Write)
Description
Legal Values
Default
Specifies the CSR Organization Name (O).
A string of up to 254 characters.
<blank>
cfgRacSecCsrOrganizationUnit (Read/Write)
Description
Legal Values
Default
Specifies the CSR Organization Unit (OU).
A string of up to 254 characters.
<blank>
cfgRacSecCsrLocalityName (Read/Write)
Description
Legal Values
Default
Specifies the CSR Loyalty (L).
A string of up to 254 characters.
<blank>
cfgRacSecCsrStateName (Read/Write)
Description
Legal Values
Default
Specifies the CSR State Name (S).
A string of up to 254 characters.
<blank>
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
282
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacSecCsrCountryCode (Read/Write)
Description
Legal Values
Default
Specifies the CSR Country Code (CC).
A string of up to 2 characters.
<blank>
cfgRacSecCsrEmailAddr (Read/Write)
Description
Legal Values
Default
Specifies the CSR email address.
A string of up to 254 characters.
<blank>
Example
racadm config -g cfgRacSecurity
cfgRacSecCsrKeySize=1024
cfgRacSecCommonName=
cfgRacSecOrganizationName=
cfgRacSecOrganizationUnit=
cfgRacSecLocalityName=
cfgRacSecStateName=
cfgRacSecCountryCode=
cfgRacSecEmailAddr=
cfgRacSecCsrKeySize (Read/Write)
Description
Legal Values
Default
Specifies the SSL asymmetric key size for the CSRs.
512, 1024, 2048
1024
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
283
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacSecurityData
NOTE: This object property is specific to iDRAC6 only.
This group is used to configure settings related to iDRAC6 SSL certificate
signing request (CSR) feature and KMC certificate signing request feature.
The properties in this group must be configured before generating a CSR
from iDRAC6. This is an indexed group which currently only supports two
indices.
NOTE: This second index is not supported for this release.
For more information on generating certificate signing requests, see the
subcommand "sslkeyupload" on page 133.
The following sections provides information about the objects in the
cfgRacSecurityData group:
cfgRacSecCsrIndex
Description
Legal Values
Specifies the CSR index
1 = Server certificate
2 = KMS certificate
<blank>
Default
cfgRacSecCsrKeySize
Description
Legal Values
Default
Specifies the keysize of the CSR
1024, 2048
1024
cfgRacSecCsrCommonName (Read/Write)
Description
Specifies the CSR Common Name (CN) that must be an IP or
iDRAC or CMC name as given in the certificate.
A string of up to 254 characters.
<blank>
Legal Values
Default
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
284
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacSecCsrOrganizationName (Read/Write)
Description
Legal Values
Default
Specifies the CSR Organization Name (O).
A string of up to 254 characters.
<blank>
cfgRacSecCsrOrganizationUnit (Read/Write)
Description
Legal Values
Default
Specifies the CSR Organization Unit (OU).
A string of up to 254 characters.
<blank>
cfgRacSecCsrLocalityName (Read/Write)
Description
Legal Values
Default
Specifies the CSR Loyalty (L).
A string of up to 254 characters.
<blank>
cfgRacSecCsrStateName
Description
Legal Values
Default
Specifies the CSR State Name (S).
A string of up to 254 characters.
<blank>
cfgRacSecCsrCountryCode
Description
Legal Values
Default
Specifies the CSR Country Code (CC).
A string of up to 254 characters.
US
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
285
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
cfgRacSecCsrEmailAddr
Description
Legal Values
Default
Specifies the CSR email address.
A string of up to 254 characters.
<blank>
Example
racadm getconfig -g cfgRacSecurityData -i 1
#cfgRacSecCsrIndex=1
cfgRacSecCsrKeySize=1024
cfgRacSecCsrCommonName=iDRAC_10.35.1105.10
cfgRacSecCsrOrganizationName=OrgName
cfgRacSecCsrOrganizationUnit=OrgUnit
cfgRacSecCsrLocalityName=LocalityName
cfgRacSecCsrStateName=TX
cfgRacSecCsrCountryCode=US
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
286
iDRAC6 and CMC Property Database Group and Object Descriptions
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
iDRAC6 and CMC Property Database Group and Object Descriptions
287
FILE LOCATION:
C:\Working\ProjectDocs\Program_Releases\iDRAC6\iDRAC6_1.95_3.5\RACADM\Source\rac
DELL CONFIDENTIAL – PRELIMINARY 3/26/13 - FOR PROOF ONLY
288
iDRAC6 and CMC Property Database Group and Object Descriptions
4
Deprecated Commands, Groups,
and Objects
This section provides information about the deprecated RACADM
subcommands, groups, and objects in the current release. Few commands,
groups, or objects are deprecated in RACADM either due to a new command
or object replacing the functionality of an existing command or object, or the
feature is no longer supported.
For the deprecated command or object:
•
If you run the racadm helpcommand, the deprecated command is not
displayed in the command list.
•
If you run the racadm help <deprecated command name>, then
the following information is displayed:
ATTENTION: <command name> is a deprecated command!
While execution of this command will still be
successful we strongly encourage you to use the
new functionality.
The functionality of this command is now covered
by <list of new functionality>.
Type “racadm help <new command name>” to learn
more.
NOTE: This information is displayed only for iDRAC6 on Rack and Tower servers
and is not displayed for iDRAC6 Enterprise on Blade servers.
•
•
If you run a deprecated command, it works if the feature is supported. If
the feature is not supported, an error is not returned.
If you run the racadm getconfig –hcommand, the deprecated
group is not displayed in the results.
Deprecated Commands, Groups, and Objects
289
•
•
If you query a deprecated group or object, then the values are returned.
If you try to configure a deprecated group or object, the configuration
succeeds.
•
If you request a group that contains a deprecated object, the deprecated
object is not displayed in the results.
Table 4-1. RACADM Deprecated Subcommands
Subcommand
Replaced With
vmkey reset
vflashsd initialize
-
testkmsconnectivity
release.
Table 4-2. RACADM Deprecated Groups and Objects
Group/Object
Replaced With
cfgVirMediaKeyEnable
cfgSDWriteProtect
290
Deprecated Commands, Groups, and Objects
S
slot names
SNMP
U
292
Index
|