Provided by: cfengine3_3.10.2-4build1_amd64 
NAME
cf-runagent - activate cf-agent on a remote host
SYNOPSIS
cf-runagent [OPTION]... [FILE]
DESCRIPTION
cf-runagent connects to a list of running instances of cf-serverd. It allows foregoing the usual cf-execd
schedule to activate cf-agent. Additionally, a user may send classes to be defined on the remote host.
Two kinds of classes may be sent: classes to decide on which hosts cf-agent will be started, and classes
that the user requests cf-agent should define on execution. The latter type is regulated by cf-serverd's
role based access control.
OPTIONS
--help, -h
Print the help message
--background, -b value
Parallelize connections (50 by default)
--debug, -d
Enable debugging output
--verbose, -v
Output verbose information about the behaviour of the agent
--dry-run, -n
All talk and no action mode - make no changes, only inform of promises not kept
--version, -V
Output the version of the software
--file, -f value
Specify an alternative input file than the default
--define-class, -D value
Define a list of comma separated classes to be sent to a remote agent
--select-class, -s value
Define a list of comma separated classes to be used to select remote agents by constraint
--inform, -I
Print basic information about changes made to the system, i.e. promises repaired
--remote-options, -o value
(deprecated)
--diagnostic, -x
(deprecated)
--hail, -H value
Hail the following comma-separated lists of hosts, overriding default list
--interactive, -i
Enable interactive mode for key trust
--timeout, -t value
Connection timeout, seconds
--color, -C value
Enable colorized output. Possible values: 'always', 'auto', 'never'. If option is used, the
default value is 'auto'
--timestamp, -l
Log timestamps on each line of log output
--log-modules, - value
Enable even more detailed debug logging for specific areas of the implementation. Use together
with '-d'. Use --log-modules=help for a list of available modules
--remote-bundles, - value
Bundles to execute on the remote agent
CFENGINE
CFEngine provides automated configuration management of large-scale computer systems. A system
administrator describes the desired state of a system using CFEngine policy code. The program cf-agent
reads policy code and attempts to bring the current system state to the desired state described. Policy
code is downloaded by cf-agent from a cf-serverd daemon. The daemon cf-execd is responsible for running
cf-agent periodically.
Documentation for CFEngine is available at http://cfengine.com/documentation/.
PROMISE THEORY
CFEngine is built on principles from promise theory, proposed by Mark Burgess in 2004. Promise theory is
a model of voluntary cooperation between individual, autonomous actors or agents who publish their
intentions to one another in the form of promises. A promise is a declaration of intent whose purpose is
to increase the recipient's certainty about a claim of past, present or future behaviour. For a promise
to increase certainty, the recipient needs to trust the promiser, but trust can also be built on the
verification that previous promises have been kept, thus trust plays a symbiotic relationship with
promises.
For an introduction to promise theory, please see http://arxiv.org/abs/0810.3294/
AVAILABILITY
cf-runagent is part of CFEngine.
Binary packages may be downloaded from http://cfengine.com/downloads/.
The source code is available at http://github.com/cfengine/
BUGS
Please see the public bug-tracker at http://bug.cfengine.com/. GitHub pull-requests may be submitted to http://github.com/cfengine/core/.
SEE ALSO
cf-promises(8), cf-agent(8), cf-serverd(8), cf-execd(8), cf-monitord(8), cf-runagent(8), cf-key(8)
AUTHOR
Mark Burgess and CFEngine AS