Directories and file structure

PATROL Agent creates several important directories and files on the PATROL host's disk drive. These files are automatically generated at run time and range from temporary files used for error logging to permanent files that store historical information. The PATROL Agent uses minimal space in the registry. 

The PATROL_HOME directory is the directory in which the PATROL installation process installs PATROL, and in which the PATROL executables and utilities run, write, and read information. The directory contains binaries, knowledge, sounds, images, application defaults, help files, and utilities. The directory is represented as $<PATROL_HOME> in UNIX and PATROL_HOME in Windows. The following diagram depicts the PATROL_HOME directory structure.

The following table lists the types of files used by the PATROL Agent and the directory in which it stores these files.

Note

This brief discussion of PATROL's directory structure is not exhaustive. The directories depicted in the figure and the files listed in the PATROL Agent file usage table, are the primary directories and files in a PATROL installation. In your PATROL implementation, additional files and directories may exist depending upon the platforms and installed components.

 PATROL Agent file usage

File typeUNIX pathDescription and examples
Windows path
Executable, shared library$<PATROL_HOME>/binBinary directory
<PATROL_HOME>\bin
Agent configuration file (default)$<PATROL_HOME>/lib/config.defaultAgent startup default configuration file
<PATROL_HOME>\lib\config.default
Event catalog$<PATROL_HOME>/lib/knowledge/StdEvents.ctgStandard Events Catalog
<PATROL_HOME>\lib\knowledge\StdEvents.ctg
Message catalogs$<PATROL_HOME>/lib/nls/C/1Directory of message catalogs
<PATROL_HOME>\lib\nls\C\1
PSL and OS scripts (shipped)$<PATROL_HOME>/lib/pslDirectory for shipped PSL and OS (and other KM-defined command types) scripts
<PATROL_HOME>\lib\psl
KMs and Standard Event Catalogs$<PATROL_HOME>/lib/knowledgeDirectory for shipped KMs and Standard Events Catalog
<PATROL_HOME>\lib\knowledge
Commit lock$<PATROL_HOME>/lib/commit.lockFile created temporarily during a Commit operation
<PATROL_HOME>\lib\commit.lock
Agent configuration files (customized)$<PATROL_HOME>/config/ config_<hostName>-<portNumber>Agent configuration files
<PATROL_HOME>\config\config_<hostName>-<portNumber>
History file and indices$<PATROL_HOME>/log/history/<hostName>/<portNumber>/annotate.dat, dir, param.histHistory file and indices
<PATROL_HOME>\log\history\<hostName>\<portNumber>\annotate.dat, dir, param.hist
PEM event log$<PATROL_HOME>/log/PEM_<hostName>_<portNumber>.log, archiveFiles containing all events for the PATROL Event Manager
<PATROL_HOME>\log\PEM_<hostName>_<portNumber>.log, archive
PEM event lock$<PATROL_HOME>/log/PEM_<hostName>_<portNumber>.log-lockLock on an Event Manager file
<PATROL_HOME>\log\PEM_<hostName>_<portNumber>.log-lock
Error log for the Agent$<PATROL_HOME>/log/PatrolAgent-<hostName>-<portNumber>.errs.~iter~File containing agent error messages, and so on
<PATROL_HOME>\log\PatrolAgent-<hostName>-<portNumber>.errs.~iter~
SOW mapped file$PATROL_HOME/log/trace/<hostname>/<port>/issow.log

Contains the PATROL's SOW mapped file when PATROL Agent runs in BMC ProactiveNet Performance Management environment.

<PATROL_HOME>\log\trace\<hostname>\<port>\issow.log
Persistent event store$PATROL_HOME/log/bemclient/log/bemclient-<port>/imgw-bemclient-<port>.data

Contains the persistent event store when PATROL Agent directly integrates into BMC ProactiveNet Event Manager.

<PATROL_HOME>\log\bemclient\log\bemclient-<port>\imgw-bemclient-<port>.data
Streamcache

$PATROL_HOME/log/streamcache/<hostname>/<port>/data.cache

$PATROL_HOME/log/streamcache/<hostname>/<port>/event.cache

$PATROL_HOME/log/streamcache/<hostname>/<port>/stat.cache

Contains the persistent event/data stores when the PATROL Agent runs in the BMC ProactiveNet Performance Management environment.

<PATROL_HOME>\log\streamcache\<hostname>\<port>\data.cache

<PATROL_HOME>\log\streamcache\<hostname>\<port>\event.cache

<PATROL_HOME>\log\streamcache\<hostname>\<port>\stat.cache

Note

In a typical setup, the agent runs as a service under the LOCAL SYSTEM account. When user accounts are domain accounts, the LOCAL SYSTEM account does not have the authority to query the domain controller to determine the domain account's home directory. Therefore, the PATROL Agent creates a directory for each user in the profile directory. The agent uses the directory as a substitute for the user's home directory when the home directory cannot be determined due to restrictions in Windows domain security. The profile directory is only used for PATROL Agents running on Windows.

Was this page helpful? Yes No Submitting... Thank you

Comments