Dell Drac 5 User Manual

							RACADM Subcommand Overview281
RACADM Subcommand Overview
This section provides descriptions of the subcommands that are available in 
the RACADM command line interface.
help
 NOTE: To use this command, you must have Log In DRAC 5 permission. 
Table A-1 describes the help command.
Synopsis
racadm help
racadm help <
subcommand>
Description
The help subcommand lists all of the subcommands that are available when 
using the racadm command along with a one-line description. You may also 
type a subcommand after help to get the syntax for a specific subcommand.
Output
The racadm help command displays a complete list of subcommands.
The racadm help  command displays information for the 
specified subcommand only.
Supported Interfaces

 Remote RACADM
 telnet/ssh/serial RACADM
Table A-1. Help Command
Command Definition
helpLists all of the subcommands available to use with 
racadm and provides a short description for each. 
						

							282RACADM Subcommand Overview
arp
 NOTE: To use this command, you must have Execute Diagnostic Commands 
permission. 
Table A-2 describes the arp command.
Synopsis
racadm arp
Supported Interfaces
 Remote RACADM
 telnet/ssh/serial RACADM
clearasrscreen
 NOTE: To use this command, you must have Clear Logs permission.
Table A-3 describes the clearasrscreen subcommand.
Synopsis
racadm clearasrscreen
Supported Interfaces
 Local RACADM
 Remote RACADM
 telnet/ssh/serial RACADM
Table A-2. arp Command
Command Definition
arpDisplays the contents of the ARP table. ARP table 
entries may not be added or deleted.
Table A-3. clearasrscreen
Subcommand Definition
clearasrscreenClears the last crash screen that is in memory. 
						

							RACADM Subcommand Overview283
config
 NOTE: To use the getconfig command, you must have Log In DRAC 5 permission.
Table A-4 describes the config and getconfig subcommands.
Synopsis
racadm config [-c|-p] -f 
racadm config -g <
groupName> -o  [-i 
<
index>] 
Supported Interfaces

 Remote RACADM
 telnet/ssh/serial RACADM
Description
The config subcommand allows the user to set DRAC 5 configuration 
parameters individually or to batch them as part of a configuration file. If the 
data is different, that DRAC 5 object is written with the new value.
Input
Table A-5 describes the config subcommand options.
 NOTE: The -f and -p options are not supported for the serial/telnet/ssh console. Table A-4. config/getconfig
Subcommand Definition
configConfigures the DRAC 5.
getconfigGets the DRAC 5 configuration data. 
						

							284RACADM Subcommand Overview
Output
This subcommand generates error output upon encountering either of the 
following:
 Invalid syntax, group name, object name, index, or other invalid database 
members
 racadm CLI failures
This subcommand returns an indication of how many configuration objects 
that were written out of how many total objects were in the .cfg file.
Table A-5. config Subcommand Options and Descriptions
Option Description
-fThe -f 
 option causes config to read the contents of the file 
specified by  and configure the DRAC 5. The file must 
contain data in the format specified in Parsing Rules.
-pThe -p, or password option, directs config to delete the password entries 
contained in the config file -f 
 after the configuration is 
complete.
-gThe -g 
, or group option, must be used with the -o 
option. The  specifies the group containing the object 
that is to be set.
-oThe -o 
 , or object option, must be used with 
the -g option. This option specifies the object name that is written with 
the string .
-i The -i 
, or index option, is only valid for indexed groups and can 
be used to specify a unique group. The  is a decimal integer 
from 1 through 16. The index is specified here by the index value, not a 
named value.
-c The -c, or check option, is used with the config subcommand and allows 
the user to parse the .cfg file to find syntax errors. If errors are found, the 
line number and a short description of what is incorrect are displayed. 
Writes do not occur to the DRAC 5. This option is a check only. 
						

							RACADM Subcommand Overview285
Examples
racadm config -g cfgLanNetworking -o 
cfgNicIpAddress 10.35.10.100
 
Sets the cfgNicIpAddress configuration parameter (object) to the value 
10.35.10.110. This IP address object is contained in the group 
cfgLanNetworking.

racadm config -f myrac.cfg 
Configures or reconfigures the DRAC 5. The myrac.cfg file may be created 
from the 
getconfig command. The myrac.cfg file may also be edited 
manually as long as the parsing rules are followed.
 NOTE: The myrac.cfg file does not contain password information. To include 
this information in the file, it must be input manually. If you want to remove 
password information from the myrac.cfg file during configuration, use the 
-poption.
getconfig
getconfig Subcommand Description
The getconfig subcommand allows the user to retrieve DRAC 5 configuration 
parameters on an individual basis, or all the RAC configuration groups may 
be retrieved and saved into a file.
Input
Table A-6 describes the getconfig subcommand options.
 NOTE: The -f option without a file specification will output the contents of the file to 
the terminal screen.  
						

							286RACADM Subcommand Overview
Output
This subcommand generates error output upon encountering either of the 
following:
 Invalid syntax, group name, object name, index, or other invalid database 
members
 racadm CLI transport failures
Table A-6. getconfig Subcommand Options
Option Description
-fThe -f 
 option directs getconfig to write the entire RAC 
configuration to a configuration file. This file can be used for batch 
configuration operations using the config subcommand. 
NOTE: The -f option does not create entries for the cfgIpmiPet and 
cfgIpmiPef groups. You must set at least one trap destination to capture 
the cfgIpmiPet group to the file. 
-gThe -g 
, or group option, can be used to display the 
configuration for a single group. The groupName is the name for the 
group used in the racadm.cfg files. If the group is an indexed group, use 
the -i option.
-hThe -h, or help option, displays a list of all available configuration 
groups that you can use. This option is useful when you do not 
remember exact group names.
-iThe -i 
, or index option, is valid only for indexed groups and 
can be used to specify a unique group. The  is a decimal integer 
from 1 through 16. If -i  is not specified, a value of 1 is assumed 
for groups, which are tables that have multiple entries. The index is 
specified by the index value, not a named value.
-oThe -o 
 or object option specifies the object name that is 
used in the query. This option is optional and can be used with the -g 
option. 
-u The -u 
, or user name option, can be used to display the 
configuration for the specified user. The  option is the 
login name for the user.
-vThe -v option displays additional details with the display of the 
properties and is used with the -g option. 
						

							RACADM Subcommand Overview287
If errors are not encountered, this subcommand displays the contents of the 
specified configuration.
Examples
racadm getconfig -g cfgLanNetworking 
Displays all of the configuration properties (objects) that are contained in 
the group 
cfgLanNetworking.

racadm getconfig -f myrac.cfg 
Saves all group configuration objects from the RAC to myrac.cfg.

racadm getconfig -h 
Displays a list of the available configuration groups on the DRAC 5.
racadm getconfig -u root
Displays the configuration properties for the user named root.

racadm getconfig -g cfgUserAdmin -i 2 -v 
Displays the user group instance at index 2 with verbose information for 
the property values.
Synopsis
racadm getconfig -f 
racadm getconfig -g <
groupName> [-i ]
racadm getconfig -u <
username>
racadm getconfig -h
Supported Interfaces

 Remote RACADM
 telnet/ssh/serial RACADM 
						

							288RACADM Subcommand Overview
coredump
 NOTE: To use this command, you must have Execute Debug Commands 
permission.
Table A-7 describes the coredump subcommand.
Synopsis
racadm coredump
Description
The coredump subcommand displays detailed information related to any 
recent critical issues that have occurred with the RAC. The coredump 
information can be used to diagnose these critical issues.
If available, the coredump information is persistent across RAC power cycles 
and will remain available until either of the following conditions occur:
 The coredump information is cleared with the coredumpdelete 
subcommand.
 Another critical condition occurs on the RAC. In this case, the coredump 
information will be relative to the last critical error that occurred.
See the coredumpdelete subcommand for more information about clearing 
the coredump.
Supported Interfaces
 Remote RACADM
 telnet/ssh/serial RACADM
Table A-7. coredump
Subcommand Definition
coredumpDisplays the last DRAC 5 core dump. 
						

							RACADM Subcommand Overview289
coredumpdelete
 NOTE: To use this command, you must have Clear Logs or Execute Debug 
Commands permission.
Table A-8 describes the coredumpdelete subcommand.
Synopsis
racadm coredumpdelete
Description
The coredumpdelete subcommand can be used to clear any currently 
resident coredump data stored in the RAC.
 NOTE: If a coredumpdelete command is issued and a coredump is not currently 
stored in the RAC, the command will display a success message. This behavior is 
expected.
See the coredump subcommand for more information on viewing a 
coredump.
Supported Interfaces

 Remote RACADM
 telnet/ssh/serial RACADM
fwupdate
 NOTE: To use this command, you must have Configure DRAC 5 permission.
 
NOTE: Before you begin your firmware update, see Connecting to the Managed 
System Through the Local Serial Port or Telnet Management Station (Client System) 
for additional instructions.
Table A-9 describes the fwupdate subcommand.
Table A-8. coredumpdelete
Subcommand Definition
coredumpdeleteDeletes the core dump stored in the DRAC 5. 
						

							290RACADM Subcommand Overview
Synopsis
racadm fwupdate -s
racadm fwupdate -g -u -a <
TFTP_Server_IP_Address> -d 
<
path>
racadm fwupdate -p -u -d <
path>
Description
The fwupdate subcommand allows users to update the firmware on the 
DRAC 5. The user can:
 Check the firmware update process status
 Update the DRAC 5 firmware from a TFTP server by providing an IP 
address and optional path
 Update the DRAC 5 firmware from the local file system using local 
RACADM
Supported Interfaces
 Local RACADM
 Remote RACADM
 telnet/ssh/serial RACADM
Input
Table A-10 describes the fwupdate subcommand options.
 NOTE: The -p option is only supported in local RACADM and is not supported with 
the serial/telnet/ssh console. Table A-9. fwupdate
Subcommand Definition
fwupdate  Updates the firmware on the DRAC 5.