Issue #6579 has been updated by James Turnbull.

Status changed from Unreviewed to Accepted


----------------------------------------
Bug #6579: ext/rack/README clarifications
https://projects.puppetlabs.com/issues/6579

Author: Justin Honold
Status: Accepted
Priority: Normal
Assignee: Nick Fagerlund
Category: 
Target version: 
Keywords: 
Branch: 
Affected URL: 


I set upon configuring a more scalable Puppet infrastructure.

http://www.puppetlabs.com/ -> http://docs.puppetlabs.com/ -> 
http://docs.puppetlabs.com/guides/scaling.html -> 
http://docs.puppetlabs.com/guides/passenger.html

I'm running 2.6.x, and it said "Please see ext/rack/README in the puppet source 
tree for instructions."  I took this to mean a redirect, as in "look there and 
stop reading this document."

- Rack 1.0.0 is explicitly stated, but I've found that the current 1.2.1 Gem 
works
- It could be specified that "squigley.namespace.at" is what needs to change to 
the host's FQDN
- [puppetmasterd] is suggested in puppet.conf, but manual runs warn that it's 
deprecated in favor of [master]
- It directs users toward a manifest which fails on Ubuntu 10.04 hosts (Could 
not find dependency Package[apache2] for 
File[/etc/apache2/conf.d/puppetmasterd])
- The manifest is suggested as a reference for one's own module, rather than 
necessary Passenger configuration
- "the boring stuff" is not specified in the document, even in outline form
- config.ru is referenced, but its source and destination locations aren't
- Looking back at the page, it became more clear to me that there were 
additional instructions past what was declared as the "Installation 
instructions" for older versions, which needed to be adapted
- A config.ru file for 2.6.x isn't declared on the wiki page along with the 
others

This part may be more of a 'code' issue, but the Puppet-included apache2.conf 
doesn't have the "Suggested Tweaks" included at the bottom of the wiki page; if 
they are suggested, I would also expect them to be standard.

I think the instructions could be split into version-specific sections, so 
there are just distro-specific rather than version-specific settings.  Overall, 
I would like to use either the README or the docs, but not a mix of both.  For 
reference, the command set I used to configure an Ubuntu 10.04 LTS system with 
an already-functioning Gem-installed 2.6.5 puppetmasterd and Apache setup:

<pre>
sudo gem install rack
sudo apt-get -y install libapache2-mod-passenger
sudo cp /var/lib/gems/1.8/gems/puppet-`puppet 
--version`/ext/rack/files/apache2.conf 
/etc/apache2/sites-available/puppet-passenger
sudo sed -i "s/squigley.namespace.at/`hostname -f`/" puppet-passenger 
/etc/apache2/sites-available/puppet-passenger
sudo mkdir -p /etc/puppet/rack/public
sudo cp /var/lib/gems/1.8/gems/puppet-`puppet 
--version`/ext/rack/files/config.ru /etc/puppet/rack
sudo chown puppet /etc/puppet/rack/config.ru
sudo a2enmod ssl passenger
sudo a2ensite puppet-passenger
sudo service apache2 restart
</pre>



-- 
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to