Lists all of the subcommands available to use with racadm and provides a short description for each.
Synopsis
racadm help
racadm help <subcommand>
Description
The help subcommand lists all of the subcommands that are available under the racadm command along with a one-line description. You may also 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 <subcommand> command displays information for the specified subcommand only.
arp
NOTE: To use this command, you must have Execute Diagnostic Commands permission.
The config subcommand allows the user to set DRAC 4 configuration parameters individually or to batch them as part of a configuration file. After the .cfg file has been correctly parsed, each object is read. If the content is the same, a write to the DRAC 4 does not occur. If the data is different, that DRAC 4 object is written with the new value.
Input
Table A-5 describes the config subcommand options.
NOTE: The -f, -s,and -p options are not supported for the serial/telnet console.
Table A-5. config Subcommand Options and Descriptions
Option
Description
-f
The -f <filename> option causes config to read the contents of the file specified by <filename> and configure the DRAC 4. The file must contain data in the format specified in "Parsing Rules."
-s
The -s, or synchronize option, directs config to synchronize the user and password database with Server Administrator (if any user passwords were modified).
-p
The -p, or password option, directs config to delete the password entries contained in the config file -f <filename> after the configuration is complete.
-g
The -g <groupName>, or group option, must be used with the -o option. The <groupName> specifies the group containing the object that is to be set.
-o
The -o <objectName><Value>, or object option, must be used with the -g option. This option specifies the object name that is written with the string<value>.
-i
The -i <index>, or index option, is only valid for indexed groups and can be used to specify a unique group. The <index> 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 4. This option is a check only.
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
If errors are not encountered, this subcommand returns an indication of how many configuration objects that were written out of how many total objects were in the .cfg file.
getconfig Subcommand Description
The getconfig subcommand allows the user to retrieve DRAC 4 configuration parameters on an individual basis, or all the configuration groups may be retrieved and saved into a file.
Input
Table A-6 describes the getconfig subcommand options.
NOTE: The -f option will output the contents of the file to the terminal screen rather than writing to a file
since no file system is available. For the serial/telnet console, the <filename> argument must be supplied,
but it is ignored.
Table A-6. getconfig Subcommand Options
Option
Description
-f
The -f <filename>, or filename option, causes getconfig to create the file <filename>. It then reads all the configuration data from the DRAC 4 and places it into the file <filename>. The created file is a format that can be used with the racadm config -f <filename>command.
-p
The -p, or password option, causes getconfig to include password information in the file for all passwords except for the user passwords (which are stored encrypted and cannot be decrypted). A # cfgUserAdmPassword line is displayed as an indication that the password is present, but the password text is not displayed.
-g
The -g <groupName>, 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.
-h
The -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.
-i
The -i <index>, or index option, is valid only for indexed groups and can be used to specify a unique group. The <index> is a decimal integer from 1 through 16. If -i <index> 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.
-u
The -u <username>, or user name option, can be used to display the configuration for the specified user. The <username> option is the log in user name for the user.
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
If errors are not encountered, this subcommand displays the contents of the specified configuration.
Examples
racadm getconfig -g cfgLanNetworking — Displays all of the configuration parameters (objects) that are contained in the group cfgLanNetworking.
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 getconfig -f myrac.cfg — Writes all of the configuration objects, from all of the DRAC 4 group configuration parameters, in to myrac.cfg.
racadm config -f myrac.cfg — Configures or reconfigures the DRAC 4. The myrac.cfg file may be created from the command specified in the previous example if the DRAC 4 has a desired configuration to be replicated. The myrac.cfg file may also be edited manually as long as the parsing rules are followed.
NOTE: The myrac.cfg file does not contain password information. To include this information in the
file, it must be input manually. If you want to remove password information from the myrac.cfg file,
use the -p option.
racadm getconfig -h — Displays a list of the available configuration groups on the DRAC 4.
racadm getconfig -u root — Displays the configuration parameters for the user named root.
coredump
NOTE: To use this command, you must have Execute Debug Commands permission.
The coredump subcommand displays detailed information, including register values, recorded when the most recent bus error occurred, or the message No CORE dump available (if a previous bus error has not occurred, or if the data has been cleared).
This bus error information is persistent across power cycles of the DRAC 4—the data remains in the flash memory of the DRAC 4 until either:
It is cleared using the coredumpdelete subcommand.
Another bus error occurs, replacing the previous information with the more recent bus error information.
See the coredumpdelete subcommand for information about deleting this information.
Output Example
FW d_cmdCoreDump:
Last CORE dump at Wed, 23 Oct 2004 15:49:41 GMT-05:00
Image ID: jon Wed Oct 23 14:55:53 CDT 2004 //DG0YN811/c/esm4/10_23/RAC2.0/FW/rmc
Sysuptime: 67f
FIQ stack
<binary data>
IRQ stack
<binary data>
UNDEF stack
<binary data>
ABORT stack
<binary data>
SVC stack
<binary data>
SWI stack
<binary data>
Enter stack
<binary data>
Current task stack: 'IPEV' -#005e0000
<binary data>
where <binary data> is the binary information that was generated by the DRAC 4 firmware.
Example output (when data is not available):
FW d_cmdCoreDump: No CORE dump available.
coredumpdelete
NOTE: To use this command, you must have Clear Logs or Execute Debug Commands permission.
Table A-8 describes the coredumpdelete subcommand.
Table A-8. coredumpdelete
Subcommand
Definition
coredumpdelete
Deletes the core dump stored in the DRAC 4.
Synopsis
racadm coredumpdelete
Description
The coredumpdelete command clears the area reserved for persistent storage of bus error information. This operation is performed regardless of whether any bus error information is currently stored in the area reserved for this information.
See the coredump command for information about displaying the bus error information.
fwupdate
NOTE: To use this command, you must have Configure DRAC 4 permission.
The fwupdate subcommand allows the caller to update the firmware on the DRAC 4. The user may:
Start updating a firmware update file that has previously been loaded into the RAMdisk update area.
Check the status of the firmware update process.
Instruct the DRAC 4 firmware to get the firmware update file from a TFTP server and load it into the RAMdisk 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 RAMdisk area.
Input
Table A-10 describes the fwupdate subcommand options.
NOTE: The -p and -u options are not supported for the serial/telnet console.
Table A-10. fwupdate Subcommand Options
Option
Description
-u
The update option performs a checksum of the firmware update file and starts the actual update process. If this option is typed by itself, it is assumed that a firmware update file has already been loaded into the RAMdisk using the -g or -p options. This option may also be used along with the -g or -p options. After the firmware update file has been loaded, the update process is started within the same call. At the end of the update, the DRAC 4 performs a soft reset.
-w
The wait option represents a delay in seconds to wait before proceeding with the update. The -w option is only valid with the -u option.
-s
The status option returns the current status of where you are in the update process. This option is always typed by itself. Do not type the -s options with other options. If you do, the status will display as if it was the only option typed.
-g
The get option instructs the firmware to get the firmware update file from the TFTP server and place it in the RAMdisk area. The user may also specify the -a and/or the -f or -d options that are described next. In the absence of the -a or -f options the defaults are read from properties contained in the group cfgRemoteHosts, using properties cfgRhostsFwUpdateIpAddr and cfgRhostsFwUpdatePath.
-a
The IP Address option specifies the IP address of the TFTP server.
-d
The -d, or directory, option specifies the directory on the TFTP server or on the DRAC 4's host server where the firmware update file resides. Do not use the -f option with the -d option.
-c
The -c, or checksum, option allows the user to verify an update file that has been loaded into the RAMdisk area. The update file can be loaded by one of the two loading mechanisms (racadm CLI or TFTP). This option essentially gets the size of the firmware update file and calculates the checksum, and verifies the file token. The TFTP interface verifies the checksum after loading automatically. This option is used mainly when using FTP. The -c option is not used with other options. (The -u option will always checksum before programming. It can be used along with the -u option).
-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. The update file is sent by way of FTP into the DRAC 4. Checksum runs on the newly loaded image. If the checksum is not correct, an error message is displayed. The user is not required to use fwupdate -s option to do this. If you type the -u option on the same command line, the update process starts.
Output
Displays a message indicating which operation is being performed.
Examples
racadm fwupdate -g - a 143.166.154.143 -f firmimg.dm1
In this example, the -g option tells the firmware to download the firmware update file from a location (specified by the -f option) on the TFTP server at a specific IP address (specified by the -a option). The update file is then loaded into RAMdisk. Since the -u option is not present, an update does not occur.
racadm fwupdate -s
This option reads the current status of the firmware update.
racadm fwupdate -u
The -u option starts the update process. This command assumes that a valid firmware update file has been previously loaded using the -g or -p option. The update file checksum is verified for correctness before proceeding.
racadm fwupdate -g -u -a 143.166.154.143 -f firmimg.dm1
In this example, the -g option tells the firmware to download the firmware update file from a location (specified by the -f option) on the TFTP server at a specific IP address (specified by the -a option). The update file is then loaded into RAMdisk. The -u option tells the firmware to proceed with the update after the firmware is loaded.
Updating the Firmware
If you use the -f option, specify the firmimg.dm1 file.
If you are updating your firmware locally, use one of the following commands to update your firmware:
Retrieves session information for one or more currently active or pending sessions from the Session Manager's session table.
Synopsis
racadm getssninfo [-A] [-u <username> | *]
Description
The getssninfo command returns a list of currently active or pending users and optionally includes summary session table information. The summary information provides the total number of sessions in each of the defined Session Manager states:
Free
Preliminary
Unvalidated
Valid
Invalid
Input
Table A-12 describes the getssinfo subcommand options.
Table A-12. getssinfo Subcommand Options
Option
Description
-A
The -A option eliminates the printing of data headers.
-u
The -u<username>user name option limits the printed output to only the detail session records for the given user name. If an "*" symbol is given as the user name, all users are listed. Summary information is not printed when this option is specified.
Examples
racadm getssninfo
Session table summary status:
1 VALID
3 AVAILABLE
Table A-13 provides an example of output from the racadm getssninfo command.
Displays DRAC 4 information, system information, and watchdog status information.
Synopsis
racadm getsysinfo [-d] [-s] [-w] [-A]
Description
The getsysinfo command returns information about watchdog status, depending on the command options.
Input
Table A-15 describes the getsysinfo subcommand options.
Table A-15. getsysinfo Subcommand Options
Option
Description
-d
Displays DRAC 4 information.
-s
Displays system information
-w
Displays watchdog information
-A
Eliminates the printing of headers/labels.
If the -w option is not specified, then the other options are used as defaults.
Output
The following data element is output as a string:
Watchdog information/recovery action
Enumeration values or bitmaps are defined for these elements. When the -A (API) option is included on the command, the enumeration/bit value of the element is listed in the output. Otherwise, the enumeration or bit value is mapped to a string before being output.
The bulleted items listed in Table A-16 define the mapping of values to strings.
Table A-16. Watchdog Recovery Action Number Descriptions
Prints the contents of the routing table. If the optional interface number is provided, then netstat prints additional information regarding the traffic across the interface, buffer usage, and other network interface information.
Synopsis
racadm netstat [<network interface number>]
ping
NOTE: To use this command, you must have Execute Diagnostic Commands or Configure DRAC 4
permission.
Verifies that the destination IP address is reachable from the DRAC 4 with the current routing-table contents. A destination IP address is required. An ICMP echo packet is sent to the destination IP address based on the current routing-table contents.
Synopsis
racadm ping <ipaddress>
setniccfg/getniccfg
NOTE: To use the setniccfg command, you must have Configure DRAC 4 permission.
NOTE: To use the getniccfg command, you must have Log In To DRAC 4 permission.
Table A-21 describes the setniccfg and getniccfg subcommands.
Table A-21. setniccfg/getniccfg
Subcommand
Definition
setniccfg
Sets the IP configuration for the controller.
getniccfg
Displays the current IP configuration for the controller.
NOTE: The terms NIC and Ethernet management port may be used interchangeably.
NOTICE: You must wait until the DRAC 4reset is completed before issuing another command. If the
DRAC 4 reset is not completed, you may receive the following error: racadm <command name>
Transport: ERROR: (RC=-1)
Synopsis
racadm racreset [hard | soft | graceful] [delay in seconds]
Description
The racreset subcommand issues a reset to the DRAC 4. 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 DRAC 4 log.
The default option is soft. If you do not type an option, the racadm CLI waits three seconds and then runs the soft option with the racreset subcommand.
NOTICE: You must reboot your system after performing a hard reset of the DRAC 4 as described in
Table A-25.
Table A-25 describes the racreset subcommand options.
Table A-25. racreset Subcommand Options
Option
Description
hard
A hard reset resets the entire DRAC 4 and is as close to a power-on reset as can be achieved using software. The DRAC 4 log, database, and selected daemons are shut down gracefully prior to the reset. A hard reset should be considered as a final effort. PCI configuration is lost.
soft
A soft reset is a processor and processor subsystem reset that resets the processor core to restart the software. PCI configurations are preserved. The DRAC 4 log, database, and selected daemons are shut down gracefully prior to the reset.
graceful
A graceful reset is the same as a soft reset.
<delay>
The user is allowed to select how many seconds of delay occur before the reset sequence is started. A valid delay entry is between 1-60 seconds. The default is 3 seconds.
Examples
racadcm racreset soft 1
Start the DRAC 4 soft reset sequence in 1 second.
racadm racreset soft 20
Start the DRAC 4 soft reset sequence after 20 seconds.
racresetcfg
NOTE: To use this command, you must have Configure DRAC 4 permission.
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. After resetting the database properties, the DRAC 4 resets automatically.
NOTICE: Before using this command, ensure that you want to restore your database to its original
default state with default user root and default password calvin.
NOTE: After issuing a racresetcfg subcommand, stop and then restart the following services: Server
Agent, Server Agent Event Monitor, and SNMP. See the Dell OpenManage Server Administrator's User's
Guide for information on stopping and restarting the services in your operating system.
serveraction
NOTE: To use this command, you must have Execute Server Control Commands permission.
Executes a managed system reset or power-on/off/cycle.
Synopsis
racadm serveraction [-d <delay>] <action>
Description
The serveraction command provides an interface to control system reset and power control. Table A-28 describes the serveraction subcommand option values.
Table A-28. serveraction Subcommand Options
String
Definition
<action>
Specifies the action. The options for the <action> string are:
powerdown — Powers down the system.
powerup — Powers up the system.
powercycle — Issues a power-cycle to the system.
hardreset — Issues a hard reset to the system.
graceshutdown — Powers down the system gracefully.
gracereboot — Powers down the system gracefully (same as the graceshutdown option)
<delay>
Specifies the time in seconds after the command is received before the action is executed. The default is 1 second.
Output
The serveraction command returns without output if successful.
getraclog
NOTE: To use this command, you must have Log In DRAC 4 permission.
Sets DRAC 4 parameters from the managed system. When used remotely, sets DRAC 4 parameters from the management station.
Synopsis
racadm setrac [-h -o -T -d]
Description
NOTE: The racadm setrac command cannot be used remotely.
The setrac command sets the managed system name, operating system name, or operating system type from the managed system to the DRAC 4. If options are not typed, all four parameters are set. The -d option allows the user to display the parameters only without actually writing them to the DRAC 4 firmware. Any combination of options, or no options, may be typed.
Input
Table A-33 describes the setrac subcommand options.
Table A-33. setrac Subcommand Options
Option
Description
-h
Gets the "Hostname" from the managed system and writes it to the DRAC 4. 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 DRAC 4. This parameter is available for viewing under the object ID interface using config/getconfig as [ifcRacManagedNodeOs] ifcRacMnOsName.
-T
Gets the "OS Type" from the managed system and writes it to the DRAC 4. This parameter is available for viewing using the getsysinfo command and under the object ID interface using config/getconfig as [ifcRacManagedNodeOs] ifcRacMnOsOsType.
-d
The -d, or display option, allows the user to get the "Hostname," "OS Name," and "OS Type" from the managed system and display these items only. Parameters are not written to the DRAC 4. If the -d option is typed along with other options, then those parameters are displayed only.
Output
A message is displayed indicating the values obtained from the managed system, and if they are being written to the DRAC 4 or only displayed.
Examples
racadm setrac -d — Only the parameter values are displayed.
racadm setrac -h — The UTC time and managed system name are taken from the managed system and written to the DRAC 4.
sslcsrgen
NOTE: To use this command, you must have Configure DRAC 4 permission.
The sslcsrgen subcommand is used to generate the CSR and download it to a file, <filename>.
Options
NOTE: The -u and -f options are not supported for the serial/telnet console.
Table A-35 describes the sslcsrgen subcommand options.
Table A-35. sslcsrgen Subcommand Options
Option
Description
-g
Generates a new CSR.
-s
Returns the status of a CSR generation process (generation in progress, active, or none).
-u
Uploads the CSR to the filename specified by the -f option.
-f
Specifies the filename of the location, <filename>, where the CSR will be downloaded.
NOTE: If the -f option is not specified, the filename defaults to sslcsr in your current directory.
If options are not specified, the default is -g -u. The -g-u options(together) cannot be used with the -s option. The -f option must be used with the -u option.
The sslcsrgen -s subcommand returns one of the following status codes:
0x00000000 — CSR was generated successfully.
0x40040014 — CSR does not exist.
0x40040006 — CSR generation in progress.
0x40040009 — Key size is not supported.
The sslcsrgen -u subcommand downloads the CSR from the DRAC 4 by FTP. This command returns 0 when successful and returns a nonzero number when unsuccessful.
Restrictions
The sslcsrgen command can only run on a system that has the managed system software installed.
Examples
racadm sslcsrgen -s
or
racadm sslcsrgen -g -u -f c:\csr\csrtest.txt
sslcertupload
NOTE: To use this command, you must have Configure DRAC 4 permission.
Table A-36 describes the sslcertupload subcommand.
Table A-36. sslcertupload
Subcommand
Description
sslcertupload
Downloads a CA certificate to the DRAC 4.
Synopsis
racadm sslcertupload -t <type> [-f <filename>]
Options
Table A-37 describes the sslcertupload subcommand options.
Table A-37. sslcertupload Subcommand Options
Option
Description
-t
Specifies the type of certificate to upload, either the CA certificate or server certificate.
0x1 = server certificate
0x2 = CA certificate
-f
Specifies the filename, <filename>, to be uploaded.
NOTE: If the -f option is not specified, the filename defaults to sslcert in your current directory.
The sslcertupload command returns 0 when successful and returns a nonzero number when unsuccessful.
Restrictions
The sslcertupload command can only run on a system that has the managed system software installed.
Example
racadm sslcertupload -t 0x1 -f c:\cert\cert.txt
sslcertdownload
NOTE: To use this command, you must have Configure DRAC 4 permission.
Table A-38 describes the sslcertdownload subcommand.
Table A-38. sslcertdownload
Subcommand
Description
sslcertupload
Downloads a CA certificate to the DRAC 4.
Synopsis
racadm sslcertdownload -t <type> [-f <filename>]
Options
Table A-39 describes the sslcertdownload subcommand options.
Table A-39. sslcertdownload Subcommand Options
Option
Description
-t
Specifies the type of certificate to download, either the CA certificate or server certificate.
0x1 = server certificate
0x2 = Active Directory certificate
-f
Specifies the filename, <filename>, to be uploaded.
NOTE: If the -f option is not specified, the filename defaults to sslcert in your current directory.
The sslcertdownload command returns 0 when successful and returns a nonzero number when unsuccessful.
Restrictions
The sslcertdownload command can only run on a system that has the managed system software installed.
Example
racadm sslcertdownload -t 0x1 -f c:\cert\cert.txt
sslcertview
NOTE: To use this command, you must have Configure DRAC 4 permission.
Displays a CA certificate or server certificate that is located in the DRAC 4.
Synopsis
racadm sslcertview -t <type> [-A]
Options
Table A-41 describes the sslcertview subcommand options.
Table A-41. sslcertview Subcommand Options
Option
Description
-t
Specifies the type of certificate to upload, either the CA certificate or server certificate.
0x1 = server certificate
0x2 = Active Directory certificate
-A
Prevents printing headers/labels.
Output Examples
For the racadm sslcertview -t 1 subcommand, you receive output similar to the following example, where C is the country, CN is the common name, O is the organization, OU is the organizational unit, L is the locality, S is the state, and E is the email address:
certificate type=1 serial number=00 key size=1024 valid from=DSU+12:34:31 valid to=DSU+15:34:31 subject.C=US subject.CN=RMC Default Certificate subject.O=Dell Inc. subject.OU=BVS subject.L=Round Rock subject.S=Texas subject.E=john@dell.com issuer.C=US issuer.CN=RMC Default Certificate issuer.O=Dell Inc. issuer.OU=BVS issuer.L=Round Rock issuer.S=Texas issuer.E=john@dell.com
For the racadm sslcertview -t 1 -A subcommand, you receive output similar to the following example:
1 00 1024 DSU+12:34:31 DSU+15:34:31 US RMC Default Certificate Dell Inc. BVS Round Rock Texas john@dell.com US RMC Default Certificate Dell Inc. BVS Round Rock Texas john@dell.com
The vmdisconnect subcommand allows a user to forcibly disconnect another user's virtual media session. Once disconnected, the GUI will reflect the correct connection status. This is available only through the use of local or remote racadm.
