Users Guide

Using the RACADM Command Line Interface 165
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 writes to 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.
• The user cannot specify a desired index 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 the user does 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 <filename>.cfg
command. Ensure that the .cfg file includes all desired objects,
users, indexes, and other parameters.
NOTICE: 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.
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 <filename>.cfg command,
and then perform a
racadm config -f <filename>.cfg command to a different DRAC 5,
without adding escape characters.
Example :
#
# This is a comment