Manuals

Manuals
RACADM Subcommand Overview: Dell Remote Access Controller 5 Firmware Version 1.30 User's Guide

Back to Contents Page

RACADM Subcommand Overview

Dell Remote Access Controller 5 Firmware Version 1.30 User's Guide

  help

  arp

  clearasrscreen

  config

  getconfig

  coredump

  coredumpdelete

  fwupdate

  getssninfo

  getsysinfo

  getractime

  ifconfig

  netstat

  ping

  setniccfg

  getniccfg

  getsvctag

  racdump

  racreset

  racresetcfg

  serveraction

  getraclog

  clrraclog

  getsel

  clrsel

  gettracelog

  sslcsrgen

  sslcertupload

  sslcertdownload

  sslcertview

  sslkeyupload

  testemail

  testtrap

  vmdisconnect

  vmkey

  usercertupload

  usercertview

  localConRedirDisable


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.

Table A-1. Help Command

Command

Definition

help

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 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 <subcommand> command displays information for the specified subcommand only.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


arp

NOTE: To use this command, you must have Execute Diagnostic Commands permission.

Table A-2 describes the arp command.

Table A-2. arp Command

Command

Definition

arp

Displays the contents of the ARP table. ARP table entries may not be added or deleted.

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.

Table A-3. clearasrscreen

Subcommand

Definition

clearasrscreen

Clears the last crash screen that is in memory.

Synopsis

racadm clearasrscreen

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


config

NOTE: To use the getconfig command, you must have Log In DRAC 5 permission.

Table A-4 describes the config and getconfig subcommands.

Table A-4. config/getconfig

Subcommand

Definition

config

Configures the DRAC 5.

getconfig

Gets the DRAC 5 configuration data.

Synopsis

racadm config [-c|-p] -f <filename>

racadm config -g <groupName> -o <objectName> [-i <index>] <Value>

Supported Interfaces

  • Local RACADM

  • 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-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 5. 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 <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 5. 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 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.

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 -p option.

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.

Table A-6. getconfig Subcommand Options

Option

Description

-f

The -f <filename> 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.

-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.

-o

The -o <objectname> 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 <username>, or user name option, can be used to display the configuration for the specified user. The <username> option is the login name for the user.

-v

The -v option displays additional details with the display of the properties and is used with the -g option.

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 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 <filename>

racadm getconfig -g <groupName> [-i <index>]

racadm getconfig -u <username>

racadm getconfig -h

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


coredump

NOTE: To use this command, you must have Execute Debug Commands permission.

Table A-7 describes the coredump subcommand.

Table A-7. coredump

Subcommand

Definition

coredump

Displays the last DRAC 5 core dump.

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


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 5.

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

  • Local RACADM

  • 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 "Updating the DRAC 5 Firmware" for additional instructions.

Table A-9 describes the fwupdate subcommand.

Table A-9. fwupdate

Subcommand

Definition

fwupdate

Updates the firmware on the DRAC 5.

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-10. fwupdate Subcommand Options 

Option

Description

-u

The update option performs a checksum of the firmware update file and starts the actual update process. This option may be used along with the -g or -p options. At the end of the update, the DRAC 5 performs a soft reset.

-s

The status option returns the current status of where you are in the update process. This option is always used by itself.

-g

The get option instructs the firmware to get the firmware update file from the TFTP server. The user must also specify the -a and -d options. In the absence of the -a option, 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 5's host server where the firmware update file resides.

-p

The -p, or put, option is used to update the firmware file from the managed system to the DRAC 5. The -u option must be used with the -p option.

Output

Displays a message indicating which operation is being performed.

Examples

  • racadm fwupdate -g -u - a 143.166.154.143 -d <path>

In this example, the -g option tells the firmware to download the firmware update file from a location (specified by the -d option) on the TFTP server at a specific IP address (specified by the -a option). After the image file is downloaded from the TFTP server, the update process begins. When completed, the DRAC 5 is reset.

If the download exceeds 15 minutes and times out, transfer the firmware flash image to a local drive on the server. Then, using Console Redirection, connect to the remote system and install the firmware locally using local racadm.

  • racadm fwupdate -s

This option reads the current status of the firmware update.

  • racadm fwupdate -p -u -d c:\ <images>

In this example, the firmware image for the update is provided by the host's file system.

  • racadm -r 192.168.0.120 -u root -p racpassword fwupdate -g -u -a 192.168.0.120 -d <images>

In this example, RACADM is used to remotely update the firmware of a specified DRAC using the provided DRAC username and password. The image is retrieved from a TFTP server.

NOTE: The -p option is not supported in the Remote RACADM interface for the fwupdate subcommand.

getssninfo

NOTE: To use this command, you must have Log In To DRAC 5 permission.

Table A-11 describes the getssninfo subcommand.

Table A-11. getssninfo Subcommand

Subcommand

Definition

getssninfo

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 users that are connected to the DRAC. The summary information provides the following information:

  • Username

  • IP address (if applicable)

  • Session type (for example, serial or telnet)

  • Consoles in use (for example, Virtual Media or Virtual KVM)

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM

Input

Table A-12 describes the getssninfo subcommand options.

Table A-12. getssninfo 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

Table A-13 provides an example of output from the racadm getssninfo command.

Table A-13. getssninfo Subcommand Output Example

User

IP Address

Type

Consoles

root

192.168.0.10

Telnet

Virtual KVM

  • racadm getssninfo -A

"root" 143.166.174.19 "Telnet" "NONE"

  • racadm getssninfo -A -u *

"root" "143.166.174.19" "Telnet" "NONE"

"bob" "143.166.174.19" "GUI" "NONE"


getsysinfo

NOTE: To use this command, you must have Log In To DRAC 5 permission.

Table A-14 describes the racadm getsysinfo subcommand.

Table A-14. getsysinfo

Command

Definition

getsysinfo

Displays DRAC 5 information, system information, and watchdog status information.

Synopsis

racadm getsysinfo [-d] [-s] [-w] [-A]

Description

The getsysinfo subcommand displays information related to the RAC, managed system, and watchdog configuration.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM

Input

Table A-15 describes the getsysinfo subcommand options.

Table A-15. getsysinfo Subcommand Options

Option

Description

-d

Displays DRAC 5 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 getsysinfo subcommand displays information related to the RAC, managed system, and watchdog configuration.

Sample Output

RAC Information:
RAC Date/Time            = Thu Dec 8 20:01:33 2005
Firmware Version         = 1.0
Firmware Build           = 05.12.08
Last Firmware Update     = Thu Dec 8 08:09:36 2005

Hardware Version         = A00
Current IP Address       = 192.168.0.120
Current IP Gateway       = 192.168.0.1
Current IP Netmask       = 255.255.255.0
DHCP Enabled             = 0
MAC Address              = 00:14:22:18:cd:f9
Current DNS Server 1     = 0.0.0.0
Current DNS Server 2     = 0.0.0.0
DNS Servers from DHCP    = 0
Register DNS RAC Name    = 0
DNS RAC Name             = rac-48192
Current DNS Domain       =

System Information:
System Model             = PowerEdge 2900
System BIOS Version      = 0.2.3
BMC Firmware Version     = 0.17
Service Tag              = 48192
Host Name                = racdev103
OS Name                  = Microsoft Windows Server 2003
Power Status             = OFF

Watchdog Information:
Recovery Action          = None
Present countdown value  = 0 seconds
Initial countdown value  = 0 seconds

Examples

  • racadm getsysinfo -A -s

"System Information:" "PowerEdge 2900" "A08" "1.0" "EF23VQ-0023" "Hostname"

"Microsoft Windows 2000 version 5.0, Build Number 2195, Service Pack 2" "ON"

  • racadm getsysinfo -w -s

System Information:
System Model             = PowerEdge 2900
System BIOS Version      = 0.2.3
BMC Firmware Version     = 0.17
Service Tag              = 48192
Host Name                = racdev103
OS Name                  = Microsoft Windows Server 2003
Power Status            = OFF


Watchdog Information:
Recovery Action          = None
Present countdown value  = 0 seconds
Initial countdown value = 0 seconds

Restrictions

The Hostname and OS Name fields in the getsysinfo output display accurate information only if Dell OpenManage is installed on the managed system. If OpenManage is not installed on the managed system, these fields may be blank or inaccurate.


getractime

NOTE: To use this command, you must have Log In DRAC 5 permission.

Table A-16 describes the getractime subcommand.

Table A-16. getractime

Subcommand

Definition

getractime

Displays the current time from the remote access controller.

Synopsis

racadm getractime [-d]

Description

With no options, the getractime subcommand displays the time in a common readable format.

With the -d option, getractime displays the time in the format, yyyymmddhhmmss.mmmmmms, which is the same format returned by the UNIX date command.

Output

The getractime subcommand displays the output on one line.

Sample Output

racadm getractime

Thu Dec 8 20:15:26 2005

racadm getractime -d

20051208201542.000000

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


ifconfig

NOTE: To use this command, you must have Execute Diagnostic Commands or Configure DRAC 5 permission.

Table A-17 describes the ifconfig subcommand.

Table A-17. ifconfig

Subcommand

Definition

ifconfig

Displays the contents of the network interface table.

Synopsis

racadm ifconfig


netstat

NOTE: To use this command, you must have Execute Diagnostic Commands permission.

Table A-18 describes the netstat subcommand.

Table A-18. netstat

Subcommand

Definition

netstat

Displays the routing table and the current connections.

Synopsis

racadm netstat

Supported Interfaces

  • Remote RACADM

  • telnet/ssh/serial RACADM


ping

NOTE: To use this command, you must have Execute Diagnostic Commands or Configure DRAC 5 permission.

Table A-19 describes the ping subcommand.

Table A-19. ping

Subcommand

Definition

ping

Verifies that the destination IP address is reachable from the DRAC 5 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>

Supported Interfaces

  • Remote RACADM

  • telnet/ssh/serial RACADM


setniccfg

NOTE: To use the setniccfg command, you must have Configure DRAC 5 permission.

Table A-20 describes the setniccfg subcommand.

Table A-20. setniccfg

Subcommand

Definition

setniccfg

Sets the IP configuration for the controller.

NOTE: The terms NIC and Ethernet management port may be used interchangeably.

Synopsis

racadm setniccfg -d

racadm setniccfg -s [<ipAddress> <netmask> <gateway>]

racadm setniccfg -o [<ipAddress> <netmask> <gateway>]

Description

The setniccfg subcommand sets the controller IP address.

  • The -d option enables DHCP for the Ethernet management port (default is DHCP enabled).

  • The -s option enables static IP settings. The IP address, netmask, and gateway can be specified. Otherwise, the existing static settings are used. <ipAddress>, <netmask>, and <gateway> must be typed as dot-separated strings.

racadm setniccfg -s 192.168.0.120 255.255.255.0 192.168.0.1

  • The -o option disables the Ethernet management port completely. <ipAddress>, <netmask>, and <gateway> must be typed as dot-separated strings.

racadm setniccfg -o 192.168.0.120 255.255.255.0 192.168.0.1

Output

The setniccfg subcommand displays an appropriate error message if the operation is not successful. If successful, a message is displayed.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


getniccfg

NOTE: To use the getniccfg command, you must have Log In To DRAC 5 permission.

Table A-21 describes the setniccfg and getniccfg subcommands.

Table A-21. setniccfg/getniccfg

Subcommand

Definition

getniccfg

Displays the current IP configuration for the controller.

Synopsis

racadm getniccfg

Description

The getniccfg subcommand displays the current Ethernet management port settings.

Sample Output

The getniccfg subcommand will display an appropriate error message if the operation is not successful. Otherwise, on success, the output displayed in the following format:

NIC Enabled     = 1

DHCP Enabled    = 1

IP Address      = 192.168.0.1

Subnet Mask     = 255.255.255.0

Gateway         = 192.168.0.1

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


getsvctag

NOTE: To use this command, you must have Log In To DRAC 5 permission.

Table A-22 describes the getsvctag subcommand.

Table A-22. getsvctag

Subcommand

Definition

getsvctag

Displays a service tag.

Synopsis

racadm getsvctag

Description

The getsvctag subcommand displays the service tag of the host system.

Example

Type getsvctag at the command prompt. The output is displayed as follows:

Y76TP0G

The command returns 0 on success and nonzero on errors.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


racdump

NOTE: To use this command, you must have Debug permission.

Table A-23 describes the racdump subcommand.

Table A-23. racdump

Subcommand

Definition

racdump

Displays status and general DRAC 5 information.

Synopsis

racadm racdump

Description

The racdump subcommand provides a single command to get dump, status, and general DRAC 5 board information.

The following information is displayed when the racdump subcommand is processed:

  • General system/RAC information

  • Coredump

  • Session information

  • Process information

  • Firmware build information

Supported Interfaces

  • Remote RACADM

  • telnet/ssh/serial RACADM


racreset

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-24 describes the racreset subcommand.

Table A-24. racreset

Subcommand

Definition

racreset

Resets the DRAC 5.

NOTICE: When you issue a racreset subcommand, the DRAC may require up to one minute to return to a usable state.

Synopsis

racadm racreset [hard | soft]

Description

The racreset subcommand issues a reset to the DRAC 5. The reset event is written into the DRAC 5 log.

A hard reset performs a deep reset operation on the RAC. A hard reset should only be performed as a last-case resort to recover the RAC.

NOTICE: You must reboot your system after performing a hard reset of the DRAC 5 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 performs a deep reset operation on the remote access controller. A hard reset should only be used as a last case resort of resetting the RAC controller for recovery purposes.

soft

A soft reset performs a graceful reboot operation on the RAC.

Examples

  • racadm racreset

Start the DRAC 5 soft reset sequence.

  • racadm racreset hard

Start the DRAC 5 hard reset sequence.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


racresetcfg

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-26 describes the racresetcfg subcommand.

Table A-26. racresetcfg

Subcommand

Definition

racresetcfg

Resets the entire RAC configuration to factory default values.

Synopsis

racadm racresetcfg

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM

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 5 resets automatically.

NOTICE: This command deletes your current RAC configuration and resets the RAC and serial configuration to the original default settings. After reset, the default name and password is root and calvin, respectively, and the IP address is 192.168.0.120. If you issue racresetcfg from a network client (for example, a supported Web browser, telnet/ssh, or remote RACADM), you must use the default IP address.
NOTE: This subcommand will also reset the serial interface to its default baud rate (57600) and COM port. The serial settings may need to be reconfigured through the BIOS setup screen for the server in order to access the RAC through the serial port.

serveraction

NOTE: To use this command, you must have Execute Server Control Commands permission.

Table A-27 describes the serveraction subcommand.

Table A-27. serveraction

Subcommand

Definition

serveraction

Executes a managed system reset or power-on/off/cycle.

Synopsis

racadm serveraction <action>

Description

The serveraction subcommand enables users to perform power management operations on the host system. Table A-28 describes the serveraction power control options.

Table A-28. serveraction Subcommand Options

String

Definition

<action>

Specifies the action. The options for the <action> string are:

  • powerdown — Powers down the managed system.
  • powerup — Powers up the managed system.
  • powercycle — Issues a power-cycle operation on the managed system. This action is similar to pressing the power button on the system's front panel to power down and then power up the system.
  • powerstatus — Displays the current power status of the server ("ON", or "OFF")
  • hardreset — Performs a reset (reboot) operation on the managed system.

Output

The serveraction subcommand displays an error message if the requested operation could not be performed, or a success message if the operation completed successfully.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


getraclog

NOTE: To use this command, you must have Log In DRAC 5 permission.

Table A-29 describes the racadm getraclog command.

Table A-29. getraclog

Command

Definition

getraclog -i

Displays the number of entries in the DRAC 5 log.

getraclog

Displays the DRAC 5 log entries.

Synopsis

racadm getraclog -i

racadm getraclog [-A] [-o] [-c count] [-s start-record] [-m]

Description

The getraclog -i command displays the number of entries in the DRAC 5 log.

The following options allow the getraclog command to read entries:

  • -A — Displays the output with no headers or labels.

  • -c — Provides the maximum count of entries to be returned.

  • -m — Displays one screen of information at a time and prompts the user to continue (similar to the UNIX more command).

  • -o — Displays the output in a single line.

  • -s — Specifies the starting record used for the display

NOTE: If no options are provided, the entire log is displayed.

Output

The default output display shows the record number, time stamp, source, and description. The timestamp begins at midnight, January 1 and increases until the system boots. After the system boots, the system's timestamp is used.

Sample Output

Record:       1
Date/Time:    Dec 8 08:10:11
Source:       login[433]
Description:  root login from 143.166.157.103

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


clrraclog

NOTE: To use this command, you must have Clear Logs permission.

Synopsis

racadm clrraclog

Description

The clrraclog subcommand removes all existing records from the RAC log. A new single record is created to record the date and time when the log was cleared.


getsel

NOTE: To use this command, you must have Log In To DRAC 5 permission.

Table A-30 describes the getsel command.

Table A-30. getsel

Command

Definition

getsel -i

Displays the number of entries in the System Event Log.

getsel

Displays SEL entries.

Synopsis

racadm getsel -i

racadm getsel [-E] [-R] [-A] [-o] [-c count] [-s count] [-m]

Description

The getsel -i command displays the number of entries in the SEL.

The following getsel options (without the -i option) are used to read entries.

-A — Specifies output with no display headers or labels.

-c — Provides the maximum count of entries to be returned.

-o — Displays the output in a single line.

-s — Specifies the starting record used for the display

-E — Places the 16 bytes of raw SEL at the end of each line of output as a sequence of hex values.

-R — Only the raw data is printed.

-m — Displays one screen at a time and prompts the user to continue (similar to the UNIX more command).

NOTE: If no arguments are specified, the entire log is displayed.

Output

The default output display shows the record number, timestamp, severity, and description.

For example:

Record:      1
Date/Time:   11/16/2005 22:40:43
Severity:    Ok
Description: System Board SEL: event log sensor for System Board, log cleared was asserted

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


clrsel

NOTE: To use this command, you must have Clear Logs permission.

Synopsis

racadm clrsel

Description

The clrsel command removes all existing records from the system event log (SEL).

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


gettracelog

NOTE: To use this command, you must have Log In To DRAC 5 permission.

Table A-31 describes the gettracelog subcommand.

Table A-31. gettracelog

Command

Definition

gettracelog -i

Displays the number of entries in the DRAC 5 trace log.

gettracelog

Displays the DRAC 5 trace log.

Synopsis

racadm gettracelog -i

racadm gettracelog [-A] [-o] [-c count] [-s startrecord] [-m]

Description

The gettracelog (without the -i option) command reads entries. The following gettracelog entries are used to read entries:

-i — Displays the number of entries in the DRAC 5 trace log

-m — Displays one screen at a time and prompts the user to continue (similar to the UNIX more command).

-o — Displays the output in a single line.

-c — specifies the number of records to display

-s — specifies the starting record to display

-A — do not display headers or labels

Output

The default output display shows the record number, timestamp, source, and description. The timestamp begins at midnight, January 1 and increases until the system boots. After the system boots, the system's timestamp is used.

For example:

Record: 1

Date/Time: Dec 8 08:21:30

Source: ssnmgrd[175]

Description: root from 143.166.157.103: session timeout sid 0be0aef4

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


sslcsrgen

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-32 describes the sslcsrgen subcommand.

Table A-32. sslcsrgen

Subcommand

Description

sslcsrgen

Generates and downloads an SSL certificate signing request (CSR) from the RAC.

Synopsis

racadm sslcsrgen [-g] [-f <filename>]

racadm sslcsrgen -s

Description

The sslcsrgen subcommand can be used to generate a CSR and download the file to the client's local file system. The CSR can be used for creating a custom SSL certificate that can be used for SSL transactions on the RAC.

Options

NOTE: The -f option is not supported for the serial/telnet/ssh console.

Table A-33 describes the sslcsrgen subcommand options.

Table A-33. 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).

-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 no options are specified, a CSR is generated and downloaded to the local file system as sslcsr by default. The -g option cannot be used with the -s option, and the -f option can only be used with the -g option.

The sslcsrgen -s subcommand returns one of the following status codes:

  • CSR was generated successfully.

  • CSR does not exist.

  • CSR generation in progress.

Restrictions

The sslcsrgen subcommand can only be executed from a local or remote RACADM client and cannot be used in the serial, telnet, or SSH interface.

NOTE: Before a CSR can be generated, the CSR fields must be configured in the RACADM cfgRacSecurity group. For example: racadm config -g cfgRacSecurity -o cfgRacSecCsrCommonName MyCompany

Examples

racadm sslcsrgen -s

or

racadm sslcsrgen -g -f c:\csr\csrtest.txt

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


sslcertupload

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-34 describes the sslcertupload subcommand.

Table A-34. sslcertupload

Subcommand

Description

sslcertupload

Uploads a custom SSL server or CA certificate from the client to the RAC.

Synopsis

racadm sslcertupload -t <type> [-f <filename>]

Options

Table A-35 describes the sslcertupload subcommand options.

Table A-35. sslcertupload Subcommand Options

Option

Description

-t

Specifies the type of certificate to upload, either the CA certificate or server certificate.

1 = server certificate

2 = CA certificate

-f

Specifies the file name of the certificate to be uploaded. If the file is not specified, the sslcert file in the current directory is selected.

The sslcertupload command returns 0 when successful and returns a nonzero number when unsuccessful.

Restrictions

The sslcertupload subcommand can only be executed from a local or remote RACADM client. The sslcsrgen subcommand cannot be used in the serial, telnet, or SSH interface.

Example

racadm sslcertupload -t 1 -f c:\cert\cert.txt

Supported Interfaces

  • Local RACADM

  • Remote RACADM


sslcertdownload

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-36 describes the sslcertdownload subcommand.

Table A-36. sslcertdownload

Subcommand

Description

sslcertupload

Downloads an SSL certificate from the RAC to the client's file system.

Synopsis

racadm sslcertdownload -t <type> [-f <filename>]

Options

Table A-37 describes the sslcertdownload subcommand options.

Table A-37. sslcertdownload Subcommand Options

Option

Description

-t

Specifies the type of certificate to download, either the Microsoft® Active Directory® certificate or server certificate.

1 = server certificate

2 = Microsoft Active Directory certificate

-f

Specifies the file name of the certificate to be uploaded. If the -f option or the filename is not specified, the sslcert file in the current directory is selected.

The sslcertdownload command returns 0 when successful and returns a nonzero number when unsuccessful.

Restrictions

The sslcertdownload subcommand can only be executed from a local or remote RACADM client. The sslcsrgen subcommand cannot be used in the serial, telnet, or SSH interface.

Example

racadm sslcertdownload -t 1 -f c:\cert\cert.txt

Supported Interfaces

  • Local RACADM

  • Remote RACADM


sslcertview

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-38 describes the sslcertview subcommand.

Table A-38. sslcertview

Subcommand

Description

sslcertview

Displays the SSL server or CA certificate that exists on the RAC.

Synopsis

racadm sslcertview -t <type> [-A]

Options

Table A-39 describes the sslcertview subcommand options.

Table A-39. sslcertview Subcommand Options

Option

Description

-t

Specifies the type of certificate to view, either the Microsoft Active Directory certificate or server certificate.

1 = server certificate

2 = Microsoft Active Directory certificate

-A

Prevents printing headers/labels.

Output Example

racadm sslcertview -t 1

Serial Number             : 00

Subject Information:
Country Code (CC)         : US
State (S)                 : Texas
Locality (L)              : Round Rock
Organization (O)          : Dell Inc.
Organizational Unit (OU)  : Remote Access Group
Common Name (CN)          : DRAC5 default certificate

Issuer Information:
Country Code (CC)         : US
State (S)                 : Texas
Locality (L)              : Round Rock
Organization (O)          : Dell Inc.
Organizational Unit (OU)  : Remote Access Group
Common Name (CN)          : DRAC5 default certificate

Valid From                : Jul 8 16:21:56 2005 GMT
Valid To                  : Jul 7 16:21:56 2010 GMT

racadm sslcertview -t 1 -A

00
US
Texas
Round Rock
Dell Inc.
Remote Access Group
DRAC5 default certificate
US
Texas
Round Rock
Dell Inc.
Remote Access Group
DRAC5 default certificate
Jul 8 16:21:56 2005 GMT
Jul 7 16:21:56 2010 GMT

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


sslkeyupload

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-40 describes the sslkeyupload subcommand.

Table A-40. sslkeyupload

Subcommand

Description

sslkeyupload

Uploads SSL key from the client to the DRAC 5.

Synopsis

racadm sslkeyupload -t <type> [-f <filename>]

Options

Table A-41 describes the sslkeyupload subcommand options.

Table A-41. sslkeyupload Subcommand Options

Option

Description

-t

Specifies the key to upload.

1 = server certificate

-f

Specifies the file name of the certificate to be uploaded. If the file is not specified, the sslcert file in the current directory is selected.

The sslkeyupload command returns 0 when successful and returns a nonzero number when unsuccessful.

Restrictions

The sslkeyupload subcommand can only be executed from a local or remote RACADM client. The sslcsrgen subcommand cannot be used in the serial, telnet, or SSH interface.

Example

racadm sslcertupload -t 1 -f c:\cert\cert.txt

Supported Interfaces

  • Local RACADM

  • Remote RACADM


testemail

Table A-42 describes the testemail subcommand.

Table A-42. testemail configuration

Subcommand

Description

testemail

Tests the RAC's e-mail alerting feature.

Synopsis

racadm testemail -i <index>

Description

Sends a test e-mail from the RAC to a specified destination.

Prior to executing the test e-mail command, ensure that the specified index in the RACADM cfgEmailAlert group is enabled and configured properly. Table Table A-43 provides a list and associated commands for the cfgEmailAlert group.

Table A-43. testemail Configuration

Action

Command

Enable the alert

racadm config -g cfgEmailAlert -o cfgEmailAlertEnable
-i 1 1

Set the destination e-mail address

racadm config -g cfgEmailAlert -o cfgEmailAlertAddress -i 1 user1@mycompany.com

Set the custom message that is sent to the destination e-mail address

racadm config -g cfgEmailAlert -o cfgEmailAlertCustomMsg -i 1 "This is a test!"

Ensure the SNMP IP address is configured properly

racadm config -g cfgRemoteHosts -o cfgRhostsSmptServerIpAddr -i 192.168.0.152

View the current e-mail alert settings

racadm getconfig -g cfgEmailAlert -i <index>

where <index> is a number from 1 to 4

Options

Table A-44 describes the testemail subcommand options.

Table A-44. testemail Subcommands

Option

Description

-i

Specifies the index of the e-mail alert to test.

Output

None.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


testtrap

NOTE: To use this command, you must have Test Alerts permission.

Table A-45 describes the testtrap subcommand.

Table A-45. testtrap

Subcommand

Description

testtrap

Tests the RAC's SNMP trap alerting feature.

Synopsis

racadm testtrap -i <index>

Description

The testtrap subcommand tests the RAC's SNMP trap alerting feature by sending a test trap from the RAC to a specified destination trap listener on the network.

Before you execute the testtrap subcommand, ensure that the specified index in the RACADM cfgIpmiPet group is configured properly.

Table Table A-43 provides a list and associated commands for the cfgIpmiPet group.

Table A-46. cfgEmailAlert Commands

Action

Command

Enable the alert

racadm config -g cfgIpmiPet -o cfgIpmiPetAlertEnable
-i 1 1

Set the destination e-mail IP address

racadm config -g cfgIpmiPet -o cfgIpmiPetAlertDestIpAddr -i 1 192.168.0.110

View the current test trap settings

racadm getconfig -g cfgIpmiPet -i <index>

where <index> is a number from 1 to 4

Input

Table A-47 describes the testtrap subcommand options.

Table A-47. testtrap Subcommand Options

Option

Description

-i

Specifies the index of the trap configuration to use for the test Valid values are from 1 to 4.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


vmdisconnect

NOTE: To use this command, you must have Access Virtual Media permission.

Table A-48 describes the vmdisconnect subcommand.

Table A-48. vmdisconnect

Subcommand

Description

vmdisconnect

Closes all open RAC virtual media connections from remote
clients.

Synopsis

racadm vmdisconnect

Description

The vmdisconnect subcommand allows a user to disconnect another user's virtual media session. Once disconnected, the web-based interface will reflect the correct connection status. This is available only through the use of local or remote racadm.

The vmdisconnect subcommand enables a RAC user to disconnect all active virtual media sessions. The active virtual media sessions can be displayed in the RAC web-based interface or by using the racadm getsysinfo subcommand.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


vmkey

NOTE: To use this command, you must have Access Virtual Media permission.

Table A-49 describes the vmkey subcommand.

Table A-49. vmkey

Subcommand

Description

vmkey

Performs virtual media key-related operations.

Synopsis

racadm vmkey <action>

If <action> is configured as reset, the virtual flash memory is reset to the default size of 16 MB.

Description

When a custom virtual media key image is uploaded to the RAC, the key size becomes the image size. The vmkey subcommand can be used to reset the key back to its original default size, which is 16 MB on the DRAC 5.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


usercertupload

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-50 describes the sslcertupload subcommand.

Table A-50. usercertupload

Subcommand

Description

usercertupload

Uploads a user certificate or a user CA certificate from the client to the DRAC.

Synopsis

racadm usercertupload -t <type> [-f <filename>] -i <index>

Options

Table A-51 describes the usercertupload subcommand options.

Table A-51. usercertupload Subcommand Options

Option

Description

-t

Specifies the type of certificate to upload, either the CA certificate or server certificate.

1 = user certificate

2 = user CA certificate

-f

Specifies the file name of the certificate to be uploaded. If the file is not specified, the sslcert file in the current directory is selected.

-i

Index number of the user. Valid values 1-16.

The usercertupload command returns 0 when successful and returns a nonzero number when unsuccessful.

Restrictions

The usercertupload subcommand can only be executed from a local or a remote RACADM client.

Example

racadm usercertupload -t 1 -f c:\cert\cert.txt -i 6

Supported Interfaces

  • Local RACADM

  • Remote RACADM


usercertview

NOTE: To use this command, you must have Configure DRAC 5 permission.

Table A-52 describes the usercertview subcommand.

Table A-52. usercertview

Subcommand

Description

usercertview

Displays the user certificate or user CA certificate that exists on the DRAC.

Synopsis

racadm sslcertview -t <type> [-A] -i <index>

Options

Table A-53 describes the sslcertview subcommand options.

Table A-53. sslcertview Subcommand Options

Option

Description

-t

Specifies the type of certificate to view, either the user certificate or the user CA certificate.

1 = user certificate

2 = user CA certificate

-A

Prevents printing headers/labels.

-i

Index number of the user. Valid values are 1-16.

Supported Interfaces

  • Local RACADM

  • Remote RACADM

  • telnet/ssh/serial RACADM


localConRedirDisable

NOTE: Only a local racadm user can execute this command.

Table A-54 describes the localConRedirDisable subcommand.

Table A-54. localConRedirDisable

Subcommand

Description

localConRedirDisable

Disables console redirection to the management station.

Synopsis

racadm localConRedirDisable <option>

If <option> is set to 1, console redirection is disabled.

Supported Interfaces

  • Local RACADM


Back to Contents Page

 

Laptops | Desktops | Business Laptops | Business Desktops | Workstations | Servers | Storage | Monitors | Printers | LCD TVs | Electronics
© 2009 Dell | About Dell | Terms of Sale | Unresolved Issues | Privacy | About Our Ads | Dell Recycling | Contact | Site Map | Feedback
AT | AU | BE | BR | CA | CH | CL | CN | CO | DE | DK | ES | FR | HK | IE | IN | IT | JP | KR | ME | MX | MY | NL | NO | PA | PR | RU | SE | SG | UK | VE | ALL

snEB10