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.
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.
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.
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.
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.
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.
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
"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.
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.
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.
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.
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.
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.
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.
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.
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.
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 optioncannot 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 cfgRacSecuritygroup. 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.
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-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.
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.
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.
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.
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.