diff options
Diffstat (limited to 'man/man8/puppet.8')
| -rw-r--r-- | man/man8/puppet.8 | 82 |
1 files changed, 5 insertions, 77 deletions
diff --git a/man/man8/puppet.8 b/man/man8/puppet.8 index 2eefc6a0a..0281d330e 100644 --- a/man/man8/puppet.8 +++ b/man/man8/puppet.8 @@ -20,81 +20,10 @@ Run a stand\-alone +puppet+ script. .\" depart_block_quote .SH DESCRIPTION +This is the standalone puppet execution script; use it to execute +individual scripts that you write. If you need to execute site\-wide +scripts, use +puppetd+ and +puppetmasterd+. -This document is intended as a secondary reference only. Please refer to the complete documentation on the -.B puppet -website: -.PP -\h"4"http://www.reductivelabs.com/trac/puppet/wiki/DocumentationStart -.PP -Every -.B puppet -executable (with the exception of -.B puppetdoc -) accepts all of the arguments below, but not all of the arguments make sense for every executable. Each argument has a section listed with it in parentheses; often, that section will map to an executable (e.g., -.B puppetd -), in which case it probably only makes sense for that one executable. If -.B puppet -is listed as the section, it is most likely an option that is valid for everyone. -.PP -This will not always be the case. I have tried to be as thorough as possible in the descriptions of the arguments, so it should be obvious whether an argument is appropriate or not. -.PP -These arguments can be supplied to the executables either as command-line arugments or in the configuration file for the appropriate executable. For instance, the command-line invocation below would set the configuration directory to /private/puppet: -.PP -\h"4"$ puppetd --confdir=/private/puppet -.PP -Note that boolean options are turned on and off with a slightly different syntax on the command line: -.PP -\h"4"$ puppetd --storeconfigs -.PP -\h"4"$ puppetd --no-storeconfigs -.PP -The invocations above will enable and disable, respectively, the storage of the client configuration. -.PP -As mentioned above, the configuration parameters can also be stored in a configuration file located in the configuration directory (/etc/puppet by default). The file is called puppet.conf. -.PP -The file, which follows INI-style formatting, should contain a bracketed heading named for each executable, followed by pairs of parameters with their values. Here is an example of a very simple puppet.conf file: -.PP -\h"4"[puppetd] -.br -\h"4"confdir = /private/puppet -.br -\h"4"storeconfigs = true -.br -.PP -Note that boolean parameters must be explicitly specified as true or false as seen above. -.PP -If you're starting out with a fresh configuration, you may wish to let the executable generate a template configuration file for you by invoking the executable in question with the --genconfig command. The executable will print a template configuration to standard output, which can be redirected to a file like so: -.PP -\h"4"$ puppetd --genconfig > /etc/puppet/puppet.conf -.PP -Note that this invocation will "clobber" (throw away) the contents of any pre-existing puppet.conf file, so make a backup of your present config if it contains valuable information. -.PP -Like the --genconfig argument, the executables also accept a --genmanifest argument, which will generate a manifest that can be used to manage all of -.B Puppet's -directories and files and prints it to standard output. This can likewise be redirected to a file: -.PP -\h"4"$ puppetd --genmanifest > /etc/puppet/manifests/site.pp -.PP -.B Puppet -can also create user and group accounts for itself (one puppet group and one puppet user) if it is invoked as root with the --mkusers argument: -.PP -\h"4"$ puppetd --mkusers -.PP -.SH SIGNALS -The -.B puppetd -and -.B puppetmasterd -executables catch some signals for special handling. Both daemons catch (SIGHUP), which forces the server to restart tself. Predictably, interrupt and terminate (SIGINT and SIGHUP) will shut down the server, whether it be an instance of -.B puppetd -or -.B puppetmasterd. -.PP -Sending the SIGUSR1 signal to an instance of -.B puppetd -will cause it to immediately begin a new configuration transaction with the server. This signal has no effect on -.B puppetmasterd. .SH OPTIONS Note that any configuration parameter that\'s valid in the configuration @@ -138,12 +67,11 @@ puppet \-l /tmp/script.log script.pp .SH AUTHOR Luke Kanies - - +.\" Generated by docutils manpage writer on 2008-01-20 10:28. .SH COPYRIGHT Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public License -.\" Generated by docutils manpage writer on 2008-01-20 10:28. +.\" Generated by docutils manpage writer on 2008-03-22 17:46. .\" |