diff options
Diffstat (limited to 'man/man8/puppetrun.8')
| -rw-r--r-- | man/man8/puppetrun.8 | 41 |
1 files changed, 21 insertions, 20 deletions
diff --git a/man/man8/puppetrun.8 b/man/man8/puppetrun.8 index 73a4ba3f2..9cbc2bd9b 100644 --- a/man/man8/puppetrun.8 +++ b/man/man8/puppetrun.8 @@ -5,47 +5,48 @@ . .SH SYNOPSIS .sp -Trigger a puppetd run on a set of hosts. +Trigger a puppet agent run on a set of hosts. .SH USAGE .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP -.B puppetrun [\-a|\-\-all] [\-c|\-\-class <class>] [\-d|\-\-debug] [\-f|\-\-foreground] +.B puppet kick [\-a|\-\-all] [\-c|\-\-class <class>] [\-d|\-\-debug] [\-f|\-\-foreground] . [\-h|\-\-help] [\-\-host <host>] [\-\-no\-fqdn] [\-\-ignoreschedules] -[\-t|\-\-tag <tag>] [\-\-test] [\-p|\-\-ping] +[\-t|\-\-tag <tag>] [\-\-test] [\-p|\-\-ping] <host> [<host> [...]] .UNINDENT .UNINDENT .UNINDENT .SH DESCRIPTION .sp -This script can be used to connect to a set of machines running -+puppetd+ and trigger them to run their configurations. The most common +This script can be used to connect to a set of machines running +puppet +agent+ and trigger them to run their configurations. The most common usage would be to specify a class of hosts and a set of tags, and -+puppetrun+ would look up in LDAP all of the hosts matching that class, -then connect to each host and trigger a run of all of the objects with -the specified tags. ++puppet kick+ would look up in LDAP all of the hosts matching that +class, then connect to each host and trigger a run of all of the objects +with the specified tags. .sp If you are not storing your host configurations in LDAP, you can specify hosts manually. .sp -You will most likely have to run +puppetrun+ as root to get access to +You will most likely have to run +puppet kick+ as root to get access to the SSL certificates. .sp -+puppetrun+ reads +puppetmaster+\(aqs configuration file, so that it can ++puppet kick+ reads +puppet master+\(aqs configuration file, so that it can copy things like LDAP settings. .SH USAGE NOTES .sp -+puppetrun+ is useless unless +puppetd+ is listening. See its ++puppet kick+ is useless unless +puppet agent+ is listening. See its documentation for more information, but the gist is that you must enable -+listen+ on the +puppetd+ daemon, either using +\-\-listen+ on the command -line or adding \(aqlisten: true\(aq in its config file. In addition, you need -to set the daemons up to specifically allow connections by creating the -+namespaceauth+ file, normally at \(aq/etc/puppet/namespaceauth.conf\(aq. This -file specifies who has access to each namespace; if you create the file -you must add every namespace you want any Puppet daemon to allow \-\- it -is currently global to all Puppet daemons. ++listen+ on the +puppet agent+ daemon, either using +\-\-listen+ on the +command line or adding \(aqlisten: true\(aq in its config file. In addition, +you need to set the daemons up to specifically allow connections by +creating the +namespaceauth+ file, normally at +\(aq/etc/puppet/namespaceauth.conf\(aq. This file specifies who has access to +each namespace; if you create the file you must add every namespace you +want any Puppet daemon to allow \-\- it is currently global to all Puppet +daemons. .sp An example file looks like this: .sp @@ -76,7 +77,7 @@ argument. See the configuration file documentation at \fI\%http://reductivelabs.com/projects/puppet/reference/configref.html\fP for the full list of acceptable parameters. A commented list of all -configuration options can also be generated by running puppetmasterdd +configuration options can also be generated by running puppet master with \(aq\-\-genconfig\(aq. .INDENT 0.0 .TP @@ -137,7 +138,7 @@ Do a ICMP echo against the target host. Skip hosts that don\(aqt respond to ping .INDENT 0.0 .INDENT 3.5 .sp -sudo puppetrun \-p 10 \-\-host host1 \-\-host host2 \-t remotefile \-t webserver +sudo puppet kick \-p 10 \-t remotefile \-t webserver host1 host2 .UNINDENT .UNINDENT .SH AUTHOR |