cf-runagent(8) cf-runagent(8)
NAME
cf-runagent - Run agent
SYNOPSIS:
cf-runagent [options]
DESCRIPTION:
The run agent connects to a list of running instances of the cf-serverd
service. The agent allows a user to forego the usual scheduling inter-
val for the agent and activate cf-agent on a remote host. Additionally,
a user can send additional classes to be defined on the remote host.
Two kinds of classes may be sent: classes to decide on which hosts the
agent will be started, and classes that the user requests the agent
should define on execution. The latter type is regulated by cf-
serverd's role based access control. cfengine is a self-healing con-
figuration and change management based system. You can think of.B
cfengine as a very high level language, much higher level than Perl or
shell. Asingle statement is called a promise, and compliance can result
in many hundreds of filesbeing created, or the permissions of many hun-
dreds offiles being set. The idea of .B cfengine is to create a one or
more sets of configuration files which willclassify and describe the
setup of every host in a network.
COMMAND LINE OPTIONS:
--help, -h
Print the help message
--background, -b
Parallelize connections (50 by default)
--debug, -d
Set debugging level 0,1,2,3
--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
Specify an alternative input file than the default
--define-class, -D
Define a list of comma separated classes to be sent to a remote
agent
--select-class, -s
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
Pass options to a remote server process
--diagnostic, -x
Activate internal diagnostics (developers only)
--hail, -H
Hail the following comma-separated lists of hosts, overriding
default list
--interactive, -i
Enable interactive mode for key trust
--query, -q
Query a server for a knowledge menu
--timeout, -t
Connection timeout, seconds
AUTHOR
Mark Burgess and CFEngine AS
INFORMATION
Bug reports: http://bug.cfengine.com, .pp Community help:
http://forum.cfengine.com Community info:
http://www.cfengine.com/pages/community Support services:
http://www.cfengine.com This software is Copyright (C) 2008-2011
CFEngine AS.
Maintenance Commands cf-runagent(8)
cfengine 3.2.1 - Generated Fri Sep 23 18:29:50 CDT 2011