cf-runagent(8)						      System Manager's Manual						    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
       interval 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 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
       hundreds offiles being set. The idea of 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-2013 CFEngine AS.

							       Maintenance Commands						    cf-runagent(8)