EPS Help
The display of the Event Processor Subsystem (EPS) configuration file list
is expanded or collapsed in the Configuration Manager table of contents (TOC)
pane at the left side of the NonStop Cluster Management Suite (NCMS)
window by double clicking on Event Processor Subsystem in the TOC.
Introduction
EPS monitors event messages as they are added to the system log, searches
for specific patterns in the messages, and takes a designated action when
a pattern match is found.
By default, EPS is configured to send a notification message to the
system console for ServerNet system area network (SAN) path failure (X
or Y cloud degraded) events and failure events produced by the process
keepalive system. You can configure EPS to change these defaults and/or
take actions on other event types.
Configuration
EPS is configured with the Eps, EpsFilters,
EpsEvents, EpsTemplates, EpsSiteAdmin,
and EpsDestinations X resource files.
As the root user, it is recommended that you edit copies of the EPS
configuration files to create custom site- and user-specific X resources.
Should future releases of EPS include configuration file changes,
your custom X resources will be preserved.
The following topics are important to the EPS configuration process:
This section explains how site- and user-specific resources
can be kept separate from the default resources provided with EPS.
The default version of all X resource files used for EPS configuration
is located in the /usr/lib/X11/app-defaults directory.
However, these defaults may be overridden or augmented with the use of
the following environment variables in the X resource loading sequence:
CAUTION: XFILESEARCHPATH, XUSERFILESEARCHPATH, and XAPPLRESDIR
are common environment variables used for defining X resources. Changing
these variables may affect other X applications.
-
XFILESEARCHPATH - The location of the primary X resource files. If not
defined, the primary default location (/usr/lib/X11/app-defaults)
is used.
-
XLOCALFILESEARCHPATH - The location of site-specific X resource files containing
definitions that override or augment the primary X resource files. If not
defined, the local default location (/usr/local/lib/X11/app-defaults)
is used.
-
XUSERFILESEARCHPATH - The location of user-customized X resource files
containing definitions that override or augment the primary and site-specific
X resource files. There is no user default location.
-
XAPPLRESDIR - An alternate location for application X resource files. This
variable is only used if XUSERFILESEARCHPATH is not defined. It has no
default value.
-
HOME - The home directory of the user (typically root) running the EPS
application. It has no default value.
-
LANG - The location for language-specific X resource files if they are
defined. It has no default value.
The loading of X resource configuration files follows a modified version
of the standard sequence:
-
(Standard) Load initial default values.
-
If $XFILESEARCHPATH is defined, look there for X resource file(s).
-
Otherwise, load file(s) from /usr/lib/X11/$LANG/app-defaults.
-
Otherwise, load file(s) from /usr/lib/X11/app-defaults.
-
(Nonstandard) Load site-specific values.
-
If $XLOCALFILESEARCHPATH is defined, look there for X resource file(s).
-
Otherwise, load file(s) from /usr/local/lib/X11/$LANG/app-defaults.
-
Otherwise, load file(s) from /usr/local/lib/X11/app-defaults.
-
(Standard) Load user-specific values.
-
If $XUSERFILESEARCHPATH is defined, look there for X resource file(s).
-
Otherwise, load file(s) from $XAPPLRESDIR/$LANG.
-
Otherwise, load file(s) from $XAPPLRESDIR.
-
Otherwise, load file(s) from $HOME/$LANG.
-
Otherwise, load file(s) from $HOME.
To create site- and/or user-specific X resources with the Configuration Manager,
perform the following steps:
- If you are not familiar with the contents of the EPS configuration files,
read through the online help for each file to identify the X resources
that you want to create or change.
- At the operating system (OS) prompt, copy the default EPS configuration files
containing resources that you intend to create/change to the site- and/or
user-specific directories identified under
Configuration File Loading Sequence.
- In the Configuration Manager, select (double click on) Properties Files,
then select (single click on) config_prefs.properties.
- In the config_prefs.properties file, edit the config.esp.dir entry
so it contains the name of the site-/user-specific directory to which you copied
the EPS configuration file(s) earlier in this procedure.
- Edit the config.eps.filelist entry so it contains the names of
the files that you copied for editing.
- On the Configuration Manager File menu (at the top of the window), select
Update.
Now when you select Event Processor Subsystem, your site-/user-specific
EPS configuration files are listed.
The X resource loading sequence can be triggered to read the configuration
files in more than one way:
Configuration File Details
Take the following links for a description of each of the EPS configuration files: