diff options
Diffstat (limited to 'man/man8/puppetrun.8')
-rw-r--r-- | man/man8/puppetrun.8 | 306 |
1 files changed, 163 insertions, 143 deletions
diff --git a/man/man8/puppetrun.8 b/man/man8/puppetrun.8 index 9cbc2bd9b..b3c27c3a7 100644 --- a/man/man8/puppetrun.8 +++ b/man/man8/puppetrun.8 @@ -1,153 +1,173 @@ -.TH "" "" "" -.SH NAME - \- -.\" Man page generated from reStructeredText. -. -.SH SYNOPSIS -.sp -Trigger a puppet agent run on a set of hosts. -.SH USAGE -.INDENT 0.0 -.INDENT 3.5 -.INDENT 0.0 -.TP -.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] <host> [<host> [...]] -.UNINDENT -.UNINDENT -.UNINDENT -.SH DESCRIPTION -.sp -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 -+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 +puppet kick+ as root to get access to -the SSL certificates. -.sp -+puppet kick+ reads +puppet master+\(aqs configuration file, so that it can -copy things like LDAP settings. -.SH USAGE NOTES -.sp -+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 +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 +.\" generated with Ronn/v0.7.3 +.\" http://github.com/rtomayko/ronn/tree/0.7.3 +. +.TH "PUPPETRUN" "8" "August 2010" "" "" +Trigger a puppet agent run on a set of hosts\.puppet kick [\-a|\-\-all] [\-c|\-\-class \fIclass\fR] [\-d|\-\-debug] [\-f|\-\-foreground] +. +.IP "" 4 +. .nf -.ft C + + [\-h|\-\-help] [\-\-host <host>] [\-\-no\-fqdn] [\-\-ignoreschedules] + [\-t|\-\-tag <tag>] [\-\-test] [\-p|\-\-ping] <host> [<host> [\.\.\.]] +. +.fi +. +.IP "" 0 +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 +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\. +. +.P +If you are not storing your host configurations in LDAP, you can specify hosts manually\. +. +.P +You will most likely have to run +puppet kick+ as root to get access to the SSL certificates\. +. +.P ++puppet kick+ reads +puppet master+\'s configuration file, so that it can copy things like LDAP settings\.+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 +puppet agent+ daemon, either using +\-\-listen+ on the command line or adding \'listen: true\' in its config file\. In addition, you need to set the daemons up to specifically allow connections by creating the +namespaceauth+ file, normally at \'/etc/puppet/namespaceauth\.conf\'\. 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\. +. +.P +An example file looks like this:: +. +.IP "" 4 +. +.nf + [fileserver] - allow *.madstop.com + allow *\.madstop\.com [puppetmaster] - allow *.madstop.com + allow *\.madstop\.com [puppetrunner] - allow culain.madstop.com -.ft P + allow culain\.madstop\.com +. +.fi +. +.IP "" 0 +. +.P +This is what you would install on your Puppet master; non\-master hosts could leave off the \'fileserver\' and \'puppetmaster\' namespaces\.Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument\. For example, \'ssldir\' is a valid configuration parameter, so you can specify \'\-\-ssldir \fIdirectory\fR\' as an argument\. +. +.P +See the configuration file documentation at http://reductivelabs\.com/projects/puppet/reference/configref\.html for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet master with \'\-\-genconfig\'\. +. +.P +all: Connect to all available hosts\. Requires LDAP support +. +.IP "" 4 +. +.nf + + at this point\. +. +.fi +. +.IP "" 0 +. +.P +class: Specify a class of machines to which to connect\. This +. +.IP "" 4 +. +.nf + + only works if you have LDAP configured, at the moment\. +. +.fi +. +.IP "" 0 +. +.P +debug: Enable full debugging\. +. +.P +foreground: Run each configuration in the foreground; that is, when +. +.IP "" 4 +. +.nf + + connecting to a host, do not return until the host has + finished its run\. The default is false\. +. +.fi +. +.IP "" 0 +. +.P +help: Print this help message +. +.P +host: A specific host to which to connect\. This flag can be +. +.IP "" 4 +. +.nf + + specified more than once\. +. +.fi +. +.IP "" 0 +. +.P +ignoreschedules: Whether the client should ignore schedules when running +. +.IP "" 4 +. +.nf + + its configuration\. This can be used to force the client + to perform work it would not normally perform so soon\. + The default is false\. +. +.fi +. +.IP "" 0 +. +.P +parallel: How parallel to make the connections\. Parallelization +. +.IP "" 4 +. +.nf + + is provided by forking for each client to which to + connect\. The default is 1, meaning serial execution\. +. .fi -.sp -This is what you would install on your Puppet master; non\-master hosts -could leave off the \(aqfileserver\(aq and \(aqpuppetmaster\(aq namespaces. -.sp -Expect more documentation on this eventually. -.SH OPTIONS -.sp -Note that any configuration parameter that\(aqs valid in the configuration -file is also a valid long argument. For example, \(aqssldir\(aq is a valid -configuration parameter, so you can specify \(aq\-\-ssldir <directory>\(aq as an -argument. -.sp -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 puppet master -with \(aq\-\-genconfig\(aq. -.INDENT 0.0 -.TP -.B all: Connect to all available hosts. Requires LDAP support -. -at this point. -.TP -.B class: Specify a class of machines to which to connect. This -. -only works if you have LDAP configured, at the moment. -.UNINDENT -.sp -debug: Enable full debugging. -.INDENT 0.0 -.TP -.B foreground: Run each configuration in the foreground; that is, when -. -connecting to a host, do not return until the host has -finished its run. The default is false. -.UNINDENT -.sp -help: Print this help message -.INDENT 0.0 -.TP -.B host: A specific host to which to connect. This flag can be -. -specified more than once. -.TP -.B ignoreschedules: Whether the client should ignore schedules when running -. -its configuration. This can be used to force the client -to perform work it would not normally perform so soon. -The default is false. -.TP -.B parallel: How parallel to make the connections. Parallelization -. -is provided by forking for each client to which to -connect. The default is 1, meaning serial execution. -.TP -.B tag: Specify a tag for selecting the objects to apply. Does -. -not work with the \-\-test option. -.TP -.B test: Print the hosts you would connect to but do not -. -actually connect. This option requires LDAP support at -this point. -.UNINDENT -.sp -ping: -.sp +. +.IP "" 0 +. +.P +tag: Specify a tag for selecting the objects to apply\. Does +. +.IP "" 4 +. .nf -.ft C -Do a ICMP echo against the target host. Skip hosts that don\(aqt respond to ping. -.ft P + + not work with the \-\-test option\. +. .fi -.SH EXAMPLE -.INDENT 0.0 -.INDENT 3.5 -.sp -sudo puppet kick \-p 10 \-t remotefile \-t webserver host1 host2 -.UNINDENT -.UNINDENT -.SH AUTHOR -.sp -Luke Kanies -.SH COPYRIGHT -.sp -Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public -License -.\" Generated by docutils manpage writer. -.\" . +.IP "" 0 +. +.P +test: Print the hosts you would connect to but do not +. +.IP "" 4 +. +.nf + + actually connect\. This option requires LDAP support at + this point\. +. +.fi +. +.IP "" 0 +. +.P +ping:: +. +.P +Do a ICMP echo against the target host\. Skip hosts that don\'t respond to ping\.sudo puppet kick \-p 10 \-t remotefile \-t webserver host1 host2Luke KaniesCopyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public License |