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 configuration 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
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.