Dell OpenManage Deployment Toolkit Version 4.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2012 Dell Inc.
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Introduction..................................................................................................................................7 What's New In This Release....................................................................................................................................7 Supported Systems..................................................
-i or --infile........................................................................................................................................................21 --ix or --inxmlfile...............................................................................................................................................21 -l or --logfile......................................................................................................................................................
useraction........................................................................................................................................................98 username..........................................................................................................................................................99 version*..........................................................................................................................................................100 virutualmedia...
UPINIT Options And Arguments...........................................................................................................................140 6 Messages And Codes.............................................................................................................143 SYSCFG Error Codes And Messages....................................................................................................................143 Failure Messages........................................................
Introduction 1 Dell OpenManage Deployment Toolkit (DTK) includes a set of utilities, sample scripts, and sample configuration files to deploy and configure your Dell system. You can use DTK to build script-based and RPM-based installation for deploying a large number of systems reliably, without changing their current deployment processes. You can use DTK in a Microsoft Windows Preinstallation Environment (Windows PE) or a Linux environment.
• • – NX3000 – NX3100 – NX300 – NX200 – NX3300 – NX3200 – NX400 Support for creating and reporting RAID in following Dell PowerVault enclosures: – MD1000 – MD1200 – MD1220 Deprecated support for the following operating systems: – Windows PE 2.0 (32-bit and 64-bit) – Red Hat Enterprise Linux 6.2 Supported Systems For a complete list of supported Dell PowerEdge systems, see the Dell Systems Software Support Matrix available at dell.com/support/manuals.
Toolkit Utilities DTK contains utilities that allow you to configure the BIOS, Baseboard Management Controller (BMC), Remote Access Controller (RAC), RAID controllers, and hard-drive partitions on supported Dell systems. Additionally, the utilities can be integrated with the sample files provided with the toolkit to fully configure one-to-many target systems in a scripted mass system deployment. NOTE: In a Linux environment, the DTK utilities do not have the .exe extension.
The syscfg.ini file cannot be used across different systems. The file output operation places system identification information at the beginning of the [syscfg] section. This information is used to determine if the file can be accepted as input for a system. The following information is used for system identification: • System ID Byte(s) • System Name • BIOS Version If these values do not match the values found on the system, the file input operation fails.
• The Dell Systems Software Support Matrix provides information about the various Dell systems, the operating systems supported by these systems, and the Dell OpenManage components that can be installed on these systems.
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 as long as they conform to the basic command line syntax. DTK Utilities General Usage The following table lists the general usage models of the DTK utilities: Table 1. DTK Utilities Utilities Usage SYSCFG syscfg --option1=[arg1] ... --optionX=[argX] or syscfg bmcoption1 --bmcsuboption1=[arg1]...
Table 2. Command Line Options Element Description - Prefix single character options. NOTE: This delimiter is not applicable to Baseboard Management Controller (BMC) sub-options. -- Prefix multi-character options. utilname Indicates the generic designation for a DTK utility name. o Indicates the generic single-character designation for an option.
Table 3. Command Line Option Delimiters Valid / Invalid DTK Command Line Example valid syscfg --option1 --option2 syscfg --asset --floppy invalid syscfg --option1=argument -option2 --option3 syscfg --asset=R910 --floppy -bootseq valid syscfg -o=filename --option1 -option2 syscfg -o=/tmp/myfile.txt --floppy --bootseq valid syscfg -l=filename --option1 -option2 syscfg -l=/tmp/myfile.txt --floppy --bootseq invalid syscfg -i=filename --option1 -option2 syscfg -i=/tmp/myfile.
Delimiter Example Description backslashes (\\), and the double quotation mark (") is interpreted as a string delimiter. If an odd number of backslashes are syscfg --option="\\ followed by a double quotation mark, \"argument" then one backslash (\) is taken for every pair of backslashes (\\) and the double quotation mark is interpreted as an escape sequence by the remaining backslash, causing a literal double quotation mark (") to be placed in the SYSCFG argument. considers \ "argument as the argument.
Help Option The -h and --help options display general usage information for the utility. If the argument matches a valid option, that usage information of the option is displayed. If the option has arguments, the arguments are displayed, separated by a | character. If the argument does not match a valid option, a usage error is given (and usage information is displayed). This option cannot be replicated.
3 SYSCFG This section documents the Deployment Toolkit (DTK) system configuration utility. It describes the command line parameters, configuration file format, and individual executables used to configure server BIOS and Baseboard Management Controller (BMC) settings, DTK state settings, and system information including PCI device detection. Features The SYSCFG utility: • Displays help and usage information. • Outputs configuration options to a file or screen.
Valid Arguments NA Description The SYSCFG utility outputs usage information. The usage information is displayed in the format shown below. --envar Options --envar Sub-Options NA Valid Arguments media should be writable Description Stores the environment variable data to a file when used with the – s option. This file can be called from other scripts to set the environment variable.
Example: A:>syscfg -h lanchannelaccess lanchannelaccess: Reports LAN channel access information. Sub-options: pefalerting: Enable or disable PEF (Platform Event Filter)alerting. Arguments: enable | disable ipmioverlan: Enable or disable IPMI over LAN access. Arguments: disable | alwaysavail channelprivlmt: Sets the maximum privilege level that can be accepted on the LAN channel.
specified in a file, the utility ignores the option. If any errors are found in the format of the names or values, an error is returned and the options are not applied to the system. If this option is dependent on any other option, they are applied in the order in which they appear in the xml file. NOTE: It is applicable only on 12G and later systems. Example: A:>syscfg --ix filename.
--ox or --outxmlfile Options --ox or --outxmlfile Sub-Options NA Valid Arguments Description Prints all BIOS options to the specified xml file. NOTE: It is applicable only on 12G and later sytems. Example: A:>syscfg --ox filename.ini --px or --pendingxmlfile Options --px or --pendingxmlfile Sub-Options NA Valid Arguments Description Prints all the pending BIOS options to a specified xml file. NOTE: It is applicable only on 12G and later sytems.
--version* Options --version* Sub-Options NA Valid Arguments NA Description Displays the version information, current time, and date for the utility. This option cannot be replicated. Example: A:>syscfg --version syscfg Version 4.2 P01(Windows - Oct 21 2012,16:48:48) Copyright (c) 2002-2012 Dell Inc. SYSCFG For BIOS Configuration SYSCFG uses BIOS interfaces to manipulate boot order and BIOS settings.
--adjcacheprefetch Option --adjcacheprefetch Valid Arguments enable, disable Description When this option is set to enable, the processor fetches the cache line containing the currently requested data, and the adjacent cache line. When this option is set to disable, the processor fetches only the cache line containing the currently requested data. Example: A:>syscfg --adjcacheprefetch=enable adjcacheprefetch=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--bezelir Option --bezelir Valid Arguments enable, disable Description Enables or disables the ESM to monitor and log front bezel intrusion conditions.
Numerical Lists Examples: A:>syscfg --bootseq= 2,3,4,5,1,6 The following devices are set in the boot sequence: Device 2:* usbcdrom.slot.1- USB CD-ROM device Device 3:* virtualcd.slot.1 – VIRTUAL CDROM Device 4:* hdd.emb.0 -Hard drive C: Device 5:* nic.emb.1 - MBA v2.5.12 Slot 0500 Device 1:* virtualfloppy.slot.1 - VIRTUAL FLOPPY Device 6:* usbfloppy.slot.1 - USB Floppy device NOTE: The asterisk indicates that the device is enabled in the BIOS. Device Name Examples: Example of device names: nic.slot.
--bootseqretry Option --bootseqretry Valid Arguments enable, disable Description Enables or disables the boot sequence retry feature. When set to enable, the system re-attempts to set the boot order after a 30-second time-out if the last boot attempt has failed. This option can be replicated. A:>syscfg --bootseqretry=enable bootseqretry=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
Example: A:>syscfg --conred=serial1 conred=serial1 Applicable Systems All PowerEdge systems prior to PowerEdge x9xx (9G) systems. --conterm Option --conterm Valid Arguments vt100, ansi Description Configures or reports the terminal type for console redirection. This option is available on all supported systems that support console redirection. This option can be replicated. Example: A:>syscfg --conterm=vt100 conterm=vt100 Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--cpucore Option --cpucore Valid Arguments 1, 2, 4, 6, 8, 10, 12, 14, 16, all Description Controls the number of enabled cores in each processor. The default value is set to the maximum number of cores per processor. The number of cores depends on the processor. Reading the cpucore that is set to the highest value of number of cores displays as all. For example, if 6-core CPU is installed, after setting to the highest value, 6, when you read the cpucore, it displays as all.
Description Enables or disables data reuse. Set to enable for High Performance Computing (HPC) applications. Set to disable for energy efficiency. This option can be replicated. A:>syscfg --datareuse=enable datareuse=enable Applicable Systems PowerEdge 11G systems --dbpm Option --dbpm Valid Arguments enable, disable Description Enables or disables demand-based power management. This option can be replicated.
Example 1: A:>syscfg --devseq The following devices are set in the disk device sequence: Device 1:* hdd.emb.0 - System BIOS boot devices Device 2:* scsiraid.slot.3 - PERC 5/E Adapter(bus 02 dev 02) Device 3:* usbkey.slot.0 - Hard-disk-emulated USB flash drive Example 2: A:>syscfg --devseq= hdd.emb.1,scsiraid.emb.1 The following devices are set in the disk device sequence: Device 1:* hdd.emb.0 - System BIOS boot devices Device 2:* scsiraid.emb.
--embnic1 Option --embnic1 Valid Arguments on, off, onnopxe, onwithiscsi Description Turns the first embedded NIC on with PXE on, off, or on without PXE enabled. This option is only valid for supported systems that have a NIC. If the NIC is enabled without PXE, it is not found in the boot order. If the NIC is turned on with PXE, it is placed at the end of the boot order. The onnopxe argument is not supported on all systems.
Example: A:>syscfg --embnic3=onnopxe embnic3=onnopxe Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --embnic4 Option --embnic4 Valid Arguments on, off, onnopxe, onwithiscsi Description Turns the fourth embedded NIC on with PXE enabled, off, or on without PXE enabled. This option is only valid for supported systems that have four embedded NICs. If the fourth NIC is enabled without PXE, it is not found in the boot order.
--embnics Option --embnics Valid Arguments enable, disable Description Turns both the embedded NICs on or off. This option is only present on systems that do not support the embnic1 and embnic2 options. This option can be replicated.
Description Configures an embedded SATA RAID controller. This option can be replicated. • • • • • • off — disables the embedded SATA RAID controller. combined — sets the SATA RAID controller to combined mode. ata — sets SATA RAID controller to ATA mode. ahci — sets ATA RAID controller to ahci mode. raid — sets SATA RAID controller to RAID mode. qdma — sets the SATA RAID controller to support ATAPI devices at transfer rates much higher than PIO.
CAUTION: If you change the controller from SCSI to RAID mode, data loss may occur. Backup any data you must save before changing modes. Example: A:>syscfg --embscsiraid=raid embscsiraid=raid Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --embscsiraidchb Option --embscsiraidchb Valid Arguments raid, scsi Description Sets the second channel on an embedded RAID controller to SCSI or RAID.
When set to rad , the external serial connector is routed to the remote access device interface. Terminal escape sequences can toggle the external connector between the system (COM2) and the remote access device. This option can be replicated. Example: A:>syscfg --extserial=com1 extserial=com1 The --serialcomm option can be used with the external serial (--extserial) option instead of the --conred (available on systems earlier than PowerEdge 9G systems) option.
--f1f2promptonerror Option ––f1f2 prompt onerror Valid Arguments enable, disable Description Enables or disables the BIOS to prompt F1 or F2 error codes. Example: A:>syscfg --f1f2promptonerror=enable f1f2promptonerror=enable Applicable Systems PowerEdge 10G and later systems --floppy Option --floppy Valid Arguments auto, off, readonly Description Sets the diskette drive controller to auto, off, or readonly. This option is available on all supported systems that have a supported diskette drive.
Example: A:>syscfg --fsbr=9600 fsbr=9600 Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --hddfailover Option --hddfailover Valid Arguments off, on Descriptionoff Specifies the device in the Hard Disk Drive Sequence menu that has not been attempted in the boot sequence. When set to on, all devices are attempted in an order in which they are configured. When set to off, only the first device in the hard disk sequence is attempted. This option can be replicated.
--hwprefetcher Option --hwprefetcher Valid Arguments enable, disable Description Processor preempts what data might be needed next, when set to enable. When some data is found, it loads several steps in advance. Processor does not preempt, when set to disable. This option can be replicated. Example: A:>syscfg --hwprefetcher=enable hwprefetcher=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --integratedsas Option --integratedsas Valid Arguments enable, disable Description Enables or disables the integrated SAS controller. This option can be replicated. Example: A:>syscfg --integratedsas=enable integratedsas=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --inteltxt Option --inteltxt Valid Arguments enable, disable Description Enables or disables the Intel TXT option.
--ioat Option --ioat Valid Arguments enable, disable Description Enables or disables the I/O Acceleration Technology (I/OAT) DMA Engine option. This option must be enabled only if the hardware and software support I/OAT on your system. This option can be replicated. Example: A:>syscfg --ioat=enable ioat=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --logicproc Option --logicproc Valid Arguments enable, disable Description Enables or disables logical processing for a system. This option is available on all systems that support logical processing (Hyperthreading). This option can be replicated. Example: A:>syscfg --logicproc=enable logicproc=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
Example: A:>syscfg --memintleave=enable memintleave=enable NOTE: The memintleave option is same as Nodeinterleave option. For more information, see Memory Settings group. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --memoperatingmode Option --memoperatingmode Valid Arguments optimizer, mirror, advancedecc Description Selects the memory operating mode. This feature is active only if a valid memory configuration is detected.
--memtest Option --memtest Valid Arguments enable, disable Description Enables or disables the POST extended memory test. Example: A:>syscfg --memtest=disable memtest=disable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --mouse Option --mouse Valid Arguments on, off Description Turns the mouse controller on or off. This option can be replicated. Example: A:>syscfg --mouse=off mouse=off Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
-noraidprompt* Option --noraidprompt* NOTE: The asterisk is not part of the command syntax. Valid Arguments NA Description Specifies that the BIOS must not prompt for confirmation when changing the mode of a RAID controller. This option can only be used with the --embscsiraid or --embscsiraidchb options. Without this option, the user is prompted during POST to confirm the change of a RAID controller from RAID (SCSI) to SCSI (RAID). This option is not replicated.
Example: A:>syscfg --setuppwd=asetuppassword -oldsetuppwd=currentpassword The password has been set.Please use a warm reboot to apply the password to the system. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --oldsyspwd Option --oldsyspwd Valid Arguments Description Supplies the current system password for the BIOS. This option is only given when setting the new system password.
Description Aids in the recovery of the operating system when the system stops responding. When this option is set to enable, the operating system is allowed to initialize the timer. When set to disable (the default), the timer has no effect on the system. Example: A:>syscfg --oswatchdogtimer=enable oswatchdogtimer=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --ovrwrt* Option --ovrwrt* NOTE: The asterisk is not part of the command syntax.
--qpibandwidthpriority Option --qpibandwidthpriority Valid Arguments compute, io Description Sets the bandwidth priority to compute or io. Set to compute for computationintensive applications. Set to io for I/O intensive applications. This option can be replicated.
Example: A:>syscfg --remflashmedia Internal Dual SD ModuleRedundancy=Lost SD1 status=Absent SD1 status=Active Applicable Systems PowerEdge R810, R815, R910, and M910 systems --rptkeyerr Option --rptkeyerr Valid Arguments enable, disable Description Enables or disables the BIOS to report keyboard errors during POST. This option can be replicated. Example: A:>syscfg --rptkeyerr=disable rptkeyerr=disable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata2 Option --sata2 Valid Arguments auto, off Description Turns the SATA port 2 to auto or off. This option can be replicated. Example: A:>syscfg --sata2=auto sata2=auto NOTE: This option maps to --sata_c for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --sata3 Option --sata3 Valid Arguments auto, off Description Turns the SATA port 3 to auto or off. This option can be replicated.
Example: A:>syscfg --sata5=auto sata5=auto NOTE: This option maps to --sata_f for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --sata6 Option --sata6 Valid Arguments auto, off Description Turns the SATA port 6 to auto or off. This option can be replicated. Example: A:>syscfg --sata6=auto sata6=auto NOTE: This option maps to --sata_g for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--serial1 Option --serial1 Valid Arguments disable, com1, com3, com1_bmc, bmcserial, bmclan, rac Description Configures or reports the first serial port communication port. This option can be replicated. • • • • bmcserial — maps serial port 1 to BMC Serial. bmclan — routes the serial traffic destined for serial1 out to NIC1. com1_bmc — maps serial port 1 to COM port 1 BMC. rac — maps serial port 1 to the RAC device.
Example: A:>syscfg --serialcomm=on serialcomm=on The --serialcomm option can be used with the external serial (--extserial) option instead of the --conred (available on systems earlier than PowerEdge 9G systems) option. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --serialportaddrsel Option --serialportaddrsel Valid Arguments default, alternate Description Sets the port address of the serial devices.
NOTE: You cannot disable your password using DTK. To disable your password, you must use the system BIOS. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --sma Option --sma Valid Arguments enable, disable Description Enables or disables processor sequential memory access. Example: A:>syscfg --sma=disable sma=disable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --slotname* Option --slotname* NOTE: The asterisk is not part of the command syntax.
Description Reports the service tag for a system. If used with the -s general option, the environment variable is set to the service tag. Example: A:>syscfg --svctag svctag=113CD1S Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems except Blade systems. --syspwd Option --syspwd Valid Arguments Description Sets the system password for the BIOS. The system password is required when booting the system. The argument string supplied to this option is the password.
--turbomode Option --turbomode Valid Arguments enable, disable Description Enables or disables core-based turbo mode. Turbo mode is a feature on Intel processors that allows one processor core to increase the frequency by one bin whenever the other core has gone into an idle state.
ports are disabled. When set to disable, both front and back user accessible ports are disabled. This option can be replicated. Example: A:>syscfg --usbports=enable usbports=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --virtualization Option --virtualization Valid Arguments enable, disable Description Enables or disables virtualization in the CPU.
Option Sub-option Arguments Description onwithoutpbm Directs the BIOS to bypass the preboot measurements. Example: A:>syscfg tpm -tpmsecurity=onwithoutpbm --setuppwdoverride -tpmactivation enabled Enables and activates the TPM feature. disabled Disables and deactivates the TPM feature. nochange Does not alter the operational state of the TPM feature. Example: A:>syscfg tpm -tpmactivation=enabled -setuppwdoverride NOTE: You cannot set tpmactivation when tpmsecurity is set to off.
Option Sub-option Arguments Description the settings. For more information on delimiters, see Command Line Option Delimiters. Example: A:>syscfg tpm -tpmactivation=enabled --tpmclear --valsetuppwd= -setuppwdoverri de NA On systems that do not have a setup password configured, if you set this option, you are not prompted for a password to access DTK settings. A:>syscfg tpm -tpmactivation=enabled --tpmclear --setuppwdoverride Sub Options And Arguments For tcm Option Table 7.
Sub Options And Arguments For power Option Table 8. Sub-options and Arguments for the power Option Option Sub-option Arguments Description power --profile where powerprofile can be maxperformance, osctl, apc Displays the settings similar to the BIOS setup screen for the respective profile. Reboot the system for the settings to take effect. If power profiles are not available on the platform, an error message is displayed.
Option Sub-option Arguments Description NOTE: This option is available only with the appropriate installed license. is the limit for power consumption in Watts, or btuphr, or NOTE: This percent. option is available only is the unit of with the the appropriate value and can be installed license. watt, or btuphr, or percent. -cap --unit The value of must be between the maximum and minimum threshold values, else an error is displayed.
NOTE: PowerEdge 12G systems are backward compatible and support legacy arguments enable and disable. However, it is recommended to use enabled and disabled on PowerEdge 12G systems as the arguments enable and disable may be deprecated in future. For more information, see the BIOS options help. To list the options which are are set on the system, but not applied due to pending reboot, type: syscfg --pendingvalues BIOS Boot Settings Table 9.
Integrated Devices Table 12. Integrated Devices Options Group Option Valid Arguments Description Integrated Devices --EmbNicPortnBootProto Unknown, None, Pxe, Iscsi Controls the legacy boot protocol of the LOM port specified by the embedded NIC port number. This is a write-only attribute. This attribute is for systems management software use, and does not appear in system BIOS setup. This attribute always returns Unknown, when read.
Group Option Valid Arguments Description When set to Mirror mode, readwrite operation occurs on both the secure digital (SD) cards. When one of the SD cards fails and is replaced, on booting, the data of the active card is copied to the offline card. When set to Disabled, read-write operation occurs only on SD card 1. NOTE: On Blade systems, disable the vflash key to configure this option. This option is applicable only on PowerEdge R810, R815, R910, M910, and PowerEdge 12G systems.
Group Option Valid Arguments Description (System DBPM) controls the CPU power management. This feature can be enabled only when CPU power management (ProcPwrPerf) is set to system DBPM in Custom mode. -DynamicCoreAllocation Enabled, Disabled Enables or disables the operating system capability to maintain the logical processors in the idle state to reduce power consumption. --MemOpMode OptimizerMode, SpareMode, MirrorMode, AdvEccMode, SpareWithAdvEccM ode Sets the memory operating mode.
Group Option Valid Arguments Description configuration can support node interleaving. NOTE: The NodeInterleave option is same as memintleave option. For more information, see memintleave. --SerialDbgOut Enabled, Disabled Enables or disables the RC/MRC Serial debug output. --SysMemSize Displays the amount of main memory in the system. --SysMemSpeed Displays the clock frequency of the main memory. --SysMemType Displays the type of main memory installed in the system.
One-Time Boot Table 15. One-Time Boot Options Group Option Valid Arguments Description One-Time Boot --OneTimeBootMode Disabled, OneTimeBootSeq, OneTimeHddSeq, OneTimeUefiBoot Seq, OneTimeCustomB ootSeqStr, OneTimeCustomH ddSeqStr, OneTimeCustomU efiBootSeqStr Allows to set the one-time boot sequence.
Group Option Valid Arguments Description processor core supports maximum two logical processors. 70 --Proc1Brand Displays the brand text provided by the processor manufacturer. --Proc1Id Displays the family, model, and stepping values of the processor. --Proc1L2Cache Displays the amount of memory in the corresponding processor cache. --Proc1L3Cache Displays the amount of memory in the corresponding processor cache.
Group Option Valid Arguments Description --Proc4NumCores Displays the number of cores in the processor package. --Proc64bit Specifies if the installed processor supports 64-bit extensions or not. --ProcAdjCacheLine Enabled, Disabled When set to Enabled (default), the system is optimized for applications that require high utilization of sequential memory access. When set to Disabled, the system is optimized for applications that require high utilization of random memory access.
SATA Settings Table 17. SATA Settings Options Group Option Valid Arguments Description SATA Settings --EmbSata Off, AtaMode, RaidMode, AhciMode Configures an embedded SATA RAID controller. • • • • --eSataPort1 Off, Auto Sets the embedded SATA port1 to auto or off. - eSataPort1Capaci ty Displays the total capacity of a hard-disk drive. This option is undefined for removable-media devices such as optical drives.
Group Option Valid Arguments Description - SataPortCDriveTy pe Indicates the type of device attached to this SATA port. --SataPortCModel Displays the drive model of the selected device. --SataPortD Sets the drive type of the selected device to off or auto . Off, Auto - SataPortDCapacit y Displays the total capacity of a hard-disk drive. This option is undefined for removable-media devices such as optical drives.
Group Option Valid Arguments Description - SataPortHCapacit y Displays the total capacity of a hard-disk drive. This option is undefined for removable-media devices such as optical drives. - SataPortHDriveTy pe Indicates the type of device attached to this SATA port. --SataPortHModel Displays the drive model of the selected device. Serial Communication Table 18.
Group Option Valid Arguments Description --Slot6 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot. --Slot7 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot. System Information Table 20. System Information Options Group Option Valid Arguments Description System Information -SysMfrContactInf o Displays the information for contacting the Original Equipment Manufacturer (OEM) of this system.
Group Option Valid Arguments Description --ProcCStates Enabled, Disabled When set to Enabled, the processor can operate in all available power states. --ProcPwrPerf MaxPerf, MinPwr, SysDbpm, OsDbpm Sets CPU Power Management to maximum performance, operating system DBPM, or System DBPM (DAPC). --ProcTurboMode Enabled, Disabled When set to Enabled, the processor can operate in Turbo Boost Mode.
Group Option Valid Arguments Description --PwrButton Enabled, Disabled Enables or disables the power button on the front panel. --SetupPassword Displays the password and allows the password to be set or modified. The password can be up to 32 characters long and contain most of nonshifted letters, numbers, and punctuation. --SysPassword > Displays the password and allows the password to be set or modified.
Group Option Valid Arguments Description bootmode is set to Uefi. It has no effect when bootmode is set to bios. SYSCFG For BMC And Remote Access Controller Configuration SYSCFG configures Baseboard Management Controller (BMC) and Remote Access Controller (RAC) settings. NOTE: Some of the following options or arguments might not be available on all systems.
controlpanelaccess Table 24. controlpanelaccess options Option Sub-option Valid Arguments Description Applicable Systems -controlpanelacce ss NA viewandmod ify, viewonly, disabled Sets or gets the access level for the Liquid Crystal Display (LCD). Example: A:>syscfg -controlpanelaccess= viewandmodify controlpanelaccess= viewandmodify PowerEdge 11G and 12G systems deviceguid* Table 25.
identify Table 27. identify option Option Sub-option Valid Arguments Description Applicable Systems --identify NA 0–254 Flashes the identification LED for a specified number of seconds. PowerEdge systems with a BMC. NOTE: Use 0 to stop the blinking of the LED. idracversion Table 28. idracversion options Option Sub-option Valid Arguments -idracversio n Description Applicable Systems Displays the version information for the iDRAC and the iDRAC firmware. This option cannot be replicated.
lancfgparams Table 30. lancfgparams options Option Sub-option Valid Arguments lancfgpara ms or lcp Description Applicable Systems Configures and displays LAN configuration parameters. This option can be replicated. All PowerEdge systems Sets the IP address source for the LAN channel. This sub-option can be replicated. --ipaddrsrc static, dhcp --ipaddress channel. This sub-option cannot be replicated.
Option Sub-option Valid Arguments Description --alertdest 1, 2, 3, 4 Sets the destination for the LAN alert. This sub-option can be replicated. --vlantag enable, disable Enables or disables VLAN tagging. This sub-option can be replicated. --vlanid Sets the 12-bit VLAN ID. This suboption can be replicated. --vlanpriority 0–7 Sets the VLAN priority value. This sub-option can be replicated. --macaddress NA Displays the BMC MAC address. This sub-option cannot be replicated.
Option Sub-option Valid Arguments Description --dnsserver1 DNS server for domain name resolution. --dnsserver2 secondary DNS server for domain name resolution. --dnsregisterrac enable, disable Enables or disables binding of the RAC name to the IP address. --dnsracname Sets the name of the RAC. -enable, domainnamefromdhc disable p Enables or disables getting the RAC domain name through DHCP.
Option Sub-option Valid Arguments Description Applicable Systems Example 2 (to set the LAN configuration parameters): A:>syscfg -lancfgparams -destipaddr=192.168.100. 15 --vlantag=enable --vlanid=1000 --vlanpriority=7 -macaddress=0:6:5b:fb:c8 :a7 --commstring=public --ipaddrsrc=static -ipaddress=192.168.100.1 0 -subnetmask=255.255.255. 0 --gateway=192.168.100.1 lanchannelaccess Table 31.
Option Sub-option Valid Arguments Description Applicable Systems Example (to configure the LAN channel with alerts and IPMI over LAN enabled): A:>syscfg lanchannelaccess-pefalerting=enable -ipmioverlan=alwaysava il lanchannelinfo Table 32. lanchannelinfo options Option Sub-option Valid Arguments Description Applicable Systems lanchanneli nfo or lci NA NA Displays media and protocol information about the LAN channel. This option cannot be replicated.
Option Sub-option Valid Arguments Description Applicable Systems Example 1 (to enable User ID 2 on the LAN channel with administrator privileges): A:>syscfg lanuseraccess -userid=2 -usrprivlmt=administrat or Example 2 (to enable User ID 4 on the LAN channel with user privileges): A:>syscfg lanuseraccess -userid=4 -usrprivlmt=user loaddefaults* Table 34.
Option Sub-option Valid Arguments Description Applicable Systems Example 1: A:>syscfg --bootseq Device 1: floppy.emb.0 - Diskette Drive A: Device 2: cdrom.emb.0 - CD-ROM device Device 3: hdd.emb.0 Hard Drive C: Device 4: nic.emb.1 Intel Boot Agent Version 4.0.17 Device 5: nic.emb.2 Intel Boot Agent Version 4.0.17 Example 2: A:>syscfg -nextboot=nic.emb.1 nextboot=nic.emb.1 nmibutton Table 36.
passwordaction Table 37. passwordaction options Option Sub-option Valid Arguments Description Configures and tests the password All PowerEdge for the specified User ID. This option systems cannot be replicated. All three suboptions, action, userid, and password must be included in the command line. passwordact ion NOTE: This option does not support 20 byte passwords. --userid 2–16, if your system has a DRAC 5 controller Specifies the BMC User ID. This sub-option cannot be replicated.
pefcfgparams Table 38. pefcfgparams options Option Sub-option Valid Arguments pefcfgparam s or pcp Description Applicable Systems Configures and displays PEF configuration parameters. This option can be replicated.
Option Sub-option Valid Arguments Description Applicable Systems less for PowerEdge 9G systems and later. --filteralert enable, disable Enables or disables alerts for the filter specified using the filter suboption. This sub-option is dependent on the filter sub-option. This sub-option can be replicated. --alertpolnum 1, 2, 3, 4 Specifies the alert policy entry number. This sub-option can be replicated.
Option Sub-option Valid Arguments Description Applicable Systems Example: A:>syscfg -powerbutton=enable powerbutton=enable powerctl Table 40. powerctl option Option Sub-option Valid Arguments Description Applicable Systems --powerctl NA powerdown Performs a chassis powerdown and controls the reset of the system. Powerdown turns off the system. All PowerEdge systems powercycle Turns off the system and automatically turns on your system after a few seconds.
serialcfgparams Option Sub-option Valid Arguments Description serialcfgpa rams or scp 92 Configures and displays serial configuration parameters. This option can be replicated. -connectionmod e basic, terminal --msgcomm noflowctrl, Sets the IPMI message rtscts communication flow control. This suboption can be replicated. -msgcommdtrhan gup NA Reports the IPMI message communication DTR hang-up. This suboption cannot be replicated.
Option Sub-option Valid Arguments Description Applicable Systems serialcfgparams tmcfgdelctrl=del tmcfgechoctrl=echo tmcfghandshakectrl=enab le connectionmode=terminal tmcfgnewlineseq=crlf msgcommflowctrl=rtscts tmcfginputnewlineseq=cr msgcommdtrhangup=disabl e msgcommbitrate=19200 tmcfglineediting=enable serialchannelaccess Table 42.
Option Sub-option Valid Arguments Description Applicable Systems istrator serialchannelaccess ipmioverserial=disab le channelprivlmt=admin istrator serialchannelinfo Table 43. serialchannelinfo options Option Sub-option Valid Arguments -serialchanneli nfo or sci Description Applicable Systems Displays media and protocol information about the serial channel. This option cannot be replicated. All PowerEdge systems --mediumtype NA Displays the medium type for the serial channel.
Option Sub-option Valid Arguments Description Applicable Systems User ID for the serial channel. This option can be replicated. --userid 2–16, if your system has a DRAC 5 controller --usrprivlmt user, Sets the maximum BMC user operator, privilege level for the serial administrato channel for the User ID r,noaccess specified using the userid sub-option. This sub-option can be replicated. This suboption is dependent on the userid sub-option. Sets the User ID. This suboption can be replicated.
solaction Table 45. solaction options Option Sub-option Valid Arguments solaction Description Applicable Systems This option enables or disables Serial-Over- LAN (SOL) access for a particular user. This option can be replicated. Example: A:>syscfg solaction --userid=2 -action=disable All PowerEdge systems solaction userid=2 action=disable --userid 2–16, if your system has a DRAC 5 controller Specifies the BMC user ID. This suboption can be replicated.
Option Sub-option Valid Arguments Description -solcharsendthres hold 1–255 Specifies that the BMC automatically sends an SOL character data packet containing this number of characters in increments of 5 (1–255) as soon as this number of characters (or greater) has been accepted from the baseboard serial controller into the BMC. This option can be replicated. Applicable Systems NOTE: On PowerEdge 9G and SC1435 systems, the maximum limit is 255.
Option Sub-option Valid Arguments Description Applicable Systems --solcharaccum interval=25 --solcharsend threshold=100 --solbitrate=9600 solcfgparams solenable=disable solprivlevel=administr ator solcharaccum interval=25 solcharsend threshold=100 solbitrate=9600 ssninfo Table 47.
Option Sub-option Valid Arguments Description --action enable, disable Enables or disables the user ID specified using the userid suboption. This sub-option can be replicated. This sub-option is dependent on the userid suboption. Example to disable User ID 3: A:>syscfg useraction -userid=3 -action=disable Applicable Systems useraction userid=3 action=disable username Table 49.
version* Table 50. version option Option Sub-option Valid Arguments Description --version* NA NA Displays the version information for the SYSCFG utility. Applicable Systems virutualmedia Table 51. virutualmedia option Option Sub-option Valid Arguments Description Applicable Systems -virutualmed ia NA enable, disable, auto Enables or disables the virtual media. This option cannot be replicated. All PowerEdge systems. Available on DRAC5 and all iDRAC versions.
Option Valid Arguments Description Example: A:>syscfg -b 1 The state byte has been set to 1. A:>syscfg -b 2 -x The state byte has been set to 0x02. -r or --read* NA NOTE: The asterisk is not part of the command syntax. Reads the value of state data. When used with the -x option, the value is reported in hexadecimal format (0xNN). Example: A:>sysfg -r -x The state byte has been set to 0x02. A:>syscfg -r The state byte has been set to 2.
Option Valid Arguments Description Example: A:>syscfg --asset asset=ASSET --biosver* None Reports the BIOS version for a system. If used with the -s option, the environment variable is set to the BIOS version. Example: A:>syscfg --biosver biosver=A08 --chassvctag* None Reports the chassis service tag on blade systems. Example: A:>syscfg --chassvctag chassvctag=SVCTAG1 --cpucount* None Reports the number of processors found on the system.
Option Valid Arguments Description -n Specifies an input file to use for resolving PCI vendor and device numbers to strings. The file must be present (with read rights) and contain a properly formatted list. For more information, see PCI Reporting . This option must be used with the pci option. Example: A:>syscfg -n pci.txt --pci PCI Bus: 2, Device: 4, Function: 0 Vendor: 8086 - Intel Corp. Device: 1229 - 82557/8/9 [Ethernet Pro 100] Sub Vendor:8086 - Intel Corp.
Option Valid Arguments Description Slot: 00 Class: 06 - Bridge SubClass: 00 - CPU/PCI None Example 2 (the pci.
Option Valid Arguments Description Example: A:>syscfg -s ENVNAME --svctag ENVNAME=SERVICE --slot* None Reports the slot on a Blade system. If it is not a Blade system, the slot is reported as 0. If used with the -s option, the environment variable is set to the slot. Example 1 (Blade systems) : A:>syscfg --slot slot=1 Example 2 (Rack and Tower systems) : A:>syscfg --slot slot=0 NOTE: This option is valid only for PowerEdge 1855 systems. --svctag* None Reports the service tag for a system.
Option Valid Arguments Description --uuid* None Reports the Unique User Identifier (UUID) for a system. The UUID is a unique system identifier used in PXE requests. Example: A:>syscfg --uuid uuid=44454C4C-5300-104C-8044- B1C04F423131 SYSCFG For IPv6 Configuration The following table lists all valid options and arguments for IPv6 configuration along with a description of each option. These options are applicable only if the DRAC on your system supports IPv6.
Option Sub-option --gatewayv6= Valid Arguments Description Allows you to view IP gatewayv6 address. PCI Reporting The scan of the PCI bus uses a file to resolve PCI vendor and device codes to vendor information strings. The format of the PCI output is as follows: PCI Bus: 2, Device: 4, Function: 0 Vendor: 8086 - Intel Corp. Device: 1229 - 82557/8/9 [Ethernet Pro 100] Sub Vendor:8086 - Intel Corp.
change the value of the MACHINE name in the Variable Names section, and change the corresponding section name.
RAIDCFG 4 This section documents the Deployment Toolkit (DTK) RAID configuration utility. The RAIDCFG utility provides a single command line tool that can configure all supported RAID controllers. Features The RAID configuration utility: • Displays help and usage information. • Reads configuration options from the Command Line Interface (CLI) parameters. • Enumerates RAID controllers, physical disks, and virtual disks. • Creates and deletes virtual disks. • Logs activity to a given filename.
RAIDCFG Options And Arguments Table below lists all of the valid options, parameters, and arguments for the RAIDCFG utility. For more information on valid RAIDCFG options and their specific uses, see RAID Configuration Utility Options and Arguments. Mandatory command line options must be present in the command. Optional command line options can be typed in any order after the mandatory options have been typed. Many options have both a short and long format.
Option Valid Arguments Short Description dphs Disables the controller Persistent Hot See Enabling and Spare feature for the selected Disabling Persistent controller. Dedicated Hot Spares for specific usage information. or disablepersistenthot spare ephs or enablepersistenthots pare fgnclr or foreignclear fgnrvr or foreignrecover fi or fastinit lghs or listglobalhotspare rghs or removeglobalhotspare rst Enables the controller Persistent Hot Spare feature for the selected controller.
Option Valid Arguments Short Description specific usage information. or setglobalhotspare sli or slowinit svdn or setvdname -ad or adisk Mandatory or Optional Initializes the virtual disk for the specified controller using the slowinit command. See Initializing Virtual Disks for specific usage information. Sets the name of the specified virtual See Assigning, Unassigning, And Listing disk on the specified controller. Global Hot Spares for specific usage information.
Option Valid Arguments Short Description Mandatory or Optional -fd or failoverdri ve ch:targ, ch:targ, ... or ch:targ:lun,... or ch:targ:enc channel:target, or channel:target:lun, or channel:target:enclo sure Specifies the location of the failover drive in an array. For SCSI controllers, the value of LUN should always be 0. For SAS controllers, the value of enclosure can be non-zero, in which case you must specify values for channel, target, and enclosure. Optional.
Option Valid Arguments Short Description Mandatory or Optional getfreeadisksize, and gethotspares. -si or silent NA Does not display any information on the terminal console. Optional. See Miscellaneous Options for specific usage information. -sp or spanlength The span size of RAID 5, which is a mandatory parameter for RAID 50. Mandatory. See Creating Virtual Disks for specific usage information. NOTE: Spanlength is applicable for RAID 10, RAID 50, and RAID 60.
Option Valid Arguments Short Description Mandatory or Optional through caching), wc (writecaching), nwc (no-write-caching), and fwb (force-write-back). RAID Configuration Utility Options And Arguments The following tables document valid options, parameters, and arguments along with a description of the expected behavior of each option. Options, parameters, and pre-defined arguments are case-sensitive and entered in lowercase, unless stated otherwise.
Option Parameters Valid Arguments Description Example: A:>raidcfg -h RAIDCFG v4.2 Copyright (c) 2002-2012 Dell Inc. [raidcfg] Help: options in <> are mandatory and options in [] are optional and can be in any order after mandatory ones. raidcfg -h Provides users with general help options that may beused with this utility. raidcfg raidcfg <-ctrl> Lists all controllers on the host and selects property information.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Controller_Name: PERC 6/E Channels: 2 No.of Virtual_Disks: 0 Firmware Version: 3500 RAIDCFG Command successful! -c or controllerid Displays the properties for the RAID controller with the specified controller ID. This option combination is mandatory.
Table 58. Creating Virtual Disks Mandatory Options and Arguments Optional Parameters -ctrl -ac=cvd - NA c=id -ad= ch:targ,ch:tar g, ... [or ch:targ:encl,. ..] or controller action= createvdisk controllerid= id adisk= channel:target : lun,... channel:target : lun,... [or channel:target : enclosure,...] -cp or cachepolicy Valid Parameters Arguments Description NA Creates a virtual disk comprising the properties supplied. This option combination is mandatory.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description For SAS controllers, the value of enclosure can be non-zero, in which case you must specify values for channel, target, and enclosure. -r or -raid 0, 1, 5, 6, 10, 50, 60 Sets the RAID type or level for the virtual disk. NOTE: If this option is not specified for any RAID controller, RAID 0 is taken as the default.
Mandatory Options and Arguments Optional Parameters -ctrl -ac=cvd - -rp or c=id -ad= readpolicy ch:targ,ch:tar g, ... [or ch:targ:encl,. ..] or controller action= createvdisk controllerid= id adisk= channel:target : lun, channel:target : lun,... [or channel:target : enclosure,...] Valid Parameters Arguments Description ra, ara, nra, rc, nrc CAUTION: If the controller is changed from SCSI to RAID mode, expect data loss to occur. Back up any data you want to save before changing the modes.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments [or channel:target : enclosure,...] Description For SCSI controllers, the value of LUN should always be 0. For SAS controllers, the value of enclosure can be non-zero, in which case you must specify values for channel, target, and enclosure. Sets the stripe size for the virtual disk. The stripe size is the amount of array disk space used on each array disk included in the stripe.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments : lun,... channel:target : lun,... [or channel:target : enclosure,...
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description • • wc — Write-Caching sets the controller to send a write-request completion signal only after the data is written to the disk. nwc — No-Write-Caching specifies that the controller does not send a write-request completion signal after the data is written to the disk. NOTE: The -wpoption is optional and can be added to the command line in any order after the mandatory option combination.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description NegSpeed: 6144 Mbps CapSpeed: 6144 Mbps Certified: YES Supported: YES Location: 0:0:1 Size: 139392 MB (136 GB) Avail: 0 MB ****** Physical Drive ****** Vendor: DELL(tm) Model: ST9146703SS Protocol: SAS Media: HDD NegSpeed: 6144 Mbps CapSpeed: 6144 Mbps Certified: YES Supported: YES Location: 0:1:1 Size: 139392 MB (136 GB) Avail: 0 MB ****** Physical Drive ****** Vendor: DELL(tm) Model: ST9146703SS Protocol: SAS Med
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Media: HDD NegSpeed: 3072 Mbps CapSpeed: 3072 Mbps Certified: YES Supported: YES Location: 0:4:1 Size: 139392 MB (136 GB) Avail: 139392 MB (136 GB) RAIDCFG Command successful! Lists the array disks that make up the virtual disk on the specified RAID controller. This option combination is mandatory.
Blinking And Unblinking Array Disks The following table lists the RAIDCFG options, parameters, and pre-defined arguments for blinking and unblinking array disks (hard drives). NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk. Table 60. Blinking And Unblinking Array Disks Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description -ad -ad= ch:targ,ch:tar g ,... ac=blink c=id or adisk adisk= channel:target , channel:target ,...
Table 61. Enumerating Virtual Disks Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description —vd or vdisk NA NA Lists all the virtual disks for each controller along with the array disks that make up each virtual disk. This option is mandatory.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Cache Policy: Direct_IO Drives: 0:0:0,0:1:0 Dedicated HS: 1:2:0 RAIDCFG Command successful! Deleting Virtual Disks The following table lists the RAIDCFG options, parameters, and pre-defined arguments for deleting virtual disks. Table 62.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments setbootflag controllerid= id Description Example: A:>raidcfg -vd -ac=sbf -c=2 vd=0 RAIDCFG Command successful! Blinking And Unblinking Virtual Disks The following table lists the RAIDCFG options, parameters, and pre-defined arguments for blinking or unblinking a physical disk associated with a virtual disk. Table 64.
Setting Environment Variables The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting the CLI environment. Table 65. Setting Environment Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description -se envn= -envc= or setenvironment envname= envcommand= NA NA Sets a user-defined environment variable to the value returned from the getcontrollerslots function call.
Function Call Description Example: A:>raidcfg -se -envn=FIRMWARE -envc= getfirmware -c=2 FIRMWARE=531T RAIDCFG Command successful! getcontrollertype Returns LSI for LSI controllers and ADAP for Adaptec controllers. Example: A:>raidcfg -se -envn=CONTROLLERTYPE -envc= getcontrollertype -c=2 CONTROLLERTYPE=LSI RAIDCFG Command successful! getadisks Returns the array disks attached to the controller.
Function Call Description getfreeadisks Returns the free array disks. A:>raidcfg -se -envn=GETFREEADISKS -envc= getfreeadisks -c=2 GETFREEADISKS=0:3:1,0:4:1 RAIDCFG Command successful! Returns the total number of array disks. A:>raidcfg -se -envn=GETADISKCOUNT -envc= getadiskcount -c=2 getadiskcount GETADISKCOUNT=1 RAIDCFG Command successful! RAID Replication Options The following table lists the RAID replication options. Table 67.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description stripesize=64 cachepolicy=d adisk=0:3:1,0:4:1 NOTE: If the controller uses global hot spares, the raid.ini file contains the following section: [GlobalHotspare0] controllerid=0 failoverdrive=0:8:0 Assigning, Unassigning, And Listing Global Hot Spares The following table lists the RAIDCFG options, parameters, and pre-defined arguments for assigning and unassigning global hot spares. Table 68.
Importing And Clearing Foreign Configurations The following table lists the RAIDCFG options, parameters, and pre-defined arguments for foreign configurations. Table 69. RAIDCFG Options for Foreign Configurations Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description -ctrl -c=id ac=fgnimp NA NA Imports the foreign configuration detected in the selected controller. This feature is supported on PERC 5 and later controllers and is not supported on SAS controllers.
Table 70. Initializing Virtual Disks Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description -vd -c=id vd=id -ac=fi or vdisk controllerid=i d vdisk=id action=fastini t NA NA Initializes the selected virtual disk in the selected controller with the fastinit command. This feature is supported on PERC 5 and later controllers and is not supported on SAS controllers. Using the fastinit command on unsupported controllers returns an error.
Table 72. Enabling And Disabling Persistent Dedicated Hot Spares Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description --ctrl -c=id ac=ephs or controller controllerid=i d action=enablep eristenthotspa re NA NA Assigns the slot corresponding to the hot spare drive as persistent. Any drive in the slot functions as a hot spare if the drive is qualified to be a hot spare.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description order after any mandatory options have been added. Example: A:>raidcfg -ctrl -si -ver or version Displays the version number of the RAIDCFG utility. This option is optional and can be added to the command line in any order after any mandatory options have been added. Example: A:>raidcfg -ver NA RAIDCFG V4.2 Copyright (c) 2002-2012 Dell Inc.
Purpose Command Description x:y,x:y,x:y,... sz=5GB -r=5 To create a virtual disk of a certain size and make it RAID 1 with a hot spare raidcfg -ctrl ac=cvd -c=slotid ad= x:y,x:y sz=5GB -r=1 fd=x:y Creates a virtual disk of 5 GB size for type RAID 1. The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands. The option <-fd> stands for failover drive and requires the drive location of the drive you want the dedicated hot spare to be in.
UPINIT 5 The UPINIT utility allows to create a utility partition (UP) on a hard drive, format the partition, and extract the partition contents onto the disk. Features The UPINIT utility: • Displays help and usage information. • Returns specific error codes and messages. NOTE: In Microsoft Windows Preinstallation Environment (Windows PE), you can find the UPINIT utility in \DELL \TOOLKIT\TEMPLATES\SCRIPTS.
UPINIT Options And Arguments Table below lists the valid options and arguments for the UPINIT utility. Table 74. UPINIT Options and Arguments Option Valid Arguments Description none none If no options are given, the tool outputs usage information. The usage information is printed in the format shown below. Example 1: A:>upinit upinit version 1.0 © 2012 Dell Inc. All rights reserved upinit.sh --disk|-d=disk --size|-s= size --file|-f=file [--overwrite|-o] [--help|-h] --help or -h prints help.
Option Valid Arguments Description Usage: upinit.bat [--overwrite] --disk=ID or -d=ID --size=size or -s=size --file=file or -f=file --help or -h prints usage. --disk or -d ID of the disk on which to create the Dell Utility Partition. --size or -s Size in MB for the Dell Utility Partition. --file or -f Filename of the Dell Utility Partition Image File. --overwrite or -o Overwrites an existing Dell Utility Partition. Example: upinit --disk=0 --size=32 --file= upimg.
Option Valid Arguments Description option because the --overwrite option does not resize an existing Dell Utility Partition. If any partitions exist, they are not deleted. disk integer, required (Windows) string, required (Linux) Specifies the disk on which to create a utility partition. This disk is checked to ensure that there are no existing partitions. Utility exits with an error if the disk has partitions other than a utility partition.
Messages And Codes 6 This section documents the error messages and codes used in Dell OpenManage Deployment Toolkit (DTK). SYSCFG Error Codes And Messages The SYSCFG utility checks your commands for correct syntax and valid input. When you enter a command, a message is displayed stating the results of the command. Failure Messages The SYSCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. The following table lists SYSCFG error codes and messages. Table 75.
Error Code Message 16 Cannot execute command. Insufficient privilege level. 17 Command illegal for specified sensor or record type. 18 Invalid commstring value. 19 Hardware subsystem error. Invalid data field in Request. 20 Invalid destination IP address. 21 The GUID is invalid. 22 Invalid gateway. 23 Invalid hostname. 24 Invalid IP address. 25 Invalid DNS IP address. 26 Invalid sub net mask. 27 Invalid value for PEF. PEF value should be between 1 and 16.
Error Code Message 46 Command response could not be provided. BMC initialization or initialization agent in progress. 47 Command response could not be provided. Device in firmware update mode. 48 Command response could not be provided. SDR Repository in update mode. 49 Cannot execute command, SEL erase in progress. 50 Attempt to set the 'set in progress' value when not in the 'set in complete' state. 51 The SOL character ’accumulate interval’ is invalid.
Error Code Message 73 The sequence list must be a comma-separated numerical list of valid unique boot device numbers (ex: 2, 1, 3). 74 The sequence list must be a comma-separated list of valid unique device names (ex: nic.emb.1, hdd.emb.1) or a commaseparated numerical list of valid unique boot device numbers (ex: 2, 1, 3). 75 There was an error setting the sequence. 76 The list is not formatted correctly. See the help for more details.
Error Code Message 100 Help is not available for the option ’%s’. 101 The -x (--hex) option can only be used with -b or -r. 102 Input file '%s' not found. 103 Input file '%s' cannot be read. 104 Invalid argument for option '%s'. 105 Function table lookup error. 106 The machine ID was not found in the file '%s'. 107 The system memory information is not available. 108 Mode can only be used with the --pci option. 109 The device name or index must be present in the boot order.
Error Code Message 128 The second channel can only be set if the RAID controller is set to RAID. 129 The set operation, '%s', requires sub commands. 130 The service tag for this system is not available. 131 The system ID value is not available. 132 The system information string is not available. 133 A system error has occurred. 134 Usage error. 135 The uuid information is not present on this system 136 Version cannot be accompanied with any other option.
Error Code Message 155 Profile should be custom for setting cpupowermode, memorypowermode and fanmode. 156 There was an error setting the Power Option. 157 The power cap value entered is out of range. Please try again. 158 The power cap value entered must be between 0 to 100 if unit is percent. 159 Invalid IPv6 address. The IPv6 address cannot be link-local or multicast. 160 Invalid IPv6 address. The IPv6 address specified has incorrect address format. 161 Invalid IPv6 address.
Error Code Message 178 Invalid configuration. Attempting to set cap when hardware does not support setting. 179 Invalid Configuration Option. 180 Cannot execute command. Parameter is illegal because command sub-function has been disabled or is unavailable. 181 Failed to report the removable flash media redundancy status. 182 Failed to report the Internal SD Module status. 183 Error locating the Virtual Media Key on the Modular system.
Failures And Solutions The following table lists the common SYSCFG failures and their solution. Table 76. SYSCFG Failures and Solutions Failure Messages Solutions Generic failure. Indicates iDRAC is in bad state. Reboot iDRAC. New value not valid. Make sure the changed value is valid. Cannot disable this orderedList’s entries. BIOS does not support enabling or disabling of a particular boot order object. System busy, try again later. Retry as iDRAC is busy with internal processing.
Error Code Message 10 Error: Invalid size. Size should be a number between 32 and 2000. 11 Error: sysdrmk failed. 12 System Error. 13 Error: Invalid Argument: 14 Error: Unzip failed. UPINIT Linux-Specific Error Codes And Messages The list of error codes and messages are specific to the Linux environment. Table 78. UPINIT Linux-Specific Error Codes and Messages Error Code Message 31 Error: Invalid disk specified. 32 Error: Mount failed.
Error Code Message 2 Failure! 3 Illegal operation 4 Unsupported operation 5 Device not found. 6 Format boot drive illegal 7 Buffer too small. 8 Virtual Disk contains boot partition. Use force option to delete. 9 Init boot drive failed. 10 Format boot drive failed. 11 Cannot write boot drive. 12 Unsupported RAID value. 13 Invalid RAID configuration. 14 Span depth not in range. 15 RAID 1 failed. 16 Exactly 2 array disks are required to create a RAID 1 virtual disk.
Error Code Message 33 Disk Unlock operation failed. 34 Disk Unlocked. 35 Disk failed on rebuild. 36 Hot Spare not free. 37 Disk Diagnostic failed. 38 Disk Rebuild failed. 39 Disk Format failed. 40 Cancel of Disk Diagnostic failed. 41 Cancel of Disk Rebuild failed. 42 Cancel of Disk Format failed 43 Assign Hot Spare failed 44 Disk too Small for Hot Spare. 45 Unassign Hot Spare failed. 46 Prepare Disk for Removal failed. 47 Disk Online failed. 48 Disk Offline failed.
Error Code Message 63 The controller cannot support the number of array disks that you have selected. Choose a smaller number. 64 Delete virtual disk failed. Controller busy. 65 Delete virtual disk failed. 66 Create virtual disk failed. 67 Create virtual disk failed. Controller busy. 68 Create virtual disk failed. Failed to map virtual disk to operating system disk. 69 Create virtual disk failed. Failed to map virtual disk to operating system disk. 70 Virtual disk initialization failed.
Error Code Message 90 Virtual disk resynching. 91 Virtual disk resynch failed. 92 Virtual disk reconstruct failed. 93 Cannot format a virtual disk that contains a boot or system partition. 94 Cannot initialize a virtual disk that contains a boot or system partition. 95 Virtual disk Copy failed. 96 Virtual disk mirror set required. 97 Virtual disk Create - Read-only failed. 98 Virtual disk Create - Read-write failed. 99 Virtual disk - Clear-to-zero failed.
Error Code Message 118 Cannot reconfigure from current RAID level to the given RAID level. 119 One of the array disks selected for the virtual disk is already in use. 120 Virtual disk operation not supported. Cannot use non-RAID disk. 121 Controller Read Configuration failed. 122 Controller Write Configuration failed. 123 Controller cache flush failed. 124 Enable alarm on controller failed. 125 Disable alarm on controller failed. 126 Quiet alarm on controller failed.
Error Code Message 146 The controller could not lock the specified virtual disk. 147 Controller IO paused. 148 No controller parameter support. 149 Controller does not recognize parameter symbol. 150 Controller Battery Recondition failed. 151 Controller Get disk signature failed. 152 Controller Read Flags failed. 153 Controller Set Flags failed. 154 Controller Remove Snap Shot failed. 155 Controller not supported. 156 Controller device initialization failure.
Error Code Message 176 Invalid array disks or failover drives selected for reconfigure/create operation. Please make sure that all array disks and failover drives associated with the virtual disk are selected. 177 The maximum number of partitions have already been created on one of the selected array disk(s). Each array disk can hold portions (partitions) of up to 10 virtual disks. This virtual disk cannot be created because one or more array disk(s) have reached the partition limit.
Error Code Message 194 Quiet alarm command failed. The enclosure processor is busy or a firmware download is in progress. 195 An error occurred while resetting a temperature probe. 200 No array disks found! 201 Invalid Virtual Disk ID! 202 RAID Type & Size are required to create a virtual disk. Ensure that the RAID type and the size are correct.
Error Code Message 220 The number of array disks provided is incorrect for the requested RAID Type! RAID 1 requires exactly 2 array disks, RAID 5 requires at least 3 array disks, RAID 10 requires at least 4 array disks and RAID 50 requires at least 6 array disks. 221 Input file cannot be read. 222 Input file not found. 223 Error in opening the file. RACADM Firmware Error Codes And Messages Table below lists RACADM firmware error codes and messages. Table 81.
Error Code Message 22 PCI ERROR 23 SERVER IS IN GRAPHICS MODE 24 SYSTEM DATE AND TIME NOT SET 25 OUT OF MEMORY 26 ACCESS LOCKED 27 PAGING ERROR 28 PAGING ALREADY IN PROGRESS 29 ERROR ACCESSING DEVICE 30 WRONG NUMBER OF ARGUMENTS 31 NO SCREEN FOR ASR STORED 32 CAN'T ADD HISTORY MONITOR 33 INVALID IDENTIFIER 34 CANNOT WRITE TO FLASH 35 FIRMWARE FILE INVALID 36 CANNOT READ REGISTER 37 CANNOT UNLOCK RESOURCE 38 TIME OUT 39 SERVER IN TEXT MODE 40 WRONG GRAPHICS MODE 41 CO
RACADM Utility Error Codes And Messages Table below lists RACADM utility error codes and messages. Table 82. RACADM Error Codes and Messages Error Code Message 513 An unknown failure occurred. 514 Librac library not initialized. 515 An invalid parameter was passed into function. 516 Invalid DRSTYPE specified. 517 Librac library already initialized. 518 Invalid transport type specified. 519 Invalid library user. 520 A connection to the RAC controller could not be established.
Error Code Message 542 Failed to create socket. 543 Socket read operation failed. 544 Socket write operation failed. 545 Failed to create SSL context object. 546 Failed to create SSL BIO object. 547 Unable to create SSL socket connection. 548 Failed to initialize socket. 549 Failed to login to RAC successfully. 550 Invalid session ID specified. 551 Failed to logout from RAC successfully. 552 Command execution failed. 553 FTP Get operation failed. 554 FTP Put operation failed.
BMC Platform Events Filter Alert Messages 7 All possible Platform Event Filter (PEF) Alert Messages along with a description of each event are listed in the table below Table 83. BMC PEF Alert Events Event Description Fan Probe Failure The fan is running too slow or not at all. Voltage Probe Failure The voltage is too low for proper operation. Discrete Voltage Probe Failure The voltage is too low for proper operation.
Event Description Automatic System Recovery The system is hung or is not responding and is taking an action configured by Automatic System Recovery. System Power Probe Warning The system is setting actions when a power consumption probe detects a warning value. System Power Probe Failure The system is setting actions when a power consumption probe detects a failure value.
Sample File Formats 8 This appendix lists the sample SYSCFG utility .ini, RAIDCFG utility .ini, and the RACADM utility .ini files. Sample SYSCFG Utility .ini File Format [syscfg] ;SystemModelName=poweredge r620 ;SystemBiosVersion=0.3.16 ;SystemServiceTag=MDN2345 ;SystemManufacturer=dell inc. ;SysMfrContactInfo=www.dell.com ;SysMemSize=4.0 gb ;SysMemType=ecc ddr3 ;SysMemSpeed=1067 mhz ;SysMemVolt=1.
IoatEngine=disable ;EmbVideo=enable SriovGlobalEnable=disable SerialComm=onnoconredir SerialPortAddress=serial1com1serial2com2 ExtSerialConnector=serial1 FailSafeBaud=115200 ConTermType=vt100vt220 RedirAfterBoot=enable SysProfile=perfperwattoptimizeddapc ;ProcPwrPerf=sysdbpm ;MemFrequency=maxperf ;ProcTurboMode=enable ;ProcC1E=enable ;ProcCStates=enable ;MemPatrolScrub=standard ;MemRefreshRate=1x ;MemVolt=autovolt ;AesNi=enable PasswordStatus=unlocked TpmSecurity=off ;TpmActivation=nochange ;TpmClear=no ;In
autoneg=enable dnsserver1=0.0.0.0 dnsserver2=0.0.0.0 dnsdhcp=disable dnsracname=idrac dnsregisterrac=disable domainname= domainnamednsdhcp=disable fullduplex=enable speed=100Mbps ;subnetmask=255.255.255.
userid=13 usrprivlmt=noaccess lanuseraccess userid=14 usrprivlmt=noaccess lanuseraccess userid=15 usrprivlmt=noaccess lanuseraccess userid=16 usrprivlmt=noaccess lcd=servicetag nmibutton=enable pefcfgparams alertpolnum=1 alertpolstatus=disable pefcfgparams alertpolnum=2 alertpolstatus=disable pefcfgparams alertpolnum=3 alertpolstatus=disable pefcfgparams alertpolnum=4 alertpolstatus=disable pefcfgparams filter=fanfail filteralert=enable filteraction=none pefcfgparams filter=discretevoltfail filteralert=enab
filteraction=none pefcfgparams filter=powerfail filteralert=enable filteraction=none pefcfgparams filter=hardwarelogfail filteralert=enable pefcfgparams filter=autorecovery filteralert=enable pefcfgparams filter=procabsent filteralert=enable filteraction=none pefcfgparams filter=powerabsent filteralert=enable filteraction=none pefcfgparams filter=batterywarn filteralert=enable filteraction=none pefcfgparams filter=batteryfail filteralert=enable filteraction=none pefcfgparams filter=systempowerwarn filterale
msgcommflowctrl=noflowctrl tmcfgdelctrl=del tmcfgechoctrl=echo tmcfghandshakectrl=enable tmcfginputnewlineseq=cr tmcfglineediting=enable tmcfgnewlineseq=crlf serialchannelaccess ipmioverserial=alwaysavail channelprivlmt=administrator serialuseraccess userid=2 usrprivlmt=administrator serialuseraccess userid=3 usrprivlmt=noaccess serialuseraccess userid=4 usrprivlmt=noaccess serialuseraccess userid=5 usrprivlmt=noaccess serialuseraccess userid=6 usrprivlmt=noaccess serialuseraccess userid=7 usrprivlmt=noacce
solaction userid=5 action=disable solaction userid=6 action=disable solaction userid=7 action=disable solaction userid=8 action=disable solaction userid=9 action=disable solaction userid=10 action=disable solaction userid=11 action=disable solaction userid=12 action=disable solaction userid=13 action=disable solaction userid=14 action=disable solaction userid=15 action=disable solaction userid=16 action=disable solcfgparams solbitrate=115200 solcharaccuminterval=10 solcharsendthreshold=255 solenable=enable
action=disable useraction userid=9 action=disable useraction userid=10 action=disable useraction userid=11 action=disable useraction userid=12 action=disable useraction userid=13 action=disable useraction userid=14 action=disable useraction userid=15 action=disable useraction userid=16 action=disable username userid=2 name=root username userid=3 name=NULL username userid=4 name=NULL username userid=5 name=NULL username userid=6 name=NULL username userid=7 name=NULL username userid=8 name=NULL username useri
username userid=15 name=NULL username userid=16 name=NULL ;uuid=44454C4C4400104E8032CDC04F333435 virtualmedia=auto Sample RAIDCFG Utility .
Dell PowerEdge servers. #idRacVersionInfo=1.20 (Build 01.17) idRacName=DRAC 5 idRacMisc= [cfgLanNetworking] cfgNicEnable=1 cfgNicIpAddress=10.98.8.121 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.0.1 cfgNicUseDhcp=0 #cfgNicMacAddress=00:11:43:34:5f:4a cfgDNSServersFromDHCP=0 cfgDNSServer1=192.168.0.5 cfgDNSServer2=192.168.0.6 cfgDNSRegisterRac=0 cfgDNSRacName=RAC-HHS7C1S cfgDNSDomainNameFromDHCP=0 cfgDNSDomainName=MYDOMAIN [cfgCurrentLanNetworking] #cfgNicCurrentIpAddress=10.98.8.
cfgNetTuningIpSubnetsAreLocal=0x1 cfgNetTuningIpReassTtl=0x3c cfgNetTuningTcpMsl=0x3c cfgNetTuningNicAutoneg=1 cfgNetTuningNic100MB=1 cfgNetTuningNicFullDuplex=1 [cfgOobSnmp] cfgOobSnmpTrapsEnable=1 cfgOobSnmpAgentEnable=1 cfgOobSnmpAgentCommunity=public [cfgRacTuning] cfgRacTuneFwUpdateResetDelay=0x46 cfgRacTuneD3debugEnable=1 cfgRacTuneRemoteRacadmEnable=1 cfgRacTuneHostCom2BaudRate=57600 cfgRacTuneHttpPort=0x50 cfgRacTuneHttpsPort=0x1bb cfgRacTuneTelnetPort=0x17 cfgRacTuneConRedirPort=0x170c [ifcRacManag