CMG-DCM
The following sections describe how to operate a DCM from the Linux
command line, including descriptions of all commands unique to the DCM.
Any of these commands can be included in your own shell script files, which
can be run as services on the DCM or remotely using a
ssh
connection as
required. If you need to compile your own C or FORTRAN programs to be run
on the DCM, please contact Güralp Systems for assistance.
6.3 Configuration
Configuring the DCM is automated by a suite of command line tools. These
maintain a configuration database and check that all the relevant Linux files are
kept up to date. If you alter the standard Linux configuration files, you should
bear in mind that these tools will overwrite them without checking that they
match the information in the database. Because of this you should use the tools
wherever possible rather than editing the files directly. The DCM's Web-based
configuration system is just a front-end to these tools.
gcfgdbls prefix
: Enter this command to find out which configuration
options begin with the prefix
prefix
(case sensitive—all the configuration
options are in lower case). The options are listed in alphabetical order. For
example:
~ # gcfgdbls serial.0
serial.0.baudrate
serial.0.handshaking
serial.0.ppp
serial.0.service
gcfgdbset
option-name
new-value
: Enter this command to set the
value of the named option to
new-value
. The database will perform a simple
type check on your value (for example, to check that certain options are
numbers), but will not otherwise make sure that your change makes sense.
gcfgdbget
option-name-or-prefix
: Enter this command to find the
current value of the named option. Instead of a single option name, you can also
use a prefix (as described above) to find out the values of a range of options.
The remaining tools also allow you to use prefixes in place of full option
names.
Each option in the database can be marked either as “clean” or as “dirty”. This
flag tells the DCM whether the database is currently in sync with the state of the
device. Whenever you alter the value of an option using the
gcfgdbset
tool,
or using the Web interface, the option is marked as “dirty”; the DCM then alters
its configuration, and marks the option as “clean” again, to signify that the
change completed successfully. Three more commands are provided to allow
you to access this flag:
gcfgdbmark clean
option-name-or-prefix
: Enter this command
to mark the named configuration option as “clean” in the database.
86
Issue A
