Dell Drac 5 User Guide

							Advanced Configuration of the DRAC 581
RACADM Subcommands
Table 4-20 provides a description of each racadm subcommand that you can 
run in RACADM. For a detailed listing of racadm subcommands including 
syntax and valid entries, see RACADM Subcommand Overview on 
page 295.
When entering a RACADM subcommand, prefix the command with 
racadm. For example:
racadm help
Table 4-20. RACADM Subcommands
Command Description
helpLists DRAC 5 subcommands.
help 
Lists usage statement for the specified subcommand.
arpDisplays the contents of the ARP table. ARP table entries may 
not be added or deleted.
clearasrscreenClears the last ASR (crash) screen (last blue screen).
clrraclogClears the DRAC 5 log. A single entry is made to indicate the 
user and time that the log was cleared.
configConfigures the RAC.
getconfigDisplays the current RAC configuration properties.
coredumpDisplays the last DRAC 5 coredump.
coredumpdeleteDeletes the coredump stored in the DRAC 5.
fwupdateExecutes or displays status on DRAC 5 firmware updates.
getssninfo Displays information about active sessions.
getsysinfoDisplays general DRAC 5 and system information.
getractimeDisplays the DRAC 5 time.
ifconfigDisplays the current RAC IP configuration.
netstatDisplays the routing table and the current connections.
pingVerifies that the destination IP address is reachable from the 
DRAC 5 with the current routing-table contents.
setniccfgSets the IP configuration for the controller.
getniccfgDisplays the current IP configuration for the controller. 
						

							82Advanced Configuration of the DRAC 5
getsvctagDisplays service tags.
racdumpDumps DRAC 5 status and state information for debug.
racreset Resets the DRAC 5.
racresetcfgResets the DRAC 5 to the default configuration.
serveractionPerforms power management operations on the managed system.
getraclogDisplays the RAC log.
clrselClears the System Event Log entries.
gettracelogDisplays the DRAC 5 trace log. If used with -i, the command 
displays the number of entries in the DRAC 5 trace log.
sslcsrgenGenerates and downloads the SSL CSR.
sslcertuploadUploads a CA certificate or server certificate to the DRAC 5.
sslcertdownloadDownloads a CA certificate.
sslcertviewViews a CA certificate or server certificate in the DRAC 5.
sslresetcfgRestores the web-server certificate to factory default and 
restarts the web-server.
testemailForces the DRAC 5 to send a test e-mail over the DRAC 5 NIC 
to check the e-mail configuration.
testtrapForces the DRAC 5 to send a test SNMP trap over the DRAC 5 
NIC to check the trap configuration.
vmdisconnectForces a virtual media connection to close.
vmkeyResets the virtual flash size to its default size (16 MB). Table 4-20. RACADM Subcommands 
(continued)
Command Description 
						

							Advanced Configuration of the DRAC 583
Frequently Asked Questions About RACADM Error Messages
After performing a DRAC 5 reset (using the racadm racreset command), 
I issue a command and the following message is displayed: 
racadm  Transport: ERROR: (RC=-1)
What does this message mean?
You must wait until the DRAC 5 completes the reset before issuing another 
command.
When I use the racadm commands and subcommands, I get errors that 
I don’t understand.
You may encounter one or more of the following errors when using the 
racadm commands and subcommands:
• Local racadm error messages — Problems such as syntax, typographical 
errors, and incorrect names.
• Remote racadm error messages—Problems such as incorrect IP Address, 
incorrect username, or incorrect password.
When I ping the DRAC IP address from my system and then switch my 
DRAC 5 card between Dedicated and Shared modes during the ping 
response, I do not receive a response. 
Clear the ARP table on your system.
Configuring Multiple DRAC 5 Cards
Using RACADM, you can configure one or more DRAC 5 cards with 
identical properties. When you query a specific DRAC 5 card using its group 
ID and object ID, RACADM creates the racadm.cfg configuration file from 
the retrieved information. By exporting the file to one or more DRAC 5 cards, 
you can configure your controllers with identical properties in a minimal 
amount of time. 
 NOTE: Some configuration files contain unique DRAC 5 information (such as 
the static IP address) that must be modified before you export the file to other 
DRAC 5 cards. 
						

							84Advanced Configuration of the DRAC 5
To configure multiple DRAC 5 cards, perform the following procedures:
1
Use RACADM to query the target DRAC 5 that contains the appropriate 
configuration. 
 NOTE: The generated .cfg file does not contain user passwords.
Open a command prompt and type:
racadm getconfig -f myfile.cfg
 NOTE: Redirecting the RAC configuration to a file using getconfig -f is only 
supported with the local and remote RACADM interfaces.
2Modify the configuration file using a simple text editor (optional).
3Use the new configuration file to modify a target RAC.
In the command prompt, type:
racadm config -f myfile.cfg
4
Reset the target RAC that was configured.
In the command prompt, type:
racadm reset
The getconfig -f racadm.cfg subcommand requests the DRAC 5 
configuration and generates the racadm.cfg file. If required, you can 
configure the file with another name. 
You can use the getconfig command to enable you to perform the following 
actions:
• Display all configuration properties in a group (specified by group name 
and index)
• Display all configuration properties for a user by user name
The config subcommand loads the information into other DRAC 5s. Use config 
to synchronize the user and password database with Server Administrator 
						

							Advanced Configuration of the DRAC 585
The initial configuration file, racadm.cfg, is named by the user. In the 
following example, the configuration file is named myfile.cfg. To create this 
file, type the following at the command prompt:
racadm getconfig -f myfile.cfg
 CAUTION: It is recommended that you edit this file with a simple text editor. The 
racadm utility uses an ASCII text parser, which does not recognize any kind of 
formatting and can corrupt the RACADM database.
Creating a DRAC 5 Configuration File
The DRAC 5 configuration file .cfg is used with the racadm 
config -f .cfg command. You can use the configuration 
file to build a configuration file (similar to an .ini file) and configure the 
DRAC 5 from this file. You may use any file name, and the file does not 
require a .cfg extension (although it is referred to by that extension name in 
this subsection). 
The .cfg file can be:
•Created
• Obtained from a 
racadm getconfig -f .cfg 
command
• Obtained from a r
acadm getconfig -f .cfg 
command, and then edited
 NOTE: See getconfig on page 299 for information about the getconfig command.
The .cfg file is first parsed to verify that valid group and object names are 
present and that some simple syntax rules are being followed. Errors are 
flagged with the line number that detected the error, and a simple message 
explains the problem. The entire file is parsed for correctness, and all errors 
are displayed. Write commands are not transmitted to the DRAC 5 if an error 
is found in the .cfg file. The user must correct all errors before any 
configuration can take place. The 
-c option may be used in the config 
subcommand, which verifies syntax only and does not perform a write 
operation to the DRAC 5. 
						

							86Advanced Configuration of the DRAC 5
Use the following guidelines when you create a .cfg file:
• If the parser encounters an indexed group, it is the value of the anchored 
object that differentiates the various indexes. 
The parser reads in all of the indexes from the DRAC 5 for that group. 
Any objects within that group are simple modifications when the DRAC 5 
is configured. If a modified object represents a new index, the index is 
created on the DRAC 5 during configuration.
• You cannot specify an index of your choice in a 
.cfg file.
Indexes may be created and deleted, so over time the group may become 
fragmented with used and unused indexes. If an index is present, it is 
modified. If an index is not present, the first available index is used. This 
method allows flexibility when adding indexed entries where you do not 
need to make exact index matches between all the RACs being managed. 
New users are added to the first available index. A 
.cfg file that parses and 
runs correctly on one DRAC 5 may not run correctly on another if all 
indexes are full and you must add a new user.
•Use the 
racresetcfg subcommand to configure all DRAC 5 cards with 
identical properties.
Use the 
racresetcfg subcommand to reset the DRAC 5 to original defaults, 
and then run the 
racadm config -f .cfg 
command. Ensure that the .cfg file includes all required objects, users, 
indexes, and other parameters.
 CAUTION: Use the racresetcfg subcommand to reset the database and the 
DRAC 5 NIC settings to the original default settings and remove all users and user 
configurations. While the root user is available, other users’ settings are also reset 
to the default settings. 
						

							Advanced Configuration of the DRAC 587
Parsing Rules
• All lines that start with # are treated as comments. 
A comment line 
must start in column one. A # character in any other 
column is treated as a # character.
Some modem parameters may include # characters in its string. An escape 
character is not required. You may want to generate a 
.cfg from a racadm 
getconfig -f .cfg
 command, and then perform a 
racadm config -f .cfg command to a different 
DRAC 5, without adding escape characters.
Example:
#
# This is a comment
[cfgUserAdmin]
cfgUserAdminPageModemInitString=
• All group entries must be surrounded by [ and ] characters. 
The starting 
[ character denoting a group name must start in column one. 
This group name 
must be specified before any of the objects in that group. 
Objects that do not include an associated group name generate an error. The 
configuration data is organized into groups as defined in DRAC 5 Property 
Database Group and Object Definitions on page 345.
The following example displays a group name, object, and the object’s 
property value.
Example:
[cfgLanNetworking] -{group name}
cfgNicIpAddress=143.154.133.121 {object name} 
						

							88Advanced Configuration of the DRAC 5
• All parameters are specified as object=value pairs with no white space 
between the object, =, or value. 
White spaces that are included after the value are ignored. A white space 
inside a value string remains unmodified. Any character to the right of the 
= is taken as is (for example, a second =, or a #, [, ], and so forth). 
These characters are valid modem chat script characters. 
See the example in the previous bullet.
•The 
.cfg parser ignores an index object entry.
Yo u  
cannot specify which index is used. If the index already exists, it is 
either used or the new entry is created in the first available index for that 
group.
The 
racadm getconfig -f .cfg command places a 
comment in front of index objects, allowing the user to see the included 
comments.
 NOTE: You may create an indexed group manually using the following command: 
racadm config -g  -o  
-i  
• The line for an indexed group cannot be deleted from a .cfg file. 
You must remove an indexed object manually using the following 
command:
racadm config -g  -o  -i 
  
 NOTE: A NULL string (identified by two  characters) directs the DRAC 5 to delete 
the index for the specified group.
To view the contents of an indexed group, use the following command:
racadm getconfig -g  -i 
• For indexed groups the object anchor must be the first object after the [ ] 
pair. The following are examples of the current indexed groups:
[cfgUserAdmin]
cfgUserAdminUserName= 
						

							Advanced Configuration of the DRAC 589
If you type racadm getconfig -f .cfg, the 
command builds a 
.cfg file for the current DRAC 5 configuration. This 
configuration file can be used as an example and as a starting point for 
your unique 
.cfg file.
Modifying the DRAC 5 IP Address
When you modify the DRAC 5 IP address in the configuration file, remove 
all unnecessary =value entries. Only the actual variable group’s 
label with [ and ] remains, including the two =value entries 
pertaining to the IP address change.
Fo r  e x a m p l e :
#
#   Object Group cfgLanNetworking
#
[cfgLanNetworking]
cfgNicIpAddress=10.35.10.110
cfgNicGateway=10.35.10.1
This file will be updated as follows:
#
#   Object Group cfgLanNetworking
#
[cfgLanNetworking]
cfgNicIpAddress=10.35.9.143
# comment, the rest of this line is ignored
cfgNicGateway=10.35.9.1
The command racadm config -f myfile.cfg parses the file and identifies any 
errors by line number. A correct file will update the proper entries. 
Additionally, you can use the same getconfig command from the previous 
example to confirm the update. 
						

							90Advanced Configuration of the DRAC 5
Use this file to download company-wide changes or to configure new systems 
over the network.
 NOTE: Anchor is an internal term and should not be used in the file. 
Configuring DRAC 5 Network Properties
To generate a list of available network properties, type the following: 
racadm getconfig -g cfgLanNetworking
To use DHCP to obtain an IP address, use the following command to write 
the object cfgNicUseDhcp and enable this feature:
racadm config -g cfgLanNetworking -o cfgNicUseDHCP 1
The commands provide the same configuration functionality as the option 
ROM at boot-up when you are prompted to type . For more 
information about configuring network properties with the option ROM, 
see Configuring DRAC 5 Network Properties on page 90.
The following is an example of how the command may be used to configure 
desired LAN network properties.
racadm config -g cfgLanNetworking -o cfgNicEnable 1
racadm config -g cfgLanNetworking -o cfgNicIpAddress 
192.168.0.120
racadm config -g cfgLanNetworking -o cfgNicNetmask 
255.255.255.0
racadm config -g cfgLanNetworking -o cfgNicGateway 
192.168.0.120
racadm config -g cfgLanNetworking -o cfgNicUseDHCP 0
racadm config -g cfgLanNetworking -o 
cfgDNSServersFromDHCP 0
racadm config -g cfgLanNetworking -o cfgDNSServer1 
192.168.0.5
racadm config -g cfgLanNetworking -o cfgDNSServer2 
192.168.0.6
racadm config -g cfgLanNetworking -o 
cfgDNSRegisterRac 1