Issue #18468 has been updated by Matthaus Owens.

Status changed from Merged - Pending Release to Closed

Released in Puppet 3.1.0
----------------------------------------
Feature #18468: Improve confusing instructions in /etc/default/puppet regarding 
service start
https://projects.puppetlabs.com/issues/18468#change-82454

Author: Henrik Lindberg
Status: Closed
Priority: Normal
Assignee: 
Category: installation
Target version: 3.1.0
Affected Puppet version: 
Keywords: debian
Branch: https://github.com/puppetlabs/puppet/pull/1391


When installing puppet 3.1rc1 (tested on debian "squeeze") it attempts to start 
puppet as a service which results in this output (at the end):
<pre>
Setting up puppet (3.1.0-0.1rc1puppetlabs1) ...
Starting puppet agent
puppet not configured to start, please edit /etc/default/puppet to enable
.
</pre>
When editing the mentioned file, it contains:
<pre>
# Defaults for puppet - sourced by /etc/init.d/puppet

# Start puppet on boot?
START=no

# Startup options
DAEMON_OPTS=""
</pre>

In order to make the service start START must be set to 'yes'.
What is confusing here is that the comment above START says this is for 
starting puppet on boot. (I did not want it to start on boot, but I want it to 
start on demand).

As it is unclear (to me) what exactly is controlled by the START flag it is 
hard to suggest a correct replacement, but something like "Master puppet 
service enablement flag. When set to 'no', the puppet service can not be 
started. When set to 'yes', the service can be started via your system's init.d 
services, which by default will start the puppet
service on boot."

Further, the output when installing is also somewhat misleading with a period 
appearing on a separate line. This led me to believe that there was text missing
after the sentence `please edit /etc/default/puppet to enable` - enable what? 
how? - questions arise as the instruction in the file it is referring to are 
not very clear (i.e. what is reported above). It could have ended with  "please 
edit /etc/default/puppet to enable by setting START=yes.", or even better 
perhaps "please edit /etc/default/puppet to enable by setting START=yes if you 
want puppet to run as a service."

For a complete noob it may also be difficult to differentiate between "puppet" 
in the meaning of "agent" as opposed to "puppet" as a product which could also 
be made clearer by saying "puppet (agent) service" or words to that effect.



-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/puppet-bugs?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to