Dell™ OpenManage™ Deployment Toolkit Version 3.2.1 Command Line Interface Reference Guide w w w. d e l l . c o m | s u p p o r t . d e l l .
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 document is subject to change without notice. © 2010 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . What’s New in This Release Requirements . . . . . . . . . . . . . . . 9 . . . . . . . . . . . . . . . . . . . . . . . 9 . . . . . . . . . . . . . . . . . . . . . 10 . . . . . . . . . . . . . . . . . . . . . . 10 Toolkit Utilities Overview System Configuration Utility . . . . . . . . . . . . 10 RAID Configuration Utility . . . . . . . . . . . . . 10 RAC Configuration Utility . . . . . . . . . . . . . . 10 . . . . .
3 SYSCFG . . . . . . . . . . . . . . . . . . . . . . . . . . Features . . . . . . . . . . . . . . . . . . . . . . . . . SYSCFG General Options . . . . . . . . . . . . . . . . SYSCFG for BIOS Configuration . . . . . . . . . . . . . Options for BIOS Configuration . . . . . . . . . . SYSCFG for BMC and Remote Access Controller Configuration . . . . . . . . . . . . . . . . . BMC and Remote Access Controller Configuration Options . . . . . . . . SYSCFG for State Configuration . 127 . . . . . .
Enumerating RAID Controllers Creating Virtual Disks . . . . . . . . . . . 152 . . . . . . . . . . . . . . . 154 Enumerating Array Disks . . . . . . . . . . . . . . 167 Initializing Virtual Disks . . . . . . . . . . . . . . 176 Importing and Clearing Foreign Configurations . . . . . . . . . . . . . . . 177 . . . . . . . . . . . . . . . 179 Deleting Virtual Disks Assigning and Unassigning Global Hot Spares . . . . . Setting Environment Variables . . . . . . . . . . . 181 . . . . . . . . .
getconfig Subcommand Description . . . . . . . . 211 fwupdate . . . . . . . . . . . . . . . . . . . . . . 213 Synopsis . . . . . . . . . . . . . . . . . . . . . . 213 Description Input . . . . . . . . . . . . . . . . . . . . . 214 . . . . . . . . . . . . . . . . . . . . . . . . 214 Output . . . . . . . . . . . . . . . . . . . . . . . . Examples . . . . . . . . . . . . . . . . . . . . . . Updating the Firmware 216 getssninfo . . . . . . . . . . . . . . . . . . . . . 217 getsysinfo . .
Failure Messages UPINIT Linux-Specific Error Codes and Messages . . . . . . . . . . . 242 . . . . . . . . . . . UPINIT Windows PE-Specific Error Codes and Messages . . . . . . . . . . . . . . . . . . 243 RAIDCFG Error Codes and Messages . . . . . . . . . . 243 . . . . . . . . . . . . . . . . . 243 Failure Messages RACADM Firmware Error Codes and Messages RACADM Utility Error Codes and Messages B BMC Platform Events Filter Alert Messages . . . . . . . . . C Sample File Formats . . . . 257 .
Contents
1 Introduction Dell™ OpenManage™ Deployment Toolkit (DTK) includes a set of utilities for configuring and deploying Dell PowerEdge™ systems. DTK is designed for customers who need to build scripted installations in order to deploy large numbers of systems in a reliable fashion without having to dramatically change their current deployment processes.
Toolkit Utilities Overview 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 a .exe extension.
Replication File Format The -i and -o options use a .ini file format for SYSCFG options. All name/value entries that follow the [syscfg] section header in the .ini file belong to the SYSCFG utility. For an example of the syscfg.ini file, see "Sample SYSCFG Utility .ini File Format." SYSCFG Replication Rules Not all BIOS and BMC options can be replicated using a .ini file. For example, boot sequence and device sequence are only replicated if a device name list can be supplied.
• Unsupported arguments are arguments valid in SYSCFG but not applicable on certain systems. If SYSCFG encounters an unsupported argument, SYSCFG terminates. For example, syscfg –-embsataraid=ahci is not applicable on some x9xx series systems. • SYSCFG logs a message in the log file for each option processed in the syscfg.ini file. To generate the log file, use the logfile option.
Other Dell Documents You Might Need Besides this Command Line Interface Reference Guide, you can find the following guides on the Dell OpenManage documentation page of the Dell Support website at support.dell.com/manuals. • The Dell OpenManage Deployment Toolkit User's Guide provides best practice procedures that focus on the basic tasks for successful deployment of Dell 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]...
Table 2-1 lists the generic command line characters and arguments present in the command line options with a short description of these characters. Table 2-1. Command Line Syntax Element Description - Single-character options are prefixed with a preceding hyphen (-). NOTE: This delimiter is not applicable to Baseboard Management Controller (BMC) suboptions. -- Multi-character options are prefixed with two (2) preceding hyphens (--). utilname Generic designation for a DTK utility name.
Case Sensitivity • Command line options, pre-defined and user-defined arguments, and filenames given as arguments are all case sensitive. • Unless specified otherwise, enter all commands, options, arguments, and command line switches in lowercase letters. Command Line Option Delimiters • Single-character options are prefixed with a preceding hyphen (-). • Multi-character options are prefixed with two (2) preceding hyphens (--).
NOTE: Example 2 is invalid because the report and set actions are used in the same command line. NOTE: Examples 3, 4, and 5 are valid because the aliases use neither report nor set actions. Read and Write Commands Options can report a certain value or set of values based on the presence of an argument. These read or write actions are implied in the DTK command line arguments. The get, read, set, or write commands, for example, are not required.
The log duplicates all standard output and error information to the specified file. Each log file begins with a time stamp and utility name. For example, YYYY/MM/DD HH:MM:SS -
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.
SYSCFG General Options NOTE: Some of the options in SYSCFG are followed by an asterisk. These commands do not accept any suboptions or arguments. The values associated with these commands are those that are reported by the BIOS. These values cannot be modified. Table 3-1 lists the SYSCFG general options. Table 3-1. SYSCFG General Options Options Suboptions Valid Arguments No option NA NA Description If an option is not given, the SYSCFG utility outputs usage information.
Table 3-1. SYSCFG General Options (continued) Options --envar Suboptions Valid Arguments valid filename valid path media should be writable Description 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 need not be specified if the DTKENVSCR environment variable is set to a valid filename.
Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments Description -h or --help NA 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 suboptions, valid arguments, and a description are listed.
Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments -i or --infile NA Description This option directs the SYSCFG utility to take input from a .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 -o or --outfile NA Description This option prints all replicable options to the specified filename. The format of the output is in a .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 Dell enabled, the processor fetches the PowerEdge cache line containing the systems 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 Dell assignment of PCI devices in the PowerEdge system. This option is set to systems standard by default, causing standard interrupt routing that uses interrupt A, B, C, and D for all PCIe devices.
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, This option sets the boot order for All Dell separated by a system. Without an argument, PowerEdge commas this option prints the boot order systems list. The argument must be or formatted as a comma-separated list of device numerical list with no spaces. The names, list must be within the bounds of separated by 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 timeout 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 All Dell off, bmcsol, the communication port for PowerEdge mmb console redirection. If this option systems is set to a serial port, then the serial port option is not available. See the descriptions for "--serial1" and "--serial2.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --cpucore 1, 2, 4, 6, 8, 10, This option controls the number Dell PowerEdge 12, all of enabled cores in each processor. xx9x and later The default value is set to the systems maximum number of cores per processor. Example: A:>syscfg --cpucore=1 cpucore=1 --cpuxdsupport enable, disable This option enables or disables the execute disable (XD) feature of the CPU.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --devseq numerical list, This option sets the hard-drive All Dell separated by sequence for a system. Without PowerEdge commas an argument, this option displays systems the device list. The argument or must be formatted as a list of device comma-separated numerical list names, of device index values.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description numerical list, Example 1: separated by A:>syscfg --devseq commas The following devices or are set in the disk list of device device sequence: names, Device 1:* hdd.emb.0 separated by System BIOS boot devices commas 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 Dell PowerEdge systems Example: A:>syscfg -embhypervisor=on embhypervisor=on --embideraid on, off This option enables or disables All Dell the embedded IDE RAID PowerEdge controller. This option is only systems valid for supported systems that have IDE ROMB.
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 Dell embedded NIC on with PXE on, PowerEdge off, or on without PXE enabled. systems This option is only valid for supported systems that have an NIC. If the NIC is enabled without PXE, it is not found in the boot order. 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 Dell embedded NIC on with PXE PowerEdge enabled, off, or on without PXE systems enabled. This option is only valid for supported systems that have two embedded NICs. If the second NIC is enabled without PXE, it is not found in the boot order.
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 Dell embedded NIC on with PXE PowerEdge enabled, off, or on without PXE systems enabled. This option is only valid for supported systems that have three embedded NICs. If the second NIC is enabled without PXE, it is not found in the boot order.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embnic4 on, off, onnopxe, onwithiscsi This option turns the fourth All Dell embedded NIC on with PXE PowerEdge enabled, off, or on without PXE systems enabled. This option is only valid for supported systems that have four embedded NICs. If the fourth NIC is enabled without PXE, it is not found in the boot order.
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 Dell PowerEdge xx1x systems Example: A:>syscfg -embnic3nic4=enable --embnic3nic4=enable --embnics on, off This option enables or disables All Dell 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 All Dell PXE on the first embedded NIC. PowerEdge If PXE is disabled, the first NIC is systems 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 Applicable Systems --embsataraid off, combined, This option configures an ata, raid, qdma embedded SATA RAID controller. This option can be replicated. All Dell PowerEdge systems off — disables the embedded SATA RAID controller. combined — sets the SATA RAID controller to combined mode. ata — sets SATA RAID controller to ATA mode. raid — sets SATA RAID controller to RAID mode.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --embscsi2 on, off This option enables or disables the second embedded SCSI controller. This option is only valid for supported systems that have an embedded SCSI controller. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --embscsiraidchb raid, scsi This option sets the second All Dell channel on an embedded RAID PowerEdge controller to SCSI or RAID. This systems option is only valid for supported systems that support RAID/RAID and RAID/SCSI settings for channels A and B. This option can be replicated.
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. All Dell PowerEdge systems except PowerEdge 1955 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. Dell 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 Dell controller to auto, off, or readPowerEdge only. This option is available on systems 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 Dell the Hard Disk Drive Sequence PowerEdge menu that has not been systems attempted in the boot sequence.When set to on, all devices are attempted in an order in which they are configured. 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 Dell pre-empts what data might be PowerEdge needed next. When some data is systems found, it loads several steps in advance. When set to disable, the processor does not pre-empt. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --integratedraid enable, disable This option enables or disables the integrated RAID controller. This option can be replicated. Applicable Systems All Dell 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 --lcd default, none, user, idracipv4addres s, idracmacaddres s, ossystemname, servicetag, ipv6address, ambienttemp, systemwatts This option determines whether to display the default string (model name and number for Dell PowerEdge systems earlier than xx1x, and service tag for Dell PowerEdge systems xx1x and later) or a user-defined string on the front-panel LCD.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --logicproc enable, disable This option enables or disables logical processing for a system. This option is available on all systems that support logical processing (Hyperthreading). This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --memintleave enable, disable This option enables or disables the memory interleave mode. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg -memintleave=enable memintleave=enable -optimizer, memoperatingmod mirror, e advancedecc This option selects the memory operating mode. This feature is active only if a valid memory configuration is detected.
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 Dell device as the first device in the PowerEdge boot order for the next boot cycle systems only. The device must be a device from the --bootseq option device list. 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 Dell PowerEdge systems Without this option, the user is prompted during POST to confirm the change of a RAID controller from RAID(SCSI) to SCSI(RAID).
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --numlock on, off This option enables or disables All Dell the keyboard number lock during PowerEdge POST. This option is not systems replicated. Example: A:>syscfg --numlock=on numlock=on --oldsetuppwd This option is required to set a All Dell new setup password when a setup PowerEdge password is currently set.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --oldsyspwd This option supplies the current All Dell system password for the BIOS. PowerEdge This option is only given when systems setting the new system password. If this password does not match the current system password, the new password is not applied to the system. The system password is required when booting the system.
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. Example: All Dell PowerEdge systems A:>syscfg -opticaldrivectrl=enable opticaldrivectrl=enable --osmode enable, disable This option enables or disables operating system installation mode for installing operating systems.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --ovrwrt* NA This option is only used with the - All Dell o option to cause the output file PowerEdge to be overwritten if a file of the systems same name already exists. This option cannot be replicated. Example: A:>syscfg -o= filename.ini --ovrwrt The file filename has been overwritten. NOTE: 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 --pwdlock lock, unlock This option locks the system password. If the system password is locked, it can be modified only through the F2 screen with the setup password. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sata0 auto, off This option enables or disables SATA port 0. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg --sata0=auto sata0=auto NOTE: This option maps to -sata_a for PowerEdge x9xx systems. --sata1 auto, off This option enables or disables SATA port 1. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sata3 auto, off This option enables or disables SATA port 3. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg --sata3=auto sata3=auto NOTE: This option maps to -sata_d for PowerEdge x9xx systems. --sata4 auto, off This option enables or disables SATA port 4. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sata6 auto, off This option enables or disables SATA port 6. This option can be replicated. All Dell PowerEdge systems Example: A:>syscfg --sata_6=auto sata_6=auto NOTE: This option maps to -sata_g for PowerEdge x9xx systems. --sata7 auto, off This option enables or disables SATA port 7. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --serial1 disable, com1, com3, com1_bmc, bmcserial, bmclan, rac This option configures or reports All Dell the first serial port PowerEdge communication port. This option systems can be replicated. bmcserial — maps serial port 1 to BMC Serial. bmclan — routes the serial traffic destined for serial1 out to NIC1. com1_bmc — maps serial port 1 to COM port 1 BMC.
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 All Dell the serial port communication. PowerEdge When set to on, the BIOS enables systems COM port 1 and COM port 2. These ports are made available for use by the operating system or applications. BIOS Console Redirection is disabled. 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 On x9xx systems, the -serialcomm option can be used with the external serial (-extserial) option instead --setuppwd This option sets the setup All Dell password for the BIOS. The setup PowerEdge password locks the BIOS F2 systems screen. The argument string supplied to this option is the password.
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 Applicable Systems --slotname* NA This option reports the slot name Dell Blade of the blade. systems Example: A:>syscfg --slotname slotname=Slot5 --sriov enable, disable This option enables or disables support for SRIOV devices.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --syspwd This option sets the system All Dell password for the BIOS. The PowerEdge system password is required when systems booting the system. The argument string supplied to this option is the password. Generally, passwords are limited to alphanumeric characters and cannot exceed 32 characters in length.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Applicable Systems --sysrev NA This option reports the system revision. This is a read-only option. All Dell PowerEdge systems Dell PowerEdge xx0x and later systems tpm NOTE: For details about the tpm suboptions and arguments, see Table 3-3. --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 --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 Applicable Systems --virtualization enable, disable This option enables or disables virtualization in the CPU. When set to enable, it enables the additional hardware capabilities provided by Virtualization Technology in applicable CPUs. All Dell PowerEdge systems When set to disable, it disables the additional hardware capabilities provided by Virtualization Technology.
Table 3-3 lists the suboptions and arguments for the tpm option. Table 3-3. Suboptions and Arguments for the tpm Option Option Suboption 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. Suboptions and Arguments for the tpm Option (continued) Option Suboption --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 suboptions and arguments for the power option. Table 3-4. Suboptions and Arguments for the power Option Option Suboption 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-4. Suboptions and Arguments for the power Option (continued) Option Suboption 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-4. Suboptions and Arguments for the power Option (continued) Option Suboption --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, suboptions, and their arguments along with a description of the expected behavior using an example. Some features that need to be noted while reading this section are: • Unless otherwise specified, all suboptions to options are optional. • If a suboption is not specified for an option, all valid suboption values are displayed for the option. If suboptions are specified, then only those suboptions are reported.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --clearsel* NA NA Clears the SEL. This option cannot be replicated. All Dell PowerEdge systems Example: A:>syscfg -clearsel Clearing SEL... NOTE: The asterisk is not part of the command syntax. --deviceguid* NA NA Displays the GUID for the BMC. This option cannot be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description --encryptkey NA sessions. The hexadecimal number entered as an argument is not case sensitive although the value returned by the encryptkey option is always in uppercase. Applicable Systems All Dell PowerEdge systems The value returned is appended with zeroes so that it is always 40 characters long.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption --kvmstatusonlcd Valid Arguments Description Applicable Systems active, inactive This option Dell configures the vKVM PowerEdge session status on the xx1x systems LCD. Example: A:>syscfg -kvmstatusonlcd= active kvmstatusonlcd= active Sets or displays the All Dell LAN channel access PowerEdge settings such as systems alerting, IPMI over LAN, and user privilege. This option can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments -user, operator, channelprivlmt administrator Description Applicable Systems Sets the maximum privilege level accepted for the LAN channel. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --ipaddrsrc static, dhcp Sets the IP address source for the LAN channel. This suboption can be replicated. --ipaddress Sets the IP address for the LAN channel. This suboption cannot be replicated. --subnetmask Sets the subnet mask for the LAN channel. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option 92 SYSCFG Suboption Valid Arguments Description --destipaddr Sets the destination IP address for the alert destination specified with the alertdest suboption. The destipaddr suboption is dependent on the alertdest suboption. If the alertdest suboption is not specified on the command line, the first alert destination (alertdest=1) is set with this IP address. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --macaddress NA Displays the BMC MAC address. This suboption cannot be replicated. --nicselection shared, sharedfailover, dedicated, sharedreceiveo nall Sets the operating mode of the NIC to shared/sharedfailover /dedicated/sharedrec eiveonall. Some of these options are not applicable on certain systems.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description --dnsserver2 Sets the IP address of the secondary DNS server for domain name resolution. -dnsregisterrac enable, disable Enables or disables binding of the RAC name to the IP address. --dnsracname Sets the name of the RAC. -enable, disable Enables or disables domainnamefro getting the RAC mdhcp domain name through DHCP.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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 96 SYSCFG lancfgparams destipaddr= 192.168.100.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments lanuseraccess or lua Description Applicable Systems Configures the All Dell privilege level and PowerEdge channel accessibility systems associated 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 suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments -NA useridswithfixe dnames Description Reports the number of User IDs with fixed names on the LAN channel.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --loaddefaults* NA NA Restores the BMC to All Dell the defaults originally PowerEdge loaded on the systems controller. This option is used to return the BMC to a known-good state. This option cannot be replicated. NOTE: The NMI, power button, and SOL defaults are not reset by using this option. Example: A:>syscfg -loaddefaults Loading defaults...
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description --nextboot NA valid device name (from the --bootseq option device list) This option sets the All Dell specified device as PowerEdge 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems Device 5: nic.emb.2 Intel Boot Agent Version 4.0.17 Example 2: A:>syscfg -nextboot= nic.emb.1 nextboot= nic.emb.1 --nmibutton NA enable, disable This option enables or disables the NMI button. All Dell PowerEdge systems This option can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments passwordaction Description Configures and tests All Dell the password for the PowerEdge specified User ID. systems This option cannot be replicated. All three suboptions, 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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 PEF configuration parameters. This option can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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 suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --hostname Sets the host name (maximum of 62 printable ASCII characters) for the BMC. This suboption can be replicated. The --hostname string must comprise only these characters: hyphen (-), underscore (_), and period (.).
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description --alertpolstatus enable, disable Enables or disables the alert policy specified using the alertpolnum suboption. This suboption can be replicated. This suboption is dependent on the alertpolnum suboption.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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 All Dell or disables the power PowerEdge button.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --powerctl NA powerdown This option performs All Dell a chassis powerdown PowerEdge and controls the reset systems of the 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments --serialchannelaccess or sca Description Applicable Systems Sets or displays the All Dell channel access PowerEdge settings for the serial systems channel. This option can be replicated. -ipmioverserial disable, alwaysavail Sets the serial channel access mode. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments -user, operator, channelprivlmt administrator Description Sets the maximum privilege level accepted for the serial channel. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments --serialchannelinfo or sci Description Applicable Systems Displays media and All Dell protocol information PowerEdge about the serial systems channel. This option cannot be replicated. --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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments serialcfgparams or scp Description Applicable Systems Configures and displays serial configuration parameters. This option can be replicated. All Dell PowerEdge systems -basic, terminal Sets the connection connectionmo mode used to de perform IPMI messaging to the BMC. This suboption can be replicated. -noflowctrl, msgcommflow rtscts ctrl Sets the IPMI message communication flow control.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems -enable, disable Sets the line editing tmcfglineediti value for terminal ng mode configuration. This suboption can be replicated. --tmcfgdelctrl del, bksp Sets the delete control value for terminal mode configuration. This suboption can be replicated. -tmcfgechoctrl echo, noecho Sets the echo control value for terminal mode configuration.
Table 3-5.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments serialuseraccess or sua Description Applicable Systems Configures the All Dell privilege level and PowerEdge channel accessibility systems associated 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 suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option 116 Suboption SYSCFG 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-5.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments solaction Description This option enables All Dell or disables SerialPowerEdge Over-LAN (SOL) systems access for a 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 suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments solcfgparams Description Applicable Systems Configures and displays SOL configuration parameters. This option can be replicated. All Dell PowerEdge systems --solenable enable, disable Enables or disables whether the SOL payload type can be activated. This option can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments -1–255 solcharsendthr eshold Description Specifies that the BMC will automatically send 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments Description Applicable Systems --solbitrate 9600, 19200, Sets the serial 57600, 115200 channel communication bit rate (in bps) with the BMC when SOL is activated. This option can be replicated. NOTE: The arguments for --solbitrate vary with various generations of Dell systems.
Table 3-5.
Table 3-5.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments ssninfo Description Displays information All Dell about the number of PowerEdge possible active systems sessions 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-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments useraction Description Applicable Systems Enables and disables All Dell BMC, sua, and lua PowerEdge user IDs. This option systems can be replicated. --userid 2–10 if your system has a DRAC 4 controller Specifies the BMC user ID. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption Valid Arguments username --userid 2–10 if your system has a DRAC 4 controller Description Applicable Systems Sets the BMC User ID and username. This option can be replicated. All Dell PowerEdge systems Specifies the User ID. This suboption can be replicated.
Table 3-5. BMC and Remote Access Controller Configuration Options (continued) Option Suboption 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 Displays the version information for the SYSCFG utility. NOTE: The asterisk is not part of the command syntax. SYSCFG for State Configuration The SYSCFG utility allows the user to write a state data value on a system.
Table 3-6. 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-7 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-7. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments --chassvctag* None Description This option reports the chassis service tag for modular systems. Example: A:>syscfg --chassvctag chassvctag=SVCTAG1 --cpucount* None This command reports the number of processors found on the system. Example 1: A:>syscfg --cpucount cpucount=1 Example 2: A:>syscfg --cpucount cpucount=2 NOTE: The asterisk is not part of the command syntax.
Table 3-7. 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-7. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description -n This option specifies an input file to use for resolving PCI vendor and device numbers to strings. The file must be present (with read rights) and contain a properly formatted list. See "PCI Reporting" for more information. This option must be used with the --pci option. Example: A:>syscfg -n pci.
Table 3-7. 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-7. 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-7. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description None Example 3 (a pci.
Table 3-7. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description -s This option sets an environment variable to the value of a function command option. The string argument must be alphanumeric without any spaces or symbols. The variable name is upper-cased before being set. This option must be used with at least one function command.
Table 3-7. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --sysasset None This option reports the system asset tag for modular systems. Example: A:>syscfg --sysasset sysasset=ASSET01 --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.
Table 3-7. 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. Example: A:>syscfg --syssvctag syssvctag=BLADE01 NOTE: The asterisk is not part of the command syntax. --uuid* None This option reports the UUID for a system. The UUID is a unique system identifier used in PXE requests.
SYSCFG for IPv6 Configuration Table 3-8 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-8. Option SYSCFG Options and Arguments for IPv6 Configuration Suboption lancfgparamsv6 --ipv6 or lcpv6 Valid Argument Description enable, disable Loads or unloads the IPv6 stack.
Table 3-8. SYSCFG Options and Arguments for IPv6 Configuration Option Suboption 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 will use 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 .ini-formatted sections 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.
• PERC 5/E Adapter, PERC 5/I Integrated, PERC 5/i Adapter • CERC SATA 1.5/6-Channel (CH), CERC SATA 1.5/2S, and PERC 3/Di (These controllers are supported in Linux only.
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.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -ad ch:targ, ch:targ, ... Specifies an array disk. Optional. or or ch:targ:lun,... adisk or ch:targ:enc See Table 4-5 for specific usage information. channel:target, or channel:target:lun , or channel:target:en closure Short Description For SCSI controllers, the value of lun should always 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-11 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-13 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. or size -sp or spanlength -ssz NOTE: Spanlength is applicable only for RAID 50.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -ver 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. or version -wp wb, wt, wc, nwc, fwb or writepolicy See Table 4-14 for specific usage information.
NOTE: Some of the following options or arguments might not be available on all systems. 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.
Enumerating RAID Controllers Table 4-3 lists the RAIDCFG options, parameters, and pre-defined arguments for enumerating RAID controllers. Table 4-3. Enumerating RAID Controllers Mandatory Optional Valid Description Options and Paramet Parameters Arguments ers Arguments -ctrl NA or controller NA Lists all the RAID controllers on the host system, along with select property information. This option is mandatory.
Table 4-3. Enumerating RAID Controllers (continued) Mandatory Optional Valid Description Options and Paramet Parameters Arguments ers Arguments -c rid Displays the properties for the RAID controller with the specified controller ID. This option combination is mandatory.
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 need to 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.
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -cp or cachepolicy d, c Sets the cache policy for the virtual disk. The valid arguments are: d — (Direct I/O) Reads are not buffered in cache memory. c — (Cache I/O) All reads are buffered in cache memory. NOTE: This option is not supported on the following controllers: CERC SATA 1.5/6 CH, CERC SATA 1.5/2S, and PERC 3/Di.
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -fd ch:targ, ch:targ, Sets the failover drive for the virtual ... disk. The -fd option is optional and can or be added to the command line in any or ch:targ:lun,... failoverdrive order after the mandatory option or ch:targ:enc combination. channel:target, NOTE: From DTK 2.
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 will be ignored. rc — (Read-Caching) Enables read caching. nrc — (No-Read-Caching) Disables read caching. NOTE: The rc and nrc options are supported on the following RAID controllers only: CERC SATA 1.
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,...] 162 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,...] Sets the maximum size of the virtual disk in MB or GB. A valid argument is a number representing the maximum size for the virtual disk.
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 following RAID controllers only: CERC SATA 1.5/CH and PERC 3/Di. 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= or arg,... controllerid= channel:tar id vdisk=id get, channel:tar get,... Displays information about the specified array disk. This option combination is mandatory.
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 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 Valid Parameter Description Arguments controller controllerid=id action= foreignimport 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 fgnrvr or controller controllerid=id action= foreignrecover Valid Parameter Description Arguments Recovers the foreign configuration detected in the selected controller. This feature is supported from the 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 need to 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 disks as global hot spares on the specified controller.
Setting Environment Variables Table 4-11 lists the RAIDCFG options, parameters, and pre-defined arguments for setting the CLI environment. Table 4-11. 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-11. Setting Environment (continued) Mandatory Options and Arguments Optional Valid Description Parameter Parameter Arguments -se -envn= envc= c=id NA or setenvironment envname= envcommand= controllerid=id NA Sets a user-defined environment variable to the value returned from the getfirmware, getcontrollertype, getadisks, getadiskcount, getfreeadisks, getfreeadiskcount, getfreeadisksize, or gethotspares function call. This option combination is mandatory.
Table 4-12 lists the function calls of the setenvironment option. Table 4-12. Function Calls of the setenvironment Option Function Call Description getfirmware Returns the firmware version of the specified controllers. Example: A:>raidcfg -se -envn=FIRMWARE -envc= getfirmware -c=2 FIRMWARE=531T RAIDCFG command successful! getcontrollertype Returns LSI for LSI controllers and ADAP for Adaptec controllers.
Table 4-12. Function Calls of the setenvironment Option (continued) Function Call Description getfreeadiskcount Returns the number of free array disks found in the specified controller. Example: A:>raidcfg -se -envn=FREEADISKCOUNT -envc= getfreeadiskcount -c=2 FREEADISKCOUNT=2 RAIDCFG command successful! getfreeadisksize Returns the total size of the free array disks in megabytes.
Table 4-12. Function Calls of the setenvironment Option (continued) Function Call Description getfreeadisks Returns the free array disks. A:>raidcfg -se -envn=GETFREEADISKS -envc= getfreeadisks -c=2 GETFREEADISKS=0:3:1,0:4:1 RAIDCFG command successful! getadiskcount Returns the total number of array disks.
RAID Replication Options Table 4-13 lists the RAID replication options. Table 4-13. 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-13. RAID Replication Options (continued) Mandatory Optional Valid Options Parameters Parameter and Arguments Arguments Description controllerid=0 size=65345 raid=1 readpolicy=ra writepolicy=wt stripesize=64 cachepolicy=d adisk=0:3:1,0:4:1 If the controller uses global hot spares, the raid.
Miscellaneous Options Table 4-14 lists all other RAIDCFG options, parameters, and pre-defined arguments. Table 4-14. 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-14. 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-15 lists the basic RAIDCFG commands. Table 4-15. 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. Note the slot ID of the controllers. You will need it for all the other commands. To list all the disks raidcfg adisk - Lists all the disks attached to the attached to a particular c=slotid controller.
Table 4-15. 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 Creates a virtual disk of 5GB size for type RAID 1.
Table 4-15. 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.
• Uncompresses the UP file onto the UP image. • Unmounts the partition. NOTE: On Windows PE, UPINIT runs as a batch file. In Linux, it is a shell script that uses standard Linux commands to accomplish the same tasks done by the Windows PE counterpart. Both command lines are identical and the output of the two utilities will be identical if 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 will output usage information. The usage information will be printed in the format shown below. Example 1: A:>upinit upinit version 1.0 © 2005 Dell Inc. All rights reserved upinit.sh --disk|-d=disk --size|-s= size --file|-f=file [--overwrite|-o] [-help|-h] --help or -h prints help. --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-2006 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 will not be 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 will be decompressed onto the utility partition. This file will be checked for existence and availability before any partitions are created on the disk. If the file is not specified, the utility will simply create the utility partition, format it, and exits. It will be up to the user to mount and populate the utility partition.
UPINIT
6 RACADM The RACADM utility provides a scriptable interface that allows you to locally or remotely configure your remote access controller (RAC). Using the RACADM utility, you can enter command line options to configure RAC properties. When you enter command line options, the RACADM utility sets or retrieves object property values in the RAC properties database. You can also use the RACADM utility to write scripts that will automatically configure multiple RACs.
RACADM Options Table 6-1 lists the options and arguments for the RACADM utility that apply to deployment. For more information about the valid RACADM options, see "RAC Configuration Utility Options, Subcommands, and Arguments." NOTE: Some of the following options or arguments might not be available on all systems. Table 6-1.
Table 6-1. RACADM Options (continued) RACADM Options RACADM and Arguments Subcommands Short Description clrsel Clears RAC system event log (SEL). config Configures the RAC. See "config/getconfig" for more information about the subcommand options and arguments. coredump Displays the last RAC coredump. coredumpdelete Deletes the last RAC coredump. fwupdate Updates the firmware on the RAC. See "fwupdate" for more information about the subcommand options and arguments.
Table 6-1. RACADM Options (continued) RACADM Options RACADM and Arguments Subcommands Short Description getsysinfo Retrieves session information for one or more currently active or pending sessions from the Session Manager's session table. See "getsysinfo" for more information about the subcommand options and arguments. gettracelog Displays the RAC diagnostic trace log. See "gettracelog" for more information about the subcommand options and arguments.
Table 6-1. RACADM Options (continued) RACADM Options RACADM and Arguments Subcommands Short Description setrac Sets RAC parameters from the managed system. See "setrac" for more information about the subcommand options and arguments. serveraction Performs system power management operations. setniccfg Modifies the network configuration properties. sslcertupload Uploads an SSL (Secure Socket Layer) certificate to the RAC. sslcertdownload Downloads an SSL certificate from the RAC.
Error Messages When using RACADM utility commands and subcommands, you may encounter one or more of the following errors: • Local error messages occur when problems occur with syntax, typographical errors, incorrect names, and so on. Example: racadm : ERROR : • Transport error messages occur when the RACADM utility communication paths to the RAC are not accessible.
• racreset • racresetcfg • setrac NOTE: Some of the following options or arguments might not be available on all systems. racadm Command Table 6-2. racadm Command Help Option Command Definition racadm Command line status and configuration utility for RACs. Description Without options, the RACADM utility executes the help command, which displays a list of available tests and a one-line description of each. The RACADM utility help displays any syntax and command line options.
Enabling and Disabling Remote Security NOTE: It is recommended that you run these commands on your local system. You must reset the RAC controller to enable these commands. Enter the following command to enable remote security: racadm config -g cfgRacTuning -o cfgRacTuneRemoteRacadmEnable 1 Enter the following command to disable remote security: racadm config -g cfgRacTuning -o cfgRacTuneRemoteRacadmEnable 0 Log/Verbose Levels Table 6-4.
Table 6-5. racadm Subcommands and Arguments (continued) Command Description getraclog Lists usage statement for the specified subcommand. racdump Dumps RAC status and state information for debug. racreset Resets the RAC. racresetcfg Resets the RAC to the default configuration. setrac Sets time, managed system name, operating system name, and type from the managed system to the RAC. config/getconfig Table 6-6.
config Subcommand Description The configuration subcommand allows the user to set RAC configuration parameters individually or to batch them as part of a configuration file. After the .cfg file has been correctly parsed, each object is read. If the content is the same, a write to the RAC does not occur. If the data is different, that RAC object is written with the new value. Input Table 6-7.
Output This subcommand generates error output upon encountering either of the following: • Invalid syntax, group name, object name, index, or other invalid database members • RACADM utility transport failures If errors are not encountered, this subcommand returns an indication of how many configuration objects that were written out of how many total objects were in the .cfg file.
Table 6-8. getconfig Subcommand Options (continued) Option Description -i The -i , or index option, is valid only for indexed groups and can be used to specify a unique group. The is a decimal integer from 1 through 16. If -i is not specified, a value of 1 is assumed for groups, which are tables that have multiple entries. The index is specified by the index value, not a “named” value.
• racadm config -f myrac.cfg Configures or reconfigures the RAC. The myrac.cfg file may be created from the command specified in the previous example if the RAC has a desired configuration to be replicated. The myrac.cfg file may also be edited manually as long as the parsing rules are followed. NOTE: The myrac.cfg file does not contain password information. To include this information in the file, it must be input manually. If you want to remove password information from the myrac.
Description The fwupdate subcommand allows the caller to update the firmware on the DRAC 4. The user may: • Start updating a firmware update file that has previously been loaded into the RAM disk update area. • Check the status of the firmware update process. • Instruct the DRAC 4 firmware to get the firmware update file from a TFTP server and load it into the RAM disk area.
Table 6-10. fwupdate Subcommand Options (continued) Option Description -g The get option instructs the firmware to get the firmware update file from the TFTP server and place it in the RAM disk area. The user may also specify the -a and/or the -f or -d options that are described next. In the absence of the -a or -f options the defaults are read from properties contained in the group cfgRemoteHosts, using properties cfgRhostsFwUpdateIpAddr and cfgRhostsFwUpdatePath.
Output Displays a message indicating which operation is being performed. Examples • racadm fwupdate -g - a 143.166.154.143 -f firmimg.dm1 In this example, the -g option tells the firmware to download the firmware update file from a location (specified by the -f option) on the TFTP server at a specific IP address (specified by the -a option). The update file is then loaded into RAM disk. Since the -u option is not present, an update does not occur.
If you are updating your firmware remotely, use the following command to update your firmware: racadm -u -p fwupdate -g u -a -d NOTE: The -p option does not support remote firmware updates. getssninfo Table 6-11. getssninfo Subcommand Command Definition getssninfo Retrieves session information for one or more currently active or pending sessions from the Session Manager's session table.
Input Table 6-12. getssninfo Subcommand Options Option Description -A The -A option eliminates the printing of data headers. -u The -u user name option limits the printed output to only the detail session records for the given user name. If an * symbol is given as the user name, all users are listed. Summary information is not printed when this option is specified.
getsysinfo Table 6-13. getsysinfo Subcommand Command Definition getsysinfo Displays RAC information, system information, and watchdog status information. Synopsis racadm getsysinfo [-d] [-s] [-w] [-A][-c] Description The getsysinfo command returns information about the RAC, system, or watchdog status, depending on the command options. The order of data on output is always the same: RAC information, system information, and watchdog information. Input Table 6-14.
Enumeration values or bitmaps are defined for these elements. When the -A (API) option is included on the command, the enumeration/bit value of the element is listed in the output. Otherwise, the enumeration or bit value is mapped to a string before being output. The following bullet items define the mapping of values to strings: Table 6-15.
Examples • racadm getsysinfo -A -w -s "123456" "PowerEdge 1650" "A08" "EF23VQ-0023" "" 0x100 "Server1" "Microsoft Windows 2000 version 5.0, Build Number 2195, Service Pack 2" "1.60" "Watchdog Info:" 2 39 40 • racadm getsysinfo -w -s System Information: System ID = 123456 System Model = PowerEdge 1650 BIOS Version = A08 Asset Tag = EF23VQ-0023 Service Tag = 2MP9Z01 Hostname = Server1 OS name 5.0, = Microsoft Windows 2000 version Build 2195 Service Pack 2 ESM Version = 1.
getraclog CAUTION: The system may hang if this command is run. You may have to powercycle the system if it hangs. NOTE: To use this command, you must have Log In DRAC 4 permission. Table 6-16 describes the getraclog command. Table 6-16. getraclog Command Definition getraclog -i Displays the number of entries in the DRAC 4 log. getraclog Displays the DRAC 4 log entries.
Output One line of output is displayed for each DRAC 4 log entry. Restrictions The output buffer size is too big for execution across IPMI transport. gettracelog CAUTION: The system may hang if this command is run. You may have to powercycle the server if it hangs. NOTE: To use this command, you must have Log In DRAC 4 permission. Table 6-17 describes the gettracelog command. Table 6-17. gettracelog Command Definition gettracelog -i Displays the number of entries in the DRAC 4 trace log.
help Table 6-18. help Subcommand Command Definition help Lists all of the subcommands available to use with the RACADM utility and provides a short description for each. Synopsis racadm help racadm help Description The help subcommand lists all of the subcommands that are available under the racadm command along with a one-line description. You may also enter a subcommand after help to get the syntax for a specific subcommand.
Description The racdump subcommand provides a single command to get a dump, status, and general RAC board information with a single command. The following commands are executed as a result of the single racdump subcommand: • getsysinfo • coredump • memmap • netstat • getssninfo • getsensors Input None Output The output of the individual commands are displayed. racreset Table 6-20. racreset Subcommand Command Definition racreset Resets the RAC.
The default option is soft. If you do not enter an option, the RACADM utility waits three seconds and then runs the soft option with the racreset subcommand. NOTE: A reboot is not necessary to apply configuration settings to the RAC. When the configuration settings affect other system components, on the other hand, a reboot is necessary for the affected components to detect the changes.
Examples • racadcm racreset soft 1 Start the RAC soft reset sequence in 1 second. • racadm racreset soft 20 Start the RAC soft reset sequence after 20 seconds. racresetcfg Table 6-22. racresetcfg Subcommand Command Definition racadm racresetcfg Resets all database configuration parameters to default values; equivalent to a soft reset. Synopsis racadm racresetcfg Description The racresetcfg command removes all database property entries that have been configured by the user.
setrac Table 6-23. setrac Subcommand Command Definition setrac Sets RAC parameters from the managed system. Synopsis racadm setrac [-h -o -T -d] Description This command sets time, managed system name, operating system name, or operating system type from the managed system to the RAC. If no options are entered, all four parameters are set. The -d option allows the user to display the parameters only without actually writing them to the RAC firmware.
Output A message is displayed indicating the values obtained from the managed system, and if they are being written to the RAC or only displayed. Examples • racadm setrac -d Only the parameter values are displayed. • racadm setrac -h The UTC time and managed system name are taken from the managed system and written to the RAC.
RACADM
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 Clear settings requires setup password. 147 There is currently no TPM Clear request pending.
Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 160 Invalid IPv6 address. The IPv6 address specified has incorrect address format. 161 Invalid IPv6 address. The gateway address specified has incorrect address format. 162 Invalid IPv6 address. The Primary DNS server address specified has incorrect address format. 163 Invalid IPv6 address. The Secondary DNS server address specified has incorrect address format. 164 Invalid IPv6 address.
Table A-1. SYSCFG Error Codes and Messages (continued) Error Code Message 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.
Table A-2. UPINIT Common Error Codes and Messages (continued) Error Code Message 5 Error: Dell Utility Partition already exits. Please use --overwrite option to upgrade or overwrite. 6 Error: Partitions exists. Please clear all the partitions before running upinit.sh. 7 Error: DOS file(s) not found at the specified path. 8 Error: UP IMAGE not found at the specified location. 9 Error: format failed. 10 Error: Invalid size. Size should be a number between 32 and 2000. 11 Error: sysdrmk failed.
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. UPINIT Windows PE-Specific Error Codes and Messages Error Code Message 31 Error: DISKPART failed. 32 Error: DISKPART command file not found. RAIDCFG Error Codes and Messages The RAIDCFG utility checks your commands for correct syntax when you enter them. When you enter a command, a message displays stating the results of the command.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 7 Buffer too small. 8 Virtual Disk contains boot partition. Use force option to delete. 9 Init boot drive failed. 10 Format boot drive failed. 11 Cannot write boot drive. 12 Unsupported RAID value. 13 Invalid RAID configuration. 14 Span depth not in range. 15 RAID 1 failed. 16 Exactly 2 array disks are required to create a RAID 1 virtual disk. 17 Unsupported stripe size value. 18 RAID 5 only.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 29 Create Mirror not supported. 30 Disk in use. 31 Disk Lock operation failed. 32 Disk locked. 33 Disk Unlock operation failed. 34 Disk Unlocked. 35 Disk failed on rebuild. 36 Hot Spare not free. 37 Disk Diagnostic failed. 38 Disk Rebuild failed. 39 Disk Format failed. 40 Cancel of Disk Diagnostic failed. 41 Cancel of Disk Rebuild failed.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 54 Virtual disk not found. 55 Virtual disk locked. 56 Drive in use. 57 Reached maximum physical size. 58 Reached maximum count of virtual disks. 59 There is not enough free space on the array disk(s) to allow the operation to complete; the size of the virtual disk is too large; or communication to the array disk(s) has been lost.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 71 Virtual disk initialization failed. Controller busy. 72 Virtual disk reconstruction failed. Controller busy. 73 Virtual disk resynching failed. Controller busy. 74 Flush Virtual disk's cache failed on controller. 75 Virtual disk partition specified not found. 76 Unsupported cache policy value. 77 Unsupported write policy value. 78 Unsupported read policy value. 79 Cancel initialization on virtual disk failed.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 86 Virtual disk initialized for use and no override requested. 87 Virtual disk type requested is invalid for the attempted operation. 88 Virtual disk Move operation failed. Cannot rename, virtual disk is already in use. 89 Failover invalid. 90 Virtual disk resynching. 91 Virtual disk resynch failed. 92 Virtual disk reconstruct failed. 93 Cannot format a virtual disk that contains a boot or system partition.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 106 SMART report count not supported. 107 Operations on hidden virtual disks are not allowed. 108 Virtual disk is in use. 109 The virtual disk is in use. It cannot be reconfigured at this time. 110 Virtual disk operation is temporarily unavailable. Initialization in progress. 111 Virtual disk operation is temporarily unavailable. Reconstruction in progress. 112 Virtual disk operation is temporarily unavailable.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 123 Controller cache flush failed. 124 Enable alarm on controller failed. 125 Disable alarm on controller failed. 126 Quiet alarm on controller failed. 127 Controller failed to perform the task. 128 Specified bus not found for controller. 129 Call to set cache mode on the controller failed. 130 Unexpected controller error. 131 Controller out of memory. 132 Invalid controller state. 133 Controller failed.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 144 Controller cannot unmirror the specified virtual disk. 145 The controller could not split the specified virtual disk. 146 The controller could not lock the specified virtual disk. 147 Controller IO paused. 148 No controller parameter support. 149 Controller does not recognize parameter symbol. 150 Controller Battery Recondition failed. 151 Controller Get disk signature failed. 152 Controller Read Flags failed.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 164 Driver could not execute. 165 Cannot delete virtual disk. 166 Cannot set temperature probe. Invalid value entered. 167 Cannot set enclosure tag. Invalid value entered. 168 Cannot set enclosure alarm. 169 Temperature probe value out of range. 170 Cannot set cache mode. 172 Data will be lost on the secondary disk and a reboot will be forced. 173 Cluster Services (MSCS) is running.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 177 The maximum number of partitions have already been created on one of the selected array disk(s). Each array disk can hold portions (partitions) of up to 10 virtual disks. This virtual disk cannot be created because one or more array disk(s) have reached the partition limit. 178 The virtual disk is in use. Please close any applications that use the virtual disk and unmount any file systems that reside on the virtual disk.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 185 The version of the controller firmware installed on your system does not support this operation. 186 There are no disks of the correct type available to be assigned as a hot spare. 187 There are no disks of sufficient size available to be assigned as a hot spare. 188 There are no disks of the correct type and sufficient size available to be assigned as a hot spare.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 202 RAID Type & Size are required to create a virtual disk. Ensure that the RAID type and the size are correct. 203 Invalid Environment command! 204 File is not writable! 205 Setting Environment Variable Command failed! 206 Filename is not provided! 207 Invalid Strict option! Please provide a valid number between 1 and 100. 208 Span depth is not needed for this RAID type.
Table A-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 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 48 NO DIAGNOSTIC TASK RUNNING 49 READ ONLY 50 SNARFING IS NOT AVAILABLE 51 TEXT RESOLUTION OF SERVER CHANGED 52 MODULE NOT LOADED 53 IPMI ERROR 54 ERROR IN DIAGNOSTIC FUNCTION 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.
Table A-7. RACADM Error Codes and Messages (continued) Error Code Message 523 Invalid message ID. 524 Invalid message type. 525 Invalid response message. 526 Specified user buffer is too small to hold data. 527 Authentication failed - Invalid user name or password. 528 Invalid CHAP protocol response encountered. 529 CHAP buffer too small. 530 Timeout occurred. 531 Insufficient user privileges to perform operation. 532 TFTP write error encountered. 533 TFTP read error encountered.
Table A-7. RACADM Error Codes and Messages (continued) Error Code Message 546 Failed to create SSL BIO object. 547 Unable to create SSL socket connection. 548 Failed to initialize socket. 549 Failed to login to RAC successfully. 550 Invalid session ID specified. 551 Failed to logout from RAC successfully. 552 Command execution failed. 553 FTP Get operation failed. 554 FTP Put operation failed. 555 Failed to initialize FTP interface. 556 Failed to load SSL library.
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 Automatic System Recovery The system is hung or is not responding and is taking an action configured by Automatic System Recovery. System Power Probe Warning The system is setting actions when a power consumption probe detects a warning value. System Power Probe Failure The system is setting actions when a power consumption probe detects a failure value.
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 268 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 269
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 270 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 271
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 274 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 275
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 276 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 277
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 278 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 279
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 virtualmedia=enable 280 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 287
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". Table D-1.
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description -o or --outfile NA Outputs all replicable options to the specified filename. The format of the output is in a .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 Suboptions 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 Suboptions Valid Arguments Description Replicated --cstates NA enable, disable Enables or disables the power c states of the processor. Yes Available only on 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 Suboptions Valid Arguments Description Replicated --embnic4 NA on, off, onnopxe, onwithiscsi Enables or disables the fourth embedded NIC. Yes --embnic1nic2 NA enable, disable Enables or disables the Yes operating system interface of the first and second embedded NIC controllers. Available only on Dell™ PowerEdge™ 1855, PowerEdge 6850, and xx1x systems.
Table D-1. SYSCFG Options (continued) Options Suboptions 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 Suboptions Valid Arguments Description Replicated --fsbr NA 115200, 57600, 19200, 9600 Sets the console redirection fail safe baud rate. Yes --hwprefetcher NA enable, disable Enables or disables hardware Yes prefetching by the processor. --hddfailover NA off, on Specifies which device in the Yes hard disk drive sequence menu is attempted in the boot sequence.
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --ioat NA enable, disable Enables or disables the I/O Acceleration Technology (I/OAT)\nDMA Engine option. Yes --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).
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --lcd2 NA Sets the second line of user- Yes defined LCD strings. NOTE: Before setting user strings for this option, ensure that --lcd is set to user. NOTE: If you have a Dell™ PowerEdge™ x6xx, x7xx, or x8xx system, you need to reboot your system for the settings to take effect. --logicproc NA enable, disable Enables or disables the logical processor (Hyperthreading).
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --memtest NA enable, disable Enables or disables the power-on self-test (POST) extended memory test. Yes --mouse NA on, off Turns the mouse controller on or off. Yes none Disables the POST prompt message when the SCSI controller type is changed. No -NA noraidprompt* NOTE: The asterisk is not part of the command syntax. --numlock NA on, off Enables or disables the keyboard number lock.
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --ovrwrt* NA none Overwrites the file contents No when used with the -o option. NOTE: The asterisk is not part of the command syntax. power --profile maxperforma Displays the settings similar Yes nce, osctl, to the BIOS setup screen for apc the respective profile. custom Creates the custom profile.
Table D-1. SYSCFG Options (continued) Options Suboptions 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 Suboptions Valid Arguments Description Replicated --redmem NA off, spare, mirror, raid Sets the redundant memory Yes mode. 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 Suboptions 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 Suboptions Valid Arguments Description Replicated --serial1 NA disable, Sets the behavior for serial com1, com3, port 1. com1_bmc, bmcserial, bmclan, rac Yes --serial2 NA auto, disable, Sets the behavior for serial com2, com4 port 2. Yes --serialcomm NA on, com1cr, com2cr, off Sets the behavior of serial port communication. Yes --setuppwd NA Sets the setup password for the system BIOS.
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated -enabled, tpmactivatio disabled, n nochange Enables or disables the TPM Yes activation feature. --tpmclear Clears the contents of the TPM chip without erasing the tpmsecurity and tpmactivation settings. No -NA undotpmcle ar Undoes the result of the tpmclear setting.
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments --usbports NA enable, Enables or disables USB enablebacko ports. nly, disable Yes --virtualization NA enable, disable Enables or disables virtualization in the CPU. Yes --virtualmedia NA enable, disable Enables or disables virtual Yes media in Dell Remote Access Controllers 5 (DRAC 5). bmcversion --devid NA Displays revision information for the BMC and the firmware.
Table D-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description lanchannelacce --pefalerting enable, ss disable -or ipmioverlan disable, lca alwaysavail -channelprivl user, operator, mt administrator Sets or displays the LAN channel access settings such as alerting and user privilege limits. lanchannelinfo -NA or mediumtype NA lci --prottype NA --ssnsupport NA Displays media and protocol information about the LAN channel.
Table D-1.
Table D-1. SYSCFG Options (continued) Options Suboptions 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 Suboptions 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 Suboptions 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 Suboptions 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 Suboptions 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 Suboptions 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 Suboptions Valid Arguments Description solcfgparams --solenable enable, disable Configures and displays SOL configuration parameters.
Table D-1. SYSCFG Options (continued) Options Suboptions 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 Suboptions 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 Suboptions 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". 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. See Table 4-4 for specific usage information.
Table D-2. 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:lu n, or channel:target:en closure -c or Short Description enclosure can be non-zero, in which case you need to specify values for channel, target, and enclosure. NOTE: You can also use pdisk or -pd instead of adisk or -ad to specify an array disk.
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 failoverd or ch:targ:enc rive channel:target, or channel:target:lu n, or channel:target:en closure -i -l Short Description For SAS controllers, the value of enclosure can be non-zero, in which case you need to specify values for channel, target, and enclosure. NOTE: From DTK 2.
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, 193 disk partitioning utilities, 10 disk partitioning utility, 10 DTK utilities overview, 10 RACADM, 202 options and arguments RAIDCFG, 144 UPINIT, 194 overview DTK utilities, 10 R E error codes, 231 error messages, 19, 231 F features RACADM, 201 RAIDCFG, 143 SYSCFG, 21 UPINIT, 193 M messages and codes, 231 RAC configuration utilities RACADM, 10 RAC configuration utility, 10 RACADM, 201 features, 201 options, subcommands, and arguments, 206 RACADM subcommands config/ge
error codes and messages, 243 features, 143 options and arguments, 144, 150 supported RAID controllers, 143, 193, 201 UPINIT, 193 utility types RAID configuration, 10 system configuration and update, 10 replication, 11 requirements, 9 what’s new, 9 S SYSCFG, 21 error checking and messages, 231 features, 21 options and arguments, 27 system configuration and update utilities, 10 SYSCFG, 10 U UPINIT, 193 creating a partition, 193 features, 193 options and arguments, 194 utility, 193 utilities disk partiti
