Dell Drac 5 User Manual

							RACADM Subcommand Overview321
Supported Interfaces

 Remote RACADM
testemail
Table A-44 describes the testemail subcommand.
Synopsis
racadm testemail -i 
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 A-45 provides a list and associated commands for the cfgEmailAlert 
group.
Table A-44. testemail configuration
Subcommand Description
testemail Tests the RAC’s e-mail alerting 
feature.
Table A-45. testemail Configuration
Action Command
Enable the alertracadm config -g cfgEmailAlert -o 
cfgEmailAlertEnable 
-i 1 1
Set the destination e-
mail addressracadm config -g cfgEmailAlert -o 
cfgEmailAlertAddress -i 1 
[email protected]
Set the custom message 
that is sent to the 
destination e-mail 
addressracadm config -g cfgEmailAlert -o 
cfgEmailAlertCustomMsg -i 1 This is a 
test! 
						

							322RACADM Subcommand Overview
Options
Table A-46 describes the testemail subcommand options.
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-47 describes the testtrap subcommand.
Ensure the SNMP IP 
address is configured 
properlyracadm config -g cfgRemoteHosts -o 
cfgRhostsSmptServerIpAddr -i 
192.168.0.152
View the current e-mail 
alert settingsracadm getconfig -g cfgEmailAlert -i 

where  is a number from 1 to 4
Table A-46. testemail Subcommands
Option Description
-iSpecifies the index of the e-mail alert to test.
Table A-47. testtrap
Subcommand Description
testtrapTests the RAC’s SNMP trap alerting feature. Table A-45. testemail Configuration (continued)
Action Command 
						

							RACADM Subcommand Overview323
Synopsis
racadm testtrap -i 
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 A-48 provides a list and associated commands for the cfgIpmiPet 
group.
Input
Table A-49 describes the testtrap subcommand options.
Table A-48. cfgEmailAlert Commands
Action Command
Enable the alertracadm config -g cfgIpmiPet -o 
cfgIpmiPetAlertEnable 
-i 1 1
Set the destination 
e-mail IP addressracadm config -g cfgIpmiPet -o 
cfgIpmiPetAlertDestIpAddr -i 1 
192.168.0.110
View the current test 
trap settingsracadm getconfig -g cfgIpmiPet -i 

where  is a number from 1 to 4
Table A-49. testtrap Subcommand Options
Option Description
-iSpecifies the index of the trap configuration to use for the test Valid 
values are from 1 to 4. 
						

							324RACADM Subcommand Overview
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-50 describes the vmdisconnect subcommand.
Synopsis
racadm vmdisconnect
Description
The vmdisconnect subcommand allows a user to disconnect another users 
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
Table A-50. vmdisconnect
Subcommand Description
vmdisconnect Closes all open RAC virtual media connections from remote 
clients. 
						

							RACADM Subcommand Overview325
vmkey
 NOTE: To use this command, you must have Access Virtual Media permission.
Table A-51 describes the vmkey subcommand.
Synopsis
racadm vmkey 
If  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

 Remote RACADM
 telnet/ssh/serial RACADM
usercertupload
 NOTE: To use this command, you must have Configure DRAC 5 permission.
Table A-52 describes the usercertupload subcommand.
Table A-51. vmkey
Subcommand Description
vmkey Performs virtual media key-related operations.
Table A-52. usercertupload
Subcommand Description
usercertuploadUploads a user certificate or a user CA 
certificate from the client to the DRAC. 
						

							326RACADM Subcommand Overview
Synopsis
racadm usercertupload -t  [-f ] -i 
<
index>
Options
Table A-53 describes the usercertupload subcommand options.
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
Table A-53. usercertupload Subcommand Options
Option Description
-tSpecifies the type of certificate to upload, either the CA certificate or 
server certificate.
1 = user certificate
2 = user 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.
-iIndex number of the user. Valid values 1-16. 
						

							RACADM Subcommand Overview327
usercertview
 NOTE: To use this command, you must have Configure DRAC 5 permission.
Table A-54 describes the usercertview subcommand.
Synopsis
racadm sslcertview -t  [-A] -i 
Options
Table A-55 describes the sslcertview subcommand options.
Supported Interfaces

 Remote RACADM
 telnet/ssh/serial RACADM
Table A-54. usercertview
Subcommand Description
usercertviewDisplays the user certificate or user CA 
certificate that exists on the DRAC.
Table A-55. sslcertview Subcommand Options
Option Description
-tSpecifies the type of certificate to view, either the user certificate or 
the user CA certificate.
1 = user certificate
2 = user CA certificate
-APrevents printing headers/labels.
-iIndex number of the user. Valid values are 1-16. 
						

							328RACADM Subcommand Overview
localConRedirDisable
 NOTE: Only a local racadm user can execute this command.
Table A-56 describes the localConRedirDisable subcommand.
Synopsis
racadm localConRedirDisable 
If  is set to 1, console redirection is disabled.
Supported Interfaces
 Local RACADM
Table A-56. localConRedirDisable
Subcommand Description
localConRedirDisable Disables console redirection to the management station. 
						

							DRAC 5 Property Database Group and Object Definitions329
DRAC 5 Property Database Group 
and Object Definitions
The DRAC 5 property database contains the configuration information for 
the DRAC 5. Data is organized by associated object, and objects are 
organized by object group. The IDs for the groups and objects that the 
property database supports are listed in this section.
Use the group and object IDs with the racadm utility to configure the DRAC 
5. The following sections describe each object and indicate whether the 
object is readable, writable, or both.
All string values are limited to displayable ASCII characters, except where 
otherwise noted. 
Displayable Characters
Displayable characters include the following set:
abcdefghijklmnopqrstuvwxwz
ABCDEFGHIJKLMNOPQRSTUVWXYZ
0123456789~`!@#$%^&*()_+-={}[]|\:;,.?/
idRacInfo
This group contains display parameters to provide information about the 
specifics of the DRAC 5 being queried.
One instance of the group is allowed. The following subsections describe the 
objects in this group.
idRacProductInfo (Read Only)
Legal Values
String of up to 63 ASCII characters. 
						

							330DRAC 5 Property Database Group and Object Definitions
Default
Dell Remote Access Controller 5
Description
Uses a text string to identify the product.
idRacDescriptionInfo (Read Only)
Legal Values
String of up to 255 ASCII characters.
Default
This system component provides a complete set of remote management 
functions for Dell PowerEdge servers.
Description
A text description of the RAC type.
idRacVersionInfo (Read Only)
Legal Values
String of up to 63 ASCII characters.
Default
1.0
Description
A string containing the current product firmware version.
idRacBuildInfo (Read Only)
Legal Values
String of up to 16 ASCII characters.