<<

NAME

reporter-manager - Executes Inca reporters on a resource

DESCRIPTION

An Inca reporter manager is responsible for scheduled and on-demand execution of reporters and sending the results to a depot for storage. A reporter manager trusts one and only one reporter agent who it registers with and accepts control changes from. A reporter manager should have a minimal impact on the resource it is running on. The reporter manager can be started in one of the following ways:

SYNOPSIS

reporter-manager [-a|-s] [options]

OPTIONS

a|--agent

A string containing the URI to the Reporter Agent process that will be responsible for the reporter manager. Currently accepted URIs include:

incas://host:port inca://host:port

-c|--cert

A path to a valid certificate file [default: none]

-d|--depot

A string containing the URI of a depot to send its reporter data to. Currently accepted URIs include:

incas://host:port inca://host:port file://path

This option can be specified more than once. The report will be sent to the first specified depot. If the first depot is unreacheable, the next depots in the list will be tried.

-D|--depot-timeout

A positive integer indicating the period in seconds of which to time out the send of a report to the depot [default: 120]

-e|--error-reporter

A string containing a path to the error reporter. E.g., inca-null-reporter

-h|--help

Print help/usage information

-i|-id

The resource identifier supplied by the reporter agent that the reporter manager will use to identify itself back to the reporter agent.

-k|--key

A path to a valid key file [default: none]

-l|--logfile

A string containing a path to the file where the log messages can be stored. If not specified, log messages will be printed to the console.

-L|--level

A string containing the log message level (i.e., print statements of this level and higher). [default: INFO]

-P|--passphrase

Read a passphrase for key from stdin

-r|--reporter-cache

A string containing the path to the local cache of reporters.

-R|--rim

A string containing a path to the reporter-instance-manager script. If not specified, this script will look into the directory where itself is located.

-s|--suite

A string containing a path to the Inca suite file containing the reporters to be executed.

-t|--trusted

A path to either a directory or file of trusted certificates [default: none]

-v|--var

A string containing a path to a temporary file space that Inca can use while executing reporters

-w|--wait

A positive integer indicating the period in seconds of which to check the reporter for a timeout [default: 2]

EXAMPLES

# run suite.xml and place data to file

reporter-manager -s t/suite.xml --r ./t -d file:/tmp/depot.tmp

# run suite.xml and send to depot on port 6324

reporter-manager -s t/suite.xml --r ./t --depot incas://localhost:6324 -c t/certs/client_ca1cert.pem -k t/certs/client_ca1keynoenc.pem -t t/certs/trusted

AUTHOR

Shava Smallen <ssmallen@sdsc.edu>

<<