beautypg.com

Guralp Systems CMG-DCM User Manual

Page 119

background image

Operator's guide

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.

gcfgdbmark dirty option-name-or-prefix : Enter this

command to mark the named configuration option as “dirty” in the
database.

gcfgdbisdirty option-name-or-prefix (option-names-or-
prefixes

...

) : This command finds out whether any of the named

options is marked as “dirty”. If none are marked, the command exits

successfully; otherwise, it exits with a failure code. Thus you can use
gcfgdbisdirty in your own shell scripts, to perform actions

depending on the status of the DCM's configuration options.

Note that marking an option as “dirty” will not necessarily lead to any

action being taken. For example, you cannot force a service to be
restarted using these commands.

Each of the four tools can also take two command-line options:

gcfgdbxxx -h : Displays a short usage reminder about the command
gcfgdbxxx. All other arguments will be ignored.

gcfgdbxxx -c config-database other-arguments : Normally,

all the gcfgdbxxx commands work on the system configuration

database. However, you can supply the file name of an alternative
database using the -c option, in which case the command will be

December 2006

119