NAME¶
cfrun - Execute remote cfagents
SYNOPSIS¶
/usr/sbin/cfrun [options]
DESCRIPTION¶
cfengine is a language based system specifically designed for testing and
configuring unix-like systems attached to a TCP/IP network.
cfrun is a tool for executing one or more remote agents; it contacts the cfservd
daemon running on a remote host, which (in turn) starts an authorized agent.
Cfrun cannot be used to send instructions to a remote agent, but it can be
used to flag certain aspects to the agent's existing policy for special
attention..
The command line options for cfrun are slightly unusual. They are separated into
three sections: options to the cfrun program, options to the remote cfagent
(with some security restrictions) and finally classes or flags to the remote
agent.
EXAMPLES¶
cfrun specialhost1 specialhost2 -- --verbose -- !solaris
In this example, we contact hosts specialhost1 specialhost2 by name, and ask
them to execute cfagent with the --verbose flag, if the class solaris is not
defined.
cfrun specialhost1 --verbose -- -- !solaris
In this example the verbose flag is sent to cfrun rather than to the remote
agent. No options are sent to the remote agents. The class specifier is sent
to all the agents so that they may determine whether they fulfill the required
class membership for execution.
The default behaviour is to execute cfagent serially on all hosts listed in the
cfrun.hosts file.
FILES¶
cfrun read a configuration file cfrun.hosts which must contain a list of every
potentially contactable host.
AUTHOR¶
Mark Burgess, Oslo University College
http://www.cfengine.org