Dell Drac 5 User Guide

							RACADM Subcommand Overview321
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-28. serveraction Subcommand Options
String Definition
Specifies the action. The options for the  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.
Table A-29. getraclog
Command Definition
getraclog -iDisplays the number of entries in the DRAC 5 log.
getraclogDisplays the DRAC 5 log entries. 
						

							322RACADM Subcommand Overview
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 
						

							RACADM Subcommand Overview323
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.
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.
Table A-30. getsel
Command Definition
getsel -iDisplays the number of entries in the System Event Log.
getselDisplays SEL entries. 
						

							324RACADM Subcommand Overview
-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.
Fo r  e x a m p l e :
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). 
						

							RACADM Subcommand Overview325
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.
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 — does not display headers or labels
Table A-31. gettracelog
Command Definition
gettracelog -iDisplays the number of entries in the DRAC 5 trace log.
gettracelogDisplays the DRAC 5 trace log. 
						

							326RACADM Subcommand Overview
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. 
Fo r  e x a m p l e :
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.
Synopsis
racadm sslcsrgen [-g] [-f ]
racadm sslcsrgen -s
Table A-32. sslcsrgen
Subcommand Description
sslcsrgenGenerates and downloads an SSL certificate 
signing request (CSR) from the RAC. 
						

							RACADM Subcommand Overview327
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.
 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 Table A-33. sslcsrgen Subcommand Options
Option Description
-gGenerates a new CSR.
-sReturns the status of a CSR generation process (generation in progress, 
active, or none).
-fSpecifies the filename of the location, , where the CSR will 
be downloaded. 
						

							328RACADM Subcommand Overview
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.
Synopsis
racadm sslcertupload -t  [-f ]
Options
Table A-35 describes the sslcertupload subcommand options.
Table A-34. sslcertupload
Subcommand Description
sslcertuploadUploads a custom SSL server or CA certificate 
from the client to the RAC.
Table A-35. sslcertupload Subcommand Options
Option Description
-tSpecifies the type of certificate to upload, either the CA certificate or 
server certificate.
1 = server certificate
2 = CA certificate
-fSpecifies the file name of the certificate to be uploaded. If the file is 
not specified, the sslcert file in the current directory is selected. 
						

							RACADM Subcommand Overview329
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.
Synopsis
racadm sslcertdownload -t  [-f ]
Table A-36. sslcertdownload
Subcommand Description
sslcertdownloadDownloads an SSL certificate from the RAC to 
the client’s file system. 
						

							330RACADM Subcommand Overview
Options
Table A-37 describes the sslcertdownload subcommand options.
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
Table A-37. sslcertdownload Subcommand Options
Option Description
-tSpecifies the type of certificate to download, either the 
Microsoft Active Directory certificate or server certificate.
1 = server certificate
2 = Microsoft Active Directory certificate
-fSpecifies 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.