arm4_daemon(8)
Table of Contents
IMPORTANT: PLEASE READ
- OPTIONS CHANGED WITH RELEASE 0.4. Please read carefully.
- This program is a daemon in the true sense. It runs in the background slurping up the data produced by the user programs and stuffs it into the backend database. It should be running at all times, and instrumented applications may hang if it isn't available.
- At this time, no data aging is performed. The database will fill until all your filespace is used. While you can manage this externally, that's not something we've tried at this time.
SYNOPSIS
arm4_daemon --help|-h
arm4_daemon --version|-V
arm4_daemon [--verbose|-v] [--debug|-d]
[--config|-C config_file] [--stats|-s] [--off|-o]
DESCRIPTION
The arm4_daemon program collects ARM 4 measurement data from the ARM 4 libraries and saves the measurements in a local database. While there will normally be many instances of the instrumented applications, there will typically be only one instance of the arm4_daemon running at a time.
CONFIGURATION
Configuration options are set in the configuration file. The default configuration is /etc/arm4.conf, although this can be overridden using the --config command line option. See arm4.conf(5) for more information.
DATAFILES
The arm4_daemon program uses the Berkeley database to store transaction information. Rather than a single file, this database uses separate files fore each database table. For simplicity, all database files are stored in a single direc‐ tory. Therefore specifying a database or database archive location is really specifying the directory in which the files are stored.
The default location for the database files is /var/opt/arm/data. For backup files, a time stamped directory is created under /var/opt/arm/data/backup. Each of these directories can be changed using the arm4.conf configuration file.
OPTIONS
-h, --help
display the command line options
-V, --Version
display the program version and exit
-v, --verbose
output diagnostic information as the program is run. This may not be suitable when running in the background as a true daemon but can be useful for debugging.
-C, --Config config_file
specifies a configuration file for this instance instead of using the default configuration file. The default con‐ figuration file /etc/arm4.conf is used if none is specified.
-d, --debug
run the daemon as a foreground process. This is primarily used for debugging.
-s, --stats
periodically display statistics on the message queues and database processes.
-o, --off
Start the agent as a "null" collector. Although the collector is active, no data is actually collected. This can be controlled using the arm4_control utility.
REPORTING BUGS
Report bugs at <http://www.arm4.org>
COPYRIGHT
Copyright © 2005-2007 arm4.org
This is free software. You may redistribute copies of it under terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
SEE ALSO
arm4_control(8), arm4_report(1), arm4_dump(8), arm4_conf(5)
