Dell™ OpenManage™ Deployment Toolkit Version 2.4 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 Notices NOTE: A NOTE indicates important information that helps you make better use of your computer. NOTICE: A NOTICE indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. ____________________ Information in this document is subject to change without notice. © 2007 Dell Inc. All rights reserved. Reproduction in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Contents 1 Introduction . What’s New . . . . . . . . . . . . . . . . . . . . . . . 9 . . . . . . . . . . . . . . . . . . . . . . . . 9 Requirements . . . . . . . . . . . . . . . . . . . . . . 10 . . . . . . . . . . . . . . . . . . . . . 10 . . . . . . . . . . . . . . . . . . . . . . 10 Toolkit Utilities Overview . . . . . . . . . . . . 10 RAID Configuration Utility . . . . . . . . . . . . . 10 RAC Configuration Utility . . . . . . . . . . . . . . 11 . . . . . . . . . . . . . . .
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 . 103 103 . . . . . . . . . . . 105 .
Enumerating Array Disks . . . . . . . . . . . . . . 141 Enumerating Virtual Disks . . . . . . . . . . . . . 146 . . . . . . . . . . . . . . . 149 Deleting Virtual Disks Assigning and Unassigning Global Hot Spares . . . . . . . . . . . . . . . . . . . . . 150 . . . . . . . . . . . 151 . . . . . . . . . . . . . 156 . . . . . . . . . . . . . . 157 Setting Environment Variables RAID Replication Options Miscellaneous Options . Quick Reference to RAIDCFG Commands . 5 UPINIT . . . . . . . . .
Description Input . . . . . . . . . . . . . . . . . . . . . 183 . . . . . . . . . . . . . . . . . . . . . . . . 184 Output . . . . . . . . . . . . . . . . . . . . . . . . Examples . . . . . . . . . . . . . . . . . . . . . . 186 getssninfo . . . . . . . . . . . . . . . . . . . . . 186 getsysinfo . . . . . . . . . . . . . . . . . . . . . . 188 getraclog . . . . . . . . . . . . . . . . . . . . . . 191 Synopsis . . . . . . . . . . . . . . . . . . . . . . 191 . . . . . . . . . . . . . . . .
B Messages and Codes . . . . . . . . . . . . . . SYSCFG Error Codes and Messages Failure Messages . . . . . . . . . . 311 . . . . . . . . . . . . . . . . . 311 UPINIT Common Error Codes and Messages Failure Messages . . . . . . 319 . . . . . . . . . . . . . . . . . 319 UPINIT Linux-Specific Error Codes and Messages . . 321 . . . . . . . 321 . . . . . . . . . . 321 . . . . . . . . . . . . . . . . . 321 UPINIT Windows PE-Specific Error Codes and Messages . . . . . . . . . . . . . . .
E Summary of SYSCFG and RAIDCFG Options . . . . . . SYSCFG Options RAIDCFG Options . . . . . . . . . . . 367 . . . . . . . . . . . . . . . . . . . . . 367 . . . . . . . . . . . . . . . . . . . . 391 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Index 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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.
Requirements For Windows PE, the DTK utilities support Windows PE version 2005 (released with Microsoft Windows Server® 2003, Service Pack 1 [SP1]). For embedded Linux, the DTK utilities can be run on Red Hat® Enterprise Linux® (version 4, update 4) 32-bit. Supported Systems For the list of Dell systems supported for this version of DTK, see the readme.txt file located at the root folder or the Dell Systems Software Support Matrix on the Dell Support website at support.dell.com.
RAC Configuration Utility The RACADM utility reports and sets RAC configuration options for Dell Remote Access Controller (DRAC) III (Linux only) and DRAC 4. NOTE: DRAC 5 is configured by SYSCFG. Disk Partitioning Utility The UPINIT script creates, formats, and populates a Dell Utility Partition. 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.
The following is the SYSCFG behavior during replication: • Options not available in SYSCFG are termed invalid options. If SYSCFG encounters an invalid option in the syscfg.ini file, the SYSCFG utility terminates. • Unsupported options are options available in SYSCFG but not applicable on certain systems. If SYSCFG encounters an unsupported option, SYSCFG logs this option and continues to the next option. For example, the virtualization option is not available on x8xx series systems.
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 or on the Dell Systems Documentation CD.
Introduction
Command Syntax Overview 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, predefined 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
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 Suboptions Valid Arguments --envar 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 NA or --outfile-o or -outfile Description This option 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. 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.
Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments --version* Description This option displays the version information, current time, and date for the utility. This option cannot be replicated. Example: A:>syscfg --version syscfg version 1.X.XX AXX © 2005 Dell Inc. All rights reserved. NOTE: The asterisk is not part of the command syntax. SYSCFG for BIOS Configuration SYSCFG uses BIOS interfaces to manipulate boot order and BIOS settings.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration Option Valid Arguments Description --acpower on, off, last This option sets the behavior for the system after AC power is lost. This option specifies how the 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 --asset This option reports or sets the customerprogrammable asset tag number for a system. The maximum length of an asset tag is 10 characters. Asset tag values cannot contain any spaces. This option is available on all supported systems. This value can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --bootseq numerical This option sets the boot order for a system. list, separated Without an argument, this option prints the boot by commas order list. The argument must be formatted as a comma-separated numerical list with no spaces. or The list must be within the bounds of the current list of device boot list, i.e.
Table 3-2. Option SYSCFG Options and Arguments for BIOS Configuration (continued) Valid Arguments Description Device 6:* usbfloppy.slot.1 - USB Floppy device NOTE: The asterisk indicates that the device is enabled in the BIOS. Device Name Examples Example of device names: nic.slot.1 (network adapter 1 in PCI slot) nic.emb.1 (network adapter 1 on system board) hdd.emb.0 (hard drive C:) cdrom.emb.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description 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 v1226 Device 6:* virtual.slot.2 VIRTUALFLOPPY DRIVE Device 2:* cdrom.emb.0 - IDE CDROM device Device 3:* hdd.emb.0 - Hard drive C: Device 5:* virtual.slot.1 VIRTUALCDROM DRIVE Device 1:* floppy.emb.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --conboot enable, disable This option configures or reports whether console redirection occurs after boot. This option is available on all supported systems that support console redirection. This option can be replicated. Example: A:>syscfg --conboot=enable conboot=enable --conred serial1, This option configures or reports the serial2, off, communication port for console redirection.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --devseq numerical This option sets the hard-drive sequence for a list, separated system. Without an argument, this option by commas displays the device list. The argument must be formatted as a comma-separated numerical list of or device index values. The list must be within the list of device bounds of the current boot list. For example, the names, low and high numbers must match.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description Example 2: A:>syscfg --devseq= hdd.emb.1,scsiraid.emb.1 The following devices are set in the disk device sequence:Device 1:* hdd.emb.0 - System BIOS boot devices Device 2:* scsiraid.emb.1 - AIC7899, A:00 Seagate NOTE: The asterisk indicates that the device is enabled in the BIOS. --embhypervisor off, on This option enables or disables the embedded hypervisor port.
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 embedded NIC on with PXE on, off, or on without PXE enabled. This option is only valid for supported systems that have an NIC. If the NIC is enabled without PXE, it is not found in the boot order. If the NIC is turned on with PXE, it is placed at the end of the boot order. The onnopxe argument is not supported on all systems.
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 embedded NIC on with PXE enabled, off, or on without PXE enabled. This option is only valid for supported systems that have three embedded NICs. If the second NIC is enabled without PXE, it is not found in the boot order. If the third NIC is turned on with PXE, it is placed at the end of the boot order.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --embnics on, off This option enables or disables both embedded NICs. This option is only present on systems that do not support the embnic1 and embnic2 options. This option can be replicated. Example: A:>syscfg --embnics=on embnics=on --embnic1pxe enable, disable This option enables or disables PXE on the first embedded NIC.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --embsataraid off, combined, ata, raid, qdma This option configures an embedded SATA RAID controller. This option can be replicated. off — disables the embedded SATA RAID controller. combined — sets the SATA RAID controller to combined mode. ata — sets SATA RAID controller to ATA mode. raid — sets SATA RAID controller to RAID mode.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --embscsiraid raid, off, scsi This option enables or disables the embedded SCSI RAID controller. This option is only valid for supported systems that have SCSI ROMB. Some systems do not support the scsi argument. This option can be replicated. NOTICE: If you change the controller from SCSI to RAID mode, data loss may occur. Backup any data you need to save before changing modes.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --extserial com1, com2, This option sets the behavior of the external serial rad connector. When set to com1, the BIOS maps the external serial connector to COM port 1. The com1 setting is the default. 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 --floppy auto, off, readonly This option sets the diskette drive controller to auto, off, or read-only. This option is available on all supported systems that have a supported diskette drive. This option can be replicated. Example: A:>syscfg --floppy=auto floppy=auto --fsbr 115200, 57600, 19200, 9600 This option sets the console redirection fail safe baud rate in bps.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --idecdrom auto, off This option enables or disables the CD drive. This option can be replicated. Example: A:>syscfg --idecdrom=auto idecdrom=auto --idracgui enable, disable Enables and disables the iDRAC GUI. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --ioat enable, disable This option enables or disables the I/O Acceleration Technology (I/OAT) DMA Engine option. This option must be enabled only if the hardware and software support I/OAT on your system. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --lpt lpt1, lpt2, lpt3, disable This option configures or reports the I/O address of the LPT (parallel) port. This option is available on all supported systems with an LPT port. This option is recorded to an output file for replication. Example: A:>syscfg --lpt=lpt1 lpt=lpt1 --lptmode ps2, at This option configures or reports the mode of an LPT (parallel) port.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --mouse off, on This option turns the mouse controller on or off. This option can be replicated. Example: A:>syscfg --mouse=off mouse=off --nextboot valid device name (from the --bootseq option device list) This option sets the specified device as the first device in the boot order for the next boot cycle only. The device must be a device from the --bootseq option device list.
Table 3-2. Option SYSCFG Options and Arguments for BIOS Configuration (continued) Valid Arguments --noraidprompt* NA Description 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. Without this option, the user is prompted during POST to confirm the change of a RAID controller from RAID(SCSI) to SCSI(RAID). This option is not replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --oldsetuppwd This option is required to set a new setup password when a setup password is currently set. The setup password locks the BIOS setup screen. The argument string supplied to this option is the current password. If this password is not correct, the new setup password is not applied to the system.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --oldsyspwd This option supplies the current system password for the BIOS. This option is only given when setting the new system password. If this password does not match the current system password, the new password is not applied to the system. The system password is required when booting the system. The argument string supplied to this option will be the password.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --osmode enable, disable This option enables or disables operating system installation mode for installing operating systems. Enabling this option causes the BIOS to only report 256 MB to the operating system. Some operating systems cannot be installed if a system has more than 2 GB of memory. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --powerbutton enable, disable This option enables or disables the power button for a system. This option is recorded to an output file for replication. This option is available on all supported systems. Example: A:>syscfg --powerbutton=enable powerbutton=enable NOTE: The system must be rebooted for BIOS options to take effect. --pwdlock lock, unlock This option locks the system password.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --sata0 auto, off This option enables or disables SATA port 0. This option can be replicated. 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 --sata4 auto, off This option enables or disables SATA port 4. This option can be replicated. Example: A:>syscfg --sata_4=auto sata_4=auto NOTE: This option maps to --sata_e for PowerEdge x9xx systems. --sata5 auto, off This option enables or disables SATA port 5. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --snoopfilter enable, disable This option enables or disables the snoop filter option from the system BIOS. Example: A:>syscfg --snoopfilter=enable snoopfilter=enable --speaker on, off This option turns the built-in speaker on or off. This option can be replicated. NOTE: The --speaker option is not supported on certain PowerEdge systems.
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 the serial port communication. When set to on, this option tells the BIOS to enable 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 --setuppwd This option sets the setup password for the BIOS. The setup password locks the BIOS F2 screen. The argument string supplied to this option is the password. Generally, passwords are limited to alphanumeric characters and cannot exceed 32 characters in length. If a current setup password is set, it must be given through the --oldsetuppwd option.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --sma enable, disable This option enables or disables processor sequential memory access. Example: A:>syscfg --sma=disable sma=disable --svctag* NA This option reports the service tag for a system. If the system is modular, it displays the service tag for PowerEdge 1855. If used with the -s general option, the environment variable is set to the service tag.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --syspwd This option sets the system password for the BIOS. The system password is required when booting the system. The argument string supplied to this option is the password. Generally, passwords are limited to alphanumeric characters and cannot exceed 32 characters in length. If a current system password is set, it must be given through the --oldsyspwd option.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --usb on, legacy, off This option sets or reports the status of the USB port. When set to on, USB keyboards and mice function only for systems with operating systems that have native USB support. When set to legacy, USB keyboards and mice are supported through the BIOS to function in operating systems that do not natively support USB. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --virtualization enable, disable This option enables or disables virtualization in the CPU. When set to enable, it enables the additional hardware capabilities provided by Virtualization Technology in applicable CPUs. When set to disable, it disables the additional hardware capabilities provided by Virtualization Technology. This option can be replicated.
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 Arguments --tpmactivation enabled Description Enables and activates the TPM feature. disabled Disables and deactivates the TPM feature. nochange Does not alter the operational state of the TPM feature. Example: A:>syscfg tpm -tpmactivation=enabled -setuppwdoverride NOTE: You cannot set tpmactivation when tpmsecurity is set to off.
Table 3-3. Suboptions and Arguments for the tpm Option (continued) Option Suboption --valsetuppwd Arguments Description Validates the setup password for TPM authentication. If you try to change DTK settings, you will be prompted to enter this password to access the settings.
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-4. BMC and Remote Access Controller Configuration Options Options Suboptions Valid Arguments bmcversion Description Displays the version information for the BMC and the BMC firmware. This option cannot be replicated. --devid NA Reports the BMC device ID. --devrevision NA Reports the BMC device revision. --majorfwrevision NA Reports the BMC device major firmware revision. --minorfwrevision NA Reports the BMC device minor firmware revision.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --clearsel* NA NA Clears the SEL. This option cannot be replicated. 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. Example: A:>syscfg -deviceguid deviceguid= XXXXXXXXXX NOTE: The asterisk is not part of the command syntax.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --encryptkey NA Encrypts the IPMI sessions. The hexadecimal number entered as an argument is not case sensitive although the value returned by the encryptkey option is always in uppercase. The value returned is appended with zeroes so that it is always 40 characters long.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --pefalerting enable, disable Enables or disables PEF alerts. This suboption can be replicated. --ipmioverlan disable, alwaysavail Sets the LAN channel access mode. This suboption can be replicated. --channelprivlmt user, operator, administrator Sets the maximum privilege level accepted for the LAN channel. This suboption can be replicated.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments lancfgparams or lcp Description Configures and displays LAN configuration parameters. This option can be replicated. --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.
Table 3-4. Options 70 BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --commstring Sets the community string (maximum of 16 printable ASCII characters) used in a platform event trap (PET). This suboption can be replicated. --destipaddr Sets the destination IP address for the alert destination specified with the alertdest suboption. The destipaddr suboption is dependent on the alertdest suboption.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --vlanpriority 0–7 Sets the VLAN priority value. This suboption can be replicated. --macaddress NA Displays the BMC MAC address. This suboption cannot be replicated. --nicselection shared, sharedfailover, dedicated Sets the operating mode of the NIC to shared/sharedfailover/d edicated. Some of these options are not applicable on certain systems.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --dnsregisterrac enable, disable Enables or disables binding of the RAC name to the IP address. --dnsracname Sets the name of the RAC. -enable, disable domainnamefromdhcp Enables or disables getting the RAC domain name through DHCP. --domainname Sets the domain name of the RAC.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description Example 2 (to set the LAN configuration parameters): A:>syscfg lancfgparams --destipaddr= 192.168.100.15 --vlantag=enable --vlanid=1000 --vlanpriority=7 --commstring= public --ipaddrsrc= static --ipaddress= 192.168.100.10 --subnetmask= 255.255.255.0 --gateway= 192.168.100.1 lancfgparams destipaddr= 192.168.100.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments lanuseraccess or lua Description Configures the privilege level and channel accessibility 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-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments -NA useridswithfixednames Description Reports the number of User IDs with fixed names on the LAN channel.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions --loaddefaults* NA Valid Arguments Description 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. 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-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --nextboot NA valid device name (from the --bootseq option device list) This option sets the specified device as the first device in the boot order for the next boot cycle only. The device must be a device from the --bootseq option device list. Run the --bootseq option to see a list of available device names. See --bootseq for more information. This option is not replicated.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description 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. This option can be replicated.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments passwordaction Description Configures and tests the password for the specified User ID. This option cannot be replicated. All three suboptions, action, userid, and password, must be included in the command line. --userid 2–10 if your system has a DRAC 4 controller Specifies the BMC User ID. This suboption cannot be replicated.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description 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 80 SYSCFG Configures and displays PEF configuration parameters. This option can be replicated.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions 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-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --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 (.). The length of the -hostname string must be 48 characters or less for x8xx systems and 62 characters or less for x9xx systems and later.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions 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-4.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --powerbutton NA enable, disable This option enables or disables the power button. This option can be replicated.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --powerctl NA powerdown This option performs a chassis powerdown and controls the reset 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. softshutdown In Linux, the system shuts down immediately.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments -serialchannelac cess or sca Description Sets or displays the channel access settings for the serial channel. This option can be replicated. --ipmioverserial disable, alwaysavail Sets the serial channel access mode. This suboption can be replicated. --channelprivlmt user, operator, administrator Sets the maximum privilege level accepted for the serial channel.
Table 3-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments -serialchannelinfo or sci Description Displays media and protocol information about the serial 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-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments serialcfgparams or scp Description Configures and displays serial configuration parameters. This option can be replicated. --connectionmode basic, terminal Sets the connection mode used to perform IPMI messaging to the BMC. This suboption can be replicated. --msgcommflowctrl noflowctrl, rtscts Sets the IPMI message communication flow control. This suboption can be replicated.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --tmcfgechoctrl echo, noecho Sets the echo control value for terminal mode configuration. This suboption can be replicated. --tmcfghandshakectrl enable, disable Sets the handshake control value for terminal mode configuration. This suboption can be replicated. --tmcfgnewlineseq noterm, crlf, null, Sets the new line cr, lfcr,1f sequence value for terminal mode configuration.
Table 3-4.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --userid 2–10 if your system has a DRAC 4 controller Sets the User ID. This suboption can be replicated. 2–16 if your system has a DRAC 5 controller --usrprivlmt 92 user, operator, administrator, noaccess Sets the maximum BMC user privilege level for the serial channel for the User ID specified using the userid suboption. This suboption can be replicated.
Table 3-4.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments solaction Description This option enables or disables Serial-OverLAN (SOL) 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-4. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments solcfgparams Description Configures and displays SOL configuration parameters. This option can be replicated. --solenable enable, disable Enables or disables whether the SOL payload type can be activated. This option can be replicated. --solprivlevel user, operator, administrator Sets the minimum user privilege level required to activate the SOL. This option can be replicated.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments --solcharsendthreshold 1–255 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-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description --solbitrate 9600, 19200 Sets the serial 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. If an argument valid for a particular generation is entered for another generation, the ‘Parameter out of range’ error is displayed.
Table 3-4.
Table 3-4.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments ssninfo Description Displays information about the number of possible active sessions and the number of currently active sessions on all channels on the BMC. This option cannot be replicated. --maxactivessns NA Displays the maximum possible active BMC sessions. This suboption cannot be replicated.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments useraction Description Enables and disables BMC, sua, and lua user IDs. This option can be replicated. --userid 2–10 if your system has a DRAC 4 controller Specifies the BMC user ID. This suboption can be replicated. 2–16 if your system has a DRAC 5 controller --action enable, disable Enables or disables the user ID specified using the userid suboption. This suboption can be replicated.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments username Description Sets the BMC User ID and username. This option can be replicated. --userid 2–10 if your system has a DRAC 4 controller Specifies the User ID. This suboption can be replicated. 2–16 if your system has a DRAC 5 controller --name Sets the username (maximum of 16 printable ASCII characters) for the User ID specified using the userid suboption.
Table 3-4. Options BMC and Remote Access Controller Configuration Options (continued) Suboptions Valid Arguments Description 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-5. 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-6 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 predefined arguments are lowercase unless stated otherwise.
Table 3-6. 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-6. 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-6. 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-6. 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-6. Option SYSCFG Options and Arguments for System Configuration (continued) Valid Arguments Description Slot: None 00 Class: 06 - Bridge SubClass: 00 - CPU/PCI Example 2 (the pci.
Table 3-6. Option SYSCFG Options and Arguments for System Configuration (continued) Valid Arguments Description None Example 3 (a pci.
Table 3-6. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --slot* None This option reports the slot of a modular system. If the system is not modular, the slot is reported as 0. If used with the -s option, the environment variable is set to the slot. Example 1 (for a modular system): A:>syscfg --slot slot=1 Example 2 (for a non-modular system): A:>syscfg --slot slot=0 NOTE: This option is valid for PowerEdge 1855 servers only.
Table 3-6. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --sysid* None This function command reports the unique system id bytes for a server. Servers contain a unique ID value based on their model. The ID value is reported as a hexadecimal value with a leading 0x, lowercase hexadecimal letters, and zero-padded to 2 bytes. If used with the -s general option, the environment variable is set to the system ID.
PCI Reporting The scan of the PCI bus will use a file to resolve PCI vendor and device codes to vendor information strings. The format of the PCI output is as follows: PCI Bus: 2, Device: 4, Function: 0 Vendor: 8086 - Intel Corp. Device: 1229 - 82557/8/9 [Ethernet Pro 100] Sub Vendor:8086 - Intel Corp.
Environmental Variable File Excerpt (sys.ini) [DELLNIC] ;environment variable will be set to INTELPRO100F for vendor 8086, dev 1001 8086,1001=INTELPRO1000F ;environment variable will be set to INTELPRO100T for vendor 8086, dev 1004 8086,1004=INTELPRO1000T ;environment variable will be set to INTELPRO100XT for vendor 8086, dev 1008 8086,1008=INTELPRO1000XT The names of the environment variables can be changed in the Variable Names section.
SYSCFG
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.
• SAS 6iR Integrated, SAS 6iR Adapter • PERC 6/E Adapter, PERC 6/i Integrated, PERC 6/i Adapter RAIDCFG Dependencies For the RAIDCFG utility to run successfully in Windows PE, it requires that the mr2kserv utility is located in the same directory as RAIDCFG. The RAIDCFG utility also requires that lsivil.dll (for Windows) or lsivil.so (for Linux) and sasvil.dll (for Windows) or sasvil.dll (for Linux) be in the same directory as RAIDCFG.
Table 4-1. RAIDCFG Short and Long Format Options Option Valid Arguments Short Description Mandatory or Optional No option NA Displays general usage information for the utility. The usage information consists of a comprehensive list of valid options, parameters, and arguments. Optional. See Table 4-4 for specific usage information. -h -? or See Table 4-2 for specific usage information. /? -ac cvd Creates a virtual disk.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -ad ch:targ, ch:targ, ... Specifies an array disk. or or ch:targ:lun,... adisk or ch:targ:enc -c Specifies a RAID controller. d, c Specifies the virtual disk cache policy. Optional. Optional. For SCSI controllers, the value of lun See Table 4-5 for specific should always be 0.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description -envn Sets the environment variable See Table 4-9 () that equates to the value for specific returned from a function call. usage information. or envname -fd or failoverdrive -i -l Mandatory or Optional ch:targ, ch:targ, ... Specifies the location of the failover or ch:targ:lun,... drive in an array. Optional.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments -r Valid RAID values are 0, 1, 5, 10, 50. or raid Short Description If no value is specified for RAID, 0 is taken as the default level. -rp or NA Mandatory. setenvironme nt Sets a user-defined environment variable to the value returned from the function call.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -sp The span size of RAID 5, which is a mandatory parameter for RAID 50. Mandatory. or NOTE: Spanlength is applicable only spanlength -ssz for RAID 50. The minimum permissible spanlength value is 3. The number of array disks for creating virtual disks should not be a prime number and should be divisible by the specified spanlength.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -wp wb, wt, wc, nwc Sets the write policy for a virtual disk. The valid arguments are: wb (writeback caching), wt (write-through caching), wc (writecaching), and nwc (no-write-caching). Optional. or writepolicy See Table 4-12 for specific usage information.
Table 4-2. General Help Options Parame Valid Description ters Arguments No option NA -? Displays general usage information for the utility. The usage information consists of a comprehensive list of valid options, parameters, and arguments. This option is optional and can be added to the command line in any order. or Example: /? A:>raidcfg -h -h NA Provides users with general help options that may be used with this utility. [raidcfg] Version 2.
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. Example: Controller_ID/Slot_ID: 0 Controller_PCI_ID: 2:14:0 Controller_Name: PERC 4e/Di Channels: 2 No.
Table 4-3. Enumerating RAID Controllers (continued) Mandatory Optional Valid Description Options and Paramet Parameters Arguments ers Arguments -c rid or Displays the properties for the RAID controller with the specified controller ID. This option combination is mandatory.
Table 4-4. Creating Virtual Disks Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -ctrl -ac=cvd NA -c=id -ad= ch:targ,ch:targ, ... [or ch:targ:encl,...] or controller action= createvdisk controllerid= id adisk= channel:target: lun,... channel:target: lun,... [or channel:target: enclosure,...] 128 RAIDCFG NA Creates a virtual disk comprising the properties supplied. This option combination is mandatory.
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments -cp 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 be added to the command line in any failoverdrive or ch:targ:lun,... order after the mandatory option or ch:targ:enc combination. channel:target, NOTE: From DTK 2.
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,...] 136 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. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Description Parameters Arguments • For PERC 5 controllers: RAID 0: 100MB RAID 1: 100MB RAID 5: 100MB • For PERC 6 controllers: RAID 0: 100MB RAID 1: 100MB RAID 5: 100MB RAID 6: 100MB RAID 60: 100MB NOTE: If this option is not provided, RAIDCFG will determine the maximum possible virtual disk size and create it. RAID 10, RAID 50, and RAID 60 do not accept this option.
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.
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.
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 Valid Description Parameter Arguments -ad -c=id -ad= arg,... controllerid= channel:tar id vdisk=id get, channel:tar get,... or Displays information about the specified array disk. This option combination is mandatory.
Table 4-6. Enumerating Virtual Disks Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments Description -vd NA Lists the virtual disks for each controller along with the array disks that make up each virtual disk. This option is mandatory.
Table 4-6. Enumerating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments -vd -c or or vdisk Description displayed with the physical disk that controller comprises it. The -c option is optional and id can be added to the command line in any order after the mandatory option.
Table 4-6. Enumerating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameter Arguments Description -vd -c=id -vd or or Displays details about a single virtual disk under the indicated controller. The -vd -c= id option combination is mandatory. The second -vd option is optional and can be added to the command line in any order after the mandatory option combination.
Table 4-7. 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.
Table 4-8. 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. Example: A:>raidcfg -ctrl -ac=sghs -c=2 -ad=0:1,0:2 RAIDCFG command successful! -ctrl ac=rghs NA -c=id -ad|pd= ch:targ:encl,c h:targ:encl NA Unassigns all global hot spares to disks on the specified controller.
Table 4-9. 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-9. Setting Environment (continued) Mandatory Options and Arguments Optional Valid Description Parameter Parameter Arguments -se -envn= NA envc= c=id NA or setenvironme nt envname= envcommand = controllerid= id Sets a user-defined environment variable to the value returned from the getfirmware, getcontrollertype, getadisks, getadiskcount, getfreeadisks, getfreeadiskcount, getfreeadisksize, or gethotspares function call.
Table 4-10. Function Calls of the setenvironment Option (continued) Function Call Description getcontrollertype Returns LSI for LSI controllers and ADAP for Adaptec controllers. Example: A:>raidcfg -se -envn=CONTROLLERTYPE -envc= getcontrollertype -c=2 CONTROLLERTYPE=LSI RAIDCFG command successful! getadisks Returns the array disks attached to the controller.
Table 4-10. Function Calls of the setenvironment Option (continued) Function Call Description gethotspares Returns the global hot spares (global failover disks) found on the specified controller. Example: A:>raidcfg -se -envn=HOTSPARES -envc= gethotspares -c=2 HOTSPARES=1:8:1,1:9:1 RAIDCFG command successful! getfreeadisks Returns the free array disks.
RAID Replication Options Table 4-11 lists the RAID replication options. Table 4-11. 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-11. 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.ini file contains the following section: [GlobalHotspare0] controllerid=0 failoverdrive=0:8:0 Miscellaneous Options Table 4-12 lists all other RAIDCFG options, parameters, and predefined arguments.
Table 4-12. 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. This option is optional and can be added to the command line in any order after the mandatory options have been added. Example: A:>raidcfg -ctrl -l=log.
Table 4-12. 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 NA or version Displays the version number of the RAIDCFG utility.
Table 4-13. Basic RAIDCFG Commands (continued) Purpose Command Description To list all the disks raidcfg adisk - Lists all the disks attached to the attached to a particular c=slotid controller. The slot ID is obtained controller from the first command. Note the drive location of the disks. You will need this information later. To create a virtual disk with all the default settings raidcfg -ctrl - Creates a virtual disk of maximum ac=cvd -c= available size for type RAID 0.
Table 4-13. Basic RAIDCFG Commands (continued) Purpose Command Description 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. The slot ID in <-c=slotid> and the array disks in <-ad=...> are obtained from the first two commands. The option <-fd> stands for failover drive and requires the drive location of the drive you want the dedicated hot spare to be in.
Table 4-13. 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.
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. In Linux, you can find it in /opt/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 © 2005 Dell Inc. All rights reserved This utility creates a utility partition for your system.
Table 5-1. Option UPINIT Options and Arguments (continued) 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. Option UPINIT Options and Arguments (continued) Valid Arguments Description 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. The --size option is not required when using the --overwrite option because the --overwrite option does not resize an existing Dell Utility Partition.
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
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 NA clrsel Clears RAC system event log (SEL). NA config Configures the RAC. See "config/getconfig" for more information about the subcommand options and arguments. NA coredump Displays the last RAC coredump. NA coredumpdelete Deletes the last RAC coredump. NA 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 NA 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. NA 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 NA setrac Sets RAC parameters from the managed system. See "setrac" for more information about the subcommand options and arguments. NA serveraction Performs system power management operations. NA setniccfg Modifies the network configuration properties. NA sslcertupload Uploads an SSL (Secure Socket Layer) certificate to 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.
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 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/getconfig Subcommands Command Definition config Configures the RAC. getconfig Gets the RAC configuration data.
Input Table 6-7. config Subcommand Options Option Description -f The -f option causes config to read the contents of the file specified by and configure the RAC. The file must contain data in the format specified in "Parsing Rules." -p The -p, or password option, directs config to delete the password entries contained in the config file -f after the configuration is complete. -g The -g , or group option, must be used with the -o option.
getconfig Subcommand Description The getconfig subcommand allows the user to retrieve RAC configuration parameters on an individual basis, or all the configuration groups may be retrieved and saved into a file. Input Table 6-8. getconfig Subcommand Options Option Description -f The -f , or filename option, causes getconfig to create the file . It then reads all the configuration data from the RAC and places it into the file .
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 displays the contents of the specified configuration. Examples • racadm getconfig -g cfgLanNetworking Displays all of the configuration parameters (objects) that are contained in the group cfgLanNetworking.
fwupdate NOTE: To use this command, you must have Configure DRAC 4 permission. Table 6-9 describes the fwupdate subcommand. Table 6-9. fwupdate Subcommand Definition fwupdate Updates the firmware on the Dell Remote Access Controller (DRAC 4).
Input Table 6-10 describes the fwupdate subcommand options. NOTE: The -p and -u options are not supported for the serial/telnet console. Table 6-10. fwupdate Subcommand Options Option Description -u The update option performs a checksum of the firmware update file and starts the actual update process. If this option is typed by itself, it is assumed that a firmware update file has already been loaded into the RAM disk using the -g or -p options. This option may also be used along with the -g or -p options.
Table 6-10. fwupdate Subcommand Options (continued) Option Description -D After the update is complete, the DRAC 4 is reset. Upon boot, a call is made to reset all firmware configuration parameters to the default values. For more information, see "racresetcfg." -p The -p, or put, option is used when you want to FTP the firmware update file from the managed system to the DRAC 4. If the -f option is used, the name of the update image must be firming.dm1.
• racadm fwupdate -u The -u option starts the update process. This command assumes that a valid firmware update file has been previously loaded using the -g or -p option. The update file checksum is verified for correctness before proceeding. • racadm fwupdate -g -u -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).
Synopsis racadm getssninfo [-A] [-u | *] Description The getssninfo command returns a list of currently active or pending users and optionally includes summary session table information. The summary information provides the total number of sessions in each of the following defined Session Manager states: • Free • Preliminary • Unvalidated • Valid • Invalid Input Table 6-12. getssninfo Subcommand Options Option Description -A The -A option eliminates the printing of data headers.
Type User IP Address Login Consoles --------- ------- ------------- Date/Time --------------------Web • RAC root 192.168.1.23 racadm getssninfo Thu, 06 Mar 2003 10:32:39 GMT-06:00 NONE -A 1 15 "Web" "RAC\root" 192.168.1.23 "Thu, 06 Mar 2003 10:32:39 GMT-06:00" "NONE" • racadm getssninfo -A -u * "Web" "RAC\root" 192.168.1.23 "Thu, 06 Mar 2003 10:32:39 GMT-06:00" "NONE" getsysinfo Table 6-13.
Input Table 6-14. getsysinfo Subcommand Options Option Description -d Displays RAC information. -s Displays system information. -w Displays watchdog information. -A Eliminates the printing of headers/labels. -c Displays chassis information. If a -d, -s, or -w option is not specified, then these three options are used as defaults.
The following bullet items define the mapping of values to strings: Table 6-15.
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.60 Watchdog Information: Recovery Action = Power Down Present countdown value = 36 Initial countdown value = 40 getraclog NOTICE: 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.
Description NOTE: The command name and the racadm subcommand names may be different. This behavior is normal. The getraclog -i command displays the number of entries in the DRAC 4 log. The following options allow the getraclog command to read entries: • -A — Provides API-formatted output (no header). • -c — Provides the maximum count of entries to be returned. • — Displays the entire log; racadm and serial only (default).
Synopsis racadm gettracelog -i racadm gettracelog -m Description The gettracelog -i command displays the number of entries in the DRAC 4 trace log. The gettracelog command (without the -i option) reads entries. The -m option displays 24 rows at a time, and queries for more (such as the UNIX more command). Output One line of output is displayed for each trace log entry. help Table 6-18.
racadm help displays usage information for the specified subcommand only. racdump Table 6-19. racdump Subcommand Command Definition racdump Displays status and general RAC information. Synopsis racadm racdump Description The racdump subcommand provides a single command to get a dump, status, and general RAC board information with a single command.
Synopsis racadm racreset [hard | soft | graceful] [delay] Description The racreset subcommand issues a reset to the RAC. The user is allowed to select how many seconds of delay occur before the reset sequence is started. The reset event is written into the RAC log. 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.
Output None 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.
Output None 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.
Table 6-24. setrac Subcommand Options (continued) Option Description -d The -d, or display option, allows the user to get the UTC time, Hostname, OS Name, and OS Type from the managed system and display these items only. Parameters are not written to the RAC. If the -d option is entered along with other options, then those parameters are displayed only. 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.
DRAC III, DRAC 4, and DRAC 5 Property Database Group and Object Definitions The Dell Remote Access Controller (DRAC) III, DRAC 4, and DRAC 5 property database contain the configuration information for the DRAC III, DRAC 4, and DRAC 5 controllers respectively. Data is organized by associated object, and objects are organized by object group. The IDs for the groups and objects that the property database supports are listed in this section.
Table A-1. DRAC III Object Groups and Objects Object Group Objects Description Valid Values Default idRacType Identifies the type of RAC. This object has read-only attributes. 0=invalid, 0x3 or 1=other, 2= 0x4 unknown, 3=DRAC III, 4=all other RACs idRacProductInfo Identifies the product using a text string. This object has read-only attributes. String of up RAC to 63 ASCII characters. idRacDescriptionInfo A text description of the String of up RAC RAC type.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default idRacMisc Generic property String of up Null undefined at this release. to 63 ASCII string This object has read/write characters. attributes. cfgMonitorExtPwrScrRule 0=disable, do not monitor 0x0, 0x1, or the external power source. 0x2 cfgMonitor The cfgMonitor group contains parameters to configure the monitoring of the optional external AC power adapter and the onboard battery.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgNicIpAddress IP address of the RAC network adapter. This object has read/write attributes. A string of "." 192.168.2 separated 0.1 numeric fields containing the static IP address. cfgNicNetmask The network mask used by the RAC network adapter. This object has read/write attributes. A string of "." 255.255.2 separated 55.0 numeric fields containing the static network mask.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgNicCurrentIpAddress The current IP address of the RAC network adapter. This object has read-only attributes. A string of "." None separated numeric fields containing the IP address. cfgNicCurrentNetmask The current network mask used by the RAC network adapter. This object has read-only attributes. A string of "." None separated numeric fields containing the network mask.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default 0=enable Boolean, 1 either 1 or 0 (TRUE or FALSE). cfgDialupNetworking This group contains parameters to configure the capabilities of the DRAC III dial-in and dial-out (demand dial). cfgDialupDialInEnable 1=disable the dial in capabilities. This object has read/write attributes. cfgDialupDialOutEnable 0=enable 1=disable the dial out capabilities. This object has read/write attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgDialupDialInBaseIp Addr Description Valid Values Default Static IP base address for PPP. When static addresses are enabled, two IP addresses are used. The first is the base, and the second is base+1. When the base IP address is 0.0.0.0, cfgDialupDialInDfltIpA ddr is used instead. A string of "." 0.0.0.0 separated numeric fields containing the IP address. This object has read/write attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgDialupDiMaxConnect Time Description Valid Values Default 0=infinite, otherwise, the Hexadecimal 0x0 maximum time in seconds values. that the link will stay connected before the connection is terminated. This object has read/write attributes. cfgDialupDialType 0x0=pulse, 0x1=tone cfgDialupModemInitStr ing A command string passed to the modem to initialize it. This object has read/write attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgRemoteHosts The group contains parameters to configure various firmware update loading, remote floppy boot, IP addresses, enables, and so on. cfgRhostsSmtpEmailEna ble 0=disable, 1=enable the Boolean, 1 SMTP protocol to send e- either 1 or 0 mail alerts. (TRUE or FALSE). This object requires a RAC reset before it becomes active. This object has read/write attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgRhostsSmtpServerIp Addr Description Valid Values Default The IP address of the server used in e-mail alerts. A string of "." 127.0.0.1 separated numeric fields containing the IP address. This object requires a RAC reset before it becomes active. This object has read/write attributes. cfgRhostsFloppyTftpIp Addr The IP address of the TFTP server where the boot image is located.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgRhostsFwUpdatePath Description Valid Values Default The path name pointing to the firmware update binary file. If this is a filename only, then the path needs to be specified in the TFTP server. Otherwise, the entire path can be specified here. String of up FIRMIM to 255 ASCII G.BIN characters that designate a valid path name. This object has read/write attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgUserAdminAlertFilter RacEventMask Description Valid Values Default See "RAC-Generated Hexadecimal 0x777777 Event Mask Definitions" values. in the Dell Remote Access Controller Racadm User's Guide. This object has read/write attributes. cfgUserAdminAlertFilter SysEventMask See "RAC-Generated Hexadecimal 0x777777 Event Mask Definitions" values. in the Dell Remote Access Controller Racadm User's Guide.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgUserAdminPageNume ricMessage Description Valid Values Default A string of digits consisting of the following: 0-9, SENI. In the numeric message, S will be replaced by the decimal value of the message severity. The E is replaced by the threedecimal digit event number. The N is replaced by the two-decimal digit sensor number. The I is replaced by the IP address of the RAC (dotteddecimal notation with the dots deleted).
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgUserAdminPageAlpha Protocol Description Valid Values Default Number of data bits, N= no parity, E=even parity, number of stop bits. 8N1 or 7E0 8N1 This object has read/write attributes. cfgUserAdminPageAlpha BaudRate Baud rate for the modem. Integer from 0x4B0 or This object has read/write 0 to 115200. 1200 attributes. cfgUserAdminPageAlpha CustomMsg User-defined message to be sent on an alpha page.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgUserAdminEmailAddr ess Description Valid Values Default Standard e-mail address, such as john_doe@mycompany.co m. A string of up to 63 ASCII characters. "" This object has read/write attributes. cfgUserAdminEmailCust omMsg User-defined message to be sent on a e-mail alert. A string of up to 31 This object has read/write ASCII characters. attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgTrapsFilterRacEvent Mask Description Valid Values Default See "RAC-Generated Hexadecimal 0x777777 Event Mask Definitions" values. in the Dell Remote Access Controller Racadm User's Guide. This object has read/write attributes. cfgTrapsFilterSysEvent Mask See "RAC-Generated Hexadecimal 0x777777 Event Mask Definitions" values. in the Dell Remote Access Controller Racadm User's Guide. This object has read/write attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgDemandDialPppUser Name User name for PPP authentication. This object has read/write attributes. A string of up to 31 ASCII characters. "" cfgDemandDialPppPass word Password for PPP authentication. This object has read/write attributes. A string of up to 31 ASCII characters.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgDialinUsrCallbackNu mber Description Valid Values Default Administrative preset telephone number for CBCP if a 1 is selected in cfgDialinUsrCallbackTyp e. A string of up to 95 ASCII characters. "" This object has read/write attributes. cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to the RAC.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgSerialBaudRate Sets the baud rate on the external serial port. This object has read/write attributes. 9600, 28800, 9600 57600, 115200 cfgSerialConsoleEnable 0=disabled, 1=enabled Boolean, cfgSerial This group contains configuration parameters for the system external serial port or DRAC III VT-100 serial connector.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgSerialConsoleIdleTim eout Description The maximum amount of 0x12c line idle time (in seconds) before the line is disconnected. This object has read/write attributes. 218 Valid Values Default Integer from 1 to any positive number.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgSerialConsoleShellType Description Valid Values Default This object has read/write 1=DRAC III 1 attributes. style VT-100 block screen interface; has limited command function compared to type 2 2=UNIX®style command line data stream interface. 3=dial-in to UNIX-style command line data stream interface. 4=PPP dialin through an external modem. (An external modem must be attached to the external serial port.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgSerialConsoleNoAuth Description Valid Values Default Allows you to disable authentication on serial shell. This object has read/write attributes. 0=log-in prompt is Enabled on the serial shell. 0 1=log-in prompt is Disabled on serial shell. cfgSerialConsoleComma nd The serial command runs after login at the start of a session and allows you to set up a command such as connect com2 that autoruns when a session begins.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgSerialTelnetColor Description Valid Values Default Enables/disables the Telnet text console color when connecting using the connect video command. 0= 1 monochrom e, 1=color This object has read/write attributes. cfgSerialTelnetAnsi Enables/disables the Telnet text console ANSI graphics mode when connecting using the connect video command. 0=VT-100 graphics mode, 1= ANSI graphics This object has read/write mode.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgNetTuningTcpSrttBase The smoothed round trip Integer from 0x0 (0) time-out base minimum 0 to 256. value for TCP round trip retransmission time in ½ second units. This object has read/write attributes. cfgNetTuningTcpSrttDflt The smoothed round trip Integer from 0x6 (6) time-out base default 6 to 384. value for TCP retransmission round trip time in ½ second units.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgOobSnmp The group contains parameters to configure the SNMP agent and trap capabilities of the RAC. cfgOobSnmpTrapsEnable 0=disable, 1=enable transmission of SNMP traps. cfgOobSnmpAgentEnable 0=disable, 1=enable the RAC SNMP agent. Boolean, 1 either 1 or 0 (TRUE or This object has read/write FALSE). attributes. Boolean, 0 either 1 or 0 This object has read/write (TRUE or FALSE).
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgRacTuneGenericFtp Passwd The user password. This object has read/write attributes. A string of up to 15 ASCII characters. cfgRacTuneRemoteCrs Port The port connection from the browser to the firmware console redirection server. This object requires a RAC reset before it becomes active. Integer from 0Validx4 5900 to any 5B86000 positive valid or 5900 port number.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgRacTuneDialOutMax ConnectTime Description Valid Values Default 0=infinite, otherwise, Integer from 0x0 maximum time in seconds 1 to 128. that the link will stay connected before the connection is terminated. This object requires a RAC reset before it becomes active. This object has read/write attributes. cfgRacTuneD3debugEna ble 0=disable, 1=enable the RAC debug command.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects cfgRacTuneMnConsole DisableAllowed Description Valid Values Default This command is applicable only to Microsoft® Windows® 2000 and Windows Server® 2003 operating systems. When TRUE, a user performing remote console redirection through the RAC Webbased remote access interface can disable the managed system’s keyboard and mouse. When FALSE, the managed system’s keyboard and mouse cannot be disabled.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default ifcRacMnOsOsName The operating system name of the managed system. This object has read/write attributes. A string of any ASCII characters. ifcRacMnOsOsType See the getsysinfo Not usercommand. This object has writable read-only attributes. 0 cfgRacSecCapabilities The current RAC security 0x1ff capability setting. This object has read-only attributes.
Table A-1. DRAC III Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgRacSecCsrCountryCo de The CSR country code. The twoThis object has read/write letter attributes. country code. "" cfgRacSecCsrEmailAddr The CSR e-mail address. A string of This object has read/write any ASCII attributes. characters. "" cfgRacSecVncInEncrypt Enable FALSE=disable, TRUE= Boolean, TRUE enable either 1 or 0 (TRUE or Enables VNC (virtual FALSE).
DRAC 4 Object Groups Use the following syntax to configure DRAC 4 controllers: racadm getconfig -g -o For example, to enable the DRAC 4 NIC, type: racadm config -g cfgLanNetworking -o cfgNicEnable 1 Table A-2 lists the object groups for DRAC 4, a brief description of the objects, and valid values for these objects. Table A-2.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default idRacName A user assigned name to String of up to RAC identify this controller. 15 ASCII This object has read/write characters. attributes. idRacMisc Generic property String of up to Null string undefined at this release. 63 ASCII This object has read/write characters. attributes. idRacType Identifies the remote access controller type as the DRAC 4. This object has read-only attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgDNSRacName Displays the RAC name, which is RAC-service tag (by default). This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE). cfgDNSRegister Rac Registers the DRAC 4 name on the DNS server. This object has read/write attributes. Boolean, either 1 or 0 (TRUE or FALSE). 0 cfgDNSServersFr omDHCP Retrieves DNS server addresses from the DHCP server.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgNicEnable Description Valid Values Default 0=Disable. Boolean, either 1 or 0 (TRUE or FALSE). 1 1=Enable the DRAC 4 NIC. This object has read/write attributes. cfgNicIpAddress The IP address of the DRAC 4 NIC. This object has read/write attributes. A string of "." 192.168.0.120 separated numeric fields containing the static IP address. cfgNicNetmask The network mask used by the DRAC 4 NIC.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgNicCurrentIp Address The current IP address of the DRAC 4 NIC. This object has read-only attributes. A string of "." None separated numeric fields containing the IP address. cfgNicCurrentNet mask The current network mask used by the DRAC 4 NIC. This object has read-only attributes. A string of "." None separated numeric fields containing the network mask.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description cfgDNSCurrent Server1 Current IP address used for DNS Server 1. This object has read-only attributes. cfgDNSCurrent Server2 Current IP address used for DNS Server 2. This object has read-only attributes. Valid Values Default cfgRemoteHosts The group contains parameters to configure various firmware update loading, IP addresses, enables, and so on.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgRhostsFwUpd ateIpAddr The address of the TFTP A string of "." 192.168.0.4 server where the firmware separated update image is located. numeric fields This object has read/write containing the IP address. attributes. cfgRhostsFwUpd ateIpAddr The address of the TFTP server where the firmware update image is located. This object has read/write attributes. A string of "." 192.168.0.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgUserAdmin This group contains parameters to allow configuratio n of users that are allowed access to the DRAC 4.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgUserAdminUs erName Description Valid Values Default The name of the user for String of up to None this index. The user index 19 ASCII is created by writing a characters. string into this name field if the index is empty. Writing a "" string deletes the user at that index. You cannot change the name. You must delete and then recreate the name. The string must not contain "/" (forward slash), "\" (backslash), ".
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgUserAdminAle rtFilterSysEvent Mask Description Valid Values See "RAC-Generated Hexadecimal Event Mask Definitions" values. in the Dell Remote Access Controller Racadm User's Guide. Default 0x777777 This object has read/write attributes. cfgUserAdminE mailEnable 0=disable, 1=enable e- Boolean, mail alerting on a per user either 1 or 0 basis. (TRUE or This object has read/write FALSE). 0 attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgTrapsEnable 0=disabled, 1=enabled for this indexed entry. This object has read/write attributes. Boolean, either 1 or 0 (TRUE or FALSE). 1 cfgTrapsSnmpCo mmunity An SNMP community name. This object has read/write attributes. String of up to "" 31 ASCII characters. cfgTrapsFilterRac EventMask See "RAC-Generated Hexadecimal Event Mask Definitions" values.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to the DRAC 4. cfgSsnMgtMaxSe ssions The maximum number 0x1, 0x2, 0x3, 0x4 of simultaneous sessions 0x4 that are allowed at one time from the DRAC 4 Web-based remote access interface. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgSerial This group contains configuratio n parameters for the system external serial port. cfgSerialBaudRate Sets the baud rate on the 9600, 28800, 115200 external serial port. (Type 57600, 115200 decimal values). To modify this property, you must have Configure DRAC 4 permission. For best results redirecting BIOS System Setup screens, Dell recommends using 115200.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgSerialConsole IdleTimeout The maximum amount Integer from 1 0x12c of line idle time (in to any positive seconds) before the line is number. disconnected. (Type hexadecimal values.) This object has read/write attributes. cfgSerialConsole ShellType Sets the serial console shell type. (Type hexadecimal values.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgSerialConsole Command Description Valid Values Default The serial command runs connect com2 Empty string after login at the start of a (no session and allows you to command) set up a command such as connect com2 that autoruns when a session begins. To modify this property, you must have Configure DRAC 4 permission.This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgSerialCom2Re dirEnable Description Valid Values Default Enables/disables the console through the COM 2 port. 0=Disabled, 1=Enabled 1=COM 2 (console enabled) To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes. cfgSerialTelnet7fls Backspace When enabled, the 0=Disabled, DRAC 4 will interpret 1=Enabled 0x7f characters as backspaces from a telnet session.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgNetTuning The group contains parameters to tune the DRAC 4 network configuration. cfgNetTuningNic Autoneg Enables autonegotiation 1 or 0 of physical link speed and duplex. If enabled, autonegotiation takes priority over values set in the cfgNetTuningNic100MB and cfgNetTuningNicFullDu plex objects. 1 To modify this property, you must have Configure DRAC 4 permission.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgNetTuningNic Mtu Description Valid Values The size in bytes of the Integer from maximum transmission 576 to 1500 unit used by the DRAC 4 NIC. (Type hexadecimal values.) Default 0x5dc (1500) To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes. cfgNetTuningIp Ttl The maximum IP packet Integer from 1 0x40 (64) lifetime in seconds. (Type to 255 hexadecimal values.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgNetTuningTcp SrttBase Description Valid Values Default The smoothed round trip Integer from 0 0x0 (0) time-out base minimum to 256 value for TCP round trip retransmission time in ½ second units. (Type hexadecimal values.) To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgNetTuningTcp ReXmtMax Description Valid Values Default The maximum number of TCP retransmission time in ½ second units. (Type hexadecimal values.) Integer from 8 0x80 (128) to 1024 To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes. cfgNetTuningTcp Msl The maximum TCP segment lifetime in ½ second units. (Type hexadecimal values.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default Use this to modify the SNMP Community Name. A string of up public to 31 ASCII characters. cfgOobSnmp The group contains parameters to configure the SNMP agent and trap capabilities of the DRAC 4. cfgOobSnmpAge ntCommunity To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default Use this property to configure the DRAC 4 HTTP port. (Type hexadecimal values.) 0 – 65535 80 0 – 65535 443 0 – 65535 22 cfgRacTuning The group contains various tuning configuration parameters. cfgRacTuneHttp Port To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgRacTuneTelnet Port Description Valid Values Default Use this property to configure the DRAC 4 telnet port. (Type hexadecimal values.) 0 – 65535 23 To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes. cfgRacTuneFwU pdateResetDelay The maximum number in seconds to wait between when the firmware update file is loaded and the update sequence is started.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgRacTuneHost Com2BaudRate Description Valid Values Default To modify this property, 115200, 57600 you must have Configure 57600, 19200, DRAC 4 permission. This and 9600 object has read/write attributes. For best results when redirecting BIOS System Setup screens, Dell recommends setting this baud rate to 57600. cfgRacTuneCon RedirPort Determines the port used 0-65535 during vKVM sessions with the Console Redirection window.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default The host name of the managed system. String of up to "" 255 ASCII characters. ifcRacManagedNodeOs This group contains parameters to configure the DRAC 4 with managed system and operating system naming information. ifcRacMnOsHost name To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects 254 Description Valid Values Default cfgRacSecCsrOrg anizationName The CSR organization String of name. To modify this ASCII property, you must have characters. Configure DRAC 4 permission. This object has read/write attributes. "" cfgRacSecCsrOrg anizationUnit The CSR organization String of unit. To modify this ASCII property, you must have characters. Configure DRAC 4 permission. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects Description Valid Values Default cfgRacSecCsrKey Size DRAC 4 SSL asymmetric Positive key size. (Type integers hexadecimal values.) To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes. cfgFloppyEmulat ion 0 (False) is the default 1 or 0 (True or 0 setting, causing the False) DRAC 4 IDE Option ROM utility to display DELL VIRTUALS-120 instead of VIRTUALFLOPPY DRIVE.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgVirMediaDisa ble Description Valid Values 0 (Enabled) enables the 1 or 0 Dell Virtual floppy on the (Disabled or next system restart. Enabled) Default 0 (Enabled) 1 (Disabled) disables the Dell Virtual floppy and CD-ROM on the next system restart. After restart: • The operating system cannot access the drives. • The virtual devices do not appear in the BIOS Setup screen.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgVirAtapiSrvPort Description Valid Values Default Sets the port number or virtual media connection. (Type hexadecimal values). Any unused port number between 0 and 65535 decimal. 0E54 in hexadecimal( 3668 in decimal) To modify this property, you must have Access Virtual Media permission. This object has read/write attributes.
Table A-2. DRAC 4 Object Groups and Objects (continued) Object Group Objects cfgADEnable Description Valid Values Default 1 (True) allows Active 1 or 0 (True or 0 Directory authentication False) to take place. 0 (False) enables local DRAC 4 authentication only. To modify this property, you must have Configure DRAC 4 permission. This object has read/write attributes. cfgADAuthTime out Time in seconds to wait for Active Directory queries to complete. (Type hexadecimal values.
Table A-2 lists the object groups for DRAC 5, a brief description of the objects, and valid values for these objects. Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default idRacProduct Info Uses a text string to identify the product. String of up to "Dell 63 ASCII Remote characters. Access Controller 5" idRacInfo This group contains display parameters to provide information about the specifics of the DRAC 5 being queried.
Table A-3. DRAC 5 Object Groups and Objects Object Group 260 Objects Description Valid Values Default idRacBuildIn fo A string containing the current product build version. This object has read-only attributes. String of up to The 16 ASCII current characters. RAC firmware build version. For example, "05.12.06". idRacName A user assigned name to identify this controller. This object has read-only attributes. String of up to DRAC 5 15 ASCII characters.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgLanNetworking This group contains parameters to configure the DRAC 5 NIC. cfgDNSDom ainNameFro mDHCP Specifies that the RAC 1 (TRUE) DNS Domain Name 0 (FALSE) should be assigned from the network DHCP server. 1 This object has read/write attributes. cfgDNSDom ainName The DNS domain name. This parameter is only valid if cfgDNSDomainNameFro mDHCP is set to 0 (FALSE).
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgDNSRegis terRac Registers the DRAC 5 name on the DNS server. 1 (TRUE) 0 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgDNSServe rsFromDHCP Specifies that the DNS server IP addresses should be assigned from the DHCP server on the network.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgDNSServer 2 Retrieves the IP address for DNS server 2. This property is only valid if cfgDNSServersFromDHC P is set to 0 (FALSE). A string 0.0.0.0 representing a valid IP address. For example: "192.168.0.20". cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses. Default To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgNicIpAdd ress Specifies the static IP address to assign to the RAC. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE). A string 192.168.0. representing a 120 valid IP address. For example: "192.168.0.20". To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgNicGatew ay The gateway IP address used for static assignment of the RAC IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE). A string representing a valid IP address. For example: "192.168.0.1". 192.168.0. 1 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgNicUseDh cp Specifies whether DHCP is 1 (TRUE) used to assign the RAC IP 0 (FALSE) address. If this property is set to 1 (TRUE), then the RAC IP address, subnet mask, and gateway are assigned from the DHCP server on the network. If this property is set to 0 (FALSE), the static IP address, subnet mask, and gateway is assigned from the cfgNicIpAddress, cfgNicNetmask, and cfgNicGateway properties.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgNicMacAd dress The RAC NIC MAC address. This object has read-only attributes. A string representing the RAC NIC MAC address. The current MAC address of the RAC NIC. For example, "00:12:67:5 2:51:A3". cfgNicVLan Enable Enables or disables the VLAN capabilities of the RAC/BMC. 1 (TRUE) 0 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgNicVLan Priority Specifies the VLAN 0-7 Priority for the network VLAN configuration. This property is only valid if cfgNicVLanEnable is set to 1 (enabled). Default 0 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgRhostsFwU pdateIpAddr Specifies the network TFTP server IP address that is used for TFTP RAC firmware update operations. A string representing a valid TFTP server IP address. For example, 192.168.0.61. 0.0.0.0 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgRhostsFw UpdatePath Specifies TFTP path where String.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgUserAdmi nIpmiLanPriv ilege The maximum privilege on 2 (User) 4 (User 2) the IPMI LAN channel. 3 (Operator) 15 (All To modify this property, others) 4 you must have Configure (Administrator) Users permission. This 15 (No access) object has read/write attributes. cfgUserAdmi nIpmiSerialPr ivilege The maximum privilege on 2 (User) 4 (User 2) the IPMI serial channel.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgUserAdmin Privilege This property specifies the 0x0000000 to 0x0000000 allowed role-based 0x00001ff, and authority privileges allowed 0x0 for the user. The value is represented as a bitmask that allows for any combination of privilege values. For details about the bit masks for user privileges, see the Dell Remote Access Controller 5 Firmware Version 1.30 User's Guide.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgUserAdmin UserName The name of the user for String. this index. The user index Maximum is created by writing a length = 16. string into this name field if the index is empty. Writing a string of double quotes ("") deletes the user at that index. You cannot change the name. You must delete and then recreate the name. The string must not contain "/" (forward slash, "\" (backslash), ".
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgUserAdmin Enable Enables or disables an individual user.. 1 (TRUE) 0 0 (FALSE) To modify this property, you must have Configure Users permission. cfgUserAdmin SolEnable Enables or disables Serial Over LAN (SOL) user access. 1 (TRUE) 0 0 (FALSE) To modify this property, you must have Configure Users permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgEmailAlert CustomMsg Specifies a custom message String. that is sent with the Maximum alert.This object has read- Length = 32. only attributes. "" cfgSsnMgtCo nsRedirMaxS essions Specifies the maximum number of console redirection sessions allowed on the RAC. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgSsnMgtW ebserverTime out Defines the Web server 60-1920 time-out. This property sets the amount of time in seconds that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached. Changes to this setting do not affect the current session (you must log out and log in again to make the new settings effective).
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgSsnMgtSs hIdleTimeout Defines the Secure Shell 0 (No timeidle time-out. This out) property sets the amount 60 – 1920 of time in seconds that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached. Changes to this setting do not affect the current session (you must log out and log in again to make the new settings effective).
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgSsnMgtTel netTimeout Defines the Telnet idle 0 (No timeout) 0 time-out. This property 60 – 1920 sets the amount of time in seconds that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgSerialBaud Rate Sets the baud rate on the DRAC 5 serial port. 9600, 28800, 57600, 115200 57600 1 (TRUE) 0 cfgSerial This group contains configuration parameters for the DRAC 5 serial port. To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgSerialCons oleEnable Enables or disables the RAC serial console interface.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgSerialCons oleQuitKey This key or key STRING combination terminates MaxLen = 4 text console redirection when using the connect com2 command.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgSerialCons oleIdleTimeo ut The maximum number of 0 = No timeseconds to wait before an out idle serial session is 60 – 1920 disconnected. Default 300 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgSerialCons oleNoAuth cfgSerialCons oleCommand Enables or disables the RAC serial console login authentication.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgSerialSshE nable Enables or disables the secure shell (SSH) interface on the DRAC 5. 1 (TRUE) 1 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgSerialTeln etEnable Enables or disables the 1 (TRUE) telnet console interface on 0 (FALSE) the RAC. 0 To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgNetTuning NicAutoneg Enables autonegotiation of 1 (TRUE) physical link speed and 0 (FALSE) duplex. If enabled, autonegotiation takes priority over values set in the cfgNetTuningNic100MB and cfgNetTuningNicFullDupl ex objects. Default cfgNetTuning This group enables users to configure the advanced network interface parameters for the RAC NIC.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgNetTuning NicMtu The size in bytes of the maximum transmission unit used by the DRAC 5 NIC. 576 – 1500 1500 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgNetTuning TcpSrttDflt The smoothed round trip 6-384 time-out base default value for TCP retransmission round trip time in ½ second units. (Type hexadecimal values.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgOobSnmp AgentEnable Enables or disables the SNMP agent in the RAC. 1 (TRUE) 0 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgRacTuning This group is used to configure various RAC configuration properties, such as valid ports and security port restrictions.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgRacTuneIp RangeAddr Specifies the acceptable IP address bit pattern in positions determined by the 1's in the range mask property (cfgRacTuneIpRangeMask ). String, IP address formatted. For example, 192.168.0.44. 192.168.1. 1 Standard IP mask values with leftjustified bits. 255.255.25 5.0 To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgRacTuneI pBlkFailWin dow Defines the timespan in 2-65535 seconds that the failed attempts are counted. When the failure attempts age to this limit, the failures are dropped from the count. Default 60 To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgRacTune Enables or disables the Remote RACADM interface in the RAC. 1 (TRUE) 1 RemoteRaca dmEnable 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgRacTuneC onRedirEncry ptEnable Encrypts the video in a 1 (TRUE) console redirection session. 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgRacTuneC onRedirVideo Port Specifies the port to be used for video traffic during Console Redirection activity with the RAC. This object requires a DRAC 5 reset before it becomes active. 1-65535 5901 1 (TRUE) 1 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgRacTuneTi mezoneOffset Specifies the timezone -720 – 780 offset (in minutes) from GMT/UTC to use for the RAC Time.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgRacTune LocalServer Video Enables (switches ON) or disables (switches OFF) the local server video. 0 (FALSE) 1 1 (TRUE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default The host name of the managed system. String. "" Maximum Length = 255. ifcRacManagedNodeOs This group contains properties that describe the Managed Server operating system. ifcRacMnOs Hostname To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. ifcRacMnOs OsName The operating system name of the managed system. String. "" Maximum Length = 255.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgRacSecCsr Organization Name Specifies the CSR Organization Name (O). String. "" Maximum Length = 254. To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgRacSecCsr Organization Unit Specifies the CSR Organization Unit (OU). To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgRacSecCsr CountryCode Specifies the CSR Organization Country Code (CC). String. Maximum Length = 2. "" To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgRacSecCsr EmailAddr Specifies the CSR e-mail Address. To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgVirMedia Attached This object is used to 1 (TRUE) attach your virtual devices 0 (FALSE) to the system via the USB bus. When the devices are attached the server will recognize valid USB Mass Storage devices attached to the system. This is equivalent to attaching a local USB CDROM/Floppy drive to a USB port on the system.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgVirAtapiSr vPort Specifies the port number 1 – 65535 used for encrypted virtual media connections to the RAC. Default 3669 To modify this property, you must have Access Virtual Media permission. This object has read/write attributes. cfgVirAtapiSr vPortSsl Sets the port used for SSL Any unused 3669 Virtual Media connections.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgVirMedia BootOnce Enables or disables the 1 (Enabled) virtual media boot-once 0 (Disabled) feature of the RAC. If this property is enabled when the host server is rebooted, this feature will attempt to boot from the virtual media devices—if the appropriate media is installed in the device. Default 0 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default Active Directory Domain in which the DRAC resides. Any printable "" text string with no white space. Length is limited to 254 characters. cfgActiveDirectory This group contains parameters to configure the DRAC 5 Active Directory feature. cfgADRacDo main To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgADSpecify ServerEnable 1 (True) enables you to 1 (TRUE) specify an LDAP or a 0 (FALSE) Global Catalog server. 0 (False) disables this option. Default 0 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgADDomain Controller DRAC 5 uses the value you Valid IP address No default specify, to search the LDAP or fully values server for user names.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgADCRLE nable Enables or disables the 1 (TRUE) Certificate Revocation List 0 (FALSE) (CRL) check for Active Directory-based Smart Card users. Default 0 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgADAuthTi meout Specifies the number of seconds to wait for Active Directory authentication requests to complete before timing out.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgADType Determines the schema type to use with Active Directory. 1 = Enables Extended Schema with Active Directory. 1= Extended Schema To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. 2 = Enables Standard Schema with Active Directory. cfgStandardSchema This group contains parameters to configure the Standard Schema settings.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgSSADRole GroupPrivilege For information about bit 0x00000000 to (blank) mask numbers used to set 0x000001ff role-based authority privileges for a Role Group, see Dell Remote Access Controller 5 Firmware Version 1.30 User's Guide. To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgIpmiSerial Connection Mode When the DRAC 5 1 (Terminal) cfgSerialConsoleEnable 0 (Basic) property is set to 0 (disabled), the DRAC 5 serial port becomes the IPMI serial port. This property determines the IPMI defined mode of the serial port. Default cfgIpmiSerial This group specifies properties used to configure the IPMI serial interface of the BMC.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgIpmiSerial ChanPrivLim it Specifies the maximum privilege level allowed on the IPMI serial channel. 2 (User) 4 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgIpmiSerial FlowControl Specifies the flow control setting for the IPMI serial port. To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgIpmiSerial EchoControl Enables or disables echo control on the IPMI serial interface. 1 (TRUE) 1 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgIpmiSerial DeleteControl Enables or disables delete control on the IPMI serial interface. 1 (TRUE) 0 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgIpmiSolEn able Enables or disables Serial Over LAN (SOL). 1 (TRUE) 1 cfgIpmiSol This group is used to configure the Serial-OverLAN capabilities of the system. 0 (FALSE) To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgIpmiSolBa udRate The baud rate for serial 9600, 19200, communication over LAN.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgIpmiSolSe ndThreshold The SOL threshold limit value. 1-255 255 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. cfgIpmiLan This group is used to configure the IPMI-OverLAN capabilities of the system. cfgIpmiLanEn able Enables or disables the 1 (TRUE) IPMI-Over-LAN interface.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgIpmiEncry ptionKey The IPMI encryption key. A string of "00000000 hexadecimal 000000000 digits from 0 to 000" 20 characters with no spaces. cfgIpmiPetCo mmunityNa me The SNMP community name for traps. To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes. A string up to 18 characters.
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values cfgIpmiPefAc tion Specifies the action that is 0 (None) 0 performed on the managed 1 (Power system when the alert is Down) triggered. 2 (Reset) To modify this property, you must have Configure 3 (Power Cycle) DRAC 5 permission. This object has read/write attributes. cfgIpmiPefEn able Enables or disables a specific platform event filter..
Table A-3. DRAC 5 Object Groups and Objects Object Group Objects Description Valid Values Default cfgIpmiPetAle rtDestIpAddr Specifies the destination IP address for the trap receiver on the network. The trap receiver receives an SNMP trap when an event is triggered on the managed system. String representing a valid IP address. For example, 192.168.0.67. 0.0.0.0 1 (TRUE) 1 To modify this property, you must have Configure DRAC 5 permission. This object has read/write attributes.
DRAC III, DRAC 4, and DRAC 5 Property Database Group and Object Definitions
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 B-1 lists SYSCFG error codes and messages. Table B-1.
Table B-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.
Table B-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 B-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 B-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 B-1. SYSCFG Error Codes and Messages (continued) Error Code Message 83 The dependent option required for this subcommand is missing in the command line. 84 Duplicate sub command 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 B-1. SYSCFG Error Codes and Messages (continued) Error Code Message 103 Input file cannot be read. 104 Invalid argument for option. 105 Function table lookup error. 106 The machine ID was not found in the file. 107 The system memory information is not available. 108 Mode can only be used with the --pci option. 109 The device name or index must be present in the boot order. 110 The output file could not be opened. Please make sure the path exists and the media is not write protected.
Table B-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 B-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 B-2 lists error codes and messages common to Linux and Microsoft®Windows® PE environments. Table B-2. UPINIT Common Error Codes and Messages Error Code Message 0 Dell Utility Partition created successfully. 1 Error: Disk ID not specified. 2 Error: SIZE not specified. 3 Error: Utility Partition Image file not specified. 4 Error: DRMK Path not specified. 5 Error: Dell Utility Partition already exits. Please use --overwrite option to upgrade or overwrite. 6 Error: Partitions exists.
UPINIT Linux-Specific Error Codes and Messages Table B-3 lists error codes and messages specific to the Linux environment. Table B-3. UPINIT Linux-Specific Error Codes and Messages Error Code Message 31 Error: Invalid disk specified. 32 Error: Mount failed. 33 Cannot create mount point . File exists. 34 Error: fdisk failed. UPINIT Windows PE-Specific Error Codes and Messages Table B-4 lists error codes and messages specific to the Windows PE environment. Table B-4.
Table B-5. RAIDCFG Error Codes and Messages Error Code Message 0 RAIDCFG Command successful! 1 Error! Incorrect Syntax. 2 Failure! 3 Illegal operation 4 Unsupported operation 5 Device not found. 6 Format boot drive illegal 7 Buffer too small. 8 Virtual Disk contains boot partition. Use force option to delete. 9 Init boot drive failed. 10 Format boot drive failed. 11 Cannot write boot drive. 12 Unsupported RAID value. 13 Invalid RAID configuration. 14 Span depth not in range.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 23 RAID 50 failed. 24 RAID 5 not supported. 25 RAID 50 not supported. 26 Size too small for given RAID type. 27 Wrong number of disks for RAID 1concatenated. 28 Insufficient space to mirror disks. 29 Create Mirror not supported. 30 Disk in use. 31 Disk Lock operation failed. 32 Disk locked. 33 Disk Unlock operation failed. 34 Disk Unlocked. 35 Disk failed on rebuild. 36 Hot Spare not free.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 47 Disk Online failed. 48 Disk Offline failed. 49 UnMount Operation failed. 50 Mount Operation failed. 51 Cannot Format Array Disk. 52 Bad chunk size. 53 Invalid disk. 54 Virtual disk not found. 55 Virtual disk locked. 56 Drive in use. 57 Reached maximum physical size. 58 Reached maximum count of virtual disks.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 66 Create virtual disk failed. 67 Create virtual disk failed. Controller busy. 68 Create virtual disk failed. Failed to map virtual disk to operating system disk. 69 Create virtual disk failed. Failed to map virtual disk to operating system disk. 70 Virtual disk initialization failed. 71 Virtual disk initialization failed. Controller busy. 72 Virtual disk reconstruction failed. Controller busy.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 83 The new virtual disk must use only the remaining free space on the array disks used in the last virtual disk you created. Select all array disks that are used in the last virtual disk you created. 84 You have selected an array disk that is in a degraded or failed state. Choose another array disk. 85 Delete the last created virtual disk first. 86 Virtual disk initialized for use and no override requested.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 100 Virtual Disk Requires Non Multilevel. 101 Virtual Disk Promote Operation failed. 102 Specified virtual disk has no drive letter assigned to it. 103 Cannot expose virtual disk. 104 Cannot reconfigure virtual disk. 105 Cannot stop the reconfiguration of the virtual disk. 106 SMART report count not supported. 107 Operations on hidden virtual disks are not allowed. 108 Virtual disk is in use.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 118 Cannot reconfigure from current RAID level to the given RAID level. 119 One of the array disks selected for the virtual disk is already in use. 120 Virtual disk operation not supported. Cannot use non-RAID disk. 121 Controller Read Configuration failed. 122 Controller Write Configuration failed. 123 Controller cache flush failed. 124 Enable alarm on controller failed. 125 Disable alarm on controller failed.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 140 The controller was not able to add space to the specified concatenation set. 141 The controller was not able to get the status of the specified mirror set. 142 The controller was not able to set the requested failover space. 143 The controller cannot get the failover space information. 144 Controller cannot unmirror the specified virtual disk. 145 The controller could not split the specified virtual disk.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 159 The virtual disk is not valid for requested operation. 160 Cannot communicate with controller. 161 Set operation failed. 162 Operation to update error count of SMART device has failed. 163 Operation to clear error count of SMART device has failed. 164 Driver could not execute. 165 Cannot delete virtual disk. 166 Cannot set temperature probe. Invalid value entered. 167 Cannot set enclosure tag.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 176 Invalid array disks or failover selected for reconfigure/create Please make sure that all array failover drives associated with disk are selected. drives operation. disks and the virtual 177 The maximum number of partitions have already been created on one of the selected array disk(s). Each array disk can hold portions (partitions) of up to 10 virtual disks.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 184 The operation cannot be performed at this time. The firmware can recondition a battery that has a Degraded or Power Low state. The firmware will not recondition a battery that is functioning normally or that has a Ready, Failed or Missing state. 185 The version of the controller firmware installed on your system does not support this operation.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 195 An error occurred while resetting a temperature probe. 200 No array disks found! 201 Invalid Virtual Disk ID! 202 RAID Type & Size are required to create a virtual disk. Ensure that the RAID type and the size are correct.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 216 Invalid virtual disk size! 217 The strict option provided failed! Virtual disk is not created. 218 Unable to determine optimum size for Virtual disk. Ensure that the array disks are of the same protocol (i.e. SAS, SATA, SCSI). If there is a mismatch of the array disks then the RAIDCFG will not be able to determine the optimum size. In addition, also ensure that there is drive size available for the specified virtual disk.
RACADM Firmware Error Codes and Messages Table B-6 lists RACADM firmware error codes and messages. Table B-6. RACADM Firmware Error Codes and Messages Error Code Message 1 UNKNOWN COMMAND.
Table B-6.
Table B-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 B-7 lists RACADM utility error codes and messages. Table B-7. RACADM Error Codes and Messages Error Code Message 513 An unknown failure occurred. 514 Librac library not initialized.
Table B-7. RACADM Error Codes and Messages (continued) Error Code Message 522 Failed to perform write operation with RAC controller. 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.
Table B-7. RACADM Error Codes and Messages (continued) Error Code Message 544 Socket write operation failed. 545 Failed to create SSL context object. 546 Failed to create SSL BIO object. 547 Unable to create SSL socket connection. 548 Failed to initialize socket. 549 Failed to login to RAC successfully. 550 Invalid session ID specified. 551 Failed to logout from RAC successfully. 552 Command execution failed. 553 FTP Get operation failed. 554 FTP Put operation failed.
Table B-7. RACADM Error Codes and Messages (continued) Error Code Message 564 LAN Proxy error - please make sure your proxy settings are configured correctly. 565 RAC service not currently installed. 566 RAC service is not started. 567 RAC service is starting. 568 RAC controller not present. 569 RAC controller is currently resetting.
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 C-1. Table C-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. Temperature Probe Warning The temperature is approaching excessively high or low limits.
Table C-1. BMC PEF Alert Events Event Description Automatic System Recovery The system is hung or is not responding and is taking an action configured by Automatic System Recovery. System Power Probe Warning The system is setting actions when a power consumption probe detects a warning value. System Power Probe Failure The system is setting actions when a power consumption probe detects a failure value.
Sample File Formats 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 346 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 347
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 348 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 349
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 Format
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 352 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 353
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 354 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 355
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 356 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 357
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 358 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 365
Sample File Formats
Summary of SYSCFG and RAIDCFG Options This appendix contains a summary of all the SYSCFG and RAIDCFG options. SYSCFG Options Table E-1 lists all the SYSCFG options and gives a brief description of these options. For details on these options, see the section, "SYSCFG". Table E-1.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description -o or --outfile 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 --version* 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 E-1. SYSCFG Options (continued) Options --bootseq Suboptions Valid Arguments Description numerical Sets the boot order. list, separated by commas or list of device names, separated by commas Replicated Yes (for systems that support a list of device names only) --bootseqretry enable, disable Enables or disables the boot Yes sequence retry feature. --conboot enable, disable Enables or disables console redirection after boot.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated -embhypervisor enable, disable Enables or disables the embedded hypervisor port. Yes --embideraid on, off Enables or disables the embedded IDE RAID controller. Yes --embnic1 on, off, onnopxe, onwithiscsi Enables or disables the first Yes embedded network interface controller (NIC). --embnic2 on, off, onnopxe, onwithiscsi Enables or disables the second embedded NIC.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --embscsiraid raid, off, scsi Enables or disables the embedded SCSI RAID or controller. raid, off Yes -embscsiraidchb raid, scsi Yes --extserial com1, com2, Sets the behavior of the rad external serial connector. Yes --fiberchannel enable, disable Enables or disables embedded fiber channel. Yes --floppy auto, off, readonly Enables or disables the diskette drive controller.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --integratedraid enable, disable Enables or disables the integrated RAID controller. Yes --integratedsas enable, disable Sets the behavior for the integrated SAS controller. Yes --internalusb off, on Enables or disables the internal USB. Yes --ioat enable, disable Enables or disables the I/O Acceleration Technology (I/OAT)\nDMA Engine option.
Table E-1. SYSCFG Options (continued) Options --lcd2 Suboptions Valid Arguments Description Replicated 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 enable, disable Enables or disables the logical processor (Hyperthreading).
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments -noraidprompt* none Description Replicated Disables the POST prompt message when the SCSI controller type is changed. No NOTE: The asterisk is not part of the command syntax. --numlock on, off Enables or disables the keyboard number lock. --oldsetuppwd Confirms the existing setup No password when setting a new setup password.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description --powerbutton enable, disable --pwdlock lock, unlock Enables or disables the ability to set the system password. --redmem off, spare, mirror, raid Replicated Enables or disables the front Yes bezel power button. No 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.
Table E-1. SYSCFG Options (continued) Options --sata1 Suboptions Valid Arguments auto, off Description Replicated Enables or disables SATA port 1. Yes NOTE: This option maps to --sata_b for PowerEdge x9xx systems. --sata2 auto, off Enables or disables SATA port 2. Yes NOTE: This option maps to --sata_c for PowerEdge x9xx systems. --sata3 auto, off Enables or disables SATA port 3. Yes NOTE: This option maps to --sata_d for PowerEdge x9xx systems.
Table E-1. SYSCFG Options (continued) Options --sata7 Suboptions Valid Arguments auto, off Description Replicated Enables or disables SATA port 7. Yes NOTE: This option maps to --sata_h for PowerEdge x9xx systems. --serial1 disable, Sets the behavior for serial com1, com3, port 1. com1_bmc, bmcserial, bmclan, rac Yes --serial2 auto, Sets the behavior for serial disable, port 2. com2, com4 Yes --serialcomm on, com1cr, com2cr, off Sets the behavior of serial port communication.
Table E-1. SYSCFG Options (continued) Options --svctag* Suboptions Valid Arguments none Description Replicated Reports the service tag for the system. No NOTE: The asterisk is not part of the command syntax. --syspwd tpm 378 Sets the system password for No the system BIOS. -off, Configures the TPM security Yes tpmsecurity onwithpbm, feature. onwithoutpb m -enabled, tpmactivat disabled, ion nochange Enables or disables the TPM Yes activation feature.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated -NA setuppwdo verride On systems that do not have No a setup password configured, if you set this option, you will not be prompted for a password to access DTK settings. --usb on, off, legacy Enables or disables the USB Yes port. --usbflash auto, fdd, hdd Sets the emulation of a USB Yes flash device to auto, diskette (fdd), or hard drive (hdd).
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments --encryptkey NA Platform Management Interface (IPMI) sessions. --identify NA 0–254 Flashes the identification LED for a specified number of seconds. enable, disable Sets or displays the LAN channel access settings such as alerting and user privilege limits.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description lancfgparams or lcp --ipaddrsrc static, dhcp Configures and displays LAN configuration parameters.
Table E-1.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments lanuseraccess -user, Configures and displays user usrprivlmt operator, access parameters for the administrato LAN channel. r, noaccess or lua --userid 2–10 -currentena NA bleduserids Description Replicated Returns the number of User IDs with fixed names. -useridswit NA hfixednam es --loaddefaults NA NA Restores the BMC to the defaults that were originally loaded on the controller.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description pefcfgparams or pcp --filter Configures and displays PEF configuration parameters. See "BMC Platform Events Filter Alert Messages" for a complete list of all possible PEF messages along a description of each event.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated -1, 2, 3, 4 alertpolnu m -enable, alertpolstat disable us --powerbutton NA enable, disable Enables or disables the power button. --powerctl NA powerdown Performs a chassis reset of the system. powercycle< /argument> reset softshutdow n --racreset NA NA disable, serialchannelac -ipmioverse alwaysavail cess or sca rial Resets the RAC.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments serialchannelinfo -NA or mediumty sci pe Description Displays serial channel information.
Table E-1. Options SYSCFG Options (continued) Suboptions Valid Arguments serialcfgparams -basic, or connection terminal scp mode -noflowctrl, msgcommf rtscts lowctrl -NA msgcomm dtrhangup Description Replicated Configures and displays serial configuration parameters. NOTE: The BMC firmware does not support serial port Point-to-Point Protocol (PPP) configurations.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description serialuseraccess -user, Configures and displays user or usrprivlmt operator, access parameters for the sua administrato serial channel. r, noaccess --userid 2–10 -NA currentena bleduserids -NA useridswit hfixednam es --solaction Enables or disables SerialOver-LAN (SOL) access for a particular user.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description solcfgparams --solenable enable, disable Configures and displays SOL configuration parameters.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description -x NA Specifies that the state data value should be in hexadecimal format. --asset NA Reports the asset tag for a system. --biosver NA Reports the BIOS version for a system. --chassvctag NA Reports the chassis service tag for modular systems. --cpucount NA Reports the number of processors in a system. --cpuspeed NA Reports the speed of all processors in a system.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --sysasset NA Reports the asset tag for a server module in a modular system chassis. --sysid NA Reports the unique system ID bytes for a system. --sysname NA Reports the system identification string for a system. --syssvctag NA Reports the service tag for a server module in a modular system chassis. --uuid NA Reports the unique universal identifier (UUID) for a system.
Table E-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -ac cvd Creates a virtual disk. or or NOTE: When providing multiple action createvdisk physical disks for the createvdisk command, do not separate the disks with spaces. For example, -ad=1:4, 1:5 causes an error. The correct syntax for displaying multiple physical disks is -ad=1:4,1:5,1:6. See Table 4-4 for specific usage information. -ac dvd Deletes a virtual disk.
Table E-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description -cp d, c Specifies the virtual disk cache policy. Optional. or See Table 4-4 for specific usage information. cachepol icy -ctrl Mandatory or Optional NA or controller Displays a list of the supported RAID Mandatory, controllers in the system, along with must be select property information. typed in the correct order. See Table 4-3 for specific usage information.
Table E-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -i Reads the RAID configuration information from the given .ini filename and creates the RAID configurations on the specified controllers. Mandatory. -l Logs command line output to a file. or -r or raid -rp or Reads the RAID configurations from all available controllers and write these configurations in the given .ini filename.
Table E-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -se NA Sets a user-defined environment variable to the value returned from the function call. Function calls are: Mandatory. or setenviro nment -si getcontrollerslots, getfirmware, getcontrollertype, getadisks, getadiskcount, getfreeadisks, getfreeadiskcount, getfreeadisksize, gethotspares. NA or Does not display any information on the terminal console. Optional.
Table E-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 NOTE: When creating virtual disks, do for specific not specify the units for chunk (stripe) usage size. The units are always listed in KB. information. NA Displays the virtual disks under all of the controllers along with the physical array disks that make up the virtual disks.
Glossary The following list defines or identifies technical terms, abbreviations, and acronyms used in your system documents. A Abbreviation for ampere(s). AC Abbreviation for alternating current. AC power switch A switch with two AC power inputs that provides AC power redundancy by failing over to a standby AC input in the event of a failure to the primary AC input. access Refers to the actions a user can take on a variable value. Examples include readonly and read-write.
API Abbreviation for application program interface, which is a set of routines, protocols, and tools for building software applications that act as an interface between the operating system and application programs. argument The value supplied with an option, such as in the following command line instance: utilname --option=argument ARP Acronym for Address Resolution Protocol, which is a method for finding a host’s Ethernet address from its Internet address.
backup A copy of a program or data file. As a precaution, you should back up your system's hard drive on a regular basis. Before making a change to the configuration of your system, you should back up important start-up files from your operating system. baud rate A measurement of data transmission speed. For example, modems are designed to transmit data at one or more specified baud rate(s) through the COM (serial) port of a system.
boot routine When you start your system, it clears all memory, initializes devices, and loads the operating system. Unless the operating system fails to respond, you can reboot (also called warm boot) your system by pressing ; otherwise, you must perform a cold boot by pressing the reset button or by turning the system off and then back on. bootable diskette You can start your system from a diskette.
cache A fast storage area that keeps a copy of data or instructions for quicker data retrieval. For example, your system's BIOS may cache ROM code in faster RAM. Or, a disk-cache utility may reserve RAM in which to store frequently accessed information from your system's disk drives; when a program makes a request to a disk drive for data that is in the cache, the disk-cache utility can retrieve the data from RAM faster than from the disk drive.
CIM Acronym for Common Information Model, which is a model for describing management information from the DMTF. CIM is implementation independent, allowing different management applications to collect the required data from a variety of sources. CIM includes schemas for systems, networks, applications and devices, and new schemas will be added. It provides mapping techniques for interchange of CIM data with MIB data from SNMP agents. CIMOM Acronym for common information model object manager.
config.sys file The config.sys file is executed when you boot your system (before running any commands in the autoexec.bat file). This start-up file contains commands that specify which devices to install and which drivers to use. This file also contains commands that determine how the operating system uses memory and controls files. ConsoleOne Novell ConsoleOne is a Java-based foundation for graphical utilities that manage and administer network resources from different locations and platforms.
coprocessor A chip that relieves the system's microprocessor of specific processing tasks. A math coprocessor, for example, handles numeric processing. A graphics coprocessor handles video rendering. The Intel® Pentium® microprocessor, for example, includes a built-in math coprocessor. cpi Abbreviation for characters per inch. CPU Abbreviation for central processing unit. See also microprocessor.
device driver A program that allows the operating system or some other program to interface correctly with a peripheral device, such as a printer. Some device drivers—such as network drivers—must be loaded from the config.sys file (with a device= statement) or as memory-resident programs (usually, from the autoexec.bat file). Others—such as video drivers—must load when you start the program for which they were designed.
DMA Abbreviation for direct memory access. A DMA channel allows certain types of data transfer between RAM and a device to bypass the microprocessor. DMTF Abbreviation for Distributed Management Task Force, a consortium of companies representing hardware and software providers. dpi Abbreviation for dots per inch. DRAM Acronym for dynamic random-access memory. A system's RAM is usually made up entirely of DRAM chips.
EDO Acronym for extended data output dynamic random access memory which is a type of DRAM that is faster than conventional DRAM. EDO RAM can start fetching the next block of memory at the same time that it sends the previous block to the microprocessor. EEPROM Acronym for electrically erasable programmable read-only memory. EIDE Abbreviation for enhanced integrated drive electronics.
EPP Abbreviation for Enhanced Parallel Port which provides improved bidirectional data transmission. Many devices are designed to take advantage of the EPP standard, especially devices, such as network or SCSI adapters that connect to the parallel port of a portable computer. EPROM Acronym for erasable programmable read-only memory. ESD Abbreviation for electrostatic discharge.
FAT Acronym for file allocation table. FAT and FAT32 are file systems that are defined as follows: • FAT — A file system used by MS-DOS, Windows 3.x, Windows 95, and Windows 98. Windows NT® and Windows 2000 also can use the FAT file system. The operating system maintains a table to keep track of the status of various segments of disk space used for file storage. • FAT32 — A derivative of the FAT file system.
format To prepare a hard drive or diskette for storing files. An unconditional format deletes all data stored on the disk. FPBGA Abbreviation for field programmable gate array, a programmable logic chip (PLD) with a high density of gates. FRU Abbreviation for field replaceable unit. ft Abbreviation for feet. FTP Abbreviation for file transfer protocol. FQDN Abbreviation for fully qualified domain name. It consists of a host and domain name, including top-level domain. Example: www.webopedia.com.
GMT Abbreviation for Greenwich Mean Time, which is the standard time common to every place in the world. GMT nominally reflects the mean solar time along the prime meridian (0 longitude) that runs through the Greenwich Observatory outside of London, UK. graphics coprocessor See coprocessor. graphics mode A video mode that can be defined as x horizontal by y vertical pixels by z colors. GUI Acronym for graphical user interface. GUID Globally unique identifier.
host adapter A host adapter implements communication between the system's bus and the controller for a peripheral device. (hard drive controller subsystems include integrated host adapter circuitry.) To add a SCSI expansion bus to your system, you must install or connect the appropriate host adapter. hot plug The ability to remove and replace a redundant part while the system is still running. Also called a hot spare.
ID Abbreviation for identifier, commonly used when referring to a user identifier (user ID), object identifier (object ID), or hardware identifier (controller ID). IDE Abbreviation for Integrated Drive Electronics. IDE is a computer system interface, used primarily for hard drives and CDs. I/O Abbreviation for input/output. The keyboard is an input device, and a printer is an output device. In general, I/O activity can be differentiated from computational activity.
IPX Abbreviation for internetwork packet exchange. IRQ Abbreviation for interrupt request. A signal that data is about to be sent to or received by a peripheral device travels by an IRQ line to the microprocessor. Each peripheral connection must be assigned an IRQ number. For example, the first serial port in your system (COM1) is assigned to IRQ4 by default. Two devices can share the same IRQ assignment, but you cannot operate both devices simultaneously. ISA Acronym for Industry-Standard Architecture.
KB/sec Abbreviation for kilobyte(s) per second. Kbit(s) Abbreviation for kilobit(s), 1024 bits. Kbit(s)/sec Abbreviation for kilobit(s) per second. key combination A command requiring you to press multiple keys at the same time. For example, you can reboot your system by pressing the key combination. kHz Abbreviation for kilohertz, 1000 hertz. LAN Acronym for local area network.
LED Abbreviation for light-emitting diode. An electronic device that lights up when a current is passed through it. local bus On a system with local-bus expansion capability, certain peripheral devices (such as the video adapter circuitry) can be designed to run much faster than they would with a traditional expansion bus. Some local-bus designs allow peripherals to run at the same speed and with the same width data path as the system's microprocessor.
Mb Abbreviation for megabit. MB Abbreviation for megabyte(s). The term megabyte means 1,048,576 bytes; however, when referring to hard drive storage, the term is often rounded to mean 1,000,000 bytes. MB/sec Abbreviation for megabytes per second. Mbps Abbreviation for megabits per second. MBR Abbreviation for master boot record. MCA Abbreviation for Micro Channel Architecture, which is designed for multiprocessing. MCA eliminates potential conflicts that arise when installing new peripheral devices.
MHz Abbreviation for megahertz. MIB Acronym for management information base. The MIB is used to send detailed status/commands from or to an SNMP managed device. microprocessor The primary computational chip inside the system that controls the interpretation and execution of arithmetic and logic functions. Software written for one microprocessor must usually be revised to run on another microprocessor. CPU is a synonym for microprocessor. MIDI Acronym for musical instrument digital interface.
ms Abbreviation for millisecond(s). MTBF Abbreviation for mean time between failures. multifrequency monitor A monitor that supports several video standards. A multifrequency monitor can adjust to the frequency range of the signal from a variety of video adapters. mV Abbreviation for millivolt(s). name The name of an object or variable is the exact string that identifies it in an SNMP Management Information Base (MIB) file or in a CIM Management Object File (MOF).
noninterlaced A technique for decreasing screen flicker by sequentially refreshing each horizontal line on the screen. ns Abbreviation for nanosecond(s), one billionth of a second. NTFS Abbreviation for the Windows NT File System option in the Windows NT operating system. NTFS is an advanced file system designed for use specifically within the Windows NT operating system. It supports file system recovery, extremely large storage media, and long filenames.
option An argument to a command that modifies its function rather than providing data and is usually set off by a delimiter such as - or /. Some options may or must be followed by a value, for example: utilname -option=argument OTP Abbreviation for one-time programmable. PAM Acronym for Pluggable Authentication Modules. PAM allows system administrators to set an authentication policy without having to recompile authentication programs.
PCMCIA Personal Computer Memory Card International Association. An international trade association that has developed standards for devices, such as modems and external hard drives, that can be plugged into portable computers. PERC Acronym for PowerEdge™ Expandable RAID controller. peripheral device An internal or external device—such as a printer, a disk drive, or a keyboard— connected to a system.
PKIS Abbreviation for Novell Public Key Infrastructure Services. PLCC Abbreviation for plastic leaded chip carrier. PEF Abbreviation for Platform Event Filter. A PEF is a function that compares an event against a set of configurable event filters and triggers a selectable action, such as, an alert on a match. Plug and Play An industry-standard specification that makes it easier to add hardware devices to personal computers.
PQFP Abbreviation for plastic quad flat pack, a type of microprocessor socket in which the microprocessor chip is permanently mounted. program diskette set The set of diskettes from which you can perform a complete installation of an operating system or application program. When you reconfigure a program, you often need its program diskette set.
RAM Acronym for random-access memory. A system's primary temporary storage area for program instructions and data. Each location in RAM is identified by a number called a memory address. Any information stored in RAM is lost when you turn off your system. RAMDAC Acronym for random-access memory digital-to-analog converter. RAM disk A memory-resident program that emulates a hard drive.
hardware. Typically, readme files provide installation information, describe new product enhancements or corrections that have not yet been documented, and list known problems or other things you need to be aware of as you use the software or hardware. real mode An operating mode supported by 80286 or higher microprocessors, real mode imitates the architecture of an 8086 microprocessor. refresh rate The rate at which the monitor redraws the video image on the monitor screen.
RPM Abbreviation for RPM Package Manager. RSA Abbreviation for Rivest, Shamir, and Adleman, the inventors of a public key encryption technology developed by RSA Data Security, Inc. RTC Abbreviation for real-time clock. Battery-powered clock circuitry inside the system that keeps the date and time after you turn off the system. SAN Acronym for storage area network. SAS Acronym for Secure Authentication Services. SATA Abbreviation for Serial Advanced Technology Attachment.
SDMS Abbreviation for SCSI device management system. sec Abbreviation for second(s). SEC Abbreviation for single-edge contact. secure port server An application that makes Web pages available for viewing by Web browsers using the HTTPS protocol. See Web server. serial port An I/O port used most often to connect a modem to your system. You can usually identify a serial port on your system by its 9-pin connector.
shadowing A computer's system and video BIOS code is usually stored on ROM chips. Shadowing refers to the performance-enhancement technique that copies BIOS code to faster RAM chips in the upper memory area (above 640 KB) during the boot routine. SIMD Abbreviation for Single Instruction Multiple Data. SIMM Acronym for single in-line memory module. A small circuit board containing DRAM chips that connects to the system board.
SNMP Abbreviation for Simple Network Management Protocol. SNMP, a popular network control and monitoring protocol, is part of the original TCP/IP protocol suite. SNMP provides the format in which vital information about different network devices, such as network servers or routers, can be sent to a management application. SNMP trap A notification (event) generated by the RAC or ESM that contains information about state changes on the managed system or about potential hardware problems.
SSL Abbreviation for secure socket layer. state Refers to the condition of an object that can have more than one condition. For example, an object may be in the not ready state. status Refers to the health or functioning of an object. For example, a temperature probe can have the status normal if the probe is measuring acceptable temperatures. When the probe begins reading temperatures that exceed limits set by the user, it reports a critical status.
system board As the main circuit board, the system board usually contains most of your system's integral components, such as the following: • Microprocessor • RAM • Controllers for standard peripheral devices, such as the keyboard • Various ROM chips Frequently used synonyms for system board are motherboard and logic board. system configuration information Data stored in memory that tells a system what hardware is installed and how the system should be configured for operation.
TAP Abbreviation for Telelocator Alphanumeric Protocol, which is a protocol used for submitting requests to a pager service. TCP/IP Abbreviation for Transmission Control Protocol/Internet Protocol. A system for transferring information over a computer network containing dissimilar systems, such as systems running Windows and UNIX®. termination Some devices (such as the last device at each end of a SCSI cable) must be terminated to prevent reflections and spurious signals in the cable.
• LowerThresholdCritical • LowerThresholdFatal time-out A specified period of system inactivity that must occur before an energy conservation feature is activated. tpi Abbreviation for tracks per inch. TQFP Abbreviation for thin quad flat pack. TSR Abbreviation for terminate-and-stay-resident. A TSR program runs in the background.
unicode A fixed width, 16-bit world wide character encoding, developed and maintained by the Unicode Consortium. UPS Abbreviation for uninterruptible power supply. A battery-powered unit that automatically supplies power to your system in the event of an electrical failure. URL Abbreviation for Uniform Resource Locator (formerly Universal Resource Locator). USB Abbreviation for Universal Serial Bus.
Validation Process of checking a command. varbind An algorithm used to assign an object identifier (OID). The varbind gives rules for arriving at the decimal prefix that uniquely identifies an enterprise, as well as the formula for specifying a unique identifier for the objects defined in that enterprise's MIB. variable A component of a managed object.
video adapter The logical circuitry that provides—in combination with the monitor—your system's video capabilities. A video adapter may support more or fewer features than a specific monitor offers. Typically, a video adapter comes with video drivers for displaying popular application programs and operating systems in a variety of video modes. On some systems, a video adapter is integrated into the system board. Also available are many video adapter cards that plug into an expansion-card connector.
virtual memory A method for increasing addressable RAM by using the hard drive. For example, in a system with 16 MB of RAM and 16 MB of virtual memory set up on the hard drive, the operating system would manage the system as though it had 32 MB of physical RAM. virus A self-starting program designed to inconvenience you. Virus programs have been known to corrupt the files stored on a hard drive or to replicate themselves until a computer system or network runs out of memory.
W Abbreviation for watt(s). Wakeup on LAN The ability for the power in a client station to be turned on by the network. Remote wake-up enables software upgrading and other management tasks to be performed on users' machines after the work day is over. It also enables remote users to gain access to machines that have been turned off. Intel calls remote wake-up Wake-onLAN. WAN Abbreviation for wide area network.
Windows 95 An integrated and complete Microsoft Windows operating system that does not require MS-DOS and that provides advanced operating system performance, improved ease of use, enhanced workgroup functionality, and simplified file management and browsing. Windows NT High-performance server and workstation operating system software developed by Microsoft that is intended for technical, engineering, and financial applications. write-protected Read-only files are said to be write-protected.
Index D O disk partitioning UPINIT, 163 options RACADM, 172 disk partitioning utilities, 11 options and arguments RAIDCFG, 118 UPINIT, 164 disk partitioning utility, 11 DTK utilities overview, 10 E error codes, 311 error messages, 19, 311 overview DTK utilities, 10 R RAC configuration utilities RACADM, 11 RAC configuration utility, 11 F features RACADM, 171 RAIDCFG, 117 SYSCFG, 21 UPINIT, 163 M messages and codes, 311 RACADM, 171 features, 171 options, subcommands, and arguments, 176 RACADM subc
RAID configuration utility RAIDCFG, 10 RAIDCFG, 117 error codes and messages, 321 features, 117 options and arguments, 118, 124 supported RAID controllers, 117, 163, 171 replication, 11 requirements, 10 S utilities disk partitioning, 11 RAC configuration, 11 RACADM, 11, 171 RAIDCFG, 10, 117 SYSCFG, 10, 21 UPINIT, 163 utility UPINIT, 163 utility types RAID configuration, 10 system configuration and update, 10 supported systems, 10 SYSCFG, 21 error checking and messages, 311 features, 21 options and argume
