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

2014-11-13

: 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 [warning: Documents this large are best viewed by clicking the View PDF Link!]

Dell OpenManage
Deployment Toolkit 3.4
Command Line Interface Reference Guide

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 – FOR PROOF ONLY

Template Last Updated -03/06/2010

Dell OpenManage

Deployment Toolkit 3.4

Command Line Interface

Reference Guide

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.

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 3

Contents

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . 7

What’s New . . . . . . . . . . . . . . . . . . . . . . . . 7

Requirements . . . . . . . . . . . . . . . . . . . . . . . 7

Toolkit Utilities . . . . . . . . . . . . . . . . . . . . . . 7

System Configuration Utility . . . . . . . . . . . . . 8

RAID Configuration Utility . . . . . . . . . . . . . . 8

RAC Configuration Utility . . . . . . . . . . . . . . . 8

Disk Partitioning Utility . . . . . . . . . . . . . . . . 8

Replication of DTK Utilities . . . . . . . . . . . . . . . . 8

Other Documents You May Need . . . . . . . . . . . . 10

Obtaining Technical Assistance . . . . . . . . . . . . 11

2 Command Syntax Overview . . . . . . . . . . . 13

Command Line Syntax . . . . . . . . . . . . . . . 13

Case Sensitivity . . . . . . . . . . . . . . . . . . 15

Command Line Option Delimiters . . . . . . . . . 15

Read and Write Commands . . . . . . . . . . . . 16

File Input and Output Commands . . . . . . . . . 16

Log Files . . . . . . . . . . . . . . . . . . . . . . 17

Help Option . . . . . . . . . . . . . . . . . . . . . 17

Error Checking and Error Messages . . . . . . . . . . 17

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

4Contents

3 SYSCFG . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Features . . . . . . . . . . . . . . . . . . . . . . . . . 19

SYSCFG General Options . . . . . . . . . . . . . . . . 20

SYSCFG for BIOS Configuration . . . . . . . . . . . . . 25

Options for BIOS Configuration . . . . . . . . . . 25

SYSCFG for BMC and Remote Access Controller

Configuration . . . . . . . . . . . . . . . . . . . . . . 87

BMC and Remote Access Controller

Configuration Options . . . . . . . . . . . . . . . 88

SYSCFG for State Configuration . . . . . . . . . . . . . 128

SYSCFG Options for State Configuration . . . . . . 128

SYSCFG for System Configuration . . . . . . . . . . . . 130

Options for System Configuration . . . . . . . . . 130

SYSCFG for IPv6 Configuration . . . . . . . . . . . . . 140

PCI Reporting . . . . . . . . . . . . . . . . . . . . . . 141

Environment Variable File . . . . . . . . . . . . . 142

4 RAIDCFG . . . . . . . . . . . . . . . . . . . . . . . . 143

Features . . . . . . . . . . . . . . . . . . . . . . . . . 143

Supported RAID Controllers . . . . . . . . . . . . . . . 143

RAIDCFG Dependencies . . . . . . . . . . . . . . . . . 144

RAIDCFG Options and Arguments . . . . . . . . . . . . 144

RAID Configuration Utility Options and Arguments . . . 151

General Help . . . . . . . . . . . . . . . . . . . . 152

Enumerating RAID Controllers . . . . . . . . . . . 153

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

Contents 5

Creating Virtual Disks . . . . . . . . . . . . . . . 155

Enumerating Array Disks . . . . . . . . . . . . . . 168

Enumerating Virtual Disks . . . . . . . . . . . . . 174

Initializing Virtual Disks . . . . . . . . . . . . . . 177

Importing and Clearing Foreign

Configurations . . . . . . . . . . . . . . . . . . . 178

Deleting Virtual Disks . . . . . . . . . . . . . . . 180

Assigning and Unassigning

Global Hot Spares . . . . . . . . . . . . . . . . . 181

Assigning and Unassigning Persistent

Dedicated Hot Spares . . . . . . . . . . . . . . . 181

Setting Environment Variables . . . . . . . . . . . 183

Function Calls of Setenvironment Option . . . . . 184

RAID Replication Options . . . . . . . . . . . . . 187

Miscellaneous Options . . . . . . . . . . . . . . . 189

Quick Reference to RAIDCFG Commands . . . . . . . . 191

5 UPINIT . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Features . . . . . . . . . . . . . . . . . . . . . . . . . 195

Creating a Partition Using UPINIT . . . . . . . . . . . 195

UPINIT Dependencies . . . . . . . . . . . . . . . . . . 196

UPINIT Options and Arguments . . . . . . . . . . . . . 196

A Messages and Codes . . . . . . . . . . . . . . 203

SYSCFG Error Codes and Messages . . . . . . . . . . 203

Failure Messages . . . . . . . . . . . . . . . . . 203

UPINIT Common Error Codes and Messages . . . . . . 213

Failure Messages . . . . . . . . . . . . . . . . . 214

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

6Contents

UPINIT Linux-Specific Error Codes and Messages . . . 215

UPINIT Windows PE-Specific Error Codes

and Messages . . . . . . . . . . . . . . . . . . . . . . 215

RAIDCFG Error Codes and Messages . . . . . . . . . . 215

Failure Messages . . . . . . . . . . . . . . . . . 215

RACADM Firmware Error Codes and Messages . . . . 229

RACADM Utility Error Codes and Messages . . . . . . 231

B BMC Platform Events Filter

Alert Messages . . . . . . . . . . . . . . . . . . . 235

C Sample File Formats . . . . . . . . . . . . . . . 237

Sample SYSCFG Utility .ini File Format . . . . . . . . . 237

Sample RAIDCFG Utility .ini File Format . . . . . . . . 253

Sample RACADM Utility .ini File Format . . . . . . . . 254

D Summary of SYSCFG and

RAIDCFG Options . . . . . . . . . . . . . . . . . 261

SYSCFG Options . . . . . . . . . . . . . . . . . . . . . 261

RAIDCFG Options . . . . . . . . . . . . . . . . . . . . 290

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Template Last Updated - 2/7/2007 Introduction 7

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

8Introduction

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Introduction 9

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

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

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.

10 Introduction

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Introduction 11

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

12 Introduction

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Template Last Updated - 2/7/2007 Command Syntax Overview 13

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Command Syntax Overview

Syntax refers to the way a command and its parameters are entered.

Dell OpenManage Deployment Toolkit (DTK) Command Line Interface

(CLI) commands can be arranged in any order 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]

syscfg bmcoption1 bmcsuboption1

[arg1]...bmcsuboptionX [argX]

•RAIDCFG

raidcfg [mandatory options] <optional arguments>

•RACADM

racadm <options> <subcommand> <subcommand_options>

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

14 Command Syntax Overview

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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

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

<optional

argument>

Indicates the generic designation for an optional argument.

<string> Indicates the generic designation for a string.

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

Command Syntax Overview 15

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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

Table 2-2. DTK Command Line Examples

Valid/

Invalid

DTK Command Line Example

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

invalid syscfg --option1=argument

--option2 --option3

syscfg --asset=R910

--floppy --bootseq

valid syscfg -o=filename

--option1

--option2

syscfg -o=/tmp/myfile.txt

--floppy

--bootseq

valid syscfg -l=filename

--option1

--option2

syscfg -l=

/tmp/myfile.txt --floppy

--bootseq

Table 2-1. Command Line Syntax

(continued)

Element Description

16 Command Syntax Overview

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

File Input and Output Commands

• Specify the file input using the

-i

filename

> command,

where <

filename

> is the name of the input file.

• Specify the file output using the

-o

filename

> command,

where <

filename

> is the name of the output file.

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

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

Table 2-2. DTK Command Line Examples

Valid/

Invalid

DTK Command Line Example

Command Syntax Overview 17

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Log Files

The -l <filename> or --logfile <filename> 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 <utilname> - <output text>.

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.

18 Command Syntax Overview

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Template Last Updated - 2/7/2007 SYSCFG 19

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

20 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

options

Valid

Arguments

Description

No option NA 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)

Usage: syscfg --option[=argument]

For more information about a

particular command,

use the option '-h' followed by

the command name.

Example: syscfg -h --asset

SYSCFG 21

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--envar valid

filename

valid path

media

should be

writable

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

must not be specified if the DTKENVSCR

environment variable is set to a valid filename.

In this case, the filename pointed to by

DTKENVSCR is used to store the environment

variable data.

Example:

syscfg --mem -s=temp --envar=

z:\scripts\file.bat

When used without the -s option, --envar takes

the default variable.

Linux Example:

syscfg --svctag --envar=

/tmp/myvars.txt

svctag = 2G8LC1S

syscfg_var = ’2G8LC1S’

source /tmp/myvars.txt

Windows PE Example:

syscfg --svctag --envar=

i:\myvars.bat

svctag = 2G8LC1S

syscfg_var = ’2G8LC1S’

call i:\myvars.bat

Table 3-1. SYSCFG General Options

(continued)

Options Sub-

options

Valid

Arguments

Description

22 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-h

--help

NA none

<valid

option

name>

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

options, 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.

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

Table 3-1. SYSCFG General Options

(continued)

Options Sub-

options

Valid

Arguments

Description

SYSCFG 23

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-i

--infile

NA <filename> 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

--logfile

NA <filename> 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

Table 3-1. SYSCFG General Options

(continued)

Options Sub-

options

Valid

Arguments

Description

24 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-o

--outfile

NA <filename> 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 <string> 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 com-

mand 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)

Table 3-1. SYSCFG General Options

(continued)

Options Sub-

options

Valid

Arguments

Description

SYSCFG 25

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

26 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Option Valid

Arguments

Description Applicable

Systems

--acpower on, off, last This option sets the behavior for

the system after AC power is lost.

This option specifies how the

system responds to the restoration

of AC power and is particularly

useful in systems that are turned off

using a power strip. When set to on,

the system turns on after AC is

restored. When set to off, the

system does not turn on after AC

is restored. When set to last, the

system turns on if the system was

on when AC power was lost; if the

system was off when AC power

was lost, the system remains off

when power is restored.

This option is available on all

supported systems. This value can

be replicated.

Example:

A:>syscfg --acpower=on

acpower=on

All Dell

PowerEdge

systems

SYSCFG 27

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--adjcacheprefetch enable, disable When this option is set to

enabled, the processor fetches the

cache line containing the

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

All Dell

PowerEdge

systems

--asset <string> This option reports or sets the

customer-programmable asset tag

number for a system.

The maximum length of an asset

tag is 10 characters. Asset tag

values cannot contain any spaces.

This option is available on all

supported systems. This value can

be replicated.

Example:

A:>syscfg --asset=

ASSETTAG

asset=ASSETTAG

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

28 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--assignintr standard,

distributed

This option controls the interrupt

assignment of PCI devices in the

system. This option is set to

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

All Dell

PowerEdge

systems

--bezelir enable, disable This option enables or disables

the ESM to monitor and log front

bezel intrusion conditions.

Example:

A:>syscfg --bezelir=

enable

bezelir=enable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 29

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Example:

A:>syscfg --bootmode=

uefi

bootmode=uefi

Dell PowerEdge

xx1x systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

30 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--bootseq numerical list,

separated by

commas

list of device

names,

separated by

commas

This option sets the boot order for

a system. Without an argument,

this option prints the boot order

list. The argument must be

formatted as a comma-separated

numerical list with no spaces. The

list must be within the bounds of

the current boot list, 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.

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.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 31

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

32 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 33

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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.

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

34 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

A:>syscfg --

bootseqretry=enable

All Dell

PowerEdge

systems

--cmosdefaults enable, disable This option requests a default

CMOS value during the next

reboot. The default values are on

and off.

A:>syscfg --

cmosdefaults=enable

cmosdefaults=disable

Dell PowerEdge

x9xx and later

systems

--conboot enable, disable This option configures or reports

whether console redirection

occurs after boot. This option is

available on all supported systems

that support console redirection.

This option can be replicated.

Example:

A:>syscfg --conboot=

enable

conboot=enable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 35

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--conred serial1, serial2,

off, bmcsol,

mmb

This option configures or reports

the communication port for

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.

Example:

A:>syscfg --conred=

serial1

conred=serial1

Dell PowerEdge

systems earlier

than PowerEdge

x9xx systems

--conterm vt100, ansi This option configures or reports

the terminal type for console

redirection. This option is

available on all supported systems

that support console redirection.

This option can be replicated.

Example:

A:>syscfg --conterm=

vt100

conterm=vt100

All Dell

PowerEdge

systems

--cpuc1e enable, disable This option enables or disables

C1-E. By default, it is enabled.

This option can be replicated.

Example:

A:>syscfg --cpuc1e=

enable

cpuc1e=enable

Dell PowerEdge

xx1x systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

36 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--cpucore 1, 2, 4, 6, 8, 10,

12, all

This option controls the number

of enabled cores in each processor.

The default value is set to the

maximum number of cores

per processor. The number of

cores depends on the processor.

Reading the cpucore that is set

to the highest value of number of

cores displays as all.

For example, if 6-core CPU is

installed, after setting to the

highest value, 6, when you read

the cpucore, it displays as all.

Example:

A:>syscfg --cpucore=1

cpucore=1

Dell PowerEdge

x9xx and later

systems

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

--cstates enable, disable This option enables or disables

the power c states of the processor.

A:>syscfg --cstates=

enable

cstates=enable

Dell PowerEdge

xx1x systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 37

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--datareuse enable, disable This option enables or disables

data reuse. Set to enable for High

Performance Computing (HPC)

applications. Set to disable for

energy efficiency. This option can

be replicated.

A:>syscfg --datareuse=

enable

datareuse=enable

Dell PowerEdge

xx1x systems

--dbpm enable, disable This option enables or disables

demand-based power

management. This option can be

replicated.

Example:

A:>syscfg --dbpm=enable

dbpm=enable

All Dell

PowerEdge

systems

dcustreamerprefetcher

enable, disable This option enables or disables

DCU Streamer Prefetcher.

This option can be replicated.

Example:

A:>syscfg --

dcustreamerprefetcher=

enable

dcustreamerprefetcher=

enable

Dell PowerEdge

xx1x systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

38 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--devseq numerical list,

separated by

commas

list of device

names,

separated by

commas

This option sets the hard-drive

sequence for a system. Without

an argument, this option displays

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.

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.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 39

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

numerical list,

separated by

commas

list of device

names,

separated by

commas

Example 1:

A:>syscfg --devseq

The following devices

are set in the disk

device sequence:

Device 1:* hdd.emb.0 -

System BIOS boot devices

Device 2:*

scsiraid.slot.3 - PERC

4/SC Adapter(bus 02 dev

02)

Device 3:*

usbkey.slot.0 - Hard-

disk-emulated USB flash

drive

Example 2:

A:>syscfg --devseq=

hdd.emb.1,scsiraid.emb.

The following devices

are set in the disk

device sequence:Device

1:* hdd.emb.0 - System

BIOS boot devices

Device 2:*

scsiraid.emb.1 - AIC-

7899, A:00 Seagate

NOTE: The asterisk indicates that

the device is enabled in the BIOS.

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

40 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embhypervisor off, on This option enables or disables

the embedded hypervisor port.

Example:

A:>syscfg --

embhypervisor=on

All Dell

PowerEdge

systems

--embideraid on, off This option enables or disables

the embedded IDE RAID

controller. This option is only

valid for supported systems that

have IDE ROMB. This option can

be replicated.

Example:

A:>syscfg --embideraid=

embideraid=on

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 41

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic1 on, off,

onnopxe,

onwithiscsi

This option turns the first

embedded NIC on with PXE on,

off, or on without PXE enabled.

This option is only valid for

supported systems that have 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

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

42 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic2 on, off,

onnopxe,

onwithiscsi

This option turns the second

embedded NIC on with PXE

enabled, off, or on without PXE

enabled. This option is only valid

for supported systems that have

two embedded NICs. If the

second NIC is enabled without

PXE, it is not found in the boot

order. If the second NIC is turned

on with PXE, it is placed at the

end of the boot order. The

onnopxe argument is not

supported on all systems. This

option can be replicated.

The onwithiscsi argument enables

the embedded NIC to boot from

the iSCSI server. The embnic2

option can be replicated.

Example:

A:>syscfg --embnic2=

onnopxe

embnic2=onnopxe

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 43

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic3 on, off,

onnopxe,

onwithiscsi

This option turns the third

embedded NIC on with PXE

enabled, off, or on without PXE

enabled. This option is only valid

for supported systems that have

three embedded NICs. If the

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

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

44 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic4 on, off,

onnopxe,

onwithiscsi

This option turns the fourth

embedded NIC on with PXE

enabled, off, or on without PXE

enabled. This option is only valid

for supported systems that have

four embedded NICs. If the

fourth NIC is enabled without

PXE, it is not found in the boot

order. If the fourth NIC is turned

on with PXE, it is placed at the

end of the boot order. The

onnopxe argument is not

supported on all systems. This

option can be replicated.

The onwithiscsi argument enables

the embedded NIC to boot from

the iSCSI server. The embnic4

option can be replicated.

Example:

A:>syscfg --embnic4=

onnopxe

embnic4=onnopxe

All Dell

PowerEdge

systems

--embnic1nic2 enable, disable This option enables or disables

the operating system interface of

the first and second embedded

NIC controllers.

Example:

A:>syscfg --

embnic1nic2=enable

--embnic1nic2=enable

Dell PowerEdge

1855, PowerEdge

6850, and

PowerEdge xx1x

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 45

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic3nic4 enable, disable This option enables or disables

the operating system interface of

the third and fourth embedded

NIC controllers.

Example:

A:>syscfg --

embnic3nic4=enable

--embnic3nic4=enable

Dell PowerEdge

xx1x systems

--embnics on, off This option enables or disables

both embedded NICs. This

option is only present on systems

that do not support the embnic1

and embnic2 options. This option

can be replicated.

Example:

A:>syscfg --embnics=on

embnics=on

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

46 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic1pxe enable, disable This option enables or disables

Preboot Execution Environmenet

(PXE) on the first embedded

NIC. If PXE is disabled, the first

NIC is not found in the boot

order. If PXE is enabled, the first

NIC is placed at the end of the

boot order. This option is only

present on systems that do not

support the embnic1 option. This

option can be replicated.

Example:

A:>syscfg --embnic1pxe=

enable

embnic1pxe=enable

All Dell

PowerEdge

systems

--embnic2pxe enable, disable This option enables or disables

PXE on the second embedded

NIC. If PXE is disabled, the

second NIC is not found in the

boot order. If PXE is enabled, the

second NIC is placed at the end of

the boot order. This option is only

present on systems that do not

support the embnic2 option. This

option can be replicated.

Example:

A:>syscfg --embnic2pxe=

disable

embnic2pxe=disable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 47

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embsataraid off, combined,

ata, raid, qdma

This option configures an

embedded SATA RAID controller.

This option can be replicated.

•

off

— disables the embedded

SATA RAID controller.

•

combined

— sets the SATA

RAID controller to combined

mode.

•

ata

— sets SATA RAID

controller to ATA mode.

•

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

All Dell

PowerEdge

systems

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

Example:

A:>syscfg --embscsi1=on

embscsi1=on

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

48 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Example:

A:>syscfg --embscsi2=on

embscsi2=on

All Dell

PowerEdge

systems

--embscsiraid raid, off, scsi This option enables or disables

the embedded SCSI RAID

controller. This option is only

valid for supported systems that

have SCSI ROMB. Some systems

do not support the scsi argument.

This option can be replicated.

CAUTION: If you change the

controller from SCSI to RAID mode,

data loss may occur. Backup any

data you must save before

changing modes.

Example:

A:>syscfg --

embscsiraid=raid

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 49

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embscsiraidchb raid, scsi This option sets the second

channel on an embedded RAID

controller to SCSI or RAID. This

option is only valid for systems

that support RAID/RAID and

RAID/SCSI settings for channels

A and B. This option can be

replicated.

Example:

A:>syscfg --

embscsiraidchb=raid

All Dell

PowerEdge

systems

embsdcardredundancy

mirrormode,

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.

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

Dell PowerEdge

R810, R815,

R910, and M910

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

50 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

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.

PowerEdge x9xx

and later systems

except modular

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 51

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embsdcard off, on This option enables or disables

the embedded SD card port.

Example:

A:>syscfg --embsdcard=

off

embsdcard=off

Dell PowerEdge

xx1x systems

--embvideoctrl enable, disable This option enables or disables

the embedded video controller.

Example:

A:>syscfg --

embvideoctrl=enable

Dell PowerEdge

xx1x systems

--fiberchannel enable, disable This option enables or disables

embedded fiber channel. This

option can be replicated.

Example:

A:>syscfg --

fiberchannel=enable

All Dell

PowerEdge

systems

--f1f2promptonerror enable, disable This option enables or disables

the BIOS to prompt F1 or F2 error

codes.

Example:

A:syscfg --

f1f2promptonerror=

enable

f1f2promptonerror=

enable

Dell PowerEdge

xx0x and later

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

52 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--floppy auto, off,

readonly

This option sets the diskette drive

controller to auto, off, or read-

only. This option is available on all

supported systems that have a

supported diskette drive.

This option can be replicated.

Example:

A:>syscfg --floppy=auto

floppy=auto

All Dell

PowerEdge

systems

--formfactor N/A This option displays the geometry

of modular Dell PowerEdge

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

Dell PowerEdge

modular systems

--fsbr 115200, 57600,

19200, 9600

This option sets the console

redirection fail safe baud rate in

bps.

Example:

A:>syscfg --fsbr=9600

fsbr=9600

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 53

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--hddfailover off, on This option specifies the device in

the Hard Disk Drive Sequence

menu that has not been

attempted in the boot

sequence.When set to on, all

devices are attempted in an order

in which they are configured.

When set to off, only the first

device in the hard disk sequence is

attempted. This option can be

replicated.

Example:

A:>syscfg --

hddfailover=on

All Dell

PowerEdge

systems

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

Example:

A:>syscfg --htassist=

enable

htassist=enable

Dell PowerEdge

systems running

on AMD

Opteron

processors

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

54 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--hwprefetcher enable, disable When set to enable, the processor

preempts what data might be

needed next. When some data is

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

All Dell

PowerEdge

systems

--idecdrom auto, off This option enables or disables

the CD drive. This option can be

replicated.

Example:

A:>syscfg --idecdrom=

auto

idecdrom=auto

All Dell

PowerEdge

systems

--idracgui enable, disable Enables and disables the iDRAC

GUI. This option can be

replicated.

Example:

A:>syscfg --idracgui=

disable

idracgui=disable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 55

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--integratedraid enable, disable This option enables or disables

the integrated RAID controller.

This option can be replicated.

Example:

A:>syscfg --

integratedraid=disable

All Dell

PowerEdge

systems

--integratedsas enable, disable This option enables or disables

the integrated SAS controller.

This option can be replicated.

Example:

A:>syscfg --

integratedsas=enable

All Dell

PowerEdge

systems

--internalusb off, on This option enables or disables all

the user-accessible USB ports.

This option can be replicated.

Example:

A:>syscfg --

internalusb=on

All Dell

PowerEdge

systems

--ioat enable, disable This option enables or disables

the I/O Acceleration Technology

(I/OAT) DMA Engine option.

This option must be enabled only

if the hardware and software

support I/OAT on your system.

This option can be replicated.

Example:

A:>syscfg --ioat=enable

ioat=enable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

56 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--lcd default, none,

user, idracipv4

address,

idracmac

address,

ossystemname,

servicetag,

ipv6address,

ambienttemp,

systemwatts

This option determines whether

to display the default string

(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

Dell PowerEdge

xx1x systems

--lcd1 <string> This option sets the first line of

user-defined text on the system

LCD. This option can be

replicated.

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.

All Dell

PowerEdge

systems

--lcd2 <string> This option sets the second line of

user-defined LCD strings.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 57

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Example:

A:>syscfg --logicproc=

enable

logicproc=enable

All Dell

PowerEdge

systems

--lpt lpt1, lpt2, lpt3,

disable

This option configures or reports

the I/O address of the LPT

(parallel) port. This option is

available on all supported systems

with an LPT port. This option is

recorded to an output file for

replication.

Example:

A:>syscfg --lpt=lpt1

lpt=lpt1

All Dell

PowerEdge

systems

--lptmode ps2, at This option configures or reports

the mode of an LPT (parallel)

port. This option is available on all

supported systems with an LPT

port. This option is recorded to an

output file for replication.

Example:

A:>syscfg --lptmode=ps2

lptmode=ps2

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

58 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--memintleave enable, disable This option enables or disables

the memory interleave mode.

This option can be replicated.

Example:

A:>syscfg --

memintleave=enable

All Dell

PowerEdge

systems

--memoperatingmode optimizer,

mirror,

advancedecc

This option selects the memory

operating mode. This feature is

active only if a valid memory

configuration is detected.

Example:

A:>syscfg --

memoperatingmode=

optimizer

memoperatingmode=

optimizer

Dell PowerEdge

xx1x systems

--memremap off, auto This option enables or disables

memory remapping.

A:>syscfg --memremap=

off

memintleave=off

All Dell

PowerEdge

systems

--memtest enable, disable This option enables or disables

the POST extended memory test.

Example:

A:>syscfg --memtest=

disable

memtest=disable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 59

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--mouse off, on This option turns the mouse

controller on or off. This option

can be replicated.

Example:

A:>syscfg --mouse=off

mouse=off

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

60 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--nextboot valid device

name (from the

--bootseq

option device

list)

This option sets the specified

device as the first device in the

boot order for the next boot cycle

only. The device must be a device

from the --bootseq option device

list. Run the --bootseq option to

see a list of available device

names.

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

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 61

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--noraidprompt*

The asterisk is not part of

the command syntax.

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.

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.

All Dell

PowerEdge

systems

Example:

A:>syscfg --

embscsiraid=raid

--noraidprompt

embscsiraid=raid

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

62 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--numlock on, off This option enables or disables

the keyboard number lock during

POST. This option is not

replicated.

Example:

A:>syscfg --numlock=on

numlock=on

All Dell

PowerEdge

systems

--oldsetuppwd <string> This option is required to set a

new setup password when a setup

password is currently set. The

setup password locks the BIOS

setup screen. The argument string

supplied to this option is the

current password. If this password

is not correct, the new setup

password is not applied to the

system. Generally, passwords are

limited to alphanumeric

characters and cannot exceed

32 characters in length. This

option is not replicated.

Example:

A:>syscfg --setuppwd=

asetuppassword --

oldsetuppwd=

currentpassword

The password has been

set. Please use a warm

reboot to apply the

password to the system.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 63

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--oldsyspwd <string> This option supplies the current

system password for the BIOS.

This option is only given when

setting the new system password.

If this password does not match

the current system password,

the new password is not applied to

the system. The system password

is required when booting the

system. The argument string

supplied to this option is the

password. Generally, passwords are

limited to alphanumeric

characters and cannot exceed

32 characters in length.

This option is not replicated.

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.

All Dell

PowerEdge

systems

Example 2:

A:>syscfg --syspwd=

asyspassword

--oldsyspwd=

currentpassword

The old password entered

is incorrect. The new

password will not be

set. Please try again.

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

64 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--opticaldrivectrl enable, disable This option enables or disables

the optical CD-ROM controller.

Example:

A:>syscfg --

opticaldrivectrl=enable

All Dell

PowerEdge

systems

--osmode enable, disable This option enables or disables

operating system installation

mode for installing operating

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

All Dell

PowerEdge

systems

--oswatchdogtimer enable, disable If your system stops responding,

the watchdog timer aids in the

recovery of your operating system.

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

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 65

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--ovrwrt*

The asterisk is not part of

the command syntax.

NA This option is only used with the -

o option to cause the output file

to be overwritten if a file of the

same name already exists. This

option cannot be replicated.

Example:

A:>syscfg -o=

filename.ini --ovrwrt

The file filename has

been overwritten.

All Dell

PowerEdge

systems

power For details about the power

sub-options and arguments, see

Table 3-5.

Dell PowerEdge

xx1x systems

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

Example:

A:>syscfg --

powerbutton=enable

NOTE: The system must be

rebooted for BIOS options to take

effect.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

66 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--qpibandwidthpriority compute, io This option sets the band width

priority to compute or I/O. Set to

compute for computation-

intensive applications. Set to I/O

for I/O-intensive applications.

This option can be replicated.

Example:

A:>syscfg --

qpibandwidthpriority=

compute

qpibandwidthpriority=

compute

Dell PowerEdge

xx1x systems

--redmem off, spare,

mirror, raid

This option allows selection of the

desired redundant memory mode,

or disables redundant memory.

This option can be replicated.

Example:

A:>syscfg --redmem=off

redmem=off

NOTE: The system must be

rebooted for BIOS options to take

effect.

All Dell

PowerEdge

systems except

xx1x

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 67

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--remflashmedia read-only This option displays the

redundancy status of internal dual

SD module. The status can be:

•Full

— Secure digital card (SD)

1 and 2 are functioning properly.

•Lost

— Either any of the secure

digital cards or both 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.

Dell PowerEdge

R810, R815,

R910, and M910

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

68 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Example:

A:>syscfg --rptkeyerr=

disable

rptkeyerr=disable

All Dell

PowerEdge

systems

--sata0 auto, off This option enables or disables

SATA port 0. This option can be

replicated.

Example:

A:>syscfg --sata0=auto

sata0=auto

NOTE: This option maps to --

sata_a for PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 69

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--sata1 auto, off This option enables or disables

SATA port 1. This option can be

replicated.

Example:

A:>syscfg --sata1=auto

sata1=auto

NOTE: This option maps to --

sata_b for Dell PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

--sata2 auto, off This option enables or disables

SATA port 2. This option can be

replicated.

Example:

A:>syscfg --sata2=auto

sata2=auto

NOTE: This option maps to --

sata_c for Dell PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

--sata3 auto, off This option enables or disables

SATA port 3. This option can be

replicated.

Example:

A:>syscfg --sata3=auto

sata3=auto

NOTE: This option maps to --

sata_d for Dell PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

70 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--sata4 auto, off This option enables or disables

SATA port 4. This option can be

replicated.

Example:

A:>syscfg --sata_4=auto

sata_4=auto

NOTE: This option maps to --

sata_e for Dell PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

--sata5 auto, off This option enables or disables

SATA port 5. This option can be

replicated.

Example:

A:>syscfg --sata_5=auto

sata_5=auto

NOTE: This option maps to --sata_f

for Dell PowerEdge x9xx systems.

All Dell

PowerEdge

systems

--sata6 auto, off This option enables or disables

SATA port 6. This option can be

replicated.

Example:

A:>syscfg --sata_6=auto

sata_6=auto

NOTE: This option maps to --

sata_g for Dell PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 71

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--sata7 auto, off This option enables or disables

SATA port 7. This option can be

replicated.

Example:

A:>syscfg --sata_7=auto

sata_7=auto

NOTE: This option maps to --

sata_h for Dell PowerEdge x9xx

systems.

All Dell

PowerEdge

systems

--snoopfilter enable, disable This option enables or disables

the snoop filter option from the

system BIOS.

Example:

A:>syscfg --

snoopfilter=enable

All Dell

PowerEdge

systems

--serial1 disable, com1,

com3,

com1_bmc,

bmcserial,

bmclan, rac

This option configures or reports

the first serial port

communication port. This option

can be replicated.

• bmcserial — maps serial port 1

to BMC Serial.

• bmclan — routes the serial

traffic destined for serial1 out to

NIC1.

• com1_bmc — maps serial port 1

to COM port 1 BMC.

• rac — maps serial port 1 to the

RAC device.

Example:

A:>syscfg --serial1=rac

serial1=rac

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

72 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--serial2 auto, disable,

com2, com4

This option configures or reports

the second serial port

communication port. This option

can be replicated.

Example:

A:>syscfg --serial2=

disable

serial2=disable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 73

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--serialcomm on, com1cr,

com2cr, off

This option sets the behavior of

the serial port communication.

When set to on, the BIOS enables

COM port 1 and COM port 2.

These ports are made available for

use by the operating system or

applications. BIOS Console

Redirection is disabled.

When set to com1cr, 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.

Dell PowerEdge

x9xx and later

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

74 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Example:

A:>syscfg --serialcomm=

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.

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

Dell PowerEdge

xx1x systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 75

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--setuppwd <string> This option sets the setup

password for the BIOS. The setup

password locks the BIOS F2

screen. The argument string

supplied to this option is the

password. Passwords are limited to

alphanumeric characters and

cannot exceed 32 characters in

length. If a current setup password

is set, it must be given through the

--oldsetuppwd option. This

option is not replicated.

Example 1:

A:>syscfg --setuppwd=

asetuppassword

The password has been

set. Please use a warm

reboot to apply the

password to the system.

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

76 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Example:

A:>syscfg --sma=disable

sma=disable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 77

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--slotname*

The asterisk is not part of

the command syntax.

NA This option reports the slot name

of the blade.

Example:

A:>syscfg --slotname

slotname=Slot5

Dell modular

systems

--sriov enable, disable This option enables or disables

support for SRIOV devices.

Example:

A:>syscfg --sriov=

disable

sriov=disable

All Dell

PowerEdge

xx1x systems

--svctag*

The asterisk is not part of

the command syntax.

NA This option reports the service tag

for a system. If used with the -s

general option, the environment

variable is set to the service tag.

Example:

A:>syscfg --svctag

svctag=113CD1S

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

78 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--syspwd <string> This option sets the system

password for the BIOS. The

system password is required when

booting the system. The argument

string supplied to this option is the

password. Generally, passwords are

limited to alphanumeric

characters and cannot exceed 32

characters in length. If a current

system password is set, it must be

given through the --oldsyspwd

option. This option is not

replicated.

Example 1:

A:>syscfg --syspwd=

password

The password has been

set. Please use a warm

reboot to apply the

password to the system.

All Dell

PowerEdge

systems

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.

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 79

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--sysrev NA This option reports the system

revision. This is a read-only

option.

All Dell

PowerEdge

systems

tpm For details about the tpm

sub-options and arguments,

see Table 3-3.

Dell PowerEdge

xx0x and later

systems

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

Example:

A:>syscfg --turbomode=

enable

--turbomode=enable

Dell PowerEdge

xx1x systems

running on Intel

processors

--usb on, legacy, off This option sets or reports the

status of the USB port. When set

to on, USB keyboards and mice

function only for systems with

operating systems that have native

USB support. When set to legacy,

USB keyboards and mice are

supported through the BIOS to

function in operating systems that

do not natively support USB.

This option can be replicated.

Example:

A:>syscfg --usb=on

usb=on

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

80 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Example:

A:>syscfg --usbflash=

auto

usbflash=auto

All Dell

PowerEdge

systems except

Dell PowerEdge

x9xx and later

--usbports enable,

enablebackonly,

disable

This option enables or disables

USB ports. When set to enable, it

enables all user accessible USB

ports. When set to

enablebackonly, the front user-

accessible ports are disabled.

When set to disable, both front

and back user accessible ports are

disabled.

This option can be replicated.

Example:

A:>syscfg --usbports=

enable

usbports=enable

All Dell

PowerEdge

systems

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

SYSCFG 81

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

When set to disable, it disables

the additional hardware

capabilities provided by

Virtualization Technology.

This option can be replicated.

Example:

A:>syscfg --

virtualization=enable

All Dell

PowerEdge

systems

--vflash enable, disable This option enables or disables

vflash on iDRAC.

Example:

A:>syscfg --vflash=

enable

vflash=enable

Dell PowerEdge

xx1x systems or

systems with

iDRAC 6

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

(continued)

Option Valid

Arguments

Description Applicable

Systems

82 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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 --tpmsecurity off Does not report the presence of TPM to

the operating system.

onwithpbm Directs the BIOS to store the TCG

compliant measurements to the TPM

during a POST operation.

onwithoutp

Directs the BIOS to bypass the pre-boot

measurements.

Example:

A:>syscfg tpm --tpmsecurity =

onwithoutpbm --

setuppwdoverride

--tpmactivation enabled Enables and activates the TPM feature.

disabled Disables and deactivates the TPM feature.

nochange Does not alter the operational state of the

TPM feature.

Example:

A:>syscfg tpm --

tpmactivation=enabled --

setuppwdoverride

NOTE: You cannot set tpmactivation when tpmsecurity is

set to off.

NOTE: After setting tpmactivation to enabled or disabled, if

you reboot your system, DTK displays the TPM

Configuration Honoured system will reset

and the system reboots again message and

reboots.

NOTE: When you set tpmactivation to enabled or disabled,

DTK displays the value of tpmactivation as nochange.

However, the TPM feature is activated/deactivated when

you reboot the system.

SYSCFG 83

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--tpmclear 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 <string> 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=

<setup_password>

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

Table 3-3. Sub-options and Arguments for the tpm Option

(continued)

Option Sub-option Arguments Description

84 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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 --tcmsecurity off Does not report the presence of TCM to

the operating system.

on Reports the presence of TCM to the

operating system.

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

SYSCFG 85

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

where

powerprofile can

maxperformance,

osctl, apc

Displays the settings similar to the BIOS

setup screen for the respective profile.

Reboot the system for the settings to take

effect.

If power profiles are not available on the

platform, an error message is displayed.

A:>syscfg power --profile=

maxperformance --

setuppwdoverride

custom Creates the custom profile. Reboot the

system for the settings to take effect.

A:>syscfg power --profile=

custom --setuppwdoverride

cpupowermode

min, max,

osdbpm,

systemdbpm

Allows you to set the CPU power and

performance management to minimum

power, maximum performance, operating

system DBPM, or system DBPM mode.

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

86 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

fanpowermode

min, max Allows you to set the fan algorithm to the

minimum power optimized or maximum

performance optimized mode.

A:>syscfg power --profile=

custom --fanpowermode=min --

setuppwdoverride

NOTE: Set the value of --profile to custom to change the values of

cpupowermode, memorypowermode, and fanpowermode.

--profile NA Displays the profile set and the respective

profile parameters.

--cap Displays the values of budgetcap, and the

maximum and minimum power

thresholds in Watts.

--cap

--unit <unit>

<budgetcap> is

the limit for

power

consumption in

Watts, or btuphr,

or percent.

<unit> is the

unit of the

value and can be

watt, or btuphr,

or percent.

The value of <budgetcap> 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 Power Cap (Watts) = [ Power supply

rating for input power (Watts) - Min

potential power (Watts) ] * Power Cap

(%) + Min potential power (Watts)]

A:>syscfg power --cap=<value>

--unit=watt --

setuppwdoverride

--maxpowercap Displays the value of the maximum power

threshold.

--minpowercap Displays the value of the minimum power

threshold.

Table 3-5. Sub-options and Arguments for the power Option

(continued)

Option Sub-option Arguments Description

SYSCFG 87

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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 <space>, <, >, |, 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 sub-

option. Options, sub-options, and arguments are case sensitive. All options,

sub-options, and pre-defined arguments are lowercase unless explicitly stated

otherwise.

--valsetuppwd <string> 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=

<setup_password>

setuppwdoverri

NA 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

Table 3-5. Sub-options and Arguments for the power Option

(continued)

Option Sub-option Arguments Description

88 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

options 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

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

Description Applicable

Systems

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

SYSCFG 89

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

majorfwrevisio

NA Reports the BMC

device major firmware

revision.

minorfwrevisio

NA Reports the BMC

device minor firmware

revision.

Example:

A:>syscfg

bmcversion

devid=32

devrevision=0

majorfwrevision=

minorfwrevision=

controlpanelacc

ess

NA viewandmodify

, viewonly,

disabled

This option sets or gets

the access level for the

Liquid Crystal Display

(LCD).

Example:

A:>syscfg --

controlpanelacce

ss=viewandmodify

controlpanelacce

ss=viewandmodify

Dell

PowerEdge

xx1x

systems

--clearsel*

The asterisk is not

part of the

command syntax.

NA NA Clears the SEL.

This option cannot be

replicated.

Example:

A:>syscfg --

clearsel

Clearing SEL...

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

90 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--deviceguid*

The asterisk is not

part of the

command syntax.

NA NA Displays the GUID for

the BMC. This option

cannot be replicated.

Example:

A:>syscfg --

deviceguid

deviceguid=

XXXXXXXXXX

All Dell

PowerEdge

systems

--encryptkey NA <hexadecimal

number>

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.

The value returned is

appended with zeroes

so that it is always 40

characters long.

Example:

A:>syscfg --

encryptkey=abcd

encryptkey=

ABCD000000000000

0000000000000000

00000000

All Dell

PowerEdge

systems

--identify NA 0–254

NOTE: Use 0 to

stop flashing

the LED.

Flashes the

identification LED for

a specified number of

seconds.

Dell

PowerEdge

systems

with a

BMC.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 91

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

kvmstatusonlcd

active, inactive This option configures

the Dell Virtual KVM

(vKVM) session status

on the LCD.

Example:

A:>syscfg --

kvmstatusonlcd=

active

kvmstatusonlcd=

active

Dell

PowerEdge

xx1x

systems

lanchannelacce

lca

Sets or displays the

LAN channel access

settings such as

alerting, IPMI over

LAN, and user

privilege. This option

can be replicated.

All Dell

PowerEdge

systems

--pefalerting enable, disable Enables or disables PEF

alerts. This sub-option

can be replicated.

--ipmioverlan disable,

alwaysavail

Sets the LAN channel

access mode. This sub-

option can be

replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

92 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

channelprivlmt

user, operator,

administrator

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

lci

Displays media and

protocol information

about the LAN

channel. This option

cannot be replicated.

All Dell

PowerEdge

systems

lancfgparams

lcp

Configures and displays

LAN configuration

parameters. This option

can be replicated.

All Dell

PowerEdge

systems

--ipaddrsrc static, dhcp Sets the IP address

source for the LAN

channel. This sub-

option can be

replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 93

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--ipaddress <ipaddress> Sets the IP address for

the LAN channel.

This sub-option cannot

be replicated.

--subnetmask <subnetmask

Sets the subnet mask

for the LAN channel.

This sub-option can be

replicated.

--gateway <gateway> Sets the gateway for the

LAN channel. This sub-

option can be

replicated.

--commstring <string> Sets the community

string (maximum of

16 printable ASCII

characters) used in a

platform event trap

(PET). This sub-option

can be replicated.

--destipaddr <ipaddress> Sets the destination

IP address for the alert

destination specified

with the alertdest sub-

option. The destipaddr

sub-option is

dependent on the

alertdest sub-option.

If the alertdest sub-

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

94 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

NOTE: The

sharedrece

iveonall

argument

is available

only on

xx1x

systems.

--fullduplex enable, disable Enables or disables full

duplex on the RAC

network interface.

--autoneg enable, disable Enables or disables

autonegotiation.

--speed 10,100 Sets the network

interface speed to 10 or

100 Mbps.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 95

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--dnsdhcp enable, disable Enables or disables

obtaining the DNS

server IP address

through DHCP.

--dnsserver1 <ipaddress> Sets the IP address of

the primary DNS server

for domain name

resolution.

--dnsserver2 <ipaddress> 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 <string> Sets the name of the

RAC.

domainnamefro

mdhcp

enable, disable Enables or disables

getting the RAC

domain name through

DHCP.

--domainname <string> Sets the domain name

of the RAC.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

96 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Example 1 (to display

the current LAN

configuration settings):

A:>syscfg --

lancfgparams

destipaddr=

192.168.100.15

vlantag=enable

vlanid=1000

vlanpriority=7

macaddress=

0:6:5b:fb:c8:a7

commstring=

public

ipaddrsrc=static

ipaddress=

192.168.100.10

subnetmask=

255.255.255.0

gateway=

192.168.100.1

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 97

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

98 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

lanuseraccess

lua

Configures the privilege

level and channel

accessibility associated

with a specified User

ID for the LAN

channel.

All Dell

PowerEdge

systems

--userid 2–10, if your

system has a

DRAC 4

controller

2–16, if your

system has a

DRAC 5

controller

Sets the User ID. This

sub-option can be

replicated.

--usrprivlmt user, operator,

administrator,

noaccess

Sets the maximum

BMC user privilege

level for the LAN

channel for the userid

specified using the

userid sub-option. This

sub-option can be

replicated. This sub-

option is dependent on

the userid sub-option.

currentenabled

userids

NA Reports the number of

currently enabled User

IDs on the LAN

channel.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 99

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

useridswithfixe

dnames

NA 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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

100 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--loaddefaults*

The asterisk is not

part of the

command syntax.

NA NA Restores the BMC to

the defaults originally

loaded on the

controller. This option

is used to return the

BMC to a known-good

state. This option

cannot be replicated.

NOTE: The NMI, power

button, and SOL defaults

are not reset by using

this option.

Example:

A:>syscfg --

loaddefaults

defaults...

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 101

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--nextboot NA valid

device

name (from

the

--bootseq

option

device

list)

This option sets the

specified device as the

first device in the boot

order for the next boot

cycle only. The device

must be a device from

the

--bootseq option device

list. Run the --bootseq

option to see a list of

available device names.

See --bootseq for more

information. This

option is not replicated.

Example 1:

A:>syscfg --

bootseq

Device 1:

floppy.emb.0 -

Diskette Drive

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

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

102 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

This option can be

replicated.

Example:

A:>syscfg --

nmibutton=enable

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 103

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

passwordaction Configures and tests

the password for the

specified User ID. This

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.

All Dell

PowerEdge

systems

--userid 2–10 if your

system has a

DRAC 4

controller

2–16 if your

system has a

DRAC 5

controller

Specifies the BMC User

ID. This sub-option

cannot be replicated.

--action setpassword,

testpassword

Sets or tests the

password for the

specified User ID. This

sub-option cannot be

replicated.

--password <string> 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):

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

104 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

pcp

Configures and displays

PEF configuration

parameters. This option

can be replicated.

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 105

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--filter fanfail, voltfail,

discretevoltfail,

tempwarn,

tempfail,

intrusion,

redundegraded,

redunlost,

procwarn,

procfail,

powerwarn,

powerfail,

hardwarelogfail,

autorecovery,

batterywarn,

batteryfail,

powerabsent,

procabsent,

systempower-

warn,

systempower-

fail

Specifies a PEF value.

This sub-option can

be replicated.

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.

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

106 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--hostname <string> Sets the host name

(maximum of 62

printable ASCII

characters) for the

BMC. This sub-option

can be replicated.

The --hostname string

must comprise only

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.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 107

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--alertpolstatus enable, disable Enables or disables the

alert policy specified

using the alertpolnum

sub-option. This sub-

option can be

replicated. This sub-

option is dependent on

the alertpolnum sub-

option.

Example (to set the

PEF configuration

parameters):

Example 1 (To

configure the PEF so

that the system is

powered down in

response to a fan failure

event):

A:>syscfg

pefcfgparams

--filter=fanfail

--filteraction=

powerdown

pefcfgparams

filter=fanfail

filteraction=

powerdown

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

108 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

disables the power

button. This option can

be replicated.

Example:

A:>syscfg --

powerbutton=

enable

powerbutton=

enable

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 109

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--powerctl NA powerdown

</argument>

This option performs a

chassis powerdown and

controls the reset of the

system.

Powerdown shuts off

the system.

All Dell

PowerEdge

systems

powercycle

</argument>

Powercycle shuts off

the system and

automatically turns on

your system after a few

seconds.

reset

</argument>

Resets the system.

softshutdown

</argument>

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

110 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--serialchannel-

access

sca

Sets or displays the

channel access settings

for the serial channel.

This option can be

replicated.

All Dell

PowerEdge

systems

ipmioverserial

disable,

alwaysavail

Sets the serial channel

access mode. This sub-

option can be

replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 111

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

channelprivlmt

user, operator,

administrator

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

112 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

serialchannelinfo

sci

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

option cannot be

replicated.

--prottype NA Displays the protocol

type for the serial

channel. This sub-

option cannot be

replicated.

--ssnsupport NA Displays the session

support information for

the serial channel. This

sub-option cannot be

replicated.

activessncount

NA Displays the number of

sessions that are

activated on the serial

channel. This sub-

option cannot be

replicated.

Example:

A:>syscfg

serialchannelinf

--mediumtype

mediumtype=

asynch

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 113

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

serialcfgparams

scp

Configures and displays

serial configuration

parameters. This option

can be replicated.

All Dell

PowerEdge

systems

connectionmo

basic, terminal Sets the connection

mode used to perform

IPMI messaging to the

BMC. This sub-option

can be replicated.

msgcommflow

ctrl

noflowctrl,

rtscts

Sets the IPMI message

communication flow

control. This sub-

option can be

replicated.

msgcommdtrh

angup

NA Reports the IPMI

message

communication DTR

hang-up. This sub-

option cannot be

replicated.

msgcommbitra

9600, 19200,

57600, 115200

Sets the IPMI message

communication baud

rate in bits per second

(bps). This sub-option

can be replicated.

tmcfglineediti

enable, disable Sets the line editing

value for terminal mode

configuration. This

sub-option can be

replicated.

--tmcfgdelctrl del, bksp Sets the delete control

value for terminal mode

configuration. This

sub-option can be

replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

114 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

tmcfgechoctrl

echo, noecho Sets the echo control

value for terminal mode

configuration. This

sub-option can be

replicated.

tmcfghandshak

ectrl

enable, disable Sets the handshake

control value for

terminal mode

configuration. This

sub-option can

be replicated.

tmcfgnewlines

noterm, crlf,

null, cr, lfcr,1f

Sets the new line

sequence value for

terminal mode

configuration. This

sub-option can be

replicated.

tmcfginputnew

lineseq

cr, null Sets the input new line

sequence value for

terminal mode

configuration. This

sub-option can

be replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 115

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Example (to display the

current serial

configuration settings):

A:> syscfg

serialcfgparams

tmcfgdelctrl=del

tmcfgechoctrl=

echo

tmcfghandshakect

rl=enable

connectionmode=

terminal

tmcfgnewlineseq=

crlf

msgcommflowctrl=

rtscts

tmcfginputnewlin

eseq=cr

msgcommdtrhangup

=disable

msgcommbitrate=

19200

tmcfglineediting

=enable

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

116 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

serialuseraccess

sua

Configures the privilege

level and channel

accessibility associated

with a specified User

ID for the serial

channel. This option

can be replicated.

All Dell

PowerEdge

systems

--userid 2–10 if your

system has a

DRAC 4

controller

2–16 if your

system has a

DRAC 5

controller

Sets the User ID. This

sub-option can be

replicated.

--usrprivlmt user, operator,

administrator,

noaccess

Sets the maximum

BMC user privilege

level for the serial

channel for the User ID

specified using the

userid sub-option. This

sub-option can be

replicated. This sub-

option is dependent on

the userid sub-option.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 117

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

currentenabled

userids

NA Reports the number of

currently enabled User

IDs on the serial

channel. This sub-

option can

be replicated.

useridswithfixe

dnames

NA Reports the number of

User IDs with fixed

names on the serial

channel. This sub-

option can be

replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

118 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 119

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

solaction This option enables or

disables Serial-Over-

LAN (SOL) access for a

particular user.

This option can be

replicated.

A:>syscfg

solaction --

userid=2 --

action=disable

solaction

userid=2 action=

disable

All Dell

PowerEdge

systems

--userid 2–10 if your

system has a

DRAC 4

controller

2–16 if your

system has a

DRAC 5

controller

Specifies the BMC user

ID. This sub-option can

be replicated.

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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

120 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

solcfgparams Configures and displays

SOL configuration

parameters. This option

can be replicated.

All Dell

PowerEdge

systems

--solenable enable, disable Enables or disables

whether the SOL

payload type can be

activated. This option

can be replicated.

--solprivlevel user, operator,

administrator

Sets the minimum user

privilege level required

to activate the SOL.

This option can be

replicated.

solcharaccumi

nterval

1–255 Sets the Character

Accumulate Interval in

5-ms increments

(1–255). This sets the

typical amount of time

that the BMC waits

before transmitting a

partial SOL character

data packet. This

option can be

replicated.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 121

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

solcharsendthr

eshold

1–255 Specifies that the BMC

automatically sends an

SOL character data

packet containing this

number of characters in

increments of 5 (1–255)

as soon as this number

of characters (or

greater) has been

accepted from the

baseboard serial

controller into the

BMC. This option can

be replicated.

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.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

122 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--solbitrate 9600, 19200,

57600, 115200

Sets the serial channel

communication bit rate

(in bps) with the BMC

when SOL is activated.

This option can be

replicated.

NOTE: The arguments

for --solbitrate vary with

various Dell systems. If

an argument valid for a

particular Dell system is

entered for another

system, the

‘Parameter out of

range’ error is

displayed.

Valid arguments are:

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.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 123

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Example 1 (to display

the current SOL

configuration):

A:> syscfg

solcfgparams

solenable=enable

solprivlevel=

administrator

solcharaccuminte

rval=25

solcharsendthres

hold=25

solbitrate=9600

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

124 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

solcfgparams Example 2 (to set the

SOL configuration

parameters):

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

All Dell

PowerEdge

systems

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 125

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

ssninfo Displays information

about the number of

possible active sessions

and the number of

currently active sessions

on all channels on the

BMC. This option

cannot be replicated.

All Dell

PowerEdge

systems

maxactivessns

NA Displays the maximum

possible active BMC

sessions. This sub-

option cannot be

replicated.

currentactivess

NA 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=

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

126 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

useraction Enables and disables

BMC, sua, and lua user

IDs. This option can be

replicated.

All Dell

PowerEdge

systems

--userid 2–10 if your

system has a

DRAC 4

controller

2–16 if your

system has a

DRAC 5

controller

Specifies the BMC user

ID. This sub-option can

be replicated.

--action enable, disable Enables or disables the

user ID specified using

the userid sub-option.

This sub-option can be

replicated. This sub-

option 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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 127

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

username Sets the BMC User ID

and username. This

option can be

replicated.

All Dell

PowerEdge

systems

--userid 2–10 if your

system has a

DRAC 4

controller

2–16 if your

system has a

DRAC 5

controller

Specifies the User ID.

This sub-option can

be replicated.

--name <string> 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 sub-

option 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

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

128 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Example 2 (to display

the username for User

ID 3):

A:>syscfg

username --

userid=3 --name

username

userid=3

name=bmcmaster

--version*

The asterisk is not

part of the

command syntax.

NA NA Displays the version

information for the

SYSCFG utility.

Table 3-6. BMC and Remote Access Controller Configuration Options

(continued)

Option Sub-option Valid

Arguments

Description Applicable

Systems

SYSCFG 129

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Option Valid

Arguments

Description

-b

--byte

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

-r

--read*

The asterisk

is not part of

the

command

syntax.

NA This option reads the value of state data. When used with

the -x option, the value is reported in hexadecimal format

(0xNN).

Example:

A:>sysfg -r -x

The state byte has been set to 0x02.

A:>syscfg -r

The state byte has been set to 2.

-x

--hex

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.

130 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

--biosver*

The asterisk is

not part of the

command

syntax.

None 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

SYSCFG 131

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--chassvctag*

The asterisk is

not part of the

command

syntax.

None This option reports the chassis service tag for modular

systems.

Example:

A:>syscfg --chassvctag

chassvctag=SVCTAG1

--cpucount*

The asterisk is

not part of the

command

syntax.

None 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

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

(continued)

Option Valid

Arguments

Description

132 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--envfile <filename> 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

--mem*

The asterisk is

not part of the

command

syntax.

None 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

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

(continued)

Option Valid

Arguments

Description

SYSCFG 133

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-n <filename> 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: 8086 - Intel Corp.

Device: 1229 - 82557/8/9 [Ethernet

Pro 100]

Sub Vendor:8086 - Intel Corp.

Sub Device:1017 - EtherExpress

PRO/100+ Dual Port Server Adapter

Slot: 01

Class: 02 - Network

SubClass: 00 - Ethernet

--ovrwrt*

The asterisk is

not part of the

command

syntax.

None 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

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

(continued)

Option Valid

Arguments

Description

134 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--pci*

The asterisk is

not part of the

command

syntax.

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.

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

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

(continued)

Option Valid

Arguments

Description

SYSCFG 135

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

None Example 2 (the pci.ids file is located in the same

directory as the utility so that names resolve):

A:>syscfg --pci

PCI Bus: 0, Device: 0, Function: 0

Vendor: 1166 - ServerWorks

Device: 0012 - CMIC-LE

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

PCI Bus: 0, Device: 0, Function: 1

Vendor: 1166 - ServerWorks

Device: 0012 - CMIC-LE

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

PCI Bus: 0, Device: 0, Function: 2

Vendor: 1166 - ServerWorks

Device: 0000 - Unknown

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

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

(continued)

Option Valid

Arguments

Description

136 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

None Example 3 (a pci.ids file does not exist):

A:>syscfg --pci

PCI Bus: 0, Device: 0, Function: 0

Vendor: 1166 - Unknown

Device: 0012 - Unknown

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

PCI Bus: 0, Device: 0, Function: 1

Vendor: 1166 - Unknown

Device: 0012 - Unknown

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

PCI Bus: 0, Device: 0, Function: 2

Vendor: 1166 - Unknown

Device: 0000 - Unknown

Slot: 00

Class: 06 - Bridge

SubClass: 00 - CPU/PCI

-s <string> 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

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

(continued)

Option Valid

Arguments

Description

SYSCFG 137

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--slot*

The asterisk is

not part of the

command

syntax.

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.

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*

The asterisk is

not part of the

command

syntax.

None 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

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

(continued)

Option Valid

Arguments

Description

138 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--sysid*

The asterisk is

not part of the

command

syntax.

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.

Example:

A:>syscfg --sysid

sysid=0x00df

--sysname*

The asterisk is

not part of the

command

syntax.

None 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

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

(continued)

Option Valid

Arguments

Description

SYSCFG 139

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--syssvctag*

The asterisk is

not part of the

command

syntax.

None This option reports the system service tag for a modular

system.

Example:

A:>syscfg --syssvctag

syssvctag=BLADE01

--uuid*

The asterisk is

not part of the

command

syntax.

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

B1C04F423131

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

(continued)

Option Valid

Arguments

Description

140 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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 Valid

Argument

Description

lancfgparamsv6

or lcpv6

--ipv6 enable,

disable

Loads or unloads the IPv6 stack.

A:> syscfg lcpv6 --ipv6=

enable

--ipsrcv6=static

--ipaddrv6=

<ipv6address> --

prefixlengthv6=

prefixlengthv6>

--gatewayv6=<

ipv6gatewayaddre

ss>

NA Allows you to manually configure

IPv6 addresses.

A:>syscfg lcpv6 --

ipsrcv6=static --

ipaddrv6=

1234:1234:1234::1234 --

prefixlengthv6=32 --

gatewayv6=

1234:1234:1234::1

--ipsrcv6=auto NA Automatically configures the IPv6

addresses.

A:> syscfg lcpv6 --

ipsrcv6=auto

--dnssrcv6 =auto NA Automatically configures the DNS

address.

A:> syscfg lcpv6 --

dnssrcv6=auto

--dnssrcv6=static

--dnsserver1v6=

<ipv6dnsserver1a

ddress>

NA Allows you to manually set the

DNS address.

SYSCFG 141

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

linklocaladdripv6

<linklocaladdripv

Allows you to view IPv6 addresses.

A:> syscfg lcpv6 --

linklocaladdripv6=

134.56.45.233

--gatewayv6=

Allows you to view IP gatewayv6

address.

Table 3-9. SYSCFG Options and Arguments for IPv6 Configuration

Option Sub-option Valid

Argument

Description

142 SYSCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Template Last Updated - 2/7/2007 RAIDCFG 143

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

144 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

RAIDCFG 145

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Table 4-1. RAIDCFG Short and Long Format Options

Option Valid Arguments Short Description Mandatory or

Optional

No option

-h

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-2 for

specific usage

information.

-ac

action

cvd

createvdisk

Creates a virtual disk.

NOTE: When providing

multiple physical disks for

the createvdisk command, do

not separate the disks with

spaces. For example, -ad=

1:4, 1:5 causes an error.

The correct syntax for

displaying multiple physical

disks is -ad=

1:4,1:5,1:6.

See Table 4-4 for

specific usage

information.

-ac

action

dvd

deletevdisk

Deletes a virtual disk. See Table 4-9 for

specific usage

information.

-ac

action

rghs

removeglobalhots

pare

Unassigns all global hot

spares to disks on the

specified controller.

Optional.

See Table 4-10 for

specific usage

information.

-ac

action

sghs

setglobalhotspare

Assigns the specified disks

as global hot spares on the

specified controller.

Optional.

See Table 4-10 for

specific usage

information.

-ad

adisk

NA Specifies an array disk

command.

See Table 4-5 for

specific usage

information.

146 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ad

adisk

ch:targ, ch:targ, ...

or ch:targ:lun,...

or ch:targ:enc

channel:target, or

channel:target:lun

, or

channel:target:en

closure

Specifies an array disk.

For SCSI controllers, the

value of LUN should always

be 0.

For SAS controllers, the

value of enclosure can be

non-zero, in which case you

must specify values for

channel, target, and

enclosure.

NOTE: You can also use

pdisk or -pd instead of adisk

or -ad to specify an array

disk.

Optional.

See Table 4-5 for

specific usage

information.

-c

controllerid

<valid controller

ID number>

Specifies a RAID controller. See Table 4-3 for

specific usage

information.

-cp

cachepolicy

d, c or d, e Specifies the cache policy

for reads on a specified

virtual disk or disk cache

policy.

Optional.

See Table 4-4 for

specific usage

information.

-ctrl

controller

NA Displays a list of the

supported RAID controllers

in the system, along with

select property information.

Mandatory, must

be typed in the

correct order.

See Table 4-3 for

specific usage

information.

-envc

envcommand

<string> Sets a user-defined

environmental variable

(<string>) to the value

returned from a function

call.

See Table 4-12 for

specific usage

information.

Table 4-1. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

RAIDCFG 147

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-envn

envname

<string> Sets the environment

variable (<string>) that

equates to the value

returned from a function

call.

See Table 4-12 for

specific usage

information.

-fd

failoverdrive

ch:targ, ch:targ, ...

or ch:targ:lun,...

or ch:targ:enc

channel:target, or

channel:target:lun

, or

channel:target:en

closure

Specifies the location of the

failover drive in an array.

For SCSI controllers, the

value of LUN should

always be 0.

For SAS controllers, the

value of enclosure can be

non-zero, in which case you

must specify values for

channel, target, and

enclosure.

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.

Optional.

See Table 4-4 for

specific usage

information.

-i <filename> 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.

-l

logfile

<filename> Logs command line output

to a file.

Optional.

See Table 4-15 for

specific usage

information.

Table 4-1. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

148 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-o <filename> 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.

-r

raid

<valid RAID level

number>

Sets the RAID level for the

array.

Valid RAID values are 0, 1,

5, 10, 50.

If no value is specified for

RAID, 0 is taken as the

default level.

Optional.

See Table 4-4 for

specific usage

information.

-rp

readpolicy

ra, ara, nra, rc, nrc Sets the read policy for the

virtual disk.

Optional.

See Table 4-4 for

specific usage

information.

-se

setenvironment

NA Sets a user-defined

environment variable to the

value returned from the

function call. The function

calls are:

getcontrollerslot

s, getfirmware,

getcontrollertype,

getadisks,

getadiskcount,

getfreeadisks,

getfreeadiskcount,

getfreeadisksize,

gethotspares.

Mandatory.

See Table 4-12 for

specific usage

information.

-si

silent

NA Does not display any

information on the

terminal console.

Optional.

See Table 4-15 for

specific usage

information.

Table 4-1. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

RAIDCFG 149

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-sz

size

<number> Sets the maximum size on

the virtual disk in MB or GB

if the size is not provided.

The default size is in MB. If

GB follows the number, the

size is expressed in GB.

Optional.

See Table 4-4 for

specific usage

information.

-sp

spanlength

<number> The span size of RAID 5,

which is a mandatory

parameter for RAID 50.

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.

Mandatory.

See Table 4-4 for

specific usage

information.

-ssz

stripesize

<number> Sets the stripe size on the

virtual disk in KB.

NOTE: When creating virtual

disks, do not specify the units

for chunk (stripe) size. The

units are always listed in KB.

Optional.

See Table 4-4 for

specific usage

information.

-vd

vdisk

NA Displays the virtual disks

under all of the controllers

along with the physical array

disks that make up the

virtual disks.

See Table 4-6 for

specific usage

information.

Table 4-1. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

150 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-vd

vdisk

<valid virtual disk

ID number>

Displays the specified

virtual disk.

Optional.

See Table 4-6 for

specific usage

information.

-ver

version

NA Displays the version

number of the utility.

Optional.

See Table 4-15 for

specific usage

information.

-wp

writepolicy

wb, wt, wc, nwc,

fwb

Sets the write policy for a

virtual disk. The valid

arguments are: wb (write-

back caching),

wt (write-through caching),

wc (write-caching), nwc

(no-write-caching), and fwb

(force-write-back).

Optional.

See Table 4-15 for

specific usage

information.

Table 4-1. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

RAIDCFG 151

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

152 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

General Help

Table 4-2 lists the RAIDCFG general help options.

Table 4-2. General Help

Options Parame

ters

Valid

Arguments

Description

option

-h

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

Example:

A:>raidcfg -h

RAIDCFG v3.3

[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 <controller>

raidcfg <-ctrl>

Lists all controllers on the host and

selects property information.

—output continues, listing all possible

option/parameter/argument combinations—

RAIDCFG 153

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Options and

Arguments

Optional

Paramet

ers

Valid

Parameters

Arguments

Description

-ctrl

controller

NA 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!

154 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-c

controlle

rid

<valid

controller

number>

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!

Table 4-3. Enumerating RAID Controllers

(continued)

Mandatory

Options and

Arguments

Optional

Paramet

ers

Valid

Parameters

Arguments

Description

RAIDCFG 155

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Parameters

Valid Parameter

Arguments

Description

-ctrl -ac=cvd

-c=id -ad=

ch:targ,ch:targ

,...

[or

ch:targ:encl,...]

controller

action=

createvdisk

controllerid=

id adisk=

channel:target

:lun,...

channel:target

:lun,...

[or

channel:target

enclosure,...]

NA 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!

156 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-cp

cachepolicy

d, c

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.

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 157

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-fd

failoverdrive

ch:targ, ch:targ,

...

or ch:targ:lun,...

or ch:targ:enc

channel:target,

channel:target:l

un, or

channel:target:

enclosure

Sets the failover drive for the virtual

disk. The -fd option is optional and can

be added to the command line in any

order after the mandatory option

combination.

NOTE: From DTK 2.4 onwards, the -fd

option creates dedicated hot spares

instead of global hot spares. For

information about setting global hot

spares, see Table 4-10.

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.

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

158 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-r

-raid

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

Sets the RAID type or level for the

virtual disk.

NOTE: If this option is not specified for

any RAID controller, RAID 0 is taken as

the default.

The valid arguments are:

• 0 — RAID 0 uses data striping,

which is writing data in equal-sized

segments across the array disks.

RAID 0 does not provide data

redundancy.

• 1 — RAID 1 is the simplest form of

maintaining redundant data. In

RAID 1, data is mirrored or

duplicated on one or more drives.

• 5 — RAID 5 provides data

redundancy by using data striping in

combination with parity information.

Rather than dedicating a drive to

parity, the parity information is

striped across all disks in the array.

• 6 — RAID 6 is an extension of RAID

5 and uses an additional parity block.

It uses block-level striping with two

parity blocks distributed across all

member disks. RAID 6 provides

protection against double disk

failures and failures while a single

disk is rebuilding. In case there is

only one array, RAID 6 may be a

better option than a hotspare disk.

• 10 — RAID 10 is a stripe of mirrors.

Multiple RAID 1 mirrors are created,

and a RAID 0 stripe is created

over these.

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 159

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

160 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ctrl -ac=cvd

-c=id -ad=

ch:targ,ch:targ

,...

[or

ch:targ:encl,...]

controller

action=

createvdisk

controllerid=

id adisk=

channel:target

:lun,

channel:target

:lun,...

[or

channel:target

enclosure,...]

-rp

readpolicy

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

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 161

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

162 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ctrl -ac=cvd

-c=id -ad=

ch:targ,ch:targ

,...

[or

ch:targ:encl,...]

controller

action=

createvdisk

controllerid=

id adisk=

channel:target

:lun,...

channel:target

:lun,...

[or

channel:target

enclosure,...]

-sp

spanlength

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 163

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ctrl -ac=cvd

-c=id -ad=

ch:targ,ch:targ

,...

[or

ch:targ:encl,...]

controller

action=

createvdisk

controllerid=

id adisk=

channel:target

:lun,

channel:target

:lun,...

[or

channel:target

enclosure,...]

-ssz

stripesize

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

164 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ctrl -ac=cvd

-c=id -ad=

ch:targ,ch:targ

,...

[or

ch:targ:encl,...]

controller

action=

createvdisk

controllerid=

id adisk=

channel:target

:lun,

channel:target

:lun,...

[or

channel:target

enclosure,...]

-str

strict

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 165

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ctrl -ac=cvd

-c=id -ad=

ch:targ,ch:targ

,...

[or

ch:targ:encl,...]

controller

action=

createvdisk

controllerid=

id adisk=

channel:target

:lun,...

channel:target

:lun,...

[or

channel:target

enclosure,...]

-sz

-size

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

166 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 167

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-wp

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.

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

168 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Enumerating Array Disks

Table 4-5 lists the RAIDCFG options, parameters, and pre-defined

arguments for enumerating array disks (hard drives).

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

Table 4-4. Creating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

RAIDCFG 169

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Table 4-5. Enumerating Array Disks (Hard Drives)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

-ad -c=id

adisk

controllerid=

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

170 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

****** 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)

Table 4-5. Enumerating Array Disks (Hard Drives)

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

RAIDCFG 171

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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!

Table 4-5. Enumerating Array Disks (Hard Drives)

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

172 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ad -c=id

adisk

controllerid=

-vd=id

vdisk=id

<valid

virtual

disk>

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!

Table 4-5. Enumerating Array Disks (Hard Drives)

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

RAIDCFG 173

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ad -c=id

adisk

controllerid=

id vdisk=id

-ad=

ch:targ,ch:t

arg,...

adisk=

channel:tar

get,

channel:tar

get,...

<valid

array disk>

<valid

array disk>

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!

Table 4-5. Enumerating Array Disks (Hard Drives)

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

174 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Parameter

Valid

Parameter

Arguments

Description

-vd

vdisk

NA NA Lists the virtual disks for each controller

along with the array disks that make up each

virtual disk. This option is mandatory.

Example:

A:>raidcfg -vd

Controller: PERC 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!

RAIDCFG 175

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-vd

vdisk

-c

controller

<valid

controller ID

number>

Lists all the virtual disks under the

indicated controllers. Each virtual disk is

displayed with the physical disk that

comprises it. The -c option is optional and

can be added to the command line in any

order after the mandatory option.

Example:

A:>raidcfg -vd -c=2

Controller: PERC 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!

Table 4-6. Enumerating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

176 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-vd -c=id

vdisk

controllerid=

-vd

vdisk

<valid

virtual disk

number>

Displays details about a single virtual disk

under the indicated controller. The -vd -c=

id option combination is mandatory. The

second -vd option is optional and can be

added to the command line in any order

after the mandatory option combination.

Example:

A:>raidcfg -vd -c=2 -vd=0

Controller: PERC 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!

Table 4-6. Enumerating Virtual Disks

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

RAIDCFG 177

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Parameters

Valid

Parameter

Arguments

Description

-vd -c=id -

vd=id -ac=fi

vdisk

controllerid=

id vdisk=id

action=

fastinit

NA <valid virtual

disk ID

number>

This option initializes the selected virtual disk

in the selected controller with the fastinit

command. This feature is supported on PERC

5 and later controllers and is not supported on

SAS controllers.

Using the fastinit command on

unsupported controllers returns an error.

Example:

A:>raidcfg -vd -c=2 -vd=2 -ac=

-vd -c=id -

vd=id -ac=

sli

vdisk

controllerid=

id vdisk=id

action=

slowinit

NA <valid virtual

disk ID

number>

This option initializes the selected virtual disk

in the selected controller with the slowinit

command. This feature is supported on PERC

5 and later controllers and is not supported on

SAS controllers. Using the slowinit command

on unsupported controllers returns an error.

Example:

A:>raidcfg -vd -c=2 -vd=2 -ac=

sli

-vd -c=id -

vd=id -ac=

sli

vdisk

controllerid=

id vdisk=id

action=

cancelinit

NA <valid virtual

disk ID

number>

This option cancels the initialization of the

virtual disk with the cancelinit command.

This feature is supported on PERC 5 and later

controllers and is not supported on SAS

controllers. Using the cancelinit command on

unsupported controllers returns an error.

Example:

A:>raidcfg -vd -c=2 -vd=2 -ac=

178 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Valid Parameter

Arguments

Description

-ctrl -c=id -ac=

fgnimp

controller

controllerid=id

action=

foreignimport

NA <valid virtual

disk ID

number>

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

RAIDCFG 179

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ctrl -c=id -ac=

fgnclr

controller

controllerid=id

action=

foreignclear

NA <valid virtual

disk ID

number>

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=

fgnrvr

controller

controllerid=id

action=

foreignrecover

NA <valid virtual

disk ID

number>

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

Table 4-8. RAIDCFG Options for Foreign Configurations

(continued)

Mandatory

Options and

Arguments

Optional

Parameters

Valid Parameter

Arguments

Description

180 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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.

Table 4-9. Deleting Virtual Disks

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

-vd -ac=dvd -

c=id

vdisk

action=

deletevdisk

controllerid=

NA NA Deletes all virtual disks on the indicated

controller. This option combination is

mandatory.

Example:

A:>raidcfg -vd -ac=dvd -c=2

RAIDCFG command successful!

-vd -ac=dvd -

c=id

vdisk

action=

deletevdisk

controllerid=

-vd

vdisk

<valid

virtual disk

number>

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!

RAIDCFG 181

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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.

Table 4-10. Assigning and Unassigning Global Hot Spares

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

-ctrl -ac=

sghs -c=id -

ad|-pd=

ch:targ:encl,c

h:targ:encl

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

-c=id -ad|-

pd=

ch:targ:encl,c

h:targ:encl

NA 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!

182 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Table 4-11. Assigning and Unassigning Persistent Dedicated Hot Spares

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

-ctrl -c=id -

ac=ephs

controller

controllerid=

id action=

enableperiste

nthotspare

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

Example:

A:>raidcfg -ctrl -ac=ephs -c=2

-ad=0:1

RAIDCFG command successful!

-ctrl -c=id -

ac=dphs

controller

controllerid=

id action=

disablepersist

enthotspare

NA 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!

RAIDCFG 183

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Parameter

Valid

Parameter

Arguments

Description

-se -envn=

<string> -

envc=

setenvironment

envname=

envcommand=

NA NA Sets a user-defined environment variable to

the value returned from the

getcontrollerslots function call.

This option combination is mandatory.

Example:

A:>raidcfg -se -envn=CNTRL -

envc=getcontrollerslots

CNTRL=0 1 2

RAIDCFG command successful!

-se -envn=

<string> -

envc=

setenvironment

envname=

envcommand=

-f

filename

<filename

When used, this option captures the

environment output to the given filename.

This option either appends the information

to an existing file or creates a new file.

184 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Function Calls of Setenvironment Option

Table 4-13 lists the function calls of the setenvironment option.

-se -envn=

<string> -

envc=

<function> -

c=id

setenvironment

envname=

envcommand=

controllerid=id

NA NA 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!

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!

Table 4-12. Setting Environment

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

RAIDCFG 185

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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!

Table 4-13. Function Calls of the setenvironment Option

(continued)

Function Call Description

186 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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!

Table 4-13. Function Calls of the setenvironment Option

(continued)

Function Call Description

RAIDCFG 187

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

RAID Replication Options

Table 4 - 14 lis ts the RA I D replication options.

Table 4-14. RAID Replication Options

Mandatory

Options

and

Arguments

Optional

Parameters

Valid

Parameter

Arguments

Description

-i NA <filename> 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 <filename> 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]

188 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table 4-14. RAID Replication Options

(continued)

Mandatory

Options

and

Arguments

Optional

Parameters

Valid

Parameter

Arguments

Description

RAIDCFG 189

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Parameter

Valid

Parameter

Arguments

Description

any -l

logfile

<filename> 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: 4:2:1

Controller_Name: Dell PERC

PERC 4e/Di

Channels: 2

Virtual_Disks: 0

Firmware Version: V2.8-

0[6064]

RAIDCFG command successful!

190 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

any -si

silent

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

Example:

A:>raidcfg -ctrl -si

RAIDCFG command successful!

any -ver

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

Inc.

RAIDCFG Command successful!

Table 4-15. Miscellaneous Optional Parameters

(continued)

Mandatory

Options and

Arguments

Optional

Parameter

Valid

Parameter

Arguments

Description

RAIDCFG 191

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

attached to a particular

controller

raidcfg adisk -

c=slotid

Lists all the disks attached to the

controller. The slot ID is obtained

from the first command.

Record the drive location of the

disks for later reference.

To create a virtual disk

with all the default

settings

raidcfg -ctrl -

ac=cvd -c=

slotid -ad=

x:y,x:y,...

Creates a virtual disk of maximum

available size for type RAID 0.

RAID 0 is the default.

The slot ID in <-c=slotid> and

the array disks in <-ad=...> are

obtained from the first two

commands.

To create a virtual disk

of a certain size with all

the default settings

raidcfg -ctrl -

ac=cvd -c=

slotid -ad=

x:y,x:y,... -

sz=5GB

Creates a virtual disk of 5GB size

for type RAID 0. RAID 0 is the

default.

The slot ID in <-c=slotid> and

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.

192 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

The slot ID in <-c=slotid> and

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 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 option <-fd> stands for

failover drive and requires the drive

location of the drive you want the

dedicated hot spare to be in. The

drive location is obtained from the

second command.

To create a virtual disk

of RAID 10

raidcfg -ctrl -

ac=cvd -c=

slotid -ad=

x:y,x:y,x:y,x:y

-r=10

Creates a virtual disk of max size

for type RAID 10.

The slot ID in<-c=slotid> and

the array disks in <-ad=...> are

obtained from the first two

commands. The drive location is

obtained from the second

command.

To create a virtual disk

of RAID 50

raidcfg -ctrl -

ac=cvd -c=

slotid -ad=

x:y,x:y,x:y,x:y

,x:y,x:y -r=50

-sp=x

Creates a virtual disk of maximum

size for type RAID 50.

The slot ID in <-c=slotid> and

the array disks in <-ad=...> are

obtained from the first two

commands. The drive location is

obtained from the second

command.

Table 4-16. Basic RAIDCFG Commands

(continued)

Purpose Command Description

RAIDCFG 193

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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 -

c=slotid

Lists all the virtual disks on a

specific controller.

The slot ID in <-c=slotid> is

obtained from the first command.

To delete a specific

virtual disk on a

controller

raidcfg vdisk -

ac=dvd -c=

slotid -vd=

vdiskid

Deletes a specific virtual disk on a

controller.

The slot ID in <-c=slotid> is

obtained from the first command

and the vdiskid in

<-vd=vdiskid> is obtained

from command 10.

Table 4-16. Basic RAIDCFG Commands

(continued)

Purpose Command Description

194 RAIDCFG

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Template Last Updated - 2/7/2007 UPINIT 195

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

196 UPINIT

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

UPINIT 197

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

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.

198 UPINIT

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-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

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

Table 5-1. UPINIT Options and Arguments

(continued)

Option Valid

Arguments

Description

UPINIT 199

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

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.

Table 5-1. UPINIT Options and Arguments

(continued)

Option Valid

Arguments

Description

200 UPINIT

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table 5-1. UPINIT Options and Arguments

(continued)

Option Valid

Arguments

Description

UPINIT 201

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table 5-1. UPINIT Options and Arguments

(continued)

Option Valid

Arguments

Description

202 UPINIT

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Template Last Updated - 2/7/2007 Messages and Codes 203

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

204 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

Messages and Codes 205

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

206 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

Messages and Codes 207

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

208 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

Messages and Codes 209

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

210 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

Messages and Codes 211

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

212 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

Messages and Codes 213

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

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.

Table A-1. SYSCFG Error Codes and Messages

(continued)

Error

Code

Message

214 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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: <argument>.

14 Error: Unzip failed.

Messages and Codes 215

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Messages

Table A-4 lists error codes and messages specific to the Windows PE

environment.

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.

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 <mount point>. File

exists.

34 Error: fdisk failed.

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.

216 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Messages and Codes 217

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

concatenated.

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

218 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 219

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

220 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 221

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

222 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 223

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

write.

158 No partner controller found.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

224 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 225

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

176 Invalid array disks or failover drives

selected for reconfigure/create operation.

Please make sure that all array disks and

failover drives associated with the virtual

disk are selected.

177 The maximum number of partitions have

already been created on one of the selected

array disk(s). Each array disk can hold

portions (partitions) of up to 10 virtual

disks. This virtual disk cannot be created

because one or more array disk(s) have

reached the partition limit.

178 The virtual disk is in use. Please close any

applications that use the virtual disk and

unmount any file systems that reside on the

virtual disk.

179 The firmware version is not supported.

Please update the firmware from

http://support.dell.com.

180 The specified device does not have enough

free space to be used as failover space for

the specified virtual disk.

181 The operation failed. Please rescan the

controller and retry the operation.

182 The operation cannot be performed while a

task is running on the specified virtual

disk.

183 The specified virtual disk has no dead disk

segments.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

226 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 227

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

228 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-5. RAIDCFG Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 229

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

230 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table A-6. RACADM Firmware Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 231

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

RACADM Utility Error Codes and Messages

Table A-7 lists RACADM utility error codes and messages.

52 MODULE NOT LOADED

53 IPMI ERROR

54 ERROR IN DIAGNOSTIC FUNCTION

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.

Table A-6. RACADM Firmware Error Codes and Messages

(continued)

Error Code Message

232 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-7. RACADM Error Codes and Messages

(continued)

Error Code Message

Messages and Codes 233

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table A-7. RACADM Error Codes and Messages

(continued)

Error Code Message

234 Messages and Codes

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Template Last Updated - 2/7/2007 BMC Platform Events Filter Alert Messages 235

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

236 BMC Platform Events Filter Alert Messages

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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.

Table B-1. BMC PEF Alert Events

(continued)

Event Description

Template Last Updated - 2/7/2007 Sample File Formats 237

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

bootseqretry=enable

conboot=enable

conterm=vt100

dbpm=disable

embhypervisor=on

embnic1=on

embnic2=onwithiscsi

embnic3=onwithiscsi

embnic4=onwithiscsi

238 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 239

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

240 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 241

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

242 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 243

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

244 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 245

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

246 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 247

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

248 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 249

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

250 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 251

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

252 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 253

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

254 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Sample File Formats 255

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

256 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

[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

Sample File Formats 257

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

cfgSerialConsoleQuitKey=<CR>~.

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

258 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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=

Sample File Formats 259

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

[cfgRacVirtual]

cfgVirAtapiSvrPort=0xe54

cfgVirMediaDisable=0

cfgFloppyEmulation=0

[cfgActiveDirectory]

cfgADRacDomain=

cfgADRacName=

cfgADEnable=0

cfgADAuthTimeout=0x78

cfgADRootDomain=

260 Sample File Formats

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

Template Last Updated - 2/7/2007 Summary of SYSCFG and RAIDCFG Options 261

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Description Replicated

--envar NA <filename>

<pathname

media should

be writable

When used with the –s

option, this option stores the

environment variable data to

a file so that this file can be

called from other scripts.

-h

--help

NA none

<valid option

name>

Without an argument, this

option displays general usage

information for the utility.

-i

--infile

NA <filename> Directs the SYSCFG utility

to take input from the.ini

file.

Yes

-l

--logfile

NA <filename>Logs the command line

output to a time-stamped

file.

Yes

262 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-o

--outfile

NA <filename> 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 <string> Prints the variable name and

the value assigned to it to

the console.

--version* NA Displays the version

information, current time,

and date for the utility.

--acpower NA on, off, last Specifies the behavior of the

system after AC power is

lost.

Yes

adjcacheprefetc

NA enable,

disable

Enables the processor to

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.

Yes

--assignintr NA standard,

distributed

Controls the interrupt

assignment of PCI devices in

the system.

--asset NA <string> Sets the asset tag value. Yes

--bezelir NA enable,

disable

Enables or disables the ESM

to monitor and log front

bezel intrusion conditions.

Yes

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 263

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--bootseq NA numerical

list,

separated by

commas

list of device

names,

separated by

commas

Sets the boot order. Yes (for

systems

that

support a

list of

device

names

only)

--bootseqretry NA enable,

disable

Enables or disables the boot

sequence retry feature.

Yes

--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 off, serial1,

serial2,

bmcsol, mmb

Sets console redirection to a

particular port.

Yes

--conterm NA vt100, ansi Sets console redirection

terminal type.

Yes

--cpucore NA 1, 2, 4 Allows the user to control

the number of enabled cores

in each processor. The

maximum number of cores

per processor is enabled by

default.

Yes

--cpuxdsupport NA enable,

disable

Enables or disables the

execute disable (XD) feature

of the CPU.

Yes

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

264 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--cstates NA enable,

disable

Enables or disables the

power c states of the

processor.

Available only on Dell

PowerEdge xx1x systems.

Yes

--dbpm NA enable,

disable

Enables or disables demand-

based power management.

Yes

--devseq NA numerical

list,

separated by

commas

list of device

names,

separated by

commas

Sets the boot order for hard

drives.

NOTE: This option appears

only if your system is

configured with two or more

bootable storage controllers.

If your system is not

configured with bootable

storage controllers and this

option is included in the

configuration file, the utility

generates a usage error.

Yes (for

systems

that

support a

list of

device

names

only)

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

embedded network interface

controller (NIC).

Yes

--embnic2 NA on, off,

onnopxe,

onwithiscsi

Enables or disables the

second embedded NIC.

Yes

--embnic3 NA on, off,

onnopxe,

onwithiscsi

Enables or disables the third

embedded NIC.

Yes

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 265

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embnic4 NA on, off,

onnopxe,

onwithiscsi

Enables or disables the

fourth embedded NIC.

Yes

--embnic1nic2 NA enable,

disable

Enables or disables the

operating system interface of

the first and second

embedded NIC controllers.

Available only on Dell

PowerEdge 1855, PowerEdge

6850, and xx1x systems.

Yes

--embnic3nic4 NA enable,

disable

Enables or disables the

operating system interface of

the third and fourth

embedded NIC controllers.

Available only on Dell

PowerEdge xx1x systems.

Yes

--embnics NA on, off Enables or disables the

embedded NICs.

Yes

--embnic1pxe NA enable,

disable

Enables or disables

Pre-boot

eXecution Environment

(

PXE) on the first embedded

NIC.

Yes

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

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

266 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--embscsiraid NA raid, off, scsi

raid, off

Enables or disables the

embedded SCSI RAID

controller.

Yes

embscsiraidchb

NA 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,

rad

Sets the behavior of the

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

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

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 267

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--fsbr NA 115200,

57600,

19200, 9600

Sets the console redirection

fail safe baud rate.

Yes

--hwprefetcher NA enable,

disable

Enables or disables hardware

prefetching by the processor.

Yes

--hddfailover NA off, on Specifies which device in the

hard disk drive sequence

menu is attempted in the

boot sequence.

Yes

--htassist NA enable,

disable

Enables or disables the probe

filter chipset option. Some

applications may have lower

performance when the

chipset feature is disabled.

Yes

-i

--infile

NA <filename> Reads BIOS configuration

options from a file. A file can

be generated with the -o

option.

--idecdrom NA auto, off Enables or disables the CD

drive controller.

Yes

--idectrl NA auto, off Enables or disables the IDE

controller.

Yes

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

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

268 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

the default string (model

name and number) or a user-

defined string in the front-

panel LCD (Liquid Crystal

Display).

The idracipv4address,

idracmacaddress,

ossystemname, servicetag,

ipv6address, ambienttemp,

and systemwatts arguments

are available only on Dell

PowerEdge xx1x systems.

Yes

--lcd1 NA <string> Configures the first line 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 system, you

must reboot your system for

the settings to take effect.

Yes

--lcd2 NA <string> Configures the second line

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.

Yes

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 269

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--logicproc NA enable,

disable

Enables or disables the

logical processor

(Hyperthreading).

Yes

--lpt NA disable, lpt1,

lpt2, lpt3

Disables or sets the parallel

port address.

Yes

--lptmode NA at, ps2 Sets the parallel port mode. Yes

--mem*

The asterisk is not

part of the

command syntax.

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,

mirror,

advancedecc

Selects the memory

operating mode. This feature

is active only if a valid

memory configuration is

detected. This option is

available only on xx1x

systems.

Yes

--memremap NA off, auto Enables or disables memory

remapping.

Yes

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

noraidprompt*

The asterisk is not

part of the

command syntax.

NA none Disables the POST prompt

message when the SCSI

controller type is changed.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

270 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--numlock NA on, off Enables or disables the

keyboard number lock.

Yes

--oldsetuppwd NA <string> Confirms the existing setup

password when setting a new

setup password.

--oldsyspwd NA <string>Confirms the existing system

password when setting a new

system password.

opticaldrivectrl

NA enable,

disable

Enables or disables the

optical CD-ROM controller.

Yes

--osmode NA enable,

disable

Enables or disables the

operating system

installation mode.

Yes

oswatchdogtim

NA enable,

disable

If your system stops

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.

Yes

--ovrwrt*

The asterisk is not

part of the

command syntax.

NA none Overwrites the file contents

when used with the -o

option.

power --profile maxperforma

nce, osctl,

apc

Displays the settings similar

to the BIOS setup screen for

the respective profile.

Yes

custom Creates the custom profile.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 271

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

cpupowermo

min, max,

osdbpm,

systemdbpm

Allows you to set the CPU

power and performance

management to minimum

power, maximum

performance, operating

system DBPM, or system

DBPM mode.

memorypow

ermode

min, 800,

1067, 1333,

max

Allows you to set memory

power and performance

management to minimum

power or maximum power

mode, or 800Mhz, 1067Mhz,

or 1333Mhz.

fanpowermo

min, max 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 <budgetcap

> watt, or

btuphr, or

percent

where

<budgetcap

> is the limit

for power

consumption

in Watts, or

btuphr, or

percent.

The value of <budgetcap>

must be between the

maximum and minimum

threshold values, else an

error is displayed.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

272 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

maxpowerca

Displays the value of the

maximum power threshold.

minpowerca

Displays the value of the

minimum power threshold.

valsetuppwd

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

--powerbutton NA enable,

disable

Enables or disables the front

bezel power button.

Yes

--pwdlock NA lock, unlock Enables or disables the

ability to set the system

password.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 273

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--redmem NA off, spare,

mirror, raid

Configures the redundant

memory mode.

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.

Yes

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

NOTE: This option maps to

--sata_a for Dell

PowerEdge x9xx systems.

Yes

--sata1 NA auto, off Enables or disables SATA

port 1.

NOTE: This option maps to

--sata_b for Dell

PowerEdge x9xx systems.

Yes

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

274 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--sata2 NA auto, off Enables or disables SATA

port 2.

NOTE: This option maps to

--sata_c for Dell

PowerEdge x9xx systems.

Yes

--sata3 NA auto, off Enables or disables SATA

port 3.

NOTE: This option maps to

--sata_d for Dell

PowerEdge x9xx systems.

Yes

--sata4 NA auto, off Enables or disables SATA

port 4.

NOTE: This option maps to

--sata_e for Dell

PowerEdge x9xx systems.

Yes

--sata5 NA auto, off Enables or disables SATA

port 5.

NOTE: This option maps to

--sata_f for Dell

PowerEdge x9xx systems.

Yes

--sata6 NA auto, off Enables or disables SATA

port 6.

NOTE: This option maps to

--sata_g for Dell

PowerEdge x9xx systems.

Yes

--sata7 NA auto, off Enables or disables SATA

port 7.

NOTE: This option maps to

--sata_h for Dell

PowerEdge x9xx systems.

Yes

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 275

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--serial1 NA disable,

com1, com3,

com1_bmc,

bmcserial,

bmclan, rac

Configures the behavior for

serial port 1.

Yes

--serial2 NA auto, disable,

com2, com4

Configures the behavior for

serial port 2.

Yes

--serialcomm NA on, com1cr,

com2cr, off

Configures the behavior of

serial port communication.

Yes

serialportaddrse

NA default,

alternate

Configures the port address

of the serial devices.

Yes

--setuppwd NA <string>Configures the setup

password for the system

BIOS.

--sma NA enable,

disable

Enables or disables processor

sequential memory access.

Yes

--slot*

The asterisk is not

part of the

command syntax.

NA none Reports the slot number for

a modular system.

NOTE: This option is valid for

Dell PowerEdge 1855 systems

only.

Yes

--snoopfilter NA enable,

disable

Enables or disables the

snoop filter option from the

system BIOS.

Yes

--svctag*

The asterisk is not

part of the

command syntax.

NA none Reports the service tag for

the system.

--syspwd NA <string> Sets the system password for

the system BIOS.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

276 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

tcm --tcmsecurity off, on Configures the TCM

security feature.

Yes

tcmactivatio

enabled,

disabled,

nochange

Enables or disables the TCM

activation feature.

Yes

--tcmclear NA Clears the contents of the

TCM chip without erasing

the tcmsecurity and

tcmactivation settings.

tpm --tpmsecurity off,

onwithpbm,

onwithoutpb

Configures the TPM security

feature.

Yes

tpmactivatio

enabled,

disabled,

nochange

Enables or disables the TPM

activation feature.

Yes

--tpmclear NA Clears the contents of the

TPM chip without erasing

the tpmsecurity and

tpmactivation settings.

undotpmcle

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.

valsetuppwd

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

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 277

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

setuppwdove

rride

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.

--turbomode NA enable,

disable

Enables or disables core-

based turbo mode.

Yes

--usb NA on, off,

legacy

Enables or disables the USB

port.

Yes

--usbflash NA auto, fdd,

hdd

Sets the emulation of a USB

flash device to auto, diskette

(FDD), or hard drive

(HDD).

Yes

--usbports NA enable,

enablebacko

nly, disable

Enables or disables USB

ports.

Yes

--virtualization NA enable,

disable

Enables or disables

virtualization in the CPU.

Yes

--vflash NA enable,

disable

Enables or disables vFlash in

Dell Remote Access

Controllers 5 (DRAC 5).

Yes

bmcversion --devid

--devrevision

majorfwrevis

ion

minorfwrevis

ion

NA Displays revision

information for the BMC

and the firmware.

controlpanelacc

ess

NA viewandmodi

fy, viewonly,

disabled

Sets or gets the access level

for the Liquid Crystal

Display (LCD).

Yes

--clearsel NA NA Clears the SEL.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

278 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--deviceguid NA NA Displays the GUID for the

BMC.

--encryptkey NA <hexadecima

l number>

Encrypts the Intelligent

Platform Management

Interface (IPMI) sessions.

Yes

--identify NA 0–254 Flashes the identification

LED for a specified number

of seconds.

lanchannelacce

lca

--pefalerting enable,

disable

disable,

alwaysavail

user,

operator,

administrator

Sets or displays the LAN

channel access settings such

as alerting and user privilege

limits.

ipmioverlan

channelprivl

lanchannelinfo

lci

mediumtype

Displays media and protocol

information about the LAN

channel.

--prottype

--ssnsupport

activessncou

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 279

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

lancfgparams

lcp

--ipaddrsrc static, dhcp Configures and displays LAN

configuration parameters.

--ipaddress <ipaddress>

subnetmask

<subnetmask

--gateway <gateway>

commstring

--destipaddr <destipaddre

ss>

--alertdest 1, 2, 3, 4

--vlantag enable,

disable

--vlanid 0–4095

--vlanpriority 0–7

--macaddress NA

nicselection

shared,

sharedfailove

r, dedicated

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

280 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--fullduplex enable,

disable

--autoneg enable,

disable

--speed 10,100

--dnsdhcp enable,

disable

--dnsserver1 <ipaddress>

--dnsserver2 <ipaddress>

dnsregisterra

enable,

disable

dnsracname

domainnam

efromdhcp

enable,

disable

lanuseraccess

lua

--usrprivlmt user,

operator,

administrator

, noaccess

Configures and displays user

access parameters for the

LAN channel.

Returns the number of User

IDs with fixed names.

--userid 2–10

currentenabl

eduserids NA

useridswithfi

xednames NA

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 281

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

name>

Sets the device for the next

boot operation only.

--nmibutton NA enable,

disable

Enables or disables the NMI

button.

passwordaction --action setpassword,

testpassword

Configures and displays

passwords associated with

User IDs.

pefcfgparams

pcp

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

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.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

282 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--filteraction powercycle,

reset,

powerdown,

powerreducti

on, none

--hostname <string>

--filteralert enable,

disable

alertpolnum

1, 2, 3, 4

alertpolstatu

enable,

disable

--powerbutton NA enable,

disable

Enables or disables the

power button.

--powerctl NA powerdown<

/argument>

powercycle</

argument>

reset</argu

ment>

softshutdown

</argument

Performs a chassis

powerdown and controls the

reset of the system.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 283

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--racreset NA NA Resets the RAC. It cannot be

accompanied with any other

option.

serialchannelac

cess or

sca

ipmioverseri

disable,

alwaysavail

Sets or displays the channel

access settings for the serial

channel.

channelprivl

user,

operator,

administrator

serialchannelinfo

sci

mediumtype

NA Displays serial channel

information.

--prottype NA

--ssnsupport NA

activessncou

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

284 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

serialcfgparams

scp

connection

mode

basic,

terminal

Configures and displays

serial configuration

parameters.

NOTE: The BMC firmware

does not support serial port

Point-to-Point Protocol (PPP)

configurations.

msgcommflo

wctrl

noflowctrl,

rtscts

msgcommdt

rhangup

msgcommbi

trate

9600, 19200,

57600,

115200

tmcfglineedi

ting

enable,

disable

tmcfgdelctrl

del, bksp

tmcfgechoct

echo, noecho

tmcfghands

hakectrl

enable,

disable

tmcfgnewlin

eseq

noterm, crlf,

null, cr, lfcr,

tmcfginputn

ewlineseq

cr, null

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 285

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

serialuseraccess

sua

--usrprivlmt user,

operator,

administrator

, noaccess

Configures and displays user

access parameters for the

serial channel.

--userid 2–10

currentenabl

eduserids

useridswithfi

xednames

--solaction Enables or disables Serial-

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

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

286 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

solcfgparams --solenable enable,

disable

Configures and displays SOL

configuration parameters.

--solprivlevel user,

operator,

administrator

solcharaccu

minterval

1–255

solcharsendt

hreshold

1–255

--solbitrate 9600, 19200,

57600,

115200

ssninfo --

maxactivess

NA Displays information about

the number of possible

active sessions and the

number of currently active

sessions on all channels on

the controller.

currentactiv

essns

useraction --userid 2–10 Enables and disables User

IDs for the

serialchannelaccess and

lanchannelaccess options.

--action enable,

disable

username --name <string> Assigns user names to a

given User ID and displays

user names associated with a

given User ID.

--userid 2–10

--version NA NA Displays the version

information for the SYSCFG

utility.

-b NA <string> Specifies the value to write

to state data.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 287

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

288 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

lancfgparamsv6 --ipv6 enable,

disable

Loads or unloads the IPv6

stack.

Yes

--ipsrcv6=

static

--ipaddrv6=

<ipv6addres

s> --

prefixlength

v6=

<prefixlengt

hv6>

gatewayv6=

<ipv6gatewa

yaddress>

Allows you to manually

configure IPv6 addresses.

--ipsrcv6=

auto

Automatically configures the

IPv6 addresses.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

Summary of SYSCFG and RAIDCFG Options 289

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

--dnssrcv6 =

auto

Automatically configures the

DNS address.

--dnssrcv6=

static --

dnsserver1v6

<ipv6dnsser

ver1address

Allows you to manually set

the DNS address.

linklocaladdr

ipv6=

<linklocalad

dripv6>

Allows you to view IPv6

addresses.

gatewayv6=

<gatewayv6

Allows you to view IP

gatewayv6 address.

Table D-1. SYSCFG Options

(continued)

Options Sub-options Valid

Arguments

Description Replicated

290 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

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

option

-h

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-1 for

specific usage

information.

-ac

action

cvd

createvdisk

Creates a virtual disk.

NOTE: When providing multiple

physical disks for the createvdisk

command, do not separate the disks

with spaces. For example, -ad=1:4,

1:5 causes an error. The correct

syntax for displaying multiple physical

disks is -ad=1:4,1:5,1:6.

See Table 4-4 for

specific usage

information.

-ac

action

dvd

deletevdisk

Deletes a virtual disk. See Table 4-9 for

specific usage

information.

-ad

adisk

NA Specifies an array disk command. See Table 4-5 for

specific usage

information.

Summary of SYSCFG and RAIDCFG Options 291

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ad

adisk

ch:targ, ch:targ, ...

or ch:targ:lun,...

or ch:targ:enc

channel:target, or

channel:target:lu

n, or

channel:target:en

closure

Specifies an array disk.

For SCSI controllers, the value of

LUN should always be 0.

For SAS controllers, the value of

enclosure can be non-zero, in which

case you must specify values for

channel, target, and enclosure.

NOTE: You can also use pdisk or -pd

instead of adisk or -ad to specify an

array disk.

Optional.

See Table 4-5 for

specific usage

information.

-c

controlle

rid

<valid controller

ID number>

Specifies a RAID controller. See Table 4-3 for

specific usage

information.

-cp

cachepol

icy

d, c or d, e Specifies the cache policy for reads on

a specified virtual disk or disk cache

policy.

Optional.

See Table 4-4 for

specific usage

information.

-ctrl

controller

NA Displays a list of the supported RAID

controllers in the system, along with

select property information.

Mandatory, must

be typed in the

correct order.

See Table 4-3 for

specific usage

information.

-envc

envcom

mand

<string> Sets a user-defined environmental

variable (<string>) to the value

returned from a function call.

See Table 4-12

for specific usage

information.

-envn

envname

<string> Sets the environment variable

(<string>) that equates to the value

returned from a function call.

See Table 4-12

for specific usage

information.

Table D-2. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

292 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-fd

failoverd

rive

ch:targ, ch:targ, ...

or ch:targ:lun,...

or ch:targ:enc

channel:target, or

channel:target:lu

n, or

channel:target:en

closure

Specifies the location of the failover

drive in an array.

For SCSI controllers, the value of

LUN should always be 0.

For SAS controllers, the value of

enclosure can be non-zero, in which

case you must specify values for

channel, target, and enclosure.

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.

Optional.

See Table 4-4 for

specific usage

information.

-i <filename> 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.

-l

logfile

<filename> Logs command line output to a file. Optional.

See Table 4-15

for specific usage

information.

-o <filename> 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.

-r

raid

<valid RAID level

number>

Sets the RAID level for the array.

Valid RAID values are 0, 1, 5, 10, 50.

If no value is specified for RAID, 0 is

taken as the default level.

Optional.

See Table 4-4 for

specific usage

information.

Table D-2. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

Summary of SYSCFG and RAIDCFG Options 293

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-rp

readpoli

ra, ara, nra, rc, nrc Sets the read policy for the virtual

disk.

Optional.

See Table 4-4 for

specific usage

information.

-se

setenviro

nment

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

Mandatory.

See Table 4-12

for specific usage

information.

-si

silent

NA Does not display any information on

the terminal console.

Optional.

See Table 4-15

for specific usage

information.

-sz

size

<number> Sets the maximum size on the virtual

disk in MB or GB if the size is not

provided.

The default size is in MB. If GB

follows the number, the size is

expressed in GB.

Optional.

See Table 4-4 for

specific usage

information.

-sp

spanleng

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

Mandatory.

See Table 4-4 for

specific usage

information.

Table D-2. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

294 Summary of SYSCFG and RAIDCFG Options

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10 - FOR PROOF ONLY

-ssz

stripesiz

<number> Sets the stripe size on the virtual disk

in KB.

NOTE: When creating virtual disks, do

not specify the units for chunk (stripe)

size. The units are always listed in KB.

Optional.

See Table 4-4 for

specific usage

information.

-vd

vdisk

NA Displays the virtual disks under all of

the controllers along with the physical

array disks that make up the virtual

disks.

See Table 4-6 for

specific usage

information.

-vd

vdisk

<valid virtual

disk ID number>

Displays the specified virtual disk. Optional.

See Table 4-6 for

specific usage

information.

-ver

version

NA Displays the version number of the

utility.

Optional.

See Table 4-15

for specific usage

information.

-wp

writepoli

wb, wt, wc, nwc Sets the write policy for a virtual disk.

The valid arguments are: wb (write-

back caching),

wt (write-through caching), wc (write-

caching), and nwc (no-write-caching).

Optional.

See Table 4-15

for specific usage

information.

Table D-2. RAIDCFG Short and Long Format Options

(continued)

Option Valid Arguments Short Description Mandatory or

Optional

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10

FOR PROOF ONLY

Index 295

Index

disk partitioning

UPINIT, 195

disk partitioning utilities, 8

disk partitioning utility, 8

DTK utilities

overview, 7

error codes, 203

error messages, 17, 203

features

RAIDCFG, 143

SYSCFG, 19

UPINIT, 195

messages and codes, 203

options and arguments

RAIDCFG, 144

UPINIT, 196

overview

DTK utilities, 7

RAC configuration utilities

RACADM, 8

RAC configuration utility, 8

RAID configuration utilities, 8

RAID configuration utility

RAIDCFG, 8

RAIDCFG, 143

error codes and messages, 215

features, 143

options and arguments, 144, 151

supported RAID controllers, 143,

195

replication, 8

requirements, 7

SYSCFG, 19

error checking and messages, 203

features, 19

options and arguments, 25

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

DELL CONFIDENTIAL – PRELIMINARY 12/3/10

FOR PROOF ONLY

296 Index

system configuration and update

utilities, 8

SYSCFG, 8

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 Openmanage Deployment Toolkit Version 3 4 Quick Reference Guide 3.4 Command Line Interface

Navigation menu

Versions of this User Manual:

Views

Navigation