1cfengine(8) System Manager's Manual cfengine(8)
2
6 cfrun - Execute remote cfagents
7
9 /usr/local/sbin/cfrun [options]
10
13 cfengine is a language based system specifically designed for testing
14 and configuring unix-like systems attached to a TCP/IP network.
15 cfrun is a tool for executing one or more remote agents; it contacts
18 the cfservd daemon running on a remote host, which (in turn) starts an
19 authorized agent. Cfrun cannot be used to send instructions to a remote
20 agent, but it can be used to flag certain aspects to the agent's exist‐
21 ing policy for special attention..
22 The command line options for cfrun are slightly unusual. They are sepa‐
25 rated into three sections: options to the cfrun program, options to the
26 remote cfagent (with some security restrictions) and finally classes or
27 flags to the remote agent.
28
31 cfrun specialhost1 specialhost2 -- --verbose -- solaris
32 In this example, we contact hosts specialhost1 specialhost2 by name,
35 and ask them to execute cfagent with the --verbose flag, if the class
36 solaris is not defined.
37 cfrun specialhost1 --verbose -- -- solaris
39 In this example the verbose flag is sent to cfrun rather than to the
42 remote agent. No options are sent to the remote agents. The class
43 specifier is sent to all the agents so that they may determine whether
44 they fulfill the required class membership for execution.
45 The default behaviour is to execute cfagent serially on all hosts
47 listed in the cfrun.hosts file.
48
51 cfrun read a configuration file cfrun.hosts which must contain a list
52 of every potentially contactable host.
53
56 Mark Burgess, Oslo University College
57
59 http://www.cfengine.org
60 Maintenance Commands cfengine(8)