evmreload(8) [osf1 man page]
evmreload(8) System Manager's Manual evmreload(8) NAME
evmreload - Reload Event Manager configuration files SYNOPSIS
/usr/sbin/evmreload [-d] [-a] [-c] [-l] [-n] OPTIONS
Reconfigures the EVM channel manager. Reconfigures the EVM daemon. Reconfigures the EVM logger. Syntax checks the event template files and reports errors, but does not make any changes effective. If a daemon reconfiguration is requested, the reconfiguration request will be sent even if there are errors in any template file. If errors exist, there is no guarantee that the new configuration will be accepted. OPERANDS
None DESCRIPTION
The evmreload command posts control events that instruct EVM resident components to reload their configuration files. It should be run to cause EVM to begin using the new configuration any time a configuration file has been changed. If no options are specified, the daemon, the channel manager, and the logger all reload their configurations. The daemon should be reconfigured any time its configuration file or event template database has changed. The logger should be reconfig- ured anytime its configuration has changed. The channel manager should be reconfigured anytime its configuration 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. NOTES
The evmreload command uses the evmshow -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 you should take care 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 @@' RESTRICTIONS
You must be user root to run this command. EXAMPLES
The following command will cause the EVM daemon to reconfigure itself: /usr/sbin/evmreload -d The following command will cause the EVM log- ger to reconfigure itself: /usr/sbin/evmreload -l The following command will cause the EVM channel manager to reconfigure itself: /usr/sbin/evmreload -c To syntax check the daemon configuration file without any reconfiguration actually occurring, enter the following command: /usr/sbin/evmreload -n To reconfigure both the EVM daemon and the EVM logger, enter the following command: /usr/sbin/evmreload -d -l To reconfigure the EVM daemon, the EVM logger, and the EVM channel manager, enter the following command: /usr/sbin/evmreload The follow- ing command will reconfigure the EVM daemon, the EVM logger, and the EVM channel manager even if there are errors in the template file. /usr/sbin/evmreload -a EXIT VALUES
The following exit values are returned: Successful completion An error occurred FILES
Executable file SEE ALSO
Commands: evmchmgr(8), evmd(8), evmlogger(8), evmpost(1) Files: evmchannel.conf(4), evmdaemon.conf(4), evmlogger.conf(4) Event Management: EVM(5) EVM Events: EvmEvent(5) delim off evmreload(8)
Check Out this Related Man Page
evmdaemon.conf(4) Kernel Interfaces Manual evmdaemon.conf(4) NAME
evmdaemon.conf - EVM daemon configuration file SYNOPSIS
sourcedir directory authtimeout time_seconds synctimeout time_seconds portnum port_number start_sync command remote_connection bool_par activity_monitor { name detector period detect_period threshold detect_thold holdoff detect_delay } service { name service_name command service_command } DESCRIPTION
The EVM daemon configuration file, evmdaemon.conf, is a text file that contains commands used to configure and start the Event Manager. Any portion of a line from an unquoted number sign (#) to the end of line is a comment. Blank lines are ignored. The following commands are recognized: Names the directory that should be searched for event template files. The default is /usr/share/evm/templates. Time to wait for a newly established client to respond to an authentication request. The default is 10 seconds. Time within which a synchronized client must achieve synchronization completing a connection request and subscribing for events. The default is 30 seconds. The port num- ber for TCP communication with remote clients. If not specified, the evm port number found in /etc/services is used if present; otherwise the reserved default value of 619 is used. The complete command line for programs that should be started as synchronized clients when the daemon starts. This command should be enclosed in double quotation marks ("). Determines the permission for connections through a remote TCP port. If bool_par evaluates to TRUE, remote connection is permitted. The default is not permitted. The bool_par parameter should be True or False. A parameter group that controls a daemon event monitoring facility. An activity_monitor definition consists of: The type of detector controlled by the group parameters. The size, in minutes, of a periodically sliding time window over which events will be counted. The number of events that will activate the monitor if counted in period. The time delay, in minutes, after activation of the activity monitor occurs before monitoring is resumed. The evmreload command will reset the delay. Defines services that are available through the daemon. A service definition consists of the name of the service and the command line that will be invoked when this service is requested. User-defined services are not currently supported. A service definition consists of: The name given to the service. The command to be invoked when this service is requested. This command should be enclosed in double quotation marks ("). The keywords described may be entered in a case-insensitive manner. The allowable strings and the minimum number of characters is shown in the following table. A minimum of zero (0) indicates that all characters are required. ---------------------------- Keyword Minimum ---------------------------- activity_monitor 0 authtimeout 8 command 4 filterdir 7 holdoff 0 name 0 period 0 portnum 4 remote_connection 0 service 7 sourcedir 7 start_sync 0 synctimeout 8 threshold 0 ---------------------------- The activity monitor detectors recognized, and the action taken when the monitor is activated are the following: -------------------------------------------------------------- Detector Action -------------------------------------------------------------- event_count post an event to alert the system administrator -------------------------------------------------------------- EXAMPLES
This is an example of an EVM daemon configuration file that does the following: Specifies that event templates are found in the directory /usr/share/evm/templates. Starts the EVM Logger and the EVM Channel Manager as synchronized clients when the daemon is started. Defines a service available through the EVM daemon. Establishes an activity monitor that will alert the system administrator if 500 events occur in any 10 minute span. Once the system administrator has been alerted, the activity monitor will remain dormant for four hours. Disables connections from remote hosts. # Event template directory: sourcedir "/usr/share/evm/templates" # Start the EVM Logger as a synchronized client: start_sync "/usr/sbin/evmlogger -o /var/run/evmlogger.info -l /var/evm/adm/logfiles/evmlogger.log" # Start the EVM Channel Manager as a synchronized client: start_sync "/usr/sbin/evmchmgr -l /var/evm/adm/logfiles/evmchmgr.log" # Event retrieval service definition: service { name event_get command "/usr/sbin/evmget_srv" } # Set up an activity monitor. activity_monitor { name event_count # currently the only supported monitor period 10 # count over a 10 minute period threshold 500 # perform action after 500 events holdoff 240 # wait 4 hours before resuming } # Disable remote communication (set following to "true" to enable) remote_connection false FILES
Location of the EVM authorization file. Location of the EVM daemon configuration file. Definition of the sockets and protocols used for Internet services. SEE ALSO
Commands: evmd(8), evmreload(8) Files: services(4) Event Management: EVM(5) delim off evmdaemon.conf(4)