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