NAME

arm4_control - ARM 4 agent control program

SYNOPSIS

arm4_control --help|-h
arm4_control --version|-V
arm4_control [--config|-C config_file] [commands...]

DESCRIPTION

The arm4_control program controls the arm4_daemon program.

OPTIONS

-h, --help
display the command line options.
-V, --Version
display the program version and exit.
-C, --Config config_file
specifies a configuration file for this instance instead of using the default configuration file. The default configuration file /etc/arm4.conf is used if none is specified.

COMMANDS

help, help commands
show all available commands.
help <command>
show options for the command.
archive
backup the current database to the backup directory. Unless specified in the configuration file, the main backup directory is /var/lib/arm4/data/backup.
collect, collect status
show the current collection state.
collect yes, collect on
turn collection on.
collect no, collect off
turn collection off.
checkpoint
perform a database checkpoint operation
remove
remove the shared memory regions and semaphores, but leave the databases intact. This is normally done when recovering from catastrophic failures.
status
show if an instance of the arm4_daemon is running.
stop
stop the current arm4_daemon instance.
wipe
remove the current database, shared memory regions, and semaphores. This is normally done when upgrading versions.
application
display currently defined applications with their application ids.
application app_id
display collection parameters for the specified application.
application app_id transactions
displays the transactions definitions and corresponding transaction ids associated with the specified application.
transaction
displays the current transaction definitions.
transaction tran_id
displays the configuration for a specific transaction id.
transaction tran_id trace all
trace all transaction instances.
transaction tran_id trace none
turn tracing off.
transaction tran_id trace n
trace every nth transaction instance.
transaction tran_id trace n[s|S]
trace one transaction instance every n tenths of seconds.
transaction tran_id trace application
honor application trace requests.
transaction tran_id trace noapplication
ignore application trace requests.
transaction tran_id trace default
use application default settings.
export definitions
exports application, metric, and transaction definitions in xml format to stdout.
export all
exports the full database including definitions and instance data in xml format to stdout.
import filename
imports an exported database in xml format from the file.

REPORTING BUGS

Report bugs at <http://www.arm4.org>

COPYRIGHT

Copyright © 2005-2008 David Carter <dcarter [at] arm4.org> and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html

SEE ALSO

arm4_daemon(1), arm4_report(1), arm4_dump(1), arm4.conf(5)