Dell Openmanage Deployment Toolkit Version 3 4 Quick Reference Guide 3.4 Command Line Interface

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

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

Download
Open PDF In Browser	View PDF

Dell OpenManage
Deployment Toolkit 3.4

Command Line Interface
Reference Guide

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLtp.fm
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 – F O R P R O O F O N LY

Template Last Updated -03/06/2010

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLtp.fm

Notes and Cautions
NOTE: A NOTE indicates important information that helps you make better use of
your computer.
CAUTION: A CAUTION indicates potential damage to hardware or loss of data if
instructions are not followed.

____________________
Information in this publication is subject to change without notice.
© 2010 Dell Inc. All rights reserved.
Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc.
is strictly forbidden.
Trademarks used in this text: Dell™, the DELL™ logo, PowerEdge™, and OpenManage™ are
trademarks of Dell Inc. Intel® and Core™ and are registered trademarks of Intel Corporation in the
U.S. and other countries. AMD Opteron™ is a trademark of Advanced Micro Devices, Inc. Microsoft®
and Windows® are either trademarks or registered trademarks of Microsoft Corporation in the United
States and/or other countries. Red Hat Enterprise Linux® and Enterprise Linux® are registered
trademarks of Red Hat, Inc. in the United States and/or other countries. SUSE ™ is a trademark of
Novell Inc. in the United States and other countries. Adaptec is a registered trademark of Adaptec, Inc.
Other trademarks and trade names may be used in this publication to refer to either the entities claiming
the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and
trade names other than its own.
November 2010

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm

Contents
1

Introduction .
What’s New

. . . . . . . . . . . . . . . . . . . . . . .

7

. . . . . . . . . . . . . . . . . . . . . . . .

7

Requirements

. . . . . . . . . . . . . . . . . . . . . . .

7

. . . . . . . . . . . . . . . . . . . . . .

7

Toolkit Utilities

. . . . . . . . . . . . .

8

RAID Configuration Utility

. . . . . . . . . . . . . .

8

RAC Configuration Utility .

. . . . . . . . . . . . . .

8

Disk Partitioning Utility

. . . . . . . . . . . . . . . .

8

Replication of DTK Utilities

. . . . . . . . . . . . . . . .

8

System Configuration Utility

2

Other Documents You May Need

. . . . . . . . . . . .

10

Obtaining Technical Assistance

. . . . . . . . . . . .

11

Command Syntax Overview .

. . . . . . . . . .

13

. . . . . . . . . . . . . . .

13

. . . . . . . . . . . . . . . . . .

15

Command Line Syntax
Case Sensitivity

Command Line Option Delimiters
Read and Write Commands

. . . . . . . . .

15

. . . . . . . . . . . .

16

File Input and Output Commands
Log Files

. . . . . . . . .

16

. . . . . . . . . . . . . . . . . . . . . .

17

Help Option

. . . . . . . . . . . . . . . . . . . . .

Error Checking and Error Messages

. . . . . . . . . .

Contents

17
17

3

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm

3

SYSCFG

. . . . . . . . . . . . . . . . . . . . . . . . . .

Features

. . . . . . . . . . . . . . . . . . . . . . . . .

SYSCFG General Options

. . . . . . . . . . . . . . . .

SYSCFG for BIOS Configuration

. . . . . . . . . . . . .

Options for BIOS Configuration

. . . . . . . . . .

SYSCFG for BMC and Remote Access Controller
Configuration . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . .

128

. . . . . .

128

. . . . . . . . . . .

130

. . . . . . . . .

130

. . . . . . . . . . . . .

140

. . . . . . . . . . . . . . . . . . . . . .

141

SYSCFG for IPv6 Configuration

Environment Variable File

Features

. . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . .

RAIDCFG Dependencies

143

. . . . . . . . . . . . . . . . .

144

. . . . . . . . . . . .

RAID Configuration Utility Options and Arguments .

144

. .

151

. . . . . . . . . . . . . . . . . . . .

152

Enumerating RAID Controllers
Contents

143

143

RAIDCFG Options and Arguments

General Help

142

. . . . . . . . . . . . . . .

Supported RAID Controllers

4

25

88

Options for System Configuration

RAIDCFG

25

. . . . . . .

SYSCFG for System Configuration .

4

20

87

SYSCFG Options for State Configuration

PCI Reporting

19

. . .

BMC and Remote Access Controller
Configuration Options . . . . . . . .
SYSCFG for State Configuration .

19

. . . . . . . . . . .

153

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm

Creating Virtual Disks

. . . . . . . . . . . . .

168

Enumerating Virtual Disks

. . . . . . . . . . . . .

174

. . . . . . . . . . . . . .

177

Initializing Virtual Disks

Importing and Clearing Foreign
Configurations . . . . . . . . .
Deleting Virtual Disks

. . . . . . . . . .

178

. . . . . . . . . . . . . . .

180

Assigning and Unassigning
Global Hot Spares . . . . .

Setting Environment Variables

. . . . . .

181

. . . . . . . . . . .

183

Function Calls of Setenvironment Option

. . . . .

184

. . . . . . . . . . . . .

187

. . . . . . . . . . . . . .

189

RAID Replication Options
Miscellaneous Options .

Quick Reference to RAIDCFG Commands .

UPINIT .

191

. . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . .

Features

181

. . . . . . . . . . . .

Assigning and Unassigning Persistent
Dedicated Hot Spares . . . . . . . . .

5

155

. . . . . . . . . . . . . . .

Enumerating Array Disks .

195
195

. . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . .

195

. . . . . . . . . . . . . . . . .

196

Creating a Partition Using UPINIT
UPINIT Dependencies .

UPINIT Options and Arguments

A Messages and Codes

. . . . . . . . . . . . . .

SYSCFG Error Codes and Messages
Failure Messages

203

. . . . . . . . . .

203

. . . . . . . . . . . . . . . . .

203

UPINIT Common Error Codes and Messages
Failure Messages

196

. . . . . . . . . . . . .

. . . . . .

213

. . . . . . . . . . . . . . . . .

214

Contents

5

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm

UPINIT Linux-Specific Error Codes and Messages .

. .

215

. . . . . . .

215

. . . . . . . . . .

215

. . . . . . . . . . . . . . . . .

215

UPINIT Windows PE-Specific Error Codes
and Messages . . . . . . . . . . . . . . .
RAIDCFG Error Codes and Messages
Failure Messages

RACADM Firmware Error Codes and Messages
RACADM Utility Error Codes and Messages

B BMC Platform Events Filter
Alert Messages . . . . . . . . .
C Sample File Formats

. . . . . .

231

235

. . . . . . . . . . . . . . .

237

. . . . . . . . .

237

Sample RAIDCFG Utility .ini File Format

. . . . . . . .

253

Sample RACADM Utility .ini File Format

. . . . . . . .

254

D Summary of SYSCFG and
RAIDCFG Options . . . . . .
SYSCFG Options
RAIDCFG Options

6

229

. . . . . . . . . .

Sample SYSCFG Utility .ini File Format

Index

. . . .

. . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . .

261

. . . . . . . . . . . . . . . . . . . .

290

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

261

295

1

Introduction

Dell OpenManage Deployment Toolkit (DTK) includes a set of utilities for
configuring and deploying Dell PowerEdge systems. You can use DTK to
build script-based and RPM-based installation for deploying large number of
systems in a reliable way, without changing their current deployment
processes.
DTK consists of command line utilities to configure various system features,
sample scripts to perform common deployment tasks, and documentation for
each utility. You can use DTK in a Microsoft Windows Preinstallation
Environment (Windows PE) or a Linux environment.

What’s New
DTK CLI does not have any updates for this release.

Requirements
For Windows PE, the DTK utilities support Windows PE 2.0 (32-bit and 64-bit)
and Windows PE 3.0 (32-bit and 64-bit).
For embedded Linux, the DTK utilities can be run on Red Hat Enterprise
Linux (version 4, update 4) 32-bit.

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

Introduction

7

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm

System Configuration Utility
The System Configuration (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) 4, DRAC 5, and iDRAC 6.

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

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" on page 237.
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 these 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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

8

Introduction

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm

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.
For example, the virtualization option is not available on Dell PowerEdge
x8xx series systems.

•

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 Dell 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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Introduction

9

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm

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
support.dell.com/manuals. On the Manuals page, click Software Systems
Management. Click on the appropriate product link on the right-side to
access the documents.
•

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

10

Introduction

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm

•

For more information on RAID controllers, see Dell OpenManage Sever
Adminstrator Storage Management User’s Guide on the Dell support site.

•

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 6 (iDRAC6) Enterprise for
Blade Servers User Guide provides information about configuring and
using an iDRAC6 for blade servers to remotely manage and monitor your
system and its shared resources through a network.

•

The Integrated Dell Remote Access Controller 6 (iDRAC6) User Guide
provides complete information about configuring and using an iDRAC6
for rack and tower servers to remotely manage and monitor your system
and its shared resources through a network.

•

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

Additionally, the Deployment Toolkit readme.txt file, which is available as
part of the DTK download at support.dell.com/manuals, 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.

Obtaining Technical Assistance
If at any time you do not understand a procedure described in this guide or if
your product does not perform as expected, help tools are available to assist
you. For more information about these help tools, see Getting Help in your
system's Hardware Owner's Manual.
Additionally, Dell Enterprise Training and Certification is available;
see www.dell.com/training for more information. This service may not be
offered in all locations.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Introduction

11

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

12

Introduction

Command Syntax Overview

2

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 in a command line instance as
long as they conform to the basic command line syntax.

Command Line Syntax
The general usage models of the DTK utilities are as follows:
•

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
support.dell.com 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

Command Syntax Overview

13

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm

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 should
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.
Table 2-1 lists the generic command line characters and arguments present in
the command line options with a short description of these characters.
Table 2-1. Command Line Syntax
Element

Description

-

Prefix single character options with a single hyphen (-).

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

Prefix multi-character options with two hyphens (--).

utilname

Indicates the generic designation for a DTK utility name.

o

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

14

Command Syntax Overview

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm

Table 2-1. Command Line Syntax (continued)
Element

Description

...

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 case sensitive.

•

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

Command Line Option Delimiters
Table 2-2 lists some examples of valid and invalid DTK command lines.
Table 2-2. DTK Command Line Examples
Valid/
Invalid

DTK Command Line

Example

valid

syscfg --option1 --option2 syscfg --asset --floppy

invalid

syscfg --option1=argument syscfg --asset=R910
--option2 --option3
--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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Command Syntax Overview

15

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm

Table 2-2. DTK Command Line Examples
Valid/
Invalid

DTK Command Line

Example

valid

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.
NOTE: If you use report and set actions are in the same command line, the
command is invalid.

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 2-3. 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

16

Command Syntax Overview

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm

Log Files
The -l  or --logfile  option records
information output on the command line to the specified log file. Each new
line of output is preceded by a time stamp.
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  - 
.
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 access 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" on page 203.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Command Syntax Overview

17

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

18

Command Syntax Overview

3

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 has the following general features:
•

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

SYSCFG

19

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

NOTE: In Microsoft Windows Preinstallation Environment (Windows PE),
the SYSCFG utility is located in \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. 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.
Table 3-1 lists the SYSCFG general options.
Table 3-1. SYSCFG General Options
Options

Suboptions

No option NA

Valid
Arguments

Description

NA

If an option is not given, the SYSCFG utility
outputs usage information. The usage information
is displayed in the format shown below.
Example:
A:>syscfg
syscfg Version 3.3.0192 P01
(Windows - Apr 21 2010, 16:48:48)
Copyright (c) 2002-2010 Dell Inc.
Usage: syscfg --option[=argument]
For more information about a
particular command,
use the option '-h' followed by
the command name.
Example: syscfg -h --asset

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

20

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-1. SYSCFG General Options (continued)
Options
--envar

Suboptions

Valid
Arguments

Description

valid
filename

When used with the –s option, this option stores
the environment variable data to a file. 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.

valid path
media
should be
writable

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

21

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-1. SYSCFG General Options (continued)
Options

Suboptions

Valid
Arguments

Description

-h
or
--help

NA

none

Without an argument, this option displays
general usage information for the utility. 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 suboptions, all sub-options, 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.

or


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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

22

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-1. SYSCFG General Options (continued)
Options

Suboptions

Valid
Arguments

Description

-i
or
--infile

NA

 This option 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. This option can be
replicated.
Example:
A:>syscfg -i filename.ini

-l
or
--logfile

NA

 This option 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.
This option can be replicated. See "Log Files" on
page 17 for more information.
Example:
A:>syscfg -l logfile

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

23

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-1. SYSCFG General Options (continued)
Options

Suboptions

Valid
Arguments

Description

-o
or
--outfile

NA

 This option 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. If a file with the same name
already exists, the information is appended to
the 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 filename.ini

-s

NA



This option prints the variable name and the
value assigned to it 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. See "--envar"
on page 21for more information.
Example:
A:>syscfg -s ENVNAME --svctag
svctag=SERVICE
ENVNAME=SERVICE

--version*

The asterisk
is not part of
the command syntax.

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

24

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

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.

Options for BIOS Configuration
Table 3-2 documents valid options and arguments along with a description of
their expected behavior. 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 due to the BIOS version or hardware feature set. Running SYSCFG without
arguments only displays the valid options.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

25

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration
Option

Valid
Arguments

Description

--acpower

on, off, last

This option sets the behavior for All Dell
the system after AC power is lost. PowerEdge
This option specifies how the
systems
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 is available on all
supported systems. This value can
be replicated.

Applicable
Systems

Example:
A:>syscfg --acpower=on
acpower=on

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

26

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--adjcacheprefetch

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

--asset



This option reports or sets the
All Dell
customer-programmable asset tag PowerEdge
number for a system.
systems
The maximum length of an asset
tag is 10 characters. Asset tag
values cannot contain any spaces.
This option is available on all
supported systems. This value can
be replicated.
Example:
A:>syscfg --asset=
ASSETTAG
asset=ASSETTAG

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

27

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--assignintr

standard,
distributed

This option controls the interrupt All Dell
assignment of PCI devices in the PowerEdge
system. This option is set to
systems
standard by 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

--bezelir

enable, disable This option enables or disables
All Dell
the ESM to monitor and log front PowerEdge
bezel intrusion conditions.
systems
Example:
A:>syscfg --bezelir=
enable
bezelir=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

28

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--bootmode

uefi, bios

This option enables booting to
Unified Extensible Firmware
Interface (UEFI) -capable
operating systems or ensures
compatibility with operating
systems that do not support
UEFI.

Dell PowerEdge
xx1x systems

Example:
A:>syscfg --bootmode=
uefi
bootmode=uefi

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

29

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--bootseq

numerical list,
separated by
commas

This option sets the boot order for All Dell
a system. Without an argument, PowerEdge
this option prints the boot order systems
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, i.e. the low
and high numbers must match,
and the same number of entries
must be supplied. This option is
available on all supported systems.
Systems that use a numerical list
for boot order cannot be
replicated.

or
list of device
names,
separated by
commas

Applicable
Systems

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

30

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

31

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

32

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

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
VIRTUALFLOPPY DRIVE
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:

NOTE: The asterisk indicates that
the device is enabled in the BIOS.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

33

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--bootseqretry

enable, disable This option 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 timeout if the
last boot attempt has failed.
This option can be replicated.

Applicable
Systems
All Dell
PowerEdge
systems

A:>syscfg -bootseqretry=enable
bootseqretry=enable
--cmosdefaults

enable, disable This option requests a default
CMOS value during the next
reboot. The default values are on
and off.

Dell PowerEdge
x9xx and later
systems

A:>syscfg -cmosdefaults=enable
cmosdefaults=disable
--conboot

enable, disable This option configures or reports All Dell
whether console redirection
PowerEdge
occurs after boot. This option is systems
available on all supported systems
that support console redirection.
This option can be replicated.
Example:
A:>syscfg --conboot=
enable
conboot=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

34

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--conred

serial1, serial2, This option configures or reports
off, bmcsol,
the communication port for
mmb
console redirection. If this option
is set to a serial port, then the
serial port option is not available.
See the descriptions for "--serial1"
on page 71 and "--serial2" on
page 72. If only one serial port is
present on a system, the serial2
argument is not available. This
option can be replicated.

Dell PowerEdge
systems earlier
than PowerEdge
x9xx systems

Example:
A:>syscfg --conred=
serial1
conred=serial1
--conterm

vt100, ansi

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

--cpuc1e

enable, disable This option enables or disables
C1-E. By default, it is enabled.
This option can be replicated.

Dell PowerEdge
xx1x systems

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

35

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--cpucore

1, 2, 4, 6, 8, 10, This option controls the number Dell PowerEdge
12, all
of enabled cores in each processor. x9xx and later
The default value is set to the
systems
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

--cpuxdsupport

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

Dell PowerEdge
x9xx and later
systems running
on Intel
processors

cpuxdsupport=enable
--cstates

enable, disable This option enables or disables
Dell PowerEdge
the power c states of the processor. xx1x systems
A:>syscfg --cstates=
enable
cstates=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

36

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--datareuse

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

--dbpm

enable, disable This option enables or disables
All Dell
demand-based power
PowerEdge
management. This option can be systems
replicated.
Example:
A:>syscfg --dbpm=enable
dbpm=enable

-enable, disable This option enables or disables
dcustreamerprefetcher
DCU Streamer Prefetcher.
This option can be replicated.

Dell PowerEdge
xx1x systems

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

37

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--devseq

numerical list,
separated by
commas

This option sets the hard-drive
All Dell
sequence for a system. Without
PowerEdge
an argument, this option displays systems
the device list. The argument
must be formatted as a
comma-separated 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. This option
is available on all supported
systems.

or
list of device
names,
separated by
commas

Applicable
Systems

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

38

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

numerical list,
separated by
commas

Example 1:

or
list of device
names,
separated by
commas

Applicable
Systems

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
4/SC Adapter(bus 02 dev
02)
Device 3:*
usbkey.slot.0 - Harddisk-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 - AIC7899, A:00 Seagate

NOTE: The asterisk indicates that
the device is enabled in the BIOS.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

39

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embhypervisor

off, on

This option enables or disables
the embedded hypervisor port.

All Dell
PowerEdge
systems

Example:
A:>syscfg -embhypervisor=on
embhypervisor=on
--embideraid

on, off

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

40

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embnic1

on, off,
onnopxe,
onwithiscsi

This option turns the first
All Dell
embedded NIC on with PXE on, PowerEdge
off, or on without PXE enabled. systems
This option is only valid for
supported systems that have an
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

41

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embnic2

on, off,
onnopxe,
onwithiscsi

This option turns the second
All Dell
embedded NIC on with PXE
PowerEdge
enabled, off, or on without PXE systems
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

42

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embnic3

on, off,
onnopxe,
onwithiscsi

This option turns the third
All Dell
embedded NIC on with PXE
PowerEdge
enabled, off, or on without PXE systems
enabled. This option is only valid
for supported systems that have
three embedded NICs. If the
second 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

43

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embnic4

on, off,
onnopxe,
onwithiscsi

This option turns the fourth
All Dell
embedded NIC on with PXE
PowerEdge
enabled, off, or on without PXE systems
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

--embnic1nic2

enable, disable This option enables or disables
the operating system interface of
the first and second embedded
NIC controllers.
Example:

Dell PowerEdge
1855, PowerEdge
6850, and
PowerEdge xx1x
systems

A:>syscfg -embnic1nic2=enable
--embnic1nic2=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

44

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embnic3nic4

enable, disable This option enables or disables
the operating system interface of
the third and fourth embedded
NIC controllers.

Dell PowerEdge
xx1x systems

Example:
A:>syscfg -embnic3nic4=enable
--embnic3nic4=enable
--embnics

on, off

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

45

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embnic1pxe

enable, disable This option enables or disables
All Dell
Preboot Execution Environmenet PowerEdge
(PXE) on the first embedded
systems
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

--embnic2pxe

enable, disable This option enables or disables
All Dell
PXE on the second embedded
PowerEdge
NIC. If PXE is disabled, the
systems
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=
disable
embnic2pxe=disable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

46

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embsataraid

off, combined, This option configures an
All Dell
ata, raid, qdma embedded SATA RAID controller. PowerEdge
This option can be replicated.
systems
• off — disables the embedded
SATA RAID controller.
• combined — sets the SATA
RAID controller to combined
mode.
• ata — sets SATA RAID
controller to ATA 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

--embscsi1

on, off

This option enables or disables
the first embedded SCSI
controller. This option is only
valid for supported systems that
have an embedded
SCSI controller. This option can
be replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --embscsi1=on
embscsi1=on

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

47

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embscsi2

on, off

This option enables or disables
the second embedded SCSI
controller. This option is only
valid for supported systems that
have an embedded SCSI
controller. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --embscsi2=on
embscsi2=on
--embscsiraid

raid, off, scsi

All Dell
This option enables or disables
PowerEdge
the embedded SCSI RAID
systems
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

48

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embscsiraidchb

raid, scsi

This option sets the second
All Dell
channel on an embedded RAID
PowerEdge
controller to SCSI or RAID. This systems
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

-mirrormode,
embsdcardredundancy disable

This option sets the redundancy
to mirrormode or enabled.
If sets to mirrormode, read-write
operation happens 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.

Dell PowerEdge
R810, R815,
R910, and M910
systems

If sets to disable, read-write
operation happens only on SD
card 1.
On modular systems, disable the
vflash key to configure this option.
Example:
A:>syscfg -embsdcardredundancy=
mirrormode
embsdcardredundancy=
mirrormode

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

49

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--extserial

com1, com2,
rad

This option 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.

PowerEdge x9xx
and later systems
except modular
systems

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 Dell PowerEdge x9xx
systems) option.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

50

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--embsdcard

off, on

This option enables or disables
the embedded SD card port.

Dell PowerEdge
xx1x systems

Example:
A:>syscfg --embsdcard=
off
embsdcard=off
--embvideoctrl

enable, disable This option enables or disables
the embedded video controller.

Dell PowerEdge
xx1x systems

Example:
A:>syscfg -embvideoctrl=enable
embvideoctrl=enable
--fiberchannel

enable, disable This option enables or disables
embedded fiber channel. This
option can be replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg -fiberchannel=enable
fiberchannel=enable
--f1f2promptonerror

enable, disable This option enables or disables
Dell PowerEdge
the BIOS to prompt F1 or F2 error xx0x and later
codes.
systems
Example:
A:syscfg -f1f2promptonerror=
enable
f1f2promptonerror=
enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

51

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--floppy

auto, off,
readonly

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

--formfactor

N/A

This option displays the geometry Dell PowerEdge
of modular Dell PowerEdge
modular systems
systems. This is a read-only option
and can have the following values:
half-height (the modular system
occupies 1 slot of the chassis),
half-height dual-width (the
modular system occupies 2
horizontal slots of the chassis),
full-height (the modular system
occupies 2 vertical slots of the
chassis), and full-height
dual-width (the modular system
occupies 4 slots of the chassis).
Example:
A:>syscfg --formfactor=
fullheight,dualwidth
formfactor=
fullheight,dualwidth

--fsbr

115200, 57600, This option sets the console
19200, 9600
redirection fail safe baud rate in
bps.

All Dell
PowerEdge
systems

Example:
A:>syscfg --fsbr=9600
fsbr=9600
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

52

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--hddfailover

off, on

This option specifies the device in All Dell
the Hard Disk Drive Sequence
PowerEdge
menu that has not been
systems
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

--htassist

enable, disable This option enables or disables
the probe filter chipset option.
Some applications may have lower
performance when the chipset
feature is disabled.

Dell PowerEdge
systems running
on AMD
Opteron
processors

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

53

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--hwprefetcher

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

--idecdrom

auto, off

This option enables or disables
All Dell
the CD drive. This option can be PowerEdge
replicated.
systems
Example:
A:>syscfg --idecdrom=
auto
idecdrom=auto

--idracgui

enable, disable Enables and disables the iDRAC
GUI. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --idracgui=
disable
idracgui=disable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

54

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--integratedraid

enable, disable This option enables or disables
the integrated RAID controller.
This option can be replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg -integratedraid=disable
integratedraid=disable
--integratedsas

enable, disable This option enables or disables
the integrated SAS controller.
This option can be replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg -integratedsas=enable
integratedsas=enable
--internalusb

off, on

This option enables or disables all All Dell
the user-accessible USB ports.
PowerEdge
This option can be replicated.
systems
Example:
A:>syscfg -internalusb=on
internalusb=on

--ioat

enable, disable This option enables or disables
All Dell
the I/O Acceleration Technology PowerEdge
(I/OAT) DMA Engine option.
systems
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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

55

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--lcd

default, none,
user, idracipv4
address,
idracmac
address,
ossystemname,
servicetag,
ipv6address,
ambienttemp,
systemwatts

This option determines whether Dell PowerEdge
to display the default string
xx1x systems
(model name and number for Dell
PowerEdge systems earlier than
Dell PoerEdgxx1x, and service tag
for Dell PowerEdge systems xx1x
and later) or a user-defined string
on the front-panel LCD.
This option can be replicated.
Example:
A:>syscfg --lcd=default
lcd=default



--lcd1

This option sets the first line of
user-defined text on the system
LCD. This option can be
replicated.

All Dell
PowerEdge
systems

NOTE: Before setting user strings

for this option, ensure that --lcd
is set to user.

NOTE: If you have a Dell

PowerEdge x8xx system, reboot
your system for the settings to take
effect.
--lcd2



This option sets the second line of All Dell
user-defined LCD strings.
PowerEdge
systems

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

56

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--logicproc

enable, disable This option 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.

All Dell
PowerEdge
systems

Example:
A:>syscfg --logicproc=
enable
logicproc=enable
--lpt

lpt1, lpt2, lpt3, This option configures or reports All Dell
disable
the I/O address of the LPT
PowerEdge
(parallel) port. This option is
systems
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

--lptmode

ps2, at

This option configures or reports All Dell
the mode of an LPT (parallel)
PowerEdge
port. This option is available on all systems
supported systems with an LPT
port. This option is recorded to an
output file for replication.
Example:
A:>syscfg --lptmode=ps2
lptmode=ps2

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

57

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--memintleave

enable, disable This option enables or disables
the memory interleave mode.
This option can be replicated.

Applicable
Systems
All Dell
PowerEdge
systems

Example:
A:>syscfg -memintleave=enable
memintleave=enable
--memoperatingmode

optimizer,
mirror,
advancedecc

This option selects the memory
operating mode. This feature is
active only if a valid memory
configuration is detected.

Dell PowerEdge
xx1x systems

Example:
A:>syscfg -memoperatingmode=
optimizer
memoperatingmode=
optimizer
--memremap

off, auto

This option enables or disables
memory remapping.
A:>syscfg --memremap=
off

All Dell
PowerEdge
systems

memintleave=off
--memtest

enable, disable This option enables or disables
All Dell
the POST extended memory test. PowerEdge
systems
Example:
A:>syscfg --memtest=
disable
memtest=disable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

58

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--mouse

off, on

This option turns the mouse
controller on or off. This option
can be replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --mouse=off
mouse=off

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

59

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--nextboot

valid device
name (from the
--bootseq
option device
list)

This option sets the specified
All Dell
device as the first device in the
PowerEdge
boot order for the next boot cycle systems
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.
See --bootseq for more
information. 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 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

60

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--noraidprompt*

NA

This option 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.

All Dell
PowerEdge
systems

The asterisk is not part of
the command syntax.

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

61

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--numlock

on, off

This option enables or disables
All Dell
the keyboard number lock during PowerEdge
POST. This option is not
systems
replicated.
Example:
A:>syscfg --numlock=on
numlock=on

--oldsetuppwd



This option is required to set a
All Dell
new setup password when a setup PowerEdge
password is currently set. The
systems
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.
Example:
A:>syscfg --setuppwd=
asetuppassword -oldsetuppwd=
currentpassword
The password has been
set. Please use a warm
reboot to apply the
password to the system.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

62

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--oldsyspwd



This option supplies the current All Dell
system password for the BIOS.
PowerEdge
This option is only given when
systems
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.
Example 1:
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

63

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--opticaldrivectrl

enable, disable This option enables or disables
the optical CD-ROM controller.
Example:

Applicable
Systems
All Dell
PowerEdge
systems

A:>syscfg -opticaldrivectrl=enable
opticaldrivectrl=enable
--osmode

enable, disable This option enables or disables
All Dell
operating system installation
PowerEdge
mode for installing operating
systems
systems. Enabling this option
causes the BIOS to only report
256 MB to the operating system.
Some operating systems cannot
be installed if a system has more
than 2 GB of memory. This option
can be replicated.
Example:
A:>syscfg --osmode=
enable
osmode=enable

--oswatchdogtimer

enable, disable If your system stops responding, All Dell
the watchdog timer aids in the
PowerEdge
recovery of your operating system. systems
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

64

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--ovrwrt*

NA

This option is only used with the - All Dell
o option to cause the output file PowerEdge
to be overwritten if a file of the
systems
same name already exists. This
option cannot be replicated.

The asterisk is not part of
the command syntax.

Applicable
Systems

Example:
A:>syscfg -o=
filename.ini --ovrwrt
The file filename has
been overwritten.
For details about the power
sub-options and arguments, see
Table 3-5.

power

--powerbutton

enable, disable This option enables or disables
the power button for a system.
This option is recorded to an
output file for replication. This
option is available on all
supported systems.

Dell PowerEdge
xx1x systems
All Dell
PowerEdge
systems

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

NOTE: The system must be

rebooted for BIOS options to take
effect.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

65

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

--qpibandwidthpriority compute, io

Description

Applicable
Systems

This option sets the band width Dell PowerEdge
priority to compute or I/O. Set to xx1x systems
compute for computationintensive applications. Set to I/O
for I/O-intensive applications.
This option can be replicated.
Example:
A:>syscfg -qpibandwidthpriority=
compute
qpibandwidthpriority=
compute

--redmem

off, spare,
mirror, raid

This option allows selection of the
desired redundant memory mode,
or disables redundant memory.
This option can be replicated.

All Dell
PowerEdge
systems except
xx1x

Example:
A:>syscfg --redmem=off
redmem=off

NOTE: The system must be

rebooted for BIOS options to take
effect.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

66

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--remflashmedia

read-only

This option displays the
Dell PowerEdge
redundancy status of internal dual R810, R815,
SD module. The status can be:
R910, and M910
• Full — Secure digital card (SD) systems
1 and 2 are functioning properly.

• Lost — Either any of the secure
digital cards or both is 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

67

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

Example:
A:>syscfg -remflashmedia
Internal Dual SD Module
Redundancy=Lost
SD1 status=Absent
SD1 status=Active
--rptkeyerr

enable, disable This option configures or reports
whether the BIOS reports
keyboard errors during POST.
This option can be replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --rptkeyerr=
disable
rptkeyerr=disable
--sata0

auto, off

This option enables or disables
SATA port 0. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata0=auto

sata0=auto
NOTE: This option maps to -sata_a for PowerEdge x9xx
systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

68

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--sata1

auto, off

This option enables or disables
SATA port 1. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata1=auto

sata1=auto
NOTE: This option maps to --

sata_b for Dell PowerEdge x9xx
systems.

--sata2

auto, off

This option enables or disables
SATA port 2. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata2=auto

sata2=auto
NOTE: This option maps to --

sata_c for Dell PowerEdge x9xx
systems.

--sata3

auto, off

This option enables or disables
SATA port 3. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata3=auto

sata3=auto
NOTE: This option maps to --

sata_d for Dell PowerEdge x9xx
systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

69

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--sata4

auto, off

This option enables or disables
SATA port 4. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata_4=auto

sata_4=auto
NOTE: This option maps to --

sata_e for Dell PowerEdge x9xx
systems.
--sata5

auto, off

This option enables or disables
SATA port 5. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata_5=auto

sata_5=auto
NOTE: This option maps to --sata_f
for Dell PowerEdge x9xx systems.

--sata6

auto, off

This option enables or disables
SATA port 6. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata_6=auto

sata_6=auto
NOTE: This option maps to --

sata_g for Dell PowerEdge x9xx
systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

70

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--sata7

auto, off

This option enables or disables
SATA port 7. This option can be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sata_7=auto

sata_7=auto
NOTE: This option maps to --

sata_h for Dell PowerEdge x9xx
systems.

--snoopfilter

enable, disable This option enables or disables
the snoop filter option from the
system BIOS.

All Dell
PowerEdge
systems

Example:
A:>syscfg -snoopfilter=enable
snoopfilter=enable
--serial1

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

This option configures or reports All Dell
the first serial port
PowerEdge
communication port. This option systems
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

71

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--serial2

auto, disable,
com2, com4

This option configures or reports All Dell
the second serial port
PowerEdge
communication port. This option systems
can be replicated.
Example:
A:>syscfg --serial2=
disable
serial2=disable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

72

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--serialcomm

on, com1cr,
com2cr, off

This option sets the behavior of
Dell PowerEdge
the serial port communication.
x9xx and later
When set to on, the BIOS enables systems
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, this option
tells the BIOS to enable 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, this option
tells the BIOS to enable 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

73

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

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 Dell PowerEdge x9xx
systems) option.
--serialportaddrsel

default,
alternate

This option sets the port address
of the serial devices.

Dell PowerEdge
xx1x systems

When this option is default,
Serial Device1 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

74

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--setuppwd



This option sets the setup
All Dell
password for the BIOS. The setup PowerEdge
password locks the BIOS F2
systems
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.
Example 1:
A:>syscfg --setuppwd=
asetuppassword
The password has been
set. Please use a warm
reboot to apply the
password to the system.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

75

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

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.
--sma

enable, disable This option enables or disables
processor sequential memory
access.

All Dell
PowerEdge
systems

Example:
A:>syscfg --sma=disable
sma=disable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

76

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

--slotname*

NA

This option reports the slot name Dell modular
of the blade.
systems

The asterisk is not part of
the command syntax.

Applicable
Systems

Example:
A:>syscfg --slotname
slotname=Slot5

--sriov

enable, disable This option enables or disables
support for SRIOV devices.

All Dell
PowerEdge
xx1x systems

Example:
A:>syscfg --sriov=
disable
sriov=disable
--svctag*
The asterisk is not part of
the command syntax.

NA

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

77

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--syspwd



This option sets the system
All Dell
password for the BIOS. The
PowerEdge
system password is required when systems
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.
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

78

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--sysrev

NA

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

All Dell
PowerEdge
systems

For details about the tpm
sub-options and arguments,
see Table 3-3.

Dell PowerEdge
xx0x and later
systems

tpm

--turbomode

enable, disable This option enables or disables
core-based turbo mode. Turbo
mode is a feature on Intel
processors that allows one
processor core to increase it’s
frequency by one bin whenever
the other core has gone into an
idle state.

Dell PowerEdge
xx1x systems
running on Intel
processors

Example:
A:>syscfg --turbomode=
enable
--turbomode=enable
--usb

on, legacy, off

This option sets or reports the
All Dell
status of the USB port. When set PowerEdge
to on, USB keyboards and mice
systems
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

79

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--usbflash

auto, fdd, hdd

This option 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.

All Dell
PowerEdge
systems except
Dell PowerEdge
x9xx and later

Example:
A:>syscfg --usbflash=
auto
usbflash=auto
--usbports

enable,
This option enables or disables
All Dell
enablebackonly, USB ports. When set to enable, it PowerEdge
disable
enables all user accessible USB
systems
ports. When set to
enablebackonly, the front useraccessible 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

80

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued)
Option

Valid
Arguments

Description

Applicable
Systems

--virtualization

enable, disable This option enables or disables
virtualization in the CPU. When
set to enable, it enables the
additional hardware capabilities
provided by Virtualization
Technology in applicable CPUs.

All Dell
PowerEdge
systems

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
--vflash

enable, disable This option enables or disables
vflash on iDRAC.
Example:
A:>syscfg --vflash=
enable

Dell PowerEdge
xx1x systems or
systems with
iDRAC 6

vflash=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

81

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-3 lists the sub-options and arguments for the tpm option.
Table 3-3.

Sub-options and Arguments for the tpm Option

Option Sub-option

Arguments

Description

tpm

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.

onwithoutp
bm

Directs the BIOS to bypass the pre-boot
measurements.

--tpmsecurity

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

82

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-3.

Sub-options and Arguments for the tpm Option (continued)

Option Sub-option
--tpmclear

Arguments

Description

NA

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

-undotpmclear

NA

Undoes 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 the settings.
Example:
A:>syscfg tpm -tpmactivation=enabled -tpmclear --valsetuppwd=


-setuppwdover
ride

NA

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

83

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-4 lists the sub-options and arguments for the tcm option.
Table 3-4.

Sub-options and Arguments for the tcm Option

Option Sub-option

Arguments

Description

tcm

off

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

on

Reports the presence of TCM to the
operating system.

--tcmsecurity

Example:
A:>syscfg tcm --tcmsecurity =
off
--tcmactivation

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

NA

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

-tcmundoclear

NA

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

84

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-5 lists the sub-options and arguments for the power option.
Table 3-5.

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

-min, max,
cpupowermode osdbpm,
systemdbpm

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

-memorypower
mode

min, 978, 800,
1067, 1333, max

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

85

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-5. Sub-options and Arguments for the power Option (continued)
Option Sub-option

Arguments

-min, max
fanpowermode

Description
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

NA

--cap

--cap

--unit 

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

 is
the limit for
power
consumption in
Watts, or btuphr,
or percent.

The value of  must be
between the maximum and minimum
threshold values, else an error is displayed.

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 the
is Power Cap (Watts) = [ Power supply
unit of the
rating for input power (Watts) - Min

potential power (Watts) ] * Power Cap
value and can be (%) + Min potential power (Watts)]
watt, or btuphr, A:>syscfg power --cap=
or percent.
--unit=watt -setuppwdoverride
--maxpowercap

Displays the value of the maximum power
threshold.

--minpowercap

Displays the value of the minimum power
threshold.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

86

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-5.

Sub-options and Arguments for the power Option (continued)

Option Sub-option
--valsetuppwd

Arguments

Description



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.
A:>syscfg power --profile=
maxperformance --valsetuppwd=


-NA
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 for BMC and Remote Access Controller
Configuration
SYSCFG configures BMC and Remote Access Controller 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

87

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

The following section documents all the valid options, sub-options, and their
arguments along with a description of the expected behavior using an
example. 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 sub-options 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 sub-options such
as commstring and hostname can take an empty string as input.

BMC and Remote Access Controller Configuration Options
Table 3-6 lists the options, sub-options, and pre-defined arguments for
configuring your system BMC and remote access controller (RAC).
Table 3-6. BMC and Remote Access Controller Configuration Options
Option

Sub-option

Valid
Arguments

bmcversion

Description

Applicable
Systems

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

All Dell
PowerEdge
systems

--devid

NA

Reports the BMC
device ID.

--devrevision

NA

Reports the BMC
device revision.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

88

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

-NA
majorfwrevisio
n

Reports the BMC
device major firmware
revision.

-NA
minorfwrevisio
n

Reports the BMC
device minor firmware
revision.
Example:
A:>syscfg
bmcversion
devid=32
devrevision=0
majorfwrevision=
0
minorfwrevision=
40

-NA
controlpanelacc
ess

viewandmodify This option sets or gets
, viewonly,
the access level for the
disabled
Liquid Crystal Display
(LCD).

Dell
PowerEdge
xx1x
systems

Example:
A:>syscfg -controlpanelacce
ss=viewandmodify
controlpanelacce
ss=viewandmodify
--clearsel*
The asterisk is not
part of the
command syntax.

NA

NA

Clears the SEL.
This option cannot be
replicated.

All Dell
PowerEdge
systems

Example:
A:>syscfg -clearsel
Clearing SEL...

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

89

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

--deviceguid*

NA

NA

Displays the GUID for All Dell
the BMC. This option PowerEdge
cannot be replicated.
systems

The asterisk is not
part of the
command syntax.

Applicable
Systems

Example:
A:>syscfg -deviceguid
deviceguid=
XXXXXXXXXX

--encryptkey

NA



Encrypts the IPMI
sessions.
The hexadecimal
number entered as an
argument is not case
sensitive although the
value returned by the
encryptkey option is
always in uppercase.

All Dell
PowerEdge
systems

The value returned is
appended with zeroes
so that it is always 40
characters long.
Example:
A:>syscfg -encryptkey=abcd
encryptkey=
ABCD000000000000
0000000000000000
00000000
--identify

NA

0–254

Flashes the

Dell

stop flashing
the LED.

a specified number of
seconds.

systems
with a
BMC.

NOTE: Use 0 to identification LED for PowerEdge

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

90

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

-kvmstatusonlcd

Valid
Arguments

Description

Applicable
Systems

active, inactive This option configures
the Dell Virtual KVM
(vKVM) session status
on the LCD.

Dell
PowerEdge
xx1x
systems

Example:
A:>syscfg -kvmstatusonlcd=
active
kvmstatusonlcd=
active
lanchannelacce
ss
or
lca

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

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

--ipmioverlan

disable,
alwaysavail

All Dell
PowerEdge
systems

Sets the LAN channel
access mode. This suboption can be
replicated.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

91

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

-user, operator,
channelprivlmt administrator

Description

Applicable
Systems

Sets the maximum
privilege level accepted
for the LAN channel.
This sub-option can be
replicated.
Example (to configure
the LAN channel with
alerts and IPMI over
LAN enabled):
A:>syscfg
lanchannelaccess
--pefalerting=
enable
--ipmioverlan=
alwaysavail
lanchannelaccess
pefalerting=
enable
ipmioverlan=
alwaysavail

lanchannelinfo
or
lci

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

lancfgparams
or
lcp

Configures and displays All Dell
LAN configuration
PowerEdge
parameters. This option systems
can be replicated.
--ipaddrsrc

static, dhcp

All Dell
PowerEdge
systems

Sets the IP address
source for the LAN
channel. This suboption can be
replicated.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

92

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

--ipaddress



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

--subnetmask



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

--gateway



Sets the gateway for the
LAN channel. This suboption can be
replicated.

--commstring



Sets the community
string (maximum of
16 printable ASCII
characters) used in a
platform event trap
(PET). This sub-option
can be replicated.

--destipaddr



Sets the destination
IP address for the alert
destination specified
with the alertdest suboption. The destipaddr
sub-option is
dependent on the
alertdest sub-option.
If the alertdest suboption is not specified
on the command line,
the first alert
destination
(alertdest=1) is
set with this IP address.
This sub-option can be
replicated.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

93

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
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 sub-option can
be replicated.

--vlanpriority

0–7

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

--macaddress

NA

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

--nicselection

shared,
sharedfailover,
dedicated,
sharedreceiveo
nall

Sets the operating
mode of the NIC to
shared/sharedfailover/d
edicated/sharedreceive
onall. Some of these
options are not
applicable on certain
systems.

--fullduplex

enable, disable Enables or disables full
duplex on the RAC
network interface.

--autoneg

enable, disable Enables or disables
autonegotiation.

--speed

10,100

Applicable
Systems

NOTE: The

sharedrece
iveonall
argument
is available
only on
xx1x
systems.

Sets the network
interface speed to 10 or
100 Mbps.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

94

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

--dnsdhcp

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

--dnsserver1



Sets the IP address of
the primary DNS server
for domain name
resolution.

--dnsserver2



Sets the IP address of
the 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, disable Enables or disables
domainnamefro
getting the RAC
mdhcp
domain name through
DHCP.
--domainname 

Sets the domain name
of the RAC.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

95

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

Example 1 (to display
the current LAN
configuration settings):
A:>syscfg -lancfgparams
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.10
subnetmask=
255.255.255.0
gateway=
192.168.100.1

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

96

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
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
--commstring=
public
--ipaddrsrc=
static
--ipaddress=
192.168.100.10
--subnetmask=
255.255.255.0
--gateway=
192.168.100.1
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.10
subnetmask=
255.255.255.0
gateway=
192.168.100.1
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

97

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

lanuseraccess
or
lua

Description

Applicable
Systems

Configures the privilege All Dell
level and channel
PowerEdge
accessibility associated systems
with a specified User
ID for the LAN
channel.
--userid

2–10, if your
system has a
DRAC 4
controller

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

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

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

-NA
currentenabled
userids

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

98

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

-NA
useridswithfixe
dnames

Description

Applicable
Systems

Reports the number of
User IDs with fixed
names on the LAN
channel.
Example 1 (to enable
User ID 2 on the LAN
channel with
administrator
privileges):
A:>syscfg
lanuseraccess
--userid=2
--usrprivlmt=
administrator
userid=2
usrprivlmt=
administrator
Example 2 (to enable
User ID 4 on the LAN
channel with user
privileges):
A:>syscfg
lanuseraccess
--userid=4
--usrprivlmt=
user
userid=4
usrprivlmt=user

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

99

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

--loaddefaults* NA
The asterisk is not
part of the
command syntax.

Valid
Arguments

Description

Applicable
Systems

NA

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

NOTE: The NMI, power

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

100

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

--nextboot

NA

valid
device
name (from
the
--bootseq
option
device
list)

This option sets the
All Dell
specified device as the PowerEdge
first device in the boot systems
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.
See --bootseq for more
information. 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 - Hard
Drive C:
Device 4:
nic.emb.1 Intel Boot Agent
Version 4.0.17

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

101

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

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

NA

enable, disable This option enables or
disables the NMI
button.

All Dell
PowerEdge
systems

This option can be
replicated.
Example:
A:>syscfg -nmibutton=enable
nmibutton=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

102

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

passwordaction

Description

Applicable
Systems

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

NOTE: 20 byte
passwords are not
supported for this
option.
--userid

2–10 if your
system has a
DRAC 4
controller

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

2–16 if your
system has a
DRAC 5
controller
--action

setpassword,
testpassword

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 sub-option cannot
be replicated.
Example (to set and
test the password for
User ID 3):

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

103

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

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.
pefcfgparams
or
pcp

Configures and displays All Dell
PEF configuration
PowerEdge
parameters. This option systems
can be replicated.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

104

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

--filter

fanfail, voltfail,
discretevoltfail,
tempwarn,
tempfail,
intrusion,
redundegraded,
redunlost,
procwarn,
procfail,
powerwarn,
powerfail,
hardwarelogfail,
autorecovery,
batterywarn,
batteryfail,
powerabsent,
procabsent,
systempowerwarn,
systempowerfail

Specifies a PEF value.
This sub-option can
be replicated.

powercycle,
reset,
powerdown,
powerreductio
n, none

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

--filteraction

Applicable
Systems

See "BMC Platform
Events Filter Alert
Messages" for a
complete list of all
possible PEF messages
along a description of
each event.

NOTE: The fanfail option
is not supported on Dell
PowerEdge xx0x
systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

105

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

--hostname



Sets the host name
(maximum of 62
printable ASCII
characters) for the
BMC. This sub-option
can be replicated.

Applicable
Systems

The --hostname string
must comprise only
these characters:
hyphen (-), underscore
(_), and period (.).
The length of the -hostname string must
be 48 characters or less
for Dell PowerEdge
x8xx systems and 62
characters or less for
Dell PowerEdge x9xx
systems and later.
--filteralert

enable, disable Enables or disables
alerts for the filter
specified using the
filter sub-option.
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

106

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

--alertpolstatus enable, disable Enables or disables the
alert policy specified
using the alertpolnum
sub-option. This suboption can be
replicated. This suboption is dependent on
the alertpolnum suboption.
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

107

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

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

NA

enable, disable This option enables or All Dell
disables the power
PowerEdge
button. This option can systems
be replicated.
Example:
A:>syscfg -powerbutton=
enable
powerbutton=
enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

108

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

--powerctl

NA

powerdown
This option performs a All Dell
 chassis powerdown and PowerEdge
controls the reset of the systems
system.
Powerdown shuts off
the system.
powercycle
Powercycle shuts off
 the system and
automatically turns on
your system after a few
seconds.
reset
Resets the system.

softshutdown In Linux, the system
 shuts down
immediately.
In Windows PE, this
option does not work.

NOTE: This option
applies only to
PowerEdge systems that
are configured with a
BMC.
This argument requires
ACPI support to
function properly.
--racreset

NA

NA

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

All Dell
PowerEdge
systems

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

109

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

--serialchannelaccess
or
sca

Description

Applicable
Systems

Sets or displays the
All Dell
channel access settings PowerEdge
for the serial channel. systems
This option can be
replicated.

-ipmioverserial

disable,
alwaysavail

Sets the serial channel
access mode. This suboption can be
replicated.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

110

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

-user, operator,
channelprivlmt administrator

Description

Applicable
Systems

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
serialchannelacc
ess
-ipmioverserial=
disable
-channelprivlmt=
administrator
serialchannelacc
ess
ipmioverserial=
disable
channelprivlmt=
administrator

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

111

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

-serialchannelinfo
or
sci

Description

Applicable
Systems

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

All Dell
PowerEdge
systems

--mediumtype NA

Displays the medium
type for the serial
channel. This suboption cannot be
replicated.

--prottype

NA

Displays the protocol
type for the serial
channel. This suboption cannot be
replicated.

--ssnsupport

NA

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

-NA
activessncount

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

112

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

serialcfgparams
or
scp

Description

Applicable
Systems

Configures and displays All Dell
serial configuration
PowerEdge
parameters. This option systems
can be replicated.
-basic, terminal Sets the connection
connectionmo
mode used to perform
de
IPMI messaging to the
BMC. This sub-option
can be replicated.
-noflowctrl,
msgcommflow rtscts
ctrl

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

-NA
msgcommdtrh
angup

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

9600, 19200,
Sets the IPMI message
-msgcommbitra 57600, 115200 communication baud
te
rate in bits per second
(bps). This sub-option
can be replicated.
-enable, disable Sets the line editing
tmcfglineediti
value for terminal mode
ng
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

113

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

-tmcfgechoctrl

echo, noecho

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

Applicable
Systems

-enable, disable Sets the handshake
tmcfghandshak
control value for
ectrl
terminal mode
configuration. This
sub-option can
be replicated.
-noterm, crlf,
tmcfgnewlines null, cr, lfcr,1f
eq

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

-cr, null
tmcfginputnew
lineseq

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

114

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

Example (to display the
current serial
configuration settings):
A:> syscfg
serialcfgparams
serialcfgparams
tmcfgdelctrl=del
tmcfgechoctrl=
echo
tmcfghandshakect
rl=enable
connectionmode=
terminal
tmcfgnewlineseq=
crlf
msgcommflowctrl=
rtscts
tmcfginputnewlin
eseq=cr
msgcommdtrhangup
=disable
msgcommbitrate=
19200
tmcfglineediting
=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

115

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

serialuseraccess
or
sua

Description

Applicable
Systems

Configures the privilege All Dell
level and channel
PowerEdge
accessibility associated systems
with a specified User
ID for the serial
channel. This option
can be replicated.
--userid

2–10 if your
system has a
DRAC 4
controller

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

2–16 if your
system has a
DRAC 5
controller
--usrprivlmt

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

116

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

-NA
currentenabled
userids

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

117

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

Example 1 (to enable
User ID 2 on the serial
channel with
administrator
privileges):
A:>syscfg
serialuseraccess
--userid=2
--usrprivlmt=
administrator
--status=enable
userid=2
usrprivlmt=
administrator
status=enable
Example 2 (to enable
User ID 4 on the serial
channel with user
privileges):
A:>syscfg
serialuseraccess
--userid=4
--usrprivlmt=
user
--status=enable
userid=4
usrprivlmt=user
status=enable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

118

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

solaction

Description

Applicable
Systems

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

2–10 if your
system has a
DRAC 4
controller

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

2–16 if your
system has a
DRAC 5
controller
--action

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

119

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

solcfgparams

Description

Applicable
Systems

Configures and displays All Dell
SOL configuration
PowerEdge
parameters. This option systems
can be replicated.
--solenable

enable, disable Enables or disables
whether the SOL
payload type can be
activated. This option
can be replicated.

--solprivlevel

user, operator,
administrator

-1–255
solcharaccumi
nterval

Sets the minimum user
privilege level required
to activate the SOL.
This option can be
replicated.
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

120

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

-1–255
solcharsendthr
eshold

Description

Applicable
Systems

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.

NOTE: On Dell
PowerEdge x8xx
systems, the maximum
limit for -solcharsendthreshold is
200. On Dell PowerEdge
x9xx systems, the
maximum limit is 255. On
the Dell PowerEdge
SC1435 system, the
maximum limit is 255.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

121

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

--solbitrate

9600, 19200,
Sets the serial channel
57600, 115200 communication bit rate
(in bps) with the BMC
when SOL is activated.
This option can be
replicated.

Applicable
Systems

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:
19200 - for Dell Power
Edge x8xx systems
57600 - for Dell Power
Edge x9xx systems that
do not have DRAC 5
installed
115200 - for Dell x9xx
systems that have
DRAC 5 installed.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

122

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

Example 1 (to display
the current SOL
configuration):
A:> syscfg
solcfgparams
solcfgparams
solenable=enable
solprivlevel=
administrator
solcharaccuminte
rval=25
solcharsendthres
hold=25
solbitrate=9600

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

123

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

solcfgparams

Valid
Arguments

Description

Applicable
Systems

Example 2 (to set the
SOL configuration
parameters):

All Dell
PowerEdge
systems

A:>syscfg
solcfgparams
--solenable=
disable
--solprivlevel=
administrator
-solcharaccuminte
rval=25
-solcharsendthres
hold=100
--solbitrate=
9600
solcfgparams
solenable=
disable
solprivlevel=
administrator
solcharaccuminte
rval=25
solcharsendthres
hold=100
solbitrate=9600

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

124

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

ssninfo

Description

Applicable
Systems

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

Displays the maximum
possible active BMC
sessions. This suboption cannot be
replicated.

-NA
currentactivess
ns

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

currentactives
sns=1
maxactivessns=
4

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

125

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

useraction

Description

Applicable
Systems

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

2–10 if your
system has a
DRAC 4
controller

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

2–16 if your
system has a
DRAC 5
controller
--action

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

126

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

username

Description

Applicable
Systems

Sets the BMC User ID All Dell
and username. This
PowerEdge
option can be
systems
replicated.
--userid

2–10 if your
system has a
DRAC 4
controller

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

2–16 if your
system has a
DRAC 5
controller
--name



Sets the username
(maximum of 16
printable ASCII
characters) for the User
ID specified using the
userid sub-option. This
sub-option 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

127

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-6. BMC and Remote Access Controller Configuration Options (continued)
Option

Sub-option

Valid
Arguments

Description

Applicable
Systems

Example 2 (to display
the username for User
ID 3):
A:>syscfg
username -userid=3 --name
username
userid=3
name=bmcmaster
NA

--version*

NA

The asterisk is not
part of the
command syntax.

Displays the version
information for the
SYSCFG utility.

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
Table 3-7 documents all valid options and arguments along with a description
of the expected behavior of each option.
NOTE: Some of the following options or arguments might not be available on all
systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

128

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-7. SYSCFG Options and Arguments for State Configuration
Option

Valid
Description
Arguments

-b



or
--byte

This option 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.
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.

NA

-r
or
--read*

Example:

The asterisk
is not part of
the
command
syntax.

-x
or
--hex

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

None

This option 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

129

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

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 3-8 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.

Table 3-8. SYSCFG Options and Arguments for System Configuration
Option

Valid
Arguments

Description

--asset

None

This option reports the customer-programmable asset
tag number for a system. This option displays the asset
tag for a system. For modular systems, the
SYSCFG utility reports the asset tag for both the server
module and the asset tag for its chassis.
Example:
A:>syscfg--asset
asset=ASSET

None

--biosver*
The asterisk is
not part of the
command
syntax.

This option 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

130

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

--chassvctag* None
The asterisk is
not part of the
command
syntax.

--cpucount*

Description
This option reports the chassis service tag for modular
systems.
Example:
A:>syscfg --chassvctag
chassvctag=SVCTAG1

None

The asterisk is
not part of the
command
syntax.

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

--cpuspeed*
The asterisk is
not part of the
command
syntax.

None

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

131

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

--envfile

 This option 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" section.
Example:
A:>syscfg --envfile sys.ini
DELLNIC1=INTEL PRO100
DELLNIC2=INTEL PRO100
DVIDEO1=RAGEXL
DIDE1=PEQUR/ROSS IDE
DSCSI1=AIC-7899
None

--mem*
The asterisk is
not part of the
command
syntax.

This option 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

132

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

-n

 This option 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. See "PCI Reporting" for more
information. This option must be used with the --pci
option.
Example:
A:>syscfg -n pci.txt --pci
PCI Bus: 2, Device: 4, Function: 0
Vendor:
Device:
Pro 100]

8086 - Intel Corp.
1229 - 82557/8/9 [Ethernet

Sub Vendor:8086 - Intel Corp.
Sub Device:1017 - EtherExpress
PRO/100+ Dual Port Server Adapter

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

None

Slot:

01

Class:

02 - Network

SubClass:

00 - Ethernet

When used with the --outfile option, this option
specifies that the output file should be overwritten if it
exists.
Example:
A:>syscfg -outfile=out.ini --ovrwrt

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

133

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

--pci*

None

This option 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.

The asterisk is
not part of the
command
syntax.

For more information, see the "PCI Reporting" section.
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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

134

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

None

Description
Slot:

00

Class:

06 - Bridge

SubClass:

00 - CPU/PCI

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

135

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

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

-s



Vendor:

1166 - Unknown

Device:

0000 - Unknown

Slot:

00

Class:

06 - Bridge

SubClass:

00 - CPU/PCI

This option 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 is upper-cased before being set. This
option must be used with at least one function
command.
Example:
A:>syscfg -s ENVNAME --svctag
ENVNAME=SERVICE

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

136

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

--slot*

None

This option reports the slot of a modular system. If the
system is not modular, the slot is reported as 0. If used
with the -s option, the environment variable is set to the
slot.

The asterisk is
not part of the
command
syntax.

Example 1 (for a modular system):
A:>syscfg --slot
slot=1
Example 2 (for a non-modular system):
A:>syscfg --slot
slot=0

NOTE: This option is valid for Dell PowerEdge 1855
systems only.
--svctag*

None

The asterisk is
not part of the
command
syntax.

This option 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

This option reports the system asset tag for modular
systems.
Example:
A:>syscfg --sysasset
sysasset=ASSET01

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

137

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

--sysid*

None

This function command 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.

The asterisk is
not part of the
command
syntax.

Example:
A:>syscfg --sysid
sysid=0x00df
--sysname*

None

The asterisk is
not part of the
command
syntax.

This function command 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

138

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-8. SYSCFG Options and Arguments for System Configuration (continued)
Option

Valid
Arguments

Description

--syssvctag*

None

This option reports the system service tag for a modular
system.

The asterisk is
not part of the
command
syntax.

--uuid*
The asterisk is
not part of the
command
syntax.

Example:
A:>syscfg --syssvctag
syssvctag=BLADE01
None

This option 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-8044B1C04F423131

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

139

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

SYSCFG for IPv6 Configuration
Table 3-9 lists all valid options and arguments for IPv6 configuration along
with a description of each option. These options are applicable only if the
DRAC in your system supports IPv6.
Table 3-9. SYSCFG Options and Arguments for IPv6 Configuration
Option

Sub-option

lancfgparamsv6 --ipv6
or lcpv6

Valid
Argument

Description

enable,
disable

Loads or unloads the IPv6 stack.
A:> syscfg lcpv6 --ipv6=
enable

--ipsrcv6=static NA
--ipaddrv6=
 -prefixlengthv6=
<
prefixlengthv6>
--gatewayv6=<
ipv6gatewayaddre
ss>

Allows you to manually configure
IPv6 addresses.

--ipsrcv6=auto

Automatically configures the IPv6
addresses.

NA

A:>syscfg lcpv6 -ipsrcv6=static -ipaddrv6=
1234:1234:1234::1234 -prefixlengthv6=32 -gatewayv6=
1234:1234:1234::1

A:> syscfg lcpv6 -ipsrcv6=auto
--dnssrcv6 =auto NA

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

--dnssrcv6=static NA
--dnsserver1v6=


Allows you to manually set the
DNS address.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

140

SYSCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

Table 3-9.

SYSCFG Options and Arguments for IPv6 Configuration

Option

Sub-option

Valid
Argument

Description

-linklocaladdripv6
=


Allows you to view IPv6 addresses.

--gatewayv6=


Allows you to view IP gatewayv6
address.

A:> syscfg lcpv6 -linklocaladdripv6=
134.56.45.233

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 --pci option in Table 3-8.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

SYSCFG

141

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm

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, change the value of the MACHINE
name in the Variable Names section, and change the corresponding
section name.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

142

SYSCFG

4

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 has the following general features:
•

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 in \DELL\x32\TOOLKIT\TOOLS or in
\DELL\x64\TOOLKIT\TOOLS. In Linux, you can find it in /opt/dell/toolkit/bin.

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

PERC 7 controllers

•

PERC S100 and PERC S300 software controllers (Not supported on 64-bit
systems)

•

PERC 4/SC, PERC 4/DC, PERC 4/Di, PERC 4/IM (Supported only on
Windows PE 2.0)

•

PERC 4e/DC, PERC 4e/Di, PERC 4e/Si (Supported only on Windows PE
2.0)

•

PERC 5/E Adapter, PERC 5/I Integrated, PERC 5/i Adapter
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

RAIDCFG

143

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

•

CERC SATA 1.5/6-Channel (CH) and CERC SATA 1.5/2S (These
controllers are supported in Linux only.)

•

SAS 5iR Integrated, SAS 5iR Adapter

•

SAS 6iR Integrated, SAS 6iR Adapter

•

PERC 6/E Adapter, PERC 6/i Integrated, PERC 6/i Adapter

•

PERC 6/i Integrated for modular systems

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.dll (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.

RAIDCFG Options and Arguments
Table 4-1 lists all of the valid options, parameters, and arguments for the
RAIDCGFG 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 all 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 4-1 shows some examples of valid and invalid short and long format
command line instances. See "RAID Configuration Utility Options and
Arguments" for an explanation of the specific order for each option. See
Table 4-16 for a list of frequently used RAID commands.
NOTE: Some of the following options or arguments might not be available on all
systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

144

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-1.

RAIDCFG Short and Long Format Options

Option

Valid Arguments

Short Description

Mandatory or
Optional

No option

NA

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

Optional.

See Table 4-4 for
specific usage
information.

-h
-?
or
/?
-ac

cvd

Creates a virtual disk.

or

or

action

createvdisk

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.

-ac

dvd

or

or

action

deletevdisk

-ac

rghs

or

or

action

removeglobalhots
pare

-ac

sghs

or

or

action

setglobalhotspare

-ad

NA

or
adisk

See Table 4-2 for
specific usage
information.

Deletes a virtual disk.

See Table 4-9 for
specific usage
information.

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

Optional.

Assigns the specified disks
as global hot spares on the
specified controller.

Optional.

Specifies an array disk
command.

See Table 4-5 for
specific usage
information.

See Table 4-10 for
specific usage
information.

See Table 4-10 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

145

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-1. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

-ad

ch:targ, ch:targ, ... Specifies an array disk.

or

or ch:targ:lun,...

adisk

or ch:targ:enc
channel:target, or
channel:target:lun
, or
channel:target:en
closure

Short Description

Mandatory or
Optional
Optional.

See Table 4-5 for
For SCSI controllers, the
value of LUN should always specific usage
information.
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.

NOTE: You can also use

pdisk or -pd instead of adisk
or -ad to specify an array
disk.
-c
or



Specifies a RAID controller. See Table 4-3 for
specific usage
information.

d, c or d, e

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

Optional.

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

Mandatory, must
be typed in the
correct order.

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

See Table 4-12 for
specific usage
information.

controllerid
-cp
or
cachepolicy
-ctrl

NA

or
controller

-envc



or
envcommand

See Table 4-4 for
specific usage
information.

See Table 4-3 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

146

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-1.

RAIDCFG Short and Long Format Options (continued)

Option

Valid Arguments

Short Description

Mandatory or
Optional

-envn



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

See Table 4-12 for
specific usage
information.

or
envname
-fd
or
failoverdrive

ch:targ, ch:targ, ... Specifies the location of the Optional.
failover drive in an array.
See Table 4-4 for
or ch:targ:lun,...
specific usage
For
SCSI
controllers,
the
or ch:targ:enc
information.
value of LUN should
channel:target, or always be 0.
channel:target:lun
For SAS controllers, the
, or
channel:target:en value of enclosure can be
non-zero, in which case you
closure
must specify values for
channel, target, and
enclosure.

NOTE: From DTK 2.4
onwards, the -fd option
creates dedicated hot spares
instead of global hot spares.
To set global hot spares, see
Table 4-10.
-i

-l
or
logfile





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

Mandatory.
See Table 4-14 for
specific usage
information.

Logs command line output Optional.
to a file.
See Table 4-15 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

147

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-1. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

Short Description

Mandatory or
Optional

-o



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

Mandatory.
See Table 4-14 for
specific usage
information.


array.
See Table 4-4 for
Valid RAID values are 0, 1, specific usage
5, 10, 50.
information.

-r
or
raid

If no value is specified for
RAID, 0 is taken as the
default level.
-rp
or

ra, ara, nra, rc, nrc Sets the read policy for the
virtual disk.

Optional.

NA

Mandatory.

readpolicy
-se
or
setenvironment

Sets a user-defined
environment variable to the
value returned from the
function call. The function
calls are:

See Table 4-4 for
specific usage
information.
See Table 4-12 for
specific usage
information.

getcontrollerslot
s, getfirmware,
getcontrollertype,
getadisks,
getadiskcount,
getfreeadisks,
getfreeadiskcount,
getfreeadisksize,
gethotspares.
-si

NA

or
silent

Does not display any
information on the
terminal console.

Optional.
See Table 4-15 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

148

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-1.

RAIDCFG Short and Long Format Options (continued)

Option

Valid Arguments

Short Description

-sz



Sets the maximum size on
Optional.
the virtual disk in MB or GB See Table 4-4 for
if the size is not provided. specific usage
The default size is in MB. If information.
GB follows the number, the
size is expressed in GB.



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

or
size

-sp
or
spanlength

-ssz

NOTE: Spanlength is
applicable for RAID 10, RAID
50 and RAID 60. The minimum
permissible spanlength value
is 2 for RAID 10, 3 for RAID 50,
and 4 for 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.


or

or
vdisk

Mandatory.
See Table 4-4 for
specific usage
information.

Optional.
See Table 4-4 for

NOTE: When creating virtual specific usage

stripesize

-vd

Sets the stripe size on the
virtual disk in KB.

Mandatory or
Optional

disks, do not specify the units information.
for chunk (stripe) size. The
units are always listed in KB.
NA

Displays the virtual disks
See Table 4-6 for
under all of the controllers specific usage
along with the physical array information.
disks that make up the
virtual disks.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

149

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-1. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

-vd


virtual disk.

Optional.

NA

Displays the version
number of the utility.

Optional.

Sets the write policy for a
virtual disk. The valid
arguments are: wb (writeback caching),
wt (write-through caching),
wc (write-caching), nwc
(no-write-caching), and fwb
(force-write-back).

Optional.

or

Short Description

vdisk
-ver
or
version
-wp

wb, wt, wc, nwc,
fwb

or
writepolicy

Mandatory or
Optional
See Table 4-6 for
specific usage
information.
See Table 4-15 for
specific usage
information.
See Table 4-15 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

150

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

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

•

Initializing Virtual Disks

•

Importing and Clearing Foreign Configurations

•

Deleting Virtual Disks

•

Assigning and Unassigning Global Hot Spares

•

Assigning and Unassigning Persistent Dedicated Hot Spares

•

Setting Environment Variables

•

RAID Replication Options

•

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

151

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

General Help
Table 4-2 lists the RAIDCFG general help options.
Table 4-2. General Help
Options

Parame Valid
Description
ters
Arguments

No
option

NA

-?

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

Example:

/?

A:>raidcfg -h

-h

NA

RAIDCFG v3.3
Copyright (c) 2002-2010 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 be used 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—

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

152

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Enumerating RAID Controllers
Table 4-3 lists the RAIDCFG options, parameters, and pre-defined
arguments for enumerating RAID controllers.
Table 4-3. Enumerating RAID Controllers
Mandatory Optional Valid
Description
Options and Paramet Parameters
Arguments ers
Arguments
-ctrl

NA

or
controller

NA

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 4e/Di
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: 513O
Controller_ID/Slot_ID: 3
Controller_PCI_ID: 3:11:0
Controller_Name: PERC 4/DC
Channels: 2
No.of Virtual_Disks: 0
Firmware Version: 350O
RAIDCFG Command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

153

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-3. Enumerating RAID Controllers (continued)
Mandatory Optional Valid
Description
Options and Paramet Parameters
Arguments ers
Arguments
-c


rid

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 4e/DC
Channels: 2
Virtual_Disks: 1
Firmware Version: 521S
RAIDCFG Command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

154

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Creating Virtual Disks
Table 4-4 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.
NOTE: On CERC SATA 1.5/2S, CERC SATA 1.5/6CH, SAS 5/iR, and SAS 6/iR
controllers, use the entire array disk to create a virtual disk.
Table 4-4. Creating Virtual Disks
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

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

NA

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 E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

155

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
-cp

d, c

or

or

cachepolicy 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

156

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
-fd

ch:targ, ch:targ, Sets the failover drive for the virtual
...
disk. The -fd option is optional and can
or
be added to the command line in any
or
ch:targ:lun,...
failoverdrive
order after the mandatory option
or ch:targ:enc
combination.
channel:target, NOTE: From DTK 2.4 onwards, the -fd
or
option creates dedicated hot spares
channel:target:l instead of global hot spares. For
un, or
information about setting global hot
channel:target: spares, see Table 4-10.
enclosure
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

157

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
-r
or
-raid

0, 1, 5, 6, 10, 50, Sets the RAID type or level for the
60
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

158

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
• 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

159

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

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

ra, ara, nra, rc,
nrc

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 NoRead-Ahead 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:
•

PERC4/SC, PERC 4/DC, PERC
4/Di, PERC 4/IM, PERC4e/DC,
PERC 4e/Di, PERC 4e/Si

•

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

•

PERC 6/i Integrated, PERC 6/i
Adapter, PERC 6/E Adapter

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

160

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

NOTE: The PERC 4/IM controller has a

fixed set of read, write, and cache
policies. If you set any of these policies
while creating a virtual disk, your
settings are ignored.
• rc — (Read-Caching) Enables read
caching.
• nrc — (No-Read-Caching) Disables
read caching.

NOTE: The rc and nrc options are
supported on CERC SATA 1.5/CH
controller only.

The -rp option is optional and can
be added to the command line in
any order after the mandatory
option combination.
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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

161

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

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



Creates a virtual disk comprised of the
properties supplied. The -sp option 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.

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

162

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

-ctrl -ac=cvd -ssz
-c=id -ad=
ch:targ,ch:targ
, ...
or
[or
stripesize
ch:targ:encl,...]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
:lun,
channel:target
:lun,...
[or
channel:target
:
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 -ssz
option 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

163

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

-ctrl -ac=cvd -str
-c=id -ad=
ch:targ,ch:targ
or
, ...
[or
ch:targ:encl,...] strict
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
If the unused portion of an array disk is
greater than the above percent, 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

164

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments

-ctrl -ac=cvd -sz
-c=id -ad=
or
ch:targ,ch:targ
-size
, ...
[or
ch:targ:encl,...]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
:lun,...
channel:target
:lun,...
[or
channel:target
:
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 -sz option
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 CERC-SATA 1.5/6ch
controllers:
– RAID 0: 10MB
– RAID 1: 9MB
– RAID 5: 9MB
• For PERC 4 (except PERC 4/IM)
controllers:
– RAID 0: 10MB
– RAID 1: 10MB
– RAID 5: 10MB

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

165

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
• For PERC 5 controllers:
– RAID 0: 100MB
– RAID 1: 100MB
– RAID 5: 100MB
• For PERC 6 controllers:
– RAID 0: 100MB
– RAID 1: 100MB
– RAID 5: 100MB
– RAID 6: 100MB
– RAID 60: 100MB
• PERC 7 controllers:
– RAID 0: 100MB
– RAID 1: 100MB
– RAID 5: 100MB
– RAID 6: 100MB
– RAID 10: 100MB
– RAID 50: 100MB
– RAID 60: 100MB
• Software RAID controllers:
– RAID 0: 100MB
– RAID 1: 100MB
– RAID 5: 100MB
– RAID 10: 100MB

NOTE: If this option is not provided,

RAIDCFG determines the maximum
possible virtual disk size and create it.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

166

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
-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:
•

PERC 4/IM, PERC 4/SC, PERC
4/Di, PERC 4/DC, PERC 4e/DC,
and PERC 4e/Di

•

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

•

PERC 6/i Integrated, PERC 6/i
Adapter, PERC 6/E Adapter

NOTE: The PERC 4/IM controller has a

fixed set of read, write, and cache
policies. If you set any of these policies
while creating a virtual disk, your
settings are ignored.
• wc — (Write-Caching) sets the
controller to send a write-request
completion signal only after the data
is written to the disk.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

167

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-4. Creating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional
Valid Parameter Description
Parameters Arguments
• 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 wc and nwc options are
supported on the CERC SATA 1.5/CH
controller only.

The -wp option 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
Table 4-5 lists the RAIDCFG options, parameters, and pre-defined
arguments for enumerating array disks (hard drives).

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

168

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-5. Enumerating Array Disks (Hard Drives)
Mandatory
Options and
Arguments

Optional
Parameter

Valid
Description
Parameter
Arguments

-ad -c=id

NA

NA

or
adisk
controllerid=
id

Lists all the array disks attached to the
specified RAID controller. This option
combination is mandatory.

NOTE: You can also use pdisk or -pd
instead of adisk or -ad to specify an array
disk.
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
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:0:1
Size: 139392 MB (136 GB)
Avail: 0 MB

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

169

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-5. Enumerating Array Disks (Hard Drives) (continued)
Mandatory
Options and
Arguments

Optional
Parameter

Valid
Description
Parameter
Arguments
****** 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)

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

170

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-5. Enumerating Array Disks (Hard Drives) (continued)
Mandatory
Options and
Arguments

Optional
Parameter

Valid
Description
Parameter
Arguments
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
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!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

171

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-5. Enumerating Array Disks (Hard Drives) (continued)
Mandatory
Options and
Arguments

Optional
Parameter

Valid
Description
Parameter
Arguments

-ad -c=id

-vd=id



or
adisk
vdisk=id
controllerid=
id

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 4e/DC
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:0:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
RAIDCFG Command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

172

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-5. Enumerating Array Disks (Hard Drives) (continued)
Mandatory
Options and
Arguments
-ad -c=id

Optional
Parameter

Valid
Description
Parameter
Arguments

-ad=

or
arg,...

controllerid=
channel:tar
id vdisk=id
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 4e/DC
****** 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!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

173

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Enumerating Virtual Disks
Table 4-6 lists the RAIDCFG options, parameters, and pre-defined
arguments for enumerating virtual disks.
Table 4-6. Enumerating Virtual Disks
Mandatory
Options and
Arguments

Optional Valid
Parameter Parameter
Arguments

Description

-vd

NA

Lists the virtual disks for each controller
along with the array disks that make up each
virtual disk. This option is mandatory.

or
vdisk

NA

Example:
A:>raidcfg -vd
Controller: PERC 4e/DC
Virtual disk not found
Controller: PERC 4e/DC
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 4/SC
Virtual disk not found
Controller: PERC 4/SC
Virtual disk not found
RAIDCFG Command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

174

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-6.

Enumerating Virtual Disks (continued)

Mandatory
Options and
Arguments

Optional Valid
Parameter Parameter
Arguments

-vd

-c

or
vdisk

Description


displayed with the physical disk that
controller
comprises it. The -c option is optional and
id
can be added to the command line in any
order after the mandatory option.
Example:
A:>raidcfg -vd -c=2
Controller: PERC 4e/DC
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!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

175

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-6. Enumerating Virtual Disks (continued)
Mandatory
Options and
Arguments

Optional Valid
Parameter Parameter
Arguments

Description

-vd -c=id

-vd

or

or

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.

vdisk
vdisk
controllerid=
id



Example:
A:>raidcfg -vd -c=2 -vd=0
Controller: PERC 4e/DC
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
Dedicated HS: 1:2:0
RAIDCFG Command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

176

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Initializing Virtual Disks
Table 4-7 lists the RAIDCFG options, parameters, and pre-defined
arguments for initializing selected virtual disks.
Table 4-7.

Initializing Virtual Disks

Mandatory
Options and
Arguments

Optional
Valid
Parameters Parameter
Arguments

-vd -c=id NA
vd=id -ac=fi
or
vdisk
controllerid=
id vdisk=id
action=
fastinit

Description


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

NA

or
vdisk
controllerid=
id vdisk=id
action=
slowinit
-vd -c=id vd=id -ac=
sli
or
vdisk
controllerid=
id vdisk=id
action=
cancelinit


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

NA


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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

177

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Importing and Clearing Foreign Configurations
Table 4-8 lists the RAIDCFG options, parameters, and pre-defined
arguments for foreign configurations.
Table 4-8. RAIDCFG Options for Foreign Configurations
Mandatory
Options and
Arguments

Optional
Parameters

-ctrl -c=id -ac= NA
fgnimp
or
controller
controllerid=id
action=
foreignimport

Valid Parameter Description
Arguments


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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

178

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-8.

RAIDCFG Options for Foreign Configurations (continued)

Mandatory
Options and
Arguments

Optional
Parameters

-ctrl -c=id -ac= NA
fgnclr
or

Valid Parameter Description
Arguments


controller
controllerid=id
action=
foreignclear

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
-ctrl -c=id -ac= NA
fgnrvr
or
controller
controllerid=id
action=
foreignrecover



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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

179

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Deleting Virtual Disks
Table 4-9 lists the RAIDCFG options, parameters, and pre-defined
arguments for deleting virtual disks.
NOTE: If you delete a virtual disk on PERC 4/IM on Windows PE, you must reboot
the system.
Table 4-9. Deleting Virtual Disks
Mandatory
Options and
Arguments

Optional
Parameter

-vd -ac=dvd - NA
c=id

Valid
Parameter
Arguments

Description

NA

Deletes all virtual disks on the indicated
controller. This option combination is
mandatory.

or

Example:

vdisk
action=
deletevdisk
controllerid=
id
-vd -ac=dvd - -vd
c=id
or
or
vdisk
vdisk
action=
deletevdisk
controllerid=
id

A:>raidcfg -vd -ac=dvd -c=2
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 being 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

180

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Assigning and Unassigning Global Hot Spares
Table 4-10 lists the RAIDCFG options, parameters, and pre-defined
arguments for assigning and unassigning global hot spares.
Table 4-10.
Mandatory
Options and
Arguments

Assigning and Unassigning Global Hot Spares
Optional
Valid
Parameter Parameter
Arguments

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

NA

Description

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
RAIDCFG command successful!

-ctrl ac=rghs NA
-c=id -ad|pd=
ch:targ:encl,c
h:targ:encl

NA

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

Assigning and Unassigning Persistent Dedicated Hot Spares
Table 4-11 lists the RAIDCFG options, parameters, and pre-defined
arguments for assigning and unassigning dedicated hot spares.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

181

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-11. Assigning and Unassigning Persistent Dedicated Hot Spares
Mandatory
Options and
Arguments

Optional
Valid
Parameter Parameter
Arguments

Description

-ctrl -c=id ac=ephs

NA

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.

NA

or
controller
controllerid=
id action=
enableperiste
nthotspare

Example:
A:>raidcfg -ctrl -ac=ephs -c=2
-ad=0:1
RAIDCFG command successful!

-ctrl -c=id ac=dphs

NA

or
controller
controllerid=
id action=
disablepersist
enthotspare

NA

Unassigns the slot corresponding to the hot
spare drive as persistent. 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
-ad=0:1,0:2
RAIDCFG command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

182

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Setting Environment Variables
Table 4-12 lists the RAIDCFG options, parameters, and pre-defined
arguments for setting the CLI environment.
Table 4-12.

Setting Environment

Mandatory
Options and
Arguments

Optional Valid
Description
Parameter Parameter
Arguments

-se -envn=
 envc=


NA

NA

Sets a user-defined environment variable to
the value returned from the
getcontrollerslots function call.
This option combination is mandatory.

or

Example:

setenvironment
envname=

envcommand=


A:>raidcfg -se -envn=CNTRL envc=getcontrollerslots

-se -envn=
 envc=


CNTRL=0 1 2
RAIDCFG command successful!
-f
or
filename


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

or
setenvironment
envname=

envcommand=


D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

183

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-12. Setting Environment (continued)
Mandatory
Options and
Arguments

Optional Valid
Description
Parameter Parameter
Arguments

-se -envn=
 envc=
 c=id

NA

NA

or
setenvironment
envname=

envcommand=

controllerid=id

Sets a user-defined environment variable to
the value returned from the
getfirmware, getcontrollertype,
getadisks, getadiskcount,
getfreeadisks,
getfreeadiskcount,
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
Table 4-13 lists the function calls of the setenvironment option.
Table 4-13. Function Calls of the setenvironment Option
Function Call

Description

getfirmware

Returns the firmware version of the specified controllers.
Example:
A:>raidcfg -se -envn=FIRMWARE -envc=
getfirmware -c=2
FIRMWARE=531T
RAIDCFG command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

184

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-13.

Function Calls of the setenvironment Option (continued)

Function Call

Description

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!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

185

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-13. Function Calls of the setenvironment Option (continued)
Function Call

Description

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!

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!

getadiskcount

Returns the total number of array disks.
A:>raidcfg -se -envn=GETADISKCOUNT -envc=
getadiskcount -c=2
GETADISKCOUNT=1
RAIDCFG command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

186

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

RAID Replication Options
Table 4-14 lists the RAID replication options.
Table 4-14.

RAID Replication Options

Mandatory Optional
Valid
Options
Parameters Parameter
and
Arguments
Arguments
-i

NA

Description

 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

NA

 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]

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

187

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-14. RAID Replication Options (continued)
Mandatory Optional
Valid
Options
Parameters Parameter
and
Arguments
Arguments

Description

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

188

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Miscellaneous Options
Table 4-15 lists all other RAIDCFG options, parameters, and pre-defined
arguments.
Table 4-15.

Miscellaneous Optional Parameters

Mandatory
Options and
Arguments

Optional Valid
Parameter Parameter
Arguments

any

-l
or
logfile

Description

 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: 0
Controller_PCI_ID:
Controller_Name:
PERC 4e/Di

4:2:1
Dell PERC

Channels:

2

Virtual_Disks:

0

Firmware Version:
0[6064]

V2.8-

RAIDCFG command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

189

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-15. Miscellaneous Optional Parameters (continued)
Mandatory
Options and
Arguments

Optional Valid
Parameter Parameter
Arguments

Description

any

-si

Does not display any information on the
terminal console. This option is optional and
can be added to the command line in any
order after any mandatory options have been
added.

NA

or
silent

Example:
A:>raidcfg -ctrl -si
RAIDCFG command successful!
any

-ver
or
version

NA

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
RAIDCFG V2.4
Copyright (c) 2005-2007 Dell
Inc.
RAIDCFG Command successful!

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

190

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Quick Reference to RAIDCFG Commands
Table 4-16 lists the basic RAIDCFG commands.
Table 4-16.

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.

To list all the disks
raidcfg adisk - Lists all the disks attached to the
attached to a particular c=slotid
controller. The slot ID is obtained
controller
from the first command.
Record the drive location of the
disks for later reference.
To create a virtual disk
with all the default
settings

raidcfg -ctrl - Creates a virtual disk of maximum
ac=cvd -c=
available size for type RAID 0.
slotid -ad=
RAID 0 is the default.
x:y,x:y,...
The slot ID in <-c=slotid> and
the array disks in <-ad=...> are
obtained from the first two
commands.

To create a virtual disk raidcfg -ctrl - Creates a virtual disk of 5GB size
of a certain size with all ac=cvd -c=
for type RAID 0. RAID 0 is the
the default settings
slotid -ad=
default.
x:y,x:y,... The slot ID in <-c=slotid> and
sz=5GB
the array disks in <-ad=...> 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 5GB size
for type RAID 1.
The slot ID in <-c=slotid> and
the array disks in <-ad=...> are
obtained from the first two
commands.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

191

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-16.

Basic RAIDCFG Commands (continued)

Purpose

Command

Description

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

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

Creates a virtual disk of 5GB size
for type RAID 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 5GB size
for type RAID 1.

The slot ID in <-c=slotid> and
the array disks in <-ad=...> are
obtained from the first two
commands.

The slot ID in <-c=slotid>
and the array disks in <-ad=...>
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

To create a virtual disk
of RAID 50

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

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

192

RAIDCFG

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

Table 4-16.

Basic RAIDCFG Commands (continued)

Purpose

Command

Description

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 <-ad=...> are
obtained from the first two
commands. The drive location is
obtained from the second
command.

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

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 <-ad=...> are
obtained from the first two
commands. The drive location is
obtained from the second
command.

NOTE: The minimum number of
drives required to create a virtual
disk of RAID 60 is 8.
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 - Lists all the virtual disks on a
c=slotid
specific controller.

To delete a specific
virtual disk on a
controller

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

The slot ID in <-c=slotid> is
obtained from the first command.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

RAIDCFG

193

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

194

RAIDCFG

5

UPINIT

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

Features
The UPINIT utility has the following general features:
•

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

UPINIT

195

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

•

Uncompresses the UP file onto the UP image.

•

Unmounts the partition.
NOTE: On Windows PE, UPINIT runs as a batch file. In Linux, it is a shell script that
uses standard Linux commands to accomplish the same tasks done by the
Windows PE counterpart. Both command lines are identical and the output of the
two utilities are identical when the same image is used.

UPINIT Dependencies
In Linux, UPINIT looks for the following files:
•

mbr file in the dell/drmk directory

•

sysdrmk in the dell/toolkit/bin directory

In Windows, UPINIT looks for the following files:
•

createup.cfg, mountup.cfg, umountup.cfg, listup.cfg in the
DELL\TOOLKIT\TEMPLATE\SCRIPTS directory

•

sysdrmk.exe in the DELL\TOOLKIT\TOOLS directory

UPINIT Options and Arguments
Table 5-1 lists the valid options and arguments for the UPINIT utility.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

196

UPINIT

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

Table 5-1. UPINIT Options and Arguments
Option

Valid
Arguments

Description

none

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
© 2005 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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

UPINIT

197

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

Table 5-1. UPINIT Options and Arguments (continued)
Option

Valid
Arguments

Description

-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-2006 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.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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

198

UPINIT

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

Table 5-1. UPINIT Options and Arguments (continued)
Option

Valid
Arguments

Description
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-2006 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

UPINIT

199

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

Table 5-1. UPINIT Options and Arguments (continued)
Option

Valid
Arguments

Description
--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 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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

200

UPINIT

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

Table 5-1. UPINIT Options and Arguments (continued)
Option

Valid
Arguments

Description

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

UPINIT

201

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

202

UPINIT

A

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.
Table A-1 lists SYSCFG error codes and messages.
Table A-1. SYSCFG Error Codes and Messages
Error
Code

Message

0

Success

1

Attempt to read write-only parameter.

2

Password cannot exceed 16 characters.

3

A BMC was either not detected or is not supported.

4

This username is already in use. Enter a unique
username.

5

Access mode not supported.

6

Cannot return number of requested data bytes.

7

User ID 1 cannot be assigned a username.

8

Cannot execute duplicated request.

9

There was an error clearing the SEL.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

Messages and Codes

203

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

10

Clear SEL cannot be accompanied with any other
option.

11

racreset cannot be accompanied with any other
option.

12

Cannot execute command. Command, or request
parameter(s), not supported in present state.

13

Command not supported on given channel.

14

The community string may only contain printable
ASCII characters.

15

Destination unavailable. Cannot deliver request to
selected destination.

16

Cannot execute command. Insufficient privilege
level.

17

Command illegal for specified sensor or record
type.

18

Invalid commstring value.

19

Hardware subsystem error. Invalid data field in
request.

20

Invalid destination IP address.

21

The GUID is invalid.

22

Invalid gateway.

23

Invalid hostname.

24

Invalid IP address.

25

Invalid DNS IP address.

26

Invalid sub net mask.

27

Invalid value for PEF. PEF value should be between
1 and 16.

28

Reservation Canceled or Invalid Reservation ID.

29

Invalid Time to live value.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

204

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

30

Invalid VLANID value.

31

Invalid Command. Used to indicate an unrecognized
or unsupported command.

32

Command invalid for given LUN.

33

Load defaults cannot be accompanied with any other
option.

34

There was an error loading the defaults.

35

Node Busy. Command could not be processed because
command processing resources are temporarily
unavailable.

36

Out of space. Command could not be completed
because of a lack of storage space required to
execute the given command operation.

37

This parameter is not supported.

38

Parameter out of range. One or more parameters in
the data field of the Request are out of range.

39

The password may only contain printable ASCII
characters.

40

Password test failed.

41

Request data length invalid.

42

Request data field length limit exceeded.

43

Requested Sensor, data, or record not present.

44

Request data truncated.

45

Command response could not be provided.

46

Command response could not be provided. BMC
initialization or initialization agent in
progress.

47

Command response could not be provided. Device in
firmware update mode.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

205

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

48

Command response could not be provided. SDR
Repository in update mode.

49

Cannot execute command, SEL erase in progress.

50

Attempt to set the 'set in progress' value when
not in the 'set in complete' state.

51

The SOL character accumulate interval is invalid.

52

The SOL character send threshold is invalid.

53

The SOL retry interval is invalid.

54

Command completed successfully.

55

Time-out while processing command. Response
unavailable.

56

Unspecified error.

57

The password may only contain printable ASCII
characters.

58

Username cannot exceed 16 characters.

59

Invalid VLANID value. Enter in dddd format.

60

Attempt to write read-only parameter.

61

BMC is busy.

62

Response data did not return successfully.

63

BMC time out error.

64

Option '%s' requires an argument.

65

The asset tag for this system is not available.

66

The asset tag cannot be more than 10 characters
long.

67

The required BIOS interfaces cannot be found on
this system.

68

The BIOS version information is not available.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

206

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

69

There is not enough free system memory to complete
the BIOS update.

70

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.

71

The BIOS update file version is older than the
current system bios. Use the --force option to use
this BIOS image.

72

The BIOS update file version is identical to the
current system bios. Use the --force option to use
this BIOS image.

73

The sequence list must be a comma-separated
numerical list of valid unique boot device numbers
(ex: 2, 1, 3).

74

The sequence list must be a comma-separated list
of valid unique device names (ex: nic.emb.1,
hdd.emb.1) or a comma-separated numerical list of
valid unique boot device numbers (ex: 2, 1, 3).

75

There was an error setting the sequence.

76

The list is not formatted correctly. See the help
for more details.

77

The size of returned buffer is larger than the
size of allocated buffer.

78

There was a problem getting the state byte.

79

The state byte is not available on this system.

80

There was a problem setting the state byte.

81

The state byte must be a value between 0 and 255
decimal.

82

The CPU information is not available.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

207

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

83

The dependent option '%s' required for this
subcommand is missing in the command line.

84

Duplicate sub command '%s' has been entered.

85

The script file does contain not a valid DTK
environment script signature.

86

The format of the environment variable is
incorrect.

87

The --envar option can only be used for a single
option.

88

The --envar option can only be used for report
operations.

89

The individual sub commands should be specified
for the -s option.

90

Getting external serial connector settings failed.

91

Setting external serial connector settings failed.

92

There was an error opening the file.

93

File does not have write permission.

94

The file contains invalid options.

95

The replication information does not match for
this system.

96

There can only be one section in the input file.

97

Bad ini file, the section cannot be found.

98

The format of the bios image file is incorrect.

99

Report operations and set operations must be
separate.

100

Help is not available for the option.

101

The -x (--hex) option can only be used with -b or
-r.

102

Input file '%s' not found.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

208

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

209

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

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.

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

210

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

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.

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

211

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

212

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-1. SYSCFG Error Codes and Messages (continued)
Error
Code

Message

175

Unspecified error.

176

Getting LCD settings failed.

177

Invalid configuration. Attempting to set cap when
capenable is set to disable.

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.

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.

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

213

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Failure Messages
The UPINIT utility failure messages provide error codes to help diagnose why
some commands do not succeed.
Table A-2 lists error codes and messages common to Linux and Microsoft
Windows PE environments.
Table A-2. UPINIT Common Error Codes and Messages
Error
Code

Message

0

Dell Utility Partition created successfully.

1

Error: Disk ID not specified.

2

Error: SIZE not specified.

3

Error: Utility Partition Image file not specified.

4

Error: DRMK Path not specified.

5

Error: Dell Utility Partition already exits.
Please use --overwrite option to upgrade or
overwrite.

6

Error: Partitions exists. Please clear all the
partitions before running upinit.sh.

7

Error: DOS file(s) not found at the specified
path.

8

Error: UP IMAGE not found at the specified
location.

9

Error: format failed.

10

Error: Invalid size. Size should be a number
between 32 and 2000.

11

Error: sysdrmk failed.

12

System Error.

13

Error: Invalid Argument: .

14

Error: Unzip failed.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

214

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

UPINIT Linux-Specific Error Codes and Messages
Table A-3 lists error codes and messages specific to the Linux environment.

UPINIT Windows PE-Specific Error Codes and
Table A-3. UPINIT Linux-Specific Error Codes and Messages
Error Code

Message

31

Error: Invalid disk specified.

32

Error: Mount failed.

33

Cannot create mount point . File
exists.

34

Error: fdisk failed.

Messages
Table A-4 lists error codes and messages specific to the Windows PE
environment.
Table A-4. UPINIT Windows PE-Specific Error Codes and Messages
Error Code

Message

31

Error: DISKPART failed.

32

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 A-5 for a list of the error
codes and the associated messages.
Table A-5 lists RAIDCFG error codes and messages.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

215

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages
Error Code Message

0

RAIDCFG Command successful!

1

Error! Incorrect Syntax.

2

Failure!

3

Illegal operation

4

Unsupported operation

5

Device not found.

6

Format boot drive illegal

7

Buffer too small.

8

Virtual Disk contains boot partition.
Use force option to delete.

9

Init boot drive failed.

10

Format boot drive failed.

11

Cannot write boot drive.

12

Unsupported RAID value.

13

Invalid RAID configuration.

14

Span depth not in range.

15

RAID 1 failed.

16

Exactly 2 array disks are required to create
a RAID 1 virtual disk.

17

Unsupported stripe size value.

18

RAID 5 only.

19

RAID 5 error.

20

A minimum of 3 array disks are required to
create a RAID 5 virtual disk.

21

RAID 0 failed.

22

RAID 10 failed.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

216

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

23

RAID 50 failed.

24

RAID 5 not supported.

25

RAID 50 not supported.

26

Size too small for given RAID type.

27

Wrong number of disks for RAID 1concatenated.

28

Insufficient space to mirror disks.

29

Create Mirror not supported.

30

Disk in use.

31

Disk Lock operation failed.

32

Disk locked.

33

Disk Unlock operation failed.

34

Disk Unlocked.

35

Disk failed on rebuild.

36

Hot Spare not free.

37

Disk Diagnostic failed.

38

Disk Rebuild failed.

39

Disk Format failed.

40

Cancel of Disk Diagnostic failed.

41

Cancel of Disk Rebuild failed.

42

Cancel of Disk Format failed

43

Assign Hot Spare failed

44

Disk too Small for Hot Spare.

45

Unassign Hot Spare failed.

46

Prepare Disk for Removal failed.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

217

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

47

Disk Online failed.

48

Disk Offline failed.

49

UnMount Operation failed.

50

Mount Operation failed.

51

Cannot Format Array Disk.

52

Bad chunk size.

53

Invalid disk.

54

Virtual disk not found.

55

Virtual disk locked.

56

Drive in use.

57

Reached maximum physical size.

58

Reached maximum count of virtual disks.

59

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.

60

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.

61

Invalid Parameter

62

Failed drive cannot be added.

63

The controller cannot support the number of
array disks that you have selected. Choose a
smaller number.

64

Delete virtual disk failed. Controller busy.

65

Delete virtual disk failed.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

218

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

66

Create virtual disk failed.

67

Create virtual disk failed. Controller busy.

68

Create virtual disk failed. Failed to map
virtual disk to operating system disk.

69

Create virtual disk failed. Failed to map
virtual disk to operating system disk.

70

Virtual disk initialization failed.

71

Virtual disk initialization failed.
Controller busy.

72

Virtual disk reconstruction failed.
Controller busy.

73

Virtual disk resynching failed. Controller
busy.

74

Flush Virtual disk's cache failed on
controller.

75

Virtual disk partition specified not found.

76

Unsupported cache policy value.

77

Unsupported write policy value.

78

Unsupported read policy value.

79

Cancel initialization on virtual disk
failed.

80

Cancel reconstruction on virtual disk
failed.

81

Cancel resynchronization on virtual disk
failed.

82

The maximum number of virtual disks that can
be created has been reached.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

219

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

83

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.

84

You have selected an array disk that is in a
degraded or failed state. Choose another
array disk.

85

Delete the last created virtual disk first.

86

Virtual disk initialized for use and no
override requested.

87

Virtual disk type requested is invalid for
the attempted operation.

88

Virtual disk Move operation failed. Cannot
rename, virtual disk is already in use.

89

Failover invalid.

90

Virtual disk resynching.

91

Virtual disk resynch failed.

92

Virtual disk reconstruct failed.

93

Cannot format a virtual disk that contains a
boot or system partition.

94

Cannot initialize a virtual disk that
contains a boot or system partition.

95

Virtual disk Copy failed.

96

Virtual disk mirror set required.

97

Virtual disk Create - Read-only failed.

98

Virtual disk Create - Read-write failed.

99

Virtual disk - Clear-to-zero failed.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

220

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

221

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

222

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

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.

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

223

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

224

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

176

Invalid array disks or failover
selected for reconfigure/create
Please make sure that all array
failover drives associated with
disk are selected.

drives
operation.
disks and
the virtual

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

225

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

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.

194

Quiet alarm command failed. The enclosure
processor is busy or a firmware download is
in progress.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

226

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

227

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-5. RAIDCFG Error Codes and Messages (continued)
Error Code Message

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.

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

228

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

RACADM Firmware Error Codes and Messages
Table A-6 lists RACADM firmware error codes and messages.
Table A-6. RACADM Firmware Error Codes and Messages
Error Code

Message

1

UNKNOWN COMMAND.

2

OUTPUT ERROR

3

TOO FEW ARGUMENTS

4

UNKNOWN PARAMETER

5

CAN'T LOCK RESOURCE

6

RESOURCE LOCKED

7

USER NOT IN DATABASE

8

WRONG PASSWORD

9

LOGIN INCORRECT

10

NOT ACCESSIBLE VIA TELNET CONNECTION

11

ACCESS DENIED

12

INVALID ARGUMENT

13

INVALID GROUP NAME

14

USER DATABASE FULL

15

CAN'T CHANGE FACTORY DEFAULT

16

USER ALREADY IN DATABASE

17

CLOSING TELNET CONNECTION

18

USER DATABASE NOT INITIALIZED

19

INVALID COMMAND SHELL CALL

20

INVALID INPUT FILE

21

TFTP ERROR

22

PCI ERROR

23

SERVER IS IN GRAPHICS MODE

24

SYSTEM DATE AND TIME NOT SET
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

229

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-6. RACADM Firmware Error Codes and Messages (continued)
Error Code

Message

25

OUT OF MEMORY

26

ACCESS LOCKED

27

PAGING ERROR

28

PAGING ALREADY IN PROGRESS

29

ERROR ACCESSING DEVICE

30

WRONG NUMBER OF ARGUMENTS

31

NO SCREEN FOR ASR STORED

32

CAN'T ADD HISTORY MONITOR

33

INVALID IDENTIFIER

34

CANNOT WRITE TO FLASH

35

FIRMWARE FILE INVALID

36

CANNOT READ REGISTER

37

CANNOT UNLOCK RESOURCE

38

TIME OUT

39

SERVER IN TEXT MODE

40

WRONG GRAPHICS MODE

41

CONFIG SPACE LOCKED

42

MASTER LOCKED

43

ASB BUS LOCKED

44

HISTORY MONITORS NOT YET AVAILABLE

45

NO VALID VALUE FOR THIS FIELD

46

DIAGNOSTIC TASK ERROR

47

DIAGNOSTIC TASK IS ALREADY RUNNING

48

NO DIAGNOSTIC TASK RUNNING

49

READ ONLY

50

SNARFING IS NOT AVAILABLE

51

TEXT RESOLUTION OF SERVER CHANGED
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

230

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-6. RACADM Firmware Error Codes and Messages (continued)
Error Code

Message

52

MODULE NOT LOADED

53

IPMI ERROR

54

ERROR IN DIAGNOSTIC FUNCTION

RACADM Utility Error Codes and Messages
Table A-7 lists RACADM utility error codes and messages.
Table A-7. 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

231

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-7. RACADM Error Codes and Messages (continued)
Error Code

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.

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.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

232

Messages and Codes

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

Table A-7. RACADM Error Codes and Messages (continued)
Error Code

Message

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Messages and Codes

233

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

234

Messages and Codes

B

BMC Platform Events Filter Alert
Messages
All possible Platform Event Filter (PEF) Alert Messages along with a
description of each event are listed in Table B-1.
Table B-1. 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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007 BMC Platform Events Filter Alert Messages

235

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaC.fm

Table B-1. BMC PEF Alert Events (continued)
Event

Description

Hardware log is
full or emptied

Either an empty or a full hardware log requires
administrator attention.

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.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

236

BMC Platform Events Filter Alert Messages

C

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]
sysname=PowerEdge R805
sysid=0221
biosver=0.2.6
;svctag=VSPT067
;do not edit information above this line
acpower=last
asset=
bootseq=
nic.emb.1,nic.emb.2,nic.emb.3,satacdrom.emb.0,nic.emb
.4
bootseqretry=enable
conboot=enable
conterm=vt100
dbpm=disable
embhypervisor=on
embnic1=on
embnic2=onwithiscsi
embnic3=onwithiscsi
embnic4=onwithiscsi
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007

Sample File Formats

237

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

extserial=com1
fsbr=115200
integratedsas=enable
internalusb=on
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=192.168.0.1
;ipaddress=192.168.0.120
ipaddrsrc=static
nicselection=dedicated
autoneg=enable
dnsserver1=0.0.0.0
dnsserver2=0.0.0.0
dnsdhcp=disable
dnsracname=megh
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

238

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

dnsregisterrac=disable
domainname=
domainnamednsdhcp=disable
fullduplex=enable
speed=100Mbps
subnetmask=255.255.255.0
vlanid=1
vlanpriority=0
vlantag=disable
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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

239

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
userid=13
usrprivlmt=noaccess
lanuseraccess
userid=14
usrprivlmt=noaccess
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

240

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

lanuseraccess
userid=15
usrprivlmt=noaccess
lanuseraccess
userid=16
usrprivlmt=noaccess
lcd=default
lcd1=jagan!
memtest=enable
nmibutton=disable
numlock=on
opticaldrivectrl=enable
oswatchdogtimer=enable
pefcfgparams
alertpolnum=1
alertpolstatus=enable
pefcfgparams
alertpolnum=2
alertpolstatus=enable
pefcfgparams
alertpolnum=3
alertpolstatus=enable
pefcfgparams
alertpolnum=4
alertpolstatus=enable
pefcfgparams
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

241

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

242

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

filteraction=none
pefcfgparams
filter=procwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=procfail
filteralert=enable
filteraction=none
pefcfgparams
filter=powerwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=powerfail
filteralert=enable
filteraction=none
pefcfgparams
filter=hardwarelogfail
filteralert=enable
pefcfgparams
filter=autorecovery
filteralert=enable
pefcfgparams
filter=procabsent
filteralert=enable
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

243

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
hostname=DTK2.4-host
powerbutton=enable
pwdlock=unlock
rptkeyerr=enable
serialcfgparams
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

244

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

connectionmode=basic
msgcommbitrate=57600
msgcommflowctrl=rtscts
tmcfgdelctrl=bksp
tmcfgechoctrl=echo
tmcfghandshakectrl=enable
tmcfginputnewlineseq=cr
tmcfglineediting=enable
tmcfgnewlineseq=crlf
serialchannelaccess
ipmioverserial=alwaysavail
channelprivlmt=administrator
serialcomm=on
serialuseraccess
userid=2
usrprivlmt=administrator
serialuseraccess
userid=3
usrprivlmt=noaccess
serialuseraccess
userid=4
usrprivlmt=noaccess
serialuseraccess
userid=5
usrprivlmt=noaccess
serialuseraccess
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

245

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

246

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
solaction
userid=5
action=disable
solaction
userid=6
action=disable
solaction
userid=7
action=disable
solaction
userid=8
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

247

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

248

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

solbitrate=57600
solcharaccuminterval=10
solcharsendthreshold=220
solenable=enable
solprivlevel=administrator
sysid=0221
sysname=PowerEdge R805
tpm
tpmactivation=nochange
tpmsecurity=onwithoutpbm
usbports=enable
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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

249

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

useraction
userid=7
action=disable
useraction
userid=8
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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

250

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

251

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
username
userid=15
name=NULL
username
userid=16
name=NULL
;uuid=44454C4C530010508054D6C04F303637
virtualization=disable
vflash=enable
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

252

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

253

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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 4/I
#idRacDescriptionInfo=This system component provides
a complete set of #remote management functions for
Dell PowerEdge servers.
#idRacVersionInfo=1.20 (Build 01.17)
idRacName=DRAC 4/I
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

254

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

255

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

[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
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

256

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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
cfgNetTuningIpSubnetsAreLocal=0x1
cfgNetTuningIpReassTtl=0x3c
cfgNetTuningTcpMsl=0x3c
cfgNetTuningNicAutoneg=1
cfgNetTuningNic100MB=1
cfgNetTuningNicFullDuplex=1
[cfgOobSnmp]
cfgOobSnmpTrapsEnable=1
cfgOobSnmpAgentEnable=1
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

257

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

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=
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

258

Sample File Formats

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

[cfgRacVirtual]
cfgVirAtapiSvrPort=0xe54
cfgVirMediaDisable=0
cfgFloppyEmulation=0
[cfgActiveDirectory]
cfgADRacDomain=
cfgADRacName=
cfgADEnable=0
cfgADAuthTimeout=0x78
cfgADRootDomain=

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Sample File Formats

259

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

260

Sample File Formats

D

Summary of SYSCFG and RAIDCFG
Options

This appendix contains a summary of all the SYSCFG and RAIDCFG options.

SYSCFG Options
Table D-1 lists all the SYSCFG options and gives a brief description of these
options. For details on these options, see the section, ""SYSCFG" on
page 19".
Table D-1. SYSCFG Options
Options

Sub-options

Valid
Arguments

--envar

NA

 When used with the –s

a file so that this file can be
media should called from other scripts.
be writable

-h
or
--help

NA

none

-i
or
--infile

NA

 Directs the SYSCFG utility
to take input from the.ini
file.

Yes

-l
or
--logfile

NA

 Logs the command line
output to a time-stamped
file.

Yes

or


Description

Replicated

Without an argument, this No
option displays general usage
information for the utility.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Template Last Updated - 2/7/2007 Summary of SYSCFG and RAIDCFG Options

261

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

-o
or
--outfile

NA

 Outputs 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.

-s

NA



--version*

NA

--acpower

NA

Replicated

Prints the variable name and
the value assigned to it to
the console.
Displays the version
information, current time,
and date for the utility.

No

on, off, last

Specifies the behavior of the Yes
system after AC power is
lost.

-NA
adjcacheprefetc
h

enable,
disable

Enables the processor to
Yes
fetch the cache line
containing the currently
requested data and prefetch
the following cache line or
fetch only the cache line
containing the currently
requested data.

--assignintr

NA

standard,
distributed

Controls the interrupt
assignment of PCI devices in
the system.

--asset

NA



Sets the asset tag value.

--bezelir

NA

enable,
disable

Enables or disables the ESM Yes
to monitor and log front
bezel intrusion conditions.

Yes

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

262

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

--bootseq

NA

numerical
Sets the boot order.
list,
separated by
commas
or
list of device
names,
separated by
commas

--bootseqretry

Replicated
Yes (for
systems
that
support a
list of
device
names
only)

NA

enable,
disable

Enables or disables the boot Yes
sequence retry feature.

--cmosdefaults NA

enable,
disable

Enables or disables the
CMOS defaults to be on or
off in the next boot.

Yes

--conboot

NA

enable,
disable

Enables or disables console
redirection after boot.

Yes

--conred

NA

Sets console redirection to a Yes
off, serial1,
serial2,
particular port.
bmcsol, mmb

--conterm

NA

vt100, ansi

Sets console redirection
terminal type.

--cpucore

NA

1, 2, 4

Allows the user to control
Yes
the number of enabled cores
in each processor. The
maximum number of cores
per processor is enabled by
default.

enable,
disable

Enables or disables the
Yes
execute disable (XD) feature
of the CPU.

--cpuxdsupport NA

Yes

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

263

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--cstates

NA

enable,
disable

Enables or disables the
power c states of the
processor.

Yes

Available only on Dell
PowerEdge xx1x systems.
--dbpm

NA

enable,
disable

Enables or disables demand- Yes
based power management.

--devseq

NA

numerical
list,
separated by
commas

Sets the boot order for hard
drives.

-embhypervisor

NA

enable,
disable

Enables or disables the
embedded hypervisor port.

Yes

--embideraid

NA

on, off

Enables or disables the
embedded IDE RAID
controller.

Yes

--embnic1

NA

on, off,
onnopxe,
onwithiscsi

Enables or disables the first Yes
embedded network interface
controller (NIC).

--embnic2

NA

on, off,
onnopxe,
onwithiscsi

Enables or disables the
second embedded NIC.

--embnic3

NA

on, off,
onnopxe,
onwithiscsi

Enables or disables the third Yes
embedded NIC.

Yes (for
systems
NOTE: This option appears that
support a
only if your system is
configured with two or more list of
or
device
list of device bootable storage controllers. names
If
your
system
is
not
names,
only)
separated by configured with bootable
storage controllers and this
commas
option is included in the
configuration file, the utility
generates a usage error.

Yes

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

264

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--embnic4

NA

on, off,
onnopxe,
onwithiscsi

Enables or disables the
fourth embedded NIC.

Yes

--embnic1nic2

NA

enable,
disable

Enables or disables the
Yes
operating system interface of
the first and second
embedded NIC controllers.
Available only on Dell
PowerEdge 1855, PowerEdge
6850, and xx1x systems.

--embnic3nic4

NA

enable,
disable

Enables or disables the
Yes
operating system interface of
the third and fourth
embedded NIC controllers.
Available only on Dell
PowerEdge xx1x systems.

--embnics

NA

on, off

Enables or disables the
embedded NICs.

Yes

--embnic1pxe

NA

enable,
disable

Enables or disables Pre-boot Yes
eXecution Environment
(PXE) on the first embedded
NIC.

--embnic2pxe

NA

enable,
disable

Enables or disables PXE on
the second embedded NIC.

Yes

--embsataraid

NA

off,
combined,
ata, raid,
qdma

Configures the embedded
SATA (Serial Advanced
Technology Attachment)
RAID controller.

Yes

--embscsi1

NA

on, off

Enables or disables the first
SCSI controller.

Yes

--embscsi2

NA

on, off

Enables or disables the
second SCSI controller.

Yes

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

265

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--embscsiraid

NA

raid, off, scsi Enables or disables the
embedded SCSI RAID
or
controller.
raid, off

Yes

-NA
embscsiraidchb

raid, scsi

Sets the second channel of
the embedded SCSI RAID
controller to operate in
RAID or SCSI mode.

Yes

--embvideoctrl

NA

enable,
disable

Enables or disables the
embedded video controller.

Yes

--extserial

NA

com1, com2, Sets the behavior of the
rad
external serial connector.

Yes

--fiberchannel

NA

enable,
disable

Enables or disables
embedded fiber channel.

Yes

--floppy

NA

auto, off,
readonly

Enables or disables the
diskette drive controller.

Yes

--formfactor

NA

NA

Displays the geometry of
No
modular Dell PowerEdge
systems. Read-only option
and can have the following
values: halfheight (the
modular system occupies 1
slot of the chassis),
halfheight-dualwidth (the
modular system occupies 2
horizontal slots of the
chassis), fullheight (the
modular system occupies 2
vertical slots of the chassis),
and fullheight-dualwidth
(the modular system
occupies 4 slots of the
chassis).

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

266

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--fsbr

NA

115200,
57600,
19200, 9600

Sets the console redirection
fail safe baud rate.

Yes

--hwprefetcher

NA

enable,
disable

Enables or disables hardware Yes
prefetching by the processor.

--hddfailover

NA

off, on

Specifies which device in the Yes
hard disk drive sequence
menu is attempted in the
boot sequence.

--htassist

NA

enable,
disable

Enables or disables the probe Yes
filter chipset option. Some
applications may have lower
performance when the
chipset feature is disabled.

-i

NA

 Reads BIOS configuration
No
options from a file. A file can
be generated with the -o
option.

--idecdrom

NA

auto, off

Enables or disables the CD
drive controller.

--idectrl

NA

auto, off

Enables or disables the IDE Yes
controller.

--idracgui

NA

enable,
disable

Enables or disables iDRAC
GUI.

Yes

--integratedraid NA

enable,
disable

Enables or disables the
integrated RAID controller.

Yes

--integratedsas

NA

enable,
disable

Sets the behavior for the
integrated SAS controller.

Yes

--internalusb

NA

off, on

Enables or disables the
internal USB.

Yes

or
--infile

Yes

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

267

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--ioat

NA

enable,
disable

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

Yes

--lcd

NA

default,
none, user,
idracipv4add
ress,
idracmacaddr
ess,
ossystemnam
e, servicetag,
ipv6address,
ambienttemp
, systemwatts

Selects whether to display
Yes
the default string (model
name and number) or a userdefined string in the frontpanel LCD (Liquid Crystal
Display).



Configures the first line of
user-defined LCD strings.

--lcd1

NA

The idracipv4address,
idracmacaddress,
ossystemname, servicetag,
ipv6address, ambienttemp,
and systemwatts arguments
are available only on Dell
PowerEdge xx1x systems.
Yes

NOTE: Before setting user

strings for this option, ensure
that --lcd is set to user.

NOTE: If you have a Dell

PowerEdge x8xx system, you
must reboot your system for
the settings to take effect.
--lcd2

NA



Configures the second line Yes
of user-defined LCD strings.

NOTE: Before setting user

strings for this option, ensure
that --lcd is set to user.

NOTE: If you have a Dell

PowerEdge x8xx syste m, you
must reboot your system for
the settings to take effect.
D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

268

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--logicproc

NA

enable,
disable

Enables or disables the
logical processor
(Hyperthreading).

Yes

--lpt

NA

disable, lpt1, Disables or sets the parallel
lpt2, lpt3
port address.

Yes

--lptmode

NA

at, ps2

Sets the parallel port mode.

Yes

--mem*

NA

none

Reports the size of system
memory.

Yes

--memintleave

NA

enable,
disable

Enables or disables the
memory interleave mode.

Yes

-memoperating
mode

NA

optimizer,
Selects the memory
Yes
mirror,
operating mode. This feature
advancedecc is active only if a valid
memory configuration is
detected. This option is
available only on xx1x
systems.

--memremap

NA

off, auto

Enables or disables memory Yes
remapping.

--memtest

NA

enable,
disable

Enables or disables the
power-on self-test (POST)
extended memory test.

Yes

--mouse

NA

on, off

Turns the mouse controller
on or off.

Yes

none

Disables the POST prompt
message when the SCSI
controller type is changed.

No

The asterisk is not
part of the
command syntax.

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

269

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--numlock

NA

on, off

Enables or disables the
keyboard number lock.

Yes

--oldsetuppwd

NA



Confirms the existing setup No
password when setting a new
setup password.

--oldsyspwd

NA



Confirms the existing system No
password when setting a new
system password.

-NA
opticaldrivectrl

enable,
disable

Enables or disables the
Yes
optical CD-ROM controller.

--osmode

NA

enable,
disable

Enables or disables the
operating system
installation mode.

NA
-oswatchdogtim
er

enable,
disable

If your system stops
Yes
responding, this option aids
in the recovery of your
operating system. When set
to enabled, the operating
system is allowed to initialize
the timer. When set to
disabled (the default), the
timer has no effect on the
system.

NA

none

Overwrites the file contents No
when used with the -o
option.

--profile

maxperforma Displays the settings similar Yes
nce, osctl,
to the BIOS setup screen for
apc
the respective profile.

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

power

custom

Yes

Creates the custom profile.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

270

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

-min, max,
Allows you to set the CPU
cpupowermo osdbpm,
power and performance
de
systemdbpm management to minimum
power, maximum
performance, operating
system DBPM, or system
DBPM mode.
-min, 800,
memorypow 1067, 1333,
ermode
max

Allows you to set memory
power and performance
management to minimum
power or maximum power
mode, or 800Mhz, 1067Mhz,
or 1333Mhz.

-min, max
fanpowermo
de

Allows you to set the fan
algorithm to the minimum
power optimized or
maximum performance
optimized mode.

--cap

Displays the values of
budgetcap, and the
maximum and minimum
power thresholds in Watts.

--cap --unit

 watt, or
btuphr, or
percent
where
 is the limit
for power
consumption
in Watts, or
btuphr, or
percent.

The value of 
must be between the
maximum and minimum
threshold values, else an
error is displayed.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

271

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

-maxpowerca
p

Displays the value of the
maximum power threshold.

-minpowerca
p

Displays the value of the
minimum power threshold.

-
valsetuppwd

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

-setuppwdove
rride

Does not prompt you for a
password to access DTK
settings on systems that do
not have a setup password
configured.

Replicated

--powerbutton

NA

enable,
disable

Enables or disables the front Yes
bezel power button.

--pwdlock

NA

lock, unlock

Enables or disables the
ability to set the system
password.

No

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

272

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--redmem

NA

off, spare,
mirror, raid

Configures the redundant
memory mode.

Yes

If you perform operations
that change the --redmem
option, you must
immediately reboot the
system. This applies to
command line usage as well
as --infile usage.
Additionally, the --redmem
option should not be issued
with any other command
and should be immediately
followed by a system reboot.
This is important when you
develop scripts that can alter
the --redmem setting.
Not available on Dell
PowerEdge xx1x systems.
--rptkeyerr

NA

enable,
disable

Enables or disables the
reporting of keyboard errors
during POST.

Yes

--sata0

NA

auto, off

Enables or disables SATA
port 0.

Yes

NOTE: This option maps to
--sata_a for Dell
PowerEdge x9xx systems.
--sata1

NA

auto, off

Enables or disables SATA
port 1.

Yes

NOTE: This option maps to
--sata_b for Dell
PowerEdge x9xx systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

273

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--sata2

NA

auto, off

Enables or disables SATA
port 2.

Yes

NOTE: This option maps to
--sata_c for Dell
PowerEdge x9xx systems.
--sata3

NA

auto, off

Enables or disables SATA
port 3.

Yes

NOTE: This option maps to
--sata_d for Dell
PowerEdge x9xx systems.
--sata4

NA

auto, off

Enables or disables SATA
port 4.

Yes

NOTE: This option maps to
--sata_e for Dell
PowerEdge x9xx systems.
--sata5

NA

auto, off

Enables or disables SATA
port 5.

Yes

NOTE: This option maps to
--sata_f for Dell
PowerEdge x9xx systems.
--sata6

NA

auto, off

Enables or disables SATA
port 6.

Yes

NOTE: This option maps to
--sata_g for Dell
PowerEdge x9xx systems.
--sata7

NA

auto, off

Enables or disables SATA
port 7.

Yes

NOTE: This option maps to
--sata_h for Dell
PowerEdge x9xx systems.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

274

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

--serial1

NA

disable,
Configures the behavior for
com1, com3, serial port 1.
com1_bmc,
bmcserial,
bmclan, rac

Yes

--serial2

NA

auto, disable, Configures the behavior for
com2, com4 serial port 2.

Yes

--serialcomm

NA

on, com1cr,
com2cr, off

Configures the behavior of
serial port communication.

Yes

-NA
serialportaddrse
l

default,
alternate

Configures the port address
of the serial devices.

Yes

--setuppwd

NA



Configures the setup
password for the system
BIOS.

No

--sma

NA

enable,
disable

Enables or disables processor Yes
sequential memory access.

--slot*

NA

none

Reports the slot number for Yes
a modular system.

The asterisk is not
part of the
command syntax.

Description

Replicated

NOTE: This option is valid for
Dell PowerEdge 1855 systems
only.

--snoopfilter

NA

enable,
disable

Enables or disables the
Yes
snoop filter option from the
system BIOS.

--svctag*

NA

none

Reports the service tag for
the system.

NA



Sets the system password for No
the system BIOS.

The asterisk is not
part of the
command syntax.

--syspwd

No

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

275

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

tcm

tpm

Valid
Arguments

Description

Replicated

--tcmsecurity off, on

Configures the TCM
security feature.

Yes

-enabled,
tcmactivatio disabled,
n
nochange

Enables or disables the TCM Yes
activation feature.

--tcmclear

Clears the contents of the
TCM chip without erasing
the tcmsecurity and
tcmactivation settings.

NA

No

--tpmsecurity off,
Configures the TPM security Yes
onwithpbm, feature.
onwithoutpb
m
-enabled,
tpmactivatio disabled,
n
nochange

Enables or disables the TPM Yes
activation feature.

--tpmclear

Clears the contents of the
TPM chip without erasing
the tpmsecurity and
tpmactivation settings.

NA

No

-NA
undotpmcle
ar

Undoes the result of the
No
tpmclear setting. If you
specify this setting before
specifying the tpmclear
setting, the ‘There is
currently no pending
TPM Clear request’
message is displayed.

-
valsetuppwd

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

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

276

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

-NA
setuppwdove
rride

On systems that do not have No
a setup password configured,
if you set this option, you are
not prompted for a password
to access DTK settings.

--turbomode

NA

enable,
disable

Enables or disables corebased turbo mode.

--usb

NA

on, off,
legacy

Enables or disables the USB Yes
port.

--usbflash

NA

auto, fdd,
hdd

Sets the emulation of a USB Yes
flash device to auto, diskette
(FDD), or hard drive
(HDD).

--usbports

NA

enable,
Enables or disables USB
enablebacko ports.
nly, disable

Yes

--virtualization NA

enable,
disable

Enables or disables
virtualization in the CPU.

Yes

--vflash

NA

enable,
disable

Enables or disables vFlash in Yes
Dell Remote Access
Controllers 5 (DRAC 5).

bmcversion

--devid

NA

Displays revision
information for the BMC
and the firmware.

--devrevision
-majorfwrevis
ion

Yes

-minorfwrevis
ion
-NA
controlpanelacc
ess

viewandmodi Sets or gets the access level
fy, viewonly, for the Liquid Crystal
disabled
Display (LCD).

--clearsel

NA

NA

Yes

Clears the SEL.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

277

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

--deviceguid

NA

NA

Displays the GUID for the
BMC.

--encryptkey

NA


Platform Management
Interface (IPMI) sessions.

--identify

NA

0–254

Replicated

Yes

Flashes the identification
LED for a specified number
of seconds.

lanchannelacce --pefalerting enable,
ss
disable
-or
ipmioverlan disable,
lca
alwaysavail
-channelprivl user,
operator,
mt
administrator

Sets or displays the LAN
channel access settings such
as alerting and user privilege
limits.

lanchannelinfo -NA
or
mediumtype NA
lci
--prottype
NA
--ssnsupport NA

Displays media and protocol
information about the LAN
channel.

-activessncou
nt

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

278

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

lancfgparams
or
lcp

--ipaddrsrc

static, dhcp

--ipaddress



Configures and displays LAN
configuration parameters.

Replicated

-
--gateway



-
commstring
--destipaddr 
--alertdest

1, 2, 3, 4

--vlantag

enable,
disable

--vlanid

0–4095

--vlanpriority 0–7
--macaddress NA
-shared,
nicselection sharedfailove
r, dedicated

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

279

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

--fullduplex

enable,
disable

--autoneg

enable,
disable

--speed

10,100

--dnsdhcp

enable,
disable

Description

Replicated

--dnsserver1 
--dnsserver2 
-enable,
dnsregisterra disable
c
-
dnsracname
-enable,
domainnam disable
efromdhcp
lanuseraccess
or
lua

--usrprivlmt user,
Configures and displays user
operator,
access parameters for the
administrator LAN channel.
, noaccess
--userid

2–10

-currentenabl NA
eduserids

Returns the number of User
IDs with fixed names.

-useridswithfi NA
xednames

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

280

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

--loaddefaults

NA

NA

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

--nextboot

NA



Sets the device for the next
boot operation only.

--nmibutton

NA

enable,
disable

Enables or disables the NMI
button.

passwordaction --action

setpassword, Configures and displays
testpassword passwords associated with
User IDs.

pefcfgparams
or
pcp

fanfail,
voltfail,
discretevoltfa
il, tempwarn,
tempfail,
intrusion,
redundegrad
ed, redunlost,
procwarn,
procfail,
powerwarn,
powerfail,
hardwarelogfa
il,
autorecovery,
batterywarn,
batteryfail,
powerabsent,
procabsent,
systempower
warn,
systempowerf
ail

--filter

Replicated

Configures and displays PEF
configuration parameters.
See "BMC Platform Events
Filter Alert Messages" on
page 235 for a complete list
of all possible PEF messages
along a description of
each event.

NOTE: The voltfail option is
not supported on Dell
PowerEdge x9xx systems and
onwards.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

281

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

--filteraction powercycle,
reset,
powerdown,
powerreducti
on, none
--hostname



--filteralert

enable,
disable

-1, 2, 3, 4
alertpolnum
enable,
-alertpolstatu disable
s
--powerbutton

NA

enable,
disable

Enables or disables the
power button.

--powerctl

NA

powerdown< Performs a chassis
/argument> powerdown and controls the
powercycle

reset
softshutdown


D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

282

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

--racreset

NA

NA

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

serialchannelac -disable,
cess or
ipmioverseri alwaysavail
sca
al

Replicated

Sets or displays the channel
access settings for the serial
channel.

-user,
channelprivl operator,
mt
administrator
serialchannelinfo -NA
or
mediumtype
sci
--prottype
NA

Displays serial channel
information.

--ssnsupport NA
-NA
activessncou
nt

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

283

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

serialcfgparams -or
connection
scp
mode

Valid
Arguments

Description

basic,
terminal

Configures and displays
serial configuration
parameters.

-noflowctrl,
msgcommflo rtscts
wctrl
-NA
msgcommdt
rhangup

Replicated

NOTE: The BMC firmware

does not support serial port
Point-to-Point Protocol (PPP)
configurations.

-9600, 19200,
msgcommbi 57600,
trate
115200
-enable,
tmcfglineedi disable
ting
-del, bksp
tmcfgdelctrl
-echo, noecho
tmcfgechoct
rl
-enable,
tmcfghands disable
hakectrl
-noterm, crlf,
tmcfgnewlin null, cr, lfcr,
eseq
lf
-cr, null
tmcfginputn
ewlineseq

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

284

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

Replicated

serialuseraccess --usrprivlmt user,
Configures and displays user
or
operator,
access parameters for the
sua
administrator serial channel.
, noaccess
--userid

2–10

-NA
currentenabl
eduserids
-NA
useridswithfi
xednames
--solaction

Enables or disables SerialOver-LAN (SOL) access for
a particular user.
--userid

2–10 if your
system has a
DRAC 4
controller
2–16 if your
system has a
DRAC 5
controller

--action

enable,
disable

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

285

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

solcfgparams

--solenable

enable,
disable

Configures and displays SOL
configuration parameters.

Replicated

--solprivlevel user,
operator,
administrator
-solcharaccu
minterval

1–255

-1–255
solcharsendt
hreshold
--solbitrate

ssninfo

9600, 19200,
57600,
115200

-NA
maxactivess
ns
-NA
currentactiv
essns

useraction

Displays information about
the number of possible
active sessions and the
number of currently active
sessions on all channels on
the controller.

--userid

2–10

--action

enable,
disable

--name



--userid

2–10

--version

NA

NA

Displays the version
information for the SYSCFG
utility.

-b

NA



Specifies the value to write
to state data.

username

Enables and disables User
IDs for the
serialchannelaccess and
lanchannelaccess options.
Assigns user names to a
given User ID and displays
user names associated with a
given User ID.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

286

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

-r or --read

NA

NA

Reads the value of state data.

-x

NA

NA

Specifies that the state data
value should be in
hexadecimal format.

--asset

NA

NA

Reports the asset tag for a
system.

--biosver

NA

NA

Reports the BIOS version for
a system.

--chassvctag

NA

NA

Reports the chassis service
tag for modular systems.

--cpucount

NA

NA

Reports the number of
processors in a system.

--cpuspeed

NA

NA

Reports the speed of all
processors in a system.

--envfile

NA



Specifies the input file to use
for resolving PCI vendor,
device, and class codes to
environment variables and
names.

--mem

NA

NA

Reports the amount of
system memory in a system.

--n

NA



Specifies an input file to use
for resolving PCI vendor and
device numbers to strings.

--ovrwrt

NA

NA

Overwrites the specified file
contents when used with the
-o option.

--pci

NA

NA

Scans all PCI buses and
reports the results.

--slot

NA

NA

Reports the slot of a modular
system.

Replicated

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

287

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

--svctag

NA

NA

Reports the service tag for a
system.

--sysasset

NA

NA

Reports the asset tag for a
server module in a modular
system chassis.

--sysid

NA

NA

Reports the unique system
ID bytes for a system.

--sysname

NA

NA

Reports the system
identification string for a
system.

--syssvctag

NA

NA

Reports the service tag for a
server module in a modular
system chassis.

--uuid

NA

NA

Reports the unique universal
identifier (UUID) for a
system.

enable,
disable

Loads or unloads the IPv6
stack.

lancfgparamsv6 --ipv6
--ipsrcv6=
static
--ipaddrv6=
 -prefixlength
v6=

-gatewayv6=


Allows you to manually
configure IPv6 addresses.

--ipsrcv6=
auto

Automatically configures the
IPv6 addresses.

Replicated

Yes

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

288

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-1. SYSCFG Options (continued)
Options

Sub-options

Valid
Arguments

Description

--dnssrcv6 =
auto

Automatically configures the
DNS address.

--dnssrcv6=
static -dnsserver1v6
=


Allows you to manually set
the DNS address.

-linklocaladdr
ipv6=


Allows you to view IPv6
addresses.

-gatewayv6=


Allows you to view IP
gatewayv6 address.

Replicated

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

289

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

RAIDCFG Options
Table D-2 lists all the RAIDCFG options and gives a brief description of
these options. For details on these options, see the section, "RAIDCFG".
Table D-2. RAIDCFG Short and Long Format Options
Option

Valid Arguments

Short Description

Mandatory or
Optional

No
option

NA

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

Optional.

See Table 4-4 for
specific usage
information.

-h
-?

See Table 4-1 for
specific usage
information.

or
/?
-ac

cvd

Creates a virtual disk.

or

or

action

createvdisk

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.

-ac

dvd

or

or

action

deletevdisk

-ad

NA

Deletes a virtual disk.

See Table 4-9 for
specific usage
information.

Specifies an array disk command.

See Table 4-5 for
specific usage
information.

or
adisk

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

290

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-2. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

-ad

ch:targ, ch:targ, ... Specifies an array disk.

Optional.

or

or ch:targ:lun,...

adisk

or ch:targ:enc

See Table 4-5 for
specific usage
information.

channel:target, or
channel:target:lu
n, or
channel:target:en
closure

-c
or

Short 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.

NOTE: You can also use pdisk or -pd
instead of adisk or -ad to specify an
array disk.



Specifies a RAID controller.

d, c or d, e

Specifies the cache policy for reads on Optional.
a specified virtual disk or disk cache See Table 4-4 for
policy.
specific usage
information.

NA

Displays a list of the supported RAID Mandatory, must
controllers in the system, along with be typed in the
select property information.
correct order.

controlle
rid
-cp
or
cachepol
icy
-ctrl
or
controller

-envc



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



Sets the environment variable
See Table 4-12
() that equates to the value for specific usage
returned from a function call.
information.

envcom
mand
or
envname

See Table 4-3 for
specific usage
information.

See Table 4-3 for
specific usage
information.

or

-envn

Mandatory or
Optional

See Table 4-12
for specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

291

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-2. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

-fd

ch:targ, ch:targ, ... Specifies the location of the failover
or ch:targ:lun,... drive in an array.

or

Short Description

Mandatory or
Optional
Optional.
See Table 4-4 for
specific usage
information.

failoverd or ch:targ:enc
rive
channel:target, or
channel:target:lu
n, or
channel:target:en
closure

For SCSI controllers, the value of
LUN should always be 0.

-i

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

Mandatory.

Logs command line output to a file.

Optional.

-l





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

NOTE: From DTK 2.4 onwards, the -fd
option creates dedicated hot spares
instead of global hot spares. To set
global hot spares, see Table 4-10.

or

See Table 4-15
for specific usage
information.

logfile
-o

-r
or
raid

See Table 4-14
for specific usage
information.



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


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

Mandatory.
See Table 4-14
for specific usage
information.
Optional.
See Table 4-4 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

292

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-2. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

-rp

ra, ara, nra, rc, nrc Sets the read policy for the virtual
disk.

Optional.

NA

Mandatory.

or

Short Description

readpoli
cy
-se
or
setenviro
nment

-si

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

NA

or



or
size



or
spanleng
th

See Table 4-12
for specific usage
information.

Optional.

Sets the maximum size on the virtual
disk in MB or GB if the size is not
provided.

Optional.

The default size is in MB. If GB
follows the number, the size is
expressed in GB.

-sp

See Table 4-4 for
specific usage
information.

Does not display any information on
the terminal console.

silent
-sz

Mandatory or
Optional

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

NOTE: Spanlength is applicable only

for RAID 50. The minimum permissible
spanlength value is 3. The number of
array disks for creating virtual disks
should not be a prime number and
should be divisible by the specified
spanlength.

See Table 4-15
for specific usage
information.
See Table 4-4 for
specific usage
information.

Mandatory.
See Table 4-4 for
specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

Summary of SYSCFG and RAIDCFG Options

293

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm

Table D-2. RAIDCFG Short and Long Format Options (continued)
Option

Valid Arguments

Short Description

-ssz



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

NA

Displays the virtual disks under all of See Table 4-6 for
the controllers along with the physical specific usage
array disks that make up the virtual
information.
disks.

or
stripesiz
e
-vd
or
vdisk
-vd
or



Optional.

NA

Displays the version number of the
utility.

Optional.

Sets the write policy for a virtual disk.
The valid arguments are: wb (writeback caching),
wt (write-through caching), wc (writecaching), and nwc (no-write-caching).

Optional.

vdisk
-ver
or
version
-wp

wb, wt, wc, nwc

or
writepoli
cy

Mandatory or
Optional

See Table 4-6 for
specific usage
information.
See Table 4-15
for specific usage
information.
See Table 4-15
for specific usage
information.

D E L L C O N F I D E N T I A L – P R E L I M I N A R Y 1 2 / 3 / 1 0 - F O R P R O O F O N LY

294

Summary of SYSCFG and RAIDCFG Options

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookIX.fm

Index
D

UPINIT, 196
overview
DTK utilities, 7

disk partitioning
UPINIT, 195
disk partitioning utilities, 8
disk partitioning utility, 8
DTK utilities
overview, 7

R
RAC configuration utilities
RACADM, 8
RAC configuration utility, 8

E

RAID configuration utilities, 8

error codes, 203

RAID configuration utility
RAIDCFG, 8

error messages, 17, 203

F
features
RAIDCFG, 143
SYSCFG, 19
UPINIT, 195

M
messages and codes, 203

O

RAIDCFG, 143
error codes and messages, 215
features, 143
options and arguments, 144, 151
supported RAID controllers, 143,
195
replication, 8
requirements, 7

S
SYSCFG, 19
error checking and messages, 203
features, 19
options and arguments, 25

options and arguments
RAIDCFG, DELL
144 CONFIDENTIAL – PRELIMINARY 12/3/10

FOR PROOF ONLY

Index

295

FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookIX.fm

system configuration and update
utilities, 8
SYSCFG, 8

U
UPINIT, 195
creating a partition, 195
features, 195
options and arguments, 196
utility, 195
utilities
disk partitioning, 8
RAC configuration, 8
RACADM, 8
RAIDCFG, 8, 143
SYSCFG, 8, 19
UPINIT, 195
utility
UPINIT, 195
utility types
RAID configuration, 8
system configuration and
update, 8

DELL CONFIDENTIAL – PRELIMINARY 12/3/10
FOR PROOF ONLY
296

Index