1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
.TH "" "" ""
.SH NAME
\-
.\" Man page generated from reStructeredText.
.SH SYNOPSIS
Trigger a puppetd run on a set of hosts.
.SH USAGE
.\" visit_block_quote
.TP
.B puppetrun [\-a|\-\-all] [\-c|\-\-class <class>] [\-d|\-\-debug] [\-f|\-\-foreground]
[\-h|\-\-help] [\-\-host <host>] [\-\-no\-fqdn] [\-\-ignoreschedules]
[\-t|\-\-tag <tag>] [\-\-test]
.\" depart_block_quote
.SH DESCRIPTION
This script can be used to connect to a set of machines running
+puppetd+ 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.
If you are not storing your host configurations in LDAP, you can specify
hosts manually.
You will most likely have to run +puppetrun+ as root to get access to
the SSL certificates.
+puppetrun+ reads +puppetmaster+\'s configuration file, so that it can
copy things like LDAP settings.
.SH USAGE NOTES
+puppetrun+ is useless unless +puppetd+ 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 \'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.
An example file looks like this:
.nf
[fileserver]
allow *.madstop.com
[puppetmaster]
allow *.madstop.com
[puppetrunner]
allow culain.madstop.com
.fi
This is what you would install on your Puppet master; non\-master hosts
could leave off the \'fileserver\' and \'puppetmaster\' namespaces.
Expect more documentation on this eventually.
.SH OPTIONS
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 <directory>\' as an
argument.
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 puppetmasterdd
with \'\-\-genconfig\'.
.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.
debug: Enable full debugging.
.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.
help: Print this help message
.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.
.SH EXAMPLE
.\" visit_block_quote
sudo puppetrun \-p 10 \-\-host host1 \-\-host host2 \-t remotefile \-t webserver
.\" depart_block_quote
.SH AUTHOR
Luke Kanies
.SH COPYRIGHT
Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public
License
.\" Generated by docutils manpage writer on 2008-05-05 09:33.
.\"
|
