NAME
ovconfchg
- manipulate settings files, update the configuration database, and trigger notification scripts.
SYNOPSIS
ovconfchg -h | -help
ovconfchg -version
ovconfchg [-ovrg <OVRG
>] [-edit | -job {-nsnamespace
{-set <attr
> <value
> | -clear <attr
> | -clear -all} ... } ... ]
DESCRIPTION
Installed HP Operations Manager 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.
The ovconfchg
command manipulates the settings in
either the system-wide configuration file or the configuration file
for the specified HPOM Resource Group,
local_settings.ini
, updates the configuration
database, settings.dat
, and triggers notification
scripts. If you call ovconfchg
without options, or
only with -ovrg
, no settings are changed, but an
update is triggered anyway. This update enables 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
The ovconfchg
command recognizes the following
options:
ovconfchg
command.
ovconfchg
command.
<OVRG
>-ovrg
to specify the name of the resource
group. Otherwise, system-wide settings files are opened.
$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 you make changes, 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 you are prompted to correct the file. If Yes, the file is reopened for making the necessary changes. If No, the original settings file remains unchanged. If the validation is successful, the changes are saved into the original settings file.
Do not open the settings file directly in a text editor and change it. This can corrupt the file.
-ns | -namespace
<namespace
>
-set
and
-clear
options.
<attr
>
<value
>-namespace
option. The local or HPOM resource settings
file is updated accordingly.
-clear
<attr
>attr
in the namespace specified by the
-namespace
option. The local settings file is updated
accordingly.
-clear -all
AUTHOR
ovconfchg
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 configuration settings:
<
DataDir
>/datafiles/xpl/config/settings.dat
<
ShareDir
>/<
OVRG
>/datafiles/xpl/settings.dat
EXAMPLES
The following examples show how to use the
ovconfchg
command:
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"
COUNT
in the namespace
tst.lib
:
ovconfchg -ns tst.lib -clear COUNT
tst.lib
:
ovconfchg -ns tst.lib -clear '*'
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