255
1. 8 7 7. 8 7 7. 2 26 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.87 7.2269
The custom user configuration is saved in the /etc/config/config.xml file. This file is transparently accessed and edited when
configuring the device using the Management Console browser GUI. Only the root user can configure from the shell.
By default, the config elements are separated by a . character (a full-stop or period). The root of the config tree is called <config>.
To address a specific element, place a . between each node or branch. For example, to access and display the description of user1
type:
# config -g config.users.user1.description
The root node of the config tree is <config>. To display the entire config tree, type:
# config -g config
To display the help text for the config command, type:
# config -h
The config application resides in the /bin directory. The environmental variable called PATH contains a route to the /bin directory.
This allows a user to simply type config at the command prompt instead of the full /bin/config path.
TABLE 15-1. CONFIG OPTIONS
OPTION DESCRIPTION
-a --run-all
Run all registered configurators. This performs every configuration synchronization action pushing all changes to
the live system.
-h --help Display a brief usage message.
-v --verbose Log extra debug information.
-d --del=id Remove the given configuration element specified by a . separated identifier.
-g --get=id Display the value of a configuration element
-p --path=file Specify an alternate configuration file to use. The default file is located at /etc/config/config.xml.
-r --run=configurator Run the specified registered configurator. Registered configurators are listed below.
-s --set=id=value Change the value of configuration element specified by a . separated identifier.
-e --export=file Save active configuration to file.
-i --import=file Load configuration from file.
-t --test-import=file Pretend to load configuration from file.
-S --separator=char The pattern to separate fields with. The default is .
-P --password=id Prompt user for a value. Hash the value, then save it in id.
The registered configurators are:
alerts ipconfig
auth nagios
cascade power
console serialconfig
dhcp services
dialin slave
eventlog systemsettings
hosts time
ipaccess ups
users
CHAPTER 15: CONFIGURATION FROM THE COMMAND LINE