NAME
evmreload — reload Event Manager configuration files
SYNOPSIS
/usr/sbin/evmreload
[-d]
[-a]
[-c]
[-l]
[-n]
DESCRIPTION
The
evmreload
command posts control events that instruct EVM resident components to
reload their configuration files.
Use the
evmreload
command to cause EVM to begin using the new configuration at any time that
a configuration file has been changed.
If no options are specified, the daemon, the channel manager, and the
logger all reload their configurations.
Reconfigure
the daemon at any time that its configuration file or
that an event template database has changed.
Reconfigure
the logger at any time that its configuration file has changed.
Reconfigure
the channel manager at any time that its configuration file has changed.
Resident EVM components also reload their configuration files on receipt
of a
SIGHUP
signal.
If an activity monitor is specified in the EVM daemon configuration
file, all counts and timers associated with the monitor are reset.
Options
- -c
Reconfigures the EVM channel manager.
- -d
Reconfigures the EVM daemon.
- -l
Reconfigures the EVM logger.
- -n
Syntax checks the event template files and reports errors, but does not
make any changes effective.
- -a
If a daemon reconfiguration is requested, the reconfiguration request
is sent even if there are errors in any template file.
If errors exist in the template file,
there is no guarantee that the new configuration is accepted.
Notes
The
evmreload
command uses the
evminfo -verify
command to check for errors in configuration files before sending a
reload request to EVM.
If errors are found, they are reported to
stderr
and no reconfiguration request is sent.
This check does not find all possible errors, however, so be sure
to check for errors reported by the EVM components
themselves.
To do this, run the following command:
evmget -A -f '[name *.evm] & [age < 5m]' -t '@timestamp @@'
RETURN VALUES
The following exit values are returned:
- 0
Successful completion.
- not 0
An error occurred.
EXAMPLES
The following command causes the EVM daemon to reconfigure itself.
The following command causes the EVM logger to reconfigure itself.
The following command causes the EVM channel manager to reconfigure itself.
The following command causes a
syntax check of the daemon configuration file without any
reconfiguration actually occurring.
The following command
reconfigures both the EVM daemon and the EVM logger.
/usr/sbin/evmreload -d -l
The following command
reconfigures the EVM daemon, the EVM logger, and the EVM channel
manager.
The following command reconfigures the EVM daemon, the EVM logger,
and the EVM channel manager even if there are errors in the template file.
WARNINGS
You must be
root
to run this command.