Dell Openmanage Deployment Toolkit Version 4 2 Quick Reference Guide 4.2 Command Line Interface

2014-11-13

: Dell Dell-Openmanage-Deployment-Toolkit-Version-4-2-Quick-Reference-Guide-117769 dell-openmanage-deployment-toolkit-version-4-2-quick-reference-guide-117769 dell pdf

Open the PDF directly: View PDF .
Page Count: 177

Download
Open PDF In Browser	View PDF

Dell OpenManage Deployment Toolkit Version 4.2
Command Line Interface Reference Guide

Notes, Cautions, and Warnings
NOTE: A NOTE indicates important information that helps you make better use of your computer.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the
problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.

© 2012 Dell Inc.
Trademarks used in this text: Dell™, the Dell logo, Dell Boomi™, Dell Precision™ , OptiPlex™, Latitude™, PowerEdge™, PowerVault™,
PowerConnect™, OpenManage™, EqualLogic™, Compellent™, KACE™, FlexAddress™, Force10™ and Vostro™ are trademarks of Dell
Inc. Intel®, Pentium®, Xeon®, Core® and Celeron® are registered trademarks of Intel Corporation in the U.S. and other countries. AMD®
is a registered trademark and AMD Opteron™, AMD Phenom™ and AMD Sempron™ are trademarks of Advanced Micro Devices, Inc.
Microsoft®, Windows®, Windows Server®, Internet Explorer®, MS-DOS®, Windows Vista® and Active Directory® are either trademarks
or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat® and Red Hat®
Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell® and SUSE® are
registered trademarks of Novell Inc. in the United States and other countries. Oracle® is a registered trademark of Oracle Corporation
and/or its affiliates. Citrix®, Xen®, XenServer® and XenMotion® are either registered trademarks or trademarks of Citrix Systems, Inc. in
the United States and/or other countries. VMware®, Virtual SMP®, vMotion®, vCenter® and vSphere® are registered trademarks or
trademarks of VMware, Inc. in the United States or other countries. IBM® is a registered trademark of International Business Machines
Corporation.
2012 - 12
Rev. A00

Contents
Notes, Cautions, and Warnings...................................................................................................2
1 Introduction..................................................................................................................................7
What's New In This Release....................................................................................................................................7
Supported Systems...................................................................................................................................................8
Supported Operating Systems..................................................................................................................................8
Toolkit Utilities..........................................................................................................................................................9
System Configuration Utility...............................................................................................................................9
RAID Configuration Utility...................................................................................................................................9
RAC Configuration Utility....................................................................................................................................9
Disk Partitioning Utility.......................................................................................................................................9
Replication Of DTK Utilities.......................................................................................................................................9
File Format..........................................................................................................................................................9
SYSCFG Replication Rules..................................................................................................................................9
RAID Replication..............................................................................................................................................10
RACADM Replication.......................................................................................................................................10
Other Documents You May Need...........................................................................................................................10
Contacting Dell.......................................................................................................................................................11

2 Command Syntax Overview.....................................................................................................13
DTK Utilities General Usage...................................................................................................................................13
Command Line Syntax............................................................................................................................................13
Case Sensitivity.......................................................................................................................................................14
Command Line Option Delimiters............................................................................................................................14
Other Delimiters......................................................................................................................................................15
Read And Write Commands....................................................................................................................................16
File Input And Output Commands...........................................................................................................................16
Log Files..................................................................................................................................................................16
Help Option.............................................................................................................................................................17
Error Checking And Error Messages......................................................................................................................17

3 SYSCFG.......................................................................................................................................19
Features..................................................................................................................................................................19
SYSCFG General Options........................................................................................................................................19
No Option..........................................................................................................................................................19
--envar..............................................................................................................................................................20
-h or --help........................................................................................................................................................20

-i or --infile........................................................................................................................................................21
--ix or --inxmlfile...............................................................................................................................................21
-l or --logfile......................................................................................................................................................22
-o or --outfile....................................................................................................................................................22
--ox or --outxmlfile............................................................................................................................................23
--px or --pendingxmlfile....................................................................................................................................23
-s.......................................................................................................................................................................23
--version*.........................................................................................................................................................24
SYSCFG For BIOS Configuration.............................................................................................................................24
SYSCFG Options On PowerEdge Systems Prior To PowerEdge 12G Systems.................................................24
Sub Options And Arguments For tpm Option....................................................................................................59
Sub Options And Arguments For tcm Option....................................................................................................61
Sub Options And Arguments For power Option...............................................................................................62
SYSCFG Options On PowerEdge 12G Systems.................................................................................................63
SYSCFG For BMC And Remote Access Controller Configuration...........................................................................78
BMC And Remote Access Controller Configuration Options...........................................................................78
clearsel*...........................................................................................................................................................78
controlpanelaccess..........................................................................................................................................79
deviceguid*......................................................................................................................................................79
encryptkey........................................................................................................................................................79
identify..............................................................................................................................................................80
idracversion......................................................................................................................................................80
kvmstatusonlcd................................................................................................................................................80
lancfgparams...................................................................................................................................................81
lanchannelaccess............................................................................................................................................84
lanchannelinfo..................................................................................................................................................85
lanuseraccess..................................................................................................................................................85
loaddefaults*....................................................................................................................................................86
nextboot............................................................................................................................................................86
nmibutton..........................................................................................................................................................87
passwordaction................................................................................................................................................88
pefcfgparams...................................................................................................................................................89
powerbutton.....................................................................................................................................................90
powerctl...........................................................................................................................................................91
racreset*..........................................................................................................................................................91
serialcfgparams...............................................................................................................................................92
serialchannelaccess........................................................................................................................................93
serialchannelinfo..............................................................................................................................................94
serialuseraccess..............................................................................................................................................94
solaction...........................................................................................................................................................96
solcfgparams....................................................................................................................................................96
ssninfo..............................................................................................................................................................98

useraction........................................................................................................................................................98
username..........................................................................................................................................................99
version*..........................................................................................................................................................100
virutualmedia..................................................................................................................................................100
SYSCFG For State Configuration...........................................................................................................................100
SYSCFG Options For State Configuration.......................................................................................................100
SYSCFG for System Configuration........................................................................................................................101
Options For System Configuration..................................................................................................................101
SYSCFG For IPv6 Configuration............................................................................................................................106
PCI Reporting........................................................................................................................................................107
Environment Variable File...............................................................................................................................107

4 RAIDCFG...................................................................................................................................109
Features................................................................................................................................................................109
Supported RAID Controllers.................................................................................................................................109
RAIDCFG Dependencies.......................................................................................................................................109
RAIDCFG Options And Arguments........................................................................................................................110
RAID Configuration Utility Options And Arguments..............................................................................................115
General Help...................................................................................................................................................115
Enumerating RAID Controllers.......................................................................................................................116
Creating Virtual Disks.....................................................................................................................................117
Enumerating Array Disks................................................................................................................................123
Blinking And Unblinking Array Disks..............................................................................................................126
Enumerating Virtual Disks..............................................................................................................................126
Deleting Virtual Disks.....................................................................................................................................128
Setting A Virtual Disk As Bootable Virtual Disk.............................................................................................128
Blinking And Unblinking Virtual Disks............................................................................................................129
Setting Virtual Disk Name..............................................................................................................................129
Setting Environment Variables.......................................................................................................................130
RAID Replication Options...............................................................................................................................132
Assigning, Unassigning, And Listing Global Hot Spares................................................................................133
Importing And Clearing Foreign Configurations.............................................................................................134
Initializing Virtual Disks..................................................................................................................................134
Resetting The Controller.................................................................................................................................135
Enabling And Disabling Persistent Dedicated Hot Spares.............................................................................135
Miscellaneous Options...................................................................................................................................136
Quick Reference To RAIDCFG Commands............................................................................................................137

5 UPINIT.......................................................................................................................................139
Features................................................................................................................................................................139
Creating A Partition Using UPINIT........................................................................................................................139
UPINIT Dependencies..........................................................................................................................................139

UPINIT Options And Arguments...........................................................................................................................140

6 Messages And Codes.............................................................................................................143
SYSCFG Error Codes And Messages....................................................................................................................143
Failure Messages...........................................................................................................................................143
Failures And Solutions....................................................................................................................................151
UPINIT Common Error Codes And Messages......................................................................................................151
Failure Messages...........................................................................................................................................151
UPINIT Linux-Specific Error Codes And Messages.............................................................................................152
UPINIT Windows PE-Specific Error Codes And Messages.................................................................................152
RAIDCFG Error Codes And Messages..................................................................................................................152
Failure Messages...........................................................................................................................................152
RACADM Firmware Error Codes And Messages.................................................................................................161
RACADM Utility Error Codes And Messages........................................................................................................163

7 BMC Platform Events Filter Alert Messages......................................................................165
8 Sample File Formats................................................................................................................167
Sample SYSCFG Utility .ini File Format..................................................................................................................167
Sample RAIDCFG Utility .ini File Format................................................................................................................175
Sample RACADM Utility .ini File Format...............................................................................................................175

Introduction

Dell OpenManage Deployment Toolkit (DTK) includes a set of utilities, sample scripts, and sample configuration files to
deploy and configure your Dell system. You can use DTK to build script-based and RPM-based installation for deploying
a large number of systems reliably, without changing their current deployment processes. You can use DTK in a
Microsoft Windows Preinstallation Environment (Windows PE) or a Linux environment.

What's New In This Release
•

•

Using DTK utilities you can deploy the following operating systems:
–

Red Hat Enterprise Linux 6.3 (64-bit)

–

Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)

–

SUSE Linux Enterprise Server 11 SP2 (64-bit)

–

SUSE Linux Enterprise Server 10 SP4 (64-bit)

–

Windows Server 2012 (64–bit)

You can install DTK Linux RPM utilities on the following operating systems:
–

Red Hat Enterprise Linux 6.3 (64-bit)

–

Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)

–

SUSE Linux Enterprise Server 11 SP2 (64-bit)

–

SUSE Linux Enterprise Server 10 SP4 (64-bit)

Support for Windows PE 4.0 (64-bit) for deploying Windows Server 2012 using W2K12INST.BAT script.
NOTE: For more information, see Dell OpenManage Deployment Toolkit User's Guide available at dell.com/
support/manuals.

•

DTK tool support for Embedded Linux ISO image (64-bit).

•

Improved syscfgperformance on Dell Power Edge yx2x (12G) systems and reduction in server provisioning time.

•

Syscfg supports the following:

•

–

Fully Qualified Domain Name (FQDN) as SNMP trap destination. For more information, see
lancfgparams.

–

BIOS configuration using XML file on Dell PowerEdge 12G systems. For more information, see --ix, --ox,
and --px.

Raidcfg supports the following:
–

•

Blinking and unblinking virtual disks and array disks. For more information, see Blinking And Unblinking
Virtual Disks and Blinking And Unblinking Array Disks.

–

Enumerating virtual disk. For more information, see Enumerating Virtual Disks.

–

Setting a virtual disk as bootable device. For more information, see Setting A Virtual Disk As Bootable
Virtual Disk.

–

Setting virtual disk name. For more information, see Setting Virtual Disk Name.

–

Listing global hot spares. For more information, see Assigning, Unassigning, And Listing Global Hot
Spares.

Support for BIOS and RAID configurations in the following Dell PowerVault Network Attached Servers (NAS) :

•

–

NX3000

–

NX3100

–

NX300

–

NX200

–

NX3300

–

NX3200

–

NX400

Support for creating and reporting RAID in following Dell PowerVault enclosures:
–

MD1000

–

MD1200

–

MD1220

Deprecated support for the following operating systems:
–

Windows PE 2.0 (32-bit and 64-bit)

–

Red Hat Enterprise Linux 6.2

Supported Systems
For a complete list of supported Dell PowerEdge systems, see the Dell Systems Software Support Matrix available at
dell.com/support/manuals. On the Manuals page, click Software→ Systems Management→ Dell OpenManage
Releases. Click the appropriate product version to access the Support Matrix.

Supported Operating Systems
For Windows, the DTK utilities support Windows PE 3.0 (32-bit and 64-bit) and Windows PE 4.0. Using the DTK utilities,
we can deploy the following Windows operating systems:
•

Microsoft Windows Server 2012 (64–bit)

•

Windows Server 2008 SP2 (32-bit and 64-bit)

•

Windows Server 2008 R2 SP1

For Linux, the DTK utilities support the following operating systems:
•

Red Hat Enterprise Linux 6.3 (64-bit)

•

Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)

•

SUSE Enterprise Linux 11 SP2 (64-bit)

•

SUSE Enterprise Linux 10 SP4 (64-bit)

You can install DTK Linux RPM utilities on the following operating systems:
•

Red Hat Enterprise Linux 6.3 (64-bit)

•

Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)

•

SUSE Enterprise Linux 11 SP2 (64-bit)

•

SUSE Enterprise Linux 10 SP4 (64-bit)
NOTE: The RPMs are available in the RPMs folder of DTK ELI ISO and also at linux.us.dell.com/repo/hardware/
OMSA_7.1.1/.

Toolkit Utilities
DTK contains utilities that allow you to configure the BIOS, Baseboard Management Controller (BMC), Remote Access
Controller (RAC), RAID controllers, and hard-drive partitions on supported Dell systems. Additionally, the utilities can be
integrated with the sample files provided with the toolkit to fully configure one-to-many target systems in a scripted
mass system deployment.
NOTE: In a Linux environment, the DTK utilities do not have the .exe extension.

System Configuration Utility
The SYSCFG utility performs the following tasks:
•
•
•
•

Reports and sets BIOS configuration options.
Reports and sets BMC/RAC configuration options.
Reports and sets user-configurable states.
Reports system information, including PCI device detection.

RAID Configuration Utility
The RAIDCFG utility reports and sets RAID configuration options.

RAC Configuration Utility
The RACADM utility reports and sets RAC configuration options for Dell Remote Access Controller DRAC 5, iDRAC6, and
iDRAC7.

Disk Partitioning Utility
The UPINIT script creates, formats, and populates a Dell Utility Partition.

Replication Of DTK Utilities
This section explains the replication of DTK utilities.

File Format
The -i and -o options use the .ini file format for system configuration (SYSCFG) options. All name/value entries that follow
the [syscfg] section header in the .ini file belong to the SYSCFG utility. For an example of the syscfg.ini file, see
Sample SYSCFG Utility .ini File Format.

SYSCFG Replication Rules
Not all BIOS and BMC options can be replicated using the .ini file. For example, boot sequence and device sequence are
only replicated if a device name list can be supplied. A numerical device list cannot be replicated since the index values
can change from system to system. In addition, because the service tag information is static, it is not commented out in
the output file or replicated. See the description of each option for further replication information.

The syscfg.ini file cannot be used across different systems. The file output operation places system identification
information at the beginning of the [syscfg] section. This information is used to determine if the file can be accepted
as input for a system. The following information is used for system identification:
•

System ID Byte(s)

•

System Name

•

BIOS Version

If these values do not match the values found on the system, the file input operation fails.
The following is the SYSCFG behavior during replication:
•

Options not available in SYSCFG are termed invalid options. If SYSCFG encounters an invalid option in the
syscfg.ini file, the SYSCFG utility terminates.

•

Unsupported options are options available in SYSCFG but not applicable on certain systems. If SYSCFG
encounters an unsupported option, SYSCFG logs this option and continues to the next option.

•

Unsupported arguments are arguments valid in SYSCFG but not applicable on certain systems. If SYSCFG
encounters an unsupported argument, SYSCFG terminates.
For example, the command syscfg –-embsataraid=ahci is not applicable on some PowerEdge x9xx
series systems.

•

SYSCFG logs a message in the log file for each option processed in the syscfg.ini file. To generate the log file,
use the logfile option.

RAID Replication
The RAID replication feature reads the RAID configuration information from the source system and creates a raid.ini file.
This raid.ini file can be applied to the RAID configurations of the target system. The RAID replication requires both, the
source system and the target system to have similar RAID controllers.

RACADM Replication
The RACREP.BAT sample script applies RAC configuration options to the target system based on the configuration
information that has been saved in a configuration file. User input is optional, depending on variables set in the
RACREP.BAT sample script. This script uses the RACADM.EXE utility to configure the RAC in the target system using the
RAC configuration file, raccfg.ini. The raccfg.ini configuration file is passed as the first parameter to the RACREP.BAT
script. If this parameter is not passed, the default variable values used in this script are set in the TKENVSET.BAT
scripts. An optional second parameter can be passed to this file, which specifies the IP address used in configuring the
RAC. The raccfg.ini file is generated with the RACCAP.BAT sample script.

Other Documents You May Need
In addition to this guide, you can access the following guides available at dell.com/support/manuals . On the Manuals
page, click dell.com/support/manuals → Product Type → Software, Monitors, Electronics & Peripherals → Software →
Enterprise System Management . Click on the appropriate product link on the right-side to access the documents.

•

The Dell OpenManage Deployment Toolkit Quick Installation Guide provides information about installing and
deploying DTK on supported Dell systems. The guide is available as part of the DTK download and at
support.dell.com.

•

The Dell OpenManage Deployment Toolkit User's Guide provides best practice procedures that focus on the
basic tasks for successful deployment of Dell systems.

•

The Dell Systems Software Support Matrix provides information about the various Dell systems, the operating
systems supported by these systems, and the Dell OpenManage components that can be installed on
these systems.

•

The Dell OpenManage Installation and Security User's Guide provides additional information about performing
an unattended installation of Dell OpenManage Server Administrator on systems running supported Windows,
Red Hat Enterprise Linux, and SUSE Linux Enterprise Server operating systems.

•

The Dell OpenManage Server Administrator User's Guide provides information on using Server Administrator on
supported operating systems.

•

The Dell Update Packages User's Guide provides information about obtaining and using Dell Update Packages
as part of your system update strategy.

•

The Dell OpenManage Sever Administrator Storage Management User’s Guide provides information about RAID
controllers.

•

The Command Line Reference Guide for iDRAC6 and CMC provides information about the RACADM
subcommands, supported interfaces, property database groups and object definitions for iDRAC6 and CMC.

•

The Integrated Dell Remote Access Controller 7 (iDRAC7) User's Guide provides information about configuring
and using iDRAC7 for 12G rack, tower, and blade servers to remotely manage and monitor your system and its
shared resources through a network.

•

The Integrated Dell Remote Access Controller 6 (iDRAC6) Enterprise for Blade Servers User Guide provides
information about configuring and using an iDRAC6 for yx1x (11G) 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 yx1x tower and rack servers to remotely manage and monitor your system
and its shared resources through a network.

•

The Glossary provides information about the terms used in this document.

•

The Deployment Toolkit readme files (for Windows PE and embedded Linux) which is available as part of the
DTK download at support.dell.com, provides the latest available information about the installation and operation
of the DTK components and the list of PowerEdge systems supported for this version of DTK.

Contacting Dell
NOTE: If you do not have an active Internet connection, you can find contact information on your purchase invoice,
packing slip, bill, or Dell product catalog.
Dell provides several online and telephone-based support and service options. Availability varies by country and
product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer
service issues:
1.

Visit support.dell.com .

Select your support category.

If you are not a U.S customer, select your country code at the bottom of the page, or select All to see more choices.

Select the appropriate service or support link based on your need.

Command Syntax Overview

Syntax refers to the way a command and its parameters are entered. Dell OpenManage Deployment Toolkit (DTK)
Command Line Interface (CLI) commands can be arranged in any order as long as they conform to the basic command
line syntax.

DTK Utilities General Usage
The following table lists the general usage models of the DTK utilities:
Table 1. DTK Utilities

Utilities

Usage

SYSCFG

syscfg --option1=[arg1] ... --optionX=[argX]
or
syscfg bmcoption1 --bmcsuboption1=[arg1]...-bmcsuboptionX=argX]

RAIDCFG

raidcfg [mandatory options]

RACADM

racadm
NOTE: The Command Line Reference Guide for iDRAC6 and CMC
available on dell.com/support/manuals provides information about the
RACADM subcommands, supported interfaces, property database
groups and object definitions for iDRAC6 and CMC.

UPINIT

For WinPE:
upinit --disk=0 --size=32 --file=t:\upimage.bin
For Linux:
upinit --disk=/dev/sda --size=32 --file=/tmp/
upimage.bin

The DTK command line switches, configuration file formatting, and error reporting follow similar style and behavior.
However, individual DTK utilities can sometimes differ from one another in significant ways. You must familiarize
yourself with the command line syntax and utility-specific options and arguments for each utility before using DTK.
NOTE: Some of the command line options in DTK are followed by an asterisk. Such options are used for reporting
purposes only.

Command Line Syntax
The following table lists the generic command line characters and arguments present in the command line options with
a short description of these characters.

Table 2. Command Line Options

Element

Description

Prefix single character options.
NOTE: This delimiter is not applicable to Baseboard Management
Controller (BMC) sub-options.

Prefix multi-character options.

utilname

Indicates the generic designation for a DTK utility name.

Indicates the generic single-character designation for an option.

optionX

Indicates the generic multi-character designation for a utility name, where
you can use X to distinguish multiple options used in the same command
line instance.

argX

Indicates the generic designation for an argument, where you can use X to
distinguish multiple arguments used in the same command line instance.

[mandatory option]

Indicates the generic designation for a mandatory argument.

Indicates the generic designation for an optional argument.

Indicates the generic designation for a string.

Indicates the generic designation for a filename.

[ ]

Indicates a component of the command line. Enter only the information
within the brackets and exclude the brackets.

...

Indicates that the previous argument can be repeated several times in a
command. Enter only the information within the ellipses and exclude the
ellipses.

Separates two mutually exclusive choices in a syntax line. For example:
usb: Turns the usb controller on or off
Argument: enable | disable | legacy
Enter only one choice: --usb=enable, --usb=
disable, or --usb=legacy.

Case Sensitivity
•

Command line options, pre-defined and user-defined arguments, and filenames given as arguments are all casesensitive on PowerEdge systems prior to PowerEdge yx2x .

•

Unless specified otherwise, enter all commands, options, arguments, and command line switches in lowercase
letters.

Command Line Option Delimiters
The following table lists some examples of valid and invalid DTK command lines.

Table 3. Command Line Option Delimiters

Valid / Invalid DTK Command Line

Example

valid

syscfg --option1 --option2

syscfg --asset --floppy

invalid

syscfg --option1=argument -option2
--option3

syscfg --asset=R910 --floppy -bootseq

valid

syscfg -o=filename --option1 -option2

syscfg -o=/tmp/myfile.txt --floppy
--bootseq

valid

syscfg -l=filename --option1 -option2

syscfg -l=/tmp/myfile.txt --floppy
--bootseq

invalid

syscfg -i=filename --option1 -option2

syscfg -i=/tmp/myfile.txt --floppy
--bootseq

valid

syscfg --option=argument
bmcoption
--option1= argument

syscfg --embnic=on pcp -hostname=webserver

NOTE: Do not combine options that specify report or set actions in a command line instance.

Other Delimiters
The following table lists the other delimiters:
Table 4. Other delimiters

Delimiter

Example

Description

White space (space or tab)

syscfg -option=argument1
argument2

considers
argument1
and
argument2
as two arguments.

A string surrounded by double
quotation marks regardless of the
white space contained within, is
interpreted as a single SYSCFG
argument.

syscfg -option="argument1
argument2"

considers
argument1
and
argument2
a single argument.

A double quotation mark preceded by
a backslash (\") is interpreted as a
literal double quotation mark (").

syscfg -option="\"argument"

considers "argument as the argument.

Backslashes are interpreted literally,
unless they immediately precede a
double quotation mark. If an even
number of backslashes are followed
by a double quotation mark, then one
backslash (\) is taken for every pair of

syscfg --option="\
\"argument"

considers \ and argument as two
arguments.

Delimiter

Example

Description

backslashes (\\), and the double
quotation mark (") is interpreted as a
string delimiter.
If an odd number of backslashes are syscfg --option="\\
followed by a double quotation mark, \"argument"
then one backslash (\) is taken for
every pair of backslashes (\\) and the
double quotation mark is interpreted
as an escape sequence by the
remaining backslash, causing a literal
double quotation mark (") to be placed
in the SYSCFG argument.

considers \ "argument as the
argument.

Read And Write Commands
Options can report a certain value or set of values based on the presence of an argument. These read or write actions
are implied in the DTK command line arguments. The get, read, set, or write commands, for example, are not required.
NOTE: You cannot combine options that specify read or write actions in a command line instance.
Table 5. Read and Write Command Examples

Valid/Invalid

DTK Command Line Example

valid

syscfg --option1 --option2

valid

syscfg --option1=arg --option2=arg

invalid

syscfg --option1=arg --option2

File Input And Output Commands
•

Specify the file input using the -i command, where is the name of the input file.

•

Specify the file output using the -o command, where is the name of the output
file.

Log Files
If the log file already exists, information is appended to the file. This allows multiple tools to use the same log file to
record information. Use the -l option to record the output of a utility.
The log duplicates all standard output and error information to the specified file. Each log file begins with a time stamp
and utility name. For example, YYYY/MM/DD HH:MM:SS < utilname > - .
The following is an example of the logging behavior:
2003/11/28 10:23:17 syscfg - option1=on
2003/11/28 10:23:17 syscfg - option2=on
2003/11/28 10:23:17 syscfg - option3 =off
NOTE: The log files may contain sensitive information such as passwords and authentication information. To
protect such information, it is recommended that only the administrator accesses the log files.

Help Option
The -h and --help options display general usage information for the utility. If the argument matches a valid option, that
usage information of the option is displayed. If the option has arguments, the arguments are displayed, separated by a |
character. If the argument does not match a valid option, a usage error is given (and usage information is displayed).
This option cannot be replicated.

Error Checking And Error Messages
The DTK utilities check your commands for correct syntax when you enter them. When a command is executed
successfully, a message displays stating that your command has been successful. Unrecognized or invalid options and
arguments result in a usage error that displays the DTK utility name and version along with a short message. For
information about the error messages, see Messages and Codes.

SYSCFG
This section documents the Deployment Toolkit (DTK) system configuration utility. It describes the command line
parameters, configuration file format, and individual executables used to configure server BIOS and Baseboard
Management Controller (BMC) settings, DTK state settings, and system information including PCI device detection.

Features
The SYSCFG utility:
•

Displays help and usage information.

•

Outputs configuration options to a file or screen.

•

Reads configuration options from a file or Command Line Interface (CLI) parameters.

•

Configures BMC/Remote Access Controller (RAC) users, local area network (LAN) channel and serial channel
settings, BMC/RAC platform event filter (PEF) settings, and BMC/RAC serial-over-LAN (SOL) settings.

•

Configures the nonmaskable interrupt (NMI) and power button.

•

Reports the BMC/RAC firmware version, BMC/RAC device global unique identifier (GUID), and BMC/RAC LAN
channel and serial channel information.

•

Reports BMC/RAC session information.

•

Clears BMC/RAC system event log (SEL).

•

Restores BMC/RAC factory defaults.

•

Records and reports the state data value.

•

Displays system configuration information.

•

Returns specific error codes and messages.

•

Logs activity to a given filename.

•

Configures the BIOS features using ini file, DTK xml file, and ws-man xml file.
NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), the SYSCFG utility is located at \dell
\x32\toolkit\tools or \dell\x64\toolkit\tools directory. In Linux, you can find it in the/opt/dell/toolkit/bin directory.

SYSCFG General Options
NOTE: Some of the options in SYSCFG are followed by an asterisk. The asterisk is not part of the command
syntax.These commands do not accept any sub-options or arguments. The values associated with these
commands are reported by the BIOS. You cannot modify these values.

No Option
Options

No option

Sub-Options

Valid Arguments

Description

The SYSCFG utility outputs usage information. The usage information is
displayed in the format shown below.

--envar
Options

--envar

Sub-Options

Valid Arguments

media should be writable

Description

Stores the environment variable data to a file when used with the – s option.
This file can be called from other scripts to set the environment variable. The
value of must not be specified if the DTKENVSCR environment
variable is set to a valid filename. In this case, the filename pointed to by
DTKENVSCR is used to store the environment variable data.
Example:
syscfg --mem -s=temp --envar= Z:\scripts\file.bat
When used without the -s option, --envar takes the default variable.
Linux Example:
syscfg --svctag --envar= /tmp/myvars.txt
svctag = 2G8LC1S
syscfg_var =’2G8LC1S’
source /tmp/myvars.txt
Windows PE Example:
syscfg --svctag --envar=i:\myvars.bat
svctag = 2G8LC1S
syscfg_var =’2G8LC1S’
call i:\myvars.bat

-h or --help
Options

-h or --help

Sub-Options

Valid Arguments

none or

Description

Displays the general usage information for the utility, when no argument is
provided. If the argument matches a valid option, that option's usage
information is displayed. If the option has arguments, the arguments are
displayed, separated by a | character. If the option has sub-options, all suboptions, valid arguments, and a description are listed. If the argument does not
match a valid option, a usage error is given (and usage information is
displayed). This option cannot be replicated.

Example:
A:>syscfg -h lanchannelaccess
lanchannelaccess: Reports LAN channel access
information.
Sub-options:
pefalerting: Enable or disable PEF (Platform Event
Filter)alerting.
Arguments: enable | disable
ipmioverlan: Enable or disable
IPMI over LAN access.
Arguments: disable | alwaysavail
channelprivlmt: Sets the maximum privilege level
that can be accepted on the LAN channel.
Arguments: user | operator |administrator

-i or --infile
Options

-i or --infile

Sub-Options

Valid Arguments

Description

Directs the SYSCFG utility to take input from the .ini file. The utility searches the
file for a section heading identical to the utility name. An error is returned if the
file or section is not found. If the section is found, each name/value pair is
applied to the system. The names must match a valid option, and the arguments
must be in the proper format for the option. If an option is not available on a
system and it is specified in a file, the utility ignores the option. If any errors are
found in the format of the names or values, an error is returned and the options
are not applied to the system. If this option is used with other function
command options, they are applied in the order in which they appear on the
command line, overriding any previous commands.
Example:
A:>syscfg -i .ini

--ix or --inxmlfile
Options

--ix or --inxmlfile

Sub-Options

Valid Arguments

Description

Directs the SYSCFG utility to receive input from the xml file. The utility searches
the BIOS option in the file. An error is returned if the file is not found. The
provided option must match a valid option, and the arguments must be in the
proper format for the option. If an option is not available on a system and it is

specified in a file, the utility ignores the option. If any errors are found in the
format of the names or values, an error is returned and the options are not
applied to the system. If this option is dependent on any other option, they are
applied in the order in which they appear in the xml file.
NOTE: It is applicable only on 12G and later systems.
Example:
A:>syscfg --ix filename.xml
NOTE: You can modify or use the BIOS configuration captured in xml
format from a PowerEdge 12G for large scale 12G deployment
configurations using RACADM or WS-MAN. For more information on using
RACADM and WS-MAN refer RACADM Command Line Reference Guide
for iDRAC7 and CMC and Dell Lifecycle Controller-Remote Services Quick
Start Guide respectively available at dell.com/support/manuals.

-l or --logfile
Option

-l or --logfile

Sub-Options

Valid Arguments

Description

Logs the command line output to a time-stamped file. The utility either appends
the information to an existing log file or creates a new file. The log file contains
the same information as the standard output, plus timestamp information. Users
should use this option instead of redirection for task diagnosis. For more
information, see Log Files .
Example:
A:>syscfg -l logfile --option=

-o or --outfile
Options

-o or --outfile

Sub-Options

Valid Arguments

Description

Prints all replicable options to the specified filename. The format of the output
is in the .ini format, with the utility name as the section header. On PowerEdge
11G systems, if a file with the same name already exists, the information is
appended to the file, but on PowerEdge 12G it overwrites the existing file. If this
option is used with other function commands, the commands are applied in the
order in which they appear. This option captures replicable BMC and BIOS
options.
Example:
A:>syscfg -o .ini

--ox or --outxmlfile
Options

--ox or --outxmlfile

Sub-Options

Valid Arguments

Description

Prints all BIOS options to the specified xml file.
NOTE: It is applicable only on 12G and later sytems.
Example:
A:>syscfg --ox filename.ini

--px or --pendingxmlfile
Options

--px or --pendingxmlfile

Sub-Options

Valid Arguments

Description

Prints all the pending BIOS options to a specified xml file.
NOTE: It is applicable only on 12G and later sytems.
Example:
A:>syscfg --px filename.xml

-s
Options

-s

Sub-Options

Valid Arguments

Description

Prints the variable name and the assigned value to the console. This option
when used with --envar, picks up the environment variable data and stores it in
a file. This file can be called from a script. For more information, see --envar.
Example:
A:>syscfg -s ENVNAME --svctag
svctag=SERVICE
ENVNAME=SERVICE

--version*
Options

--version*

Sub-Options

Valid Arguments

Description

Displays the version information, current time, and date for the utility. This
option cannot be replicated.
Example:
A:>syscfg --version syscfg Version 4.2 P01(Windows
- Oct 21 2012,16:48:48)
Copyright (c) 2002-2012 Dell Inc.

SYSCFG For BIOS Configuration
SYSCFG uses BIOS interfaces to manipulate boot order and BIOS settings. It configures all options available on the BIOS
setup screen, including boot order, embedded device configuration, and asset tag management.

SYSCFG Options On PowerEdge Systems Prior To PowerEdge 12G Systems
The following are the valid options and arguments supported on PowerEdge systems earlier than PowerEdge 12G
systems. Options and arguments are case-sensitive. All options and pre-defined arguments are lowercase unless stated
otherwise. Running SYSCFG without arguments only displays the valid options. Some of the following options or
arguments may not be available on all systems due to the BIOS version or hardware feature set.
NOTE: If you have modified tpm or tcm option, reboot the system for the options to take effect.

--acpower
Option

--acpower

Valid Arguments

on, off, last

Description

Sets the behavior for the system after AC power is lost. This option specifies
how the system responds to the restoration of AC power and is particularly
useful in systems that are turned off using a power strip. When set to on, the
system turns on after AC is restored. When set to off, the system does not turn
on after AC is restored. When set to last, the system turns on if the system was
on when AC power was lost; if the system was off when AC power was lost, the
system remains off when power is restored. This option can be replicated.
Example:
A:>syscfg --acpower=on
acpower=on

Applicable Systems

All Dell PowerEdge systems prior to PowerEdge 12G systems.

--adjcacheprefetch
Option

--adjcacheprefetch

Valid Arguments

enable, disable

Description

When this option is set to enable, the processor fetches the cache line
containing the currently requested data, and the adjacent cache line. When
this option is set to disable, the processor fetches only the cache line
containing the currently requested data.
Example:
A:>syscfg --adjcacheprefetch=enable
adjcacheprefetch=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--asset
Option

--asset

Valid Arguments

Description

Reports or sets the customer-programmable asset tag number for a system.
The maximum length of an asset tag is 10 characters. Asset tag values cannot
contain any spaces. For more information on delimiters, see Command Line
Option Delimiters. This value can be replicated.
Example:
A:>syscfg --asset=
asset=ASSETTAG

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems except Blade
systems.

--assignintr
Option

--assignintr

Valid Arguments

standard, distributed

Description

Controls the interrupt assignment of PCI devices in the system. This option is
set to standardby default, causing standard interrupt routing that uses interrupt
A, B, C, and D for all PCIe devices. When set to distributed, the interrupt routing
is swizzled at the MCH root ports to minimize sharing of interrupts across all
PCIe (and PCI-X in the Programmable Interrupt Controller (PIC) mode) devices.
Example:
A:>syscfg --assignintr=standard
assignintr=standard

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--bezelir
Option

--bezelir

Valid Arguments

enable, disable

Description

Enables or disables the ESM to monitor and log front bezel intrusion conditions.
Example:
A:>syscfg --bezelir=enable
bezelir=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems

--bootmode
Option

--bootmode

Valid Arguments

uefi, bios

Description

Allows booting to Unified Extensible Firmware Interface (UEFI) -capable
operating systems or ensures compatibility with operating systems that do not
support UEFI.
Example:
A:>syscfg --bootmode=uefi
bootmode=uefi

Applicable Systems

PowerEdge 11G systems

--bootseq
Option

--bootseq

Valid Arguments

numerical list separated by commas or list of device names separated by
commas

Description

Enables, disables, and orders the devices in a boot order list. Only the devices
present on the system are listed in the bootseq.
Without an argument, this option prints the boot order list. The argument must
be formatted as a comma-separated numerical list with no spaces. The list
must be within the bounds of the current boot list, that is, the low and high
numbers must match, and the same number of entries must be supplied.
Systems that use a numerical list for boot order cannot be replicated.
Some systems also allow the boot order to be expressed as a list of device
names. Device names are formatted as a name.location.instance string, where
name is the name of the device, location is either slot or embedded (emb), and
instance is the numerical position of the device. Some device name examples
are shown below. Systems that support a list of device names for boot order
can be replicated.

Numerical Lists Examples:
A:>syscfg --bootseq= 2,3,4,5,1,6
The following devices are set in the boot sequence:
Device 2:* usbcdrom.slot.1- USB CD-ROM device
Device 3:* virtualcd.slot.1 – VIRTUAL CDROM
Device 4:* hdd.emb.0 -Hard drive C:
Device 5:* nic.emb.1 - MBA v2.5.12 Slot 0500
Device 1:* virtualfloppy.slot.1 - VIRTUAL FLOPPY
Device 6:* usbfloppy.slot.1 - USB Floppy device
NOTE: The asterisk indicates that the device is enabled in the BIOS.
Device Name Examples:
Example of device names:
nic.slot.1 (network adapter 1 in PCI slot)
nic.emb.1 (network adapter 1 on system board)
hdd.emb.0 (hard drive C:)
cdrom.emb.0 (CD drive)
Device Name Lists Examples
Example 1:
#syscfg --bootseq
The following devices are set in the boot sequence:
Device 2:* cdrom.emb.0 - IDE CD-ROM device
Device 3:* hdd.emb.0 - Hard drive C:
Device 5:* virtual.slot.1 - VIRTUALCDROM DRIVE
Device 1:* floppy.emb.0 - Diskette drive A:1226
Device 6:* virtual.slot.2 - VIRTUALFLOPPY DRIVE
Device 4:* nic.emb.1 - IBA GE Slot 0638 v1226
Example 2:
#syscfg --bootseq=nic.emb.1,virtual.slot.1
The following devices are set in the boot sequence:
Device 4:* nic.emb.1 - IBA GE Slot 0638 v
Device 5:* virtual.slot.1 - VIRTUALCDROM DRIVE
Device 2: cdrom.emb.0 - IDE CD-ROM device
Device 3: hdd.emb.0 - Hard drive C:
Device 1: floppy.emb.0 - Diskette drive A:
NOTE: The asterisk indicates that the device is enabled in the BIOS.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--bootseqretry
Option

--bootseqretry

Valid Arguments

enable, disable

Description

Enables or disables the boot sequence retry feature. When set to enable, the
system re-attempts to set the boot order after a 30-second time-out if the last
boot attempt has failed. This option can be replicated.
A:>syscfg --bootseqretry=enable
bootseqretry=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--cmosdefaults
Option

--cmosdefaults

Valid Arguments

enable, disable

Description

Enables or disables the request for a default CMOS value during the next
reboot.
A:>syscfg --cmosdefaults=enable
cmosdefaults=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--conboot
Option

--conboot

Valid Arguments

enable, disable

Description

Enables or disables configuring or reporting of console redirection after reboot.
This option is available on all supported systems that support console
redirection. This option can be replicated.
Example:
A:>syscfg --conboot=enable
conboot=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12Gsystems.

--conred
Option

--conred

Valid Arguments

serial1, serial2, off, bmcsol, mmb

Description

Configures or reports the communication port for console redirection. If this
option is set to serial port, then the serial port option is not available. If only one
serial port is present on a system, the serial2 argument is not available. This
option can be replicated.

Example:
A:>syscfg --conred=serial1
conred=serial1
Applicable Systems

All PowerEdge systems prior to PowerEdge x9xx (9G) systems.

--conterm
Option

--conterm

Valid Arguments

vt100, ansi

Description

Configures or reports the terminal type for console redirection. This option is
available on all supported systems that support console redirection. This option
can be replicated.
Example:
A:>syscfg --conterm=vt100
conterm=vt100

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--coreperformanceboost
Option

--coreperformanceboost

Valid Arguments

enable, disable

Description

Enables or disables the AMD Core Performance Boost feature. When enabled,
it allows higher performance power states if additional power is available to
the CPU. This option can be replicated.
Example:
A:>syscfg --coreperformanceboost=enable
coreperformanceboost=enable

Applicable Systems

PowerEdge R715, R815, R515, R415, and M915 systems with AMD Opteron 6000
series processor

--cpucle
Option

--cpucle

Valid Arguments

enable, disable

Description

Enables or disables C1-E. By default, it is enabled. This option can be
replicated.
Example:
A:>syscfg --cpucle=enable
cpucle=enable

Applicable Systems

PowerEdge 11G systems

--cpucore
Option

--cpucore

Valid Arguments

1, 2, 4, 6, 8, 10, 12, 14, 16, all

Description

Controls the number of enabled cores in each processor. The default value is
set to the maximum number of cores per processor. The number of cores
depends on the processor. Reading the cpucore that is set to the highest value
of number of cores displays as all.
For example, if 6-core CPU is installed, after setting to the highest value, 6,
when you read the cpucore, it displays as all.
Example:
A:>syscfg --cpucore=1
cpucore=1

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--cpuxdsupport
Option

--cpuxdsupport

Valid Arguments

enable, disable

Description

Enables or disables the execute disable (XD) feature of the CPU.
Example:
A:>syscfg --cpuxdsupport=enable
cpuxdsupport=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems running on Intel
processors.

--cstates
Option

--cstates

Valid Arguments

enable, disable

Description

Enables or disables the power c states of the processor.
A:>syscfg --cstates=enable
cstates=enable

Applicable Systems

PowerEdge 11G systems

--datareuse
Option

--datareuse

Valid Arguments

enable, disable

Description

Enables or disables data reuse. Set to enable for High Performance Computing
(HPC) applications. Set to disable for energy efficiency. This option can be
replicated.
A:>syscfg --datareuse=enable
datareuse=enable

Applicable Systems

PowerEdge 11G systems

--dbpm
Option

--dbpm

Valid Arguments

enable, disable

Description

Enables or disables demand-based power management. This option can be
replicated.
Example:
A:>syscfg --dbpm=enable
dbpm=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--dcustreamerprefetcher
Option

--dcustreamerprefetcher

Valid Arguments

enable, disable

Description

Enables or disables DCU Streamer Prefetcher. This option can be replicated.
Example:
A:>syscfg --dcustreamerprefetcher=enable
dcustreamerprefetcher=enable

Applicable Systems

PowerEdge 11G systems

--devseq
Option

--devseq

Valid Arguments

numerical list separated by commas or list of device names separated by
commas

Description

Sets the hard-drive sequence for a system. Without an argument, this option
displays the device list. The argument must be formatted as a commaseparated numerical list of device index values. The list must be within the
bounds of the current boot list. For example, the low and high numbers must
match. Systems that use a numerical list for boot order cannot be replicated.
Some systems allow the boot order to be expressed as a list of device names.
Systems that support device names also support replication of the boot order
through the output file option. Device names are formatted as a
name.location.instance string, where name is the name of the device, location
is either slot or embedded (emb) , and instance is the numerical position of the
device. Some device name examples are shown below. Systems that support a
list of device names for boot order can be replicated.

Example 1:
A:>syscfg --devseq
The following devices are set in the disk device
sequence:
Device 1:* hdd.emb.0 - System BIOS boot devices
Device 2:* scsiraid.slot.3 - PERC 5/E Adapter(bus
02 dev 02)
Device 3:* usbkey.slot.0 - Hard-disk-emulated USB
flash drive
Example 2:
A:>syscfg --devseq= hdd.emb.1,scsiraid.emb.1
The following devices are set in the disk device
sequence:
Device 1:* hdd.emb.0 - System BIOS boot devices
Device 2:* scsiraid.emb.1 - AIC-7899, A:00 Seagate
NOTE: The asterisk indicates that the device is enabled in the BIOS.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embhypervisor
Option

--embhypervisor

Valid Arguments

off, on

Description

Turns on or off the embedded hypervisor port.
Example:
A:>syscfg --embhypervisor=on
embhypervisor=on

Applicable Systems

All PowerEdge systems prior to PowerEdge yx2x systems

--embideraid
Option

--embideraid

Valid Arguments

on, off

Description

Turns on or off the embedded IDE RAID controller. This option is only valid for
supported systems that have IDE ROMB. This option can be replicated.
Example:
A:>syscfg --embideraid=on
embideraid=on

Applicable Systems

All PowerEdge systems prior to PowerEdge yx2x systems

--embnic1
Option

--embnic1

Valid Arguments

on, off, onnopxe, onwithiscsi

Description

Turns the first embedded NIC on with PXE on, off, or on without PXE enabled.
This option is only valid for supported systems that have a NIC. If the NIC is
enabled without PXE, it is not found in the boot order. If the NIC is turned on
with PXE, it is placed at the end of the boot order. The onnopxe argument is not
supported on all systems.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic1 option can be replicated.
Example:
A:>syscfg --embnic1=onnopxe
embnic1=onnopxe

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embnic2
Option

--embnic2

Valid Arguments

on, off, onnopxe, onwithiscsi

Description

Turns the second embedded NIC on with PXE enabled, off, or on without PXE
enabled. This option is only valid for supported systems that have two
embedded NICs. If the second NIC is enabled without PXE, it is not found in the
boot order. If the second NIC is turned on with PXE, it is placed at the end of
the boot order. The onnopxe argument is not supported on all systems. This
option can be replicated.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic2 option can be replicated.
Example:
A:>syscfg --embnic2=onnopxe
embnic2=onnopxe

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embnic3
Option

--embnic3

Valid Arguments

on, off, onnopxe, onwithiscsi

Description

Turns the third embedded NIC on with PXE enabled, off, or on without PXE
enabled. This option is only valid for supported systems that have three
embedded NICs. If the third NIC is enabled without PXE, it is not found in the
boot order. If the third NIC is turned on with PXE, it is placed at the end of the
boot order. The onnopxe argument is not supported on all systems. This option
can be replicated.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic3 option can be replicated.

Example:
A:>syscfg --embnic3=onnopxe
embnic3=onnopxe
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embnic4
Option

--embnic4

Valid Arguments

on, off, onnopxe, onwithiscsi

Description

Turns the fourth embedded NIC on with PXE enabled, off, or on without PXE
enabled. This option is only valid for supported systems that have four
embedded NICs. If the fourth NIC is enabled without PXE, it is not found in the
boot order. If the fourth NIC is turned on with PXE, it is placed at the end of the
boot order. The onnopxe argument is not supported on all systems. This option
can be replicated.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic4 option can be replicated.
Example:
A:>syscfg --embnic4=onnopxe
embnic4=onnopxe

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embnic1nic2
Option

--embnic1nic2

Valid Arguments

enable, disable

Description

Enables or disables the operating system interface of the first and second
embedded NIC controllers.
Example:
A:>syscfg --embnic1nic2=enable
--embnic1nic2=enable

Applicable Systems

PowerEdge 1855, PowerEdge 6850, and PowerEdge 11G systems

--embnic3nic4
Option

--embnic3nic4

Valid Arguments

enable, disable

Description

Enables or disables the operating system interface of the third and fourth
embedded NIC controllers.
Example:
A:>syscfg --embnic3nic4=enable
--embnic3nic4=enable

Applicable Systems

PowerEdge yx1x systems

--embnics
Option

--embnics

Valid Arguments

enable, disable

Description

Turns both the embedded NICs on or off. This option is only present on systems
that do not support the embnic1 and embnic2 options. This option can be
replicated.
Example:
A:>syscfg --embnics=enable
--embnics=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge yx2x systems

--embnic1pxe
Option

--embnic1pxe

Valid Arguments

enable, disable

Description

Enables or disables Preboot Execution Environment (PXE) on the first
embedded NIC. If PXE is disabled, the first NIC is not found in the boot order. If
PXE is enabled, the first NIC is placed at the end of the boot order. This option
is only present on systems that do not support the embnic1 option. This option
can be replicated.
Example:
A:>syscfg --embnic1pxe=enable
embnic1pxe=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embnic2pxe
Option

--embnic2pxe

Valid Arguments

enable, disable

Description

Enables or disables Preboot Execution Environment (PXE) on the second
embedded NIC. If PXE is disabled, the second NIC is not found in the boot
order. If PXE is enabled, the second NIC is placed at the end of the boot order.
This option is only present on systems that do not support the embnic2 option.
This option can be replicated.
Example:
A:>syscfg --embnic2pxe=enable
embnic2pxe=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embsataraid
Option

--embsataraid

Valid Arguments

off, combined, ata, ahci, raid, qdma

Description

Configures an embedded SATA RAID controller. This option can be replicated.
•
•
•
•
•
•

off — disables the embedded SATA RAID controller.
combined — sets the SATA RAID controller to combined mode.
ata — sets SATA RAID controller to ATA mode.
ahci — sets ATA RAID controller to ahci mode.
raid — sets SATA RAID controller to RAID mode.
qdma — sets the SATA RAID controller to support ATAPI devices at
transfer rates much higher than PIO. A device driver must be installed
on your system to use the QDMA mode.

Example:
A:>syscfg --embsataraid=off
embsataraid=off
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embscsi1
Option

--embscsi1

Valid Arguments

on, off

Description

Turns the first embedded SCSI controller. This option is only valid for supported
systems that have an embedded SCSI controller. This option can be replicated.
Example:
A:>syscfg --embscsi1=on
embscsi1=on

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embscsi2
Option

--embscsi2

Valid Arguments

on, off

Description

Turns the second embedded SCSI controller. This option is only valid for
supported systems that have an embedded SCSI controller. This option can be
replicated.
Example:
A:>syscfg --embscsi2=on
embscsi2=on

Applicable Systems

All PowerEdge systems prior to PowerEdge yx2x systems

--embscsiraid
Option

--embscsiraid

Valid Arguments

raid, off, scsi

Description

Sets the specified value for the SCSI RAID controller. This option is only valid
for supported systems that have SCSI ROMB. Some systems do not support the
scsi argument. This option can be replicated.

CAUTION: If you change the controller from SCSI to RAID mode, data loss
may occur. Backup any data you must save before changing modes.
Example:
A:>syscfg --embscsiraid=raid
embscsiraid=raid
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embscsiraidchb
Option

--embscsiraidchb

Valid Arguments

raid, scsi

Description

Sets the second channel on an embedded RAID controller to SCSI or RAID.
This option is only valid for systems that support RAID/RAID and RAID/SCSI
settings for channels A and B. This option can be replicated.
Example:
A:>syscfg --embscsiraidchb=raid
embscsiraidchb=raid

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--embsdcardredundancy
Option

--embsdcardredundancy

Valid Arguments

mirrormode, disable

Description

Sets the redundancy to mirrormode or disabled.
If set to mirrormode, read-write operation occurs on both the secure digital
(SD) cards. If one of the SD cards fails and is replaced, on booting, the data is
copied to that SD card.
If set to disable, read-write operation occurs only on SD card 1.
On Blade systems, disable the vflash key to configure this option.
Example:
A:>syscfg --embsdcardredundancy=mirrormode
embsdcardredundancy=mirrormode

Applicable Systems

PowerEdge R810, R815, R910, and M910 systems

--extserial
Option

--extserial

Valid Arguments

com1, com2, rad

Description

Sets the behavior of the external serial connector. When set to com1 , the BIOS
maps the external serial connector to COM port 1. The com1 setting is the
default.
When set to com2 , the external serial connector is routed to the COM2
interface. Terminal escape sequences can toggle the external connector
between the system (COM2) and the remote access device.

When set to rad , the external serial connector is routed to the remote access
device interface. Terminal escape sequences can toggle the external
connector between the system (COM2) and the remote access device.
This option can be replicated.
Example:
A:>syscfg --extserial=com1
extserial=com1
The --serialcomm option can be used with the external serial (--extserial)
option instead of the --conred (available on systems earlier than PowerEdge 9G
systems) option.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems except Blade
systems.

--embsdcard
Option

--embsdcard

Valid Arguments

off, on

Description

Enables or disables the embedded SD card port.
Example:
A:>syscfg --embsdcard=off
embsdcard=off

Applicable Systems

PowerEdge 11G systems

--embvideoctrl
Option

--embvideoctrl

Valid Arguments

enable, disable

Description

Enables or disables the embedded video controller.
Example:
A:>syscfg --embvideoctrl=enable
embvideoctrl=enable

Applicable Systems

PowerEdge 11G systems

--fiberchannel
Option

--fiberchannel

Valid Arguments

enable, disable

Description

Enables or disables embedded fiber channel. This option can be replicated.
Example:
A:>syscfg --fiberchannel=enable
fiberchannel=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--f1f2promptonerror
Option

––f1f2 prompt onerror

Valid Arguments

enable, disable

Description

Enables or disables the BIOS to prompt F1 or F2 error codes.
Example:
A:>syscfg --f1f2promptonerror=enable
f1f2promptonerror=enable

Applicable Systems

PowerEdge 10G and later systems

--floppy
Option

--floppy

Valid Arguments

auto, off, readonly

Description

Sets the diskette drive controller to auto, off, or readonly. This option is
available on all supported systems that have a supported diskette drive. This
option can be replicated
Example:
A:>syscfg --floppy=auto
floppy=auto

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--formfactor
Option

––formfactor

Valid Arguments

halfheight, halfheight, dualwide, fullheight, fullheight, dualwide

Description

Displays the geometry of PowerEdge Blade systems. This is a read-only option
and can have the following values: halfheight (the Blade systems occupies 1
slot of the chassis), halfheight, dualwide (the Blade system occupies 2
horizontal slots of the chassis), fullheight (the Blade system occupies 2 vertical
slots of the chassis), and fullheight, dualwide (the Blade system occupies 4
slots of the chassis).
Example:
A:>syscfg --formfactor=fullheight, dualwide
formfactor=fullheight, dualwide

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--fsbr
Option

--fsbr

Valid Arguments

115200, 57600, 19200, 9600

Description

Sets the console redirection fail safe baud rate in bps.

Example:
A:>syscfg --fsbr=9600
fsbr=9600
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--hddfailover
Option

--hddfailover

Valid Arguments

off, on

Descriptionoff

Specifies the device in the Hard Disk Drive Sequence menu that has not been
attempted in the boot sequence. When set to on, all devices are attempted in
an order in which they are configured. When set to off, only the first device in
the hard disk sequence is attempted. This option can be replicated.
Example:
A:>syscfg --hddfailover=on
hddfailover=on

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--hpcmode
Option

--hpcmode

Valid Arguments

enable, disable

Description

Enables or disables the High Performance Computing (HPC) Mode. When set to
enable, the HPC is enabled utilizing only the high frequency P-State settings.
When set to disable (default value), all P-States inherent to the CPU are used.
To fully enable HPC Mode, set the power management to custom, cpu power
and performance management to OsDbpm, and fan power and performance
management to maximum performance.
Example:
A:>syscfg --hpcmode=enable
hpcmode=enable

Applicable Systems

PowerEdge R715, R815, and M915 with AMD Opteron 6200 series processor

--htassist
Option

--htassist

Valid Arguments

enable, disable

Description

Enables or disables the Probe Filter chipset option. Some applications may
have lower performance when the chipset feature is disabled.
Example:
A:>syscfg --htassist=enable
htassist=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems with AMD Opteron
processors.

--hwprefetcher
Option

--hwprefetcher

Valid Arguments

enable, disable

Description

Processor preempts what data might be needed next, when set to enable.
When some data is found, it loads several steps in advance.
Processor does not preempt, when set to disable.
This option can be replicated.
Example:
A:>syscfg --hwprefetcher=enable
hwprefetcher=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--idecdrom
Option

--idecdrom

Valid Arguments

auto, off

Description

Turns the CD drive on or off. This option can be replicated.
Example:
A:>syscfg --idecdrom=auto
idecdrom=auto

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--idracgui
Option

--idracgui

Valid Arguments

enable, disable

Description

Enables and disables the iDRAC GUI. This option can be replicated.
Example:
A:>syscfg --idracgui=disable
idracgui=disable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--integratedraid
Option

--integratedraid

Valid Arguments

enable, disable

Description

Enables or disables the integrated RAID controller. This option can be
replicated.
Example:
A:>syscfg --integratedraid=disable
integratedraid=disable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--integratedsas
Option

--integratedsas

Valid Arguments

enable, disable

Description

Enables or disables the integrated SAS controller. This option can be
replicated.
Example:
A:>syscfg --integratedsas=enable
integratedsas=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--inteltxt
Option

--inteltxt

Valid Arguments

enable, disable

Description

Enables or disables the Intel TXT option. This option can be replicated.
Example:
A:>syscfg --inteltxt=enable
inteltxt=enable
NOTE: To enable the Intel TXT option in a supported processor, make sure
that the:
•
•
•
•

Applicable Systems

Virtualization technology in Processor setting is enabled.
TPM module is installed and initialed as OK by BIOS.
TPM security in System security is set to on with pre-boot
measurements.
User password is not set.

All PowerEdge 11G systems with Intel processors.

--internalusb
Option

--internalusb

Valid Arguments

off, on

Description

Turns on or off all the user-accessible USB ports. This option can be replicated.
Example:
A:>syscfg --internalusb=on
internalusb=on

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--ioat
Option

--ioat

Valid Arguments

enable, disable

Description

Enables or disables the I/O Acceleration Technology (I/OAT) DMA Engine
option. This option must be enabled only if the hardware and software support
I/OAT on your system. This option can be replicated.
Example:
A:>syscfg --ioat=enable
ioat=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--lcd
Option

--lcd

Valid Arguments

default, none, user, idracipv4address, idracmacaddress, ossystemname,
servicetag, ipv6address, ambienttemp, systemwatts

Description

Displays the default string (model name and number for PowerEdge systems
earlier than Dell PowerEdge 11G, and service tag for PowerEdge systems 11G
and later) or a userdefined string on the front-panel LCD based on the specified
argument. This option can be replicated.
Example:
A:>syscfg --lcd=default
lcd=default

Applicable Systems

PowerEdge 11G systems

--lcd1
Option

--lcd1

Valid Arguments

Description

Sets the first line of user-defined text on the system LCD. This option can be
replicated. For more information on delimiters, see Command Line Option
Delimiters.
NOTE: Before setting user strings for --lcd1 , ensure that --lcd is set
to user.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--lcd2
Option

--lcd2

Valid Arguments

Description

Sets the second line of user-defined text on the system LCD. This option can be
replicated. For more information on delimiters, see Command Line Option
Delimiters.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--logicproc
Option

--logicproc

Valid Arguments

enable, disable

Description

Enables or disables logical processing for a system. This option is available on
all systems that support logical processing (Hyperthreading).
This option can be replicated.
Example:
A:>syscfg --logicproc=enable
logicproc=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--lpt
Option

--lpt

Valid Arguments

lpt1, lpt2, lpt3, disable

Description

Configures or reports the I/O address of the LPT (parallel) port. This option is
available on all supported systems with an LPT port. This option is recorded to
an output file for replication.
Example:
A:>syscfg --lpt=lpt1
lpt=lpt1

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

-memdynamicpower
Option

--memdynamicpower

Valid Arguments

enable, disable

Description

Enables or disables the dynamic memory power states. This option can be
replicated.
Example:
A:>syscfg --memdynamicpower=enable
memdynamicpower=enable

Applicable Systems

PowerEdge R910 system with Intel Xeon 7500 series

--memintleave
Option

--memintleave

Valid Arguments

enable, disable

Description

Enables or disables the memory interleave mode. This option can be replicated.

Example:
A:>syscfg --memintleave=enable
memintleave=enable
NOTE: The memintleave option is same as Nodeinterleave option. For more
information, see Memory Settings group.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--memoperatingmode
Option

--memoperatingmode

Valid Arguments

optimizer, mirror, advancedecc

Description

Selects the memory operating mode. This feature is active only if a valid
memory configuration is detected.
Example:
A:>syscfg --memoperatingmode=optimizer
memoperatingmode=optimizer

Applicable Systems

PowerEdge 11G systems

--memprefailurenotify
Option

--memprefailurenotify

Valid Arguments

enable, disable

Description

Enables or disables the Correctable ECC SMIs. When enabled, the SMIs report
the Correctable ECC errors.
This option can be replicated.
Example:
A:>syscfg --memprefailurenotify=enable
memprefailurenotify=enable

Applicable Systems

PowerEdge R710, R610, and T610 systems with Intel Xeon processor

--memremap
Option

--memremap

Valid Arguments

off, auto

Description

Sets the memory remapping to off or auto.
Example:
A:>syscfg --memremap=off
memremap=off

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--memtest
Option

--memtest

Valid Arguments

enable, disable

Description

Enables or disables the POST extended memory test.
Example:
A:>syscfg --memtest=disable
memtest=disable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--mouse
Option

--mouse

Valid Arguments

on, off

Description

Turns the mouse controller on or off.
This option can be replicated.
Example:
A:>syscfg --mouse=off
mouse=off

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--nextboot
Option

--nextboot

Valid Arguments

(from the bootseq option device list)

Description

Sets the specified device as the first device in the boot order for the next boot
cycle only. The device must be a device from the bootseq option device list.
Run the bootseq option to see a list of available device names. For more
information, see --bootmode . This option is not replicated.
Example 1:
A:>syscfg --bootseq
Device 1: floppy.emb.0 -Diskette Drive A:
Device 2: cdrom.emb.0 -CD-ROM device
Device 3: hdd.emb.0 - HardDrive C:
Device 4: nic.emb.1 -Intel Boot Agent Version 4.0.17
Device 5: nic.emb.2 -Intel Boot Agent Version 4.0.17
Example 2:
A:>syscfg --nextboot=nic.emb.1
nextboot=nic.emb.1

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

-noraidprompt*
Option

--noraidprompt*
NOTE: The asterisk is not part of the command syntax.

Valid Arguments

Description

Specifies that the BIOS must not prompt for confirmation when changing the
mode of a RAID controller. This option can only be used with the --embscsiraid
or --embscsiraidchb options.
Without this option, the user is prompted during POST to confirm the change of
a RAID controller from RAID (SCSI) to SCSI (RAID). This option is not replicated.
CAUTION: When changing a RAID controller from SCSI to RAID or from
RAID to SCSI, data is lost on the affected hard drives. The warning
message for this data is not displayed if you use the --noraidprompt option.
To avoid data loss, back up any information on the hard drives before
changing the type of controller used with the drives
Example:
A:>syscfg --embscsiraid=raid --noraidprompt
embscsiraid=raid

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--numlock
Option

--numlock

Valid Arguments

on, off

Description

Turns the keyboard number lock on or off during POST. This option is not
replicated.
Example:
A:>syscfg --numlock=on
numlock=on

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--oldsetuppwd
Option

--oldsetuppwd

Valid Arguments

Description

Allows to set a new setup password if a setup password is already present on
the system. The setup password locks the BIOS setup screen. The argument
string supplied to this option is the current password. If this password is not
correct, the new setup password is not applied to the system. Generally,
passwords are limited to alphanumeric characters and cannot exceed 32
characters in length. This option is not replicated. For more information on
delimiters, see Command Line Option Delimiters.

Example:
A:>syscfg --setuppwd=asetuppassword -oldsetuppwd=currentpassword
The password has been set.Please use a warm reboot
to apply the password to the system.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--oldsyspwd
Option

--oldsyspwd

Valid Arguments

Description

Supplies the current system password for the BIOS. This option is only given
when setting the new system password. If this password does not match the
current system password, the new password is not applied to the system. The
system password is required when booting the system. The argument string
supplied to this option is the password. Generally, passwords are limited to
alphanumeric characters and cannot exceed 32 characters in length. This
option is not replicated. For more information on delimiters see Command Line
Option Delimiters.
Example1:
A:>syscfg --syspwd=anotherpassword -oldsyspwd=password
The password has been set.Please use a warm reboot
to apply the password to the system.
Example 2:
A:>syscfg --syspwd=asyspassword -oldsyspwd=currentpassword
The old password entered is incorrect. The new
password will not be set. Please try again.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--opticaldrivectrl
Option

--opticaldrivectrl

Valid Arguments

enable, disable

Description

Enables or disables the optical CD-ROM controller.
Example:
A:>syscfg --opticaldrivectrl=enable
opticaldrivectrl=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--oswatchdogtimer
Option

--oswatchdogtimer

Valid Arguments

enable, disable

Description

Aids in the recovery of the operating system when the system stops
responding. When this option is set to enable, the operating system is allowed
to initialize the timer. When set to disable (the default), the timer has no effect
on the system.
Example:
A:>syscfg --oswatchdogtimer=enable
oswatchdogtimer=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--ovrwrt*
Option

--ovrwrt*
NOTE: The asterisk is not part of the command syntax.

Valid Arguments

Description

Used with the -o option to cause the output file to be overwritten if a file of the
same name already exists. This option cannot be replicated.
Example:
A:>syscfg -o=filename.ini --ovrwrt
The file filename has been overwritten.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

power
Option

power

Valid Arguments

Description

For details about the power suboptions and arguments, see Sub Options For
Power Option.

Applicable Systems

PowerEdge 11G systems

--powerbutton
Option

--powerbutton

Valid Arguments

enable, disable

Description

Enables or disables the power button for a system. This option is recorded to
an output file for replication.
Example:
A:>syscfg --powerbutton=enable
powerbutton=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--qpibandwidthpriority
Option

--qpibandwidthpriority

Valid Arguments

compute, io

Description

Sets the bandwidth priority to compute or io. Set to compute for computationintensive applications. Set to io for I/O intensive applications. This option can
be replicated.
Example:
A:>syscfg --qpibandwidthpriority=compute
qpibandwidthpriority=compute

Applicable Systems

Dell PowerEdge 11G systems

--redmem
Option

--redmem

Valid Arguments

off, spare, mirror, DDDC

Description

Allows selection of the required redundant memory mode, or disables
redundant memory. This option can be replicated.
Example:
A:>syscfg --redmem=off
redmem=off

Applicable Systems

PowerEdge M910, R910, and R810 systems with Intel Xeon 7500 series
processor.

--remflashmedia
Option

--remflashmedia

Valid Arguments

read-only

Description

Displays the redundancy status of internal dual SD module. The status can be:
•
•

Full — Secure digital card (SD) 1 and 2 are functioning properly.
Lost — Either any of the secure digital cards or both are not
functioning properly.

The option also displays the status of the individual SD cards as follows:
•
•
•
•
•
•

Active — The card is used for secure digital reads.
Standby — The card is receiving a copy of all secure digital reads.
Failed — An error is reported during a secure digital read or write.
Absent — No secure digital media is detected.
Offline — At boot, card identification signature is different from the
non-volatile storage value or card is the destination of a copying
operation that is in progress.
Write Protected — The card is write-protected.

Example:
A:>syscfg --remflashmedia
Internal Dual SD ModuleRedundancy=Lost
SD1 status=Absent
SD1 status=Active
Applicable Systems

PowerEdge R810, R815, R910, and M910 systems

--rptkeyerr
Option

--rptkeyerr

Valid Arguments

enable, disable

Description

Enables or disables the BIOS to report keyboard errors during POST. This
option can be replicated.
Example:
A:>syscfg --rptkeyerr=disable
rptkeyerr=disable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata0
Option

--sata0

Valid Arguments

auto, off

Description

Turns the SATA port 0 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata0=auto
sata0=auto
NOTE: This option maps to --sata_a for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata1
Option

--sata1

Valid Arguments

auto, off

Description

Turns the SATA port 1 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata1=auto
sata1=auto
NOTE: This option maps to --sata_b for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata2
Option

--sata2

Valid Arguments

auto, off

Description

Turns the SATA port 2 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata2=auto
sata2=auto
NOTE: This option maps to --sata_c for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata3
Option

--sata3

Valid Arguments

auto, off

Description

Turns the SATA port 3 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata3=auto
sata3=auto
NOTE: This option maps to --sata_d for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata4
Option

--sata4

Valid Arguments

auto, off

Description

Turns the SATA port 4 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata4=auto
sata4=auto
NOTE: This option maps to --sata_e for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata5
Option

--sata5

Valid Arguments

auto, off

Description

Turns the SATA port 5 to auto or off. This option can be replicated.

Example:
A:>syscfg --sata5=auto
sata5=auto
NOTE: This option maps to --sata_f for PowerEdge 9G systems.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata6
Option

--sata6

Valid Arguments

auto, off

Description

Turns the SATA port 6 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata6=auto
sata6=auto
NOTE: This option maps to --sata_g for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sata7
Option

--sata7

Valid Arguments

auto, off

Description

Turns the SATA port 7 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata7=auto
sata7=auto
NOTE: This option maps to --sata_h for PowerEdge 9G systems.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--snoopfilter
Option

--snoopfilter

Valid Arguments

enable, disable

Description

Enables or disables the snoop filter option from the system BIOS.
Example:
A:>syscfg --snoopfilter=enable
snoopfilter=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--serial1
Option

--serial1

Valid Arguments

disable, com1, com3, com1_bmc, bmcserial, bmclan, rac

Description

Configures or reports the first serial port communication port. This option can
be replicated.
•
•
•
•

bmcserial — maps serial port 1 to BMC Serial.
bmclan — routes the serial traffic destined for serial1 out to NIC1.
com1_bmc — maps serial port 1 to COM port 1 BMC.
rac — maps serial port 1 to the RAC device.

Example:
A:>syscfg --serial1=rac
serial1=rac
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--serial2
Option

--serial2

Valid Arguments

auto, disable, com2, com4

Description

Configures or reports the second serial port communication port. This option
can be replicated.
Example:
A:>syscfg --serial2=rac
serial2=rac

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--serialcomm
Option

--serialcomm

Valid Arguments

on, com1cr, com2cr, off

Description

Sets the behavior of the serial port communication. When set to on, the BIOS
enables COM port 1 and COM port 2. These ports are made available for use by
the operating system or applications. BIOS Console Redirection is disabled.
When set to com1cr , BIOS enables COM port 1 and COM port 2. These ports
are made available for use by the operating system or applications. BIOS
Console Redirection is through COM port 1.
When set to com2cr , BIOS enables COM port 1 and COM port 2. These ports
are made available for use by the operating system or applications. BIOS
Console Redirection is through COM port 2.
When set to off , this option tells the BIOS to disable COM port 1 and COM port
2.
This option can be replicated.

Example:
A:>syscfg --serialcomm=on
serialcomm=on
The --serialcomm option can be used with the external serial (--extserial) option
instead of the --conred (available on systems earlier than PowerEdge 9G
systems) option.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--serialportaddrsel
Option

--serialportaddrsel

Valid Arguments

default, alternate

Description

Sets the port address of the serial devices.
When this option is default, Serial Device 1 is set to COM port 1 and Serial
Device 2 is set to COM port 2.
When this option is alternate, Serial Device 1 is set to COM port 2 and Serial
Device 2 is set to COM port 1.
This option can be replicated.
Example:
A:>syscfg --serialportaddrsel=default
serialportaddrsel=default

Applicable Systems

PowerEdge 11G systems

--setuppwd
Option

--setuppwd

Valid Arguments

Description

Sets the setup password for the BIOS. The setup password locks the BIOS F2
screen. The argument string supplied to this option is the password. Passwords
are limited to alphanumeric characters and cannot exceed 32 characters in
length. If a current setup password is set, it must be given through the
oldsetuppwd option. This option is not replicated. For more information on
delimiters, see Command Line Option Delimiters .
Example:
A:>syscfg --setuppwd=asetuppassword
The password has been set. Please use a warm reboot
to apply the password to the system.
Example 2:
A:>syscfg --setuppwd=asetuppassword -oldsetuppwd=currentpassword
The password has been set. Please use a warm reboot
to apply the password to the system.
Example 3:
A:>syscfg --setuppwd=asetuppassword -oldsetuppwd=currentpassword
The old password entered is incorrect. The new
password will not be set. Please try again.

NOTE: You cannot disable your password using DTK. To disable your
password, you must use the system BIOS.
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sma
Option

--sma

Valid Arguments

enable, disable

Description

Enables or disables processor sequential memory access.
Example:
A:>syscfg --sma=disable
sma=disable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--slotname*
Option

--slotname*
NOTE: The asterisk is not part of the command syntax.

Valid Arguments

Description

Reports the slot name of the blade.
Example:
A:>syscfg --slotname
slotname=Slot5

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sriov
Option

--sriov

Valid Arguments

enable, disable

Description

Enables or disables support for Single Root I/O Virtualization (SR-IOV) devices.
Example:
A:>syscfg --sriov=disable
sriov=disable

Applicable Systems

PowerEdge R410, R510, R610, R710, R910, T410, T610, and T710 systems prior to
PowerEdge12G systems with Intel Xeon processor 7500/6500 series.

--svctag*
Option

--svctag*
NOTE: The asterisk is not part of the command syntax.

Valid Arguments

Description

Reports the service tag for a system. If used with the -s general option, the
environment variable is set to the service tag.
Example:
A:>syscfg --svctag
svctag=113CD1S

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems except Blade
systems.

--syspwd
Option

--syspwd

Valid Arguments

Description

Sets the system password for the BIOS. The system password is required when
booting the system. The argument string supplied to this option is the password.
Generally, passwords are limited to alphanumeric characters and cannot
exceed 32 characters in length. If a current system password is set, it must be
given through the oldsyspwd option. This option is not replicated. For more
information on delimiters, see Command Line Option Delimiters .
Example 1:
A:>syscfg --syspwd=password
The password has been set. Please use a warm reboot
to apply the password to the system.
Example 2:
A:>syscfg --syspwd=password --oldsyspwd=password
The password has been set. Please use a warm reboot
to apply the password to the system
.
NOTE: You cannot disable your password using DTK. To disable your
password, you must use the system BIOS.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--sysrev
Option

--sysrev

Valid Arguments

Description

Reports the system revision. This is a read-only option.

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

tpm
Option

tpm

Valid Arguments

Description

For details about the tpm suboptions and arguments, see Sub Options For tpm
Option.

Applicable Systems

PowerEdge 10G and 11G systems

--turbomode
Option

--turbomode

Valid Arguments

enable, disable

Description

Enables or disables core-based turbo mode. Turbo mode is a feature on Intel
processors that allows one processor core to increase the frequency by one
bin whenever the other core has gone into an idle state.
Example:
A:>syscfg --turbomode=disable
--turbomode=enable

Applicable Systems

PowerEdge 11G systems running on Intel processors

--usb
Option

--usb

Valid Arguments

on, legacy, off

Description

Sets or reports the status of the USB port. When set to on, USB keyboards and
mice function only for systems with operating systems that have native USB
support. When set to legacy, USB keyboards and mice are supported through
the BIOS to function in operating systems that do not natively support USB .
This option can be replicated.
Example:
A:>syscfg --usb=on
usb=on

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--usbflash
Option

--usbflash

Valid Arguments

auto, fdd, hdd

Description

Sets or reports the emulation for a USB flash device. The USB flash device can
be set to emulate a hard drive (HDD) or a diskette drive (FDD). This option can
be replicated.
Example:
A:>syscfg --usbflash=auto
usbflash=auto

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--usbports
Option

--usbports

Valid Arguments

enable, enablebackonly, disable

Description

Enables or disables USB ports. When set to enable, it enables all user
accessible USB ports. When set to enablebackonly, the front user-accessible

ports are disabled. When set to disable, both front and back user accessible
ports are disabled. This option can be replicated.
Example:
A:>syscfg --usbports=enable
usbports=enable
Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--virtualization
Option

--virtualization

Valid Arguments

enable, disable

Description

Enables or disables virtualization in the CPU. When set to enable, it enables the
additional hardware capabilities provided by Virtualization Technology in
applicable CPUs.
When set to disable, it disables the additional hardware capabilities provided
by Virtualization Technology.
This option can be replicated.
Example:
A:>syscfg --virtualization=enable
virtualization=enable

Applicable Systems

All PowerEdge systems prior to PowerEdge 12G systems.

--vflash
Option

--vflash

Valid Arguments

enable, disable

Description

Enables or disables vflash on iDRAC.
Example:
A:>syscfg --vflash=enable
vflash=enable

Applicable Systems

All PowerEdge 11G systems or systems with iDRAC6

Sub Options And Arguments For tpm Option
The following table lists the sub-options and arguments for the tpm option.
Table 6. Sub-options and Arguments for the tpm Option

Option

Sub-option

Arguments

Description

tpm

--tpmsecurity

off

Does not report the presence of TPM to the
operating system.

onwithpbm

Directs the BIOS to store the TCG compliant
measurements to the TPM during a POST
operation.

Option

Sub-option

Arguments

Description

onwithoutpbm

Directs the BIOS to bypass the preboot
measurements.
Example:
A:>syscfg tpm -tpmsecurity=onwithoutpbm
--setuppwdoverride

-tpmactivation

enabled

Enables and activates the TPM feature.

disabled

Disables and deactivates the TPM feature.

nochange

Does not alter the operational state of the TPM
feature.
Example:
A:>syscfg tpm -tpmactivation=enabled -setuppwdoverride
NOTE: You cannot set tpmactivation when
tpmsecurity is set to off.
NOTE: After setting tpmactivation to enabled or
disabled, if you reboot your system, DTK
displays the TPM Configuration
Honoured system will reset and
the system reboots again message
and reboots.
NOTE: When you set tpmactivation to enabled
or disabled, DTK displays the value of
tpmactivation as nochange. However, the TPM
feature is activated/deactivated when you
reboot the system.

--tpmclear

Clears the contents of the TPM chip without
erasing the tpmsecurity and tpmactivation settings.
Example:
A:>syscfg tpm -tpmactivation=enabled --tpmclear
--setuppwdoverride

--undotpmclear

Cancels the result of the tpmclear setting. If you
specify this setting before specifying the tpmclear
setting, the There is currently no
pending TPM Clear request message is
displayed.
Example:
A:>syscfg tpm -tpmactivation=enabled -undotpmclear --setuppwdoverride

--valsetuppwd

Validates the setup password for TPM
authentication. If you try to change DTK settings,
you are prompted to enter this password to access

Option

Sub-option

Arguments

Description
the settings. For more information on delimiters, see
Command Line Option Delimiters.
Example:
A:>syscfg tpm -tpmactivation=enabled --tpmclear
--valsetuppwd=

-setuppwdoverri
de

On systems that do not have a setup password
configured, if you set this option, you are not
prompted for a password to access DTK settings.
A:>syscfg tpm -tpmactivation=enabled --tpmclear
--setuppwdoverride

Sub Options And Arguments For tcm Option
Table 7. Sub-options and Arguments for the tcm Option

Option

Sub-option

Arguments

Description

tcm

--tcmsecurity

off

Does not report the presence of TCM to the
operating system.

Reports the presence of TCM to the operating
system.
Example:
A:>syscfg tcm --tcmsecurity=off

enabled

Enables and activates the TCM feature.

disabled

Disables and deactivates the TCM feature.

nochange

Does not alter the operational state of the TCM
feature.
Example:
A:>syscfg tcm -tcmactivation=enabled

--tcmclear

Clears the contents of the TCM chip without
erasing the tcmsecurity and tcmactivation settings.
Example:
A:>syscfg tcm -tcmactivation=enabled --tcmclear
--setuppwdoverride

--tcmundoclear

Cancels the result of the tcmclear setting.
Example:
A:>syscfg tcm -tcmactivation=enabled -tcmundoclear --setuppwdoverride

-tcmactivation

Sub Options And Arguments For power Option
Table 8. Sub-options and Arguments for the power Option

Option

Sub-option

Arguments

Description

power

--profile

where powerprofile
can be
maxperformance,
osctl, apc

Displays the settings similar to the BIOS setup
screen for the respective profile. Reboot the system
for the settings to take effect.
If power profiles are not available on the platform,
an error message is displayed.
A:>syscfg power-profile=maxperformance -setuppwdoverride

custom

Creates the custom profile. Reboot the system for
the settings to take effect.
A:>syscfg power --profile=custom
--setuppwdoverride

--cpupowermode

min, max, osdbpm,
systemdbpm

Allows you to set the CPU power and performance
management to minimum power, maximum
performance, operating system DBPM, or system
DBPM mode.
Example:
A:>syscfg power --profile=custom
--cpupowermode=min -setuppwdoverride

-memorypowermod
e

min, 978, 800, 1067,
1333, max

Allows you to set memory power and performance
management to minimum power mode, maximum
power mode, 978 Mhz, 800 Mhz, 1067 Mhz, or 1333
Mhz.
A:>syscfg power --profile=custom
--memorypowermode=min -setuppwdoverride

--fanpowermode

min, max

Allows you to set the fan algorithm to the minimum
power optimized or maximum performance
optimized mode.
A:>syscfg power --profile=custom
--fanpowermode=min -setuppwdoverride
NOTE: Set the value of profile to custom to
change the values of cpupowermode ,
memorypowermode , and fanpowermode.

--profile
--cap

Displays the profile set and the respective profile
parameters.
Displays the values of budgetcap, and the maximum
and minimum power thresholds in Watts.

Option

Sub-option

Arguments

Description

NOTE: This
option is
available only
with the
appropriate
installed license.
is the
limit for power
consumption in
Watts, or btuphr, or
NOTE: This
percent.
option is
available only
is the unit of
with the
the
appropriate
value and can be
installed license. watt, or btuphr, or
percent.

-cap
--unit

The value of must be between the
maximum and minimum threshold values, else an
error is displayed. If the value is less than the
minimum threshold value, a warning message
appears.
If the unit is btuphr, it is converted in to Watts using
the formula Watt = BTU/hr /3.413. If the unit is
percent, the formula is Power Cap (Watts) = [Power
supply rating for input power (Watts) - Min potential
power (Watts)] * Power Cap (%) + Min potential
power (Watts)]
Example:
A:>syscfg power --cap= -unit=watt --setuppwdoverride

--maxpowercap

Displays the value of the maximum power
threshold.

--minpowercap

Displays the value of the minimum power threshold.

--valsetuppwd

Validates the setup password for power
authentication. If you try to change the DTK
settings, you are prompted to enter this password
to access the settings. For more information on
delimiters, see Command Line Option Delimiters.
A:>syscfg power --profile=
maxperformance --valsetuppwd=

-setuppwdoverri
de

Does not prompt you for a password to access the
DTK settings on systems that do not have a setup
password configured.
A:>syscfg power --profile=
maxperformance –setuppwdoverride

SYSCFG Options On PowerEdge 12G Systems
The following table lists the valid SYSCFG options and arguments supported on the PowerEdge 12G systems. On
PowerEdge 12G systems, the SYSCFG options are grouped. The options and arguments are case insensitive. Running
SYSCFG without arguments only displays the valid options. Reboot the system for the BIOS options to take effect.
Some of the BIOS options or arguments may not be available on all systems due to:
•

The BIOS version or hardware feature set.

•

A missing or expired license. The system displays an error message if the required license is not found. For more
information, see Dell License Manager on dell.com/support/manuals.

NOTE: PowerEdge 12G systems are backward compatible and support legacy arguments enable and disable.
However, it is recommended to use enabled and disabled on PowerEdge 12G systems as the arguments enable
and disable may be deprecated in future. For more information, see the BIOS options help.
To list the options which are are set on the system, but not applied due to pending reboot, type:
syscfg --pendingvalues

BIOS Boot Settings

Table 9. BIOS Boot Setting Options

Group

Option

Valid Arguments

Description

BIOS Boot Settings

--BootSeq

list of device names
separated by commas

Specifies the location of the operating
system files needed for system startup.
This option is applicable when bootmode
is set to Bios and has no effect when
bootmode is set to Uefi.

--HddSeq

list of device names
separated by commas

Specifies the order in which hard-disk
drives are configured in the system. The
first hard drive in the system will be the
bootable C: drive in DOS/DOS-like
operating systems. This option is
applicable when bootmode is set to
Bios and has no effect when bootmode
is set to Uefi.

Boot Settings

Table 10. Boot Settings Options

Group

Option

Valid Arguments

Description

Boot Settings

--BootMode

Bios, Uefi

Determines the boot mode of the system.

--BootSeqRetry

Enabled,
Disabled

Enables or disables the Boot Sequence
Retry feature. When set to Enabled, the
system attempts the boot sequence after a
30-second time-out if the last boot attempt
has failed.

Embedded Server Management

Table 11. Embedded Server Management Options

Group

Option

Valid Arguments

Description

Embedded Server
Management

--FrontLcd

None,
UserDefined,
ModelNum,
Advanced

Allows you to set the model number or a
user-defined string on the front-panel LCD
display.

--UserLcdStr

Allows you to set the default string (model
name and number for PowerEdge systems
earlier than Dell PowerEdge 11G and
service tag for PowerEdge systems 11G
and later) or a user-defined string on the
front-panel LCD. The maximum length of
the string is 62 characters.

Integrated Devices

Table 12. Integrated Devices Options

Group

Option

Valid Arguments

Description

Integrated
Devices

--EmbNicPortnBootProto Unknown, None,
Pxe, Iscsi

Controls the legacy boot protocol of the
LOM port specified by the embedded
NIC port number. This is a write-only
attribute. This attribute is for systems
management software use, and does
not appear in system BIOS setup. This
attribute always returns Unknown,
when read. There is no change to the
LOM port legacy boot protocol setting
when Unknown is returned. An error is
returned if written with a setting
(None, PXE, or iSCSI) that is
not supported by the LOM Port.

--EmbVideo

Enabled,
Disabled

Enables or disables the BIOS support
for the Embedded Video Controller.

--IntegratedNetwork1

Enabled,
DisabledOs,

Enables or disables Integrated Network
1.
NOTE: If set to DisabledOs, the
Integrated NICs may still be
available for shared network
access by the embedded
management controller. This
function must be configured
through the NIC management
utilities provided with your system.

--IntegratedNetwork2

Enabled,
DisabledOs

Enables or disables Integrated Network
2.
NOTE: If set to DisabledOs, the
Integrated NICs may still be
available for shared network
access by the embedded
management controller. This
function must be configured
through the NIC management
utilities provided with your system.

--IntegratedRaid

Enabled,
Disabled

Enables or disables the integrated RAID
controller.

--IntegratedSas

Enabled,
Disabled

Enables or disables the integrated SAS
controller.

--InternalSdCard

On, Off

Turns the internal SD card port on or
off.

-Mirror,
InternalSdCardRedundan Disabled
cy

Sets the internal SD card port
redundancy to Mirror mode or
Disabled.

Group

Option

Valid Arguments

Description
When set to Mirror mode, readwrite operation occurs on both the
secure digital (SD) cards. When one of
the SD cards fails and is replaced, on
booting, the data of the active card is
copied to the offline card.
When set to Disabled, read-write
operation occurs only on SD card 1.
NOTE: On Blade systems, disable
the vflash key to configure this
option. This option is applicable
only on PowerEdge R810, R815,
R910, M910, and PowerEdge 12G
systems.

--InternalUsb

On, Off

Turns the internal USB port on or off.

--InternalUsb1

On, Off

Turns the internal USB port 1 on or off.

--InternalUsb2

On, Off

Turns the internal USB port 2 on or off.

--IoatEngine

Enabled,
Disabled

Enables or disables the I/O Acceleration
Technology (I/OAT) option.

--OsWatchdogTimer

Enabled,
Disabled

Aids in the recovery of the operating
system when the system does not
respond. When set to Enabled, the
operating system is allowed to initialize
the timer. When it is set to Disabled
(default value), the timer has no effect
on the system.

--SriovGlobalEnable

Enabled,
Disabled

Enables or disables support for Single
Root I/O Virtualization (SR-IOV) devices.
NOTE: This option is supported on
PowerEdge R410, R510, R610, R710,
R910, T410, T610, T710, and
PowerEdge 12G systems with Intel
Xeon processor 7500/6500 series.

--UsbPorts

AllOn,
OnlyBackPortsOn
, AllOff

Sets the user accessible USB Ports.
Selecting OnlyBackPortsOn
disables front USB ports, and selecting
AllOff disables both front and back
USB ports.

Memory Settings

Table 13. Memory Settings Options

Group

Option

Valid Arguments

Description

Memory
Settings

-CollaborativeCpuPerfCt
rl

Enabled,
Disabled

When set to Enabled, the operating
system demand based power
management (OS DBPM) and system
demand based power management

Group

Option

Valid Arguments

Description
(System DBPM) controls the CPU power
management. This feature can be enabled
only when CPU power management
(ProcPwrPerf) is set to system DBPM
in Custom mode.

-DynamicCoreAllocation

Enabled,
Disabled

Enables or disables the operating system
capability to maintain the logical
processors in the idle state to reduce
power consumption.

--MemOpMode

OptimizerMode,
SpareMode,
MirrorMode,
AdvEccMode,
SpareWithAdvEccM
ode

Sets the memory operating mode. This
feature is active only if a valid memory
configuration is detected. When
OptimizerMode is enabled, the DRAM
controllers operate independently in 64-bit
mode and provide optimized memory
performance. When MirrorMode is
enabled, only half of the installed memory
is reported as available to the operating
system. When AdvECCMode is enabled,
the two DRAM controllers are combined
in 128-bit mode to provide optimized
reliability. Memory that cannot be teamed
by the controllers is not reported to the
operating system. When SpareMode is
enabled, the memory size reported to the
operating system does not include the
spare portion.

--MemOpVoltage

AutoVolt,
Volt15V

Sets the DIMM voltage selection. When
set to AutoVolt(default value), the
system automatically sets the voltage to
the optimal setting based upon the DIMM
capability and the installed DIMM
population. This option also enables
setting the system DIMM voltage to a
higher (1.5V) setting if the DIMMs support
multiple voltages and have been set to a
lower voltage.
NOTE: Volt15V represents 1.5 Volt.

--MemTest

Enabled,
Disabled

Enables or disables the POST extended
memory test.

--MonitorMwait

Enabled,
Disabled

Enables or disables Monitor/Mwait
instructions. You can disable Monitor/
Mwait only when C state is disabled in
Custom mode.

--NodeInterleave

Enabled,
Disabled

Enables node interleaving, if the system is
configured with matching memory. If set
to Disabled (default), the system
supports Non-Uniform Memory (NUMA)
architecture memory configurations. This
field is active only if the memory

Group

Option

Valid Arguments

Description
configuration can support node
interleaving.
NOTE: The NodeInterleave
option is same as memintleave
option. For more information, see
memintleave.

--SerialDbgOut

Enabled,
Disabled

Enables or disables the RC/MRC Serial
debug output.

--SysMemSize

Displays the amount of main memory in
the system.

--SysMemSpeed

Displays the clock frequency of the main
memory.

--SysMemType

Displays the type of main memory
installed in the system.

--SysMemVolt

Displays the voltage of the main memory.

--VideoMem

Displays the total amount of video memory
available to the embedded video
controller.

Miscellaneous Settings

Table 14. Miscellaneous Settings Options

Group

Option

Valid Arguments

Description

Miscellaneous
Settings

--AssetTag

Displays the Asset Tag and allows the
Asset Tag to be modified.
NOTE: The Asset Tag is a string
assigned to a system, usually by an
administrator, for security or tracking
purposes. The Asset Tag can be up to
10 characters long and can contain
only printable US-ASCII characters.

--ErrPrompt

Enabled,
Disabled

Enables (default value) or disables the
F1/F2 prompt on error.

-InSystemCharac
terization

Enabled,
Disabled

Enables or disables In-System
characterization.

--NumLock

On, Off

Determines whether the system boots with
NumLock turned on or off. This does not
apply to 84- key keyboards.

--ReportKbdErr

Report, Noreport

Sets if keyboard-related error messages
are reported at system startup or not.

One-Time Boot

Table 15. One-Time Boot Options

Group

Option

Valid Arguments

Description

One-Time
Boot

--OneTimeBootMode

Disabled,
OneTimeBootSeq,
OneTimeHddSeq,
OneTimeUefiBoot
Seq,
OneTimeCustomB
ootSeqStr,
OneTimeCustomH
ddSeqStr,
OneTimeCustomU
efiBootSeqStr

Allows to set the one-time boot sequence.

-OneTimeBootSeqDev

numerical list separated
by commas or list of
device names separated
by commas

Determines the one-time boot device when
the One- Time Boot Device List is set to BIOS
Boot Sequence Device. If Boot Mode is set to
UEFI, the system temporarily switches the
Boot Mode to BIOS when attempting a onetime boot to the device.

--OneTimeHddSeqDev numerical list separated
by commas or list of
device names separated
by commas

Determines the one-time boot hard disk
when the One-Time Boot Device List is set to
BIOS Hard-Disk Drive Sequence Device. If
Boot Mode is set to UEFI , the system
temporarily switches the Boot Mode to BIOS
when attempting a one-time boot to the
device.

-numerical list separated
OneTimeUefiBootSeq by commas or list of
Dev
device names separated
by commas

Determines the one-time boot device when
the One-Time Boot Device List is set to UEFI
Boot Sequence Device. If Boot Mode is set to
BIOS, the system temporarily switches the
Boot Mode to UEFI when attempting a onetime boot to the device.

Processor Settings

Table 16. Processor Settings Options

Group

Option

Valid Arguments

Description

Processo
r Settings

--DataReuse

Enabled, Disabled

Enables (default value) or disables data reuse
in cache.

--DcuIpPrefetcher

Enabled, Disabled

Enables (default value) or disables DCU IP
Prefetcher.

-Enabled, Disabled
DcuStreamerPrefetch
er

Enables (default value) or disables DCU
Streamer Prefetcher.

--LogicalProc

When this option is set to Enabled (default
value), the BIOS reports all logical processors.
When set to Disabled, the BIOS only
reports one logical processor per core. Each

Enabled, Disabled

Group

Option

Valid Arguments

Description
processor core supports maximum two logical
processors.

--Proc1Brand

Displays the brand text provided by the
processor manufacturer.

--Proc1Id

Displays the family, model, and stepping
values of the processor.

--Proc1L2Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc1L3Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc1NumCores

Displays the number of cores in the processor
package.

--Proc2Brand

Displays the brand text provided by the
processor manufacturer.

--Proc2Id

Displays the family, model, and stepping
values of the processor.

--Proc2L2Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc2L3Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc2NumCores

Displays the number of cores in the processor
package.

--Proc3Brand

Displays the brand text provided by the
processor manufacturer.

--Proc3Id

Displays the family, model, and stepping
values of the processor.

--Proc3L2Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc3L3Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc3NumCores

Displays the number of cores in the processor
package.

--Proc4Brand

Displays the brand text provided by the
processor manufacturer.

--Proc4Id

Displays the family, model, and stepping
values of the processor.

--Proc4L2Cache

Displays the amount of memory in the
corresponding processor cache.

--Proc4L3Cache

Displays the amount of memory in the
corresponding processor cache.

Group

Option

Valid Arguments

Description

--Proc4NumCores

Displays the number of cores in the processor
package.

--Proc64bit

Specifies if the installed processor supports
64-bit extensions or not.

--ProcAdjCacheLine

Enabled, Disabled

When set to Enabled (default), the system is
optimized for applications that require high
utilization of sequential memory access. When
set to Disabled, the system is optimized for
applications that require high utilization of
random memory access.

--ProcBusSpeed

Displays the bus speed of the processor.

--ProcCores

single, all,
dual, quad, 1, 2,
4, 6, 8, 10, 12,
14, 16

Controls the number of enabled cores in each
processor. By default, the maximum number of
cores per processor will be enabled.

--ProcCoreSpeed

Displays the clock speed of the processor(s).

-ProcExecuteDisable

Enabled, Disabled

Enables or disables the Execute Disable
Memory Protection Technology

--ProcHwPrefetcher

Enabled, Disabled

Enables or disables the hardware prefetcher.

-ProcVirtualization

Enabled, Disabled

When set to Enabled , the additional
hardware capabilities provided by
Virtualization Technology are available for use.

-InputOutput,
QpiBandwidthPriorit Compute
y

Sets the bandwidth priority to Compute
(default value) or I/O.

--QpiSpeed

MaxDataRate,
8GTps, 7GTps,
6GTps

Sets the speed of the processor.

--RtidSetting

Enabled, Disabled

When set to Enabled, it allocates more
(Requestor Transaction IDs) RTIDs to the
remote socket thereby increasing cache
performance between the sockets.

SATA Settings

Table 17. SATA Settings Options

Group

Option

Valid Arguments

Description

SATA
Settings

--EmbSata

Off, AtaMode,
RaidMode,
AhciMode

Configures an embedded SATA RAID controller.
•
•
•
•

--eSataPort1

Off, Auto

Sets the embedded SATA port1 to auto or off.

-
eSataPort1Capaci
ty

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
eSataPort1DriveT
ype

Indicates the type of device attached to the
embedded SATA port.

-eSataPort1Model

Displays the drive model of the selected device.

--SataPortA

Off, Auto

Sets the drive type of the selected device to off or
auto.

-
SataPortACapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortADriveTy
pe

This option indicates type of device attached to this
SATA port.

--SataPortAModel

Displays the drive model of the selected device.

--SataPortB

Sets the drive type of the selected device to off or
auto.

Off, Auto

-
SataPortBCapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortBDriveTy
pe

Indicates type of device attached to this SATA port.

--SataPortBModel

Displays the drive model of the selected device.

--SataPortC

Sets the drive type of the selected device to off or
auto.

Off, Auto

-
SataPortCCapacit
y

Off — disables the embedded SATA RAID
controller.
AtaMode — sets SATA RAID controller to
ATA mode.
RaidMode — sets SATA RAID controller to
RAID mode.
AhciMode — sets SATA RAID controller to
ahci mode.

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

Group

Option

Valid Arguments

Description

-
SataPortCDriveTy
pe

Indicates the type of device attached to this SATA
port.

--SataPortCModel

Displays the drive model of the selected device.

--SataPortD

Sets the drive type of the selected device to off or
auto .

Off, Auto

-
SataPortDCapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortDDriveTy
pe

Indicates the type of device attached to this SATA
port.

--SataPortDModel

Displays the drive model of the selected device.

--SataPortE

Sets the drive type of the selected device to off or
auto .

Off, Auto

-
SataPortECapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortEDriveTy
pe

Indicates type of device attached to this SATA port.

--SataPortEModel

Displays the drive model of the selected device.

--SataPortF

Sets the drive type of the selected device to off or
auto.

Off, Auto

-
SataPortFCapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortFDriveTy
pe

Indicates the type of device attached to this SATA
port.

--SataPortFModel

Displays the drive model of the selected device.

--SataPortG

Sets the drive type of the selected device to off or
auto.

Off, Auto

-
SataPortGCapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortGDriveTy
pe

Indicates the type of device attached to this SATA
port.

--SataPortGModel

Displays the drive model of the selected device.

--SataPortH

Sets the drive type of the selected device to off or
auto.

Off, Auto

Group

Option

Valid Arguments

Description

-
SataPortHCapacit
y

Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.

-
SataPortHDriveTy
pe

Indicates the type of device attached to this SATA
port.

--SataPortHModel

Displays the drive model of the selected device.

Serial Communication

Table 18. Serial Communication Options

Group

Option

--ConTermType
Serial
Communicati
on

Valid Arguments

Description

Vt100Vt220, Ansi

Sets the terminal type for your remote
console.

-Serial1, Serial2,
ExtSerialConnect RemoteAccDevice
or

Associates the External Serial Connector to
Serial Device 1, Serial Device 2, or the
Remote Access Device.

--FailSafeBaud

The BIOS attempts to determine the baud
rate automatically. This failsafe baud rate is
used only if the attempt fails.

115200, 57600,
19200, 9600

--RedirAfterBoot Enabled, Disabled

Sets the BIOS console redirection to
enable or disable when the operating
system is loaded.

--SerialComm

Enables or disables the serial
communication devices (Serial Device 1
and Serial Device 2) in BIOS.

OnNoConRedir,
OnConRedirCom1,
OnConRedirCom2, Off

-Serial1Com1Serial2Co
SerialPortAddres m2,
s
Serial1Com2Serial2Co
m1, Com1, Com2

Sets the port address for the Serial Devices
(COM1=0x3F8, COM2= 0x2F8).

Slot Disablement

Table 19. Slot Disablement Options

Group

Option

Valid Arguments

Description

Slot Disablement

--Slot1

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

--Slot2

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

--Slot3

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

--Slot4

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

--Slot5

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

Group

Option

Valid Arguments

Description

--Slot6

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

--Slot7

Enabled, Disabled,
BootDriverDisabled

Enables or disables the specified slot.

System Information

Table 20. System Information Options

Group

Option

Valid
Arguments

Description

System
Information

-SysMfrContactInf
o

Displays the information for contacting the Original
Equipment Manufacturer (OEM) of this system.

-SystemBiosVersio
n

Displays the current revision of the system BIOS
firmware.

-SystemManufactur
er

Displays the name of the Original Equipment
Manufacturer (OEM) of this system.

-SystemModelName

Displays the product name of the system.

-SystemServiceTag

Displays the system service tag (a unique identifier
assigned by the Original Equipment Manufacturer (OEM)
of this system).

System Profile Settings

Table 21. System Profile Settings Options

Group

Option

Valid Arguments

Description

System
Profile
Settings

--MemFrequency

MaxPerf, 1600MHz,
1333MHz, 1067MHz,
800MHz,
MaxReliability

Sets the Memory Frequency as maximum
performance, 1600 Mhz, 1333 MHz, 1067 MHz,
800 MHz, or maximum reliability.

--MemPatrolScrub

Standard,
Extended, Disabled

Sets the Memory Patrol Scrub frequency as
Standard Mode, Extended Mode, or
Disabled.

--MemRefreshRate

1x, 2x

Sets the Memory Refresh Rate as 1xor 2x.

--MemVolt

AutoVolt, Volt15V,
Volt135V

Sets the DIMM voltage selection.

NOTE: Volt15V
represents 1.5 Volt and
Volt135V represents
1.35 Volt.
--ProcC1E

Enabled, Disabled

When set to Enabled, the processor is
allowed to switch to minimum performance
state when idle.

Group

Option

Valid Arguments

Description

--ProcCStates

Enabled, Disabled

When set to Enabled, the processor can
operate in all available power states.

--ProcPwrPerf

MaxPerf, MinPwr,
SysDbpm, OsDbpm

Sets CPU Power Management to maximum
performance, operating system DBPM, or
System DBPM (DAPC).

--ProcTurboMode

Enabled, Disabled

When set to Enabled, the processor can
operate in Turbo Boost Mode.

--SysProfile

PerfPerWatt
OptimizedOs,
PerfPerWatt
OptimizedDapc,
PerfOptimized,
Custom, DenseCfg
Optimized

Sets the System Profile to Performance
Optimized, Power Optimized (DAPC), Power
Optimized (OS), Dense Configuration Optimized,
or Custom mode. When set to a mode other
than Custom, BIOS will set each option
accordingly. When set to Custom, you can
change setting of each option.

System Security

Table 22. System Security Options

Group

Option

Valid Arguments

Description

System
Security

--AcPwrRcvry

On, Off, Last

Specifies how the system will react after AC
power has been restored to the system. It is
especially useful for people who turn their
systems off with a power strip.

--AcPwrRcvryDelay

Immediate,
User, Random

Specifies how the system will support the
staggering of power-up after AC power has
been restored to the system.

-
AcPwrRcvryUserDela
y

Controls the user defined AC Recovery Delay.
Enter a delay in the range of 60 seconds to 240
seconds.

--AesNi

Enabled,
Disabled

Displays the current status of Intel Processor
AES-NI feature.

-BiosUpdateControl

Unlocked,
Limited,
Locked

Locks, unlocks, or limits the BIOS update using
DOS or UEFI shell based flash utilities. For
environments not requiring local BIOS updates,
it is recommended to set this field to Locked.

--IntelTxt

On, Off

Turns the Trusted Execution Technology on or
off. To enable Intel TXT, VT must be enabled,
and the TPM must be enabled with pre-boot
measurements and activated.

--NmiButton

Enabled,
Disabled

Enables or disables the Non-Maskable Interrupt
(NMI) button on the front panel.

--PasswordStatus

Locked,
Unlocked

Locks the system password. To prevent the
system password from being modified, set this
option to locked and enable setup password.
This field also prevents the system password
from being disabled by the user while the
system boots.

Group

Option

Valid Arguments

Description

--PwrButton

Enabled,
Disabled

Enables or disables the power button on the
front panel.

--SetupPassword

Displays the password and allows the password
to be set or modified. The password can be up to
32 characters long and contain most of nonshifted letters, numbers, and punctuation.

--SysPassword

Displays the password and allows the password
to be set or modified. The password can be up to
32 characters long and contain most of nonshifted letters, numbers, and punctuation.

-SystemCpldVersion

Displays the current revision of the Complex
Programmable Logic Device (CPLD) of the
system.

--TcmActivation

NoChange,
Activate,
Deactivate

Allows the user to change the operational state
of the Trusted Cryptography Module (TCM). This
field is Read-Only when TCM Security is set to
Off.

--TcmClear

Yes, No

CAUTION: Clearing the TCM will cause loss
of all keys in the TCM. This could affect
booting of the operating system.
When set to Yes, all the contents of the TCM
will be cleared. This field is read-only when
TCMSecurity is set to Off.

--TcmSecurity

On, Off

Controls the reporting of the Trusted
Cryptography Module (TCM) in the system.

--TpmActivation

NoChange,
Activate,
Deactivate

Allows the user to change the operational state
of the Trusted Platform Module (TPM). This field
is read-only when TPMSecurity is set to
Off.

--TpmClear

Yes, No

CAUTION: Clearing the TPM will cause loss
of all keys in the TPM. This could affect
booting of the operating system.
When set to Yes, all the contents of the TPM
will be cleared. This field is read-only when
TPMSecurity is set to Off.

--TpmSecurity

Off, OnPbm,
OnNoPbm

Controls the reporting of the Trusted Platform
Module (TPM) in the system.

--TpmStatus

Displays the current status of TPM.

--UefiBootSeq

numerical list
separated by commas
or list of device
names separated by
commas

Controls the UEFI boot order. The first option in
the list is attempted first, and if unsuccessful,
the second option will be attempted, and so on.
The system attempts to launch enabled boot
options only; it will not launch disabled boot
options. This field applies only when

Group

Option

Valid Arguments

Description
bootmode is set to Uefi. It has no effect
when bootmode is set to bios.

SYSCFG For BMC And Remote Access Controller Configuration
SYSCFG configures Baseboard Management Controller (BMC) and Remote Access Controller (RAC) settings.
NOTE: Some of the following options or arguments might not be available on all systems.
NOTE: For options that use text strings such as username, password, hostname, and community string, using some
characters such as , <, >, | , or = on the command line can be misinterpreted by the command line parser
and cause errors.
NOTE: The following options or arguments are also applicable to DRAC 5.
The following tables document valid options, sub-options, and arguments along with a description of the expected
behavior of each option and suboption. Options, sub-options, and arguments are case-sensitive. All options, sub-options,
and pre-defined arguments are lowercase unless explicitly stated otherwise. Some features that must be noted while
reading this section are:
•

Unless otherwise specified, all sub-options to options are optional.

•

If a sub-option is not specified for an option, all valid sub-option values are displayed for the option. If suboptions are specified, then only those suboptions are reported.

•

Wherever options or sub-options take empty strings as input, the string NULL should be input. For example,
options such as username and suboptions such as commstring and hostname can take an empty string as input.

BMC And Remote Access Controller Configuration Options
The following are the options, sub-options, and pre-defined arguments for configuring your system BMC and RAC.
NOTE: Some of the command line options in DTK are followed by an asterisk. Such options are used for reporting
purposes only.

clearsel*
Table 23. clearsel option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

--clearsel*

Clears the System Event Log (SEL).
This option cannot be replicated.
Example:
A:>syscfg -- clearsel
Clearing SEL...

All PowerEdge
systems

controlpanelaccess
Table 24. controlpanelaccess options

Option

Sub-option

Valid
Arguments

Description

Applicable Systems

-controlpanelacce
ss

viewandmod
ify,
viewonly,
disabled

Sets or gets the access level for
the Liquid Crystal Display (LCD).
Example:
A:>syscfg -controlpanelaccess=
viewandmodify
controlpanelaccess=
viewandmodify

PowerEdge 11G and
12G systems

deviceguid*
Table 25. deviceguid options

Option

Sub-option

Valid Arguments

Description

Applicable Systems

-deviceguid*

Displays the GUID for the BMC. This
option cannot be replicated.
Example:
A:>syscfg--deviceguid

All PowerEdge
systems

deviceguid=XXXXXXXXXX

encryptkey
Table 26. encryptkey option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

-encryptkey

Encrypts the IPMI sessions.
The hexadecimal number entered
as an argument is case insensitive
although the value returned by the
encryptkey option is always in
uppercase.
The value returned is appended
with zeroes so that it is always 40
characters long.
Example:
A:>syscfg -encryptkey=abcd

All PowerEdge
systems

encryptkey=
ABCD00000000000
000000000000000
0000000000

identify
Table 27. identify option

Option

Sub-option

Valid Arguments

Description

Applicable
Systems

--identify

0–254

Flashes the identification LED
for a specified number of
seconds.

PowerEdge
systems with a
BMC.

NOTE: Use 0 to
stop the blinking
of the LED.

idracversion
Table 28. idracversion options

Option

Sub-option

Valid
Arguments

-idracversio
n

Description

Applicable Systems

Displays the version information
for the iDRAC and the iDRAC
firmware. This option cannot be
replicated.

All PowerEdge
systems

--devid

Reports the iDRAC device ID.

--devrevision

Reports the iDRAC device
revision.

-majorfwversion

Reports the major firmware
revision of iDRAC.

-minorfwversion

Reports the minor firmware
revision of iDRAC.
A:>syscfg -idracversion
devid=32
devrevision=0
majorfwversion=0
minorfwversion=40

kvmstatusonlcd
Table 29. kvmstatusonlcd options

Option

Sub-option

-NA
kvmstatusonlc
d

Valid
Arguments

Description

Applicable Systems

active,
inactive

Configures the Dell Virtual KVM (vKVM)
session status on the LCD.
Example:
A:>syscfg -kvmstatusonlcd=active

PowerEdge 11G
systems

kvmstatusonlcd=active

lancfgparams
Table 30. lancfgparams options

Option

Sub-option

Valid
Arguments

lancfgpara
ms or lcp

Description

Applicable Systems

Configures and displays LAN
configuration parameters. This
option can be replicated.

All PowerEdge
systems

Sets the IP address source for the
LAN channel. This sub-option can
be replicated.

--ipaddrsrc

static,
dhcp

--ipaddress

channel. This sub-option cannot be
replicated.

--subnetmask

channel. This sub-option can be
replicated.

--gateway

Sets the gateway for the LAN
channel. This sub-option can be
replicated.

--commstring

--destipaddr

Fully Qualified Domain Name
(FQDN) for the alert destination
specified with the alertdest
sub-option.
The destipaddr sub-option is
dependent on the alertdest
suboption. If the alertdest suboption is not specified on the
command line, the first alert
destination (alertdest=1) is
set with this IP address or FQDN.
This sub-option can be replicated.
Example 1 (to set the destination IP
address):
A:>syscfg lcp -alertdest=1 -destipaddr=192.168.100.
15

Sets the community string
(maximum of 16 printable ASCII
characters) used in a platform
event trap (PET). This sub-option
can be replicated.
NOTE: FQDN is
applicable only
for
destipaddr
option and is
supported only
on PowerEdge
12G systems.

Example 2(to set the destination IP
address as FQDN):
A:>syscfg lcp -alertdest=1 -destipaddr=xxx.yyy.com

Option

Sub-option

Valid
Arguments

Description

--alertdest

1, 2, 3,
4

Sets the destination for the LAN
alert. This sub-option can be
replicated.

--vlantag

enable,
disable

Enables or disables VLAN tagging.
This sub-option can be replicated.

--vlanid

Sets the 12-bit VLAN ID. This suboption can be replicated.

--vlanpriority

0–7

Sets the VLAN priority value. This
sub-option can be replicated.

--macaddress

Displays the BMC MAC address.
This sub-option cannot be
replicated.

--nicselection

Sets the operating mode of the NIC
to shared, sharedfailover,
dedicated, or
sharedreceiveonall. Some
of these options are not applicable
on certain systems.

--nicselection

Sets the operating mode of the
iDRAC7 NIC to dedicated,
lom1, lom2, lom3, or lom4.
Some of these options are not
applicable on certain systems due
to underlying hardware.

shared,
sharedfai
NOTE: This option is lover,
available only with dedicated
the appropriate
,
installed license.
sharedrec
eiveonall

dedicated
, lom1,
NOTE: This option is lom2,
available only with lom3,
the appropriate
lom4
installed license.

-none,
Sets the operating mode of the NIC
nicselectionfailo lom1,
selection failover to none, lom1,
ver
lom2,
lom2, lom3, lom4, or all.
lom3,
NOTE: This option is
lom4, all Some of these options are not
available only with
applicable on certain systems. due
the appropriate
to underlying hardware.
installed license.

--fullduplex

enable,
disable

Enables or disables full duplex on
the RAC network interface.

--autoneg

enable,
disable

Enables or disables
autonegotiation.

--speed

10,100

Sets the network interface speed
to 10 or 100 Mbps.

--dnsdhcp

enable,
disable

Enables or disables obtaining the
DNS server IP address through
DHCP.

Applicable Systems

This option is
applicable on
systems prior to
PowerEdge 12G
systems. The
sharedreceive
onall argument is
available only on
PowerEdge 11G
systems.
NOTE: This
option is
applicable on
PowerEdge 11G
systems.
NOTE: This
option is
applicable on
PowerEdge 12G
systems.

Option

Sub-option

Valid
Arguments

Description

--dnsserver1

DNS server for domain name
resolution.

--dnsserver2

secondary DNS server for domain
name resolution.

--dnsregisterrac

enable,
disable

Enables or disables binding of the
RAC name to the IP address.

--dnsracname

Sets the name of the RAC.

-enable,
domainnamefromdhc disable
p

Enables or disables getting the
RAC domain name through DHCP.

--domainname

Sets the domain name of the RAC.
Example 1 (to display the current
LAN configuration settings):
A:>syscfg -lancfgparams

Applicable Systems

destipaddr=192.168.100.
15
vlantag=enable
vlanid=1000
vlanpriority=7
macaddress=0:6:5b:fb:c8
:a7
commstring=public
ipaddrsrc=static
ipaddress=192.168.100.1
0
subnetmask=255.255.255.
0
gateway=192.168.100.1

Option

Sub-option

Valid
Arguments

Description

Applicable Systems

Example 2 (to set the LAN
configuration parameters):
A:>syscfg -lancfgparams
-destipaddr=192.168.100.
15
--vlantag=enable
--vlanid=1000
--vlanpriority=7
-macaddress=0:6:5b:fb:c8
:a7
--commstring=public
--ipaddrsrc=static
-ipaddress=192.168.100.1
0
-subnetmask=255.255.255.
0
--gateway=192.168.100.1

lanchannelaccess
Table 31. lanchannelaccess options

Option

Sub-option

Valid Arguments

lanchannelacc
ess or lca

Description

Applicable
Systems

Sets or displays the LAN
channel access settings such
as alerting, IPMI over LAN, and
user privilege. This option can
be replicated.

All PowerEdge
systems

--pefalerting

enable,
disable

Enables or disables PEF alerts.
This sub-option can be
replicated.

--ipmioverlan

disable,
alwaysavail

Sets the LAN channel access
mode. This sub-option can be
replicated.

-channelprivlm
t

user,
operator,
administrat
or

Sets the maximum privilege
level accepted for the LAN
channel. This sub-option can be
replicated.

Option

Sub-option

Valid Arguments

Description

Applicable
Systems

Example (to configure the LAN
channel with alerts and IPMI
over LAN enabled):
A:>syscfg
lanchannelaccess-pefalerting=enable -ipmioverlan=alwaysava
il

lanchannelinfo
Table 32. lanchannelinfo options

Option

Sub-option

Valid Arguments

Description

Applicable Systems

lanchanneli
nfo or lci

Displays media and protocol
information about the LAN channel.
This option cannot be replicated.

All PowerEdge
systems

lanuseraccess
Table 33. lanuseraccess options

Option

Sub-option

Valid Arguments

lanuseracc
ess or lua

Description

Applicable
Systems

Configures the privilege level and
channel accessibility associated
with a specified User ID for the
LAN channel.

All PowerEdge
systems

--userid

2–16, if your
system has a
DRAC 5
controller

Sets the User ID. This sub-option
can be replicated.

--usrprivlmt

user,
operator,
administrat
or,
noaccess

Sets the maximum BMC user
privilege level for the LAN
channel for the userid specified
using the useridsub-option.
This sub-option can be replicated.
This sub-option is dependent on
the userid sub-option.

-NA
currentenableduse
rids

Reports the number of currently
enabled User IDs on the LAN
channel.

-NA
useridswithfixedn
ames

Reports the number of User IDs
with fixed names on the LAN
channel.

Option

Sub-option

Valid Arguments

Description

Applicable
Systems

Example 1 (to enable User ID 2 on
the LAN channel with
administrator privileges):
A:>syscfg
lanuseraccess -userid=2 -usrprivlmt=administrat
or
Example 2 (to enable User ID 4 on
the LAN channel with user
privileges):
A:>syscfg
lanuseraccess -userid=4 -usrprivlmt=user

loaddefaults*
Table 34. loaddefaults option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

-loaddefaul
ts*

Restores the BMC to the defaults
originally loaded on the controller.
This option is used to return the
BMC to a known-good state. This
option cannot be replicated.

All PowerEdge
systems

NOTE: The NMI, power button,
and SOL defaults are not reset
by using this option.
Example:
A:>syscfg --loaddefaults
Loading defaults...

nextboot
Table 35. nextboot option

Option

Sub-option

Valid
Arguments

Description

Applicable Systems

--nextboot or
-OneTimeBootSeq
Dev

valid device
name (from the
bootseq
option device
list)

All PowerEdge
systems

Option

Sub-option

Valid
Arguments

Description

Applicable Systems

Example 1:
A:>syscfg --bootseq
Device 1: floppy.emb.0
- Diskette Drive A:
Device 2: cdrom.emb.0
- CD-ROM device
Device 3: hdd.emb.0 Hard Drive C:
Device 4: nic.emb.1 Intel Boot Agent
Version 4.0.17
Device 5: nic.emb.2 Intel Boot Agent
Version 4.0.17
Example 2:
A:>syscfg -nextboot=nic.emb.1
nextboot=nic.emb.1

nmibutton
Table 36. nmibutton option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

--nmibutton

enable,
disable

Enables or disables the NMI button.
This option can be replicated.
Example:
A:>syscfg -nmibutton=enable

All PowerEdge
systems

nmibutton=enable

passwordaction
Table 37. passwordaction options

Option

Sub-option

Valid Arguments

Description

Configures and tests the password
All PowerEdge
for the specified User ID. This option systems
cannot be replicated. All three suboptions, action, userid, and
password must be included in the
command line.

passwordact
ion

NOTE: This option does not
support 20 byte passwords.
--userid

2–16, if your
system has a
DRAC 5
controller

Specifies the BMC User ID. This
sub-option cannot be replicated.

--action

setpassword
,
testpasswor
d

Sets or tests the password for the
specified User ID. This sub-option
cannot be replicated.

--password

Sets the password (maximum of 16
printable ASCII characters) for the
specified BMC User ID. This suboption cannot be replicated.
Example (to set and test the
password for User ID 3):
A:>syscfg
passwordaction -userid=3 -action=setpassword -password=bmcmaster
passwordaction userid=3
action=setpassword
password=*********
A:>syscfg
passwordaction -userid=3 -action=testpassword -password=bmcmastor
Password test failed.

Applicable Systems

pefcfgparams
Table 38. pefcfgparams options

Option

Sub-option

Valid
Arguments

pefcfgparam
s or pcp

Description

Applicable Systems

Configures and displays PEF
configuration parameters. This
option can be replicated.

All PowerEdge
systems

fanfail,
voltfail,
discretevo
ltfail,
tempwarn,
tempfail,
intrusion,
redundegra
ded,redunl
ost,
procwarn,
procfail,
powerwarn,
powerfail,
hardwarelo
gfail,
autorecove
ry,
batterywar
n,
batteryfai
l,
powerabsen
t,
procabsent
,
systempowe
rwarn,
systempowe
rfail

Specifies a PEF value. This suboption can be replicated.
For a complete list of all possible
PEF messages along a description
of each event, see BMC Platform
Events Filter Alert Messages

-filteraction

powercycle
, reset,
powerdown,
power
reduction,
none

Sets the event filter action for the
filter specified using the filter
sub-option. This sub-option
depends on the filter suboption. This sub-option can be
replicated.

--hostname

Sets the host name (maximum of
62 printable ASCII characters) for
the BMC. This sub-option can be
replicated.
The hostname string must
comprise only the followig
characters: hyphen (-) ,
underscore (_) , and period (.) .
The length of the hostname
string must be 62 characters or

--filter

NOTE: The fanfail option
is not supported on
PowerEdge 10G systems.

Option

Sub-option

Valid
Arguments

Description

Applicable Systems

less for PowerEdge 9G systems
and later.
--filteralert

enable,
disable

Enables or disables alerts for the
filter specified using the filter suboption. This sub-option is
dependent on the filter sub-option.
This sub-option can be replicated.

--alertpolnum

1, 2, 3, 4

Specifies the alert policy entry
number. This sub-option can be
replicated.

-alertpolstatu
s

enable,
disable

Enables or disables the alert policy
specified using the
alertpolnum sub-option. This
sub-option can be replicated. This
sub-option is dependent on the
alertpolnum sub-option.
Example: (to set the PEF
configuration parameters):
Example 1 (To configure the PEF so
that the system is powered down
in response to a fan failure event):
A:>syscfg pefcfgparams
--filter= fanfail-filteraction=powerdown
pefcfgparams
filter=fanfail
filteraction=powerdown
Example 2 (To configure the PEF so
that a PEF alert is not sent to the
destination IP address in response
to a chassis intrusion event):
A:>syscfg pefcfgparams
--filter= intrusion-filteralert=disable
pefcfgparams filter=
intrusion
filteralert=disable

powerbutton
Table 39. powerbutton option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

-powerbutton

enable,
disable

Enables or disables the power
button. This option can be
replicated.

All PowerEdge
systems

Option

Sub-option

Valid Arguments

Description

Applicable Systems

Example:
A:>syscfg -powerbutton=enable
powerbutton=enable

powerctl
Table 40. powerctl option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

--powerctl

powerdown

Performs a chassis powerdown and
controls the reset of the system.
Powerdown turns off the system.

All PowerEdge
systems

powercycle

Turns off the system and
automatically turns on your system
after a few seconds.

reset

Resets the system.

softshutdow
n

In Linux, the system turns off
immediately.
NOTE: In Windows PE, this
option does not work.
NOTE: This option applies only
to PowerEdge systems that are
configured with a BMC.
NOTE: This argument requires
ACPI support to function
properly.

racreset*
Table 41. racreset option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

--racreset*

Resets the RAC. It cannot be
accompanied with any other option.
This option cannot be replicated.

All PowerEdge
systems

serialcfgparams
Option

Sub-option

Valid Arguments Description

serialcfgpa
rams or scp

Configures and displays serial
configuration parameters. This
option can be replicated.
-connectionmod
e

basic,
terminal

--msgcomm

noflowctrl, Sets the IPMI message
rtscts
communication flow control. This
suboption can be replicated.

-msgcommdtrhan
gup

Reports the IPMI message
communication DTR hang-up. This
suboption cannot be replicated.

-msgcommbitrat
e

9600,
19200,
57600,
115200

Sets the IPMI message
communication baud rate in bits
per second (bps). This sub-option
can be replicated.

-tmcfglineedit
ing

enable,
disable

Sets the line editing value for
terminal mode configuration. This
sub-option can be replicated.

-tmcfgdelctrl

del, bksp

Sets the delete control value for
terminal mode configuration. This
sub-option can be replicated.

-tmcfgechoctrl

echo,
noecho

Sets the echo control value for
terminal mode configuration. This
sub-option can be replicated.

-tmcfghandshak
ectrl

enable,
disable

Sets the handshake control value
for terminal mode configuration.
This sub-option can be replicated.

-tmcfgnewlines
eq

noterm,
Sets the new line sequence value
crlf, null, for terminal mode configuration.
cr, lfcr,1f This sub-option can be replicated.

-tmcfginputnew
lineseq

cr, null

Sets the connection mode used to
perform IPMI messaging to the
BMC. This sub-option can be
replicated.

Sets the input new line sequence
value for terminal mode
configuration. This sub-option can
be replicated.
Example (to display the current
serial configuration settings):
A:>syscfg
serialcfgparams

Applicable Systems
All PowerEdge
systems

Option

Sub-option

Valid Arguments Description

Applicable Systems

serialcfgparams
tmcfgdelctrl=del
tmcfgechoctrl=echo
tmcfghandshakectrl=enab
le
connectionmode=terminal
tmcfgnewlineseq=crlf
msgcommflowctrl=rtscts
tmcfginputnewlineseq=cr
msgcommdtrhangup=disabl
e
msgcommbitrate=19200
tmcfglineediting=enable

serialchannelaccess
Table 42. serialchannelaccess options

Option

Sub-option

Valid Arguments Description

-serialchannelacc
ess or sca

Sets or displays the channel
access settings for the serial
channel. This option can be
replicated.

Applicable
Systems
All PowerEdge
systems

-disable,
Sets the serial channel access
ipmioverseria alwaysavail mode. This sub-option can be
l
replicated.
-user,
channelprivlm operator,
t
administrat
or

Sets the maximum privilege
level accepted for the serial
channel. This sub-option can
be replicated.
Example (to configure the
serial channel with IPMI over
serial disabled and the
maximum privilege level set to
administrator):
A:>syscfg
serialchannel
access -ipmioverserial=disab
le
-channelprivlmt=admin

Option

Sub-option

Valid Arguments Description

Applicable
Systems

istrator
serialchannelaccess
ipmioverserial=disab
le
channelprivlmt=admin
istrator

serialchannelinfo
Table 43. serialchannelinfo options

Option

Sub-option

Valid
Arguments

-serialchanneli
nfo or sci

Description

Applicable Systems

Displays media and protocol
information about the serial
channel. This option cannot be
replicated.

All PowerEdge
systems

--mediumtype

Displays the medium type for the
serial channel. This sub-option
cannot be replicated.

--prottype

Displays the protocol type for the
serial channel. This sub-option
cannot be replicated.

--ssnsupport

Displays the session support
information for the serial
channel. This sub-option cannot
be replicated.

-NA
activessncoun
t

Displays the number of sessions
that are activated on the serial
channel. This sub-option cannot
be replicated.
Example:
A:>syscfg
serialchannelinfo -mediumtype
mediumtype= asynch

serialuseraccess
Table 44. serialuseraccess options

Option
serialuseracce
ss or sua

Sub-option

Valid Arguments

Description

Applicable
Systems

Configures the privilege level
and channel accessibility
associated with a specified

All PowerEdge
systems

Option

Sub-option

Valid Arguments

Description

Applicable
Systems

User ID for the serial channel.
This option can be replicated.
--userid

2–16, if your
system has a
DRAC 5 controller

--usrprivlmt

user,
Sets the maximum BMC user
operator,
privilege level for the serial
administrato channel for the User ID
r,noaccess
specified using the userid
sub-option. This sub-option
can be replicated. This suboption is dependent on the
userid sub-option.

Sets the User ID. This suboption can be replicated.

-NA
currentenabledu
serids

Reports the number of
currently enabled User IDs on
the serial channel. This suboption can be replicated.

-NA
useridswithfixe
dnames

Reports the number of User
IDs with fixed names on the
serial channel. This suboption can be replicated.
Example 1 (to enable User ID 2
on the serial channel with
administrator privileges ) :
A:>syscfg
serialuseraccess -userid=2 -usrprivlmt=administr
ator
userid=2
usrprivlmt=administr
ator
status=enable
Example 2 (to enable User ID 4
on the serial channel with
user privileges ):
A:>syscfg
serialuseraccess -userid=4 -usrprivlmt=user
userid=4
usrprivlmt=user
status=enable

solaction
Table 45. solaction options

Option

Sub-option

Valid Arguments

solaction

Description

Applicable Systems

This option enables or disables
Serial-Over- LAN (SOL) access for a
particular user. This option can be
replicated.
Example:
A:>syscfg solaction
--userid=2 -action=disable

All PowerEdge
systems

solaction userid=2
action=disable
--userid

2–16, if your
system has a
DRAC 5
controller

Specifies the BMC user ID. This suboption can be replicated.

--action

enable,
disable

Enables or disables the user ID
specified using the userid suboption. This sub-option can be
replicated and is dependent on the
userid sub-option.

solcfgparams
Table 46. solcfgparams options

Option

Sub-option

Valid
Arguments

solcfgpara
ms

Description

Applicable Systems

Configures and displays SOL
configuration parameters. This
option can be replicated.

All PowerEdge
systems

--solenable

enable,
disable

Enables or disables if the SOL
payload type can be activated.
This option can be replicated.

--solprivlevel

user,
operator,
administra
tor

Sets the minimum user privilege
level required to activate the SOL.
This option can be replicated.

-solcharaccuminte
rval

1–255

Sets the Character Accumulate
Interval in 5–ms increments (1–
255). This sets the typical amount
of time that the BMC waits before
transmitting a partial SOL
character data packet. This
option can be replicated.

Option

Sub-option

Valid
Arguments

Description

-solcharsendthres
hold

1–255

Specifies that the BMC
automatically sends an SOL
character data packet containing
this number of characters in
increments of 5 (1–255) as soon
as this number of characters (or
greater) has been accepted from
the baseboard serial controller
into the BMC. This option can be
replicated.

Applicable Systems

NOTE: On PowerEdge 9G and
SC1435 systems, the
maximum limit is 255.
--solbitrate

9600,
19200,
57600,
115200

Sets the serial channel
communication bit rate (in bps)
with the BMC when SOL is
activated. This option can be
replicated.
NOTE: The arguments for
solbitrate vary with
various Dell systems. If an
argument valid for a
particular Dell system is
entered for another system,
the Parameter out of
range error is displayed.
Valid arguments are:
•
•

57600 — for PowerEdge
9G systems that do not
have DRAC 5 installed.
115200 — for PowerEdge
9G systems that have
DRAC 5 installed.

Example 1 (to display the current
SOL configuration):
A:>syscfg solcfgparams
solcfgparams
solenable=enable
solprivlevel=administr
ator
solcharaccum
interval=25
solcharsend
threshold=25
solbitrate=9600
Example 2 (to set the SOL
configuration parameters):
A:>syscfg solcfgparams
--solenable=disable
-solprivlevel=administr
ator

Option

Sub-option

Valid
Arguments

Description

Applicable Systems

--solcharaccum
interval=25
--solcharsend
threshold=100
--solbitrate=9600
solcfgparams
solenable=disable
solprivlevel=administr
ator
solcharaccum
interval=25
solcharsend
threshold=100
solbitrate=9600

ssninfo
Table 47. ssninfo options

Option

Sub-option

Valid Arguments

ssninfo

Description

Applicable Systems

Displays information about the
All PowerEdge
number of possible active sessions
systems
and the number of currently active
sessions on all channels on the BMC.
This option cannot be replicated.
-maxactivessns

Displays the maximum possible
active BMC sessions. This sub-option
cannot be replicated.

-currentactives
sns

Displays the number of currently
active sessions on all channels of the
BMC. This sub-option cannot be
replicated.
Example:
A:>syscfg ssninfo
currentactivessns=1
maxactivessns=4

useraction
Table 48. useraction options

Option

Sub-option

Valid Arguments

useraction

Applicable Systems

Enables and disables BMC, sua, and All PowerEdge
lua user IDs. This option can be
systems
replicated.
--userid

Description

2–16, if your
system has a
DRAC 5
controller

Specifies the BMC user ID. This
sub-option can be replicated.

Option

Sub-option

Valid Arguments

Description

--action

enable,
disable

Enables or disables the user ID
specified using the userid suboption. This sub-option can be
replicated. This sub-option is
dependent on the userid suboption.
Example to disable User ID 3:
A:>syscfg useraction -userid=3 -action=disable

Applicable Systems

useraction userid=3
action=disable

username
Table 49. username options

Option

Sub-option

Valid Arguments

username

Description

Applicable Systems

Sets the BMC User ID and
username. This option can be
replicated.

All PowerEdge
systems

--userid

2–16 if your
system has a
DRAC 5
controller

Specifies the User ID. This suboption can be replicated.

--name

Sets the username (maximum of
16 printable ASCII characters) for
the User ID specified using the
userid sub-option. This suboption can be replicated. This suboption is dependent on the userid
sub-option.
Example 1( to configure User ID 3
with a user name ):
A:>syscfg username -userid=3 -name=bmcmaster
username userid=3
name=bmcmaster
Example 2 (to display the username
for User ID 3):
A:>syscfg username -userid=3 --name
username userid=3
name=bmcmaster

version*
Table 50. version option

Option

Sub-option

Valid Arguments

Description

--version*

Displays the version information for
the SYSCFG utility.

Applicable Systems

virutualmedia
Table 51. virutualmedia option

Option

Sub-option

Valid Arguments

Description

Applicable Systems

-virutualmed
ia

enable,
disable,
auto

Enables or disables the virtual
media. This option cannot be
replicated.

All PowerEdge
systems. Available on
DRAC5 and all iDRAC
versions.

NOTE: This
option is
available
only with
the
appropriate
installed
license.

SYSCFG For State Configuration
The SYSCFG utility allows the user to write a state data value on a system. This value is preserved across reboot or
power-off operations. Users can use this state data value for storing important state information, such as the progress of
a multi-reboot deployment process.

SYSCFG Options For State Configuration
The following table lists all valid options and arguments along with a description of the expected behavior of each
option.
NOTE: Some of the following options or arguments are not available on all systems.
Table 52. SYSCFG Options and Arguments for State Configuration

Option

Valid Arguments

Description

-b or --byte

Specifies a value to write to state data. The format of the argument
must be in decimal format unless the -x option is given. If the -x option
is given, the value is interpreted as hexadecimal format. The value can
optionally contain 0x. The decimal range is 0–255, and the
hexadecimal range is 0x00–0xFF.

100

Option

Valid Arguments

Description
Example:
A:>syscfg -b 1
The state byte has been set to 1.
A:>syscfg -b 2 -x
The state byte has been set to 0x02.

-r or --read*

NOTE: The
asterisk is not
part of the
command
syntax.

Reads the value of state data. When used with the -x option, the value
is reported in hexadecimal format (0xNN).
Example:
A:>sysfg -r -x
The state byte has been set to 0x02.
A:>syscfg -r
The state byte has been set to 2.

-x or --hex

None

Specifies that a value should be in hexadecimal format.
Example:
A:>sysfg -r -x
The state byte has been set to 0x01.
A:>sysfg -x -b 0x02
The state byte has been set to 0x02.

SYSCFG for System Configuration
SYSCFG enables system configuration and reporting. It reports system identification values, processor types and
speeds, memory size, and detects device using PCI scan.

Options For System Configuration
Table below documents valid options and arguments along with a description of the expected behavior of each option.
Options and arguments are case sensitive. All options and pre-defined arguments are lowercase unless stated
otherwise.
NOTE: Some of the following options or arguments might not be available on all systems. Some of the command
line options are followed by an asterisk. Such options are used for reporting purposes only
Table 53. SYSCFG Options and Arguments for System Configuration

Option

Valid Arguments

Description

--asset

None

Reports the customer-programmable asset tag number for a system.
This option displays the asset tag for a system. For Blade systems, the
SYSCFG utility reports the asset tag for both the server module and
the asset tag for its chassis. For more information on delimiters, see
Command Line Option Delimiters .

101

Option

Valid Arguments

Description
Example:
A:>syscfg --asset
asset=ASSET

--biosver*

None

Reports the BIOS version for a system. If used with the -s option, the
environment variable is set to the BIOS version.
Example:
A:>syscfg --biosver
biosver=A08

--chassvctag*

None

Reports the chassis service tag on blade systems.
Example:
A:>syscfg --chassvctag
chassvctag=SVCTAG1

--cpucount*

None

Reports the number of processors found on the system.
Example 1:
A:>syscfg --cpucount cpucount=1
Example 2:
A:>syscfg --cpucount cpucount=2

--cpuspeed*

None

Reports the speed of all processors in a system.
Example:
A:>syscfg --cpuspeed
cpuspeed=1000MHz

--envfile

Reads the environment variable file (included in DTK as sys.ini ) and
sets environment variables to names in the file, based on the system's
information. Primarily, this command performs a PCI scan and
matches the vendor/device numbers of the devices to those specified
in the environment variable file. For more information, see the
Environment Variable File.
Example:
A:>syscfg --envfile sys.ini
DELLNIC1=INTEL PRO100
DELLNIC2=INTEL PRO100
DVIDEO1=RAGEXL
DIDE1=PEQUR/ROSS IDE
DSCSI1=AIC-7899

--mem*

None

Reports the amount of system memory physically installed in the
system, not the amount of memory available to an operating system. If
used with the -s option, the environment variable is set to the amount
of system memory. The last two characters of the memory value
indicate the order of magnitude used (KB or MB).
Example:
A:>syscfg --mem
mem=256MB

102

Option

Valid Arguments

Description

-n

Specifies an input file to use for resolving PCI vendor and device
numbers to strings. The file must be present (with read rights) and
contain a properly formatted list. For more information, see PCI
Reporting . This option must be used with the pci option.
Example:
A:>syscfg -n pci.txt --pci
PCI Bus: 2, Device: 4, Function: 0
Vendor: 8086 - Intel Corp.
Device: 1229 - 82557/8/9 [Ethernet Pro
100]
Sub Vendor:8086 - Intel Corp.
Sub Device:1017 - EtherExpress
PRO/100+ Dual Port Server Adapter
Slot: 01
Class: 02 - Network
SubClass: 00 - Ethernet

--ovrwrt*

None

When used with the outfile option, this option specifies that the
output file should be overwritten if it exists.
NOTE: This option is applicable only on PowerEdge systems prior
to 12G.
Example:
A:>syscfg -outfile=out.ini --ovrwrt

--pci*

None

Performs a scan of all PCI buses and displays the results. The utility
uses an open source pci.ids file for vendor/device name
resolution. The utility looks for a file called pci.ids in the current
working directory. If the file is not found in the current working
directory, the directory containing the SYSCFG executable is
searched. If the -n option is used to specify a filename, this filename
is used for resolution. If a specific filename is not given and the
pci.ids file cannot be found, Unknown is printed for all vendor and
device codes.
For more information, see PCI Reporting.
Example 1 (the pci.ids filename is specified in the command line
instance ):
A:>syscfg -n pci.ids --pci
PCI Bus: 0, Device: 0, Function: 0
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 1
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 2
Vendor: 1166 - ServerWorks
Device: 0000 - Unknown

103

Option

Valid Arguments

Description
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI

None

Example 2 (the pci.ids file is located in the same directory as the
utility so that names resolve):
A:>syscfg --pci
PCI Bus: 0, Device: 0, Function: 0
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 1
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 2
Vendor: 1166 - ServerWorks
Device: 0000 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI

None

Example 3 (a pci.ids file does not exist) :
A:>syscfg --pci
PCI Bus: 0, Device: 0, Function: 0
Vendor: 1166 - Unknown
Device: 0012 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 1
Vendor: 1166 - Unknown
Device: 0012 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 2
Vendor: 1166 - Unknown
Device: 0000 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI

-s

104

Sets an environment variable to the value of a function command
option. The string argument must be alphanumeric without any spaces
or symbols. The variable name must be in upper case. This option must
be used with at least one function command.

Option

Valid Arguments

Description
Example:
A:>syscfg -s ENVNAME --svctag
ENVNAME=SERVICE

--slot*

None

Reports the slot on a Blade system. If it is not a Blade system, the slot
is reported as 0. If used with the -s option, the environment variable is
set to the slot.
Example 1 (Blade systems) :
A:>syscfg --slot
slot=1
Example 2 (Rack and Tower systems) :
A:>syscfg --slot
slot=0
NOTE: This option is valid only for PowerEdge 1855 systems.

--svctag*

None

Reports the service tag for a system. If used with the -s option, the
environment variable is set to the BIOS version.
Example:
A:>syscfg --svctag
svctag=113CD1S

--sysasset*

None

Reports the system asset tag on Blade systems.
Example:
A:>syscfg --sysasset
sysasset=ASSET01

--sysid*

None

Reports the unique system id bytes for a server. Servers contain a
unique ID value based on their model. The ID value is reported as a
hexadecimal value with a leading 0x, lowercase hexadecimal letters,
and zero-padded to 2 bytes. If used with the -s general option, the
environment variable is set to the system ID.
Example:
A:>syscfg --sysid
sysid=0x00df

--sysname*

None

Reports the system identification string for a server, which is the string
displayed under the Dell logo during POST. If used with the -s option,
the environment variable is set to the system name.
Example:
A:>syscfg --sysname
sysname=PowerEdge 1550/1000

--syssvctag*

None

Reports the system service tag on a Blade system.
Example:
A:>syscfg --syssvctag
syssvctag=BLADE01

105

Option

Valid Arguments

Description

--uuid*

None

Reports the Unique User Identifier (UUID) for a system. The UUID is a
unique system identifier used in PXE requests.
Example:
A:>syscfg --uuid
uuid=44454C4C-5300-104C-8044- B1C04F423131

SYSCFG For IPv6 Configuration
The following table lists all valid options and arguments for IPv6 configuration along with a description of each option.
These options are applicable only if the DRAC on your system supports IPv6.
NOTE: On PowerEdge 12G and later systems, this option is available only with the appropriate installed license.
Table 54. SYSCFG Options and Arguments for IPv6 Configuration

Option

Sub-option

Valid Arguments

Description

lancfgparam
sv6 or
lcpv6

--ipv6

enable,
disable

Enables or disables the IPv6 stack.
A:> syscfg lcpv6 -ipv6=enable

--ipsrcv6=static
--ipaddrv6=

-prefixlengthv6=
-gatewayv6=

Allows you to manually configure IPv6
addresses.
A:>syscfg lcpv6

--ipsrcv6=auto

Automatically configures the IPv6
addresses.
A:>syscfg lcpv6 -ipsrcv6=auto

--dnssrcv6=auto

Automatically configures the DNS
address.
A:>syscfg lcpv6 -dnssrcv6=auto

--dnssrcv6=static
-dnsserver1v6=

Allows you to manually set the DNS
address.

-linklocaladdripv6=

106

--ipsrcv6=static
-ipaddrv6=1234:1234:1234::1
234
--prefixlengthv6=32
-gatewayv6=1234:1234:1234::
1

Allows you to view IPv6 addresses.
A:>syscfg lcpv6 -linklocaladdripv6=134.56.4
5.233

Option

Sub-option
--gatewayv6=

Valid Arguments

Description
Allows you to view IP gatewayv6
address.

PCI Reporting
The scan of the PCI bus uses a file to resolve PCI vendor and device codes to vendor information strings. The format of
the PCI output is as follows:
PCI Bus: 2, Device: 4, Function: 0
Vendor: 8086 - Intel Corp.
Device: 1229 - 82557/8/9 [Ethernet Pro 100]
Sub Vendor:8086 - Intel Corp.
Sub Device:1017 - EtherExpress PRO/100+ Dual Port Server Adapter
Slot: 01
Class: 02 - Network
SubClass: 00 - Ethernet
If the file for vendor resolution is not present, the utility prints Unknown next to a vendor name. If the file for
environment variable names is not present, the utility fails the environment variable operation.
The pci.ids file is located at \DELL\TOOLKIT\TOOLS on Windows systems and /opt/dell/toolkit/bin on Linux systems. For
more information and examples, see the Options For System Configuration.

Environment Variable File
The environment variable file can be used for discovering and recording system information to environment variables.
The file consists of several sections with .ini format that map PCI vendor/device numbers to environment variable
values. The environment variable file is sys.ini in \DELL\TOOLKIT\TOOLS on Windows systems and on Linux systems, you
can find it in /opt/dell/toolkit/bin . For example, the [DELLNIC] section header designates that an environment
variable named dellnic1 should be set to the value of the name or value pair whose name matches the NIC's vendor
or device number. If multiple NICs are present on a system, the environment variables are numbered sequentially:
dellnic1, dellnic2 , and so on
Environmental Variable File Excerpt (sys.ini)
[DELLNIC]
;environment variable will be set to INTELPRO100F for
vendor 8086, dev 1001
8086,1001=INTELPRO1000F
;environment variable will be set to INTELPRO100T for
vendor 8086, dev 1004
8086,1004=INTELPRO1000T
;environment variable will be set to INTELPRO100XT for
vendor 8086, dev 1008
8086,1008=INTELPRO1000XT
The names of the environment variables can be changed in the Variable Names section. If a name is changed, the
section that corresponds to that name must be changed as well.
Also available in the .ini file is a section that maps the system ID number to a string. This string can be used to identify
the system during the discovery phase of deployment. The section name is the environment variable that is set to the
value of the name/value pair whose name matches the system ID. To change the name of the environment variable,

107

change the value of the MACHINE name in the Variable Names section, and change the corresponding section
name.

108

RAIDCFG

This section documents the Deployment Toolkit (DTK) RAID configuration utility. The RAIDCFG utility provides a single
command line tool that can configure all supported RAID controllers.

Features
The RAID configuration utility:
•

Displays help and usage information.

•

Reads configuration options from the Command Line Interface (CLI) parameters.

•

Enumerates RAID controllers, physical disks, and virtual disks.

•

Creates and deletes virtual disks.

•

Logs activity to a given filename.

•

Returns specific error codes and messages.

•

Assigns and unassigns global and dedicated hot spares.
NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), you can find the RAIDCFG utility at \DELL
\x32\TOOLKIT\TOOLS or at \DELL\x64\TOOLKIT\TOOLS. In Linux, you can find it at/opt/dell/toolkit/bin.

Supported RAID Controllers
The RAIDCFG utility supports the following RAID controllers:
•

PERC H310 Adapter, PERC H310 Mini Blade, PERC H310 Mini Monolithic, PERC H310 Embedded, PERC H710 Mini
Blade, PERC H710P Mini Blade, PERC H710 Adapter, and PERC H710 Adapter

•

PERC H200 Integrated, PERC H200 Adapter, PERC H200 Embedded, PERC H700 Integrated, PERC H700 Adapter,
and PERC H800 Adapter

•

PERC 6/E Adapter, PERC 6/I Integrated, and PERC 6/I Adapter

•

PERC 6/I Integrated for blade systems

•

PERC 5/E Adapter, PERC 5/I Integrated, and PERC 5/I Adapter

•

PERC S110, PERC S100, and PERC S300 software controller (Not supported on 64-bit systems)

•

CERC 6/I Integrated

•

SAS 6iR Integrated and SAS 6iR Adapter

•

SAS 5iR Integrated and SAS 5iR Adapter

RAIDCFG Dependencies
For the RAIDCFG utility to run successfully in Windows PE, the mr2kserv, lsivil.dll (for Windows) or lsivil.so (for Linux) and
sasvil.dll (for Windows) or sasvil.so (for Linux) must be in the same directory as RAIDCFG.
The mr2kserv is a service that is automatically started by the DTK startup script. This service is required to configure all
LSI RAID controllers in Windows PE and provides Plug and Play support.

109

RAIDCFG Options And Arguments
Table below lists all of the valid options, parameters, and arguments for the RAIDCFG utility. For more information on
valid RAIDCFG options and their specific uses, see RAID Configuration Utility Options and Arguments.
Mandatory command line options must be present in the command. Optional command line options can be typed in any
order after the mandatory options have been typed. Many options have both a short and long format. Short and long
format options cannot be used in the same command line instance.
Table below shows some examples of valid and invalid short and long format command line instances. For an
explanation of the specific order for each option, see RAID Configuration Utility Options And Arguments. For a list of
frequently used RAID commands, see Quick Reference To RAIDCFG Commands.
NOTE: Some of the following options or arguments might not be available on all systems.
Table 55. RAIDCFG Short and Long Format Options

Option

Valid Arguments

Short Description

Mandatory or Optional

No option

Displays general usage information
for the utility. The usage information
consists of a comprehensive list of
valid options, parameters, and
arguments.

Optional.
See General Help for
specific usage
information.

blink

Blinks the specified physical disks on See Blinking And
the specified controller.
Unblinking Array Disks for
specific usage
information.

cvd
or
createvdisk

Creates a virtual disk.

Cancels the slow or full initialization
on the selected virtual disk.

See Initializing Virtual
Disks for specific usage
information.

Deletes a virtual disk.

See Deleting Virtual Disks
for specific usage
information.

-h
-?
or
/?
-ac or
action

or
cancelinit
dvd
or
deletevdisk

110

NOTE: When providing multiple
physical disks for the
createvdisk command, do not
separate the disks with spaces.
For example, -ad= 1:4, 1:5
causes an error. The correct
syntax for displaying multiple
physical disks is -ad=
1:4,1:5,1:6

See Creating Virtual Disks
for specific usage
information.

Option

Valid Arguments

Short Description

dphs

Disables the controller Persistent Hot See Enabling and
Spare feature for the selected
Disabling Persistent
controller.
Dedicated Hot Spares for
specific usage
information.

or
disablepersistenthot
spare
ephs
or
enablepersistenthots
pare
fgnclr
or
foreignclear

fgnrvr
or
foreignrecover

fi
or
fastinit
lghs
or
listglobalhotspare
rghs
or
removeglobalhotspare
rst

Enables the controller Persistent Hot
Spare feature for the selected
controller.

See Enabling and
Disabling Persistent
Dedicated Hot Spares for
specific usage
information.

Clears the foreign configuration for
the indicated controller.

See Importing and
Clearing Foreign
Configurations for
specific usage
information.

Recovers the Foreign configuration
for the indicated controller.

See Importing and
Clearing Foreign
Configurations for
specific usage
information.

Initializes the virtual disk for the
specified controller using
fastinitcommand.

See Initializing Virtual
Disks for specific usage
information.

Displays the array (physical) disks
used for global hotspare for the
specified controller.

See Assigning,
Unassigning, And Listing
Global Hot Spares for
specific usage
information.

Unassigns all global hot spares to
disks on the specified controller.

See Assigning,
Unassigning, And Listing
Global Hot Spares for
specific usage
information.

Resets the selected controller.

See Resetting The
Controller for specific
usage information.

or
reset
sbf
or
setbootflag
sghs

Mandatory or Optional

Sets the indicated virtual disk as boot See Setting A Virtual Disk
As Bootable Virtual Disk
VD on the indicated controller.
for specific usage
information.
Assigns the specified disks as global
hot spares on the specified
controller.

Optional. SeeAssigning,
Unassigning, And Listing
Global Hot Spares for

111

Option

Valid Arguments

Short Description

specific usage
information.

or
setglobalhotspare
sli
or
slowinit
svdn
or
setvdname
-ad or
adisk

Mandatory or Optional

Initializes the virtual disk for the
specified controller using the
slowinit command.

See Initializing Virtual
Disks for specific usage
information.

Sets the name of the specified virtual See Assigning,
Unassigning, And Listing
disk on the specified controller.
Global Hot Spares for
specific usage
information.

Specifies an array disk command.

See Enumerating Array
Disks for specific usage
information.

ch:targ,
ch:targ, ...
or ch:targ:lun,...
or ch:targ:enc
channel:target, or
channel:target:lun,
or
channel:target:enclo
sure

Specifies an array disk.
For SCSI controllers, the value of
LUN should always be 0.
For SAS controllers, the value of
enclosure can be non-zero, in which
case you must specify values for
channel, target, and enclosure.

Optional.
See Enumerating Array
Disks for specific usage
information.

-c or
controlleri
d

Specifies a RAID controller.

See Enumerating RAID
Controllers for specific
usage information.

-cp or
cachepolicy

d, c or d, e

Specifies the cache policy for reads
on a specified virtual disk or disk
cache policy.

Optional.
See Creating Virtual Disks
for specific usage
information.

-ctrl or
controller

Displays a list of the supported RAID
controllers in the system, along with
select property information.

Mandatory, must be typed
in the correct order.
See Enumerating RAID
Controllers for specific
usage information.

-envc or
envcommand

Sets a user-defined environmental
variable () to the value
returned from a function call.

See Setting Environment
Variables for specific
usage information.

-envn or
envname

Sets the environment variable
() that equates to the value
returned from a function call.

See Setting Environment
Variables for specific
usage information.

112

NOTE: You can also use
pdiskor -pd instead of
adiskor -adto specify an
array disk.

Option

Valid Arguments

Short Description

Mandatory or Optional

-fd or
failoverdri
ve

ch:targ, ch:targ, ...
or ch:targ:lun,...
or ch:targ:enc
channel:target, or
channel:target:lun,
or
channel:target:enclo
sure

Specifies the location of the failover
drive in an array.
For SCSI controllers, the value of
LUN should always be 0.
For SAS controllers, the value of
enclosure can be non-zero, in which
case you must specify values for
channel, target, and
enclosure.

Optional.
See Creating Virtual Disks
for specific usage
information.

NOTE: From DTK 2.4 onwards,
the -fd option creates
dedicated hot spares instead of
global hot spares. To set global
hot spares, see Assigning,
Unassigning, And Listing Global
Hot Spares.
-i

Reads the RAID configuration
information from the given .ini
filename and creates the RAID
configurations on the specified
controllers.

Mandatory.
See Miscellaneous
Options for specific usage
information.

-l or
logfile

Logs command line output to a file.

Optional.
See Miscellaneous
Optionsfor specific usage
information.

-o

Reads the RAID configurations from
all available controllers and write
these configurations in the given .ini
filename.

Mandatory.
See RAID Replication
Options for specific usage
information.

-r or raid

Sets the RAID level for the array.
Valid RAID values are 0, 1, 5,
10, 50.
If no value is specified for RAID, 0is
taken as the default level.

Optional.
See Creating Virtual Disks
for specific usage
information.

-rp or
readpolicy

ra, ara, nra, rc,
nrc

Sets the read policy for the virtual
disk.

Optional.
See Creating Virtual Disks
for specific usage
information.

-se or
setenvironm
ent

Sets a user-defined environment
variable to the value returned from
the function call. The function calls
are:
getcontrollerslots,
getfirmware,
getcontrollertype,
getadisks,
getadiskcount,
getfreeadisks,
getfreeadiskcount,

Mandatory.
See Setting Environment
Variables for specific
usage information.

113

Option

Valid Arguments

Short Description

Mandatory or Optional

getfreeadisksize, and
gethotspares.
-si or
silent

Does not display any information on
the terminal console.

Optional.
See Miscellaneous
Options for specific usage
information.

-sp or
spanlength

The span size of RAID 5, which is a
mandatory parameter for RAID 50.

Mandatory.
See Creating Virtual Disks
for specific usage
information.

NOTE: Spanlength is applicable
for RAID 10, RAID 50, and RAID
60. The minimum permissible
spanlength value is 2for RAID
10, 3for RAID 50 and 4for RAID
60. The number of array disks for
creating virtual disks should not
be a prime number and should
be divisible by the specified
spanlength.
-sz or size

Sets the maximum size on the virtual
disk in MB or GB if the size is not
provided.
The default size is in MB. If GB
follows the number, the size is
expressed in GB.

-ssz or
stripesize

Sets the stripe size on the virtual disk Optional.
in KB.
See Creating Virtual Disks
for specific usage
NOTE: When creating virtual
information.
disks, do not specify the units for
chunk (stripe) size. The units are
always listed in KB.

-vd or
vdisk

Displays the virtual disks under all of See Enumerating Virtual
the controllers along with the
Disks for specific usage
physical array disks that make up the information.
virtual disks.

Displays the specified virtual disk.

Optional.
See Enumerating Virtual
Disks for specific usage
information.

-ver or
version

Displays the version number of the
utility.

Optional.
See Miscellaneous
Options for specific usage
information.

-wp or
writepolicy

wb, wt, wc, nwc, fwb

Sets the write policy for a virtual
disk. The valid arguments are: wb
(writeback caching), wt (write-

Optional.
See Miscellaneous
Options for specific usage
information.

114

Optional.
See Creating Virtual Disks
for specific usage
information.

Option

Valid Arguments

Short Description

Mandatory or Optional

through caching), wc (writecaching), nwc (no-write-caching),
and fwb (force-write-back).

RAID Configuration Utility Options And Arguments
The following tables document valid options, parameters, and arguments along with a description of the expected
behavior of each option. Options, parameters, and pre-defined arguments are case-sensitive and entered in lowercase,
unless stated otherwise. The information is grouped by task in the following sections:
•

General Help

•

Enumerating RAID Controllers

•

Creating Virtual Disks

•

Enumerating Array Disks

•

Blinking And Unblinking Array Disks

•

Enumerating Virtual Disks

•

Deleting Virtual Disks

•

Setting A Virtual Disk As Bootable Virtual Disk

•

Blinking And Unblinking Virtual Disks

•

Setting Virtual Disk Name

•

Setting Environment Variables

•

RAID Replication Options

•

Assigning, Unassigning, And Listing Global Hot Spares

•

Importing and Clearing Foreign Configurations

•

Initializing Virtual Disks

•

Resetting The Controller

•

Enabling and Disabling Persistent Dedicated Hot Spares

•

Miscellaneous Options
NOTE: Some of the following options or arguments may not be available on all systems.

General Help
The following table lists the RAIDCFG general help options.
Table 56. General Help

Option

Parameters

Valid Arguments

Description

No option-h

Displays general usage information for the
utility. The usage information consists of a
comprehensive list of valid options,
parameters, and arguments. This option is
optional and can be added to the command
line in any order.

-?
or
/?

115

Option

Parameters

Valid Arguments

Description
Example:
A:>raidcfg -h
RAIDCFG v4.2
Copyright (c) 2002-2012 Dell
Inc.
[raidcfg]
Help: options in <> are
mandatory and options in []
are optional and can be in any
order after mandatory ones.
raidcfg -h
Provides users with general
help options that may beused
with this utility.
raidcfg
raidcfg <-ctrl>
Lists all controllers on the
host and selects property
information.
—output continues, listing all
possible
option/parameter/argument
combinations—

Enumerating RAID Controllers
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating RAID controllers.
Table 57. Enumerating RAID Controllers

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-ctrl or
controller

Lists all the RAID controllers on the host
system, along with select property
information. This option is mandatory
Example:
Controller_ID/Slot_ID: 0
Controller_PCI_ID: 2:14:0
Controller_Name: PERC 6/E
Channels: 2
No.of Virtual_Disks: 1
Array_Disks:
0:0:0,1:2:0,1:3:0,1:4:0,1:5:0
Firmware Version: 5130
Controller_ID/Slot_ID: 3
Controller_PCI_ID: 3:11:0

116

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
Controller_Name: PERC 6/E
Channels: 2
No.of Virtual_Disks: 0
Firmware Version: 3500
RAIDCFG Command successful!

-c or
controllerid

Displays the properties for the RAID controller
with the specified controller ID. This option
combination is mandatory.
Example:
A:>raidcfg -ctrl -c=2
Controller_ID/Slot_ID: 2
Controller_PCI_ID: 8:14:0
Controller_Name: PERC 6/E
Channels: 2
Virtual_Disks: 1
Firmware Version: 521S
RAIDCFG Command successful!

Creating Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for creating virtual disks.
NOTE: If you create a virtual disk on Windows PE, you must reboot your system.

117

Table 58. Creating Virtual Disks

Mandatory Options
and Arguments

Optional Parameters

-ctrl -ac=cvd - NA
c=id -ad=
ch:targ,ch:tar
g,
... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,...
channel:target
: lun,...
[or
channel:target
:
enclosure,...]
-cp or
cachepolicy

Valid Parameters
Arguments

Description

Creates a virtual disk comprising the
properties supplied. This option combination is
mandatory.
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
Example:
A:>raidcfg -ctrl -ac=cvd
-c=2
-ad=1:4,1:8 -r=1 -ssz=32
-cp=d -rp=nra
-wp=wt -fd=1:1
RAIDCFG Command successful!

d, c or d, e

Sets the cache policy or disk cache policy.
The valid arguments for cache policy are:.
•
•

d — (Direct I/O) Reads are not
buffered in cache memory.
c — (Cache I/O) All reads are
buffered in cache memory.
NOTE: Cache policy is not supported on
controllers that do not have a battery.

Valid arguments for disk cache policy are:
•
•

d — Disable
e — Enable

The -cp option is optional and can be added
to the command line in any order after the
mandatory option combination.
-fd or
failoverdrive

ch:targ, ch:targ, ... or
ch:targ:lun,... or
ch:targ:enc
channel:target, or
channel:target:l un, or
channel:target:
enclosure

Sets the failover drive for the virtual disk. The
-fd option is optional and can be added to
the command line in any order after the
mandatory option combination.
NOTE: From DTK 2.4 onwards, the -fd
option creates dedicated hot spares
instead of global hot spares. For
information about setting global hot
spares, see Assigning, Unassigning, And
Listing Global Hot Spares.
For SCSI controllers, the value of LUN should
always be 0.

118

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.

-r or -raid

0, 1, 5, 6, 10, 50, 60

Sets the RAID type or level for the virtual disk.
NOTE: If this option is not specified for
any RAID controller, RAID 0 is taken as
the default.
The valid arguments are:
•

•

0 — RAID 0 uses data striping, which
is writing data in equal-sized
segments across the array disks.
RAID 0 does not provide data
redundancy.
1 — RAID 1 is the simplest form of
maintaining redundant data. In RAID
1, data is mirrored or duplicated on
one or more drives.
5 — RAID 5 provides data redundancy
by using data striping in combination
with parity information. Rather than
dedicating a drive to parity, the parity
information is striped across all disks
in the array.
6 — RAID 6 is an extension of RAID 5
and uses an additional parity block. It
uses block-level striping with two
parity blocks distributed across all
member disks. RAID 6 provides
protection against double disk failures
and failures while a single disk is
rebuilding. In case there is only one
array, RAID 6 may be a better option
than a hotspare disk.
10 — RAID 10 is a stripe of mirrors.
Multiple RAID 1 mirrors are created,
and a RAID 0 stripe is created over
these.
50 — RAID 50 is a dual-level array
that uses multiple RAID 5 sets in a
single array. A single hard drive
failure can occur in each of the RAID
5 without any loss of data on the
entire array. Although the RAID 50 has
increased write performance, when a
hard drive fails and reconstruction
takes place, performance decreases,
data/program access is slower, and
transfer speeds on the array are
affected.
60 — RAID 60 is a combination of
RAID 6 and RAID 0. A RAID 0 array is
striped across RAID 6 elements. It
requires at least 8 disks.

119

Mandatory Options
and Arguments

Optional Parameters

-ctrl -ac=cvd - -rp or
c=id -ad=
readpolicy
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,
channel:target
: lun,...
[or
channel:target
:
enclosure,...]

Valid Parameters
Arguments

Description

ra, ara, nra, rc, nrc

CAUTION: If the controller is changed
from SCSI to RAID mode, expect data loss
to occur. Back up any data you want to
save before changing the modes.
Sets the SCSI read policy for the virtual disk.
Specify the SCSI read policy for the logical
drive. The valid arguments are:
•
•

•

ra — (read-ahead) The controller
reads sequential sectors of the disk
when seeking data.
ara — (Adaptive Read-Ahead) The
controller initiates read-ahead only if
the two most recent read requests
accessed sequential sectors of the
disk. If subsequent read requests
access random sectors of the disk,
the controller reverts to No-ReadAhead policy. The controller
continues to evaluate whether or not
read requests are accessing
sequential sectors of the disk and can
initiate read-ahead if necessary.
nra — (No-Read-Ahead) The
controller does not read sequential
sectors of the disk when seeking data.
NOTE: The ra, ara, and nra options are
supported on the following RAID
controllers only:
•
•
•
•

-ctrl -ac=cvd - -sp or
c=id -ad=
spanlength
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,...
channel:target
: lun,...

120

PERC 5/E Adapter, PERC 5/I
Integrated, PERC 5/i Adapter
PERC 6/i Integrated, PERC 6/i
Adapter, PERC 6/E Adapter
rc — (Read-Caching) Enables
read caching.
nrc — (No-Read-Caching)
Disables read caching.

Creates a virtual disk comprised of the
properties supplied. The -spoption is optional
and can be the added to the command line in
any order after the mandatory option
combination.
NOTE: Spanlength is applicable only for
RAID 50 and RAID 60. The minimum
permissible spanlength value for RAID 50
is 3 and for RAID 60 is 4. The number of
array disks for creating a virtual disk
should not be a prime number and should
be divisible by the specified spanlength.

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

[or
channel:target
:
enclosure,...]

Description
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.

Sets the stripe size for the virtual disk. The
stripe size is the amount of array disk space
used on each array disk included in the stripe.
A valid argument is a number that is less than
the size of the virtual disk. The -sszoption is
optional and can be added to the command
line in any order after the mandatory option
combination. However, do not specify a unit
for stripe size when creating virtual disks. The
unit is always displayed in KB.
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.

-ctrl -ac=cvd - -str or strict
c=id -ad=
ch:targ,ch:tar
g , ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,
channel:target
: lun,... [or
channel:target
: enclosure,..

Strict (-str parameter) is the percentage of
expected array disk utilization.
Example:
A:> raidcfg -ctrl -ac=
cvd -c=0 -ad=0:0,0:1 r=1 -str=20

-ctrl -ac=cvd
-c=id -ad=
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target

-ctrl -ac=cvd - -ssz or
stripesize
c=id -ad=
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,
channel:target
: lun,...
[or
channel:target
:
enclosure,...]

-sz or -size

If the unused portion of an array disk is
greater than the above percentage, raidcfg
aborts.
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
Sets the maximum size of the virtual disk in
MB or GB. A valid argument is a number
representing the maximum size for the virtual
disk. The -szoption is optional and can be the
added to the command line in any order after
the mandatory option combination.
The minimum virtual disk size that you can
create for various controllers is given below.
•

For PERC 5 controllers:
–

RAID 0: 100 MB

121

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

: lun,...
channel:target
: lun,... [or
channel:target
:
enclosure,...]

Description

•

– RAID 1: 100 MB
– RAID 5: 100 MB
For PERC 6 controllers:

•

– RAID 0: 100 MB
– RAID 1: 100 MB
– RAID 5: 100 MB
– RAID 6: 100 MB
– RAID 60: 100 MB
For PERC 7 and PERC 8 controllers:

•

– RAID 0: 100 MB
– RAID 1: 100 MB
– RAID 5: 100 MB
– RAID 6: 100 MB
– RAID 10: 100 MB
– RAID 50: 100 MB
– RAID 60: 100 MB
Software RAID controllers:
–
–
–
–

RAID 0: 100 MB
RAID 1: 100 MB
RAID 5: 100 MB
RAID 10: 100 MB

NOTE: If this option is not provided,
RAIDCFG determines the maximum
possible virtual disk size and creates it.
-wp or
writepolicy

wb, wt, wc, nwc

Sets the write policy for the virtual disk. The
valid arguments are:
•

•

wb — Write-Back caching sets the
controller to send a write-request
completion signal as soon as the data
is in the controller cache but has not
yet been written to disk.
wt — Write-Through caching sets the
controller to send a write-request
completion signal only after the data
is written to the disk.
NOTE: The wb and wt options are
supported on the following RAID
controllers only:
•
•
•

122

PERC 5/E Adapter, PERC 5/I
Integrated, PERC 5/i Adapter
PERC 6/i Integrated, PERC 6/i
Adapter, PERC 6/E Adapter
PERC 7 and PERC 8

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
•

•

wc — Write-Caching sets the
controller to send a write-request
completion signal only after the data
is written to the disk.
nwc — No-Write-Caching specifies
that the controller does not send a
write-request completion signal after
the data is written to the disk.
NOTE: The -wpoption is optional and can
be added to the command line in any
order after the mandatory option
combination.

For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.

Enumerating Array Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating array disks (hard
drives).
NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk.
Table 59. Enumerating Array Disks (Hard Drives)

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-ad -c=id or
adisk
controllerid=i
d

Lists all the array disks attached to the
specified RAID controller. This option
combination is mandatory.
NOTE: The following example displays
output of a Series 7 controller.
NOTE: Software controller does not
display the NegSpeed, CapSpeed,
Certified and Supported
parameters.
Example:
A:>raidcfg -ad -c=2
Controller: PERC H700 Adapter
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD

123

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:0:1
Size: 139392 MB (136 GB)
Avail: 0 MB
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:1:1
Size: 139392 MB (136 GB)
Avail: 0 MB
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:2:1
Size: 139392 MB (136 GB)
Avail: 139392 MB (136 GB)
RAIDCFG Command successful!
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:3:1
Size: 139392 MB (136 GB)
Avail: 139392 MB (136 GB)
****** Physical Drive ******
Vendor: DELL
Model: ST9146802SS
Protocol: SAS

124

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
Media: HDD
NegSpeed: 3072 Mbps
CapSpeed: 3072 Mbps
Certified: YES
Supported: YES
Location: 0:4:1
Size: 139392 MB (136 GB)
Avail: 139392 MB (136 GB)
RAIDCFG Command successful!
Lists the array disks that make up the virtual
disk on the specified RAID controller. This
option combination is mandatory.
Example:
A:>raidcfg -ad -c=2 -vd=0
Controller: PERC 6/E
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:0:0
Drive Size: 34680 MB
Drive Avail: 0 MB

-vd=id or
vdisk=id

****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
RAIDCFG Command successful!
-ad -c=id or
adisk
controllerid=i
d

-ad=
ch:targ,ch:t
arg,... adisk=
channel:tar
get,
channel:tar
get,...

Displays information about the specified array
disk. This option combination is mandatory.
Example:
A:>raidcfg -ad -c=2 -ad=
0:1,0:2
Controller: PERC 6/E
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:2:0
Drive Size: 34680 MB
Drive Avail: 34680 MB
RAIDCFG Command successful!

125

Blinking And Unblinking Array Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for blinking and unblinking array
disks (hard drives).
NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk.
Table 60. Blinking And Unblinking Array Disks

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-ad -ad=
ch:targ,ch:tar
g ,... ac=blink c=id or adisk
adisk=
channel:target
,
channel:target
,... -ac=blink
controllerid=
id vdisk=id

Blinks the specified physical disks on the
specified controller.
Example:
A:>raidcfg -ad -ad=0:1,0:2
ac=blink -c=2
Controller: PERC 6/E
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:2:0
Drive Size: 34680 MB
Drive Avail: 34680 MB
RAIDCFG Command successful!

-ad -ad=
ch:targ,ch:tar
g ,... -ac=
unblink -c=id
or adisk adisk=
channel:target
,
channel:target
,... -ac=
unblink
controllerid=
id vdisk=id

Unblinks the specified physical disks on the
specified controller.
Example:
A:>raidcfg -ad -ad=0:1,0:2
ac=unblink -c=2
Controller: PERC 6/E
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:2:0
Drive Size: 34680 MB
Drive Avail: 34680 MB
RAIDCFG Command successful!

Enumerating Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating virtual disks.

126

Table 61. Enumerating Virtual Disks

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

—vd or vdisk

Lists all the virtual disks for each controller
along with the array disks that make up each
virtual disk. This option is mandatory.
Example:
A:>raidcfg -vd
Controller: PERC 6/E
Virtual disk not found
Controller: PERC 6/E
VDisk ID: 0
Size: 34680 MB
Type: RAID 1
Read Policy: Normal Read Ahead
Write Policy: Writeback
Cache Policy: Direct_IO
Drives: 0:0:0,0:1:0
Controller: PERC 6/E
Virtual disk not found
Controller: PERC 6/E
Virtual disk not found
RAIDCFG Command successful!

-vd or vdisk

-c or
controller id

Lists all the virtual disks under the indicated
controllers. Each virtual disk is displayed with
the physical disk that comprises it. The -c
option is optional and can be added to the
command line in any order after the
mandatory option.
Example:
A:>raidcfg -vd -c=2
Controller: PERC 6/E
VDisk ID: 0
Size: 34680 MB
Type: RAID 1
Read Policy: Normal Read Ahead
Write Policy: Writeback
Cache Policy: Direct_IO
Drives: 0:0:0,0:1:0
RAIDCFG Command successful!

-vd -c=id or
vdisk
controllerid=
id

-vd or vdisk

Displays details about a single virtual disk
under the indicated controller. The -vd -c= id
option combination is mandatory. The second
-vd option is optional and can be added to the
command line in any order after the
mandatory option combination.
Example:
A:>raidcfg -vd -c=2 -vd=0
Controller: PERC 6/E
VDisk ID: 0
Size: 34680 MB
Type: RAID 1
Read Policy: Normal Read Ahead
Write Policy: Writeback

127

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
Cache Policy: Direct_IO
Drives: 0:0:0,0:1:0
Dedicated HS: 1:2:0
RAIDCFG Command successful!

Deleting Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for deleting virtual disks.
Table 62. Deleting Virtual Disks

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-vd -ac=dvd c=id
or
vdisk
action=deletev
disk
controllerid=i
d

Deletes all virtual disks on the indicated
controller. This option combination is
mandatory.
Example:
A:>raidcfg -vd -ac=dvd -c=2

-vd -ac=dvd c=id
or
vdisk
action=deletev
disk
controllerid=i
d

-vd or vdisk

RAIDCFG Command successful!

Deletes the indicated virtual disk on the
indicated controller. The -vd- ac=dvd -c
=id option combination is mandatory. The
second -vd option is optional and can be
added to the command line in any order after
the mandatory option.
Example:
A:>raidcfg -vd -ac=dvd -c=2 vd=0
RAIDCFG Command successful!

NOTE: When virtual disks are created, the RAID controller starts the background initialization operation. Virtual
disks cannot be deleted until this operation completes. This limitation affects mostly CERC SATA controllers.
NOTE: If the raid.ini file contains the [Reset] section, then the RAIDCFG utility removes all the hot spares (dedicated
and global) and virtual disks on the specified RAID controllers in the system.

Setting A Virtual Disk As Bootable Virtual Disk
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting a virtual disk as a
bootable virtual disk.
Table 63. Setting A Virtual Disk As Bootable Virtual Disk

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-vd -ac=sbf c=id or vdisk
action=

-vd or vdisk

Sets the specified virtual disk as bootable
virtual disk on the specified controller.

128

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

setbootflag
controllerid=
id

Description
Example:
A:>raidcfg -vd -ac=sbf -c=2 vd=0
RAIDCFG Command successful!

Blinking And Unblinking Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for blinking or unblinking a
physical disk associated with a virtual disk.
Table 64. Blinking And Unblinking Virtual Disks

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-vd -vd=id
ac=blink -c=id
or vdisk
vdisk=id
action=blink
controllerid=i
d

Blinks the physical disks associated with the
specified virtual disk on the specified
controller.
Example:
A:>raidcfg -vd -vd=2 -ac=blink
-c=2
RAIDCFG Command successful!

-vd -vd=id
ac=unblink c=id or vdisk
vdisk=id
action=blink
controllerid=i
d

Unblinks the physical disks associated with
the specified virtual disk on the specified
controller.
Example:
A:>raidcfg -vd -vd=2 -ac=blink
-c=2
RAIDCFG Command successful!

Setting Virtual Disk Name
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting the name of a virtual
disk on a controller.
Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-vd -vd=id ac=svdn - vdn=
c=id or vdisk
vdisk= id
action=
setvdname
vdname=
controllerid=
id

Sets the name of the specified virtual disk on
the specified controller.
Example:
A:>raidcfg -vd -vd=2 -ac=svdn vdn=xxx -c=2
RAIDCFG Command successful!

129

Setting Environment Variables
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting the CLI environment.
Table 65. Setting Environment

Mandatory Options and
Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-se envn=
-envc=
or
setenvironment
envname=
envcommand=

Sets a user-defined environment variable to
the value returned from the
getcontrollerslots function call.
This option combination is mandatory.
Example:
A:>raidcfg -se -envn=CNTRL envc=getcontrollerslots
CNTRL=0 1 2
RAIDCFG Command successful!

-se envn=
-envc=
or
setenvironment
envname=
envcommand=

-f or filename

Captures the environment output to the
given filename. This option either appends
the information to an existing file or creates
a new file.

-se envn=
- envc=
-c=id
or
setenvironment
envname=
envcommand=
controllerid=id

Sets a user-defined environment variable to
the value returned from the
getfirmware,
getcontrollertype, getadisks,
getadiskcount,
getfreeadisks,getfreeadiskcou
nt, getfreeadisksize, or
gethotspares function call. This option
combination is mandatory.
Example:
A:>raidcfg -se -envn=FIRMWARE
-envc=getfirmware -c=2
FIRMWARE=531T
RAIDCFG Command successful!

Function Calls of Setenvironment Option
The following table lists the function calls of the setenvironment option.
Table 66. Function Calls of the setenvironment Option

Function Call

Description

getfirmware

Returns the firmware version of the specified controllers.

130

Function Call

Description
Example:
A:>raidcfg -se -envn=FIRMWARE -envc=
getfirmware -c=2
FIRMWARE=531T
RAIDCFG Command successful!

getcontrollertype

Returns LSI for LSI controllers and ADAP for Adaptec controllers.
Example:
A:>raidcfg -se -envn=CONTROLLERTYPE -envc=
getcontrollertype -c=2
CONTROLLERTYPE=LSI
RAIDCFG Command successful!

getadisks

Returns the array disks attached to the controller.
Example:
A:>raidcfg -se -envn=ADISKS -envc=getadisks -c=2
ADISKS=0:0:1,0:1:1,0:2:1
RAIDCFG Command successful!

getfreeadiskcount

Returns the number of free array disks found in the specified controller.
Example:
A:>raidcfg -se -envn=FREEADISKCOUNT -envc=
getfreeadiskcount -c=2
FREEADISKCOUNT=2
RAIDCFG Command successful!

getfreeadisksize

Returns the total size of the free array disks in megabytes.
Example:
A:>raidcfg -se -envn=FREEADISKSIZE -envc=
getfreeadisksize -c=2
FREEADISKSIZE=15346
RAIDCFG Command successful!

gethotspares

Returns the global hot spares (global failover disks) found on the specified controller.
Example:
A:>raidcfg -se -envn=HOTSPARES -envc=
gethotspares -c=2
HOTSPARES=1:8:1,1:9:1
RAIDCFG Command successful!

131

Function Call

Description

getfreeadisks

Returns the free array disks.
A:>raidcfg -se -envn=GETFREEADISKS -envc=
getfreeadisks -c=2
GETFREEADISKS=0:3:1,0:4:1
RAIDCFG Command successful!
Returns the total number of array disks.
A:>raidcfg -se -envn=GETADISKCOUNT -envc=
getadiskcount -c=2

getadiskcount

GETADISKCOUNT=1
RAIDCFG Command successful!

RAID Replication Options
The following table lists the RAID replication options.
Table 67. RAID Replication Options

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-i

Reads the RAID configuration information
from the given .ini filename and creates the
RAID configurations on the specified
controllers. This option is mandatory.
Example:
A:> raidcfg -i=\tmp\raid.ini

-o

Reads the RAID configurations from all
available controllers and writes these
configurations in the raid.ini file under
the /tmp directory (in Linux systems). This
option is mandatory.
Example:
A:> raidcfg -o=\tmp\raid.ini
The contents of the raid.ini
file are:
[vdisk0]
controllerid=0
size=123456
raid=5
readpolicy=ra
writepolicy=wt
stripesize=32
cachepolicy=d
adisk=0:0:1,0:1:1,0:2:1
[vdisk1]
controllerid=0
size=65345
raid=1
readpolicy=ra
writepolicy=wt

132

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
stripesize=64
cachepolicy=d
adisk=0:3:1,0:4:1
NOTE: If the controller uses global hot
spares, the raid.ini file contains the
following section:
[GlobalHotspare0]
controllerid=0
failoverdrive=0:8:0

Assigning, Unassigning, And Listing Global Hot Spares
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for assigning and unassigning
global hot spares.
Table 68. Assigning, Unassigning, and Listing Global Hot Spares

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-ctrl -ac=sghs
-c=id -ad|-pd=
ch:targ:encl

Assigns the specified disk as a global hot
spare on the controller. You can assign only
one disk at a time.
Example:
A:>raidcfg -ctrl -ac=sghs -c=2
-ad=0:1

or
controller
action=setglob
alhotspare
controllerid=i
d adisk|
pdisk=channel:
target:enclosu
re

RAIDCFG Command successful!

-ad|-pd ac=lghs -c=id
or adisk|pdisk
action=listglo
balhotspare
controllerid=i
d

-ctrl —ac=rghs
-c=id -ad|-pd=
ch:targ:encl or
controller
action=removeg
lobalhotspare
controllerid=i
d adisk|
pdisk=channel:
target:enclosu
re

Displays the array (physical) disks used for
global hotspare for the specified controller.
Example:
A:>raidcfg -ad -ac=lghs -c=2
RAIDCFG Command successful!

Unassigns all the specified global hot spares
to a disk on the specified controller.
Example:
A:>raidcfg -ctrl -ac=rghs -c=2ad=0:1,0:2
RAIDCFG Command successful!

133

Importing And Clearing Foreign Configurations
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for foreign configurations.
Table 69. RAIDCFG Options for Foreign Configurations

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-ctrl -c=id ac=fgnimp

Imports the foreign configuration detected in
the selected controller. This feature is
supported on PERC 5 and later controllers and
is not supported on SAS controllers.
If you use this argument on a controller that
does not have a foreign configuration, the No
Foreign configuration present
in the controller message is
displayed.
Example:
A:>raidcfg -ctrl -c=2 ac=fgnimp

Clears the foreign configuration detected in
the selected controller. This feature is
supported on PERC 5 and later controllers and
is not supported on SAS controllers..
If you use this argument on a controller that
does not have a foreign configuration, the No
Foreign configuration present
in the controller message is
displayed.
Example:
A:>raidcfg -ctrl -c=2 ac=fgnclr

Recovers the foreign configuration detected in
the selected controller. This feature is
supported on PERC 5 and later controllers and
is not supported on SAS controllers.
If you use this argument on a controller that
does not have a foreign configuration, the No
Foreign configuration present
in the controller message is
displayed.
Example:
A:>raidcfg -ctrl -c=2 ac=fgnrvr

or
controller
controllerid=i
daction=foreig
nimport

-ctrl -c=id ac= fgnclr
or
controllercont
rollerid=id
foreignclear

-ctrl -c=id
-ac=fgnrvr
or
controller
controllerid=i
d
action=foreign
recover

Initializing Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for initializing selected virtual
disks.

134

Table 70. Initializing Virtual Disks

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-vd -c=id vd=id -ac=fi or
vdisk
controllerid=i
d vdisk=id
action=fastini
t

Initializes the selected virtual disk in the
selected controller with the fastinit command.
This feature is supported on PERC 5 and later
controllers and is not supported on SAS
controllers.
Using the fastinit command on unsupported
controllers returns an error.
Example:
A:>raidcfg -vd -c=2 -vd=2 ac=fi

-vd -c=id vd=id -ac=sli
or vdisk
controllerid=i
d vdisk=id
action=slowini
t

Initializes the selected virtual disk in the
selected controller with the slowinit
command. This feature is supported on PERC 5
and later controllers and is not supported on
SAS controllers. Using the slowinit command
on unsupported controllers returns an error.
Example:
A:>raidcfg -vd -c=2 -vd=2 ac=sli

-vd -c=id vd=id -ac=ci or
vdisk
controllerid=i
d vdisk=id
action=canceli
nit

Cancels the initialization of the virtual disk
with the cancelinit command. This feature is
supported on PERC 5 and later controllers and
is not supported on SAS controllers. Using the
cancelinit command on unsupported
controllers returns an error.
Example:
A:>raidcfg -vd -c=2 -vd=2 ac=ci

Resetting The Controller
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for resetting the controller.
Table 71. Resetting The Controller

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

-ctrl -c=id ac=rst or
controller
controllerid=i
d action=reset

Resets the specified controller.
Example:
A:>raidcfg -ctrl -c=2 -ac=rst

Enabling And Disabling Persistent Dedicated Hot Spares
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enabling and disabling
dedicated hot spares.

135

Table 72. Enabling And Disabling Persistent Dedicated Hot Spares

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

--ctrl -c=id ac=ephs
or
controller
controllerid=i
d
action=enablep
eristenthotspa
re

Assigns the slot corresponding to the hot
spare drive as persistent. Any drive in the slot
functions as a hot spare if the drive is qualified
to be a hot spare.
Example:
A:>raidcfg -ctrl -ac=ephs -c=2

--ctrl -c=id ac=dphs
or
controller
controllerid=i
d
action=disable
persistenthots
pare

RAIDCFG Command successful!
NA

Disables the persistent slot corresponding to
the hot spare drive. If the drive is removed
from the slot and any drive is inserted, the slot
stops functioning as a hot spare. You must
manually assign the drive as a hot spare
again.
Example:
A:>raidcfg -ctrl -ac=dphs -c=2
RAIDCFG Command successful!

Miscellaneous Options
The following table lists all other RAIDCFG options, parameters, and pre-defined arguments.
Table 73. Miscellaneous Optional Parameters

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description

any option

-l or logfile

Logs command line output to a file. The utility
either appends the information to an existing
log file or creates a new file. The log file
contains the same information as standard
output. This option is optional and can be
added to the command line in any order after
the mandatory options have been added.
Example:
A:>raidcfg -ctrl -l=log.txt
Controller_ID/Slot_ID:
Controller_PCI_ID:
Controller_Name:
PERC 6/E
Channels:
Virtual_Disks:
Firmware Version:
V2.8-0[6064]

0
4:2:1
Dell
2
0

RAIDCFG Command successful!
-si or silent

136

Does not display any information on the
terminal console. This option is optional and
can be added to the command line in any

Mandatory Options
and Arguments

Optional Parameters

Valid Parameters
Arguments

Description
order after any mandatory options have been
added.
Example:
A:>raidcfg -ctrl -si

-ver or
version

Displays the version number of the RAIDCFG
utility. This option is optional and can be
added to the command line in any order after
any mandatory options have been added.
Example:
A:>raidcfg -ver

Quick Reference To RAIDCFG Commands
The following table lists the basic RAIDCFG commands.
Purpose

Command

Description

To list all the RAID
controllers in a system

raidcfg -ctrl

Lists all the RAID controllers in the system.
Record the slot ID of the controllers for later reference.
Example:
A:>raidcfg -ctrl -ac=sghs -c=2 -ad=0:1
RAIDCFG Command successful!

To list all the disks attached raidcfg adisk c=slotid
to a particular controller

Lists all the disks attached to the controller. The slot ID is
obtained from the first command.
Record the drive location of the disks for later reference.

To create a virtual disk with raidcfg -ctrl ac=cvd -c=slotid all the default settings
ad= x:y,x:y,...

Creates a virtual disk of maximum available size for type
RAID 0. RAID 0 is the default.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands.

To create a virtual disk of a
certain size with all the
default settings

raidcfg -ctrl ac=cvd -c=slotid ad= x:y,x:y,... sz=5GB

Creates a virtual disk of 5 GB size for type RAID 0. RAID 0
is the default.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands.

To create a virtual disk of a
certain size and make it
RAID 1

raidcfg -ctrl ac=cvd -c=slotid ad= x:y,x:y sz=5GB -r=1

Creates a virtual disk of 5 GB size for type RAID 1.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands.

To create a virtual disk of a
certain size and make it
RAID 5

raidcfg -ctrl ac=cvd -c=slotid ad=

Creates a virtual disk of 5 GB size for type RAID 5.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands.

137

Purpose

Command

Description

x:y,x:y,x:y,... sz=5GB -r=5
To create a virtual disk of a
certain size and make it
RAID 1 with a hot spare

raidcfg -ctrl ac=cvd -c=slotid ad= x:y,x:y sz=5GB -r=1 fd=x:y

Creates a virtual disk of 5 GB size for type RAID 1.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands.
The option <-fd> stands for failover drive and requires the
drive location of the drive you want the dedicated hot
spare to be in. The drive location is obtained from the
second command.

To create a virtual disk of
RAID 10

raidcfg -ctrl ac=cvd -c=slotid ad=
x:y,x:y,x:y,x:y r=10

Creates a virtual disk of max size for type RAID 10.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands. The
drive location is obtained from the second command.

To create a virtual disk of
RAID 50

raidcfg -ctrl ac=cvd -c=slotid ad=
x:y,x:y,x:y,x:y ,x
:y,x:y -r=50 -sp=x

Creates a virtual disk of maximum size for type RAID 50.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands. The
drive location is obtained from the second command.

To create a virtual disk of
RAID 6

raidcfg -ctrl ac=cvd -c=slotid ad=
x:y,x:y,x:y,x:y ,x
:y,x:y -r=6 -sp=x

Creates a virtual disk of maximum size for type RAID 6.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands. The
drive location is obtained from the second command.

raidcfg -ctrl ac=cvd -c=slotid ad=
x:y,x:y,x:y,x:y ,x
:y,x:y -r=60 -sp=x

Creates a virtual disk of maximum size for type RAID 60.
The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands. The
drive location is obtained from the second command.

To view all the virtual disks
in a system

raidcfg vdisk

Lists the virtual disks on a system for all RAID controllers.

To view all the virtual disks
for a specific controller

raidcfg vdisk c=slotid

Lists all the virtual disks on a specific controller.
The slot ID in <-c=slotid> is obtained from the first
commands.

To delete a specific virtual
disk on a controller

raidcfg vdisk ac=dvd -c=slotid vd= vdiskid

Deletes a specific virtual disk on a controller.
The slot ID in <-c=slotid> is obtained from the first
command and the vdiskid in <-vd=vdiskid> is
obtained from command 10.

To create a virtual disk of
RAID 60

138

NOTE: The minimum number of drives required to
create a virtual disk of RAID 6 is 4.

NOTE: The minimum number of drives required to
create a virtual disk of RAID 60 is 8.

UPINIT

The UPINIT utility allows to create a utility partition (UP) on a hard drive, format the partition, and extract the partition
contents onto the disk.

Features
The UPINIT utility:
•

Displays help and usage information.

•

Returns specific error codes and messages.
NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), you can find the UPINIT utility in \DELL
\TOOLKIT\TEMPLATES\SCRIPTS. In Linux, you can find it in /opt/dell/toolkit/templates/scripts

Creating A Partition Using UPINIT
The size of the virtual disk where a utility partition is to be created must be a minimum of 8 GB.
UPINIT performs the following steps:
•

Ensures that the UP image file is present and readable.

•

Ensures that no partitions are present on the target disk.

•

Creates a utility partition of type Dell Utility (DE). If there is an existing UP, UPINIT does not create a new one. It
only updates the existing UP. If no UP is found, UPINIT exits.

•

Updates the boot sector with the UP boot sector image. If required, it updates the master boot record as well.

•

Mounts the partition.

•

Uncompresses the UP file onto the UP image.

•

Unmounts the partition.
NOTE: On Windows PE, UPINIT runs as a batch file. In Linux, it runs as a shell script that uses standard Linux
commands to accomplish the same tasks as done by the Windows PE UPINIT utility. Both command lines are
identical and the output of the two utilities are identical when the same image is used.

UPINIT Dependencies
On systems running Linux, UPINIT looks for the following files:
•

mbr file in the dell/drmk directory

•

sysdrmk in the dell/toolkit/bin directory

On systems running Windows, UPINIT looks for the following files:
•

createup.cfg , mountup.cfg , umountup.cfg , and listup.cfg in the DELL\TOOLKIT\TEMPLATE\SCRIPTS directory

•

sysdrmk.exe in the DELL\TOOLKIT\TOOLS directory

139

UPINIT Options And Arguments
Table below lists the valid options and arguments for the UPINIT utility.
Table 74. UPINIT Options and Arguments

Option

Valid Arguments

Description

none

If no options are given, the tool outputs usage information. The usage
information is printed in the format shown below.
Example 1:
A:>upinit
upinit version 1.0
© 2012 Dell Inc. All rights reserved
upinit.sh --disk|-d=disk --size|-s=
size --file|-f=file
[--overwrite|-o] [--help|-h]
--help or -h prints help.
--disk or -d disk device on which to
create the Dell Utility Partition.
--size or -s Size in MB for the Dell
Utility Partition.
--file or -f filename of Dell Utility
Partition Image File.
--overwrite or -o Installs the Dell
Utility partition over an existing
one.
Example 2:
upinit --disk=/dev/sda --size=32 -file=upimg.bin
In the example, upinit creates a Dell
Utility Partition of size 32 MB on
/dev/sda using upimg.bin file.
NOTE: The --overwrite option should be used for upgrading/
downgrading purposes. The --size option is not required when
using the --overwrite option because the --overwrite option does
not resize an existing Dell Utility Partition. If any partitions exist,
they are deleted.

-h

none

This function command requires an argument that matches a valid
option. If the argument matches a valid option, that option’s usage
information is displayed. This option cannot be used with other
options.
Windows PE Example:
upinit version 1.0
Copyright (c) 2002-2012 Dell Inc.
This utility creates a utility partition for
your system. This utility requires a Utility
Partition image file (upimg.bin) which can be
found under /opt/dell/toolkit/systems folder in
the Deployment Toolkit ISO. For more
information, please consult the Deployment
Toolkit Documentation.

140

Option

Valid Arguments

Description
Usage:
upinit.bat [--overwrite] --disk=ID or
-d=ID --size=size or -s=size
--file=file or -f=file
--help or -h prints usage.
--disk or -d ID of the disk on which
to create the Dell Utility Partition.
--size or -s Size in MB for the Dell
Utility Partition.
--file or -f Filename of the Dell
Utility Partition Image File.
--overwrite or -o Overwrites an
existing Dell Utility Partition.
Example:
upinit --disk=0 --size=32 --file= upimg.bin
In the example, upinit creates a Dell Utility Partition of size 32 MB
using the upimg.bin image file.
The --overwrite option should be used for upgrading/downgrading
purposes. The --size option is not required when using the --overwrite
option because the --overwrite option does not resize an existing Dell
Utility Partition. If any partitions exist, they are not deleted.
Linux Example:
upinit version 1.0
Copyright (c) 2002-2012 Dell Inc.
This utility creates a utility
partition for your system.
This utility requires a Utility
Partition image file (upimg.bin) which
can be found under
/opt/dell/toolkit/systems folder in
the Deployment Toolkit ISO. For more
information, please consult the
Deployment Toolkit Documentation.
Usage:
upinit.sh --disk|-d=disk --size|-s=
size --file|-f=file
[--overwrite|-o] [--help|-h]
--help or -h prints help.
--disk or -d disk device on which to
create the Dell Utility Partition.
--size or -s Size in MB for the Dell
Utility Partition.
--file or -f filename of Dell Utility
Partition Image File.
--overwrite or -o Installs the Dell
Utility partition over an existing
one.
Example:
upinit --disk=/dev/sda --size=32 -file=upimg.bin
In the example, upinit creates a Dell Utility Partition of size 32 MB
on /dev/sda using the upimg.bin file.
The --overwrite option should be used for upgrading/downgrading
purposes. The --size option is not required when using the --overwrite

141

Option

Valid Arguments

Description
option because the --overwrite option does not resize an existing Dell
Utility Partition. If any partitions exist, they are not deleted.

disk

integer, required
(Windows) string,
required (Linux)

Specifies the disk on which to create a utility partition. This disk is
checked to ensure that there are no existing partitions. Utility exits
with an error if the disk has partitions other than a utility partition.
Use option --overwrite to overwrite an existing utility partition.
Example:
A:>upinit --disk=0 --size=32 --file=
c:\upimage.bin (WinPE Example)
# upinit --disk=/dev/hda --size=32 -file=/home/BIN/upimage.bin (Linux
Example)

size

integer, required

The size of the utility partition to create. The created utility is at least
the size specified by size and be as close to actual size as drive
geometry allows.
Example :
A:>upinit --disk=0 --size=32 --file=
c:\upimage.bin

file

string, required

Specifies a file that is decompressed onto the utility partition. This file
is checked for existence and availability before any partitions are
created on the disk. If the file is not specified, the utility simply create
the utility partition, format it, and exits. The user has to mount and
populate the utility partition. It is very unlikely that the user do NOT
specify the utility partition format.
Example:
A:>upinit --disk=0 --size=32 --file=
c:\upimage.bin

--overwrite

string, optional

Overwrites an existing utility partition. It does not create a new
partition or delete an existing partition.

142

Messages And Codes

This section documents the error messages and codes used in Dell OpenManage Deployment Toolkit (DTK).

SYSCFG Error Codes And Messages
The SYSCFG utility checks your commands for correct syntax and valid input. When you enter a command, a message is
displayed stating the results of the command.

Failure Messages
The SYSCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. The
following table lists SYSCFG error codes and messages.
Table 75. SYSCFG Error Codes and Messages

Error Code

Message

Success

Attempt to read write-only parameter.

Password cannot exceed 16 characters.

A BMC was either not detected or is not supported.

This username is already in use. Enter a unique username.

Access mode not supported.

Cannot return number of requested data bytes.

User ID 1 cannot be assigned a username.

Cannot execute duplicated request.

There was an error clearing the SEL.

Clear SEL cannot be accompanied with any other option.

racreset cannot be accompanied with any other option.

Cannot execute command. Command, or request parameter(s), not
supported in present state.

Command not supported on given channel.

The community string may only contain printable ASCII
characters.

Destination unavailable. Cannot deliver request to selected
destination.

143

Error Code

Message

Cannot execute command. Insufficient privilege level.

Command illegal for specified sensor or record type.

Invalid commstring value.

Hardware subsystem error. Invalid data field in Request.

Invalid destination IP address.

The GUID is invalid.

Invalid gateway.

Invalid hostname.

Invalid IP address.

Invalid DNS IP address.

Invalid sub net mask.

Invalid value for PEF. PEF value should be between 1 and 16.

Reservation Canceled or Invalid Reservation ID.

Invalid Time to live value.

Invalid VLANID value.

Invalid Command. Used to indicate an unrecognized or
unsupported command.

Command invalid for given LUN.

Load defaults cannot be accompanied with any other option.

There was an error loading the defaults.

Node Busy. Command could not be processed because command
processing resources are temporarily unavailable.

Out of space. Command could not be completed because of a lack
of storage space required to execute the given command
operation.

This parameter is not supported.

Parameter out of range. One or more parameters in the data
field of the Request are out of range.

The password may only contain printable ASCII characters.

Password test failed.

Requested data length invalid.

Requested data field length limit exceeded.

Requested Sensor, data, or record not present.

Request data truncated.

Command response could not be provided.

144

Error Code

Message

Command response could not be provided. BMC initialization or
initialization agent in progress.

Command response could not be provided. Device in firmware
update mode.

Command response could not be provided. SDR Repository in
update mode.

Cannot execute command, SEL erase in progress.

Attempt to set the 'set in progress' value when not in the
'set in complete' state.

The SOL character ’accumulate interval’ is invalid.

The SOL character ’send threshold’ is invalid.

The SOL ’retry interval’ is invalid.

Command completed successfully.

Time-out while processing command. Response unavailable.

Unspecified error.

The password may only contain printable ASCII characters.

Username cannot exceed 16 characters.

Invalid VLANID value. Enter in ’dddd’ format.

Attempt to write read-only parameter ’%s’.

BMC is busy.

Response data did not return successfully.

BMC time out error.

Option '%s' requires an argument.

The asset tag for this system is not available.

The asset tag cannot be more than 10 characters long.

The required BIOS interfaces cannot be found on this system.

The BIOS version information is not available.

There is not enough free system memory to complete the BIOS
update.

The BIOS update file version is a different version class
(A00, X00) than the current system BIOS. Use the --force
option to use this BIOS image.

The BIOS update file version is older than the current system
bios. Use the --force option to use this BIOS image.

The BIOS update file version is identical to the current
system bios. Use the --force option to use this BIOS image.

145

Error Code

Message

The sequence list must be a comma-separated numerical list of
valid unique boot device numbers (ex: 2, 1, 3).

The sequence list must be a comma-separated list of valid
unique device names (ex: nic.emb.1, hdd.emb.1) or a commaseparated numerical list of valid unique boot device numbers
(ex: 2, 1, 3).

There was an error setting the sequence.

The list is not formatted correctly. See the help for more
details.

The size of returned buffer is larger than the size of
allocated buffer.

There was a problem getting the state byte.

The state byte is not available on this system.

There was a problem setting the state byte.

The state byte must be a value between 0 and 255 decimal.

The CPU information is not available.

The dependent option '%s' required for this subcommand is
missing in the command line.

Duplicate sub command '%s' has been entered.

The script file does contain not a valid DTK environment
script signature.

The format of the environment variable is incorrect.

The --envar option can only be used for a single option.

The --envar option can only be used for report operations.

The individual sub commands should be specified for the -s
option.

Getting external serial connector settings failed.

Setting external serial connector settings failed.

There was an error opening the file.

File ’%s’does not have write permission.

The file contains invalid options ’%s’.

The replication information does not match for this system.

There can only be one section in the input file.

Bad ini file, the section cannot be found.

The format of the bios image file is incorrect.

Report operations and set operations must be separate.

146

Error Code

Message

100

Help is not available for the option ’%s’.

101

The -x (--hex) option can only be used with -b or -r.

102

Input file '%s' not found.

103

Input file '%s' cannot be read.

104

Invalid argument for option '%s'.

105

Function table lookup error.

106

The machine ID was not found in the file '%s'.

107

The system memory information is not available.

108

Mode can only be used with the --pci option.

109

The device name or index must be present in the boot order.

110

The output file '%s' could not be opened. Please make sure the
path exists and the media is not write protected.

111

Could not write to output file, disk may be full.

112

The current password must be supplied with a new password
using --oldsyspwd.

113

The current password must be supplied with a new password
using --oldsetuppwd.

114

The current password can only be supplied when setting a new
password.

115

Actions are not allowed for this filter. Only alerts are
allowed.

116

There was an error getting the option '%s'.

117

The option '%s' is not available or cannot be configured
through software.

118

There was an error setting the option '%s'.

119

The -n (--namefile) option can only be used with - -pci.

120

The password may only contain alphanumeric characters.

121

The BIOS passwords have been disabled via jumper.

122

The password length must be between 1 and 32.

123

This password is locked and can only be unlocked by the admin
user.

124

There was an error setting the password.

125

The LCD string length must be between 1 and %s.

126

The LCD string may only contain alphanumeric characters.

127

There was an error setting the LCD string.

147

Error Code

Message

128

The second channel can only be set if the RAID controller is
set to RAID.

129

The set operation, '%s', requires sub commands.

130

The service tag for this system is not available.

131

The system ID value is not available.

132

The system information string is not available.

133

A system error has occurred.

134

Usage error.

135

The uuid information is not present on this system

136

Version cannot be accompanied with any other option.

137

The self-identify blinker timer should be set to 0..255
second(s).

138

Encrypt key is too long.

139

Encrypt key is invalid, accepted characters are 0 to 9 or A to
F.

140

Parameter has been temporarily disabled due to a dependency on
other settings.

141

The old password supplied is incorrect. The new password will
not be set. Please try again.

142

Cannot stat /etc/omreg.cfg file. Please ensure /etc/omreg.cfg
file is present and is valid for your environment. You can
copy this file from the DTK iso.

143

Getting nicselection settings failed.

144

HAPI Driver Load Error.

145

Filter action power reduction is only supported for the system
power warn/fail filters.

146

TPM/TCM Clear settings requires setup password.

147

There is currently no TPM/TCM Clear request pending.

148

Password is not required for retrieving the ’%s’ options.

149

Setup password is required for setting the ’%s’ options.

150

Invalid Password override.

151

Invalid TPM/TCM set option.

152

There was an error setting the TPM/TCM option.

153

There is no setup password installed on this system.

154

The setup password supplied is incorrect. Please try again.

148

Error Code

Message

155

Profile should be custom for setting cpupowermode,
memorypowermode and fanmode.

156

There was an error setting the Power Option.

157

The power cap value entered is out of range. Please try again.

158

The power cap value entered must be between 0 to 100 if unit
is percent.

159

Invalid IPv6 address. The IPv6 address cannot be link-local or
multicast.

160

Invalid IPv6 address. The IPv6 address specified has incorrect
address format.

161

Invalid IPv6 address. The gateway address specified has
incorrect address format.

162

Invalid IPv6 address. The Primary DNS server address specified
has incorrect address format.

163

Invalid IPv6 address. The Secondary DNS server address
specified has incorrect address format.

164

Invalid IPv6 address. The gateway address specified is
invalid.

165

Invalid configuration. Attempting to apply IPv6 configuration
on a non supported platform.

166

Invalid IPv6 configuration. Attempt to set DNS server address
manually while DNS address source is set to auto.

167

Invalid IPv6 configuration. Attempt to set IPv6 address
manually while IPv6 address source is set to auto.

168

Invalid IPv6 configuration. Attempting to apply IPv6
configuration without loading IPv6 stack.

169

Invalid IPv4 configuration. Attempting to apply IPv4
configuration with IPv4 disabled.

170

Invalid IPv6 configuration. Ipv6 address cannot be specified
without specifying prefix-length.

171

Invalid IPv6 configuration. dnssrcv6 cannot be set to auto
when ipsrcv6 is set to manual.

172

Error while executing IPMI Set command.

173

Error while executing IPMI Get command.

174

Error during Trap Alert.

175

Unspecified error.

176

Getting LCD settings failed.

177

Invalid configuration. Attempting to set cap when capenable is
set to disable.

149

Error Code

Message

178

Invalid configuration. Attempting to set cap when hardware
does not support setting.

179

Invalid Configuration Option.

180

Cannot execute command. Parameter is illegal because command
sub-function has been disabled or is unavailable.

181

Failed to report the removable flash media redundancy status.

182

Failed to report the Internal SD Module status.

183

Error locating the Virtual Media Key on the Modular system.

184

Error in setting the redundancy option for the Internal SD
Modules.

185

Error in retrieving the redundancy option for the Internal SD
Modules.

186

Error in setting the redundancy option on Modular systems for
the Internal SD Modules.

187

Error in retrieving the vFlash option.

188

Error in setting the vFlash option.

189

Set failed due to dependency.

190

Set failed because attribute is forced to a value.

191

Cannot disable this OrderedList’s entries.

192

System busy, try again later.

193

New value not valid.

194

Not found.

195

System Services and/or CSIOR disabled.

196

Unable to set Password Status due to pending System Password
changes.

197

Password verification fail.

198

Set failed due to previously scheduled job.

199

Set failed because attribute is suppressed.

200

Generic failure.

201

XML path context creation failed.

202

Unable to parse XML.

203

Unable to connect IDRAC data manager.

204

'root' privileges required to execute this application.

205

Invalid alert destination.

150

Failures And Solutions
The following table lists the common SYSCFG failures and their solution.
Table 76. SYSCFG Failures and Solutions

Failure Messages

Solutions

Generic failure.

Indicates iDRAC is in bad state. Reboot iDRAC.

New value not valid.

Make sure the changed value is valid.

Cannot disable this orderedList’s
entries.

BIOS does not support enabling or disabling of a particular boot order object.

System busy, try again later.

Retry as iDRAC is busy with internal processing.

Unable to connect IDRAC data
manager.

Start data manager service using srvadmin_services (specific to Linux).

System Services and/or CSIOR
disabled.

Enable CSIOR from screen.

UPINIT Common Error Codes And Messages
The UPINIT utility checks your commands for correct syntax. When you enter a command, a message is displayed
stating the results of the command.

Failure Messages
The UPINIT utility failure messages provide error codes to help diagnose why some commands do not succeed. Table
below lists error codes and messages common to Linux and Microsoft Windows PE environments.
Table 77. UPINIT Common Error Codes and Messages

Error Code

Message

Dell Utility Partition created successfully.

Error: Disk ID not specified.

Error: SIZE not specified.

Error: Utility Partition Image file not specified.

Error: DRMK Path not specified.

Error: Dell Utility Partition already exits. Please use -overwrite option to upgrade or overwrite.

Error: Partitions exists. Please clear all the partitions
before running upinit.sh.

Error: DOS file(s) not found at the specified path.

Error: UP IMAGE not found at the specified location.

Error: format failed.

151

Error Code

Message

Error: Invalid size. Size should be a number between 32 and
2000.

Error: sysdrmk failed.

System Error.

Error: Invalid Argument:

Error: Unzip failed.

UPINIT Linux-Specific Error Codes And Messages
The list of error codes and messages are specific to the Linux environment.
Table 78. UPINIT Linux-Specific Error Codes and Messages

Error Code

Message

Error: Invalid disk specified.

Error: Mount failed.

Cannot create mount point .File exists

Error: fdisk failed.

UPINIT Windows PE-Specific Error Codes And Messages
The list of error codes and messages below are specific to the Windows PE environment.
Table 79. UPINIT Windows PE-Specific Error Codes and Messages

Error Code

Message

Error: DISKPART failed.

Error: DISKPART command file not found.

RAIDCFG Error Codes And Messages
The RAIDCFG utility checks your commands for correct syntax when you enter them. When you enter a command, a
message displays stating the results of the command.

Failure Messages
The RAIDCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. See
table below for a list of the error codes and the associated messages.
Table 80. RAIDCFG Error Codes and Messages

Error Code

Message

RAIDCFG Command successful!

Error! Incorrect Syntax.

152

Error Code

Message

Failure!

Illegal operation

Unsupported operation

Device not found.

Format boot drive illegal

Buffer too small.

Virtual Disk contains boot partition. Use force option to
delete.

Init boot drive failed.

Format boot drive failed.

Cannot write boot drive.

Unsupported RAID value.

Invalid RAID configuration.

Span depth not in range.

RAID 1 failed.

Exactly 2 array disks are required to create a RAID 1 virtual
disk.

Unsupported stripe size value.

RAID 5 only.

RAID 5 error.

A minimum of 3 array disks are required to create a RAID 5
virtual disk.

RAID 0 failed.

RAID 10 failed.

RAID 50 failed.

RAID 5 not supported.

RAID 50 not supported.

Size too small for given RAID type.

Wrong number of disks for RAID 1- concatenated.

Insufficient space to mirror disks.

Create Mirror not supported.

Disk in use.

Disk Lock operation failed.

Disk locked.

153

Error Code

Message

Disk Unlock operation failed.

Disk Unlocked.

Disk failed on rebuild.

Hot Spare not free.

Disk Diagnostic failed.

Disk Rebuild failed.

Disk Format failed.

Cancel of Disk Diagnostic failed.

Cancel of Disk Rebuild failed.

Cancel of Disk Format failed

Assign Hot Spare failed

Disk too Small for Hot Spare.

Unassign Hot Spare failed.

Prepare Disk for Removal failed.

Disk Online failed.

Disk Offline failed.

UnMount Operation failed.

Mount Operation failed.

Cannot Format Array Disk.

Bad chunk size.

Invalid disk.

Virtual disk not found.

Virtual disk locked.

Drive in use.

Reached maximum physical size.

Reached maximum count of virtual disks.

There is not enough free space on the array disk(s) to allow
the operation to complete; the size of the virtual disk is too
large; or communication to the array disk(s) has been lost.

Limit your array disk selection to those disks already
included in another single virtual disk or to those array
disks that are not used at all by another virtual disk.

Invalid Parameter

Failed drive cannot be added.

154

Error Code

Message

The controller cannot support the number of array disks that
you have selected. Choose a smaller number.

Delete virtual disk failed. Controller busy.

Delete virtual disk failed.

Create virtual disk failed.

Create virtual disk failed. Controller busy.

Create virtual disk failed. Failed to map virtual disk to
operating system disk.

Virtual disk initialization failed.

Virtual disk initialization failed. Controller busy.

Virtual disk reconstruction failed. Controller busy.

Virtual disk resynching failed. Controller busy.

Flush Virtual disk's cache failed on controller.

Virtual disk partition specified not found.

Unsupported cache policy value.

Unsupported write policy value.

Unsupported read policy value.

Cancel initialization on virtual disk failed.

Cancel reconstruction on virtual disk failed.

Cancel resynchronization on virtual disk failed.

The maximum number of virtual disks that can be created has
been reached.

The new virtual disk must use only the remaining free space on
the array disks used in the last virtual disk you created.
Select all array disks that are used in the last virtual disk
you created.

You have selected an array disk that is in a degraded or
failed state. Choose another array disk.

Delete the last created virtual disk first.

Virtual disk initialized for use and no override requested.

Virtual disk type requested is invalid for the attempted
operation.

Virtual disk Move operation failed. Cannot rename, virtual
disk is already in use.

Failover invalid.

155

Error Code

Message

Virtual disk resynching.

Virtual disk resynch failed.

Virtual disk reconstruct failed.

Cannot format a virtual disk that contains a boot or system
partition.

Cannot initialize a virtual disk that contains a boot or
system partition.

Virtual disk Copy failed.

Virtual disk mirror set required.

Virtual disk Create - Read-only failed.

Virtual disk Create - Read-write failed.

Virtual disk - Clear-to-zero failed.

100

Virtual Disk Requires Non Multilevel.

101

Virtual Disk Promote Operation failed.

102

Specified virtual disk has no drive letter assigned to it.

103

Cannot expose virtual disk.

104

Cannot reconfigure virtual disk.

105

Cannot stop the reconfiguration of the virtual disk.

106

SMART report count not supported.

107

Operations on hidden virtual disks are not allowed.

108

Virtual disk is in use.

109

The virtual disk is in use. It cannot be reconfigured at this
time.

110

Virtual disk operation is temporarily unavailable.
Initialization in progress.

111

Virtual disk operation is temporarily unavailable.
Reconstruction in progress.

112

Virtual disk operation is temporarily unavailable. Rebuild in
progress.

113

Virtual disk operation is temporarily unavailable. Check
consistency in progress.

114

Specified virtual disk too small.

115

Virtual disk operation not supported. Size too small.

116

Operation is temporarily unavailable. Space in use.

117

Cannot reconfigure to the given RAID level.

156

Error Code

Message

118

Cannot reconfigure from current RAID level to the given RAID
level.

119

One of the array disks selected for the virtual disk is
already in use.

120

Virtual disk operation not supported. Cannot use non-RAID
disk.

121

Controller Read Configuration failed.

122

Controller Write Configuration failed.

123

Controller cache flush failed.

124

Enable alarm on controller failed.

125

Disable alarm on controller failed.

126

Quiet alarm on controller failed.

127

Controller failed to perform the task.

128

Specified bus not found for controller.

129

Call to set cache mode on the controller failed.

130

Unexpected controller error.

131

Controller out of memory.

132

Invalid controller state.

133

Controller failed.

134

Controller busy.

135

Controller does not exist.

136

Controller name is invalid.

137

Controller is iterated.

138

Rename of virtual disk was not successful.

139

The controller was not able to erase the file system from the
specified virtual disk.

140

The controller was not able to add space to the specified
concatenation set.

141

The controller was not able to get the status of the specified
mirror set.

142

The controller was not able to set the requested failover
space.

143

The controller cannot get the failover space information.

144

Controller cannot unmirror the specified virtual disk.

145

The controller could not split the specified virtual disk.

157

Error Code

Message

146

The controller could not lock the specified virtual disk.

147

Controller IO paused.

148

No controller parameter support.

149

Controller does not recognize parameter symbol.

150

Controller Battery Recondition failed.

151

Controller Get disk signature failed.

152

Controller Read Flags failed.

153

Controller Set Flags failed.

154

Controller Remove Snap Shot failed.

155

Controller not supported.

156

Controller device initialization failure.

157

Partner controller already opened readwrite.

158

No partner controller found.

159

The virtual disk is not valid for requested operation.

160

Cannot communicate with controller.

161

Set operation failed.

162

Operation to update error count of SMART device has failed.

163

Operation to clear error count of SMART device has failed.

164

Driver could not execute.

165

Cannot delete virtual disk.

166

Cannot set temperature probe. Invalid value entered.

167

Cannot set enclosure tag. Invalid value entered.

168

Cannot set enclosure alarm.

169

Temperature probe value out of range.

170

Cannot set cache mode.

172

Data will be lost on the secondary disk and a reboot will be
forced.

173

Cluster Services (MSCS) is running. Deleting a virtual disk
that contains a cluster resource can result in unpredictable
errors or system hangs (quorum disk). You should shut down
cluster services before deleting cluster resources. Are you
sure you want to proceed?

174

Cannot perform Create Virtual Disk or Delete Virtual Disk
while the other server in a cluster is online. Please shut one
of the servers down and retry the operation.

158

Error Code

Message

176

Invalid array disks or failover drives selected for
reconfigure/create operation. Please make sure that all array
disks and failover drives associated with the virtual disk are
selected.

177

The maximum number of partitions have already been created on
one of the selected array disk(s). Each array disk can hold
portions (partitions) of up to 10 virtual disks. This virtual
disk cannot be created because one or more array disk(s) have
reached the partition limit.

178

The virtual disk is in use. Please close any applications that
use the virtual disk and unmount any file systems that reside
on the virtual disk.

179

The firmware version is not supported. Please update the
firmware from http://support.dell.com.

180

The specified device does not have enough free space to be
used as failover space for the specified virtual disk.

181

The operation failed. Please rescan the controller and retry
the operation.

182

The operation cannot be performed while a task is running on
the specified virtual disk.

183

The specified virtual disk has no dead disk segments.

184

The operation cannot be performed at this time. The firmware
can recondition a battery that has a Degraded or Power Low
state. The firmware will not recondition a battery that is
functioning normally or that has a Ready, Failed or Missing
state.

185

The version of the controller firmware installed on your
system does not support this operation.

186

There are no disks of the correct type available to be
assigned as a hot spare.

187

There are no disks of sufficient size available to be assigned
as a hot spare.

188

There are no disks of the correct type and sufficient size
available to be assigned as a hot spare.

189

The Create Virtual Disk task was successful but the operating
system may not be aware of the new virtual disk.

191

The import of foreign configurations is complete. Some
configurations could not be imported.

192

Enable alarm command failed. The enclosure processor is busy
or a firmware download is in progress.

193

Disable alarm command failed. The enclosure processor is busy
or a firmware download is in progress.

159

Error Code

Message

194

Quiet alarm command failed. The enclosure processor is busy or
a firmware download is in progress.

195

An error occurred while resetting a temperature probe.

200

No array disks found!

201

Invalid Virtual Disk ID!

202

RAID Type & Size are required to create a virtual disk. Ensure
that the RAID type and the size are correct.

203

Invalid Environment command!

204

File is not writable!

205

Setting Environment Variable Command failed!

206

Filename is not provided!

207

Invalid Strict option! Please provide a valid number between 1
and 100.

208

Span depth is not needed for this RAID type.

209

Array disk(s) cannot be part of virtual disk(s) and also be
hotspares.

210

Cannot have silent and logfile switch with the same command.

211

Invalid array disk(s)!

212

Invalid failover disk(s)!

213

Creation of a virtual disk on this RAID controller requires
the use of the entire disk space of the array disks. The size
or - sz parameter is not needed.

214

Invalid size given! size=max or -sz=max is not supported for
this RAID controller.

215

The value given for envname or -envn is null or too long.

216

Invalid virtual disk size!

217

The strict option provided failed! Virtual disk is not
created.

218

Unable to determine optimum size for Virtual disk. Ensure that
the array disks are of the same protocol (i.e. SAS, SATA,
SCSI). If there is a mismatch of the array disks then the
RAIDCFG will not be able to determine the optimum size. In
addition, also ensure that there is drive size available for
the specified virtual disk.

219

One or more array disks selected to create virtual disk or
hotspare doesn't have enough disk space. Please make sure that
all the array disks and failover drives selected have enough
free space.

160

Error Code

Message

220

The number of array disks provided is incorrect for the
requested RAID Type! RAID 1 requires exactly 2 array disks,
RAID 5 requires at least 3 array disks, RAID 10 requires at
least 4 array disks and RAID 50 requires at least 6 array
disks.

221

Input file cannot be read.

222

Input file not found.

223

Error in opening the file.

RACADM Firmware Error Codes And Messages
Table below lists RACADM firmware error codes and messages.
Table 81. RACADM Firmware Error Codes and Messages

Error Code

Message

UNKNOWN COMMAND.

OUTPUT ERROR

TOO FEW ARGUMENTS

UNKNOWN PARAMETER

CAN'T LOCK RESOURCE

RESOURCE LOCKED

USER NOT IN DATABASE

WRONG PASSWORD

NOT ACCESSIBLE VIA TELNET CONNECTION

ACCESS DENIED

INVALID ARGUMENT

INVALID GROUP NAME

USER DATABASE FULL

CAN'T CHANGE FACTORY DEFAULT

USER ALREADY IN DATABASE

CLOSING TELNET CONNECTION

USER DATABASE NOT INITIALIZED

INVALID COMMAND SHELL CALL

INVALID INPUT FILE

TFTP ERROR

161

Error Code

Message

PCI ERROR

SERVER IS IN GRAPHICS MODE

SYSTEM DATE AND TIME NOT SET

OUT OF MEMORY

ACCESS LOCKED

PAGING ERROR

PAGING ALREADY IN PROGRESS

ERROR ACCESSING DEVICE

WRONG NUMBER OF ARGUMENTS

NO SCREEN FOR ASR STORED

CAN'T ADD HISTORY MONITOR

INVALID IDENTIFIER

CANNOT WRITE TO FLASH

FIRMWARE FILE INVALID

CANNOT READ REGISTER

CANNOT UNLOCK RESOURCE

TIME OUT

SERVER IN TEXT MODE

WRONG GRAPHICS MODE

CONFIG SPACE LOCKED

MASTER LOCKED

ASB BUS LOCKED

HISTORY MONITORS NOT YET AVAILABLE

NO VALID VALUE FOR THIS FIELD

DIAGNOSTIC TASK ERROR

DIAGNOSTIC TASK IS ALREADY RUNNING

NO DIAGNOSTIC TASK RUNNING

READ ONLY

SNARFING IS NOT AVAILABLE

TEXT RESOLUTION OF SERVER CHANGED

MODULE NOT LOADED

IPMI ERROR

ERROR IN DIAGNOSTIC FUNCTION

162

RACADM Utility Error Codes And Messages
Table below lists RACADM utility error codes and messages.
Table 82. RACADM Error Codes and Messages

Error Code

Message

513

An unknown failure occurred.

514

Librac library not initialized.

515

An invalid parameter was passed into function.

516

Invalid DRSTYPE specified.

517

Librac library already initialized.

518

Invalid transport type specified.

519

Invalid library user.

520

A connection to the RAC controller could not be established.

521

Failed to perform read operation with RAC controller.

522

Failed to perform write operation with RAC controller.

523

Invalid message ID.

524

Invalid message type.

525

Invalid response message.

526

Specified user buffer is too small to hold data.

527

Authentication failed - Invalid user name or password.

528

Invalid CHAP protocol response encountered.

529

CHAP buffer too small.

530

Timeout occurred.

531

Insufficient user privileges to perform operation.

532

TFTP write error encountered.

533

TFTP read error encountered.

534

TFTP local file write error encountered.

535

TFTP local file read error encountered.

536

TFTP write request failed.

537

TFTP read request failed.

538

Failed to open file.

539

Failed to load socket library.

540

Invalid socket library.

541

Unable to resolve HostName.

163

Error Code

Message

542

Failed to create socket.

543

Socket read operation failed.

544

Socket write operation failed.

545

Failed to create SSL context object.

546

Failed to create SSL BIO object.

547

Unable to create SSL socket connection.

548

Failed to initialize socket.

549

Failed to login to RAC successfully.

550

Invalid session ID specified.

551

Failed to logout from RAC successfully.

552

Command execution failed.

553

FTP Get operation failed.

554

FTP Put operation failed.

555

Failed to initialize FTP interface.

556

Failed to load SSL library.

557

Failed to initialize librac library.

558

Invalid session ID.

559

SpcmpObjectName failed.

560

SpcmpObjectIdGet failed.

561

SpcmpObjectIdSet failed.

562

Failed to send SPCMP message to RAC.

563

Invalid transport session info.

564

LAN Proxy error - please make sure your proxy settings are
configured correctly.

565

RAC service not currently installed.

566

RAC service is not started.

567

RAC service is starting.

568

RAC controller not present.

569

RAC controller is currently resetting.

164

BMC Platform Events Filter Alert Messages

All possible Platform Event Filter (PEF) Alert Messages along with a description of each event are listed in the table
below
Table 83. BMC PEF Alert Events

Event

Description

Fan Probe
Failure

The fan is running too slow or not at all.

Voltage Probe
Failure

The voltage is too low for proper operation.

Discrete
Voltage Probe
Failure

The voltage is too low for proper operation.

Temperature
Probe Warning

The temperature is approaching excessively high or low limits.

Temperature
Probe Failure

The temperature is either too high or too low for proper operation.

Chassis
Intrusion
Detected

The system chassis has been opened.

Redundancy (PS
or Fan)
Degraded

Redundancy for the fans and/or power supplies has been reduced.

Redundancy (PS
or Fan) Lost

No redundancy remains for the system's fans and/or power supplies.

Processor
Warning

A processor is running at less than peak performance or speed.

Processor
Failure

A processor has failed.

PPS/VRM/DCtoDC
Warning

The power supply, voltage regulator module, or DC-to-DC converter is pending a failure
condition.

Power
Supply/VRM/D2D
Failure

The power supply, voltage regulator module, or DC-to-DC converter has failed.

Hardware log
is full or
emptied

Either an empty or a full hardware log requires administrator attention.

165

Event

Description

Automatic
System
Recovery

The system is hung or is not responding and is taking an action configured by Automatic
System Recovery.

System Power
Probe Warning

The system is setting actions when a power consumption probe detects a warning value.

System Power
Probe Failure

The system is setting actions when a power consumption probe detects a failure value.

166

Sample File Formats

This appendix lists the sample SYSCFG utility .ini, RAIDCFG utility .ini, and the RACADM utility .ini files.

Sample SYSCFG Utility .ini File Format
[syscfg]
;SystemModelName=poweredge r620
;SystemBiosVersion=0.3.16
;SystemServiceTag=MDN2345
;SystemManufacturer=dell inc.
;SysMfrContactInfo=www.dell.com
;SysMemSize=4.0 gb
;SysMemType=ecc ddr3
;SysMemSpeed=1067 mhz
;SysMemVolt=1.35v
;VideoMem=16 mb
MemTest=enable
MemOpMode=adveccmode
;NodeInterleave=disable
SerialDbgOut=disable
LogicalProc=enable
QpiSpeed=maxdatarate
ProcVirtualization=enable
ProcAdjCacheLine=enable
ProcHwPrefetcher=enable
DcuStreamerPrefetcher=enable
DcuIpPrefetcher=enable
ProcExecuteDisable=enable
ProcCores=all
;Proc64bit=yes
;ProcCoreSpeed=2.30 ghz
;Proc1Id=06-2d-2
;Proc1Brand=[genuine intel(r) cpu @ 2.30ghz
]
;Proc1L2Cache=8x256 kb
;Proc1L3Cache=20 mb
;Proc1NumCores=8
EmbSata=ahcimode
;SataPortE=auto
;SataPortEModel=unknown
;SataPortEDriveType=unknown device
;SataPortECapacity=n/a
;SataPortF=auto
;SataPortFModel=unknown
;SataPortFDriveType=unknown device
;SataPortFCapacity=n/a
BootMode=bios
BootSeqRetry=disable
IntegratedRaid=enable
UsbPorts=allon
InternalUsb=on
IntegratedNetwork1=enable
OsWatchdogTimer=disable

167

IoatEngine=disable
;EmbVideo=enable
SriovGlobalEnable=disable
SerialComm=onnoconredir
SerialPortAddress=serial1com1serial2com2
ExtSerialConnector=serial1
FailSafeBaud=115200
ConTermType=vt100vt220
RedirAfterBoot=enable
SysProfile=perfperwattoptimizeddapc
;ProcPwrPerf=sysdbpm
;MemFrequency=maxperf
;ProcTurboMode=enable
;ProcC1E=enable
;ProcCStates=enable
;MemPatrolScrub=standard
;MemRefreshRate=1x
;MemVolt=autovolt
;AesNi=enable
PasswordStatus=unlocked
TpmSecurity=off
;TpmActivation=nochange
;TpmClear=no
;IntelTxt=off
LocalBiosUpdateSupport=enable
PwrButton=enable
NmiButton=enable
AcPwrRcvry=last
AcPwrRcvryDelay=immediate
;AcPwrRcvryUserDelay=60
AssetTag=
NumLock=on
ReportKbdErr=report
ErrPrompt=enable
Characterization=enable
BootSeq=Floppy.iDRACVirtual.11,Optical.iDRACVirtual.1-1
;UefiBootSeq=NIC.Integrated.1-1-1,NIC.Integrated.1-21,NIC.Integrated.1-3-1,NIC.Integrated.1-41,Optical.iDRACVirtual.1-1,Floppy.iDRACVirtual.1-1
OneTimeBootMode=disable
;OneTimeBootSeqDev=floppy.idracvirtual.1-1
;OneTimeUefiBootSeqDev=nic.integrated.1-1-1
Slot1=enable
Slot2=enable
Slot3=enable
extserial=com1
lancfgparams
alertdest=1
destipaddr=0.0.0.0
lancfgparams
alertdest=2
destipaddr=0.0.0.0
lancfgparams
alertdest=3
destipaddr=0.0.0.0
lancfgparams
alertdest=4
destipaddr=0.0.0.0
commstring=public
;gateway=10.94.132.1
;ipaddress=10.94.132.131
ipaddrsrc=dhcp
nicselection=dedicated

168

autoneg=enable
dnsserver1=0.0.0.0
dnsserver2=0.0.0.0
dnsdhcp=disable
dnsracname=idrac
dnsregisterrac=disable
domainname=
domainnamednsdhcp=disable
fullduplex=enable
speed=100Mbps
;subnetmask=255.255.255.0
vlanid=1
vlanpriority=0
vlantag=disable
lancfgparamsv6
;dnssrcv6=static
;gatewayv6=::
;ipv6address1=::
ipv6=disable
;ipaddrv6=::
;ipsrcv6=auto
;linklocaladdrv6=::
;prefixlengthv6=0
;dnsserver1v6=::
;dnsserver2v6=::
;ipv6address2=::
lanchannelaccess
ipmioverlan=alwaysavail
channelprivlmt=administrator
pefalerting=disable
lanuseraccess
userid=2
usrprivlmt=administrator
lanuseraccess
userid=3
usrprivlmt=noaccess
lanuseraccess
userid=4
usrprivlmt=noaccess
lanuseraccess
userid=5
usrprivlmt=noaccess
lanuseraccess
userid=6
usrprivlmt=noaccess
lanuseraccess
userid=7
usrprivlmt=noaccess
lanuseraccess
userid=8
usrprivlmt=noaccess
lanuseraccess
userid=9
usrprivlmt=noaccess
lanuseraccess
userid=10
usrprivlmt=noaccess
lanuseraccess
userid=11
usrprivlmt=noaccess
lanuseraccess
userid=12
usrprivlmt=noaccess
lanuseraccess

169

userid=13
usrprivlmt=noaccess
lanuseraccess
userid=14
usrprivlmt=noaccess
lanuseraccess
userid=15
usrprivlmt=noaccess
lanuseraccess
userid=16
usrprivlmt=noaccess
lcd=servicetag
nmibutton=enable
pefcfgparams
alertpolnum=1
alertpolstatus=disable
pefcfgparams
alertpolnum=2
alertpolstatus=disable
pefcfgparams
alertpolnum=3
alertpolstatus=disable
pefcfgparams
alertpolnum=4
alertpolstatus=disable
pefcfgparams
filter=fanfail
filteralert=enable
filteraction=none
pefcfgparams
filter=discretevoltfail
filteralert=enable
filteraction=none
pefcfgparams
filter=tempwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=tempfail
filteralert=enable
filteraction=none
pefcfgparams
filter=intrusion
filteralert=enable
filteraction=none
pefcfgparams
filter=redundegraded
filteralert=enable
filteraction=none
pefcfgparams
filter=redunlost
filteralert=enable
filteraction=none
pefcfgparams
filter=procwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=procfail
filteralert=enable
filteraction=none
pefcfgparams
filter=powerwarn
filteralert=enable

170

filteraction=none
pefcfgparams
filter=powerfail
filteralert=enable
filteraction=none
pefcfgparams
filter=hardwarelogfail
filteralert=enable
pefcfgparams
filter=autorecovery
filteralert=enable
pefcfgparams
filter=procabsent
filteralert=enable
filteraction=none
pefcfgparams
filter=powerabsent
filteralert=enable
filteraction=none
pefcfgparams
filter=batterywarn
filteralert=enable
filteraction=none
pefcfgparams
filter=batteryfail
filteralert=enable
filteraction=none
pefcfgparams
filter=systempowerwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=systempowerfail
filteralert=enable
filteraction=none
pefcfgparams
filter=discretesdcardfail
filteralert=enable
filteraction=none
pefcfgparams
filter=discretesdcardpresent
filteralert=enable
filteraction=none
pefcfgparams
filter=discretesdcardwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=ripsfail
filteralert=enable
filteraction=none
pefcfgparams
filter=ripsoffline
filteralert=enable
filteraction=none
pefcfgparams
filter=ripsredundancylost
filteralert=enable
filteraction=none
hostname=
powerbutton=enable
serialcfgparams
connectionmode=basic
msgcommbitrate=19200

171

msgcommflowctrl=noflowctrl
tmcfgdelctrl=del
tmcfgechoctrl=echo
tmcfghandshakectrl=enable
tmcfginputnewlineseq=cr
tmcfglineediting=enable
tmcfgnewlineseq=crlf
serialchannelaccess
ipmioverserial=alwaysavail
channelprivlmt=administrator
serialuseraccess
userid=2
usrprivlmt=administrator
serialuseraccess
userid=3
usrprivlmt=noaccess
serialuseraccess
userid=4
usrprivlmt=noaccess
serialuseraccess
userid=5
usrprivlmt=noaccess
serialuseraccess
userid=6
usrprivlmt=noaccess
serialuseraccess
userid=7
usrprivlmt=noaccess
serialuseraccess
userid=8
usrprivlmt=noaccess
serialuseraccess
userid=9
usrprivlmt=noaccess
serialuseraccess
userid=10
usrprivlmt=noaccess
serialuseraccess
userid=11
usrprivlmt=noaccess
serialuseraccess
userid=12
usrprivlmt=noaccess
serialuseraccess
userid=13
usrprivlmt=noaccess
serialuseraccess
userid=14
usrprivlmt=noaccess
serialuseraccess
userid=15
usrprivlmt=noaccess
serialuseraccess
userid=16
usrprivlmt=noaccess
solaction
userid=2
action=enable
solaction
userid=3
action=disable
solaction
userid=4
action=disable

172

solaction
userid=5
action=disable
solaction
userid=6
action=disable
solaction
userid=7
action=disable
solaction
userid=8
action=disable
solaction
userid=9
action=disable
solaction
userid=10
action=disable
solaction
userid=11
action=disable
solaction
userid=12
action=disable
solaction
userid=13
action=disable
solaction
userid=14
action=disable
solaction
userid=15
action=disable
solaction
userid=16
action=disable
solcfgparams
solbitrate=115200
solcharaccuminterval=10
solcharsendthreshold=255
solenable=enable
solprivlevel=administrator
sysid=04CE
sysname=PowerEdge R620
useraction
userid=2
action=enable
useraction
userid=3
action=disable
useraction
userid=4
action=disable
useraction
userid=5
action=disable
useraction
userid=6
action=disable
useraction
userid=7
action=disable
useraction
userid=8

173

action=disable
useraction
userid=9
action=disable
useraction
userid=10
action=disable
useraction
userid=11
action=disable
useraction
userid=12
action=disable
useraction
userid=13
action=disable
useraction
userid=14
action=disable
useraction
userid=15
action=disable
useraction
userid=16
action=disable
username
userid=2
name=root
username
userid=3
name=NULL
username
userid=4
name=NULL
username
userid=5
name=NULL
username
userid=6
name=NULL
username
userid=7
name=NULL
username
userid=8
name=NULL
username
userid=9
name=NULL
username
userid=10
name=NULL
username
userid=11
name=NULL
username
userid=12
name=NULL
username
userid=13
name=NULL
username
userid=14
name=NULL

174

username
userid=15
name=NULL
username
userid=16
name=NULL
;uuid=44454C4C4400104E8032CDC04F333435
virtualmedia=auto

Sample RAIDCFG Utility .ini File Format
[Reset]
controllerid=1,2,3,6
[vdisk0]
controllerid=4
size=139392
raid=1
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=d
adisk=0:1:1,0:0:1
[vdisk1]
controllerid=4
size=139392
raid=1
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=c
adisk=0:3:1,0:2:1
[vdisk2]
controllerid=2
size=278784
raid=0
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=d
adisk=0:5:1,0:4:1
failoverdrive=0:9:1
[vdisk3]
controllerid=4
size=278784
raid=5
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=c
adisk=0:8:1,0:7:1,0:6:1
[GlobalHotspare0]
controllerid=0
failoverdrive=0:8:0

Sample RACADM Utility .ini File Format
[idRacInfo]
#idRacType=0x05
#idRacProductInfo=Dell Remote Access Controller 5
#idRacDescriptionInfo=This system component provides
a complete set of #remote management functions for

175

Dell PowerEdge servers.
#idRacVersionInfo=1.20 (Build 01.17)
idRacName=DRAC 5
idRacMisc=
[cfgLanNetworking]
cfgNicEnable=1
cfgNicIpAddress=10.98.8.121
cfgNicNetmask=255.255.255.0
cfgNicGateway=192.168.0.1
cfgNicUseDhcp=0
#cfgNicMacAddress=00:11:43:34:5f:4a
cfgDNSServersFromDHCP=0
cfgDNSServer1=192.168.0.5
cfgDNSServer2=192.168.0.6
cfgDNSRegisterRac=0
cfgDNSRacName=RAC-HHS7C1S
cfgDNSDomainNameFromDHCP=0
cfgDNSDomainName=MYDOMAIN
[cfgCurrentLanNetworking]
#cfgNicCurrentIpAddress=10.98.8.121
#cfgNicCurrentNetmask=255.255.255.0
#cfgNicCurrentGateway=192.168.0.1
#cfgNicCurrentDhcpWasUsed=0
#cfgDNSCurrentDhcpWasUsed=0
#cfgDNSCurrentServer1=192.168.0.5
#cfgDNSCurrentServer2=192.168.0.6
#cfgDNSCurrentDomainName=MYDOMAIN
[cfgRemoteHosts]
cfgRhostsSmtpEmailEnable=1
cfgRhostsFwUpdateTftpEnable=1
cfgRhostsSmtpServerIpAddr=127.0.0.1
cfgRhostsFwUpdateIpAddr=192.168.0.4
cfgRhostsFwUpdatePath=
[cfgUserAdmin]
#cfgUserAdminIndex=1
cfgUserAdminUserName=root
#cfgUserAdminPassword=
cfgUserAdminPrivilege=0
cfgUserAdminAlertFilterRacEventMask=0x300000
cfgUserAdminAlertFilterSysEventMask=0x77777
cfgUserAdminEmailEnable=0
cfgUserAdminEmailAddress=
cfgUserAdminEmailCustomMsg=
[cfgSessionManagement]
cfgSsnMgtMaxSessions=0x4
cfgSsnMgtMaxSessionsPerUser=0x4
[cfgSerial]
cfgSerialBaudRate=115200
cfgSerialConsoleEnable=0
cfgSerialConsoleQuitKey=~.
cfgSerialConsoleIdleTimeout=0x12c
cfgSerialConsoleShellType=0x2
cfgSerialConsoleNoAuth=0
cfgSerialConsoleCommand=
cfgSerialTelnetEnable=0
cfgSerialCom2RedirEnable=1
cfgSerialTelnet7fIsBackspace=0
[cfgNetTuning]
cfgNetTuningNicMtu=0x5dc
cfgNetTuningIpTtl=0x40
cfgNetTuningTcpSrttBase=0x0
cfgNetTuningTcpSrttDflt=0x6
cfgNetTuningTcpReXmtMin=0x2
cfgNetTuningTcpReXmtMax=0x80

176

cfgNetTuningIpSubnetsAreLocal=0x1
cfgNetTuningIpReassTtl=0x3c
cfgNetTuningTcpMsl=0x3c
cfgNetTuningNicAutoneg=1
cfgNetTuningNic100MB=1
cfgNetTuningNicFullDuplex=1
[cfgOobSnmp]
cfgOobSnmpTrapsEnable=1
cfgOobSnmpAgentEnable=1
cfgOobSnmpAgentCommunity=public
[cfgRacTuning]
cfgRacTuneFwUpdateResetDelay=0x46
cfgRacTuneD3debugEnable=1
cfgRacTuneRemoteRacadmEnable=1
cfgRacTuneHostCom2BaudRate=57600
cfgRacTuneHttpPort=0x50
cfgRacTuneHttpsPort=0x1bb
cfgRacTuneTelnetPort=0x17
cfgRacTuneConRedirPort=0x170c
[ifcRacManagedNodeOs]
ifcRacMnOsHostname=(none)
ifcRacMnOsOsName=Linux 2.4.21-20.ELIhugemem
ifcRacMnOsOsType=0x2
[cfgRacSecurity]
cfgRacSecCsrKeySize=0x400
cfgRacSecCsrCommonName=
cfgRacSecCsrOrganizationName=
cfgRacSecCsrOrganizationUnit=
cfgRacSecCsrLocalityName=
cfgRacSecCsrStateName=
cfgRacSecCsrCountryCode=
cfgRacSecCsrEmailAddr=
[cfgRacVirtual]
cfgVirAtapiSvrPort=0xe54
cfgVirMediaDisable=0
cfgFloppyEmulation=0
[cfgActiveDirectory]
cfgADRacDomain=
cfgADRacName=
cfgADEnable=0
cfgADAuthTimeout=0x78
cfgADRootDomain=

177

Dell Openmanage Deployment Toolkit Version 4 2 Quick Reference Guide 4.2 Command Line Interface

Navigation menu

Versions of this User Manual:

Views

Navigation