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. © 2013 Dell Inc.
Contents 1 Introduction..................................................................................................................................7 What's New In This Release.................................................................................................................................... 7 Supported Systems...................................................................................................................................................8 Supported Operating Systems...
-l or --logfile......................................................................................................................................................22 -o or --outfile.................................................................................................................................................... 22 --ox or --outxmlfile............................................................................................................................................
ssninfo.............................................................................................................................................................. 98 useraction........................................................................................................................................................ 98 username..........................................................................................................................................................99 version*....
UPINIT Dependencies.......................................................................................................................................... 141 UPINIT Options And Arguments........................................................................................................................... 142 6 Messages And Codes.............................................................................................................145 SYSCFG Error Codes And 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.
Supported Systems For a complete list of supported Dell PowerEdge systems, see the Dell Systems Software Support Matrix in the required version of OpenManage Software at dell.com/openmanagemanuals Supported Operating Systems For Windows, the DTK utilities support Windows PE 3.0 (32-bit and 64-bit) and Windows PE 4.0 (64–bit).
RAID Configuration Utility The RAIDCFG utility reports and sets RAID configuration options. RAC Configuration Utility The RACADM utility reports and sets RAC configuration options for Dell Remote Access Controller DRAC 5, iDRAC6, and iDRAC7. Disk Partitioning Utility The UPINIT script creates, formats, and populates a Dell Utility Partition. Replication Of DTK Utilities This section explains the replication of DTK utilities. File Format The -i and -o options use the .
• SYSCFG logs a message in the log file for each option processed in the syscfg.ini file. To generate the log file, use the logfile option. RAID Replication The RAID replication feature reads the RAID configuration information from the source system and creates a raid.ini file. This raid.ini file can be applied to the RAID configurations of the target system. The RAID replication requires both, the source system and the target system to have similar RAID controllers. RACADM Replication The RACREP.
• The Deployment Toolkit release notes (for Windows PE and embedded Linux) which is also available as part of the DTK download, provides the latest available information about the installation and operation of the DTK components and the list of PowerEdge systems supported for this version of DTK. Accessing Documents From Dell Support Site To access the documents from Dell Support site: 1. Go to dell.com/support/manuals. 2.
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.3 P01(Windows - Apr 29 2013,16:48:48) Copyright (c) 2002-2013 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 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.
Description Configures or reports the I/O address of the LPT (parallel) port. This option is available on all supported systems with an LPT port. This option is recorded to an output file for replication. Example: A:>syscfg --lpt=lpt1 lpt=lpt1 Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. -memdynamicpower Option --memdynamicpower Valid Arguments enable, disable Description Enables or disables the dynamic memory power states. This option can be replicated.
--memprefailurenotify Option --memprefailurenotify Valid Arguments enable, disable Description Enables or disables the Correctable ECC SMIs. When enabled, the SMIs report the Correctable ECC errors. This option can be replicated. Example: A:>syscfg --memprefailurenotify=enable memprefailurenotify=enable Applicable Systems PowerEdge R710, R610, and T610 systems with Intel Xeon processor --memremap Option --memremap Valid Arguments off, auto Description Sets the memory remapping to off or auto.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --nextboot Option --nextboot Valid Arguments (from the bootseq option device list) Description Sets the specified device as the first device in the boot order for the next boot cycle only. The device must be a device from the bootseq option device list. Run the bootseq option to see a list of available device names. For more information, see --bootmode . This option is not replicated.
--numlock Option --numlock Valid Arguments on, off Description Turns the keyboard number lock on or off during POST. This option is not replicated. Example: A:>syscfg --numlock=on numlock=on Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --oldsetuppwd Option --oldsetuppwd Valid Arguments Description Allows to set a new setup password if a setup password is already present on the system. The setup password locks the BIOS setup screen.
Example 2: A:>syscfg --syspwd=asyspassword -oldsyspwd=currentpassword The old password entered is incorrect. The new password will not be set. Please try again. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --opticaldrivectrl Option --opticaldrivectrl Valid Arguments enable, disable Description Enables or disables the optical CD-ROM controller.
power Option power Valid Arguments NA Description For details about the power suboptions and arguments, see Sub Options For Power Option. Applicable Systems PowerEdge 11G systems --powerbutton Option --powerbutton Valid Arguments enable, disable Description Enables or disables the power button for a system. This option is recorded to an output file for replication.
--remflashmedia Option --remflashmedia Valid Arguments read-only Description Displays the redundancy status of internal dual SD module. The status can be: • • Full — Secure digital card (SD) 1 and 2 are functioning properly. Lost — Either any of the secure digital cards or both are not functioning properly. The option also displays the status of the individual SD cards as follows: • • • • • • Active — The card is used for secure digital reads.
Example: A:>syscfg --sata0=auto sata0=auto NOTE: This option maps to --sata_a for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --sata1 Option --sata1 Valid Arguments auto, off Description Turns the SATA port 1 to auto or off. This option can be replicated. Example: A:>syscfg --sata1=auto sata1=auto NOTE: This option maps to --sata_b for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--sata4 Option --sata4 Valid Arguments auto, off Description Turns the SATA port 4 to auto or off. This option can be replicated. Example: A:>syscfg --sata4=auto sata4=auto NOTE: This option maps to --sata_e for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --sata5 Option --sata5 Valid Arguments auto, off Description Turns the SATA port 5 to auto or off. This option can be replicated.
Example: A:>syscfg --sata7=auto sata7=auto NOTE: This option maps to --sata_h for PowerEdge 9G systems. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --snoopfilter Option --snoopfilter Valid Arguments enable, disable Description Enables or disables the snoop filter option from the system BIOS. Example: A:>syscfg --snoopfilter=enable snoopfilter=enable Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems.
--serialcomm Option --serialcomm Valid Arguments on, com1cr, com2cr, off Description Sets the behavior of the serial port communication. When set to on, the BIOS enables COM port 1 and COM port 2. These ports are made available for use by the operating system or applications. BIOS Console Redirection is disabled. When set to com1cr , BIOS enables COM port 1 and COM port 2. These ports are made available for use by the operating system or applications. BIOS Console Redirection is through COM port 1.
length. If a current setup password is set, it must be given through the oldsetuppwd option. This option is not replicated. For more information on delimiters, see Command Line Option Delimiters . Example: A:>syscfg --setuppwd=asetuppassword The password has been set. Please use a warm reboot to apply the password to the system. Example 2: A:>syscfg --setuppwd=asetuppassword -oldsetuppwd=currentpassword The password has been set. Please use a warm reboot to apply the password to the system.
--sriov Option --sriov Valid Arguments enable, disable Description Enables or disables support for Single Root I/O Virtualization (SR-IOV) devices. Example: A:>syscfg --sriov=disable sriov=disable Applicable Systems PowerEdge R410, R510, R610, R710, R910, T410, T610, and T710 systems prior to PowerEdge12G systems with Intel Xeon processor 7500/6500 series. --svctag* --svctag* Option NOTE: The asterisk is not part of the command syntax.
Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --sysrev Option --sysrev Valid Arguments NA Description Reports the system revision. This is a read-only option. Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. tpm Option tpm Valid Arguments NA Description For details about the tpm suboptions and arguments, see Sub Options For tpm Option.
--usbflash Option --usbflash Valid Arguments auto, fdd, hdd Description Sets or reports the emulation for a USB flash device. The USB flash device can be set to emulate a hard drive (HDD) or a diskette drive (FDD). This option can be replicated. Example: A:>syscfg --usbflash=auto usbflash=auto Applicable Systems All PowerEdge systems prior to PowerEdge 12G systems. --usbports Option --usbports Valid Arguments enable, enablebackonly, disable Description Enables or disables USB ports.
Enables or disables vflash on iDRAC. Example: A:>syscfg --vflash=enable Description vflash=enable Applicable Systems All PowerEdge 11G systems or systems with iDRAC6 Sub Options And Arguments For tpm Option The following table lists the sub-options and arguments for the tpm option. Table 6. Sub-options and Arguments for the tpm Option Option Sub-option Arguments Description tpm --tpmsecurity off Does not report the presence of TPM to the operating system.
Option Sub-option Arguments Description --tpmclear NA Clears the contents of the TPM chip without erasing the tpmsecurity and tpmactivation settings. Example: A:>syscfg tpm -tpmactivation=enabled --tpmclear --setuppwdoverride --undotpmclear NA Cancels the result of the tpmclear setting. If you specify this setting before specifying the tpmclear setting, the There is currently no pending TPM Clear request message is displayed.
Option Sub-option Arguments Description nochange Does not alter the operational state of the TCM feature. Example: A:>syscfg tcm -tcmactivation=enabled --tcmclear NA Clears the contents of the TCM chip without erasing the tcmsecurity and tcmactivation settings. Example: A:>syscfg tcm -tcmactivation=enabled --tcmclear --setuppwdoverride --tcmundoclear NA Cancels the result of the tcmclear setting.
Option Sub-option Arguments Description power mode, 978 Mhz, 800 Mhz, 1067 Mhz, or 1333 Mhz. A:>syscfg power --profile=custom --memorypowermode=min -setuppwdoverride --fanpowermode min, max Allows you to set the fan algorithm to the minimum power optimized or maximum performance optimized mode. A:>syscfg power --profile=custom --fanpowermode=min -setuppwdoverride NOTE: Set the value of profile to custom to change the values of cpupowermode , memorypowermode , and fanpowermode.
Option Sub-option Arguments Description -setuppwdoverri de NA Does not prompt you for a password to access the DTK settings on systems that do not have a setup password configured. A:>syscfg power --profile= maxperformance –setuppwdoverride SYSCFG Options On PowerEdge 12G Systems The following table lists the valid SYSCFG options and arguments supported on the PowerEdge 12G systems. On PowerEdge 12G systems, the SYSCFG options are grouped. The options and arguments are case insensitive.
Group Option Valid Arguments Description 30-second time-out if the last boot attempt has failed. Embedded Server Management Table 11. Embedded Server Management Options Group Option Valid Arguments Description Embedded Server Management --FrontLcd None, UserDefined, ModelNum, Advanced Allows you to set the model number or a user-defined string on the front-panel LCD display.
Group Option Valid Arguments Description NOTE: If set to DisabledOs, the Integrated NICs may still be available for shared network access by the embedded management controller. This function must be configured through the NIC management utilities provided with your system. --IntegratedRaid Enabled, Disabled Enables or disables the integrated RAID controller. --IntegratedSas Enabled, Disabled Enables or disables the integrated SAS controller.
Group Option Valid Arguments Description NOTE: This option is supported on PowerEdge R410, R510, R610, R710, R910, T410, T610, T710, and PowerEdge 12G systems with Intel Xeon processor 7500/6500 series. --UsbPorts AllOn, OnlyBackPortsOn , AllOff Sets the user accessible USB Ports. Selecting OnlyBackPortsOn disables front USB ports, and selecting AllOff disables both front and back USB ports. Memory Settings Table 13.
Group Option Valid Arguments Description capability and the installed DIMM population. This option also enables setting the system DIMM voltage to a higher (1.5V) setting if the DIMMs support multiple voltages and have been set to a lower voltage. NOTE: Volt15V represents 1.5 Volt. --MemTest Enabled, Disabled Enables or disables the POST extended memory test. --MonitorMwait Enabled, Disabled Enables or disables Monitor/Mwait instructions.
Group Option Valid Arguments Description NOTE: The Asset Tag is a string assigned to a system, usually by an administrator, for security or tracking purposes. The Asset Tag can be up to 10 characters long and can contain only printable US-ASCII characters. --ErrPrompt Enabled, Disabled Enables (default value) or disables the F1/F2 prompt on error. -InSystemCharac terization Enabled, Disabled Enables or disables In-System characterization.
Group Option Valid Arguments Description Boot Mode to UEFI when attempting a onetime boot to the device. Processor Settings Table 16. Processor Settings Options Group Option Valid Arguments Description Processo r Settings --DataReuse Enabled, Disabled Enables (default value) or disables data reuse in cache. --DcuIpPrefetcher Enabled, Disabled Enables (default value) or disables DCU IP Prefetcher.
Group 70 Option Valid Arguments Description --Proc3L2Cache Displays the amount of memory in the corresponding processor cache. --Proc3L3Cache Displays the amount of memory in the corresponding processor cache. --Proc3NumCores Displays the number of cores in the processor package. --Proc4Brand Displays the brand text provided by the processor manufacturer. --Proc4Id Displays the family, model, and stepping values of the processor.
Group Option Valid Arguments Description --RtidSetting Enabled, Disabled When set to Enabled, it allocates more (Requestor Transaction IDs) RTIDs to the remote socket thereby increasing cache performance between the sockets. 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.
Group Option Valid Arguments Description --SataPortC Off, Auto Sets the drive type of the selected device to off or auto. - SataPortCCapacit y Displays the total capacity of a hard-disk drive. This option is undefined for removable-media devices such as optical drives. - SataPortCDriveTy pe Indicates the type of device attached to this SATA port. --SataPortCModel Displays the drive model of the selected device.
Group Option Valid Arguments Description - SataPortGDriveTy pe Indicates the type of device attached to this SATA port. --SataPortGModel Displays the drive model of the selected device. --SataPortH Sets the drive type of the selected device to off or auto. Off, Auto - SataPortHCapacit 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 --Slot3 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot. --Slot4 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot. --Slot5 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot. --Slot6 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot. --Slot7 Enabled, Disabled, BootDriverDisabled Enables or disables the specified slot.
Group Option Valid Arguments Description NOTE: Volt15V represents 1.5 Volt and Volt135V represents 1.35 Volt. --ProcC1E Enabled, Disabled When set to Enabled, the processor is allowed to switch to minimum performance state when idle. --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).
Group Option Valid Arguments Description --NmiButton Enabled, Disabled Enables or disables the Non-Maskable Interrupt (NMI) button on the front panel. --PasswordStatus Locked, Unlocked Locks the system password. To prevent the system password from being modified, set this option to locked and enable setup password. This field also prevents the system password from being disabled by the user while the system boots.
Group Option Valid Arguments Description --TpmStatus NA Displays the current status of TPM. UEFI Boot Settings Table 23. UEFI Boot Setting Options Group Option Valid Arguments Description UEFI Boot Settings --UefiBootSeq list of device names separated by commas Sets the UEFI boot order. The first option in the list is attempted first. If the first option is not successful, the second option is attempted, and so on.
Option Sub-option Valid Arguments Description -majorfwvers ion NA Reports the BMC device major firmware revision. -minorfwvers ion NA Reports the BMC device minor firmware revision. Example: A:>syscfg bmcversion devid=32 Applicable Systems devrevision=0 majorfwversion=0 minorfwversion=40 chassistype* Table 25. chassistype option Option Sub-option Valid Arguments Description Applicable Systems -chassistype * NA NA Identifies the Chassis Management Controller (CMC).
Option Sub-option Valid Arguments Description viewonly, disabled Example: A:>syscfg -controlpanelaccess= viewandmodify controlpanelaccess= viewandmodify Applicable Systems deviceguid* Table 28. deviceguid options Option Sub-option Valid Arguments Description Applicable Systems -deviceguid* NA NA Displays the GUID for the BMC. This option cannot be replicated. Example: A:>syscfg--deviceguid All PowerEdge systems deviceguid=XXXXXXXXXX encryptkey Table 29.
identify Table 30. 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 31. 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 33. 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 34.
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 35. 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 --lcd1 Option --lcd1 Valid Arguments Description Sets the first line of user-defined text on the system LCD. This option can be replicated.
Option Sub-option Valid Arguments Description Applicable Systems BMC to a known-good state. This option cannot be replicated. NOTE: The NMI, power button, and SOL defaults are not reset by using this option. Example: A:>syscfg --loaddefaults Loading defaults... nextboot Table 38.
nmibutton Table 39. nmibutton option Option Sub-option Valid Arguments Description Applicable Systems --nmibutton NA enable, disable Enables or disables the NMI button. This option can be replicated. Example: A:>syscfg -nmibutton=enable All PowerEdge systems nmibutton=enable passwordaction Table 40. 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.
Option Sub-option Valid Arguments Description Applicable Systems userid=3 -action=testpassword -password=bmcmastor Password test failed. pefcfgparams Table 41. 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 the BMC. This sub-option can be replicated. The hostname string must comprise only the followig characters: hyphen (-) , underscore (_) , and period (.) . The length of the hostname string must be 62 characters or 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.
powerbutton Table 42. powerbutton option Option Sub-option Valid Arguments Description Applicable Systems -powerbutton NA enable, disable Enables or disables the power button. This option can be replicated. Example: A:>syscfg -powerbutton=enable All PowerEdge systems powerbutton=enable powerctl Table 43. powerctl option Option Sub-option Valid Arguments Description Applicable Systems --powerctl NA powerdown Performs a chassis powerdown and controls the reset of the system.
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 45.
Option Sub-option Valid Arguments Description Applicable Systems istrator serialchannelaccess ipmioverserial=disab le channelprivlmt=admin istrator serialchannelinfo Table 46. 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 48. 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 50.
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 52.
version* Table 53. version option Option Sub-option Valid Arguments Description --version* NA NA Displays the version information for the SYSCFG utility. Applicable Systems virutualmedia Table 54. 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 on PowerEdge blade 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.
Table below shows some examples of valid and invalid short and long format command line instances. For an explanation of the specific order for each option, see RAID Configuration Utility Options And Arguments. For a list of frequently used RAID commands, see Quick Reference To RAIDCFG Commands. NOTE: Some of the following options or arguments might not be available on all systems. Table 58.
Option Valid Arguments Short Description Mandatory or Optional fgnclr Clears the foreign configuration for the indicated controller. See Importing and Clearing Foreign Configurations for specific usage information. Recovers the Foreign configuration for the indicated controller. See Importing and Clearing Foreign Configurations for specific usage information. Initializes the virtual disk for the specified controller. See Initializing Virtual Disks for specific usage information.
Option Valid Arguments Short Description Mandatory or Optional spciels Sets the PCIe link speed of the controller to 2 or 3. See Setting And Displaying The PCIe Link Speed for specific usage information. or setPCIeLinkSpeed svdn or setvdname -ad or adisk Sets the name of the specified virtual See Assigning, Unassigning, And Listing disk on the specified controller. Global Hot Spares for specific usage information. NA Specifies an array disk command.
Option Valid Arguments Short Description or channel:target:enclo sure case you must specify values for channel, target, and enclosure. Mandatory or Optional NOTE: From DTK 2.4 onwards, the -fd option creates dedicated hot spares instead of global hot spares. To set global hot spares, see Assigning, Unassigning, And Listing Global Hot Spares. -i Reads the RAID configuration information from the given .ini filename and creates the RAID configurations on the specified controllers.
Option Valid Arguments Short Description Mandatory or 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. NOTE: Spanlength is applicable for RAID 10, RAID 50, and RAID 60. The minimum permissible spanlength value is 2for RAID 10, 3for RAID 50 and 4for RAID 60. The number of array disks for creating virtual disks should not be a prime number and should be divisible by the specified spanlength.
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.3 Copyright (c) 2002-2013 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.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description -cp or cachepolicy d, c or d, e Sets the cache policy or disk cache policy. The valid arguments for cache policy are:. : enclosure,...] • • d — (Direct I/O) Reads are not buffered in cache memory. c — (Cache I/O) All reads are buffered in cache memory. NOTE: Cache policy is not supported on controllers that do not have a battery.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description • • • • • -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,...] ra, ara, nra, rc, nrc 5 — RAID 5 provides data redundancy by using data striping in combination with parity information.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description • read requests are accessing sequential sectors of the disk and can initiate read-ahead if necessary. nra — (No-Read-Ahead) The controller does not read sequential sectors of the disk when seeking data. NOTE: The ra, ara, and nra options are supported on the following RAID controllers only: • • • • -ctrl -ac=cvd - -sp or c=id -ad= spanlength ch:targ,ch:tar g, ... [or ch:targ:encl,. ..
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments channel:target : lun,... [or channel:target : enclosure,...] Description specify values for channel, target, and enclosure. -ctrl -ac=cvd - -str or strict 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,.. -ctrl -ac=cvd -c=id -ad= ch:targ,ch:tar g, ... [or ch:targ:encl,. .
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description • – RAID 60: 100 MB Software RAID controllers: – – – – RAID 0: 100 MB RAID 1: 100 MB RAID 5: 100 MB RAID 10: 100 MB NOTE: If this option is not provided, RAIDCFG determines the maximum possible virtual disk size and creates it. -wp or writepolicy wb, wt, wc, nwc Sets the write policy for the virtual disk.
Enumerating Array Disks The following table lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating array disks (hard drives). NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk. Table 62. Enumerating Array Disks (Hard Drives) Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description -ad -c=id or adisk controllerid=i d NA NA Lists all the array disks attached to the specified RAID controller.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Model: ST9146703SS Protocol: SAS Media: HDD NegSpeed: 6144 Mbps CapSpeed: 6144 Mbps Certified: YES Supported: YES Location: 0:2:1 Size: 139392 MB (136 GB) Avail: 139392 MB (136 GB) RAIDCFG Command successful! ****** Physical Drive ****** Vendor: DELL(tm) Model: ST9146703SS Protocol: SAS Media: HDD NegSpeed: 6144 Mbps CapSpeed: 6144 Mbps Certified: YES Supported: YES Location: 0:3:1 Size: 139392 MB (136 GB) Avail: 1
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Drive Model: ST336607LC Drive Location: 0:1:0 Drive Size: 34680 MB Drive Avail: 0 MB RAIDCFG Command successful! -ad -c=id or adisk controllerid=i d -ad= ch:targ,ch:t arg,... adisk= channel:tar get, channel:tar get,... Displays information about the specified array disk. This option combination is mandatory.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Drive Vendor: FUJITSU Drive Model: MAP3367NC Drive Location: 0:2:0 Drive Size: 34680 MB Drive Avail: 34680 MB RAIDCFG Command successful! -ad -ad= ch:targ,ch:tar g ,... -ac= unblink -c=id or adisk adisk= channel:target , channel:target ,... -ac= unblink controllerid= id vdisk=id NA NA Unblinks the specified physical disks on the specified controller.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Controller: PERC 6/E Virtual disk not found RAIDCFG Command successful! -vd or vdisk -c or controller id Lists all the virtual disks under the indicated controllers. Each virtual disk is displayed with the physical disk that comprises it. The -c option is optional and can be added to the command line in any order after the mandatory option.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments vdisk action=deletev disk controllerid=i d -vd -ac=dvd c=id or vdisk action=deletev disk controllerid=i d Description Example: A:>raidcfg -vd -ac=dvd -c=2 RAIDCFG Command successful! -vd or vdisk Deletes the indicated virtual disk on the indicated controller. The -vd- ac=dvd -c =id option combination is mandatory.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments action=blink controllerid=i d -vd -vd=id ac=unblink c=id or vdisk vdisk=id action=blink controllerid=i d Description Example: A:>raidcfg -vd -vd=2 -ac=blink -c=2 RAIDCFG Command successful! NA Unblinks the physical disks associated with the specified virtual disk on the specified controller.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments -envc= or setenvironment envname= envcommand= -se envn= - envc= -c=id or setenvironment envname= envcommand= controllerid=id Description the information to an existing file or creates a new file.
Function Call Description Example: A:>raidcfg -se -envn=FREEADISKCOUNT -envc= getfreeadiskcount -c=2 FREEADISKCOUNT=2 RAIDCFG Command successful! getfreeadisksize Returns the total size of the free array disks in megabytes. Example: A:>raidcfg -se -envn=FREEADISKSIZE -envc= getfreeadisksize -c=2 FREEADISKSIZE=15346 RAIDCFG Command successful! Returns the global hot spares (global failover disks) found on the specified controller.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Example: A:> raidcfg -i=\tmp\raid.ini -o NA Reads the RAID configurations from all available controllers and writes these configurations in the raid.ini file under the /tmp directory (in Linux systems). This option is mandatory. Example: A:> raidcfg -o=\tmp\raid.ini The contents of the raid.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments alhotspare controllerid=i d adisk| pdisk=channel: target:enclosu re Description Example: A:>raidcfg -ctrl -ac=sghs -c=2 -ad=0:1 RAIDCFG Command successful! -ad|-pd ac=lghs -c=id or adisk|pdisk action=listglo balhotspare controllerid=i d NA -ctrl —ac=rghs -c=id -ad|-pd= ch:targ:encl or controller action=removeg lobalhotspare controllerid=i d adisk| pdisk=channel: target:enclosu re NA NA Displays the array (physical) disk
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description Example: A:>raidcfg -ctrl -c=2 ac=fgnclr -ctrl -c=id -ac=fgnrvr NA NA or controller controllerid=i d action=foreign recover Recovers the foreign configuration detected in the selected controller. This feature is supported on PERC 5 and later controllers and is not supported on SAS controllers.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description cancelinit command on unsupported controllers returns an error. Example: A:>raidcfg -vd -c=2 -vd=2 ac=ci d vdisk=id action=canceli nit Resetting The Controller The following table lists the RAIDCFG options, parameters, and pre-defined arguments for resetting the controller. Table 74.
Setting And Displaying The PCIe Link Speed The following table lists the RAIDCFG options, parameters, and pre-defined arguments for setting and displaying the Peripheral Component Interconnect Express (PCIe) link speed of the controller. Table 76.
Mandatory Options and Arguments Optional Parameters Valid Parameters Arguments Description log file or creates a new file. The log file contains the same information as standard output. This option is optional and can be added to the command line in any order after the mandatory options have been added. Example: A:>raidcfg -ctrl -l=log.txt Controller_ID/Slot_ID: Controller_PCI_ID: Controller_Name: PERC 6/E Channels: Virtual_Disks: Firmware Version: V2.
Purpose Command Description Example: A:>raidcfg -ctrl -ac=sghs -c=2 -ad=0:1 RAIDCFG Command successful! To list all the disks attached raidcfg adisk c=slotid to a particular controller Lists all the disks attached to the controller. The slot ID is obtained from the first command. Record the drive location of the disks for later reference. To create a virtual disk with raidcfg -ctrl ac=cvd -c=slotid all the default settings ad= x:y,x:y,...
Purpose Command Description NOTE: The minimum number of drives required to create a virtual disk of RAID 6 is 4. raidcfg -ctrl ac=cvd -c=slotid ad= x:y,x:y,x:y,x:y ,x :y,x:y -r=60 -sp=x Creates a virtual disk of maximum size for type RAID 60. The slot ID in <-c=slotid> and the array disks in are obtained from the first two commands. The drive location is obtained from the second command.
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 79. 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 80.
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. 101 The -x (--hex) option can only be used with -b or -r. 102 Input file not found. 103 Input file cannot be read. 104 Invalid argument for option. 105 Function table lookup error. 106 The machine ID was not found in the file. 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 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.
Error Code Message 205 Invalid alert destination. 206 The set operation failed due to unspecified error. 207 Incorrect syntax for help. For more information about a particular command, use the option '-h or --help' followed by the command name. Example: %s -h --asset Failures And Solutions The following table lists the common SYSCFG failures and their solution. Table 81. SYSCFG Failures and Solutions Failure Messages Solutions Generic failure. Indicates iDRAC is in bad state. Reboot iDRAC.
Error Code Message 5 Error: Dell Utility Partition already exits. Please use -overwrite option to upgrade or overwrite. 6 Error: Partitions exists. Please clear all the partitions before running upinit.sh. 7 Error: DOS file(s) not found at the specified path. 8 Error: UP IMAGE not found at the specified location. 9 Error: format failed. 10 Error: Invalid size. Size should be a number between 32 and 2000. 11 Error: sysdrmk failed. 12 System Error.
Failure Messages The RAIDCFG utility failure messages provide error codes to help diagnose why some commands do not succeed. See table below for a list of the error codes and the associated messages. Table 85. 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.
Error Code Message 26 Size too small for given RAID type. 27 Wrong number of disks for RAID 1- concatenated. 28 Insufficient space to mirror disks. 29 Create Mirror not supported. 30 Disk in use. 31 Disk Lock operation failed. 32 Disk locked. 33 Disk Unlock operation failed. 34 Disk Unlocked. 35 Disk failed on rebuild. 36 Hot Spare not free. 37 Disk Diagnostic failed. 38 Disk Rebuild failed. 39 Disk Format failed. 40 Cancel of Disk Diagnostic failed.
Error Code Message 59 There is not enough free space on the array disk(s) to allow the operation to complete; the size of the virtual disk is too large; or communication to the array disk(s) has been lost. 60 Limit your array disk selection to those disks already included in another single virtual disk or to those array disks that are not used at all by another virtual disk. 61 Invalid Parameter 62 Failed drive cannot be added.
Error Code Message 84 You have selected an array disk that is in a degraded or failed state. Choose another array disk. 85 Delete the last created virtual disk first. 86 Virtual disk initialized for use and no override requested. 87 Virtual disk type requested is invalid for the attempted operation. 88 Virtual disk Move operation failed. Cannot rename, virtual disk is already in use. 89 Failover invalid. 90 Virtual disk resynching. 91 Virtual disk resynch failed.
Error Code Message 112 Virtual disk operation is temporarily unavailable. Rebuild in progress. 113 Virtual disk operation is temporarily unavailable. Check consistency in progress. 114 Specified virtual disk too small. 115 Virtual disk operation not supported. Size too small. 116 Operation is temporarily unavailable. Space in use. 117 Cannot reconfigure to the given RAID level. 118 Cannot reconfigure from current RAID level to the given RAID level.
Error Code Message 140 The controller was not able to add space to the specified concatenation set. 141 The controller was not able to get the status of the specified mirror set. 142 The controller was not able to set the requested failover space. 143 The controller cannot get the failover space information. 144 Controller cannot unmirror the specified virtual disk. 145 The controller could not split the specified virtual disk. 146 The controller could not lock the specified virtual disk.
Error Code Message 172 Data will be lost on the secondary disk and a reboot will be forced. 173 Cluster Services (MSCS) is running. Deleting a virtual disk that contains a cluster resource can result in unpredictable errors or system hangs (quorum disk). You should shut down cluster services before deleting cluster resources. Are you sure you want to proceed? 174 Cannot perform Create Virtual Disk or Delete Virtual Disk while the other server in a cluster is online.
Error Code Message 189 The Create Virtual Disk task was successful but the operating system may not be aware of the new virtual disk. 191 The import of foreign configurations is complete. Some configurations could not be imported. 192 Enable alarm command failed. The enclosure processor is busy or a firmware download is in progress. 193 Disable alarm command failed. The enclosure processor is busy or a firmware download is in progress. 194 Quiet alarm command failed.
Error Code Message SCSI). If there is a mismatch of the array disks then the RAIDCFG will not be able to determine the optimum size. In addition, also ensure that there is drive size available for the specified virtual disk. 219 One or more array disks selected to create virtual disk or hotspare doesn't have enough disk space. Please make sure that all the array disks and failover drives selected have enough free space.
Error Code Message 237 Please reset the controller before doing any further operation. RACADM Firmware Error Codes And Messages Table below lists RACADM firmware error codes and messages. Table 86. RACADM Firmware Error Codes and Messages Error Code Message 1 UNKNOWN COMMAND.
Error Code Message 27 PAGING ERROR 28 PAGING ALREADY IN PROGRESS 29 ERROR ACCESSING DEVICE 30 WRONG NUMBER OF ARGUMENTS 31 NO SCREEN FOR ASR STORED 32 CAN'T ADD HISTORY MONITOR 33 INVALID IDENTIFIER 34 CANNOT WRITE TO FLASH 35 FIRMWARE FILE INVALID 36 CANNOT READ REGISTER 37 CANNOT UNLOCK RESOURCE 38 TIME OUT 39 SERVER IN TEXT MODE 40 WRONG GRAPHICS MODE 41 CONFIG SPACE LOCKED 42 MASTER LOCKED 43 ASB BUS LOCKED 44 HISTORY MONITORS NOT YET AVAILABLE 45 NO VALID VALUE FO
Table 87. RACADM Error Codes and Messages Error Code Message 513 An unknown failure occurred. 514 Librac library not initialized. 515 An invalid parameter was passed into function. 516 Invalid DRSTYPE specified. 517 Librac library already initialized. 518 Invalid transport type specified. 519 Invalid library user. 520 A connection to the RAC controller could not be established. 521 Failed to perform read operation with RAC controller.
Error Code Message 545 Failed to create SSL context object. 546 Failed to create SSL BIO object. 547 Unable to create SSL socket connection. 548 Failed to initialize socket. 549 Failed to login to RAC successfully. 550 Invalid session ID specified. 551 Failed to logout from RAC successfully. 552 Command execution failed. 553 FTP Get operation failed. 554 FTP Put operation failed. 555 Failed to initialize FTP interface. 556 Failed to load SSL library.
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 88. 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