Dell™ OpenManage™ Deployment Toolkit Version 2.3 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 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 . . . . . . . . . . . . . . . . . . . . . . . . 16 16 16 17 17 . . . . . . . . . .
SYSCFG for BIOS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . Options for BIOS Configuration . . . . . . . . . . . . . . . . . . . . . . . SYSCFG for BMC and Remote Access Controller Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 SYSCFG for System Configuration . . . . . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . . . . . . . . . 68 . . . . . . . . . . . . . . . . . . . . . 68 75 76 . . . . . . . . . . . . . . . . . . . . .
UPINIT Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UPINIT Options and Arguments 6 . . . . . . . . . . . . . . . . . . . . . . . . 108 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 RACADM Features 108 RACADM Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A DRAC III and DRAC 4 Property Database Group and Object Definitions . . . . . . . . . . . . . . . . . . . . . . . . . DRAC III. . . . 135 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 idRacInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cfgMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
cfgDialupModemBaudRate (Read/Write) . . . . . . . cfgDialupDialInAuthType (Read/Write) . . . . . . . . . cfgDialupDialOutModemConnectTimeout (Read/Write) cfgRemoteHosts . . . . . . . . . 144 144 144 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 cfgRhostsSmtpEmailEnable (Read/Write) . . cfgRhostsFloppyTftpEnable (Read/Write) . . cfgRhostsFwUpdateTftpEnable (Read/Write) cfgRhostsSmtpServerIpAddr (Read/Write) . . cfgRhostsFloppyTftpIpAddr (Read/Write) . .
cfgTrapsFilterRacEventMask (Read/Write) . cfgTrapsFilterSysEventMask (Read/Write) . cfgDemandDial . . . . . . . . . . . . . . . . 155 155 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 156 156 157 157 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 cfgDemandDialIpAddr (Read/Write) . . . . . cfgDemandDialPhoneNumber (Read/Write) . cfgDemandDialPppUserName (Read/Write) .
cfgNetTuningTcpReXmtMin (Read/Write) cfgNetTuningTcpReXmtMax (Read/Write) cfgNetTuningTcpMsl (Read/Write) . . . . Tuning the RAC for Satellite Connectivity. cfgOobSnmp . . . . . . . . . . . . . . . . 165 165 166 166 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 167 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DRAC 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . idRacInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
cfgUserAdmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cfgTraps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 cfgSessionManagement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 190 190 190 191 191 . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 cfgTrapsDestIpAddr (Read/Write) . . . .
cfgNetTuningNicMtu (Read/Write) . . . . . . . cfgNetTuningIpTtl (Read/Write) . . . . . . . . cfgNetTuningIpReassTtl (Read/Write) . . . . . cfgNetTuningTcpSrttBase (Read/Write) . . . . cfgNetTuningTcpSrttDflt (Read/Write) . . . . . cfgNetTuningTcpReXmtMin (Read/Write) . . . cfgNetTuningTcpReXmtMax (Read/Write) . . . cfgNetTuningTcpMsl (Read/Write) . . . . . . . cfgNetTuningIpSubnetsAreLocal (Read/Write) Tuning the DRAC 4 for Satellite Connectivity . . cfgOobSnmp . . . . . . . . . . . . .
cfgRacVirtual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cfgActiveDirectory . 210 . . . . . . . . . . . . . . . . . . . . 210 210 211 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 cfgFloppyEmulation (Read/Write). cfgVirMediaDisable (Read/Write) cfgVirAtapiSrvPort (Read/Write) . cfgADRacDomain (Read/Write) . cfgADRacName (Read/Write) . . cfgADEnable (Read/Write) . . . . cfgADAuthTimeout (Read/Write) . cfgADRootDomain (Read/Write) . . . . . . . . . . . . .
C BMC Platform Events Filter Alert Messages . D Sample File Formats. . . . . . . . . . 243 . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Sample SYSCFG Utility .ini File Format E 245 Sample RAIDCFG Utility .ini File Format . . . . . . . . . . . . . . . . . . . . 259 Sample RACADM Utility .ini File Format . . . . . . . . . . . . . . . . . . . 260 Summary of SYSCFG and RAIDCFG Options SYSCFG Options . . . . . . . . . . 265 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Introduction Overview 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.
Supported Systems Table 1-1 lists the PowerEdge systems for DTK version 2.3. Table 1-1. Supported Systems DTK Version 2.
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.
RACADM Replication The RACREP.BAT sample script applies RAC configuration options to the target system based on the configuration information that has been saved in a configuration file. User input is optional, depending on variables set in the RACREP.BAT sample script. This script uses the RACADM.EXE utility to configure the RAC in the target system using the RAC configuration file, raccfg.ini. The raccfg.ini configuration file is passed as the first parameter to the RACREP.BAT script.
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. 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. o Generic single-character designation for an option.
Command Line Option Delimiters • Single-character options are prefixed with a preceding hyphen (-). • Multi-character options are prefixed with two (2) preceding hyphens (--). Example: utilname -o --option Table 2-2 lists some examples of valid and invalid DTK command lines. Table 2-2.
File Input and Output Commands • File input is specified by the -i command, where is the name of the input file. • File output is specified by the -o command, where is the name of the output file. Log Files The -l or --logfile option records information output on the command line to the specified log file. Each new line of output is preceded by a time stamp. If the log file already exists, information is appended to the file.
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 Description No option NA NA If an option is not given, the SYSCFG utility outputs usage information.
Table 3-1. SYSCFG General Options (continued) Options Suboptions Valid Arguments Description --envar valid filename valid path media should be writable 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 none or 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 Description -l or --logfile NA This option logs the command line output to a time-stamped 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 the standard output, plus timestamp information. Users should use this option instead of redirection for task diagnosis. This option can be replicated.
SYSCFG for BIOS Configuration SYSCFG uses BIOS interfaces to manipulate boot order and BIOS settings. It configures all options available on the BIOS setup screen, including boot order, embedded device configuration, and asset tag management. Options for BIOS Configuration Table 3-2 documents valid options and arguments along with a description of their expected behavior. Options and arguments are case sensitive. All options and predefined arguments are lowercase unless stated otherwise.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --assignintr standard, distributed This option controls the interrupt assignment of PCI devices in the system. This option is set to standard by default, causing standard interrupt routing that uses interrupt A, B, C, D for all PCIe devices.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --bootseq numerical list, separated by commas Device Name Examples (continued) or list of device names, separated by commas 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 --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, serial2, This option configures or reports the communication port for console off, bmcsol, redirection.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --devseq numerical list, separated by commas This option sets the hard-drive sequence for a system. Without an argument, this option displays the device list. The argument must be formatted as a comma-separated numerical list of device index values. The list must be within the bounds of the current boot list. For example, the low and high numbers must match.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --embnic1 on, off, onnopxe This option turns the first embedded NIC on with PXE enabled, 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 --embnic2pxe enable, disable This option enables or disables PXE on the second embedded NIC. If PXE is disabled, the second NIC is not found in the boot order. If PXE is enabled, the second NIC is placed at the end of the boot order. This option is only present on systems that do not support the embnic2 option. This option can be replicated.
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 --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, 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 --lcd default, none, user This option selects whether to display the default string (model name and number) or a user-defined string in the front-panel LCD (Liquid Crystal Display). This option can be replicated. Example: A:>syscfg --lcd=default lcd=default --lcd1 This option sets the first line of user-defined text on the system LCD. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --memintleave enable, disable This option enables or disables the memory interleave mode. This option can be replicated. Example: A:>syscfg --memintleave=enable memintleave=enable --memtest enable, disable This option enables or disables the POST extended memory test.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --noraidprompt* NA This option specifies that the BIOS must not prompt for confirmation when changing the mode of a RAID controller. This option can only be used with the --embscsiraid or --embscsiraidchb options. 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 --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 --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 --sata1 auto, off This option enables or disables SATA port 1. This option can be replicated. Example: A:>syscfg --sata1=auto sata1=auto NOTE: This option maps to --sata_b for PowerEdge x9xx systems. --sata2 auto, off This option enables or disables SATA port 2. This option can be replicated.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --sata7 auto, off This option enables or disables SATA port 7. This option can be replicated. Example: A:>syscfg --sata_7=auto sata_7=auto NOTE: This option maps to --sata_h for PowerEdge x9xx systems. --snoopfilter enable, disable This option enables or disables the snoop filter option from the system BIOS.
Table 3-2. SYSCFG Options and Arguments for BIOS Configuration (continued) Option Valid Arguments Description --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 --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 --usbflash auto, fdd, hdd This option sets or reports the emulation for a USB flash device. The USB flash device can be set to emulate a hard drive (hdd) or a diskette drive (fdd). This option can be replicated. Example: A:>syscfg --usbflash=auto usbflash=auto --usbports enable, This option enables or disables USB ports.
SYSCFG for BMC and Remote Access Controller Configuration SYSCFG configures BMC and Remote Access Controller settings. NOTE: Some of the following options or arguments might not be available on all systems. NOTE: For options that use text strings such as username, password, hostname, and community string, using some characters such as , <, >, |, or = on the command line can be misinterpreted by the command line parser and cause errors.
Table 3-3. 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-3. 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-3. BMC and Remote Access Controller Configuration Options (continued) Options lancfgparams or lcp 50 SYSCFG Suboptions Valid Arguments 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-3. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description lancfgparams or lcp (continued) --autoneg enable, disable Enables or disables autonegotiation. --speed 10,100 --dnsdhcp enable, disable Enables or disables obtaining the DNS server IP address through DHCP. --dnsserver1 Sets the IP address of the primary DNS server for domain name resolution.
Table 3-3. BMC and Remote Access Controller Configuration Options (continued) Options lancfgparams or lcp (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-3. 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-3. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --loaddefaults* NA NA Restores the BMC to the defaults that were originally loaded on the controller. This option is used to return the BMC to a known-good state. 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-3. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments Description --nmibutton NA enable, disable This option enables or disables the NMI button. This option can be replicated. Example: A:>syscfg --nmibutton=enable nmibutton=enable passwordaction 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.
Table 3-3. BMC and Remote Access Controller Configuration Options (continued) Options pefcfgparams or pcp 56 SYSCFG Suboptions Valid Arguments Description Configures and displays PEF configuration parameters. This option can be replicated. fanfail, voltfail, discretevoltfail, tempwarn, tempfail, intrusion, redundegraded , redunlost, procwarn, procfail, powerwarn, powerfail, hardwarelogfail, autorecovery, batterywarn, batteryfail, powerabsent, procabsent Specifies a PEF value.
Table 3-3.
Table 3-3. 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-3. BMC and Remote Access Controller Configuration Options (continued) Options --serialchannelinfo or sci Suboptions Valid Arguments 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-3. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments serialcfgparams or scp (continued) --tmcfghandshakectrl enable, disable Sets the handshake control value for terminal mode configuration. This suboption can be replicated. --tmcfgnewlineseq noterm, crlf, null, cr, lfcr,1f --tmcfginputnewlineseq cr, null Description Sets the new line sequence value for terminal mode configuration. This suboption can be replicated.
Table 3-3. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments serialuseraccess or sua Description Configures the privilege level and channel accessibility associated with a specified User ID for the serial channel. This option can be replicated. --userid 2–10 if your system has a DRAC 4 controller Sets the User ID. This suboption can be replicated.
Table 3-3. BMC and Remote Access Controller Configuration Options (continued) Options Suboptions Valid Arguments solaction Description This option enables or disables Serial-Over-LAN (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-3. 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-3.
Table 3-3. 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-3. BMC and Remote Access Controller Configuration Options (continued) Options 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.
SYSCFG for State Configuration The SYSCFG utility allows the user to write a state data value on a system. This value is preserved across reboot or power-off operations. Users can use this state data value for storing important state information, such as the progress of a multi-reboot deployment process. SYSCFG Options for State Configuration Table 3-4 documents all valid options and arguments along with a description of the expected behavior of each option.
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-5 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-5. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --cpuspeed* None This option reports the speed of all processors in a system. Example: A:>syscfg --cpuspeed cpuspeed=1000MHz NOTE: The asterisk is not part of the command syntax. --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.
Table 3-5. 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.txt --pci PCI Bus: 2, Device: 4, Function: 0 Vendor: 8086 - Intel Corp.
Table 3-5. 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-5. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --pci * (continued) None Example 2 (the pci.
Table 3-5. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --pci* (continued) None Example 3 (a pci.
Table 3-5. 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-5. SYSCFG Options and Arguments for System Configuration (continued) Option Valid Arguments Description --sysname* None This function command reports the system identification string for a server, which is the string displayed under the Dell logo during POST. If used with the -s option, the environment variable is set to the system name. Example: A:>syscfg --sysname sysname=PowerEdge 1550/1000 NOTE: The asterisk is not part of the command syntax.
The pci.ids file is located at \DELL\TOOLKIT\TOOLS on Windows systems and /opt/dell/toolkit/bin on Linux systems. For more information and examples, see the --pci option in Table 3-3. Environment Variable File The environment variable file can be used for discovering and recording system information to environment variables. The file consists of several .ini-formatted sections that map PCI vendor/device numbers to environment variable values. The environment variable file is sys.
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.
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. The mr2kserv is a service that is automatically started by the DTK startup script. This service is required to configure all LSI RAID controllers in Windows PE.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -ac dvd Deletes a virtual disk. or or action deletevdisk See Table 4-7 for specific usage information. -ad NA Specifies an array disk command. See Table 4-5 for specific usage information. -ad ch:targ, ch:targ, ... Specifies an array disk. Optional. or or ch:targ:lun,... adisk or ch:targ:enc For SCSI controllers, the value of lun should always be 0.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description -fd ch:targ, ch:targ, ... Specifies the location of the failover drive in an array. Optional. or or ch:targ:lun,... For SCSI controllers, the value of lun should always be 0.
Table 4-1. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -si NA Does not display any information on the terminal console. Optional. or silent -sz Sets the maximum size on the virtual disk in MB or GB Optional. if the size is not provided. See Table 4-4 for The default size is in MB. If GB follows the number, specific usage the size is expressed in GB. information.
RAID Configuration Utility Options and Arguments The following tables document valid options, parameters, and arguments along with a description of the expected behavior of each option. Options, parameters, and predefined arguments are case sensitive and entered in lowercase, unless stated otherwise.
Enumerating RAID Controllers Table 4-3 lists the RAIDCFG options, parameters, and predefined arguments for enumerating RAID controllers. Table 4-3. Enumerating RAID Controllers Mandatory Options Optional and Arguments Parameters Valid Parameters Description Arguments -ctrl NA or NA Lists all the RAID controllers on the host system, along with select property information. This option is mandatory.
Table 4-3. Enumerating RAID Controllers (continued) Mandatory Options Optional and Arguments Parameters Valid Parameters Description Arguments -ctrl Controller_ID/Slot_ID: 6 or Controller_PCI_ID: 2:6:0 controller (continued) Controller_Name: PERC 4/SC Channels: 1 Virtual_Disks: 0 Firmware Version: 350O RAIDCFG Command successful! -c or controllerid specified controller ID. This option combination is mandatory.
Creating Virtual Disks Table 4-4 lists the RAIDCFG options, parameters, and predefined arguments for creating virtual disks. NOTE: If you create a virtual disk on Windows PE, you need to reboot your system. NOTE: On CERC SATA 1.5/2S, CERC SATA 1.5/6CH, and SAS 5/iR controllers, use the entire array disk to create a virtual disk. Table 4-4. Creating Virtual Disks Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ...
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ... -cp Sets the cache policy for the virtual disk. The valid arguments are: [or ch:targ:encl,...] d, c or d — (Direct I/O) Reads are not buffered in cache memory. cachepolicy or c — (Cache I/O) All reads are buffered in cache memory. NOTE: This option is not supported on the following controllers: CERC SATA 1.
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ... -r Sets the RAID type or level for the virtual disk. The valid arguments are: [or ch:targ:encl,...] or controller action= createvdisk controllerid=id adisk= channel:target:lun, channel:target:lun,... [or channel:target: enclosure,...
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ... -rp Sets the SCSI read policy for the virtual disk. Specify the SCSI read policy for the logical drive. The valid arguments are: [or ch:targ:encl,...] or or readpolicy controller action= createvdisk controllerid=id adisk= channel:target:lun, channel:target:lun,... [or channel:target: enclosure,...
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ... -sp Creates a virtual disk comprised of the properties supplied. The -sp option is optional and can be the added to the command line in any order after the mandatory option combination. NOTE: Spanlength is applicable only for RAID 50. The minimum permissible spanlength value is 3.
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ... -sz 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. The -sz option is optional and can be the added to the command line in any order after the mandatory option combination. [or ch:targ:encl,...
Table 4-4. Creating Virtual Disks (continued) Mandatory Options and Arguments Optional Valid Parameter Parameters Arguments Description -ctrl -ac=cvd -c=id -ad= ch:targ,ch:targ, ... -wp Sets the write policy for the virtual disk. The valid arguments are: [or ch:targ:encl,...] or controller action= createvdisk controllerid=id adisk= channel:target:lun, channel:target:lun,... [or channel:target: enclosure,...
Enumerating Array Disks Table 4-5 lists the RAIDCFG options, parameters, and predefined arguments for enumerating array disks (hard drives). Table 4-5. Enumerating Array Disks (Hard Drives) Mandatory Options Optional and Arguments Parameter Valid Parameter Description Arguments -ad -c=id NA or adisk controllerid= id NA Lists all the array disks attached to the specified RAID controller. This option combination is mandatory.
Table 4-5.
Table 4-5.
Table 4-5. Enumerating Array Disks (Hard Drives) (continued) Mandatory Options Optional and Arguments Parameter -ad -c=id or Valid Parameter Description Arguments -ad= id vdisk=id channel:target,... Displays information about the specified array disk. This option combination is mandatory.
Enumerating Virtual Disks Table 4-6 lists the RAIDCFG options, parameters, and predefined arguments for enumerating virtual disks. Table 4-6. Enumerating Virtual Disks Mandatory Options Optional and Arguments Parameter Valid Parameter Arguments Description -vd NA or 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 Optional and Arguments Parameter Valid Parameter Arguments Description -vd -c or or vdisk controllerid Lists all the virtual disks under the indicated controllers. Each virtual disk is displayed with the physical disk that comprises it. The -c option is optional and can be added to the command line in any order after the mandatory option.
Deleting Virtual Disks Table 4-7 lists the RAIDCFG options, parameters, and predefined arguments for deleting virtual disks. NOTE: If you delete a virtual disk on PERC 4/IM on Windows PE, you need to reboot the system. Table 4-7. Deleting Virtual Disks Mandatory Options Optional Valid Parameter and Arguments Parameter Arguments Description -vd -ac=dvd -c=id NA Deletes all virtual disks on the indicated controller. This option combination is mandatory.
Setting Environment Variables Table 4-8 lists the RAIDCFG options, parameters, and predefined arguments for setting the CLI environment. Table 4-8. Setting Environment Mandatory Options Optional and Arguments Parameter Valid Parameter Description 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. Function Calls of the setenvironment Option Function Call Description getfirmware Returns the firmware version of the specified controllers. Example: A:>raidcfg -se -envn=FIRMWARE -envc=getfirmware -c=2 FIRMWARE=531T RAIDCFG command successful! getcontrollertype Returns LSI for LSI controllers and ADAP for Adaptec controllers.
Table 4-9. Function Calls of the setenvironment Option (continued) Function Call Description gethotspares Returns the global hotspares (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.
Table 4-10. RAID Replication Options (continued) Mandatory Optional Options and Parameters Arguments Valid Parameter Arguments Description -o Reads the RAID configurations from all available controllers and writes these configurations in the raid.ini file under the /tmp directory (in Linux systems). This option is mandatory. NA Example: A:> raidcfg -o=/tmp/raid.ini The contents of the raid.
Miscellaneous Options Table 4-11 lists all other RAIDCFG options, parameters, and predefined arguments. Table 4-11. Miscellaneous Optional Parameters Mandatory Options Optional and Arguments Parameter Valid Parameter Description Arguments any -l or logfile Logs command line output to a file. The utility either appends the information to an existing log file or creates a new file. The log file contains the same information as standard output.
Table 4-11. Miscellaneous Optional Parameters (continued) Mandatory Options Optional and Arguments Parameter Valid Parameter Description Arguments any NA -si or silent 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. Example: A:>raidcfg -ctrl -si RAIDCFG command successful! any -ver NA or version Displays the version number of the RAIDCFG utility.
Table 4-12. Basic RAIDCFG Commands (continued) Purpose Command Description To create a virtual disk of a certain raidcfg -ctrl -ac=cvd size with all the default settings -c=slotid -ad= x:y,x:y,... -sz=5GB Creates a virtual disk of 5GB size for type RAID 0. RAID 0 is the default. To create a virtual disk of a certain raidcfg -ctrl -ac=cvd size and make it RAID 1 -c=slotid -ad=x:y,x:y -sz=5GB -r=1 Creates a virtual disk of 5GB size for type RAID 1.
Table 4-12. Basic RAIDCFG Commands (continued) Purpose Command Description To view all the virtual disks in a system raidcfg vdisk Lists the virtual disks on a system for all RAID controllers. To view all the virtual disks for a specific controller raidcfg vdisk -c= slotid Lists all the virtual disks on a specific controller. The slot ID in <-c=slotid> is obtained from the first command.
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.
UPINIT Dependencies In Linux, UPINIT looks for the following files: • mbr file in the dell/drmk directory • sysdrmk in the dell/toolkit/bin directory In Windows, UPINIT looks for the following files: • createup.cfg, mountup.cfg, umountup.cfg, listup.cfg in the DELL\TOOLKIT\TEMPLATE\SCRIPTS directory • sysdrmk.exe in the DELL\TOOLKIT\TOOLS directory UPINIT Options and Arguments Table 5-1 lists the valid options and arguments for the UPINIT utility. Table 5-1.
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. UPINIT Options and Arguments (continued) Option Valid Arguments Description Linux Example: upinit version 1.0 © 2005 Dell Inc. All rights reserved This utility creates a utility partition for your system. This utility requires a Utility Partition image file which can be found on your Dell PowerEdge Installation and Server Management CD. For more information, please consult the Deployment Toolkit Documentation. Usage: upinit.
Table 5-1. UPINIT Options and Arguments (continued) Option Valid Arguments Description size integer, required The size of the utility partition to create. The created utility will be at least the size specified by size and be as close to actual size as drive geometry will allow. Example: A:> upinit --disk=0 --size=32 --file=c:\upimage.bin file string, required Specifies a file that will be decompressed onto 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 and Arguments RACADM Subcommands Short Description NA racdump Displays status and general RAC information. See "racdump" for more information about the subcommand options and arguments. NA racreset Resets the RAC. See "racreset" for more information about the subcommand options and arguments. NA racresetcfg Resets all database configuration parameters to default values; equivalent to a soft reset.
RAC Configuration Utility Options, Subcommands, and Arguments The following sections document all valid options, subcommands, and arguments along with a description of the expected behavior of many option-subcommand-argument combinations. Options, subcommands, and arguments are case sensitive. All options, subcommands, and predefined arguments are lowercase unless explicitly stated otherwise.
racadm Options The base racadm command has the following options and arguments: Table 6-3. Base racadm Command Options and Arguments Option Description -l Specifies the log level for debug. NOTE: Ensure that you run this option from a writable folder. -v Specifies the verbose level for screen output. -L Specifies a debug log file. Enabling and Disabling Remote Security NOTE: It is recommended that you run these commands on your local system.
racadm Subcommands/Arguments Table 6-5. racadm Subcommands and Arguments Command Description config/getconfig Configures the RAC and displays the RAC configuration. fwupdate Executes or gets status on RAC firmware updates. getsysinfo Displays general RAC and system information. getraclog Lists RAC subcommands. getraclog Lists usage statement for the specified subcommand. racdump Dumps RAC status and state information for debug. racreset Resets the RAC.
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.
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 . The created file is a format that can be used with the racadm config -f command.
• racadm getconfig -f myrac.cfg Reads all of the configuration objects, from all of the RAC group configuration parameters and place them in a file called myrac.cfg. • racadm config -f myrac.cfg Configures or reconfigures the RAC. The myrac.cfg file may be created from the command specified in the previous example if the RAC has a desired configuration to be replicated. The myrac.cfg file may also be edited manually as long as the parsing rules are followed. NOTE: The myrac.
• Instruct the DRAC 4 firmware to get the firmware update file from a TFTP server and load it into the RAM disk area. The user may specify the IP address and path/filename or IP address and directory, or use the default values found in the database. The user may also specify that the update be started after loading, or to terminate and make a separate call to start the update process. • Load the update file into the DRAC 4 RAM disk area. Input Table 6-10 describes the fwupdate subcommand 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.
Example: racadm fwupdate -p -u -d \my\updatefiles\path racadm fwupdate -p -u -f \my\updatefiles\path\ If you are updating your firmware remotely, use the following command to update your firmware: racadm -u -p fwupdate -g -u -a -d NOTE: The -p option does not support remote firmware updates. getssninfo Table 6-11.
Output None Examples • racadm getssninfo Session table summary status: 1 VALID 15 AVAILABLE Type User IP Address ---------- --------- --------------- --------------- ------------ Web RAC • racadm getssninfo root 192.168.1.23 Login Date/Time Consoles 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.
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.
Examples • racadm getsysinfo -A -w -s "123456" "PowerEdge 1650" "A08" "EF23VQ-0023" "" 0x100 "Server1" "Microsoft Windows 2000 version 5.0, Build Number 2195, Service Pack 2" "1.60" "Watchdog Info:" 2 39 40 • racadm getsysinfo -w -s System Information: System ID = 123456 System Model = PowerEdge 1650 BIOS Version = A08 Asset Tag = EF23VQ-0023 Service Tag = 2MP9Z01 Hostname = Server1 OS name = Microsoft Windows 2000 version 5.0, Build 2195 Service Pack 2 ESM Version = 1.
Synopsis racadm getraclog -i racadm getraclog [-A] [-c count] \[-s start-record] [-v] [-V] [-m] 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.
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.
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.
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.
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. The database has default properties for all entries that are used to restore the card back to its original default settings.
Input Table 6-24. setrac Subcommand Options Option Description -h Gets the Hostname from the managed system and writes it to the RAC. This parameter is available for viewing using the getsysinfo command, and under the object ID interface using config/getconfig as [ifcRacManagedNodeOs] ifcRacMnOsHostname. -o Gets the OS Name from the managed system and writes it to the RAC.
RACADM
DRAC III and DRAC 4 Property Database Group and Object Definitions The Dell Remote Access Controller (DRAC) III and DRAC 4 property database contain the configuration information for the DRAC III and DRAC 4 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.
idRacProductInfo (Read Only) Valid Values String of up to 63 ASCII characters. Default RAC Description Identifies the product using a text string. idRacDescriptionInfo (Read Only) Valid Values String of up to 255 ASCII characters. Default RAC Description A text description of the RAC type. idRacVersionInfo (Read Only) Valid Values String of up to 63 ASCII characters. Default RAC firmware version x.
Description A user-assigned name to identify this controller. idPcmciaInfo (Read Only) Valid Values String of up to 63 ASCII characters. Default Null string Description Text description of the PCMCIA modem card. idRacMisc (Read/Write) Valid Values String of up to 63 ASCII characters. Default Null string Description Generic property undefined at this release. cfgMonitor This group contains parameters to configure the monitoring of the optional external AC power adapter and the onboard battery.
Description 0=disable, do not monitor the external power source. 1=always monitor the external power source. 2=only monitor the external power source if it is connected. cfgMonitorBatteryRule (Read/Write) Valid Values 0x1 Default 0x1 Description The battery is not optional at the first release. 1=always monitor the onboard battery. cfgLanNetworking This group contains parameters to configure the RAC network adapter interface. One instance of the group is allowed.
cfgNicIpAddress (Read/Write) Valid Values A string of "." separated numeric fields containing the static IP address. Default 192.168.20.1 Description The IP address of the RAC network adapter. cfgNicNetmask (Read/Write) Valid Values A string of "." separated numeric fields containing the static network mask. Default 255.255.255.0 Description The network mask used by the RAC network adapter. NOTE: This object requires a RAC reset before it becomes active.
cfgNicUseDhcp (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default 0 Description 0=use the static RAC network adapter parameters described above. 1=use DHCP and obtain the necessary parameters from the DHCP server for the RAC network adapter. cfgCurrentLanNetworking This group contains parameters that are currently in use by the RAC network adapter interface. One instance of the group is allowed. The following subsections describe the objects in this group.
cfgNicCurrentGateway (Read Only) Valid Values A string of "." separated numeric fields containing the gateway address. Default None Description The current gateway used by the RAC network adapter. cfgNicCurrentDhcpWasUsed (Read Only) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default None Description Indicates whether or not DHCP was used to configure the network adapter. 0=IP address is static. 1=IP address was obtained from a DHCP server.
Description 0=enable 1=disable the dial in capabilities. cfgDialupDialOutEnable (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default 1 Description 0=enable 1=disable the dial out capabilities. cfgDialupDialInDhcpEnable (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default 0 Description 0=enable 1=disable Gets the IP address from the DHCP server to become the PPP IP address(es).
Description 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, cfgDialupDialInDfltIpAddr is used instead. For more information, see the Dell™ Remote Access Controller Installation and Setup Guide. cfgDialupDialInDfltIpAddr (Read/Write) Valid Values A string of "." separated numeric fields containing the IP address.
cfgDialupDialType (Read/Write) Default 0x1 Description 0x0=pulse, 0x1=tone (Enter hexadecimal values.) cfgDialupModemInitString (Read/Write) Valid Values String of up to 63 ASCII characters meaningful to the modem. Default ATL1M1X3E0S0=2 Description A command string passed to the modem to initialize it. cfgDialupModemBaudRate (Read/Write) Default 0x9600 or 38400 Description Baud rate of the modem. (Enter hexadecimal values.
Description 0=infinite, otherwise, the maximum time in seconds that the link will stay connected before the connection is terminated. (Enter hexadecimal values.) cfgRemoteHosts The group contains parameters to configure various firmware update loading, remote floppy boot, IP addresses, enables, and so on. One instance of the group is allowed. The following subsections describe the objects in this group. cfgRhostsSmtpEmailEnable (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE).
Default 1 Description 0=disable, 1=enable loading the firmware update file through TFTP. This object requires a RAC reset before it becomes active. cfgRhostsSmtpServerIpAddr (Read/Write) Valid Values A string of "." separated numeric fields containing the IP address. Default 127.0.0.1 Description The IP address of the server used in e-mail alerts. This object requires a RAC reset before it becomes active. cfgRhostsFloppyTftpIpAddr (Read/Write) Valid Values A string of ".
Description The path name pointing to the remote floppy boot image. If this is a filename only, the path needs to be specified in the TFTP server, or the entire path can be specified here. NOTE: The server may still require you to specify the drive, such as C drive. cfgRhostsFwUpdateIpAddr (Read/Write) Valid Values A string of "." separated numeric fields containing the IP address. Default 192.168.0.4 Description The address of the TFTP server where the firmware update image is located.
Default None Description The name of the user for this index. The user index is created by writing a 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. NOTE: This command is the anchor for this indexed group. cfgUserAdminPassword (Write Only) Valid Values A string of up to 255 ASCII characters. Default None Description The password for this user.
Description See "RAC-Generated Event Mask Definitions" in the Dell Remote Access Controller Racadm User's Guide. (Enter hexadecimal values.) cfgUserAdminPageNumericEnable (Read/Write) NOTE: This object property is for the DRAC III controller only. Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default 0 Description 0=disable, 1=enable numeric paging on a per user basis. cfgUserAdminPageNumericNumber (Read/Write) NOTE: This object property is for the DRAC III controller only.
Description 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 three-decimal 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 (dotted-decimal notation with the dots deleted). NOTICE: It is possible to overflow the number of digits that a numeric pager can handle.
Default "" Description See "Telephone Number Properties" in the Dell Remote Access Controller Racadm User's Guide for valid telephone number characters. cfgUserAdminPageAlphaProtocol (Read/Write) NOTE: This object property is for the DRAC III controller only. Valid Values 8N1 or 7E0 Default 8N1 Description Number of data bits, N=no parity, E=even parity, number of stop bits. cfgUserAdminPageAlphaBaudRate (Read/Write) NOTE: This object property is for the DRAC III controller only.
Description User-defined message to be sent on an alpha page. cfgUserAdminPageAlphaModemConnectTimeout (Read/Write) NOTE: This object property is for the DRAC III controller only. Valid Values Integer from 0 to any positive number. Default 0x3C or 60 Description 0=infinite (The time in seconds that the remote system has to answer the telephone.) (Enter hexadecimal values.) cfgUserAdminPageAlphaPagerId (Read/Write) NOTE: This object property is for the DRAC III controller only.
cfgUserAdminEmailEnable (Read/Write) Valid Values Boolean either 1 or 0 (TRUE or FALSE). Default 0 Description 0=disable, 1=enable e-mail alerting on a per user basis. cfgUserAdminEmailAddress (Read/Write) Valid Values A string of up to 63 ASCII characters. Default "" Description Standard e-mail address, such as john_doe@mycompany.com. cfgUserAdminEmailCustomMsg (Read/Write) Valid Values A string of up to 31 ASCII characters.
Default AT+GCI=B5 Description Characters that make up a valid modem initialization string. cfgTraps This group contains parameters to configure the delivery of SNMP traps. Sixteen instances of this group are allowed, which represent sixteen unique trap destinations. The following subsections describe the objects in this group. cfgTrapsDestIpAddr (Read/Write) Valid Values A string of "." separated numeric fields containing the IP address. Default "" Description IP address of an SNMP trap daemon.
Default "" Description A SNMP community name. cfgTrapsFilterRacEventMask (Read/Write) Valid Values See "RAC-Generated Event Mask Definitions" in the Dell Remote Access Controller Racadm User's Guide. Default 0x777777 Description See "RAC-Generated Event Mask Definitions" in the Dell Remote Access Controller Racadm User's Guide. (Enter hexadecimal values.
cfgDemandDialIpAddr (Read/Write) Valid Values A string of "." separated numeric fields containing the IP address. Default "" Description This address is the destination IP address. This IP address may not be the IP address of the system that responds to the telephone number. However, the system that responds to the telephone number must be able to route to this IP address. NOTE: This object is the anchor for this indexed group.
cfgDemandDialPppPassword (Read/Write) Valid Values A string of up to 31 ASCII characters. Default "" Description Password for PPP authentication. cfgAuthType (Read/Write) Valid Values 0, 1, 2 Default 0x0 Description PPP authentication type; 0=Any (including clear text), 1=CHAP, 2=MS CHAP (MS CHAP is not supported.) (Enter hexadecimal values.) cfgDialinUsers This group contains parameters to configure the dial in PPP authentication capability of the DRAC III.
Description User name for PPP authentication. NOTE: This object is the anchor for this indexed group. cfgDialinUsrPppUserPassword (Read/Write) Valid Values A string of up to 15 ASCII characters. Default "" Description Password for PPP authentication. cfgDialinUsrCallbackType (Read/Write) Default 0x0 Description 0=None, 1=Admin preset, 2=User-specified. Used by the callback control protocol (CBCP). (Enter hexadecimal values.
cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to the RAC. One instance of the group is allowed. All objects in this group require a RAC reset before they become active. The following subsections describe the objects in this group.
cfgSerial This group contains configuration parameters for the system external serial port or DRAC III VT-100 serial connector. One instance of the group is allowed. The following subsections describe the objects in this group. cfgSerialBaudRate (Read/Write) NOTE: For best results redirecting BIOS System Setup, Dell recommends using 115200. For the DRAC III controller, Dell recommends using 9600.
Description Terminates text console redirection when using VT-100. cfgSerialConsoleIdleTimeout (Read/Write) Valid Values Integer from 1 to any positive number. (Enter hexadecimal values.) Default 0x12c Description The maximum amount of line idle time (in seconds) before the line is disconnected. (Enter hexadecimal values.
cfgSerialConsoleCommand (Read/Write) Description 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. Default Empty string (no command). Example connect com2 cfgSerialTelnetEnable (Read/Write) Description Enables/disables Telnet console.
Valid Values 0=VT100 graphics mode, 1=ANSI graphics mode. cfgSerialTelnetColor (Read/Write) Description Enables/disables the Telnet text console color when connecting using the connect video command. Default 1 Valid Values 0=monochrome, 1=color cfgSerialTelnetAnsi (Read/Write) Description Enables/disables the Telnet text console ANSI graphics mode when connecting using the connect video command. Default 1 Valid Values 0=VT-100 graphics mode, 1=ANSI graphics mode.
cfgNetTuning The group contains parameters to tune the RAC network configuration. One instance of the group is allowed. All objects in this group require a RAC reset before they become active. The following subsections describe the objects in this group. cfgNetTuningNicMtu (Read/Write) Valid Values Integer from 576 to 1500. Default 0x5dc (1500) Description The size in bytes of the maximum transmission unit used by the RAC network adapter. (Enter hexadecimal values.
cfgNetTuningTcpSrttBase (Read/Write) Valid Values Integer from 0 to 256. Default 0x0 (0) Description The smoothed round trip time-out base minimum value for TCP round trip retransmission time in ½ second units. (Enter hexadecimal values.) cfgNetTuningTcpSrttDflt (Read/Write) Valid Values Integer from 6 to 384. Default 0x6 (6) Description The smoothed round trip time-out base default value for TCP retransmission round trip time in ½ second units. (Enter hexadecimal values.
Default 0x80 (128) Description The maximum number of TCP retransmission time in ½ second units. (Enter hexadecimal values.) cfgNetTuningTcpMsl (Read/Write) Valid Values Integer from 60 to 240. Default 0x3c (60) Description The maximum TCP segment lifetime in ½ second units. (Enter hexadecimal values.) Tuning the RAC for Satellite Connectivity The RACADM.EXE utility may be used to modify the network tuning properties of the RAC. It is also possible to use the racadm.
Table A-1. RAC Properties for Satellite Connectivity (continued) Property Normal Value Satellite Value cfgNetTuningTcpSrttBase 0 0x100 cfgNetTuningTcpSrttDflt 0x6 0x180 cfgNetTuningTcpReXmtMin 0 0 cfgNetTuningTcpReXmtMax 0x80 0x400 cfgNetTuningTcpMsl 0x3c 0xf0 NOTICE: Although these parameters can be configured, it is recommended that you not use any other settings than those detailed here. Other settings may adversely affect the RAC's ability to communicate with other network nodes.
Description 0=disable, 1=enable the RAC SNMP agent. cfgRacTuning The group contains various tuning configuration parameters. One instance of the group is allowed. The following subsections describe the objects in this group. cfgRacTuneMnNwIpAddrBase (Read/Write) Valid Values A string of "." separated numeric fields containing the IP address. Default 192.168.234.235 Description A base of two IP addresses used for the PPP connection to the RAC. This object requires a RAC reset before it becomes active.
Description The user name used in FTP authentication. cfgRacTuneGenericFtpPasswd (Read/Write) Valid Values A string of up to 15 ASCII characters. Default racadm Description The user password. cfgRacTuneRemoteCrsPort (Read/Write) Valid Values Integer from 5900 to any positive valid port number. Default 0Validx45B86000 or 5900 Description The port connection from the browser to the firmware console redirection server. This object requires a RAC reset before it becomes active.
cfgRacTuneDialOutIdleTime (Read/Write) Valid Values Integer from 0 to any positive value. Default 0x28 or 40 Description 0=infinite, otherwise, when line is idle for this many seconds, the line is disconnected. This object requires a RAC reset before it becomes active. (Enter hexadecimal values.) cfgRacTuneDialOutMaxConnectTime (Read/Write) Valid Values Integer from 1 to 128.
cfgRacTuneRemoteRacadmEnable (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default 0 Description 0=disable, 1=enable This object requires a RAC reset before it becomes active. cfgRacTuneMnConsoleDisableAllowed Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default FALSE Description This command is applicable only to Microsoft® Windows® 2000 and Windows Server® 2003 operating systems.
ifcRacManagedNodeOs This group contains parameters to configure the RAC with managed system and operating system naming information. One instance of the group is allowed. The following subsections describe the objects in this group. ifcRacMnOsHostname (Read/Write) Valid Values A string of up to 255 ASCII characters. Default "" Description The host name of the managed system. ifcRacMnOsOsName (Read/Write) Valid Values A string of any ASCII characters.
cfgRacSecurity This group contains parameters to configure the RAC SSL (Secure Socket Layer) security features. cfgRacSecCapabilities (Read Only) Valid Values 0x1ff Default 0x1ff Description The current RAC security capability setting. cfgRacSecCsrKeySize (Read Only) Valid Values 512 or 1024 Default 1024 Description The Web SSL handshake RSA key size. cfgRacSecCsrCommonName (Read/Write) Valid Values A string of any ASCII characters.
cfgRacSecCsrOrganizationName (Read/Write) Valid Values A string of any ASCII characters. Default "" Description The CSR organization name. cfgRacSecCsrOrganizationUnit (Read/Write) Valid Values A string of any ASCII characters. Default "" Description The CSR organization unit. cfgRacSecCsrLocalityName (Read/Write) Valid Values A string of any ASCII characters. Default "" Description The CSR locality name. cfgRacSecCsrStateName (Read/Write) Valid Values A string of any ASCII characters.
Description The CSR state. cfgRacSecCsrCountryCode (Read/Write) Valid Values The two-letter country code. Default "" Description The CSR country code. cfgRacSecCsrEmailAddr (Read/Write) Valid Values A string of any ASCII characters. Default "" Description The CSR e-mail address. cfgRacSecVncInEncryptEnable (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default TRUE Description FALSE=disable, TRUE=enable Enables VNC (virtual network computing) console redirection encryption.
cfgRacSecAuthLocalRacEnable (Read Only) Valid Values 0x01 Default 0x01 Description Enables RAC local base authentication. cfgRacSecAuthLocalOsEnable (Read/Write) Valid Values Boolean, either 1 or 0 (TRUE or FALSE). Default TRUE Description FALSE=disable, TRUE=enable Enables RAC operating system base authentication. This object requires a RAC reset before it becomes active. DRAC 4 idRacInfo This group contains display parameters to provide information about the specifics of the DRAC 4 being queried.
Description Uses a text string to identify the product. idRacDescriptionInfo (Read Only) Legal Values String of up to 255 ASCII characters. Default RAC Description A text description of the RAC type. idRacVersionInfo (Read Only) Legal Values String of up to 63 ASCII characters. Default RAC Firmware Version x.x Description A string containing the current firmware version of the product, where x is the current revision.
idRacMisc (Read/Write) Legal Values String of up to 63 ASCII characters. Default Null string Description Generic property undefined at this release. idRacType (Read) Default 5 Description Identifies the remote access controller type as the DRAC 4. cfgLanNetworking This group contains parameters to configure the DRAC 4 NIC. One instance of the group is allowed. All objects in this group will require the DRAC 4 NIC to be reset, which may cause a brief loss in connectivity.
cfgDNSDomainName (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values String of up to 254 ASCII characters. At least one of the characters must be alphabetic. NOTE: Microsoft Active Directory® only supports Fully Qualified Domain Names (FQDN) of 64 bytes or fewer. Default MYDOMAIN Description The DNS domain name. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE) and if cfgDNSDomainNameFromDHCP is set to 0 (FALSE).
Description Registers the DRAC 4 name on the DNS server. cfgDNSServersFromDHCP (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Boolean, either 1 or 0 (TRUE or FALSE). Default 0 Description Retrieves DNS server addresses from the DHCP server. cfgDNSServer1 (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Any legal IP address. Default 192.168.0.
Description Retrieves the IP address for DNS server 2. This parameter is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE). NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses. cfgNicEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Boolean, either 1 or 0 (TRUE or FALSE). Default 1 Description 0=Disable. 1=Enable the DRAC 4 NIC.
Description The network mask used by the DRAC 4 NIC. cfgNicGateway (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of "." separated numeric fields containing the static gateway. Default 192.168.0.120 Description The gateway used by the DRAC 4 NIC. cfgNicUseDhcp (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
cfgCurrentLanNetworking This group contains parameters that are currently in use by the DRAC 4 NIC. One instance of the group is allowed. The following subsections describe the objects in this group. cfgNicCurrentIpAddress (Read Only) Legal Values A string of "." separated numeric fields containing the IP address Default None Description The current IP address of the DRAC 4 NIC. cfgNicCurrentNetmask (Read Only) Legal Values A string of "." separated numeric fields containing the network mask.
cfgNicCurrentDhcpWasUsed (Read Only) Legal Values Boolean, either 1 or 0 (TRUE or FALSE). Default None Description Indicates whether or not DHCP was used to configure the NIC. 0 = IP address is static 1 = IP address was obtained from a DHCP server. cfgDNSCurrentDomainName (Read Only) Description Current DNS domain name. cfgDNSCurrentServer1 (Read Only) Description Current IP address used for DNS Server 1. cfgDNSCurrentServer2 (Read Only) Description Current IP address used for DNS Server 2.
Default 1 Description 0=disable, 1=enable the SMTP protocol to send e-mail alerts. cfgRhostsSmtpServerIpAddr (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of "." separated numeric fields containing the IP address. Default 127.0.0.1 Description The IP address of the server used in e-mail alerts. cfgRhostsFwUpdateTftpEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
Description The address of the TFTP server where the firmware update image is located. cfgRhostsFwUpdatePath (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values String of up to 255 ASCII characters that designate a valid path name. Default "" Description 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.
Table A-2. Bit Masks for User Privileges User Privilege Bit Mask Log In To DRAC 4 0x80000001 Configure DRAC 4 0x80000002 Configure Users 0x80000004 Clear Logs 0x80000008 Execute Server Control Commands 0x80000010 Access Console Redirection 0x80000020 Access Virtual Media 0x80000040 Test Alerts 0x80000080 Execute Debug Commands 0x80000100 cfgUserAdminUserName (Read/Write) NOTE: To modify this property, you must have Configure Users permission.
Description The password for this user. The user passwords are encrypted and cannot be seen or displayed after this property is written. cfgUserAdminAlertFilterRacEventMask (Read/Write) NOTE: To modify this property, you must have Configure Users permission. Legal Values See "DRAC 4-Generated Event Mask Definitions." Default 0x777777 Description See "DRAC 4-Generated Event Mask Definitions." (Type hexadecimal values.
cfgUserAdminEmailAddress (Read/Write) NOTE: To modify this property, you must have Configure Users permission. Legal Values A string of up to 63 ASCII characters. Default "" Description Standard e-mail address, such as john_doe@mycompany.com. cfgUserAdminEmailCustomMsg (Read/Write) NOTE: To modify this property, you must have Configure Users permission. Legal Values A string of up to 31 ASCII characters. Default "" Description User-defined message to be sent on an e-mail alert.
Legal Values A string of "." separated numeric fields containing the IP address. Default "" Description IP address of an SNMP trap daemon. NOTE: This object is the anchor for this indexed group. cfgTrapsEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Boolean, either 1 or 0 (TRUE or FALSE). Default 1 Description 0=Disabled, 1=Enabled for this indexed entry.
Legal Values See "DRAC 4-Generated Event Mask Definitions." Default 0x300000 Description See "DRAC 4-Generated Event Mask Definitions." (Type hexadecimal values.) cfgTrapsFilterSysEventMask (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values See "DRAC 4-Generated Event Mask Definitions." Default 0x77777 Description See "DRAC 4-Generated Event Mask Definitions." (Type hexadecimal values.
cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to the DRAC 4. One instance of the group is allowed. All objects in this group require a DRAC 4 reset before they become active. The following subsections describe the objects in this group. cfgSsnMgtMaxSessions (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
Default 0x12C seconds (5 minutes) Description Defines the Secure Shell (SSH) idle 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). cfgSerial This group contains configuration parameters for the system external serial port.
cfgSerialConsoleQuitKey (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of 3 or fewer characters. Default The <~><.> key combination The key represents a carriage return; press as a substitute for . Description This key sequence terminates text console redirection when using VT-100. cfgSerialConsoleIdleTimeout (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
cfgSerialConsoleNoAuth (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 0 – Login prompt is Enabled on the serial shell. 1 – Login prompt is Disabled on serial shell. Default 0 Description Allows you to disable authentication on the serial shell. cfgSerialConsoleCommand (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
cfgSerialSshEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 0=disabled, 1=enabled Default 1=enabled Description Enables/disables secure shell on the DRAC 4. cfgSerialTelnetEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
Description When enabled, the DRAC 4 will interpret 0x7f characters as backspaces from a telnet session. Some telnet clients send 0x7f characters when you press . Normally, when you press , 0x08 characters are sent. Default 0 Legal Values 0=Disabled, 1=Enabled cfgNetTuning The group contains parameters to tune the DRAC 4 network configuration. One instance of the group is allowed. All objects in this group require a DRAC 4 reset before they become active.
Description Sets the DRAC 4 link speed to 100 Mbit (1) or 10 Mbit (0). cfgNetTuningNicFullDuplex (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 1 or 0 Default 1 Description Sets the duplex to full duplex(1) or half duplex (0). cfgNetTuningNicMtu (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Integer from 576 to 1500. Default 0x5dc (1500).
cfgNetTuningIpReassTtl (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Integer from 60 to 240. Default 0x3c (60) Description The maximum IP packet fragment reassembly time in ½ second units. (Type hexadecimal values.) cfgNetTuningTcpSrttBase (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Integer from 0 to 256.
cfgNetTuningTcpReXmtMin (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Integer from 2 to 1024. Default 0x2 (2) Description The minimum number of TCP retransmission time in ½ second units. (Type hexadecimal values.) cfgNetTuningTcpReXmtMax (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Integer from 8 to 1024.
Legal Values 1 or 0 Default 1 Description Packets addressed to subnets of the local net do not go to the gateway. Tuning the DRAC 4 for Satellite Connectivity The racadm CLI may be used to modify the network tuning properties of the DRAC 4. It is also possible to use the racadm.cfg file to modify these properties (similar to the manner in which .ini files are used).
Following the modification of the network tuning, the DRAC 4 must be reset for the new tuning values to take effect. After the DRAC 4 has been reset, it should be available for use in a normal or satellite network configuration. cfgOobSnmp The group contains parameters to configure the SNMP agent and trap capabilities of the DRAC 4. One instance of the group is allowed. The following subsections describe the objects in this group.
Legal Values Boolean either 1 or 0 (TRUE or FALSE). Default 0 Description 0=Disable, 1=Enable the DRAC 4 SNMP agent. cfgRacTuning The group contains various tuning configuration parameters. One instance of the group is allowed. The following subsections describe the objects in this group. cfgRacTuneHttpPort (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 0 – 65535 Default 80 Description Use this property to configure the DRAC 4 HTTP port.
cfgRacTuneSshPort (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 0 – 65535 Default 22 Description Use this property to configure the DRAC 4 SSH port. (Type hexadecimal values.) cfgRacTuneTelnetPort (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 0 – 65535 Default 23 Description Use this property to configure the DRAC 4 telnet port. (Type hexadecimal values.
Legal Values Boolean, either 1 or 0 (TRUE or FALSE). Default 1 Description 0=disable, 1=enable the DRAC 4 debug command. cfgRacTuneRemoteRacadmEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Boolean, either 1 or 0 (TRUE or FALSE). Default 1 Description 0=Disable, 1=Enable cfgRacTuneHostCom2BaudRate (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
Default 5900 (0x170c) Description Determines the port used during vKVM sessions with the Console Redirection window. After changing this property, the RAC must be reset prior to opening any new Console Redirection sessions. (Type hexadecimal values.) NOTE: This object requires a DRAC 4 reset before it becomes active. ifcRacManagedNodeOs This group contains parameters to configure the DRAC 4 with managed system and operating system naming information. One instance of the group is allowed.
ifcRacMnOsOsType (Read Only) Legal Values Not user-writable. Default 0 Description Manage system operating system type. cfgRacSecurity This group contains parameters to configure the DRAC 4 SSL (Secure Sockets Layer) security features. cfgRacSecCsrCommonName (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of any ASCII characters Default "" Description The CSR (certificate signing request) common name.
cfgRacSecCsrOrganizationUnit (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of any ASCII characters. Default "" Description The CSR organization unit. cfgRacSecCsrLocalityName (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of any ASCII characters. Default "" Description The CSR locality name.
Legal Values The two-letter country code. Default "" Description The CSR country code. cfgRacSecCsrEmailAddr (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values A string of any ASCII characters. Default "" Description The CSR e-mail address. cfgRacSecCsrKeySize (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values Positive integers. Default 0x400 Description DRAC 4 SSL asymmetric key size.
cfgRacVirtual This group contains parameters to configure the DRAC 4 Virtual Media feature. One instance of the group is allowed. The following subsections describe the objects in this group. cfgFloppyEmulation (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 1 or 0 (True or False) Default 0 Description 0 (False) is the default setting, causing the DRAC 4 IDE Option ROM utility to display DELL VIRTUALS-120 instead of VIRTUALFLOPPY DRIVE.
cfgVirAtapiSrvPort (Read/Write) NOTE: To modify this property, you must have Access Virtual Media permission. Legal Values Any unused port number between 0 and 65535 decimal. Default 0E54 in hexadecimal(3668 in decimal) Description Sets the port number or virtual media connection. (Type hexadecimal values). cfgActiveDirectory This group contains parameters to configure the DRAC 4 Active Directory feature.
cfgADEnable (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission. Legal Values 1 or 0 (True or False) Default 0 Description 1 (True) allows Active Directory authentication to take place. 0 (False) enables local DRAC 4 authentication only. cfgADAuthTimeout (Read/Write) NOTE: To modify this property, you must have Configure DRAC 4 permission.
Event Filter Operation and Event Mask Properties The DRAC 4 alert filter scans the alert enable database properties before it scans the event masks. (An event mask is a bit sequence that specifies information about the DRAC 4- or managed-systemgenerated event, such as the event’s origin, type, and severity). NOTE: Throughout this document, objects are always referred to by group name and object name, separated by a space.
Examples • If you want to define alerts for the following: – Critical voltage or temperature sensors – Lost communication with the BMC then the event mask property value to use is 0x02244444. The following command sets this property value: racadm -g cfgUserAdmin -o cfgUserAdminAlertFilterRacEventMask -i1 0x2244444 • If you want to define alerts for the following: – Critical events – System power off – Watchdog timer hang then the event mask property value to use is 0x00064444.
where has the following bit definitions: • Bit-0: 1 = Send alert when system transitions to a powered-on state. • Bit-1: 1 = Send alert when system transitions to a powered-off state. • Bit-2: 1 = Send alert when watchdog timer detects a system hang. • Bit-3: Reserved. Alert Filter Properties The alert filter property group ID is cfgUserAdmin. The object IDs are shown in Table A-6. Table A-6.
Email Test Command Synopsis racadm testemail -e -i racadm testemail -e -u Alert Data Definitions The e-mail alert contains the following information: message (including test message, if a paging test), event description, date, time, severity, system ID, model, BIOS version, asset tag, service tag, managed system name, operating system name, and BMC version.
Alert Data Definitions The "alertMessage" string (up to 1 KB) provides the specific information describing the cause and specific source of the event, which includes: • Sensor identification: entity/IPMBslaveAddress • Sensor number • Sensor ID string (if possible) • Current reading and range (normal/warning/critical) • Threshold values: minimum, maximum, normal For more information, see the Dell OpenManage™ Server Administrator SNMP Reference Guide.
DRAC III and DRAC 4 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. 220 SYSCFG Error Codes and Messages (continued) Error Code Message 14 The community string may only contain printable ASCII characters. 15 Destination unavailable. Cannot deliver request to selected destination. 16 Cannot execute command. Insufficient privilege level. 17 Command illegal for specified sensor or record type. 18 Invalid commstring value. 19 Hardware subsystem error. Invalid data field in request. 20 Invalid destination IP address. 21 The GUID is invalid.
Table B-1. SYSCFG Error Codes and Messages (continued) Error Code Message 41 Request data length invalid. 42 Request data field length limit exceeded. 43 Requested Sensor, data, or record not present. 44 Request data truncated. 45 Command response could not be provided. 46 Command response could not be provided. BMC initialization or initialization agent in progress. 47 Command response could not be provided. Device in firmware update mode. 48 Command response could not be provided.
Table B-1. 222 SYSCFG Error Codes and Messages (continued) Error Code Message 68 The BIOS version information is not available. 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.
Table B-1. SYSCFG Error Codes and Messages (continued) Error Code Message 91 Setting external serial connector settings failed. 92 There was an error opening the file. 93 File does not have write permission. 94 The file contains invalid options. 95 The replication information does not match for this system. 96 There can only be one section in the input file. 97 Bad ini file, the section cannot be found. 98 The format of the bios image file is incorrect.
Table B-1. 224 SYSCFG Error Codes and Messages (continued) Error Code Message 118 There was an error setting the option. 119 The -n (--namefile) option can only be used with --pci. 120 The password may only contain alphanumeric characters. 121 The BIOS passwords have been disabled via jumper. 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.
UPINIT Common Error Codes and Messages The UPINIT utility checks your commands for correct syntax. When you enter a command, a message is displayed stating the results of the command. Failure Messages The UPINIT utility failure messages provide error codes to help diagnose why some commands do not succeed. Table B-2 lists error codes and messages common to Linux and Microsoft®Windows® PE environments. Table B-2.
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. 228 RAIDCFG Error Codes and Messages (continued) Error Code Message 26 Size too small for given RAID type. 27 Wrong number of disks for RAID 1-concatenated. 28 Insufficient space to mirror disks. 29 Create Mirror not supported. 30 Disk in use. 31 Disk Lock operation failed. 32 Disk locked. 33 Disk Unlock operation failed. 34 Disk Unlocked. 35 Disk failed on rebuild. 36 Hot Spare not free. 37 Disk Diagnostic failed. 38 Disk Rebuild failed. 39 Disk Format failed.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 54 Virtual disk not found. 55 Virtual disk locked. 56 Drive in use. 57 Reached maximum physical size. 58 Reached maximum count of virtual disks. 59 There is not enough free space on the array disk(s) to allow the operation to complete; the size of the virtual disk is too large; or communication to the array disk(s) has been lost.
Table B-5. 230 RAIDCFG Error Codes and Messages (continued) Error Code Message 77 Unsupported write policy value. 78 Unsupported read policy value. 79 Cancel initialization on virtual disk failed. 80 Cancel reconstruction on virtual disk failed. 81 Cancel resynchronization on virtual disk failed. 82 The maximum number of virtual disks that can be created has been reached.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 99 Virtual disk - Clear-to-zero failed. 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.
Table B-5. 232 RAIDCFG Error Codes and Messages (continued) Error Code Message 122 Controller Write Configuration failed. 123 Controller cache flush failed. 124 Enable alarm on controller failed. 125 Disable alarm on controller failed. 126 Quiet alarm on controller failed. 127 Controller failed to perform the task. 128 Specified bus not found for controller. 129 Call to set cache mode on the controller failed. 130 Unexpected controller error. 131 Controller out of memory.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 148 No controller parameter support. 149 Controller does not recognize parameter symbol. 150 Controller Battery Recondition failed. 151 Controller Get disk signature failed. 152 Controller Read Flags failed. 153 Controller Set Flags failed. 154 Controller Remove Snap Shot failed. 155 Controller not supported. 156 Controller device initialization failure. 157 Partner controller already opened read-write.
Table B-5. 234 RAIDCFG Error Codes and Messages (continued) Error Code Message 174 Cannot perform Create Virtual Disk or Delete Virtual Disk while the other server in a cluster is online. Please shut one of the servers down and retry the operation. 176 Invalid array disks or failover drives selected for reconfigure/create operation. Please make sure that all array disks and failover drives associated with the virtual disk are selected.
Table B-5. RAIDCFG Error Codes and Messages (continued) Error Code Message 188 There are no disks of the correct type and sufficient size available to be assigned as a hot spare. 189 The Create Virtual Disk task was successful but the operating system may not be aware of the new virtual disk. 191 The import of foreign configurations is complete. Some configurations could not be imported. 192 Enable alarm command failed. The enclosure processor is busy or a firmware download is in progress.
Table B-5. 236 RAIDCFG Error Codes and Messages (continued) Error Code Message 214 Invalid size given! size=max or -sz=max is not supported for this RAID controller. 215 The value given for envname or -envn is null or too long. 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).
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.
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. 515 An invalid parameter was passed into function. 516 Invalid DRSTYPE specified. 517 Librac library already initialized. 518 Invalid transport type specified. 519 Invalid library user. 520 A connection to the RAC controller could not be established.
Table B-7. 240 RACADM Error Codes and Messages (continued) Error Code Message 536 TFTP write request failed. 537 TFTP read request failed. 538 Failed to open file. 539 Failed to load socket library. 540 Invalid socket library. 541 Unable to resolve HostName. 542 Failed to create socket. 543 Socket read operation failed. 544 Socket write operation failed. 545 Failed to create SSL context object. 546 Failed to create SSL BIO object. 547 Unable to create SSL socket connection.
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.
Messages and Codes
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.
BMC Platform Events Filter Alert Messages
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 NOTE: The following is a sample SYSCFG utility .ini file format for PowerEdge x9xx series only. [syscfg] sysname=PowerEdge 2950 sysid=01B2 biosver=1.1.0 ;svctag=3KD7L1S ;do not edit information above this line acpower=last adjcacheprefetch=enable asset=dtk12 bootseq= cdrom.emb.0,hdd.emb.0,nic.emb.1,virtualfloppy.slot.1,virtualcd.slot.
fsbr=115200 hwprefetcher=enable idecdrom=auto integratedraid=enable 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.22.1 ;ipaddress=192.168.22.253 ipaddrsrc=static nicselection=dedicated autoneg=enable dnsserver1=0.0.0.0 dnsserver2=0.0.0.
fullduplex=enable speed=100Mbps subnetmask=255.255.255.
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 lanuseraccess userid=15 usrprivlmt=noaccess lanuseraccess userid=16 usrprivlmt=noaccess lcd=default lcd1= logicproc=enable 248 Sample File Formats
memtest=enable nmibutton=enable numlock=on pefcfgparams alertpolnum=1 alertpolstatus=enable pefcfgparams alertpolnum=2 alertpolstatus=enable pefcfgparams alertpolnum=3 alertpolstatus=enable pefcfgparams alertpolnum=4 alertpolstatus=enable pefcfgparams filter=fanfail filteralert=enable filteraction=none pefcfgparams filter=discretevoltfail filteralert=enable filteraction=none pefcfgparams filter=tempwarn filteralert=enable filteraction=none pefcfgparams filter=tempfail Sample File Formats 249
filteralert=enable filteraction=none pefcfgparams filter=intrusion filteralert=enable filteraction=none pefcfgparams filter=redundegraded filteralert=enable filteraction=none pefcfgparams filter=redunlost filteralert=enable 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 250 Sample File Forma
filteraction=none pefcfgparams filter=hardwarelogfail filteralert=enable pefcfgparams filter=autorecovery filteralert=enable pefcfgparams filter=procabsent filteralert=enable filteraction=none pefcfgparams filter=powerabsent filteralert=enable filteraction=none pefcfgparams filter=batterywarn filteralert=enable filteraction=none pefcfgparams filter=batteryfail filteralert=enable filteraction=none hostname=localhost.
serialcfgparams 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=administrator serialuseraccess userid=4 usrprivlmt=administrator serialuseraccess userid=5 usrprivlmt=administrator seria
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 serialuseraccess userid=15 usrprivlmt=noaccess serialuseraccess userid=16 Sample File Formats 253
usrprivlmt=noaccess snoopfilter=disable solaction userid=2 action=enable solaction userid=3 action=enable solaction userid=4 action=enable solaction userid=5 action=enable solaction userid=6 action=disable solaction userid=7 action=disable solaction userid=8 action=disable solaction userid=9 action=disable solaction userid=10 action=disable 254 Sample File Formats
solaction userid=11 action=disable solaction userid=12 action=disable solaction userid=13 action=disable solaction userid=14 action=disable solaction userid=15 action=disable solaction userid=16 action=disable solcfgparams solbitrate=57600 solcharaccuminterval=10 solcharsendthreshold=220 solenable=enable solprivlevel=administrator sysid=01B2 sysname=PowerEdge 2950 usbports=enable useraction userid=2 Sample File Formats 255
action=enable useraction userid=3 action=enable useraction userid=4 action=enable useraction userid=5 action=enable useraction userid=6 action=disable 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 256 Sample File Formats
userid=12 action=disable useraction userid=13 action=disable useraction userid=14 action=disable useraction userid=15 action=disable useraction userid=16 action=disable username userid=2 name=root username userid=3 name=megh username userid=4 name=megh username userid=5 name=megh3 username userid=6 name=NULL Sample File Formats 257
username userid=7 name=NULL username userid=8 name=NULL username 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 258 Sample File Formats
name=NULL ;uuid=44454C4C4B0010448037B3C04F4C3153 virtualization=disable virtualmedia=disable Sample RAIDCFG Utility .
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. #idRacVersionInfo=1.20 (Build 01.17) idRacName=DRAC 4/I idRacMisc= [cfgLanNetworking] cfgNicEnable=1 cfgNicIpAddress=10.98.8.121 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.0.
#cfgNicCurrentDhcpWasUsed=0 #cfgDNSCurrentDhcpWasUsed=0 #cfgDNSCurrentServer1=192.168.0.5 #cfgDNSCurrentServer2=192.168.0.6 #cfgDNSCurrentDomainName=MYDOMAIN [cfgRemoteHosts] cfgRhostsSmtpEmailEnable=1 cfgRhostsFwUpdateTftpEnable=1 cfgRhostsSmtpServerIpAddr=127.0.0.1 cfgRhostsFwUpdateIpAddr=192.168.0.
cfgSerialBaudRate=115200 cfgSerialConsoleEnable=0 cfgSerialConsoleQuitKey=~.
[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= 264 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 "SYSCFG" chapter. Table E-1. SYSCFG Options Options --envar Suboptions Valid Arguments Description When used with the –s option, this option stores the environment variable data to a file so that this file can be called from other scripts.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --adjcacheprefetch enable, disable Enables the processor to fetch the cache line containing the currently requested data and prefetch the following cache line or fetch only the cache line containing the currently requested data. Yes --assignintr standard, distributed Controls the interrupt assignment of PCI devices in the system. --asset Sets the asset tag value.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --embnics on, off Enables or disables the embedded NICs. Yes --embnic1pxe enable, disable Enables or disables Pre-boot eXecution Yes Environment (PXE) on the first embedded NIC. --embnic2pxe enable, disable Enables or disables PXE on the second Yes embedded NIC. --embsataraid off, combined, ata, raid Configures the embedded SATA (Serial Advanced Technology Attachment) RAID 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 --lcd default, none, user Selects whether to display the default Yes string (model name and number) or a user-defined string in the front-panel LCD (Liquid Crystal Display).
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description Replicated --noraidprompt* none Disables the POST prompt message when the SCSI controller type is changed. NOTE: The asterisk is not part of the command syntax. No --numlock on, off Enables or disables the keyboard number lock. Yes --oldsetuppwd Confirms the existing setup password when setting a new setup password.
Table E-1. SYSCFG Options (continued) Options Suboptions --sata1 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 Suboptions Valid Arguments Description Replicated --slot* none Reports the slot number for a modular Yes system. NOTE: This option is valid for PowerEdge 1855 servers only. The asterisk is not part of the command syntax. --snoopfilter enable, disable Enables or disables the snoop filter option from the system BIOS. Yes --speaker on, off Turns the built-in speaker on or off. Yes --svctag* none Reports the service tag for the system.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description --identify NA 0–254 Flashes the identification LED for a specified number of seconds. lanchannelaccess or lca --pefalerting enable, disable --ipmioverlan disable, alwaysavail Sets or displays the LAN channel access settings such as alerting and user privilege limits.
Table E-1.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description pefcfgparams or pcp --filter fanfail, voltfail, discretevoltfail, tempwarn, tempfail, intrusion, redundegraded, redunlost, procwarn, procfail, powerwarn, powerfail, hardwarelogfail, autorecovery, batterywarn, batteryfail, powerabsent, procabsent Configures and displays PEF configuration parameters.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments Description serialchannelinfo or sci --mediumtype NA Displays serial channel information. --prottype NA --ssnsupport NA --activessncount NA serialcfgparams or scp Replicated --connectionmode basic, terminal Configures and displays serial configuration parameters. -noflowctrl, rtscts NOTE: The BMC firmware does not msgcommflowctrl support serial port Point-to-Point -NA Protocol (PPP) configurations.
Table E-1. SYSCFG Options (continued) Options Suboptions Valid Arguments --solaction Description Enables or disables Serial-Over-LAN (SOL) access for a particular user. --userid 2–10 if your system has a DRAC 4 controller 2–16 if your system has a DRAC 5 controller solcfgparams --action enable, disable --solenable enable, disable --solprivlevel user, operator, administrator 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.
RAIDCFG Options Table E-1 lists all the RAIDCFG options and gives a brief description of these options. For details on these options, see the "RAIDCFG" chapter. Table E-2. RAIDCFG Short and Long Format Options Option Valid Arguments Short Description Mandatory or Optional No option NA Displays general usage information for the utility. The usage information consists of a comprehensive list of valid options, parameters, and arguments. Optional. See Table 4-4 for specific usage information.
Table E-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -cp d, c Specifies the virtual disk cache policy. Optional. or See Table 4-4 for specific usage information. cachepolicy -ctrl NA or Displays a list of the supported RAID controllers in the system, along with select property information. controller -envc Mandatory, must be 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 -r Sets the RAID level for the array. Optional. Valid RAID values are 0, 1, 5, 10, 50. If no value is specified for RAID, 0 is taken as the default level. See Table 4-4 for specific usage information. Sets the read policy for the virtual disk. Optional. or raid -rp ra, ara, nra, rc, nrc or See Table 4-4 for specific usage information.
Table E-2. RAIDCFG Short and Long Format Options (continued) Option Valid Arguments Short Description Mandatory or Optional -vd NA Displays the virtual disks under all of the controllers along with the physical array disks that make up the virtual disks. See Table 4-6 for specific usage information. Displays the specified virtual disk. Optional. NA Displays the version number of the utility. or vdisk -vd or See Table 4-6 for specific usage information.
Summary of SYSCFG and RAIDCFG Options
Glossary The following list defines or identifies technical terms, abbreviations, and acronyms used in your system documents. A Abbreviation for ampere(s). AC ANSI Abbreviation for American National Standards Institute. 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. Abbreviation for alternating current.
attribute BIOS As it relates to DMI, an attribute is a piece of information related to a component. Attributes can be combined to form groups. If an attribute is defined as read-write, it may be defined by a management application. Acronym for basic input/output system. Your system's BIOS contains programs stored on a flash memory chip.
bus CD-ROM An information pathway between the components of a system. Your system contains an expansion bus that allows the microprocessor to communicate with controllers for all the various peripheral devices connected to the system. Your system also contains an address bus and a data bus for communication between the microprocessor and RAM. Abbreviation for compact disc read-only memory. CD drives use optical technology to read data from CDs.
CLI ConsoleOne Abbreviation for command line interface. Novell ConsoleOne is a Java-based foundation for graphical utilities that manage and administer network resources from different locations and platforms. ConsoleOne provides a single point of control for all Novell and external products. CMOS Acronym for complementary metal-oxide semiconductor. In systems, CMOS memory chips are often used for NVRAM storage.
cpi DHCP Abbreviation for characters per inch. CPU Abbreviation for Dynamic Host Configuration Protocol, a protocol that provides a means to dynamically allocate IP addresses to computers on a LAN. Abbreviation for central processing unit. See also microprocessor. DIMM CRC Acronym for dual in-line memory module. A small circuit board containing DRAM chips that connects to the system board.
DMA ECP Abbreviation for direct memory access. A DMA channel allows certain types of data transfer between RAM and a device to bypass the microprocessor. Abbreviation for Extended Capabilities Port. EDO Abbreviation for Distributed Management Task Force, a consortium of companies representing hardware and software providers. Acronym for extended data output dynamic random access memory which is a type of DRAM that is faster than conventional DRAM.
EMM expansion-card connector Abbreviation for expanded memory manager. A utility that uses extended memory to emulate expanded memory. A connector on the system's system board or riser board for plugging in an expansion card. extended memory EMS Abbreviation for Expanded Memory Specification. RAM above 1 MB. Most software that can use it, such as the Windows operating system, requires that extended memory be under the control of an XMM.
switching topology), and Fibre Channel Arbitrated Loop (FC_AL). firmware FQDN Abbreviation for fully qualified domain name. It consists of a host and domain name, including top-level domain. Software (programs or data) that has been written onto read-only memory (ROM). Firmware can boot and operate a device. Each controller contains firmware which helps provide the controller's functionality. www is the host, webopedia is the second-level domain, and .com is the top-level domain.
GUI hot plug Acronym for graphical user interface. The ability to remove and replace a redundant part while the system is still running. Also called a hot spare. GUID Globally unique identifier. A 16-byte identifier based on the host's network interface card (NIC) address and time stamp. HPFS h HTTP Abbreviation for hexadecimal. A base-16 numbering system, often used in programming to identify addresses in the system's RAM and I/O memory addresses for devices.
ID IPMI Abbreviation for identifier, commonly used when referring to a user identifier (user ID), object identifier (object ID), or hardware identifier (controller ID). Abbreviation for Intelligent Platform Management Interface, which is a part of systems management technology. IDE IPX Abbreviation for Integrated Drive Electronics. IDE is a computer system interface, used primarily for hard drives and CDs. Abbreviation for internetwork packet exchange. I/O Abbreviation for input/output.
K LCD Abbreviation for kilo-, indicating 1000. Abbreviation for liquid crystal display. KB Abbreviation for kilobyte(s), 1024 bytes. KB/sec Abbreviation for kilobyte(s) per second. A type of display used in many portable computers. LCDs utilize two sheets of polarizing material with a liquid crystal solution between them. An electric current passed through the liquid causes the crystals to align so that light cannot pass through them.
mA MCA Abbreviation for milliampere(s). Abbreviation for Micro Channel Architecture, which is designed for multiprocessing. MCA eliminates potential conflicts that arise when installing new peripheral devices. MCA is not compatible with either EISA or XT bus architecture, so older cards cannot be used with it. MAC Acronym for media access control, which is a network sublayer between a network node and the network physical layer.
MIDI mV Acronym for musical instrument digital interface. Abbreviation for millivolt(s). modem name A device that allows your system to communicate with other systems over telephone lines. 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). modular system A system that can include multiple server modules. Each server module functions as an individual system.
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. It also supports object-oriented applications by treating all files as objects with user-defined and system-defined attributes. See also FAT and FAT32. NTLM Abbreviation for Windows NT LAN Manager.
PCMCIA PKCS #7 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. Abbreviation for Public Key Cryptography Standard #7. PKCS #7 is an RSA Data Security, Inc., standard for encapsulating signed data such as a certificate chain. PKIS PERC Acronym for PowerEdge™ Expandable RAID controller.
power unit QFP A set of power supplies in a system chassis. Abbreviation for quad flat pack. ppm RAC Abbreviation for pages per minute. Acronym for remote access controller. PPP RAID Short for Point-to-Point Protocol; it is a method of connecting a computer to the Internet. Acronym for redundant array of independent drives. RAM PQFP Abbreviation for plastic quad flat pack, a type of microprocessor socket in which the microprocessor chip is permanently mounted. Acronym for random-access memory.
RDRAM remote management system Acronym for Rambus DRAM. A dynamic RAM chip technology from Rambus, Inc. Direct RDRAMs are used in systems. Direct RDRAM chips are housed in RIMM modules, which are similar to DIMMs but have different pin settings. The chips can be built with dual channels, doubling the transfer rate to 3.2 GB/sec. A remote management system is any system that accesses the Server Administrator home page on a managed system from a remote location using a supported Web browser.
SAS serial port Acronym for Secure Authentication Services. SATA 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. Abbreviation for Serial Advanced Technology Attachment. settings SCA Abbreviation for single connector attachment. schema A collection of class definitions that describes managed objects in a particular environment.
SIMM SNMP trap Acronym for single in-line memory module. A small circuit board containing DRAM chips that connects to the system board. A notification (event) generated by the RAC or ESM that contains information about state changes on the managed system or about potential hardware problems. SIP SODIMM Acronym for single in-line package, which is a type of housing for electronic components in which the connecting pins protrude from one side. A SIP is also called a Single In-line Pin Package (SIPP).
SSL syntax Abbreviation for secure socket layer. The rules that dictate how you must type a command or instruction so that the system understands it. A variable's syntax indicates its data type. 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.
system.ini file TFTP A start-up file for the Windows operating system. When you start Windows, it consults the system.ini file to determine a variety of options for the Windows operating environment. Among other things, the system.ini file records which video, mouse, and keyboard drivers are installed for Windows. Abbreviation for Trivial File Transfer Protocol. TFTP is a version of the TCP/IP FTP protocol that has no directory or password capability.
TSR URL Abbreviation for terminate-and-stay-resident. A TSR program runs in the background. Most TSR programs implement a predefined key combination (sometimes referred to as a hot key) that allows you to activate the TSR program's interface while running another program. When you finish using the TSR program, you can return to the other application program and leave the TSR program resident in memory for later use. TSR programs can sometimes cause memory conflicts.
varbind video adapter 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. 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.
video resolution VRAM Video resolution—800 x 600, for example—is expressed as the number of pixels across by the number of pixels up and down. To display a program at a specific graphics resolution, you must install the appropriate video drivers and your monitor must support the resolution. Acronym for video random-access memory. Some video adapters use VRAM chips (or a combination of VRAM and DRAM) to improve video performance.
win.ini file XMM A start-up file for the Windows operating system. When you start Windows, it consults the win.ini file to determine a variety of options for the Windows operating environment. Among other things, the win.ini file records what printer(s) and fonts are installed for Windows. The win.ini file also usually includes sections that contain optional settings for Windows application programs that are installed on the hard drive.
Glossary
Index D disk partitioning UPINIT, 107 disk partitioning utilities, 17 disk partitioning utility, 17 DTK utilities overview, 16 E error codes, 219 options and arguments RAIDCFG, 78 UPINIT, 108 overview DTK utilities, 16 P Property Database Group and Object Definitions DRAC4, 176 DRACIII, 135 RAID configuration utilities, 16 RAID configuration utility RAIDCFG, 16 RAIDCFG, 77 error codes and messages, 226 features, 77 options and arguments, 78, 82 supported RAID controllers, 77, 107, 113 replication, 17 re
Index utilities disk partitioning, 17 RAC configuration, 17 RACADM, 17, 113 RAIDCFG, 16, 77 SYSCFG, 16, 23 UPINIT, 107 utility UPINIT, 107 utility types RAID configuration, 16 system configuration and update, 16 W what’s new, 15 310 Index
