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

2014-11-13

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

Open the PDF directly: View PDF PDF.
Page Count: 177 [warning: Documents this large are best viewed by clicking the View PDF Link!]

Dell OpenManage Deployment Toolkit Version 4.2
Command Line Interface Reference Guide
Notes, Cautions, and Warnings
NOTE: A NOTE indicates important information that helps you make better use of your computer.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the
problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 2012 Dell Inc.
Trademarks used in this text: Dell™, the Dell logo, Dell Boomi™, Dell Precision™ , OptiPlex™, Latitude™, PowerEdge™, PowerVault™,
PowerConnect™, OpenManage™, EqualLogic™, Compellent™, KACE™, FlexAddress™, Force10™ and Vostro™ are trademarks of Dell
Inc. Intel®, Pentium®, Xeon®, Core® and Celeron® are registered trademarks of Intel Corporation in the U.S. and other countries. AMD®
is a registered trademark and AMD Opteron™, AMD Phenom™ and AMD Sempron™ are trademarks of Advanced Micro Devices, Inc.
Microsoft®, Windows®, Windows Server®, Internet Explorer®, MS-DOS®, Windows Vista® and Active Directory® are either trademarks
or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat® and Red Hat®
Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell® and SUSE® are
registered trademarks of Novell Inc. in the United States and other countries. Oracle® is a registered trademark of Oracle Corporation
and/or its affiliates. Citrix®, Xen®, XenServer® and XenMotion® are either registered trademarks or trademarks of Citrix Systems, Inc. in
the United States and/or other countries. VMware®, Virtual SMP®, vMotion®, vCenter® and vSphere® are registered trademarks or
trademarks of VMware, Inc. in the United States or other countries. IBM® is a registered trademark of International Business Machines
Corporation.
2012 - 12
Rev. A00
Contents
Notes, Cautions, and Warnings...................................................................................................2
1 Introduction..................................................................................................................................7
What's New In This Release....................................................................................................................................7
Supported Systems...................................................................................................................................................8
Supported Operating Systems..................................................................................................................................8
Toolkit Utilities..........................................................................................................................................................9
System Configuration Utility...............................................................................................................................9
RAID Configuration Utility...................................................................................................................................9
RAC Configuration Utility....................................................................................................................................9
Disk Partitioning Utility.......................................................................................................................................9
Replication Of DTK Utilities.......................................................................................................................................9
File Format..........................................................................................................................................................9
SYSCFG Replication Rules..................................................................................................................................9
RAID Replication..............................................................................................................................................10
RACADM Replication.......................................................................................................................................10
Other Documents You May Need...........................................................................................................................10
Contacting Dell.......................................................................................................................................................11
2 Command Syntax Overview.....................................................................................................13
DTK Utilities General Usage...................................................................................................................................13
Command Line Syntax............................................................................................................................................13
Case Sensitivity.......................................................................................................................................................14
Command Line Option Delimiters............................................................................................................................14
Other Delimiters......................................................................................................................................................15
Read And Write Commands....................................................................................................................................16
File Input And Output Commands...........................................................................................................................16
Log Files..................................................................................................................................................................16
Help Option.............................................................................................................................................................17
Error Checking And Error Messages......................................................................................................................17
3 SYSCFG.......................................................................................................................................19
Features..................................................................................................................................................................19
SYSCFG General Options........................................................................................................................................19
No Option..........................................................................................................................................................19
--envar..............................................................................................................................................................20
-h or --help........................................................................................................................................................20
-i or --infile........................................................................................................................................................21
--ix or --inxmlfile...............................................................................................................................................21
-l or --logfile......................................................................................................................................................22
-o or --outfile....................................................................................................................................................22
--ox or --outxmlfile............................................................................................................................................23
--px or --pendingxmlfile....................................................................................................................................23
-s.......................................................................................................................................................................23
--version*.........................................................................................................................................................24
SYSCFG For BIOS Configuration.............................................................................................................................24
SYSCFG Options On PowerEdge Systems Prior To PowerEdge 12G Systems.................................................24
Sub Options And Arguments For tpm Option....................................................................................................59
Sub Options And Arguments For tcm Option....................................................................................................61
Sub Options And Arguments For power Option...............................................................................................62
SYSCFG Options On PowerEdge 12G Systems.................................................................................................63
SYSCFG For BMC And Remote Access Controller Configuration...........................................................................78
BMC And Remote Access Controller Configuration Options...........................................................................78
clearsel*...........................................................................................................................................................78
controlpanelaccess..........................................................................................................................................79
deviceguid*......................................................................................................................................................79
encryptkey........................................................................................................................................................79
identify..............................................................................................................................................................80
idracversion......................................................................................................................................................80
kvmstatusonlcd................................................................................................................................................80
lancfgparams...................................................................................................................................................81
lanchannelaccess............................................................................................................................................84
lanchannelinfo..................................................................................................................................................85
lanuseraccess..................................................................................................................................................85
loaddefaults*....................................................................................................................................................86
nextboot............................................................................................................................................................86
nmibutton..........................................................................................................................................................87
passwordaction................................................................................................................................................88
pefcfgparams...................................................................................................................................................89
powerbutton.....................................................................................................................................................90
powerctl...........................................................................................................................................................91
racreset*..........................................................................................................................................................91
serialcfgparams...............................................................................................................................................92
serialchannelaccess........................................................................................................................................93
serialchannelinfo..............................................................................................................................................94
serialuseraccess..............................................................................................................................................94
solaction...........................................................................................................................................................96
solcfgparams....................................................................................................................................................96
ssninfo..............................................................................................................................................................98
useraction........................................................................................................................................................98
username..........................................................................................................................................................99
version*..........................................................................................................................................................100
virutualmedia..................................................................................................................................................100
SYSCFG For State Configuration...........................................................................................................................100
SYSCFG Options For State Configuration.......................................................................................................100
SYSCFG for System Configuration........................................................................................................................101
Options For System Configuration..................................................................................................................101
SYSCFG For IPv6 Configuration............................................................................................................................106
PCI Reporting........................................................................................................................................................107
Environment Variable File...............................................................................................................................107
4 RAIDCFG...................................................................................................................................109
Features................................................................................................................................................................109
Supported RAID Controllers.................................................................................................................................109
RAIDCFG Dependencies.......................................................................................................................................109
RAIDCFG Options And Arguments........................................................................................................................110
RAID Configuration Utility Options And Arguments..............................................................................................115
General Help...................................................................................................................................................115
Enumerating RAID Controllers.......................................................................................................................116
Creating Virtual Disks.....................................................................................................................................117
Enumerating Array Disks................................................................................................................................123
Blinking And Unblinking Array Disks..............................................................................................................126
Enumerating Virtual Disks..............................................................................................................................126
Deleting Virtual Disks.....................................................................................................................................128
Setting A Virtual Disk As Bootable Virtual Disk.............................................................................................128
Blinking And Unblinking Virtual Disks............................................................................................................129
Setting Virtual Disk Name..............................................................................................................................129
Setting Environment Variables.......................................................................................................................130
RAID Replication Options...............................................................................................................................132
Assigning, Unassigning, And Listing Global Hot Spares................................................................................133
Importing And Clearing Foreign Configurations.............................................................................................134
Initializing Virtual Disks..................................................................................................................................134
Resetting The Controller.................................................................................................................................135
Enabling And Disabling Persistent Dedicated Hot Spares.............................................................................135
Miscellaneous Options...................................................................................................................................136
Quick Reference To RAIDCFG Commands............................................................................................................137
5 UPINIT.......................................................................................................................................139
Features................................................................................................................................................................139
Creating A Partition Using UPINIT........................................................................................................................139
UPINIT Dependencies..........................................................................................................................................139
UPINIT Options And Arguments...........................................................................................................................140
6 Messages And Codes.............................................................................................................143
SYSCFG Error Codes And Messages....................................................................................................................143
Failure Messages...........................................................................................................................................143
Failures And Solutions....................................................................................................................................151
UPINIT Common Error Codes And Messages......................................................................................................151
Failure Messages...........................................................................................................................................151
UPINIT Linux-Specific Error Codes And Messages.............................................................................................152
UPINIT Windows PE-Specific Error Codes And Messages.................................................................................152
RAIDCFG Error Codes And Messages..................................................................................................................152
Failure Messages...........................................................................................................................................152
RACADM Firmware Error Codes And Messages.................................................................................................161
RACADM Utility Error Codes And Messages........................................................................................................163
7 BMC Platform Events Filter Alert Messages......................................................................165
8 Sample File Formats................................................................................................................167
Sample SYSCFG Utility .ini File Format..................................................................................................................167
Sample RAIDCFG Utility .ini File Format................................................................................................................175
Sample RACADM Utility .ini File Format...............................................................................................................175
1
Introduction
Dell OpenManage Deployment Toolkit (DTK) includes a set of utilities, sample scripts, and sample configuration files to
deploy and configure your Dell system. You can use DTK to build script-based and RPM-based installation for deploying
a large number of systems reliably, without changing their current deployment processes. You can use DTK in a
Microsoft Windows Preinstallation Environment (Windows PE) or a Linux environment.
What's New In This Release
• Using DTK utilities you can deploy the following operating systems:
– Red Hat Enterprise Linux 6.3 (64-bit)
– Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)
– SUSE Linux Enterprise Server 11 SP2 (64-bit)
– SUSE Linux Enterprise Server 10 SP4 (64-bit)
– Windows Server 2012 (64–bit)
• You can install DTK Linux RPM utilities on the following operating systems:
– Red Hat Enterprise Linux 6.3 (64-bit)
– Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)
– SUSE Linux Enterprise Server 11 SP2 (64-bit)
– SUSE Linux Enterprise Server 10 SP4 (64-bit)
• Support for Windows PE 4.0 (64-bit) for deploying Windows Server 2012 using W2K12INST.BAT script.
NOTE: For more information, see
Dell OpenManage Deployment Toolkit User's Guide
available at dell.com/
support/manuals.
• DTK tool support for Embedded Linux ISO image (64-bit).
• Improved syscfgperformance on Dell Power Edge yx2x (12G) systems and reduction in server provisioning time.
•Syscfg supports the following:
– Fully Qualified Domain Name (FQDN) as SNMP trap destination. For more information, see
lancfgparams.
– BIOS configuration using XML file on Dell PowerEdge 12G systems. For more information, see --ix, --ox,
and --px.
•Raidcfg supports the following:
– Blinking and unblinking virtual disks and array disks. For more information, see Blinking And Unblinking
Virtual Disks and Blinking And Unblinking Array Disks.
– Enumerating virtual disk. For more information, see Enumerating Virtual Disks.
– Setting a virtual disk as bootable device. For more information, see Setting A Virtual Disk As Bootable
Virtual Disk.
– Setting virtual disk name. For more information, see Setting Virtual Disk Name.
– Listing global hot spares. For more information, see Assigning, Unassigning, And Listing Global Hot
Spares.
• Support for BIOS and RAID configurations in the following Dell PowerVault Network Attached Servers (NAS) :
7
– NX3000
– NX3100
– NX300
– NX200
– NX3300
– NX3200
– NX400
• Support for creating and reporting RAID in following Dell PowerVault enclosures:
– MD1000
– MD1200
– MD1220
• Deprecated support for the following operating systems:
– Windows PE 2.0 (32-bit and 64-bit)
– Red Hat Enterprise Linux 6.2
Supported Systems
For a complete list of supported Dell PowerEdge systems, see the
Dell Systems Software Support Matrix
available at
dell.com/support/manuals. On the Manuals page, click Software→ Systems Management→ Dell OpenManage
Releases. Click the appropriate product version to access the Support Matrix.
Supported Operating Systems
For Windows, the DTK utilities support Windows PE 3.0 (32-bit and 64-bit) and Windows PE 4.0. Using the DTK utilities,
we can deploy the following Windows operating systems:
• Microsoft Windows Server 2012 (64–bit)
• Windows Server 2008 SP2 (32-bit and 64-bit)
• Windows Server 2008 R2 SP1
For Linux, the DTK utilities support the following operating systems:
• Red Hat Enterprise Linux 6.3 (64-bit)
• Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)
• SUSE Enterprise Linux 11 SP2 (64-bit)
• SUSE Enterprise Linux 10 SP4 (64-bit)
You can install DTK Linux RPM utilities on the following operating systems:
• Red Hat Enterprise Linux 6.3 (64-bit)
• Red Hat Enterprise Linux 5.8 (32-bit and 64-bit)
• SUSE Enterprise Linux 11 SP2 (64-bit)
• SUSE Enterprise Linux 10 SP4 (64-bit)
NOTE: The RPMs are available in the RPMs folder of DTK ELI ISO and also at linux.us.dell.com/repo/hardware/
OMSA_7.1.1/.
8
Toolkit Utilities
DTK contains utilities that allow you to configure the BIOS, Baseboard Management Controller (BMC), Remote Access
Controller (RAC), RAID controllers, and hard-drive partitions on supported Dell systems. Additionally, the utilities can be
integrated with the sample files provided with the toolkit to fully configure one-to-many target systems in a scripted
mass system deployment.
NOTE: In a Linux environment, the DTK utilities do not have the .exe extension.
System Configuration Utility
The SYSCFG utility performs the following tasks:
• Reports and sets BIOS configuration options.
• Reports and sets BMC/RAC configuration options.
• Reports and sets user-configurable states.
• Reports system information, including PCI device detection.
RAID Configuration Utility
The RAIDCFG utility reports and sets RAID configuration options.
RAC Configuration Utility
The RACADM utility reports and sets RAC configuration options for Dell Remote Access Controller DRAC 5, iDRAC6, and
iDRAC7.
Disk Partitioning Utility
The UPINIT script creates, formats, and populates a Dell Utility Partition.
Replication Of DTK Utilities
This section explains the replication of DTK utilities.
File Format
The -i and -o options use the .ini file format for system configuration (SYSCFG) options. All name/value entries that follow
the [syscfg] section header in the .ini file belong to the SYSCFG utility. For an example of the syscfg.ini file, see
Sample SYSCFG Utility .ini File Format.
SYSCFG Replication Rules
Not all BIOS and BMC options can be replicated using the .ini file. For example, boot sequence and device sequence are
only replicated if a device name list can be supplied. A numerical device list cannot be replicated since the index values
can change from system to system. In addition, because the service tag information is static, it is not commented out in
the output file or replicated. See the description of each option for further replication information.
9
The syscfg.ini file cannot be used across different systems. The file output operation places system identification
information at the beginning of the [syscfg] section. This information is used to determine if the file can be accepted
as input for a system. The following information is used for system identification:
• System ID Byte(s)
• System Name
• BIOS Version
If these values do not match the values found on the system, the file input operation fails.
The following is the SYSCFG behavior during replication:
• Options not available in SYSCFG are termed invalid options. If SYSCFG encounters an invalid option in the
syscfg.ini file, the SYSCFG utility terminates.
• Unsupported options are options available in SYSCFG but not applicable on certain systems. If SYSCFG
encounters an unsupported option, SYSCFG logs this option and continues to the next option.
• Unsupported arguments are arguments valid in SYSCFG but not applicable on certain systems. If SYSCFG
encounters an unsupported argument, SYSCFG terminates.
For example, the command syscfg –-embsataraid=ahci is not applicable on some PowerEdge
x
9
xx
series systems.
• SYSCFG logs a message in the log file for each option processed in the syscfg.ini file. To generate the log file,
use the logfile option.
RAID Replication
The RAID replication feature reads the RAID configuration information from the source system and creates a raid.ini file.
This raid.ini file can be applied to the RAID configurations of the target system. The RAID replication requires both, the
source system and the target system to have similar RAID controllers.
RACADM Replication
The RACREP.BAT sample script applies RAC configuration options to the target system based on the configuration
information that has been saved in a configuration file. User input is optional, depending on variables set in the
RACREP.BAT sample script. This script uses the RACADM.EXE utility to configure the RAC in the target system using the
RAC configuration file, raccfg.ini. The raccfg.ini configuration file is passed as the first parameter to the RACREP.BAT
script. If this parameter is not passed, the default variable values used in this script are set in the TKENVSET.BAT
scripts. An optional second parameter can be passed to this file, which specifies the IP address used in configuring the
RAC. The raccfg.ini file is generated with the RACCAP.BAT sample script.
Other Documents You May Need
In addition to this guide, you can access the following guides available at dell.com/support/manuals . On the Manuals
page, click dell.com/support/manuals → Product Type → Software, Monitors, Electronics & Peripherals → Software →
Enterprise System Management . Click on the appropriate product link on the right-side to access the documents.
• The
Dell OpenManage Deployment Toolkit Quick Installation Guide
provides information about installing and
deploying DTK on supported Dell systems. The guide is available as part of the DTK download and at
support.dell.com.
• The
Dell OpenManage Deployment Toolkit User's Guide
provides best practice procedures that focus on the
basic tasks for successful deployment of Dell systems.
10
• The
Dell Systems Software Support Matrix
provides information about the various Dell systems, the operating
systems supported by these systems, and the Dell OpenManage components that can be installed on
these systems.
• The Dell OpenManage Installation and Security User's Guide provides additional information about performing
an unattended installation of Dell OpenManage Server Administrator on systems running supported Windows,
Red Hat Enterprise Linux, and SUSE Linux Enterprise Server operating systems.
• The
Dell OpenManage Server Administrator User's Guide
provides information on using Server Administrator on
supported operating systems.
• The
Dell Update Packages User's Guide
provides information about obtaining and using Dell Update Packages
as part of your system update strategy.
• The
Dell OpenManage Sever Administrator Storage Management User’s Guide
provides information about RAID
controllers.
• The
Command Line Reference Guide for iDRAC6 and CMC
provides information about the RACADM
subcommands, supported interfaces, property database groups and object definitions for iDRAC6 and CMC.
• The
Integrated Dell Remote Access Controller 7
(iDRAC7) User's Guide
provides information about configuring
and using iDRAC7 for 12G rack, tower, and blade servers to remotely manage and monitor your system and its
shared resources through a network.
• The
Integrated Dell Remote Access Controller 6 (iDRAC6)
Enterprise for Blade Servers User Guide
provides
information about configuring and using an iDRAC6 for
yx1x
(11G) blade servers to remotely manage and monitor
your system and its shared resources through a network.
• The
Integrated Dell Remote Access Controller 6 (iDRAC6) User Guide
provides complete information about
configuring and using an iDRAC6 for
yx1x
tower and rack servers to remotely manage and monitor your system
and its shared resources through a network.
• The Glossary provides information about the terms used in this document.
• The Deployment Toolkit readme files (for Windows PE and embedded Linux) which is available as part of the
DTK download at support.dell.com, provides the latest available information about the installation and operation
of the DTK components and the list of PowerEdge systems supported for this version of DTK.
Contacting Dell
NOTE: If you do not have an active Internet connection, you can find contact information on your purchase invoice,
packing slip, bill, or Dell product catalog.
Dell provides several online and telephone-based support and service options. Availability varies by country and
product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer
service issues:
1. Visit support.dell.com .
2. Select your support category.
3. If you are not a U.S customer, select your country code at the bottom of the page, or select All to see more choices.
4. Select the appropriate service or support link based on your need.
11
12
2
Command Syntax Overview
Syntax refers to the way a command and its parameters are entered. Dell OpenManage Deployment Toolkit (DTK)
Command Line Interface (CLI) commands can be arranged in any order as long as they conform to the basic command
line syntax.
DTK Utilities General Usage
The following table lists the general usage models of the DTK utilities:
Table 1. DTK Utilities
Utilities Usage
SYSCFG syscfg --option1=[arg1] ... --optionX=[argX]
or
syscfg bmcoption1 --bmcsuboption1=[arg1]...--
bmcsuboptionX=argX]
RAIDCFG raidcfg [mandatory options] <optional arguments>
RACADM racadm <options> <subcommand> <subcommand_options>
NOTE: The Command Line Reference Guide for iDRAC6 and CMC
available on dell.com/support/manuals provides information about the
RACADM subcommands, supported interfaces, property database
groups and object definitions for iDRAC6 and CMC.
UPINIT For WinPE:
upinit --disk=0 --size=32 --file=t:\upimage.bin
For Linux:
upinit --disk=/dev/sda --size=32 --file=/tmp/
upimage.bin
The DTK command line switches, configuration file formatting, and error reporting follow similar style and behavior.
However, individual DTK utilities can sometimes differ from one another in significant ways. You must familiarize
yourself with the command line syntax and utility-specific options and arguments for each utility before using DTK.
NOTE: Some of the command line options in DTK are followed by an asterisk. Such options are used for reporting
purposes only.
Command Line Syntax
The following table lists the generic command line characters and arguments present in the command line options with
a short description of these characters.
13
Table 2. Command Line Options
Element Description
-Prefix single character options.
NOTE: This delimiter is not applicable to Baseboard Management
Controller (BMC) sub-options.
-- Prefix multi-character options.
utilname Indicates the generic designation for a DTK utility name.
oIndicates the generic single-character designation for an option.
optionX Indicates the generic multi-character designation for a utility name, where
you can use X to distinguish multiple options used in the same command
line instance.
argX Indicates the generic designation for an argument, where you can use X to
distinguish multiple arguments used in the same command line instance.
[mandatory option] Indicates the generic designation for a mandatory argument.
<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.
... Indicates that the previous argument can be repeated several times in a
command. Enter only the information within the ellipses and exclude the
ellipses.
|Separates two mutually exclusive choices in a syntax line. For example:
usb: Turns the usb controller on or off
Argument: enable | disable | legacy
Enter only one choice: --usb=enable, --usb=
disable, or --usb=legacy.
Case Sensitivity
• Command line options, pre-defined and user-defined arguments, and filenames given as arguments are all case-
sensitive on PowerEdge systems prior to PowerEdge
yx2x
.
• Unless specified otherwise, enter all commands, options, arguments, and command line switches in lowercase
letters.
Command Line Option Delimiters
The following table lists some examples of valid and invalid DTK command lines.
14
Table 3. Command Line Option Delimiters
Valid / Invalid DTK Command Line Example
valid syscfg --option1 --option2 syscfg --asset --floppy
invalid syscfg --option1=argument --
option2
--option3
syscfg --asset=R910 --floppy --
bootseq
valid syscfg -o=filename --option1 --
option2
syscfg -o=/tmp/myfile.txt --floppy
--bootseq
valid syscfg -l=filename --option1 --
option2
syscfg -l=/tmp/myfile.txt --floppy
--bootseq
invalid syscfg -i=filename --option1 --
option2
syscfg -i=/tmp/myfile.txt --floppy
--bootseq
valid syscfg --option=argument
bmcoption
--option1= argument
syscfg --embnic=on pcp --
hostname=webserver
NOTE: Do not combine options that specify report or set actions in a command line instance.
Other Delimiters
The following table lists the other delimiters:
Table 4. Other delimiters
Delimiter Example Description
White space (space or tab) syscfg --
option=argument1
argument2
considers
argument1
and
argument2
as two arguments.
A string surrounded by double
quotation marks regardless of the
white space contained within, is
interpreted as a single SYSCFG
argument.
syscfg --
option="argument1
argument2"
considers
argument1
and
argument2
a single argument.
A double quotation mark preceded by
a backslash (\") is interpreted as a
literal double quotation mark (").
syscfg --
option="\"argument"
considers "argument as the argument.
Backslashes are interpreted literally,
unless they immediately precede a
double quotation mark. If an even
number of backslashes are followed
by a double quotation mark, then one
backslash (\) is taken for every pair of
syscfg --option="\
\"argument"
considers \ and argument as two
arguments.
15
Delimiter Example Description
backslashes (\\), and the double
quotation mark (") is interpreted as a
string delimiter.
If an odd number of backslashes are
followed by a double quotation mark,
then one backslash (\) is taken for
every pair of backslashes (\\) and the
double quotation mark is interpreted
as an escape sequence by the
remaining backslash, causing a literal
double quotation mark (") to be placed
in the SYSCFG argument.
syscfg --option="\\
\"argument"
considers \ "argument as the
argument.
Read And Write Commands
Options can report a certain value or set of values based on the presence of an argument. These read or write actions
are implied in the DTK command line arguments. The get, read, set, or write commands, for example, are not required.
NOTE: You cannot combine options that specify read or write actions in a command line instance.
Table 5. Read and Write Command Examples
Valid/Invalid DTK Command Line Example
valid syscfg --option1 --option2
valid syscfg --option1=arg --option2=arg
invalid syscfg --option1=arg --option2
File Input And Output Commands
• Specify the file input using the -i <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.
Log Files
If the log file already exists, information is appended to the file. This allows multiple tools to use the same log file to
record information. Use the -l option to record the output of a utility.
The log duplicates all standard output and error information to the specified file. Each log file begins with a time stamp
and utility name. For example, YYYY/MM/DD HH:MM:SS < utilname > - <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 accesses the log files.
16
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.
17
18
3
SYSCFG
This section documents the Deployment Toolkit (DTK) system configuration utility. It describes the command line
parameters, configuration file format, and individual executables used to configure server BIOS and Baseboard
Management Controller (BMC) settings, DTK state settings, and system information including PCI device detection.
Features
The SYSCFG utility:
• Displays help and usage information.
• Outputs configuration options to a file or screen.
• Reads configuration options from a file or Command Line Interface (CLI) parameters.
• Configures BMC/Remote Access Controller (RAC) users, local area network (LAN) channel and serial channel
settings, BMC/RAC platform event filter (PEF) settings, and BMC/RAC serial-over-LAN (SOL) settings.
• Configures the nonmaskable interrupt (NMI) and power button.
• Reports the BMC/RAC firmware version, BMC/RAC device global unique identifier (GUID), and BMC/RAC LAN
channel and serial channel information.
• Reports BMC/RAC session information.
• Clears BMC/RAC system event log (SEL).
• Restores BMC/RAC factory defaults.
• Records and reports the state data value.
• Displays system configuration information.
• Returns specific error codes and messages.
• Logs activity to a given filename.
• Configures the BIOS features using ini file, DTK xml file, and ws-man xml file.
NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), the SYSCFG utility is located at \dell
\x32\toolkit\tools or \dell\x64\toolkit\tools directory. In Linux, you can find it in the/opt/dell/toolkit/bin directory.
SYSCFG General Options
NOTE: Some of the options in SYSCFG are followed by an asterisk. The asterisk is not part of the command
syntax.These commands do not accept any sub-options or arguments. The values associated with these
commands are reported by the BIOS. You cannot modify these values.
No Option
Options No option
Sub-Options NA
19
Valid Arguments NA
Description The SYSCFG utility outputs usage information. The usage information is
displayed in the format shown below.
--envar
Options --envar
Sub-Options NA
Valid Arguments <
valid filename
> <
valid path
> media should be writable
Description Stores the environment variable data to a file when used with the – s option.
This file can be called from other scripts to set the environment variable. The
value of <
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
-h or --help
Options -h or --help
Sub-Options NA
Valid Arguments none or <
valid option name
>
Description Displays the general usage information for the utility, when no argument is
provided. If the argument matches a valid option, that option's usage
information is displayed. If the option has arguments, the arguments are
displayed, separated by a | character. If the option has sub-options, all 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.
20
Example:
A:>syscfg -h lanchannelaccess
lanchannelaccess: Reports LAN channel access
information.
Sub-options:
pefalerting: Enable or disable PEF (Platform Event
Filter)alerting.
Arguments: enable | disable
ipmioverlan: Enable or disable
IPMI over LAN access.
Arguments: disable | alwaysavail
channelprivlmt: Sets the maximum privilege level
that can be accepted on the LAN channel.
Arguments: user | operator |administrator
-i or --infile
Options -i or --infile
Sub-Options NA
Valid Arguments <
filename
>
Description Directs the SYSCFG utility to take input from the .ini file. The utility searches the
file for a section heading identical to the utility name. An error is returned if the
file or section is not found. If the section is found, each name/value pair is
applied to the system. The names must match a valid option, and the arguments
must be in the proper format for the option. If an option is not available on a
system and it is specified in a file, the utility ignores the option. If any errors are
found in the format of the names or values, an error is returned and the options
are not applied to the system. If this option is used with other function
command options, they are applied in the order in which they appear on the
command line, overriding any previous commands.
Example:
A:>syscfg -i <filename>.ini
--ix or --inxmlfile
Options --ix or --inxmlfile
Sub-Options NA
Valid Arguments <
filename
>
Description Directs the SYSCFG utility to receive input from the xml file. The utility searches
the BIOS option in the file. An error is returned if the file is not found. The
provided option must match a valid option, and the arguments must be in the
proper format for the option. If an option is not available on a system and it is
21
specified in a file, the utility ignores the option. If any errors are found in the
format of the names or values, an error is returned and the options are not
applied to the system. If this option is dependent on any other option, they are
applied in the order in which they appear in the xml file.
NOTE: It is applicable only on 12G and later systems.
Example:
A:>syscfg --ix filename.xml
NOTE: You can modify or use the BIOS configuration captured in xml
format from a PowerEdge 12G for large scale 12G deployment
configurations using RACADM or WS-MAN. For more information on using
RACADM and WS-MAN refer
RACADM Command Line Reference Guide
for iDRAC7 and CMC
and
Dell Lifecycle Controller-Remote Services Quick
Start Guide
respectively available at dell.com/support/manuals.
-l or --logfile
Option -l or --logfile
Sub-Options NA
Valid Arguments <
filename
>
Description Logs the command line output to a time-stamped file. The utility either appends
the information to an existing log file or creates a new file. The log file contains
the same information as the standard output, plus timestamp information. Users
should use this option instead of redirection for task diagnosis. For more
information, see Log Files .
Example:
A:>syscfg -l logfile --option=<filename>
-o or --outfile
Options -o or --outfile
Sub-Options NA
Valid Arguments <
filename
>
Description Prints all replicable options to the specified filename. The format of the output
is in the .ini format, with the utility name as the section header. On PowerEdge
11G systems, if a file with the same name already exists, the information is
appended to the file, but on PowerEdge 12G it overwrites the existing file. If this
option is used with other function commands, the commands are applied in the
order in which they appear. This option captures replicable BMC and BIOS
options.
Example:
A:>syscfg -o <filename>.ini
22
--ox or --outxmlfile
Options --ox or --outxmlfile
Sub-Options NA
Valid Arguments <
filename
>
Description Prints all BIOS options to the specified xml file.
NOTE: It is applicable only on 12G and later sytems.
Example:
A:>syscfg --ox filename.ini
--px or --pendingxmlfile
Options --px or --pendingxmlfile
Sub-Options NA
Valid Arguments <
filename
>
Description Prints all the pending BIOS options to a specified xml file.
NOTE: It is applicable only on 12G and later sytems.
Example:
A:>syscfg --px filename.xml
-s
Options -s
Sub-Options NA
Valid Arguments <
string
>
Description Prints the variable name and the assigned value to the console. This option
when used with --envar, picks up the environment variable data and stores it in
a file. This file can be called from a script. For more information, see --envar.
Example:
A:>syscfg -s ENVNAME --svctag
svctag=SERVICE
ENVNAME=SERVICE
23
--version*
Options --version*
Sub-Options NA
Valid Arguments NA
Description Displays the version information, current time, and date for the utility. This
option cannot be replicated.
Example:
A:>syscfg --version syscfg Version 4.2 P01(Windows
- Oct 21 2012,16:48:48)
Copyright (c) 2002-2012 Dell Inc.
SYSCFG For BIOS Configuration
SYSCFG uses BIOS interfaces to manipulate boot order and BIOS settings. It configures all options available on the BIOS
setup screen, including boot order, embedded device configuration, and asset tag management.
SYSCFG Options On PowerEdge Systems Prior To PowerEdge 12G Systems
The following are the valid options and arguments supported on PowerEdge systems earlier than PowerEdge 12G
systems. Options and arguments are case-sensitive. All options and pre-defined arguments are lowercase unless stated
otherwise. Running SYSCFG without arguments only displays the valid options. Some of the following options or
arguments may not be available on all systems due to the BIOS version or hardware feature set.
NOTE: If you have modified tpm or tcm option, reboot the system for the options to take effect.
--acpower
Option --acpower
Valid Arguments on, off, last
Description Sets the behavior for the system after AC power is lost. This option specifies
how the system responds to the restoration of AC power and is particularly
useful in systems that are turned off using a power strip. When set to on, the
system turns on after AC is restored. When set to off, the system does not turn
on after AC is restored. When set to last, the system turns on if the system was
on when AC power was lost; if the system was off when AC power was lost, the
system remains off when power is restored. This option can be replicated.
Example:
A:>syscfg --acpower=on
acpower=on
Applicable Systems All Dell PowerEdge systems prior to PowerEdge 12G systems.
24
--adjcacheprefetch
Option --adjcacheprefetch
Valid Arguments enable, disable
Description When this option is set to enable, the processor fetches the cache line
containing the currently requested data, and the adjacent cache line. When
this option is set to disable, the processor fetches only the cache line
containing the currently requested data.
Example:
A:>syscfg --adjcacheprefetch=enable
adjcacheprefetch=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--asset
Option --asset
Valid Arguments <
string
>
Description Reports or sets the customer-programmable asset tag number for a system.
The maximum length of an asset tag is 10 characters. Asset tag values cannot
contain any spaces. For more information on delimiters, see Command Line
Option Delimiters. This value can be replicated.
Example:
A:>syscfg --asset=<ASSETTAG>
asset=ASSETTAG
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems except Blade
systems.
--assignintr
Option --assignintr
Valid Arguments standard, distributed
Description Controls the interrupt assignment of PCI devices in the system. This option is
set to standardby default, causing standard interrupt routing that uses interrupt
A, B, C, and D for all PCIe devices. When set to distributed, the interrupt routing
is swizzled at the MCH root ports to minimize sharing of interrupts across all
PCIe (and PCI-X in the Programmable Interrupt Controller (PIC) mode) devices.
Example:
A:>syscfg --assignintr=standard
assignintr=standard
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
25
--bezelir
Option --bezelir
Valid Arguments enable, disable
Description Enables or disables the ESM to monitor and log front bezel intrusion conditions.
Example:
A:>syscfg --bezelir=enable
bezelir=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems
--bootmode
Option --bootmode
Valid Arguments uefi, bios
Description Allows booting to Unified Extensible Firmware Interface (UEFI) -capable
operating systems or ensures compatibility with operating systems that do not
support UEFI.
Example:
A:>syscfg --bootmode=uefi
bootmode=uefi
Applicable Systems PowerEdge 11G systems
--bootseq
Option --bootseq
Valid Arguments numerical list separated by commas or list of device names separated by
commas
Description Enables, disables, and orders the devices in a boot order list. Only the devices
present on the system are listed in the bootseq.
Without an argument, this option prints the boot order list. The argument must
be formatted as a comma-separated numerical list with no spaces. The list
must be within the bounds of the current boot list, that is, the low and high
numbers must match, and the same number of entries must be supplied.
Systems that use a numerical list for boot order cannot be replicated.
Some systems also allow the boot order to be expressed as a list of device
names. Device names are formatted as a
name.location.instance
string, where
name
is the name of the device,
location
is either slot or embedded (emb), and
instance
is the numerical position of the device. Some device name examples
are shown below. Systems that support a list of device names for boot order
can be replicated.
26
Numerical Lists Examples:
A:>syscfg --bootseq= 2,3,4,5,1,6
The following devices are set in the boot sequence:
Device 2:* usbcdrom.slot.1- USB CD-ROM device
Device 3:* virtualcd.slot.1 – VIRTUAL CDROM
Device 4:* hdd.emb.0 -Hard drive C:
Device 5:* nic.emb.1 - MBA v2.5.12 Slot 0500
Device 1:* virtualfloppy.slot.1 - VIRTUAL FLOPPY
Device 6:* usbfloppy.slot.1 - USB Floppy device
NOTE: The asterisk indicates that the device is enabled in the BIOS.
Device Name Examples:
Example of device names:
nic.slot.1 (network adapter 1 in PCI slot)
nic.emb.1 (network adapter 1 on system board)
hdd.emb.0 (hard drive C:)
cdrom.emb.0 (CD drive)
Device Name Lists Examples
Example 1:
#syscfg --bootseq
The following devices are set in the boot sequence:
Device 2:* cdrom.emb.0 - IDE CD-ROM device
Device 3:* hdd.emb.0 - Hard drive C:
Device 5:* virtual.slot.1 - VIRTUALCDROM DRIVE
Device 1:* floppy.emb.0 - Diskette drive A:1226
Device 6:* virtual.slot.2 - VIRTUALFLOPPY DRIVE
Device 4:* nic.emb.1 - IBA GE Slot 0638 v1226
Example 2:
#syscfg --bootseq=nic.emb.1,virtual.slot.1
The following devices are set in the boot sequence:
Device 4:* nic.emb.1 - IBA GE Slot 0638 v
Device 5:* virtual.slot.1 - VIRTUALCDROM DRIVE
Device 2: cdrom.emb.0 - IDE CD-ROM device
Device 3: hdd.emb.0 - Hard drive C:
Device 1: floppy.emb.0 - Diskette drive A:
NOTE: The asterisk indicates that the device is enabled in the BIOS.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
27
--bootseqretry
Option --bootseqretry
Valid Arguments enable, disable
Description Enables or disables the boot sequence retry feature. When set to enable, the
system re-attempts to set the boot order after a 30-second time-out if the last
boot attempt has failed. This option can be replicated.
A:>syscfg --bootseqretry=enable
bootseqretry=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--cmosdefaults
Option --cmosdefaults
Valid Arguments enable, disable
Description Enables or disables the request for a default CMOS value during the next
reboot.
A:>syscfg --cmosdefaults=enable
cmosdefaults=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--conboot
Option --conboot
Valid Arguments enable, disable
Description Enables or disables configuring or reporting of console redirection after reboot.
This option is available on all supported systems that support console
redirection. This option can be replicated.
Example:
A:>syscfg --conboot=enable
conboot=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12Gsystems.
--conred
Option --conred
Valid Arguments serial1, serial2, off, bmcsol, mmb
Description Configures or reports the communication port for console redirection. If this
option is set to serial port, then the serial port option is not available. If only one
serial port is present on a system, the serial2 argument is not available. This
option can be replicated.
28
Example:
A:>syscfg --conred=serial1
conred=serial1
Applicable Systems All PowerEdge systems prior to PowerEdge
x9xx
(9G) systems.
--conterm
Option --conterm
Valid Arguments vt100, ansi
Description Configures or reports the terminal type for console redirection. This option is
available on all supported systems that support console redirection. This option
can be replicated.
Example:
A:>syscfg --conterm=vt100
conterm=vt100
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--coreperformanceboost
Option --coreperformanceboost
Valid Arguments enable, disable
Description Enables or disables the AMD Core Performance Boost feature. When enabled,
it allows higher performance power states if additional power is available to
the CPU. This option can be replicated.
Example:
A:>syscfg --coreperformanceboost=enable
coreperformanceboost=enable
Applicable Systems PowerEdge R715, R815, R515, R415, and M915 systems with AMD Opteron 6000
series processor
--cpucle
Option --cpucle
Valid Arguments enable, disable
Description Enables or disables C1-E. By default, it is enabled. This option can be
replicated.
Example:
A:>syscfg --cpucle=enable
cpucle=enable
Applicable Systems PowerEdge 11G systems
29
--cpucore
Option --cpucore
Valid Arguments 1, 2, 4, 6, 8, 10, 12, 14, 16, all
Description Controls the number of enabled cores in each processor. The default value is
set to the maximum number of cores per processor. The number of cores
depends on the processor. Reading the cpucore that is set to the highest value
of number of cores displays as all.
For example, if 6-core CPU is installed, after setting to the highest value, 6,
when you read the cpucore, it displays as all.
Example:
A:>syscfg --cpucore=1
cpucore=1
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--cpuxdsupport
Option --cpuxdsupport
Valid Arguments enable, disable
Description Enables or disables the execute disable (XD) feature of the CPU.
Example:
A:>syscfg --cpuxdsupport=enable
cpuxdsupport=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems running on Intel
processors.
--cstates
Option --cstates
Valid Arguments enable, disable
Description Enables or disables the power c states of the processor.
A:>syscfg --cstates=enable
cstates=enable
Applicable Systems PowerEdge 11G systems
--datareuse
Option --datareuse
Valid Arguments enable, disable
30
Description Enables or disables data reuse. Set to enable for High Performance Computing
(HPC) applications. Set to disable for energy efficiency. This option can be
replicated.
A:>syscfg --datareuse=enable
datareuse=enable
Applicable Systems PowerEdge 11G systems
--dbpm
Option --dbpm
Valid Arguments enable, disable
Description Enables or disables demand-based power management. This option can be
replicated.
Example:
A:>syscfg --dbpm=enable
dbpm=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--dcustreamerprefetcher
Option --dcustreamerprefetcher
Valid Arguments enable, disable
Description Enables or disables DCU Streamer Prefetcher. This option can be replicated.
Example:
A:>syscfg --dcustreamerprefetcher=enable
dcustreamerprefetcher=enable
Applicable Systems PowerEdge 11G systems
--devseq
Option --devseq
Valid Arguments numerical list separated by commas or list of device names separated by
commas
Description Sets the hard-drive sequence for a system. Without an argument, this option
displays the device list. The argument must be formatted as a 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.
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.
31
Example 1:
A:>syscfg --devseq
The following devices are set in the disk device
sequence:
Device 1:* hdd.emb.0 - System BIOS boot devices
Device 2:* scsiraid.slot.3 - PERC 5/E Adapter(bus
02 dev 02)
Device 3:* usbkey.slot.0 - Hard-disk-emulated USB
flash drive
Example 2:
A:>syscfg --devseq= hdd.emb.1,scsiraid.emb.1
The following devices are set in the disk device
sequence:
Device 1:* hdd.emb.0 - System BIOS boot devices
Device 2:* scsiraid.emb.1 - AIC-7899, A:00 Seagate
NOTE: The asterisk indicates that the device is enabled in the BIOS.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embhypervisor
Option --embhypervisor
Valid Arguments off, on
Description Turns on or off the embedded hypervisor port.
Example:
A:>syscfg --embhypervisor=on
embhypervisor=on
Applicable Systems All PowerEdge systems prior to PowerEdge yx2x systems
--embideraid
Option --embideraid
Valid Arguments on, off
Description Turns on or off the embedded IDE RAID controller. This option is only valid for
supported systems that have IDE ROMB. This option can be replicated.
Example:
A:>syscfg --embideraid=on
embideraid=on
Applicable Systems All PowerEdge systems prior to PowerEdge yx2x systems
32
--embnic1
Option --embnic1
Valid Arguments on, off, onnopxe, onwithiscsi
Description Turns the first embedded NIC on with PXE on, off, or on without PXE enabled.
This option is only valid for supported systems that have a NIC. If the NIC is
enabled without PXE, it is not found in the boot order. If the NIC is turned on
with PXE, it is placed at the end of the boot order. The onnopxe argument is not
supported on all systems.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic1 option can be replicated.
Example:
A:>syscfg --embnic1=onnopxe
embnic1=onnopxe
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embnic2
Option --embnic2
Valid Arguments on, off, onnopxe, onwithiscsi
Description Turns the second embedded NIC on with PXE enabled, off, or on without PXE
enabled. This option is only valid for supported systems that have two
embedded NICs. If the second NIC is enabled without PXE, it is not found in the
boot order. If the second NIC is turned on with PXE, it is placed at the end of
the boot order. The onnopxe argument is not supported on all systems. This
option can be replicated.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic2 option can be replicated.
Example:
A:>syscfg --embnic2=onnopxe
embnic2=onnopxe
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embnic3
Option --embnic3
Valid Arguments on, off, onnopxe, onwithiscsi
Description Turns the third embedded NIC on with PXE enabled, off, or on without PXE
enabled. This option is only valid for supported systems that have three
embedded NICs. If the third NIC is enabled without PXE, it is not found in the
boot order. If the third NIC is turned on with PXE, it is placed at the end of the
boot order. The onnopxe argument is not supported on all systems. This option
can be replicated.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic3 option can be replicated.
33
Example:
A:>syscfg --embnic3=onnopxe
embnic3=onnopxe
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embnic4
Option --embnic4
Valid Arguments on, off, onnopxe, onwithiscsi
Description Turns the fourth embedded NIC on with PXE enabled, off, or on without PXE
enabled. This option is only valid for supported systems that have four
embedded NICs. If the fourth NIC is enabled without PXE, it is not found in the
boot order. If the fourth NIC is turned on with PXE, it is placed at the end of the
boot order. The onnopxe argument is not supported on all systems. This option
can be replicated.
The onwithiscsi argument enables the embedded NIC to boot from the iSCSI
server. The embnic4 option can be replicated.
Example:
A:>syscfg --embnic4=onnopxe
embnic4=onnopxe
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embnic1nic2
Option --embnic1nic2
Valid Arguments enable, disable
Description Enables or disables the operating system interface of the first and second
embedded NIC controllers.
Example:
A:>syscfg --embnic1nic2=enable
--embnic1nic2=enable
Applicable Systems PowerEdge 1855, PowerEdge 6850, and PowerEdge 11G systems
--embnic3nic4
Option --embnic3nic4
Valid Arguments enable, disable
Description Enables or disables the operating system interface of the third and fourth
embedded NIC controllers.
Example:
A:>syscfg --embnic3nic4=enable
--embnic3nic4=enable
Applicable Systems PowerEdge yx1x systems
34
--embnics
Option --embnics
Valid Arguments enable, disable
Description Turns both the embedded NICs on or off. This option is only present on systems
that do not support the embnic1 and embnic2 options. This option can be
replicated.
Example:
A:>syscfg --embnics=enable
--embnics=enable
Applicable Systems All PowerEdge systems prior to PowerEdge yx2x systems
--embnic1pxe
Option --embnic1pxe
Valid Arguments enable, disable
Description Enables or disables Preboot Execution Environment (PXE) on the first
embedded NIC. If PXE is disabled, the first NIC is not found in the boot order. If
PXE is enabled, the first NIC is placed at the end of the boot order. This option
is only present on systems that do not support the embnic1 option. This option
can be replicated.
Example:
A:>syscfg --embnic1pxe=enable
embnic1pxe=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embnic2pxe
Option --embnic2pxe
Valid Arguments enable, disable
Description Enables or disables Preboot Execution Environment (PXE) on the second
embedded NIC. If PXE is disabled, the second NIC is not found in the boot
order. If PXE is enabled, the second NIC is placed at the end of the boot order.
This option is only present on systems that do not support the embnic2 option.
This option can be replicated.
Example:
A:>syscfg --embnic2pxe=enable
embnic2pxe=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embsataraid
Option --embsataraid
Valid Arguments off, combined, ata, ahci, raid, qdma
35
Description Configures an embedded SATA RAID controller. This option can be replicated.
•off — disables the embedded SATA RAID controller.
•combined — sets the SATA RAID controller to combined mode.
•ata — sets SATA RAID controller to ATA mode.
•ahci — sets ATA RAID controller to ahci mode.
•raid — sets SATA RAID controller to RAID mode.
•qdma — sets the SATA RAID controller to support ATAPI devices at
transfer rates much higher than PIO. A device driver must be installed
on your system to use the QDMA mode.
Example:
A:>syscfg --embsataraid=off
embsataraid=off
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embscsi1
Option --embscsi1
Valid Arguments on, off
Description Turns the first embedded SCSI controller. This option is only valid for supported
systems that have an embedded SCSI controller. This option can be replicated.
Example:
A:>syscfg --embscsi1=on
embscsi1=on
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embscsi2
Option --embscsi2
Valid Arguments on, off
Description Turns the second embedded SCSI controller. This option is only valid for
supported systems that have an embedded SCSI controller. This option can be
replicated.
Example:
A:>syscfg --embscsi2=on
embscsi2=on
Applicable Systems All PowerEdge systems prior to PowerEdge yx2x systems
--embscsiraid
Option --embscsiraid
Valid Arguments raid, off, scsi
Description Sets the specified value for the SCSI RAID controller. This option is only valid
for supported systems that have SCSI ROMB. Some systems do not support the
scsi argument. This option can be replicated.
36
CAUTION: If you change the controller from SCSI to RAID mode, data loss
may occur. Backup any data you must save before changing modes.
Example:
A:>syscfg --embscsiraid=raid
embscsiraid=raid
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embscsiraidchb
Option --embscsiraidchb
Valid Arguments raid, scsi
Description Sets the second channel on an embedded RAID controller to SCSI or RAID.
This option is only valid for systems that support RAID/RAID and RAID/SCSI
settings for channels A and B. This option can be replicated.
Example:
A:>syscfg --embscsiraidchb=raid
embscsiraidchb=raid
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--embsdcardredundancy
Option --embsdcardredundancy
Valid Arguments mirrormode, disable
Description Sets the redundancy to mirrormode or disabled.
If set to mirrormode, read-write operation occurs on both the secure digital
(SD) cards. If one of the SD cards fails and is replaced, on booting, the data is
copied to that SD card.
If set to disable, read-write operation occurs only on SD card 1.
On Blade systems, disable the vflash key to configure this option.
Example:
A:>syscfg --embsdcardredundancy=mirrormode
embsdcardredundancy=mirrormode
Applicable Systems PowerEdge R810, R815, R910, and M910 systems
--extserial
Option --extserial
Valid Arguments com1, com2, rad
Description Sets the behavior of the external serial connector. When set to com1 , the BIOS
maps the external serial connector to COM port 1. The com1 setting is the
default.
When set to com2 , the external serial connector is routed to the COM2
interface. Terminal escape sequences can toggle the external connector
between the system (COM2) and the remote access device.
37
When set to rad , the external serial connector is routed to the remote access
device interface. Terminal escape sequences can toggle the external
connector between the system (COM2) and the remote access device.
This option can be replicated.
Example:
A:>syscfg --extserial=com1
extserial=com1
The --serialcomm option can be used with the external serial (--extserial)
option instead of the --conred (available on systems earlier than PowerEdge 9G
systems) option.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems except Blade
systems.
--embsdcard
Option --embsdcard
Valid Arguments off, on
Description Enables or disables the embedded SD card port.
Example:
A:>syscfg --embsdcard=off
embsdcard=off
Applicable Systems PowerEdge 11G systems
--embvideoctrl
Option --embvideoctrl
Valid Arguments enable, disable
Description Enables or disables the embedded video controller.
Example:
A:>syscfg --embvideoctrl=enable
embvideoctrl=enable
Applicable Systems PowerEdge 11G systems
--fiberchannel
Option --fiberchannel
Valid Arguments enable, disable
Description Enables or disables embedded fiber channel. This option can be replicated.
Example:
A:>syscfg --fiberchannel=enable
fiberchannel=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
38
--f1f2promptonerror
Option ––f1f2 prompt onerror
Valid Arguments enable, disable
Description Enables or disables the BIOS to prompt F1 or F2 error codes.
Example:
A:>syscfg --f1f2promptonerror=enable
f1f2promptonerror=enable
Applicable Systems PowerEdge 10G and later systems
--floppy
Option --floppy
Valid Arguments auto, off, readonly
Description Sets the diskette drive controller to auto, off, or readonly. This option is
available on all supported systems that have a supported diskette drive. This
option can be replicated
Example:
A:>syscfg --floppy=auto
floppy=auto
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--formfactor
Option ––formfactor
Valid Arguments halfheight, halfheight, dualwide, fullheight, fullheight, dualwide
Description Displays the geometry of PowerEdge Blade systems. This is a read-only option
and can have the following values: halfheight (the Blade systems occupies 1
slot of the chassis), halfheight, dualwide (the Blade system occupies 2
horizontal slots of the chassis), fullheight (the Blade system occupies 2 vertical
slots of the chassis), and fullheight, dualwide (the Blade system occupies 4
slots of the chassis).
Example:
A:>syscfg --formfactor=fullheight, dualwide
formfactor=fullheight, dualwide
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--fsbr
Option --fsbr
Valid Arguments 115200, 57600, 19200, 9600
Description Sets the console redirection fail safe baud rate in bps.
39
Example:
A:>syscfg --fsbr=9600
fsbr=9600
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--hddfailover
Option --hddfailover
Valid Arguments off, on
Descriptionoff Specifies the device in the Hard Disk Drive Sequence menu that has not been
attempted in the boot sequence. When set to on, all devices are attempted in
an order in which they are configured. When set to off, only the first device in
the hard disk sequence is attempted. This option can be replicated.
Example:
A:>syscfg --hddfailover=on
hddfailover=on
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--hpcmode
Option --hpcmode
Valid Arguments enable, disable
Description Enables or disables the High Performance Computing (HPC) Mode. When set to
enable, the HPC is enabled utilizing only the high frequency P-State settings.
When set to disable (default value), all P-States inherent to the CPU are used.
To fully enable HPC Mode, set the power management to custom, cpu power
and performance management to OsDbpm, and fan power and performance
management to maximum performance.
Example:
A:>syscfg --hpcmode=enable
hpcmode=enable
Applicable Systems PowerEdge R715, R815, and M915 with AMD Opteron 6200 series processor
--htassist
Option --htassist
Valid Arguments enable, disable
Description Enables or disables the Probe Filter chipset option. Some applications may
have lower performance when the chipset feature is disabled.
Example:
A:>syscfg --htassist=enable
htassist=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems with AMD Opteron
processors.
40
--hwprefetcher
Option --hwprefetcher
Valid Arguments enable, disable
Description Processor preempts what data might be needed next, when set to enable.
When some data is found, it loads several steps in advance.
Processor does not preempt, when set to disable.
This option can be replicated.
Example:
A:>syscfg --hwprefetcher=enable
hwprefetcher=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--idecdrom
Option --idecdrom
Valid Arguments auto, off
Description Turns the CD drive on or off. This option can be replicated.
Example:
A:>syscfg --idecdrom=auto
idecdrom=auto
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--idracgui
Option --idracgui
Valid Arguments enable, disable
Description Enables and disables the iDRAC GUI. This option can be replicated.
Example:
A:>syscfg --idracgui=disable
idracgui=disable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--integratedraid
Option --integratedraid
Valid Arguments enable, disable
Description Enables or disables the integrated RAID controller. This option can be
replicated.
Example:
A:>syscfg --integratedraid=disable
integratedraid=disable
41
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--integratedsas
Option --integratedsas
Valid Arguments enable, disable
Description Enables or disables the integrated SAS controller. This option can be
replicated.
Example:
A:>syscfg --integratedsas=enable
integratedsas=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--inteltxt
Option --inteltxt
Valid Arguments enable, disable
Description Enables or disables the Intel TXT option. This option can be replicated.
Example:
A:>syscfg --inteltxt=enable
inteltxt=enable
NOTE: To enable the Intel TXT option in a supported processor, make sure
that the:
• Virtualization technology in Processor setting is enabled.
• TPM module is installed and initialed as OK by BIOS.
• TPM security in System security is set to on with pre-boot
measurements.
• User password is not set.
Applicable Systems All PowerEdge 11G systems with Intel processors.
--internalusb
Option --internalusb
Valid Arguments off, on
Description Turns on or off all the user-accessible USB ports. This option can be replicated.
Example:
A:>syscfg --internalusb=on
internalusb=on
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
42
--ioat
Option --ioat
Valid Arguments enable, disable
Description Enables or disables the I/O Acceleration Technology (I/OAT) DMA Engine
option. This option must be enabled only if the hardware and software support
I/OAT on your system. This option can be replicated.
Example:
A:>syscfg --ioat=enable
ioat=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--lcd
Option --lcd
Valid Arguments default, none, user, idracipv4address, idracmacaddress, ossystemname,
servicetag, ipv6address, ambienttemp, systemwatts
Description Displays the default string (model name and number for PowerEdge systems
earlier than Dell PowerEdge 11G, and service tag for PowerEdge systems 11G
and later) or a userdefined string on the front-panel LCD based on the specified
argument. This option can be replicated.
Example:
A:>syscfg --lcd=default
lcd=default
Applicable Systems PowerEdge 11G systems
--lcd1
Option --lcd1
Valid Arguments <
string
>
Description Sets the first line of user-defined text on the system LCD. This option can be
replicated. For more information on delimiters, see Command Line Option
Delimiters.
NOTE: Before setting user strings for --lcd1 , ensure that --lcd is set
to user.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--lcd2
Option --lcd2
Valid Arguments <
string
>
Description Sets the second line of user-defined text on the system LCD. This option can be
replicated. For more information on delimiters, see Command Line Option
Delimiters.
43
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--logicproc
Option --logicproc
Valid Arguments enable, disable
Description Enables or disables logical processing for a system. This option is available on
all systems that support logical processing (Hyperthreading).
This option can be replicated.
Example:
A:>syscfg --logicproc=enable
logicproc=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--lpt
Option --lpt
Valid Arguments lpt1, lpt2, lpt3, disable
Description Configures or reports the I/O address of the LPT (parallel) port. This option is
available on all supported systems with an LPT port. This option is recorded to
an output file for replication.
Example:
A:>syscfg --lpt=lpt1
lpt=lpt1
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
-memdynamicpower
Option --memdynamicpower
Valid Arguments enable, disable
Description Enables or disables the dynamic memory power states. This option can be
replicated.
Example:
A:>syscfg --memdynamicpower=enable
memdynamicpower=enable
Applicable Systems PowerEdge R910 system with Intel Xeon 7500 series
--memintleave
Option --memintleave
Valid Arguments enable, disable
Description Enables or disables the memory interleave mode. This option can be replicated.
44
Example:
A:>syscfg --memintleave=enable
memintleave=enable
NOTE: The memintleave option is same as Nodeinterleave option. For more
information, see Memory Settings group.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--memoperatingmode
Option --memoperatingmode
Valid Arguments optimizer, mirror, advancedecc
Description Selects the memory operating mode. This feature is active only if a valid
memory configuration is detected.
Example:
A:>syscfg --memoperatingmode=optimizer
memoperatingmode=optimizer
Applicable Systems PowerEdge 11G systems
--memprefailurenotify
Option --memprefailurenotify
Valid Arguments enable, disable
Description Enables or disables the Correctable ECC SMIs. When enabled, the SMIs report
the Correctable ECC errors.
This option can be replicated.
Example:
A:>syscfg --memprefailurenotify=enable
memprefailurenotify=enable
Applicable Systems PowerEdge R710, R610, and T610 systems with Intel Xeon processor
--memremap
Option --memremap
Valid Arguments off, auto
Description Sets the memory remapping to off or auto.
Example:
A:>syscfg --memremap=off
memremap=off
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
45
--memtest
Option --memtest
Valid Arguments enable, disable
Description Enables or disables the POST extended memory test.
Example:
A:>syscfg --memtest=disable
memtest=disable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--mouse
Option --mouse
Valid Arguments on, off
Description Turns the mouse controller on or off.
This option can be replicated.
Example:
A:>syscfg --mouse=off
mouse=off
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--nextboot
Option --nextboot
Valid Arguments
<valid device name
> (from the bootseq option device list)
Description Sets the specified device as the first device in the boot order for the next boot
cycle only. The device must be a device from the bootseq option device list.
Run the bootseq option to see a list of available device names. For more
information, see --bootmode . This option is not replicated.
Example 1:
A:>syscfg --bootseq
Device 1: floppy.emb.0 -Diskette Drive A:
Device 2: cdrom.emb.0 -CD-ROM device
Device 3: hdd.emb.0 - HardDrive C:
Device 4: nic.emb.1 -Intel Boot Agent Version 4.0.17
Device 5: nic.emb.2 -Intel Boot Agent Version 4.0.17
Example 2:
A:>syscfg --nextboot=nic.emb.1
nextboot=nic.emb.1
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
46
-noraidprompt*
Option --noraidprompt*
NOTE: The asterisk is not part of the command syntax.
Valid Arguments NA
Description Specifies that the BIOS must not prompt for confirmation when changing the
mode of a RAID controller. This option can only be used with the --embscsiraid
or --embscsiraidchb options.
Without this option, the user is prompted during POST to confirm the change of
a RAID controller from RAID (SCSI) to SCSI (RAID). This option is not replicated.
CAUTION: When changing a RAID controller from SCSI to RAID or from
RAID to SCSI, data is lost on the affected hard drives. The warning
message for this data is not displayed if you use the --noraidprompt option.
To avoid data loss, back up any information on the hard drives before
changing the type of controller used with the drives
Example:
A:>syscfg --embscsiraid=raid --noraidprompt
embscsiraid=raid
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--numlock
Option --numlock
Valid Arguments on, off
Description Turns the keyboard number lock on or off during POST. This option is not
replicated.
Example:
A:>syscfg --numlock=on
numlock=on
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--oldsetuppwd
Option --oldsetuppwd
Valid Arguments <
string
>
Description Allows to set a new setup password if a setup password is already present on
the system. The setup password locks the BIOS setup screen. The argument
string supplied to this option is the current password. If this password is not
correct, the new setup password is not applied to the system. Generally,
passwords are limited to alphanumeric characters and cannot exceed 32
characters in length. This option is not replicated. For more information on
delimiters, see Command Line Option Delimiters.
47
Example:
A:>syscfg --setuppwd=asetuppassword --
oldsetuppwd=currentpassword
The password has been set.Please use a warm reboot
to apply the password to the system.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--oldsyspwd
Option --oldsyspwd
Valid Arguments <
string
>
Description Supplies the current system password for the BIOS. This option is only given
when setting the new system password. If this password does not match the
current system password, the new password is not applied to the system. The
system password is required when booting the system. The argument string
supplied to this option is the password. Generally, passwords are limited to
alphanumeric characters and cannot exceed 32 characters in length. This
option is not replicated. For more information on delimiters see Command Line
Option Delimiters.
Example1:
A:>syscfg --syspwd=anotherpassword --
oldsyspwd=password
The password has been set.Please use a warm reboot
to apply the password to the system.
Example 2:
A:>syscfg --syspwd=asyspassword --
oldsyspwd=currentpassword
The old password entered is incorrect. The new
password will not be set. Please try again.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--opticaldrivectrl
Option --opticaldrivectrl
Valid Arguments enable, disable
Description Enables or disables the optical CD-ROM controller.
Example:
A:>syscfg --opticaldrivectrl=enable
opticaldrivectrl=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--oswatchdogtimer
Option --oswatchdogtimer
Valid Arguments enable, disable
48
Description Aids in the recovery of the operating system when the system stops
responding. When this option is set to enable, the operating system is allowed
to initialize the timer. When set to disable (the default), the timer has no effect
on the system.
Example:
A:>syscfg --oswatchdogtimer=enable
oswatchdogtimer=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--ovrwrt*
Option --ovrwrt*
NOTE: The asterisk is not part of the command syntax.
Valid Arguments NA
Description Used with the -o option to cause the output file to be overwritten if a file of the
same name already exists. This option cannot be replicated.
Example:
A:>syscfg -o=filename.ini --ovrwrt
The file filename has been overwritten.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
power
Option power
Valid Arguments NA
Description For details about the power suboptions and arguments, see Sub Options For
Power Option.
Applicable Systems PowerEdge 11G systems
--powerbutton
Option --powerbutton
Valid Arguments enable, disable
Description Enables or disables the power button for a system. This option is recorded to
an output file for replication.
Example:
A:>syscfg --powerbutton=enable
powerbutton=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
49
--qpibandwidthpriority
Option --qpibandwidthpriority
Valid Arguments compute, io
Description Sets the bandwidth priority to compute or io. Set to compute for computation-
intensive applications. Set to io for I/O intensive applications. This option can
be replicated.
Example:
A:>syscfg --qpibandwidthpriority=compute
qpibandwidthpriority=compute
Applicable Systems Dell PowerEdge 11G systems
--redmem
Option --redmem
Valid Arguments off, spare, mirror, DDDC
Description Allows selection of the required redundant memory mode, or disables
redundant memory. This option can be replicated.
Example:
A:>syscfg --redmem=off
redmem=off
Applicable Systems PowerEdge M910, R910, and R810 systems with Intel Xeon 7500 series
processor.
--remflashmedia
Option --remflashmedia
Valid Arguments read-only
Description Displays the redundancy status of internal dual SD module. The status can be:
• Full — Secure digital card (SD) 1 and 2 are functioning properly.
• Lost — Either any of the secure digital cards or both are not
functioning properly.
The option also displays the status of the individual SD cards as follows:
• Active — The card is used for secure digital reads.
• Standby — The card is receiving a copy of all secure digital reads.
• Failed — An error is reported during a secure digital read or write.
• Absent — No secure digital media is detected.
• Offline — At boot, card identification signature is different from the
non-volatile storage value or card is the destination of a copying
operation that is in progress.
• Write Protected — The card is write-protected.
50
Example:
A:>syscfg --remflashmedia
Internal Dual SD ModuleRedundancy=Lost
SD1 status=Absent
SD1 status=Active
Applicable Systems PowerEdge R810, R815, R910, and M910 systems
--rptkeyerr
Option --rptkeyerr
Valid Arguments enable, disable
Description Enables or disables the BIOS to report keyboard errors during POST. This
option can be replicated.
Example:
A:>syscfg --rptkeyerr=disable
rptkeyerr=disable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata0
Option --sata0
Valid Arguments auto, off
Description Turns the SATA port 0 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata0=auto
sata0=auto
NOTE: This option maps to --sata_a for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata1
Option --sata1
Valid Arguments auto, off
Description Turns the SATA port 1 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata1=auto
sata1=auto
NOTE: This option maps to --sata_b for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
51
--sata2
Option --sata2
Valid Arguments auto, off
Description Turns the SATA port 2 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata2=auto
sata2=auto
NOTE: This option maps to --sata_c for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata3
Option --sata3
Valid Arguments auto, off
Description Turns the SATA port 3 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata3=auto
sata3=auto
NOTE: This option maps to --sata_d for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata4
Option --sata4
Valid Arguments auto, off
Description Turns the SATA port 4 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata4=auto
sata4=auto
NOTE: This option maps to --sata_e for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata5
Option --sata5
Valid Arguments auto, off
Description Turns the SATA port 5 to auto or off. This option can be replicated.
52
Example:
A:>syscfg --sata5=auto
sata5=auto
NOTE: This option maps to --sata_f for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata6
Option --sata6
Valid Arguments auto, off
Description Turns the SATA port 6 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata6=auto
sata6=auto
NOTE: This option maps to --sata_g for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata7
Option --sata7
Valid Arguments auto, off
Description Turns the SATA port 7 to auto or off. This option can be replicated.
Example:
A:>syscfg --sata7=auto
sata7=auto
NOTE: This option maps to --sata_h for PowerEdge 9G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--snoopfilter
Option --snoopfilter
Valid Arguments enable, disable
Description Enables or disables the snoop filter option from the system BIOS.
Example:
A:>syscfg --snoopfilter=enable
snoopfilter=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
53
--serial1
Option --serial1
Valid Arguments disable, com1, com3, com1_bmc, bmcserial, bmclan, rac
Description Configures or reports the first serial port communication port. This option can
be replicated.
• bmcserial — maps serial port 1 to BMC Serial.
• bmclan — routes the serial traffic destined for serial1 out to NIC1.
• com1_bmc — maps serial port 1 to COM port 1 BMC.
• rac — maps serial port 1 to the RAC device.
Example:
A:>syscfg --serial1=rac
serial1=rac
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--serial2
Option --serial2
Valid Arguments auto, disable, com2, com4
Description Configures or reports the second serial port communication port. This option
can be replicated.
Example:
A:>syscfg --serial2=rac
serial2=rac
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--serialcomm
Option --serialcomm
Valid Arguments on, com1cr, com2cr, off
Description Sets the behavior of the serial port communication. When set to on, the BIOS
enables COM port 1 and COM port 2. These ports are made available for use by
the operating system or applications. BIOS Console Redirection is disabled.
When set to com1cr , BIOS enables COM port 1 and COM port 2. These ports
are made available for use by the operating system or applications. BIOS
Console Redirection is through COM port 1.
When set to com2cr , BIOS enables COM port 1 and COM port 2. These ports
are made available for use by the operating system or applications. BIOS
Console Redirection is through COM port 2.
When set to off , this option tells the BIOS to disable COM port 1 and COM port
2.
This option can be replicated.
54
Example:
A:>syscfg --serialcomm=on
serialcomm=on
The --serialcomm option can be used with the external serial (--extserial) option
instead of the --conred (available on systems earlier than PowerEdge 9G
systems) option.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--serialportaddrsel
Option --serialportaddrsel
Valid Arguments default, alternate
Description Sets the port address of the serial devices.
When this option is default, Serial Device 1 is set to COM port 1 and Serial
Device 2 is set to COM port 2.
When this option is alternate, Serial Device 1 is set to COM port 2 and Serial
Device 2 is set to COM port 1.
This option can be replicated.
Example:
A:>syscfg --serialportaddrsel=default
serialportaddrsel=default
Applicable Systems PowerEdge 11G systems
--setuppwd
Option --setuppwd
Valid Arguments <
string
>
Description Sets the setup password for the BIOS. The setup password locks the BIOS F2
screen. The argument string supplied to this option is the password. Passwords
are limited to alphanumeric characters and cannot exceed 32 characters in
length. If a current setup password is set, it must be given through the
oldsetuppwd option. This option is not replicated. For more information on
delimiters, see Command Line Option Delimiters .
Example:
A:>syscfg --setuppwd=asetuppassword
The password has been set. Please use a warm reboot
to apply the password to the system.
Example 2:
A:>syscfg --setuppwd=asetuppassword --
oldsetuppwd=currentpassword
The password has been set. Please use a warm reboot
to apply the password to the system.
Example 3:
A:>syscfg --setuppwd=asetuppassword --
oldsetuppwd=currentpassword
The old password entered is incorrect. The new
password will not be set. Please try again.
55
NOTE: You cannot disable your password using DTK. To disable your
password, you must use the system BIOS.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sma
Option --sma
Valid Arguments enable, disable
Description Enables or disables processor sequential memory access.
Example:
A:>syscfg --sma=disable
sma=disable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--slotname*
Option --slotname*
NOTE: The asterisk is not part of the command syntax.
Valid Arguments NA
Description Reports the slot name of the blade.
Example:
A:>syscfg --slotname
slotname=Slot5
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sriov
Option --sriov
Valid Arguments enable, disable
Description Enables or disables support for Single Root I/O Virtualization (SR-IOV) devices.
Example:
A:>syscfg --sriov=disable
sriov=disable
Applicable Systems PowerEdge R410, R510, R610, R710, R910, T410, T610, and T710 systems prior to
PowerEdge12G systems with Intel Xeon processor 7500/6500 series.
--svctag*
Option --svctag*
NOTE: The asterisk is not part of the command syntax.
Valid Arguments NA
56
Description Reports the service tag for a system. If used with the -s general option, the
environment variable is set to the service tag.
Example:
A:>syscfg --svctag
svctag=113CD1S
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems except Blade
systems.
--syspwd
Option --syspwd
Valid Arguments <
string
>
Description Sets the system password for the BIOS. The system password is required when
booting the system. The argument string supplied to this option is the password.
Generally, passwords are limited to alphanumeric characters and cannot
exceed 32 characters in length. If a current system password is set, it must be
given through the oldsyspwd option. This option is not replicated. For more
information on delimiters, see Command Line Option Delimiters .
Example 1:
A:>syscfg --syspwd=password
The password has been set. Please use a warm reboot
to apply the password to the system.
Example 2:
A:>syscfg --syspwd=password --oldsyspwd=password
The password has been set. Please use a warm reboot
to apply the password to the system
.
NOTE: You cannot disable your password using DTK. To disable your
password, you must use the system BIOS.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sysrev
Option --sysrev
Valid Arguments NA
Description Reports the system revision. This is a read-only option.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
tpm
Option tpm
Valid Arguments NA
Description For details about the tpm suboptions and arguments, see Sub Options For tpm
Option.
Applicable Systems PowerEdge 10G and 11G systems
57
--turbomode
Option --turbomode
Valid Arguments enable, disable
Description Enables or disables core-based turbo mode. Turbo mode is a feature on Intel
processors that allows one processor core to increase the frequency by one
bin whenever the other core has gone into an idle state.
Example:
A:>syscfg --turbomode=disable
--turbomode=enable
Applicable Systems PowerEdge 11G systems running on Intel processors
--usb
Option --usb
Valid Arguments on, legacy, off
Description Sets or reports the status of the USB port. When set to on, USB keyboards and
mice function only for systems with operating systems that have native USB
support. When set to legacy, USB keyboards and mice are supported through
the BIOS to function in operating systems that do not natively support USB .
This option can be replicated.
Example:
A:>syscfg --usb=on
usb=on
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--usbflash
Option --usbflash
Valid Arguments auto, fdd, hdd
Description Sets or reports the emulation for a USB flash device. The USB flash device can
be set to emulate a hard drive (HDD) or a diskette drive (FDD). This option can
be replicated.
Example:
A:>syscfg --usbflash=auto
usbflash=auto
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--usbports
Option --usbports
Valid Arguments enable, enablebackonly, disable
Description Enables or disables USB ports. When set to enable, it enables all user
accessible USB ports. When set to enablebackonly, the front user-accessible
58
ports are disabled. When set to disable, both front and back user accessible
ports are disabled. This option can be replicated.
Example:
A:>syscfg --usbports=enable
usbports=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--virtualization
Option --virtualization
Valid Arguments enable, disable
Description Enables or disables virtualization in the CPU. When set to enable, it enables the
additional hardware capabilities provided by Virtualization Technology in
applicable CPUs.
When set to disable, it disables the additional hardware capabilities provided
by Virtualization Technology.
This option can be replicated.
Example:
A:>syscfg --virtualization=enable
virtualization=enable
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--vflash
Option --vflash
Valid Arguments enable, disable
Description Enables or disables vflash on iDRAC.
Example:
A:>syscfg --vflash=enable
vflash=enable
Applicable Systems All PowerEdge 11G systems or systems with iDRAC6
Sub Options And Arguments For tpm Option
The following table lists the sub-options and arguments for the tpm option.
Table 6. Sub-options and Arguments for the tpm Option
Option Sub-option Arguments Description
tpm --tpmsecurity off Does not report the presence of TPM to the
operating system.
onwithpbm Directs the BIOS to store the TCG compliant
measurements to the TPM during a POST
operation.
59
Option Sub-option Arguments Description
onwithoutpbm Directs the BIOS to bypass the preboot
measurements.
Example:
A:>syscfg tpm --
tpmsecurity=onwithoutpbm
--setuppwdoverride
--
tpmactivation enabled Enables and activates the TPM feature.
disabled Disables and deactivates the TPM feature.
nochange Does not alter the operational state of the TPM
feature.
Example:
A:>syscfg tpm --
tpmactivation=enabled --
setuppwdoverride
NOTE: You cannot set tpmactivation when
tpmsecurity is set to off.
NOTE: After setting tpmactivation to enabled or
disabled, if you reboot your system, DTK
displays the TPM Configuration
Honoured system will reset and
the system reboots again message
and reboots.
NOTE: When you set tpmactivation to enabled
or disabled, DTK displays the value of
tpmactivation as nochange. However, the TPM
feature is activated/deactivated when you
reboot the system.
--tpmclear 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 Cancels the result of the tpmclear setting. If you
specify this setting before specifying the tpmclear
setting, the There is currently no
pending TPM Clear request message is
displayed.
Example:
A:>syscfg tpm --
tpmactivation=enabled --
undotpmclear --setuppwdoverride
--valsetuppwd <
string
>Validates the setup password for TPM
authentication. If you try to change DTK settings,
you are prompted to enter this password to access
60
Option Sub-option Arguments Description
the settings. For more information on delimiters, see
Command Line Option Delimiters.
Example:
A:>syscfg tpm --
tpmactivation=enabled --tpmclear
--valsetuppwd=<setup_password>
--
setuppwdoverri
de
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
Sub Options And Arguments For tcm Option
Table 7. Sub-options and Arguments for the tcm Option
Option Sub-option Arguments Description
tcm --tcmsecurity off Does not report the presence of TCM to the
operating system.
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 Cancels the result of the tcmclear setting.
Example:
A:>syscfg tcm --
tcmactivation=enabled --
tcmundoclear --setuppwdoverride
61
Sub Options And Arguments For power Option
Table 8. Sub-options and Arguments for the power Option
Option Sub-option Arguments Description
power --profile <
powerprofile
>
where
powerprofile
can be
maxperformance,
osctl, apc
Displays the settings similar to the BIOS setup
screen for the respective profile. Reboot the system
for the settings to take effect.
If power profiles are not available on the platform,
an error message is displayed.
A:>syscfg power--
profile=maxperformance --
setuppwdoverride
custom Creates the custom profile. Reboot the system for
the settings to take effect.
A:>syscfg power --profile=custom
--setuppwdoverride
--cpupowermode min, max, osdbpm,
systemdbpm
Allows you to set the CPU power and performance
management to minimum power, maximum
performance, operating system DBPM, or system
DBPM mode.
Example:
A:>syscfg power --profile=custom
--cpupowermode=min --
setuppwdoverride
--
memorypowermod
e
min, 978, 800, 1067,
1333, max
Allows you to set memory power and performance
management to minimum power mode, maximum
power mode, 978 Mhz, 800 Mhz, 1067 Mhz, or 1333
Mhz.
A:>syscfg power --profile=custom
--memorypowermode=min --
setuppwdoverride
--fanpowermode min, max Allows you to set the fan algorithm to the minimum
power optimized or maximum performance
optimized mode.
A:>syscfg power --profile=custom
--fanpowermode=min --
setuppwdoverride
NOTE: Set the value of profile to custom to
change the values of cpupowermode ,
memorypowermode , and fanpowermode.
--profile 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.
62
Option Sub-option Arguments Description
NOTE: This
option is
available only
with the
appropriate
installed license.
--
cap<budgetcap>
--unit<unit>
NOTE: This
option is
available only
with the
appropriate
installed license.
<
budgetcap
> is the
limit for power
consumption in
Watts, or btuphr, or
percent.
<
unit
> is the unit of
the <
budgetcap
>
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 value is less than the
minimum threshold value, a warning message
appears.
If the unit is btuphr, it is converted in to Watts using
the formula Watt = BTU/hr /3.413. If the unit is
percent, the formula is Power Cap (Watts) = [Power
supply rating for input power (Watts) - Min potential
power (Watts)] * Power Cap (%) + Min potential
power (Watts)]
Example:
A:>syscfg power --cap=<value> --
unit=watt --setuppwdoverride
--maxpowercap Displays the value of the maximum power
threshold.
--minpowercap Displays the value of the minimum power threshold.
--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. For more information on
delimiters, see Command Line Option Delimiters.
A:>syscfg power --profile=
maxperformance --valsetuppwd=
<setup_password>
--
setuppwdoverri
de
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
SYSCFG Options On PowerEdge 12G Systems
The following table lists the valid SYSCFG options and arguments supported on the PowerEdge 12G systems. On
PowerEdge 12G systems, the SYSCFG options are grouped. The options and arguments are case insensitive. Running
SYSCFG without arguments only displays the valid options. Reboot the system for the BIOS options to take effect.
Some of the BIOS options or arguments may not be available on all systems due to:
• The BIOS version or hardware feature set.
• A missing or expired license. The system displays an error message if the required license is not found. For more
information, see
Dell License Manager
on dell.com/support/manuals.
63
NOTE: PowerEdge 12G systems are backward compatible and support legacy arguments enable and disable.
However, it is recommended to use enabled and disabled on PowerEdge 12G systems as the arguments enable
and disable may be deprecated in future. For more information, see the BIOS options help.
To list the options which are are set on the system, but not applied due to pending reboot, type:
syscfg --pendingvalues
BIOS Boot Settings
Table 9. BIOS Boot Setting Options
Group Option Valid Arguments Description
BIOS Boot Settings --BootSeq list of device names
separated by commas
Specifies the location of the operating
system files needed for system startup.
This option is applicable when bootmode
is set to Bios and has no effect when
bootmode is set to Uefi.
--HddSeq list of device names
separated by commas
Specifies the order in which hard-disk
drives are configured in the system. The
first hard drive in the system will be the
bootable C: drive in DOS/DOS-like
operating systems. This option is
applicable when bootmode is set to
Bios and has no effect when bootmode
is set to Uefi.
Boot Settings
Table 10. Boot Settings Options
Group Option Valid Arguments Description
Boot Settings --BootMode Bios, Uefi Determines the boot mode of the system.
--BootSeqRetry Enabled,
Disabled Enables or disables the Boot Sequence
Retry feature. When set to Enabled, the
system attempts the boot sequence after a
30-second time-out if the last boot attempt
has failed.
Embedded Server Management
Table 11. Embedded Server Management Options
Group Option Valid Arguments Description
Embedded Server
Management
--FrontLcd None,
UserDefined,
ModelNum,
Advanced
Allows you to set the model number or a
user-defined string on the front-panel LCD
display.
--UserLcdStr <string>Allows you to set the default string (model
name and number for PowerEdge systems
earlier than Dell PowerEdge 11G and
service tag for PowerEdge systems 11G
and later) or a user-defined string on the
front-panel LCD. The maximum length of
the string is 62 characters.
64
Integrated Devices
Table 12. Integrated Devices Options
Group Option Valid Arguments Description
Integrated
Devices
--EmbNicPortnBootProto Unknown, None,
Pxe, Iscsi Controls the legacy boot protocol of the
LOM port specified by the embedded
NIC port number. This is a write-only
attribute. This attribute is for systems
management software use, and does
not appear in system BIOS setup. This
attribute always returns Unknown,
when read. There is no change to the
LOM port legacy boot protocol setting
when Unknown is returned. An error is
returned if written with a setting
(None, PXE, or iSCSI) that is
not supported by the LOM Port.
--EmbVideo Enabled,
Disabled Enables or disables the BIOS support
for the Embedded Video Controller.
--IntegratedNetwork1 Enabled,
DisabledOs, Enables or disables Integrated Network
1.
NOTE: If set to DisabledOs, the
Integrated NICs may still be
available for shared network
access by the embedded
management controller. This
function must be configured
through the NIC management
utilities provided with your system.
--IntegratedNetwork2 Enabled,
DisabledOs Enables or disables Integrated Network
2.
NOTE: If set to DisabledOs, the
Integrated NICs may still be
available for shared network
access by the embedded
management controller. This
function must be configured
through the NIC management
utilities provided with your system.
--IntegratedRaid Enabled,
Disabled Enables or disables the integrated RAID
controller.
--IntegratedSas Enabled,
Disabled Enables or disables the integrated SAS
controller.
--InternalSdCard On, Off Turns the internal SD card port on or
off.
--
InternalSdCardRedundan
cy
Mirror,
Disabled
Sets the internal SD card port
redundancy to Mirror mode or
Disabled.
65
Group Option Valid Arguments Description
When set to Mirror mode, read-
write operation occurs on both the
secure digital (SD) cards. When one of
the SD cards fails and is replaced, on
booting, the data of the active card is
copied to the offline card.
When set to Disabled, read-write
operation occurs only on SD card 1.
NOTE: On Blade systems, disable
the vflash key to configure this
option. This option is applicable
only on PowerEdge R810, R815,
R910, M910, and PowerEdge 12G
systems.
--InternalUsb On, Off Turns the internal USB port on or off.
--InternalUsb1 On, Off Turns the internal USB port 1 on or off.
--InternalUsb2 On, Off Turns the internal USB port 2 on or off.
--IoatEngine Enabled,
Disabled Enables or disables the I/O Acceleration
Technology (I/OAT) option.
--OsWatchdogTimer Enabled,
Disabled Aids in the recovery of the operating
system when the system does not
respond. When set to Enabled, the
operating system is allowed to initialize
the timer. When it is set to Disabled
(default value), the timer has no effect
on the system.
--SriovGlobalEnable Enabled,
Disabled
Enables or disables support for Single
Root I/O Virtualization (SR-IOV) devices.
NOTE: This option is supported on
PowerEdge R410, R510, R610, R710,
R910, T410, T610, T710, and
PowerEdge 12G systems with Intel
Xeon processor 7500/6500 series.
--UsbPorts AllOn,
OnlyBackPortsOn
, AllOff
Sets the user accessible USB Ports.
Selecting OnlyBackPortsOn
disables front USB ports, and selecting
AllOff disables both front and back
USB ports.
Memory Settings
Table 13. Memory Settings Options
Group Option Valid Arguments Description
Memory
Settings
--
CollaborativeCpuPerfCt
rl
Enabled,
Disabled When set to Enabled, the operating
system demand based power
management (OS DBPM) and system
demand based power management
66
Group Option Valid Arguments Description
(System DBPM) controls the CPU power
management. This feature can be enabled
only when CPU power management
(ProcPwrPerf) is set to system DBPM
in Custom mode.
--
DynamicCoreAllocation
Enabled,
Disabled Enables or disables the operating system
capability to maintain the logical
processors in the idle state to reduce
power consumption.
--MemOpMode OptimizerMode,
SpareMode,
MirrorMode,
AdvEccMode,
SpareWithAdvEccM
ode
Sets the memory operating mode. This
feature is active only if a valid memory
configuration is detected. When
OptimizerMode is enabled, the DRAM
controllers operate independently in 64-bit
mode and provide optimized memory
performance. When MirrorMode is
enabled, only half of the installed memory
is reported as available to the operating
system. When AdvECCMode is enabled,
the two DRAM controllers are combined
in 128-bit mode to provide optimized
reliability. Memory that cannot be teamed
by the controllers is not reported to the
operating system. When SpareMode is
enabled, the memory size reported to the
operating system does not include the
spare portion.
--MemOpVoltage AutoVolt,
Volt15V
Sets the DIMM voltage selection. When
set to AutoVolt(default value), the
system automatically sets the voltage to
the optimal setting based upon the DIMM
capability and the installed DIMM
population. This option also enables
setting the system DIMM voltage to a
higher (1.5V) setting if the DIMMs support
multiple voltages and have been set to a
lower voltage.
NOTE: Volt15V represents 1.5 Volt.
--MemTest Enabled,
Disabled Enables or disables the POST extended
memory test.
--MonitorMwait Enabled,
Disabled Enables or disables Monitor/Mwait
instructions. You can disable Monitor/
Mwait only when C state is disabled in
Custom mode.
--NodeInterleave Enabled,
Disabled
Enables node interleaving, if the system is
configured with matching memory. If set
to Disabled (default), the system
supports Non-Uniform Memory (NUMA)
architecture memory configurations. This
field is active only if the memory
67
Group Option Valid Arguments Description
configuration can support node
interleaving.
NOTE: The NodeInterleave
option is same as memintleave
option. For more information, see
memintleave.
--SerialDbgOut Enabled,
Disabled Enables or disables the RC/MRC Serial
debug output.
--SysMemSize <string>Displays the amount of main memory in
the system.
--SysMemSpeed <string>Displays the clock frequency of the main
memory.
--SysMemType <string>Displays the type of main memory
installed in the system.
--SysMemVolt <string>Displays the voltage of the main memory.
--VideoMem <string>Displays the total amount of video memory
available to the embedded video
controller.
Miscellaneous Settings
Table 14. Miscellaneous Settings Options
Group Option Valid Arguments Description
Miscellaneous
Settings
--AssetTag <string>Displays the Asset Tag and allows the
Asset Tag to be modified.
NOTE: The Asset Tag is a string
assigned to a system, usually by an
administrator, for security or tracking
purposes. The Asset Tag can be up to
10 characters long and can contain
only printable US-ASCII characters.
--ErrPrompt Enabled,
Disabled Enables (default value) or disables the
F1/F2 prompt on error.
--
InSystemCharac
terization
Enabled,
Disabled Enables or disables In-System
characterization.
--NumLock On, Off Determines whether the system boots with
NumLock turned on or off. This does not
apply to 84- key keyboards.
--ReportKbdErr Report, Noreport Sets if keyboard-related error messages
are reported at system startup or not.
68
One-Time Boot
Table 15. One-Time Boot Options
Group Option Valid Arguments Description
One-Time
Boot
--OneTimeBootMode Disabled,
OneTimeBootSeq,
OneTimeHddSeq,
OneTimeUefiBoot
Seq,
OneTimeCustomB
ootSeqStr,
OneTimeCustomH
ddSeqStr,
OneTimeCustomU
efiBootSeqStr
Allows to set the one-time boot sequence.
--
OneTimeBootSeqDev numerical list separated
by commas or list of
device names separated
by commas
Determines the one-time boot device when
the One- Time Boot Device List is set to BIOS
Boot Sequence Device. If Boot Mode is set to
UEFI, the system temporarily switches the
Boot Mode to BIOS when attempting a one-
time boot to the device.
--OneTimeHddSeqDev numerical list separated
by commas or list of
device names separated
by commas
Determines the one-time boot hard disk
when the One-Time Boot Device List is set to
BIOS Hard-Disk Drive Sequence Device. If
Boot Mode is set to UEFI , the system
temporarily switches the Boot Mode to BIOS
when attempting a one-time boot to the
device.
--
OneTimeUefiBootSeq
Dev
numerical list separated
by commas or list of
device names separated
by commas
Determines the one-time boot device when
the One-Time Boot Device List is set to UEFI
Boot Sequence Device. If Boot Mode is set to
BIOS, the system temporarily switches the
Boot Mode to UEFI when attempting a one-
time boot to the device.
Processor Settings
Table 16. Processor Settings Options
Group Option Valid Arguments Description
Processo
r Settings
--DataReuse Enabled, Disabled Enables (default value) or disables data reuse
in cache.
--DcuIpPrefetcher Enabled, Disabled Enables (default value) or disables DCU IP
Prefetcher.
--
DcuStreamerPrefetch
er
Enabled, Disabled Enables (default value) or disables DCU
Streamer Prefetcher.
--LogicalProc Enabled, Disabled When this option is set to Enabled (default
value), the BIOS reports all logical processors.
When set to Disabled, the BIOS only
reports one logical processor per core. Each
69
Group Option Valid Arguments Description
processor core supports maximum two logical
processors.
--Proc1Brand <string>Displays the brand text provided by the
processor manufacturer.
--Proc1Id <string>Displays the family, model, and stepping
values of the processor.
--Proc1L2Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc1L3Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc1NumCores <integer>Displays the number of cores in the processor
package.
--Proc2Brand <string>Displays the brand text provided by the
processor manufacturer.
--Proc2Id <string>Displays the family, model, and stepping
values of the processor.
--Proc2L2Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc2L3Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc2NumCores <integer>Displays the number of cores in the processor
package.
--Proc3Brand <string>Displays the brand text provided by the
processor manufacturer.
--Proc3Id <string>Displays the family, model, and stepping
values of the processor.
--Proc3L2Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc3L3Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc3NumCores <integer>Displays the number of cores in the processor
package.
--Proc4Brand <string>Displays the brand text provided by the
processor manufacturer.
--Proc4Id <string>Displays the family, model, and stepping
values of the processor.
--Proc4L2Cache <string>Displays the amount of memory in the
corresponding processor cache.
--Proc4L3Cache <string>Displays the amount of memory in the
corresponding processor cache.
70
Group Option Valid Arguments Description
--Proc4NumCores <integer>Displays the number of cores in the processor
package.
--Proc64bit <string>Specifies if the installed processor supports
64-bit extensions or not.
--ProcAdjCacheLine Enabled, Disabled When set to Enabled (default), the system is
optimized for applications that require high
utilization of sequential memory access. When
set to Disabled, the system is optimized for
applications that require high utilization of
random memory access.
--ProcBusSpeed <string>Displays the bus speed of the processor.
--ProcCores single, all,
dual, quad, 1, 2,
4, 6, 8, 10, 12,
14, 16
Controls the number of enabled cores in each
processor. By default, the maximum number of
cores per processor will be enabled.
--ProcCoreSpeed <string>Displays the clock speed of the processor(s).
--
ProcExecuteDisable
Enabled, Disabled Enables or disables the Execute Disable
Memory Protection Technology
--ProcHwPrefetcher Enabled, Disabled Enables or disables the hardware prefetcher.
--
ProcVirtualization
Enabled, Disabled When set to Enabled , the additional
hardware capabilities provided by
Virtualization Technology are available for use.
--
QpiBandwidthPriorit
y
InputOutput,
Compute Sets the bandwidth priority to Compute
(default value) or I/O.
--QpiSpeed MaxDataRate,
8GTps, 7GTps,
6GTps
Sets the speed of the processor.
--RtidSetting Enabled, Disabled When set to Enabled, it allocates more
(Requestor Transaction IDs) RTIDs to the
remote socket thereby increasing cache
performance between the sockets.
71
SATA Settings
Table 17. SATA Settings Options
Group Option Valid Arguments Description
SATA
Settings
--EmbSata Off, AtaMode,
RaidMode,
AhciMode
Configures an embedded SATA RAID controller.
•Off — disables the embedded SATA RAID
controller.
•AtaMode — sets SATA RAID controller to
ATA mode.
•RaidMode — sets SATA RAID controller to
RAID mode.
•AhciMode — sets SATA RAID controller to
ahci mode.
--eSataPort1 Off, Auto Sets the embedded SATA port1 to auto or off.
--
eSataPort1Capaci
ty
<string> Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
eSataPort1DriveT
ype
<string> Indicates the type of device attached to the
embedded SATA port.
--
eSataPort1Model
<string> Displays the drive model of the selected device.
--SataPortA Off, Auto Sets the drive type of the selected device to off or
auto.
--
SataPortACapacit
y
<string> Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortADriveTy
pe
<string>This option indicates type of device attached to this
SATA port.
--SataPortAModel <string>Displays the drive model of the selected device.
--SataPortB Off, Auto Sets the drive type of the selected device to off or
auto.
--
SataPortBCapacit
y
<string>Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortBDriveTy
pe
<string>Indicates type of device attached to this SATA port.
--SataPortBModel <string>Displays the drive model of the selected device.
--SataPortC Off, Auto Sets the drive type of the selected device to off or
auto.
--
SataPortCCapacit
y
<string>Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
72
Group Option Valid Arguments Description
--
SataPortCDriveTy
pe
<string>Indicates the type of device attached to this SATA
port.
--SataPortCModel <string>Displays the drive model of the selected device.
--SataPortD Off, Auto Sets the drive type of the selected device to off or
auto .
--
SataPortDCapacit
y
<string>Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortDDriveTy
pe
<string>Indicates the type of device attached to this SATA
port.
--SataPortDModel <string> Displays the drive model of the selected device.
--SataPortE Off, Auto Sets the drive type of the selected device to off or
auto .
--
SataPortECapacit
y
<string> Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortEDriveTy
pe
<string>Indicates type of device attached to this SATA port.
--SataPortEModel <string>Displays the drive model of the selected device.
--SataPortF Off, Auto Sets the drive type of the selected device to off or
auto.
--
SataPortFCapacit
y
<string>Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortFDriveTy
pe
<string>Indicates the type of device attached to this SATA
port.
--SataPortFModel <string>Displays the drive model of the selected device.
--SataPortG Off, Auto Sets the drive type of the selected device to off or
auto.
--
SataPortGCapacit
y
<string>Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortGDriveTy
pe
<string>Indicates the type of device attached to this SATA
port.
--SataPortGModel <string>Displays the drive model of the selected device.
--SataPortH Off, Auto Sets the drive type of the selected device to off or
auto.
73
Group Option Valid Arguments Description
--
SataPortHCapacit
y
<string>Displays the total capacity of a hard-disk drive. This
option is undefined for removable-media devices
such as optical drives.
--
SataPortHDriveTy
pe
<string>Indicates the type of device attached to this SATA
port.
--SataPortHModel <string>Displays the drive model of the selected device.
Serial Communication
Table 18. Serial Communication Options
Group Option Valid Arguments Description
Serial
Communicati
on
--ConTermType Vt100Vt220, Ansi Sets the terminal type for your remote
console.
--
ExtSerialConnect
or
Serial1, Serial2,
RemoteAccDevice Associates the External Serial Connector to
Serial Device 1, Serial Device 2, or the
Remote Access Device.
--FailSafeBaud 115200, 57600,
19200, 9600 The BIOS attempts to determine the baud
rate automatically. This failsafe baud rate is
used only if the attempt fails.
--RedirAfterBoot Enabled, Disabled Sets the BIOS console redirection to
enable or disable when the operating
system is loaded.
--SerialComm OnNoConRedir,
OnConRedirCom1,
OnConRedirCom2, Off
Enables or disables the serial
communication devices (Serial Device 1
and Serial Device 2) in BIOS.
--
SerialPortAddres
s
Serial1Com1Serial2Co
m2,
Serial1Com2Serial2Co
m1, Com1, Com2
Sets the port address for the Serial Devices
(COM1=0x3F8, COM2= 0x2F8).
Slot Disablement
Table 19. Slot Disablement Options
Group Option Valid Arguments Description
Slot Disablement --Slot1 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
--Slot2 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
--Slot3 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
--Slot4 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
--Slot5 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
74
Group Option Valid Arguments Description
--Slot6 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
--Slot7 Enabled, Disabled,
BootDriverDisabled
Enables or disables the specified slot.
System Information
Table 20. System Information Options
Group Option Valid
Arguments Description
System
Information
--
SysMfrContactInf
o
<string>Displays the information for contacting the Original
Equipment Manufacturer (OEM) of this system.
--
SystemBiosVersio
n
<string>Displays the current revision of the system BIOS
firmware.
--
SystemManufactur
er
<string>Displays the name of the Original Equipment
Manufacturer (OEM) of this system.
--
SystemModelName
<string>Displays the product name of the system.
--
SystemServiceTag
<string>Displays the system service tag (a unique identifier
assigned by the Original Equipment Manufacturer (OEM)
of this system).
System Profile Settings
Table 21. System Profile Settings Options
Group Option Valid Arguments Description
System
Profile
Settings
--MemFrequency MaxPerf, 1600MHz,
1333MHz, 1067MHz,
800MHz,
MaxReliability
Sets the Memory Frequency as maximum
performance, 1600 Mhz, 1333 MHz, 1067 MHz,
800 MHz, or maximum reliability.
--MemPatrolScrub Standard,
Extended, Disabled Sets the Memory Patrol Scrub frequency as
Standard Mode, Extended Mode, or
Disabled.
--MemRefreshRate 1x, 2x Sets the Memory Refresh Rate as 1xor 2x.
--MemVolt AutoVolt, Volt15V,
Volt135V
NOTE: Volt15V
represents 1.5 Volt and
Volt135V represents
1.35 Volt.
Sets the DIMM voltage selection.
--ProcC1E Enabled, Disabled When set to Enabled, the processor is
allowed to switch to minimum performance
state when idle.
75
Group Option Valid Arguments Description
--ProcCStates Enabled, Disabled When set to Enabled, the processor can
operate in all available power states.
--ProcPwrPerf MaxPerf, MinPwr,
SysDbpm, OsDbpm Sets CPU Power Management to maximum
performance, operating system DBPM, or
System DBPM (DAPC).
--ProcTurboMode Enabled, Disabled When set to Enabled, the processor can
operate in Turbo Boost Mode.
--SysProfile PerfPerWatt
OptimizedOs,
PerfPerWatt
OptimizedDapc,
PerfOptimized,
Custom, DenseCfg
Optimized
Sets the System Profile to Performance
Optimized, Power Optimized (DAPC), Power
Optimized (OS), Dense Configuration Optimized,
or Custom mode. When set to a mode other
than Custom, BIOS will set each option
accordingly. When set to Custom, you can
change setting of each option.
System Security
Table 22. System Security Options
Group Option Valid Arguments Description
System
Security
--AcPwrRcvry On, Off, Last Specifies how the system will react after AC
power has been restored to the system. It is
especially useful for people who turn their
systems off with a power strip.
--AcPwrRcvryDelay Immediate,
User, Random Specifies how the system will support the
staggering of power-up after AC power has
been restored to the system.
--
AcPwrRcvryUserDela
y
<integer>Controls the user defined AC Recovery Delay.
Enter a delay in the range of 60 seconds to 240
seconds.
--AesNi Enabled,
Disabled Displays the current status of Intel Processor
AES-NI feature.
--
BiosUpdateControl
Unlocked,
Limited,
Locked
Locks, unlocks, or limits the BIOS update using
DOS or UEFI shell based flash utilities. For
environments not requiring local BIOS updates,
it is recommended to set this field to Locked.
--IntelTxt On, Off Turns the Trusted Execution Technology on or
off. To enable Intel TXT, VT must be enabled,
and the TPM must be enabled with pre-boot
measurements and activated.
--NmiButton Enabled,
Disabled Enables or disables the Non-Maskable Interrupt
(NMI) button on the front panel.
--PasswordStatus Locked,
Unlocked Locks the system password. To prevent the
system password from being modified, set this
option to locked and enable setup password.
This field also prevents the system password
from being disabled by the user while the
system boots.
76
Group Option Valid Arguments Description
--PwrButton Enabled,
Disabled Enables or disables the power button on the
front panel.
--SetupPassword <string>Displays the password and allows the password
to be set or modified. The password can be up to
32 characters long and contain most of non-
shifted letters, numbers, and punctuation.
--SysPassword <
string
>> Displays the password and allows the password
to be set or modified. The password can be up to
32 characters long and contain most of non-
shifted letters, numbers, and punctuation.
--
SystemCpldVersion NA Displays the current revision of the Complex
Programmable Logic Device (CPLD) of the
system.
--TcmActivation NoChange,
Activate,
Deactivate
Allows the user to change the operational state
of the Trusted Cryptography Module (TCM). This
field is Read-Only when TCM Security is set to
Off.
--TcmClear Yes, No CAUTION: Clearing the TCM will cause loss
of all keys in the TCM. This could affect
booting of the operating system.
When set to Yes, all the contents of the TCM
will be cleared. This field is read-only when
TCMSecurity is set to Off.
--TcmSecurity On, Off Controls the reporting of the Trusted
Cryptography Module (TCM) in the system.
--TpmActivation NoChange,
Activate,
Deactivate
Allows the user to change the operational state
of the Trusted Platform Module (TPM). This field
is read-only when TPMSecurity is set to
Off.
--TpmClear Yes, No CAUTION: Clearing the TPM will cause loss
of all keys in the TPM. This could affect
booting of the operating system.
When set to Yes, all the contents of the TPM
will be cleared. This field is read-only when
TPMSecurity is set to Off.
--TpmSecurity Off, OnPbm,
OnNoPbm Controls the reporting of the Trusted Platform
Module (TPM) in the system.
--TpmStatus NA Displays the current status of TPM.
--UefiBootSeq numerical list
separated by commas
or list of device
names separated by
commas
Controls the UEFI boot order. The first option in
the list is attempted first, and if unsuccessful,
the second option will be attempted, and so on.
The system attempts to launch enabled boot
options only; it will not launch disabled boot
options. This field applies only when
77
Group Option Valid Arguments Description
bootmode is set to Uefi. It has no effect
when bootmode is set to bios.
SYSCFG For BMC And Remote Access Controller Configuration
SYSCFG configures Baseboard Management Controller (BMC) and Remote Access Controller (RAC) settings.
NOTE: Some of the following options or arguments might not be available on all systems.
NOTE: For options that use text strings such as username, password, hostname, and community string, using some
characters such as <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 suboption. Options, sub-options, and arguments are case-sensitive. All options, sub-options,
and pre-defined arguments are lowercase unless explicitly stated otherwise. Some features that must be noted while
reading this section are:
• Unless otherwise specified, all sub-options to options are optional.
• If a sub-option is not specified for an option, all valid sub-option values are displayed for the option. If sub-
options are specified, then only those suboptions are reported.
• Wherever options or sub-options take empty strings as input, the string NULL should be input. For example,
options such as username and suboptions such as commstring and hostname can take an empty string as input.
BMC And Remote Access Controller Configuration Options
The following are the options, sub-options, and pre-defined arguments for configuring your system BMC and RAC.
NOTE: Some of the command line options in DTK are followed by an asterisk. Such options are used for reporting
purposes only.
clearsel*
Table 23. clearsel option
Option Sub-option Valid Arguments Description Applicable Systems
--clearsel* NA NA Clears the System Event Log (SEL).
This option cannot be replicated.
Example:
A:>syscfg -- clearsel
Clearing SEL...
All PowerEdge
systems
78
controlpanelaccess
Table 24. controlpanelaccess options
Option Sub-option Valid
Arguments Description Applicable Systems
--
controlpanelacce
ss
NA viewandmod
ify,
viewonly,
disabled
Sets or gets the access level for
the Liquid Crystal Display (LCD).
Example:
A:>syscfg --
controlpanelaccess=
viewandmodify
controlpanelaccess=
viewandmodify
PowerEdge 11G and
12G systems
deviceguid*
Table 25. deviceguid options
Option Sub-option Valid Arguments Description Applicable Systems
--
deviceguid* NA NA Displays the GUID for the BMC. This
option cannot be replicated.
Example:
A:>syscfg--deviceguid
deviceguid=XXXXXXXXXX
All PowerEdge
systems
encryptkey
Table 26. encryptkey option
Option Sub-option Valid Arguments Description Applicable Systems
--
encryptkey NA <
hexadecimal
number
>
Encrypts the IPMI sessions.
The hexadecimal number entered
as an argument is case insensitive
although the value returned by the
encryptkey option is always in
uppercase.
The value returned is appended
with zeroes so that it is always 40
characters long.
Example:
A:>syscfg --
encryptkey=abcd
encryptkey=
ABCD00000000000
000000000000000
0000000000
All PowerEdge
systems
79
identify
Table 27. identify option
Option Sub-option Valid Arguments Description Applicable
Systems
--identify NA 0–254
NOTE: Use 0 to
stop the blinking
of the LED.
Flashes the identification LED
for a specified number of
seconds.
PowerEdge
systems with a
BMC.
idracversion
Table 28. idracversion options
Option Sub-option Valid
Arguments Description Applicable Systems
--
idracversio
n
Displays the version information
for the iDRAC and the iDRAC
firmware. This option cannot be
replicated.
All PowerEdge
systems
--devid NA Reports the iDRAC device ID.
--devrevision NA Reports the iDRAC device
revision.
--
majorfwversion NA Reports the major firmware
revision of iDRAC.
--
minorfwversion NA Reports the minor firmware
revision of iDRAC.
A:>syscfg --
idracversion
devid=32
devrevision=0
majorfwversion=0
minorfwversion=40
kvmstatusonlcd
Table 29. kvmstatusonlcd options
Option Sub-option Valid
Arguments Description Applicable Systems
--
kvmstatusonlc
d
NA active,
inactive
Configures the Dell Virtual KVM (vKVM)
session status on the LCD.
Example:
A:>syscfg --
kvmstatusonlcd=active
kvmstatusonlcd=active
PowerEdge 11G
systems
80
lancfgparams
Table 30. lancfgparams options
Option Sub-option Valid
Arguments Description Applicable Systems
lancfgpara
ms or lcp
Configures and displays LAN
configuration parameters. This
option can be replicated.
All PowerEdge
systems
--ipaddrsrc static,
dhcp
Sets the IP address source for the
LAN channel. This sub-option can
be replicated.
--ipaddress <ipaddres
s>
Sets the IP address for the LAN
channel. This sub-option cannot be
replicated.
--subnetmask <subnetma
sk>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 <ipaddres
s>
Sets the destination IP address or
Fully Qualified Domain Name
(FQDN) for the alert destination
specified with the alertdest
sub-option.
The destipaddr sub-option is
dependent on the alertdest
suboption. If the alertdest sub-
option is not specified on the
command line, the first alert
destination (alertdest=1) is
set with this IP address or FQDN.
This sub-option can be replicated.
Example 1 (to set the destination IP
address):
A:>syscfg lcp --
alertdest=1 --
destipaddr=192.168.100.
15
Example 2(to set the destination IP
address as FQDN):
A:>syscfg lcp --
alertdest=1 --
destipaddr=xxx.yyy.com
NOTE: FQDN is
applicable only
for
destipaddr
option and is
supported only
on PowerEdge
12G systems.
81
Option Sub-option Valid
Arguments Description Applicable Systems
--alertdest 1, 2, 3,
4Sets 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
NOTE: This option is
available only with
the appropriate
installed license.
shared,
sharedfai
lover,
dedicated
,
sharedrec
eiveonall
Sets the operating mode of the NIC
to shared, sharedfailover,
dedicated, or
sharedreceiveonall. Some
of these options are not applicable
on certain systems.
This option is
applicable on
systems prior to
PowerEdge 12G
systems. The
sharedreceive
onall argument is
available only on
PowerEdge 11G
systems.
--nicselection
NOTE: This option is
available only with
the appropriate
installed license.
dedicated
, lom1,
lom2,
lom3,
lom4
Sets the operating mode of the
iDRAC7 NIC to dedicated,
lom1, lom2, lom3, or lom4.
Some of these options are not
applicable on certain systems due
to underlying hardware.
NOTE: This
option is
applicable on
PowerEdge 11G
systems.
--
nicselectionfailo
ver
NOTE: This option is
available only with
the appropriate
installed license.
none,
lom1,
lom2,
lom3,
lom4, all
Sets the operating mode of the NIC
selection failover to none, lom1,
lom2, lom3, lom4, or all.
Some of these options are not
applicable on certain systems. due
to underlying hardware.
NOTE: This
option is
applicable on
PowerEdge 12G
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.
--dnsdhcp enable,
disable Enables or disables obtaining the
DNS server IP address through
DHCP.
82
Option Sub-option Valid
Arguments Description Applicable Systems
--dnsserver1 <ipaddres
s>Sets the IP address of the primary
DNS server for domain name
resolution.
--dnsserver2 <ipaddres
s>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.
--
domainnamefromdhc
p
enable,
disable Enables or disables getting the
RAC domain name through DHCP.
--domainname <string>Sets the domain name of the RAC.
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.1
0
subnetmask=255.255.255.
0
gateway=192.168.100.1
83
Option Sub-option Valid
Arguments Description Applicable Systems
Example 2 (to set the LAN
configuration parameters):
A:>syscfg --
lancfgparams
--
destipaddr=192.168.100.
15
--vlantag=enable
--vlanid=1000
--vlanpriority=7
--
macaddress=0:6:5b:fb:c8
:a7
--commstring=public
--ipaddrsrc=static
--
ipaddress=192.168.100.1
0
--
subnetmask=255.255.255.
0
--gateway=192.168.100.1
lanchannelaccess
Table 31. lanchannelaccess options
Option Sub-option Valid Arguments Description Applicable
Systems
lanchannelacc
ess or lca
Sets or displays the LAN
channel access settings such
as alerting, IPMI over LAN, and
user privilege. This option can
be replicated.
All PowerEdge
systems
--pefalerting enable,
disable
Enables or disables PEF alerts.
This sub-option can be
replicated.
--ipmioverlan disable,
alwaysavail
Sets the LAN channel access
mode. This sub-option can be
replicated.
--
channelprivlm
t
user,
operator,
administrat
or
Sets the maximum privilege
level accepted for the LAN
channel. This sub-option can be
replicated.
84
Option Sub-option Valid Arguments Description Applicable
Systems
Example (to configure the LAN
channel with alerts and IPMI
over LAN enabled):
A:>syscfg
lanchannelaccess--
pefalerting=enable --
ipmioverlan=alwaysava
il
lanchannelinfo
Table 32. lanchannelinfo options
Option Sub-option Valid Arguments Description Applicable Systems
lanchanneli
nfo or lci NA NA Displays media and protocol
information about the LAN channel.
This option cannot be replicated.
All PowerEdge
systems
lanuseraccess
Table 33. lanuseraccess options
Option Sub-option Valid Arguments Description Applicable
Systems
lanuseracc
ess or lua Configures the privilege level and
channel accessibility associated
with a specified User ID for the
LAN channel.
All PowerEdge
systems
--userid 2–16, if your
system has a
DRAC 5
controller
Sets the User ID. This sub-option
can be replicated.
--usrprivlmt user,
operator,
administrat
or,
noaccess
Sets the maximum BMC user
privilege level for the LAN
channel for the userid specified
using the useridsub-option.
This sub-option can be replicated.
This sub-option is dependent on
the userid sub-option.
--
currentenableduse
rids
NA Reports the number of currently
enabled User IDs on the LAN
channel.
--
useridswithfixedn
ames
NA Reports the number of User IDs
with fixed names on the LAN
channel.
85
Option Sub-option Valid Arguments Description Applicable
Systems
Example 1 (to enable User ID 2 on
the LAN channel with
administrator privileges):
A:>syscfg
lanuseraccess --
userid=2 --
usrprivlmt=administrat
or
Example 2 (to enable User ID 4 on
the LAN channel with user
privileges):
A:>syscfg
lanuseraccess --
userid=4 --
usrprivlmt=user
loaddefaults*
Table 34. loaddefaults option
Option Sub-option Valid Arguments Description Applicable Systems
--
loaddefaul
ts*
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
Loading defaults...
All PowerEdge
systems
nextboot
Table 35. nextboot option
Option Sub-option Valid
Arguments Description Applicable Systems
--nextboot or
--
OneTimeBootSeq
Dev
NA valid device
name (from the
bootseq
option device
list)
Sets the specified device as the
first device in the boot order for
the next boot cycle only. The
device must be a device from the
bootseq option device list. Run
the bootseq option to see a list
of available device names. For
more information, see --bootseq.
This option is not replicated.
All PowerEdge
systems
86
Option Sub-option Valid
Arguments Description Applicable Systems
Example 1:
A:>syscfg --bootseq
Device 1: floppy.emb.0
- Diskette Drive A:
Device 2: cdrom.emb.0
- CD-ROM device
Device 3: hdd.emb.0 -
Hard Drive C:
Device 4: nic.emb.1 -
Intel Boot Agent
Version 4.0.17
Device 5: nic.emb.2 -
Intel Boot Agent
Version 4.0.17
Example 2:
A:>syscfg --
nextboot=nic.emb.1
nextboot=nic.emb.1
nmibutton
Table 36. nmibutton option
Option Sub-option Valid Arguments Description Applicable Systems
--nmibutton NA enable,
disable
Enables or disables the NMI button.
This option can be replicated.
Example:
A:>syscfg --
nmibutton=enable
nmibutton=enable
All PowerEdge
systems
87
passwordaction
Table 37. passwordaction options
Option Sub-option Valid Arguments Description Applicable Systems
passwordact
ion
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: This option does not
support 20 byte passwords.
All PowerEdge
systems
--userid 2–16, if your
system has a
DRAC 5
controller
Specifies the BMC User ID. This
sub-option cannot be replicated.
--action setpassword
,
testpasswor
d
Sets or tests the password for the
specified User ID. This sub-option
cannot be replicated.
--password <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):
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.
88
pefcfgparams
Table 38. pefcfgparams options
Option Sub-option Valid
Arguments Description Applicable Systems
pefcfgparam
s or pcp Configures and displays PEF
configuration parameters. This
option can be replicated.
All PowerEdge
systems
--filter fanfail,
voltfail,
discretevo
ltfail,
tempwarn,
tempfail,
intrusion,
redundegra
ded,redunl
ost,
procwarn,
procfail,
powerwarn,
powerfail,
hardwarelo
gfail,
autorecove
ry,
batterywar
n,
batteryfai
l,
powerabsen
t,
procabsent
,
systempowe
rwarn,
systempowe
rfail
Specifies a PEF value. This sub-
option can be replicated.
For a complete list of all possible
PEF messages along a description
of each event, see BMC Platform
Events Filter Alert Messages
NOTE: The fanfail option
is not supported on
PowerEdge 10G systems.
--
filteraction
powercycle
, reset,
powerdown,
power
reduction,
none
Sets the event filter action for the
filter specified using the filter
sub-option. This sub-option
depends on the filter sub-
option. This sub-option can be
replicated.
--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 the followig
characters: hyphen (-) ,
underscore (_) , and period (.) .
The length of the hostname
string must be 62 characters or
89
Option Sub-option Valid
Arguments Description Applicable Systems
less for PowerEdge 9G systems
and later.
--filteralert enable,
disable Enables or disables alerts for the
filter specified using the filter 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.
--
alertpolstatu
s
enable,
disable
Enables or disables the alert policy
specified using the
alertpolnum sub-option. This
sub-option can be replicated. This
sub-option is dependent on the
alertpolnum sub-option.
Example: (to set the PEF
configuration parameters):
Example 1 (To configure the PEF so
that the system is powered down
in response to a fan failure event):
A:>syscfg pefcfgparams
--filter= fanfail--
filteraction=powerdown
pefcfgparams
filter=fanfail
filteraction=powerdown
Example 2 (To configure the PEF so
that a PEF alert is not sent to the
destination IP address in response
to a chassis intrusion event):
A:>syscfg pefcfgparams
--filter= intrusion--
filteralert=disable
pefcfgparams filter=
intrusion
filteralert=disable
powerbutton
Table 39. powerbutton option
Option Sub-option Valid Arguments Description Applicable Systems
--
powerbutton NA enable,
disable
Enables or disables the power
button. This option can be
replicated.
All PowerEdge
systems
90
Option Sub-option Valid Arguments Description Applicable Systems
Example:
A:>syscfg --
powerbutton=enable
powerbutton=enable
powerctl
Table 40. powerctl option
Option Sub-option Valid Arguments Description Applicable Systems
--powerctl NA powerdown
</argument>
Performs a chassis powerdown and
controls the reset of the system.
Powerdown turns off the system.
All PowerEdge
systems
powercycle
</argument> Turns off the system and
automatically turns on your system
after a few seconds.
reset </
argument> Resets the system.
softshutdow
n </
argument>
In Linux, the system turns off
immediately.
NOTE: In Windows PE, this
option does not work.
NOTE: This option applies only
to PowerEdge systems that are
configured with a BMC.
NOTE: This argument requires
ACPI support to function
properly.
racreset*
Table 41. racreset option
Option Sub-option Valid Arguments Description Applicable Systems
--racreset* NA NA Resets the RAC. It cannot be
accompanied with any other option.
This option cannot be replicated.
All PowerEdge
systems
91
serialcfgparams
Option Sub-option Valid Arguments Description Applicable Systems
serialcfgpa
rams or scp Configures and displays serial
configuration parameters. This
option can be replicated.
All PowerEdge
systems
--
connectionmod
e
basic,
terminal Sets the connection mode used to
perform IPMI messaging to the
BMC. This sub-option can be
replicated.
--msgcomm noflowctrl,
rtscts Sets the IPMI message
communication flow control. This
suboption can be replicated.
--
msgcommdtrhan
gup
NA Reports the IPMI message
communication DTR hang-up. This
suboption cannot be replicated.
--
msgcommbitrat
e
9600,
19200,
57600,
115200
Sets the IPMI message
communication baud rate in bits
per second (bps). This sub-option
can be replicated.
--
tmcfglineedit
ing
enable,
disable Sets the line editing value for
terminal mode configuration. This
sub-option can be replicated.
--
tmcfgdelctrl
del, bksp Sets the delete control value for
terminal mode configuration. This
sub-option can be replicated.
--
tmcfgechoctrl
echo,
noecho Sets the echo control value for
terminal mode configuration. This
sub-option can be replicated.
--
tmcfghandshak
ectrl
enable,
disable Sets the handshake control value
for terminal mode configuration.
This sub-option can be replicated.
--
tmcfgnewlines
eq
noterm,
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.
Example (to display the current
serial configuration settings):
A:>syscfg
serialcfgparams
92
Option Sub-option Valid Arguments Description Applicable Systems
serialcfgparams
tmcfgdelctrl=del
tmcfgechoctrl=echo
tmcfghandshakectrl=enab
le
connectionmode=terminal
tmcfgnewlineseq=crlf
msgcommflowctrl=rtscts
tmcfginputnewlineseq=cr
msgcommdtrhangup=disabl
e
msgcommbitrate=19200
tmcfglineediting=enable
serialchannelaccess
Table 42. serialchannelaccess options
Option Sub-option Valid Arguments Description Applicable
Systems
--
serialchannelacc
ess or sca
Sets or displays the channel
access settings for the serial
channel. This option can be
replicated.
All PowerEdge
systems
--
ipmioverseria
l
disable,
alwaysavail Sets the serial channel access
mode. This sub-option can be
replicated.
--
channelprivlm
t
user,
operator,
administrat
or
Sets the maximum privilege
level accepted for the serial
channel. This sub-option can
be replicated.
Example (to configure the
serial channel with IPMI over
serial disabled and the
maximum privilege level set to
administrator):
A:>syscfg
serialchannel
access --
ipmioverserial=disab
le
--
channelprivlmt=admin
93
Option Sub-option Valid Arguments Description Applicable
Systems
istrator
serialchannelaccess
ipmioverserial=disab
le
channelprivlmt=admin
istrator
serialchannelinfo
Table 43. serialchannelinfo options
Option Sub-option Valid
Arguments Description Applicable Systems
--
serialchanneli
nfo or sci
Displays media and protocol
information about the serial
channel. This option cannot be
replicated.
All 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.
--
activessncoun
t
NA Displays the number of sessions
that are activated on the serial
channel. This sub-option cannot
be replicated.
Example:
A:>syscfg
serialchannelinfo --
mediumtype
mediumtype= asynch
serialuseraccess
Table 44. serialuseraccess options
Option Sub-option Valid Arguments Description Applicable
Systems
serialuseracce
ss or sua Configures the privilege level
and channel accessibility
associated with a specified
All PowerEdge
systems
94
Option Sub-option Valid Arguments Description Applicable
Systems
User ID for the serial channel.
This option can be replicated.
--userid 2–16, if your
system has a
DRAC 5 controller
Sets the User ID. This sub-
option can be replicated.
--usrprivlmt user,
operator,
administrato
r,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.
--
currentenabledu
serids
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.
Example 1 (to enable User ID 2
on the serial channel with
administrator privileges ) :
A:>syscfg
serialuseraccess --
userid=2 --
usrprivlmt=administr
ator
userid=2
usrprivlmt=administr
ator
status=enable
Example 2 (to enable User ID 4
on the serial channel with
user privileges ):
A:>syscfg
serialuseraccess --
userid=4 --
usrprivlmt=user
userid=4
usrprivlmt=user
status=enable
95
solaction
Table 45. solaction options
Option Sub-option Valid Arguments Description Applicable Systems
solaction This option enables or disables
Serial-Over- LAN (SOL) access for a
particular user. This option can be
replicated.
Example:
A:>syscfg solaction
--userid=2 --
action=disable
solaction userid=2
action=disable
All PowerEdge
systems
--userid 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.
solcfgparams
Table 46. solcfgparams options
Option Sub-option Valid
Arguments Description Applicable Systems
solcfgpara
ms
Configures and displays SOL
configuration parameters. This
option can be replicated.
All PowerEdge
systems
--solenable enable,
disable Enables or disables if the SOL
payload type can be activated.
This option can be replicated.
--solprivlevel user,
operator,
administra
tor
Sets the minimum user privilege
level required to activate the SOL.
This option can be replicated.
--
solcharaccuminte
rval
1–255 Sets the Character Accumulate
Interval in 5–ms increments (1–
255). This sets the typical amount
of time that the BMC waits before
transmitting a partial SOL
character data packet. This
option can be replicated.
96
Option Sub-option Valid
Arguments Description Applicable Systems
--
solcharsendthres
hold
1–255 Specifies that the BMC
automatically sends an SOL
character data packet containing
this number of characters in
increments of 5 (1–255) as soon
as this number of characters (or
greater) has been accepted from
the baseboard serial controller
into the BMC. This option can be
replicated.
NOTE: On PowerEdge 9G and
SC1435 systems, the
maximum limit is 255.
--solbitrate 9600,
19200,
57600,
115200
Sets the serial channel
communication bit rate (in bps)
with the BMC when SOL is
activated. This option can be
replicated.
NOTE: The arguments for
solbitrate vary with
various Dell systems. If an
argument valid for a
particular Dell system is
entered for another system,
the Parameter out of
range error is displayed.
Valid arguments are:
• 57600 — for PowerEdge
9G systems that do not
have DRAC 5 installed.
• 115200 — for PowerEdge
9G systems that have
DRAC 5 installed.
Example 1 (to display the current
SOL configuration):
A:>syscfg solcfgparams
solcfgparams
solenable=enable
solprivlevel=administr
ator
solcharaccum
interval=25
solcharsend
threshold=25
solbitrate=9600
Example 2 (to set the SOL
configuration parameters):
A:>syscfg solcfgparams
--solenable=disable
--
solprivlevel=administr
ator
97
Option Sub-option Valid
Arguments Description Applicable Systems
--solcharaccum
interval=25
--solcharsend
threshold=100
--solbitrate=9600
solcfgparams
solenable=disable
solprivlevel=administr
ator
solcharaccum
interval=25
solcharsend
threshold=100
solbitrate=9600
ssninfo
Table 47. ssninfo options
Option Sub-option Valid Arguments Description Applicable Systems
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 PowerEdge
systems
--
maxactivessns NA Displays the maximum possible
active BMC sessions. This sub-option
cannot be replicated.
--
currentactives
sns
NA Displays the number of currently
active sessions on all channels of the
BMC. This sub-option cannot be
replicated.
Example:
A:>syscfg ssninfo
currentactivessns=1
maxactivessns=4
useraction
Table 48. useraction options
Option Sub-option Valid Arguments Description Applicable Systems
useraction Enables and disables BMC, sua, and
lua user IDs. This option can be
replicated.
All PowerEdge
systems
--userid 2–16, if your
system has a
DRAC 5
controller
Specifies the BMC user ID. This
sub-option can be replicated.
98
Option Sub-option Valid Arguments Description Applicable Systems
--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
username
Table 49. username options
Option Sub-option Valid Arguments Description Applicable Systems
username Sets the BMC User ID and
username. This option can be
replicated.
All PowerEdge
systems
--userid 2–16 if your
system has a
DRAC 5
controller
Specifies the User ID. This 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
Example 2 (to display the username
for User ID 3):
A:>syscfg username --
userid=3 --name
username userid=3
name=bmcmaster
99
version*
Table 50. version option
Option Sub-option Valid Arguments Description Applicable Systems
--version* NA NA Displays the version information for
the SYSCFG utility.
virutualmedia
Table 51. virutualmedia option
Option Sub-option Valid Arguments Description Applicable Systems
--
virutualmed
ia
NOTE: This
option is
available
only with
the
appropriate
installed
license.
NA enable,
disable,
auto
Enables or disables the virtual
media. This option cannot be
replicated.
All PowerEdge
systems. Available on
DRAC5 and all iDRAC
versions.
SYSCFG For State Configuration
The SYSCFG utility allows the user to write a state data value on a system. This value is preserved across reboot or
power-off operations. Users can use this state data value for storing important state information, such as the progress of
a multi-reboot deployment process.
SYSCFG Options For State Configuration
The following table lists all valid options and arguments along with a description of the expected behavior of each
option.
NOTE: Some of the following options or arguments are not available on all systems.
Table 52. SYSCFG Options and Arguments for State Configuration
Option Valid Arguments Description
-b or --byte <string>Specifies a value to write to state data. The format of the argument
must be in decimal format unless the -x option is given. If the -x option
is given, the value is interpreted as hexadecimal format. The value can
optionally contain 0x. The decimal range is 0–255, and the
hexadecimal range is 0x00–0xFF.
100
Option Valid Arguments Description
Example:
A:>syscfg -b 1
The state byte has been set to 1.
A:>syscfg -b 2 -x
The state byte has been set to 0x02.
-r or --read*
NOTE: The
asterisk is not
part of the
command
syntax.
NA Reads the value of state data. When used with the -x option, the value
is reported in hexadecimal format (0xNN).
Example:
A:>sysfg -r -x
The state byte has been set to 0x02.
A:>syscfg -r
The state byte has been set to 2.
-x or --hex None Specifies that a value should be in hexadecimal format.
Example:
A:>sysfg -r -x
The state byte has been set to 0x01.
A:>sysfg -x -b 0x02
The state byte has been set to 0x02.
SYSCFG for System Configuration
SYSCFG enables system configuration and reporting. It reports system identification values, processor types and
speeds, memory size, and detects device using PCI scan.
Options For System Configuration
Table below documents valid options and arguments along with a description of the expected behavior of each option.
Options and arguments are case sensitive. All options and pre-defined arguments are lowercase unless stated
otherwise.
NOTE: Some of the following options or arguments might not be available on all systems. Some of the command
line options are followed by an asterisk. Such options are used for reporting purposes only
Table 53. SYSCFG Options and Arguments for System Configuration
Option Valid Arguments Description
--asset None Reports the customer-programmable asset tag number for a system.
This option displays the asset tag for a system. For Blade systems, the
SYSCFG utility reports the asset tag for both the server module and
the asset tag for its chassis. For more information on delimiters, see
Command Line Option Delimiters .
101
Option Valid Arguments Description
Example:
A:>syscfg --asset
asset=ASSET
--biosver* None Reports the BIOS version for a system. If used with the -s option, the
environment variable is set to the BIOS version.
Example:
A:>syscfg --biosver
biosver=A08
--chassvctag* None Reports the chassis service tag on blade systems.
Example:
A:>syscfg --chassvctag
chassvctag=SVCTAG1
--cpucount* None Reports the number of processors found on the system.
Example 1:
A:>syscfg --cpucount cpucount=1
Example 2:
A:>syscfg --cpucount cpucount=2
--cpuspeed* None Reports the speed of all processors in a system.
Example:
A:>syscfg --cpuspeed
cpuspeed=1000MHz
--envfile <filename>Reads the environment variable file (included in DTK as sys.ini ) and
sets environment variables to names in the file, based on the system's
information. Primarily, this command performs a PCI scan and
matches the vendor/device numbers of the devices to those specified
in the environment variable file. For more information, see the
Environment Variable File.
Example:
A:>syscfg --envfile sys.ini
DELLNIC1=INTEL PRO100
DELLNIC2=INTEL PRO100
DVIDEO1=RAGEXL
DIDE1=PEQUR/ROSS IDE
DSCSI1=AIC-7899
--mem* None Reports the amount of system memory physically installed in the
system, not the amount of memory available to an operating system. If
used with the -s option, the environment variable is set to the amount
of system memory. The last two characters of the memory value
indicate the order of magnitude used (KB or MB).
Example:
A:>syscfg --mem
mem=256MB
102
Option Valid Arguments Description
-n <filename>Specifies an input file to use for resolving PCI vendor and device
numbers to strings. The file must be present (with read rights) and
contain a properly formatted list. For more information, see PCI
Reporting . This option must be used with the pci option.
Example:
A:>syscfg -n pci.txt --pci
PCI Bus: 2, Device: 4, Function: 0
Vendor: 8086 - Intel Corp.
Device: 1229 - 82557/8/9 [Ethernet Pro
100]
Sub Vendor:8086 - Intel Corp.
Sub Device:1017 - EtherExpress
PRO/100+ Dual Port Server Adapter
Slot: 01
Class: 02 - Network
SubClass: 00 - Ethernet
--ovrwrt* None When used with the outfile option, this option specifies that the
output file should be overwritten if it exists.
NOTE: This option is applicable only on PowerEdge systems prior
to 12G.
Example:
A:>syscfg -outfile=out.ini --ovrwrt
--pci* None Performs a scan of all PCI buses and displays the results. The utility
uses an open source pci.ids file for vendor/device name
resolution. The utility looks for a file called pci.ids in the current
working directory. If the file is not found in the current working
directory, the directory containing the SYSCFG executable is
searched. If the -n option is used to specify a filename, this filename
is used for resolution. If a specific filename is not given and the
pci.ids file cannot be found, Unknown is printed for all vendor and
device codes.
For more information, see PCI Reporting.
Example 1 (the pci.ids filename is specified in the command line
instance ):
A:>syscfg -n pci.ids --pci
PCI Bus: 0, Device: 0, Function: 0
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 1
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 2
Vendor: 1166 - ServerWorks
Device: 0000 - Unknown
103
Option Valid Arguments Description
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
None Example 2 (the pci.ids file is located in the same directory as the
utility so that names resolve):
A:>syscfg --pci
PCI Bus: 0, Device: 0, Function: 0
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 1
Vendor: 1166 - ServerWorks
Device: 0012 - CMIC-LE
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 2
Vendor: 1166 - ServerWorks
Device: 0000 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
None Example 3 (a pci.ids file does not exist) :
A:>syscfg --pci
PCI Bus: 0, Device: 0, Function: 0
Vendor: 1166 - Unknown
Device: 0012 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 1
Vendor: 1166 - Unknown
Device: 0012 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
PCI Bus: 0, Device: 0, Function: 2
Vendor: 1166 - Unknown
Device: 0000 - Unknown
Slot: 00
Class: 06 - Bridge
SubClass: 00 - CPU/PCI
-s <string>Sets an environment variable to the value of a function command
option. The string argument must be alphanumeric without any spaces
or symbols. The variable name must be in upper case. This option must
be used with at least one function command.
104
Option Valid Arguments Description
Example:
A:>syscfg -s ENVNAME --svctag
ENVNAME=SERVICE
--slot* None Reports the slot on a Blade system. If it is not a Blade system, the slot
is reported as 0. If used with the -s option, the environment variable is
set to the slot.
Example 1 (Blade systems) :
A:>syscfg --slot
slot=1
Example 2 (Rack and Tower systems) :
A:>syscfg --slot
slot=0
NOTE: This option is valid only for PowerEdge 1855 systems.
--svctag* None Reports the service tag for a system. If used with the -s option, the
environment variable is set to the BIOS version.
Example:
A:>syscfg --svctag
svctag=113CD1S
--sysasset* None Reports the system asset tag on Blade systems.
Example:
A:>syscfg --sysasset
sysasset=ASSET01
--sysid* None Reports the unique system id bytes for a server. Servers contain a
unique ID value based on their model. The ID value is reported as a
hexadecimal value with a leading 0x, lowercase hexadecimal letters,
and zero-padded to 2 bytes. If used with the -s general option, the
environment variable is set to the system ID.
Example:
A:>syscfg --sysid
sysid=0x00df
--sysname* None Reports the system identification string for a server, which is the string
displayed under the Dell logo during POST. If used with the -s option,
the environment variable is set to the system name.
Example:
A:>syscfg --sysname
sysname=PowerEdge 1550/1000
--syssvctag* None Reports the system service tag on a Blade system.
Example:
A:>syscfg --syssvctag
syssvctag=BLADE01
105
Option Valid Arguments Description
--uuid* None Reports the Unique User Identifier (UUID) for a system. The UUID is a
unique system identifier used in PXE requests.
Example:
A:>syscfg --uuid
uuid=44454C4C-5300-104C-8044- B1C04F423131
SYSCFG For IPv6 Configuration
The following table lists all valid options and arguments for IPv6 configuration along with a description of each option.
These options are applicable only if the DRAC on your system supports IPv6.
NOTE: On PowerEdge 12G and later systems, this option is available only with the appropriate installed license.
Table 54. SYSCFG Options and Arguments for IPv6 Configuration
Option Sub-option Valid Arguments Description
lancfgparam
sv6 or
lcpv6
--ipv6 enable,
disable
Enables or disables the IPv6 stack.
A:> syscfg lcpv6 --
ipv6=enable
--ipsrcv6=static
--ipaddrv6=
<ipv6address>
--
prefixlengthv6=<prefix
lengthv6>
--
gatewayv6=<ipv6gateway
address>
NA Allows you to manually configure IPv6
addresses.
A:>syscfg lcpv6
--ipsrcv6=static
--
ipaddrv6=1234:1234:1234::1
234
--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=<ipv6dnsse
rver1address>
NA Allows you to manually set the DNS
address.
--
linklocaladdripv6=<link
localaddripv6>
Allows you to view IPv6 addresses.
A:>syscfg lcpv6 --
linklocaladdripv6=134.56.4
5.233
106
Option Sub-option Valid Arguments Description
--gatewayv6=<gatewayv6>Allows you to view IP gatewayv6
address.
PCI Reporting
The scan of the PCI bus uses a file to resolve PCI vendor and device codes to vendor information strings. The format of
the PCI output is as follows:
PCI Bus: 2, Device: 4, Function: 0
Vendor: 8086 - Intel Corp.
Device: 1229 - 82557/8/9 [Ethernet Pro 100]
Sub Vendor:8086 - Intel Corp.
Sub Device:1017 - EtherExpress PRO/100+ Dual Port Server Adapter
Slot: 01
Class: 02 - Network
SubClass: 00 - Ethernet
If the file for vendor resolution is not present, the utility prints Unknown next to a vendor name. If the file for
environment variable names is not present, the utility fails the environment variable operation.
The pci.ids file is located at \DELL\TOOLKIT\TOOLS on Windows systems and /opt/dell/toolkit/bin on Linux systems. For
more information and examples, see the Options For System Configuration.
Environment Variable File
The environment variable file can be used for discovering and recording system information to environment variables.
The file consists of several sections with .ini format that map PCI vendor/device numbers to environment variable
values. The environment variable file is sys.ini in \DELL\TOOLKIT\TOOLS on Windows systems and on Linux systems, you
can find it in /opt/dell/toolkit/bin . For example, the [DELLNIC] section header designates that an environment
variable named dellnic1 should be set to the value of the name or value pair whose name matches the NIC's vendor
or device number. If multiple NICs are present on a system, the environment variables are numbered sequentially:
dellnic1, dellnic2 , and so on
Environmental Variable File Excerpt (sys.ini)
[DELLNIC]
;environment variable will be set to INTELPRO100F for
vendor 8086, dev 1001
8086,1001=INTELPRO1000F
;environment variable will be set to INTELPRO100T for
vendor 8086, dev 1004
8086,1004=INTELPRO1000T
;environment variable will be set to INTELPRO100XT for
vendor 8086, dev 1008
8086,1008=INTELPRO1000XT
The names of the environment variables can be changed in the Variable Names section. If a name is changed, the
section that corresponds to that name must be changed as well.
Also available in the .ini file is a section that maps the system ID number to a string. This string can be used to identify
the system during the discovery phase of deployment. The section name is the environment variable that is set to the
value of the name/value pair whose name matches the system ID. To change the name of the environment variable,
107
change the value of the MACHINE name in the Variable Names section, and change the corresponding section
name.
108
4
RAIDCFG
This section documents the Deployment Toolkit (DTK) RAID configuration utility. The RAIDCFG utility provides a single
command line tool that can configure all supported RAID controllers.
Features
The RAID configuration utility:
• Displays help and usage information.
• Reads configuration options from the Command Line Interface (CLI) parameters.
• Enumerates RAID controllers, physical disks, and virtual disks.
• Creates and deletes virtual disks.
• Logs activity to a given filename.
• Returns specific error codes and messages.
• Assigns and unassigns global and dedicated hot spares.
NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), you can find the RAIDCFG utility at \DELL
\x32\TOOLKIT\TOOLS or at \DELL\x64\TOOLKIT\TOOLS. In Linux, you can find it at/opt/dell/toolkit/bin.
Supported RAID Controllers
The RAIDCFG utility supports the following RAID controllers:
• PERC H310 Adapter, PERC H310 Mini Blade, PERC H310 Mini Monolithic, PERC H310 Embedded, PERC H710 Mini
Blade, PERC H710P Mini Blade, PERC H710 Adapter, and PERC H710 Adapter
• PERC H200 Integrated, PERC H200 Adapter, PERC H200 Embedded, PERC H700 Integrated, PERC H700 Adapter,
and PERC H800 Adapter
• PERC 6/E Adapter, PERC 6/I Integrated, and PERC 6/I Adapter
• PERC 6/I Integrated for blade systems
• PERC 5/E Adapter, PERC 5/I Integrated, and PERC 5/I Adapter
• PERC S110, PERC S100, and PERC S300 software controller (Not supported on 64-bit systems)
• CERC 6/I Integrated
• SAS 6iR Integrated and SAS 6iR Adapter
• SAS 5iR Integrated and SAS 5iR Adapter
RAIDCFG Dependencies
For the RAIDCFG utility to run successfully in Windows PE, the mr2kserv, lsivil.dll (for Windows) or lsivil.so (for Linux) and
sasvil.dll (for Windows) or sasvil.so (for Linux) must be in the same directory as RAIDCFG.
The mr2kserv is a service that is automatically started by the DTK startup script. This service is required to configure all
LSI RAID controllers in Windows PE and provides Plug and Play support.
109
RAIDCFG Options And Arguments
Table below lists all of the valid options, parameters, and arguments for the RAIDCFG utility. For more information on
valid RAIDCFG options and their specific uses, see RAID Configuration Utility Options and Arguments.
Mandatory command line options must be present in the command. Optional command line options can be typed in any
order after the mandatory options have been typed. Many options have both a short and long format. Short and long
format options cannot be used in the same command line instance.
Table below shows some examples of valid and invalid short and long format command line instances. For an
explanation of the specific order for each option, see RAID Configuration Utility Options And Arguments. For a list of
frequently used RAID commands, see Quick Reference To RAIDCFG Commands.
NOTE: Some of the following options or arguments might not be available on all systems.
Table 55. RAIDCFG Short and Long Format Options
Option Valid Arguments Short Description Mandatory or Optional
No option
-h
-?
or
/?
NA Displays general usage information
for the utility. The usage information
consists of a comprehensive list of
valid options, parameters, and
arguments.
Optional.
See General Help for
specific usage
information.
-ac or
action blink Blinks the specified physical disks on
the specified controller.
See Blinking And
Unblinking Array Disks for
specific usage
information.
cvd
or
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 Creating Virtual Disks
for specific usage
information.
ci
or
cancelinit
Cancels the slow or full initialization
on the selected virtual disk.
See Initializing Virtual
Disks for specific usage
information.
dvd
or
deletevdisk
Deletes a virtual disk. See Deleting Virtual Disks
for specific usage
information.
110
Option Valid Arguments Short Description Mandatory or Optional
dphs
or
disablepersistenthot
spare
Disables the controller Persistent Hot
Spare feature for the selected
controller.
See Enabling and
Disabling Persistent
Dedicated Hot Spares for
specific usage
information.
ephs
or
enablepersistenthots
pare
Enables the controller Persistent Hot
Spare feature for the selected
controller.
See Enabling and
Disabling Persistent
Dedicated Hot Spares for
specific usage
information.
fgnclr
or
foreignclear
Clears the foreign configuration for
the indicated controller.
See Importing and
Clearing Foreign
Configurations for
specific usage
information.
fgnrvr
or
foreignrecover
Recovers the Foreign configuration
for the indicated controller.
See Importing and
Clearing Foreign
Configurations for
specific usage
information.
fi
or
fastinit
Initializes the virtual disk for the
specified controller using
fastinitcommand.
See Initializing Virtual
Disks for specific usage
information.
lghs
or
listglobalhotspare
Displays the array (physical) disks
used for global hotspare for the
specified controller.
See Assigning,
Unassigning, And Listing
Global Hot Spares for
specific usage
information.
rghs
or
removeglobalhotspare
Unassigns all global hot spares to
disks on the specified controller.
See Assigning,
Unassigning, And Listing
Global Hot Spares for
specific usage
information.
rst
or
reset
Resets the selected controller. See Resetting The
Controller for specific
usage information.
sbf
or
setbootflag
Sets the indicated virtual disk as boot
VD on the indicated controller.
See Setting A Virtual Disk
As Bootable Virtual Disk
for specific usage
information.
sghs Assigns the specified disks as global
hot spares on the specified
controller.
Optional. SeeAssigning,
Unassigning, And Listing
Global Hot Spares for
111
Option Valid Arguments Short Description Mandatory or Optional
or
setglobalhotspare
specific usage
information.
sli
or
slowinit
Initializes the virtual disk for the
specified controller using the
slowinit command.
See Initializing Virtual
Disks for specific usage
information.
svdn
or
setvdname
Sets the name of the specified virtual
disk on the specified controller.
See Assigning,
Unassigning, And Listing
Global Hot Spares for
specific usage
information.
-ad or
adisk NA Specifies an array disk command. See Enumerating Array
Disks for specific usage
information.
ch:targ,
ch:targ, ...
or ch:targ:lun,...
or ch:targ:enc
channel:target, or
channel:target:lun,
or
channel:target:enclo
sure
Specifies an array disk.
For SCSI controllers, the value of
LUN should always be 0.
For SAS controllers, the value of
enclosure can be non-zero, in which
case you must specify values for
channel, target, and enclosure.
NOTE: You can also use
pdiskor -pd instead of
adiskor -adto specify an
array disk.
Optional.
See Enumerating Array
Disks for specific usage
information.
-c or
controlleri
d
<valid controller ID
number>
Specifies a RAID controller. See Enumerating RAID
Controllers for specific
usage information.
-cp or
cachepolicy
d, c or d, e Specifies the cache policy for reads
on a specified virtual disk or disk
cache policy.
Optional.
See Creating Virtual Disks
for specific usage
information.
-ctrl or
controller
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 Enumerating RAID
Controllers for specific
usage information.
-envc or
envcommand
<string>Sets a user-defined environmental
variable (<
string
>) to the value
returned from a function call.
See Setting Environment
Variables for specific
usage information.
-envn or
envname
<string>Sets the environment variable
(<
string
>) that equates to the value
returned from a function call.
See Setting Environment
Variables for specific
usage information.
112
Option Valid Arguments Short Description Mandatory or Optional
-fd or
failoverdri
ve
ch:targ, ch:targ, ...
or ch:targ:lun,...
or ch:targ:enc
channel:target, or
channel:target:lun,
or
channel:target:enclo
sure
Specifies the location of the failover
drive in an array.
For SCSI controllers, the value of
LUN should always be 0.
For SAS controllers, the value of
enclosure can be non-zero, in which
case you must specify values for
channel, target, and
enclosure.
NOTE: From DTK 2.4 onwards,
the -fd option creates
dedicated hot spares instead of
global hot spares. To set global
hot spares, see Assigning,
Unassigning, And Listing Global
Hot Spares.
Optional.
See Creating Virtual Disks
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 Miscellaneous
Options for specific usage
information.
-l or
logfile
<filename>Logs command line output to a file. Optional.
See Miscellaneous
Optionsfor specific usage
information.
-o <filename>Reads the RAID configurations from
all available controllers and write
these configurations in the given .ini
filename.
Mandatory.
See RAID Replication
Options for specific usage
information.
-r or raid <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, 0is
taken as the default level.
Optional.
See Creating Virtual Disks
for specific usage
information.
-rp or
readpolicy
ra, ara, nra, rc,
nrc
Sets the read policy for the virtual
disk.
Optional.
See Creating Virtual Disks
for specific usage
information.
-se or
setenvironm
ent
NA Sets a user-defined environment
variable to the value returned from
the function call. The function calls
are:
getcontrollerslots,
getfirmware,
getcontrollertype,
getadisks,
getadiskcount,
getfreeadisks,
getfreeadiskcount,
Mandatory.
See Setting Environment
Variables for specific
usage information.
113
Option Valid Arguments Short Description Mandatory or Optional
getfreeadisksize, and
gethotspares.
-si or
silent
NA Does not display any information on
the terminal console.
Optional.
See Miscellaneous
Options for specific usage
information.
-sp or
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 2for RAID
10, 3for RAID 50 and 4for RAID
60. The number of array disks for
creating virtual disks should not
be a prime number and should
be divisible by the specified
spanlength.
Mandatory.
See Creating Virtual Disks
for specific usage
information.
-sz or 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 Creating Virtual Disks
for specific usage
information.
-ssz or
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 Creating Virtual Disks
for specific usage
information.
-vd or
vdisk
NA Displays the virtual disks under all of
the controllers along with the
physical array disks that make up the
virtual disks.
See Enumerating Virtual
Disks for specific usage
information.
<valid virtual disk
ID number>
Displays the specified virtual disk. Optional.
See Enumerating Virtual
Disks for specific usage
information.
-ver or
version
NA Displays the version number of the
utility.
Optional.
See Miscellaneous
Options for specific usage
information.
-wp or
writepolicy
wb, wt, wc, nwc, fwb Sets the write policy for a virtual
disk. The valid arguments are: wb
(writeback caching), wt (write-
Optional.
See Miscellaneous
Options for specific usage
information.
114
Option Valid Arguments Short Description Mandatory or Optional
through caching), wc (write-
caching), nwc (no-write-caching),
and fwb (force-write-back).
RAID Configuration Utility Options And Arguments
The following tables document valid options, parameters, and arguments along with a description of the expected
behavior of each option. Options, parameters, and pre-defined arguments are case-sensitive and entered in lowercase,
unless stated otherwise. The information is grouped by task in the following sections:
•General Help
•Enumerating RAID Controllers
•Creating Virtual Disks
•Enumerating Array Disks
•Blinking And Unblinking Array Disks
•Enumerating Virtual Disks
•Deleting Virtual Disks
•Setting A Virtual Disk As Bootable Virtual Disk
•Blinking And Unblinking Virtual Disks
•Setting Virtual Disk Name
•Setting Environment Variables
•RAID Replication Options
•Assigning, Unassigning, And Listing Global Hot Spares
•Importing and Clearing Foreign Configurations
•Initializing Virtual Disks
•Resetting The Controller
•Enabling and Disabling Persistent Dedicated Hot Spares
•Miscellaneous Options
NOTE: Some of the following options or arguments may not be available on all systems.
General Help
The following table lists the RAIDCFG general help options.
Table 56. General Help
Option Parameters Valid Arguments Description
No option-h
-?
or
/?
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.
115
Option Parameters Valid Arguments Description
Example:
A:>raidcfg -h
RAIDCFG v4.2
Copyright (c) 2002-2012 Dell
Inc.
[raidcfg]
Help: options in <> are
mandatory and options in []
are optional and can be in any
order after mandatory ones.
raidcfg -h
Provides users with general
help options that may beused
with this utility.
raidcfg <controller>
raidcfg <-ctrl>
Lists all controllers on the
host and selects property
information.
—output continues, listing all
possible
option/parameter/argument
combinations—
Enumerating RAID Controllers
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating RAID controllers.
Table 57. Enumerating RAID Controllers
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ctrl or
controller 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 6/E
Channels: 2
No.of Virtual_Disks: 1
Array_Disks:
0:0:0,1:2:0,1:3:0,1:4:0,1:5:0
Firmware Version: 5130
Controller_ID/Slot_ID: 3
Controller_PCI_ID: 3:11:0
116
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
Controller_Name: PERC 6/E
Channels: 2
No.of Virtual_Disks: 0
Firmware Version: 3500
RAIDCFG Command successful!
-c or
controllerid
<valid
controller ID
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 6/E
Channels: 2
Virtual_Disks: 1
Firmware Version: 521S
RAIDCFG Command successful!
Creating Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for creating virtual disks.
NOTE: If you create a virtual disk on Windows PE, you must reboot your system.
117
Table 58. Creating Virtual Disks
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ctrl -ac=cvd -
c=id -ad=
ch:targ,ch:tar
g,
... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,...
channel:target
: lun,...
[or
channel:target
:
enclosure,...]
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!
-cp or
cachepolicy
d, c or d, e Sets the cache policy or disk cache policy.
The valid arguments for cache policy are:.
• d — (Direct I/O) Reads are not
buffered in cache memory.
• c — (Cache I/O) All reads are
buffered in cache memory.
NOTE: Cache policy is not supported on
controllers that do not have a battery.
Valid arguments for disk cache policy are:
• d — Disable
• e — Enable
The -cp option is optional and can be added
to the command line in any order after the
mandatory option combination.
-fd or
failoverdrive
ch:targ, ch:targ, ... or
ch:targ:lun,... or
ch:targ:enc
channel:target, or
channel:target:l un, or
channel:target:
enclosure
Sets the failover drive for the virtual disk. The
-fd option is optional and can be added to
the command line in any order after the
mandatory option combination.
NOTE: From DTK 2.4 onwards, the -fd
option creates dedicated hot spares
instead of global hot spares. For
information about setting global hot
spares, see Assigning, Unassigning, And
Listing Global Hot Spares.
For SCSI controllers, the value of LUN should
always be 0.
118
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
-r or -raid 0, 1, 5, 6, 10, 50, 60 Sets the RAID type or level for the virtual disk.
NOTE: If this option is not specified for
any RAID controller, RAID 0 is taken as
the default.
The valid arguments are:
• 0 — RAID 0 uses data striping, which
is writing data in equal-sized
segments across the array disks.
RAID 0 does not provide data
redundancy.
• 1 — RAID 1 is the simplest form of
maintaining redundant data. In RAID
1, data is mirrored or duplicated on
one or more drives.
• 5 — RAID 5 provides data redundancy
by using data striping in combination
with parity information. Rather than
dedicating a drive to parity, the parity
information is striped across all disks
in the array.
• 6 — RAID 6 is an extension of RAID 5
and uses an additional parity block. It
uses block-level striping with two
parity blocks distributed across all
member disks. RAID 6 provides
protection against double disk failures
and failures while a single disk is
rebuilding. In case there is only one
array, RAID 6 may be a better option
than a hotspare disk.
• 10 — RAID 10 is a stripe of mirrors.
Multiple RAID 1 mirrors are created,
and a RAID 0 stripe is created over
these.
• 50 — RAID 50 is a dual-level array
that uses multiple RAID 5 sets in a
single array. A single hard drive
failure can occur in each of the RAID
5 without any loss of data on the
entire array. Although the RAID 50 has
increased write performance, when a
hard drive fails and reconstruction
takes place, performance decreases,
data/program access is slower, and
transfer speeds on the array are
affected.
• 60 — RAID 60 is a combination of
RAID 6 and RAID 0. A RAID 0 array is
striped across RAID 6 elements. It
requires at least 8 disks.
119
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ctrl -ac=cvd -
c=id -ad=
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,
channel:target
: lun,...
[or
channel:target
:
enclosure,...]
-rp or
readpolicy
ra, ara, nra, rc, nrc CAUTION: If the controller is changed
from SCSI to RAID mode, expect data loss
to occur. Back up any data you want to
save before changing the modes.
Sets the SCSI read policy for the virtual disk.
Specify the SCSI read policy for the logical
drive. The valid arguments are:
•ra — (read-ahead) The controller
reads sequential sectors of the disk
when seeking data.
•ara — (Adaptive Read-Ahead) The
controller initiates read-ahead only if
the two most recent read requests
accessed sequential sectors of the
disk. If subsequent read requests
access random sectors of the disk,
the controller reverts to No-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:
• PERC 5/E Adapter, PERC 5/I
Integrated, PERC 5/i Adapter
• PERC 6/i Integrated, PERC 6/i
Adapter, PERC 6/E Adapter
• rc — (Read-Caching) Enables
read caching.
• nrc — (No-Read-Caching)
Disables read caching.
-ctrl -ac=cvd -
c=id -ad=
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,...
channel:target
: lun,...
-sp or
spanlength
<number>Creates a virtual disk comprised of the
properties supplied. The -spoption is optional
and can be the added to the command line in
any order after the mandatory option
combination.
NOTE: Spanlength is applicable only for
RAID 50 and RAID 60. The minimum
permissible spanlength value for RAID 50
is 3 and for RAID 60 is 4. The number of
array disks for creating a virtual disk
should not be a prime number and should
be divisible by the specified spanlength.
120
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
[or
channel:target
:
enclosure,...]
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
-ctrl -ac=cvd -
c=id -ad=
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,
channel:target
: lun,...
[or
channel:target
:
enclosure,...]
-ssz or
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 -sszoption is
optional and can be added to the command
line in any order after the mandatory option
combination. However, do not specify a unit
for stripe size when creating virtual disks. The
unit is always displayed in KB.
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
-ctrl -ac=cvd -
c=id -ad=
ch:targ,ch:tar
g , ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
: lun,
channel:target
: lun,... [or
channel:target
: enclosure,..
-str or 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 percentage, raidcfg
aborts.
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
-ctrl -ac=cvd
-c=id -ad=
ch:targ,ch:tar
g, ... [or
ch:targ:encl,.
..]
or
controller
action=
createvdisk
controllerid=
id adisk=
channel:target
-sz or -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 -szoption is optional and can be the
added to the command line in any order after
the mandatory option combination.
The minimum virtual disk size that you can
create for various controllers is given below.
• For PERC 5 controllers:
– RAID 0: 100 MB
121
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
: lun,...
channel:target
: lun,... [or
channel:target
:
enclosure,...]
– RAID 1: 100 MB
– RAID 5: 100 MB
• For PERC 6 controllers:
– RAID 0: 100 MB
– RAID 1: 100 MB
– RAID 5: 100 MB
– RAID 6: 100 MB
– RAID 60: 100 MB
• For PERC 7 and PERC 8 controllers:
– RAID 0: 100 MB
– RAID 1: 100 MB
– RAID 5: 100 MB
– RAID 6: 100 MB
– RAID 10: 100 MB
– RAID 50: 100 MB
– RAID 60: 100 MB
• Software RAID controllers:
– RAID 0: 100 MB
– RAID 1: 100 MB
– RAID 5: 100 MB
– RAID 10: 100 MB
NOTE: If this option is not provided,
RAIDCFG determines the maximum
possible virtual disk size and creates it.
-wp or
writepolicy
wb, wt, wc, nwc Sets the write policy for the virtual disk. The
valid arguments are:
•wb — Write-Back caching sets the
controller to send a write-request
completion signal as soon as the data
is in the controller cache but has not
yet been written to disk.
•wt — Write-Through caching sets the
controller to send a write-request
completion signal only after the data
is written to the disk.
NOTE: The wb and wt options are
supported on the following RAID
controllers only:
• PERC 5/E Adapter, PERC 5/I
Integrated, PERC 5/i Adapter
• PERC 6/i Integrated, PERC 6/i
Adapter, PERC 6/E Adapter
• PERC 7 and PERC 8
122
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
•wc — Write-Caching sets the
controller to send a write-request
completion signal only after the data
is written to the disk.
•nwc — No-Write-Caching specifies
that the controller does not send a
write-request completion signal after
the data is written to the disk.
NOTE: The -wpoption is optional and can
be added to the command line in any
order after the mandatory option
combination.
For SCSI controllers, the value of LUN should
always be 0.
For SAS controllers, the value of enclosure
can be non-zero, in which case you must
specify values for channel, target, and
enclosure.
Enumerating Array Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating array disks (hard
drives).
NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk.
Table 59. Enumerating Array Disks (Hard Drives)
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ad -c=id or
adisk
controllerid=i
d
NA NA Lists all the array disks attached to the
specified RAID controller. This option
combination is mandatory.
NOTE: The following example displays
output of a Series 7 controller.
NOTE: Software controller does not
display the NegSpeed, CapSpeed,
Certified and Supported
parameters.
Example:
A:>raidcfg -ad -c=2
Controller: PERC H700 Adapter
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
123
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:0:1
Size: 139392 MB (136 GB)
Avail: 0 MB
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:1:1
Size: 139392 MB (136 GB)
Avail: 0 MB
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:2:1
Size: 139392 MB (136 GB)
Avail: 139392 MB (136 GB)
RAIDCFG Command successful!
****** Physical Drive ******
Vendor: DELL(tm)
Model: ST9146703SS
Protocol: SAS
Media: HDD
NegSpeed: 6144 Mbps
CapSpeed: 6144 Mbps
Certified: YES
Supported: YES
Location: 0:3:1
Size: 139392 MB (136 GB)
Avail: 139392 MB (136 GB)
****** Physical Drive ******
Vendor: DELL
Model: ST9146802SS
Protocol: SAS
124
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
Media: HDD
NegSpeed: 3072 Mbps
CapSpeed: 3072 Mbps
Certified: YES
Supported: YES
Location: 0:4:1
Size: 139392 MB (136 GB)
Avail: 139392 MB (136 GB)
RAIDCFG Command successful!
-vd=id or
vdisk=id
Lists the array disks that make up the virtual
disk on the specified RAID controller. This
option combination is mandatory.
Example:
A:>raidcfg -ad -c=2 -vd=0
Controller: PERC 6/E
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!
-ad -c=id or
adisk
controllerid=i
d
-ad=
ch:targ,ch:t
arg,... adisk=
channel:tar
get,
channel:tar
get,...
<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 6/E
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:2:0
Drive Size: 34680 MB
Drive Avail: 34680 MB
RAIDCFG Command successful!
125
Blinking And Unblinking Array Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for blinking and unblinking array
disks (hard drives).
NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk.
Table 60. Blinking And Unblinking Array Disks
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ad -ad=
ch:targ,ch:tar
g ,... -
ac=blink -
c=id or adisk
adisk=
channel:target
,
channel:target
,... -ac=blink
controllerid=
id vdisk=id
NA NA Blinks the specified physical disks on the
specified controller.
Example:
A:>raidcfg -ad -ad=0:1,0:2
ac=blink -c=2
Controller: PERC 6/E
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:2:0
Drive Size: 34680 MB
Drive Avail: 34680 MB
RAIDCFG Command successful!
-ad -ad=
ch:targ,ch:tar
g ,... -ac=
unblink -c=id
or adisk adisk=
channel:target
,
channel:target
,... -ac=
unblink
controllerid=
id vdisk=id
NA NA Unblinks the specified physical disks on the
specified controller.
Example:
A:>raidcfg -ad -ad=0:1,0:2
ac=unblink -c=2
Controller: PERC 6/E
****** Physical Drive ******
Drive Vendor: SEAGATE
Drive Model: ST336607LC
Drive Location: 0:1:0
Drive Size: 34680 MB
Drive Avail: 0 MB
****** Physical Drive ******
Drive Vendor: FUJITSU
Drive Model: MAP3367NC
Drive Location: 0:2:0
Drive Size: 34680 MB
Drive Avail: 34680 MB
RAIDCFG Command successful!
Enumerating Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating virtual disks.
126
Table 61. Enumerating Virtual Disks
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
—vd or vdisk NA NA Lists all the virtual disks for each controller
along with the array disks that make up each
virtual disk. This option is mandatory.
Example:
A:>raidcfg -vd
Controller: PERC 6/E
Virtual disk not found
Controller: PERC 6/E
VDisk ID: 0
Size: 34680 MB
Type: RAID 1
Read Policy: Normal Read Ahead
Write Policy: Writeback
Cache Policy: Direct_IO
Drives: 0:0:0,0:1:0
Controller: PERC 6/E
Virtual disk not found
Controller: PERC 6/E
Virtual disk not found
RAIDCFG Command successful!
-vd or vdisk -c or
controller id
<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 6/E
VDisk ID: 0
Size: 34680 MB
Type: RAID 1
Read Policy: Normal Read Ahead
Write Policy: Writeback
Cache Policy: Direct_IO
Drives: 0:0:0,0:1:0
RAIDCFG Command successful!
-vd -c=id or
vdisk
controllerid=
id
-vd or vdisk <valid virtual disk ID
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 6/E
VDisk ID: 0
Size: 34680 MB
Type: RAID 1
Read Policy: Normal Read Ahead
Write Policy: Writeback
127
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
Cache Policy: Direct_IO
Drives: 0:0:0,0:1:0
Dedicated HS: 1:2:0
RAIDCFG Command successful!
Deleting Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for deleting virtual disks.
Table 62. Deleting Virtual Disks
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-vd -ac=dvd -
c=id
or
vdisk
action=deletev
disk
controllerid=i
d
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
or
vdisk
action=deletev
disk
controllerid=i
d
-vd or vdisk <valid virtual
disk ID
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!
NOTE: When virtual disks are created, the RAID controller starts the background initialization operation. Virtual
disks cannot be deleted until this operation completes. This limitation affects mostly CERC SATA controllers.
NOTE: If the raid.ini file contains the [Reset] section, then the RAIDCFG utility removes all the hot spares (dedicated
and global) and virtual disks on the specified RAID controllers in the system.
Setting A Virtual Disk As Bootable Virtual Disk
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting a virtual disk as a
bootable virtual disk.
Table 63. Setting A Virtual Disk As Bootable Virtual Disk
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-vd -ac=sbf -
c=id or vdisk
action=
-vd or vdisk <valid virtual
disk ID
number>
Sets the specified virtual disk as bootable
virtual disk on the specified controller.
128
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
setbootflag
controllerid=
id
Example:
A:>raidcfg -vd -ac=sbf -c=2 -
vd=0
RAIDCFG Command successful!
Blinking And Unblinking Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for blinking or unblinking a
physical disk associated with a virtual disk.
Table 64. Blinking And Unblinking Virtual Disks
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-vd -vd=id
ac=blink -c=id
or vdisk
vdisk=id
action=blink
controllerid=i
d
NA NA Blinks the physical disks associated with the
specified virtual disk on the specified
controller.
Example:
A:>raidcfg -vd -vd=2 -ac=blink
-c=2
RAIDCFG Command successful!
-vd -vd=id
ac=unblink -
c=id or vdisk
vdisk=id
action=blink
controllerid=i
d
NA NA Unblinks the physical disks associated with
the specified virtual disk on the specified
controller.
Example:
A:>raidcfg -vd -vd=2 -ac=blink
-c=2
RAIDCFG Command successful!
Setting Virtual Disk Name
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting the name of a virtual
disk on a controller.
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-vd -vd=id -
ac=svdn - vdn=
<string> -
c=id or vdisk
vdisk= id
action=
setvdname
vdname=<string
>
controllerid=
id
NA NA Sets the name of the specified virtual disk on
the specified controller.
Example:
A:>raidcfg -vd -vd=2 -ac=svdn -
vdn=xxx -c=2
RAIDCFG Command successful!
129
Setting Environment Variables
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting the CLI environment.
Table 65. Setting Environment
Mandatory Options and
Arguments Optional Parameters Valid Parameters
Arguments Description
-se -
envn=<string>
-envc=<function>
or
setenvironment
envname=<string>
envcommand=<funct
ion>
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=<function>
or
setenvironment
envname=<string>
envcommand=<funct
ion>
-f or filename <filename>Captures the environment output to the
given filename. This option either appends
the information to an existing file or creates
a new file.
-se -
envn=<string>
- envc=<function>
-c=id
or
setenvironment
envname=<string>
envcommand=<funct
ion>
controllerid=id
NA NA Sets a user-defined environment variable to
the value returned from the
getfirmware,
getcontrollertype, getadisks,
getadiskcount,
getfreeadisks,getfreeadiskcou
nt, getfreeadisksize, or
gethotspares function call. This option
combination is mandatory.
Example:
A:>raidcfg -se -envn=FIRMWARE
-envc=getfirmware -c=2
FIRMWARE=531T
RAIDCFG Command successful!
Function Calls of Setenvironment Option
The following table lists the function calls of the setenvironment option.
Table 66. Function Calls of the setenvironment Option
Function Call Description
getfirmware Returns the firmware version of the specified controllers.
130
Function Call Description
Example:
A:>raidcfg -se -envn=FIRMWARE -envc=
getfirmware -c=2
FIRMWARE=531T
RAIDCFG Command successful!
getcontrollertype Returns LSI for LSI controllers and ADAP for Adaptec controllers.
Example:
A:>raidcfg -se -envn=CONTROLLERTYPE -envc=
getcontrollertype -c=2
CONTROLLERTYPE=LSI
RAIDCFG Command successful!
getadisks Returns the array disks attached to the controller.
Example:
A:>raidcfg -se -envn=ADISKS -envc=getadisks -c=2
ADISKS=0:0:1,0:1:1,0:2:1
RAIDCFG Command successful!
getfreeadiskcount Returns the number of free array disks found in the specified controller.
Example:
A:>raidcfg -se -envn=FREEADISKCOUNT -envc=
getfreeadiskcount -c=2
FREEADISKCOUNT=2
RAIDCFG Command successful!
getfreeadisksize Returns the total size of the free array disks in megabytes.
Example:
A:>raidcfg -se -envn=FREEADISKSIZE -envc=
getfreeadisksize -c=2
FREEADISKSIZE=15346
RAIDCFG Command successful!
gethotspares Returns the global hot spares (global failover disks) found on the specified controller.
Example:
A:>raidcfg -se -envn=HOTSPARES -envc=
gethotspares -c=2
HOTSPARES=1:8:1,1:9:1
RAIDCFG Command successful!
131
Function Call Description
getfreeadisks Returns the free array disks.
A:>raidcfg -se -envn=GETFREEADISKS -envc=
getfreeadisks -c=2
GETFREEADISKS=0:3:1,0:4:1
RAIDCFG Command successful!
getadiskcount Returns the total number of array disks.
A:>raidcfg -se -envn=GETADISKCOUNT -envc=
getadiskcount -c=2
GETADISKCOUNT=1
RAIDCFG Command successful!
RAID Replication Options
The following table lists the RAID replication options.
Table 67. RAID Replication Options
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-i 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]
controllerid=0
size=65345
raid=1
readpolicy=ra
writepolicy=wt
132
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
stripesize=64
cachepolicy=d
adisk=0:3:1,0:4:1
NOTE: If the controller uses global hot
spares, the raid.ini file contains the
following section:
[GlobalHotspare0]
controllerid=0
failoverdrive=0:8:0
Assigning, Unassigning, And Listing Global Hot Spares
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for assigning and unassigning
global hot spares.
Table 68. Assigning, Unassigning, and Listing Global Hot Spares
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ctrl -ac=sghs
-c=id -ad|-pd=
ch:targ:encl
or
controller
action=setglob
alhotspare
controllerid=i
d adisk|
pdisk=channel:
target:enclosu
re
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!
-ad|-pd -
ac=lghs -c=id
or adisk|pdisk
-
action=listglo
balhotspare
controllerid=i
d
NA NA Displays the array (physical) disks used for
global hotspare for the specified controller.
Example:
A:>raidcfg -ad -ac=lghs -c=2
RAIDCFG Command successful!
-ctrl —ac=rghs
-c=id -ad|-pd=
ch:targ:encl or
controller
action=removeg
lobalhotspare
controllerid=i
d adisk|
pdisk=channel:
target:enclosu
re
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!
133
Importing And Clearing Foreign Configurations
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for foreign configurations.
Table 69. RAIDCFG Options for Foreign Configurations
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ctrl -c=id -
ac=fgnimp
or
controller
controllerid=i
daction=foreig
nimport
NA NA 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
-ctrl -c=id -
ac= fgnclr
or
controllercont
rollerid=id
foreignclear
NA NA 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
or
controller
controllerid=i
d
action=foreign
recover
NA NA Recovers the foreign configuration detected in
the selected controller. This feature is
supported on PERC 5 and later controllers and
is not supported on SAS controllers.
If you use this argument on a controller that
does not have a foreign configuration, the No
Foreign configuration present
in the controller message is
displayed.
Example:
A:>raidcfg -ctrl -c=2 -
ac=fgnrvr
Initializing Virtual Disks
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for initializing selected virtual
disks.
134
Table 70. Initializing Virtual Disks
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-vd -c=id -
vd=id -ac=fi or
vdisk
controllerid=i
d vdisk=id
action=fastini
t
NA NA Initializes the selected virtual disk in the
selected controller with the fastinit command.
This feature is supported on PERC 5 and later
controllers and is not supported on SAS
controllers.
Using the fastinit command on unsupported
controllers returns an error.
Example:
A:>raidcfg -vd -c=2 -vd=2 -
ac=fi
-vd -c=id -
vd=id -ac=sli
or vdisk
controllerid=i
d vdisk=id
action=slowini
t
NA NA Initializes the selected virtual disk in the
selected controller with the slowinit
command. This feature is supported on PERC 5
and later controllers and is not supported on
SAS controllers. Using the slowinit command
on unsupported controllers returns an error.
Example:
A:>raidcfg -vd -c=2 -vd=2 -
ac=sli
-vd -c=id -
vd=id -ac=ci or
vdisk
controllerid=i
d vdisk=id
action=canceli
nit
NA NA Cancels the initialization of the virtual disk
with the cancelinit command. This feature is
supported on PERC 5 and later controllers and
is not supported on SAS controllers. Using the
cancelinit command on unsupported
controllers returns an error.
Example:
A:>raidcfg -vd -c=2 -vd=2 -
ac=ci
Resetting The Controller
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for resetting the controller.
Table 71. Resetting The Controller
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
-ctrl -c=id -
ac=rst or
controller
controllerid=i
d action=reset
NA NA Resets the specified controller.
Example:
A:>raidcfg -ctrl -c=2 -ac=rst
Enabling And Disabling Persistent Dedicated Hot Spares
The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enabling and disabling
dedicated hot spares.
135
Table 72. Enabling And Disabling Persistent Dedicated Hot Spares
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
--ctrl -c=id -
ac=ephs
or
controller
controllerid=i
d
action=enablep
eristenthotspa
re
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
RAIDCFG Command successful!
--ctrl -c=id -
ac=dphs
or
controller
controllerid=i
d
action=disable
persistenthots
pare
NA NA Disables the persistent slot corresponding to
the hot spare drive. If the drive is removed
from the slot and any drive is inserted, the slot
stops functioning as a hot spare. You must
manually assign the drive as a hot spare
again.
Example:
A:>raidcfg -ctrl -ac=dphs -c=2
RAIDCFG Command successful!
Miscellaneous Options
The following table lists all other RAIDCFG options, parameters, and pre-defined arguments.
Table 73. Miscellaneous Optional Parameters
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
any option -l or logfile <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 6/E
Channels: 2
Virtual_Disks: 0
Firmware Version:
V2.8-0[6064]
RAIDCFG Command successful!
-si or 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
136
Mandatory Options
and Arguments Optional Parameters Valid Parameters
Arguments Description
order after any mandatory options have been
added.
Example:
A:>raidcfg -ctrl -si
-ver or
version
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 V4.2
Copyright (c) 2002-2012 Dell
Inc.
RAIDCFG Command successful!
Quick Reference To RAIDCFG Commands
The following table lists the basic RAIDCFG commands.
Purpose Command Description
To list all the RAID
controllers in a system
raidcfg -ctrl Lists all the RAID controllers in the system.
Record the slot ID of the controllers for later reference.
Example:
A:>raidcfg -ctrl -ac=sghs -c=2 -ad=0:1
RAIDCFG Command successful!
To list all the disks attached
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 5 GB 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 5 GB size for type RAID 1.
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 5
raidcfg -ctrl -
ac=cvd -c=slotid -
ad=
Creates a virtual disk of 5 GB size for type RAID 5.
The slot ID in <-c=slotid> and the array disks in <-
ad=...> are obtained from the first two commands.
137
Purpose Command Description
x:y,x:y,x:y,... -
sz=5GB -r=5
To create a virtual disk of a
certain size and make it
RAID 1 with a hot spare
raidcfg -ctrl -
ac=cvd -c=slotid -
ad= x:y,x:y -
sz=5GB -r=1 -
fd=x:y
Creates a virtual disk of 5 GB size for type RAID 1.
The slot ID in <-c=slotid> and the array disks in <-
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.
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
commands.
To delete a specific virtual
disk on a controller
raidcfg vdisk -
ac=dvd -c=slotid -
vd= vdiskid
Deletes a specific virtual disk on a controller.
The slot ID in <-c=slotid> is obtained from the first
command and the vdiskid in <-vd=vdiskid> is
obtained from command 10.
138
5
UPINIT
The UPINIT utility allows to create a utility partition (UP) on a hard drive, format the partition, and extract the partition
contents onto the disk.
Features
The UPINIT utility:
• Displays help and usage information.
• Returns specific error codes and messages.
NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), you can find the UPINIT utility in \DELL
\TOOLKIT\TEMPLATES\SCRIPTS. In Linux, you can find it in /opt/dell/toolkit/templates/scripts
Creating A Partition Using UPINIT
The size of the virtual disk where a utility partition is to be created must be a minimum of 8 GB.
UPINIT performs the following steps:
• Ensures that the UP image file is present and readable.
• Ensures that no partitions are present on the target disk.
• Creates a utility partition of type Dell Utility (DE). If there is an existing UP, UPINIT does not create a new one. It
only updates the existing UP. If no UP is found, UPINIT exits.
• Updates the boot sector with the UP boot sector image. If required, it updates the master boot record as well.
• Mounts the partition.
• Uncompresses the UP file onto the UP image.
• Unmounts the partition.
NOTE: On Windows PE, UPINIT runs as a batch file. In Linux, it runs as a shell script that uses standard Linux
commands to accomplish the same tasks as done by the Windows PE UPINIT utility. Both command lines are
identical and the output of the two utilities are identical when the same image is used.
UPINIT Dependencies
On systems running Linux, UPINIT looks for the following files:
•mbr file in the dell/drmk directory
•sysdrmk in the dell/toolkit/bin directory
On systems running Windows, UPINIT looks for the following files:
•createup.cfg , mountup.cfg , umountup.cfg , and listup.cfg in the DELL\TOOLKIT\TEMPLATE\SCRIPTS directory
•sysdrmk.exe in the DELL\TOOLKIT\TOOLS directory
139
UPINIT Options And Arguments
Table below lists the valid options and arguments for the UPINIT utility.
Table 74. UPINIT Options and Arguments
Option Valid Arguments Description
none none If no options are given, the tool outputs usage information. The usage
information is printed in the format shown below.
Example 1:
A:>upinit
upinit version 1.0
© 2012 Dell Inc. All rights reserved
upinit.sh --disk|-d=disk --size|-s=
size --file|-f=file
[--overwrite|-o] [--help|-h]
--help or -h prints help.
--disk or -d disk device on which to
create the Dell Utility Partition.
--size or -s Size in MB for the Dell
Utility Partition.
--file or -f filename of Dell Utility
Partition Image File.
--overwrite or -o Installs the Dell
Utility partition over an existing
one.
Example 2:
upinit --disk=/dev/sda --size=32 --
file=upimg.bin
In the example, upinit creates a Dell
Utility Partition of size 32 MB on
/dev/sda using upimg.bin file.
NOTE: The --overwrite option should be used for upgrading/
downgrading purposes. The --size option is not required when
using the --overwrite option because the --overwrite option does
not resize an existing Dell Utility Partition. If any partitions exist,
they are deleted.
-h none This function command requires an argument that matches a valid
option. If the argument matches a valid option, that option’s usage
information is displayed. This option cannot be used with other
options.
Windows PE Example:
upinit version 1.0
Copyright (c) 2002-2012 Dell Inc.
This utility creates a utility partition for
your system. This utility requires a Utility
Partition image file (upimg.bin) which can be
found under /opt/dell/toolkit/systems folder in
the Deployment Toolkit ISO. For more
information, please consult the Deployment
Toolkit Documentation.
140
Option Valid Arguments Description
Usage:
upinit.bat [--overwrite] --disk=ID or
-d=ID --size=size or -s=size
--file=file or -f=file
--help or -h prints usage.
--disk or -d ID of the disk on which
to create the Dell Utility Partition.
--size or -s Size in MB for the Dell
Utility Partition.
--file or -f Filename of the Dell
Utility Partition Image File.
--overwrite or -o Overwrites an
existing Dell Utility Partition.
Example:
upinit --disk=0 --size=32 --file= upimg.bin
In the example, upinit creates a Dell Utility Partition of size 32 MB
using the upimg.bin image file.
The --overwrite option should be used for upgrading/downgrading
purposes. The --size option is not required when using the --overwrite
option because the --overwrite option does not resize an existing Dell
Utility Partition. If any partitions exist, they are not deleted.
Linux Example:
upinit version 1.0
Copyright (c) 2002-2012 Dell Inc.
This utility creates a utility
partition for your system.
This utility requires a Utility
Partition image file (upimg.bin) which
can be found under
/opt/dell/toolkit/systems folder in
the Deployment Toolkit ISO. For more
information, please consult the
Deployment Toolkit Documentation.
Usage:
upinit.sh --disk|-d=disk --size|-s=
size --file|-f=file
[--overwrite|-o] [--help|-h]
--help or -h prints help.
--disk or -d disk device on which to
create the Dell Utility Partition.
--size or -s Size in MB for the Dell
Utility Partition.
--file or -f filename of Dell Utility
Partition Image File.
--overwrite or -o Installs the Dell
Utility partition over an existing
one.
Example:
upinit --disk=/dev/sda --size=32 --
file=upimg.bin
In the example, upinit creates a Dell Utility Partition of size 32 MB
on /dev/sda using the upimg.bin file.
The --overwrite option should be used for upgrading/downgrading
purposes. The --size option is not required when using the --overwrite
141
Option Valid Arguments Description
option because the --overwrite option does not resize an existing Dell
Utility Partition. If any partitions exist, they are not deleted.
disk integer, required
(Windows) string,
required (Linux)
Specifies the disk on which to create a utility partition. This disk is
checked to ensure that there are no existing partitions. Utility exits
with an error if the disk has partitions other than a utility partition.
Use option --overwrite to overwrite an existing utility partition.
Example:
A:>upinit --disk=0 --size=32 --file=
c:\upimage.bin (WinPE Example)
# upinit --disk=/dev/hda --size=32 --
file=/home/BIN/upimage.bin (Linux
Example)
size integer, required The size of the utility partition to create. The created utility is at least
the size specified by size and be as close to actual size as drive
geometry allows.
Example :
A:>upinit --disk=0 --size=32 --file=
c:\upimage.bin
file string, required Specifies a file that is decompressed onto the utility partition. This file
is checked for existence and availability before any partitions are
created on the disk. If the file is not specified, the utility simply create
the utility partition, format it, and exits. The user has to mount and
populate the utility partition. It is very unlikely that the user do NOT
specify the utility partition format.
Example:
A:>upinit --disk=0 --size=32 --file=
c:\upimage.bin
--overwrite string, optional Overwrites an existing utility partition. It does not create a new
partition or delete an existing partition.
142
6
Messages And Codes
This section documents the error messages and codes used in Dell OpenManage Deployment Toolkit (DTK).
SYSCFG Error Codes And Messages
The SYSCFG utility checks your commands for correct syntax and valid input. When you enter a command, a message is
displayed stating the results of the command.
Failure Messages
The SYSCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. The
following table lists SYSCFG error codes and messages.
Table 75. SYSCFG Error Codes and Messages
Error Code Message
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.
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.
143
Error Code Message
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.
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 Requested data length invalid.
42 Requested data field length limit exceeded.
43 Requested Sensor, data, or record not present.
44 Request data truncated.
45 Command response could not be provided.
144
Error Code Message
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.
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 ’%s’.
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.
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.
145
Error Code Message
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.
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 ’%s’does not have write permission.
94 The file contains invalid options ’%s’.
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.
146
Error Code Message
100 Help is not available for the option ’%s’.
101 The -x (--hex) option can only be used with -b or -r.
102 Input file '%s' not found.
103 Input file '%s' cannot be read.
104 Invalid argument for option '%s'.
105 Function table lookup error.
106 The machine ID was not found in the file '%s'.
107 The system memory information is not available.
108 Mode can only be used with the --pci option.
109 The device name or index must be present in the boot order.
110 The output file '%s' could not be opened. Please make sure the
path exists and the media is not write protected.
111 Could not write to output file, disk may be full.
112 The current password must be supplied with a new password
using --oldsyspwd.
113 The current password must be supplied with a new password
using --oldsetuppwd.
114 The current password can only be supplied when setting a new
password.
115 Actions are not allowed for this filter. Only alerts are
allowed.
116 There was an error getting the option '%s'.
117 The option '%s' is not available or cannot be configured
through software.
118 There was an error setting the option '%s'.
119 The -n (--namefile) option can only be used with - -pci.
120 The password may only contain alphanumeric characters.
121 The BIOS passwords have been disabled via jumper.
122 The password length must be between 1 and 32.
123 This password is locked and can only be unlocked by the admin
user.
124 There was an error setting the password.
125 The LCD string length must be between 1 and %s.
126 The LCD string may only contain alphanumeric characters.
127 There was an error setting the LCD string.
147
Error Code Message
128 The second channel can only be set if the RAID controller is
set to RAID.
129 The set operation, '%s', requires sub commands.
130 The service tag for this system is not available.
131 The system ID value is not available.
132 The system information string is not available.
133 A system error has occurred.
134 Usage error.
135 The uuid information is not present on this system
136 Version cannot be accompanied with any other option.
137 The self-identify blinker timer should be set to 0..255
second(s).
138 Encrypt key is too long.
139 Encrypt key is invalid, accepted characters are 0 to 9 or A to
F.
140 Parameter has been temporarily disabled due to a dependency on
other settings.
141 The old password supplied is incorrect. The new password will
not be set. Please try again.
142 Cannot stat /etc/omreg.cfg file. Please ensure /etc/omreg.cfg
file is present and is valid for your environment. You can
copy this file from the DTK iso.
143 Getting nicselection settings failed.
144 HAPI Driver Load Error.
145 Filter action power reduction is only supported for the system
power warn/fail filters.
146 TPM/TCM Clear settings requires setup password.
147 There is currently no TPM/TCM Clear request pending.
148 Password is not required for retrieving the ’%s’ options.
149 Setup password is required for setting the ’%s’ options.
150 Invalid Password override.
151 Invalid TPM/TCM set option.
152 There was an error setting the TPM/TCM option.
153 There is no setup password installed on this system.
154 The setup password supplied is incorrect. Please try again.
148
Error Code Message
155 Profile should be custom for setting cpupowermode,
memorypowermode and fanmode.
156 There was an error setting the Power Option.
157 The power cap value entered is out of range. Please try again.
158 The power cap value entered must be between 0 to 100 if unit
is percent.
159 Invalid IPv6 address. The IPv6 address cannot be link-local or
multicast.
160 Invalid IPv6 address. The IPv6 address specified has incorrect
address format.
161 Invalid IPv6 address. The gateway address specified has
incorrect address format.
162 Invalid IPv6 address. The Primary DNS server address specified
has incorrect address format.
163 Invalid IPv6 address. The Secondary DNS server address
specified has incorrect address format.
164 Invalid IPv6 address. The gateway address specified is
invalid.
165 Invalid configuration. Attempting to apply IPv6 configuration
on a non supported platform.
166 Invalid IPv6 configuration. Attempt to set DNS server address
manually while DNS address source is set to auto.
167 Invalid IPv6 configuration. Attempt to set IPv6 address
manually while IPv6 address source is set to auto.
168 Invalid IPv6 configuration. Attempting to apply IPv6
configuration without loading IPv6 stack.
169 Invalid IPv4 configuration. Attempting to apply IPv4
configuration with IPv4 disabled.
170 Invalid IPv6 configuration. Ipv6 address cannot be specified
without specifying prefix-length.
171 Invalid IPv6 configuration. dnssrcv6 cannot be set to auto
when ipsrcv6 is set to manual.
172 Error while executing IPMI Set command.
173 Error while executing IPMI Get command.
174 Error during Trap Alert.
175 Unspecified error.
176 Getting LCD settings failed.
177 Invalid configuration. Attempting to set cap when capenable is
set to disable.
149
Error Code Message
178 Invalid configuration. Attempting to set cap when hardware
does not support setting.
179 Invalid Configuration Option.
180 Cannot execute command. Parameter is illegal because command
sub-function has been disabled or is unavailable.
181 Failed to report the removable flash media redundancy status.
182 Failed to report the Internal SD Module status.
183 Error locating the Virtual Media Key on the Modular system.
184 Error in setting the redundancy option for the Internal SD
Modules.
185 Error in retrieving the redundancy option for the Internal SD
Modules.
186 Error in setting the redundancy option on Modular systems for
the Internal SD Modules.
187 Error in retrieving the vFlash option.
188 Error in setting the vFlash option.
189 Set failed due to dependency.
190 Set failed because attribute is forced to a value.
191 Cannot disable this OrderedList’s entries.
192 System busy, try again later.
193 New value not valid.
194 Not found.
195 System Services and/or CSIOR disabled.
196 Unable to set Password Status due to pending System Password
changes.
197 Password verification fail.
198 Set failed due to previously scheduled job.
199 Set failed because attribute is suppressed.
200 Generic failure.
201 XML path context creation failed.
202 Unable to parse XML.
203 Unable to connect IDRAC data manager.
204 'root' privileges required to execute this application.
205 Invalid alert destination.
150
Failures And Solutions
The following table lists the common SYSCFG failures and their solution.
Table 76. SYSCFG Failures and Solutions
Failure Messages Solutions
Generic failure. Indicates iDRAC is in bad state. Reboot iDRAC.
New value not valid. Make sure the changed value is valid.
Cannot disable this orderedList’s
entries.
BIOS does not support enabling or disabling of a particular boot order object.
System busy, try again later. Retry as iDRAC is busy with internal processing.
Unable to connect IDRAC data
manager.
Start data manager service using srvadmin_services (specific to Linux).
System Services and/or CSIOR
disabled.
Enable CSIOR from <F2> screen.
UPINIT Common Error Codes And Messages
The UPINIT utility checks your commands for correct syntax. When you enter a command, a message is displayed
stating the results of the command.
Failure Messages
The UPINIT utility failure messages provide error codes to help diagnose why some commands do not succeed. Table
below lists error codes and messages common to Linux and Microsoft Windows PE environments.
Table 77. UPINIT Common Error Codes and Messages
Error Code Message
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.
151
Error Code Message
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.
UPINIT Linux-Specific Error Codes And Messages
The list of error codes and messages are specific to the Linux environment.
Table 78. UPINIT Linux-Specific Error Codes and Messages
Error Code Message
31 Error: Invalid disk specified.
32 Error: Mount failed.
33 Cannot create mount point <mount point>.File exists
34 Error: fdisk failed.
UPINIT Windows PE-Specific Error Codes And Messages
The list of error codes and messages below are specific to the Windows PE environment.
Table 79. UPINIT Windows PE-Specific Error Codes and Messages
Error Code Message
31 Error: DISKPART failed.
32 Error: DISKPART command file not found.
RAIDCFG Error Codes And Messages
The RAIDCFG utility checks your commands for correct syntax when you enter them. When you enter a command, a
message displays stating the results of the command.
Failure Messages
The RAIDCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. See
table below for a list of the error codes and the associated messages.
Table 80. RAIDCFG Error Codes and Messages
Error Code Message
0 RAIDCFG Command successful!
1 Error! Incorrect Syntax.
152
Error Code Message
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.
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.
153
Error Code Message
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.
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.
154
Error Code Message
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.
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.
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.
155
Error Code Message
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.
100 Virtual Disk Requires Non Multilevel.
101 Virtual Disk Promote Operation failed.
102 Specified virtual disk has no drive letter assigned to it.
103 Cannot expose virtual disk.
104 Cannot reconfigure virtual disk.
105 Cannot stop the reconfiguration of the virtual disk.
106 SMART report count not supported.
107 Operations on hidden virtual disks are not allowed.
108 Virtual disk is in use.
109 The virtual disk is in use. It cannot be reconfigured at this
time.
110 Virtual disk operation is temporarily unavailable.
Initialization in progress.
111 Virtual disk operation is temporarily unavailable.
Reconstruction in progress.
112 Virtual disk operation is temporarily unavailable. Rebuild in
progress.
113 Virtual disk operation is temporarily unavailable. Check
consistency in progress.
114 Specified virtual disk too small.
115 Virtual disk operation not supported. Size too small.
116 Operation is temporarily unavailable. Space in use.
117 Cannot reconfigure to the given RAID level.
156
Error Code Message
118 Cannot reconfigure from current RAID level to the given RAID
level.
119 One of the array disks selected for the virtual disk is
already in use.
120 Virtual disk operation not supported. Cannot use non-RAID
disk.
121 Controller Read Configuration failed.
122 Controller Write Configuration failed.
123 Controller cache flush failed.
124 Enable alarm on controller failed.
125 Disable alarm on controller failed.
126 Quiet alarm on controller failed.
127 Controller failed to perform the task.
128 Specified bus not found for controller.
129 Call to set cache mode on the controller failed.
130 Unexpected controller error.
131 Controller out of memory.
132 Invalid controller state.
133 Controller failed.
134 Controller busy.
135 Controller does not exist.
136 Controller name is invalid.
137 Controller is iterated.
138 Rename of virtual disk was not successful.
139 The controller was not able to erase the file system from the
specified virtual disk.
140 The controller was not able to add space to the specified
concatenation set.
141 The controller was not able to get the status of the specified
mirror set.
142 The controller was not able to set the requested failover
space.
143 The controller cannot get the failover space information.
144 Controller cannot unmirror the specified virtual disk.
145 The controller could not split the specified virtual disk.
157
Error Code Message
146 The controller could not lock the specified virtual disk.
147 Controller IO paused.
148 No controller parameter support.
149 Controller does not recognize parameter symbol.
150 Controller Battery Recondition failed.
151 Controller Get disk signature failed.
152 Controller Read Flags failed.
153 Controller Set Flags failed.
154 Controller Remove Snap Shot failed.
155 Controller not supported.
156 Controller device initialization failure.
157 Partner controller already opened readwrite.
158 No partner controller found.
159 The virtual disk is not valid for requested operation.
160 Cannot communicate with controller.
161 Set operation failed.
162 Operation to update error count of SMART device has failed.
163 Operation to clear error count of SMART device has failed.
164 Driver could not execute.
165 Cannot delete virtual disk.
166 Cannot set temperature probe. Invalid value entered.
167 Cannot set enclosure tag. Invalid value entered.
168 Cannot set enclosure alarm.
169 Temperature probe value out of range.
170 Cannot set cache mode.
172 Data will be lost on the secondary disk and a reboot will be
forced.
173 Cluster Services (MSCS) is running. Deleting a virtual disk
that contains a cluster resource can result in unpredictable
errors or system hangs (quorum disk). You should shut down
cluster services before deleting cluster resources. Are you
sure you want to proceed?
174 Cannot perform Create Virtual Disk or Delete Virtual Disk
while the other server in a cluster is online. Please shut one
of the servers down and retry the operation.
158
Error Code Message
176 Invalid array disks or failover drives selected for
reconfigure/create operation. Please make sure that all array
disks and failover drives associated with the virtual disk are
selected.
177 The maximum number of partitions have already been created on
one of the selected array disk(s). Each array disk can hold
portions (partitions) of up to 10 virtual disks. This virtual
disk cannot be created because one or more array disk(s) have
reached the partition limit.
178 The virtual disk is in use. Please close any applications that
use the virtual disk and unmount any file systems that reside
on the virtual disk.
179 The firmware version is not supported. Please update the
firmware from http://support.dell.com.
180 The specified device does not have enough free space to be
used as failover space for the specified virtual disk.
181 The operation failed. Please rescan the controller and retry
the operation.
182 The operation cannot be performed while a task is running on
the specified virtual disk.
183 The specified virtual disk has no dead disk segments.
184 The operation cannot be performed at this time. The firmware
can recondition a battery that has a Degraded or Power Low
state. The firmware will not recondition a battery that is
functioning normally or that has a Ready, Failed or Missing
state.
185 The version of the controller firmware installed on your
system does not support this operation.
186 There are no disks of the correct type available to be
assigned as a hot spare.
187 There are no disks of sufficient size available to be assigned
as a hot spare.
188 There are no disks of the correct type and sufficient size
available to be assigned as a hot spare.
189 The Create Virtual Disk task was successful but the operating
system may not be aware of the new virtual disk.
191 The import of foreign configurations is complete. Some
configurations could not be imported.
192 Enable alarm command failed. The enclosure processor is busy
or a firmware download is in progress.
193 Disable alarm command failed. The enclosure processor is busy
or a firmware download is in progress.
159
Error Code Message
194 Quiet alarm command failed. The enclosure processor is busy or
a firmware download is in progress.
195 An error occurred while resetting a temperature probe.
200 No array disks found!
201 Invalid Virtual Disk ID!
202 RAID Type & Size are required to create a virtual disk. Ensure
that the RAID type and the size are correct.
203 Invalid Environment command!
204 File is not writable!
205 Setting Environment Variable Command failed!
206 Filename is not provided!
207 Invalid Strict option! Please provide a valid number between 1
and 100.
208 Span depth is not needed for this RAID type.
209 Array disk(s) cannot be part of virtual disk(s) and also be
hotspares.
210 Cannot have silent and logfile switch with the same command.
211 Invalid array disk(s)!
212 Invalid failover disk(s)!
213 Creation of a virtual disk on this RAID controller requires
the use of the entire disk space of the array disks. The size
or - sz parameter is not needed.
214 Invalid size given! size=max or -sz=max is not supported for
this RAID controller.
215 The value given for envname or -envn is null or too long.
216 Invalid virtual disk size!
217 The strict option provided failed! Virtual disk is not
created.
218 Unable to determine optimum size for Virtual disk. Ensure that
the array disks are of the same protocol (i.e. SAS, SATA,
SCSI). If there is a mismatch of the array disks then the
RAIDCFG will not be able to determine the optimum size. In
addition, also ensure that there is drive size available for
the specified virtual disk.
219 One or more array disks selected to create virtual disk or
hotspare doesn't have enough disk space. Please make sure that
all the array disks and failover drives selected have enough
free space.
160
Error Code Message
220 The number of array disks provided is incorrect for the
requested RAID Type! RAID 1 requires exactly 2 array disks,
RAID 5 requires at least 3 array disks, RAID 10 requires at
least 4 array disks and RAID 50 requires at least 6 array
disks.
221 Input file cannot be read.
222 Input file not found.
223 Error in opening the file.
RACADM Firmware Error Codes And Messages
Table below lists RACADM firmware error codes and messages.
Table 81. RACADM Firmware Error Codes and Messages
Error Code Message
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
161
Error Code Message
22 PCI ERROR
23 SERVER IS IN GRAPHICS MODE
24 SYSTEM DATE AND TIME NOT SET
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
52 MODULE NOT LOADED
53 IPMI ERROR
54 ERROR IN DIAGNOSTIC FUNCTION
162
RACADM Utility Error Codes And Messages
Table below lists RACADM utility error codes and messages.
Table 82. RACADM Error Codes and Messages
Error Code Message
513 An unknown failure occurred.
514 Librac library not initialized.
515 An invalid parameter was passed into function.
516 Invalid DRSTYPE specified.
517 Librac library already initialized.
518 Invalid transport type specified.
519 Invalid library user.
520 A connection to the RAC controller could not be established.
521 Failed to perform read operation with RAC controller.
522 Failed to perform write operation with RAC controller.
523 Invalid message ID.
524 Invalid message type.
525 Invalid response message.
526 Specified user buffer is too small to hold data.
527 Authentication failed - Invalid user name or password.
528 Invalid CHAP protocol response encountered.
529 CHAP buffer too small.
530 Timeout occurred.
531 Insufficient user privileges to perform operation.
532 TFTP write error encountered.
533 TFTP read error encountered.
534 TFTP local file write error encountered.
535 TFTP local file read error encountered.
536 TFTP write request failed.
537 TFTP read request failed.
538 Failed to open file.
539 Failed to load socket library.
540 Invalid socket library.
541 Unable to resolve HostName.
163
Error Code Message
542 Failed to create socket.
543 Socket read operation failed.
544 Socket write operation failed.
545 Failed to create SSL context object.
546 Failed to create SSL BIO object.
547 Unable to create SSL socket connection.
548 Failed to initialize socket.
549 Failed to login to RAC successfully.
550 Invalid session ID specified.
551 Failed to logout from RAC successfully.
552 Command execution failed.
553 FTP Get operation failed.
554 FTP Put operation failed.
555 Failed to initialize FTP interface.
556 Failed to load SSL library.
557 Failed to initialize librac library.
558 Invalid session ID.
559 SpcmpObjectName failed.
560 SpcmpObjectIdGet failed.
561 SpcmpObjectIdSet failed.
562 Failed to send SPCMP message to RAC.
563 Invalid transport session info.
564 LAN Proxy error - please make sure your proxy settings are
configured correctly.
565 RAC service not currently installed.
566 RAC service is not started.
567 RAC service is starting.
568 RAC controller not present.
569 RAC controller is currently resetting.
164
7
BMC Platform Events Filter Alert Messages
All possible Platform Event Filter (PEF) Alert Messages along with a description of each event are listed in the table
below
Table 83. BMC PEF Alert Events
Event Description
Fan Probe
Failure
The fan is running too slow or not at all.
Voltage Probe
Failure
The voltage is too low for proper operation.
Discrete
Voltage Probe
Failure
The voltage is too low for proper operation.
Temperature
Probe Warning
The temperature is approaching excessively high or low limits.
Temperature
Probe Failure
The temperature is either too high or too low for proper operation.
Chassis
Intrusion
Detected
The system chassis has been opened.
Redundancy (PS
or Fan)
Degraded
Redundancy for the fans and/or power supplies has been reduced.
Redundancy (PS
or Fan) Lost
No redundancy remains for the system's fans and/or power supplies.
Processor
Warning
A processor is running at less than peak performance or speed.
Processor
Failure
A processor has failed.
PPS/VRM/DCtoDC
Warning
The power supply, voltage regulator module, or DC-to-DC converter is pending a failure
condition.
Power
Supply/VRM/D2D
Failure
The power supply, voltage regulator module, or DC-to-DC converter has failed.
Hardware log
is full or
emptied
Either an empty or a full hardware log requires administrator attention.
165
Event Description
Automatic
System
Recovery
The system is hung or is not responding and is taking an action configured by Automatic
System Recovery.
System Power
Probe Warning
The system is setting actions when a power consumption probe detects a warning value.
System Power
Probe Failure
The system is setting actions when a power consumption probe detects a failure value.
166
8
Sample File Formats
This appendix lists the sample SYSCFG utility .ini, RAIDCFG utility .ini, and the RACADM utility .ini files.
Sample SYSCFG Utility .ini File Format
[syscfg]
;SystemModelName=poweredge r620
;SystemBiosVersion=0.3.16
;SystemServiceTag=MDN2345
;SystemManufacturer=dell inc.
;SysMfrContactInfo=www.dell.com
;SysMemSize=4.0 gb
;SysMemType=ecc ddr3
;SysMemSpeed=1067 mhz
;SysMemVolt=1.35v
;VideoMem=16 mb
MemTest=enable
MemOpMode=adveccmode
;NodeInterleave=disable
SerialDbgOut=disable
LogicalProc=enable
QpiSpeed=maxdatarate
ProcVirtualization=enable
ProcAdjCacheLine=enable
ProcHwPrefetcher=enable
DcuStreamerPrefetcher=enable
DcuIpPrefetcher=enable
ProcExecuteDisable=enable
ProcCores=all
;Proc64bit=yes
;ProcCoreSpeed=2.30 ghz
;Proc1Id=06-2d-2
;Proc1Brand=[genuine intel(r) cpu @ 2.30ghz
]
;Proc1L2Cache=8x256 kb
;Proc1L3Cache=20 mb
;Proc1NumCores=8
EmbSata=ahcimode
;SataPortE=auto
;SataPortEModel=unknown
;SataPortEDriveType=unknown device
;SataPortECapacity=n/a
;SataPortF=auto
;SataPortFModel=unknown
;SataPortFDriveType=unknown device
;SataPortFCapacity=n/a
BootMode=bios
BootSeqRetry=disable
IntegratedRaid=enable
UsbPorts=allon
InternalUsb=on
IntegratedNetwork1=enable
OsWatchdogTimer=disable
167
IoatEngine=disable
;EmbVideo=enable
SriovGlobalEnable=disable
SerialComm=onnoconredir
SerialPortAddress=serial1com1serial2com2
ExtSerialConnector=serial1
FailSafeBaud=115200
ConTermType=vt100vt220
RedirAfterBoot=enable
SysProfile=perfperwattoptimizeddapc
;ProcPwrPerf=sysdbpm
;MemFrequency=maxperf
;ProcTurboMode=enable
;ProcC1E=enable
;ProcCStates=enable
;MemPatrolScrub=standard
;MemRefreshRate=1x
;MemVolt=autovolt
;AesNi=enable
PasswordStatus=unlocked
TpmSecurity=off
;TpmActivation=nochange
;TpmClear=no
;IntelTxt=off
LocalBiosUpdateSupport=enable
PwrButton=enable
NmiButton=enable
AcPwrRcvry=last
AcPwrRcvryDelay=immediate
;AcPwrRcvryUserDelay=60
AssetTag=
NumLock=on
ReportKbdErr=report
ErrPrompt=enable
Characterization=enable
BootSeq=Floppy.iDRACVirtual.1-
1,Optical.iDRACVirtual.1-1
;UefiBootSeq=NIC.Integrated.1-1-1,NIC.Integrated.1-2-
1,NIC.Integrated.1-3-1,NIC.Integrated.1-4-
1,Optical.iDRACVirtual.1-1,Floppy.iDRACVirtual.1-1
OneTimeBootMode=disable
;OneTimeBootSeqDev=floppy.idracvirtual.1-1
;OneTimeUefiBootSeqDev=nic.integrated.1-1-1
Slot1=enable
Slot2=enable
Slot3=enable
extserial=com1
lancfgparams
alertdest=1
destipaddr=0.0.0.0
lancfgparams
alertdest=2
destipaddr=0.0.0.0
lancfgparams
alertdest=3
destipaddr=0.0.0.0
lancfgparams
alertdest=4
destipaddr=0.0.0.0
commstring=public
;gateway=10.94.132.1
;ipaddress=10.94.132.131
ipaddrsrc=dhcp
nicselection=dedicated
168
autoneg=enable
dnsserver1=0.0.0.0
dnsserver2=0.0.0.0
dnsdhcp=disable
dnsracname=idrac
dnsregisterrac=disable
domainname=
domainnamednsdhcp=disable
fullduplex=enable
speed=100Mbps
;subnetmask=255.255.255.0
vlanid=1
vlanpriority=0
vlantag=disable
lancfgparamsv6
;dnssrcv6=static
;gatewayv6=::
;ipv6address1=::
ipv6=disable
;ipaddrv6=::
;ipsrcv6=auto
;linklocaladdrv6=::
;prefixlengthv6=0
;dnsserver1v6=::
;dnsserver2v6=::
;ipv6address2=::
lanchannelaccess
ipmioverlan=alwaysavail
channelprivlmt=administrator
pefalerting=disable
lanuseraccess
userid=2
usrprivlmt=administrator
lanuseraccess
userid=3
usrprivlmt=noaccess
lanuseraccess
userid=4
usrprivlmt=noaccess
lanuseraccess
userid=5
usrprivlmt=noaccess
lanuseraccess
userid=6
usrprivlmt=noaccess
lanuseraccess
userid=7
usrprivlmt=noaccess
lanuseraccess
userid=8
usrprivlmt=noaccess
lanuseraccess
userid=9
usrprivlmt=noaccess
lanuseraccess
userid=10
usrprivlmt=noaccess
lanuseraccess
userid=11
usrprivlmt=noaccess
lanuseraccess
userid=12
usrprivlmt=noaccess
lanuseraccess
169
userid=13
usrprivlmt=noaccess
lanuseraccess
userid=14
usrprivlmt=noaccess
lanuseraccess
userid=15
usrprivlmt=noaccess
lanuseraccess
userid=16
usrprivlmt=noaccess
lcd=servicetag
nmibutton=enable
pefcfgparams
alertpolnum=1
alertpolstatus=disable
pefcfgparams
alertpolnum=2
alertpolstatus=disable
pefcfgparams
alertpolnum=3
alertpolstatus=disable
pefcfgparams
alertpolnum=4
alertpolstatus=disable
pefcfgparams
filter=fanfail
filteralert=enable
filteraction=none
pefcfgparams
filter=discretevoltfail
filteralert=enable
filteraction=none
pefcfgparams
filter=tempwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=tempfail
filteralert=enable
filteraction=none
pefcfgparams
filter=intrusion
filteralert=enable
filteraction=none
pefcfgparams
filter=redundegraded
filteralert=enable
filteraction=none
pefcfgparams
filter=redunlost
filteralert=enable
filteraction=none
pefcfgparams
filter=procwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=procfail
filteralert=enable
filteraction=none
pefcfgparams
filter=powerwarn
filteralert=enable
170
filteraction=none
pefcfgparams
filter=powerfail
filteralert=enable
filteraction=none
pefcfgparams
filter=hardwarelogfail
filteralert=enable
pefcfgparams
filter=autorecovery
filteralert=enable
pefcfgparams
filter=procabsent
filteralert=enable
filteraction=none
pefcfgparams
filter=powerabsent
filteralert=enable
filteraction=none
pefcfgparams
filter=batterywarn
filteralert=enable
filteraction=none
pefcfgparams
filter=batteryfail
filteralert=enable
filteraction=none
pefcfgparams
filter=systempowerwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=systempowerfail
filteralert=enable
filteraction=none
pefcfgparams
filter=discretesdcardfail
filteralert=enable
filteraction=none
pefcfgparams
filter=discretesdcardpresent
filteralert=enable
filteraction=none
pefcfgparams
filter=discretesdcardwarn
filteralert=enable
filteraction=none
pefcfgparams
filter=ripsfail
filteralert=enable
filteraction=none
pefcfgparams
filter=ripsoffline
filteralert=enable
filteraction=none
pefcfgparams
filter=ripsredundancylost
filteralert=enable
filteraction=none
hostname=
powerbutton=enable
serialcfgparams
connectionmode=basic
msgcommbitrate=19200
171
msgcommflowctrl=noflowctrl
tmcfgdelctrl=del
tmcfgechoctrl=echo
tmcfghandshakectrl=enable
tmcfginputnewlineseq=cr
tmcfglineediting=enable
tmcfgnewlineseq=crlf
serialchannelaccess
ipmioverserial=alwaysavail
channelprivlmt=administrator
serialuseraccess
userid=2
usrprivlmt=administrator
serialuseraccess
userid=3
usrprivlmt=noaccess
serialuseraccess
userid=4
usrprivlmt=noaccess
serialuseraccess
userid=5
usrprivlmt=noaccess
serialuseraccess
userid=6
usrprivlmt=noaccess
serialuseraccess
userid=7
usrprivlmt=noaccess
serialuseraccess
userid=8
usrprivlmt=noaccess
serialuseraccess
userid=9
usrprivlmt=noaccess
serialuseraccess
userid=10
usrprivlmt=noaccess
serialuseraccess
userid=11
usrprivlmt=noaccess
serialuseraccess
userid=12
usrprivlmt=noaccess
serialuseraccess
userid=13
usrprivlmt=noaccess
serialuseraccess
userid=14
usrprivlmt=noaccess
serialuseraccess
userid=15
usrprivlmt=noaccess
serialuseraccess
userid=16
usrprivlmt=noaccess
solaction
userid=2
action=enable
solaction
userid=3
action=disable
solaction
userid=4
action=disable
172
solaction
userid=5
action=disable
solaction
userid=6
action=disable
solaction
userid=7
action=disable
solaction
userid=8
action=disable
solaction
userid=9
action=disable
solaction
userid=10
action=disable
solaction
userid=11
action=disable
solaction
userid=12
action=disable
solaction
userid=13
action=disable
solaction
userid=14
action=disable
solaction
userid=15
action=disable
solaction
userid=16
action=disable
solcfgparams
solbitrate=115200
solcharaccuminterval=10
solcharsendthreshold=255
solenable=enable
solprivlevel=administrator
sysid=04CE
sysname=PowerEdge R620
useraction
userid=2
action=enable
useraction
userid=3
action=disable
useraction
userid=4
action=disable
useraction
userid=5
action=disable
useraction
userid=6
action=disable
useraction
userid=7
action=disable
useraction
userid=8
173
action=disable
useraction
userid=9
action=disable
useraction
userid=10
action=disable
useraction
userid=11
action=disable
useraction
userid=12
action=disable
useraction
userid=13
action=disable
useraction
userid=14
action=disable
useraction
userid=15
action=disable
useraction
userid=16
action=disable
username
userid=2
name=root
username
userid=3
name=NULL
username
userid=4
name=NULL
username
userid=5
name=NULL
username
userid=6
name=NULL
username
userid=7
name=NULL
username
userid=8
name=NULL
username
userid=9
name=NULL
username
userid=10
name=NULL
username
userid=11
name=NULL
username
userid=12
name=NULL
username
userid=13
name=NULL
username
userid=14
name=NULL
174
username
userid=15
name=NULL
username
userid=16
name=NULL
;uuid=44454C4C4400104E8032CDC04F333435
virtualmedia=auto
Sample RAIDCFG Utility .ini File Format
[Reset]
controllerid=1,2,3,6
[vdisk0]
controllerid=4
size=139392
raid=1
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=d
adisk=0:1:1,0:0:1
[vdisk1]
controllerid=4
size=139392
raid=1
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=c
adisk=0:3:1,0:2:1
[vdisk2]
controllerid=2
size=278784
raid=0
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=d
adisk=0:5:1,0:4:1
failoverdrive=0:9:1
[vdisk3]
controllerid=4
size=278784
raid=5
readpolicy=ra
writepolicy=wb
stripesize=64
cachepolicy=c
adisk=0:8:1,0:7:1,0:6:1
[GlobalHotspare0]
controllerid=0
failoverdrive=0:8:0
Sample RACADM Utility .ini File Format
[idRacInfo]
#idRacType=0x05
#idRacProductInfo=Dell Remote Access Controller 5
#idRacDescriptionInfo=This system component provides
a complete set of #remote management functions for
175
Dell PowerEdge servers.
#idRacVersionInfo=1.20 (Build 01.17)
idRacName=DRAC 5
idRacMisc=
[cfgLanNetworking]
cfgNicEnable=1
cfgNicIpAddress=10.98.8.121
cfgNicNetmask=255.255.255.0
cfgNicGateway=192.168.0.1
cfgNicUseDhcp=0
#cfgNicMacAddress=00:11:43:34:5f:4a
cfgDNSServersFromDHCP=0
cfgDNSServer1=192.168.0.5
cfgDNSServer2=192.168.0.6
cfgDNSRegisterRac=0
cfgDNSRacName=RAC-HHS7C1S
cfgDNSDomainNameFromDHCP=0
cfgDNSDomainName=MYDOMAIN
[cfgCurrentLanNetworking]
#cfgNicCurrentIpAddress=10.98.8.121
#cfgNicCurrentNetmask=255.255.255.0
#cfgNicCurrentGateway=192.168.0.1
#cfgNicCurrentDhcpWasUsed=0
#cfgDNSCurrentDhcpWasUsed=0
#cfgDNSCurrentServer1=192.168.0.5
#cfgDNSCurrentServer2=192.168.0.6
#cfgDNSCurrentDomainName=MYDOMAIN
[cfgRemoteHosts]
cfgRhostsSmtpEmailEnable=1
cfgRhostsFwUpdateTftpEnable=1
cfgRhostsSmtpServerIpAddr=127.0.0.1
cfgRhostsFwUpdateIpAddr=192.168.0.4
cfgRhostsFwUpdatePath=
[cfgUserAdmin]
#cfgUserAdminIndex=1
cfgUserAdminUserName=root
#cfgUserAdminPassword=
cfgUserAdminPrivilege=0
cfgUserAdminAlertFilterRacEventMask=0x300000
cfgUserAdminAlertFilterSysEventMask=0x77777
cfgUserAdminEmailEnable=0
cfgUserAdminEmailAddress=
cfgUserAdminEmailCustomMsg=
[cfgSessionManagement]
cfgSsnMgtMaxSessions=0x4
cfgSsnMgtMaxSessionsPerUser=0x4
[cfgSerial]
cfgSerialBaudRate=115200
cfgSerialConsoleEnable=0
cfgSerialConsoleQuitKey=<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
176
cfgNetTuningIpSubnetsAreLocal=0x1
cfgNetTuningIpReassTtl=0x3c
cfgNetTuningTcpMsl=0x3c
cfgNetTuningNicAutoneg=1
cfgNetTuningNic100MB=1
cfgNetTuningNicFullDuplex=1
[cfgOobSnmp]
cfgOobSnmpTrapsEnable=1
cfgOobSnmpAgentEnable=1
cfgOobSnmpAgentCommunity=public
[cfgRacTuning]
cfgRacTuneFwUpdateResetDelay=0x46
cfgRacTuneD3debugEnable=1
cfgRacTuneRemoteRacadmEnable=1
cfgRacTuneHostCom2BaudRate=57600
cfgRacTuneHttpPort=0x50
cfgRacTuneHttpsPort=0x1bb
cfgRacTuneTelnetPort=0x17
cfgRacTuneConRedirPort=0x170c
[ifcRacManagedNodeOs]
ifcRacMnOsHostname=(none)
ifcRacMnOsOsName=Linux 2.4.21-20.ELIhugemem
ifcRacMnOsOsType=0x2
[cfgRacSecurity]
cfgRacSecCsrKeySize=0x400
cfgRacSecCsrCommonName=
cfgRacSecCsrOrganizationName=
cfgRacSecCsrOrganizationUnit=
cfgRacSecCsrLocalityName=
cfgRacSecCsrStateName=
cfgRacSecCsrCountryCode=
cfgRacSecCsrEmailAddr=
[cfgRacVirtual]
cfgVirAtapiSvrPort=0xe54
cfgVirMediaDisable=0
cfgFloppyEmulation=0
[cfgActiveDirectory]
cfgADRacDomain=
cfgADRacName=
cfgADEnable=0
cfgADAuthTimeout=0x78
cfgADRootDomain=
177

Navigation menu