Dell OpenManage Deployment Toolkit 3.4 Command Line Interface Reference Guide FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLtp.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLtp.fm Notes and Cautions NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates potential damage to hardware or loss of data if instructions are not followed. ____________________ Information in this publication is subject to change without notice. © 2010 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm Contents 1 Introduction . What’s New . . . . . . . . . . . . . . . . . . . . . . . 7 . . . . . . . . . . . . . . . . . . . . . . . . 7 Requirements . . . . . . . . . . . . . . . . . . . . . . . 7 . . . . . . . . . . . . . . . . . . . . . . 7 Toolkit Utilities . . . . . . . . . . . . . 8 RAID Configuration Utility . . . . . . . . . . . . . . 8 RAC Configuration Utility . . . . . . . . . . . . . . . 8 Disk Partitioning Utility . .
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm 3 SYSCFG . . . . . . . . . . . . . . . . . . . . . . . . . . Features . . . . . . . . . . . . . . . . . . . . . . . . . SYSCFG General Options . . . . . . . . . . . . . . . . SYSCFG for BIOS Configuration . . . . . . . . . . . . . Options for BIOS Configuration . . . . . . . . . . SYSCFG for BMC and Remote Access Controller Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 . . . . . . 128 . . . . . . . .
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm Creating Virtual Disks . . . . . . . . . . . . . 168 Enumerating Virtual Disks . . . . . . . . . . . . . 174 . . . . . . . . . . . . . . 177 Initializing Virtual Disks Importing and Clearing Foreign Configurations . . . . . . . . . Deleting Virtual Disks . . . . . . . . . . 178 . . . . . . . . . . . . . . . 180 Assigning and Unassigning Global Hot Spares . . . . . Setting Environment Variables . . . . . . 181 . . . . . . . . . . .
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookTOC.fm UPINIT Linux-Specific Error Codes and Messages . . . 215 . . . . . . . 215 . . . . . . . . . . 215 . . . . . . . . . . . . . . . . . 215 UPINIT Windows PE-Specific Error Codes and Messages . . . . . . . . . . . . . . . RAIDCFG Error Codes and Messages Failure Messages RACADM Firmware Error Codes and Messages RACADM Utility Error Codes and Messages B BMC Platform Events Filter Alert Messages . . . . . . . . . C Sample File Formats . . . .
1 Introduction Dell OpenManage Deployment Toolkit (DTK) includes a set of utilities for configuring and deploying Dell PowerEdge systems. You can use DTK to build script-based and RPM-based installation for deploying large number of systems in a reliable way, without changing their current deployment processes. DTK consists of command line utilities to configure various system features, sample scripts to perform common deployment tasks, and documentation for each utility.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm System Configuration Utility The System Configuration (SYSCFG) utility performs the following tasks: • Reports and sets BIOS configuration options • Reports and sets BMC/RAC configuration options • Reports and sets user-configurable states • Reports system information, including PCI device detection RAID Configuration Utility The RAIDCFG utility reports and sets RAID configuration options.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm The syscfg.ini file cannot be used across different systems. The file output operation places system identification information at the beginning of the [syscfg] section. This information is used to determine if the file can be accepted as input for a system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm RACADM Replication The RACREP.BAT sample script applies RAC configuration options to the target system based on the configuration information that has been saved in a configuration file. User input is optional, depending on variables set in the RACREP.BAT sample script. This script uses the RACADM.EXE utility to configure the RAC in the target system using the RAC configuration file, raccfg.ini. The raccfg.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.fm • For more information on RAID controllers, see Dell OpenManage Sever Adminstrator Storage Management User’s Guide on the Dell support site. • The Command Line Reference Guide for iDRAC6 and CMC provides information about the RACADM subcommands, supported interfaces, property database groups and object definitions for iDRAC6 and CMC.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc01.
Command Syntax Overview 2 Syntax refers to the way a command and its parameters are entered. Dell OpenManage Deployment Toolkit (DTK) Command Line Interface (CLI) commands can be arranged in any order in a command line instance as long as they conform to the basic command line syntax. Command Line Syntax The general usage models of the DTK utilities are as follows: • SYSCFG syscfg option1 [arg1] ... optionX [argX] OR syscfg bmcoption1 bmcsuboption1 [arg1]...
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm The DTK command line switches, configuration file formatting, and error reporting follow similar style and behavior. However, individual DTK utilities can sometimes differ from one another in significant ways. You should familiarize yourself with the command line syntax and utility-specific options and arguments for each utility before using DTK. NOTE: Some of the command line options in DTK are followed by an asterisk.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm Table 2-1. Command Line Syntax (continued) Element Description ... Indicates that the previous argument can be repeated several times in a command. Enter only the information within the ellipses and exclude the ellipses. | Separates two mutually exclusive choices in a syntax line. For example: usb: Turns the usb controller on or off. Argument: enable | disable | legacy Enter only one choice: --usb=enable, --usb=disable, or --usb=legacy.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm Table 2-2. DTK Command Line Examples Valid/ Invalid DTK Command Line Example valid syscfg -i=filename --option1 --option2 syscfg -i= /tmp/myfile.txt --floppy --bootseq valid syscfg --option=argument bmcoption --option1=argument syscfg --embnic=on pcp --hostname=webserver NOTE: Do not combine options that specify report or set actions in a command line instance.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.fm Log Files The -l or --logfile option records information output on the command line to the specified log file. Each new line of output is preceded by a time stamp. If the log file already exists, information is appended to the file. This allows multiple tools to use the same log file to record information. Use the -l option to record the output of a utility.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc02.
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.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), the SYSCFG utility is located in \dell\x32\toolkit\tools or \dell\x64\toolkit\tools directory. In Linux, you can find it in the /opt/dell/toolkit/bin directory. SYSCFG General Options NOTE: Some of the options in SYSCFG are followed by an asterisk. These commands do not accept any sub-options or arguments. The values associated with these commands are reported by the BIOS.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-1. SYSCFG General Options (continued) Options --envar Suboptions Valid Arguments Description valid filename When used with the –s option, this option stores the environment variable data to a file. This file can be called from other scripts to set the environment variable. The value of must not be specified if the DTKENVSCR environment variable is set to a valid filename.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments Description -h or --help NA none Without an argument, this option displays general usage information for the utility. If the argument matches a valid option, that option's usage information is displayed. If the option has arguments, the arguments are displayed, separated by a | character.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments Description -i or --infile NA This option directs the SYSCFG utility to take input from the.ini file. The utility searches the file for a section heading identical to the utility name. An error is returned if the file or section is not found. If the section is found, each name/value pair is applied to the system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments Description -o or --outfile NA This option prints all replicable options to the specified filename. The format of the output is in the.ini format, with the utility name as the section header. If a file with the same name already exists, the information is appended to the file.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm SYSCFG for BIOS Configuration SYSCFG uses BIOS interfaces to manipulate boot order and BIOS settings. It configures all options available on the BIOS setup screen, including boot order, embedded device configuration, and asset tag management. Options for BIOS Configuration Table 3-2 documents valid options and arguments along with a description of their expected behavior. Options and arguments are case sensitive.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration Option Valid Arguments Description --acpower on, off, last This option sets the behavior for All Dell the system after AC power is lost. PowerEdge This option specifies how the systems system responds to the restoration of AC power and is particularly useful in systems that are turned off using a power strip. When set to on, the system turns on after AC is restored.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --adjcacheprefetch enable, disable When this option is set to All Dell enabled, the processor fetches the PowerEdge cache line containing the systems currently requested data, and the adjacent cache line.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --assignintr standard, distributed This option controls the interrupt All Dell assignment of PCI devices in the PowerEdge system. This option is set to systems standard by default, causing standard interrupt routing that uses interrupt A, B, C, and D for all PCIe devices.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --bootmode uefi, bios This option enables booting to Unified Extensible Firmware Interface (UEFI) -capable operating systems or ensures compatibility with operating systems that do not support UEFI.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --bootseq numerical list, separated by commas This option sets the boot order for All Dell a system. Without an argument, PowerEdge this option prints the boot order systems list. The argument must be formatted as a comma-separated numerical list with no spaces. The list must be within the bounds of the current boot list, i.e.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems Numerical Lists Examples: A:>syscfg --bootseq= 2,3,4,5,1,6 The following devices are set in the boot sequence: Device 2:* usbcdrom.slot.1 - USB CD-ROM device Device 3:* virtualcd.slot.1 – VIRTUAL CDROM Device 4:* hdd.emb.0 Hard drive C: Device 5:* nic.emb.1 MBA v2.5.12 Slot 0500 Device 1:* virtualfloppy.slot.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems Device Name Examples Example of device names: nic.slot.1 (network adapter 1 in PCI slot) nic.emb.1 (network adapter 1 on system board) hdd.emb.0 (hard drive C:) cdrom.emb.0 (CD drive) Device Name Lists Examples Example 1: #syscfg --bootseq The following devices are set in the boot sequence: Device 2:* cdrom.emb.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems Device 6:* virtual.slot.2 VIRTUALFLOPPY DRIVE Device 4:* nic.emb.1 IBA GE Slot 0638 v1226 Example 2: #syscfg --bootseq= nic.emb.1,virtual.slot. 1 The following devices are set in the boot sequence: Device 4:* nic.emb.1 IBA GE Slot 0638 v VIRTUALFLOPPY DRIVE Device 2:* cdrom.emb.0 IDE CD-ROM device Device 3:* hdd.emb.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --bootseqretry enable, disable This option enables or disables the boot sequence retry feature. When set to enable, the system re-attempts to set the boot order after a 30-second timeout if the last boot attempt has failed. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --conred serial1, serial2, This option configures or reports off, bmcsol, the communication port for mmb console redirection. If this option is set to a serial port, then the serial port option is not available. See the descriptions for "--serial1" on page 71 and "--serial2" on page 72.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --cpucore 1, 2, 4, 6, 8, 10, This option controls the number Dell PowerEdge 12, all of enabled cores in each processor. x9xx and later The default value is set to the systems maximum number of cores per processor. The number of cores depends on the processor.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --datareuse enable, disable This option enables or disables Dell PowerEdge data reuse. Set to enable for High xx1x systems Performance Computing (HPC) applications. Set to disable for energy efficiency. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --devseq numerical list, separated by commas This option sets the hard-drive All Dell sequence for a system. Without PowerEdge an argument, this option displays systems the device list. The argument must be formatted as a comma-separated numerical list of device index values. The list must be within the bounds of the current boot list.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description numerical list, separated by commas Example 1: or list of device names, separated by commas Applicable Systems A:>syscfg --devseq The following devices are set in the disk device sequence: Device 1:* hdd.emb.0 System BIOS boot devices Device 2:* scsiraid.slot.3 - PERC 4/SC Adapter(bus 02 dev 02) Device 3:* usbkey.slot.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embhypervisor off, on This option enables or disables the embedded hypervisor port. All Dell PowerEdge systems Example: A:>syscfg -embhypervisor=on embhypervisor=on --embideraid on, off This option enables or disables All Dell the embedded IDE RAID PowerEdge controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic1 on, off, onnopxe, onwithiscsi This option turns the first All Dell embedded NIC on with PXE on, PowerEdge off, or on without PXE enabled. systems This option is only valid for supported systems that have an NIC. If the NIC is enabled without PXE, it is not found in the boot order.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic2 on, off, onnopxe, onwithiscsi This option turns the second All Dell embedded NIC on with PXE PowerEdge enabled, off, or on without PXE systems enabled. This option is only valid for supported systems that have two embedded NICs. If the second NIC is enabled without PXE, it is not found in the boot order.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic3 on, off, onnopxe, onwithiscsi This option turns the third All Dell embedded NIC on with PXE PowerEdge enabled, off, or on without PXE systems enabled. This option is only valid for supported systems that have three embedded NICs. If the second NIC is enabled without PXE, it is not found in the boot order.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic4 on, off, onnopxe, onwithiscsi This option turns the fourth All Dell embedded NIC on with PXE PowerEdge enabled, off, or on without PXE systems enabled. This option is only valid for supported systems that have four embedded NICs. If the fourth NIC is enabled without PXE, it is not found in the boot order.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic3nic4 enable, disable This option enables or disables the operating system interface of the third and fourth embedded NIC controllers. Dell PowerEdge xx1x systems Example: A:>syscfg -embnic3nic4=enable --embnic3nic4=enable --embnics on, off This option enables or disables All Dell both embedded NICs.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic1pxe enable, disable This option enables or disables All Dell Preboot Execution Environmenet PowerEdge (PXE) on the first embedded systems NIC. If PXE is disabled, the first NIC is not found in the boot order. If PXE is enabled, the first NIC is placed at the end of the boot order.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embsataraid off, combined, This option configures an All Dell ata, raid, qdma embedded SATA RAID controller. PowerEdge This option can be replicated. systems • off — disables the embedded SATA RAID controller. • combined — sets the SATA RAID controller to combined mode. • ata — sets SATA RAID controller to ATA mode.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embscsi2 on, off This option enables or disables the second embedded SCSI controller. This option is only valid for supported systems that have an embedded SCSI controller. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embscsiraidchb raid, scsi This option sets the second All Dell channel on an embedded RAID PowerEdge controller to SCSI or RAID. This systems option is only valid for systems that support RAID/RAID and RAID/SCSI settings for channels A and B. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --extserial com1, com2, rad This option sets the behavior of the external serial connector. When set to com1, the BIOS maps the external serial connector to COM port 1. The com1 setting is the default.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embsdcard off, on This option enables or disables the embedded SD card port. Dell PowerEdge xx1x systems Example: A:>syscfg --embsdcard= off embsdcard=off --embvideoctrl enable, disable This option enables or disables the embedded video controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --floppy auto, off, readonly This option sets the diskette drive All Dell controller to auto, off, or readPowerEdge only. This option is available on all systems supported systems that have a supported diskette drive. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --hddfailover off, on This option specifies the device in All Dell the Hard Disk Drive Sequence PowerEdge menu that has not been systems attempted in the boot sequence.When set to on, all devices are attempted in an order in which they are configured.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --hwprefetcher enable, disable When set to enable, the processor All Dell preempts what data might be PowerEdge needed next. When some data is systems found, it loads several steps in advance. When set to disable, the processor does not preempt. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --integratedraid enable, disable This option enables or disables the integrated RAID controller. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg -integratedraid=disable integratedraid=disable --integratedsas enable, disable This option enables or disables the integrated SAS controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --logicproc enable, disable This option enables or disables logical processing for a system. This option is available on all systems that support logical processing (Hyperthreading). This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --memintleave enable, disable This option enables or disables the memory interleave mode. This option can be replicated. Applicable Systems All Dell PowerEdge systems Example: A:>syscfg -memintleave=enable memintleave=enable --memoperatingmode optimizer, mirror, advancedecc This option selects the memory operating mode.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --mouse off, on This option turns the mouse controller on or off. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --nextboot valid device name (from the --bootseq option device list) This option sets the specified All Dell device as the first device in the PowerEdge boot order for the next boot cycle systems only. The device must be a device from the --bootseq option device list.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --noraidprompt* NA This option specifies that the BIOS must not prompt for confirmation when changing the mode of a RAID controller. This option can only be used with the --embscsiraid or --embscsiraidchb options. All Dell PowerEdge systems The asterisk is not part of the command syntax.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --numlock on, off This option enables or disables All Dell the keyboard number lock during PowerEdge POST. This option is not systems replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --oldsyspwd This option supplies the current All Dell system password for the BIOS. PowerEdge This option is only given when systems setting the new system password. If this password does not match the current system password, the new password is not applied to the system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --opticaldrivectrl enable, disable This option enables or disables the optical CD-ROM controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --ovrwrt* NA This option is only used with the - All Dell o option to cause the output file PowerEdge to be overwritten if a file of the systems same name already exists. This option cannot be replicated. The asterisk is not part of the command syntax. Applicable Systems Example: A:>syscfg -o= filename.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments --qpibandwidthpriority compute, io Description Applicable Systems This option sets the band width Dell PowerEdge priority to compute or I/O. Set to xx1x systems compute for computationintensive applications. Set to I/O for I/O-intensive applications. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --remflashmedia read-only This option displays the Dell PowerEdge redundancy status of internal dual R810, R815, SD module. The status can be: R910, and M910 • Full — Secure digital card (SD) systems 1 and 2 are functioning properly.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems Example: A:>syscfg -remflashmedia Internal Dual SD Module Redundancy=Lost SD1 status=Absent SD1 status=Active --rptkeyerr enable, disable This option configures or reports whether the BIOS reports keyboard errors during POST. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sata1 auto, off This option enables or disables SATA port 1. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg --sata1=auto sata1=auto NOTE: This option maps to -- sata_b for Dell PowerEdge x9xx systems. --sata2 auto, off This option enables or disables SATA port 2.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sata4 auto, off This option enables or disables SATA port 4. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg --sata_4=auto sata_4=auto NOTE: This option maps to -- sata_e for Dell PowerEdge x9xx systems. --sata5 auto, off This option enables or disables SATA port 5.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sata7 auto, off This option enables or disables SATA port 7. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg --sata_7=auto sata_7=auto NOTE: This option maps to -- sata_h for Dell PowerEdge x9xx systems.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --serial2 auto, disable, com2, com4 This option configures or reports All Dell the second serial port PowerEdge communication port. This option systems can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --serialcomm on, com1cr, com2cr, off This option sets the behavior of Dell PowerEdge the serial port communication. x9xx and later When set to on, the BIOS enables systems COM port 1 and COM port 2. These ports are made available for use by the operating system or applications. BIOS Console Redirection is disabled.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems Example: A:>syscfg --serialcomm= on serialcomm=on The --serialcomm option can be used with the external serial (-extserial) option instead of the -conred (available on systems earlier than Dell PowerEdge x9xx systems) option.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --setuppwd This option sets the setup All Dell password for the BIOS. The setup PowerEdge password locks the BIOS F2 systems screen. The argument string supplied to this option is the password. Passwords are limited to alphanumeric characters and cannot exceed 32 characters in length.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems Example 2: A:>syscfg --setuppwd= asetuppassword --oldsetuppwd= currentpassword The password has been set. Please use a warm reboot to apply the password to the system. Example 3: A:>syscfg --setuppwd= asetuppassword --oldsetuppwd= currentpassword The old password entered is incorrect. The new password will not be set.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --slotname* NA This option reports the slot name Dell modular of the blade. systems The asterisk is not part of the command syntax. Applicable Systems Example: A:>syscfg --slotname slotname=Slot5 --sriov enable, disable This option enables or disables support for SRIOV devices.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --syspwd This option sets the system All Dell password for the BIOS. The PowerEdge system password is required when systems booting the system. The argument string supplied to this option is the password. Generally, passwords are limited to alphanumeric characters and cannot exceed 32 characters in length.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sysrev NA This option reports the system revision. This is a read-only option. All Dell PowerEdge systems For details about the tpm sub-options and arguments, see Table 3-3. Dell PowerEdge xx0x and later systems tpm --turbomode enable, disable This option enables or disables core-based turbo mode.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --usbflash auto, fdd, hdd This option sets or reports the emulation for a USB flash device. The USB flash device can be set to emulate a hard drive (HDD) or a diskette drive (FDD). This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --virtualization enable, disable This option enables or disables virtualization in the CPU. When set to enable, it enables the additional hardware capabilities provided by Virtualization Technology in applicable CPUs.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-3 lists the sub-options and arguments for the tpm option. Table 3-3. Sub-options and Arguments for the tpm Option Option Sub-option Arguments Description tpm off Does not report the presence of TPM to the operating system. onwithpbm Directs the BIOS to store the TCG compliant measurements to the TPM during a POST operation. onwithoutp bm Directs the BIOS to bypass the pre-boot measurements.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-3. Sub-options and Arguments for the tpm Option (continued) Option Sub-option --tpmclear Arguments Description NA Clears the contents of the TPM chip without erasing the tpmsecurity and tpmactivation settings. Example: A:>syscfg tpm -tpmactivation=enabled -tpmclear --setuppwdoverride -undotpmclear NA Undoes the result of the tpmclear setting.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-4 lists the sub-options and arguments for the tcm option. Table 3-4. Sub-options and Arguments for the tcm Option Option Sub-option Arguments Description tcm off Does not report the presence of TCM to the operating system. on Reports the presence of TCM to the operating system. --tcmsecurity Example: A:>syscfg tcm --tcmsecurity = off --tcmactivation enabled Enables and activates the TCM feature.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-5 lists the sub-options and arguments for the power option. Table 3-5. Sub-options and Arguments for the power Option Option Sub-option Arguments Description power --profile where powerprofile can be maxperformance, osctl, apc Displays the settings similar to the BIOS setup screen for the respective profile. Reboot the system for the settings to take effect.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-5. Sub-options and Arguments for the power Option (continued) Option Sub-option Arguments -min, max fanpowermode Description Allows you to set the fan algorithm to the minimum power optimized or maximum performance optimized mode. A:>syscfg power --profile= custom --fanpowermode=min -setuppwdoverride NOTE: Set the value of --profile to custom to change the values of cpupowermode, memorypowermode, and fanpowermode.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-5. Sub-options and Arguments for the power Option (continued) Option Sub-option --valsetuppwd Arguments Description Validates the setup password for power authentication. If you try to change the DTK settings, you are prompted to enter this password to access the settings.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm The following section documents all the valid options, sub-options, and their arguments along with a description of the expected behavior using an example. Some features that must be noted while reading this section are: • Unless otherwise specified, all sub-options to options are optional. • If a sub-option is not specified for an option, all valid sub-option values are displayed for the option.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems -NA majorfwrevisio n Reports the BMC device major firmware revision. -NA minorfwrevisio n Reports the BMC device minor firmware revision.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description --deviceguid* NA NA Displays the GUID for All Dell the BMC. This option PowerEdge cannot be replicated. systems The asterisk is not part of the command syntax. Applicable Systems Example: A:>syscfg -deviceguid deviceguid= XXXXXXXXXX --encryptkey NA Encrypts the IPMI sessions.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option -kvmstatusonlcd Valid Arguments Description Applicable Systems active, inactive This option configures the Dell Virtual KVM (vKVM) session status on the LCD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments -user, operator, channelprivlmt administrator Description Applicable Systems Sets the maximum privilege level accepted for the LAN channel. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems --ipaddress Sets the IP address for the LAN channel. This sub-option cannot be replicated. --subnetmask Sets the subnet mask for the LAN channel. This sub-option can be replicated. --gateway Sets the gateway for the LAN channel.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description --alertdest 1, 2, 3, 4 Sets the destination for the LAN alert. This sub-option can be replicated. --vlantag enable, disable Enables or disables VLAN tagging. This sub-option can be replicated. --vlanid Sets the 12-bit VLAN ID. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems --dnsdhcp enable, disable Enables or disables obtaining the DNS server IP address through DHCP. --dnsserver1 Sets the IP address of the primary DNS server for domain name resolution. --dnsserver2 Sets the IP address of the secondary DNS server for domain name resolution.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems Example 1 (to display the current LAN configuration settings): A:>syscfg -lancfgparams lancfgparams destipaddr= 192.168.100.15 vlantag=enable vlanid=1000 vlanpriority=7 macaddress= 0:6:5b:fb:c8:a7 commstring= public ipaddrsrc=static ipaddress= 192.168.100.10 subnetmask= 255.255.255.0 gateway= 192.168.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems Example 2 (to set the LAN configuration parameters): A:>syscfg lancfgparams --destipaddr= 192.168.100.15 --vlantag=enable --vlanid=1000 --vlanpriority=7 --commstring= public --ipaddrsrc= static --ipaddress= 192.168.100.10 --subnetmask= 255.255.255.0 --gateway= 192.168.100.1 lancfgparams destipaddr= 192.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments lanuseraccess or lua Description Applicable Systems Configures the privilege All Dell level and channel PowerEdge accessibility associated systems with a specified User ID for the LAN channel. --userid 2–10, if your system has a DRAC 4 controller Sets the User ID. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments -NA useridswithfixe dnames Description Applicable Systems Reports the number of User IDs with fixed names on the LAN channel.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option --loaddefaults* NA The asterisk is not part of the command syntax. Valid Arguments Description Applicable Systems NA Restores the BMC to All Dell the defaults originally PowerEdge loaded on the systems controller. This option is used to return the BMC to a known-good state. This option cannot be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems --nextboot NA valid device name (from the --bootseq option device list) This option sets the All Dell specified device as the PowerEdge first device in the boot systems order for the next boot cycle only. The device must be a device from the --bootseq option device list.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems Device 5: nic.emb.2 Intel Boot Agent Version 4.0.17 Example 2: A:>syscfg -nextboot= nic.emb.1 nextboot= nic.emb.1 --nmibutton NA enable, disable This option enables or disables the NMI button. All Dell PowerEdge systems This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments passwordaction Description Applicable Systems Configures and tests All Dell the password for the PowerEdge specified User ID. This systems option cannot be replicated. All three sub-options, action, userid, and password, must be included in the command line. NOTE: 20 byte passwords are not supported for this option.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems A:>syscfg passwordaction --userid=3 --action= setpassword --password= bmcmaster passwordaction userid=3 action= setpassword password= ********* A:>syscfg passwordaction --userid=3 --action= testpassword --password= bmcmastor Password test failed.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description --filter fanfail, voltfail, discretevoltfail, tempwarn, tempfail, intrusion, redundegraded, redunlost, procwarn, procfail, powerwarn, powerfail, hardwarelogfail, autorecovery, batterywarn, batteryfail, powerabsent, procabsent, systempowerwarn, systempowerfail Specifies a PEF value. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description --hostname Sets the host name (maximum of 62 printable ASCII characters) for the BMC. This sub-option can be replicated. Applicable Systems The --hostname string must comprise only these characters: hyphen (-), underscore (_), and period (.).
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems --alertpolstatus enable, disable Enables or disables the alert policy specified using the alertpolnum sub-option. This suboption can be replicated. This suboption is dependent on the alertpolnum suboption.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems --powerctl NA powerdown This option performs a All Dell chassis powerdown and PowerEdge controls the reset of the systems system. Powerdown shuts off the system. powercycle Powercycle shuts off the system and automatically turns on your system after a few seconds.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments --serialchannelaccess or sca Description Applicable Systems Sets or displays the All Dell channel access settings PowerEdge for the serial channel. systems This option can be replicated. -ipmioverserial disable, alwaysavail Sets the serial channel access mode. This suboption can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments -user, operator, channelprivlmt administrator Description Applicable Systems Sets the maximum privilege level accepted for the serial channel. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments -serialchannelinfo or sci Description Applicable Systems Displays media and protocol information about the serial channel. This option cannot be replicated. All Dell PowerEdge systems --mediumtype NA Displays the medium type for the serial channel. This suboption cannot be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments serialcfgparams or scp Description Applicable Systems Configures and displays All Dell serial configuration PowerEdge parameters. This option systems can be replicated. -basic, terminal Sets the connection connectionmo mode used to perform de IPMI messaging to the BMC. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description -tmcfgechoctrl echo, noecho Sets the echo control value for terminal mode configuration. This sub-option can be replicated. Applicable Systems -enable, disable Sets the handshake tmcfghandshak control value for ectrl terminal mode configuration. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments serialuseraccess or sua Description Applicable Systems Configures the privilege All Dell level and channel PowerEdge accessibility associated systems with a specified User ID for the serial channel. This option can be replicated. --userid 2–10 if your system has a DRAC 4 controller Sets the User ID.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems -NA currentenabled userids Reports the number of currently enabled User IDs on the serial channel. This suboption can be replicated. -NA useridswithfixe dnames Reports the number of User IDs with fixed names on the serial channel. This suboption can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments solaction Description Applicable Systems This option enables or All Dell disables Serial-OverPowerEdge LAN (SOL) access for a systems particular user. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments solcfgparams Description Applicable Systems Configures and displays All Dell SOL configuration PowerEdge parameters. This option systems can be replicated. --solenable enable, disable Enables or disables whether the SOL payload type can be activated. This option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments -1–255 solcharsendthr eshold Description Applicable Systems Specifies that the BMC automatically sends an SOL character data packet containing this number of characters in increments of 5 (1–255) as soon as this number of characters (or greater) has been accepted from the baseboard serial controller into the BMC.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description --solbitrate 9600, 19200, Sets the serial channel 57600, 115200 communication bit rate (in bps) with the BMC when SOL is activated. This option can be replicated. Applicable Systems NOTE: The arguments for --solbitrate vary with various Dell systems.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments ssninfo Description Applicable Systems Displays information All Dell about the number of PowerEdge possible active sessions systems and the number of currently active sessions on all channels on the BMC. This option cannot be replicated. -NA maxactivessns Displays the maximum possible active BMC sessions.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments useraction Description Applicable Systems Enables and disables All Dell BMC, sua, and lua user PowerEdge IDs. This option can be systems replicated. --userid 2–10 if your system has a DRAC 4 controller Specifies the BMC user ID. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments username Description Applicable Systems Sets the BMC User ID All Dell and username. This PowerEdge option can be systems replicated. --userid 2–10 if your system has a DRAC 4 controller Specifies the User ID. This sub-option can be replicated.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-6. BMC and Remote Access Controller Configuration Options (continued) Option Sub-option Valid Arguments Description Applicable Systems Example 2 (to display the username for User ID 3): A:>syscfg username -userid=3 --name username userid=3 name=bmcmaster NA --version* NA The asterisk is not part of the command syntax. Displays the version information for the SYSCFG utility.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-7. SYSCFG Options and Arguments for State Configuration Option Valid Description Arguments -b or --byte This option specifies a value to write to state data. The format of the argument must be in decimal format unless the -x option is given. If the -x option is given, the value is interpreted as hexadecimal format. The value can optionally contain 0x. The decimal range is 0–255, and the hexadecimal range is 0x00–0xFF.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm SYSCFG for System Configuration SYSCFG enables system configuration and reporting. It reports system identification values, processor types and speeds, memory size, and detects device using PCI scan. Options for System Configuration Table 3-8 documents valid options and arguments along with a description of the expected behavior of each option. Options and arguments are case sensitive.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments --chassvctag* None The asterisk is not part of the command syntax. --cpucount* Description This option reports the chassis service tag for modular systems. Example: A:>syscfg --chassvctag chassvctag=SVCTAG1 None The asterisk is not part of the command syntax. This command reports the number of processors found on the system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --envfile This option reads the environment variable file (included in DTK as sys.ini) and sets environment variables to names in the file, based on the system's information. Primarily, this command performs a PCI scan and matches the vendor/device numbers of the devices to those specified in the environment variable file.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description -n This option specifies an input file to use for resolving PCI vendor and device numbers to strings. The file must be present (with read rights) and contain a properly formatted list. See "PCI Reporting" for more information. This option must be used with the --pci option. Example: A:>syscfg -n pci.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --pci* None This option performs a scan of all PCI buses and displays the results. The utility uses an open source pci.ids file for vendor/device name resolution. The utility looks for a file called pci.ids in the current working directory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments None Description Slot: 00 Class: 06 - Bridge SubClass: 00 - CPU/PCI Example 2 (the pci.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description None Example 3 (a pci.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --slot* None This option reports the slot of a modular system. If the system is not modular, the slot is reported as 0. If used with the -s option, the environment variable is set to the slot. The asterisk is not part of the command syntax.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --sysid* None This function command reports the unique system id bytes for a server. Servers contain a unique ID value based on their model. The ID value is reported as a hexadecimal value with a leading 0x, lowercase hexadecimal letters, and zero-padded to 2 bytes.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-8. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --syssvctag* None This option reports the system service tag for a modular system. The asterisk is not part of the command syntax. --uuid* The asterisk is not part of the command syntax. Example: A:>syscfg --syssvctag syssvctag=BLADE01 None This option reports the Unique User Identifier (UUID) for a system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm SYSCFG for IPv6 Configuration Table 3-9 lists all valid options and arguments for IPv6 configuration along with a description of each option. These options are applicable only if the DRAC in your system supports IPv6. Table 3-9. SYSCFG Options and Arguments for IPv6 Configuration Option Sub-option lancfgparamsv6 --ipv6 or lcpv6 Valid Argument Description enable, disable Loads or unloads the IPv6 stack.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Table 3-9. SYSCFG Options and Arguments for IPv6 Configuration Option Sub-option Valid Argument Description -linklocaladdripv6 = Allows you to view IPv6 addresses. --gatewayv6= Allows you to view IP gatewayv6 address. A:> syscfg lcpv6 -linklocaladdripv6= 134.56.45.233 PCI Reporting The scan of the PCI bus uses a file to resolve PCI vendor and device codes to vendor information strings.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc03.fm Environment Variable File The environment variable file can be used for discovering and recording system information to environment variables. The file consists of several sections with .ini format that map PCI vendor/device numbers to environment variable values. The environment variable file is sys.ini in \DELL\TOOLKIT\TOOLS on Windows systems and on Linux systems, you can find it in /opt/dell/toolkit/bin.
4 RAIDCFG This section documents the Deployment Toolkit (DTK) RAID configuration utility. The RAIDCFG utility provides a single command line tool that can configure all supported RAID controllers. Features The RAID configuration utility has the following general features: • Displays help and usage information. • Reads configuration options from the Command Line Interface (CLI) parameters. • Enumerates RAID controllers, physical disks, and virtual disks. • Creates and deletes virtual disks.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm • CERC SATA 1.5/6-Channel (CH) and CERC SATA 1.5/2S (These controllers are supported in Linux only.) • SAS 5iR Integrated, SAS 5iR Adapter • SAS 6iR Integrated, SAS 6iR Adapter • PERC 6/E Adapter, PERC 6/i Integrated, PERC 6/i Adapter • PERC 6/i Integrated for modular systems RAIDCFG Dependencies For the RAIDCFG utility to run successfully in Windows PE, the mr2kserv, lsivil.dll (for Windows) or lsivil.so (for Linux) and sasvil.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-1. RAIDCFG Short and Long Format Options Option Valid Arguments Short Description Mandatory or Optional No option NA Displays general usage information for the utility. The usage information consists of a comprehensive list of valid options, parameters, and arguments. Optional. See Table 4-4 for specific usage information. -h -? or /? -ac cvd Creates a virtual disk.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -ad ch:targ, ch:targ, ... Specifies an array disk. or or ch:targ:lun,... adisk or ch:targ:enc channel:target, or channel:target:lun , or channel:target:en closure Short Description Mandatory or Optional Optional. See Table 4-5 for For SCSI controllers, the value of LUN should always specific usage information. be 0.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -envn Sets the environment variable () that equates to the value returned from a function call. See Table 4-12 for specific usage information. or envname -fd or failoverdrive ch:targ, ch:targ, ... Specifies the location of the Optional. failover drive in an array. See Table 4-4 for or ch:targ:lun,...
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -o Reads the RAID configurations from all available controllers and write these configurations in the given .ini filename. Mandatory. See Table 4-14 for specific usage information. array.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description -sz Sets the maximum size on Optional. the virtual disk in MB or GB See Table 4-4 for if the size is not provided. specific usage The default size is in MB. If information. GB follows the number, the size is expressed in GB. The span size of RAID 5, which is a mandatory parameter for RAID 50.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -vd virtual disk. Optional. NA Displays the version number of the utility. Optional. Sets the write policy for a virtual disk. The valid arguments are: wb (writeback caching), wt (write-through caching), wc (write-caching), nwc (no-write-caching), and fwb (force-write-back). Optional.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm RAID Configuration Utility Options and Arguments The following tables document valid options, parameters, and arguments along with a description of the expected behavior of each option. Options, parameters, and pre-defined arguments are case sensitive and entered in lowercase, unless stated otherwise.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm General Help Table 4-2 lists the RAIDCFG general help options. Table 4-2. General Help Options Parame Valid Description ters Arguments No option NA -? Displays general usage information for the utility. The usage information consists of a comprehensive list of valid options, parameters, and arguments. This option is optional and can be added to the command line in any order. or Example: /? A:>raidcfg -h -h NA RAIDCFG v3.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Enumerating RAID Controllers Table 4-3 lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating RAID controllers. Table 4-3. Enumerating RAID Controllers Mandatory Optional Valid Description Options and Paramet Parameters Arguments ers Arguments -ctrl NA or controller NA Lists all the RAID controllers on the host system, along with select property information. This option is mandatory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-3. Enumerating RAID Controllers (continued) Mandatory Optional Valid Description Options and Paramet Parameters Arguments ers Arguments -c rid Displays the properties for the RAID controller with the specified controller ID. This option combination is mandatory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Creating Virtual Disks Table 4-4 lists the RAIDCFG options, parameters, and pre-defined arguments for creating virtual disks. NOTE: If you create a virtual disk on Windows PE, you must reboot your system. NOTE: On CERC SATA 1.5/2S, CERC SATA 1.5/6CH, SAS 5/iR, and SAS 6/iR controllers, use the entire array disk to create a virtual disk. Table 4-4.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -cp d, c or or cachepolicy d, e Sets the cache policy or disk cache policy. The valid arguments for cache policy are: • d — (Direct I/O) Reads are not buffered in cache memory. • c — (Cache I/O) All reads are buffered in cache memory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -fd ch:targ, ch:targ, Sets the failover drive for the virtual ... disk. The -fd option is optional and can or be added to the command line in any or ch:targ:lun,... failoverdrive order after the mandatory option or ch:targ:enc combination. channel:target, NOTE: From DTK 2.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -r or -raid 0, 1, 5, 6, 10, 50, Sets the RAID type or level for the 60 virtual disk. NOTE: If this option is not specified for any RAID controller, RAID 0 is taken as the default. The valid arguments are: • 0 — RAID 0 uses data striping, which is writing data in equal-sized segments across the array disks.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments • 50 — RAID 50 is a dual level array that uses multiple RAID 5 sets in a single array. A single hard drive failure can occur in each of the RAID 5 without any loss of data on the entire array.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -ctrl -ac=cvd -rp -c=id -ad= ch:targ,ch:targ , ... or [or readpolicy ch:targ:encl,...] or controller action= createvdisk controllerid= id adisk= channel:target :lun, channel:target :lun,... [or channel:target : enclosure,...] ra, ara, nra, rc, nrc Sets the SCSI read policy for the virtual disk.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments NOTE: The PERC 4/IM controller has a fixed set of read, write, and cache policies. If you set any of these policies while creating a virtual disk, your settings are ignored. • rc — (Read-Caching) Enables read caching. • nrc — (No-Read-Caching) Disables read caching.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -ctrl -ac=cvd -sp -c=id -ad= or ch:targ,ch:targ spanlength , ... [or ch:targ:encl,...] or controller action= createvdisk controllerid= id adisk= channel:target :lun,... channel:target :lun,... [or channel:target : enclosure,...] Creates a virtual disk comprised of the properties supplied.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -ctrl -ac=cvd -ssz -c=id -ad= ch:targ,ch:targ , ... or [or stripesize ch:targ:encl,...] or controller action= createvdisk controllerid= id adisk= channel:target :lun, channel:target :lun,... [or channel:target : enclosure,...] Sets the stripe size for the virtual disk.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -ctrl -ac=cvd -str -c=id -ad= ch:targ,ch:targ or , ... [or ch:targ:encl,...] strict or controller action= createvdisk controllerid= id adisk= channel:target :lun, channel:target :lun,... [or channel:target : enclosure,...] Strict (-str parameter) is the percentage of expected array disk utilization.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -ctrl -ac=cvd -sz -c=id -ad= or ch:targ,ch:targ -size , ... [or ch:targ:encl,...] or controller action= createvdisk controllerid= id adisk= channel:target :lun,... channel:target :lun,... [or channel:target : enclosure,...] Sets the maximum size of the virtual disk in MB or GB.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -wp or writepolicy wb, wt, wc, nwc Sets the write policy for the virtual disk. The valid arguments are: • wb — (Write-Back Caching) sets the controller to send a write-request completion signal as soon as the data is in the controller cache but has not yet been written to disk.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments • nwc — (No-Write-Caching) specifies that the controller does not send a write-request completion signal after the data is written to the disk. NOTE: The wc and nwc options are supported on the CERC SATA 1.5/CH controller only.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-5. Enumerating Array Disks (Hard Drives) Mandatory Options and Arguments Optional Parameter Valid Description Parameter Arguments -ad -c=id NA NA or adisk controllerid= id Lists all the array disks attached to the specified RAID controller. This option combination is mandatory. NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk. NOTE: The following example displays output of a Series 7 controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-5.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-5.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-5. Enumerating Array Disks (Hard Drives) (continued) Mandatory Options and Arguments Optional Parameter Valid Description Parameter Arguments -ad -c=id -vd=id or adisk vdisk=id controllerid= id Lists the array disks that make up the virtual disk on the specified RAID controller. This option combination is mandatory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-5. Enumerating Array Disks (Hard Drives) (continued) Mandatory Options and Arguments -ad -c=id Optional Parameter Valid Description Parameter Arguments -ad= or arg,... controllerid= channel:tar id vdisk=id get, channel:tar get,... Displays information about the specified array disk. This option combination is mandatory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Enumerating Virtual Disks Table 4-6 lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating virtual disks. Table 4-6. Enumerating Virtual Disks Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments Description -vd NA Lists the virtual disks for each controller along with the array disks that make up each virtual disk. This option is mandatory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-6. Enumerating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments -vd -c or vdisk Description displayed with the physical disk that controller comprises it. The -c option is optional and id can be added to the command line in any order after the mandatory option.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-6. Enumerating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments Description -vd -c=id -vd or or Displays details about a single virtual disk under the indicated controller. The -vd -c= id option combination is mandatory. The second -vd option is optional and can be added to the command line in any order after the mandatory option combination.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Initializing Virtual Disks Table 4-7 lists the RAIDCFG options, parameters, and pre-defined arguments for initializing selected virtual disks. Table 4-7.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Importing and Clearing Foreign Configurations Table 4-8 lists the RAIDCFG options, parameters, and pre-defined arguments for foreign configurations. Table 4-8.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-8. RAIDCFG Options for Foreign Configurations (continued) Mandatory Options and Arguments Optional Parameters -ctrl -c=id -ac= NA fgnclr or Valid Parameter Description Arguments controller controllerid=id action= foreignclear Clears the foreign configuration detected in the selected controller. This feature is supported on PERC 5 and later controllers and is not supported on SAS controllers.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Deleting Virtual Disks Table 4-9 lists the RAIDCFG options, parameters, and pre-defined arguments for deleting virtual disks. NOTE: If you delete a virtual disk on PERC 4/IM on Windows PE, you must reboot the system. Table 4-9. Deleting Virtual Disks Mandatory Options and Arguments Optional Parameter -vd -ac=dvd - NA c=id Valid Parameter Arguments Description NA Deletes all virtual disks on the indicated controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Assigning and Unassigning Global Hot Spares Table 4-10 lists the RAIDCFG options, parameters, and pre-defined arguments for assigning and unassigning global hot spares. Table 4-10. Mandatory Options and Arguments Assigning and Unassigning Global Hot Spares Optional Valid Parameter Parameter Arguments -ctrl -ac= NA sghs -c=id ad|-pd= ch:targ:encl,c h:targ:encl NA Description Assigns the specified disk as a global hot spare on the controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-11. Assigning and Unassigning Persistent Dedicated Hot Spares Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments Description -ctrl -c=id ac=ephs NA Assigns the slot corresponding to the hot spare drive as persistent. Any drive in the slot functions as a hot spare if the drive is qualified to be a hot spare.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Setting Environment Variables Table 4-12 lists the RAIDCFG options, parameters, and pre-defined arguments for setting the CLI environment. Table 4-12. Setting Environment Mandatory Options and Arguments Optional Valid Description Parameter Parameter Arguments -se -envn= envc= NA NA Sets a user-defined environment variable to the value returned from the getcontrollerslots function call. This option combination is mandatory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-12.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-13. Function Calls of the setenvironment Option (continued) Function Call Description getcontrollertype Returns LSI for LSI controllers and ADAP for Adaptec controllers. Example: A:>raidcfg -se -envn=CONTROLLERTYPE -envc= getcontrollertype -c=2 CONTROLLERTYPE=LSI RAIDCFG command successful! getadisks Returns the array disks attached to the controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-13. Function Calls of the setenvironment Option (continued) Function Call Description gethotspares Returns the global hot spares (global failover disks) found on the specified controller. Example: A:>raidcfg -se -envn=HOTSPARES -envc= gethotspares -c=2 HOTSPARES=1:8:1,1:9:1 RAIDCFG command successful! getfreeadisks Returns the free array disks.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm RAID Replication Options Table 4-14 lists the RAID replication options. Table 4-14. RAID Replication Options Mandatory Optional Valid Options Parameters Parameter and Arguments Arguments -i NA Description Reads the RAID configuration information from the given .ini filename and creates the RAID configurations on the specified controllers. This option is mandatory. Example: A:> raidcfg -i=\tmp\raid.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-14. RAID Replication Options (continued) Mandatory Optional Valid Options Parameters Parameter and Arguments Arguments Description controllerid=0 size=65345 raid=1 readpolicy=ra writepolicy=wt stripesize=64 cachepolicy=d adisk=0:3:1,0:4:1 If the controller uses global hot spares, the raid.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Miscellaneous Options Table 4-15 lists all other RAIDCFG options, parameters, and pre-defined arguments. Table 4-15. Miscellaneous Optional Parameters Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments any -l or logfile Description Logs command line output to a file. The utility either appends the information to an existing log file or creates a new file.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-15. Miscellaneous Optional Parameters (continued) Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments Description any -si Does not display any information on the terminal console. This option is optional and can be added to the command line in any order after any mandatory options have been added.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Quick Reference to RAIDCFG Commands Table 4-16 lists the basic RAIDCFG commands. Table 4-16. Basic RAIDCFG Commands Purpose Command Description To list all the RAID controllers in a system raidcfg -ctrl Lists all the RAID controllers in the system. Record the slot ID of the controllers for later reference. To list all the disks raidcfg adisk - Lists all the disks attached to the attached to a particular c=slotid controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-16. Basic RAIDCFG Commands (continued) Purpose Command Description To create a virtual disk of a certain size and make it RAID 5 raidcfg -ctrl ac=cvd -c= slotid -ad= x:y,x:y,x:y,... -sz=5GB -r=5 Creates a virtual disk of 5GB size for type RAID 5.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.fm Table 4-16. Basic RAIDCFG Commands (continued) Purpose Command Description To create a virtual disk of RAID 6 raidcfg -ctrl ac=cvd -c= slotid -ad= x:y,x:y,x:y,x:y ,x:y,x:y -r=6 sp=x Creates a virtual disk of maximum size for type RAID 6. The slot ID in <-c=slotid> and the array disks in <-ad=...> are obtained from the first two commands. The drive location is obtained from the second command.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc04.
5 UPINIT The UPINIT utility is used to make a utility partition (UP) on a hard drive, format the partition, and extract the partition contents onto the disk. Features The UPINIT utility has the following general features: • Displays help and usage information. • Returns specific error codes and messages. NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), you can find the UPINIT utility in \DELL\TOOLKIT\TEMPLATES\SCRIPTS.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm • Uncompresses the UP file onto the UP image. • Unmounts the partition. NOTE: On Windows PE, UPINIT runs as a batch file. In Linux, it is a shell script that uses standard Linux commands to accomplish the same tasks done by the Windows PE counterpart. Both command lines are identical and the output of the two utilities are identical when the same image is used.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm Table 5-1. UPINIT Options and Arguments Option Valid Arguments Description none none If no options are given, the tool outputs usage information. The usage information is printed in the format shown below. Example 1: A:>upinit upinit version 1.0 © 2005 Dell Inc. All rights reserved upinit.sh --disk|-d=disk --size|-s= size --file|-f=file [--overwrite|-o] [-help|-h] --help or -h prints help.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm Table 5-1. UPINIT Options and Arguments (continued) Option Valid Arguments Description -h none This function command requires an argument that matches a valid option. If the argument matches a valid option, that option’s usage information is displayed. This option cannot be used with other options. Windows PE Example: upinit version 1.0 Copyright (c) 2002-2006 Dell Inc. This utility creates a utility partition for your system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm Table 5-1. UPINIT Options and Arguments (continued) Option Valid Arguments Description In the example, upinit creates a Dell Utility Partition of size 32 MB using the upimg.bin image file. The --overwrite option should be used for upgrading/downgrading purposes. The --size option is not required when using the --overwrite option because the --overwrite option does not resize an existing Dell Utility Partition.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm Table 5-1. UPINIT Options and Arguments (continued) Option Valid Arguments Description --overwrite or -o Installs the Dell Utility partition over an existing one. Example: upinit --disk=/dev/sda --size=32 -file=upimg.bin In the example, upinit creates a Dell Utility Partition of size 32 MB on /dev/sda using the upimg.bin file. The --overwrite option should be used for upgrading/downgrading purposes.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.fm Table 5-1. UPINIT Options and Arguments (continued) Option Valid Arguments Description file string, required Specifies a file that is decompressed onto the utility partition. This file is checked for existence and availability before any partitions are created on the disk. If the file is not specified, the utility simply create the utility partition, format it, and exits. The user has to mount and populate the utility partition.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLc05.
A Messages and Codes This section documents the error messages and codes used in Dell OpenManage Deployment Toolkit (DTK). SYSCFG Error Codes and Messages The SYSCFG utility checks your commands for correct syntax and valid input. When you enter a command, a message is displayed stating the results of the command. Failure Messages The SYSCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. Table A-1 lists SYSCFG error codes and messages. Table A-1.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 10 Clear SEL cannot be accompanied with any other option. 11 racreset cannot be accompanied with any other option. 12 Cannot execute command. Command, or request parameter(s), not supported in present state. 13 Command not supported on given channel. 14 The community string may only contain printable ASCII characters. 15 Destination unavailable.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 30 Invalid VLANID value. 31 Invalid Command. Used to indicate an unrecognized or unsupported command. 32 Command invalid for given LUN. 33 Load defaults cannot be accompanied with any other option. 34 There was an error loading the defaults. 35 Node Busy. Command could not be processed because command processing resources are temporarily unavailable.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 48 Command response could not be provided. SDR Repository in update mode. 49 Cannot execute command, SEL erase in progress. 50 Attempt to set the 'set in progress' value when not in the 'set in complete' state. 51 The SOL character accumulate interval is invalid. 52 The SOL character send threshold is invalid. 53 The SOL retry interval is invalid.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 69 There is not enough free system memory to complete the BIOS update. 70 The BIOS update file version is a different version class (A00, X00) than the current system BIOS. Use the --force option to use this BIOS image. 71 The BIOS update file version is older than the current system bios. Use the --force option to use this BIOS image.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 83 The dependent option '%s' required for this subcommand is missing in the command line. 84 Duplicate sub command '%s' has been entered. 85 The script file does contain not a valid DTK environment script signature. 86 The format of the environment variable is incorrect. 87 The --envar option can only be used for a single option.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 103 Input file '%s' cannot be read. 104 Invalid argument for option '%s'. 105 Function table lookup error. 106 The machine ID was not found in the file '%s'. 107 The system memory information is not available. 108 Mode can only be used with the --pci option. 109 The device name or index must be present in the boot order.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 122 The password length must be between 1 and 32. 123 This password is locked and can only be unlocked by the admin user. 124 There was an error setting the password. 125 The LCD string length must be between 1 and %s. 126 The LCD string may only contain alphanumeric characters. 127 There was an error setting the LCD string.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 142 Cannot stat /etc/omreg.cfg file. Please ensure /etc/omreg.cfg file is present and is valid for your environment. You can copy this file from the DTK iso. 143 Getting nicselection settings failed. 144 HAPI Driver Load Error. 145 Filter action power reduction is only supported for the system power warn/fail filters.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 159 Invalid IPv6 address. The IPv6 address cannot be link-local or multicast. 160 Invalid IPv6 address. The IPv6 address specified has incorrect address format. 161 Invalid IPv6 address. The gateway address specified has incorrect address format. 162 Invalid IPv6 address. The Primary DNS server address specified has incorrect address format. 163 Invalid IPv6 address.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 175 Unspecified error. 176 Getting LCD settings failed. 177 Invalid configuration. Attempting to set cap when capenable is set to disable. 178 Invalid configuration. Attempting to set cap when hardware does not support setting. 179 Invalid Configuration Option. 180 Cannot execute command.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Failure Messages The UPINIT utility failure messages provide error codes to help diagnose why some commands do not succeed. Table A-2 lists error codes and messages common to Linux and Microsoft Windows PE environments. Table A-2. UPINIT Common Error Codes and Messages Error Code Message 0 Dell Utility Partition created successfully. 1 Error: Disk ID not specified. 2 Error: SIZE not specified.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm UPINIT Linux-Specific Error Codes and Messages Table A-3 lists error codes and messages specific to the Linux environment. UPINIT Windows PE-Specific Error Codes and Table A-3. UPINIT Linux-Specific Error Codes and Messages Error Code Message 31 Error: Invalid disk specified. 32 Error: Mount failed. 33 Cannot create mount point . File exists. 34 Error: fdisk failed.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages Error Code Message 0 RAIDCFG Command successful! 1 Error! Incorrect Syntax. 2 Failure! 3 Illegal operation 4 Unsupported operation 5 Device not found. 6 Format boot drive illegal 7 Buffer too small. 8 Virtual Disk contains boot partition. Use force option to delete. 9 Init boot drive failed. 10 Format boot drive failed. 11 Cannot write boot drive. 12 Unsupported RAID value.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 23 RAID 50 failed. 24 RAID 5 not supported. 25 RAID 50 not supported. 26 Size too small for given RAID type. 27 Wrong number of disks for RAID 1concatenated. 28 Insufficient space to mirror disks. 29 Create Mirror not supported. 30 Disk in use. 31 Disk Lock operation failed. 32 Disk locked. 33 Disk Unlock operation failed. 34 Disk Unlocked.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 47 Disk Online failed. 48 Disk Offline failed. 49 UnMount Operation failed. 50 Mount Operation failed. 51 Cannot Format Array Disk. 52 Bad chunk size. 53 Invalid disk. 54 Virtual disk not found. 55 Virtual disk locked. 56 Drive in use. 57 Reached maximum physical size. 58 Reached maximum count of virtual disks.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 66 Create virtual disk failed. 67 Create virtual disk failed. Controller busy. 68 Create virtual disk failed. Failed to map virtual disk to operating system disk. 69 Create virtual disk failed. Failed to map virtual disk to operating system disk. 70 Virtual disk initialization failed. 71 Virtual disk initialization failed. Controller busy.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 83 The new virtual disk must use only the remaining free space on the array disks used in the last virtual disk you created. Select all array disks that are used in the last virtual disk you created. 84 You have selected an array disk that is in a degraded or failed state. Choose another array disk. 85 Delete the last created virtual disk first.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 100 Virtual Disk Requires Non Multilevel. 101 Virtual Disk Promote Operation failed. 102 Specified virtual disk has no drive letter assigned to it. 103 Cannot expose virtual disk. 104 Cannot reconfigure virtual disk. 105 Cannot stop the reconfiguration of the virtual disk. 106 SMART report count not supported.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 118 Cannot reconfigure from current RAID level to the given RAID level. 119 One of the array disks selected for the virtual disk is already in use. 120 Virtual disk operation not supported. Cannot use non-RAID disk. 121 Controller Read Configuration failed. 122 Controller Write Configuration failed. 123 Controller cache flush failed.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 140 The controller was not able to add space to the specified concatenation set. 141 The controller was not able to get the status of the specified mirror set. 142 The controller was not able to set the requested failover space. 143 The controller cannot get the failover space information. 144 Controller cannot unmirror the specified virtual disk.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 159 The virtual disk is not valid for requested operation. 160 Cannot communicate with controller. 161 Set operation failed. 162 Operation to update error count of SMART device has failed. 163 Operation to clear error count of SMART device has failed. 164 Driver could not execute. 165 Cannot delete virtual disk. 166 Cannot set temperature probe.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 176 Invalid array disks or failover selected for reconfigure/create Please make sure that all array failover drives associated with disk are selected. drives operation. disks and the virtual 177 The maximum number of partitions have already been created on one of the selected array disk(s). Each array disk can hold portions (partitions) of up to 10 virtual disks.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 184 The operation cannot be performed at this time. The firmware can recondition a battery that has a Degraded or Power Low state. The firmware will not recondition a battery that is functioning normally or that has a Ready, Failed or Missing state. 185 The version of the controller firmware installed on your system does not support this operation.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 195 An error occurred while resetting a temperature probe. 200 No array disks found! 201 Invalid Virtual Disk ID! 202 RAID Type & Size are required to create a virtual disk. Ensure that the RAID type and the size are correct.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 216 Invalid virtual disk size! 217 The strict option provided failed! Virtual disk is not created. 218 Unable to determine optimum size for Virtual disk. Ensure that the array disks are of the same protocol (i.e. SAS, SATA, SCSI). If there is a mismatch of the array disks then the RAIDCFG will not be able to determine the optimum size.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm RACADM Firmware Error Codes and Messages Table A-6 lists RACADM firmware error codes and messages. Table A-6. RACADM Firmware Error Codes and Messages Error Code Message 1 UNKNOWN COMMAND.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-6.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-6. RACADM Firmware Error Codes and Messages (continued) Error Code Message 52 MODULE NOT LOADED 53 IPMI ERROR 54 ERROR IN DIAGNOSTIC FUNCTION RACADM Utility Error Codes and Messages Table A-7 lists RACADM utility error codes and messages. Table A-7. RACADM Error Codes and Messages Error Code Message 513 An unknown failure occurred. 514 Librac library not initialized. 515 An invalid parameter was passed into function.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-7. RACADM Error Codes and Messages (continued) Error Code Message 526 Specified user buffer is too small to hold data. 527 Authentication failed - Invalid user name or password. 528 Invalid CHAP protocol response encountered. 529 CHAP buffer too small. 530 Timeout occurred. 531 Insufficient user privileges to perform operation. 532 TFTP write error encountered. 533 TFTP read error encountered.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.fm Table A-7. RACADM Error Codes and Messages (continued) Error Code Message 549 Failed to login to RAC successfully. 550 Invalid session ID specified. 551 Failed to logout from RAC successfully. 552 Command execution failed. 553 FTP Get operation failed. 554 FTP Put operation failed. 555 Failed to initialize FTP interface. 556 Failed to load SSL library. 557 Failed to initialize librac library. 558 Invalid session ID.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaB.
B BMC Platform Events Filter Alert Messages All possible Platform Event Filter (PEF) Alert Messages along with a description of each event are listed in Table B-1. Table B-1. BMC PEF Alert Events Event Description Fan Probe Failure The fan is running too slow or not at all. Voltage Probe Failure The voltage is too low for proper operation. Discrete Voltage Probe Failure The voltage is too low for proper operation.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaC.fm Table B-1. BMC PEF Alert Events (continued) Event Description Hardware log is full or emptied Either an empty or a full hardware log requires administrator attention. Automatic System Recovery The system is hung or is not responding and is taking an action configured by Automatic System Recovery. System Power Probe Warning The system is setting actions when a power consumption probe detects a warning value.
C Sample File Formats This appendix lists the sample SYSCFG utility .ini, RAIDCFG utility .ini, and the RACADM utility .ini files. Sample SYSCFG Utility .ini File Format [syscfg] sysname=PowerEdge R805 sysid=0221 biosver=0.2.6 ;svctag=VSPT067 ;do not edit information above this line acpower=last asset= bootseq= nic.emb.1,nic.emb.2,nic.emb.3,satacdrom.emb.0,nic.emb .
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm extserial=com1 fsbr=115200 integratedsas=enable internalusb=on lancfgparams alertdest=1 destipaddr=0.0.0.0 lancfgparams alertdest=2 destipaddr=0.0.0.0 lancfgparams alertdest=3 destipaddr=0.0.0.0 lancfgparams alertdest=4 destipaddr=0.0.0.0 commstring=public gateway=192.168.0.1 ;ipaddress=192.168.0.120 ipaddrsrc=static nicselection=dedicated autoneg=enable dnsserver1=0.0.0.0 dnsserver2=0.0.0.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm dnsregisterrac=disable domainname= domainnamednsdhcp=disable fullduplex=enable speed=100Mbps subnetmask=255.255.255.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm filteraction=none pefcfgparams filter=powerabsent filteralert=enable filteraction=none pefcfgparams filter=batterywarn filteralert=enable filteraction=none pefcfgparams filter=batteryfail filteralert=enable filteraction=none pefcfgparams filter=systempowerwarn filteralert=enable filteraction=none pefcfgparams filter=systempowerfail filteralert=enable filteraction=none hostname=DTK2.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm Sample RAIDCFG Utility .
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm writepolicy=wb stripesize=64 cachepolicy=d adisk=0:5:1,0:4:1 failoverdrive=0:9:1 [vdisk3] controllerid=4 size=278784 raid=5 readpolicy=ra writepolicy=wb stripesize=64 cachepolicy=c adisk=0:8:1,0:7:1,0:6:1 [GlobalHotspare0] controllerid=0 failoverdrive=0:8:0 Sample RACADM Utility .
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm idRacMisc= [cfgLanNetworking] cfgNicEnable=1 cfgNicIpAddress=10.98.8.121 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.0.1 cfgNicUseDhcp=0 #cfgNicMacAddress=00:11:43:34:5f:4a cfgDNSServersFromDHCP=0 cfgDNSServer1=192.168.0.5 cfgDNSServer2=192.168.0.6 cfgDNSRegisterRac=0 cfgDNSRacName=RAC-HHS7C1S cfgDNSDomainNameFromDHCP=0 cfgDNSDomainName=MYDOMAIN [cfgCurrentLanNetworking] #cfgNicCurrentIpAddress=10.98.8.121 #cfgNicCurrentNetmask=255.255.255.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm [cfgRemoteHosts] cfgRhostsSmtpEmailEnable=1 cfgRhostsFwUpdateTftpEnable=1 cfgRhostsSmtpServerIpAddr=127.0.0.1 cfgRhostsFwUpdateIpAddr=192.168.0.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm cfgSerialConsoleQuitKey=~.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.fm cfgOobSnmpAgentCommunity=public [cfgRacTuning] cfgRacTuneFwUpdateResetDelay=0x46 cfgRacTuneD3debugEnable=1 cfgRacTuneRemoteRacadmEnable=1 cfgRacTuneHostCom2BaudRate=57600 cfgRacTuneHttpPort=0x50 cfgRacTuneHttpsPort=0x1bb cfgRacTuneTelnetPort=0x17 cfgRacTuneConRedirPort=0x170c [ifcRacManagedNodeOs] ifcRacMnOsHostname=(none) ifcRacMnOsOsName=Linux 2.4.21-20.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaD.
D Summary of SYSCFG and RAIDCFG Options This appendix contains a summary of all the SYSCFG and RAIDCFG options. SYSCFG Options Table D-1 lists all the SYSCFG options and gives a brief description of these options. For details on these options, see the section, ""SYSCFG" on page 19". Table D-1.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description -o or --outfile NA Outputs all replicable options to the specified filename. The format of the output is in the.ini format, with the utility name as the section header. -s NA --version* NA --acpower NA Replicated Prints the variable name and the value assigned to it to the console.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description --bootseq NA numerical Sets the boot order. list, separated by commas or list of device names, separated by commas --bootseqretry Replicated Yes (for systems that support a list of device names only) NA enable, disable Enables or disables the boot Yes sequence retry feature.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --cstates NA enable, disable Enables or disables the power c states of the processor. Yes Available only on Dell PowerEdge xx1x systems. --dbpm NA enable, disable Enables or disables demand- Yes based power management. --devseq NA numerical list, separated by commas Sets the boot order for hard drives.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --embnic4 NA on, off, onnopxe, onwithiscsi Enables or disables the fourth embedded NIC. Yes --embnic1nic2 NA enable, disable Enables or disables the Yes operating system interface of the first and second embedded NIC controllers. Available only on Dell PowerEdge 1855, PowerEdge 6850, and xx1x systems.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --embscsiraid NA raid, off, scsi Enables or disables the embedded SCSI RAID or controller. raid, off Yes -NA embscsiraidchb raid, scsi Sets the second channel of the embedded SCSI RAID controller to operate in RAID or SCSI mode. Yes --embvideoctrl NA enable, disable Enables or disables the embedded video controller.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --fsbr NA 115200, 57600, 19200, 9600 Sets the console redirection fail safe baud rate. Yes --hwprefetcher NA enable, disable Enables or disables hardware Yes prefetching by the processor. --hddfailover NA off, on Specifies which device in the Yes hard disk drive sequence menu is attempted in the boot sequence.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --ioat NA enable, disable Enables or disables the I/O Acceleration Technology (I/OAT)\nDMA Engine option.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --logicproc NA enable, disable Enables or disables the logical processor (Hyperthreading). Yes --lpt NA disable, lpt1, Disables or sets the parallel lpt2, lpt3 port address. Yes --lptmode NA at, ps2 Sets the parallel port mode. Yes --mem* NA none Reports the size of system memory.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --numlock NA on, off Enables or disables the keyboard number lock. Yes --oldsetuppwd NA Confirms the existing setup No password when setting a new setup password. --oldsyspwd NA Confirms the existing system No password when setting a new system password.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated -min, max, Allows you to set the CPU cpupowermo osdbpm, power and performance de systemdbpm management to minimum power, maximum performance, operating system DBPM, or system DBPM mode.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description -maxpowerca p Displays the value of the maximum power threshold. -minpowerca p Displays the value of the minimum power threshold. - valsetuppwd Validates the setup password for power authentication. If you try to change DTK settings, you are prompted to enter this password to access the settings.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --redmem NA off, spare, mirror, raid Configures the redundant memory mode. Yes If you perform operations that change the --redmem option, you must immediately reboot the system. This applies to command line usage as well as --infile usage.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --sata2 NA auto, off Enables or disables SATA port 2. Yes NOTE: This option maps to --sata_c for Dell PowerEdge x9xx systems. --sata3 NA auto, off Enables or disables SATA port 3. Yes NOTE: This option maps to --sata_d for Dell PowerEdge x9xx systems. --sata4 NA auto, off Enables or disables SATA port 4.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments --serial1 NA disable, Configures the behavior for com1, com3, serial port 1. com1_bmc, bmcserial, bmclan, rac Yes --serial2 NA auto, disable, Configures the behavior for com2, com4 serial port 2. Yes --serialcomm NA on, com1cr, com2cr, off Configures the behavior of serial port communication.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options tcm tpm Valid Arguments Description Replicated --tcmsecurity off, on Configures the TCM security feature. Yes -enabled, tcmactivatio disabled, n nochange Enables or disables the TCM Yes activation feature. --tcmclear Clears the contents of the TCM chip without erasing the tcmsecurity and tcmactivation settings.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated -NA setuppwdove rride On systems that do not have No a setup password configured, if you set this option, you are not prompted for a password to access DTK settings. --turbomode NA enable, disable Enables or disables corebased turbo mode. --usb NA on, off, legacy Enables or disables the USB Yes port.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description --deviceguid NA NA Displays the GUID for the BMC. --encryptkey NA Platform Management Interface (IPMI) sessions. --identify NA 0–254 Replicated Yes Flashes the identification LED for a specified number of seconds.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description lancfgparams or lcp --ipaddrsrc static, dhcp --ipaddress Configures and displays LAN configuration parameters.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description --loaddefaults NA NA Restores the BMC to the defaults that were originally loaded on the controller. This option is used to return the BMC to a known-good state. --nextboot NA Sets the device for the next boot operation only. --nmibutton NA enable, disable Enables or disables the NMI button.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated --filteraction powercycle, reset, powerdown, powerreducti on, none --hostname --filteralert enable, disable -1, 2, 3, 4 alertpolnum enable, -alertpolstatu disable s --powerbutton NA enable, disable Enables or disables the power button.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description --racreset NA NA Resets the RAC. It cannot be No accompanied with any other option. serialchannelac -disable, cess or ipmioverseri alwaysavail sca al Replicated Sets or displays the channel access settings for the serial channel.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options serialcfgparams -or connection scp mode Valid Arguments Description basic, terminal Configures and displays serial configuration parameters. -noflowctrl, msgcommflo rtscts wctrl -NA msgcommdt rhangup Replicated NOTE: The BMC firmware does not support serial port Point-to-Point Protocol (PPP) configurations.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description Replicated serialuseraccess --usrprivlmt user, Configures and displays user or operator, access parameters for the sua administrator serial channel. , noaccess --userid 2–10 -NA currentenabl eduserids -NA useridswithfi xednames --solaction Enables or disables SerialOver-LAN (SOL) access for a particular user.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description solcfgparams --solenable enable, disable Configures and displays SOL configuration parameters.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description -r or --read NA NA Reads the value of state data. -x NA NA Specifies that the state data value should be in hexadecimal format. --asset NA NA Reports the asset tag for a system. --biosver NA NA Reports the BIOS version for a system. --chassvctag NA NA Reports the chassis service tag for modular systems.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description --svctag NA NA Reports the service tag for a system. --sysasset NA NA Reports the asset tag for a server module in a modular system chassis. --sysid NA NA Reports the unique system ID bytes for a system. --sysname NA NA Reports the system identification string for a system.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-1. SYSCFG Options (continued) Options Sub-options Valid Arguments Description --dnssrcv6 = auto Automatically configures the DNS address. --dnssrcv6= static -dnsserver1v6 = Allows you to manually set the DNS address. -linklocaladdr ipv6= Allows you to view IPv6 addresses. -gatewayv6= Allows you to view IP gatewayv6 address.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm RAIDCFG Options Table D-2 lists all the RAIDCFG options and gives a brief description of these options. For details on these options, see the section, "RAIDCFG". Table D-2. RAIDCFG Short and Long Format Options Option Valid Arguments Short Description Mandatory or Optional No option NA Displays general usage information for the utility. The usage information consists of a comprehensive list of valid options, parameters, and arguments.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -ad ch:targ, ch:targ, ... Specifies an array disk. Optional. or or ch:targ:lun,... adisk or ch:targ:enc See Table 4-5 for specific usage information. channel:target, or channel:target:lu n, or channel:target:en closure -c or Short Description For SCSI controllers, the value of LUN should always be 0.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -fd ch:targ, ch:targ, ... Specifies the location of the failover or ch:targ:lun,... drive in an array. or Short Description Mandatory or Optional Optional. See Table 4-4 for specific usage information. failoverd or ch:targ:enc rive channel:target, or channel:target:lu n, or channel:target:en closure For SCSI controllers, the value of LUN should always be 0.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -rp ra, ara, nra, rc, nrc Sets the read policy for the virtual disk. Optional. NA Mandatory. or Short Description readpoli cy -se or setenviro nment -si Sets a user-defined environment variable to the value returned from the function call.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\DTKCLaE.fm Table D-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description -ssz Sets the stripe size on the virtual disk Optional. in KB. See Table 4-4 for NOTE: When creating virtual disks, do specific usage not specify the units for chunk (stripe) information. size. The units are always listed in KB.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookIX.
FILE LOCATION: C:\Work\DTK\DTK_CLI_3.4\Source\bookIX.
