ovconfchg()ovconfchg()NAMEovconfchg - manipulates settings files, updates the configuration data‐
base, and triggers notification scripts
SYNOPSISovconfchg-h | -help
ovconfchg-version
ovconfchg [-ovrg <OVRG>] [-edit | -job {-ns namespace {-set <attr>
<value> | -clear <attr> | -clear -all} ... } ... ]
DESCRIPTION
Installed OpenView components have associated configuration settings
files that contain one or more namespaces. A namespace is a group of
configuration settings that belong to a component.
ovconfchg manipulates the settings in either the system-wide configura‐
tion file or the configuration file for the specified OV Resource
Group, local_settings.ini, updates the configuration database, set‐
tings.dat, and triggers notification scripts. If ovconfchg is called
without options, or only with -ovrg, no settings are changed but an
update is triggered anyway. This is to allow updating after default
settings files have been added, removed, or updated.
When ovconfchg runs, all configuration settings are read and merged in
memory. Default definitions are used to make corresponding checks, as
well as to emit and log warnings in the event of a violation. During
this process, file locks are used to prevent parallel updates. A new
configuration database is then created containing the merged data.
Parameters
ovconfchg recognizes the following options:
-h | -help
Displays all the options for the ovconfchg command.
-version
Displays the version of the ovconfchg command.
-ovrg <OVRG>
If the parameter you want to change belongs to an OpenView
resource group, use -ovrg to specify the name of the resource
group. Otherwise, system-wide settings files are opened.
-edit
Starts a text editor to edit the settings file, local_set‐
tings.ini. The text editor used is determined by the $EDITOR
environment variable. If $EDITOR is not set, vi starts on UNIX
and Notepad starts on Windows.
A temporary copy of the file is created for editing. After the
changes are made, the file is validated for syntax errors. The
syntax rule for validation is that the namespace and attribute
names should contain only letters (a-z, A-Z), digits (0-9),
period(.) and underscore(_) characters.
If the validation fails, the line number of the error is
reported and the user will be prompted to correct the file. If
Yes, the file will be reopened for making the necessary changes.
If No, the original settings file remains unchanged. If the val‐
idation is successful, the changes are saved into the original
settings file.
Do not configure binary values using this option. This can cor‐
rupt the file. It is also recommended to restrict the data
entered using this option to US-ASCII (7-bit only) subset.
Do not open the settings file directly in a text editor and
change it. This can corrupt the file.
-job
Create an update job file only and do not synchronize.
-ns | -namespace <namespace>
Sets a namespace for the -set and -clear options.
-set <attr> <value>
Sets an attribute value in the namespace specified by the
-namespace option. The local or OV resource settings file is
updated accordingly.
-clear <attr>
Clears the local setting for the attribute attr in the namespace
specified by the -namespace option. The local settings file is
updated accordingly.
-clear -all
Clears all local settings. The local settings file is updated
accordingly.
AUTHORovconfchg was developed by Hewlett-Packard Company.
FILES
The ovconfchg command uses the following files to store local settings:
· <DataDir>/conf/xpl/config/local_settings.ini
· <ShareDir>/<OVRG>/conf/xpl/config/local_settings.ini
The ovconfchg command uses the following files to store database con‐
figuration settings:
· <DataDir>/datafiles/xpl/config/settings.dat
· <ShareDir>/<OVRG>/datafiles/xpl/settings.dat
EXAMPLES
The following examples show how to use the ovconfchg command:
· To assign the value 12 to the attribute COUNT, and assign the value
"red blue white" to the attribute COLORS in the namespace, tst.lib:
ovconfchg-ns tst.lib -set COUNT 12 -set COLORS "red blue white"
· To clear the attribute COUNT in the namespace tst.lib:
ovconfchg-ns tst.lib -clear COUNT
· To remove all locally configured attributes from the namespace
tst.lib:
ovconfchg-ns tst.lib -clear '*'
· For the OpenView resource group server, assign the value 50 to the
attribute COUNT in the namespace tst.lib:
ovconfchg-ovrg server -ns tst.lib -set COUNT 50
SEE ALSO
ovconfget
ovconfchg()